README
1This is the JavaScript testing area for Jemplate. If you are new to testing
2Jemplate, please read this.
3
4== RUNNING THE TESTS ==
5
6There are currently three ways to run these JavaScript tests.
7
81) If you have Plack.pm installed, run this command and follow the printed
9 instructions:
10
11 make clean test
12
132) If you have some other webserver pointing at this directory you can just go
14 to the appropriate URL (+ index.html) and all the tests will run in your
15 browser.
16
173) You can do the following commands:
18
19 cd tjs
20 make clean test
21
22The output will tell you a URL to load in your browser to run the tests.
23
24== ADDING OR CHANGING TESTS ==
25
26This directory contains a bunch of files that look like this:
27
28 t/basic.t.html
29
30All the tests reside in the t/ directory. They have names like:
31
32 t/basic.t.js
33
34Each html file runs the corresponding js test. The file index.html runs
35all the tests. All of the html files are generated. To regenerate all
36the files, run this command:
37
38 make clean all
39
40All these generated HTML files are checked into the Jemplate repository.
41This is so that they will run in place on CPAN or JSAN. (Yes, you can
42actually run the Jemplate tests directly from CPAN and JSAN.)
43
44== NOTES ON TJS ==
45
46The tjs/ directory gives you more control for running tests. You can
47build/test different runtimes with commands like:
48
49 make test
50 make test-jquery
51 make test-yui
52
53All of the test files and most of the rest of the files under tjs/ are
54symlinks to the canonical tests above the tjs/ directory.
55
56Also all of the html files (and other stuff) generated by the make
57commands goes under tjs/var/. These files never get checked into the
58Jemplate repository.
59
60