9SrSSKrSSKrSSKJr SSKJr /SQr\S/- r"SS\5r "S S \ 5r S r "S S \5r "SS\5r "SS\ 5r"SS\ 5r"SS\5r\R"SS:r\(aSrSrOSrSrSSKJr Sr"SS\5r"SS\5rg!\a \rN!f=f) zAcontextlib2 - backports and enhancements to the contextlib moduleN)dequewraps)contextmanagerclosingContextDecorator ExitStackredirect_stdoutredirect_stderrsuppress ContextStackc*\rSrSrSrSrSrSrSrg)rzJA base class or mixin that enables context managers to work as decorators.cX[R"S[5 UR5$)aReturns the context manager used to actually wrap the call to the decorated function. The default implementation just returns *self*. Overriding this method allows otherwise one-shot context managers like _GeneratorContextManager to support use as decorators via implicit recreation. DEPRECATED: refresh_cm was never added to the standard library's ContextDecorator API z2refresh_cm was never added to the standard library)warningswarnDeprecationWarning _recreate_cmselfs 'lib/third_party/contextlib2/__init__.py refresh_cmContextDecorator.refresh_cms%  J( *  ""cU$)aReturn a recreated instance of self. Allows an otherwise one-shot context manager like _GeneratorContextManager to support use as a decorator via implicit recreation. This is a private interface just for _GeneratorContextManager. See issue #11647 for details. rs rrContextDecorator._recreate_cm"s  rc4^^[T5UU4Sj5nU$)Ncj>TR5 T"U0UD6sSSS5 $!,(df  g=fN)r)argskwdsfuncrs rinner(ContextDecorator.__call__..inner/s(""$T*T*%$$s$ 2r)rr#r$s`` r__call__ContextDecorator.__call__.s t +  + rrN) __name__ __module__ __qualname____firstlineno____doc__rrr&__static_attributes__rrrrrsP#" rrc0\rSrSrSrSrSrSrSrSr g) _GeneratorContextManager6z%Helper for @contextmanager decorator.cU"U0UD6UlXUsUlUlUl[ USS5nUc[ U5R nX@lg)Nr,)genr#r!r"getattrtyper,)rr#r!r"docs r__init__!_GeneratorContextManager.__init__9sN&&*.d' 49didIt, ;t*$$C rcdURURURUR5$r ) __class__r#r!r"rs rr%_GeneratorContextManager._recreate_cmGs#~~diiDII>>rc`[UR5$![a [S5ef=f)Nzgenerator didn't yield)nextr2 StopIteration RuntimeErrorrs r __enter__"_GeneratorContextManager.__enter__Ms0 9> ! 978 8 9s-cUc![UR5 [S5eUcU"5nURR XU5 [S5e![a gf=f![a nXBLsSnA$SnAf[a.nXBLaSnAg[ (aUR ULaSnAgeSnAf [R"5SULaeg=f)Nzgenerator didn't stopz#generator didn't stop after throw()F) r<r2r>r=throw_HAVE_EXCEPTION_CHAINING __cause__sysexc_info)rr4value tracebackexcs r__exit__!_GeneratorContextManager.__exit__Ss < <TXX##:;;} tI6"#HII!  ! ('' < ,+ 0F  <<>!$E12sFA'A' A$#A$' C1A93C9 CB/B/.B//!C)r,r!r#r2r"N) r(r)r*r+r,r6rr?rKr-rrrr/r/6s/? 9 (rr/c0^[T5U4Sj5nU$)a@contextmanager decorator. Typical usage: @contextmanager def some_generator(): try: yield finally: This makes this: with some_generator() as : equivalent to this: try: = finally: c>[TX5$r )r/)r!r"r#s rhelpercontextmanager..helpers'd99rr)r#rOs` rrr~s 8 4[:: Mrc*\rSrSrSrSrSrSrSrg)ra Context to automatically close something at the end of a block. Code like this: with closing(.open()) as f: is equivalent to this: f = .open() try: finally: f.close() cXlgr thing)rrUs rr6closing.__init__s rcUR$r rTrs rr?closing.__enter__s zzrc8URR5 gr )rUclose)rrGs rrKclosing.__exit__s rrTN r(r)r*r+r,r6r?rKr-rrrrrs rrc*\rSrSrSrSrSrSrSrg)_RedirectStreamNcXl/Ulgr  _new_target _old_targets)r new_targets rr6_RedirectStream.__init__s%rcURR[[UR55 [ [URUR 5 UR $r )rcappendr3rF_streamsetattrrbrs rr?_RedirectStream.__enter__sC   dll!;<T\\4#3#34rcj[[URURR 55 gr )rirFrhrcpoprexctypeexcinstexctbs rrK_RedirectStream.__exit__s!T\\4#4#4#8#8#:;rra) r(r)r*r+rhr6r?rKr-rrrr^r^sG  URnX!LagUbUTLaOUnMXlgr ) __context__)new_excold_exc exc_context frame_excs r_fix_exception_context3_make_context_fixer.._fix_exception_contexts<%11 )&+*B%#* rr)rrs` r_make_context_fixerrs *&%rc^USRnUSe![a WUSlef=f)NrB)r BaseException) exc_details fixed_ctxs r_reraise_with_existing_contextrs@ $A22Ia.  )2KN &  s,cS$)Ncgr r)rrs r%_make_context_fixer..srr)rs rrrs,,rc$Uupn[S5 g)Nz!raise exc_type, exc_value, exc_tb)exec)rexc_type exc_valueexc_tbs rrr"s&1#V 12r) InstanceTypecF[U5nU[La UR$U$r )r4rr9)objobj_types r _get_typer.s"9 | #== rcN\rSrSrSrSrSrSrSrSr Sr S r S r S r S rg )r i5aoContext manager for dynamic management of a stack of exit callbacks For example: with ExitStack() as stack: files = [stack.enter_context(open(fname)) for fname in filenames] # All opened files will automatically be closed at the end of # the with statement, even if attempts to open files later # in the list raise an exception c"[5Ulgr )r_exit_callbacksrs rr6ExitStack.__init__As $wrcf[U5"5nURUl[5UlU$)z?Preserve the context stack by transferring it to a new instance)r4rr)r new_stacks rpop_allExitStack.pop_allDs+JL $($8$8 !$wrcF^^UU4SjnTUlURU5 g)z:Helper to correctly register callbacks to __exit__ methodsc>T"T/UQ76$r r)rcmcm_exits r _exit_wrapper.ExitStack._push_cm_exit.._exit_wrapperMs2, , ,rN)__self__push)rrrrs `` r _push_cm_exitExitStack._push_cm_exitKs -!#  - rc[U5nURnURX5 U$![a URR U5 U$f=f)zRegisters a callback with the standard __exit__ method signature Can suppress exceptions the same way __exit__ methods can. Also accepts any object with an __exit__ method (registering a call to the method instead of the object itself) )rrKrAttributeErrorrrg)rexit_cb_type exit_methods rrExitStack.pushRs^T? 2"++K   t 1  .  ' ' -  .s ,%AAcL^^^UUU4SjnTUlURU5 T$)zLRegisters an arbitrary callback and arguments. Cannot suppress exceptions. c>T"T0TD6 gr r)rrJtbr!callbackr"s rr)ExitStack.callback.._exit_wrapperks d #d #r) __wrapped__r)rrr!r"rs ``` rrExitStack.callbackfs#  $%- ! - rcx[U5nURnURU5nURX5 U$)zEnters the supplied context manager If successful, also pushes its __exit__ method as a callback and returns the result of the __enter__ method. )rrKr?r)rr_cm_type_exitresults r enter_contextExitStack.enter_contextss;R=!!##B' 2% rc*URSSS5 g)z$Immediately unwind the context stackN)rKrs rrZExitStack.closes dD$'rcU$r rrs rr?ExitStack.__enter__s rcUSSLn[R"5Sn[U5nSnSnUR(a>URR 5nU"U6(aSnSnSnUR(aM>U(a [ U5 U=(a U$! [R"5nU"USUS5 SnUnN\=f)NrrBFT)NNN)rFrGrrrlr) rr received_excrrsuppressed_exc pending_raisecbnew_exc_detailss rrKExitStack.__exit__s"1~T1 LLN1% !4Y!? ""%%))+B .{#%)N$)M"4K """  *; 7.. ."%,,.&q'9;q>J $ - s B*C)rN)r(r)r*r+r,r6rrrrrrZr?rKr-rrrr r 5s4 '!(  (/rr c>^\rSrSrSrU4SjrSrSrSrSr U=r $)r iz+Backwards compatibility alias for ExitStackc`>[R"S[5 [[U]5 g)Nz*ContextStack has been renamed to ExitStack)rrrsuperr r6)rr9s rr6ContextStack.__init__s" B( * lD*,rc$URU5$r )r)rrs r register_exitContextStack.register_exitsyy""rc.UR"U/UQ70UD6$r )r)rrr!r"s rregisterContextStack.registers}}X5555rc"UR5$r )rrs rpreserveContextStack.preserves||~rr) r(r)r*r+r,r6rrrr- __classcell__)r9s@rr r s5- #6r)r,rFr collectionsr functoolsr__all__objectrr/rrr^r r r version_inforDrrtypesrr ImportErrorr4r r rrrrsG  =N %v%PE/EPDf2++A.!3& - 3 " m/m/`9yIsB88CC