a hbfK@sddlZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z m Z mZmZmZmZmZddlmZddlmZmZddlmZddlmZmZddlmZddlm Z m!Z!dd l"m#Z#m$Z$m%Z%dd l&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-dd l.m/Z/e rddlm0Z0ne1Z0eeefZ2ee3ej4fZ5e6e7Z8Gddde0Z9ee3dfee3dfe3dddZ:Gddde0Z;GdddZGddde=Z?dS)N) IO TYPE_CHECKING Collection ContainerIterableIteratorListOptionalTupleUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedName) LegacyVersionVersion)NoneMetadataError) site_packages user_site)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError) stdlib_pkgs)egg_link_path_from_locationegg_link_path_from_sys_path)is_localnormalize_path) url_to_path)Protocolc@sBeZdZeedddZeedddZeedddZdS) BaseEntryPointreturncCs tdSNNotImplementedErrorselfr'X/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/pip/_internal/metadata/base.pyname6szBaseEntryPoint.namecCs tdSr"r#r%r'r'r(value:szBaseEntryPoint.valuecCs tdSr"r#r%r'r'r(group>szBaseEntryPoint.groupN)__name__ __module__ __qualname__propertystrr)r*r+r'r'r'r(r5s r.)entryinfor!cCs\|rD|ddkrD|r |ddkr*|d7}n |dd}|dd}qttjg||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..)r3Nr0pathlibPath)r1r2r'r'r(_convert_installed_files_pathCs   r9c@steZdZedddZedddZeeedddZeeeddd Z eeedd d Z eeedd d Z ee dddZ ee dddZee dddZee dddZeedddZeedddZeedddZeeedddZeedddZee dd d!Zee dd"d#Zee dd$d%Zee dd&d'Zee d(d)d*Zeee j!d(d+d,Z"eed(d-d.Z#e$e%dd/d0Z&ee'j(j)dd1d2Z*eeedd3d4Z+eedd5d6Z,ee-dd7d8Z.dFe/ee$e0d:d;d<Z1e$edd=d>Z2eeedd?d@Z3eeeddAdBZ4eeeddCdDZ5dES)GBaseDistributionr cCs|jd|jd|jdS)N z ())raw_nameversionlocationr%r'r'r(__repr__bszBaseDistribution.__repr__cCs|jd|jS)Nr;)r=r>r%r'r'r(__str__eszBaseDistribution.__str__cCs tdS)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. Nr#r%r'r'r(r?hs zBaseDistribution.locationcCs6|j}|r|r2t|jSnt|j}|r2|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_editablerurlrr=r?)r&rB egg_link_pathr'r'r(editable_project_locationvs  z*BaseDistribution.editable_project_locationcCs.t|j}|r|}n|jr"|j}ndSt|S)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). N)rr=r?r)r&egg_linkr?r'r'r(installed_locations z#BaseDistribution.installed_locationcCs tdS)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_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)rIr7r8is_filer&rIr'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)r?endswithr&r?r'r'r(installed_as_eggsz!BaseDistribution.installed_as_eggcCs*|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-inforIrMr7r8is_dirrKr'r'r("installed_with_setuptools_egg_infos  z3BaseDistribution.installed_with_setuptools_egg_infocCs*|j}|sdS|dsdSt|S)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-inforPrKr'r'r(installed_with_dist_infos  z)BaseDistribution.installed_with_dist_infocCs tdSr"r#r%r'r'r(canonical_nameszBaseDistribution.canonical_namecCs tdSr"r#r%r'r'r(r>szBaseDistribution.versioncCs|jddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)r=replacer%r'r'r(setuptools_filenamesz$BaseDistribution.setuptools_filenamec Csvz|t}Wnty"YdS0z t|WSttjtfyp}z t dt|j |WYd}~dSd}~00dS)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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningrT)r&contenter'r'r(rBs$   zBaseDistribution.direct_urlc CsPz|d}Wntttfy(YdS0|D]}|}|r2|Sq2dS)N INSTALLER)rYOSError ValueErrorr splitlinesstrip)r&installer_textline cleaned_liner'r'r( installers  zBaseDistribution.installercCs t|jSr")boolrFr%r'r'r(editable!szBaseDistribution.editablecCs|jdurdSt|jS)z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)rHrr%r'r'r(local%s zBaseDistribution.localcCs&|jdustdurdS|jttSNF)rHr startswithrr%r'r'r( in_usersite/szBaseDistribution.in_usersitecCs&|jdustdurdS|jttSrp)rHrrqrr%r'r'r(in_site_packages5sz!BaseDistribution.in_site_packages)pathr!cCs tdS)z7Check whether an entry in the info directory is a file.Nr#r&rtr'r'r(rJ;szBaseDistribution.is_filecCs tdS)a$Iterate through a directory in the info directory. Each item yielded would be a path relative to the info directory. :raise FileNotFoundError: If ``name`` does not exist in the directory. :raise NotADirectoryError: If ``name`` does not point to a directory. Nr#rur'r'r(iterdir?szBaseDistribution.iterdircCs tdS)zRead a file in the info directory. :raise FileNotFoundError: If ``name`` does not exist in the directory. :raise NoneMetadataError: If ``name`` exists in the info directory, but cannot be read. Nr#rur'r'r(rYIszBaseDistribution.read_textcCs tdSr"r#r%r'r'r(iter_entry_pointsRsz"BaseDistribution.iter_entry_pointscCs tdS)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. Nr#r%r'r'r(metadataUs zBaseDistribution.metadatacCs |jdS)zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)rxgetr%r'r'r(metadata_version`sz!BaseDistribution.metadata_versioncCs|jd|jS)z*Value of "Name:" in distribution metadata.Name)rxryrTr%r'r'r(r=eszBaseDistribution.raw_namec Csn|jd}|durtSztt|}Wn>tyh}z&d}t||j|tWYd}~Sd}~00|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)rxryrr0r r_r`r=)r&r*specrbmessager'r'r(requires_pythonls z BaseDistribution.requires_pythonr')extrasr!cCs tdS)zDependencies of this distribution. For modern .dist-info distributions, this is the collection of "Requires-Dist:" entries in distribution metadata. Nr#)r&rr'r'r(iter_dependenciessz"BaseDistribution.iter_dependenciescCs tdS)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_extrassz%BaseDistribution.iter_provided_extrascCs<z|d}Wnty"YdS0ddt|DS)NRECORDcss |]}tt|dVqdS)rNr6).0rowr'r'r( zFBaseDistribution._iter_declared_entries_from_record..)rYrZcsvreaderrg)r&textr'r'r("_iter_declared_entries_from_records  z3BaseDistribution._iter_declared_entries_from_recordcsz|d}Wnty"YdS0dd|jddD}|j}|j}|dusV|durZ|Szt||Wnty|YS0j s|Sfdd|DS)Nzinstalled-files.txtcss|]}|r|VqdSr"r'rpr'r'r(rrzFBaseDistribution._iter_declared_entries_from_legacy..F)keependsc3s"|]}tt|jjVqdSr")r9r7r8partsrinfo_relr'r(rs) rYrZrgr?rIr7r8 relative_torfr)r&rpathsrootr2r'rr("_iter_declared_entries_from_legacys$    z3BaseDistribution._iter_declared_entries_from_legacycCs|p|S)aIterate through file entires 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_entriesN)r')6r,r-r.r0r@rAr/r r?rFrHrIrmrLrOrRrSrrTDistributionVersionr>rXrrBrlrnrorrrsInfoPathrJrr7 PurePosixPathrvrYrrrwemailr}Messagerxrzr=rr~rr rrrrrr'r'r'r(r:asj        r:c@seZdZdZeddddZeeeeddddZ eedd d d Z e ddd d Z e ddddZ dedddfeeeeeee edddZdS)BaseEnvironmentz6An environment containing distributions to introspect.r cCs tdSr"r#)clsr'r'r(defaultszBaseEnvironment.default)rr!cCs tdSr"r#)rrr'r'r( from_pathsszBaseEnvironment.from_pathsr:)r)r!cCs tdS)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_distributionsz BaseEnvironment.get_distributioncCs tdS)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. Nr#r%r'r'r(_iter_distributionssz#BaseEnvironment._iter_distributionsccsD|D]6}tjd|jtjd}|s8td|j|jq|VqdS)z(Iterate through installed distributions.z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$)flagsz%Ignoring invalid distribution %s (%s)N)rrematchrT IGNORECASEr_r`r?)r&distproject_name_validr'r'r(iter_distributionss z"BaseEnvironment.iter_distributionsTF) local_onlyskipinclude_editableseditables_only user_onlyr!csb|}|rdd|D}|s,dd|D}|r>dd|D}|rPdd|D}fdd|DS)aReturn a list of installed distributions. :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. css|]}|jr|VqdSr")rordr'r'r(rrz?BaseEnvironment.iter_installed_distributions..css|]}|js|VqdSr"rnrr'r'r(rrcss|]}|jr|VqdSr"rrr'r'r(rrcss|]}|jr|VqdSr")rrrr'r'r(r rc3s|]}|jvr|VqdSr")rTrrr'r(r r)r)r&rrrrritr'rr(iter_installed_distributionssz,BaseEnvironment.iter_installed_distributionsN)r,r-r.__doc__ classmethodrr rr0rrrrrrrmrr:rr'r'r'r(rs* rc@s&eZdZUeed<ejdddZdS)Wheelr?r cCs tdSr"r#r%r'r'r( as_zipfileszWheel.as_zipfileN)r,r-r.r0__annotations__zipfileZipFilerr'r'r'r(r s rc@s,eZdZeddddZejdddZdS)FilesystemWheelN)r?r!cCs ||_dSr")r?rNr'r'r(__init__szFilesystemWheel.__init__r cCstj|jddSNT) allowZip64)rrr?r%r'r'r(rszFilesystemWheel.as_zipfile)r,r-r.r0rrrrr'r'r'r(rsrc@s2eZdZeeeddddZejdddZ dS) MemoryWheelN)r?streamr!cCs||_||_dSr")r?r)r&r?rr'r'r(rszMemoryWheel.__init__r cCstj|jddSr)rrrr%r'r'r(r!szMemoryWheel.as_zipfile) r,r-r.r0rbytesrrrrr'r'r'r(rsr)@r email.messagerr]loggingr7rrtypingrrrrrrrr r r "pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr rpip._vendor.packaging.utilsrZpip._vendor.packaging.versionrrpip._internal.exceptionsrpip._internal.locationsrrpip._internal.models.direct_urlrrrpip._internal.utils.compatrpip._internal.utils.egg_linkrrpip._internal.utils.miscrrpip._internal.utils.urlsrrobjectrr0rr getLoggerr,r_rr9r:rrrrr'r'r'r(sH0          ^P