HEX

File: //opt/python38/lib/python3.8/site-packages/pip/_internal/metadata/__pycache__/base.cpython-38.pyc
U

�{�e3e�@s�ddlZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
mZmZm
Z
mZmZmZmZmZmZmZmZmZddlmZddlmZmZddlmZmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%m&Z&dd	l'm(Z(m)Z)m*Z*dd
l+m,Z,ddl-m.Z.ddl/m0Z0m1Z1dd
l2m3Z3ddl4m5Z5e�r<ddl	m6Z6ne7Z6ee e!fZ8ee9ej:fZ;e�<e=�Z>Gdd�de6�Z?ee9dfee9dfe9d�dd�Z@Gdd�de�ZAGdd�de6�ZBGdd�d�ZCGdd�de6�ZDGdd �d eD�ZEGd!d"�d"eD�ZFdS)#�N)
�IO�
TYPE_CHECKING�Any�
Collection�	Container�Dict�Iterable�Iterator�List�
NamedTuple�Optional�Tuple�Union)�Requirement)�InvalidSpecifier�SpecifierSet)�NormalizedName�canonicalize_name)�
LegacyVersion�Version)�NoneMetadataError)�
site_packages�	user_site)�DIRECT_URL_METADATA_NAME�	DirectUrl�DirectUrlValidationError)�stdlib_pkgs)�egg_link_path_from_sys_path)�is_local�normalize_path)�url_to_path�)�msg_to_json)�Protocolc@sBeZdZeed�dd��Zeed�dd��Zeed�dd��ZdS)	�BaseEntryPoint��returncCs
t��dS�N��NotImplementedError��self�r,�?/tmp/pip-unpacked-wheel-_0scjqea/pip/_internal/metadata/base.py�name9szBaseEntryPoint.namecCs
t��dSr'r(r*r,r,r-�value=szBaseEntryPoint.valuecCs
t��dSr'r(r*r,r,r-�groupAszBaseEntryPoint.groupN)�__name__�
__module__�__qualname__�property�strr.r/r0r,r,r,r-r$8sr$.)�entry�infor&cCsV|rD|ddkrD|r |ddkr*|d7}n|dd�}|dd�}qttj||���S)a�Convert a legacy installed-files.txt path into modern RECORD path.

    The legacy format stores paths relative to the info directory, while the
    modern format stores paths relative to the package root, e.g. the
    site-packages directory.

    :param entry: Path parts of the installed-files.txt entry.
    :param info: Path parts of the egg-info directory relative to package root.
    :returns: The converted entry.

    For best compatibility with symlinks, this does not use ``abspath()`` or
    ``Path.resolve()``, but tries to work with path parts:

    1. While ``entry`` starts with ``..``, remove the equal amounts of parts
       from ``info``; if ``info`` is empty, start appending ``..`` instead.
    2. Join the two directly.
    r�..���)r8Nr!�r5�pathlib�Path)r6r7r,r,r-�_convert_installed_files_pathFs
r=c@s&eZdZUeed<eed<eed<dS)�
RequiresEntry�requirement�extra�markerN)r1r2r3r5�__annotations__r,r,r,r-r>ds
r>c@sheZdZeedd�dd��Zeeeedd�dd��Zededd�d	d
��Zed�dd
�Z	ed�dd�Z
eeed�dd��Z
eeed�dd��Zeeed�dd��Zeeed�dd��Zeed�dd��Zeed�dd��Zeed�dd��Zeed�dd��Zeed�d d!��Zeed�d"d#��Zeed�d$d%��Zeeed�d&d'��Zeed�d(d)��Zeed�d*d+��Zeed�d,d-��Zeed�d.d/��Z eed�d0d1��Z!eed�d2d3��Z"e#ed4�d5d6�Z$e%ed�d7d8�Z&e#ed4�d9d:�Z'e(e)d�d;d<�Z*e+j,j-d�d=d>�Z.e/j0d?d@�e+j,j-d�dAdB��Z1ee+j,j-d�dCdD��Z2ee3ee4fd�dEdF��Z5eeed�dGdH��Z6eed�dIdJ��Z7ee8d�dKdL��Z9dfe:ee(e;dN�dOdP�Z<e(ed�dQdR�Z=eedS�dTdU�Z>ee%ed�dVdW�Z?ee%ed�dXdY�Z@ee%ed�dZd[�ZAe%eBd�d\d]�ZCe(ed�d^d_�ZDe(ed�d`da�ZEe+j,j-dbdc�ddde�ZFdbS)g�BaseDistribution)�	directoryr&cCs
t��dS)z�Load the distribution from a metadata directory.

        :param directory: Path to a metadata directory, e.g. ``.dist-info``.
        Nr()�clsrDr,r,r-�from_directorykszBaseDistribution.from_directory)�metadata_contents�filename�project_namer&cCs
