+ Brhl$Rt^RIt^RIt^RIt^RIt^RIHt^RIHt^RI H t H t .R+Ot !RR]P4t!RR]P4t!RR ]4t!RR]4t!RR4t!RR]]]4t!RR]]]4tRtRt!RR]4t!RR]4t!R R!]4t!R"R ]4t!R#R ]4t!R$R]4t!R%R&4t!R'R ]]4t!R(R ]]4t !R)R]]4t!!R*R]4t"R#),z4Utilities for with-statement contexts. See PEP 343.N)dequewraps) MethodType GenericAliasclosing nullcontextAbstractContextManagerAbstractAsyncContextManagerAsyncExitStackContextDecorator ExitStackredirect_stdoutredirect_stderrsuppressaclosingchdircra]tRt^toRt]!]4tRtRt ] PR4t ]R4t RtVtR#)r z,An abstract base class for context managers.c V#z0Return `self` upon entering the runtime context.selfs&'/usr/local/lib/python3.14/contextlib.py __enter__ AbstractContextManager.__enter__s c R#z9Raise any exception triggered within the runtime context.Nrrexc_type exc_value tracebacks&&&&r__exit__AbstractContextManager.__exit__srcRV\Jd\P!VRR4#\#)rr#)r _collections_abc_check_methodsNotImplementedclsCs&&r__subclasshook__'AbstractContextManager.__subclasshook__"s& ( (#221k:N NrrN)__name__ __module__ __qualname____firstlineno____doc__ classmethodr__class_getitem__ __slots__rabcabstractmethodr#r,__static_attributes____classdictcell__ __classdict__s@rr r sK6#L1I rcra]tRt^)toRt]!]4tRtRt ] PR4t ]R4t RtVtR#)r z9An abstract base class for asynchronous context managers.c "V#5irrrs&r __aenter__&AbstractAsyncContextManager.__aenter__1s  c "R#5irrrs&&&&r __aexit__%AbstractAsyncContextManager.__aexit__5s r@cRV\Jd\P!VRR4#\#)r>rB)r r&r'r(r)s&&rr,,AbstractAsyncContextManager.__subclasshook__:s- - -#221l3>@ @rrN)r.r/r0r1r2r3rr4r5r>r6r7rBr,r8r9r:s@rr r )sKC#L1I rc0a]tRt^BtoRtRtRtRtVtR#)r zJA base class or mixin that enables context managers to work as decorators.c V#)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_cmEs  rc4aa\S4VV3Rl4pV#)c<SP4;_uu_4S!V/VBuuRRR4# +'giR#;iNrHargskwdsfuncrs*,rinner(ContextDecorator.__call__..innerRs.""$$T*T*%$$$s- > rrrQrRsff r__call__ContextDecorator.__call__Qs t +  + rrN r.r/r0r1r2rHrUr8r9r:s@rr r BsP rc0a]tRt^YtoRtRtRtRtVtR#)AsyncContextDecoratorzPA base class or mixin that enables async context managers to work as decorators.c V#)z-Return a recreated instance of self. rrs&rrH"AsyncContextDecorator._recreate_cm\s  rc4aa\S4VV3Rl4pV#)c<"SP4;_uu_4GRjxL S!V/VBGRjxL uuRRR4GRjxL #L&LL +GRjxL 'giR#;i5irLrMrNs*,rrR-AsyncContextDecorator.__call__..innerbsD((***!40400+**0+***sYA*AA* A A A  A*A A* A  A* A' A A' A' ! A*rrTsff rrUAsyncContextDecorator.__call__as t 1  1 rrNrWr:s@rrYrYYsV rrYc0a]tRt^itoRtRtRtRtVtR#)_GeneratorContextManagerBasezBShared functionality for @contextmanager and @asynccontextmanager.cV!V/VBVnWVuVnVnVn\ VRR4pVf\ V4P pW@nR#)r2N)genrQrOrPgetattrtyper2)rrQrOrPdocs&&&& r__init__%_GeneratorContextManagerBase.__init__lsN&&*.d' 49didIt, ;t*$$C rcdVPVPVPVP4#rL) __class__rQrOrPrs&rrH)_GeneratorContextManagerBase._recreate_cmzs#~~diiDII>>r)r2rOrQrcrPN) r.r/r0r1r2rgrHr8r9r:s@rraraisL??rrac0a]tRt^toRtRtRtRtVtR#)_GeneratorContextManagerz%Helper for @contextmanager decorator.cpV=V=V=\VP4# \ d\ R4Rhi;i)generator didn't yieldN)rOrPrQnextrc StopIteration RuntimeErrorrs&rr"_GeneratorContextManager.__enter__sD Ity$) C> ! C78d B Cs5cnVf#\VP4\R4hVfV!4pVPP V4\R4h TPP4i;i \dR#i;i \dpYBJuRp?#Rp?i\dJpYBJd Y4nRp?R#\T\4'dTPTJd Y2nRp?R#hRp?i\dpYBJdhY4nRp?R#Rp?ii;i TPP4i;i)Ngenerator didn't stopFz#generator didn't stop after throw()) rprcrrcloserqthrow __traceback__ isinstance __cause__ BaseExceptionrtypvaluer"excs&&&& rr#!_GeneratorContextManager.__exit__s  ; %TXX%&'>??}# u%F !"#HIIWHHNN$ !  ! ('' <(1% um44 .*3'  #$-!  suA9 AB  DA69 BB DBD D+D, C0=,C0/C00 D=D> DDD4rN) r.r/r0r1r2rr#r8r9r:s@rrmrms 0C7!7!rrmc0a]tRt^toRtRtRtRtVtR#)_AsyncGeneratorContextManagerz*Helper for @asynccontextmanager decorator.c"V=V=V=\VP4GRjxL #L \ d\ R4Rhi;i5i)Nro)rOrPrQanextrcStopAsyncIterationrrrs&rr>(_AsyncGeneratorContextManager.__aenter__sL Ity$) Ctxx( ((! C78d B Cs%A)')A)AAc"Vf+\VP4GRjxL \R4hVfV!4pVPP V4GRjxL \R4hLK TPP4GRjxL i;i \dR#i;iLL \dpYBJuRp?#Rp?i\dPpYBJd Y4nRp?R#\T\\34'dTPTJd Y2nRp?R#hRp?i\dpYBJdhY4nRp?R#Rp?ii;i TPP4GRjxL i;i5i)NruFz$generator didn't stop after athrow()) rrcrracloserathrowrxryrqrzr{r|s&&&& rrB'_AsyncGeneratorContextManager.__aexit__s6 ; ,DHHo%%,&'>??}# hhooe,,,F ("#IJJe&((//+++ &  -% ('' <(1% u}6H&IJJ .*3'  #$-! hhoo'''sE%BA,B A. E%B*B(B*! D=,B.B B BE% B%!E%$B%%E%(B** D:5B=7D:8E%= D: D: DE%2DE%D D:"D:# D5/E%5D::E%=E"EE""E%rN) r.r/r0r1r2r>rBr8r9r:s@rrrs 5C7(7(rrc0a\S4V3Rl4pV#)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<\SW4#rL)rmrOrPrQs*,rhelpercontextmanager..helper/s'd99rrrQrsf rcontextmanagerrs 6 4[:: Mrc0a\S4V3Rl4pV#)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<\SW4#rL)rrs*,rr#asynccontextmanager..helperPs,T4>>rrrsf rasynccontextmanagerr5s 6 4[?? Mrc6a]tRtRtoRtRtRtRtRtVt R#)riVa 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() cWnR#rLthingrrs&&rrgclosing.__init__g rcVP#rLrrs&rrclosing.__enter__is zzrc:VPP4R#rL)rrvrexc_infos&*rr#closing.__exit__ks rrN r.r/r0r1r2rgrr#r8r9r:s@rrrVs rc6a]tRtRtoRtRtRtRtRtVt R#)rioarAsync 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() cWnR#rLrrs&&rrgaclosing.__init__rrc""VP#5irLrrs&rr>aclosing.__aenter__szz cV"VPP4GRjxL R#L5irL)rrrs&*rrBaclosing.__aexit__sjj!!!s )')rN) r.r/r0r1r2rgr>rBr8r9r:s@rrros"""rc6a]tRtRtoRtRtRtRtRtVt R#)_RedirectStreamiNc Wn.VnR#rL _new_target _old_targets)r new_targets&&rrg_RedirectStream.__init__s%rcVPP\\VP44\ \VPVP 4VP #rL)rappendrdsys_streamsetattrrrs&rr_RedirectStream.__enter__sC   dll!;<T\\4#3#34rcl\\VPVPP 44R#rL)rrrrpop)rexctypeexcinstexctbs&&&&rr#_RedirectStream.__exit__s!T\\4#4#4#8#8#:;rr) r.r/r0r1rrgrr#r8r9r:s@rrrsG  <._exit_wrappers d #d #rrrrOrPrsbjl r_create_cb_wrapper!_BaseExitStack._create_cb_wrappers $rc$\4VnR#rL)r_exit_callbacksrs&rrg_BaseExitStack.__init__s $wrc f\V4!4pVPVn\4VnV#)z@Preserve the context stack by transferring it to a new instance.)rerr)r new_stacks& rpop_all_BaseExitStack.pop_alls+JL $($8$8 !$wrc \V4pVPpVPW4V# \dTP T4T#i;i)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). )rer# _push_cm_exitAttributeError_push_exit_callbackrexit_cb_type exit_methods&& rpush_BaseExitStack.pushsX: 2"++K   t 1  +  $ $T *  +s ,A  A c \V4pVPpVPpT!T4pTPY4T# \d)\ RTP RTP R24Rhi;i)zEnters the supplied context manager. If successful, also pushes its __exit__ method as a callback and returns the result of the __enter__ method. '.z6' object does not support the context manager protocolN)rerr#r TypeErrorr/r0rrrr*_enter_exitresults&& r enter_context_BaseExitStack.enter_contexts2h S]]FLLE 2%  Sa/q1A1A0BCGHINR S Ss A3A3c `VP!V.VO5/VBpWnVPV4V#)zLRegisters an arbitrary callback and arguments. Cannot suppress exceptions. )r __wrapped__rrrrOrPrs""*, rr_BaseExitStack.callbacks9 //H4H4H %-!   /rc LVPW4pVPVR4R#)z;Helper to correctly register callbacks to __exit__ methods.TN)rrrrrrs&&& rr_BaseExitStack._push_cm_exit#s"11">    5rc>VPPW!34R#rL)rr)rris_syncs&&&rr"_BaseExitStack._push_exit_callback(s ##W$78r)rN)T)r.r/r0r1r2 staticmethodrrrgrrrrrrr8r9r:s@rrrsV8'' '(& 6 99rrc6a]tRtRtoRtRtRtRtRtVt R#)r i-aoContext 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. cV#rLrrs&rrExitStack.__enter__8s rca V^,pVRJp\P!4o V 3RlpRpRpVP'd\VPP4wrxV'gQhVfRpM\ V4W"P 3pV!V!'d RpRpRpKkKmV'dVPp VhT;'dT# \ dp T!Y4RpT pRp ? KRp ? ii;i \ d X Tnhi;i)NcZ<VPpVeW!JdR#VSJdMTpK#WnR#rN __context__new_excold_exc exc_context frame_excs&& r_fix_exception_context2ExitStack.__exit__.._fix_exception_contextB7%11 &+*@)+%#* rFTNNNr exceptionrrrerxr{r) r exc_detailsr received_excrsuppressed_exc pending_raiser cbr fixed_ctxrs &* @rr#ExitStack.__exit__;s!n$ MMO  *  """..224KGN7 ;"2K"&s)S2C2C"CK{##%)N$)MC$   OO  ...! &w4 $   ! "+ s*')B>B>$C#> C  CC #C7c ,VPRRR4R#z%Immediately unwind the context stack.N)r#rs&rrvExitStack.closeqs dD$'rrN) r.r/r0r1r2rr#rvr8r9r:s@rr r -s4/l((rcna]tRtRtoRt]R4t]R4tRtRt Rt Rt R t R t R tR tVtR #)r iwaAsync 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\W4#rLrrs&&r_create_async_exit_wrapper)AsyncExitStack._create_async_exit_wrapperrrcaaaVVV3RlpV#)c4<"S!S/SBGRjxL R#L5irLrrs&&&rr>AsyncExitStack._create_async_cb_wrapper.._exit_wrappersD)D) ) )s rrsbjl r_create_async_cb_wrapper'AsyncExitStack._create_async_cb_wrappers *rc "\V4pVPpVPpT!T4GRjxL pTPY4T# \d)\ RTP RTP R24Rhi;iLM5i)zEnters the supplied async context manager. If successful, also pushes its __aexit__ method as a callback and returns the result of the __aenter__ method. rrzC' object does not support the asynchronous context manager protocolN)rer>rBrrr/r0_push_async_cm_exitrs&& renter_async_context"AsyncExitStack.enter_async_contexts 2h '^^FMME bz!   +  'a/q1A1A0BCTU"& ' '"s% BA BBB 3A==Bc \V4pVPpVPW4V# \dTP TR4T#i;i)zRegisters a coroutine function with the standard __aexit__ method signature. Can suppress exceptions the same way __aexit__ method can. Also accepts any object with an __aexit__ method (registering a call to the method instead of the object itself). F)rerBr7rrrs&& rpush_async_exitAsyncExitStack.push_async_exitsZ: 8",,K  $ $T 7  2  $ $T5 1  2s ,A  A c bVP!V.VO5/VBpWnVPVR4V#)zVRegisters an arbitrary coroutine function and arguments. Cannot suppress exceptions. F)r4rrrs""*, rpush_async_callback"AsyncExitStack.push_async_callbacks; 55hNNN %-!   6rc H"VPRRR4GRjxL R#L5ir+)rBrs&rrAsyncExitStack.aclosesnnT4...s " "c LVPW4pVPVR4R#)zDHelper to correctly register coroutine function to __aexit__ method.FN)r/rr s&&& rr7"AsyncExitStack._push_async_cm_exits$77D    6rc"V#5irLrrs&rr>AsyncExitStack.__aenter__s  r@ca "V^,pVRJp\P!4o V 3RlpRpRpVP'dkVPP4wrxVfRpM\ V4W"P 3pV'dV!V!p MV!V!GRjxL p V 'd RpRpRpKzK|V'dVPp VhT;'dT#L9 \ dp T!Y4RpT pRp ? KRp ? ii;i \ d X Tnhi;i5i)rNcZ<VPpVeW!JdR#VSJdMTpK#WnR#rrrs&& rr8AsyncExitStack.__aexit__.._fix_exception_contextrrFTr r!) rr#rr$rr%r&r r' cb_suppressrr(rs &* @rrBAsyncExitStack.__aexit__s!n$ MMO  *  """..224KG ;"2K"&s)S2C2C"CK"$k"2K(*K(8"8K%)N$)MC   OO  ...+#9 ! &w4 $   ! "+ sq>D D %CCC C"C( D 5C6D  D C C3 C.(D .C33D 6D  D rN)r.r/r0r1r2rr/r4r8r;r>rr7r>rBr8r9r:s@rr r wsZ '' $$ /7 8/8/rcFa]tRtRtoRtR RltRtRtRtRt R t Vt R#) ria7Context 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 NcWnR#rL enter_result)rrNs&&rrgnullcontext.__init__s(rcVP#rLrMrs&rrnullcontext.__enter__s   rcR#rLrrexcinfos&*rr#nullcontext.__exit__rrc""VP#5irLrMrs&rr>nullcontext.__aenter__s   rc"R#5irLrrSs&*rrBnullcontext.__aexit__s r@rMrL) r.r/r0r1r2rgrr#r>rBr8r9r:s@rrrs()! !  rc6a]tRtRtoRtRtRtRtRtVt R#)ri"zHNon thread-safe context manager to change the current working directory.c Wn.VnR#rL)path_old_cwd)rr\s&&rrgchdir.__init__%s  rcVPP\P!44\P!VP 4R#rL)r]rosgetcwdrr\rs&rrchdir.__enter__)s* RYY[) rcb\P!VPP44R#rL)r`rr]rrSs&*rr#chdir.__exit__-s ""$%r)r]r\Nrr:s@rrr"sR&&r)rrrrr r r r r rrrrr)#r2r6r`rr& collectionsr functoolsrtypesrr__all__ABCr r objectr rYrarmrrrrrrrrrrr r rrrrrrks9: * SWW0#''2v. F  ??0G! G!RG( G(TBB$2"*"4<,<$ o  o $%$NQ9Q9jF( 6F(TM/^%@M/` (*E 6 & " &r