Manual - Section 1: trial

NAME

trial - run unit tests

SYNOPSIS

trial [options] [[file|package|module|TestCase|testmethod]...]

trial --help

DESCRIPTION

trial loads and executes a suite of unit tests, obtained from modules, packages and files listed on the command line.

trial will take either filenames or fully qualified Python names as arguments. Thus ’trial myproject/foo.py’, ’trial myproject.foo’ and ’trial myproject.foo.SomeTestCase.test_method’ are all valid ways to invoke trial.

-b, --debug

Run the tests in the Python debugger. Also does post-mortem debugging on exceptions. Will load ’.pdbrc’ from current directory if it exists.

-B, --debug-stacktraces

Report Deferred creation and callback stack traces

--coverage

Generate coverage information in _trial_temp/coverage/. Requires Python 2.3 or higher.

--disablegc

Disable the garbage collector. I don’t know why this is in trial.

-x, --extra

Add an extra argument. (This is a hack necessary for interfacing with emacs’s ‘gud’.)

-e, --rterrors

Print tracebacks to standard output as soon as they occur

--force-gc

Run gc.collect() before and after each test case. This can be used to isolate errors that occur when objects get collected. This option would be the default, except it makes tests run about ten times slower.

-h, --help

Print a usage message to standard output, then exit.

--help-reporters

Print a list of valid reporters to standard output, then exit.

--help-reactors

List the names of possibly available reactors.

-l, --logfile <logfile>

Direct the log to a different file. The default file is ’test.log’. <logfile> is relative to _trial_temp.

-n, --dry-run

Go through all the tests and make them pass without running.

-N, --no-recurse

By default, trial recurses through packages to find every module inside every subpackage. Unless, that is, you specify this option.

--nopm Don’t automatically jump into debugger for post-mortem analysis of exceptions. Only usable in conjunction with --debug.

--profile

Run tests under the Python profiler.

-r, --reactor <reactor>

Choose which reactor to use. See --help-reactors for a list.

--recursionlimit

Set Python’s recursion limit. See sys.setrecursionlimit()

--reporter

Select the reporter to use for Trial’s output. Use the --help-reporters option to see a list of valid reporters.

--spew Print an insanely verbose log of everything that happens. Useful when debugging freezes or locks in complex code.

--tbformat <format>

Format to display tracebacks with. Acceptable values are ’default’, ’brief’ and ’verbose’. ’brief’ produces tracebacks that play nicely with Emacs’ GUD.

--temp-directory <directory>

WARNING: Do not use this options unless you know what you are doing. By default, trial creates a directory called _trial_temp under the current working directory. When trial runs, it first deletes this directory, then creates it, then changes into the directory to run the tests. The log file and any coverage files are stored here. Use this option if you wish to have trial run in a directory other than _trial_temp. Be warned, trial will delete the directory before re-creating it.

--testmodule <filename>

Ask trial to look into <filename> and run any tests specified using the Emacs-style buffer variable ’test-case-name’.

--unclean-warnings

As of Twisted 8.0, trial will report an error if the reactor is left unclean at the end of the test. This option is provided to assist in migrating from Twisted 2.5 to Twisted 8.0 and later. Enabling this option will turn the errors into warnings.

-u, --until-failure

Keep looping the tests until one of them raises an error or a failure. This is particularly useful for reproducing intermittent failures.

--version

Prints the Twisted version number and exit.

--without-module <modulenames>

Simulate the lack of the specified comma-separated list of modules. This makes it look like the modules are not present in the system, causing tests to check the behavior for that configuration.

-z, --random [<seed>]

Run the tests in random order using the specified seed.

Manual - Section 1: trial

Linux Online Man Pages for openSUSE 11.2 "Emerald"

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

REPORTING BUGS

COPYRIGHT

Contents

-b, --debug
	Run the tests in the Python debugger. Also does post-mortem debugging on exceptions. Will load ’.pdbrc’ from current directory if it exists.
-B, --debug-stacktraces
	Report Deferred creation and callback stack traces
--coverage
	Generate coverage information in _trial_temp/coverage/. Requires Python 2.3 or higher.
--disablegc
	Disable the garbage collector. I don’t know why this is in trial.
-x, --extra
	Add an extra argument. (This is a hack necessary for interfacing with emacs’s ‘gud’.)
-e, --rterrors
	Print tracebacks to standard output as soon as they occur
--force-gc
	Run gc.collect() before and after each test case. This can be used to isolate errors that occur when objects get collected. This option would be the default, except it makes tests run about ten times slower.
-h, --help
	Print a usage message to standard output, then exit.
--help-reporters
	Print a list of valid reporters to standard output, then exit.
--help-reactors
	List the names of possibly available reactors.
-l, --logfile <logfile>
	Direct the log to a different file. The default file is ’test.log’. <logfile> is relative to _trial_temp.
-n, --dry-run
	Go through all the tests and make them pass without running.
-N, --no-recurse
	By default, trial recurses through packages to find every module inside every subpackage. Unless, that is, you specify this option.
--nopm	Don’t automatically jump into debugger for post-mortem analysis of exceptions. Only usable in conjunction with --debug.
--profile
	Run tests under the Python profiler.
-r, --reactor <reactor>
	Choose which reactor to use. See --help-reactors for a list.
--recursionlimit
	Set Python’s recursion limit. See sys.setrecursionlimit()
--reporter
	Select the reporter to use for Trial’s output. Use the --help-reporters option to see a list of valid reporters.
--spew	Print an insanely verbose log of everything that happens. Useful when debugging freezes or locks in complex code.
--tbformat <format>
	Format to display tracebacks with. Acceptable values are ’default’, ’brief’ and ’verbose’. ’brief’ produces tracebacks that play nicely with Emacs’ GUD.
--temp-directory <directory>
	WARNING: Do not use this options unless you know what you are doing. By default, trial creates a directory called _trial_temp under the current working directory. When trial runs, it first deletes this directory, then creates it, then changes into the directory to run the tests. The log file and any coverage files are stored here. Use this option if you wish to have trial run in a directory other than _trial_temp. Be warned, trial will delete the directory before re-creating it.
--testmodule <filename>
	Ask trial to look into <filename> and run any tests specified using the Emacs-style buffer variable ’test-case-name’.
--unclean-warnings
	As of Twisted 8.0, trial will report an error if the reactor is left unclean at the end of the test. This option is provided to assist in migrating from Twisted 2.5 to Twisted 8.0 and later. Enabling this option will turn the errors into warnings.
-u, --until-failure
	Keep looping the tests until one of them raises an error or a failure. This is particularly useful for reproducing intermittent failures.
--version
	Prints the Twisted version number and exit.
--without-module <modulenames>
	Simulate the lack of the specified comma-separated list of modules. This makes it look like the modules are not present in the system, causing tests to check the behavior for that configuration.
-z, --random [<seed>]
	Run the tests in random order using the specified seed.