vz'TempDirectory.atexit..I s$ !@!@Q!&!@!@!@!@!@!@r ) instanceswarningswarnjoin)clss r atexitzTempDirectory.atexitD s_ = M !@!@#-!@!@!@@@B
r returnc | j r| S t | _ | j | | j j s%t
j | j d| j _ | S )zt
Create a temporary directory for this instance to use if one
has not already been created.
T)r r r' add __class__ atexit_setupr, registerr s r r zTempDirectory.createL sb
9 KII 4 ~* / ODK ( ( (*.DN ' r c | j rAt j | j r | j st | j | ` | | j v r | j | dS dS )z
Delete the temporary directory and anything in it.
This :class:`TempDirectory` cannot be used again unless
:meth:`create` is called.
N)r osexistsr r r' remover3 s r cleanupzTempDirectory.cleanupZ su 9 22 4;K 49 4> ! ! N ! !$ ' ' ' ' ' " !r c \ t | j D ]}| dS )zn
Delete all temporary directories associated with all
:class:`TempDirectory` objects.
N)tupler' r8 )r+ r% s r cleanup_allzTempDirectory.cleanup_allf s6 s}%% A
IIKKKK r recursive
files_only followlinksc |r| | n| j }g }|rt j || D ]\ }}}d |t | dz d t j }|r|dz
}|D ] } |s| || z dz t | D ]}
| ||
z n,t j
| D ]} | | g } t | D ]?}d}
| j D ]}| | rd}
n |
r*| | @| S )N)r> /r
FT)
_joinr r5 walkr* lensplitsepr sortedlistdirr search)r r r< r= r> resultdirpathdirnames filenamesdirnamenamenfilteredr r s r actualzTempDirectory.actualo s $(6tzz$ TY !02k1 1 1
0
0,9 ((73t99Q;<<#8#>#>rv#F#FGG #sNG ' ; ;G% ;
ggoc&9::: "9 - - 0 0DMM'$,////0
0 Z%%
!
!
a 6NN " "DF
<<%% !FE
OOD ! ! ! !r c | | || }|st d |D ]}t | dS )a
Print the contents of the specified directory.
:param path: The path to list, which can be:
* `None`, indicating the root of the temporary
directory should be listed.
* A tuple of strings, indicating that the
elements of the tuple should be used as directory
names to traverse from the root of the
temporary directory to find the directory to be
listed.
* A forward-slash separated string, indicating
the directory or subdirectory that should be
traversed to from the temporary directory and
listed.
:param recursive: If `True`, the directory specified will have
its subdirectories recursively listed too.
z No files or directories found.N)rQ print)r r r< rQ rO s r rG zTempDirectory.listdir sT . T9-- 4 2 3 3 3 A !HHHH r Texpectedc d}t t | t | |||| d dS )a
Compare the expected contents with the actual contents of the temporary
directory. An :class:`AssertionError` will be raised if they are not the
same.
:param expected: A sequence of strings containing the paths
expected in the directory. These paths should
be forward-slash separated and relative to
the root of the temporary directory.
:param path: The path to use as the root for the comparison,
relative to the root of the temporary directory.
This can either be:
* A tuple of strings, making up the relative path.
* A forward-slash separated string.
If it is not provided, the root of the temporary
directory will be used.
:param files_only: If specified, directories will be excluded from
the list of actual paths used in the comparison.
:param recursive: If ``False``, only the direct contents of
the directory specified by ``path`` will be included
in the actual contents used for comparison.
:param followlinks: If ``True``, symlinks and hard links
will be followed when recursively building up
the actual list of directory contents.
TF)rT rQ r< N)r rF r: rQ )r rT r r= r< r> __tracebackhide__s r r zTempDirectory.compare sa R !)) T[[)Z ! ! ! ! ! !r c t |t r| d }t j | t j }| t j r+| | j r|S t d t j | j | S )Nr@ z8Attempt to read or write outside the temporary Directory)
isinstancer rD r5 rE r* rstrip
startswithr
ValueError)r rN relatives r rA zTempDirectory._join s dC #::c??D6;;t$$++BF33 rv & & ""49--
J
w||DIx000r rJ c X | | }t j | |S )a
Make an empty directory at the specified path within the
temporary directory. Any intermediate subdirectories that do
not exist will also be created.
:param dirpath: The directory to create, which can be:
* A tuple of strings.
* A forward-slash separated string.
:returns: The absolute path of the created directory.
)rA r5 makedirs)r rJ thepaths r makedirzTempDirectory.makedir s* **W%%
G r filepathdatac t |t r| d }t | dk rP| |dd }t
j | st j | | | }|p| j }||
| }t |d 5 }| | ddd n # 1 swxY w Y |S )a
Write the supplied data to a file at the specified path within
the temporary directory. Any subdirectories specified that do
not exist will also be created.
The file will always be written in binary mode. The data supplied must
either be bytes or an encoding must be supplied to convert the string
into bytes.
:param filepath: The path to the file to create, which can be:
* A tuple of strings.
* A forward-slash separated string.
:param data:
:class:`bytes` containing the data to be written, or a :class:`str`
if ``encoding`` has been supplied.
:param encoding: The encoding to be used if data is not bytes. Should
not be passed if data is already bytes.
:returns: The absolute path of the file written.
r@ r
Nwb)
rX r rD rC rA r5 r r6 r^ r encodeopenwrite)r ra rb r rJ r_ fs r rh zTempDirectory.write s! 4 h $ $ + ~~c**H x==1 jj#2# //G7>>'**
% G$$$**X&&,t} ;;x((D
'4
A
GGDMMM s C55C9<C9c > || j n| | S )ao
Return the full path on disk that corresponds to the path
relative to the temporary directory that is passed in.
:param path: The path to the file to create, which can be:
* A tuple of strings.
* A forward-slash separated string.
:returns: A string containing the absolute path.
)r rA r r s r as_stringzTempDirectory.as_string, s !Ltyydjj.>.>>r c X t || j n| | S )a9
Return the :class:`~pathlib.Path` that corresponds to the path
relative to the temporary directory that is passed in.
:param path: The path to the file to create, which can be:
* A tuple of strings.
* A forward-slash separated string.
)r r rA rk s r as_pathzTempDirectory.as_pathA s( DII4::d3C3CDDDr c \ ddl m} ||| j n| | S )a9
Return the :class:`py.path.local` that corresponds to the path
relative to the temporary directory that is passed in.
:param path: The path to the file to create, which can be:
* A tuple of strings.
* A forward-slash separated string.
r )local)py.pathrp r rA )r r rp s r as_localzTempDirectory.as_localN s< "!!!!!u$,TYYDJJt4D4DEEEr c t | | d 5 }| }ddd n # 1 swxY w Y |p| j }|| | S |S )a
Reads the file at the specified path within the temporary
directory.
The file is always read in binary mode. Bytes will be returned unless
an encoding is supplied, in which case a unicode string of the decoded
data will be returned.
:param filepath: The path to the file to read, which can be:
* A tuple of strings.
* A forward-slash separated string.
:param encoding: The encoding used to decode the data in the file.
:returns:
The contents of the file as a :class:`str` or :class:`bytes`, if ``encoding``
is not specified.
rbN)rg rA readr decode)r ra r ri rb s r ru zTempDirectory.read\ s , $**X&&
-
- 6688D ,t} ;;x(( ( s AA A c | S r r r3 s r __enter__zTempDirectory.__enter__y s r c . | d S r )r8 )r typevalue tracebacks r __exit__zTempDirectory.__exit__| s r r )r- r )r- N)NFFF)NF)NFTF)"__name__
__module__ __qualname____doc__setr' r1 r r r r r r r classmethodr, r r8 r; PathStringsrQ rG r rA r` bytesrh rl getpathrn rr ru rx r} r r r r r s% * IL D 7; %'
T?23 SM
" [
(
(
(
( [ !% # $ % & & & & &
& & & &P K 4 @ !% $ " %
/! /! sm/! /! /!
/!
/! /! /! /!b 1 1 1{ $& &k &ucz1B &c & & & &P? ?eC# $6 7 ?3 ? ? ? ?& G E EK E4 E E E E F F[ FO F F F F [ C 5PSCT : r r r- c X d|d< t | i |}t |j |j S )z
A decorator for making a :class:`TempDirectory` available for the
duration of a test function.
All arguments and parameters are passed through to the
:class:`TempDirectory` constructor.
Fr )r r r r8 )argskwls r tempdirr s3 BxLt"r""A !) $ $$r )r, r5 r( pathlibr rer tempfiler typingr r r r r
testfixtures.comparisonr testfixtures.utilsr r r r rq pyr r r r r r s?
B B B B B B B B B B B B B B + + + + + + # # # # # # CsO$ NNNf f f f f f f fR
%HhZ%9 :
%
%
%
%
%
%r