Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
util
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: osutil.cpython-310.pyc
o �$�a, � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddlm Z ddl m Z m Z mZmZmZmZ ddlmZ zddlm Z W n eyS dZY nw dZded efd d �Zd ed efd d�Zdeded efdd�Zded dfdd�Z dee ded ee fdd�Z deded dfd d �Z deded dfd d �Z deded dfd d!�Z!e�"d"�Z#e�"d#�Z$d$ed efd%d&�Z%d'ed efd(d)�Z&ej'fded*ed efd+d,�Z(e(Z)e�*� p�e�+� Z,d-ed efd.d/�Z-ej.d0ed e d1 fd2d3��Z/G d4d5� d5�Z0ded dfd6d7�Z1dS )8z� sphinx.util.osutil ~~~~~~~~~~~~~~~~~~ Operating system-related utility functions for Sphinx. :copyright: Copyright 2007-2021 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 �4/usr/lib/python3/dist-packages/sphinx/util/osutil.py�os_path' s r � nativepathc C s | � tjt�S )z"Return path in OS-independent form)r r r r )r r r r � canon_path+ s r �base�toc C s� |� t�r|S | �d�d �t�}|�d�d �t�}t|dd� |dd� �D ]\}}||kr2 n |�d� |�d� q(||krCdS t|�dkrR|dgkrRdt 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 c C s t j| dd� dS )zEnsure that a path exists.T)�exist_okN)�os�makedirsr r r r � ensuredirG s r- �dirnames�suffixc c sf � | D ]-}t �|�D ]%\}}}|D ] }|�|�r.z t�t�||��V W q ty- Y qw qq qd S r )r+ �walk�endswithr �getmtimer$ �OSError)r. r/ �dirname�root�dirs�files�sfiler r r �mtimes_of_filesL s � �����r9 �source�destc C sN t jdtdd� tj�|�r zt�|� W n ty Y nw 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�unlinkr3 �rename�r: r; r r r �movefileW s � �rD c C s0 t �| �}tt d�rt �||j|jf� dS dS )z!Copy a file's modification times.�utimeN)r+ �stat�hasattrrE �st_atime�st_mtime)r: r; �str r r � copytimesd s �rK c C sL t �|�r t�| |�s$t�| |� zt| |� W dS ty# Y dS w 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�copyfilerK r3 rC r r r rO k s ��rO z[^a-zA-Z0-9_-]z Documentation$�stringc C s t �d| �pdS )Nr �sphinx)�no_fn_re�sub)rP r r r � make_filename| s rT �projectc C s t t�d| ���� S )Nr )rT �project_suffix_rerS �lower)rU r r r �make_filename_from_project� s rX �startc C s( zt j�| |�W S ty | Y S w )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). )r+ r �relpath� ValueError)r rY r r r rZ � s �rZ �pathdirc C sj t d ur t| t �r | �� S t�| �} t| t�r3z| �t�} W | S ty2 } ztdt �|�d }~ww | S )NzAmultibyte filename not supported on this filesystem encoding (%r))�Path� isinstance�abspathr �bytes�decode� fs_encoding�UnicodeDecodeError)r\ �excr r r r_ � s �����r_ � target_dir)NNNc c s8 � t �� }zt �| � d V W t �|� d S t �|� w r )r+ �getcwd�chdir)re �cwdr r r �cd� s � ri c @ sx e Zd ZdZdeddfdd�Zdeddfdd �Zdd d �Zdd d �Zde e de de de fdd�Z dede fdd�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. r r Nc C s || _ d | _d S r )�_path�_io)�selfr r r r �__init__� s zFileAvoidWrite.__init__�datac C s | j st� | _ | j �|� d S r )rl r �write)rm ro r r r rp � s zFileAvoidWrite.writec C s� | j std��| �� }| j �� z+t| jdd��}|�� }||kr+ W d � W dS W d � n1 s5w Y W n tyD Y nw t| jddd��}|�|� W d � dS 1 s^w Y dS )z0Stop accepting writes and write file, if needed.z,FileAvoidWrite does not support empty files.zutf-8)�encodingN�w) rl � Exception�getvalue�close�openrk �readr3 rp )rm �buf�old_f� old_content�fr r r ru � s& � �� � "�zFileAvoidWrite.closec C s | S r r )rm r r r � __enter__� s zFileAvoidWrite.__enter__�exc_type� exc_value� tracebackc C s | � � dS )NT)ru )rm r} r~ r r r r �__exit__� s zFileAvoidWrite.__exit__�namec C s | j std��t| j |�S )Nz=Must write to FileAvoidWrite before other methods can be used)rl rs �getattr)rm r� r r r � __getattr__� s zFileAvoidWrite.__getattr__)r N)r rj )�__name__� __module__� __qualname__�__doc__�strrn rp ru r| r rs r �boolr� r� r r r r rj � s rj c C s( t j�| �r t�| � d S t �| � d S r )r+ r �isdirrN �rmtree�remover r r r r� � s r� )2r� � contextlibrL r+ �rerN �sysr> �ior r �typingr r r r r r �sphinx.deprecationr �sphinx.testing.pathr] � ImportErrorr r� r r r) r- �floatr9 rD rK rO �compilerR rV rT rX �curdirrZ � safe_relpath�getfilesystemencoding�getdefaultencodingrb r_ �contextmanagerri rj r� r r r r �<module> sL � 8
Save
Cancel