Running the Demo's Selenium Tests

The deformdemo application serves as a target for functional
testing during Deform's development. A suite of Selenium tests may be
run against a local instance of the demonstration application. It is
wise to run these tests before submitting a patch. Here's how:

Make sure you have a Java interpreter installed.

Start the deformdemo application as described above in "Running
the Demo". Leave the terminal window running this application open,
and open another terminal window to perform the below steps.

Leave the terminal window in which the selenium server is now
running open, and open (yet) another terminal window.

In the newest terminal window, cd to the "deformdemo" checkout directory
you created above in "Running the Demo":

$ cd /path/to/my/deformdemo/checkout

Run the tests:

$ $VENV/bin/python deformdemo/test.py

$VENV is defined as it was in "Running the Demo" above.

You will (hopefully) see Firefox pop up in a two-windowed
arrangement, and it will begin to display in quick succession the
loading of pages in the bottom window and some test output in the
top window. The tests will run for a minute or two.

Test success means that the console window on which you ran
test.py shows a bunch of dots, a test summary, then OK. If
it shows a traceback, FAILED, or anything other than a straight
line of dots, it means there was an error.

Fix any errors by modifying your code or by modifying the tests to
expect the changes you've made.

Testing an Alternate Renderer Implementation

Copy the demo.ini file from this demo package to your renderer's
package.

Change the deform.renderer key in the demo.ini copy to point at
your renderer (it's a Python dotted name).