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 uses 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
--config=CONFIG
                        Path to alternative config location. Otherwise the configuration file is
                        expected to be named after test case class, located either next to test module or path
                        defined by environment variable ``FL_CONF_PATH``
--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.
