JezK
Edit File: contextlib2.pyc
� Z��ic @ s> d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d d d d d d d d g Z e d g 7Z e j d d+ k r� e j Z n e j d e f i d, d 6� Z d � Z d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ e j d! d k Z e r�d" � Z d# � Z n d$ � Z d% � Z y d d& l m Z Wn e k r�e Z n Xd' � Z d e f d( � � YZ! d e! f d) � � YZ" d e f d* � � YZ# d S(- sA contextlib2 - backports and enhancements to the contextlib modulei����N( t deque( t wrapst contextmanagert closingt nullcontextt AbstractContextManagert ContextDecoratort ExitStackt redirect_stdoutt redirect_stderrt suppresst ContextStacki i i t ABCt __slots__c C sB | | k r d S| j | � x | j D] } t | | � q' W| S( N( t appendt __bases__t _classic_mro( t Ct resultt B( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s c G s� y | j } Wn& t k r5 t t | g � � } n XxM | D]E } x< | D]0 } | | j k rJ | j | d k rv t SPqJ qJ Wt Sq= Wt S( N( t __mro__t AttributeErrort tupleR t __dict__t Nonet NotImplementedt True( R t methodst mrot methodR ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _check_methods$ s c B s8 e Z d Z d � Z e j d � � Z e d � � Z RS( s, An abstract base class for context managers.c C s | S( s0 Return `self` upon entering the runtime context.( ( t self( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt __enter__8 s c C s d S( s9 Raise any exception triggered within the runtime context.N( R ( R t exc_typet exc_valuet traceback( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt __exit__< s c C s | t k r t | d d � St S( s< Check whether subclass is considered a subclass of this ABC.R R$ ( R R R ( t clsR ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt __subclasshook__A s ( t __name__t __module__t __doc__R t abct abstractmethodR$ t classmethodR& ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR 5 s c B s) e Z d Z d � Z d � Z d � Z RS( sJ A base class or mixin that enables context managers to work as decorators.c C s t j d t � | j � S( s� Returns the context manager used to actually wrap the call to the decorated function. The default implementation just returns *self*. Overriding this method allows otherwise one-shot context managers like _GeneratorContextManager to support use as decorators via implicit recreation. DEPRECATED: refresh_cm was never added to the standard library's ContextDecorator API s2 refresh_cm was never added to the standard library( t warningst warnt DeprecationWarningt _recreate_cm( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt refresh_cmL s c C s | S( s6 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 ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR0 ] s c s" t � � � � f d � � } | S( Nc s$ � j � � � | | � SWd QXd S( N( R0 ( t argst kwds( t funcR ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt innerj s ( R ( R R4 R5 ( ( R4 R s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt __call__i s ( R' R( R) R1 R0 R6 ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR I s t _GeneratorContextManagerc B s2 e Z d Z d � Z d � Z d � Z d � Z RS( s% Helper for @contextmanager decorator.c C sl | | | � | _ | | | | _ | _ | _ t | d d � } | d k r_ t | � j } n | | _ d S( NR) ( t genR4 R2 R3 t getattrR t typeR) ( R R4 R2 R3 t doc( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt __init__t s c C s | j | j | j | j � S( N( t __class__R4 R2 R3 ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR0 � s c C s5 y t | j � SWn t k r0 t d � � n Xd S( Ns generator didn't yield( t nextR8 t StopIterationt RuntimeError( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c C s | d k rA y t | j � Wn t k r1 d SXt d � � n� | d k rY | � } n y& | j j | | | � t d � � Wnz t k r� } | | k St k r� } | | k r� t St r� | j | k r� t S� n# t j � d | k r� � q� n Xd S( Ns generator didn't stops# generator didn't stop after throw()i ( R R> R8 R? R@ t throwt Falset _HAVE_EXCEPTION_CHAININGt __cause__t syst exc_info( R R: t valueR# t exc( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ � s, ( R' R( R) R< R0 R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR7 q s c s t � � � f d � � } | S( s� @contextmanager decorator. Typical usage: @contextmanager def some_generator(<arguments>): <setup> try: yield <value> finally: <cleanup> This makes this: with some_generator(<arguments>) as <variable>: <body> equivalent to this: <setup> try: <variable> = <value> <body> finally: <cleanup> c s t � | | � S( N( R7 ( R2 R3 ( R4 ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt helper� s ( R ( R4 RI ( ( R4 s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c B s) e Z d Z d � Z d � Z d � Z RS( s2 Context to automatically close something at the end of a block. Code like this: with closing(<module>.open(<arguments>)) as f: <block> is equivalent to this: f = <module>.open(<arguments>) try: <block> finally: f.close() c C s | | _ d S( N( t thing( R RJ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< � s c C s | j S( N( RJ ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c G s | j j � d S( N( RJ t close( R RF ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ � s ( R' R( R) R< R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s t _RedirectStreamc B s) e Z d Z d � Z d � Z d � Z RS( c C s | | _ g | _ d S( N( t _new_targett _old_targets( R t new_target( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< � s c C s9 | j j t t | j � � t t | j | j � | j S( N( RN R R9 RE t _streamt setattrRM ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c C s t t | j | j j � � d S( N( RQ RE RP RN t pop( R t exctypet excinstt exctb( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ s N( R' R( R RP R< R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRL � s c B s e Z d Z d Z RS( sA Context 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) t stdout( R' R( R) RP ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s c B s e Z d Z d Z RS( sC Context manager for temporarily redirecting stderr to another file.t stderr( R' R( R) RP ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s c B s) e Z d Z d � Z d � Z d � Z RS( s? 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 c G s | | _ d S( N( t _exceptions( R t exceptions( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< ) s c C s d S( N( ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR , s c C s | d k o t | | j � S( N( R t issubclassRX ( R RS RT RU ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ / s ( R' R( R) R< R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s i c s � f d � } | S( Nc sO x? | j } | | k r d S| d k s4 | � k r8 Pn | } q W| | _ d S( N( t __context__R ( t new_exct old_exct exc_context( t frame_exc( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _fix_exception_context@ s ( ( R_ R` ( ( R_ s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _make_context_fixer? s c C sC y | d j } | d � Wn! t k r> | | d _ � n Xd S( Ni ( R[ t BaseException( t exc_detailst fixed_ctx( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _reraise_with_existing_contextO s c C s d � S( Nc S s d S( N( R ( R\ R] ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt <lambda>[ t ( ( R_ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRa Z s c B s | \ } } } d d Ud S( Ns! raise exc_type, exc_value, exc_tb( ( Rc R! R" t exc_tb( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRe _ s ( t InstanceTypec C s# t | � } | t k r | j S| S( N( R: Ri R= ( t objt obj_type( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _get_typek s c B s_ e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s� 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 C s t � | _ d S( N( R t _exit_callbacks( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< s c C s+ t | � � } | j | _ t � | _ | S( s? Preserve the context stack by transferring it to a new instance( R: Rm R ( R t new_stack( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt pop_all� s c s, � � f d � } � | _ | j | � d S( s: Helper to correctly register callbacks to __exit__ methodsc s � � | � S( N( ( Rc ( t cmt cm_exit( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _exit_wrapper� s N( t __self__t push( R Rp Rq Rr ( ( Rp Rq s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt _push_cm_exit� s c C sQ t | � } y | j } Wn! t k r< | j j | � n X| j | | � | S( s Registers 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) ( Rl R$ R Rm R Ru ( R t exitt _cb_typet exit_method( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRt � s c s/ � � � f d � } � | _ | j | � � S( s\ Registers an arbitrary callback and arguments. Cannot suppress exceptions. c s � � � � d S( N( ( R! RH t tb( R2 t callbackR3 ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRr � s ( t __wrapped__Rt ( R Rz R2 R3 Rr ( ( R2 Rz R3 s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRz � s c C s8 t | � } | j } | j | � } | j | | � | S( s� Enters the supplied context manager If successful, also pushes its __exit__ method as a callback and returns the result of the __enter__ method. ( Rl R$ R Ru ( R Rp t _cm_typet _exitR ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt enter_context� s c C s | j d d d � d S( s$ Immediately unwind the context stackN( R$ R ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyRK � s c C s | S( N( ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c G s� | d d k } t j � d } t | � } t } t } xx | j r� | j j � } y% | | � rw t } t } d } n Wq; t j � } | | d | d � t } | } q; Xq; W| r� t | � n | o� | S( Ni i ( NNN( R RE RF Ra RB Rm RR R Re ( R Rc t received_excR_ R` t suppressed_exct pending_raiset cbt new_exc_details( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ � s( ( R' R( R) R< Ro Ru Rt Rz R~ RK R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s s c B s2 e Z d Z d � Z d � Z d � Z d � Z RS( s+ Backwards compatibility alias for ExitStackc C s' t j d t � t t | � j � d S( Ns* ContextStack has been renamed to ExitStack( R- R. R/ t superR R< ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< � s c C s | j | � S( N( Rt ( R Rz ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt register_exit� s c O s | j | | | � S( N( Rz ( R Rz R2 R3 ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt register� s c C s | j � S( N( Ro ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt preserve� s ( R' R( R) R< R� R� R� ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s c B s, e Z d Z d d � Z d � Z d � Z RS( sM 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 c C s | | _ d S( N( t enter_result( R R� ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR< � s c C s | j S( N( R� ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR s c G s d S( N( ( R t excinfo( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR$ s N( R' R( R) R R< R R$ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyR � s ( i i ( ($ R) R* RE R- t collectionsR t functoolsR t __all__t version_infoR t _abc_ABCt ABCMetat objectR R R R R7 R R RL R R R RC Ra Re t typesRi t ImportErrorR: Rl R R R ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/contextlib2.pyt <module> sL (H " q