ruạṛ
a �u:j&S � @ s� d Z ddlmZ ddlZddlZddlmZmZmZ ddl m Z ddl m Z ddl m Z ddlmZmZ ddlZd d lmZ dd lmZ dd lmZ er�dd lmZ ejj Z ddd�dd�Z G dd� d�Z G dd� d�Z G dd� de �Z!G dd� de!�Z"G dd � d e �Z#G d d � d e"�Z$G d d � d e#�Z%d!dd"d#�d$d%�Z&G d&d'� d'�Z'd"d"d(�d)d*�Z(d"d"d(�d+d,�Z)d"d-dd.d/�d0d1�Z*d!d-dd!d2�d3d4�Z+d"dd5d6�d7d8�Z,dS )9u_ Automatic discovery of Python modules and packages (for inclusion in the distribution) and other config values. For the purposes of this module, the following nomenclature is used: - "src-layout": a directory representing a Python project that contains a "src" folder. Everything under the "src" folder is meant to be included in the distribution when packaging the project. Example:: . ├── tox.ini ├── pyproject.toml └── src/ └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "flat-layout": a Python project that does not use "src-layout" but instead have a directory under the project root for each package:: . ├── tox.ini ├── pyproject.toml └── mypkg/ ├── __init__.py ├── mymodule.py └── my_data_file.txt - "single-module": a project that contains a single Python script direct under the project root (no directory used):: . ├── tox.ini ├── pyproject.toml └── mymodule.py � )� annotationsN)�Iterable�Iterator�Mapping�� fnmatchcase)�glob)�Path)� TYPE_CHECKING�ClassVar� )�StrPath)�log)� convert_path)� Distributionr �bool)�path�returnc C s t j�| ��� S �N)�osr �basename� isidentifier)r � r �G/opt/bart/bart_venv/lib/python3.9/site-packages/setuptools/discovery.py� _valid_name? s r c @ s@ e Zd ZdZddd�dd�Zddd�d d �Zddd�d d �Zd S )�_Filterz� Given a list of patterns, create a callable that will be true only if the input matches at least one of the patterns. �str�None)�patternsr c G s t �|�| _d S r )�dict�fromkeys� _patterns)�selfr r r r �__init__J s z_Filter.__init__r )�itemr c s t � fdd�| jD ��S )Nc 3 s | ]}t � |�V qd S r r )�.0�pat�r$ r r � <genexpr>N � z#_Filter.__call__.<locals>.<genexpr>)�anyr! �r" r$ r r' r �__call__M s z_Filter.__call__c C s || j v S r )r! r+ r r r � __contains__P s z_Filter.__contains__N)�__name__� __module__� __qualname__�__doc__r# r, r- r r r r r D s r c @ s\ e Zd ZU dZdZded< dZded< eddd d d d �d d ��Zeddddd �dd��Z dS )�_Finderz@Base class that exposes functionality for module/package findersr zClassVar[tuple[str, ...]]�ALWAYS_EXCLUDE�DEFAULT_EXCLUDE�.��*r z Iterable[str]� list[str]��where�exclude�includer c C s8 |p| j }t| �tt|��tg | j�|�R � t|� ��S )aZ Return a list of all Python items (packages or modules, depending on the finder implementation) found within directory ``where``. ``where`` is the root directory which will be searched. It should be supplied as a "cross-platform" (i.e. URL-style) path; it will be converted to the appropriate local path syntax. ``exclude`` is a sequence of names to exclude; ``*`` can be used as a wildcard in the names. When finding packages, ``foo.*`` will exclude all subpackages of ``foo`` (but not ``foo`` itself). ``include`` is a sequence of names to include. If it's specified, only the named items will be included. If it's not specified, all found items will be included. ``include`` can contain shell style wildcard patterns just like ``exclude``. )r4 �list� _find_iterr r r r3 ��clsr: r; r< r r r �findZ s ��z _Finder.findr � Iterator[str]c C s t �d S r )�NotImplementedErrorr? r r r r> } s z_Finder._find_iterN)r5 r r6 ) r. r/ r0 r1 r3 �__annotations__r4 � classmethodrA r> r r r r r2 T s �"r2 c @ sB e Zd ZdZdZeddddd�dd��Zedd d d �d d ��ZdS )� PackageFinderzI Generate a list of all Python packages found within a directory )Zez_setupz *__pycache__r r rB r9 c c s� t jt|�dd�D ]�\}}}|dd� }g |dd�< |D ]�}t j�||�} t j�| |�} | �t jjd�} d|v s8| �| | �s~q8|| �r�|| �s�| V | � d�|v s8| � d�|v r�q8|� |� q8qdS )zy All the packages found in 'where' that pass the 'include' filter, but not the 'exclude' filter. T)� followlinksNr5 r7 �.*) r �walkr r �join�relpath�replace�sep�_looks_like_package�append) r@ r: r; r< �root�dirs�filesZall_dirs�dir� full_path�rel_path�packager r r r> � s zPackageFinder._find_iterr r )r � _package_namer c C s t j�t j�| d��S )z%Does a directory look like a package?� __init__.py)r r �isfilerJ )r rW r r r rN � s z!PackageFinder._looks_like_packageN) r. r/ r0 r1 r3 rE r> � staticmethodrN r r r r rF � s !rF c @ s" e Zd Zedddd�dd��ZdS )�PEP420PackageFinderr r r )�_pathrW r c C s dS )NTr )r\ rW r r r rN � s z'PEP420PackageFinder._looks_like_packageN)r. r/ r0 rZ rN r r r r r[ � s r[ c @ s0 e Zd ZdZeddddd�dd��Zee�ZdS ) � ModuleFinderzYFind isolated Python modules. This function will **not** recurse subdirectories. r r rB r9 c c sV t tj�|d��D ]>}tj�tj�|��\}}| �|�s:q||�r||�s|V qd S )Nz*.py)r r r rJ �splitextr �_looks_like_module)r@ r: r; r< �file�moduleZ_extr r r r> � s zModuleFinder._find_iterN) r. r/ r0 r1 rE r> rZ r r_ r r r r r] � s r] c @ s< e Zd ZdZeedd� eD ���Zedddd�dd ��Zd S ) �FlatLayoutPackageFinder)#�ci�bin�debian�doc�docsZ documentationZmanpages�newsZ newsfragmentsZ changelog�test�testsZ unit_testZ unit_tests�example�examples�scriptsZtools�util�utils�python�build�dist�venv�env� requirements�tasks�fabfileZ site_scons� benchmark� benchmarks�exercise� exercisesZhtmlcov�[._]*c c s | ]}||� d �fV qdS )rH Nr )r% �pr r r r( � r) z!FlatLayoutPackageFinder.<genexpr>r r r )r\ � package_namer c C sB |� d�}|d �� p"|d �d�}|o@tdd� |dd � D ��S )Nr5 r �-stubsc s s | ]}|� � V qd S r )r )r% �namer r r r( r) z>FlatLayoutPackageFinder._looks_like_package.<locals>.<genexpr>r )�splitr �endswith�all)r\ r~ �namesZroot_pkg_is_validr r r rN � s z+FlatLayoutPackageFinder._looks_like_packageN) r. r/ r0 Z_EXCLUDE�tuple� chain_iterr4 rZ rN r r r r rb � s )rb c @ s e Zd ZdZdS )�FlatLayoutModuleFinder)�setupZconftestri rj rk rl rq ZtoxfileZnoxfileZpavementZdodorv rw z[Ss][Cc]onstructZ conanfileZmanagerx ry rz r{ r| N)r. r/ r0 r4 r r r r r� s r� r r8 )�root_pkg�pkg_dirr c s" t �|�}� g� fdd�|D � S )Nc s g | ]}d � � |f��qS )r5 )rJ �r% �n�r� r r � <listcomp>' r) z)_find_packages_within.<locals>.<listcomp>)r[ rA )r� r� �nestedr r� r �_find_packages_within% s r� c @ s e Zd ZdZddd�dd�Zdd� Zd d � Zed d �d d��Zedd �dd��Z d4ddddd�dd�Z ddd�dd�Z ddd�dd �Z dd �d d �Z dd �d d �Zdd �d!d"�Zdd �d#d$�Zdd �d%d&�Zd'd(d)�d*d+�Zdd �d,d-�Zd.d �d/d0�Zd.d �d1d2�Zd3S )5�ConfigDiscoveryz�Fill-in metadata and options that can be automatically derived (from other metadata/options, the file system or conventions) r r )� distributionr c C s || _ d| _d| _d| _d S )NF)rr �_called� _disabled�_skip_ext_modules)r" r� r r r r# / s zConfigDiscovery.__init__c C s d| _ dS )z+Internal API to disable automatic discoveryTN)r� �r" r r r �_disable5 s zConfigDiscovery._disablec C s d| _ dS )a� Internal API to disregard ext_modules. Normally auto-discovery would not be triggered if ``ext_modules`` are set (this is done for backward compatibility with existing packages relying on ``setup.py`` or ``setup.cfg``). However, ``setuptools`` can call this function to ignore given ``ext_modules`` and proceed with the auto-discovery if ``packages`` and ``py_modules`` are not given (e.g. when using pyproject.toml metadata). TN)r� r� r r r �_ignore_ext_modules9 s z#ConfigDiscovery._ignore_ext_modulesr )r c C s | j jp tjS r )rr Zsrc_rootr �curdirr� r r r � _root_dirE s zConfigDiscovery._root_dir�dict[str, str]c C s | j jd u ri S | j jS r )rr � package_dirr� r r r � _package_dirJ s z ConfigDiscovery._package_dirFTr )�forcer� �ignore_ext_modulesr c C s8 |du r| j s| jrdS | �|� |r.| �� d| _ dS )a� Automatically discover missing configuration fields and modifies the given ``distribution`` object in-place. Note that by default this will only have an effect the first time the ``ConfigDiscovery`` object is called. To repeatedly invoke automatic discovery (e.g. when the project directory changes), please use ``force=True`` (or create a new ``ConfigDiscovery`` instance). FNT)r� r� �_analyse_package_layout� analyse_name)r" r� r� r� r r r r, P s zConfigDiscovery.__call__)r� r c C sL |p| j }| jjdu p| }| jjdupJ| jjdupJ|pJt| jd�oJ| jjS )zF``True`` if the user has specified some form of package/module listingN� configuration)r� rr � ext_modules�packages� py_modules�hasattrr� )r" r� r� r r r �_explicitly_specifiedg s �� �z%ConfigDiscovery._explicitly_specifiedc C s0 | � |�rdS t�d� | �� p.| �� p.| �� S )NTzLNo `packages` or `py_modules` configuration, performing automatic discovery.)r� r �debug�_analyse_explicit_layout�_analyse_src_layout�_analyse_flat_layout)r" r� r r r r� t s ���z'ConfigDiscovery._analyse_package_layoutc sr | j �� }|�dd� | j� |s$dS t�d|� �� t� fdd�|�� D ��}t|�| j _ t�d| j j � �� dS ) zAThe user can explicitly give a package layout via ``package_dir``� NFz(`explicit-layout` detected -- analysing c 3 s& | ] \}}t |tj�� |��V qd S r )r� r r rJ )r% �pkg� parent_dir��root_dirr r r( � s �z;ConfigDiscovery._analyse_explicit_layout.<locals>.<genexpr>�discovered packages -- T) r� �copy�popr� r r� r� �itemsr= rr r� )r" r� �pkgsr r� r r� � s � z(ConfigDiscovery._analyse_explicit_layoutc C s� | j }tj�| j|�dd��}tj�|�s.dS t�d|� �� |� dtj� |�� || j _ t �|�| j _t�|�| j _t�d| j j� �� t�d| j j� �� dS )a� Try to find all packages or modules under the ``src`` directory (or anything pointed by ``package_dir[""]``). The "src-layout" is relatively safe for automatic discovery. We assume that everything within is meant to be included in the distribution. If ``package_dir[""]`` is not given, but the ``src`` directory exists, this function will set ``package_dir[""] = "src"``. r� �srcFz#`src-layout` detected -- analysing r� �discovered py_modules -- T)r� r r rJ r� �get�isdirr r� � setdefaultr rr r� r[ rA r� r] r� )r" r� �src_dirr r r r� � s z#ConfigDiscovery._analyse_src_layoutc C s" t �d| j� �� | �� p | �� S )a� Try to find all packages and modules under the project root. Since the ``flat-layout`` is more dangerous in terms of accidentally including extra files/directories, this function is more conservative and will raise an error if multiple packages or modules are found. This assumes that multi-package dists are uncommon and refuse to support that use case in order to be able to prevent unintended errors. z$`flat-layout` detected -- analysing )r r� r� �_analyse_flat_packages�_analyse_flat_modulesr� r r r r� � s z$ConfigDiscovery._analyse_flat_layoutc C sH t �| j�| j_tt| jj��}t�d| jj� �� | � |d� t |�S )Nr� r� ) rb rA r� rr r� �remove_nested_packages� remove_stubsr r� � _ensure_no_accidental_inclusionr )r" � top_levelr r r r� � s z&ConfigDiscovery._analyse_flat_packagesc C s@ t �| j�| j_t�d| jj� �� | �| jjd� t| jj�S )Nr� �modules) r� rA r� rr r� r r� r� r r� r r r r� � s z%ConfigDiscovery._analyse_flat_modulesr8 r )�detected�kindc C sL t |�dkrHddlm} ddlm} d|� d|� d|� d�}|||���d S ) Nr r )�cleandoc)�PackageDiscoveryErrorzMultiple top-level z discovered in a flat-layout: z�. To avoid accidental inclusion of unwanted files or directories, setuptools will not proceed with this build. If you are trying to create a single distribution with multiple a� on purpose, you should not rely on automatic discovery. Instead, consider the following options: 1. set up custom discovery (`find` directive with `include` or `exclude`) 2. use a `src-layout` 3. explicitly set `py_modules` or `packages` with a list of names To find more information, look for "package discovery" on setuptools docs. )�len�inspectr� Zsetuptools.errorsr� )r" r� r� r� r� �msgr r r r� � s �z/ConfigDiscovery._ensure_no_accidental_inclusionc C sB | j jjs| j jrdS t�d� | �� p.| �� }|r>|| j j_dS )z�The packages/modules are the essential contribution of the author. Therefore the name of the distribution can be derived from them. Nz7No `name` configuration, performing automatic discovery)rr �metadatar� r r� �#_find_name_single_package_or_module�_find_name_from_packages)r" r� r r r r� � s �z ConfigDiscovery.analyse_name� str | Nonec C sP dD ]F}t | j|d�pg }|rt|�dkrt�d|d � �� |d S qdS )z Exactly one module or package)r� r� Nr z&Single module/package detected, name: r )�getattrrr r� r r� )r" �fieldr� r r r r� � s z3ConfigDiscovery._find_name_single_package_or_modulec C s` | j js dS tt| j jtd��}| j jp*i }t||| j�}|rRt� d|� �� |S t� d� dS )z<Try to find the root package that is not a PEP 420 namespaceN��keyz&Common parent package detected, name: z7No parent package detected, impossible to derive `name`) rr r� r� �sortedr� r� �find_parent_packager� r r� �warn)r" r� r� Z parent_pkgr r r r� � s z(ConfigDiscovery._find_name_from_packagesN)FTF)r. r/ r0 r1 r# r� r� �propertyr� r� r, r� r� r� r� r� r� r� r� r� r� r� r r r r r� * s* � r� )r� r c sb t | td�}|dd� }t|�}tt|��D ]0\}� t� fdd�|D ��r,|�|| d � q,|S )z�Remove nested packages from a list of packages. >>> remove_nested_packages(["a", "a.b1", "a.b2", "a.b1.c1"]) ['a'] >>> remove_nested_packages(["a", "b", "c.d", "c.d.e.f", "g.h", "a.a1"]) ['a', 'b', 'c.d', 'g.h'] r� Nc 3 s | ]}� � |� d ��V qdS �r5 N�� startswith)r% �other�r� r r r( r) z)remove_nested_packages.<locals>.<genexpr>r )r� r� � enumerate�reversedr* r� )r� r� r� �size�ir r� r r� s r� c C s dd� | D �S )z�Remove type stubs (:pep:`561`) from a list of packages. >>> remove_stubs(["a", "a.b", "a-stubs", "a-stubs.b.c", "b", "c-stubs"]) ['a', 'a.b', 'b'] c S s$ g | ] }|� d �d �d�s|�qS )r5 r r )r� r� �r% r� r r r r� & r) z remove_stubs.<locals>.<listcomp>r )r� r r r r� s r� zMapping[str, str]r� )r� r� r� r c s� t | td�} g }t| �D ]8\}� t� fdd�| |d d� D ��sF qR|�� � q|D ]2� t� ||�}tj�|d�}tj� |�rV� S qVdS )z0Find the parent package that is not a namespace.r� c 3 s | ]}|� � � d ��V qdS r� r� r� r� r r r( 0 r) z&find_parent_package.<locals>.<genexpr>r NrX ) r� r� r� r� rO �find_package_pathr r rJ rY )r� r� r� Zcommon_ancestorsr� Zpkg_path�initr r� r r� ) s " r� )r� r� r� r c C s� | � d�}tt|�dd�D ]H}d�|d|� �}||v r|| }tjj||g||d� �R � S q|�d�ppd}tjj|g|� d��|�R � S )a� Given a package name, return the path where it should be found on disk, considering the ``package_dir`` option. >>> path = find_package_path("my.pkg", {"": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/my/pkg' >>> path = find_package_path("my.pkg", {"my": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested/pkg' >>> path = find_package_path("my.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './root/is/nested' >>> path = find_package_path("other.pkg", {"my.pkg": "root/is/nested"}, ".") >>> path.replace(os.sep, "/") './other/pkg' r5 r ���Nr� �/)r� �ranger� rJ r r r� )r� r� r� �partsr� Z partial_name�parentr r r r� A s $r� r� )r� � package_pathr c s$ t | �}t|�j� � fdd�|D �S )Nc s& i | ] }|d � g � �|�d����qS )r� r5 )rJ r� r� ��prefixr r � <dictcomp>f r) z)construct_package_dir.<locals>.<dictcomp>)r� r r� )r� r� Z parent_pkgsr r� r �construct_package_dirc s r� )-r1 � __future__r � itertoolsr �collections.abcr r r �fnmatchr r �pathlibr �typingr r Z_distutils_hack.override�_distutils_hackr\ r � distutilsr �distutils.utilr � setuptoolsr �chain� from_iterabler� r r r2 rF r[ r] rb r� r� r� r� r� r� r� r� r r r r �<module> s> ' 0/5 e "
cải xoăn