3 de_+@sRddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZddlmZddlmZmZddlmZddlmZmZddlmZmZmZddlmZdd l m!Z!dd l"m#Z#erdd lm$Z$ne%Z$eeefZ&ej'e(Z)Gd d d e$Z*Gddde$Z+GdddZ,Gddde$Z-Gddde-Z.Gddde-Z/dS)N) IO TYPE_CHECKING Collection ContainerIterableIteratorListOptionalUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedName) LegacyVersionVersion)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError) stdlib_pkgs)egg_link_path_from_sys_path) url_to_path)Protocolc@sBeZdZeedddZeedddZeedddZdS) BaseEntryPoint)returncCs tdS)N)NotImplementedError)selfr:/tmp/pip-build-red6nood/pip/pip/_internal/metadata/base.pyname+szBaseEntryPoint.namecCs tdS)N)r)rrrrvalue/szBaseEntryPoint.valuecCs tdS)N)r)rrrrgroup3szBaseEntryPoint.groupN)__name__ __module__ __qualname__propertystrrrr rrrrr*s rc@seZdZedddZedddZeeedddZeeeddd Z eeedd d Z ee dd d Z ee dddZeeedddZeedddZeedddZeedddZeedddZeedddZeedddZeeddd Zeejjdd!d"Zeeedd#d$Zeedd%d&Z ee!dd'd(Z"ffe#eee$d)d*d+Z%eedd,d-Z&d.S)/BaseDistribution)rcCs|jd|jd|jdS)N z ())raw_nameversionlocation)rrrr__repr__9szBaseDistribution.__repr__cCs|jd|jS)Nr')r)r*)rrrr__str__<szBaseDistribution.__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. N)r)rrrrr+?s zBaseDistribution.locationcCs6|j}|r|jr2t|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_urlZis_local_editablerurlrr)r+)rr. egg_link_pathrrreditable_project_locationMs  z*BaseDistribution.editable_project_locationcCs tdS)a'Location of the .[egg|dist]-info directory. 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. N)r)rrrrinfo_directorycszBaseDistribution.info_directorycCs tdS)N)r)rrrrcanonical_namesszBaseDistribution.canonical_namecCs tdS)N)r)rrrrr*wszBaseDistribution.versioncCsny|jt}Wntk r"dSXy tj|Sttjtfk rh}zt j dt|j |dSd}~XnXdS)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_textrFileNotFoundErrorrZ from_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningr3)rcontenterrrr.{s  zBaseDistribution.direct_urlcCs tdS)N)r)rrrr installerszBaseDistribution.installercCs t|jS)N)boolr1)rrrreditableszBaseDistribution.editablecCs tdS)N)r)rrrrlocalszBaseDistribution.localcCs tdS)N)r)rrrr in_usersiteszBaseDistribution.in_usersitecCs tdS)N)r)rrrrin_site_packagessz!BaseDistribution.in_site_packages)rrcCs tdS)zRead a file in the .dist-info (or .egg-info) directory. Should raise ``FileNotFoundError`` if ``name`` does not exist in the metadata directory. N)r)rrrrrr4szBaseDistribution.read_textcCs tdS)N)r)rrrriter_entry_pointssz"BaseDistribution.iter_entry_pointscCs tdS)z?Metadata of distribution parsed from e.g. METADATA or PKG-INFO.N)r)rrrrmetadataszBaseDistribution.metadatacCs |jjdS)zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)rDget)rrrrmetadata_versionsz!BaseDistribution.metadata_versioncCs|jjd|jS)z*Value of "Name:" in distribution metadata.Name)rDrEr3)rrrrr)szBaseDistribution.raw_namecCsf|jjd}|dkrtSytt|}Wn6tk r`}zd}tj||j|tSd}~XnX|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)rDrEr r%r r9r:r))rrspecr<messagerrrrequires_pythons z BaseDistribution.requires_python)extrasrcCs tdS)zDependencies of this distribution. For modern .dist-info distributions, this is the collection of "Requires-Dist:" entries in distribution metadata. N)r)rrKrrriter_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. N)r)rrrriter_provided_extrassz%BaseDistribution.iter_provided_extrasN)'r!r"r#r%r,r-r$r r+r1r2rr3DistributionVersionr*rr.r=r>r?r@rArBr4rrrCemailrIMessagerDrFr)r rJrr rLrMrrrrr&8sH r&c@seZdZdZeddddZeeeeddddZ eedd d d Z e ddd d Z e ddddZ dedddfeeeeeee edddZdS)BaseEnvironmentz6An environment containing distributions to introspect.)rcCs tdS)N)r)clsrrrdefaultszBaseEnvironment.default)pathsrcCs tdS)N)r)rRrTrrr from_pathsszBaseEnvironment.from_pathsr&)rrcCs tdS)z=Given a requirement name, return the installed distributions.N)r)rrrrrget_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. N)r)rrrr_iter_distributionssz#BaseEnvironment._iter_distributionsccsHxB|jD]6}tjd|jtjd}|s:tjd|j|jq |Vq WdS)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)rWrematchr3 IGNORECASEr9r:r+)rdistZproject_name_validrrriter_distributionss z"BaseEnvironment.iter_distributionsTF) local_onlyskipinclude_editableseditables_only user_onlyrcsb|j}|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|VqdS)N)r@).0drrr +sz?BaseEnvironment.iter_installed_distributions..css|]}|js|VqdS)N)r?)rcrdrrrre-scss|]}|jr|VqdS)N)r?)rcrdrrrre/scss|]}|jr|VqdS)N)rA)rcrdrrrre1sc3s|]}|jkr|VqdS)N)r3)rcrd)r_rrre2s)r])rr^r_r`rarbitr)r_riter_installed_distributionssz,BaseEnvironment.iter_installed_distributionsN)r!r"r#__doc__ classmethodrSr rr%rUrVrrWr]rr>rr&rgrrrrrQs rQc@s"eZdZUeejdddZdS)Wheel)rcCs tdS)N)r)rrrr as_zipfile8szWheel.as_zipfileN)r!r"r#r%r+zipfileZipFilerkrrrrrj5s rjc@s,eZdZeddddZejdddZdS)FilesystemWheelN)r+rcCs ||_dS)N)r+)rr+rrr__init__=szFilesystemWheel.__init__)rcCstj|jddS)NT) allowZip64)rlrmr+)rrrrrk@szFilesystemWheel.as_zipfile)r!r"r#r%rorlrmrkrrrrrn<srnc@s2eZdZeeeddddZejdddZ dS) MemoryWheelN)r+streamrcCs||_||_dS)N)r+rr)rr+rrrrrroEszMemoryWheel.__init__)rcCstj|jddS)NT)rp)rlrmrr)rrrrrkIszMemoryWheel.as_zipfile) r!r"r#r%rbytesrorlrmrkrrrrrqDsrq)0 email.messagerOr7loggingrYrltypingrrrrrrrr r "pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr r pip._vendor.packaging.utilsrZpip._vendor.packaging.versionrrZpip._internal.models.direct_urlrrrZpip._internal.utils.compatrZpip._internal.utils.egg_linkrZpip._internal.utils.urlsrrobjectrN getLoggerr!r9rr&rQrjrnrqrrrrs2,       2L