File: //lib/python3/dist-packages/twisted/test/__pycache__/test_lockfile.cpython-310.pyc
o
�b�; � @ s� d Z ddlZddlZddlmZmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
dZd Ze �� rBe d
�du rBe d �du rBd Zd
ZG dd� de
�ZG dd� de
�ZdS )z'
Tests for L{twisted.python.lockfile}.
� N)�skipIf�
skipUnless)�lockfile)�
requireModule)�platform)�TestCaseF� zwin32api.OpenProcess�
pywintypesTzZOn windows, lockfile.kill is not implemented in the absence of win32api and/or pywintypes.c @ sx e Zd ZdZdd� Zee�� d�dd� �Zdd� Z ee�� d �d
d � �Z
e e e
�d d
� �Ze e e
�dd� �Zdd� ZdS )� UtilTestszM
Tests for the helper functions used to implement L{FilesystemLock}.
c C s: | � � }t�d|� | �ttjd|�}| �|jtj� dS )z�
L{lockfile.symlink} raises L{OSError} with C{errno} set to L{EEXIST}
when an attempt is made to create a symlink which already exists.
�fooN)�mktempr �symlink� assertRaises�OSError� assertEqual�errno�EEXIST��self�name�exc� r �</usr/lib/python3/dist-packages/twisted/test/test_lockfile.py�test_symlinkEEXIST& s z UtilTests.test_symlinkEEXIST�Bspecial rename EIO handling only necessary and correct on Windows.c C sD | � � }dd� }| �td|� | �ttj|d�}| �|jtj� dS )a<
L{lockfile.symlink} raises L{OSError} with C{errno} set to L{EIO} when
the underlying L{rename} call fails with L{EIO}.
Renaming a file on Windows may fail if the target of the rename is in
the process of being deleted (directory deletion appears not to be
atomic).
c S � t tjd ���N�r r �EIO��src�dstr r r �
fakeRename? � z4UtilTests.test_symlinkEIOWindows.<locals>.fakeRename�renamer N) r �patchr r �IOErrorr
r r r )r r r" r r r r �test_symlinkEIOWindows0 s
z UtilTests.test_symlinkEIOWindowsc C s, | � � }| �ttj|�}| �|jtj� dS )z�
L{lockfile.readlink} raises L{OSError} with C{errno} set to L{ENOENT}
when an attempt is made to read a symlink which does not exist.
N)r r r r �readlinkr r �ENOENTr r r r �test_readlinkENOENTF s z UtilTests.test_readlinkENOENT�Gspecial readlink EACCES handling only necessary and correct on Windows.c C sB | � � }dd� }| �td|� | �ttj|�}| �|jtj� dS )a\
L{lockfile.readlink} raises L{OSError} with C{errno} set to L{EACCES}
on Windows when the underlying file open attempt fails with C{EACCES}.
Opening a file on Windows may fail if the path is inside a directory
which is in the process of being deleted (directory deletion appears
not to be atomic).
c S r r �r r �EACCES)�path�moder r r �fakeOpen^ r# z6UtilTests.test_readlinkEACCESWindows.<locals>.fakeOpen�_openN) r r% r r r& r( r r r- )r r r0 r r r r �test_readlinkEACCESWindowsO s
z$UtilTests.test_readlinkEACCESWindowsc C s t �t�� d� dS )z}
L{lockfile.kill} returns without error if passed the PID of a
process which exists and signal C{0}.
r N)r �kill�os�getpid�r r r r � test_kille s zUtilTests.test_killc C s& | � ttjdd�}| �|jtj� dS )z�
L{lockfile.kill} raises L{OSError} with errno of L{ESRCH} if
passed a PID which does not correspond to any process.
i���r N)r r r r3 r r �ESRCH)r r r r r �test_killESRCHm s zUtilTests.test_killESRCHc C s6 | � tdd� t�| �� �}|�� | �|�� � dS )z�
Verify that when L{lockfile.kill} does end up as None (e.g. on Windows
without pywin32), it doesn't end up being called and raising a
L{TypeError}.
r3 N)r% r �FilesystemLockr �lock� assertFalse)r �flr r r �test_noKillCallw s zUtilTests.test_noKillCallN)�__name__�
__module__� __qualname__�__doc__r r r � isWindowsr' r* r2 r �skipKill�skipKillReasonr7 r9 r> r r r r r
! s&
�
�
r
c @ s� e Zd Zdd� Zdd� Zee�� d�dd� �Zdd � Z d
d � Z
d d
� Z dd� Z dd� Z
ee�� d�dd� �Zee�� d�dd� �Zdd� Zdd� Zee�� d�d d � �Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(S ))� LockingTestsc sL � fdd�}| � td|� | �� }t�|�}| �t|j�}| �|j� � d S )Nc s
t � d ��r )r )�source�dest�r r r � fakeSymlink� �
z3LockingTests._symlinkErrorTest.<locals>.fakeSymlinkr
) r% r r r: r r r; r r )r r rJ �lockfr; r r rI r �_symlinkErrorTest� s
z LockingTests._symlinkErrorTestc C s | � tj� dS )z�
An exception raised by C{symlink} other than C{EEXIST} is passed up to
the caller of L{FilesystemLock.lock}.
N)rM r �ENOSYSr6 r r r �test_symlinkError� s z LockingTests.test_symlinkErrorz9POSIX-specific error propagation not expected on Windows.c C s | � tj� | � tj� dS )a
An L{OSError} raised by C{symlink} on a POSIX platform with an errno of
C{EACCES} or C{EIO} is passed to the caller of L{FilesystemLock.lock}.
On POSIX, unlike on Windows, these are unexpected errors which cannot
be handled by L{FilesystemLock}.
N)rM r r- r r6 r r r �test_symlinkErrorPOSIX� s z#LockingTests.test_symlinkErrorPOSIXc C s< | � � }t�|�}| �|�� � | �|j� | �|j� dS )z�
If the lock has never been held, it can be acquired and the C{clean}
and C{locked} attributes are set to C{True}.
N)r r r: �
assertTruer; �clean�locked�r rL r; r r r �test_cleanlyAcquire� s
z LockingTests.test_cleanlyAcquirec C sh | � � }t�|�}| �|�� � |�� | �|j� t�|�}| �|�� � | �|j� | �|j� dS )z�
If a lock is released cleanly, it can be re-acquired and the C{clean}
and C{locked} attributes are set to C{True}.
N) r r r: rQ r; �unlockr< rS rR rT r r r �test_cleanlyRelease� s
z LockingTests.test_cleanlyReleasec C sH | � � }t�|�}| �|�� � t�|�}| �|�� � | �|j� dS )zK
If a lock is currently locked, it cannot be locked again.
N)r r r: rQ r; r< rS )r rL � firstLock�
secondLockr r r �test_cannotLockLocked� s
z"LockingTests.test_cannotLockLockedc s� d� � fdd�}| � � }| �td|� t�t� �|� t�|�}| �|�� � | �|j � | �|j
� | � t� |�tt
�� �� dS )z�
If a lock was held by a process which no longer exists, it can be
acquired, the C{clean} attribute is set to C{False}, and the
C{locked} attribute is set to C{True}.
i90 c s, |dkr
t tjd ��| � krt tjd ��d S )Nr �r r �EPERMr8 ��pid�signal��ownerr r �fakeKill� �
�z4LockingTests.test_uncleanlyAcquire.<locals>.fakeKillr3 N)r r% r r
�strr: rQ r; r< rR rS r r( r4 r5 )r rb rL r; r r` r �test_uncleanlyAcquire� s
z"LockingTests.test_uncleanlyAcquirec �~ � �fdd�}| � td|��dd� }| � td|� | �� � t�� �}t�td�� � | �|�� � | �|j� | �|j � dS ) z�
If the lock is initially held but then released before it can be
examined to determine if the process which held it still exists, it is
acquired and the C{clean} and C{locked} attributes are set to C{True}.
c s t �� � ��� t �| �S r )r �rmlink�restorer( �r �rL �
readlinkPatchr r � fakeReadlink� s
z?LockingTests.test_lockReleasedBeforeCheck.<locals>.fakeReadlinkr( c S �, |dkr
t tjd ��| dkrt tjd ��d S �Nr �u� r[ r] r r r rb � rc z;LockingTests.test_lockReleasedBeforeCheck.<locals>.fakeKillr3 ro N�
r% r r r: r
rd rQ r; rR rS )r rl rb r; r rj r � test_lockReleasedBeforeCheck� �
z)LockingTests.test_lockReleasedBeforeCheckr c C sF dd� }| � td|� | �� }t�|�}| �|�� � | �|j� dS )a�
If the lock is released while an attempt is made to acquire
it, the lock attempt fails and C{FilesystemLock.lock} returns
C{False}. This can happen on Windows when L{lockfile.symlink}
fails with L{IOError} of C{EIO} because another process is in
the middle of a call to L{os.rmdir} (implemented in terms of
RemoveDirectory) which is not atomic.
c S r r r r r r r rJ s zGLockingTests.test_lockReleasedDuringAcquireSymlink.<locals>.fakeSymlinkr
N)r% r r r: r< r; rS )r rJ rL r; r r r �%test_lockReleasedDuringAcquireSymlink s
z2LockingTests.test_lockReleasedDuringAcquireSymlinkr+ c C sV dd� }| � td|� | �� }t�|�}t�td�|� | �|�� � | �|j� dS )z�
If the lock is initially held but is released while an attempt
is made to acquire it, the lock attempt fails and
L{FilesystemLock.lock} returns C{False}.
c S r r r, ri r r r rl ) s zILockingTests.test_lockReleasedDuringAcquireReadlink.<locals>.fakeReadlinkr( ro N) r% r r r: r
rd r< r; rS )r rl rL r; r r r �&test_lockReleasedDuringAcquireReadlink s
z3LockingTests.test_lockReleasedDuringAcquireReadlinkc sj � �fdd�}| � td|� | �� }t�td�|� t�|�}| ��|j�}| �|j � � | �
|j � d S )Nc s
�� d ��r r ri �r �
exceptionTyper r rl 8 rK z5LockingTests._readlinkErrorTest.<locals>.fakeReadlinkr( ro ) r% r r r
rd r: r r; r r r< rS )r rv r rl rL r; r r ru r �_readlinkErrorTest7 s
z LockingTests._readlinkErrorTestc C s | � ttj� | � ttj� dS )z�
An exception raised by C{readlink} other than C{ENOENT} is passed up to
the caller of L{FilesystemLock.lock}.
N)rw r r rN r& r6 r r r �test_readlinkErrorG s z LockingTests.test_readlinkErrorc C s | � ttj� | � ttj� dS )z�
Any L{IOError} raised by C{readlink} on a POSIX platform passed to the
caller of L{FilesystemLock.lock}.
On POSIX, unlike on Windows, these are unexpected errors which cannot
be handled by L{FilesystemLock}.
N)rw r& r rN r- r6 r r r �test_readlinkErrorPOSIXO s z$LockingTests.test_readlinkErrorPOSIXc rf ) z�
If a second process cleans up the lock after a first one checks the
lock and finds that no process is holding it, the first process does
not fail when it tries to clean up the lock.
c s �� � t�� � t�| �S r )rh r rg ri �rL � rmlinkPatchr r �
fakeRmlinke s
z?LockingTests.test_lockCleanedUpConcurrently.<locals>.fakeRmlinkrg c S rm rn r[ r] r r r rb n rc z=LockingTests.test_lockCleanedUpConcurrently.<locals>.fakeKillr3 ro Nrp )r r| rb r; r rz r � test_lockCleanedUpConcurrently^ rr z+LockingTests.test_lockCleanedUpConcurrentlyc C s| dd� }| � td|� dd� }| � td|� | �� }t�td�|� t�|�}| �t|j�}| � |j
t
j � | � |j
� dS ) z�
An exception raised by L{rmlink} other than C{ENOENT} is passed up
to the caller of L{FilesystemLock.lock}.
c S r r )r r rN ri r r r r| � r# z1LockingTests.test_rmlinkError.<locals>.fakeRmlinkrg c S rm rn r[ r] r r r rb � rc z/LockingTests.test_rmlinkError.<locals>.fakeKillr3 ro N)r% r r r
rd r: r r r; r r rN r< rS )r r| rb rL r; r r r r �test_rmlinkError} s
z LockingTests.test_rmlinkErrorc C sf dd� }| � td|� | �� }t�td�|� t�|�}| �t|j�}| � |j
t
j � | � |j
� dS )z�
If L{kill} raises an exception other than L{OSError} with errno set to
C{ESRCH}, the exception is passed up to the caller of
L{FilesystemLock.lock}.
c S r r )r r r\ r] r r r rb � r# z-LockingTests.test_killError.<locals>.fakeKillr3 ro N)r% r r r
rd r: r r r; r r r\ r< rS )r rb rL r; r r r r �test_killError� s
zLockingTests.test_killErrorc C s< | � � }t�tt�� d �|� t�|�}| �t|j � dS )z�
L{FilesystemLock.unlock} raises L{ValueError} if called for a lock
which is held by a different process.
� N)
r r r
rd r4 r5 r: r �
ValueErrorrV rT r r r �test_unlockOther� s
z LockingTests.test_unlockOtherc C s\ | � � }| �t�|�� t�|�}| �|�� � | �t�|�� |�� | �t�|�� dS )zp
L{isLocked} returns C{True} if the named lock is currently locked,
C{False} otherwise.
N)r r< r �isLockedr: rQ r; rV rT r r r �
test_isLocked� s
zLockingTests.test_isLockedN)r? r@ rA rM rO r r rC rP rU rW rZ re rq r rs rt rw rx ry r} r~ r r� r� r r r r rF � sF �
�
�
�
rF )rB r r4 �unittestr r �twisted.pythonr �twisted.python.reflectr �twisted.python.runtimer �twisted.trial.unittestr rD rE rC r
rF r r r r �<module> s$ �b