#b&dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ej de Gdde ZGd d eeZGd d eeZGd deeZGddZddZdZdZdS)z Daemon runner library. Npidfile) DaemonContextu@The ‘runner’ module is not a supported API for this library.ceZdZdZdS)DaemonRunnerErrorz3 Abstract base class for errors from DaemonRunner. N__name__ __module__ __qualname____doc__//usr/lib/python3/dist-packages/daemon/runner.pyrrs====rrceZdZdZdS)DaemonRunnerInvalidActionErrorz; Raised when specified action for DaemonRunner is invalid. Nr rrrrrsEEEErrceZdZdZdS)DaemonRunnerStartFailureErrorz, Raised when failure starting DaemonRunner. Nr rrrrr#6666rrceZdZdZdS)DaemonRunnerStopFailureErrorz, Raised when failure stopping DaemonRunner. Nr rrrrr'rrrc`eZdZdZdZdZdZdZddZdZ d Z d Z d Z e e e d Z d ZdZdS) DaemonRunnera3 Controller for a callable running in a separate background process. The first command-line argument is the action to take: * 'start': Become a daemon and call `app.run()`. * 'stop': Exit the daemon process specified in the PID file. * 'restart': Stop, then start. zstarted with pid {pid:d}c|||_t|_||d|_|jt|j|j|_|j|j_dS)a" Set up the parameters of a new runner. :param app: The application instance; see below. :return: ``None``. The `app` argument must have the following attributes: * `stdin_path`, `stdout_path`, `stderr_path`: Filesystem paths to open and replace the existing `sys.stdin`, `sys.stdout`, `sys.stderr`. * `pidfile_path`: Absolute filesystem path to a file that will be used as the PID file for the daemon. If ``None``, no PID file will be used. * `pidfile_timeout`: Used as the default acquisition timeout value supplied to the runner's PID lock file. * `run`: Callable that will be invoked when the daemon is started. N) parse_argsapprdaemon_context#_open_streams_from_app_stream_pathsr pidfile_pathmake_pidlockfilepidfile_timeoutselfrs r__init__zDaemonRunner.__init__7sz, +oo 00555   '+$c&9;;DL&*l###rct|jd|j_t|jd|j_t|jdd|j_dS)ab Open the `daemon_context` streams from the paths specified. :param app: The application instance. Open the `daemon_context` standard streams (`stdin`, `stdout`, `stderr`) as stream objects of the appropriate types, from each of the corresponding filesystem paths from the `app`. rtzw+tr) bufferingN)open stdin_pathrstdin stdout_pathstdout stderr_pathstderrr"s rrz0DaemonRunner._open_streams_from_app_stream_pathsXs[%)$>$>!%)#/5%A%A"%)!&5&5&5"""rc tj|d}d}d|j}d||}t|tj |dS)z Emit a usage message, then exit. :param argv: The command-line arguments used to invoke the program, as a sequence of strings. :return: ``None``. r|zusage: {progname} {usage})prognameusageN) ospathbasenamejoin action_funcskeysformat emit_messagesysexit)r#argvr2usage_exit_code action_usagemessages r _usage_exitzDaemonRunner._usage_exitgs7##DG,,xx 1 6 6 8 899 -44!577W !!!!!rNc| tj}d}t||kr||t |d|_|j|jvr||dSdS)a Parse command-line arguments. :param argv: The command-line arguments used to invoke the program, as a sequence of strings. :return: ``None``. The parser expects the first argument as the program name, the second argument as the action to perform. If the parser fails to parse the arguments, emit a usage message and exit the program. Nr0r)r<r>lenrBstractionr8)r#r>min_argss rrzDaemonRunner.parse_argsvs} <8D t99x     T " " "$q'll ;d/ / /   T " " " " " 0 /rct|jr|j |jnB#t j$r0}td|j}||d}~wwxYwtj }|j |}t||j dS)z Open the daemon context and run the application. :return: ``None``. :raises DaemonRunnerStartFailureError: If the PID file cannot be locked by this process. z(PID file {pidfile.path!r} already lockedrN)pid)is_pidfile_staler break_lockrr(lockfile AlreadyLockedrr:r4getpid start_messager;rrun)r#excerrorrIrAs r_startzDaemonRunner._starts DL ) ) & L # # % % % !   $ $ & & & &% ! ! !1>EE $ F..//ES  ! ikk$+++44W  sA B+BBc|j} tj|tjdS#t $r,}td||}||d}~wwxYw)z Terminate the daemon process specified in the current PID file. :return: ``None``. :raises DaemonRunnerStopFailureError: If terminating the daemon fails with an OS error. z"Failed to terminate {pid:d}: {exc})rIrQN) rread_pidr4killsignalSIGTERMOSErrorrr:)r#rIrQrRs r_terminate_daemon_processz&DaemonRunner._terminate_daemon_processsl##%% ! GC ( ( ( ( ( ! ! !08??S@**++ES  !s< A2'A--A2c|js*td|j}|t |jr|jdS|dS)z Exit the daemon process specified in the current PID file. :return: ``None``. :raises DaemonRunnerStopFailureError: If the PID file is not already locked. z$PID file {pidfile.path!r} not lockedrN)r is_lockedrr:rJrKrZ)r#rRs r_stopzDaemonRunner._stops|%%'' 0:AA $ B..//EK DL ) ) - L # # % % % % %  * * , , , , ,rcV||dS)z Stop, then start. N)r]rS)r#s r_restartzDaemonRunner._restarts   r)startstoprestartc |j|j}n8#t$r+td|j}|wxYw|S)ad Get the function for the specified action. :return: The function object corresponding to the specified action. :raises DaemonRunnerInvalidActionError: if the action is unknown. The action is specified by the `action` attribute, which is set during `parse_args`. zUnknown action: {action!r})rF)r8rFKeyErrorrr:)r#funcrRs r_get_action_funczDaemonRunner._get_action_funcsm $T[1DD   2077#{8,,--EK    s 5A cD|}||dS)z Perform the requested action. :return: ``None``. The action is specified by the `action` attribute, which is set during `parse_args`. N)rf)r#res r do_actionzDaemonRunner.do_actions&$$&& T rN)r r r r rOr$rrBrrSrZr]r_r8rfrhrrrrr+s  /M333B 5 5 5 " " "####20!!! ---$ L (     rrc| tj}|d||dS)z@ Emit a message to the specified stream (default `sys.stderr`). Nz {message} )rA)r<r.writer:flush)rAstreams rr;r;sB ~ LL%%g%66777 LLNNNNNrc,t|ts%td|}|tj|s%td|}|tj||}|S)z= Make a PIDLockFile instance with the given filesystem path. zNot a filesystem path: {path!r})r5zNot an absolute path: {path!r}) isinstancerE ValueErrorr:r4r5isabsrTimeoutPIDLockFile)r5acquire_timeoutrRrLs rr r s dC <CCD 7==  ;BBC )$@@H Orcd}|j}|3 tj|tjn#t $rd}YnwxYw|S)u Determine whether a PID file is stale. :return: ``True`` iff the PID file is stale; otherwise ``False``. The PID file is “stale” if its contents are valid but do not match the PID of a currently-running process. FNT)rUr4rVrWSIG_DFLProcessLookupError)rresult pidfile_pids rrJrJ sfF"'"$$K  GK 0 0 0 0!   FFF  Ms5 AAri)r errnor4rWr<warningsrLrdaemonrwarnDeprecationWarning Exceptionrrpr RuntimeErrorrrrr;r rJrrrrs !!!!!! J >>>>> >>>FFFFF%6 FFF77777$5|77777777#4l777FFFFFFFFR   r