plum-test

Build and run visual regression tests against plum stylesheets.

Getting Started

• Install with NPM - npm install --save plum-test

Usage

Node

var plumTest = require('plum-test');

var options = {
  src: 'path/to/plum/directory',
  dest: 'path/to/save/results/to',
  stylesheets: ['path/to/compiled/stylesheets'],
};

plumTest(options, function(err, res) {
  if (err) {
    return err;
  }
  return res;
});

CLI

plum-test
  --src='path/to/plum/directory'
  --dest='path/to/save/results/to'
  --stylesheets='path/to/compiled/stylesheet, path/to/another/compiled/stylesheet'

To run only a specific test(s) you can pass a comma , seperated list of paths to the the --tests.

plum-test
  --src='path/to/plum/directory'
  --dest='path/to/save/results/to'
  --stylesheets='path/to/compiled/stylesheet, path/to/another/compiled/stylesheet'
  --tests='path/to/plum/directory/modules/module-one' # only test the module-one module.

API

test( options )

Name	Type	Argument	Description
options.src	string	<required>	the src path to your plum stylesheets.
options.dest	string	<required>	the path to save the test results to.
options.stylesheets	array|string	<required>	the paths to your compiled css stylesheets.
options.tests	array|string	<optional>	the paths to the tests to be run.

callback( error, response )

Name	Type	Argument	Description
error	error	<required>	any errors that may have occured.
response	string	<required>	success message.

Developing

plum-test is built using ES6. Run the following task to compile the src/ into dist/.

npm run build

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.

License

Copyright (c) 2015 Jason Bellamy
Licensed under the MIT license.