
    M/e                        d Z ddl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lm	Z	 ddlm
Z
 ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ ddlmZ  ej&                  e      Zej,                  dk7  rrej.                  gZej2                  ej4                  ej6                  ej8                  fD ]3  Z ej<                  e      ej>                  k7  s#ejA                  e       5 ng Z G d d      Z! G d de!      Z"y)zBRegisters functions to be called if an exception or signal occurs.    N)TracebackType)Any)Callable)Dict)List)Optional)Type)Union)errors)osntc                       e Zd ZdZdedef   dededdfdZdd	Zd
ee	e
      dee
   dee   defdZdedef   dededdfdZddZddZddZdededdfdZddZy)ErrorHandleraG  Context manager for running code that must be cleaned up on failure.

    The context manager allows you to register functions that will be called
    when an exception (excluding SystemExit) or signal is encountered.
    Usage::

        handler = ErrorHandler(cleanup1_func, *cleanup1_args, **cleanup1_kwargs)
        handler.register(cleanup2_func, *cleanup2_args, **cleanup2_kwargs)

        with handler:
            do_something()

    Or for one cleanup function::

        with ErrorHandler(func, args, kwargs):
            do_something()

    If an exception is raised out of do_something, the cleanup functions will
    be called in last in first out order. Then the exception is raised.
    Similarly, if a signal is encountered, the cleanup functions are called
    followed by the previously received signal handler.

    Each registered cleanup function is called exactly once. If a registered
    function raises an exception, it is logged and the next function is called.
    Signals received while the registered functions are executing are
    deferred until they finish.

    func.argskwargsreturnNc                 |    d| _         d| _        g | _        i | _        g | _        | | j
                  |g|i | y y NF)call_on_regular_exitbody_executedfuncsprev_handlersreceived_signalsregisterselfr   r   r   s       A/usr/lib/python3/dist-packages/certbot/_internal/error_handler.py__init__zErrorHandler.__init__P   sL    $)!".0
DF+-DMM$000     c                 2    d| _         | j                          y r   )r   _set_signal_handlers)r   s    r   	__enter__zErrorHandler.__enter__Y   s    "!!#r    	exec_type
exec_valuetracec           
         d| _         d}|t        u r|S || j                  sq|S |t        j                  u r#t
        j                  d| j                         d}n:t
        j                  ddj                  t        j                  |||                   | j                          | j                          | j                          |S )NTFzEncountered signals: %szEncountered exception:
%s )r   
SystemExitr   r   
SignalExitloggerdebugr   join	tracebackformat_exception_call_registered_reset_signal_handlers_call_signals)r   r$   r%   r&   retvals        r   __exit__zErrorHandler.__exit__]   s     "
"M,,&+++LL2D4I4IJFLL5rww**9j%H8J K 	##%r    c                 h    | j                   j                  t        j                  |g|i |       y)zSets func to be run with the given arguments during cleanup.

        :param function func: function to be called in case of an error

        N)r   append	functoolspartialr   s       r   r   zErrorHandler.registert   s+     	

)++DB4B6BCr    c                    t         j                  d       | j                  r=	  | j                  d           | j                  j                          | j                  r<yy# t        $ r\}t	        j
                  t        |      |      }t         j                  ddj                  |      j                                Y d}~d}~ww xY w)zCalls all registered functionszCalling registered functionsz)Encountered exception during recovery: %sr(   N)r+   r,   r   	Exceptionr.   format_exception_onlytypeerrorr-   rstrippop)r   excoutputs      r   r0   zErrorHandler._call_registered|   s    34jj7

2 
 JJNN jj  7"88cCHHWWV_3357 77s   A   	C)AC  Cc                     t         D ]I  }t        j                  |      }||| j                  |<   t        j                  || j                         K y)z-Sets signal handlers for signals in _SIGNALS.N)_SIGNALSsignal	getsignalr   _signal_handler)r   signumprev_handlers      r   r"   z!ErrorHandler._set_signal_handlers   sK     	<F!++F3L'-9""6*fd&:&:;	<r    c                     | j                   j                         D ]  \  }}t        j                  ||        | j                   j                          y)z/Resets signal handlers for signals in _SIGNALS.N)r   itemsrE   clear)r   rH   handlers      r   r1   z#ErrorHandler._reset_signal_handlers   sD    #11779 	+OFGMM&'*	+  "r    rH   unused_framec                 r    | j                   j                  |       | j                  st        j                  y)a  Replacement function for handling received signals.

        Store the received signal. If we are executing the code block in
        the body of the context manager, stop by raising signal exit.

        :param int signum: number of current signal

        N)r   r6   r   r   r*   )r   rH   rN   s      r   rG   zErrorHandler._signal_handler   s2     	$$V,!!### "r    c                     | j                   D ]@  }t        j                  d|       t        j                  t        j
                         |       B y)z"Finally call the deferred signals.zCalling signal %sN)r   r+   r,   r   killgetpid)r   rH   s     r   r2   zErrorHandler._call_signals   s:    ++ 	)FLL,f5GGBIIK(	)r    )r   N)__name__
__module____qualname____doc__r   r   r   r#   r   r	   BaseExceptionr   boolr4   r   r0   r"   r1   intrG   r2    r    r   r   r   3   s    81Xc3h/ 1 1s 1t 1$(4+>"? %m4 /48.DXc3h/ D Ds Dt D
<#$c $ $ $)r    r   c                   >     e Zd ZdZdedef   dededdf fdZ xZS )	ExitHandlerzContext manager for running code that must be cleaned up.

    Subclass of ErrorHandler, with the same usage and parameters.
    In addition to cleaning up on all signals, also cleans up on
    regular exit.
    r   .r   r   r   Nc                 :    t        |   |g|i | d| _        y )NT)superr   r   )r   r   r   r   	__class__s       r   r   zExitHandler.__init__   s"    ///$(!r    )rS   rT   rU   rV   r   r   r   __classcell__)r_   s   @r   r\   r\      s7    )Xc3h/ ) )s )t ) )r    r\   )#rV   r7   loggingrE   r.   typesr   typingr   r   r   r   r   r	   r
   certbotr   certbot.compatr   	getLoggerrS   r+   nameSIGTERMrD   SIGHUPSIGQUITSIGXCPUSIGXFSZsignal_coderF   SIG_IGNr6   r   r\   rZ   r    r   <module>ro      s    H              			8	$ 77d?Hv~~8 ) 6K(FNN:OOK()( Hu) u)p	), 	)r    