*jl " S r SSKrSSKrSSKrSSKrSSKJr SSKJr SSK J
r
J r / SQr " S S\R 5 r " S S
\R 5 r " S S \5 r " S
S\5 r " S S5 r " S S\\\5 r " S S\\\5 rS rS r " S S\5 r " S S\5 r " S S \5 r " S S \5 r " S S \5 r " S! S"\5 r " S# S$5 r " S% S&\ \5 r " S' S(\ \5 r " S) S*\\5 r! " S+ S,\5 r"g)-z4Utilities for with-statement contexts. See PEP 343. N)dequewraps)
MethodType GenericAlias)asynccontextmanagercontextmanagerclosing nullcontextAbstractContextManagerAbstractAsyncContextManagerAsyncExitStackContextDecorator ExitStackredirect_stdoutredirect_stderrsuppressaclosingchdirc f \ rS rSrSr\" \5 rSrS r \
R S 5 r \S 5 r
Srg)r z,An abstract base class for context managers. c U $ z0Return `self` upon entering the runtime context.r selfs 1/opt/alt/python313/lib64/python3.13/contextlib.py __enter__ AbstractContextManager.__enter__ s c gz9Raise any exception triggered within the runtime context.Nr r exc_type exc_value tracebacks r __exit__ AbstractContextManager.__exit__ s r c P U [ L a [ R " USS5 $ [ $ )Nr r' )r _collections_abc_check_methodsNotImplementedclsCs r __subclasshook__'AbstractContextManager.__subclasshook__" s& ( (#221k:N N r N)__name__
__module__ __qualname____firstlineno____doc__ classmethodr __class_getitem__ __slots__r abcabstractmethodr' r0 __static_attributes__r r r r r sH 6#L1I r r c f \ rS rSrSr\" \5 rSrS r \
R S 5 r \S 5 r
Srg)r
) z9An abstract base class for asynchronous context managers.r c # U $ 7fr r r s r
__aenter__&AbstractAsyncContextManager.__aenter__1 s
c # g7fr" r r# s r __aexit__%AbstractAsyncContextManager.__aexit__5 s
c P U [ L a [ R " USS5 $ [ $ )Nr@ rD )r
r* r+ r, r- s r r0 ,AbstractAsyncContextManager.__subclasshook__: s- - -#221l3>@
@ r N)r2 r3 r4 r5 r6 r7 r r8 r9 r@ r: r; rD r0 r< r r r r
r
) sH C#L1I r r
c $ \ rS rSrSrS rS rSrg)r B zJA base class or mixin that enables context managers to work as decorators.c U $ )a Return 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.
r r s r _recreate_cm ContextDecorator._recreate_cmE s r c 4 ^ ^ [ T5 UU 4S j5 nU$ )Nc j > TR 5 T" U 0 UD6sS S S 5 $ ! , ( d f g = fNrL argskwdsfuncr s r inner(ContextDecorator.__call__..innerR s( ""$T*T* %$$s $
2r r rU rV s `` r __call__ContextDecorator.__call__Q s t +
+ r r Nr2 r3 r4 r5 r6 rL rY r< r r r r r B s P
r r c $ \ rS rSrSrS rS rSrg)AsyncContextDecoratorY zPA base class or mixin that enables async context managers to work as decorators.c U $ )z-Return a recreated instance of self.
r r s r rL "AsyncContextDecorator._recreate_cm\ s r c 4 ^ ^ [ T5 UU 4S j5 nU$ )Nc ># TR 5 IS h vN T" U 0 UD6I S h vN sS S S 5 IS h vN $ N% N N ! , IS h vN ( d f g = f7frP rQ rR s r rV -AsyncContextDecorator.__call__..innerb sA ((** !4 04 00 +**0 +***sP A >A AA A A AA AA A
A
AA r rX s `` r rY AsyncContextDecorator.__call__a s t 1
1 r r Nr[ r r r r] r] Y s V
r r] c $ \ rS rSrSrS rS rSrg) _GeneratorContextManagerBasei zBShared functionality for @contextmanager and @asynccontextmanager.c U" U0 UD6U l XUsU l U l U l [ USS 5 nUc [ U 5 R nX@l g )Nr6 )genrU rS rT getattrtyper6 )r rU rS rT docs r __init__%_GeneratorContextManagerBase.__init__l sN &&*.d' 49didIt, ;t*$$C r c d U R U R U R U R 5 $ rP ) __class__rU rS rT r s r rL )_GeneratorContextManagerBase._recreate_cmz s# ~~diiDII>>r )r6 rS rU ri rT N)r2 r3 r4 r5 r6 rm rL r< r r r rf rf i s L ?r rf c $ \ rS rSrSrS rS rSrg)_GeneratorContextManager z%Helper for @contextmanager decorator.c n U ? U ?U ? [ U R 5 $ ! [
a
[
S5 S ef = fNzgenerator didn't yield)rS rT rU nextri
StopIteration RuntimeErrorr s r r "_GeneratorContextManager.__enter__ sD
Ity$) C> ! C 78d B Cs 4c R Uc" [ U R 5 [ S5 eUc U" 5 n U R R U5 [ S5 e! U R R 5 f = f! [ a gf = f! [ a
nXBLs S nA$ S nAf[ aD nXBL a X4l S nAg[ U[ 5 ( a UR UL a X2l S nAge S nAf[ a nXBLa e X4l S nAgS nAff = f! U R R 5 f = f)Ngenerator didn't stopFz#generator didn't stop after throw())
rw ri ry closerx throw
__traceback__
isinstance __cause__
BaseExceptionr typvaluer& excs r r' !_GeneratorContextManager.__exit__ s
;
%TXX%&'>?? } #
u%F
!"#HIIW HHNN$
!
!
( ''
<(1% um44
.*3'
#$-!
si A7 A B
D
A47
BB
DBD
D&
C%5*C%$C%%
D2 DD
D&r N)r2 r3 r4 r5 r6 r r' r< r r r rs rs s
0C7!r rs c $ \ rS rSrSrS rS rSrg) _AsyncGeneratorContextManager z*Helper for @asynccontextmanager decorator.c # U ? U ?U ? [ U R 5 I S h vN $ N! [
a
[
S5 S ef = f7frv )rS rT rU anextri StopAsyncIterationry r s r r@ (_AsyncGeneratorContextManager.__aenter__ sL
Ity$) C txx ( ((! C 78d B Cs% A) ') A) A Ac # Uc* [ U R 5 I S h vN [ S5 eUc U" 5 n U R R U5 I S h vN [ S5 e NJ! U R R 5 I S h vN f = f! [ a gf = f NJ! [ a
nXBLs S nA$ S nAf[ aJ nXBL a X4l S nAg[ U[ [ 45 ( a UR UL a X2l S nAge S nAf[ a nXBLa e X4l S nAgS nAff = f! U R R 5 I S h vN f = f7f)Nr| Fz$generator didn't stop after athrow()) r ri ry acloser athrowr r rx r r r s r rD '_AsyncGeneratorContextManager.__aexit__ s6 ;
,DHHo%%,&'>?? } #
hhooe,,,F
("#IJJe & ((//+++
&
-%
( ''
<(1% u}6H&IJJ
.*3'
#$-!
hhoo'''s EB A*B A,
E B& B$B& D/ *B , B
B
BE
B! E B!!E$B& &
D,0B82D,3E8
D,
D
E0D
E D
D, D'"E'D,,E/ E
EEEr N)r2 r3 r4 r5 r6 r@ rD r< r r r r r s
5C7(r r c 0 ^ [ T 5 U 4S j5 nU$ )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 $ rP )rs rS rT rU s r helper contextmanager..helper/ s 'd99r r rU r s ` r r r s 6 4[: : Mr c 0 ^ [ T 5 U 4S j5 nU$ )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 > [ TX5 $ rP )r r s r r #asynccontextmanager..helperP s ,T4>>r r r s ` r r r 5 s 6 4[? ? Mr c * \ rS rSrSrS rS rS rSrg)r
iV 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()
c Xl g rP thingr r s r rm closing.__init__g
r c U R $ rP r r s r r closing.__enter__i s zzr c 8 U R R 5 g rP )r r} r exc_infos r r' closing.__exit__k s
r r N r2 r3 r4 r5 r6 rm r r' r< r r r r
r
V s r r
c * \ rS rSrSrS rS rS rSrg)r io ar Async 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()
c Xl g rP r r s r rm aclosing.__init__ r r c " # U R $ 7frP r r s r r@ aclosing.__aenter__ s zz
c T # U R R 5 I S h vN g N7frP )r r r s r rD aclosing.__aexit__ s jj !!!s (&(r N) r2 r3 r4 r5 r6 rm r@ rD r< r r r r r o s ""r r c * \ rS rSrSrS rS rS rSrg)_RedirectStreami Nc Xl / U l g rP _new_target _old_targets)r
new_targets r rm _RedirectStream.__init__ s % r c U R R [ [ U R 5 5 [ [ U R U R 5 U R $ rP )r appendrj sys_streamsetattrr r s r r _RedirectStream.__enter__ sC dll!;<T\\4#3#34 r c j [ [ U R U R R 5 5 g rP )r r r r pop)r exctypeexcinstexctbs r r' _RedirectStream.__exit__ s! T\\4#4#4#8#8#:;r r ) r2 r3 r4 r5 r rm r r' r< r r r r r s G
T" T0 TD6 g rP r r$ r tbrS callbackrT s r
_exit_wrapper8_BaseExitStack._create_cb_wrapper.._exit_wrapper s d #d #r r r rS rT r s ``` r _create_cb_wrapper!_BaseExitStack._create_cb_wrapper s $ r c " [ 5 U l g rP )r _exit_callbacksr s r rm _BaseExitStack.__init__ s $w r c f [ U 5 " 5 nU R Ul [ 5 U l U$ )z@Preserve the context stack by transferring it to a new instance.)rk r r )r new_stacks r pop_all_BaseExitStack.pop_all s+ JL $($8$8 ! $w r c [ U5 n UR nU R X5 U$ ! [ a U R U5 U$ f = f)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).
)rk r'
_push_cm_exitAttributeError_push_exit_callbackr exit_cb_type exit_methods r push_BaseExitStack.push sX : 2"++K
t 1 + $ $T * +s , A
A c [ U5 n UR nUR nU" U5 nU R X5 U$ ! [ a( [ SUR
SUR S35 Sef = f)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)rk r r' r TypeErrorr3 r4 r r r r. _enter_exitresults r
enter_context _BaseExitStack.enter_context s 2h S]]FLLE 2%
Sa /q1A1A0B CG H INR
S Ss A 2A2c ` U R " U/UQ70 UD6nXl U R U5 U$ )zLRegisters an arbitrary callback and arguments.
Cannot suppress exceptions.
)r __wrapped__r r r rS rT r s r r _BaseExitStack.callback s9
//H4H4H
%-! /r c J U R X5 nU R US5 g)z;Helper to correctly register callbacks to __exit__ methods.TN)r r r r r r s r r _BaseExitStack._push_cm_exit# s" 11">
5r c < U R R X!45 g rP )r r )r r is_syncs r r "_BaseExitStack._push_exit_callback( s ##W$78r )r N)T)r2 r3 r4 r5 r6 staticmethodr r rm r r r r r r r< r r r r r sN 8' '
'(& 6
9r r c * \ rS rSrSrS rS rS rSrg)r i- ao Context 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 U $ rP r r s r r ExitStack.__enter__8 s r c ^ US nUS Ln[ R " 5 m U 4S jnSnSnU R ( a] U R R 5 u px Uc SnO[ U5 X"R
4nU" U6 ( a SnSnS nU R ( a M] U( a UR n
UeU=( a U$ ! [ a n U" X5 SnU n S n A NOS n A ff = f! [ a W
Ul e f = f)N c P > U R nUb X!L a g UTL a OUn M Xl g rP __context__new_excold_exc exc_context frame_excs r _fix_exception_context2ExitStack.__exit__.._fix_exception_contextB < % 1 1 &+*@ )+% #* r FNNNTr exceptionr r rk r r r ) r exc_detailsr received_excr" suppressed_exc
pending_raiser cbr fixed_ctxr! s @r r' ExitStack.__exit__; s !n$ MMO *
"" ..224KG
;"2K"&s)S2C2C"CK{#%)N$)M C """$
OO .. !
&w4 $
!
"+
s$ -B9 C 9
C CC C/c * U R SSS5 gz%Immediately unwind the context stack.N)r' r s r r} ExitStack.closeq s
dD$'r r N) r2 r3 r4 r5 r6 r r' r} r< r r r r r - s 4/l(r r c b \ rS rSrSr\S 5 r\S 5 rS rS r S r
S r S r S
r
S rS rg
)r iw a Async 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 [ X5 $ rP r r s r _create_async_exit_wrapper)AsyncExitStack._create_async_exit_wrapper r r c ^ ^^ UU U4S jnU$ )Nc 2 ># T" T0 TD6I S h vN g N7frP r r s r r >AsyncExitStack._create_async_cb_wrapper.._exit_wrapper s D)D) ) )s r r s ``` r _create_async_cb_wrapper'AsyncExitStack._create_async_cb_wrapper s * r c # [ U5 n UR nUR nU" U5 I Sh vN nU R X5 U$ ! [ a( [ SUR
SUR S35 Sef = f NL7f)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 r zC' object does not support the asynchronous context manager protocolN)rk r@ rD r r r3 r4 _push_async_cm_exitr s r enter_async_context"AsyncExitStack.enter_async_context s 2h '^^FMME
bz! +
'a /q1A1A0B CT U "&
' ' "s% BA
BA?B
2A<<Bc [ U5 n UR nU R X5 U$ ! [ a U R US5 U$ f = f)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)rk rD r< r r r s r push_async_exit AsyncExitStack.push_async_exit sZ : 8",,K
$ $T 7 2 $ $T5 1 2s , A A c b U R " U/UQ70 UD6nXl U R US5 U$ )zVRegisters an arbitrary coroutine function and arguments.
Cannot suppress exceptions.
F)r9 r r r s r push_async_callback"AsyncExitStack.push_async_callback s;
55hNNN
%-! 6r c F # U R SSS5 I Sh vN g N7fr0 )rD r s r r AsyncExitStack.aclose s nnT4...s ! !c J U R X5 nU R US5 g)zDHelper to correctly register coroutine function to __aexit__
method.FN)r4 r r s r r< "AsyncExitStack._push_async_cm_exit s$ 77D
6r c # U $ 7frP r r s r r@ AsyncExitStack.__aenter__ s
rB c ^ # US nUS Ln[ R " 5 m U 4S jnSnSnU R ( at U R R 5 u px Uc SnO[ U5 X"R
4nU( a U" U6 n O
U" U6 I S h vN n U ( a SnSnS nU R ( a Mt U( a UR n UeU=( a U$ NE! [ a n
U" X5 SnU
n S n
A
NQS n
A
ff = f! [ a W Ul e f = f7f)Nr c P > U R nUb X!L a g UTL a OUn M Xl g rP r r s r r" 8AsyncExitStack.__aexit__.._fix_exception_context r$ r Fr% Tr& )
r r( r r) r" r* r+ r r, cb_suppressr r- r! s
@r rD AsyncExitStack.__aexit__ s !n$ MMO *
"" ..224KG
;"2K"&s)S2C2C"CK"$k"2K(*K(8"8K %)N$)M C """,
OO ..+ #9 !
&w4 $
!
"+
s` AD
2C C
C D
1D
9C7 D
C
C4 C/*D
/C44D
7D
D
r N)r2 r3 r4 r5 r6 r r4 r9 r= r@ rC r r< r@ rD r< r r r r r w sR
' '
$$ /7 8/r r c : \ rS rSrSrS
S jrS rS rS rS r S r
g) r i a7 Context 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
Nc Xl g rP enter_result)r rS s r rm nullcontext.__init__ s (r c U R $ rP rR r s r r nullcontext.__enter__ s r c g rP r r excinfos r r' nullcontext.__exit__ r r c " # U R $ 7frP rR r s r r@ nullcontext.__aenter__ s r c # g 7frP r rX s r rD nullcontext.__aexit__ s rF rR rP ) r2 r3 r4 r5 r6 rm r r' r@ rD r< r r r r r s )!
!
r r c * \ rS rSrSrS rS rS rSrg)r i" zHNon thread-safe context manager to change the current working directory.c Xl / U l g rP )path_old_cwd)r ra s r rm chdir.__init__% s
r c U R R [ R " 5 5 [ R " U R
5 g rP )rb r osgetcwdr ra r s r r chdir.__enter__) s*
RYY[)
r c ` [ R " U R R 5 5 g rP )re r rb r rX s r r' chdir.__exit__- s
""$%r )rb ra Nr r r r r r " s R &r r )#r6 r: re r r* collectionsr functoolsr typesr r __all__ABCr r
objectr r] rf rs r r r r
r r r r r r r r r r r r r rp s9 :
* SWW 0 #'' 2v .
F
? ?0G! G!RG( G(T B B$ 2"* "4<, <$
o
o $% $NQ9 Q9jF( 6 F(TM/^%@ M/`
(*E
6 & " &r