a s hLc@sddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z mZmZddlmZmZmZmZmZddlmZddlmZmZddlmZmZddlmZdd l m!Z!dd l"m#Z#m$Z$dd l%m&Z&m'Z'm(Z(dd l)m*Z*dd l+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3ee4ej5fZ6e7e8Z9GdddeZ:ddddddZ;GdddeZGdd d eZ?Gd!d"d"e?Z@Gd#d$d$e?ZAdS)%) annotationsN) Collection ContainerIterableIterator)IOAny NamedTupleProtocolUnion) Requirement)InvalidSpecifier SpecifierSet)NormalizedNamecanonicalize_name)Version)NoneMetadataError) site_packages user_site)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError) stdlib_pkgs)egg_link_path_from_sys_path)is_localnormalize_path) url_to_path) msg_to_jsonc@sBeZdZeddddZeddddZeddddZd S) BaseEntryPointstrreturncCs tdSNNotImplementedErrorselfr(W/var/www/html/assistant/venv/lib/python3.9/site-packages/pip/_internal/metadata/base.pyname-szBaseEntryPoint.namecCs tdSr#r$r&r(r(r)value1szBaseEntryPoint.valuecCs tdSr#r$r&r(r(r)group5szBaseEntryPoint.groupN)__name__ __module__ __qualname__propertyr*r+r,r(r(r(r)r,s rztuple[str, ...]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..)r3Nrr pathlibPath)r1r2r(r(r)_convert_installed_files_path:s   r8c@s&eZdZUded<ded<ded<dS) RequiresEntryr requirementextramarkerN)r-r.r/__annotations__r(r(r(r)r9Xs r9c@seZdZedddddZedddddddZed ddd d d Zdd ddZdd ddZe dd ddZ e dd ddZ e dd ddZ e dd ddZ e dd ddZe dd ddZe dd d d!Ze dd d"d#Ze d$d d%d&Ze d'd d(d)Ze dd d*d+Ze dd d,d-Ze d.d d/d0Ze dd d1d2Ze dd d3d4Ze dd d5d6Ze dd d7d8Ze dd d9d:Ze dd d;d<Zd=dd>d?d@ZdAd dBdCZd=dd>dDdEZdFd dGdHZ dId dJdKZ!e"j#dId dLdMZ$e dNd dOdPZ%e dd dQdRZ&e dd dSdTZ'e dUd dVdWZ(dwdYdZd[d\d]Z)d^d d_d`Z*dad dbdcZ+ddd dedfZ,ddd dgdhZ-ddd didjZ.dkd dldmZ/d^d dndoZ0d^d dpdqZ1dIdrdsdtduZ2dvS)xBaseDistributionr ) directoryr"cCs tdS)zLoad the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. Nr$)clsr?r(r(r)from_directory_szBaseDistribution.from_directorybytes)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. Nr$)r@rCrDrEr(r(r)from_metadata_file_contentsgsz,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. Nr$)r@rHr*r(r(r) from_wheelys zBaseDistribution.from_wheelr!cCs|jd|jd|jdS)N z ())raw_name raw_versionlocationr&r(r(r)__repr__szBaseDistribution.__repr__cCs|jd|jS)NrJ)rLrMr&r(r(r)__str__szBaseDistribution.__str__z str | NonecCs 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)rNs 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_editablerurlrrLrN)r'rQ 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). Nr$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. Nr$r&r(r(r) info_locationszBaseDistribution.info_locationboolcCs|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)rVr6r7is_filer'rVr(r(r)installed_by_distutilssz'BaseDistribution.installed_by_distutilscCs|j}|sdSt|jdkS)zWhether this distribution is installed as an egg. This usually indicates the distribution was installed by (older versions of) easy_install. Fz.egg)rNr6r7suffixr'rNr(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-inforVendswithr6r7is_dirrYr(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-infor^rYr(r(r)installed_with_dist_infos  z)BaseDistribution.installed_with_dist_inforcCs tdSr#r$r&r(r(r)canonical_name szBaseDistribution.canonical_namercCs tdSr#r$r&r(r(r)versionszBaseDistribution.versioncCs tdSr#r$r&r(r(r)rMszBaseDistribution.raw_versioncCs|jddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)rLreplacer&r(r(r)setuptools_filenamesz$BaseDistribution.setuptools_filenamezDirectUrl | Nonec 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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningrc)r'contenter(r(r)rQs$   zBaseDistribution.direct_urlc CsPz|d}Wntttfy(YdS0|D]}|}|r2|Sq2dS)N INSTALLER)riOSError ValueErrorr splitlinesstrip)r'Zinstaller_textlineZ cleaned_liner(r(r) installer9s  zBaseDistribution.installercCs |dS)N REQUESTED)rXr&r(r(r) requestedEszBaseDistribution.requestedcCs t|jSr#)rWrTr&r(r(r)editableIszBaseDistribution.editablecCs|jdurdSt|jS)z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)rUrr&r(r(r)localMs zBaseDistribution.localcCs&|jdustdurdS|jttSNF)rUr startswithrr&r(r(r) in_usersiteWszBaseDistribution.in_usersitecCs&|jdustdurdS|jttSr)rUrrrr&r(r(r)in_site_packages]sz!BaseDistribution.in_site_packagesInfoPath)pathr"cCs tdS)z7Check whether an entry in the info directory is a file.Nr$r'rr(r(r)rXcszBaseDistribution.is_filez Iterator[str]cCs 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. Nr$r&r(r(r)iter_distutils_script_namesgsz,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. Nr$rr(r(r)rioszBaseDistribution.read_textzIterable[BaseEntryPoint]cCs tdSr#r$r&r(r(r)iter_entry_pointsxsz"BaseDistribution.iter_entry_pointszemail.message.MessagecCs tdSr#r$r&r(r(r)_metadata_impl{szBaseDistribution._metadata_implcCs|}|||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_add_egg_info_requires)r'metadatar(r(r)r~s  zBaseDistribution.metadatazdict[str, Any]cCs 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. )rrr&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_versionsz!BaseDistribution.metadata_versioncCs|jd|jS)z*Value of "Name:" in distribution metadata.Name)rrrcr&r(r(r)rLszBaseDistribution.raw_namerc 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)rrrr r rorprL)r'r+specrrmessager(r(r)requires_pythons z BaseDistribution.requires_pythonr(zCollection[str]zIterable[Requirement])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_dependenciesz Iterable[str]cCs|jdgS)zRaw Requires-Dist metadata. Requires-Dist)rget_allr&r(r(r)iter_raw_dependenciessz&BaseDistribution.iter_raw_dependencieszIterable[NormalizedName]cCs tdS)ajExtras provided by this distribution. For modern .dist-info distributions, this is the collection of "Provides-Extra:" entries in distribution metadata. The return value of this function is expected to be normalised names, per PEP 685, with the returned value being handled appropriately by `iter_dependencies`. Nr$r&r(r(r)iter_provided_extrass z%BaseDistribution.iter_provided_extraszIterator[str] | NonecCs<z|d}Wnty"YdS0ddt|DS)NRECORDcss |]}tt|dVqdS)rNr5).0rowr(r(r) zFBaseDistribution._iter_declared_entries_from_record..)rirjcsvreaderrw)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#)r8r6r7partsrZinfo_relr(r)rs) rirjrwrNrVr6r7 relative_torvr)r'rpathsrootr2r(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_entrieszIterator[RequiresEntry]ccsz|d}Wnty"YdS0d}}|D]X}|}|r4|drPq4|dr||dr||dd\}}}q4t|||d Vq4dS) 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.txtNrt#[]z[]:)r:r;r<)rirjrwrxrr_ partitionr9)r'rqr;r<ryrfr(r(r)_iter_requires_txt_entriess   z+BaseDistribution._iter_requires_txt_entriesccs<dh}|D](}t|j}||vr&q|||VqdS)z'Get extras from the egg-info directory.rtN)rrr;add)r'Z known_extrasr1r;r(r(r)_iter_egg_info_extrass   z&BaseDistribution._iter_egg_info_extrasccs|D]r}t|j}|r6|jr6d|jd|d}n$|rHd|d}n|jrV|j}nd}|rr|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 == "rtz ; N)rrr;r<r:)r'r1r;r<r(r(r)_iter_egg_info_dependenciess   z,BaseDistribution._iter_egg_info_dependenciesNone)rr"cCsD|ds |D] }||d<q|ds@|D] }||d<q2dS)z6Add egg-info requires.txt information to the metadata.rzProvides-ExtraN)rrr)r'rdepr;r(r(r)r9s      z'BaseDistribution._add_egg_info_requiresN)r()3r-r.r/ classmethodrArFrIrOrPr0rNrTrUrVrZr]rarbrcrdrMrhrQrzr|r}r~rrrXrrirr functoolscached_propertyrrrrLrrrrrrrrrrrr(r(r(r)r>^s            r>c@seZdZdZeddddZedddddZd d d d d ZddddZddddZ de dddfdddddddddZ dS)BaseEnvironmentz6An environment containing distributions to introspect.r!cCs tdSr#r$)r@r(r(r)defaultFszBaseEnvironment.defaultzlist[str] | None)rr"cCs tdSr#r$)r@rr(r(r) from_pathsJszBaseEnvironment.from_pathsr zBaseDistribution | None)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_distributionNsz BaseEnvironment.get_distributionzIterator[BaseDistribution]cCs 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_distributionsVsz#BaseEnvironment._iter_distributionsccsD|D]6}tjd|jtjd}|s8td|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)rrematchrc IGNORECASErorprN)r'distZproject_name_validr(r(r)iter_all_distributions_s z&BaseEnvironment.iter_all_distributionsTFrWzContainer[str]) 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|VqdSr#)r~rdr(r(r)rrz?BaseEnvironment.iter_installed_distributions..css|]}|js|VqdSr#r}rr(r(r)rrcss|]}|jr|VqdSr#rrr(r(r)rrcss|]}|jr|VqdSr#)rrr(r(r)rrc3s|]}|jvr|VqdSr#)rcrrr(r)rr)r)r'rrrrritr(rr)iter_installed_distributionstsz,BaseEnvironment.iter_installed_distributionsN) r-r.r/__doc__rrrrrrrrr(r(r(r)rCs rc@s$eZdZUded<ddddZdS)rGr rNzipfile.ZipFiler!cCs tdSr#r$r&r(r(r) as_zipfileszWheel.as_zipfileN)r-r.r/r=rr(r(r(r)rGs rGc@s*eZdZdddddZdddd Zd S) FilesystemWheelr r)rNr"cCs ||_dSr#)rNr\r(r(r)__init__szFilesystemWheel.__init__rr!cCstj|jddSNT) allowZip64)zipfileZipFilerNr&r(r(r)rszFilesystemWheel.as_zipfileNr-r.r/rrr(r(r(r)rsrc@s,eZdZddddddZddd d Zd S) MemoryWheelr z IO[bytes]r)rNstreamr"cCs||_||_dSr#)rNr)r'rNrr(r(r)rszMemoryWheel.__init__rr!cCstj|jddSr)rrrr&r(r(r)rszMemoryWheel.as_zipfileNrr(r(r(r)rsr)B __future__rr email.messageemailrrmloggingr6rrcollections.abcrrrrtypingrrr r r "pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr rpip._vendor.packaging.utilsrrZpip._vendor.packaging.versionrpip._internal.exceptionsrpip._internal.locationsrrpip._internal.models.direct_urlrrrpip._internal.utils.compatrZpip._internal.utils.egg_linkrpip._internal.utils.miscrrpip._internal.utils.urlsr_jsonrr PurePathr getLoggerr-rorr8r9r>rrGrrr(r(r(r)sF         hU