twisted.python.failure : API documentation

Asynchronous-friendly error mechanism.

Class	DefaultException	Undocumented
Function	format_frames	Format and write frames.
Class	NoCurrentExceptionError	Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state.
Class	Failure	A basic abstraction for an error that has occurred.
Function	startDebugMode	Enable debug hooks for Failures.
Class	_Traceback	Fake traceback object which can be passed to functions in the standard library `traceback` module.
Class	_Frame	A fake frame object, used by `_Traceback`.
Class	_Code	A fake code object, used by `_Traceback` via `_Frame`.
Function	_safeReprVars	Convert a list of (name, object) pairs into (name, repr) pairs.
Function	_debuginit	Initialize failure object, possibly spawning pdb.

def format_frames(frames, write, detail='default'): (source)

Format and write frames.

Parameters	frames	is a list of frames as used by Failure.frames, with each frame being a list of (funcName, fileName, lineNumber, locals.items(), globals.items()) (type: list)
	write	this will be called with formatted strings. (type: callable)
	detail	Four detail levels are available: default, brief, verbose, and verbose-vars-not-captured. `Failure.printDetailedTraceback` uses the latter when the caller asks for verbose, but no vars were captured, so that an explicit warning about the missing data is shown. (type: string)

def _safeReprVars(varsDictItems): (source)

Convert a list of (name, object) pairs into (name, repr) pairs.

twisted.python.reflect.safe_repr is used to generate the repr, so no exceptions will be raised by faulty __repr__ methods.

Parameters	varsDictItems	a sequence of (name, value) pairs as returned by e.g. `locals().items()`.
Returns	a sequence of (name, repr) pairs.

t.p.failure : module documentation