File: //usr/lib/python3/dist-packages/sphinx/__pycache__/project.cpython-310.pyc
o
�$�a�
� @ s� d Z ddlZddlmZ ddlmZmZmZmZ ddlm Z ddl
m Z m Z m
Z
ddlmZ ddlmZmZ e �e�Zg d �ZG d
d � d �ZdS ) z�
sphinx.project
~~~~~~~~~~~~~~
Utility function and classes for Sphinx projects.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�glob)�Dict�List�Optional�Set)�__)�get_matching_files�logging�path_stabilize)�compile_matchers)�SEP�relpath)z **/_sourcesz.#*z**/.#*z
*.lproj/**c @ s� e Zd ZdZdedeeef ddfdd�Zdd d
�Zg fd ee de e fd d
�Z
dede e fdd�Z ddede
defdd�ZdS )�Projectz;A project is the source code set of the Sphinx document(s).�srcdir�
source_suffix�returnNc C s || _ || _t� | _d S )N)r r �set�docnames)�selfr r � r �0/usr/lib/python3/dist-packages/sphinx/project.py�__init__ s zProject.__init__�otherc C s |j | _ dS )z!Take over a result of last build.N)r )r r r r r �restore% s zProject.restore�
exclude_pathsc s� t � � _t|t �}t� j|�D ]P}� �|�}|r`|� jv rCtj� � j|�d }� fdd�t
|�D �}t j t
d�||� �|�dd� qt�tj� � j|�tj�rW� j�|� qt j t
d�|d� q� jS ) zbFind all document files in the source directory and put them in
:attr:`docnames`.
z.*c s g | ]}t |� j��qS r )r
r )�.0�f�r r r �
<listcomp>4 s z$Project.discover.<locals>.<listcomp>zDmultiple files found for the document "%s": %r
Use %r for the build.T)�oncez document not readable. Ignored.)�location)r r r �
EXCLUDE_PATHSr r �path2doc�os�path�joinr �logger�warningr �doc2path�access�R_OK�add)r r �excludes�filename�docname�pattern�filesr r r �discover) s
��zProject.discoverr- c C sP |� | j�r t|| j�}| jD ]}|�|�r%t|�}|dt|� � S qdS )z�Return the docname for the filename if the file is a document.
*filename* should be absolute or relative to the source directory.
N)�
startswithr r
r �endswithr
�len)r r- �suffixr r r r" ? s
�zProject.path2docTr. �basedirc C sb |� ttjj�}tj�| j|�}| jD ] }tj�|| �r nqt | j�d }|r-|| S || S )z�Return the filename for the document name.
If *basedir* is True, return as an absolute path.
Else, return as a relative path to the source directory.
r )
�replacer r# r$ �sepr% r r �isfile�list)r r. r6 �basenamer5 r r r r( N s
�zProject.doc2path)r r r N)T)�__name__�
__module__� __qualname__�__doc__�strr r r r r r1 r r" �boolr( r r r r r s
r )r? r# r �typingr r r r �
sphinx.localer � sphinx.utilr r r
�sphinx.util.matchingr �sphinx.util.osutilr r
� getLoggerr< r& r! r r r r r �<module> s