+ ilcs$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_stderrsuppressaclosingchdircsra]tRt^toRt]!]4tRtRt ] PR4t ]R4t RtVtR#)rz,An abstract base class for context managers.c V#z0Return `self` upon entering the runtime context.self&#/usr/lib64/python3.14/contextlib.py __enter__Z AbstractContextManager.__enter__s c sR#z9Raise any exception triggered within the runtime context.Nrrexc_typeZ exc_value traceback&&&&r__exit__ZAbstractContextManager.__exit__srcRV\Jd\P!VRR4#\#)rr)r_collections_abc_check_methodsNotImplementedclsZC&&r__subclasshook__Z'AbstractContextManager.__subclasshook__"s& ( (#221k:N NrrN)__name__ __module__ __qualname____firstlineno____doc__ classmethodr__class_getitem__ __slots__rabcabstractmethodrr'__static_attributes____classdictcell__Z __classdict__@rrrsK6#L1I rcsra]tRt^)toRt]!]4tRtRt ] PR4t ]R4t RtVtR#)rz9An abstract base class for asynchronous context managers.c "V#5irrrrr __aenter__Z&AbstractAsyncContextManager.__aenter__1s  c s"R#5irrrrr __aexit__Z%AbstractAsyncContextManager.__aexit__5s r8cr )r7r9)rr!r"r#r$r&rr'Z,AbstractAsyncContextManager.__subclasshook__:s- - -#221l3>@ @rrN)r(r)r*r+r,r-rr.r/r7r0r1r9r'r2r3r4r5rrr)sKC#L1I rcs0a]tRt^BtoRtRtRtRtVtR#)r zJA base class or mixin that enables context managers to work as decorators.c r)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. rrrr _recreate_cmZContextDecorator._recreate_cmEs  rc4aa\S4VV3Rl4pV#)cs<SP4;_uu_4S!V/VBuuRRR4# +'giR#;iNr:argskwdsfuncr*,rinnerZ(ContextDecorator.__call__..innerRs.""$$T*T*%$$$s- > rrrArCff r__call__ZContextDecorator.__call__Qs t +  + rrN r(r)r*r+r,r:rFr2r3r4r5rr r BsP rcs0a]tRt^YtoRtRtRtRtVtR#)AsyncContextDecoratorzPA base class or mixin that enables async context managers to work as decorators.c r)z-Return a recreated instance of self. rrrrr:Z"AsyncContextDecorator._recreate_cm\s  rcr;)cs<"SP4;_uu_4GRjxL S!V/VBGRjxL uuRRR4GRjxL #L&LL +GRjxL 'giR#;i5ir<r=r>rBrrCZ-AsyncContextDecorator.__call__..innerbsD((***!40400+**0+***sYA*AA* A A A  A*A A* A  A* A' A A' A' ! A*rrDrErrFZAsyncContextDecorator.__call__as t 1  1 rrNrGr4r5rrHrHYsV rrHcs0a]tRt^itoRtRtRtRtVtR#)_GeneratorContextManagerBasezBShared functionality for @contextmanager and @asynccontextmanager.csV!V/VBVnWVuVnVnVn\ VRR4pVf\ V4P pW@nR#)r,N)genrAr?r@getattrtyper,)rrAr?r@Zdoc&&&& r__init__Z%_GeneratorContextManagerBase.__init__lsN&&*.d' 49didIt, ;t*$$C rcsdVPVPVPVP4#r<)Z __class__rAr?r@rrrr:Z)_GeneratorContextManagerBase._recreate_cmzs#~~diiDII>>r)r,r?rArJr@N) r(r)r*r+r,rNr:r2r3r4r5rrIrIisL??rrIcs0a]tRt^toRtRtRtRtVtR#)_GeneratorContextManagerz%Helper for @contextmanager decorator.cspV=V=V=\VP4# \ d\ R4Rhi;i)generator didn't yieldN)r?r@rAnextrJ StopIteration RuntimeErrorrrrrZ"_GeneratorContextManager.__enter__sD Ity$) C> ! C78d B Cs5csnVf#\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()) rQrJrScloserRZthrow __traceback__ isinstance __cause__ BaseExceptionrZtypZvaluerexcrMrrZ!_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)r*r+r,rrr2r3r4r5rrOrOs 0C7!7!rrOcs0a]tRt^toRtRtRtRtVtR#)_AsyncGeneratorContextManagerz*Helper for @asynccontextmanager decorator.cs"V=V=V=\VP4GRjxL #L \ d\ R4Rhi;i5i)NrP)r?r@rAanextrJStopAsyncIterationrSrrrr7Z(_AsyncGeneratorContextManager.__aenter__sL Ity$) Ctxx( ((! C78d B Cs%A)')A)AAcs"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)NrTFz$generator didn't stop after athrow()) r]rJrSacloser^ZathrowrVrWrRrXrYrZrMrr9Z'_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)r*r+r,r7r9r2r3r4r5rr\r\s 5C7(7(rr\c0a\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#r<)rOr?r@rA*,rhelperZcontextmanager..helper/s'd99rrrArdf rcontextmanagerrgs 6 4[:: Mrcr`)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: crar<)r\rbrcrrdZ#asynccontextmanager..helperPs,T4>>rrrerfrasynccontextmanagerrh5s 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#r<thingrrlr&rrNZclosing.__init__g rcVP#r<rkrrrrZclosing.__enter__is zzrcs:VPP4R#r<)rlrUrZexc_info&*rrZclosing.__exit__ks rrkN r(r)r*r+r,rNrrr2r3r4r5rrrVs rcri)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() crjr<rkrmr&rrNZaclosing.__init__rnrc""VP#5ir<rkrrrr7Zaclosing.__aenter__szz csV"VPP4GRjxL R#L5ir<)rlr_rprqrr9Zaclosing.__aexit__sjj!!!s )')rkN) r(r)r*r+r,rNr7r9r2r3r4r5rrros"""rcs6a]tRtRtoRtRtRtRtRtVt R#)_RedirectStreamiNc Wn.VnR#r< _new_target _old_targets)rZ new_targetr&rrNZ_RedirectStream.__init__s%rcsVPP\\VP44\ \VPVP 4VP #r<)ryappendrKsys_streamsetattrrxrrrrZ_RedirectStream.__enter__sC   dll!;<T\\4#3#34rcsl\\VPVPP 44R#r<)r}r{r|rypop)rexctypeexcinstexctbrrrZ_RedirectStream.__exit__s!T\\4#4#4#8#8#:;rrw) r(r)r*r+r|rNrrr2r3r4r5rrurusG  <._exit_wrappers d #d #rrrr?r@rbjl r_create_cb_wrapperZ!_BaseExitStack._create_cb_wrappers $rcs$\4VnR#r<)r_exit_callbacksrrrrNZ_BaseExitStack.__init__s $wrc sf\V4!4pVPVn\4VnV#)z@Preserve the context stack by transferring it to a new instance.)rLrr)rZ new_stacks& rpop_allZ_BaseExitStack.pop_alls+JL $($8$8 !$wrc s\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). )rLr _push_cm_exitAttributeError_push_exit_callbackrZexitZ_cb_typeZ exit_method&& rpushZ_BaseExitStack.pushsX: 2"++K   t 1  +  $ $T *  +s ,A  A c s\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)rLrrr TypeErrorr)r*rrrr%Z_enterZ_exitZresult&& r enter_contextZ_BaseExitStack.enter_contexts2h S]]FLLE 2%  Sa/q1A1A0BCGHINR S Ss A3A3c s`VP!V.VO5/VBpWnVPV4V#)zLRegisters an arbitrary callback and arguments. Cannot suppress exceptions. )r __wrapped__rrrr?r@r""*, rrZ_BaseExitStack.callbacks9 //H4H4H %-!   /rc LVPW4pVPVR4R#)z;Helper to correctly register callbacks to __exit__ methods.TN)rrrrrr&&& rrZ_BaseExitStack._push_cm_exit#s"11">    5rcs>VPPW!34R#r<)rrz)rris_syncs&&&rrZ"_BaseExitStack._push_exit_callback(s ##W$78r)rN)T)r(r)r*r+r, staticmethodrrrNrrrrrrr2r3r4r5rrrsV8'' '(& 6 99rrcri)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. crr<rrrrrZExitStack.__enter__8s rcsa V^,pVRJp\P!4o V 3RlpRpRpVP'dRVPP4wrxVfRpM\ V4W"P 3pV!V!'d RpRpRpKaKcV'dVPp VhT;'dT# \ dp T!Y4RpT pRp ? KRp ? ii;i \ d X Tnhi;i)NcZ<VPpVeW!JdR#VSJdMTpK#WnR#rN __context__new_excZold_excZ exc_context frame_exc&& r_fix_exception_contextZ2ExitStack.__exit__.._fix_exception_contextB7%11 &+*@)+%#* rFTNNNr{Z exceptionrr~rLrVrYr) r exc_detailsr[ received_excrsuppressed_exc pending_raisercbr fixed_ctxrs &* @rrZExitStack.__exit__;s!n$ MMO  *  """..224KG ;"2K"&s)S2C2C"CK{##%)N$)MC$   OO  ...! &w4 $   ! "+ s*)B4B4C4 C? CCC-c s,VPRRR4R#z%Immediately unwind the context stack.N)rrrrrUZExitStack.closeqs dD$'rrN) r(r)r*r+r,rrrUr2r3r4r5rr r -s4/l((rcsna]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. crr<rrr&r_create_async_exit_wrapperZ)AsyncExitStack._create_async_exit_wrapperrrcr)cs4<"S!S/SBGRjxL R#L5ir<rrrrrZ>AsyncExitStack._create_async_cb_wrapper.._exit_wrappersD)D) ) )s rrrr_create_async_cb_wrapperZ'AsyncExitStack._create_async_cb_wrappers *rc s"\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)rLr7r9rrr)r*_push_async_cm_exitrrrenter_async_contextZ"AsyncExitStack.enter_async_contexts 2h '^^FMME bz!   +  'a/q1A1A0BCTU"& ' '"s% BA BBB 3A==Bc s\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)rLr9rrrrrrpush_async_exitZAsyncExitStack.push_async_exitsZ: 8",,K  $ $T 7  2  $ $T5 1  2s ,A  A c sbVP!V.VO5/VBpWnVPVR4V#)zVRegisters an arbitrary coroutine function and arguments. Cannot suppress exceptions. F)rrrrrrpush_async_callbackZ"AsyncExitStack.push_async_callbacks; 55hNNN %-!   6rc sH"VPRRR4GRjxL R#L5ir)r9rrrr_ZAsyncExitStack.aclosesnnT4...s " "c r)zDHelper to correctly register coroutine function to __aexit__ method.FN)rrrrrrZ"AsyncExitStack._push_async_cm_exits$77D    6rcr6r<rrrrr7ZAsyncExitStack.__aenter__s  r8csa "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)rNcrrrrrrrZ8AsyncExitStack.__aexit__.._fix_exception_contextrrFTrr) rrr[rrrrrrZ cb_suppressrrrs &* @rr9ZAsyncExitStack.__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)r*r+r,rrrrrrr_rr7r9r2r3r4r5rr r wsZ '' $$ /7 8/8/rcsFa]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 Ncrjr< enter_result)rrr&rrNZnullcontext.__init__s(rcror<rrrrrZnullcontext.__enter__s   rcrr<rrZexcinforqrrZnullcontext.__exit__rrcrsr<rrrrr7Znullcontext.__aenter__s   rtcs"R#5ir<rrrqrr9Znullcontext.__aexit__s r8rr<) r(r)r*r+r,rNrrr7r9r2r3r4r5rrrs()! !  rcri)ri"zHNon thread-safe context manager to change the current working directory.crvr<)path_old_cwd)rrr&rrNZchdir.__init__%s  rcsVPP\P!44\P!VP 4R#r<)rrzosZgetcwdrrrrrrZchdir.__enter__)s* RYY[) rcsb\P!VPP44R#r<)rrrr~rrqrrZchdir.__exit__-s ""$%r)rrNrrr4r5rrr"sR&&r)rhrgrrrrr r r r r rrr)#r,r0rr{r!Z collectionsrZ functoolsrZtypesrrZ__all__ZABCrrZobjectr rHrIrOr\rgrhrrrur r rrr r rrrrrrs9: * SWW0#''2v. F  ??0G! G!RG( G(TBB$2"*"4<,<$ o  o $%$NQ9Q9jF( 6F(TM/^%@M/` (*E 6 & " &r