spritesmith-engine-test

5.1.1 • Public • Published

spritesmith-engine-test Build Status

Common test suite for spritesmith engines

These files were written for usage with mocha

Specification version

The current repository version is built to match specification version:

2.0.0

Specification documentation can be found at:

https://github.com/twolfson/spritesmith-engine-spec/tree/2.0.0

Getting started

Install the module via: npm install spritesmith-engine-test

Create files that require and run the test suite:

test/myengine_test.js:

// Load in dependencies
var spritesmithEngineTest = require('spritesmith-engine-test');
var MyEngine = require('../lib/engine');

// Run our test suite
// DEV: This loads and define multiple `mocha` test suites
spritesmithEngineTest.run({
  engine: MyEngine,
  engineName: 'myengine'
});

Run your tests via mocha:

# Install test dependencies
npm install mocha

# Run mocha test suite
./node_modules/.bin/mocha test/
#  myengine
#    interpretting an image file
#      ✓ gathers statistics on an image file
#  ...

Documentation

spritesmith-engine-test exports the following keys its module.exports:

  • config Object - Assortment of configurations used for each test suite
    • See lib/config.js for documentation
    • Feel free to reuse these in any of your one-off tests
  • run Function - Test suite runner
    • Documentation cane be found below
  • spritesmithUtils Object - One-off utilities for our test mocha suites
    • See lib/utils/ for documentation
    • Feel free to reuse these in any of your one-off tests

run(params)

Generates a set of mocha test suites for a spritesmith engine

  • params Object - Container for test setup
    • engine Object - spritesmith engine as defined by spritesmith-engine-spec
    • engineName String - Name of engine to use in test suites
    • engineOptions Object - Optional options to pass to engine constructor
    • tests Object - Optional overrides to enable/disable tests
      • By default, all tests will run
      • Signature should be testName: boolean (e.g. {interpretPngImage: false})
      • A list of tests can be found below

Example with tests:

spritesmithEngineTest.run({
  engine: myengine,
  engineName: 'myengine',
  // Skip over rendering a GIF image
  tests: {
    renderGifCanvas: false
  }
});

Tests

Our test suite has the following tests built into it:

  • assertSpecVersion - Verify the engine has a specVersion for the corresponding specification
  • interpretPngImage - Loads a PNG image and asserts we get the correct height/width
  • interpretJpegImage - Same as interpretPngImage but for a JPEG (using format: 'jpeg')
  • interpretJpgImage - Same as interpretPngImage but for a JPEG (using format: 'jpg')
  • interpretGifImage - Same as interpretPngImage but for a GIF
  • renderPngCanvas - Loads a PNG image, renders it via the export, and asserts the image is more/less the same
  • renderJpgCanvas - Same as renderPngCanvas but for a JPG
  • renderGifCanvas - Same as renderPngCanvas but for a GIF
  • renderPngBufferVinylCanvas - Same as renderPngCanvas but uses a buffer-based Vinyl object instead of a filepath
  • renderPngStreamVinylCanvas - Same as renderPngCanvas but uses a stream-based Vinyl object instead of a filepath
  • renderPngNullVinylCanvas - Same as renderPngCanvas but uses a null-based Vinyl object instead of a filepath
  • renderMultiplePngImages - Load multiple images, place them at different spots on a canvas, and verify the placements are respected
  • renderManyPngImages - Load 500 images and render them on a canvas
    • This is to verify each engine can handle a signficant amount of images
  • interpretLargePngImage - Load an 800x600 image and assert we get the correct height/width
    • This is part of a regression we encountered in phantomjssmith

Donating

Support this project and others by twolfson via donations.

http://twolfson.com/support-me

License

Copyright (c) 2013-2014 Todd Wolfson

Licensed under the MIT license.

Readme

Keywords

Package Sidebar

Install

npm i spritesmith-engine-test

Weekly Downloads

8

Version

5.1.1

License

MIT

Unpacked Size

46.9 kB

Total Files

21

Last publish

Collaborators

  • twolfson