twisted.scripts.trial

module documentation

Undocumented

Class	`Options`	Options to the trial command line tool.
Function	`getTestModules`	Undocumented
Function	`isTestFile`	Returns true if 'filename' looks like a file containing unit tests. False otherwise. Doesn't care whether filename exists.
Function	`loadLocalVariables`	Accepts a filename and attempts to load the Emacs variable declarations from that file, simulating what Emacs does.
Function	`run`	Undocumented
Constant	`TBFORMAT_MAP`	Undocumented
Class	`_BasicOptions`	Basic options shared between trial and its local workers.
Exception	`_DebuggerNotFound`	A debugger import failed.
Function	`_autoJobs`	Heuristically guess the number of job workers to run.
Function	`_checkKnownRunOrder`	Check that the given order is a known test running order.
Function	`_getLoader`	Undocumented
Function	`_getSuite`	Undocumented
Function	`_initialDebugSetup`	Undocumented
Function	`_makeRunner`	Return a trial runner class set up with the parameters extracted from `config`.
Function	`_maybeFindSourceLine`	Try to find the source line of the given test thing.
Function	`_parseLocalVariables`	Accepts a single line in Emacs local variable declaration format and returns a dict of all the variables {name: value}. Raises ValueError if 'line' is in the wrong format.
Function	`_reporterAction`	Undocumented
Function	`_wrappedPdb`	Wrap an instance of `pdb.Pdb` with readline support and load any .rcs.
Variable	`_runOrders`	Undocumented

def getTestModules(filename): ¶

Undocumented

def isTestFile(filename): ¶

Returns true if 'filename' looks like a file containing unit tests. False otherwise. Doesn't care whether filename exists.

def loadLocalVariables(filename): ¶

Accepts a filename and attempts to load the Emacs variable declarations from that file, simulating what Emacs does.

See http://www.gnu.org/software/emacs/manual/html_node/File-Variables.html

def run() -> NoReturn: ¶

Undocumented

TBFORMAT_MAP: dict[str, str] = ¶

Undocumented

Value

{'plain': 'default',
 'default': 'default',
 'emacs': 'brief',
 'brief': 'brief',
 'cgitb': 'verbose',
 'verbose': 'verbose'}

def _autoJobs() -> int: ¶

Heuristically guess the number of job workers to run.

When ``os.process_cpu_count()`` is available (Python 3.13+), return the number of logical CPUs usable by the current process. This respects the ``PYTHON_CPU_COUNT`` environment variable and/or ``python -X cpu_count`` flag.

Otherwise, if ``os.sched_getaffinity()`` is available (on some Unixes) this returns the number of CPUs this process is restricted to, under the assumption that this affinity will be inherited.

Otherwise, consult ``os.cpu_count()`` to get the number of logical CPUs.

Failing all else, return 1.

Returns
`int`	A strictly positive integer.

def _checkKnownRunOrder(order): ¶

Check that the given order is a known test running order.

Does nothing else, since looking up the appropriate callable to sort the tests should be done when it actually will be used, as the default argument will not be coerced by this function.

Parameters
order	one of the known orders in `_runOrders`
Returns
the order unmodified

def _getLoader(config: Options) -> runner.TestLoader: ¶

Undocumented

def _getSuite(config: Options) -> TestSuite: ¶

Undocumented

def _initialDebugSetup(config: Options): ¶

Undocumented

def _makeRunner(config: Options) -> runner._Runner: ¶

Return a trial runner class set up with the parameters extracted from config.

Returns
`runner._Runner`	A trial runner instance.

def _maybeFindSourceLine(testThing): ¶

Try to find the source line of the given test thing.

Parameters
testThing:an `TestCase`, test method, or module, though only the former two have a chance to succeed	the test item to attempt to inspect
Returns
int	the starting source line, or -1 if one couldn't be found

def _parseLocalVariables(line): ¶

Accepts a single line in Emacs local variable declaration format and returns a dict of all the variables {name: value}. Raises ValueError if 'line' is in the wrong format.

See http://www.gnu.org/software/emacs/manual/html_node/File-Variables.html

def _reporterAction(): ¶

Undocumented

def _wrappedPdb(): ¶

Wrap an instance of pdb.Pdb with readline support and load any .rcs.

_runOrders = ¶

Undocumented