forked from enlightenment/www-content
Wiki page enlightenment-regression.md changed with summary [] by Andrew Williams
This commit is contained in:
parent
4e792731c7
commit
c92a13ee81
|
@ -15,14 +15,71 @@ but it must be installed using the following instructions before it can be used.
|
||||||
|
|
||||||
The test suite should be cloned from git and installed in the usual autotools manner:
|
The test suite should be cloned from git and installed in the usual autotools manner:
|
||||||
|
|
||||||
```
|
|
||||||
$ git clone https://git.enlightenment.org/devs/discomfitor/test-e.git
|
$ git clone https://git.enlightenment.org/devs/discomfitor/test-e.git
|
||||||
$ cd test-e
|
$ cd test-e
|
||||||
$ ./autogen.sh --prefix=<your enlightenment prefix here>
|
$ ./autogen.sh --prefix=<your enlightenment prefix here>
|
||||||
$ make
|
$ make
|
||||||
$ make install
|
$ make install
|
||||||
```
|
|
||||||
|
|
||||||
## Running Tests ##
|
## Running Tests ##
|
||||||
|
|
||||||
|
Tests are invoked using the run script:
|
||||||
|
|
||||||
|
* ``./run.sh`` runs all available tests
|
||||||
|
* ``./run.sh <test1> <test2>`` run the specified tests
|
||||||
|
|
||||||
|
Graphical output is rendered to a png file matching the name of the test i.e. test1.png.
|
||||||
|
|
||||||
|
Test stdout and stderr are saved to a log file with the same name i.e. test1.log.
|
||||||
|
|
||||||
|
## Configuration ##
|
||||||
|
|
||||||
|
The following environment variables are supported to control the behaviour of the tests:
|
||||||
|
|
||||||
|
VG_ON
|
||||||
|
: Run test(s) under valgrind
|
||||||
|
|
||||||
|
GDB_ON
|
||||||
|
: Automatically print a backtrace on crash
|
||||||
|
|
||||||
|
TEST_EXIT
|
||||||
|
: Use exit() instead of logging out after tests
|
||||||
|
|
||||||
|
CLEAN
|
||||||
|
: Run ‘git clean -dxf’ before running tests
|
||||||
|
|
||||||
|
DELAY_ON
|
||||||
|
: Wait 4 extra seconds before beginning tests
|
||||||
|
|
||||||
|
STRACE_ON
|
||||||
|
: Run tests under strace
|
||||||
|
|
||||||
|
E_COMP_ENGINE
|
||||||
|
: ‘sw’ or ‘gl’ to set software or gl rendering
|
||||||
|
|
||||||
|
E_WL_FORCE
|
||||||
|
: ‘buffer’, ‘drm’, ‘x11’, ‘wl’ to set the output engine
|
||||||
|
|
||||||
|
Additionally you can change the expected outcome of a test by editing the
|
||||||
|
imgs/testname.png file. If you delete the file then it will be recreated
|
||||||
|
from the output of the next test run.
|
||||||
|
|
||||||
## Adding New Tests ##
|
## Adding New Tests ##
|
||||||
|
|
||||||
|
To add a new test to the suite follow these steps
|
||||||
|
|
||||||
|
Create src/<newtestname>.c
|
||||||
|
Copy scripts/basic.sh to scripts/<newtestname>.sh
|
||||||
|
Add src/<newtestname>.c to src/Makefile.mk
|
||||||
|
Add RUN_TEST(<newtestname>); to src/e_mod_main.c
|
||||||
|
Add TEST_FN(<newtestname>); to src/e_mod_main.h
|
||||||
|
|
||||||
|
Add the following content to src/<newtestname>.c as a starting point:
|
||||||
|
|
||||||
|
#include "e_mod_main.h"
|
||||||
|
TEST_FN(<testname>)
|
||||||
|
{
|
||||||
|
// Initialize stuff here
|
||||||
|
}
|
||||||
|
|
||||||
|
For further examples of how to write tests please check the content of existing test files.
|
Loading…
Reference in New Issue