Had to figure this all out for something else, so figured I'd document it. Eventually we may have so many tests that running one in isolation will be handy.
Signed-off-by: Bryce Harrington <br...@osg.samsung.com> --- testing.html | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/testing.html b/testing.html index 660cee9..e5781fe 100644 --- a/testing.html +++ b/testing.html @@ -73,6 +73,49 @@ $ make check $ make check BACKEND=x11-backend.so </pre> +<h3>Running Individual Tests</h3> +<p> +The <code>check</code> target essentially executes all tests registered +in the <code>TESTS</code> variable in Makefile.am. Files with +a <code>.test</code> extension are run directly, e.g.:</p> + +<pre> +$ ./vertex-clip.test +test "float_difference_same":exit status 0, pass. +... +16 tests, 16 pass, 0 skip, 0 fail +</pre> + +<p>Tests suffixed with <code>.la</code> and <code>.weston</code> are run +using the <code>tests/weston-tests-env</code> shell script, which you can +use to run individual tests, thusly:</p> +<pre> +$ abs_builddir=$PWD tests/weston-tests-env button.weston +</pre> + +<h3>Test Results</h3> +<p> +The <code>*.test</code> tests output their results to stdout. The other +tests write into a logs/ subdirectory and generate one log for the +server and another for the test itself. +</p> +<p> +Example output: +</p> +<pre> +test-client: got global pointer 100 100 +test-client: got keyboard keymap +test-client: got surface enter output 0x202d600 +test-client: got keyboard modifiers 0 0 0 0 +test-client: got pointer enter 0 0, surface 0x202d500 +test-client: got pointer motion 50 50 +test-client: got global pointer 150 150 +test-client: got pointer button 272 1 +test-client: got pointer button 272 0 +test "simple_button_test":exit status 0, pass. +1 tests, 1 pass, 0 skip, 0 fail +</pre> + <h3>Writing Tests</h3> <p><b>Compositor Tests</b></p> -- 1.7.9.5 _______________________________________________ wayland-devel mailing list wayland-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/wayland-devel
