twisted.python.failure : API documentation

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.
Function	_Traceback	No summary
Class	_TracebackFrame	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	_extraneous	Mark the given callable as extraneous to inlineCallbacks exception reporting; don't show these functions.
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 _Traceback(stackFrames, tbFrames): (source)

Construct a fake traceback object using a list of frames. Note that although frames generally include locals and globals, this information is not kept by this method, since locals and globals are not used in standard tracebacks.

Parameters	stackFrames	[(methodname, filename, lineno, locals, globals), ...]
	tbFrames	[(methodname, filename, lineno, locals, globals), ...]

def _extraneous(f): (source)

Mark the given callable as extraneous to inlineCallbacks exception reporting; don't show these functions.

Parameters	f	a function that you NEVER WANT TO SEE AGAIN in ANY TRACEBACK reported by Failure. (type: function)
Returns	f

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.

def _debuginit(self, exc_value=None, exc_type=None, exc_tb=None, captureVars=False, Failure__init__=Failure.__init__): (source)

Initialize failure object, possibly spawning pdb.

def startDebugMode(): (source)

Enable debug hooks for Failures.

twisted.python.failure module documentation

`twisted.python.failure` module documentation