֛hYSrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r SSKJ r SSK J r SSK JrJrJr SSKJr SS KJr SS KJr \"S \S \4S 9rSqSr"SS\5rS$SjrSr"SS\5rSr "SS5r!"SS5r""SS5r#/r$S%Sjr%"SS\&5r'Sr(S r)SSSS!\'RT4S"jr+S#r,g)&z9 Asynchronous-friendly error mechanism. See L{Failure}. ) annotationsN)partial)getmro)StringIO)CallableNoReturnTypeVar)Version)reflect)deprecatedProperty _T_Callable.)boundc\rSrSrSrg)DefaultException&N)__name__ __module__ __qualname____firstlineno____static_attributes__rZC:\Users\psant\Downloads\Noiseback\school\venv\Lib\site-packages\twisted/python/failure.pyrr&srrc dUS;a[SU<S35eUnUS:XaUHupEpgnU"USUSUS35 M gUS:XaMUHFupEpgnU"SUS US US35 U"S [R"XV5R5-5 MH gUS :Xa#UHupEpgnU"S XVU4-5 M U"S5 gUS:XaqUHjupEpgnU"S XVU4-5 U"S5 UHupU"SU S[ U 5S35 M U"S5 UHupU"SU S[ U 5S35 M Ml gg)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 )r: rz File "z", line z, in z %s rz%s:%d: %s(...) zA [Capture of Locals and Globals disabled (use captureVars=True)] rz [ Locals ] z z : z ( Globals ) N) ValueError linecachegetlinestriprepr) frameswritedetailwmethodfilenamelineno localVars globalVarsnamevals r format_framesr3*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\rSrSrSrSrg)NoCurrentExceptionError\z~ Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state. rN)rrrr__doc__rrrrr5r5\srr5c[U5S:dS5eSn[USU5n[U5=p#USSH*n[XA5n[U5UlURnM, U$)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), ...] rzMust pass some framesN)len_Frame_TracebackFrametb_next)tbFramesstackfirstTbtbsfs r _TracebackrCcsx x=1 555  E 8A; &E"5))Gqrlr!$U+ ZZ Nrc\rSrSrSrSrSrg)r<ze Fake traceback object which can be passed to functions in the standard library L{traceback} module. cbXlURUlURUlSUlg)z @param frame: _Frame object N)tb_framef_lineno tb_linenof_lastitb_lastir=)selfframes r__init___TracebackFrame.__init__s&    r)rGrKrIr=Nrrrrr7rNrrrrr<r<s  rr<c\rSrSrSrSrSrg)r;a( 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 Uup4pVn[X45UlXPl[U=(d 05Ul[U=(d 05UlX lSUl[[5R5Ul SUl g)z @param frameinfo: (methodname, filename, lineno, locals, globals) @param back: previous (older) stack frame @type back: C{frame} rN) _Codef_coderHdict f_globalsf_localsf_backrJvarsbuiltinscopy f_builtinsf_trace)rL frameinfobackr1r-r.localzglobalzs rrN_Frame.__init__sh 3</D+  gm,V\r*   x.--/ r)rYr]rUrWrJrHrXr^NrPrrrr;r;s rr;c$\rSrSrSrSrSrSrg)rTz 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. cXlX lSUlSUlSUl/UlSUlSUlSUlSUl SUl SUl SUl SUl SUlSUlg)Nrrr)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)rLr1r-s rrN_Code.__init__sw #  "#!" rcg)N))NNNNrrLs r co_positions_Code.co_positionss*r)rkrnrmrorhrjrprqrsrirgrtrurrrvrlN)rrrrr7rNrzrrrrrTrTs$+rrTcD[RUR5 U$)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__)fs r _extraneousrs%%ajj1 Hrc\rSrSrSrSrSrS#Sjr\S5r \ RS5r \ "\ "SS S S55S 5r \ RS 5r \S 5r\RS5rSr\S$Sj5rSrSrS%Sjr\S5rS&SjrS&SjrSrSrSrSrSrS&SjrS&SjrS'S(Sjjr S)Sjr!S*S jr"S*S!jr#S"r$g)+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. rNcn[S-q[UlS=Ul=UlnX@lUc;[R "5uUlUlnURc [ 5eOMUc>[U[5(aURUlO[U5UlXlO X lXl[UR[5(aURUR5 gUc<U(aUnO2[URSS5(aURRnXPlg)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}. r9N __traceback__)counttypevalue captureVarssysexc_infor5 isinstance Exception __class__r _extrapolategetattrrrA)rL exc_valueexc_typeexc_tbrrAs rrNFailure.__init__s2  &** *DJ&  (+  %DItz2yy -//!  )Y//%// !O "J I"J djj' * *   djj )  :_d;;ZZ--rc[US5(a UR$/=olURnUGbURnUR(aUR R 5nUR URLa0nOURR 5nXT4HnSU;dM US M [UR55n[UR55nOS=pEURURRURRURUU45 URnUbGMU$)N_frames __builtins__r)hasattrrrArGrrXr\rWlistitemsr~rUrgrhrIr=)rLr(rArrarbds rr(Failure.frames8s 4 # #<<  "" WWn A*::, Gkk..0G A%*n-)flln-w}}/#%% MMHH$$HH((LL  B1n2 rcXlgN)r)rLr(s rr(r[s rTwisted c/$rrrys rr? Failure.stack_s rcAgrr)rLr?s rr?rcs rcURb UR$[R"UR5(ah[ UR[ 5(aI[ UR5n[[[RU55UlUR$UR/UlUR$r) _parentsinspectisclassr issubclassrrrmapr qual)rLparentCss rparentsFailure.parentsgs == $== ??499 % %*TYY *J*Jdii(H W\\8!<=DM}}"YYKDM}}rcXlgr)r)rLrs rrrss rcN[R"UR5Ulg)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)r\__dict__)rL otherFailures rrFailure._extrapolatews ,"7"78 rc[R[5n[S- qSUl[UlXlUR UlSUlU$)z Create a L{Failure} for an exception without a traceback. By restricting the inputs significantly, this constructor runs much faster. r9FN)r__new__rrrrrrA)rresults r_withoutTracebackFailure._withoutTracebacksF)  "  oo   rcRUR"U6nU(dUR5 U$)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)rL errorTypeserrors rtrap Failure.traps&0 J'    ! rcUH^nUn[R"U5(a+[U[5(a[R "U5nX0R ;dM\Us $ g)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)rLrrerrs rr Failure.checksP ECu%%*UI*F*Fll5)ll"  rcLURRUR5e)zN raise the original exception, preserving traceback information if available. )rwith_tracebackrArys rrFailure.raiseExceptions jj''00rcjURURRUR55$)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. )throwrrrA)rLgs rthrowExceptionIntoGenerator#Failure.throwExceptionIntoGenerators&wwtzz009::rcSR[R"UR5[R"UR5UR 55$)Nz <{} {}: {}>)formatr rrrgetErrorMessagerys r__repr__Failure.__repr__sA## LL ( LL #  "  rc(SUR5-$)Nz[Failure instance: %s])getBriefTracebackrys r__str__Failure.__str__s'$*@*@*BBBrcSU;aURS5 URS5US'URS5US'URRU5 g)Nr?rrr(r)poprupdaterLstates r __setstate__Failure.__setstate__sN e  IIg !IIi0j 99X.i U#rc URnURR5nURS5US'/US'SU;aURS5 UR(aGUR Vs/sH+nUSUSUS[ US5[ US 5/PM- snUS 'OUR US 'S US 'SUS 'U$s snf)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?rrr9rr(NrApickled)rrr\rrr( _safeReprVars)rL_cvs r __getstate__Failure.__getstate__s LL MM   uuZ() ' > EE)     %A aDaDaD!!A$'!!A$' % AhK++AhK$) # s62C c`[[R[5SUR54$)Nr)rrrrrys r __reduce__Failure.__reduce__s%12t7H7H7JKKrcUR5nURS5US'Xl[URSS5(aSURlgg)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 $ 6rcURb UR$[UR5S:a[UR5$g)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. Nr)rAr:r(rCrys rgetTracebackObjectFailure.getTracebackObject!s: 77 77N   !dkk* *rc[UR[5(aURR5$[R "UR5$)z: Get a string of the exception which caused this Failure. )rrrrr safe_strrys rrFailure.getErrorMessage2s= djj' * *::--/ / ++rcT[5nURUS9 UR5$)N)file)rprintBriefTracebackgetvalue)rLios rrFailure.getBriefTraceback:s& Z   b ){{}rcV[5nURX1US9 UR5$)N)relideFrameworkCoder*)rprintTracebackr)rLrr*rs r getTracebackFailure.getTraceback?s/ Z 6  {{}rc UcSSKJn URnURnUS:XaUR(dSnOUnUS:Xa4U"SUR UR =(a S=(d S4-5 OuUS :XagUR(aS nOS nU"U<S [R"UR5<S [R"UR5<S 35 OU"S5 UR(a[URXV5 OUS :XdU"S5 US :XdJU"[R"UR5S [R"UR5S 35 [UR[5(a-URS5 URR!XU5 US:XaU"SUR -5 gg)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'}. Nr)logrrz*--- Failure #%d%s--- z (pickled)  r Tracebackz"Traceback (failure with no frames)z: r"z#Traceback (most recent call last): z Failure: z (chained Failure) z*--- End of Failure #%d --- )twisted.pythonrlogerrr)rrrr(r rrrr3rrrr)rLrrr*rr+ formatDetail hasFramess rrFailure.printTracebackFs~ < *::D JJ Y t'7'77L!L Y  ):: >F3GH w {{' @ g..tyy97;K;KDJJ;WY  4 5 ;; $++q 77" kN dii()G,<,r,s #  .."7m8CK+@A    y +/^:iB   8++<   pHmpHf M    $$ D:"r