U
ʗRea @ s d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m
Z
m Z m Z m
Z
mZmZmZmZmZmZmZmZmZ d dlmZ d dlmZmZ d dl m Z d dl m Z m Z d dl!m"Z" d dl#m$Z$m%Z%m&Z& d d l'm(Z(m)Z)m*Z* d d
l+m,Z, d d l-m.Z. d d l/m0Z0m1Z1 d d
l2m3Z3 d dl4m5Z5 ddl6m7Z7 e rHd dl m8Z8 ne9Z8ee e f Z:ee;eje?Z@G dd de8ZAee;df ee;df e;dddZBG dd deZCG dd de8ZDG d d d ZEG d d d e8ZFG d d! d!eFZGG d"d# d#eFZHdS )$ N)
IO
TYPE_CHECKINGAny
Collection ContainerDictIterableIteratorList
NamedTupleOptionalTupleUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedName)
LegacyVersionVersion)NoneMetadataError)
get_scheme
site_packages user_site)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError) stdlib_pkgs)egg_link_path_from_sys_path)is_localnormalize_path)
safe_extra) url_to_path ) msg_to_json)Protocolc @ sB e Zd ZeedddZeedddZeedddZdS ) BaseEntryPointreturnc C s
t d S NNotImplementedErrorself r- /builddir/build/BUILDROOT/alt-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/site-packages/pip/_internal/metadata/base.pyname: s zBaseEntryPoint.namec C s
t d S r( r) r+ r- r- r. value> s zBaseEntryPoint.valuec C s
t d S r( r) r+ r- r- r. groupB s zBaseEntryPoint.groupN)__name__
__module__ __qualname__propertystrr/ r0 r1 r- r- r- r. r% 9 s r% .)entryinfor' c C sV | rD| d dkrD|r |d dkr*|d7 }n |dd }| dd } q t tj|| 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 ..)r9 Nr" r6 pathlibPath)r7 r8 r- r- r. _convert_installed_files_pathG s
r> c @ s& e Zd ZU eed< eed< eed< dS )
RequiresEntry requirementextramarkerN)r2 r3 r4 r6 __annotations__r- r- r- r. r? e s
r? c @ sR e Zd Zeed dddZeded dddZedd d
Zedd d Ze e
e dd
dZ e e
e dddZ e e
e dddZ
e e
e dddZe edddZe edddZe edddZe eddd Ze edd d Ze edd d Ze edd!d"Ze e
e dd#d$Ze edd%d&Ze edd'd(Z e edd)d*Z e edd+d,Z e edd-d.Z e edd/d0Z e!ed1d2d3Z"e#e dd4d5Z$e!ed1d6d7Z%e&e' dd8d9Z(e)j*j+dd:d;Z,e-j.dd?Z/e e)j*j+dd@dAZ0e e1ee2f ddBdCZ3e e
e ddDdEZ4e eddFdGZ5e e6ddHdIZ7dbe8e e&e9 dKdLdMZ:e&e ddNdOZ;e
e#e ddPdQZe#e? ddVdWZ@e&e ddXdYZAe&e ddZd[ZBe)j*j+d\d]d^d_ZCe edd`daZDd\S )cBaseDistribution) directoryr' c C s
t dS )zLoad the distribution from a metadata directory.
:param directory: Path to a metadata directory, e.g. ``.dist-info``.
Nr) )clsrE r- r- r. from_directoryl s z BaseDistribution.from_directoryWheel)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) )rF rI r/ r- r- r.
from_wheelt s zBaseDistribution.from_wheelr& c C s | j d| j d| j dS )N z ())raw_nameversionlocationr+ r- r- r. __repr__ s zBaseDistribution.__repr__c C s | j d| j S )NrK )rM rN r+ r- r- r. __str__ s zBaseDistribution.__str__c 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. rO s zBaseDistribution.locationc C s6 | j }|r | r2t|jS nt| j}|r2| jS dS )zThe 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_urlis_local_editabler! urlr rM rO )r, rR
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_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)rX r< r= is_filer, rX r- r- r. installed_by_distutils s z'BaseDistribution.installed_by_distutilsc C s | j }|sdS |dS )zWhether this distribution is installed as an egg.
This usually indicates the distribution was installed by (older versions
of) easy_install.
Fz.egg)rO endswithr, rO r- r- r. installed_as_egg s z!BaseDistribution.installed_as_eggc C s* | j }|sdS |ds 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-inforX r\ r< r= is_dirrZ r- r- r. "installed_with_setuptools_egg_info s
z3BaseDistribution.installed_with_setuptools_egg_infoc C s* | j }|sdS |ds 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_infoc C s
t d S r( r) r+ r- r- r. canonical_name s z BaseDistribution.canonical_namec C s
t d S r( r) r+ r- r- r. rN s zBaseDistribution.versionc C s | j ddS )zConvert a project name to its setuptools-compatible filename.
This is a copy of ``pkg_resources.to_filename()`` for compatibility.
-_)rM replacer+ r- r- r. setuptools_filename s z$BaseDistribution.setuptools_filenamec
C sz z| t}W n tk
r$ Y dS X z t|W S ttjtfk
rt } z t
dt| j | W Y dS d}~X Y nX dS )zObtain 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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorr loggerwarningrc )r, contenter- r- r. rR s$ zBaseDistribution.direct_urlc
C sR z| d}W n tttfk
r* Y dS X | D ]}| }|r4| S q4dS )N INSTALLER )rh OSError
ValueErrorr
splitlinesstrip)r, installer_textline cleaned_liner- r- r. installer. s
zBaseDistribution.installerc C s
| dS )N REQUESTED)rY r+ r- r- r. requested: s zBaseDistribution.requestedc C s
t | jS r( )boolrV r+ r- r- r. editable> s zBaseDistribution.editablec C s | j dkrdS t| j S )z|If distribution is installed in the current virtual environment.
Always True if we're not in a virtualenv.
NF)rW r r+ r- r- r. localB s
zBaseDistribution.localc C s& | j d kstd krdS | j ttS NF)rW r
startswithr r+ r- r- r. in_usersiteL s z BaseDistribution.in_usersitec C s& | j d kstd krdS | j ttS r )rW r r r r+ r- r- r. in_site_packagesR s z!BaseDistribution.in_site_packages)pathr' c C s
t dS )z7Check whether an entry in the info directory is a file.Nr) r, r r- r- r. rY X s zBaseDistribution.is_filec C s
t dS )zFind 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_names\ s z,BaseDistribution.iter_distutils_script_namesc C s
t dS )zRead 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. rh d s zBaseDistribution.read_textc C s
t d S r( r) r+ r- r- r. iter_entry_pointsm s z"BaseDistribution.iter_entry_pointsc C s
t d S r( r) r+ r- r- r. _metadata_implp s z BaseDistribution._metadata_implr" )maxsizec C s | }| | |S r( )r _add_egg_info_requires)r, metadatar- r- r. _metadata_cacheds s
z!BaseDistribution._metadata_cachedc 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 r+ r- r- r. r { s zBaseDistribution.metadatac C s
t | jS )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 dS )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| jS )z*Value of "Name:" in distribution metadata.Name)r r rc r+ r- r- r. rM s zBaseDistribution.raw_namec
C sp | j d}|dkrt S ztt|}W n@ tk
rj } z"d}t|| j| t W Y S d}~X Y nX |S )zValue 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 r6 r rn ro rM )r, r0 specrq messager- r- r. requires_python s z BaseDistribution.requires_pythonr- )extrasr' c C s
t dS )zDependencies 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_dependenciesc C s
t dS )zExtras provided by this distribution.
For modern .dist-info distributions, this is the collection of
"Provides-Extra:" entries in distribution metadata.
Nr) r+ r- r- r. iter_provided_extras s z%BaseDistribution.iter_provided_extrasc C s> z| d}W n tk
r$ Y d S X dd t| D S )NRECORDc s s | ]}t t|d V qdS )r Nr; ).0rowr- r- r. s zFBaseDistribution._iter_declared_entries_from_record..)rh ri csvreaderrv )r, textr- r- r. "_iter_declared_entries_from_record s
z3BaseDistribution._iter_declared_entries_from_recordc s z| d}W n tk
r$ Y d S X dd |jddD }| j}| j}|d ksX|d kr\|S zt|| W n tk
r | Y S X j s|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..F)keependsc 3 s" | ]}t t|j jV qd S r( )r> r< r= partsr info_relr- r. r s )
rh ri rv rO rX r< r= relative_toru r )r, r pathsrootr8 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_entriesc c s z| d}W n tk
r$ Y dS X d }}| D ]X}| }|r6|drRq6|dr~|dr~|dd\}}}q6t|||d V q6dS )
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.txtNrs #[]z[]:)r@ rA rB )rh ri rv rw r r\ partitionr? )r, rp rA rB ry re r- r- r. _iter_requires_txt_entries s z+BaseDistribution._iter_requires_txt_entriesc c s8 dh}| D ]$}|j|kr q||j |jV qdS )z'Get extras from the egg-info directory.rs N)r rA add)r, known_extrasr7 r- r- r. _iter_egg_info_extras s
z&BaseDistribution._iter_egg_info_extrasc c s | D ]x}|jr4|jr4d|j dt|j d}n,|jrNdt|j d}n|jr\|j}nd}|rx|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 == "rs z ; N)r rA rB r r@ )r, r7 rB r- r- r. _iter_egg_info_dependencies s
z,BaseDistribution._iter_egg_info_dependenciesN)r r' c C sD | ds | D ] }||d< q| ds@| D ] }||d< q2dS )z6Add egg-info requires.txt information to the metadata.z
Requires-DistzProvides-ExtraN)get_allr r )r, r deprA r- r- r. r * s
z'BaseDistribution._add_egg_info_requiresc C s( t | j}|t tdjdd S )zr
Return True if given Distribution is installed in
path matching distutils_scheme layout.
rs pythonr )r rW r r purelibsplit)r, norm_pathr- r- r. in_install_path3 s
z BaseDistribution.in_install_path)r- )Er2 r3 r4 classmethodr6 rG rJ rP rQ r5 r rO rV rW rX r~ r[ r^ ra rb r rc DistributionVersionrN rg r rR r{ r} r r r r InfoPathrY r r rh r r% r emailr Messager functools lru_cacher r r r r r rM r r r r r r r r r r? r r r r r r- r- r- r. rD k s
rD c @ s e Zd ZdZed dddZeeee d dddZ eed d d
d Z
e d dd d
Z e e
dddZdedddfeee eeee e
dddZdS )BaseEnvironmentz6An environment containing distributions to introspect.r& c C s
t d S r( r) )rF r- r- r. defaultA s zBaseEnvironment.default)r r' c C s
t d S r( r) )rF r r- r- r.
from_pathsE s zBaseEnvironment.from_pathsrD )r/ r' c C s
t dS )zGiven 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_distributionI s z BaseEnvironment.get_distributionc 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_distributionsQ s z#BaseEnvironment._iter_distributionsc c sD | D ]6}tjd|jtjd}|s8td|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 rematchrc
IGNORECASErn ro rO )r, distproject_name_validr- r- r. iter_all_distributionsZ s z&BaseEnvironment.iter_all_distributionsTF)
local_onlyskipinclude_editableseditables_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 s z?BaseEnvironment.iter_installed_distributions..c s s | ]}|j s|V qd S r( r r r- r- r. r s c s s | ]}|j r|V qd S r( r r r- r- r. r s c s s | ]}|j r|V qd S r( )r r r- r- r. r s c 3 s | ]}|j kr|V qd S r( )rc r r r- r. r s
)r )r, r r r r r itr- r r. iter_installed_distributionso s z,BaseEnvironment.iter_installed_distributionsN)r2 r3 r4 __doc__r r r r
r6 r r r r rD r r r~ r r r- r- r- r. r > s* r c @ s& e Zd ZU eed< ejdddZdS )rH rO r& c C s
t d S r( r) r+ r- r- r.
as_zipfile s zWheel.as_zipfileN)r2 r3 r4 r6 rC zipfileZipFiler r- r- r- r. rH s
rH c @ s, e Zd ZeddddZejdddZdS )FilesystemWheelN)rO r' c C s
|| _ d S r( )rO r] r- r- r. __init__ s zFilesystemWheel.__init__r& c C s t j| jddS NT)
allowZip64)r r rO r+ r- r- r. r s zFilesystemWheel.as_zipfile)r2 r3 r4 r6 r r r r r- r- r- r. r s r c @ s2 e Zd Zeee ddddZejdddZ dS ) MemoryWheelN)rO streamr' c C s || _ || _d S r( )rO r )r, rO r r- r- r. r s zMemoryWheel.__init__r& c C s t j| jddS r )r r r r+ r- r- r. r s zMemoryWheel.as_zipfile)
r2 r3 r4 r6 r bytesr r r r r- r- r- r. r s r )Ir
email.messager r rl loggingr< r r typingr r r r r r r r r
r r r
r "pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr r pip._vendor.packaging.utilsr Z pip._vendor.packaging.versionr r pip._internal.exceptionsr pip._internal.locationsr r 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.packagingr pip._internal.utils.urlsr! _jsonr# r$ objectr r6 PurePathr getLoggerr2 rn r% r> r? rD r rH r r r- r- r- r. sR <
VU