ó ƒu~Mc@s?dZddlZddlZddlZddlZddlmZddlmZddlm Z da dZ de fd „ƒYZ d d „Zd Zd e fd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdfd„ƒYZeZeeeejjd„Zd„ZddlZdS(s9 Asynchronous-friendly error mechanism. See L{Failure}. i˙˙˙˙N(tStringIO(tgetmro(treflectiitDefaultExceptioncBseZRS((t__name__t __module__(((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyRstdefaultc Cs‘|d krtd|f‚n|}|dkrkxY|D],\}}}}}|d|||fƒq8Wn"|dkrŃx|D]L\}}}}}|d|||fƒ|dtj||ƒjƒƒq~Wnź|dkrx­|D]˘\}}}}}|d|||fƒ|d ƒx.|D]&\} } |d | t| ƒfƒq!W|d ƒx.|D]&\} } |d | t| ƒfƒq\WqäWnd S(sľFormat and write frames. @param 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 frames: list @param write: this will be called with formatted strings. @type write: callable @param detail: Three detail levels are available: default, brief, and verbose. @type detail: string Rtbrieftverboses3Detail must be default, brief, or verbose. (not %r)s %s:%s:%s s File "%s", line %s, in %s s %s s%s:%d: %s(...) s [ Locals ] s %s : %s s ( Globals ) N(sdefaultRsverbose(t ValueErrort linecachetgetlinetstriptrepr( tframestwritetdetailtwtmethodtfilenametlinenot localVarst globalVarstnametval((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt format_framess&   '   s--- ---tNoCurrentExceptionErrorcBseZdZRS(sŠ Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state. (RRt__doc__(((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyRFst _TracebackcBseZdZd„ZRS(sq Fake traceback object which can be passed to functions in the standard library L{traceback} module. cCs‘t|ƒdkstd‚|d|d}}|\}}}}}t||ƒ|_||_t|ƒdkr~d|_nt|ƒ|_dS(s] 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 object, since locals and globals are not used in standard tracebacks. @param frames: [(methodname, filename, lineno, locals, globals), ...] isMust pass some framesiN(tlentAssertionErrort_Framettb_framet tb_linenotNonettb_nextR(tselfRtheadRRRtlocalztglobalz((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt__init__Ss   (RRRR((((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyRMsRcBseZdZd„ZRS(sč A fake frame object, used by L{_Traceback}. @ivar f_code: fake L{code} object @ivar f_globals: fake f_globals dictionary (usually empty) @ivar f_locals: fake f_locals dictionary (usually empty) cCs(t||ƒ|_i|_i|_dS(sŤ @param name: method/function name for this frame. @type name: C{str} @param filename: filename for this frame. @type name: C{str} N(t_Codetf_codet f_globalstf_locals(R$RR((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyR(ps (RRRR((((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyRgsR)cBseZdZd„ZRS(sB A fake code object, used by L{_Traceback} via L{_Frame}. cCs||_||_dS(N(tco_namet co_filename(R$RR((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyR(€s (RRRR((((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyR)|stFailurecBsöeZdZdZdZeejdƒZ dddd„Z d„Z d„Z d„Z d„Zd„ZeeƒZd „Zd „Zd „Zd „Zd „Zd„Zd„Zddd„Zdedd„Zddd„Zddd„ZRS(s" A basic abstraction for an error that has occurred. This is necessary because Python's built-in error mechanisms are inconvenient for asynchronous communication. @ivar value: The exception instance responsible for this failure. @ivar type: The exception's class. it YIELD_VALUEc Csőtdat|_d|_|_}t|ttfƒr}|dkr}ddl}|jd|t ddƒt |ƒ}nd}|dkrž|j ƒ}n|dkrét j ƒ\|_|_}|jdkrŕtƒ‚nd}nW|dkr.t|tƒr|j|_nt|ƒ|_||_n||_||_t|jtƒre|jj|_dS|dkrƒ|rƒ|}qƒng}|_g}|_||_|r¸|j} nt|jtƒs×d} }nx#|rü| rü| j} |d8}qÚWxś| rľ| jjƒ} | j| jkr0i} n| jjƒ} x-| | fD]} | jdƒrL| d=qLqLW|jd| jj| jj| j | j!ƒ| j!ƒgƒ| j} qWxÂ|dk rz|j} | jjƒ} | j| jkrři} n| jjƒ} x-| | fD]} | jdƒr| d=qqW|j"| jj| jj|j#| j!ƒ| j!ƒgƒ|j$}qšWt%j&|jƒrât'|jtƒrât(|jƒ} t)t*j+| ƒ|_,|j,j"t*j+|jƒƒn|jg|_,dS( s_ Initialize me with an explanation of the error. By default, this will use the current C{exception} (L{sys.exc_info}()). However, if you want to specify a particular kind of failure, you can pass an exception as an argument. If no C{exc_value} is passed, then an "original" C{Failure} will be searched for. If the current exception handler that this C{Failure} is being constructed in is handling an exception raised by L{raiseException}, then this C{Failure} will act like the original C{Failure}. For C{exc_tb} only L{traceback} instances or C{None} are allowed. If C{None} is supplied for C{exc_value}, the value of C{exc_tb} is ignored, otherwise if C{exc_tb} is C{None}, it will be found from execution context (ie, L{sys.exc_info}). ii˙˙˙˙NsTDon't pass strings (like %r) to failure.Failure (replacing with a DefaultException).t stackleveliit __builtins__(-tcountR"ttypetvaluet isinstancetstrtunicodetwarningstwarntDeprecationWarningRt _findFailuretsystexc_infoRt Exceptiont __class__R/t__dict__RtstackttbR tf_backR,tcopyR+thas_keytinsertR*R-R.tf_linenotitemstappendR!R#tinspecttisclasst issubclassRtmapRtqualtparents(R$t exc_valuetexc_typetexc_tbRCR9t stackOffsetRRBtfR&R'tdtparentCs((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyR(˜s˜  !                              $cGs"|j|Œ}|s|‚n|S(s Trap this failure if its type is in a predetermined list. This allows you to trap a Failure in an error callback. It will be automatically re-raised if it is not a type that you expect. The reason for having this particular API is because it's very useful in Deferred errback chains:: def _ebFoo(self, failure): r = failure.trap(Spam, Eggs) print 'The Failure is due to either Spam or Eggs!' if r == Spam: print 'Spam did it!' elif r == Eggs: print 'Eggs did it!' If the failure is not a Spam or an Eggs, then the Failure will be 'passed on' to the next errback. @type errorTypes: L{Exception} (tcheck(R$t errorTypesterror((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyttrap"s cGs^xW|D]O}|}tj|ƒrCt|tƒrCtj|ƒ}n||jkr|SqWdS(súCheck if this failure's type is in a predetermined list. @type errorTypes: list of L{Exception} classes or fully-qualified class names. @returns: the matching L{Exception} type, or None if no match. N(RKRLRMR?RRORPR"(R$RYRZterr((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyRX=s cCs|j|j|j‚dS(sf raise the original exception, preserving traceback information if available. N(R4R5RC(R$((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pytraiseExceptionMscCs|j|j|j|jƒS(sJ Throw the original exception into the given generator, preserving traceback information if available. @return: The next value yielded from the generator. @raise StopIteration: If there are no more values in the generator. @raise anything else: Anything that the generator raises. (tthrowR4R5RC(R$tg((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pytthrowExceptionIntoGeneratorUs cCstjƒd}|sdSd}|}x|jrD|}|j}q)W|j}|j|jjkrs|jj dƒS|jj sœ|jj |j |j kr dS|r×|j}|j|j jkr×|jj dƒSn|jj}|r|j|j jkr|jj dƒSdS(sV Find the failure that represents the exception currently in context. i˙˙˙˙NR$(R=R>R"R#R R*R]t func_codeR,tgettco_codettb_lastit _yieldOpcodeR`RD(tclsRCt secondLastTbtlastTbt lastFrametframe((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyR<as*      cCsd|j|jfS(Ns<%s %s>(R@R4(R$((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt__repr__›scCsd|jƒS(Ns[Failure instance: %s](tgetBriefTraceback(R$((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt__str__žsc Csw|jr|jS|jjƒ}g|jD]ƒ}|d|d|dg|dD]#}|dtj|dƒf^qOg|dD]#}|dtj|dƒf^q€g^q)|dR@tDO_POST_MORTEMR7tpdbt post_mortem(R$RQRRRStFailure__init__texctstrreprR((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt _debuginit9s    cCs tt_dS(s Enable debug hooks for Failures.N(R’R/R((((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pytstartDebugModeJs(RR=R RKRˆt cStringIORRttwisted.pythonRR3RƒR?RRR„RtobjectRRR)R/tTrueRŒR"R(tim_funcR’R“R(((s:/usr/lib/python2.7/dist-packages/twisted/python/failure.pyt s.     $ ˙ł