UNPKG

grunt-jstestdriver

Version:

Grunt task for uniting testing using JS Test Driver.

76 lines (48 loc) 2.98 kB
Jasmine Adapter for [JsTestDriver][jstd] ======================================== Author ------ * Olmo Maldonado (me@ibolmo.com) * Misko Hevery (misko@hevery.com) * Christoph Pojer (christoph.pojer@gmail.com) Requirements ------------ - [JsTestDriver (JSTD)][jstd] - [Jasmine][jasmine] Usage ----- Create, or update, a `jstestdriver.conf` file (see [wiki page][jstd-conf] for more info). Update your `jstestdriver.conf` by prepending the jasmine library and the adapter's source files. For example: load: - "../jasmine/lib/jasmine-1.0.1.js" - "../JasmineAdapter/src/*" - "your_source_files.js" - "your_test_files.js" Copy `server.sh` and `test.sh` (included) to your working directory, for convenience. # copy cp /path/to/jasmine-jstestdriver-adapter/*.sh ./ First: run `server.sh` and supply `-p`, for port, and `-j`, path to `jstestdriver.jar` or follow the convention defined in the `.sh` scripts (see Caveats below). Open up [http://localhost:9876/capture](http://localhost:9876/capture) (update for your port) in any browser. Finally: run `test.sh` to test all tests (specs) included with the `jstestdriver.conf`. Optionally pass a `-j` and `-t` arguments to `test.sh` to set the path to `jstestdriver.jar` and any test you'd only like to run, respectively. Directory Layout ---------------- - src: The adapter source code. Intent is to match interface with interface. - src-test: The test files that verifies that the adapter works as intended. Caveats ------- ### jsTestDriver.conf and *.sh files The files located in this repo assume that the parent folder has the jasmine source and a jstestdriver compiled available. Update the paths, or pass arguments (as explained above), to reflect your own layout if you'd like to test the adapter. ### JSTD 1.3.2 This release has a [known bug (232)](http://code.google.com/p/js-test-driver/issues/detail?can=2&q=223&colspec=ID%20Type%20Status%20Priority%20Milestone%20Owner%20Summary&id=223) with relative paths. Quick solution is to place the `jasmine.js` and `JasmineAdapter.js` inside of the **absolute** path. In other words, make sure you do not use `..`. Other options are to: use a 1.3.1.jar or compile a jar from the HEAD (trunk) of the [JSTD][jstd] repository. Changes ------- * 1.1 - 2011-04-06 Olmo refactors and clean code into a more encapsulated adapter. * 1.0 - 2010-12-14 Misko completely rewrites the adapter and is now a passthru for JSTD. Adds ddescribe and iit. * 0.5 - 2010-10-03 Chistoph has been improving the code and fixing bugs. Adds .sh files for simple run of server and client. * 0.2 - 2010-04-22 Misko fixes and refactors the adapter: beforeEach, afterEach, and nesting supported. * 0.1 - 2009-12-10 Olmo Initial release. Some support for beforeEach, afterEach, and matchers. [jstd]: http://code.google.com/p/js-test-driver [jstd-conf]: http://code.google.com/p/js-test-driver/wiki/ConfigurationFile [jasmine]: http://github.com/pivotal/jasmine