Asynchronous-friendly error mechanism.

See Failure.

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.

Parametersframesis 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)
writethis will be called with formatted strings. (type: callable)
detailFour 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.

ParametersvarsDictItemsa sequence of (name, value) pairs as returned by e.g. locals().items().
Returnsa 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.

API Documentation for Twisted, generated by pydoctor at 2017-09-23 19:45:03.