Project

watircats

0.01
No commit activity in last 3 years
No release in over 3 years
watircatsclockworknet/watircatsHomepageDocumentationSource CodeBug TrackerWiki
Responive screenshot and comparison tool using Watir-WebDriver.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
8,127
Stars
13
Forks
3
Watchers
9
 Releases
Current version
0.2.5
Total releases
3
First release
2014-07-29
Latest release
2014-10-24
 Issues
Open Issues
1
Closed Issues
1
Total Issues
2
Issue Closure Rate
50%
 Pull Requests
Open Pull Requests
1
Closed Pull Requests
0
Merged Pull Requests
4
Pull Request Acceptance Rate
80%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2015-03-26
Reverse Dependencies
0

 Dependencies

Runtime

autotest
~> 4.4
haml
~> 4.0
minitest
~> 5.0
psych
~> 2.0
require_all
~> 1.3
thor
~> 0.18
watir-webdriver
~> 0.6
xml-simple
~> 1.1
 Project Readme

WatirCats

Gem Version

WatirCats uses Watir-Webdriver to grab screenshots of pages at multiple widths. It also grabs and parses a site's sitemap, assuming the site map is hosted at the site_root/sitemap.xml.

Using the compare, ImageMagick is used to see if the images have differences. If they do, you'll get a visual diff in the output folder.

Some of the features:

  • Responsive Screenshots
  • Multiple sources for URLs, but most rely on /sitemap.xml for use
  • Multiple Browsing engines. Chrome, Firefox, FirefoxESR, and support for IE
  • Proxy and custom binary path support for Firefox

Requirements

  • ImageMagick
  • Ruby 1.9.3 or greater
  • Firefox

Installation

gem install watircats

or

  • Checkout this repository
  • bundle install
  • gem build watircats.gemspec
  • gem install watircats-0.2.5.gem

Usage

  • Compare And Take Screenshots:
  • watircats compare http://my.example.com http://my-other.example.com
  • Compare two folders of screenshots:
  • watircats folders folder_a folder_b
  • Take screenshots at several widths:
  • watircats screenshots http://my.example.com --widths 1024 800 320

Configuration

Configuration can be done at the command line or via a config file. See 'sample_config.yml' for the available parameters.

Specify a config file at runtime with --config_file my_config_file.yml

If you want to add functionality to this project, pull requests are welcome.

  • Create a branch based off master and do all of your changes with in it.
  • If it you have to pause to add a 'and' anywhere in the title, it should be two pull requests.
  • Make commits of logical units and describe them properly
  • Check for unnecessary whitespace with git diff --check before committing.
  • If possible, submit tests to your patch / new feature so it can be tested easily.
  • Assure nothing is broken by running all the test
  • Please ensure that it complies with coding standards.

Please raise any issues with this project as a GitHub issue.

License

WatirCats is available to everyone under the terms of the MIT open source license. Take a look at the LICENSE file in the code.

Credits