tf!UdZddlmZddlZddlmZmZmZddl m Z ddl m Z m Z mZddlmZmZddlmZdd lmZGd d eZeeGd d ZeeGddZeZd ed<GddeZGddeZGddeZGddeZdS)z PID file. ) annotationsN)getpidkillname) TracebackType)AnyOptionalType) Interface implementer)Logger)FilePathcBeZdZdZddZddZddZdd Zdd ZddZ dS)IPIDFilez5 Manages a file that remembers a process ID. returnintcdS)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. Nrb/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/application/runner/_pidfile.pyreadz IPIDFile.readrNonecdS)z Store the PID of the current process in this PID file. @raise EnvironmentError: If this PID file cannot be written. NrrrrwriteRunningPIDzIPIDFile.writeRunningPID%rrcdS)zm Remove this PID file. @raise EnvironmentError: If this PID file cannot be removed. NrrrrremovezIPIDFile.remove,rrboolcdS)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. Nrrrr isRunningzIPIDFile.isRunning3rr 'IPIDFile'cdS)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. Nrrrr __enter__zIPIDFile.__enter__ArrexcTypeOptional[Type[BaseException]]excValueOptional[BaseException] tracebackOptional[TracebackType]Optional[bool]cdS)zS Exit a context using this PIDFile. Removes the PID file. Nr)r$r&r(s r__exit__zIPIDFile.__exit__KrrNrrrrrr)rr!)r$r%r&r'r(r)rr*) __name__ __module__ __qualname____doc__rrrr r#r,rrrrrs                             rrceZdZdZeZeddZdd Zdd Z dd Z d d Z d dZ d!dZ ed"dZd#dZd$dZdS)%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}. pidrrbytescJt|dS)z Format a PID file's content. @param pid: A process ID. @return: Formatted PID file contents.  )rencoder6s r_formatzPIDFile._formatcs"c((%%'''rfilePath FilePath[Any]rc||_dS)zD @param filePath: The path to the PID file on disk. N)r=)selfr=s r__init__zPIDFile.__init__ns! rcDd} |j5}|D]}dddn #1swxYwYn7#t$r*}|jtjkrt dd}~wwxYw t |S#t$rtd|wxYw)NrPID file does not existz#non-integer PID value in PID file: ) r=openOSErrorerrnoENOENT NoPIDFoundr ValueErrorInvalidPIDFileError)r@ pidStringfhes rrz PIDFile.readts  ##%% !#I                  w%,&& !:;;;    y>> !   %CiCC  s9;/ ;3;3; A/%A**A/3BBcb|j||dS)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= setContentr<r@r6s r_writezPIDFile._writes.   #!6!677777rcH|tdSN)rQrr@s rrzPIDFile.writeRunningPIDs FHHrc8|jdSrS)r=rrTs rrzPIDFile.removes rrc |}n#t$rYdSwxYwtdkr||St dt)NFposixz isRunning is not implemented on )rrH SYSTEM_NAME_pidIsRunningPOSIXNotImplementedErrorrPs rr zPIDFile.isRunningsp ))++CC   55  ' ! !**3// /%&V&V&VWW Ws  %%c t|ddS#t$rE}|jtjkrt d|jtjkrYd}~dSd}~wwxYw)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. rTz'PID file refers to non-existing processN)rrErFESRCHStalePIDFileErrorEPERM)r6rMs rrYzPIDFile._pidIsRunningPOSIXsy"  aLLL4   w%+%%'(QRRREK''ttttt  s A#9AAA# 'PIDFile'c |rtn*#t$r|jdYnwxYw||S)Nz&Replacing stale PID file: {log_source})r AlreadyRunningErrorr]_loginforrTs rr#zPIDFile.__enter__s| E~~ ,)+++ ,  E E E INNC D D D D D E  s"%$A  A r$r%r&r'r(r)c.|dSrS)rr@r$r&r(s rr,zPIDFile.__exit__s trN)r6rrr7)r=r>rrr-r6rrrr.r/)r6rrr)rr_r$r%r&r'r(r)rr)r0r1r2r3r rb staticmethodr<rArrQrrr rYr#r,rrrr5r5Ws  688D(((\(!!!! $8888 X X X X\8rr5cReZdZdZddZddZddZdd Zdd Zdd Z ddZ ddZ 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. rrcdSrSrrTs rrAzNonePIDFile.__init__s rrc td)NrC)rHrTs rrzNonePIDFile.reads2333rr6c6ttjd)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 permitted)rErFr^rPs rrQzNonePIDFile._writesek#<===rc0|ddS)Nr)rQrTs rrzNonePIDFile.writeRunningPIDs Arc6ttjd)NzNo such file or directory)rErFrGrTs rrzNonePIDFile.removesel$?@@@rrcdS)NFrrTs rr zNonePIDFile.isRunningsur 'NonePIDFile'c|SrSrrTs rr#zNonePIDFile.__enter__s rr$r%r&r'r(r)cdSrSrres rr,zNonePIDFile.__exit__s trNr.r-rfr/)rrqrg) r0r1r2r3rArrQrrr r#r,rrrrjrjs    4444 > > > >AAAArrj nonePIDFileceZdZdZdS)raz% Process is already running. Nr0r1r2r3rrrrararraceZdZdZdS)rJz( PID file contents are invalid. NrvrrrrJrJ rwrrJceZdZdZdS)r]z[ PID file contents are valid, but there is no process with the referenced PID. Nrvrrrr]r]srr]ceZdZdZdS)rHz# No PID found in PID file. NrvrrrrHrHrwrrH) r3 __future__rrFosrrrrXtypesrtypingrr r zope.interfacer r twisted.loggerr twisted.python.filepathrrr5rjrt__annotations__ ExceptionrarJr]rHrrrrs9 #""""" 0000000000&&&&&&&&&&11111111!!!!!!,,,,,,? ? ? ? ? y? ? ? D Xvvvvvvvvr X,,,,,,,,^$ %%%%) )  r