File: //usr/lib/python3/dist-packages/duplicity/__pycache__/path.cpython-310.pyc
o
�wa;r � @ s\ d Z ddlmZ ddlmZ e�� ddlmZ ddlmZ ddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlZddlZddlZddlmZ ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlT dZ da G dd� de�Z G dd� de �Z G dd� de�Z!G dd� de!�Z"G dd � d e"�Z#G d d � d e$�Z%dS ) z�Wrapper class around a file like "/usr/bin/env"
This class makes certain file operations more convenient and
associates stat information with filenames
� )�print_function)�standard_library)�str)�objectN)�
cached_ops)�config)�dup_time)� file_naming)�gpg)�librsync)�log)�tarfile)�util)�*i � c @ s e Zd ZdZdZdS )�
StatResultz3Used to emulate the output of os.stat() and relatedr N)�__name__�
__module__� __qualname__�__doc__�st_mode� r r �0/usr/lib/python3/dist-packages/duplicity/path.pyr ; s r c @ s e Zd ZdS )�
PathExceptionN)r r r r r r r r B s r c @ s� e Zd ZdZd>dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd?d2d3�Zd4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z dS )@�ROPathz�Read only Path
Objects of this class doesn't represent real files, so they don't
have a name. They are required to be indexed though.
Nc C s. d\| _ | _|| _d\| _| _d\| _| _dS )zROPath initializer�NNN)�opened�fileobj�index�stat�type�mode�devnums)�selfr r r r r �__init__M s zROPath.__init__c
C s | j sd| _| j j}t �|�rd| _nAt �|�r d| _n8t �|�r%d| _n/t �|�r.d| _n&t �|�r>tt �
| � � �d ��t � |�rGd| _n
t �
|�rPd | _ntd
��t �|�| _| jd v r�zt�| j j�t�| j j�f| _W dS t�td �t �
| � � �| j jf � d
| _Y dS dS )z4Set the value of self.type, self.mode from self.statN�reg�dir�sym�fifoz is a socket, unsupported by tar�sock�chr�blkz Unknown type)r* r+ z7Warning: %s invalid devnums (0x%X), treating as (0, 0).�r r )r r r �S_ISREG�S_ISDIR�S_ISLNK�S_ISFIFO�S_ISSOCKr r �fsdecode�get_relative_path�S_ISCHR�S_ISBLK�S_IMODEr! �os�major�st_rdev�minorr" r �Warn�_)r# r r r r �
set_from_statT s@
�
�
� �zROPath.set_from_statc C s d\| _ | _dS )z*Black out self - set type and stat to Noner N)r r �r# r r r �blankw s z ROPath.blankc C s | j S )z!True if corresponding file exists�r r> r r r �exists{ s z
ROPath.existsc C �
| j dkS )z(True if self corresponds to regular filer% r@ r> r r r �isreg �
z ROPath.isregc C rB )zTrue if self is dirr& r@ r> r r r �isdir� rD z ROPath.isdirc C rB )zTrue if self is symr' r@ r> r r r �issym� rD z ROPath.issymc C rB )zTrue if self is fifor( r@ r> r r r �isfifo� rD z
ROPath.isfifoc C rB )zTrue is self is socketr) r@ r> r r r �issock� rD z
ROPath.issockc C s | j dkp | j dkS )z True is self is a device filer* r+ r@ r> r r r �isdev� � z ROPath.isdevc C � | j jS )z$Return device number path resides on)r �st_devr> r r r � getdevloc� � zROPath.getdevlocc C rK )z'Return length in bytes from stat object)r �st_sizer> r r r �getsize� rN zROPath.getsizec C s t | jj�S )z"Return mod time of path in seconds)�intr �st_mtimer> r r r �getmtime� � zROPath.getmtimec C s | j r d�| j �S dS )z(Return relative path, created from index� /� .)r �joinr> r r r r3 � s zROPath.get_relative_pathc C s | j }d|j|j| jf S )z(Return permissions mode, owner and groupz%s:%s %o)r �st_uid�st_gidr! )r# �s1r r r �getperms� s zROPath.getpermsc C s6 |dkr
| j r
| jrJ d|| j | jf ��d| _| j S )z#Return fileobj associated with self�rbz%s %s %sr �r r �r# r! r r r �open� s
�z ROPath.openc C s" | � d�}|�� }|�� rJ �|S )z/Return contents of associated fileobj in stringr\ )r_ �read�close)r# �fin�bufr r r �get_data� s
zROPath.get_datac C s | j rJ �|| _ d| _dS )z"Set file object returned by open()Nr] )r# r r r r �
setfileobj� s
zROPath.setfileobjc C s� |j }|tjks
|tjkrd| _ n]|tjkrtd��|tjkr5d| _ |j| _t | jdj
�r4t � | j�| _n9|tj
krEd| _ |j|jf| _n)|tjkrUd| _ |j|jf| _n|tjkr^d| _ n|tjkrgd| _ ntd |f ��|j| _t� | _ ztjr}t�t�|j �d
| j_ W n ty� |j | j_ Y nw ztjr�t�t� |j �d
| j_!W n ty� |j"| j_!Y nw t#|j$�| j_%| jj%d k r�t&�'t(d �|j) � d | j_%|j*| j_+d
S )z5Set data from tarinfo object (part of tarfile module)r% z Hard links not supported yetr' � r* r+ r& r( zUnknown tarinfo type %s� r �.Warning: %s has negative mtime, treating as 0.N),r r
�REGTYPE�AREGTYPE�LNKTYPEr �SYMTYPE�linkname�symtext�
isinstance� __class__r �fsencode�CHRTYPE�devmajor�devminorr" �BLKTYPE�DIRTYPE�FIFOTYPEr! r r r �
numeric_owner�KeyErrorr �getpwnam�unamerX �uid�getgrnam�gnamerY �gidrQ �mtimerR r r; r< �uc_name�sizerO )r# �tarinfor r r r �init_from_tarinfo� s\
�
� �
�zROPath.init_from_tarinfoc C sV t | j| j�}| j| j|_|_| �� r| j|_n| �� r!| j|_| � � r)| j|_|S )zReturn ropath copy of self)
r r r r r! rF rn rI r" rA )r# �
new_ropathr r r �
get_ropath� s
zROPath.get_ropathc C s
t �� }| jrt�d�| j��|_nd|_| �� r | jd7 _d|_| j r�| �
� r4t j |_ | j j
|_nO| �� r=t j|_ nF| �� rFt j|_ n=| �� r`t j|_ | j|_t|jt�r_t�|j�|_n#| �� rz| j dkrnt j|_ nt j|_ | j\|_|_ n t dt | j � ��| j |_ | j j | j j!|_"|_#| j j$dk r�t%�&t'd�t�| �(� � � d|_)nt*| j j$�|_)z t+�,|j"�d |_-W n t.y� d|_-Y nw z t+�/|j#�d |_0W n t.y� d|_0Y nw |j t jt jfv r�t1t2d �r�t1t2d
�r�| j\|_|_ |S d \|_ |_|S ) z�Generate a tarfile.TarInfo object based on self
Doesn't set size based on stat, because we may want to replace
data wiht other stream. Size should be set separately by
calling function.
rU �.�/r r* zUnrecognized type rh rf r8 r: r, )3r
�TarInfor r r2 rW �namerE r� r rC ri r rO rv rG rw rF rl rn rm ro �bytesrI rr ru r" rs rt r r r! rX rY r| r rR r r; r< r3 r� rQ r �getpwuidr{ ry �getgrgidr~ �hasattrr7 )r# �tir r r � get_tarinfo sf
�
�
�
� �zROPath.get_tarinfoc C s� | j s|j sdS | js|js|js| jrdS | j |j kr dS | �� s*| �� s*| �� rK| �|�s1dS t| jj�t|jj�kr?dS | jjdkoJ|jjdkS | �� rU| j |j kS | �
� rd| �|�oc| j |j kS J �)z6Used to compare two ROPaths. Doesn't look at fileobjsr r ) r r rC rE rG � perms_equalrQ rR rF rn rI r" �r# �otherr r r �__eq__K s"
z
ROPath.__eq__c C s | � |� S �N)r� r� r r r �__ne__d � z
ROPath.__ne__r c s
� fdd�}|du r dS � j s|j sdS � js"|jr"|td�� dS |js0� jr0|td�� dS � j |j krD|td �|j � j f � dS � �� sP� �� sP� �� r�� �|�se|td
�|�� � �� f � dS t� jj �t|jj �kr�� jj dks}|jj dkr�|td �t
� t|jj ��t
� t� jj ��f � dS � �� r�� � |�r�dS |td �� dS dS � �
� r҈ j|jks jt�tj� |jkr�dS |td
�|j� jf � dS � �� �r� �|�s�|td
�|�� � �� f � dS � j|jk�r|td�|j� jf � dS dS J �)a' Compare ROPaths like __eq__, but log reason if different
This is placed in a separate function from __eq__ because
__eq__ should be very time sensitive, and logging statements
would slow it down. Used when verifying.
Only run if include_data is true.
c s, t d�d | }t�|t�� �� � � d S )NzDifference found:� )r< r �Noticer r2 r3 )�
log_string�log_strr> r r �log_diffq s z(ROPath.compare_verbose.<locals>.log_diffFTr z New file %sr zFile %s is missingz!File %%s has type %s, expected %sz(File %%s has permissions %s, expected %sz"File %%s has mtime %s, expected %sz Data for file %s is differentz%Symlink %%s points to %s, expected %sz+Device file %%s has numbers %s, expected %s)r r r< rC rE rG r� r[ rQ rR r � timetopretty� compare_datarF rn r rq r7 �seprI r" )r# r� � include_datar� r r> r �compare_verboseg sp
�
���
$
�
�
�zROPath.compare_verbosec sZ | � d�� |� d��� �fdd�} � �t�}��t�}||kr%|� dS |s,|� dS q)z8Compare data from two regular files, return true if samer\ c s � � � rJ ��� � r J �d S r� )ra r ��f1�f2r r ra � s z"ROPath.compare_data.<locals>.closer r )r_ r` �_copy_blocksize)r# r� ra �buf1�buf2r r� r r� � s
�zROPath.compare_datac C s2 | j |j }}| j|jko|j|jko|j|jkS )z:True if self and other have same permissions and ownership)r r! rY rX )r# r� rZ �s2r r r r� � s
�
�zROPath.perms_equalc C s� | � � r
|�| �d�� n^| �� rt�|j� nS| �� r9t�| j |j� t
j s3t� |j| j
j| j
j� |�� dS | �� rDt�|j� n'| �� rSt�tj��|j� n| �� rk| jdkr_d}nd}|j|g| j�R � | �|� dS )z:Copy self to other. Also copies data. Other must be Pathr\ Nr* �c�b) rC � writefileobjr_ rE r7 �mkdirr� rF �symlinkrn r �do_not_restore_ownership�lchownr rX rY �setdatarG �mkfiforH �socket�AF_UNIX�bindrI r �makedevr" � copy_attribs)r# r� �devtyper r r �copy� s(
z ROPath.copyc s� t � t�r3��� s-�jrtjst�� �fdd�� t�� �fdd�� t�� �fdd�� � �� dS t � t �s:J �t
� }�jj �jj |_ |_ t
�jj�|_|� _�j� _dS )z'Only copy attributes from self to otherc s t �� j�jj�jj�S r� )r7 �chownr� r rX rY r �r� r# r r �<lambda>� s z%ROPath.copy_attribs.<locals>.<lambda>c s t �� j�j�S r� )r7 �chmodr� r! r r� r r r� � s c s t �� jt�� �jjf�S r� )r7 �utimer� �timer rR r r� r r r� � s N)ro �PathrF r r r� r �maybe_ignore_errorsr� r r rX rY rQ rR r! )r# r� r r r� r r� � s
zROPath.copy_attribsc C s dt �| j�| jf S )� Return string representationz(%s %s))r �uindexr r r> r r r �__str__� s zROPath.__str__r� )r )!r r r r r$ r= r? rA rC rE rF rG rH rI rM rP rS r3 r[ r_ rd re r� r� r� r� r� r� r� r� r� r� r� r r r r r F s>
#7 E
D r c @ s� e Zd ZdZe�d�Zdd� Zd<dd�Zdd � Z d
d � Z
d d
� Z dd� Z dd� Z
dd� Zd=dd�Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd>d0d1�Z d2d3� Z d>d4d5�Z d6d7� Z d8d9� Z d:d;� Z!d/S )?r� z�
Path class - wrapper around ordinary local files
Besides caching stat() results, this class organizes various file
code.
z [\\\"\$`]c C s� t jr|s|S tj�tjj|� �}g }|r/|t jvr/tj�|�\}}|�d|� |r/|t jvs|r?t j| �t� tj
��| S |S )Nr ) r �renamer7 �path�normcaserW �split�insertr rq r� )r# r r� �tail�extrar r r � rename_index� s
� zPath.rename_indexr c C sd d\| _ | _t|t�rt�|�}|| _| �|�| _t j
j |g| j�R � | _ t�
| j �| _| �� dS )zPath initializerr N)r r ro r r rq �baser� r r7 r� rW r� r2 r� r� )r# r� r r r r r$ s
z
Path.__init__c
C s� zt jr t�| j�| _nt�| j�| _W n( ty< } z tj|j }|dv r0d\| _| _ d| _
n� W Y d}~dS d}~ww | � � | � � rNt�
| j�| _dS dS )zRefresh stat cache)�ENOENT�ENOTDIR�ELOOP�ENOTCONN�ENODEVr N)r �
copy_linksr7 r r� �lstat�OSError�errno� errorcoder r! r= rF �readlinkrn )r# �e�
err_stringr r r r� s$ � ����z Path.setdatac C s, t |dj�r t�|�}| �| j| j|f �S )z'Return new Path with ext added to indexrf )ro rp r rq r� r )r# �extr r r �append4 s
z Path.appendc C s | � | j|�S )z Return new Path with index index)rp r� )r# r r r r � new_index: s zPath.new_indexc C s t �| j�S )z#Return list generated by os.listdir)r7 �listdirr� r> r r r r� > rT z Path.listdirc C s | � � o| �� S )z/Return true if path is a directory and is empty)rE r� r> r r r �
isemptydirB s zPath.isemptydirc C s* t |dj�r t�|�}| �� o|| �� v S )z5Return true if path is a directory and contains childrf )ro rp r rq rE r� )r# �childr r r �containsF s
z
Path.containsr\ c C s* | j rJ �| jr
| j}|S t| j|�}|S )z�
Return fileobj associated with self
Usually this is just the file data on disk, but can be
replaced with arbitrary data using the setfileobj method.
)r r r_ r� )r# r! �resultr r r r_ N s
�z Path.openc C sD d| j |t|�t|�g}t�tjd|�dkr td| ��| �� dS )z8Make a device file with specified type, major/minor nums�mknodr zError running %sN)r� r r7 �spawnvp�P_WAITr r� )r# r r8 r: �cmdlistr r r r� \ s z Path.makedevc C sZ t �td�| j � zt�| j� W n ty& tj s$t
d| j d��Y nw | � � dS )z#Make directory(s) at specified pathzMaking directory %szError creating directory %s� N) r �Infor< r� r7 �makedirsr� r� r �forcer r� r> r r r r� c s �� z
Path.mkdirc C sJ t �td�| j � | �� rt�tj| j � nt�tj
| j � | � � dS )zRemove this filez Deleting %sN) r r� r< r� rE r �ignore_missingr7 �rmdirr� �unlinkr� r> r r r �deletem s
z Path.deletec C s* t �td�| j � | �d�}|�� dS )z#Open the file, write 0 bytes, closez Touching %s�wbN)r r� r< r� r_ ra )r# �fpr r r �touchv s
z
Path.touchc C s^ ddl m} t�td�| j � ttg �}|�| �� � D ]}||j
|� q |� � | � � dS )z2Remove self by recursively deleting files under itr �� selectionzDeleting tree %sN)
� duplicityr� r r� r< r� �IterTreeReducer� PathDeleter�Select�set_iterr �Finishr� )r# r� �itrr� r r r �deltree| s
z Path.deltreec C sZ | j rt| j| j dd� �S | j�d�}t|�dkr"|d s"td�S td�|dd� ��S )z Return directory that self is inN���rU rg r )r r� r� r� �lenrW �r# �
componentsr r r �get_parent_dir� s zPath.get_parent_dirc C sL | � d�} |�t�}|sn|�|� q|�� s |�� r td��| �� dS )z4Copy file object fin to self. Close both when done.r� r zError closing file objectN)r_ r` r� �writera r r� )r# rb �foutrc r r r r� � s
� zPath.writefileobjc C s$ t �| j|j� | �� |�� dS )z(Rename file at current path to new_path.N)�shutil�mover� r� �r# �new_pathr r r r� � s z Path.renamec C s | � |� | �� dS )z;Like rename but destination may be on different file systemN)r� r� r r r r r � s
z Path.movec C s t �| j|� | �� dS )z Change permissions of the pathN)r7 r� r� r� r^ r r r r� � s z
Path.chmodc C sv | � � r|� � s
J �| �� }| �d�}|�d�}t�||�}|�|� |�� r)J �|�� r/J �|�|� |�| � dS )z2Patch self with diff and then copy attributes overr\ N) rC �get_temp_in_same_dirr_ r � PatchedFiler� ra r� r� )r# � diff_ropath� temp_path�fbase�fdiff�
patch_fileobjr r r �patch_with_attribs� s
zPath.patch_with_attribsc C sF | � � } |�dtt� �}|js|S td7 atdk s"J d| j ��q)z7Return temp non existent path in same directory as selfr zduplicity_temp.i' z(Warning too many temp files created for )r� r� r �_tmp_path_counterr r� )r# �
parent_dirr r r r r � s �
��zPath.get_temp_in_same_dirNc C s6 ddl m} |�| ��� }|�|��� }t�|||�S )z7Compare self to other Path, descending down directoriesr r� )r� r� r� r� �Iter�equal)r# r� �verboser� �selfsel�otherselr r r �compare_recursive� s zPath.compare_recursivec C s d| j | j| jf S )r� z
(%s %s %s))r r� r r> r r r �__repr__� rJ z
Path.__repr__c C s |s| j }d| j�dd� |� S )z�
Return quoted version of s (defaults to self.name)
The output is meant to be interpreted with shells, so can be
used with os.system.
z"%s"c S s d| � d� S )N�\r )�group)�mr r r r� � s z Path.quote.<locals>.<lambda>)r� �regex_chars_to_quote�sub)r# �sr r r �quote� s z
Path.quotec C s� |d |d krdksJ � J �d}d}|t |�d k rC|| dkr1|||d 7 }|d7 }n
||| 7 }|d7 }|t |�d k s |S )z?Return unquoted version of string s, as quoted by above quote()r r� �"rf r r rg )r� )r# r r� �ir r r �unquote� s $
�z Path.unquotec C s$ | j �d�}|r |d sJ �|d S )z!Return filename of last componentrU r� )r� r� r� r r r � get_filename� s zPath.get_filenamec C s> d� dd� | j�d�D ��}| jd dkrd| S |r |S dS )z�
Return string of canonical version of path
Remove ".", and trailing slashes where possible. Note that
it's harder to remove "..", as "foo/bar/.." is not necessarily
"foo", so we can't use path.normpath()
rU c S s g | ]
}|r|d kr|�qS )rV r )�.0�xr r r �
<listcomp>� s z&Path.get_canonical.<locals>.<listcomp>r r� rV )rW r� r� r� )r# �newpathr r r �
get_canonical� s zPath.get_canonical)r )r\ r� )"r r r r �re�compiler r� r$ r� r� r� r� r� r� r_ r� r� r� r� r� r� r� r� r r� r
r r r r r r! r& r r r r r� � s<
r� c @ s$ e Zd ZdZd dd�Zd
dd�ZdS ) �DupPathz�
Represent duplicity data files
Based on the file name, files that are compressed or encrypted
will have different open() methods.
r Nc C sL |r|| _ nt|�dksJ �t�|d �| _ | j s J d��t�| ||� dS )z�
DupPath initializer
The actual filename (no directory) must be the single element
of the index, unless parseresults is given.
r r z%must be a recognizable duplicity fileN)�prr� r �parser� r$ )r# r� r � parseresultsr r r r$ s zDupPath.__init__r\ c C s� | j s| jrJ �| jjr| jjrJ �|r| jjsJ �| jjr%t�| j|�S | jjrF|s.tj }|dkr9t
� d| |�S |dkrDt
� d| |�S dS | � |�S )z�
Return fileobj with appropriate encryption/compression
If encryption is specified but no gpg_profile, use
config.default_profile.
r\ Fr� TN)
r r r* � encrypted�
compressed�gzip�GzipFiler� r � gpg_profiler
�GPGFiler_ )r# r! r1 r r r �
filtered_open s �
zDupPath.filtered_open)r N)r\ N)r r r r r$ r3 r r r r r) s
r) c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) r� z+Delete a directory. Called by Path.deltreec C s
|| _ d S r� )r� �r# r r� r r r �
start_process5 �
zPathDeleter.start_processc C s | j �� d S r� )r� r� r> r r r � end_process8 s zPathDeleter.end_processc C s
|� � S r� )rE r4 r r r �can_fast_process; r6 z PathDeleter.can_fast_processc C s |� � d S r� )r� r4 r r r � fast_process> r� zPathDeleter.fast_processN)r r r r r5 r7 r8 r9 r r r r r� 3 s r� )&r �
__future__r �futurer �install_aliases�builtinsr r r� r/ r7 r' r r� r r� r� r r r r r
r r r
r �duplicity.lazyr� r r � Exceptionr r r� r) � ITRBranchr� r r r r �<module> sJ 0 1