Manual Pages for UNIX Darwin command on man trial

TRIAL(1) TRIAL(1)

NAME

trial - run unit tests

SYNOPSIS

ttrriiaall [[ooppttiioonnss]] [[[[ffiillee||ppaacckkaaggee||mmoodduullee||TTeessttCCaassee||tteessttmmeetthhoodd]]......]]

ttrriiaall --hheellpp

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.testmethod' are all valid ways to

invoke trial.

-bb, --ddeebbuugg

Run the tests in the Python debugger. Also does post-mortem

debugging on exceptions.

-BB, --ddeebbuugg-ssttaacckkttrraacceess

Report Deferred creation and callback stack traces

--ccoovveerraaggee

Generate coverage information in trialtemp/coverage/. Requires

Python 2.3 or higher.

--ddiissaabblleeggcc

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

trial.

-ee, --rrtteerrrroorrss

Print tracebacks to standard output as soon as they occur

--ffoorrccee-ggcc

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.

-hh, --hheellpp

Print a usage message to standard output, then exit.

--hheellpp-rreeppoorrtteerrss

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

--hheellpp-rreeaaccttoorrss

List the names of possibly available reactors.

-ll, --llooggffiillee

Direct the log to a different file. The default file is

'test.log'. is relative to trialtemp.

-nn, --ddrryy-rruunn

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

-NN, --nnoo-rreeccuurrssee

By default, trial recurses through packages to find every module

inside every subpackage. Unless, that is, you specify this option.

--nnooppmm Don't automatically jump into debugger for post-mortem analysis

of exceptions. Only usable in conjunction with -debug.

--pprrooffiillee

I don't know what this option does.

-rr, --rreeaaccttoorr

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

--rreeccuurrssiioonnlliimmiitt

Set Python's recursion limit. I don't know why this is in

trial.

--rreeppoorrtteerr

Select the reporter to use for Trial's output. Use the -help-

reporters option to see a list of valid reporters.

--ssppeeww Print an insanely verbose log of everything that happens. Useful

when debugging freezes or locks in complex code.

--ttbbffoorrmmaatt

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

--tteemmpp-ddiirreeccttoorryy <>

WARNING: Do not use this options unless you know what you are

doing. By default, trial creates a directory called trialtemp

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 trialtemp. Be warned, trial will

delete the directory before re-creating it.

--tteessttmmoodduullee <>

Ask trial to look into and run any tests specified

using the Emacs-style buffer variable 'test-case-name'.

-uu, --uunnttiill-ffaaiilluurree

Keep looping the tests until one of them raises an error or a

failure. This is particularly useful for reproducing intermit-

tent failures.

-zz, --rraannddoomm [[<>]]

Run the tests in random order using the specified seed. AUTHOR Written by Jonathan M. Lange

REPORTING BUGS

To report a bug, visit http://twistedmatrix.com/bugs/ COPYRIGHT

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. July 2006 TRIAL(1)