pixage
PIXel perfect application using visual regression testing with help of imAGE-magick gives birth to PIXAGE
Pixels + Image = Pixage
A utility which can be used manually or be integrated with an existing selenium-ruby or appium-ruby automation framework to perform visual regression testing of screenshots.
Table of contents
- Installation
- Install using gem command
- Install using bundler
- Dependency
- Usage
- CLI Usage
- Automation Usage
- Contributing
- Issues
Installation
There are multiple ways in which you can install and use pixage gem. You must have Ruby installed before you can install this gem.
Just use following command from you Terminal.
gem install pixage
You can include it in your Gemfile and run bundle install.
gem 'pixage'
then run following
bundle install
Dependency
This gem is dependent on ImageMagick. Please install latest verison of ImageMagick before you start using pixage.
To verify if imagemagick is successfully installed, please run the following command (After installaing pixage).
pixage diagnosis
Usage
There are 2 ways this gem can be used.
- CLI usage which can be really helpful for testers and designers to do visual regression testing manually.
- Can be integrated with automation suite to compare run time screenshots with pre-saved baseline images.
Following are the list of commands :
Basic usage in case of compare 2 images which are similar size and resolution:
# Basic usage with default options
pixage compare images/expected.png images/actual.png
# Basic usage with custom options
pixage compare images/expected.png images/actual.png --threshold=1 --fuzz=25 --color=red
For further commmand usage documentation, please refer the wiki section.
Apart from CLI usage, pixage gem can also be integrated with automation suite be it a selenium-webdriver-ruby for web application or appium-ruby for mobile applications or just a ruby script acheieving some fine purpose.
Below is the code snippet to be used in case of automation integration:
# First, as mentioned in installation step, include gem in Gemfile
gem 'pixage'
# Next, require and include it in your project
require 'pixage'
include 'Pixage'
# Finally use the commands in your code:
# Assuming you have your baseline/expected image previously stored
@driver.save_screenshot(actual.png)
resize_n_compare(expected.png, actual.png)
# Also you can compare 2 runtime images like:
@driver.save_screenshot(first.png)
@driver.save_screenshot(second.png)
compare(first.png, second.png)
NOTE: To see a working example on how to integrate pixage with a Ruby-Cucumber-Selenium tests, please see the examples directory. It also has a sample report stored for reference.
To execute the example, do the following:
- Clone the repo
git clone https://github.com/krupani/pixage.git
- get into the examples folder
cd pixage/examples
- install dependent gems or just run
bundle install
- if you dont have bundler installed then first run
gem install bundler
and then repeat above step
- if you dont have bundler installed then first run
- execute the tests
cucumber features BROWSER=chrome
, provided you have chromedriver in your PATH
Contributing
Ideas and suggestions are always always most welcome. Please fork this gem and feel free to add any updates, suggestions etc and create a pull request.
Issues
If you face any problem related to syntax, usability, documentation then please raise an issue