3
Pf @ st d Z ddlmZ ddlZddlZddlZddlmZmZm Z m
Z
m Z m Z G dd deZ
dd Zd
d Zd d
ZdS )z8 Lockfile behaviour implemented via Unix PID files.
)absolute_importN )LockBase
AlreadyLocked
LockFailed NotLocked NotMyLock LockTimeoutc @ sL e Zd ZdZdddZdd Zdd Zd
d Zdd d
Zdd Z dd Z
dS ) PIDLockFileaA Lockfile implemented as a Unix PID file.
The lock file is a normal file named by the attribute `path`.
A lock's PID file contains a single line of text, containing
the process ID (PID) of the process that acquired the lock.
>>> lock = PIDLockFile('somefile')
>>> lock = PIDLockFile('somefile')
FNc C s t j| |d| | j| _d S )NF)r __init__pathZ unique_name)selfr Zthreadedtimeout r !/usr/lib/python3.6/pidlockfile.pyr $ s zPIDLockFile.__init__c C s
t | jS )z- Get the PID from the lock file.
)read_pid_from_pidfiler )r
r r r read_pid* s zPIDLockFile.read_pidc C s t jj| jS )zv Test if the lock is currently held.
The lock is held if the PID file for this lock exists.
)osr exists)r
r r r is_locked/ s zPIDLockFile.is_lockedc C s | j otj | j kS )z Test if the lock is held by the current process.
Returns ``True`` if the current process ID matches the
number stored in the PID file.
)r r getpidr )r
r r r i_am_locking7 s zPIDLockFile.i_am_lockingc C s |dk r |n| j }tj }|dk r2|dkr2||7 }xyt| j W n tk
r } zv|jtjkrtj |kr|dk r|dkrtd| j ntd| j tj |dk r|d pd nt
d| j W Y dd}~X q4X dS q4W dS )z Acquire the lock.
Creates the PID file for this lock, or raises an error if
the lock could not be acquired.
Nr z&Timeout waiting to acquire lock for %sz%s is already locked
g?zfailed to create %s) r timewrite_pid_to_pidfiler OSErrorerrnoZEEXISTr r Zsleepr )r
r Zend_timeexcr r r acquire? s$
zPIDLockFile.acquirec C s: | j std| j | j s,td| j t| j dS )z Release the lock.
Removes the PID file to release the lock, or raises an
error if the current process does not hold the lock.
z%s is not lockedz%s is locked, but not by meN)r r r r r remove_existing_pidfile)r
r r r release_ s
zPIDLockFile.releasec C s t | j dS )z Break an existing lock.
Removes the PID file if it already exists, otherwise does
nothing.
N)r r )r
r r r
break_lockl s zPIDLockFile.break_lock)FN)N) __name__
__module__ __qualname____doc__r r r r r r r! r r r r r
s
r
c C sb d}yt | d}W n tk
r& Y n8X |j j }y t|}W n tk
rT Y nX |j |S )z Read the PID recorded in the named PID file.
Read and return the numeric PID recorded as text in the named
PID file. If the PID file cannot be read, or if the content is
not a valid PID, return ``None``.
Nr)openIOErrorreadlinestripint
ValueErrorclose) pidfile_pathpidpidfileliner r r r v s r c C sR t jt jB t jB }d}t j| ||}t j|d}t j }|jd| |j dS )u Write the PID in the named PID file.
Get the numeric process ID (“PID”) of the current process
and write it to the named file as a line of text.
i wz%s
N) r O_CREATO_EXCLO_WRONLYr' fdopenr writer- )r. Z
open_flagsZ open_modeZ
pidfile_fdr0 r/ r r r r s r c C sF yt j| W n2 tk
r@ } z|jtjkr.n W Y dd}~X nX dS )z Remove the named PID file if it exists.
Removing a PID file that doesn't already exist puts us in the
desired state, so we ignore the condition if the file does not
exist.
N)r remover r ENOENT)r. r r r r r s r )r% Z
__future__r r r r r r r r r r r
r r r r r r r
s ]"