a oe@sdZddlZddlZddlZddlZddlmZddlmZddlm Z ddlm Z ddlm Z ddlm Z dd lm Z dd lmZdd lmZdd lmZeeZejd krejgZejejejejfD]Zeeejkre eqngZGdddZ!Gddde!Z"dS)zBRegisters functions to be called if an exception or signal occurs.N) TracebackType)Any)Callable)Dict)List)Optional)Type)Union)errors)osntc@seZdZdZedefeeddddZdddd Zee e ee ee e d d d Z edefeeddd dZddddZddddZddddZeeddddZddddZdS) ErrorHandleraGContext 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. .NfuncargskwargsreturncOsBd|_d|_g|_i|_g|_|dur>|j|g|Ri|dSNF)call_on_regular_exit body_executedfuncs prev_handlersreceived_signalsregisterselfrrrr@C:\Program Files\Certbot\pkgs\certbot\_internal\error_handler.py__init__PszErrorHandler.__init__)rcCsd|_|dSr)r_set_signal_handlers)rrrr __enter__YszErrorHandler.__enter__) exec_type exec_valuetracerc Csd|_d}|tur|S|dur*|jsd|Sn:|tjurHtd|jd}ntddt |||| | | |S)NTFzEncountered signals: %szEncountered exception: %s)r SystemExitrr SignalExitloggerdebugrjoin tracebackformat_exception_call_registered_reset_signal_handlers _call_signals)rr!r"r#Zretvalrrr__exit__]s"   zErrorHandler.__exit__cOs$|jtj|g|Ri|dS)zSets func to be run with the given arguments during cleanup. :param function func: function to be called in case of an error N)rappend functoolspartialrrrrrtszErrorHandler.registerc Cs|td|jrxz|jdWnJtyj}z2tt||}tdd| WYd}~n d}~00|j q dS)zCalls all registered functionszCalling registered functionsz)Encountered exception during recovery: %sr$N) r'r(r Exceptionr*format_exception_onlytypeerrorr)rstrippop)rexcoutputrrrr,|s  zErrorHandler._call_registeredcCs8tD].}t|}|dur||j|<t||jqdS)z-Sets signal handlers for signals in _SIGNALS.N)_SIGNALSsignal getsignalr_signal_handler)rsignumZ prev_handlerrrrrs   z!ErrorHandler._set_signal_handlerscCs.|jD]\}}t||q |jdS)z/Resets signal handlers for signals in _SIGNALS.N)ritemsr=clear)rr@Zhandlerrrrr-sz#ErrorHandler._reset_signal_handlers)r@ unused_framercCs|j||jstjdS)aReplacement 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)rr0rr r&)rr@rCrrrr?s zErrorHandler._signal_handlercCs,|jD] }td|tt|qdS)z"Finally call the deferred signals.zCalling signal %sN)rr'r(r killgetpid)rr@rrrr.s  zErrorHandler._call_signals)__name__ __module__ __qualname____doc__rrrr rr BaseExceptionrboolr/rr,rr-intr?r.rrrrr 3s      r cs4eZdZdZedefeeddfdd ZZS) 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. .Nrcs$tj|g|Ri|d|_dS)NT)superrrr __class__rrrszExitHandler.__init__)rFrGrHrIrrr __classcell__rrrOrrMsrM)#rIr1Zloggingr=r*typesrtypingrrrrrrr Zcertbotr Zcertbot.compatr Z getLoggerrFr'nameSIGTERMr<ZSIGHUPZSIGQUITZSIGXCPUZSIGXFSZZ signal_coder>SIG_IGNr0r rMrrrrs2            x