R jrrBQs]PHs]PHs]PH s]PHs]QHGs]QHGs]QH%G s G s Gs]QH@Gs,Q-NsQQ\O&2sQQ\O&2sQQ \2sQQ\2sQQ2sQQ\\\2sQQ\\\2sQsQsQQ\2sQQ\2sQ Q!\2s Q"Q \ 2s!Q#Q \ 2s"Q$Q\2s#Q%s$Q&,s%Q'Q(2s&Q)Q \&\2s'Q*Q \&\2s(Q+Q\\2s)Q,Q\2s*P!).z4Utilities for with-statement contexts. See PEP 343.)dequewraps)isasyncgenfunctioniscoroutinefunctionisgeneratorfunction) GenericAliasclosing nullcontextAbstractContextManagerAbstractAsyncContextManagerAsyncExitStackContextDecorator ExitStackredirect_stdoutredirect_stderrsuppressaclosingchdirct`\sQs]snQs\\2sQsQs \ OQ2s \Q2s QsUsP!)r z,An abstract base class for context managers.c U!z0Return `self` upon entering the runtime context.selfs&'/usr/local/lib/python3.15/contextlib.py __enter__ AbstractContextManager.__enter__s c P!z9Raise any exception triggered within the runtime context.rrexc_type exc_value tracebacks&&&&r__exit__AbstractContextManager.__exit__#srcTU[Ic[OUQQ2![!)rr%)r _collections_abc_check_methodsNotImplementedclsCs&&r__subclasshook__'AbstractContextManager.__subclasshook__(s& ( (#221k:N Nrr)__name__ __module__ __qualname____firstlineno____doc__ classmethodr__class_getitem__ __slots__rabcabstractmethodr%r.__static_attributes____classdictcell__ __classdict__s@rr r sK6#L1I rct`\sQs]/snQs\\2sQsQs \ OQ2s \Q2s QsUsP!)r z9An abstract base class for asynchronous context managers.c  U!3hrrrs&r __aenter__&AbstractAsyncContextManager.__aenter__7s  c  P!3hr rr!s&&&&r __aexit__%AbstractAsyncContextManager.__aexit__;s rBcTU[Ic[OUQQ2![!)r@rD)r r(r)r*r+s&&rr.,AbstractAsyncContextManager.__subclasshook__@s- - -#221l3>@ @rr)r0r1r2r3r4r5rr6r7r@r8r9rDr.r:r;r<s@rr r /sKC#L1I rc2`\sQs]HsnQsQsQsQsUsP!)rzJA base class or mixin that enables context managers to work as decorators.c U!)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. rrs&r _recreate_cmContextDecorator._recreate_cmKs  rc``[R2o[R2%cUU1QkoUU2![R2%cUU1QkoUU2![R2%cUU1QkoUU2!UU1QkoUU2!)c `: RO29^tt^2[RU-U@29^tt^2EPiwK oUPiwK oU3wJKKBPPP2EPiwK L)EPiwK %fhL9hPPP2P!)%fhP!9h3hNrJrargskwdsgenvaluefuncrs*, rasyncgen_inner1ContextDecorator.__call__..asyncgen_inner[sr&&(('d(;d(;<<<+.((%"'K =(3 =<<<<<)(((sB. BABA2 A A A  A2 BA A2  B*A. +B2B 9A=: B B B B.B+ #B+ % B.c: RO29^tt^2RU-U@EPiwK ttPPP2!K)%fhP!9h3hrNrJrQrRrUrs*,r async_inner.ContextDecorator.__call__..async_innerds>&&((!%t!4t!444)(4)((s+A=; = A=A A  Ac ?: RO29^tt^2[RU-U@29^tt^2oSFPiwK ttPPP2ttPPP2!K)%fhL9hPPP2P!)%fhP!9h3hrNrJr )rQrRrSrUrs*, r gen_inner,ContextDecorator.__call__..gen_innerksZ&&(('$2E2E*F*F#'*NN+G*F((*+G*F((((sVB A8A AA  A8 B A A+ $A+ &A8. B 8B B  B c:RO29^tt^2RU-U@ttPPP2!)%fhP!9hrNrYrZs*,rinner(ContextDecorator.__call__..innerrs.&&((..)(((s /A A r_isasyncgenfunction_iscoroutinefunction_isgeneratorfunctionrrUwrapperrVr[r_rbsff r__call__ContextDecorator.__call__Wst+ t $ $ ( >* * !$ ' ' 5;' ' !$ ' ' ,9% % /5> !rr r0r1r2r3r4rJrjr:r;r<s@rrrHsP ""rc2`\sQs]ysnQsQsQsQsUsP!)AsyncContextDecoratorzPA base class or mixin that enables async context managers to work as decorators.c U!)z-Return a recreated instance of self. rrs&rrJ"AsyncContextDecorator._recreate_cm|s  rc``[R2o[R2%cUU1QkoUU2![R2%cUU1QkoUU2![R2%cUU1QkoUU2!UU1QkoUU2!)c : RO29^tt^2EPiwK [RU-U@29^tt^2EPiwK oUPiwK oU3wJK?KKBPPP2EPiwK L)EPiwK %fhL9hPPP2EPiwK P!)EPiwK %fhP!9h3hrNrOrPs*, rrV6AsyncContextDecorator.__call__..asyncgen_inners%%'''T4040111S'*$$e# (1$s211111(''''''sCA# C B1A%B1 A> A) A'A)  A> #C%B1'A) )A> * B16A: 7B1>B B  B B B1 C(B,)C1C 8B<9 C C  Cc : RO29^tt^2EPiwK RU-U@EPiwK ttPPP2EPiwK !K+KK )EPiwK %fhP!9h3hrNrYrZs*,rr[3AsyncContextDecorator.__call__..async_innersG,,...!%t!4t!444/..4/...sYA4A A4AA AA4A A4AA4A1 A  A1 )A1 + A4c N: RO29^tt^2EPiwK [RU-U@29^tt^2oSFD oU3wJ PPP2PPP2EPiwK P!KK)%fhK&9hK)EPiwK %fhP!9h3hrNr^rPs*, rr_1AsyncContextDecorator.__call__..gen_innersc,,... t!4t!455%(E"'K&)6/..55/...shB%A/ B%BA1 B B%'B(B%1B :B <BB%B" B B" B"  B%c : RO29^tt^2EPiwK RU-U@ttPPP2EPiwK !K!K)EPiwK %fhP!9h3hrNrYrZs*,rrb-AsyncContextDecorator.__call__..inners<,,...../......sGA(A A( A A(AA(A( A% A A% A%  A(rdrhsff rrjAsyncContextDecorator.__call__st+ t $ $ $>* * !$ ' ' 5;' ' !$ ' ' ( 9% % /5> !rrrlr<s@rrnrnysV #"#"rrnc2`\sQs]snQsQsQsQsUsP!)_GeneratorContextManagerBasezBShared functionality for @contextmanager and @asynccontextmanager.cUU-U@UmVUtUmUmUm[ UQP2oUe[ U2O oV@mP!)r4)rSrUrQrRgetattrtyper4)rrUrQrRdocs&&&& r__init__%_GeneratorContextManagerBase.__init__sN&&*.d' 49didIt, ;t*$$C rcfUOUOUOUO2!rN) __class__rUrQrRrs&rrJ)_GeneratorContextManagerBase._recreate_cms#~~diiDII>>r)r4rQrUrSrR) r0r1r2r3r4rrJr:r;r<s@rr|r|sL??rr|c2`\sQs]snQsQsQsQsUsP!)_GeneratorContextManagerz%Helper for @contextmanager decorator.crU;U;U;[UO2![ c[ Q2Pgh9h)generator didn't yield)rQrRrUnextrS StopIteration RuntimeErrorrs&rr"_GeneratorContextManager.__enter__sD Ity$) C> ! C78d B Cs  66cpUe#[UO2[Q2gUeU2oUOO U2[Q2gSOO2h9h[cP !h9h[coXBItPo=!Po=h[cJoXBIc X4mPo=P ![S[2%cSOSIc X2mPo=P !gPo=h[coXBIcgX4mPo=P !Po=hh9hSOO2h9h)Ngenerator didn't stopz#generator didn't stop after throw()) rrSrcloserthrow __traceback__ isinstance __cause__ BaseExceptionrtyprTr$excs&&&& rr%!_GeneratorContextManager.__exit__s  ; %TXX%&'>??}# u%F !"#HIIWHHNN$ !  ! ('' <(1% um44 .*3'  #$-!  sA: AB  DA7: B B B  DDBD D,D-C12C1>C1C1$C10C11 D>D?DDDD5r) r0r1r2r3r4rr%r:r;r<s@rrrs 0C7!7!rrc2`\sQsQsnQsQsQsQsUsP!)_AsyncGeneratorContextManagerz*Helper for @asynccontextmanager decorator.c U;U;U;[UO2EPiwK !K[ c[ Q2Pgh9h3h)Nr)rQrRrUanextrSStopAsyncIterationrrs&rr@(_AsyncGeneratorContextManager.__aenter__sO Ity$) Ctxx(( ((! C78d B Cs*A,*,A, AAAc Ue-[UO2EPiwK [Q2gUeU2oUOO U2EPiwK [Q2gKMSOO2EPiwK h9h[cP !h9hKN[coXBItPo=!Po=h[cPoXBIc X4mPo=P ![S[[12%cSOSIc X2mPo=P !gPo=h[coXBIcgX4mPo=P !Po=hh9hSOO2EPiwK h9h3h)Nrz$generator didn't stop after athrow()) rrSracloserathrowrrrrrrs&&&& rrD'_AsyncGeneratorContextManager.__aexit__s6 ; ,DHHo%%,&'>??}# hhooe,,,F ("#IJJe&((//+++ &  -% ('' <(1% u}6H&IJJ .*3'  #$-! hhoo'''sE.BA1B A3E.E.B1B/ B1& E1B3BB BE. B,'B,(E.+B,,E./B11 E;E<C>E?E. EEDDE.#D?DDE.D E)E*D</D<6E.<EE.E+#E' $E++E.r) r0r1r2r3r4r@rDr:r;r<s@rrrs 5C7(7(rrc2`[R2U1Qk2oU!)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:[RV2!rN)rrQrRrUs*,rhelpercontextmanager..helperms'd99rrrUrsf rcontextmanagerrRs 6 4[:: Mrc2`[R2U1Qk2oU!)a@asynccontextmanager decorator. Typical usage: @asynccontextmanager async def some_async_generator(): try: yield finally: This makes this: async with some_async_generator() as : equivalent to this: try: = finally: c:[RV2!rN)rrs*,rr#asynccontextmanager..helpers,T4>>rrrsf rasynccontextmanagerrss 6 4[?? Mrc8`\sQsQsnQsQsQsQsQsUs P!)r a 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() cVmP!rNthingrrs&&rrclosing.__init__ rcUO!rNrrs&rrclosing.__enter__s zzrc<UOO2P!rN)rrrexc_infos&*rr%closing.__exit__s rr r0r1r2r3r4rrr%r:r;r<s@rr r s rc8`\sQsQsnQsQsQsQsQsUs P!)rarAsync context manager for safely finalizing an asynchronously cleaned-up resource such as an async generator, calling its ``aclose()`` method. Code like this: async with aclosing(.fetch()) as agen: is equivalent to this: agen = .fetch() try: finally: await agen.aclose() cVmP!rNrrs&&rraclosing.__init__rrc$ UO!3hrNrrs&rr@aclosing.__aenter__szzc\ UOO2EPiwK P!K3hrN)rrrs&*rrDaclosing.__aexit__sjj!!!s ,*,r) r0r1r2r3r4rr@rDr:r;r<s@rrrs"""rc8`\sQsQsnPsQsQsQsQsUs P!)_RedirectStreamc"Vm,UmP!rN _new_target _old_targets)r new_targets&&rr_RedirectStream.__init__s%rcUOO[[UO22[ [UOUO 2UO !rN)rappendr~sys_streamsetattrrrs&rr_RedirectStream.__enter__sC   dll!;<T\\4#3#34rcn[[UOUOO 22P!rN)rrrrpop)rexctypeexcinstexctbs&&&&rr%_RedirectStream.__exit__s!T\\4#4#4#8#8#:;rr) r0r1r2r3rrrr%r:r;r<s@rrrsG  <._exit_wrapper)s d #d #rrrrQrRr sbjl r_create_cb_wrapper!_BaseExitStack._create_cb_wrapper's $rc&[2UmP!rN)r_exit_callbacksrs&rr_BaseExitStack.__init__-s $wrc h[U22oUOUm[2UmU!)z@Preserve the context stack by transferring it to a new instance.)rrr)r new_stacks& rpop_all_BaseExitStack.pop_all0s+JL $($8$8 !$wrc D[UQU2oUOU2U!)zRegisters a callback with the standard __exit__ method signature. Can suppress exceptions the same way __exit__ method can. Also accepts any object with an __exit__ method (registering a call to the method instead of the object itself). r%r_push_exit_callbackrexit exit_methods&& rpush_BaseExitStack.push7s%&dJ=    - rc h[UQ[2oU[Ic2[U2o[QUO QUO Q02g[UQ[2oU[Ic2[U2o[QUO QUO Q02gU2oUO U2U!)zEnters the supplied context manager. If successful, also pushes its __exit__ method as a callback and returns the result of the __enter__ method. r'.z6' object does not support the context manager protocolr%r _sentinelr TypeErrorr1r2rrcm_enterr,_exitresults&& r enter_context_BaseExitStack.enter_contextBs ![)< Y r(Ca/q1A1A0BCGHI IJ : I r(Ca/q1A1A0BCGHI I   ' rc dUOU,UN3-U@oVmUOU2U!)zLRegisters an arbitrary callback and arguments. Cannot suppress exceptions. )r  __wrapped__rrrrQrRr s""*, rr_BaseExitStack.callbackVs9 //H4H4H %-!   /rc@UOOV!12P!rN)rr)rris_syncs&&&rr"_BaseExitStack._push_exit_callbackcs ##W$78r)r)T)r0r1r2r3r4 staticmethodr rrrr(rrr:r;r<s@rrr$s=8 ' ( 99rrc8`\sQsQsnQsQsQsQsQsUs P!)rhaoContext 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. cU!rNrrs&rrExitStack.__enter__ss rc` U]*oUPIo[O2n U 1QkoP oP oUO%c]UOO2vqxU%fPgUeQoL[ U2V"O 1oUU%c P oP oPoJlJnU%cUOo UgS9%cS![ co SX2P oS oPo = JPo = hh9h[ c W Smgh9h)c\:UOoUdV!IcP!URIcLSoJ#VmP!r7 __context__new_excold_exc exc_context frame_excs&& r_fix_exception_context2ExitStack.__exit__.._fix_exception_context}7%11 &+*@)+%#* rNNNr exceptionrrrrrr;) r exc_detailsr received_excrAsuppressed_exc pending_raiser/cbr= fixed_ctxr@s &* @rr%ExitStack.__exit__vs!n$ MMO  *  """..224KGN7 ;"2K"&s)S2C2C"CK{##%)N$)MC$   OO  ...! &w4 $   ! "+ s<(C,&CC&C% C" C" CC"% C9/ C9c .UOPPP2P!z%Immediately unwind the context stack.)r%rs&rrExitStack.closes dD$'rr) r0r1r2r3r4rr%rr:r;r<s@rrrhs4/l((rcZ`\sQsQsnQs\Q2sQsQsQs Qs Qs Q s Q s UsP!) r aAsync context manager for dynamic management of a stack of exit callbacks. For example: async with AsyncExitStack() as stack: connections = [await stack.enter_async_context(get_connection()) for i in range(5)] # All opened connections will automatically be released at the # end of the async with statement, even if attempts to open a # connection later in the list raise an exception. c```UUU1QkoU!)c<: RR-R@EPiwK P!K3hrNrrs&&&rr >AsyncExitStack._create_async_cb_wrapper.._exit_wrappersD)D) ) )s rr sbjl r_create_async_cb_wrapper'AsyncExitStack._create_async_cb_wrappers *rc  [UQ[2oU[Ic2[U2o[QUO QUO Q02g[UQ[2oU[Ic2[U2o[QUO QUO Q02gU2EPiwK oUO UP 2U!K3h)zEnters the supplied async context manager. If successful, also pushes its __aexit__ method as a callback and returns the result of the __aenter__ method. r@rrzC' object does not support the asynchronous context manager protocolrDr r#s&& renter_async_context"AsyncExitStack.enter_async_contexts !\9= Y r(Ca/q1A1A0BCTUV VK; I r(Ca/q1A1A0BCTUV Vx   .  sCA C+    e4 rc fUOU,UN3-U@oVmUOUP 2U!)zVRegisters an arbitrary coroutine function and arguments. Cannot suppress exceptions. )rVr+rr,s""*, rpush_async_callback"AsyncExitStack.push_async_callbacks; 55hNNN %-!   6rc N UOPPP2EPiwK P!K3hrO)rDrs&rrAsyncExitStack.aclosesnnT4...s %#%c U!3hrNrrs&rr@AsyncExitStack.__aenter__s  rBc(` U]*oUPIo[O2n U 1QkoP oP oUO%coUOO2vqxUeQoL[ U2V"O 1oU%c UUo LUUEPiwK o U %c P oP oPoJ~JU%cUOo UgS9%cS!K9[ co SX2P oS oPo = JPo = hh9h[ c W Smgh9h3h)r7c\:UOoUdV!IcP!URIcLSoJ#VmP!r9r:r<s&& rrA8AsyncExitStack.__aexit__.._fix_exception_contextrCrrDrE) rrGrrHrArIrJr/rK cb_suppressr=rLr@s &* @rrDAsyncExitStack.__aexit__s!n$ MMO  *  """..224KG ;"2K"&s)S2C2C"CK"$k"2K(*K(8"8"8K%)N$)MC   OO  ...+#9 ! &w4 $   ! "+ s?DD C$!CCC C'C- D:C;DDC C8 C8! C3-D3C88D; D DDr)r0r1r2r3r4r1rVrYr\r_rr@rDr:r;r<s@rr r sA  (  /8/8/rcH`\sQsQsnQsQ QksQsQsQsQs Qs Us P!) r 4a7Context manager that does no additional processing. Used as a stand-in for a normal context manager, when a particular block of code is only sometimes used with a normal context manager: cm = optional_cm if condition else nullcontext() with cm: # Perform operation, using optional_cm if condition is True cVmP!rN enter_result)rrns&&rrnullcontext.__init__?s(rcUO!rNrmrs&rrnullcontext.__enter__Bs   rcP!rNrrexcinfos&*rr%nullcontext.__exit__Errc$ UO!3hrNrmrs&rr@nullcontext.__aenter__Hs   rc P!3hrNrrss&*rrDnullcontext.__aexit__Ks rBrmrN) r0r1r2r3r4rrr%r@rDr:r;r<s@rr r 4s()! !  rc8`\sQsQsnQsQsQsQsQsUs P!)rOzHNon thread-safe context manager to change the current working directory.c"Vm,UmP!rN)path_old_cwd)rr}s&&rrchdir.__init__Rs  rcUOO[O22[OUO 2P!rN)r~rosgetcwdrr}rs&rrchdir.__enter__Vs* RYY[) rcd[OUOO22P!rN)rrr~rrss&*rr%chdir.__exit__Zs ""$%r)r~r}rr<s@rrrOsR&&r)rrr r r r r rrrrrrr)+r4r8rrr( collectionsr functoolsrrrrerrfrrgtypesr__all__ABCr r objectrrnr|rrrrr rrrrrrr!rrr r rrrrrsU:   SWW0#''2."v."b+"F+"\??0G! G!RG( G(TBB$2"*"4<,<$ o  o $%$N'L @9@9HF( 6F(T/^%@/D (*E 6 & " &r