U lj!@sUdZddlmZddlZddlmZmZmZddl m Z ddl m Z m Z mZddlmZmZddlmZdd lmZGd d d eZeeGd d d ZeeGdddZeZd ed<GdddeZGdddeZGdddeZGdddeZdS)z PID file. ) annotationsN)getpidkillname) TracebackType)AnyOptionalType) Interface implementer)Logger)FilePathc@sjeZdZdZddddZddddZddd d Zd dd d ZddddZdddddddZ dS)IPIDFilez5 Manages a file that remembers a process ID. intreturncCsdS)a+ Read the process ID stored in this PID file. @return: The contained process ID. @raise NoPIDFound: If this PID file does not exist. @raise EnvironmentError: If this PID file cannot be read. @raise ValueError: If this PID file's content is invalid. NrrrG/tmp/pip-unpacked-wheel-aghyhbke/twisted/application/runner/_pidfile.pyreadsz IPIDFile.readNonecCsdS)z Store the PID of the current process in this PID file. @raise EnvironmentError: If this PID file cannot be written. NrrrrrwriteRunningPID%szIPIDFile.writeRunningPIDcCsdS)zm Remove this PID file. @raise EnvironmentError: If this PID file cannot be removed. Nrrrrrremove,szIPIDFile.removeboolcCsdS)a Determine whether there is a running process corresponding to the PID in this PID file. @return: True if this PID file contains a PID and a process with that PID is currently running; false otherwise. @raise EnvironmentError: If this PID file cannot be read. @raise InvalidPIDFileError: If this PID file's content is invalid. @raise StalePIDFileError: If this PID file's content refers to a PID for which there is no corresponding running process. Nrrrrr isRunning3szIPIDFile.isRunningz 'IPIDFile'cCsdS)z Enter a context using this PIDFile. Writes the PID file with the PID of the running process. @raise AlreadyRunningError: A process corresponding to the PID in this PID file is already running. Nrrrrr __enter__AszIPIDFile.__enter__Optional[Type[BaseException]]Optional[BaseException]Optional[TracebackType]zOptional[bool]excTypeexcValue tracebackrcCsdS)zS Exit a context using this PIDFile. Removes the PID file. Nr)rr r!rrr__exit__KszIPIDFile.__exit__N) __name__ __module__ __qualname____doc__rrrrrr"rrrrrs  rc@seZdZdZeZedddddZddd d d Zdd d dZ dddddZ dd ddZ dd ddZ dd ddZ edddddZdd ddZddddd d!d"Zd#S)$PIDFilez Concrete implementation of L{IPIDFile}. This implementation is presently not supported on non-POSIX platforms. Specifically, calling L{PIDFile.isRunning} will raise L{NotImplementedError}. rbytespidrcCst|dS)z Format a PID file's content. @param pid: A process ID. @return: Formatted PID file contents.  )rencoder*rrr_formatcs zPIDFile._formatz FilePath[Any]r)filePathrcCs ||_dS)zD @param filePath: The path to the PID file on disk. N)r/)selfr/rrr__init__nszPIDFile.__init__rc Csd}z(|j}|D]}q qW5QRXWn8tk rd}z|jtjkrRtdW5d}~XYnXz t|WStk rtd|YnXdS)NPID file does not existz#non-integer PID value in PID file: ) r/openOSErrorerrnoENOENT NoPIDFoundr ValueErrorInvalidPIDFileError)r0Z pidStringfherrrrts   z PIDFile.readcCs|j|j|ddS)z Store a PID in this PID file. @param pid: A PID to store. @raise EnvironmentError: If this PID file cannot be written. r-N)r/Z setContentr.r0r*rrr_writeszPIDFile._writecCs|tdSN)r>rr0rrrrszPIDFile.writeRunningPIDcCs|jdSr?)r/rr@rrrrszPIDFile.removercCsHz |}Wntk r"YdSXtdkr6||StdtdS)NFposixz isRunning is not implemented on )rr8 SYSTEM_NAME_pidIsRunningPOSIXNotImplementedErrorr=rrrrs  zPIDFile.isRunningc Cshzt|dWnPtk r^}z2|jtjkr6tdn|jtjkrLWY dSW5d}~XYnXdSdS)a1 POSIX implementation for running process check. Determine whether there is a running process corresponding to the given PID. @param pid: The PID to check. @return: True if the given PID is currently running; false otherwise. @raise EnvironmentError: If this PID file cannot be read. @raise InvalidPIDFileError: If this PID file's content is invalid. @raise StalePIDFileError: If this PID file's content refers to a PID for which there is no corresponding running process. rz'PID file refers to non-existing processTN)rr5r6ZESRCHStalePIDFileErrorEPERM)r*r<rrrrCs    zPIDFile._pidIsRunningPOSIXz 'PIDFile'cCs@z|rtWn tk r2|jdYnX||S)Nz&Replacing stale PID file: {log_source})rAlreadyRunningErrorrE_loginforr@rrrrs zPIDFile.__enter__rrrrcCs |dSr?)rr0rr r!rrrr"szPIDFile.__exit__N)r#r$r%r&r rH staticmethodr.r1rr>rrrrCrr"rrrrr'Ws    r'c@seZdZdZddddZddddZddd d d Zddd d ZddddZddddZ ddddZ dddddddZ dS) NonePIDFilez PID file implementation that does nothing. This is meant to be used as a "active None" object in place of a PID file when no PID file is desired. rrcCsdSr?rr@rrrr1szNonePIDFile.__init__rcCs tddS)Nr3)r8r@rrrrszNonePIDFile.readr)cCsttjddS)z Store a PID in this PID file. @param pid: A PID to store. @raise EnvironmentError: If this PID file cannot be written. @note: This implementation always raises an L{EnvironmentError}. zOperation not permittedN)r5r6rFr=rrrr>s zNonePIDFile._writecCs|ddS)Nr)r>r@rrrrszNonePIDFile.writeRunningPIDcCsttjddS)NzNo such file or directory)r5r6r7r@rrrrszNonePIDFile.removercCsdS)NFrr@rrrrszNonePIDFile.isRunningz 'NonePIDFile'cCs|Sr?rr@rrrrszNonePIDFile.__enter__rrrrcCsdSr?rrJrrrr"szNonePIDFile.__exit__N) r#r$r%r&r1rr>rrrrr"rrrrrLs rL nonePIDFilec@seZdZdZdS)rGz% Process is already running. Nr#r$r%r&rrrrrGsrGc@seZdZdZdS)r:z( PID file contents are invalid. NrNrrrrr: sr:c@seZdZdZdS)rEz[ PID file contents are valid, but there is no process with the referenced PID. NrNrrrrrEsrEc@seZdZdZdS)r8z# No PID found in PID file. NrNrrrrr8sr8) r& __future__rr6osrrrrBtypesrtypingrrr Zzope.interfacer r Ztwisted.loggerr Ztwisted.python.filepathr rr'rLrM__annotations__ ExceptionrGr:rEr8rrrrs$    By/