t��dS)a�Load the distribution from the contents of a METADATA file.

        This is used to implement PEP 658 by generating a "shallow" dist object that can
        be used for resolution without downloading or building the actual dist yet.

        :param metadata_contents: The contents of a METADATA file.
        :param filename: File name for the dist with this metadata.
        :param project_name: Name of the project this dist represents.
        Nr()rErGrHrIr,r,r-�from_metadata_file_contentsssz,BaseDistribution.from_metadata_file_contents�Wheel)�wheelr.r&cCs
t��dS)aLoad the distribution from a given wheel.

        :param wheel: A concrete wheel definition.
        :param name: File name of the wheel.

        :raises InvalidWheel: Whenever loading of the wheel causes a
            :py:exc:`zipfile.BadZipFile` exception to be thrown.
        :raises UnsupportedWheel: If the wheel is a valid zip, but malformed
            internally.
        Nr()rErLr.r,r,r-�
from_wheel�szBaseDistribution.from_wheelr%cCs|j�d|j�d|j�d�S)N� z (�))�raw_name�version�locationr*r,r,r-�__repr__�szBaseDistribution.__repr__cCs|j�d|j��S)NrN)rPrQr*r,r,r-�__str__�szBaseDistribution.__str__cCs
t��dS)a�Where the distribution is loaded from.

        A string value is not necessarily a filesystem path, since distributions
        can be loaded from other sources, e.g. arbitrary zip archives. ``None``
        means the distribution is created in-memory.

        Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If
        this is a symbolic link, we want to preserve the relative path between
        it and files in the distribution.
        Nr(r*r,r,r-rR�szBaseDistribution.locationcCs6|j}|r|��r2t|j�Snt|j�}|r2|jSdS)z�The project location for editable distributions.

        This is the directory where pyproject.toml or setup.py is located.
        None if the distribution is not installed in editable mode.
        N)�
direct_urlZis_local_editabler �urlrrPrR)r+rU�
egg_link_pathr,r,r-�editable_project_location�s
z*BaseDistribution.editable_project_locationcCs
t��dS)a�The distribution's "installed" location.

        This should generally be a ``site-packages`` directory. This is
        usually ``dist.location``, except for legacy develop-installed packages,
        where ``dist.location`` is the source code location, and this is where
        the ``.egg-link`` file is.

        The returned location is normalized (in particular, with symlinks removed).
        Nr(r*r,r,r-�installed_location�sz#BaseDistribution.installed_locationcCs
t��dS)a/Location of the .[egg|dist]-info directory or file.

        Similarly to ``location``, a string value is not necessarily a
        filesystem path. ``None`` means the distribution is created in-memory.

        For a modern .dist-info installation on disk, this should be something
        like ``{location}/{raw_name}-{version}.dist-info``.

        Do not canonicalize this value with e.g. ``pathlib.Path.resolve()``. If
        this is a symbolic link, we want to preserve the relative path between
        it and other files in the distribution.
        Nr(r*r,r,r-�
info_location�szBaseDistribution.info_locationcCs|j}|sdSt�|���S)aWhether this distribution is installed with legacy distutils format.

        A distribution installed with "raw" distutils not patched by setuptools
        uses one single file at ``info_location`` to store metadata. We need to
        treat this specially on uninstallation.
        F)rZr;r<�is_file�r+rZr,r,r-�installed_by_distutils�sz'BaseDistribution.installed_by_distutilscCs|j}|sdS|�d�S)z�Whether this distribution is installed as an egg.

        This usually indicates the distribution was installed by (older versions
        of) easy_install.
        Fz.egg)rR�endswith�r+rRr,r,r-�installed_as_egg�sz!BaseDistribution.installed_as_eggcCs*|j}|sdS|�d�sdSt�|���S)a�Whether this distribution is installed with the ``.egg-info`` format.

        This usually indicates the distribution was installed with setuptools
        with an old pip version or with ``single-version-externally-managed``.

        Note that this ensure the metadata store is a directory. distutils can
        also installs an ``.egg-info``, but as a file, not a directory. This
        property is *False* for that case. Also see ``installed_by_distutils``.
        Fz	.egg-info�rZr^r;r<�is_dirr\r,r,r-�"installed_with_setuptools_egg_info�s
