twisted.spread.pb.CopiedFailure

exception documentation

class CopiedFailure(RemoteCopy, failure.Failure): (source)

Constructor: CopiedFailure(exc_value, exc_type, exc_tb, captureVars)

View In Hierarchy

A CopiedFailure is a pb.RemoteCopy of a failure.Failure transferred via PB.

Method printTraceback Emulate Python's standard error reporting mechanism.
Method setCopyableState I will be invoked with the state to copy locally.
Method throwExceptionIntoGenerator Throw the original exception into the given generator, preserving traceback information if available. In the case of a CopiedFailure where the exception type is a string, a pb.RemoteError is thrown instead.
Instance Variable traceback The remote traceback.
Instance Variable type The full import path of the exception class which was raised on the remote end.
Instance Variable value A str() representation of the remote value.

Inherited from RemoteCopy:

Method unjellyFor Perform the inverse operation of Jellyable.jellyFor.
Instance Variable __dict__ Undocumented

Inherited from Unjellyable (via RemoteCopy):

Method setStateFor Undocumented

Inherited from Failure (via RemoteCopy, Unjellyable):

Method __getstate__ Avoid pickling objects in the traceback.
Method __init__ Initialize me with an explanation of the error.
Method __reduce__ Undocumented
Method __repr__ Undocumented
Method __setstate__ Undocumented
Method __str__ Undocumented
Method check Check if this failure's type is in a predetermined list.
Method cleanFailure Remove references to other objects, replacing them with strings.
Method frames.setter Undocumented
Method getBriefTraceback Undocumented
Method getErrorMessage Get a string of the exception which caused this Failure.
Method getTraceback Undocumented
Method getTracebackObject Get an object that represents this Failure's stack that can be passed to traceback.extract_tb.
Method parents.setter Undocumented
Method printBriefTraceback Print a traceback as densely as possible.
Method printDetailedTraceback Print a traceback with detailed locals and globals information.
Method raiseException raise the original exception, preserving traceback information if available.
Method stack.setter Undocumented
Method trap Trap this failure if its type is in a predetermined list.
Class Variable pickled Undocumented
Instance Variable captureVars Undocumented
Instance Variable count Undocumented
Instance Variable tb Undocumented
Property frames Undocumented
Property parents Undocumented
Property stack Undocumented
Static Method _withoutTraceback Create a Failure for an exception without a traceback.
Method _extrapolate Extrapolate from one failure into another, copying its stack frames.
Instance Variable _frames Undocumented
Instance Variable _parents Undocumented
def printTraceback(self, file=None, elideFrameworkCode=0, detail='default'): (source)
overrides twisted.python.failure.Failure.printTraceback

Emulate Python's standard error reporting mechanism.

Parameters
fileIf specified, a file-like object to which to write the traceback.
elideFrameworkCodeDeprecated, ignored.
detailA string indicating how much information to include in the traceback. Must be one of 'brief', 'default', or 'verbose'.
def setCopyableState(self, state): (source)
overrides twisted.spread.pb.RemoteCopy.setCopyableState

I will be invoked with the state to copy locally.

'state' is the data returned from the remote object's 'getStateToCopyFor' method, which will often be the remote object's dictionary (or a filtered approximation of it depending on my peer's perspective).

def throwExceptionIntoGenerator(self, g): (source)
overrides twisted.python.failure.Failure.throwExceptionIntoGenerator

Throw the original exception into the given generator, preserving traceback information if available. In the case of a CopiedFailure where the exception type is a string, a pb.RemoteError is thrown instead.

Returns
The next value yielded from the generator.
Raises
StopIterationIf there are no more values in the generator.
RemoteErrorThe wrapped remote exception.
traceback: str = (source)

The remote traceback.

type: str = (source)
overrides twisted.python.failure.Failure.type

The full import path of the exception class which was raised on the remote end.

value: CopiedFailure or str = (source)
overrides twisted.python.failure.Failure.value

A str() representation of the remote value.