| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/util/__pycache__/ |
Upload File : |
a
�ab- � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddlm
Z
ddl m Z m
Z
mZmZmZmZ ddlmZ zddlm
Z W n ey� dZY n0 dZeed�d d
�Zeed �d d
�Zeeed�dd�Zedd�dd�Z ee eee d�dd�Z eedd�dd�Z eedd�dd�Z eedd�d d �Z!e�"d �Z#e�"d �Z$eed �d!d"�Z%eed#�d$d%�Z&ej'feeed&�d'd(�Z(e(Z)e�*� �p�e�+� Z,eed)�d*d+�Z-ej.ee
d, d-�d.d/��Z/G d0d1� d1�Z0edd�d2d3�Z1dS )4z�
sphinx.util.osutil
~~~~~~~~~~~~~~~~~~
Operating system-related utility functions for Sphinx.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�StringIO��path)�Any� Generator�Iterator�List�Optional�Type)�RemovedInSphinx50Warning�/)�
canonicalpath�returnc C s | � ttj�S �N)�replace�SEPr �sep)r
� r �6/usr/lib/python3.9/site-packages/sphinx/util/osutil.py�os_path' s r )�
nativepathr c C s | � tjt�S )z"Return path in OS-independent form)r r r r )r r r r �
canon_path+ s r )�base�tor c C s� |� t�r|S | �d�d �t�}|�d�d �t�}t|dd� |dd� �D ](\}}||krd qz|�d� |�d� qP||kr�dS t|�dkr�|dgkr�dt S dt t|�d t�|� S ) z.Return a relative URL from ``base`` to ``to``.�#r N���� � �.z..)�
startswithr �split�zip�pop�len�join)r r �b2�t2�x�yr r r � relative_uri0 s
"
r) �r r c C s t j| dd� dS )zEnsure that a path exists.T)�exist_okN)�os�makedirsr r r r � ensuredirG s r. )�dirnames�suffixr c c sd | D ]Z}t �|�D ]J\}}}|D ]:}|�|�r zt�t�||��V W q tyX Y q 0 q qqd S r )r, �walk�endswithr �getmtimer$ �OSError)r/ r0 �dirname�rootZ_dirs�filesZsfiler r r �mtimes_of_filesL s
r8 )�source�destr c C sN t jdtdd� tj�|�r>zt�|� W n ty< Y n0 t�| |� dS )z3Move a file, removing the destination if it exists.zYsphinx.util.osutil.movefile() is deprecated for removal. Please use os.replace() instead.� )�
stacklevelN) �warnings�warnr r, r �exists�unlinkr4 �rename�r9 r: r r r �movefileW s � rC c C s, t �| �}tt d�r(t �||j|jf� dS )z!Copy a file's modification times.�utimeN)r, �stat�hasattrrD �st_atime�st_mtime)r9 r: �str r r � copytimesd s
rJ c C sH t �|�rt�| |�sDt�| |� zt| |� W n tyB Y n0 dS )z{Copy a file and its modification times, if possible.
Note: ``copyfile`` skips copying if the file has not been changedN)r r? �filecmp�cmp�shutil�copyfilerJ r4 rB r r r rN k s rN z[^a-zA-Z0-9_-]z Documentation$)�stringr c C s t �d| �pdS )Nr Zsphinx)�no_fn_re�sub)rO r r r �
make_filename| s rR )�projectr c C s t t�d| ���� S )Nr )rR �project_suffix_rerQ �lower)rS r r r �make_filename_from_project� s rV )r �startr c C s, zt j�| |�W S ty& | Y S 0 dS )a Return a relative filepath to *path* either from the current directory or
from an optional *start* directory.
This is an alternative of ``os.path.relpath()``. This returns original path
if *path* and *start* are on different drives (for Windows platform).
N)r, r �relpath�
ValueError)r rW r r r rX � s rX )�pathdirr c
C sx t d urt| t �r| �� S t�| �} t| t�rpz| �t�} W n2 tyn } ztdt �|�W Y d }~n
d }~0 0 | S d S )NzAmultibyte filename not supported on this filesystem encoding (%r))�Path�
isinstance�abspathr �bytes�decode� fs_encoding�UnicodeDecodeError)rZ �excr r r r] � s
��r] )NNN)�
target_dirr c c s8 t �� }z t �| � d V W t �|� n t �|� 0 d S r )r, �getcwd�chdir)rc �cwdr r r �cd� s
rg c @ st e Zd ZdZedd�dd�Zedd�dd�Zdd �d
d �Zd d �d d
�Ze e
e
e e d�dd�Z
ee d�dd�ZdS )�FileAvoidWritea� File-like object that buffers output and only writes if content changed.
Use this class like when writing to a file to avoid touching the original
file if the content hasn't changed. This is useful in scenarios where file
mtime is used to invalidate caches or trigger new behavior.
When writing to this file handle, all writes are buffered until the object
is closed.
Objects can be used as context managers.
Nr* c C s || _ d | _d S r )�_path�_io)�selfr r r r �__init__� s zFileAvoidWrite.__init__)�datar c C s | j st� | _ | j �|� d S r )rj r �write)rk rm r r r rn � s zFileAvoidWrite.write)r c C s� | j std��| �� }| j �� zTt| jdd��2}|�� }||krTW d � W dS W d � n1 sh0 Y W n ty� Y n0 t| jddd��}|�|� W d � n1 s�0 Y dS )z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)�encodingN�w) rj � Exception�getvalue�close�openri �readr4 rn )rk �bufZold_fZ old_content�fr r r rs � s
4 zFileAvoidWrite.closec C s | S r r )rk r r r � __enter__� s zFileAvoidWrite.__enter__)�exc_type� exc_value� tracebackr c C s | � � dS )NT)rs )rk ry rz r{ r r r �__exit__� s zFileAvoidWrite.__exit__)�namer c C s | j std��t| j |�S )Nz=Must write to FileAvoidWrite before other methods can be used)rj rq �getattr)rk r} r r r � __getattr__� s zFileAvoidWrite.__getattr__)�__name__�
__module__� __qualname__�__doc__�strrl rn rs rx r
rq r �boolr| r r r r r rh � s rh c C s& t j�| �rt�| � n
t �| � d S r )r, r �isdirrM �rmtree�remover r r r r� � s r� )2r� �
contextlibrK r, �rerM �sysr= �ior r �typingr r r r r r
Zsphinx.deprecationr Zsphinx.testing.pathr[ � ImportErrorr r� r r r) r. �floatr8 rC rJ rN �compilerP rT rR rV �curdirrX Z safe_relpath�getfilesystemencoding�getdefaultencodingr` r] �contextmanagerrg rh r� r r r r �<module> sH
8