z3BaseDistribution.installed_with_setuptools_egg_infocCs*|j}|sdS|�d�sdSt�|���S)aaWhether this distribution is installed with the "modern format".

        This indicates a "modern" installation, e.g. storing metadata in the
        ``.dist-info`` directory. This applies to installations made by
        setuptools (but through pip, not directly), or anything using the
        standardized build backend interface (PEP 517).
        Fz
.dist-inforar\r,r,r-�installed_with_dist_infos	
z)BaseDistribution.installed_with_dist_infocCs
t��dSr'r(r*r,r,r-�canonical_nameszBaseDistribution.canonical_namecCs
t��dSr'r(r*r,r,r-rQszBaseDistribution.versioncCs|j�dd�S)z�Convert a project name to its setuptools-compatible filename.

        This is a copy of ``pkg_resources.to_filename()`` for compatibility.
        �-�_)rP�replacer*r,r,r-�setuptools_filenamesz$BaseDistribution.setuptools_filenamec
Cszz|�t�}Wntk
r$YdSXzt�|�WSttjtfk
rt}zt	�
dt|j|�WY�dSd}~XYnXdS)z�Obtain a DirectUrl from this distribution.

        Returns None if the distribution has no `direct_url.json` metadata,
        or if `direct_url.json` is invalid.
        NzError parsing %s for %s: %s)�	read_textr�FileNotFoundErrorr�	from_json�UnicodeDecodeError�json�JSONDecodeErrorr�logger�warningre)r+�content�er,r,r-rU%s$��zBaseDistribution.direct_urlc
CsRz|�d�}Wntttfk
r*YdSX|��D]}|��}|r4|Sq4dS)N�	INSTALLER�)rj�OSError�
ValueErrorr�
splitlines�strip)r+Zinstaller_text�lineZcleaned_liner,r,r-�	installer?s
zBaseDistribution.installercCs
|�d�S)NZ	REQUESTED)r[r*r,r,r-�	requestedKszBaseDistribution.requestedcCs
t|j�Sr')�boolrXr*r,r,r-�editableOszBaseDistribution.editablecCs|jdkrdSt|j�S)z|If distribution is installed in the current virtual environment.

        Always True if we're not in a virtualenv.
        NF)rYrr*r,r,r-�localSs
zBaseDistribution.localcCs&|jdkstdkrdS|j�tt��S�NF)rYr�
startswithrr*r,r,r-�in_usersite]szBaseDistribution.in_usersitecCs&|jdkstdkrdS|j�tt��Sr�)rYrr�rr*r,r,r-�in_site_packagescsz!BaseDistribution.in_site_packages)�pathr&cCs
t��dS)z7Check whether an entry in the info directory is a file.Nr(�r+r�r,r,r-r[iszBaseDistribution.is_filecCs
t��dS)z�Find distutils 'scripts' entries metadata.

        If 'scripts' is supplied in ``setup.py``, distutils records those in the
        installed distribution's ``scripts`` directory, a file for each script.
        Nr(r*r,r,r-�iter_distutils_script_namesmsz,BaseDistribution.iter_distutils_script_namescCs
t��dS)z�Read a file in the info directory.

        :raise FileNotFoundError: If ``path`` does not exist in the directory.
        :raise NoneMetadataError: If ``path`` exists in the info directory, but
            cannot be read.
        Nr(r�r,r,r-rjuszBaseDistribution.read_textcCs
t��dSr'r(r*r,r,r-�iter_entry_points~sz"BaseDistribution.iter_entry_pointscCs
t��dSr'r(r*r,r,r-�_metadata_impl�szBaseDistribution._metadata_implr!)�maxsizecCs|��}|�|�|Sr')r��_add_egg_info_requires)r+�metadatar,r,r-�_metadata_cached�s
z!BaseDistribution._metadata_cachedcCs|��S)aMetadata of distribution parsed from e.g. METADATA or PKG-INFO.

        This should return an empty message if the metadata file is unavailable.

        :raises NoneMetadataError: If the metadata file is available, but does
            not contain valid metadata.
        )r�r*r,r,r-r��s	zBaseDistribution.metadatacCs
