o c@sddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd l m!Z!dd l"m#Z#m$Z$dd l%m&Z&m'Z'ddl(m)Z)ddl*m+Z+m,Z,m-Z-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m6Z:ddl;mm?Z@ddlAmBZBddlCmDZDmEZEddlFmGZGddlHmIZImJZJddlKmLZLmMZMddlNmOZOddlPmQZQmRZRmSZSmTZTmUZUmVZVddlWmXZXddlYmZZZdd l[m\Z\m]Z]dd!l^m_Z_dd"l`maZaebecZdGd#d$d$Zed%eed&effd'd(Zgd)e d*eeed+efd&ehfd,d-Zid.eefd*eeed&ehfd/d0ZjGd1d2d2eZkd)e d*eeed3ekd&dfd4d5ZldS)6N)Enum)Values)Any CollectionDictIterableListOptionalSequenceUnion)Marker) Requirement) SpecifierSet)canonicalize_name)Version)parse)BuildBackendHookCaller)BuildEnvironmentNoOpBuildEnvironment)InstallationErrorLegacyInstallFailure) get_scheme)BaseDistributionget_default_environmentget_directory_distributionget_wheel_distribution)FilesystemWheel) DirectUrl)Link)generate_metadata)generate_editable_metadata)install_editable)install) install_wheel)load_pyproject_tomlmake_pyproject_path)UninstallPathSet)LegacyInstallReason deprecated)direct_url_for_editabledirect_url_from_link)Hashes) ConfiguredBuildBackendHookCallerask_path_exists backup_dir display_pathhide_urlredact_auth_from_url safe_extra)runner_with_spinner_message) TempDirectory tempdir_kinds)running_under_virtualenv)vcsc!@s@eZdZdZ             dideedeeedfdedee d ee d eed ed ee ed ee edee ee efdee eefdede edededdf ddZdefddZdefddZdefddZedeefddZedefdd Zedefd!d"Zedefd#d$Zdjd%eeedefd&d'Zedefd(d)Zdkd+edefd,d-Zdeefd.d/Zd0ed1ed2edefd3d4Z dld5d6Z!dld7d8Z"d9eddfd:d;Z#edefdd?Z%edefd@dAZ&edefdBdCZ'edefdDdEZ(dldFdGZ)dldHdIZ*dldJdKZ+ede,fdLdMZ-de.fdNdOZ/dldPdQZ0  dmdRed1ed2eddfdSdTZ1dldUdVZ2 dmdWedXedee3fdYdZZ4d[ed\ed]edefd^d_Z5d0eeddfd`daZ6     *  *dnd e ed ee7edbeedceeddeedeed9edfeddfdgdhZ8dS)oInstallRequirementz 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. FNreq comes_fromeditablelinkmarkers use_pep517isolatedinstall_optionsglobal_options hash_optionsconfig_settings constraintextras user_suppliedpermit_editable_wheelsreturncCs|dus t|ts J|||_||_| |_||_||_d|_d|_|jr8|s)J|j r8t j t j |j|_|durF|rF|jrFt|j}||_|_d|_d|_d|_|jra|jj ra|jj|_| rg| |_n|rsdd|jD|_nt|_|dur|r|j}||_d|_d|_d|_d|_|r|ng|_| r| ng|_| r| ni|_ | |_!d|_"||_#||_$t%|_&d|_'d|_(g|_)d|_*||_+d|_,dS)NFcSsh|]}t|qSr:r2.0extrar:r:J/opt/certbot/lib/python3.10/site-packages/pip/_internal/req/req_install.py sz.InstallRequirement.__init__..)- isinstancer r;r<rFr=rIlegacy_install_reason source_diris_fileospathnormpathabspath file_pathurlrr> original_linkoriginal_link_is_in_wheel_cache download_infolocal_file_pathrGsetmarkerr? satisfied_byshould_reinstall_temp_build_dirinstall_succeededrBrCrDrEpreparedrHrAr build_envmetadata_directorypyproject_requiresrequirements_to_checkpep517_backendr@needs_more_preparation)selfr;r<r=r>r?r@rArBrCrDrErFrGrHrIr:r:rN__init__Ms\     zInstallRequirement.__init__cCs|jrt|j}|jr|dt|jj7}n |jr!t|jj}nd}|jdur>|jjdur5t|jj}nd}|d|7}|j rZt |j trK|j }n|j }|rZ|d|d7}|S)Nz from {}zz in z (from )) r;strr>formatr1rYr`locationr/r<rP from_path)rksrqr<r:r:rN__str__s(     zInstallRequirement.__str__cCsd|jjt||jS)Nz<{} object: {} editable={!r}>)rp __class____name__ror=rkr:r:rN__repr__szInstallRequirement.__repr__cs>t|t}fddt|D}dj|jjd|dS)z5An un-tested helper for getting state, for debugging.c3s |] }d||VqdS)z{}={!r}N)rp)rLattr attributesr:rN sz2InstallRequirement.format_debug..z<{name} object: {{{state}}}>z, )namestate)varssortedrprurvjoin)rknamesr~r:rzrN format_debugszInstallRequirement.format_debugcCs|jdurdS|jjSN)r;r}rwr:r:rNr}s zInstallRequirement.namec Cs|jsdS|js J|j1td}|j|d|jvWdWdS1s1wYWddS1sAwYdS)NFz1Checking if build backend supports build_editablebuild_editable)r@rirer4subprocess_runner_supported_features)rkrunnerr:r:rNsupports_pyproject_editables  "z.InstallRequirement.supports_pyproject_editablecCs|jjSr)r; specifierrwr:r:rNrszInstallRequirement.specifiercCs$|j}t|dkott|jdvS)zReturn whether I am pinned to an exact version. For example, some-package==1.2 is pinned; some-package>1.2 is not. >=====)rlennextiteroperator)rk specifiersr:r:rN is_pinnedszInstallRequirement.is_pinnedextras_requestedcs,|sd}jdurtfdd|DSdS)N)c3s |] }jd|iVqdS)rMN)r?evaluaterKrwr:rNr| s z3InstallRequirement.match_markers..T)r?any)rkrr:rwrN match_markerss  z InstallRequirement.match_markerscCs 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. )boolrDrwr:r:rNhas_hash_optionss z#InstallRequirement.has_hash_optionsTtrust_internetcCsB|j}|r |jn|j}|r|jr||jg|jt|S)aReturn 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() ) rDcopyr>rZhash setdefault hash_nameappendr+)rkr good_hashesr>r:r:rNhashess  zInstallRequirement.hashescCsP|jdurdSt|j}|jr&t|jtr|j}n|j}|r&|d|7}|S)z8Format a nice indicator to show where this "comes from" Nz->)r;ror<rPrr)rkrsr<r:r:rNrr/s     zInstallRequirement.from_path build_dir autodeleteparallel_buildscCs|dusJ|jdur|jjsJ|jjS|jdur&ttjdd|_|jjSt|j}|r7|dt j }t j |sHt d|t |t j||}|rSdnd}t||tjddjS)NT)kindglobally_managed_zCreating directory %sF)rUdeleterr)rbrUr;r5r6 REQ_BUILDrr}uuiduuid4hexrTexistsloggerdebugmakedirsr)rkrrrdir_nameactual_build_dir delete_argr:r:rNensure_build_location=s2         z(InstallRequirement.ensure_build_locationcCsn|jdusJ|jdusJ|jdusJtt|jdtr"d}nd}td|jd||jdg|_dS)z*Set requirement after generating metadata.NrrrrName)r;metadatarRrP parse_versionrr r)rkopr:r:rN_set_requiremenths z#InstallRequirement._set_requirementcCsDt|jd}t|jj|krdStd|j||jt||_dS)NrzeGenerating metadata for package %s produced metadata for project name %s. Fix your #egg=%s fragments.)rrr;r}rwarningr )rk metadata_namer:r:rNwarn_on_mismatching_name~sz+InstallRequirement.warn_on_mismatching_name use_user_sitecCs|jdurdSt|jj}|sdS|jjj|jdd}|sGd|_|rB|jr,d|_ dSt r>|j r@t d|j d|jdSdSd|_ dS|jrRd|_ d|_dS||_dS)zFind an installed distribution that satisfies or conflicts with this requirement, and set self.satisfied_by or self.should_reinstall appropriately. NT) prereleaseszNWill not install to the user site because it will lack sys.path precedence to rm)r;rget_distributionr}rcontainsversionr` in_usersiterar7in_site_packagesrraw_namerqr=)rkr existing_distversion_compatibler:r:rNcheck_if_existss8      z"InstallRequirement.check_if_existscCs|jsdS|jjS)NF)r>is_wheelrwr:r:rNrszInstallRequirement.is_wheelcCstj|j|jr |jjp dS)Nr)rTrUrrRr>subdirectory_fragmentrwr:r:rNunpacked_source_directorysz,InstallRequirement.unpacked_source_directorycC(|js Jd|tj|jd}|S)NNo source dir for zsetup.pyrRrTrUrr)rksetup_pyr:r:rN setup_py_pathz InstallRequirement.setup_py_pathcCr)Nrz setup.cfgr)rk setup_cfgr:r:rNsetup_cfg_pathrz!InstallRequirement.setup_cfg_pathcCs|js Jd|t|jS)Nr)rRr%rrwr:r:rNpyproject_toml_paths z&InstallRequirement.pyproject_toml_pathcCs`t|j|j|jt|}|durd|_dSd|_|\}}}}||_||_t||j||d|_ dS)aALoad 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$r@rrrorhrgr,rri)rkpyproject_toml_datarequiresbackendcheckrr:r:rNr$s   z&InstallRequirement.load_pyproject_tomlcCsT|jr |jr"|s$tj|js&tj|js(td|ddSdSdSdSdS)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) r=r@rrTrUisfilerrrrwr:r:rNisolated_editable_sanity_checks   z1InstallRequirement.isolated_editable_sanity_checkcCs|jsJ|jp d|j}|jr8|jdusJ|jr-|jr-|r-t|j |j|d|_ nt |j |j|d|_ nt |j |j |j|j|d|_ |jsN|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. zfrom N)rerdetails)rerrRrAr)rRr}r>r@rir=rIrr rerfrgenerate_metadata_legacyrrrArrassert_source_matches_version)rkrr:r:rNprepare_metadatas>     z#InstallRequirement.prepare_metadatacCst|ds |j|_|jS)N _metadata)hasattrget_distrrrwr:r:rNr1s  zInstallRequirement.metadatacCsB|jrt|jS|jr|jrtt|jt|jStd|d)NzInstallRequirement zC has no metadata directory and no wheel: can't make a distribution.) rfrr]rrrrr}AssertionErrorrwr:r:rNr8s   zInstallRequirement.get_distcCsT|jsJ|jd}|jjr||jjvrtd||dStdt|j||dS)Nrz'Requested %s, but installing version %sz;Source in %s has version %s, which satisfies requirement %s)rRrr;rrrrr/)rkrr:r:rNrDs  z0InstallRequirement.assert_source_matches_version parent_dircCs$|jdur|j|||d|_dSdS)aAEnsure 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)rr)rRr)rkrrrr:r:rNensure_has_source_dirVs  z(InstallRequirement.ensure_has_source_dircCs|js td|jdS|jsJ|jsJ|jjdkrdSt|jj}|s0Jd|jjt |jj}|j |j|dddS)Nz>Cannot update repository at %s; repository location is unknownfilezUnsupported VCS URL r)rY verbosity) r>rrrRr=schemer8get_backend_for_schemerYr0obtain)rk vcs_backend hidden_urlr:r:rNupdate_editablems    z"InstallRequirement.update_editable auto_confirmverbosecCsV|jsJt|jj}|std|jdStd|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.NzFound existing installation: %s) r;rrr}rrinfor& from_distremove)rkrrdistuninstalled_pathsetr:r:rN uninstalls    zInstallRequirement.uninstallrU parentdirrootdircCs<dtdtdtfdd}tj||}|||}|jd|S)Nr}prefixrJcSsN||tjjsJd|d||t|dd}|tjjd}|S)Nzname z doesn't start with prefix r/) startswithrTrUseprreplace)r}rr:r:rN_clean_zip_names z=InstallRequirement._get_archive_name.._clean_zip_namer)rorTrUrr})rkrUrrrr}r:r:rN_get_archive_names z$InstallRequirement._get_archive_namecCs|jsJ|dur dSd}d|j|jd}tj||}tj|rjtdt |d}|dkr5d}n5|d krGt d t |t |n#|d krat |}t d t |t |t||n |d krjtd|sndStj|d tjdd}|Utjtj|j}t|D]<\} } } | D]} |j| | |d} t| d}d|_||dq| D]}|j|| |d}tj| |}|||qqWdn1swYt dt |dS)z}Saves archive to provided build_dir. Used for saving downloaded VCS requirements as part of `pip download`. NTz {}-{}.ziprz8The file {} exists. (i)gnore, (w)ipe, (b)ackup, (a)bort )iwbarFrz Deleting %srzBacking up %s to %sr) allowZip64)rrrirzSaved %s)rRrpr}rrTrUrrr-r/rrrr.shutilmovesysexitzipfileZipFile ZIP_DEFLATEDnormcaserWrwalkrZipInfo external_attrwritestrwriter)rkrcreate_archive archive_name archive_pathresponse dest_file zip_outputdirdirpathdirnames filenamesdirname dir_arcnamezipdirfilename file_arcnamer:r:rNarchivesv     zInstallRequirement.archiveroothomerwarn_script_location pycompilec Cst|j||||j|d} |dur|ng}|jr2|js2t||||||j|j|j|j|jd d|_ dS|jrh|j s:Jd} |jrEt |j} n |j rQt |j |j|j} t|j|j | t|j||| |jdd|_ dSt||j}t||j}z,|jdur|jjr|j|jt|||||||| |j|j|j|j|jt|jd} Wnty} zd|_ | d} ~ wtyd|_ w| |_ | r|jdur|jjr|j|jdSdSdSdS)N)userr#r"rAr)rr#rr}rrArerT)rreq_descriptionr%r$ direct_url requested)rBrCr"r#rrr%rrrAreq_namererr'F)rr}rAr=rinstall_editable_legacyrrerrcr]r)rZr*rRr[r#ror;rHlistrCrBrQemit_before_installemit_deprecationinstall_legacyr Exceptionemit_after_success) rkrBrCr"r#rr$rr%rr(successexcr:r:rNr"s          zInstallRequirement.install) FNNNFNNNNFr:FFr)T)rJN)FF)NNNNTFT)9rv __module__ __qualname____doc__r r r rorrr rrrrlrtrxrpropertyr} functools lru_cacherrrrrrrr+rrrrrrrrrrrrr$rrrrrrrrrr&rrr!r r"r:r:r:rNr9Fs       o     + &   ,    F   r9r;rJcCs>d}|jsd}n |jrd}n|jrd}|rtddddd|S) Nrz3Unnamed requirements are not allowed as constraintsz4Editable requirements are not allowed as constraintszConstraints cannot have extrasaConstraints 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 )reason replacementgone_inissue)r}r=rGr()r;problemr:r:rNcheck_invalid_constraint_typeZsr?optionsreqsoptioncCs0t||drdS|D] }t||drdSq dS)NTF)getattr)r@rArBr;r:r:rN _has_optionws  rDrBcCs$|D] }|s |jr|jsdSqdS)NFT)rBr@)rBrAr;r:r:rN_install_option_ignoreds rEc@seZdZdZdZdZdS)LegacySetupPyOptionsCheckModerN)rvr4r5INSTALLWHEELDOWNLOADr:r:r:rNrFsrFmodecCst||d}t||d}t||d}|p|p|}|sdS|jtd|tjkrD|rFt|j|r:tddSt dddd d dSdSdS) NrB build_optionsrCzImplying --no-binary=:all: due to the presence of --build-option / --global-option / --install-option. Consider using --config-settings for more flexibility.z5Ignoring --install-option when building using PEP 517zv--install-option is deprecated because it forces pip to use the 'setup.py install' command which is itself deprecated.i^,zto use --config-settingsz23.1)r:r=r;r<) rDformat_controldisallow_binariesrrrFrIrErBr()r@rArLhas_install_optionshas_build_optionshas_global_optionslegacy_setup_py_options_presentr:r:rNcheck_legacy_setup_py_optionss.       rT)mr8loggingrTrrrr enumroptparsertypingrrrrrr r r pip._vendor.packaging.markersr "pip._vendor.packaging.requirementsr pip._vendor.packaging.specifiersrpip._vendor.packaging.utilsrpip._vendor.packaging.versionrrrpip._vendor.pyproject_hooksrpip._internal.build_envrrpip._internal.exceptionsrrpip._internal.locationsrpip._internal.metadatarrrrpip._internal.metadata.baserpip._internal.models.direct_urlrpip._internal.models.linkr'pip._internal.operations.build.metadatar0pip._internal.operations.build.metadata_editabler .pip._internal.operations.build.metadata_legacyr0pip._internal.operations.install.editable_legacyr!r+'pip._internal.operations.install.legacyr"r/&pip._internal.operations.install.wheelr#pip._internal.pyprojectr$r%pip._internal.req.req_uninstallr&pip._internal.utils.deprecationr'r(&pip._internal.utils.direct_url_helpersr)r*pip._internal.utils.hashesr+pip._internal.utils.miscr,r-r.r/r0r1pip._internal.utils.packagingr3pip._internal.utils.subprocessr4pip._internal.utils.temp_dirr5r6pip._internal.utils.virtualenvr7pip._internal.vcsr8 getLoggerrvrr9ror?rrDrErFrTr:r:r:rNs  (