aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorManish Goregaokar <manishsmail@gmail.com>2014-09-14 23:14:36 +0530
committerManish Goregaokar <manishsmail@gmail.com>2014-09-14 23:14:36 +0530
commitfe31805a04854190645cc9e685963c7af9c29b07 (patch)
treeaafe889fe404f80b8311093f0b8cd8c1deef49b7
parent0b0c2ef461094b5d43a97af5d39c78f22527f8a6 (diff)
parentd3dc61c984bd95d43cf284db1a3f2681286c9621 (diff)
downloadservo-fe31805a04854190645cc9e685963c7af9c29b07.tar.gz
servo-fe31805a04854190645cc9e685963c7af9c29b07.zip
Merge pull request #3282 from gilles-leblanc/tests-readme
Updates tests README.md for mach; r=Manishearth
-rw-r--r--tests/wpt/README.md24
1 files changed, 11 insertions, 13 deletions
diff --git a/tests/wpt/README.md b/tests/wpt/README.md
index 21f1b46caf5..ddb2e59b81f 100644
--- a/tests/wpt/README.md
+++ b/tests/wpt/README.md
@@ -15,7 +15,7 @@ In particular, this folder contains:
Running the tests
=================
-The simplest way to run the tests in Servo is `make check-wpt` in the build
+The simplest way to run the tests in Servo is `./mach test` in the root
directory. This will run the subset of JavaScript tests defined in
`include.ini` and log the output to stdout.
@@ -32,18 +32,16 @@ variable. Some useful options are:
Servo simultaneously to run multiple tests in parallel for more efficiency
(especially on multi-core processors).
-Running the tests without make
+Running the tests without mach
------------------------------
-When avoiding `make` for some reason, one can run `run.py` directly. However,
-this requires in the first place that the virtualenv has been set up (which can
-be done by running `make check-wpt` in advance). Then run from the build
-directory:
+When avoiding `mach` for some reason, one can run `run.py` directly. However,
+this requires in the first place that the virtualenv has been set up. To set up
+the virtualenv and run the tests run the following from the root directory:
- source _virtualenv/bin/activate
- python $srcdir/src/test/wpt/run.py --config srcdir/src/test/wpt/config.ini
+ bash tests/wpt/run.sh
-with any other desired arguments.
+You can substitute `bash` for another shell which supports `source`.
Running the tests manually
--------------------------
@@ -59,7 +57,7 @@ first adding the following to the system's hosts file:
127.0.0.1 xn--n8j6ds53lwwkrqhv28a.web-platform.test
127.0.0.1 xn--lve-6lad.web-platform.test
-and then running `python serve.py` from `src/tests/wpt/web-platform-tests`.
+and then running `python serve.py` from `tests/wpt/web-platform-tests`.
Then navigate Servo to `http://web-platform.test:8000/path/to/test`.
Updating test expectations
@@ -73,13 +71,13 @@ remove `.ini` files that no longer contain any expectations.
When a larger number of changes is required, this process can be automated.
This first requires saving the raw, unformatted log from a test run, for
-example by running `WPTARGS=--log-raw /tmp/servo.log make check-wpt`. Once the
-log is saved, run from the build directory:
+example by running `./mach test-wpt --log-raw /tmp/servo.log`. Once the
+log is saved, run from the root directory:
source _virtualenv/bin/activate
_virtualenv/bin/wptupdate \
--ignore-existing \
- --config $srcdir/src/test/wpt/config.ini \
+ --config tests/wpt/config.ini \
/tmp/servo.log
This will update the `.ini` files under the `metadata` folder; commit those