t|j�S)aPEP 566 compliant JSON-serializable representation of METADATA or PKG-INFO.

        This should return an empty dict if the metadata file is unavailable.

        :raises NoneMetadataError: If the metadata file is available, but does
            not contain valid metadata.
        )r"r�r*r,r,r-�
metadata_dict�s	zBaseDistribution.metadata_dictcCs|j�d�S)zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)r��getr*r,r,r-�metadata_version�sz!BaseDistribution.metadata_versioncCs|j�d|j�S)z*Value of "Name:" in distribution metadata.�Name)r�r�rer*r,r,r-rP�szBaseDistribution.raw_namec
Csp|j�d�}|dkrt�Sztt|��}Wn@tk
rj}z"d}t�||j|�t�WY�Sd}~XYnX|S)z�Value of "Requires-Python:" in distribution metadata.

        If the key does not exist or contains an invalid value, an empty
        SpecifierSet should be returned.
        zRequires-PythonNz-Package %r has an invalid Requires-Python: %s)r�r�rr5rrprqrP)r+r/�specrs�messager,r,r-�requires_python�sz BaseDistribution.requires_pythonr,)�extrasr&cCs
t��dS)z�Dependencies of this distribution.

        For modern .dist-info distributions, this is the collection of
        "Requires-Dist:" entries in distribution metadata.
        Nr()r+r�r,r,r-�iter_dependencies�sz"BaseDistribution.iter_dependenciescCs
t��dS)a�Extras provided by this distribution.

        For modern .dist-info distributions, this is the collection of
        "Provides-Extra:" entries in distribution metadata.

        The return value of this function is not particularly useful other than
        display purposes due to backward compatibility issues and the extra
        names being poorly normalized prior to PEP 685. If you want to perform
        logic operations on extras, use :func:`is_extra_provided` instead.
        Nr(r*r,r,r-�iter_provided_extras�sz%BaseDistribution.iter_provided_extras)r@r&cCs
t��dS)z�Check whether an extra is provided by this distribution.

        This is needed mostly for compatibility issues with pkg_resources not
        following the extra normalization rules defined in PEP 685.
        Nr()r+r@r,r,r-�is_extra_provided�sz"BaseDistribution.is_extra_providedcCs>z|�d�}Wntk
r$YdSXdd�t�|���D�S)N�RECORDcss |]}tt�|d��VqdS)rNr:)�.0�rowr,r,r-�	<genexpr>�szFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)rjrk�csv�readerrx)r+�textr,r,r-�"_iter_declared_entries_from_record�s
z3BaseDistribution._iter_declared_entries_from_recordcs�z|�d�}Wntk
r$YdSXdd�|jdd�D�}|j}|j}|dksX|dkr\|Szt�|��|��Wntk
r�|YSX�j	s�|S�fdd�|D�S)Nzinstalled-files.txtcss|]}|r|VqdSr'r,�r��pr,r,r-r��szFBaseDistribution._iter_declared_entries_from_legacy.<locals>.<genexpr>F)�keependsc3s"|]}tt�|�j�j�VqdSr')r=r;r<�partsr��Zinfo_relr,r-r��s�)
rjrkrxrRrZr;r<�relative_torwr�)r+r��paths�rootr7r,r�r-�"_iter_declared_entries_from_legacy�s$

