Testem programmatic runner enhanced with Mincer preprocessing
THIS PROJECT HAS MIGRATED TO grunt-testem-mincer. This package is not being maintained. This exists because the new package is version incompatible with the old one and it has no version history. Therefore this exists to bridge that gap.
Run tests with Testem in a convenient way:
- Multi-environment runs ❤️
- Out-of-box support for Coffee, Ejs, JST, ... 💚
- Built-in support of Mincer 💙
This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-contrib-testem --save-dev
Within your Grunt configuration you have to define one or more environments that Testem will run with:
In the example given we pass coffee files straight into the
src and there's no mistake in that.
grunt-contrib-testem will chew it for you :godmode:.
There are two modes that you can run tests at:
grunt testem:ci:<environment>command-line CI mode
grunt testem:run:<environment>Development mode where Testem watches for modifications of files to rerun tests on your behalf
grunt testem task runs all settled environments one by one in CI mode.
Every environment can take 3 arguments which are:
src: the full list of files to run (allows unix glob masks: "path//."). Files get included into playground in the order they are listed at the array.
options: options that get passed to running instance of Testem (they are typically located at Testem config)
assets: options that can be used to configure internal instance of Mincer preprocessor
The full list of options you can use to affect Testem instance is available at Testem documentation.
Note also that you can use JS function as hooks:
Mincer.Environmentas a first parameter and
Minceritself as a second.
grunt-contrib-testem is powered by Mincer and it allows you to organize testing of almost any kind of code no matter how exactly it is organized and what preprocessing it requires. This is exactly how it works:
During initialization, plugin setups local Mincer server with project root as an inclusion path. Then it substitutes local paths with URLs served through it. So instead of passing
spec/spec.coffee to Testem (that will not work obviously), it passes
http://localhost:7358/spec/spec.coffee and Mincer takes care of the rest. It also intelligently passes proper
watch_files option to Testem so no worries – autoreload works just fine.
What does it mean in other words? It means you can utilize Mincer during the building of your specs or application files. You can use any directives and any Engines it has to offer you (or even write your own). And all that complexity will work blazing fast thanks to built-in Mincer caching! 😱
So go ahead, take a look at these samples...
... and hurry up to start using it!
Huge thanks goes to Toby Ho, the original author of Testem that was one by one accepting my pull-requests and modifications that made such integration possible.
Copyright 2013 Boris Staal
It is free software, and may be redistributed under the terms of MIT license.