explicitly set charset=UTF-8 on docs; fixes Usage Gallery display issue.
[dygraphs.git] / auto_tests / README
1 These tests are run with js-test-driver
2 (http://code.google.com/p/js-test-driver/).
3
4 Running tests
5 -------------
6
7 - Start a terminal window at the dygraphs root directory (one
8   directory up from here.)
9
10 - From there, you start the test server and capture at least one slave
11   browser:
12
13    Run:
14    $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --port 9876
15   
16    Open
17    http://localhost:9876/capture
18    in the browser you want to use for your test.
19
20 - Run the tests with:
21
22   $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --tests all
23
24
25 Debugging tests
26 ---------------
27
28 This is a bit of a hack, but you can also run tests manually inside the browser
29 using auto_tests/misc/local.html.
30
31 Once you've opened that page, open up the JavaScript console and run something
32 like:
33
34   new SimpleDrawingTestCase().runTest("testDrawSimpleRangePlusOne")
35
36 to run just one test. This is useful for seeing the dygraph that the test
37 creates, setting breakpoints, etc.
38
39 Please don't rely on it as proof that your tests pass; the command-line is the
40 reference for ensuring Dygraphs automated tests pass.
41
42
43 (This is a specialized version of the instructions found at 
44 http://code.google.com/p/js-test-driver/wiki/GettingStarted.
45 They're listed as a courtesy, but you really should get to understand
46 js-test-driver, which has lots of powerful features.)