�z3BaseDistribution._iter_declared_entries_from_legacycCs|��p|��S)a�Iterate through file entries declared in this distribution.

        For modern .dist-info distributions, this is the files listed in the
        ``RECORD`` metadata file. For legacy setuptools distributions, this
        comes from ``installed-files.txt``, with entries normalized to be
        compatible with the format used by ``RECORD``.

        :return: An iterator for listed entries, or None if the distribution
            contains neither ``RECORD`` nor ``installed-files.txt``.
        )r�r�r*r,r,r-�iter_declared_entries�s�z&BaseDistribution.iter_declared_entriesccs�z|�d�}Wntk
r$YdSXd}}|��D]X}|��}|r6|�d�rRq6|�d�r~|�d�r~|�d��d�\}}}q6t|||d	�Vq6dS)
a�Parse a ``requires.txt`` in an egg-info directory.

        This is an INI-ish format where an egg-info stores dependencies. A
        section name describes extra other environment markers, while each entry
        is an arbitrary string (not a key-value pair) representing a dependency
        as a requirement string (no markers).

        There is a construct in ``importlib.metadata`` called ``Sectioned`` that
        does mostly the same, but the format is currently considered private.
        zrequires.txtNru�#�[�]z[]�:)r?r@rA)rjrkrxryr�r^�	partitionr>)r+rrr@rArzrgr,r,r-�_iter_requires_txt_entriessz+BaseDistribution._iter_requires_txt_entriesccs<dh}|��D](}t|j�}||kr&q|�|�|VqdS)z'Get extras from the egg-info directory.ruN)r�rr@�add)r+Zknown_extrasr6r@r,r,r-�_iter_egg_info_extras$s

z&BaseDistribution._iter_egg_info_extrasccs�|��D]r}t|j�}|r6|jr6d|j�d|�d�}n$|rHd|�d�}n|jrV|j}nd}|rr|j�d|��Vq|jVqdS)a�Get distribution dependencies from the egg-info directory.

        To ease parsing, this converts a legacy dependency entry into a PEP 508
        requirement string. Like ``_iter_requires_txt_entries()``, there is code
        in ``importlib.metadata`` that does mostly the same, but not do exactly
        what we need.

        Namely, ``importlib.metadata`` does not normalize the extra name before
        putting it into the requirement string, which causes marker comparison
        to fail because the dist-info format do normalize. This is consistent in
        all currently available PEP 517 backends, although not standardized.
        �(z) and extra == "�"z
extra == "ruz ; N)r�rr@rAr?)r+r6r@rAr,r,r-�_iter_egg_info_dependencies.s


z,BaseDistribution._iter_egg_info_dependenciesN)r�r&cCsD|�d�s |��D]}||d<q|�d�s@|��D]}||d<q2dS)z6Add egg-info requires.txt information to the metadata.z
Requires-DistzProvides-ExtraN)�get_allr�r�)r+r��depr@r,r,r-r�Js


z'BaseDistribution._add_egg_info_requires)r,)Gr1r2r3�classmethodr5rF�bytesrJrMrSrTr4rrRrXrYrZr}r]r`rcrdrre�DistributionVersionrQrirrUr{r|r~rr�r��InfoPathr[r	r�rjrr$r��emailr��Messager��	functools�	lru_cacher�r�rrr�r�rPrr�rrr�r�r�r�r�r�r>r�r�r�r�r,r,r,r-rCjs��

		




rCc@s�eZdZdZedd�dd��Zeeeedd�dd��Z	eedd	�d
d�Z
edd�dd
�Zee
d�dd�Zdedddfeeeeeeee
d�dd�ZdS)�BaseEnvironmentz6An environment containing distributions to introspect.r%cCs
t��dSr'r()rEr,r,r-�defaultWszBaseEnvironment.default)r�r&cCs
t��dSr'r()rEr�r,r,r-�
from_paths[szBaseEnvironment.from_pathsrC)r.r&cCs
t��dS)z�Given a requirement name, return the installed distributions.

        The name may not be normalized. The implementation must canonicalize
        it for lookup.
        Nr()r+r.r,r,r-�get_distribution_sz BaseEnvironment.get_distributioncCs
