twisted.python.failure
module documentationtwisted.python
View Source
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. |
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) |
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 | frames | [(methodname, filename, lineno, locals, globals), ...] |
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 |
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. |
Initialize failure object, possibly spawning pdb.