X-Git-Url: https://adrianiainlam.tk/git/?a=blobdiff_plain;f=auto_tests%2FREADME;fp=auto_tests%2FREADME;h=0000000000000000000000000000000000000000;hb=9b62fb423238c196c50c06ad2671998136795eae;hp=d0f34f4806d773b6258a9fada1250b2bba952ee6;hpb=3123ca57f71d145bb5bcc4a2f754d3dff3225346;p=dygraphs.git diff --git a/auto_tests/README b/auto_tests/README deleted file mode 100644 index d0f34f4..0000000 --- a/auto_tests/README +++ /dev/null @@ -1,92 +0,0 @@ -These tests are run with js-test-driver -(http://code.google.com/p/js-test-driver/). - -Running tests -------------- - -With phantomjs: - -- Install phantomjs (http://www.phantomjs.org). - -- Start a terminal window at the dygraphs root directory (one - directory up from here.) - -- Run "./test.sh". This will tell you whether the tests passed. - - -With a real browser: - -- Start a terminal window at the dygraphs root directory (one - directory up from here.) - -- From there, you start the test server and capture at least one slave - browser: - - Run: - $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --port 9876 - - Open - http://localhost:9876/capture - in the browser you want to use for your test. - -- Run the tests with: - - $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --tests all - - -Debugging tests ---------------- - -This is a bit of a hack, but you can also run tests manually inside the browser -using auto_tests/misc/local.html. - -Once you've opened that page, open up the JavaScript console and run something -like: - - new SimpleDrawingTestCase().runTest("testDrawSimpleRangePlusOne") - -to run just one test. This is useful for seeing the dygraph that the test -creates, setting breakpoints, etc. - -Please don't rely on it as proof that your tests pass; the command-line is the -reference for ensuring Dygraphs automated tests pass. - - -(This is a specialized version of the instructions found at -http://code.google.com/p/js-test-driver/wiki/GettingStarted. -They're listed as a courtesy, but you really should get to understand -js-test-driver, which has lots of powerful features.) - - -Code Coverage -------------- - -To generate code coverage data, start the jstd test server: - - $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --port 9876 - -Then run the tests with the --outputCoverage option: - - $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --tests all --testOutput . - -This can take a few minutes. It will spew out gobs of XML files, which should -be deleted. The one file you care about is jsTestDriver.conf-coverage.dat. It -contains LCOV-format coverage data. It contains coverage data for _all_ JS -files, including the tests themselves and library code which is irrelevant for -coverage analysis. So you need to filter it down: - - $ cat jsTestDriver.conf-coverage.dat | ./auto_tests/misc/filter-lcov.py - -To post the coverage data to coveralls, you'll need to export a few environment -variables and install node-coveralls: - - $ npm install # installs node-coveralls, which is listed in package.json - $ export COVERALLS_SERVICE_NAME=jstd - $ export COVERALLS_REPO_TOKEN=... # get this by visiting http://coveralls.io - $ export COVERALLS_GIT_COMMIT=$(git rev-parse HEAD) - $ cat jsTestDriver.conf-coverage.dat \ - | ./auto_tests/misc/filter-lcov.py \ - | ./node_modules/coveralls/bin/coveralls.js - -If all goes well, you should see your coverage data posted at -https://coveralls.io/r/danvk/dygraphs.