t��dS)aIterate through installed distributions.

        This function should be implemented by subclass, but never called
        directly. Use the public ``iter_distribution()`` instead, which
        implements additional logic to make sure the distributions are valid.
        Nr(r*r,r,r-�_iter_distributionsgsz#BaseEnvironment._iter_distributionsccsD|��D]6}tjd|jtjd�}|s8t�d|j|j�q|VqdS)zBIterate through all installed distributions without any filtering.z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$)�flagsz%Ignoring invalid distribution %s (%s)N)r��re�matchre�
IGNORECASErprqrR)r+�distZproject_name_validr,r,r-�iter_all_distributionsps��z&BaseEnvironment.iter_all_distributionsTF)�
local_only�skip�include_editables�editables_only�	user_onlyr&csb|��}|rdd�|D�}|s,dd�|D�}|r>dd�|D�}|rPdd�|D�}�fdd�|D�S)a/Return a list of installed distributions.

        This is based on ``iter_all_distributions()`` with additional filtering
        options. Note that ``iter_installed_distributions()`` without arguments
        is *not* equal to ``iter_all_distributions()``, since some of the
        configurations exclude packages by default.

        :param local_only: If True (default), only return installations
        local to the current virtualenv, if in a virtualenv.
        :param skip: An iterable of canonicalized project names to ignore;
            defaults to ``stdlib_pkgs``.
        :param include_editables: If False, don't report editables.
        :param editables_only: If True, only report editables.
        :param user_only: If True, only report installations in the user
        site directory.
        css|]}|jr|VqdSr')r�r��dr,r,r-r��sz?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>css|]}|js|VqdSr'�r~r�r,r,r-r��scss|]}|jr|VqdSr'r�r�r,r,r-r��scss|]}|jr|VqdSr')r�r�r,r,r-r��sc3s|]}|j�kr|VqdSr')rer��r�r,r-r��s
)r�)r+r�r�r�r�r��itr,r�r-�iter_installed_distributions�sz,BaseEnvironment.iter_installed_distributionsN)r1r2r3�__doc__r�r�rr
r5r�r�r	r�rCr�rr}rr�r,r,r,r-r�Ts*	��r�c@s&eZdZUeed<ejd�dd�ZdS)rKrRr%cCs
t��dSr'r(r*r,r,r-�
as_zipfile�szWheel.as_zipfileN)r1r2r3r5rB�zipfile�ZipFiler�r,r,r,r-rK�s
rKc@s,eZdZedd�dd�Zejd�dd�ZdS)�FilesystemWheelN)rRr&cCs
||_dSr')rRr_r,r,r-�__init__�szFilesystemWheel.__init__r%cCstj|jdd�S�NT)�
allowZip64)r�r�rRr*r,r,r-r��szFilesystemWheel.as_zipfile)r1r2r3r5r�r�r�r�r,r,r,r-r��sr�c@s2eZdZeeedd�dd�Zejd�dd�Z	dS)�MemoryWheelN)rR�streamr&cCs||_||_dSr')rRr�)r+rRr�r,r,r-r��szMemoryWheel.__init__r%cCstj|jdd�Sr�)r�r�r�r*r,r,r-r��szMemoryWheel.as_zipfile)
r1r2r3r5rr�r�r�r�r�r,r,r,r-r��sr�)Gr��
email.messager�r�rn�loggingr;r�r��typingrrrrrrrr	r
rrr
rZ"pip._vendor.packaging.requirementsrZ pip._vendor.packaging.specifiersrr�pip._vendor.packaging.utilsrr�pip._vendor.packaging.versionrr�pip._internal.exceptionsr�pip._internal.locationsrr�pip._internal.models.direct_urlrrr�pip._internal.utils.compatrZpip._internal.utils.egg_linkr�pip._internal.utils.miscrr�pip._internal.utils.urlsr �_jsonr"r#�objectr�r5�PurePathr��	getLoggerr1rpr$r=r>rCr�rKr�r�r,r,r,r-�<module>sP<


�mU