2011-01-29 14:42:53 +00:00
|
|
|
Automated tests based on the "MonKey Testing" keytest program.
|
2011-02-02 23:18:16 +00:00
|
|
|
======================================================================
|
|
|
|
|
|
|
|
|
|
WARNING!!
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
Running the tests in this folder may cause abrupt kill of existing
|
|
|
|
|
LyX instances on your system. In order to avoid any possible data
|
|
|
|
|
loss, quit any running instance of LyX in which you're carrying out
|
|
|
|
|
real work. Also, although precautions have been taken in order to not
|
|
|
|
|
allow the key presses to reach non-LyX windows, this may sometimes
|
|
|
|
|
happen anyway. Please, close any running application that is not
|
|
|
|
|
strictly needed.
|
|
|
|
|
|
2011-01-29 14:42:53 +00:00
|
|
|
|
2011-01-30 15:58:08 +00:00
|
|
|
DEPENDENCIES
|
2011-02-02 23:18:16 +00:00
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
The following programs are needed by the testing framework:
|
|
|
|
|
- xvkbd: a modified copy of xvkbd is included in this folder, and should
|
|
|
|
|
be built before running the tests
|
|
|
|
|
- wmctrl
|
|
|
|
|
- pcregrep
|
2011-01-30 15:58:08 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
USAGE
|
2011-02-02 23:18:16 +00:00
|
|
|
----------------------------------------------------------------------
|
2011-01-29 14:42:53 +00:00
|
|
|
In order to launch all the tests available in this folder, just run
|
|
|
|
|
|
2011-02-02 23:18:16 +00:00
|
|
|
make
|
2011-01-29 14:42:53 +00:00
|
|
|
|
2011-01-31 20:39:35 +00:00
|
|
|
and do not interact with your computer while the tests are running.
|
|
|
|
|
|
2011-01-29 14:42:53 +00:00
|
|
|
If you wish to launch one or more specific tests, then provide them
|
2011-02-02 23:18:16 +00:00
|
|
|
as argument to the run-tests.sh script, e.g.:
|
2011-01-29 14:42:53 +00:00
|
|
|
|
|
|
|
|
./run-tests.sh <whatever>*-in.txt
|
|
|
|
|
|
|
|
|
|
For failed tests you get a folder with the logs that help you identify
|
|
|
|
|
the problem.
|
2011-01-30 15:58:08 +00:00
|
|
|
|
|
|
|
|
|
2011-02-02 23:18:16 +00:00
|
|
|
SYNTAX
|
|
|
|
|
----------------------------------------------------------------------
|
2011-01-30 15:58:08 +00:00
|
|
|
Each test-case script should be named as xxx-in.txt. The syntax of the
|
|
|
|
|
script is described in detail in the sample test-case script
|
|
|
|
|
hello-world-in.txt.
|
|
|
|
|
|
|
|
|
|
|
2011-02-02 23:18:16 +00:00
|
|
|
TODO
|
|
|
|
|
----------------------------------------------------------------------
|
2011-01-30 15:58:08 +00:00
|
|
|
Speed-up the execution of the tests as much as possible (i.e., get rid
|
|
|
|
|
of heuristic waits when present and replace them with exact check of
|
|
|
|
|
the condition we're waiting for).
|
|
|
|
|
|
|
|
|
|
Allow for tests with multiple LyX instances, e.g., for copy&paste
|
|
|
|
|
across LyX instances, or multiple applications, i.e., for testing
|
|
|
|
|
the interaction between LyX and other applications.
|
