o cb@sddlZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZddlmZmZddlmZddlmZm Z ddl!m"Z"ddl#m$Z$m%Z%dd l&m'Z'm(Z(m)Z)dd l*m+Z+dd l,m-Z-dd l.m/Z/m0Z0dd l1m2Z2ddl3m4Z4ddl5m6Z6e rddl m7Z7ne8Z7eee fZ9ee:ej;fZZ?Gddde7Z@dee:dfdee:dfde:fddZAGdddeZBGddde7ZCGdddZDGd d!d!e7ZEGd"d#d#eEZFGd$d%d%eEZGdS)&N) IO TYPE_CHECKINGAny Collection ContainerDictIterableIteratorList NamedTupleOptionalTupleUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedName) LegacyVersionVersion)NoneMetadataError) 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@sBeZdZedefddZedefddZedefddZdS) BaseEntryPointreturncCtNNotImplementedErrorselfr,H/opt/certbot/lib/python3.10/site-packages/pip/_internal/metadata/base.pyname:zBaseEntryPoint.namecCr&r'r(r*r,r,r-value>r/zBaseEntryPoint.valuecCr&r'r(r*r,r,r-groupBr/zBaseEntryPoint.groupN)__name__ __module__ __qualname__propertystrr.r0r1r,r,r,r-r$9sr$entry.infor%cCsj|r)|ddkr)|r|ddkr|d7}n|dd}|dd}|r)|ddksttjg||RS)aConvert 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..)r9Nr!r6pathlibPath)r7r8r,r,r-_convert_installed_files_pathGs   r>c@s&eZdZUeed<eed<eed<dS) RequiresEntry requirementextramarkerN)r2r3r4r6__annotations__r,r,r,r-r?es  r?c @sleZdZededdfddZededededdfdd Zed d d eddfd dZdefddZ defddZ e de efddZ e de efddZe de efddZe de efddZe defddZe defddZe defdd Ze defd!d"Ze defd#d$Ze defd%d&Ze defd'd(Ze de efd)d*Ze defd+d,Ze defd-d.Ze defd/d0Ze defd1d2Z e defd3d4Z!e defd5d6Z"d7e#defd8d9Z$de%efd:d;Z&d7e#defdd?Z*de+j,j-fd@dAZ.e/j0dBdCde+j,j-fdDdEZ1e de+j,j-fdFdGZ2e de3ee4ffdHdIZ5e de efdJdKZ6e defdLdMZ7e de8fdNdOZ9dfdQe:ede(e;fdRdSZde e%efdXdYZ?de e%efdZd[Z@de%eAfd\d]ZBde(efd^d_ZCde(efd`daZDdbe+j,j-ddcfdddeZEdcS)gBaseDistribution directoryr%cCr&)zLoad the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. r()clsrEr,r,r-from_directorylzBaseDistribution.from_directorymetadata_contentsfilename project_namecCr&)aLoad 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()rFrIrJrKr,r,r-from_metadata_file_contentstsz,BaseDistribution.from_metadata_file_contentswheelWheelr.cCr&)aLoad 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()rFrMr.r,r,r- from_wheel zBaseDistribution.from_wheelcCs|jd|jd|jdS)N z ())raw_nameversionlocationr*r,r,r-__repr__szBaseDistribution.__repr__cCs|jd|jS)NrQ)rSrTr*r,r,r-__str__szBaseDistribution.__str__cCr&)aWhere 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-rUrPzBaseDistribution.locationcCs8|j}|r|rt|jSdSt|j}|r|jSdS)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 urlrrSrU)r+rX egg_link_pathr,r,r-editable_project_locations  z*BaseDistribution.editable_project_locationcCr&)aThe 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*r,r,r-installed_locations z#BaseDistribution.installed_locationcCr&)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_locationszBaseDistribution.info_locationcCs|j}|sdSt|S)aWhether 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)r^r<r=is_filer+r^r,r,r-installed_by_distutilssz'BaseDistribution.installed_by_distutilscCs|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)rUendswithr+rUr,r,r-installed_as_eggs z!BaseDistribution.installed_as_eggcC*|j}|sdS|dsdSt|S)aWhether 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-infor^rbr<r=is_dirr`r,r,r-"installed_with_setuptools_egg_infos   z3BaseDistribution.installed_with_setuptools_egg_infocCre)aaWhether 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-inforfr`r,r,r-installed_with_dist_infos   z)BaseDistribution.installed_with_dist_infocCr&r'r(r*r,r,r-canonical_namer/zBaseDistribution.canonical_namecCr&r'r(r*r,r,r-rTr/zBaseDistribution.versioncCs|jddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)rSreplacer*r,r,r-setuptools_filenamesz$BaseDistribution.setuptools_filenamec Csrz|t}Wn tyYdSwzt|WSttjtfy8}zt dt|j |WYd}~dSd}~ww)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_textrFileNotFoundErrorr from_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningrj)r+contenter,r,r-rX&s*   zBaseDistribution.direct_urlc CsPz|d}Wn tttfyYdSw|D] }|}|r%|SqdS)N INSTALLER)roOSError ValueErrorr splitlinesstrip)r+installer_textline cleaned_liner,r,r- installer@s zBaseDistribution.installercCs |dS)N REQUESTED)r_r*r,r,r- requestedL zBaseDistribution.requestedcC t|jSr')boolr\r*r,r,r-editablePrzBaseDistribution.editablecCs|jdurdSt|jS)z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)r]rr*r,r,r-localTs  zBaseDistribution.localcC&|jdus tdur dS|jttSNF)r]r startswithrr*r,r,r- in_usersite^zBaseDistribution.in_usersitecCrr)r]rrrr*r,r,r-in_site_packagesdrz!BaseDistribution.in_site_packagespathcCr&)z7Check whether an entry in the info directory is a file.r(r+rr,r,r-r_jr/zBaseDistribution.is_filecCr&)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. r(r*r,r,r-iter_distutils_script_namesnrHz,BaseDistribution.iter_distutils_script_namescCr&)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. r(rr,r,r-rovzBaseDistribution.read_textcCr&r'r(r*r,r,r-iter_entry_pointsz"BaseDistribution.iter_entry_pointscCr&r'r(r*r,r,r-_metadata_implrzBaseDistribution._metadata_implr!)maxsizecCs|}|||Sr')r_add_egg_info_requires)r+metadatar,r,r-_metadata_cacheds z!BaseDistribution._metadata_cachedcCs|S)aMetadata 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. )rr*r,r,r-rs zBaseDistribution.metadatacCr)aPEP 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"rr*r,r,r- metadata_dicts zBaseDistribution.metadata_dictcCs |jdS)zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)rgetr*r,r,r-metadata_versions z!BaseDistribution.metadata_versioncCs|jd|jS)z*Value of "Name:" in distribution metadata.Name)rrrjr*r,r,r-rSszBaseDistribution.raw_namec Csl|jd}|dur tSz tt|}W|Sty5}zd}t||j|tWYd}~Sd}~ww)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)rrrr6rrurvrS)r+r0specrxmessager,r,r-requires_pythons z BaseDistribution.requires_pythonr,extrascCr&)zDependencies of this distribution. For modern .dist-info distributions, this is the collection of "Requires-Dist:" entries in distribution metadata. r()r+rr,r,r-iter_dependenciesrHz"BaseDistribution.iter_dependenciescCr&)zExtras 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_extrasrHz%BaseDistribution.iter_provided_extrascCs<z|d}Wn tyYdSwddt|DS)NRECORDcss"|] }tt|dVqdS)rNr;).0rowr,r,r- s zFBaseDistribution._iter_declared_entries_from_record..)rorpcsvreaderr})r+textr,r,r-"_iter_declared_entries_from_records  z3BaseDistribution._iter_declared_entries_from_recordcsz|d}Wn tyYdSwdd|jddD}|j}|j}|dus+|dur-|Sz t||Wn tyB|YSwj sH|Sfdd|DS)Nzinstalled-files.txtcss|]}|r|VqdSr'r,rpr,r,r-rszFBaseDistribution._iter_declared_entries_from_legacy..F)keependsc3s$|] }tt|jjVqdSr')r>r<r=partsrinfo_relr,r-rs  ) rorpr}rUr^r<r= relative_tor|r)r+rpathsrootr8r,rr-"_iter_declared_entries_from_legacys(   z3BaseDistribution._iter_declared_entries_from_legacycCs|p|S)aIterate 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``. )rrr*r,r,r-iter_declared_entriess z&BaseDistribution.iter_declared_entriesccsz|d}Wn tyYdSwd}}|D],}|}|r(|dr)q|dr?|dr?|dd\}}}qt|||d VqdS) aParse 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.txtNrz#[]z[]:)r@rArB)rorpr}r~rrb partitionr?)r+rwrArBrrlr,r,r-_iter_requires_txt_entriess    z+BaseDistribution._iter_requires_txt_entriesccs:dh}|D]}|j|vrq||j|jVqdS)z'Get extras from the egg-info directory.rzN)rrAadd)r+ known_extrasr7r,r,r-_iter_egg_info_extrass    z&BaseDistribution._iter_egg_info_extrasccs|D]<}|jr|jrd|jdt|jd}n|jr(dt|jd}n |jr/|j}nd}|r=|jd|Vq|jVqdS)aGet 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 == "rzz ; N)rrArBrr@)r+r7rBr,r,r-_iter_egg_info_dependencies!s  z,BaseDistribution._iter_egg_info_dependenciesrNcCsH|ds|D]}||d<q |ds |D]}||d<qdSdS)z6Add egg-info requires.txt information to the metadata.z Requires-DistzProvides-ExtraN)get_allrr)r+rdeprAr,r,r-r<s      z'BaseDistribution._add_egg_info_requires)r,)Fr2r3r4 classmethodr6rGbytesrLrOrVrWr5r rUr\r]r^rrardrhrirrjDistributionVersionrTrnrrXrrrrrrInfoPathr_r rrorr$remailrMessager functools lru_cacherrrrrrrSrrrrrrrrrr?rrrrr,r,r,r-rDks             rDc@seZdZdZedddZedeeeddfddZ deded fd d Z de d fd d Z de e fddZdedddfdedeedededede e f ddZdS)BaseEnvironmentz6An environment containing distributions to introspect.r%cCr&r'r()rFr,r,r-defaultIr/zBaseEnvironment.defaultrcCr&r'r()rFrr,r,r- from_pathsMr/zBaseEnvironment.from_pathsr.rDcCr&)zGiven 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_distributionQrHz BaseEnvironment.get_distributioncCr&)aIterate 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_distributionsYrz#BaseEnvironment._iter_distributionsccsF|D]}tjd|jtjd}|std|j|jq|VqdS)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)rrematchrj IGNORECASErurvrU)r+distproject_name_validr,r,r-iter_all_distributionsbs  z&BaseEnvironment.iter_all_distributionsTF local_onlyskipinclude_editableseditables_only user_onlycsb|}|r dd|D}|sdd|D}|rdd|D}|r(dd|D}fdd|DS)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. cs|]}|jr|VqdSr')rrdr,r,r-rz?BaseEnvironment.iter_installed_distributions..css|]}|js|VqdSr'rrr,r,r-rrcsrr'rrr,r,r-rrcsrr')rrr,r,r-rrc3s|] }|jvr|VqdSr')rjrrr,r-rs)r)r+rrrrritr,rr-iter_installed_distributionswsz,BaseEnvironment.iter_installed_distributionsN)r%r)r2r3r4__doc__rrr r r6rrr rrDrrrrrr,r,r,r-rFs6  rc@s&eZdZUeed<dejfddZdS)rNrUr%cCr&r'r(r*r,r,r- as_zipfilerzWheel.as_zipfileN)r2r3r4r6rCzipfileZipFilerr,r,r,r-rNs rNc@s.eZdZdeddfddZdejfddZdS)FilesystemWheelrUr%NcCs ||_dSr')rUrcr,r,r-__init__s zFilesystemWheel.__init__cCtj|jddSNT) allowZip64)rrrUr*r,r,r-rzFilesystemWheel.as_zipfile)r2r3r4r6rrrrr,r,r,r-rsrc@s6eZdZdedeeddfddZdejfddZ dS) MemoryWheelrUstreamr%NcCs||_||_dSr')rUr)r+rUrr,r,r-rs zMemoryWheel.__init__cCrr)rrrr*r,r,r-rrzMemoryWheel.as_zipfile) r2r3r4r6rrrrrrr,r,r,r-rsr)Hr email.messagerrrsloggingr<rrtypingrrrrrrrr r r r r r"pip._vendor.packaging.requirementsr pip._vendor.packaging.specifiersrrpip._vendor.packaging.utilsrpip._vendor.packaging.versionrrpip._internal.exceptionsrpip._internal.locationsrrpip._internal.models.direct_urlrrrpip._internal.utils.compatrpip._internal.utils.egg_linkrpip._internal.utils.miscrrpip._internal.utils.packagingrpip._internal.utils.urlsr _jsonr"r#objectrr6PurePathr getLoggerr2rur$r>r?rDrrNrrr,r,r,r-sZ<             ^U