From 9ec17b011b0b131ef330dc654ebf00135849361e Mon Sep 17 00:00:00 2001 From: Vincent Sanders Date: Mon, 23 Mar 2020 12:29:05 +0000 Subject: Document the integration test setup --- docs/development.md | 44 +++----------------------------------------- 1 file changed, 3 insertions(+), 41 deletions(-) (limited to 'docs/development.md') diff --git a/docs/development.md b/docs/development.md index c9268d4d4..5a8d1aa86 100644 --- a/docs/development.md +++ b/docs/development.md @@ -65,47 +65,9 @@ functions. # Integration testing -The monkey frontend is used to perform complex tests involving -operating the browser as a user might (opening windows, navigating to -websites and rendering the contents etc.) - -A test is written as a set of operations in a yaml file. A test can be -run using the monkey_driver.py python script - - $ ./test/monkey_driver.py -m ./nsmonkey -t test/monkey-tests/start-stop.yaml - -There are very few tests within the netsurf repository. The large -majority of integration tests are held within the -[netsurf-test](http://source.netsurf-browser.org/netsurf-test.git/) -repository. - -To allow more effective use of these tests additional infrastructure -has been constructed to allow groupings of tests to be run. This is -used extensively by the CI system to perform integration testing on -every commit. - -Each test is a member of a group and the tests within each group are -run together. Groups are listed within division index files. To run -the integration tests the monkey-see-monkey-do python script is -used. It downloads the test plan for a division from the netsurf test -infrastructrure and executes it. - - $ ./test/monkey-see-monkey-do - Fetching tests... - Parsing tests... - Running tests... - Start group: initial - [ Basic checks that the browser can start and stop ] - => Run test: start-stop-no-js.yaml - => Run test: basic-navigation.yaml - => Run test: start-stop.yaml - Start group: no-networking - [ Tests that require no networking ] - => Run test: resource-scheme.yaml - Start group: ecmascript - [ ECMAScript tests ] - PASS - +NetSurf [integration tests](docs/integration-testing.md) use the +monkey frontend to operate the browser as a whole. These tests open +windows, navigate to websites and render contents as a user might. # Documented API -- cgit v1.2.3