+ DfjYRt^RIHt^RIt^RIt^RIt^RIt^RIt^RIH t ^RIH t ^RI H t ^RI HtHtHt^RIHt^RIHt^R IHt]!R ]R ]3,R 7t^s^t!R R]4tR#RltRt!RR]4tRt !RR4t!!RR4t"!RR4t#.t$RRlt%!RR]&4t'Rt(Rt)RRRR ]'PT3R!lt+R"t,R#)$z9 Asynchronous-friendly error mechanism. See L{Failure}. ) annotationsN)partial)getmro)StringIO)CallableNoReturnTypeVar)Version)reflect)deprecatedProperty _T_Callable.)boundc]tRt^&tRtR#)DefaultExceptionN)__name__ __module__ __qualname____firstlineno____static_attributes__r8/usr/lib/python3/dist-packages/twisted/python/failure.pyrr&srrc VR9d\RV: R24hTpVR8Xd!VFwrErgpV!V RV RV R24K R#VR8XdSVFJwrErgpV!R V R V R V R24V!R \P!WV4P4,4KL R#VR8Xd)VFwrErgpV!R WVV3,4K V!R4R#VR8XdwVFnwrErgpV!R WVV3,4V!R4VFwrV!RV R\ V 4 R24K V!R4VFwrV!RV R\ V 4 R24K Kp R#R#)a` 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: Four detail levels are available: default, brief, verbose, and verbose-vars-not-captured. C{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 detail: string defaultbriefverboseverbose-vars-not-capturedzKDetail must be default, brief, verbose, or verbose-vars-not-captured. (not ): z File "z", line z, in z %s z%s:%d: %s(...) zA [Capture of Locals and Globals disabled (use captureVars=True)] z [ Locals ] z z : z ( Globals ) N)rrrr) ValueError linecachegetlinestriprepr) frameswritedetailwmethodfilenamelineno localVars globalVarsnamevals &&& r format_framesr0*s"QQ5; >   A ?E ;Ff  !F81VHB/ 0@F 9 ?E ;Ff  (6(%xrB C j9,,X>DDFF G@F . .?E ;Ff  Hf#== >@F NO 9 ?E ;Ff  Hf#== > o & BtfCS {"-.'  ' BtfCS {"-.(@F rz--- ---c]tRt^\tRtRtR#)NoCurrentExceptionErrorz~ Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state. rN)rrrr__doc__rrrrr2r2\srr2c\V4^8gQR4hRp\V^,V4p\V4;r#VR,F*p\WA4p\V4VnVPpK, V#)z Construct a fake traceback object using a list of frames. It should have the same API as stdlib to allow interaction with other tools. @param tbFrames: [(methodname, filename, lineno, locals, globals), ...] zMust pass some framesN:NN)len_Frame_TracebackFrametb_next)tbFramesstackfirstTbtbsfs& r _Tracebackr?csx x=1 555  E 8A; &E"5))Grllr!$U+ ZZ Nrc ]tRt^tRtRtRtR#)r8ze Fake traceback object which can be passed to functions in the standard library L{traceback} module. c dWnVPVnVPVnRVnR#)z @param frame: _Frame object N)tb_framef_lineno tb_linenof_lastitb_lastir9)selfframes&&r__init___TracebackFrame.__init__s&    r)rBrFrDr9Nrrrrr3rIrrrrr8r8s  rr8c ]tRt^tRtRtRtR#)r7a( A fake frame object, used by L{_Traceback}. @ivar f_code: fake L{code} object @ivar f_lineno: line number @ivar f_globals: fake f_globals dictionary (usually empty) @ivar f_locals: fake f_locals dictionary (usually empty) @ivar f_back: previous stack frame (towards the caller) c Vwr4rVp\W44VnWPn\T;'g/4Vn\T;'g/4VnW n^Vn\\4P4Vn RVn R#)z @param frameinfo: (methodname, filename, lineno, locals, globals) @param back: previous (older) stack frame @type back: C{frame} N) _Codef_coderCdict f_globalsf_localsf_backrEvarsbuiltinscopy f_builtinsf_trace)rG frameinfobackr.r*r+localzglobalzs&&& rrI_Frame.__init__sl 3</D+  gmm,V\\r*   x.--/ r)rSrWrOrQrErCrRrXNrKrrrr7r7s rr7c&]tRt^tRtRtRtRtR#)rNz A fake code object, used by L{_Traceback} via L{_Frame}. It is intended to have the same API as the stdlib code type to allow interoperation with other tools based on that interface. c WnW nRVn^Vn^Vn.VnRVnRVnRVn^Vn RVn ^Vn ^Vn RVn ^Vn^VnR#)rNr)co_name co_filename co_lnotabco_firstlineno co_argcount co_varnamesco_code co_cellvars co_constsco_flags co_freevarsco_posonlyargcountco_kwonlyargcountco_names co_nlocals co_stacksize)rGr.r*s&&&rrI_Code.__init__sw #  "#!" rc R#)N))NNNNrrGs&r co_positions_Code.co_positionss**r)rdrgrfrhrarcrirjrlrbr`rmrnrkroreN)rrrrr3rIrsrrrrrNrNs$+rrNc V^8dQhRRRR/#)fr returnr)formats"r __annotate__rzs   ;  ;  rcD\PVP4V#)z Mark the given callable as extraneous to inlineCallbacks exception reporting; don't show these functions. @param f: a function that you NEVER WANT TO SEE AGAIN in ANY TRACEBACK reported by Failure. @type f: function @return: f )_inlineCallbacksExtraneousappend__code__)rws&r _extraneousrs%%ajj1 Hrc]tRt^tRt^tRtR&Rlt]R4t ] PR4t ] !] !R^^ ^44R4t ] PR4t ]R 4t]PR 4tR t]R R l4tRtRtRRlt]R4tRRltRRltRtRtRtRtRtRRltRRltR'R R!llt R(R"lt!R)R#lt"R)R$lt#R%t$R#)*Failurea A basic abstraction for an error that has occurred. This is necessary because Python's built-in error mechanisms are inconvenient for asynchronous communication. The C{frame} attribute contain the traceback frames. Each frame is a tuple of (funcName, fileName, lineNumber, localsItems, globalsItems), where localsItems and globalsItems are the contents of C{locals().items()}/C{globals().items()} for that frame, or an empty tuple if those details were not captured. Local/global variables in C{frame} will only be captured if C{captureVars=True} when constructing the L{Failure}. @ivar value: The exception instance responsible for this failure. @ivar type: The exception's class. @ivar stack: Deprecated, always an empty list. Equivalent information can be extracted from C{import traceback; traceback.extract_stack(your_failure.tb)} @ivar frames: list of frames, innermost first. Nc \^,s\VnR;Vn;VnpW@nVf=\P !4wVnVnpVPf \ 4hMOVf@\V\4'dVPVnM\V4VnWnM W nWn\VP\4'dVPVP4R#Vf?V'dTpM3\VPRR4'dVPPpWPnR#)a 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 L{None} are allowed. If L{None} is supplied for C{exc_value}, the value of C{exc_tb} is ignored, otherwise if C{exc_tb} is L{None}, it will be found from execution context (ie, L{sys.exc_info}). @param captureVars: if set, capture locals and globals of stack frames. This is pretty slow, and makes no difference unless you are going to use L{printDetailedTraceback}. N __traceback__)counttypevalue captureVarssysexc_infor2 isinstance Exception __class__r _extrapolategetattrrr=)rG exc_valueexc_typeexc_tbrr=s&&&&& rrIFailure.__init__s2  &** *DJ&  (+  %DItz2yy -//!  )Y//%// !O "J I"J djj' * *   djj )  :_d;;ZZ--rc \VR4'd VP#.;qnVPpVEeVPpVP'dVP P 4pVP VPJd/pMVPP 4pWT3FpRV9gK VRK \VP44p\VP44pMR;rEVPVPPVPPVPVV34VPpEKV#)_frames __builtins__r)hasattrrr=rBrrRrVrQlistitemsr}rOr`rarDr9)rGr%r=rwr[r\ds& rr%Failure.frames8s  4 # #<<  "" WWn A*::, Gkk..0G A%*n-)flln-w}}/#%% MMHH$$HH((LL  B rc WnR#N)r)rGr%s&&rr%r[s rTwistedc .#rrrrs&rr; Failure.stack_s rc ?R#rr)rGr;s&&rr;rcs rc VPe VP#\P!VP4'dj\ VP\ 4'dJ\ VP4p\\\PV44VnVP#VP.VnVP#r) _parentsinspectisclassr issubclassrrrmapr qual)rGparentCss& rparentsFailure.parentsgs == $== ??499 % %*TYY *J*Jdii(H W\\8!<=DM}}"YYKDM}}rc WnR#r)r)rGrs&&rrrss rc P\P!VP4VnR#)z Extrapolate from one failure into another, copying its stack frames. @param otherFailure: Another L{Failure}, whose traceback information, if any, should be preserved as part of the stack presented by this one. @type otherFailure: L{Failure} N)rV__dict__)rG otherFailures&&rrFailure._extrapolatews ,"7"78 rc V^8dQhRRRR/#)rvr BaseExceptionrxrr)rys"rrzFailure.__annotate__s7rc \P\4p\^, sRVn\VnWnVP VnRVnV#)z Create a L{Failure} for an exception without a traceback. By restricting the inputs significantly, this constructor runs much faster. FN)r__new__rrrrrr=)rresults& r_withoutTracebackFailure._withoutTracebacksF)  "  oo   rc VVP!V!pV'gVP4V#)a 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. In Python 2 the Failure will be raised; in Python 3 the underlying exception will be re-raised. @type errorTypes: L{Exception} )checkraiseException)rG errorTypeserrors&* rtrap Failure.traps&0 J'    ! rc VFapTp\P!V4'd-\V\4'd\P !V4pW0P 9gK_Vu# R#)z 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)rrrrr rr)rGrrerrs&* rr Failure.checksP ECu%%*UI*F*Fll5)ll"  rcV^8dQhRR/#)rvrxrr)rys"rrzrs111rc LVPPVP4h)zN raise the original exception, preserving traceback information if available. )rwith_tracebackr=rrs&rrFailure.raiseExceptions jj''00rc jVPVPPVP44#)a 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. )throwrrr=)rGgs&&rthrowExceptionIntoGenerator#Failure.throwExceptionIntoGenerators&wwtzz009::rcV^8dQhRR/#rvrxstrr)rys"rrzrs  # rc RP\P!VP4\P!VP4VP 44#)z <{} {}: {}>)ryr rrrgetErrorMessagerrs&r__repr__Failure.__repr__sA## LL ( LL #  "  rcV^8dQhRR/#rr)rys"rrzrsCCCrc 0RVP4,#)z[Failure instance: %s])getBriefTracebackrrs&r__str__Failure.__str__s'$*@*@*BBBrc RV9dVPR4VPR4VR&VPR4VR&VPPV4R#)r;rrr%rN)poprupdaterGstates&&r __setstate__Failure.__setstate__sN e  IIg !IIi0j 99X.i U#rc  VPpVPP4pVPR4VR&.VR&RV9dVPR4VP'd[VP Uu.uF?pV^,V^,V^,\ V^,4\ V^,4.NKA upVR&MVP VR&RVR&^VR&V#uupi) z Avoid pickling objects in the traceback. This is not called direclty by pickle, since C{BaseException} implements reduce; instead, pickle calls C{Failure.__reduce__} which then calls this API. rrr;rr%Nr=pickled)rrrVrrr% _safeReprVars)rG_cvs& r __getstate__Failure.__getstate__s LL MM   uuZ() ' > EE)      %A aDaDaD!!A$'!!A$' % AhK++AhK$) # s8ACc `\\P\4RVP43#)Nr)rrrrrrs&r __reduce__Failure.__reduce__s%12t7H7H7JKKrc VP4pVPR4VR&Wn\VPRR4'dRVPnR#R#)z Remove references to other objects, replacing them with strings. On Python 3, this will also set the C{__traceback__} attribute of the exception instance to L{None}. r%rrN)rrrrrrrs& r cleanFailureFailure.cleanFailuresN!!# 99X.i 4:: 5 5'+DJJ $ 6rc VPe VP#\VP4^8d\VP4#R#)aY Get an object that represents this Failure's stack that can be passed to traceback.extract_tb. If the original traceback object is still present, return that. If this traceback object has been lost but we still have the information, return a fake traceback object (see L{_Traceback}). If there is no traceback information at all, return None. N)r=r6r%r?rrs&rgetTracebackObjectFailure.getTracebackObject!s: 77 77N   !dkk* *rcV^8dQhRR/#rr)rys"rrzr2s,,,rc \VP\4'dVPP4#\P !VP4#)z: Get a string of the exception which caused this Failure. )rrrrr safe_strrrs&rrFailure.getErrorMessage2s= djj' * *::--/ / ++rcV^8dQhRR/#rr)rys"rrzr:s3rc Z\4pVPVR7VP4#))file)rprintBriefTracebackgetvalue)rGios& rrFailure.getBriefTraceback:s& Z   b ){{}rc$V^8dQhRRRRRR/#)rvelideFrameworkCodeintr'rrxr)rys"rrzr?s"sTWrc \\4pVPW1VR7VP4#))rrr')rprintTracebackr)rGrr'rs&&& r getTracebackFailure.getTraceback?s/ Z 6  {{}rc  Vf^RIHpVPpVPpVR8XdVP'gRpMTpVR8Xd;T!RVP VP ;'d R;'gR3,4MwVR8XdiVP'dR pMR pV!V: R \P!VP4: R \P!VP4: R 24MV!R 4VP'd\VPWV4MVR8Xg V!R4VR8XgKV!\P!VP4 R \P!VP4 R 24\VP\4'd.VPR4VPP!WV4VR8XdV!RVP ,4R#R#)aT Emulate Python's standard error reporting mechanism. @param file: If specified, a file-like object to which to write the traceback. @param elideFrameworkCode: Deprecated, ignored. @param detail: A string indicating how much information to include in the traceback. Must be one of C{'brief'}, C{'default'}, or C{'verbose'}. N)logrrz*--- Failure #%d%s--- z (pickled)  r Tracebackz"Traceback (failure with no frames)z: rz#Traceback (most recent call last): z Failure: z (chained Failure) z*--- End of Failure #%d --- )twisted.pythonrlogerrr&rrrr%r rrrr0rrrr)rGrrr'rr( formatDetail hasFramess&&&& rrFailure.printTracebackFs < *::D JJ Y t'7'7'77L!L Y  ):: > >FF3GH w {{{' @ g..tyy97;K;KDJJ;WY  4 5 ;;; $++q 77" kN dii()G,<,r-s #  .."7m8CK+@A    y +/^:iB   8++<   pHmpHf M    $$ D:"r