-- markdown -- # Qjutest - qunit test runner/bootstrapper

Qjutest builds qunit test runners and downloads dependencies. There are two different uses. Either generate temporary testrunners when they are needed or generate testrunners that can be checked in with your project.

## Installation

Download source and run 'python setup.py install'. This will create a 'qjutest' script on your path.

## Usage

-h, --help show this help message and exit
-d DEST, --destination=DEST
 path where test runner should be placed
-t TESTDIR, --test-dir=TESTDIR
 directory in which to find tests
-n NAME, --name=NAME
 name of project. Used for test title
-j JSDIR, --js-dir=JSDIR
 directory to find js dependencies
-e, --external-qunit
 link to external qunit file. Don't download it
-c, --clobber overwrite existing test runner files
-w, --wait wait for keyboard before quitting/clean up
-b, --browser launch browser with test script

## Examples


Makes a temporary directory into which qunit is downloaded. Generates a test runner html file with script tags for myproj.js, feature1.js and feature2.js. Prints the location of the runner on the console. The test runner is not deleted by qjutest so the user must take care to do so himself.

./qjutest -d tests -c

Makes a new testrunner in the tests directory, overwriting it if it exists. qunit is downloaded as well, so this may be used to upgrade an existing test runner to the latest qunit release.

./qjutest -e -d infrastructure -n "My awesome project" -t testdir

Makes a new testrunner in the "infrastructure" directory, including tests from "testdir". The title of the runner document will be "My awesome project". It will not download qunit, just link to the qunit files on github.

./qjutest -b -w

Make a temporary runner and launch it in the default browser. The script will wait for any key to be pressed before removing the temporary runner and quitting.

## Administrativa

Author is Rune Halvorsen <runefh@gmail.com> and the code is hosted on http://bitbucket.org/runeh/qjutest/ .

## License

Copyright (c) 2009 Rune F. Halvorsen Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.