trial man page on Debian

Man page or keyword search:  
man Server   8174 pages
apropos Keyword Search (all sections)
Output format
Debian logo
[printable version]

TRIAL(1)							      TRIAL(1)

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 direc‐
	      tory 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  intermit‐
	      tent failures.

       --version
	      Prints the Twisted version number and exit.

       --without-module <modulenames>
	      Simulate	the lack of the specified comma-separated list of mod‐
	      ules. This makes it look like the modules are not present in the
	      system,  causing tests to check the behavior for that configura‐
	      tion.

       -z, --random [<seed>]
	      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
       Copyright © 2003-2008 Twisted Matrix Laboratories
       This is free software; see the source for copying conditions.  There is
       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.

				   Oct 2007			      TRIAL(1)
[top]

List of man pages available for Debian

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net