Test runner fl-run-test usage

fl-run-test [options] file [class.method|class|suite] [...]

fl-run-test launch a FunkLoad unit test.

A FunkLoad unittest use a configuration file named [class].conf, this configuration is overriden by the command line options.

See http://funkload.nuxeo.org/ for more information.

Examples

fl-run-test myFile.py
Run all tests.
fl-run-test myFile.py test_suite
Run suite named test_suite.
fl-run-test myFile.py MyTestCase.testSomething
Run a single test MyTestCase.testSomething.
fl-run-test myFile.py MyTestCase
Run all ‘test*’ test methods in MyTestCase.
fl-run-test myFile.py MyTestCase -u http://localhost
Same against localhost.
fl-run-test –doctest myDocTest.txt
Run doctest from plain text file (requires python2.4).
fl-run-test –doctest -d myDocTest.txt
Run doctest with debug output (requires python2.4).
fl-run-test myfile.py -V
Run default set of tests and view in real time each page fetch with firefox.
fl-run-test myfile.py MyTestCase.testSomething -l 3 -n 100
Run MyTestCase.testSomething, reload one hundred time the page 3 without concurrency and as fast as possible. Output response time stats. You can loop on many pages using slice -l 2:4.
fl-run-test myFile.py -e [Ss]ome
Run all tests that match the regex [Ss]ome.
fl-run-test myFile.py -e ‘!xmlrpc$’
Run all tests that does not ends with xmlrpc.
fl-run-test myFile.py –list
List all the test names.
fl-run-test -h
More options.

Options

--version show program’s version number and exit
--help, -h show this help message and exit
--quiet, -q Minimal output.
--verbose, -v Verbose output.
--debug, -d FunkLoad and doctest debug output.
--debug-level=DEBUG_LEVEL
 Debug level 3 is more verbose.
--url=MAIN_URL, -u MAIN_URL
 Base URL to bench without ending ‘/’.
--sleep-time-min=FTEST_SLEEP_TIME_MIN, -m FTEST_SLEEP_TIME_MIN
 Minumum sleep time between request.
--sleep-time-max=FTEST_SLEEP_TIME_MAX, -M FTEST_SLEEP_TIME_MAX
 Maximum sleep time between request.
--dump-directory=DUMP_DIR
 Directory to dump html pages.
--firefox-view, -V
 Real time view using firefox, you must have a running instance of firefox in the same host.
--no-color Monochrome output.
--loop-on-pages=LOOP_STEPS, -l LOOP_STEPS
 Loop as fast as possible without concurrency on pages, expect a page number or a slice like 3:5. Output some statistics.
--loop-number=LOOP_NUMBER, -n LOOP_NUMBER
 Number of loop.
--accept-invalid-links
 Do not fail if css/image links are not reachable.
--simple-fetch Don’t load additional links like css or images when fetching an html page.
--stop-on-fail Stop tests on first failure or error.
--regex=REGEX, -e REGEX
 The test names must match the regex.
--list Just list the test names.
--doctest Check for a doc test.
--pause Pause between request, press ENTER to continue.