| Current File : //usr/lib/python3/dist-packages/twisted/application/runner/__pycache__/_pidfile.cpython-312.pyc |
�
Ϫ�f! � �T � U d Z ddlmZ ddlZddlmZmZmZ ddl m
Z
ddl m Z m
Z
mZ ddlmZmZ ddlmZ dd lmZ G d
� d e� Z ee� G d � d
� � Z ee� G d� d� � Z e� Zd ed< G d� de� Z G d� de� Z G d� de� Z G d� de� Z y)z
PID file.
� )� annotationsN)�getpid�kill�name)�
TracebackType)�Any�Optional�Type)� Interface� implementer)�Logger)�FilePathc �P � e Zd ZdZd d�Zd
d�Zd
d�Zd d�Zd d�Z d
d�Z y)�IPIDFilez5
Manages a file that remembers a process ID.
c � � y)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.
N� r � �E/usr/lib/python3/dist-packages/twisted/application/runner/_pidfile.py�readz
IPIDFile.read � � r c � � y)z�
Store the PID of the current process in this PID file.
@raise EnvironmentError: If this PID file cannot be written.
Nr r r r �writeRunningPIDzIPIDFile.writeRunningPID% r r c � � y)zm
Remove this PID file.
@raise EnvironmentError: If this PID file cannot be removed.
Nr r r r �removezIPIDFile.remove, r r c � � y)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.
Nr r r r � isRunningzIPIDFile.isRunning3 r r c � � y)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.
Nr r r r � __enter__zIPIDFile.__enter__A r r c � � y)zS
Exit a context using this PIDFile.
Removes the PID file.
Nr )�excType�excValue� tracebacks r �__exit__zIPIDFile.__exit__K r r N��return�int�r% �None�r% �bool)r% z
'IPIDFile')r � Optional[Type[BaseException]]r! �Optional[BaseException]r" �Optional[TracebackType]r% zOptional[bool])
�__name__�
__module__� __qualname__�__doc__r r r r r r# r r r r r sI � �� � � � � � �.� �)� � +� �
� r r c � � e Zd ZdZ e� Zed
d�� Zdd�Zdd�Z dd�Z
dd�Z dd�Z dd�Z
edd �� Zdd
�Z dd �Zy )�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}.
c �: � t | � � d�j � S )z�
Format a PID file's content.
@param pid: A process ID.
@return: Formatted PID file contents.
�
)r& �encode��pids r �_formatzPIDFile._formatc s � � �c�(��2��%�%�'�'r c � � || _ y)zD
@param filePath: The path to the PID file on disk.
N)�filePath)�selfr; s r �__init__zPIDFile.__init__n s � � !��
r c �8 � d} | j j � 5 }|D ] } n d d d � t
|� S # 1 sw Y �xY w# t $ r.}|j t j k( r t d� �� d }~ww xY w# t $ r t d|��� �w xY w)Nr �PID file does not existz#non-integer PID value in PID file: ) r; �open�OSError�errno�ENOENT�
NoPIDFoundr& �
ValueError�InvalidPIDFileError)r< � pidString�fh�es r r z PIDFile.readt s� � �� � �� � �#�#�%�
��!#� �I���
� ��y�>� !�
�
�� � ��w�w�%�,�,�&� �!:�;�;� �� �� � �%�5�i�]�C��
� �s6 �A � ;�A �
B �A� A � A>�)A9�9A>�Bc �Z � | j j | j |�� � y)z�
Store a PID in this PID file.
@param pid: A PID to store.
@raise EnvironmentError: If this PID file cannot be written.
r7 N)r; �
setContentr9 �r< r8 s r �_writezPIDFile._write� s! � �
�
�
� � �� � �#� �!6�7r c �6 � | j t � � y �N)rM r �r< s r r zPIDFile.writeRunningPID� s � � � � �F�H� r c �8 � | j j � y rO )r; r rP s r r zPIDFile.remove� s � � �
�
� � � r c � � | j � }t dk( r| j |� S t dt � �� �# t $ r Y yw xY w)NF�posixz isRunning is not implemented on )r rD � SYSTEM_NAME�_pidIsRunningPOSIX�NotImplementedErrorrL s r r zPIDFile.isRunning� sT � � ��)�)�+�C� �'� !��*�*�3�/� /�%�(H��
�&V�W� W��
� �� �s �> � A
� A
c �� � t | d� y# t $ rP}|j t j k( r t d� �|j t j
k( rY d}~y� d}~ww xY w)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.
r Tz'PID file refers to non-existing processN)r rA rB �ESRCH�StalePIDFileError�EPERM)r8 rI s r rU zPIDFile._pidIsRunningPOSIX� sY � �"
� ��a�L� �� � ��w�w�%�+�+�%�'�(Q�R�R����E�K�K�'����
�s � � A(�AA#�"A#�#A(c � � | j � r
t � � | j � | S # t $ r | j j d� Y �8w xY w)Nz&Replacing stale PID file: {log_source})r �AlreadyRunningErrorrY �_log�infor rP s r r zPIDFile.__enter__� sW � � E��~�~� �)�+�+� �
� � � �� �� !� E� �I�I�N�N�C� D� E�s �/ �$A�Ac �$ � | j � y rO )r �r< r r! r" s r r# zPIDFile.__exit__� s � �
� � �
�r N)r8 r& r% �bytes)r; z
FilePath[Any]r% r( r$ �r8 r& r% r( r' r) )r8 r& r% r* )r% z 'PIDFile'�r r+ r! r, r" r- r% r( )r. r/ r0 r1 r
r] � staticmethodr9 r= r rM r r r rU r r# r r r r3 r3 W s� � �� �8�D��(� �(�!� �$8� � � X� �� ��8��.�� *�� +� �
� r r3 c �` � e Zd ZdZd d�Zd d�Zd
d�Zd d�Zd d�Zdd�Z dd�Z
dd �Z y
)� 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.
c � � y rO r rP s r r= zNonePIDFile.__init__� s � � r c � � t d� �)Nr? )rD rP s r r zNonePIDFile.read� s � ��2�3�3r c �6 � t t j d� �)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)rA rB rZ rL s r rM zNonePIDFile._write� s � � �e�k�k�#<�=�=r c �& � | j d� y )Nr )rM rP s r r zNonePIDFile.writeRunningPID� s
� � � � �A�r c �6 � t t j d� �)NzNo such file or directory)rA rB rC rP s r r zNonePIDFile.remove� s � ��e�l�l�$?�@�@r c � � y)NFr rP s r r zNonePIDFile.isRunning� s � �r c � � | S rO r rP s r r zNonePIDFile.__enter__� s � �� r c � � y rO r r` s r r# zNonePIDFile.__exit__� s � � r Nr' r$ rb r) )r% z
'NonePIDFile'rc ) r. r/ r0 r1 r= r rM r r r r r# r r r rf rf � sV � ��
�4�
>��A����.�� *�� +� �
� r rf � nonePIDFilec � � e Zd ZdZy)r\ z%
Process is already running.
N�r. r/ r0 r1 r r r r\ r\ � � �r r\ c � � e Zd ZdZy)rF z(
PID file contents are invalid.
Nrq r r r rF rF
rr r rF c � � e Zd ZdZy)rY z[
PID file contents are valid, but there is no process with the referenced
PID.
Nrq r r r rY rY s � �r rY c � � e Zd ZdZy)rD z#
No PID found in PID file.
Nrq r r r rD rD rr r rD ) r1 �
__future__r rB �osr r r rT �typesr �typingr r r
�zope.interfacer r �twisted.loggerr
�twisted.python.filepathr r r3 rf ro �__annotations__� Exceptionr\ rF rY rD r r r �<module>r s� ��
� #� � 0� 0� � &� &� 1� !� ,�? �y� ? �D
�X��v� v� �v�r
�X��,� ,� �,�^ $�
� �X� %��)� � �)� � � � ��� r