o hB@sdZddlZddlZddlZddlmZddlmZgdZedg7Zej dddkr0ej Z n e d e fd d iZ d d ZddZGddde ZGddde ZGdddeZddZGddde ZGddde ZGdddeZGdddeZGd d!d!e Zej dd"kZerd#d$Zd%d&Znd'd$Zd(d&Zzdd)lmZWn eyeZ Ynwd*d+Z Gd,d-d-e Z!Gd.dde!Z"Gd/d0d0eZ#dS)1zAcontextlib2 - backports and enhancements to the contextlib moduleN)dequewraps) contextmanagerclosing nullcontextAbstractContextManagerContextDecorator ExitStackredirect_stdoutredirect_stderrsuppress ContextStack)ABC __slots__cCs0||vrdS|||jD]}t||q|SN)append __bases__ _classic_mro)CresultBrr=/var/www/html/env/lib/python3.10/site-packages/contextlib2.pyrs    rcGstz|j}Wntytt|g}Ynw|D]}|D]}||jvr2|j|dur0tSnqtSqdS)NT)__mro__AttributeErrortupler__dict__NotImplemented)rmethodsmromethodrrrr_check_methods$s    r%c@s2eZdZdZddZejddZeddZ dS) rz,An abstract base class for context managers.cC|S)z0Return `self` upon entering the runtime context.rselfrrr __enter__8sz AbstractContextManager.__enter__cCsdS)z9Raise any exception triggered within the runtime context.Nr)r(exc_type exc_value tracebackrrr__exit__<szAbstractContextManager.__exit__cCs|tur t|ddStS)z.innerr)r(rArBrr@r__call__iszContextDecorator.__call__N)r0r1r2r3r<r;rCrrrrr Is  r c@s0eZdZdZddZddZddZdd Zd S) _GeneratorContextManagerz%Helper for @contextmanager decorator.cCsN||i||_||||_|_|_t|dd}|dur"t|j}||_dS)Nr3)genrAr>r?getattrtyper3)r(rAr>r?docrrr__init__ts    z!_GeneratorContextManager.__init__cCs||j|j|jSr) __class__rAr>r?r'rrrr;sz%_GeneratorContextManager._recreate_cmcCs$zt|jWStytdw)Nzgenerator didn't yield)nextrE StopIteration RuntimeErrorr'rrrr)s   z"_GeneratorContextManager.__enter__c Cs|durz t|jWtdtyYdSw|dur |}z |j|||tdtyB}z ||uWYd}~Sd}~wtyg}z||urTWYd}~dStrb|j|urbWYd}~dSd}~wtd|ursYdS)Nzgenerator didn't stopz#generator didn't stop after throw()F) rKrErLrMthrow_HAVE_EXCEPTION_CHAINING __cause__sysexc_info)r(rGvaluer,excrrrr-s4  z!_GeneratorContextManager.__exit__N)r0r1r2r3rIr;r)r-rrrrrDqs  rDcstfdd}|S)a@contextmanager decorator. Typical usage: @contextmanager def some_generator(): try: yield finally: This makes this: with some_generator() as : equivalent to this: try: = finally: cs t||Sr)rDr=rArrhelpers zcontextmanager..helperr)rArWrrVrrsrc@r7) ra2Context 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() cC ||_dSrthing)r(rZrrrrI zclosing.__init__cC|jSrrYr'rrrr)zclosing.__enter__cGs|jdSr)rZclose)r(rSrrrr-szclosing.__exit__Nr0r1r2r3rIr)r-rrrrrs  rc@s(eZdZdZddZddZddZdS)_RedirectStreamNcCs||_g|_dSr) _new_target _old_targets)r( new_targetrrrrIs z_RedirectStream.__init__cCs*|jtt|jtt|j|j|jSr)rbrrFrR_streamsetattrrar'rrrr)sz_RedirectStream.__enter__cCstt|j|jdSr)rerRrdrbpopr(exctypeexcinstexctbrrrr-z_RedirectStream.__exit__)r0r1r2rdrIr)r-rrrrr`s  r`c@eZdZdZdZdS)r aAContext manager for temporarily redirecting stdout to another file. # How to send help() to stderr with redirect_stdout(sys.stderr): help(dir) # How to write help() to a file with open('help.txt', 'w') as f: with redirect_stdout(f): help(pow) stdoutNr0r1r2r3rdrrrrr s r c@rl)r zCContext manager for temporarily redirecting stderr to another file.stderrNrnrrrrr sr c@r7) r a?Context manager to suppress specified exceptions After the exception is suppressed, execution proceeds with the next statement following the with statement. with suppress(FileNotFoundError): os.remove(somefile) # Execution still resumes here if the file was already removed cGrXr) _exceptions)r( exceptionsrrrrI)r[zsuppress.__init__cCdSrrr'rrrr),zsuppress.__enter__cCs|duo t||jSr) issubclassrprgrrrr-/s zsuppress.__exit__Nr_rrrrr s   r rcsfdd}|S)Ncs6 |j}||ur dS|dus|urn|}q||_dSr) __context__)new_excold_exc exc_context frame_excrr_fix_exception_context@s z3_make_context_fixer.._fix_exception_contextr)rzr{rryr_make_context_fixer?s  r|cCs.z |dj}|dty||d_w)NrN)ru BaseException) exc_details fixed_ctxrrr_reraise_with_existing_contextOs   rcCsddS)NcSrrrr)rvrwrrr[sz%_make_context_fixer..rryrrrr|ZcCs|\}}}tddS)Nz!raise exc_type, exc_value, exc_tb)exec)r~r*r+exc_tbrrrr_s  ) InstanceTypecCst|}|tur |jS|Sr)rGrrJ)objobj_typerrr _get_typeksrc@sXeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ dS)r aContext 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 cCs t|_dSr)r_exit_callbacksr'rrrrIs zExitStack.__init__cCst|}|j|_t|_|S)z?Preserve the context stack by transferring it to a new instance)rGrr)r( new_stackrrrpop_alls zExitStack.pop_allcs"fdd}|_||dS)z:Helper to correctly register callbacks to __exit__ methodscsg|RSrr)r~cmcm_exitrr _exit_wrappersz.ExitStack._push_cm_exit.._exit_wrapperN)__self__push)r(rrrrrr _push_cm_exitszExitStack._push_cm_exitcCsDt|}z|j}Wnty|j|Y|Sw||||S)aRegisters 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) )rr-rrrr)r(exit_cb_type exit_methodrrrrs    zExitStack.pushcs$fdd}|_||S)z\Registers an arbitrary callback and arguments. Cannot suppress exceptions. csidSrr)r*rUtbr>callbackr?rrrsz)ExitStack.callback.._exit_wrapper) __wrapped__r)r(rr>r?rrrrrs zExitStack.callbackcCs(t|}|j}||}||||S)zEnters the supplied context manager If successful, also pushes its __exit__ method as a callback and returns the result of the __enter__ method. )rr-r)r)r(r_cm_type_exitrrrr enter_contexts   zExitStack.enter_contextcCs|ddddS)z$Immediately unwind the context stackN)r-r'rrrr^szExitStack.closecCr&rrr'rrrr)rszExitStack.__enter__c Gs|ddu}td}t|}d}d}|jrA|j}z ||r'd}d}d}Wnt}||d|dd}|}Y|js|rGt||oJ|S)NrrNFT)NNN)rRrSr|rrfr) r(r~ received_excrzr{suppressed_exc pending_raisecbnew_exc_detailsrrrr-s,    zExitStack.__exit__N) r0r1r2r3rIrrrrrr^r)r-rrrrr ss    r cs8eZdZdZfddZddZddZdd ZZS) rz+Backwards compatibility alias for ExitStackcstdttt|dS)Nz*ContextStack has been renamed to ExitStack)r8r9r:superrrIr'rJrrrIszContextStack.__init__cCs ||Sr)r)r(rrrr register_exitr[zContextStack.register_exitcOs|j|g|Ri|Sr)r)r(rr>r?rrrregisterrkzContextStack.registercCs|Sr)rr'rrrpreserverzContextStack.preserve) r0r1r2r3rIrrr __classcell__rrrrrs  c@s*eZdZdZd ddZddZddZdS) raMContext 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 NcCrXr enter_result)r(rrrrrIr[znullcontext.__init__cCr\rrr'rrrr)r]znullcontext.__enter__cGrrrr)r(excinforrrr-rsznullcontext.__exit__rr_rrrrrs   r)$r3r4rRr8 collectionsr functoolsr__all__ version_infor_abc_ABCABCMetaobjectrr%rr rDrrr`r r r rPr|rtypesr ImportErrorrGrr rrrrrrsJ    (H"   q