~ntt-pf-lab/nova/monkey_patch_notification

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'><html lang="en" xmlns="http://www.w3.org/1999/xhtml">

<head>

<title>Twisted Documentation: TRIAL.1</title>

</head>

<h1 class="title">TRIAL.1</h1>

<div class="toc"><ol><li><a href="#auto0">NAME</a></li><li><a href="#auto1">SYNOPSIS</a></li><li><a href="#auto2">DESCRIPTION</a></li><li><a href="#auto3">AUTHOR</a></li><li><a href="#auto4">REPORTING BUGS</a></li><li><a href="#auto5">COPYRIGHT</a></li></ol></div>

trial - run unit tests

<h2>SYNOPSIS<a name="auto1"/></h2>

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

trial --help

<h2>DESCRIPTION<a name="auto2"/></h2>

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.

<dl><dt>-b, --debug

</dt><dd>Run the tests in the Python debugger. Also does post-mortem

debugging on exceptions. Will load '.pdbrc' from current directory if

it exists.

</dd>

<dt>-B, --debug-stacktraces

</dt><dd>Report Deferred creation and callback stack traces

</dd>

<dt>--coverage

</dt><dd>Generate coverage information in _trial_temp/coverage/. Requires Python 2.3

or higher.

</dd>

<dt>--disablegc

</dt><dd>Disable the garbage collector. I don't know why this is in trial.

</dd>

<dt>-x, --extra

</dt><dd>Add an extra argument. (This is a hack necessary for interfacing with emacs's

`gud'.)

</dd>

<dt>-e, --rterrors

</dt><dd>Print tracebacks to standard output as soon as they occur

</dd>

<dt>--force-gc

</dt><dd>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.

</dd>

<dt>-h, --help

</dt><dd>Print a usage message to standard output, then exit.

</dd>

<dt>--help-reporters

</dt><dd>Print a list of valid reporters to standard output, then exit.

</dd>

<dt>--help-reactors

</dt><dd>List the names of possibly available reactors.

</dd>

<dt>-l, --logfile <logfile>

</dt><dd>Direct the log to a different file. The default file is 'test.log'.

<logfile> is relative to _trial_temp.

</dd>

<dt>-n, --dry-run

</dt><dd>Go through all the tests and make them pass without running.

</dd>

<dt>-N, --no-recurse

</dt><dd>By default, trial recurses through packages to find every module inside

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

</dd>

<dt>--nopm

</dt><dd>Don't automatically jump into debugger for post-mortem analysis of

exceptions. Only usable in conjunction with --debug.

</dd>

100

<dt>--profile

101

</dt><dd>Run tests under the Python profiler.

102

</dd>

103

104

<dt>-r, --reactor <reactor>

105

</dt><dd>Choose which reactor to use. See --help-reactors for a list.

106

</dd>

107

108

<dt>--recursionlimit

109

</dt><dd>Set Python's recursion limit. See sys.setrecursionlimit()

110

</dd>

111

112

<dt>--reporter

113

</dt><dd>Select the reporter to use for Trial's output. Use the --help-reporters

114

option to see a list of valid reporters.

115

</dd>

116

117

<dt>--spew

118

</dt><dd>Print an insanely verbose log of everything that happens. Useful when

119

debugging freezes or locks in complex code.

120

</dd>

121

122

<dt>--tbformat <format>

123

</dt><dd>Format to display tracebacks with. Acceptable values are 'default', 'brief'

124

and 'verbose'. 'brief' produces tracebacks that play nicely with Emacs' GUD.

125

</dd>

126

127

<dt>--temp-directory <directory>

128

</dt><dd>WARNING: Do not use this options unless you know what you are doing.

129

By default, trial creates a directory called _trial_temp under the current

130

working directory. When trial runs, it first deletes this directory,

131

then creates it, then changes into the directory to run the tests. The log

132

file and any coverage files are stored here. Use this option if you wish to

133

have trial run in a directory other than _trial_temp. Be warned, trial

134

will delete the directory before re-creating it.

135

</dd>

136

137

<dt>--testmodule <filename>

138

</dt><dd>Ask trial to look into <filename> and run any tests specified using the

139

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

140

</dd>

141

142

<dt>--unclean-warnings

143

</dt><dd>As of Twisted 8.0, trial will report an error if the reactor is left unclean

144

at the end of the test. This option is provided to assist in migrating from

145

Twisted 2.5 to Twisted 8.0 and later. Enabling this option will turn the errors

146

into warnings.

147

</dd>

148

149

<dt>-u, --until-failure

150

</dt><dd>Keep looping the tests until one of them raises an error or a failure.

151

This is particularly useful for reproducing intermittent failures.

152

</dd>

153

154

<dt>--version

155

</dt><dd>Prints the Twisted version number and exit.

156

</dd>

157

158

<dt>--without-module <modulenames>

159

</dt><dd>Simulate the lack of the specified comma-separated list of modules. This makes

160

it look like the modules are not present in the system, causing tests to check

161

the behavior for that configuration.

162

</dd>

163

164

<dt>-z, --random [<seed>]

165

</dt><dd>Run the tests in random order using the specified seed.

166

</dd>

167

168

</dl>

169

170

171

172

<h2>AUTHOR<a name="auto3"/></h2>

173

174

Written by Jonathan M. Lange

175

176

177

<h2>REPORTING BUGS<a name="auto4"/></h2>

178

179

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

180

181

182

<h2>COPYRIGHT<a name="auto5"/></h2>

183

184

185

This is free software; see the source for copying conditions. There is NO

186

warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

187

188

189

</div>

190

191

<a href="../howto/index.html">Index</a>

192

Version: 10.0.0

193

</body>

194

</html>

b'\\ No newline at end of file'

Older »