{"id":22379137,"url":"https://github.com/sky-uk/cezanne","last_synced_at":"2025-07-31T01:31:53.599Z","repository":{"id":19033573,"uuid":"22258055","full_name":"sky-uk/cezanne","owner":"sky-uk","description":"Visual regression testing tool","archived":false,"fork":false,"pushed_at":"2017-02-02T11:35:41.000Z","size":972,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-03-15T12:26:23.143Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sky-uk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-07-25T13:37:29.000Z","updated_at":"2017-02-02T11:35:43.000Z","dependencies_parsed_at":"2022-07-28T20:10:00.990Z","dependency_job_id":null,"html_url":"https://github.com/sky-uk/cezanne","commit_stats":null,"previous_names":["bskyb-commerce/cezanne"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fcezanne","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fcezanne/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fcezanne/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fcezanne/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sky-uk","download_url":"https://codeload.github.com/sky-uk/cezanne/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228204605,"owners_count":17884711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T23:09:05.542Z","updated_at":"2024-12-04T23:09:06.214Z","avatar_url":"https://github.com/sky-uk.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/sky-uk/cezanne.svg?branch=master)](https://travis-ci.org/sky-uk/cezanne)\n[![Coverage Status](https://coveralls.io/repos/sky-uk/cezanne/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/sky-uk/cezanne?branch=master)\n\n# Cezanne\n\nCross-browser visual regression testing tool\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'cezanne'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install cezanne\n\n## Usage \n### RSpec\n\nIn your `spec_helper.rb`\n    \n    require 'cezanne/rspec'\n    \n    RSpec.configure do |config|\n      config.include Cezanne\n    end\n\n    Cezanne.configure do |config|\n      config.uid = ENV['build_number']\n      config.project_name = 'awesome_app'\n    end\n\nThe `uid` should be a unique identifier. We use the build number, but it can be a static string if you don't need\nto keep multiple versions of the screenshots.\n\nIn your tests\n\n    \n    describe 'Mont Sainte-Victoire', screenshots: true do\n      it 'is a masterpiece' do\n        visit 'url-to-painting'\n        check_visual_regression_for 'mont-sainte-victoire'\n      end\n    end\n\nMake sure to use a unique name for each screenshot. \nThe associate file will be a gif image named after the parameter (`'mont-sainte-victoire'` in the example above)\nand the browser name \u0026 version, to make it easy to check visual regressions on multiple browsers.\n\n## Dependencies\n\nCezanne uses ImageMagick. Check with your package manager.\n\nScreenshots are taken using Capybara and its configured driver (local, headless, remote) as long as it supports screenshots.\n\nScreenshots images (`.gif`) are stored on Dropbox. Follow the instructions at https://www.dropbox.com/developers/core and \nexport your oAuth access token\n\n    export DROPBOX_ACCESS_TOKEN=**insert dropbox access token here**\n\n\n## (Opinionated) Workflow\n\n* Reference screenshots are stored on Dropbox\n* New and different screenshots will be synced to Dropbox at the end of the test suite \n\n\n    ```\n    project_name\n    |\n    +-- reference_screenshots\n    |\n    +-- uid\n    |   |\n    |   +-- new_screenshots\n    |   |\n    |   +-- different_screenshots\n    |\n    |\n    +-- uid_2\n        |\n        ...\n    ```\n\n## Tests\n\nTo run the specs\n\n1. clone the repo `git clone git@github.com:sky-uk/cezanne.git`\n2. cd into it `cd cezanne`\n3. install deps `gem install bundler \u0026\u0026 bundle install`\n4. run the specs `rspec`\n\n(integration tests use Firefox by default)\n\n## Authors\n\nMade with \u003c3 by the Sky Haiku team\n\nGot questions? Ask Ben ([@benstokoe](https://github.com/benstokoe)) or Andrea ([@pigats](https://github.com/pigats))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-uk%2Fcezanne","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsky-uk%2Fcezanne","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-uk%2Fcezanne/lists"}