GUIRE

GUIRE - Graphical User Interface Regression Engine - Is a testing framework for user interface components. GUIRE helps detect changes that occur in the browser - from a single pixel or colour unit to entire component breakages.

Usage

GUIRE is a command-line application who's usage looks like:

guire <suite-path...>
    --report-dir [report-directory]
    --reference-dir [reference-directory]
    --audit
    --pdf

| Argument | Description | |---------------------|---------------------------------------------------------------------| | --report-dir | Set the report directory for output of all reporting and results | | --reference-dir | Set the reference directory for storage of comparison (control) images | | --title | Set the title in the report | | --audit | Enter audit mode | | --pdf | Enable PDF output for reporting |

Each test suite must be a JavaScript file who's configuration is described here.

Auditing

Auditing can be performed when differences are detected, allowing users to update reference shots with newly-taken shots.

Enter audit mode by providing the --audit argument - prompts for each failing component will appear so that the user can make the decision to either save the screenshot as the new reference, or simply skip it and move on to the next one.

Developing

Run npm install to get started. Execute the example by running npm run example.

Contributing

We greatly appreciate contributions, but please respect the format of the codebase. Follow by example where possible, and run the linter if you're unsure. GUIRE is a 4-space-indentation, semicolon-required and XO-linted project.

Using an editor which supports the included .editorconfig and XO configuration (in package.json) is advised.

Testing

Simply run npm test to make sure everything is OK.