File: //lib/python3/dist-packages/pip/_internal/metadata/__pycache__/base.cpython-310.pyc
o
@%Ne�K � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ d dlmZ d dlmZmZ d dlmZ d dlmZm Z d dl m Z d dl m Z m!Z! d d l"m#Z#m$Z$m%Z% d d
l&m'Z' d d l(m)Z)m*Z* d d l+m,Z,m-Z- d d
l.m/Z/ e
r�d dlm0Z0 ne1Z0eee f Z2ee3ej4f Z5e�6e7�Z8G dd� de0�Z9dee3df dee3df de3fdd�Z:G dd� de0�Z;G dd� d�Z<G dd � d e0�Z=G d d � d e=�Z>G d d � d e=�Z?dS )!� N)
�IO�
TYPE_CHECKING�
Collection� Container�Iterable�Iterator�List�Optional�Tuple�Union)� Requirement)�InvalidSpecifier� SpecifierSet)�NormalizedName)�
LegacyVersion�Version)�NoneMetadataError)�
site_packages� user_site)�DIRECT_URL_METADATA_NAME� DirectUrl�DirectUrlValidationError)� stdlib_pkgs)�egg_link_path_from_location�egg_link_path_from_sys_path)�is_local�normalize_path)� url_to_path)�Protocolc @ sB e Zd Zedefdd��Zedefdd��Zedefdd��ZdS ) �BaseEntryPoint�returnc C � t � ��N��NotImplementedError��self� r' �=/usr/lib/python3/dist-packages/pip/_internal/metadata/base.py�name6 � zBaseEntryPoint.namec C r! r" r# r% r' r' r( �value: r* zBaseEntryPoint.valuec C r! r" r# r% r' r' r( �group> r* zBaseEntryPoint.groupN)�__name__�
__module__� __qualname__�property�strr) r+ r, r' r' r' r( r 5 s r �entry.�infor c C sj | r)| d dkr)|r|d dkr|d7 }n|dd� }| dd� } | r)| d dkst 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 �..���)r4 N� �r1 �pathlib�Path)r2 r3 r' r' r( � _convert_installed_files_pathC s
�r: c @ s| e Zd Zdefdd�Zdefdd�Zedee fdd��Zedee fdd ��Z edee fd
d ��Z
edee fd d
��Z ede fdd��Z
ede fdd��Zede fdd��Zede fdd��Zedefdd��Zedefdd��Zedefdd��Zedee fd d ��Zedefd d ��Zede fd d!��Zede fd"d#��Zede fd$d%��Zede fd&d'��Z d(e de fd)d*�Z d(e de e j! fd+d,�Z"d(e defd-d.�Z#de$e% fd/d0�Z&ede'j(j)fd1d2��Z*edee fd3d4��Z+edefd5d6��Z,ede-fd7d8��Z.dFd:e/e de$e0 fd;d<�Z1de$e fd=d>�Z2dee e fd?d@�Z3dee e fdAdB�Z4dee e fdCdD�Z5dES )G�BaseDistributionr c C s | j � d| j� d| j� d�S )N� z (�))�raw_name�version�locationr% r' r' r( �__repr__b s zBaseDistribution.__repr__c C s | j � d| j� �S )Nr< )r> r? r% r' r' r( �__str__e s zBaseDistribution.__str__c C r! )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.
r# r% r' r' r( r@ h s zBaseDistribution.locationc C s8 | j }|r|�� rt|j�S dS t| j�}|r| 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 r> r@ )r& rC �
egg_link_pathr' r' r( �editable_project_locationv s
�z*BaseDistribution.editable_project_locationc C s2 t | j�}|r
|}t|�S | jr| j}t|�S 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).
N)r r> r@ r )r& �egg_linkr@ r' r' r( �installed_location� s
��z#BaseDistribution.installed_locationc C r! )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.
r# r% r' r' r( �
info_location� s z BaseDistribution.info_locationc 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)rJ r8 r9 �is_file�r& rJ r' r' r( �installed_by_distutils� s z'BaseDistribution.installed_by_distutilsc C s | 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)r@ �endswith�r& r@ r' r' r( �installed_as_egg� s
z!BaseDistribution.installed_as_eggc C �* | j }|sdS |�d�sdS 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�rJ rN r8 r9 �is_dirrL r' r' r( �"installed_with_setuptools_egg_info� s
z3BaseDistribution.installed_with_setuptools_egg_infoc C rQ )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-inforR rL r' r' r( �installed_with_dist_info� s
z)BaseDistribution.installed_with_dist_infoc C r! r" r# r% r' r' r( �canonical_name� r* z BaseDistribution.canonical_namec C r! r" r# r% r' r' r( r? � r* zBaseDistribution.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.
�-�_)r> �replacer% r' r' r( �setuptools_filename� s z$BaseDistribution.setuptools_filenamec
C sr z| � t�}W n
ty Y dS w zt�|�W S ttjtfy8 } zt �
dt| j |� W Y d}~dS d}~ww )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�warningrV )r& �content�er' r' r( rC � s* � ����zBaseDistribution.direct_urlc
C sP z| � d�}W n
tttfy Y dS w |�� D ] }|�� }|r%| S qdS )N� INSTALLER� )r[ �OSError�
ValueErrorr �
splitlines�strip)r& �installer_text�line� cleaned_liner' r' r( � installer s � �zBaseDistribution.installerc C s
t | j�S r" )�boolrG r% r' r' r( �editable! 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)rI r r% r' r' r( �local% s
zBaseDistribution.localc C �& | j d u s td u r dS | j �tt��S �NF)rI r �
startswithr r% r' r' r( � in_usersite/ � z BaseDistribution.in_usersitec C rr rs )rI r rt r r% r' r' r( �in_site_packages5 rv z!BaseDistribution.in_site_packages�pathc C r! )z7Check whether an entry in the info directory is a file.r# �r& rx r' r' r( rK ; r* zBaseDistribution.is_filec C r! )a$ Iterate through a directory in the info directory.
Each item yielded would be a path relative to the info directory.
:raise FileNotFoundError: If ``name`` does not exist in the directory.
:raise NotADirectoryError: If ``name`` does not point to a directory.
r# ry r' r' r( �iterdir? s zBaseDistribution.iterdirc C r! )z�Read a file in the info directory.
:raise FileNotFoundError: If ``name`` does not exist in the directory.
:raise NoneMetadataError: If ``name`` exists in the info directory, but
cannot be read.
r# ry r' r' r( r[ I � zBaseDistribution.read_textc C r! r" r# r% r' r' r( �iter_entry_pointsR � z"BaseDistribution.iter_entry_pointsc C r! )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# r% r' r' r( �metadataU s zBaseDistribution.metadatac 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 rV r% r' r' r( r> e s zBaseDistribution.raw_namec
C sl | j �d�}|du r
t� S z tt|��}W |S ty5 } zd}t�|| j|� t� W Y d}~S d}~ww )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 r1 r
ra rb r> )r& r+ �specrd �messager' r' r( �requires_pythonl s ���z BaseDistribution.requires_pythonr' �extrasc C r! )z�Dependencies of this distribution.
For modern .dist-info distributions, this is the collection of
"Requires-Dist:" entries in distribution metadata.
r# )r& r� r' r' r( �iter_dependencies � z"BaseDistribution.iter_dependenciesc C r! )z�Extras provided by this distribution.
For modern .dist-info distributions, this is the collection of
"Provides-Extra:" entries in distribution metadata.
r# r% r' r' r( �iter_provided_extras� r� z%BaseDistribution.iter_provided_extrasc C s< z| � d�}W n
ty Y d S w dd� t�|�� �D �S )N�RECORDc s s" � | ] }t t�|d ��V qdS )r Nr7 )�.0�rowr' r' r( � <genexpr>� s � zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)r[ r\ �csv�readerri )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 w dd� |jdd�D �}| j}| j}|d u s+|d u r-|S z
t�|��|�� W n tyB | Y S w � j sH|S � fdd�|D �S )Nzinstalled-files.txtc s s � | ]}|r|V qd S r" r' �r� �pr' r' r( r� � s � zFBaseDistribution._iter_declared_entries_from_legacy.<locals>.<genexpr>F)�keependsc 3 s$ � | ]
}t t�|�j� j�V qd S r" )r: r8 r9 �partsr� ��info_relr' r( r� � s
� �
�)
r[ r\ ri r@ rJ r8 r9 � relative_torh r� )r& r� �paths�rootr3 r' r� r( �"_iter_declared_entries_from_legacy� s( � �
�z3BaseDistribution._iter_declared_entries_from_legacyc C s | � � p| �� S )a� Iterate through file entires 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_entriesN)r' )6r- r. r/ r1 rA rB r0 r r@ rG rI rJ ro rM rP rT rU r rV �DistributionVersionr? rZ r rC rn rp rq ru rw �InfoPathrK r r8 �
PurePosixPathrz r[ r r r| �emailr� �Messager~ r� r> r r� r r r� r� r� r� r� r' r' r' r( r; a sl
r; c @ s� e Zd ZdZeddd��Zedeee dd fdd��Z deded fd
d �Z
de d fd d
�Z de d fdd�Z
dedddfdedee dededede e f dd�ZdS )�BaseEnvironmentz6An environment containing distributions to introspect.r c C r! r" r# )�clsr' r' r( �default� r* zBaseEnvironment.defaultr� c C r! r" r# )r� r� r' r' r( �
from_paths� r* zBaseEnvironment.from_pathsr) r; c C r! )z�Given a requirement name, return the installed distributions.
The name may not be normalized. The implementation must canonicalize
it for lookup.
r# )r& r) r' r' r( �get_distribution� r� z BaseEnvironment.get_distributionc C r! )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.
r# r% r' r' r( �_iter_distributions� r{ z#BaseEnvironment._iter_distributionsc c sF � | � � D ]}tjd|jtjd�}|s t�d|j|j� q|V qdS )z(Iterate through installed distributions.z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$)�flagsz%Ignoring invalid distribution %s (%s)N)r� �re�matchrV �
IGNORECASEra rb r@ )r& �dist�project_name_validr' r' r( �iter_distributions� s � ���z"BaseEnvironment.iter_distributionsTF�
local_only�skip�include_editables�editables_only� user_onlyc sb | � � }|r
dd� |D �}|sdd� |D �}|r dd� |D �}|r(dd� |D �}� fdd�|D �S )a Return a list of installed distributions.
: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 � � | ]}|j r|V qd S r" )rq �r� �dr' r' r( r� � � z?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>c s s � | ]}|j s|V qd S r" �rp r� r' r' r( r� r� c s r� r" r� r� r' r' r( r� r� c s r� r" )ru r� r' r' r( r� r� c 3 s � | ]
}|j � vr|V qd S r" )rV r� �r� r' r( r�
s � )r� )r& r� r� r� r� r� �itr' r� r( � iter_installed_distributions� s z,BaseEnvironment.iter_installed_distributionsN)r r� )r- r. r/ �__doc__� classmethodr� r r r1 r� r� r r� r� r ro r r; r� r' r' r' r( r� � s6 �������r� c @ s& e Zd ZU eed< dejfdd�ZdS )�Wheelr@ r c C r! r" r# r% r' r' r( �
as_zipfile r} zWheel.as_zipfileN)r- r. r/ r1 �__annotations__�zipfile�ZipFiler� r' r' r' r( r�
s
r� c @ s. e Zd Zdeddfdd�Zdejfdd�ZdS )�FilesystemWheelr@ r Nc C s
|| _ d S r" )r@ rO r' r' r( �__init__ s
zFilesystemWheel.__init__c C � t j| jdd�S �NT)�
allowZip64)r� r� r@ r% r' r' r( r� � zFilesystemWheel.as_zipfile)r- r. r/ r1 r� r� r� r� r' r' r' r( r� s r� c @ s6 e Zd Zdedee ddfdd�Zdejfdd�Z dS ) � MemoryWheelr@ �streamr Nc C s || _ || _d S r" )r@ r� )r& r@ r� r' r' r( r� s
zMemoryWheel.__init__c C r� r� )r� r� r� r% r' r' r( r� ! r� zMemoryWheel.as_zipfile)
r- r. r/ r1 r �bytesr� r� r� r� r' r' r' r( r� s r� )@r� �
email.messager� r_ �loggingr8 r� r� �typingr r r r r r r r r
r �"pip._vendor.packaging.requirementsr � pip._vendor.packaging.specifiersr
r �pip._vendor.packaging.utilsr � pip._vendor.packaging.versionr r �pip._internal.exceptionsr �pip._internal.locationsr r � pip._internal.models.direct_urlr r r �pip._internal.utils.compatr � pip._internal.utils.egg_linkr r �pip._internal.utils.miscr r �pip._internal.utils.urlsr r �objectr� r1 r� r� � getLoggerr- ra r r: r; r� r� r� r� r' r' r' r( �<module> sP 0
�
�
� ^P