aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Benjamin Jones <bjones@galois.com>2013-05-24 16:17:02 -0700
committerGravatar Benjamin Jones <bjones@galois.com>2013-05-24 16:17:02 -0700
commit9fcfe08332ec6a1ccb77706d3edb6f83989d29ab (patch)
tree01c25030022642beb292cb8a9156188950f18d93
parent74df0b8481f6f59819dc2c9dd4377cfecadfd0be (diff)
added tests/README.md
-rw-r--r--contexts/data/tests/README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/contexts/data/tests/README.md b/contexts/data/tests/README.md
new file mode 100644
index 0000000..dbd8435
--- /dev/null
+++ b/contexts/data/tests/README.md
@@ -0,0 +1,30 @@
+Running Tests
+=============
+
+The Javascript unit tests for FiveUI can be run in one of two ways, manually in
+your browser, or in a headless context (better for automation/continuous
+integration).
+
+In Browser
+----------
+
+Start a local webserver at the FiveUI project root ($FIVEUI_ROOT) and load
+`contexts/data/tests/SpecRunner.html`.
+
+Headless
+--------
+
+Install [phantomjs](http://phantomjs.org/) on your system.
+
+ - Debian/Ubuntu: apt-get install phantomjs
+ - Fedora: yum install phantomjs
+ - Mac OSX: brew install phantomjs
+
+Run:
+
+ $ cd contexts/data
+ $ phantomjs lib/phantomjs_jasmine/phantomjs_jasminexml_runner.js \
+ tests/PhantomJSJasmineRunner.html tests/reports/
+
+XML test reports will be generated in
+`$FIVEUI_ROOT/contexts/data/tests/reports/`.