interface documentation

class twisted.application.runner._pidfile.IPIDFile(Interface): (source)

Known implementations: twisted.application.runner._pidfile.NonePIDFile, twisted.application.runner._pidfile.PIDFile

View In Hierarchy

Manages a file that remembers a process ID.

Method read Read the process ID stored in this PID file.
Method writeRunningPID Store the PID of the current process in this PID file.
Method remove Remove this PID file.
Method isRunning Determine whether there is a running process corresponding to the PID in this PID file.
Method __enter__ Enter a context using this PIDFile.
Method __exit__ Exit a context using this PIDFile.
def read(): (source)

Read the process ID stored in this PID file.

ReturnsThe contained process ID. (type: int)
RaisesNoPIDFoundIf this PID file does not exist.
EnvironmentErrorIf this PID file cannot be read.
ValueErrorIf this PID file's content is invalid.
def writeRunningPID(): (source)

Store the PID of the current process in this PID file.

RaisesEnvironmentErrorIf this PID file cannot be written.
def remove(): (source)

Remove this PID file.

RaisesEnvironmentErrorIf this PID file cannot be removed.
def isRunning(): (source)

Determine whether there is a running process corresponding to the PID in this PID file.

ReturnsTrue if this PID file contains a PID and a process with that PID is currently running; false otherwise. (type: bool)
RaisesEnvironmentErrorIf this PID file cannot be read.
InvalidPIDFileErrorIf this PID file's content is invalid.
StalePIDFileErrorIf this PID file's content refers to a PID for which there is no corresponding running process.
def __enter__(): (source)

Enter a context using this PIDFile.

Writes the PID file with the PID of the running process.

ReturnsUndocumented (type: IPIDFile)
RaisesAlreadyRunningErrorA process corresponding to the PID in this PID file is already running.
def __exit__(excType, excValue, traceback): (source)

Exit a context using this PIDFile.

Removes the PID file.

ParametersexcTypeUndocumented (type: Optional[Type[BaseException]])
excValueUndocumented (type: Optional[BaseException])
tracebackUndocumented (type: Optional[TracebackType])
ReturnsUndocumented (type: Optional[bool])
API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.