R`if Z 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 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 l0m1Z1m2Z2 d d
l3m4Z4 ddl5m6Z6 e rd dl m7Z7 ne8Z7ee e!f Z9ee:ejv f Z< ejz e> Z? G d de7 Z@dee:df dee:df de:fdZA G d de ZB G d de7 ZC G d d ZD G d d e7 ZE G d d!eE ZF G d" d#eE ZGy)$ N)
IO
TYPE_CHECKINGAny
Collection ContainerDictIterableIteratorList
NamedTupleOptionalTupleUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedNamecanonicalize_name)
LegacyVersionVersion)NoneMetadataError)
get_scheme
site_packages user_site)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError) stdlib_pkgs)egg_link_path_from_sys_path)is_localnormalize_path) url_to_path ) msg_to_json)Protocolc N e Zd Zedefd Zedefd Zedefd Zy)BaseEntryPointreturnc t NNotImplementedErrorselfs /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_internal/metadata/base.pynamezBaseEntryPoint.name9 !## c t r* r+ r- s r/ valuezBaseEntryPoint.value= r1 r2 c t r* r+ r- s r/ groupzBaseEntryPoint.groupA r1 r2 N)__name__
__module__ __qualname__propertystrr0 r4 r6 r2 r/ r' r' 8 sQ
$c $ $ $s $ $ $s $ $r2 r' entry.infor( c | r-| d dk( r%|r|d dk( r|dz
}n|dd }| dd } | r | d dk( r%t t j g || 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 ..)r@ Nr# r; pathlibPath)r= r> s r/ _convert_installed_files_pathrE F sm * E!H$tBx4' GOD9Dab E!H$ w||*T*E* ++r2 c , e Zd ZU eed< eed< eed< y)
RequiresEntry requirementextramarkerN)r7 r8 r9 r; __annotations__r< r2 r/ rG rG d s J Kr2 rG c e Zd Zededd fd Zededededd fd Zedd d
edd fd Zdefd Z defd
Z
e de e fd Z
e de e fd Ze de e fd Ze de e fd Ze defd Ze defd Ze defd Ze defd Ze defd Ze defd Ze defd Ze de e fd Z e defd Z e defd Z e defd Z e defd Z e defd Z!e defd Z"d e#defd!Z$de%e fd"Z&d e#defd#Z'de(e) fd$Z*de+jX jZ fd%Z. e/j` d&' de+jX jZ fd( Z1e de+jX jZ fd) Z2e de3ee4f fd* Z5e de e fd+ Z6e defd, Z7e de8fd- Z9d=d.e:e de(e; fd/Zde e%e fd3Z?de e%e fd4Z@de e%e fd5ZAde%eB fd6ZCde(e fd7ZDde(e fd8ZEd9e+jX jZ dd:fd;ZFe defd< ZGy:)>BaseDistribution directoryr( c t )zLoad the distribution from a metadata directory.
:param directory: Path to a metadata directory, e.g. ``.dist-info``.
r+ )clsrN s r/ from_directoryz BaseDistribution.from_directoryk
"##r2 metadata_contentsfilename project_namec t )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.
r+ )rP rS rT rU s r/ from_metadata_file_contentsz,BaseDistribution.from_metadata_file_contentss s
"##r2 wheelWheelr0 c t )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.
r+ )rP rX r0 s r/
from_wheelzBaseDistribution.from_wheel
"##r2 c T | j d| j d| j dS )N z ())raw_nameversionlocationr- s r/ __repr__zBaseDistribution.__repr__ s' -- $,, r$-- BBr2 c 8 | j d| j S )Nr^ )r` ra r- s r/ __str__zBaseDistribution.__str__ s -- $,, 00r2 c t )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- s r/ rb zBaseDistribution.location r\ r2 c | j }|r&|j rt |j S yt | j
}|r | j S y)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 r` rb )r. rh
egg_link_paths r/ editable_project_locationz*BaseDistribution.editable_project_location sR __
++-":>>22 8
FM }}$r2 c t )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).
r+ r- s r/ installed_locationz#BaseDistribution.installed_location
"##r2 c t )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- s r/
info_locationz BaseDistribution.info_location s
"##r2 c f | j }|syt j | j 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)rq rC rD is_filer. rq s r/ installed_by_distutilsz'BaseDistribution.installed_by_distutils s- **
||M*2244r2 c B | j }|sy|j d S )zWhether this distribution is installed as an egg.
This usually indicates the distribution was installed by (older versions
of) easy_install.
Fz.egg)rb endswithr. rb s r/ installed_as_eggz!BaseDistribution.installed_as_egg s$ == ((r2 c | j }|sy|j d syt j | j 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-inforq rw rC rD is_dirrt s r/ "installed_with_setuptools_egg_infoz3BaseDistribution.installed_with_setuptools_egg_info s> **
%%k2||M*1133r2 c | j }|sy|j d syt j | j 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{ rt s r/ installed_with_dist_infoz)BaseDistribution.installed_with_dist_info s> **
%%l3||M*1133r2 c t r* r+ r- s r/ canonical_namez BaseDistribution.canonical_name r1 r2 c t r* r+ r- s r/ ra zBaseDistribution.version r1 r2 c : | j j dd S )zConvert a project name to its setuptools-compatible filename.
This is a copy of ``pkg_resources.to_filename()`` for compatibility.
-_)r` replacer- s r/ setuptools_filenamez$BaseDistribution.setuptools_filename s }}$$S#..r2 c | j t } t j | S # t $ r Y yw xY w# t
t j t f$ r0}t j dt | j | Y d}~yd}~ww xY w)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 loggerwarningr )r. contentes r/ rh zBaseDistribution.direct_url% s nn%=>G
&&w/ / !
$
NN-(##
s! - < 99 B
&BB
c | j d }|j D ] }|j }|s|c S y# t t t f$ r Y yw xY w)N INSTALLER )r OSError
ValueErrorr
splitlinesstrip)r. installer_textline cleaned_lines r/ installerzBaseDistribution.installer? s_ !^^K 8N #--/D :: ! " E
+D
"EG NN7DMM1 5 > ! "s ? A?,A:4A?:A?extrasc t )zDependencies of this distribution.
For modern .dist-info distributions, this is the collection of
"Requires-Dist:" entries in distribution metadata.
r+ )r. r s r/ iter_dependenciesz"BaseDistribution.iter_dependencies rR r2 c t )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.
r+ r- s r/ iter_provided_extrasz%BaseDistribution.iter_provided_extras ro r2 rI c t )zCheck 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.
r+ )r. rI s r/ is_extra_providedz"BaseDistribution.is_extra_provided rR r2 c | j d }d t j |j D S # t $ r Y y w xY w)NRECORDc 3 ^ K | ]% }t t j |d ' yw)r NrB ).0rows r/ zFBaseDistribution._iter_declared_entries_from_record.. s% S5RcGLLQ()5Rs +-)r r csvreaderr )r. texts r/ "_iter_declared_entries_from_recordz3BaseDistribution._iter_declared_entries_from_record sG >>(+D TSZZ@Q5RSS ! s = A A c R | j d }d |j d D }| j }| j }|||S t j | j | j s|S fd|D S # t $ r Y y w xY w# t $ r |cY S w xY w)Nzinstalled-files.txtc 3 & K | ] }|s| y wr* r< )r ps r/ r zFBaseDistribution._iter_declared_entries_from_legacy.. s A ;qq ;s F)keependsc 3 K | ]7 }t t j | j j 9 y wr* )rE rC rD parts)r r info_rels r/ r zFBaseDistribution._iter_declared_entries_from_legacy.. s2
*',,q/*?*? Ps =A )
r r r rb rq rC rD relative_tor r )r. r pathsrootr> r s @r/ "_iter_declared_entries_from_legacyz3BaseDistribution._iter_declared_entries_from_legacy s >>"78D BDOOUO ;A}}!! <4<L ||D)55d;H ~~L
! L s# B $B BB B&%B&c F | j xs | j 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- s r/ iter_declared_entriesz&BaseDistribution.iter_declared_entries s&
3 3 5
9668
r2 c # v K | j d }dx}}|j D ]} }|j }|r|j d r'|j d r6|j d r%|j d j
d \ }}}nt ||| y# t $ r Y yw xY ww)
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.txtNr #[]z[]:)rH rI rJ )r r r r r rw partitionrG )r. r rI rJ r r s r/ _iter_requires_txt_entriesz+BaseDistribution._iter_requires_txt_entries s nn^4G &&(D::# > > $$
3 $+AV $ $hsm $$s $t $THXc]4K T
HXc]4K
*
x
'>
NH],C N2x} (Xc] (83u}}/D/D 3 3 8 8 8r2 rM c e Zd ZdZedd Zedeee dd fd Z deded fdZ
de d fd Z de e
fd
Zd ed d d fd
edee dededede e
f dZy)BaseEnvironmentz6An environment containing distributions to introspect.r( c t r* r+ )rP s r/ defaultzBaseEnvironment.defaulta r1 r2 r c t r* r+ )rP r s r/
from_pathszBaseEnvironment.from_pathse r1 r2 r0 rM c t )zGiven a requirement name, return the installed distributions.
The name may not be normalized. The implementation must canonicalize
it for lookup.
r+ )r. r0 s r/ get_distributionz BaseEnvironment.get_distributioni rR r2 c t )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- s r/ _iter_distributionsz#BaseEnvironment._iter_distributionsq r r2 c # K | j D ]d }t j d|j t j }|s,t
j
d|j |j a| f yw)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 rematchr
IGNORECASEr r rb )r. distproject_name_valids r/ iter_all_distributionsz&BaseEnvironment.iter_all_distributionsz sk ,,.D
"$<##mm"
&;''MM
J# /s A9A;TF
local_onlyskipinclude_editableseditables_only user_onlyc | j }|r d |D }|s d |D }|r d |D }|r d |D }fd|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 3 : K | ] }|j s| y wr* )r r ds r/ r z?BaseEnvironment.iter_installed_distributions.. s +R177!R c 3 : K | ] }|j r| y wr* r r s r/ r z?BaseEnvironment.iter_installed_distributions.. s 2Rqzz!Rr" c 3 : K | ] }|j s| y wr* r$ r s r/ r z?BaseEnvironment.iter_installed_distributions.. s .R1::!Rr" c 3 : K | ] }|j s| y wr* )r r s r/ r z?BaseEnvironment.iter_installed_distributions.. s 1R1==!Rr" c 3 @ K | ] }|j vs| y wr* )r )r r! r s r/ r z?BaseEnvironment.iter_installed_distributions.. s >2a!1!1!=2s )r )r. r r r r r its ` r/ iter_installed_distributionsz,BaseEnvironment.iter_installed_distributions sR 0
(
(
* +R+B 2R2B .R.B 1R1B>2>>r2 N)r( r )r7 r8 r9 __doc__r r
r
r r; r r r
r rM r r r r r) r< r2 r/ r r ^ s @$ $ $xS 2 $7H $ $$S $X6H-I $$X.@%A $1A(B . *"& $
!?!? n!? !?
!?
!?
" #!?r2 r c 8 e Zd ZU eed< dej fdZy)rY rb r( c t r* r+ r- s r/
as_zipfilezWheel.as_zipfile r r2 N)r7 r8 r9 r; rK zipfileZipFiler- r< r2 r/ rY rY s M$GOO $r2 rY c < e Zd ZdeddfdZdej fdZy)FilesystemWheelrb r( Nc || _ y r* )rb rx s r/ __init__zFilesystemWheel.__init__ s
r2 c D t j | j d S NT)
allowZip64)r. r/ rb r- s r/ r- zFilesystemWheel.as_zipfile s t}}>>r2 )r7 r8 r9 r; r3 r. r/ r- r< r2 r/ r1 r1 s% ! ! !?GOO ?r2 r1 c F e Zd Zdedee ddfdZdej fdZ y) MemoryWheelrb streamr( Nc || _ || _ y r* )rb r9 )r. rb r9 s r/ r3 zMemoryWheel.__init__ s
r2 c D t j | j d S r5 )r. r/ r9 r- s r/ r- zMemoryWheel.as_zipfile s t{{t<rN s,
; K I @ 6 H H
3 D = 0 HM7 23 g&&& ' 8 $ $X $ , c?,
S/, ,<J q8x q8hR? R?j$H $?e ?=% =r2