---
name: "trial2.2"
section: "1"
platform: "linux"
package: "python2.2-twisted"
version: "1.3.0-8"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/trial2.2"
---

# trial2.2(1)

run unit tests

## NAME

trial - run unit tests

## SYNOPSIS

**trial** \[-b\] \[-v\|-o\|-j\] \[--coverage *coverdir*\] \[-r *reactor*\] \[-l *logfile*\] \[-m *module* \[-m *module* ... \]\] \[-p *package* \[-p *package* ... \]\] *file*\|*module*\|*package*\|*TestCase*\|*testMethod ...*

**trial --help**

## DESCRIPTION

*trial loads and executes a suite of unit tests, obtained from modules and* *packages listed on the command line.* *The* **--help** option prints out a usage message to standard output.

- **-s**, **--summary**

  Print out just a machine-parseable summary of the results.

- **-v**, **--verbose**

  Be more verbose. Without this option, trial prints out a single character for each test. (e.g. An 'F' for a failure, a '.' for a success, a 'S' for skipped test, a 'T' for a todo and '!' for unexpected success). With this option, trial prints a single line for each test. This is especially useful for gauging how long each test takes.

- **-o**, **--bwverbose**

  Be verbose, but do not attempt to use colors (more log-file friendly)

- **-j**, **--jelly**

  Report results in a machine-readable jelly stream.

- **--timing**

  Report results with timing information for each test.

- **--tbformat** \<format\>

  Format to display tracebacks with. Valid values are 'plain' and 'emacs', default being 'plain'.

- **-m**, **--module** \<module\>

  Module containing test cases.

- **--testmodule** \<module\>

  Find the test case for a named file

- **-p**, **--package** \<package\>

  Package containing modules that contain test cases. trial loads modules named 'test\_' within the given package.

- **-l**, **--logfile** \<logfile\>

  Log exceptions (and other things) to the given logfile.

- **-r**, **--reactor** \<reactor\>

  Use this reactor for running the tests. The reactor names are the same as those accepted by twistd: c, qt, gtk2, and so on.

- **--coverage** \<coverdir\>

  Generate coverage information in the given directory (relative to  \_trial\_temp). Requires Python 2.3.3.

- **-b**, **--debug**

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

- **-R**, **--recurse**

  Recursively search the specified packages for test modules.

## AUTHOR

Written by Jonathan M. Lange

## REPORTING BUGS

Report bugs to \<twisted-python@twistedmatrix.com\>.

## COPYRIGHT

Copyright © 2003 Matthew W. Lefkowitz\
 This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.