/usr/local/lib/python3.9/site-packages/pip/_internal/metadata/__pycache__
a ���hLc � @ s� d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl m Z m Z mZmZ d dlmZmZmZmZmZ d dlmZ d dlmZmZ d dlm Z m Z d dl m Z d d l m!Z! d d l"m#Z#m$Z$ d d l%m&Z&m'Z'm(Z( d d l)m*Z* d d l+m,Z, d dl-m.Z.m/Z/ d dl0m1Z1 ddl2m3Z3 ee4ej5f Z6e�7e8�Z9G dd� de�Z:dddd�dd�Z;G dd� de�Z<G dd � d e�Z=G d d � d �Z>G d d � d e�Z?G d!d"� d"e?�Z@G d#d$� d$e?�ZAdS )%� )� annotationsN)� Collection� Container�Iterable�Iterator)�IO�Any� NamedTuple�Protocol�Union)� Requirement)�InvalidSpecifier� SpecifierSet)�NormalizedName�canonicalize_name)�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_jsonc @ sB e Zd Zedd�dd��Zedd�dd��Zedd�dd��Zd S ) �BaseEntryPoint�str��returnc C s t � �d S �N��NotImplementedError��self� r( �E/usr/local/lib/python3.9/site-packages/pip/_internal/metadata/base.py�name- s zBaseEntryPoint.namec C s t � �d S r# r$ r& r( r( r) �value1 s zBaseEntryPoint.valuec C s t � �d S r# r$ r& r( r( r) �group5 s zBaseEntryPoint.groupN)�__name__� __module__� __qualname__�propertyr* r+ r, r( r( r( r) r , s r ztuple[str, ...]r )�entry�infor" c C s\ | rD| d dkrD|r |d dkr*|d7 }n |dd� }| dd� } q t tjg |�| �R � �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 �..���)r3 Nr �r �pathlib�Path)r1 r2 r( r( r) � _convert_installed_files_path: s r8 c @ s& e Zd ZU ded< ded< ded< dS )� RequiresEntryr � requirement�extra�markerN)r- r. r/ �__annotations__r( r( r( r) r9 X s r9 c @ s� e Zd Zedd d�dd��Zedddd d�dd��Zed dd d �d d ��Zdd �dd�Zdd �dd�Ze dd �dd��Z e dd �dd��Z e dd �dd��Z e dd �dd��Z e dd �d d ��Ze dd �d d ��Ze dd �d d!��Ze dd �d"d#��Ze d$d �d%d&��Ze d'd �d(d)��Ze dd �d*d+��Ze dd �d,d-��Ze d.d �d/d0��Ze dd �d1d2��Ze dd �d3d4��Ze dd �d5d6��Ze dd �d7d8��Ze dd �d9d:��Ze dd �d;d<��Z d=dd>�d?d@�Z dAd �dBdC�Z d=dd>�dDdE�Z dFd �dGdH�Z dId �dJdK�Z!e"j#dId �dLdM��Z$e dNd �dOdP��Z%e dd �dQdR��Z&e dd �dSdT��Z'e dUd �dVdW��Z(dwdYdZd[�d\d]�Z)d^d �d_d`�Z*dad �dbdc�Z+ddd �dedf�Z,ddd �dgdh�Z-ddd �didj�Z.dkd �dldm�Z/d^d �dndo�Z0d^d �dpdq�Z1dIdrds�dtdu�Z2dvS )x�BaseDistributionr )� directoryr" c C s t � �dS )z�Load the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. Nr$ )�clsr? r( r( r) �from_directory_ s z BaseDistribution.from_directory�bytes)�metadata_contents�filename� project_namer" c C s 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$ )r@ rC rD rE r( r( r) �from_metadata_file_contentsg s z,BaseDistribution.from_metadata_file_contents�Wheel)�wheelr* r" c C s t � �dS )a Load 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$ )r@ rH r* r( r( r) � from_wheely s zBaseDistribution.from_wheelr! c C s | j � d| j� d| j� d�S )N� z (�))�raw_name� raw_version�locationr& r( r( r) �__repr__� s zBaseDistribution.__repr__c C s | j � d| j� �S )NrJ )rL rM r& r( r( r) �__str__� s zBaseDistribution.__str__z str | Nonec C s 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) rN � s zBaseDistribution.locationc C s6 | j }|r |�� r2t|j�S nt| j�}|r2| jS dS )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_url�is_local_editabler �urlr rL rN )r' rQ � egg_link_pathr( r( r) �editable_project_location� s z*BaseDistribution.editable_project_locationc C s 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� s z#BaseDistribution.installed_locationc C s 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� s z BaseDistribution.info_location�boolc C s | j }|sdS t�|��� S )a Whether 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)rW r6 r7 �is_file�r' rW r( r( r) �installed_by_distutils� s z'BaseDistribution.installed_by_distutilsc C s | j }|sdS t�|�jdkS )z�Whether this distribution is installed as an egg. This usually indicates the distribution was installed by (older versions of) easy_install. Fz.egg)rN r6 r7 �suffix�r' rN r( r( r) �installed_as_egg� s z!BaseDistribution.installed_as_eggc C s* | j }|sdS |�d�s dS t�|��� 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�rW �endswithr6 r7 �is_dirrZ r( r( r) �"installed_with_setuptools_egg_info� s z3BaseDistribution.installed_with_setuptools_egg_infoc C s* | j }|sdS |�d�s dS t�|��� S )aa Whether 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-infor_ rZ r( r( r) �installed_with_dist_info� s z)BaseDistribution.installed_with_dist_infor c C s t � �d S r# r$ r& r( r( r) �canonical_name s z BaseDistribution.canonical_namer c C s t � �d S r# r$ r& r( r( r) �version s zBaseDistribution.versionc C s t � �d S r# r$ r& r( r( r) rM s z BaseDistribution.raw_versionc C s | j �dd�S )z�Convert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. �-�_)rL �replacer& r( r( r) �setuptools_filename s z$BaseDistribution.setuptools_filenamezDirectUrl | Nonec C sv z| � t�}W n ty" Y dS 0 z t�|�W S ttjtfyp } z t � dt| j |� W Y d}~dS d}~0 0 dS )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�warningrd )r' �content�er( r( r) rQ s$ � �zBaseDistribution.direct_urlc C sP z| � d�}W n tttfy( Y dS 0 |�� D ]}|�� }|r2| S q2dS )N� INSTALLER� )rj �OSError� ValueErrorr � splitlines�strip)r' Zinstaller_text�lineZ cleaned_liner( r( r) � installer9 s zBaseDistribution.installerc C s | � d�S )N� REQUESTED)rY r& r( r( r) � requestedE s zBaseDistribution.requestedc C s t | j�S r# )rX rU r& r( r( r) �editableI s zBaseDistribution.editablec C s | j du rdS t| j �S )z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)rV r r& r( r( r) �localM s zBaseDistribution.localc C s& | j d u std u rdS | j �tt��S �NF)rV r � startswithr r& r( r( r) � in_usersiteW s z BaseDistribution.in_usersitec C s& | j d u std u rdS | j �tt��S r� )rV r r� r r& r( r( r) �in_site_packages] s z!BaseDistribution.in_site_packages�InfoPath)�pathr" c C s t � �dS )z7Check whether an entry in the info directory is a file.Nr$ �r' r� r( r( r) rY c s zBaseDistribution.is_filez Iterator[str]c C s 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_namesg s z,BaseDistribution.iter_distutils_script_namesc C s 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) rj o s zBaseDistribution.read_textzIterable[BaseEntryPoint]c C s t � �d S r# r$ r& r( r( r) �iter_entry_pointsx s z"BaseDistribution.iter_entry_pointszemail.message.Messagec C s t � �d S r# r$ r& r( r( r) �_metadata_impl{ s z BaseDistribution._metadata_implc C s | � � }| �|� |S )a Metadata 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� �_add_egg_info_requires)r' �metadatar( r( r) r� ~ s zBaseDistribution.metadatazdict[str, Any]c C s t | j�S )a PEP 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 z BaseDistribution.metadata_dictc C s | j �d�S )zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)r� �getr& r( r( r) �metadata_version� s z!BaseDistribution.metadata_versionc C s | j �d| j�S )z*Value of "Name:" in distribution metadata.�Name)r� r� rd r& r( r( r) rL � s zBaseDistribution.raw_namer c C sn | j �d�}|du rt� S ztt|��}W n> tyh } z&d}t�|| j|� t� W Y d}~S d}~0 0 |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� r r r rp rq rL )r' r+ �specrs �messager( r( r) �requires_python� s z BaseDistribution.requires_pythonr( zCollection[str]zIterable[Requirement])�extrasr" c C s 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� s z"BaseDistribution.iter_dependenciesz Iterable[str]c C s | j �dg �S )zRaw Requires-Dist metadata.� Requires-Dist)r� �get_allr& r( r( r) �iter_raw_dependencies� s z&BaseDistribution.iter_raw_dependencieszIterable[NormalizedName]c C s t � �dS )aj 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 expected to be normalised names, per PEP 685, with the returned value being handled appropriately by `iter_dependencies`. Nr$ r& r( r( r) �iter_provided_extras� s z%BaseDistribution.iter_provided_extraszIterator[str] | Nonec C s< z| � d�}W n ty" Y d S 0 dd� t�|�� �D �S )N�RECORDc s s | ]}t t�|d ��V qdS )r Nr5 )�.0�rowr( r( r) � <genexpr>� � zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)rj rk �csv�readerrx )r' �textr( r( r) �"_iter_declared_entries_from_record� s z3BaseDistribution._iter_declared_entries_from_recordc s� z| � d�}W n ty" Y d S 0 dd� |jdd�D �}| j}| j}|d u sV|d u rZ|S zt�|��|�� W n ty� | Y S 0 � j s�|S � fdd�|D �S )Nzinstalled-files.txtc s s | ]}|r|V qd S r# r( �r� �pr( r( r) r� � r� zFBaseDistribution._iter_declared_entries_from_legacy.<locals>.<genexpr>F)�keependsc 3 s" | ]}t t�|�j� j�V qd S r# )r8 r6 r7 �partsr� �Zinfo_relr( r) r� � s �) rj rk rx rN rW r6 r7 � relative_torw r� )r' r� �paths�rootr2 r( r� r) �"_iter_declared_entries_from_legacy� s$ �z3BaseDistribution._iter_declared_entries_from_legacyc C s | � � 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_entrieszIterator[RequiresEntry]c c s� z| � d�}W n ty" Y dS 0 d }}|�� D ]X}|�� }|r4|�d�rPq4|�d�r||�d�r||�d��d�\}}}q4t|||d �V q4dS ) 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. z requires.txtNru �#�[�]z[]�:)r: r; r< )rj rk rx ry r� r` � partitionr9 )r' rr r; r< rz rg r( r( r) �_iter_requires_txt_entries� s z+BaseDistribution._iter_requires_txt_entriesc c s< dh}| � � D ](}t|j�}||v r&q|�|� |V qdS )z'Get extras from the egg-info directory.ru N)r� r r; �add)r' Z known_extrasr1 r; r( r( r) �_iter_egg_info_extras s z&BaseDistribution._iter_egg_info_extrasc c s� | � � D ]r}t|j�}|r6|jr6d|j� d|� d�}n$|rHd|� d�}n|jrV|j}nd}|rr|j� d|� �V q|jV qdS )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 == "ru z ; N)r� r r; r< r: )r' r1 r; r< r( r( r) �_iter_egg_info_dependencies s z,BaseDistribution._iter_egg_info_dependencies�None)r� r" c C sD |� d�s | �� D ] }||d< q|� d�s@| �� D ] }||d< q2dS )z6Add egg-info requires.txt information to the metadata.r� zProvides-ExtraN)r� r� r� )r' r� �depr; r( r( r) r� 9 s z'BaseDistribution._add_egg_info_requiresN)r( )3r- r. r/ � classmethodrA rF rI rO rP r0 rN rU rV rW r[ r^ rb rc rd re rM ri rQ r{ r} r~ r r� r� rY r� rj r� r� � functools�cached_propertyr� r� r� rL r� r� r� r� r� r� r� r� r� r� r� r( r( r( r) r> ^ s� r> c @ s� e Zd ZdZed d�dd��Zedd d�dd��Zd d d �d d �Zdd�dd�Zdd�dd�Z de dddfddddddd�dd�Z dS )�BaseEnvironmentz6An environment containing distributions to introspect.r! c C s t � �d S r# r$ )r@ r( r( r) �defaultF s zBaseEnvironment.defaultzlist[str] | None)r� r" c C s t � �d S r# r$ )r@ r� r( r( r) � from_pathsJ s zBaseEnvironment.from_pathsr zBaseDistribution | None)r* r" c C s 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_distributionN s z BaseEnvironment.get_distributionzIterator[BaseDistribution]c C s t � �dS )a Iterate 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_distributionsV s z#BaseEnvironment._iter_distributionsc c sD | � � D ]6}tjd|jtjd�}|s8t�d|j|j� q|V qdS )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�matchrd � IGNORECASErp rq rN )r' �dist�project_name_validr( r( r) �iter_all_distributions_ s ��z&BaseEnvironment.iter_all_distributionsTFrX zContainer[str])� local_only�skip�include_editables�editables_only� user_onlyr" c sb | � � }|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. c s s | ]}|j r|V qd S r# )r �r� �dr( r( r) r� � r� z?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>c s s | ]}|j s|V qd S r# �r~ r� r( r( r) r� � r� c s s | ]}|j r|V qd S r# r� r� r( r( r) r� � r� c s s | ]}|j r|V qd S r# )r� r� r( r( r) r� � r� c 3 s | ]}|j � vr|V qd S r# )rd r� �r� r( r) r� � r� )r� )r' r� r� r� r� r� �itr( r� r) � iter_installed_distributionst s z,BaseEnvironment.iter_installed_distributionsN) r- r. r/ �__doc__r� r� r� r� r� r� r r� r( r( r( r) r� C s �r� c @ s$ e Zd ZU ded< dd�dd�ZdS )rG r rN �zipfile.ZipFiler! c C s t � �d S r# r$ r& r( r( r) � as_zipfile� s zWheel.as_zipfileN)r- r. r/ r= r� r( r( r( r) rG � s rG c @ s* e Zd Zddd�dd�Zdd�dd �Zd S ) �FilesystemWheelr r� )rN r" c C s || _ d S r# )rN r] r( r( r) �__init__� s zFilesystemWheel.__init__r� r! c C s t j| jdd�S �NT)� allowZip64)�zipfile�ZipFilerN r& r( r( r) r� � s zFilesystemWheel.as_zipfileN�r- r. r/ r� r� r( r( r( r) r� � s r� c @ s, e Zd Zdddd�dd�Zdd�d d �Zd S ) � MemoryWheelr z IO[bytes]r� )rN �streamr" c C s || _ || _d S r# )rN r� )r' rN r� r( r( r) r� � s zMemoryWheel.__init__r� r! c C s t j| jdd�S r� )r� r� r� r& r( r( r) r� � s zMemoryWheel.as_zipfileNr� r( r( r( r) r� � s r� )B� __future__r r� � email.message�emailr� rn �loggingr6 r� r� �collections.abcr r r r �typingr r r r r Z"pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr r �pip._vendor.packaging.utilsr r Z pip._vendor.packaging.versionr �pip._internal.exceptionsr �pip._internal.locationsr r � pip._internal.models.direct_urlr r r �pip._internal.utils.compatr � pip._internal.utils.egg_linkr �pip._internal.utils.miscr r �pip._internal.utils.urlsr �_jsonr r �PurePathr� � getLoggerr- rp r r8 r9 r> r� rG r� r� r( r( r( r) �<module> sF hU
.
Edit
..
Edit
__init__.cpython-39.pyc
Edit
_json.cpython-39.pyc
Edit
base.cpython-39.pyc
Edit
pkg_resources.cpython-39.pyc
Edit