a
ljJ @ s@ d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZm Z m
Z
m Z m Z m
Z
mZmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d d lm Z d d
l m Z d d l m!Z! d d l"m#Z#m$Z$ d d
l%m&Z& d dl'm(Z( d dl)m*Z* d dl+m,Z, d dl-m.Z. d dl/m,Z0 d dl1m2Z3 d dl4m5Z5 d dl4m6Z7 d dl8m9Z9 d dl:m;Z;mZ> d dl?m@Z@ d dlAmBZBmCZC d dlDmEZE d dlFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZO d d lPmQZQ d d lRmSZS d d lTmUZUmVZV d d lWmXZX d d lYmZZZ e[e\Z]e^e!d!d"d#Z_G d$d% d%Z`e`e^d&d'd(ZadS )) N)Any
CollectionDictIterableListOptionalSequenceUnion)
pkg_resources)Marker) Requirement) SpecifierSet)canonicalize_name)Version)parse)Pep517HookCaller) Distribution)BuildEnvironmentNoOpBuildEnvironment)InstallationError)
get_scheme)Link)generate_metadata)generate_editable_metadata)install_editable)LegacyInstallFailure)install)
install_wheel)load_pyproject_tomlmake_pyproject_path)UninstallPathSet)
deprecated)direct_url_for_editabledirect_url_from_link)Hashes) ask_path_exists
backup_dir display_pathdist_in_install_pathdist_in_site_packagesdist_in_usersiteget_distributionhide_urlredact_auth_from_url) get_metadata)runner_with_spinner_message)
TempDirectory
tempdir_kinds)running_under_virtualenv)vcs)metadata_directoryreturnc C s | tj}tj|\}}t||}|drJtj}tj |d }n.|dsXJ tj
}tj |d dd }||||dS )zQReturn a pkg_resources.Distribution for the provided
metadata directory.
z .egg-infor z
.dist-info-) project_namemetadata) rstriposseppathsplitr
Z PathMetadataendswithr splitextZDistInfoDistribution)r4 Zdist_dirbase_dirZ
dist_dir_namer8 Zdist_clsZ dist_name rA A/usr/lib/python3.9/site-packages/pip/_internal/req/req_install.py _get_distB s
rC c @ s e Zd ZdZdSee eeed f eee ee
ee eee e ee e ee ee e f ee
e eeddddZedd d
Zedd d Zedd
dZeee dddZe edddZeedddZeedddZdTeee edddZeedddZ dUee d d d Z ee dd d!Z eeeed"d#d$Z ddd%d&Z!ddd'd(Z"edd)d*d+Z#eedd,d-Z$eedd.d/Z%eedd0d1Z&eedd2d3Z'eedd4d5Z(ddd6d7Z)ddd8d9Z*ddd:d;Z+ee,ddd?Z/ddd@dAZ0dVeeeddBdCdDZ1dddEdFZ2dWeeee3 dGdHdIZ4eeeedJdKdLZ5ee ddMdNdOZ6dXe e ee7e ee ee ee eeeddP dQdRZ8dS )YInstallRequirementz
Represents something that may be installed later on, may have information
about where to fetch the relevant requirement and also contains logic for
installing the said requirement.
FNrA )req
comes_fromeditablelinkmarkers
use_pep517isolatedinstall_optionsglobal_options hash_options
constraintextras
user_suppliedpermit_editable_wheelsr5 c C s |d u st |tsJ ||| _|| _| | _|| _|| _d | _d | _| jrp|sRJ |j rpt
j t
j
|j| _|d u r|r|jrt|j}| | _| _d| _d | _| jr| jj r| jj| _| r| | _n |rdd |jD | _nt | _|d u r|r|j}|| _d | _d| _d | _d | _ |r"|ng | _ | r2| ng | _ |
rB|
ni | _ d| _ |
| _!|| _"t# | _$d | _%d | _&g | _'d | _(|| _)d| _*d S )NFc S s h | ]}t |qS rA )r
Z
safe_extra.0extrarA rA rB z.InstallRequirement.__init__..)+
isinstancer rE rF rO rG rR legacy_install_reason
source_diris_filer: r< normpathabspathZ file_pathurlr rH
original_link original_link_is_in_wheel_cachelocal_file_pathrP setZmarkerrI satisfied_byshould_reinstall_temp_build_dirinstall_succeededrL rM rN ZpreparedrQ rK r build_envr4 pyproject_requiresrequirements_to_checkpep517_backendrJ Zneeds_more_preparation)selfrE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rA rA rB __init__c sX
zInstallRequirement.__init__)r5 c C s | j r.t| j }| jrF|dt| jj7 }n| jrBt| jj}nd}| jd urf|dt| jj7 }| j rt
| j tr| j }n
| j }|r|d| d7 }|S )Nz from {}zz in {}z (from )) rE strrH formatr- r^ rc r' locationrF rX from_pathrk srF rA rA rB __str__ s
zInstallRequirement.__str__c C s d | jjt| | jS )Nz <{} object: {} editable={!r}>)ro __class____name__rn rG rk rA rA rB __repr__ s zInstallRequirement.__repr__c s> t | t } fddt|D }dj| jjd|dS )z5An un-tested helper for getting state, for debugging.c 3 s | ]}d | | V qdS )z{}={!r}N)ro )rT attrZ
attributesrA rB rW z2InstallRequirement.format_debug..z <{name} object: {{{state}}}>z, )namestate)varssortedro ru rv join)rk namesr} rA rz rB format_debug s z InstallRequirement.format_debugc C s | j d u rd S t| j jS N)rE r
Z safe_namer| rw rA rA rB r| s
zInstallRequirement.namec C s | j s
dS | jsJ | j` td}| j|, d| j v W d W d S 1 sb0 Y W d n1 s0 Y d S )NFz1Checking if build backend supports build_editableZbuild_editable)rJ rj rg r/ Zsubprocess_runnerZ_supported_features)rk ZrunnerrA rA rB supports_pyproject_editable s
z.InstallRequirement.supports_pyproject_editablec C s | j jS r )rE specifierrw rA rA rB r s z InstallRequirement.specifierc C s$ | j }t|dko"tt|jdv S )zReturn whether I am pinned to an exact version.
For example, some-package==1.2 is pinned; some-package>1.2 is not.
> =====)r lennextiteroperator)rk Z
specifiersrA rA rB is_pinned s z InstallRequirement.is_pinned)extras_requestedr5 c s0 |sd} j d ur(t fdd|D S dS d S )N) c 3 s | ]} j d |iV qdS )rU N)rI ZevaluaterS rw rA rB r{ s z3InstallRequirement.match_markers..T)rI any)rk r rA rw rB
match_markers s
z InstallRequirement.match_markersc C s
t | jS )zReturn whether any known-good hashes are specified as options.
These activate --require-hashes mode; hashes specified as part of a
URL do not.
)boolrN rw rA rA rB has_hash_options s z#InstallRequirement.has_hash_optionsT)trust_internetr5 c C sB | j }|r| jn| j}|r:|jr:||jg |j t|S )a Return a hash-comparer that considers my option- and URL-based
hashes to be known-good.
Hashes in URLs--ones embedded in the requirements file, not ones
downloaded from an index server--are almost peers with ones from
flags. They satisfy --require-hashes (whether it was implicitly or
explicitly activated) but do not activate it. md5 and sha224 are not
allowed in flags, which should nudge people toward good algos. We
always OR all hashes together, even ones from URLs.
:param trust_internet: Whether to trust URL-based (#md5=...) hashes
downloaded from the internet, as by populate_link()
) rN copyrH r_ hash
setdefaultZ hash_nameappendr$ )rk r Z good_hashesrH rA rA rB hashes' s
zInstallRequirement.hashesc C sP | j du rdS t| j }| jrLt| jtr2| j}n
| j }|rL|d| 7 }|S )z8Format a nice indicator to show where this "comes from" Nz->)rE rn rF rX rq rr rA rA rB rq < s
z InstallRequirement.from_path) build_dir
autodeleteparallel_buildsr5 c C s |d us J | j d ur*| j js"J | j jS | jd u rLttjdd| _ | j jS t| j}|rn| dt j
}t j |st
d| t | t j||}|rd nd}t||tjddjS )NT)kindglobally_managed_zCreating directory %sF)r< deleter r )re r< rE r0 r1 Z REQ_BUILDr r| uuidZuuid4hexr: existsloggerdebugmakedirsr )rk r r r Zdir_nameZactual_build_dirZ
delete_argrA rA rB ensure_build_locationJ s.
z(InstallRequirement.ensure_build_locationc C sn | j du sJ | jdus J | jdus*J tt| jd trDd}nd}td| jd || jd g| _ dS )z*Set requirement after generating metadata.Nr r r r Name)rE r8 rZ rX
parse_versionr r r )rk oprA rA rB _set_requirementu s z#InstallRequirement._set_requirementc C sD t | jd }t | jj|kr"d S td| j|| j t|| _d S )Nr zeGenerating metadata for package %s produced metadata for project name %s. Fix your #egg=%s fragments.)r r8 rE r| r warningr )rk Z
metadata_namerA rA rB warn_on_mismatching_name s z+InstallRequirement.warn_on_mismatching_name)
use_user_siter5 c C s | j du rdS t| j j}|s"dS |j}|duo@| j jj|dd}|sd| _|rt|r`d| _qt rt
|rt d |j
|jqt|rd| _n| jrd| _d| _n|| _dS )zFind an installed distribution that satisfies or conflicts
with this requirement, and set self.satisfied_by or
self.should_reinstall appropriately.
NT)Z prereleaseszVWill not install to the user site because it will lack sys.path precedence to {} in {})rE r+ r| versionr containsrc r* rd r2 r) r ro r7 rp r( rG )rk r Z
existing_distZexisting_versionZversion_compatiblerA rA rB check_if_exists s8
z"InstallRequirement.check_if_existsc C s | j s
dS | j jS )NF)rH is_wheelrw rA rA rB r s zInstallRequirement.is_wheelc C s t j| j| jr| jjpdS )Nr )r: r< r rZ rH Zsubdirectory_fragmentrw rA rA rB unpacked_source_directory s z,InstallRequirement.unpacked_source_directoryc C s( | j sJ d| tj| jd}|S )NNo source dir for zsetup.pyrZ r: r< r r )rk Zsetup_pyrA rA rB
setup_py_path s z InstallRequirement.setup_py_pathc C s( | j sJ d| tj| jd}|S )Nr z setup.cfgr )rk Z setup_cfgrA rA rB setup_cfg_path s z!InstallRequirement.setup_cfg_pathc C s | j sJ d| t| jS )Nr )rZ r r rw rA rA rB pyproject_toml_path s z&InstallRequirement.pyproject_toml_pathc C s^ t | j| j| jt| }|du r*d| _dS d| _|\}}}}|| _|| _t| j||d| _ dS )aA Load the pyproject.toml file.
After calling this routine, all of the attributes related to PEP 517
processing for this requirement have been set. In particular, the
use_pep517 attribute can be used to determine whether we should
follow the PEP 517 or legacy (setup.py) code path.
NFT) backend_path)
r rJ r r rn ri rh r r rj )rk Zpyproject_toml_dataZrequiresbackendcheckr rA rA rB r s z&InstallRequirement.load_pyproject_tomlc C sD | j r@| jr@| s@tj| js@tj| js@td| ddS )zCheck that an editable requirement if valid for use with PEP 517/518.
This verifies that an editable that has a pyproject.toml either supports PEP 660
or as a setup.py or a setup.cfg
zProject z has a 'pyproject.toml' and its build backend is missing the 'build_editable' hook. Since it does not have a 'setup.py' nor a 'setup.cfg', it cannot be installed in editable mode. Consider using a build backend that supports PEP 660.N) rG rJ r r: r< isfiler r r rw rA rA rB isolated_editable_sanity_check s
z1InstallRequirement.isolated_editable_sanity_checkc C s | j s
J | jrZ| jdus J | jrF| jrF| rFt| j| jd| _qt | j| jd| _n*t
| j| j | j | j
| jp|d| j d| _| js| n| | dS )zEnsure that project metadata is available.
Under PEP 517 and PEP 660, call the backend hook to prepare the metadata.
Under legacy processing, call setup.py egg-info.
N)rg r zfrom )rg r rZ rK details)rZ rJ rj rG rR r r rg r4 r generate_metadata_legacyr r rK r| rH r r assert_source_matches_versionrw rA rA rB prepare_metadata s8
z#InstallRequirement.prepare_metadatac C s t | dst| | _| jS )N _metadata)hasattrr. get_distr rw rA rA rB r8 B s
zInstallRequirement.metadatac C s
t | jS r )rC r4 rw rA rA rB r I s zInstallRequirement.get_distc C sR | j s
J | jd }| jjr8|| jjvr8td| | ntdt| j || d S )Nr z'Requested %s, but installing version %sz;Source in %s has version %s, which satisfies requirement %s)rZ r8 rE r r r r r' )rk r rA rA rB r L s
z0InstallRequirement.assert_source_matches_version)
parent_dirr r r5 c C s | j du r | j|||d| _ dS )aA Ensure that a source_dir is set.
This will create a temporary build dir if the name of the requirement
isn't known yet.
:param parent_dir: The ideal pip parent_dir for the source_dir.
Generally src_dir for editables and build_dir for sdists.
:return: self.source_dir
N)r r )rZ r )rk r r r rA rA rB ensure_has_source_dir^ s
z(InstallRequirement.ensure_has_source_dirc C s | j std| j d S | js"J | js,J | j jdkrCannot update repository at %s; repository location is unknownfilezUnsupported VCS URL )r^ ) rH r r rZ rG schemer3 Zget_backend_for_schemer^ r, Zobtain)rk Z vcs_backendZ
hidden_urlrA rA rB update_editableu s
z"InstallRequirement.update_editable) auto_confirmverboser5 c C sR | j s
J t| j j}|s,td| j dS td| t|}||| |S )a
Uninstall the distribution currently satisfying this requirement.
Prompts before removing or modifying files unless
``auto_confirm`` is True.
Refuses to delete or modify files outside of ``sys.prefix`` -
thus uninstallation within a virtual environment can only
modify that virtual environment, even if the virtualenv is
linked to global site-packages.
z#Skipping %s as it is not installed.Nz Found existing installation: %s) rE r+ r| r r infor Z from_distremove)rk r r ZdistZuninstalled_pathsetrA rA rB uninstall s
z InstallRequirement.uninstall)r< parentdirrootdirr5 c C s8 t t t ddd}tj||}|||}| jd | S )N)r| prefixr5 c S sN | |tjj s&J d| d|| t|d d } | tjjd} | S )Nzname z doesn't start with prefix r /)
startswithr: r< r; r replace)r| r rA rA rB _clean_zip_name s
z=InstallRequirement._get_archive_name.._clean_zip_namer )rn r: r< r r| )rk r< r r r r| rA rA rB _get_archive_name s
z$InstallRequirement._get_archive_name)r r5 c C s | j s
J |du rdS d}d| j| jd }tj||}tj|rtdt |d}|dkrjd}nj|d krt
d
t | t | nF|d krt
|}t
d t |t | t|| n|d
krtd |sdS tj|d tjdd}| tjtj| j}t|D ]~\} }
} |
D ]6} | j| | |d}
t|
d }d|_| |d q$| D ]0}| j|| |d}tj| |}| || q`qW d n1 s0 Y t
dt | dS )z}Saves archive to provided build_dir.
Used for saving downloaded VCS requirements as part of `pip download`.
NTz {}-{}.zipr z8The file {} exists. (i)gnore, (w)ipe, (b)ackup, (a)bort )iwbar Fr z Deleting %sr zBacking up %s to %sr )Z
allowZip64)r r r i r zSaved %s) rZ ro r| r8 r: r< r r r% r' r r r r& shutilmovesysexitzipfileZipFile ZIP_DEFLATEDnormcaser] r walkr ZZipInfoZ
external_attrZwritestrwriter )rk r Zcreate_archive archive_nameZ archive_pathZresponseZ dest_fileZ
zip_outputdirdirpathdirnames filenamesdirnameZ dir_arcnameZzipdirfilenameZ file_arcnamerA rA rB archive sr
4zInstallRequirement.archive) rL rM roothomer warn_script_locationr pycompiler5 c
C s t | j|||| j|d} |d ur$|ng }| jrd| jsdt|||||| j| j| j| j| jd
d| _ d S | jr| j
stJ d }
| jrt | j}
n| j rt
| j | j| j}
t| j| j
| t| j|||
| jd d| _ d S t|| j }t|| j }z8t|||||||| | j| j| j| j| jt| jd} W nL tyV } zd| _ | jW Y d } ~ n$d } ~ 0 typ d| _ Y n0 | | _ | r| jdkrt d | jd d dd
d S ) N)userr r rK r )r r r r| r rK rg r T)r req_descriptionr r
direct_urlZ requested)rL rM r r r r r r r rK Zreq_namerg r r Fi zg{} was installed using the legacy 'setup.py install' method, because a wheel could not be built for it.z+to fix the wheel build issue reported abovereasonZ replacementZgone_inZissue) r r| rK rG r install_editable_legacyr rg r rf ra r" r_ r# rZ r` r rn rE rQ listrM rL install_legacyr __cause__ ExceptionrY r! ro )
rk rL rM r r r r r r r r successexcrA rA rB r s
zInstallRequirement.install) FNNNFNNNFrA FF)N)T)FF)FF)NNNNTFT)9rv
__module__ __qualname____doc__r r r rn r r r r r r rl rt rx r propertyr| functools lru_cacher r
r r r r r r$ r rq r r r r r r r r r r r r r r8 r r r r r r r r r r r rA rA rA rB rD \ s
j +.)
F
rD )rE r5 c C s> d}| j sd}n| jr d}n
| jr&d}|r:tddd dd |S ) Nr z3Unnamed requirements are not allowed as constraintsz4Editable requirements are not allowed as constraintsz Constraints cannot have extrasa Constraints are only allowed to take the form of a package name and a version specifier. Other forms were originally permitted as an accident of the implementation, but were undocumented. The new implementation of the resolver no longer supports these forms.z+replacing the constraint with a requirementi r )r| rG rP r! )rE ZproblemrA rA rB check_invalid_constraint_typeb s r )br Zloggingr: r r r r typingr r r r r r r r Z pip._vendorr
Z pip._vendor.packaging.markersr Z"pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr
Zpip._vendor.packaging.utilsr Z pip._vendor.packaging.versionr r r Zpip._vendor.pep517.wrappersr Zpip._vendor.pkg_resourcesr Zpip._internal.build_envr r Zpip._internal.exceptionsr Zpip._internal.locationsr Zpip._internal.models.linkr Z'pip._internal.operations.build.metadatar Z0pip._internal.operations.build.metadata_editabler Z.pip._internal.operations.build.metadata_legacyr Z0pip._internal.operations.install.editable_legacyr r Z'pip._internal.operations.install.legacyr r r Z&pip._internal.operations.install.wheelr Zpip._internal.pyprojectr r Z pip._internal.req.req_uninstallr Z pip._internal.utils.deprecationr! Z&pip._internal.utils.direct_url_helpersr" r# Zpip._internal.utils.hashesr$ Zpip._internal.utils.miscr% r& r' r( r) r* r+ r, r- Z pip._internal.utils.packagingr. Z pip._internal.utils.subprocessr/ Z pip._internal.utils.temp_dirr0 r1 Z pip._internal.utils.virtualenvr2 Zpip._internal.vcsr3 Z getLoggerrv r rn rC rD r rA rA rA rB s` ( ,