B 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 rDddl m7Z7ne8Z7eee fZ9ee:ej;fZZ?Gddde7Z@ee:dfee:dfe:dddZAGdddeZBGddde7ZCGdddZDGddde7ZEGd 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@sBeZdZeedddZeedddZeedddZdS) BaseEntryPoint)returncCs tdS)N)NotImplementedError)selfr(L/var/www/cleansys/lib/python3.7/site-packages/pip/_internal/metadata/base.pyname:szBaseEntryPoint.namecCs tdS)N)r&)r'r(r(r)value>szBaseEntryPoint.valuecCs tdS)N)r&)r'r(r(r)groupBszBaseEntryPoint.groupN)__name__ __module__ __qualname__propertystrr*r+r,r(r(r(r)r$9s r$.)entryinfor%cCsZxF|rF|ddkrF|r"|ddkr,|d7}n |dd}|dd}qWttj||S)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. rz..)z..Nr!)r1pathlibPath)r2r3r(r(r)_convert_installed_files_pathGs   r7c@s&eZdZUeed<eed<eed<dS) RequiresEntry requirementextramarkerN)r-r.r/r1__annotations__r(r(r(r)r8es r8c@sXeZdZeeddddZeeeeddddZededdd d Zed d d Z ed ddZ e e ed ddZ e e ed ddZe e ed ddZe e ed ddZe ed ddZe ed ddZe ed ddZe ed ddZe ed d d!Ze ed d"d#Ze ed d$d%Ze e ed d&d'Ze ed d(d)Ze ed d*d+Ze ed d,d-Ze ed d.d/Z e ed d0d1Z!e ed d2d3Z"e#ed4d5d6Z$e%ed d7d8Z&e#ed4d9d:Z'e(e)d d;d<Z*e+j,j-d d=d>Z.e/j0d?d@e+j,j-d dAdBZ1e e+j,j-d dCdDZ2e e3ee4fd dEdFZ5e e ed dGdHZ6e ed dIdJZ7e e8d dKdLZ9dce:ee(e;dNdOdPZe e%ed dUdVZ?e e%ed dWdXZ@e%eAd dYdZZBe(ed d[d\ZCe(ed d]d^ZDe+j,j-d_d`dadbZEd_S)dBaseDistribution) directoryr%cCs tdS)zLoad the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. N)r&)clsr>r(r(r)from_directorylszBaseDistribution.from_directory)metadata_contentsfilename project_namer%cCs tdS)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. N)r&)r?rArBrCr(r(r)from_metadata_file_contentstsz,BaseDistribution.from_metadata_file_contentsWheel)wheelr*r%cCs tdS)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. N)r&)r?rFr*r(r(r) from_wheels zBaseDistribution.from_wheel)r%cCs|jd|jd|jdS)N z ())raw_nameversionlocation)r'r(r(r)__repr__szBaseDistribution.__repr__cCs|jd|jS)NrH)rJrK)r'r(r(r)__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&)r'r(r(r)rLs 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_urlZis_local_editabler urlrrJrL)r'rOZ egg_link_pathr(r(r)editable_project_locations  z*BaseDistribution.editable_project_locationcCs tdS)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)r&)r'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. N)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)rSr5r6is_file)r'rSr(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)rLendswith)r'rLr(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-info)rSrVr5r6is_dir)r'rSr(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-info)rSrVr5r6rX)r'rSr(r(r)installed_with_dist_infos  z)BaseDistribution.installed_with_dist_infocCs tdS)N)r&)r'r(r(r)canonical_nameszBaseDistribution.canonical_namecCs tdS)N)r&)r'r(r(r)rKszBaseDistribution.versioncCs|jddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)rJreplace)r'r(r(r)setuptools_filenamesz$BaseDistribution.setuptools_filenamec Cspy|t}Wntk r"dSXy t|Sttjtfk rj}zt dt|j |dSd}~XYnXdS)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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningr[)r'contenter(r(r)rO&s  zBaseDistribution.direct_urlc CsPy|d}Wntttfk r(dSXx |D]}|}|r4|Sq4WdS)NZ INSTALLER)r`OSError ValueErrorr splitlinesstrip)r'Zinstaller_textlineZ cleaned_liner(r(r) installer@szBaseDistribution.installercCs |dS)NZ REQUESTED)rT)r'r(r(r) requestedLszBaseDistribution.requestedcCs t|jS)N)boolrQ)r'r(r(r)editablePszBaseDistribution.editablecCs|jdkrdSt|jS)z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)rRr)r'r(r(r)localTs zBaseDistribution.localcCs&|jdkstdkrdS|jttS)NF)rRr startswithr)r'r(r(r) in_usersite^szBaseDistribution.in_usersitecCs&|jdkstdkrdS|jttS)NF)rRrrtr)r'r(r(r)in_site_packagesdsz!BaseDistribution.in_site_packages)pathr%cCs tdS)z7Check whether an entry in the info directory is a file.N)r&)r'rwr(r(r)rTjszBaseDistribution.is_filecCs tdS)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. N)r&)r'r(r(r)iter_distutils_script_namesnsz,BaseDistribution.iter_distutils_script_namescCs tdS)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. N)r&)r'rwr(r(r)r`vszBaseDistribution.read_textcCs tdS)N)r&)r'r(r(r)iter_entry_pointssz"BaseDistribution.iter_entry_pointscCs tdS)N)r&)r'r(r(r)_metadata_implszBaseDistribution._metadata_implr!)maxsizecCs|}|||S)N)rz_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. )r~)r'r(r(r)r}s zBaseDistribution.metadatacCs t|jS)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"r})r'r(r(r) metadata_dicts zBaseDistribution.metadata_dictcCs |jdS)zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)r}get)r'r(r(r)metadata_versionsz!BaseDistribution.metadata_versioncCs|jd|jS)z*Value of "Name:" in distribution metadata.Name)r}rr[)r'r(r(r)rJszBaseDistribution.raw_namec Csh|jd}|dkrtSytt|}Wn8tk rb}zd}t||j|tSd}~XYnX|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)r}rrr1rrerfrJ)r'r+specrhmessager(r(r)requires_pythons 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. N)r&)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. N)r&)r'r(r(r)iter_provided_extrassz%BaseDistribution.iter_provided_extrascCs<y|d}Wntk r"dSXddt|DS)NZRECORDcss |]}tt|dVqdS)rN)r1r5r6).0rowr(r(r) szFBaseDistribution._iter_declared_entries_from_record..)r`racsvreaderrl)r'textr(r(r)"_iter_declared_entries_from_records z3BaseDistribution._iter_declared_entries_from_recordcsy|d}Wntk r"dSXdd|jddD}|j}|j}|dksV|dkrZ|Syt||Wntk r|SXj s|Sfdd|DS)Nzinstalled-files.txtcss|]}|r|VqdS)Nr()rpr(r(r)rszFBaseDistribution._iter_declared_entries_from_legacy..F)keependsc3s"|]}tt|jjVqdS)N)r7r5r6parts)rr)info_relr(r)rs) r`rarlrLrSr5r6 relative_torkr)r'rpathsrootr3r()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``. )rr)r'r(r(r)iter_declared_entriess z&BaseDistribution.iter_declared_entriesccsy|d}Wntk r"dSXd}}xd|D]X}|}|r6|drRq6|dr~|dr~|dd\}}}q6t|||d Vq6WdS) 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.txtNri#[]z[]:)r9r:r;)r`rarlrmrtrV partitionr8)r'rgr:r;rnr]r(r(r)_iter_requires_txt_entriess z+BaseDistribution._iter_requires_txt_entriesccs<dh}x0|D]$}|j|kr q||j|jVqWdS)z'Get extras from the egg-info directory.riN)rr:add)r'Z known_extrasr2r(r(r)_iter_egg_info_extrass   z&BaseDistribution._iter_egg_info_extrasccsx|D]x}|jr6|jr6d|jdt|jd}n,|jrPdt|jd}n|jr^|j}nd}|rz|jd|Vq |jVq WdS)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 == "riz ; N)rr:r;rr9)r'r2r;r(r(r)_iter_egg_info_dependencies!s  z,BaseDistribution._iter_egg_info_dependenciesN)r}r%cCsL|ds$x|D] }||d<qW|dsHx|D] }||d<q8WdS)z6Add egg-info requires.txt information to the metadata.z Requires-DistzProvides-ExtraN)get_allrr)r'r}Zdepr:r(r(r)r|<s    z'BaseDistribution._add_egg_info_requires)r()Fr-r.r/ classmethodr1r@bytesrDrGrMrNr0r rLrQrRrSrqrUrWrYrZrr[DistributionVersionrKr_rrOrorprrrsrurvInfoPathrTr rxr`rr$ryemailrMessagerz functools lru_cacher~r}rrrrrJrrrrrrrrrr8rrrr|r(r(r(r)r=ks             r=c@seZdZdZeddddZeeeeddddZ eedd d d Z e ddd d Z e e dddZdedddfeeeeeee e dddZdS)BaseEnvironmentz6An environment containing distributions to introspect.)r%cCs tdS)N)r&)r?r(r(r)defaultIszBaseEnvironment.default)rr%cCs tdS)N)r&)r?rr(r(r) from_pathsMszBaseEnvironment.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. N)r&)r'r*r(r(r)get_distributionQsz 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&)r'r(r(r)_iter_distributionsYsz#BaseEnvironment._iter_distributionsccsHxB|D]6}tjd|jtjd}|s:td|j|jq |Vq WdS)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)rrematchr[ IGNORECASErerfrL)r'distZproject_name_validr(r(r)iter_all_distributionsbs z&BaseEnvironment.iter_all_distributionsTF) local_onlyskipinclude_editableseditables_only user_onlyr%csb|}|rdd|D}|s,dd|D}|r>dd|D}|rPdd|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. css|]}|jr|VqdS)N)rs)rdr(r(r)rsz?BaseEnvironment.iter_installed_distributions..css|]}|js|VqdS)N)rr)rrr(r(r)rscss|]}|jr|VqdS)N)rr)rrr(r(r)rscss|]}|jr|VqdS)N)ru)rrr(r(r)rsc3s|]}|jkr|VqdS)N)r[)rr)rr(r)rs)r)r'rrrrritr()rr)iter_installed_distributionswsz,BaseEnvironment.iter_installed_distributionsN)r-r.r/__doc__rrr r r1rrr rr=rrrqrrr(r(r(r)rFs rc@s&eZdZUeed<ejdddZdS)rErL)r%cCs tdS)N)r&)r'r(r(r) as_zipfileszWheel.as_zipfileN)r-r.r/r1r<zipfileZipFilerr(r(r(r)rEs rEc@s,eZdZeddddZejdddZdS)FilesystemWheelN)rLr%cCs ||_dS)N)rL)r'rLr(r(r)__init__szFilesystemWheel.__init__)r%cCstj|jddS)NT) allowZip64)rrrL)r'r(r(r)rszFilesystemWheel.as_zipfile)r-r.r/r1rrrrr(r(r(r)rsrc@s2eZdZeeeddddZejdddZ dS) MemoryWheelN)rLstreamr%cCs||_||_dS)N)rLr)r'rLrr(r(r)rszMemoryWheel.__init__)r%cCstj|jddS)NT)r)rrr)r'r(r(r)rszMemoryWheel.as_zipfile) r-r.r/r1rrrrrrr(r(r(r)rsr)Hr email.messagerrrcloggingr5rrtypingrrrrrrrr r r r r r"pip._vendor.packaging.requirementsrZ pip._vendor.packaging.specifiersrrZpip._vendor.packaging.utilsrpip._vendor.packaging.versionrrpip._internal.exceptionsrpip._internal.locationsrrZpip._internal.models.direct_urlrrrpip._internal.utils.compatrZpip._internal.utils.egg_linkrpip._internal.utils.miscrrZpip._internal.utils.packagingrZpip._internal.utils.urlsr _jsonr"r#objectrr1PurePathr getLoggerr-rer$r7r8r=rrErrr(r(r(r)sP<            ^U