o j*d@sddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z mZmZddlmZmZmZmZddlmZddlmZmZddlmZmZddlmZdd lm Z dd l!m"Z"m#Z#dd l$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+m,Z,ddl-m.Z.ddl/m0Z0hdZ1e2ej3BZ4e5e6Z7GdddeZ8d'ddZ9GdddeZ:GdddeZ;Gdd d ZGd%d&d&e=Z?dS)() annotationsN) Collection ContainerIterableIterator)IOAny NamedTupleProtocol) Requirement)InvalidSpecifier SpecifierSet)NormalizedNamecanonicalize_name)Version)NoneMetadataError) site_packages user_site)DIRECT_URL_METADATA_NAME DirectUrlDirectUrlValidationError)egg_link_path_from_sys_path)is_localnormalize_path) url_to_path) msg_to_json>pythonwsgirefargparsec@s6eZdZed ddZed ddZed ddZd S) BaseEntryPointreturnstrcCtNNotImplementedErrorselfr)Y/var/www/html/django_cbt/venv/lib/python3.10/site-packages/pip/_internal/metadata/base.pyname3zBaseEntryPoint.namecCr#r$r%r'r)r)r*value7r,zBaseEntryPoint.valuecCr#r$r%r'r)r)r*group;r,zBaseEntryPoint.groupNr!r")__name__ __module__ __qualname__propertyr+r-r.r)r)r)r*r 2s  r entrytuple[str, ...]infor!r"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..)r7Nrr"pathlibPath)r4r6r)r)r*_convert_installed_files_path@s   r<c@s&eZdZUded<ded<ded<dS) RequiresEntryr" requirementextramarkerN)r0r1r2__annotations__r)r)r)r*r=^s  r=c@s6eZdZedzddZed{d d Zed|ddZd}ddZd}ddZe d~ddZ e j d~ddZ e d~ddZe d~ddZe ddd Ze dd!d"Ze dd#d$Ze dd%d&Ze dd(d)Ze dd+d,Ze d}d-d.Ze d}d/d0Ze dd2d3Ze d}d4d5Ze dd6d7Ze dd8d9Ze dd:d;Ze ddd?ZddBdCZddEdFZ ddGdHZ!ddJdKZ"ddMdNZ#e j ddOdPZ$e ddRdSZ%e d~dTdUZ&e d}dVdWZ'e ddYdZZ(ddd_d`Z)ddbdcZ*ddedfZ+ddhdiZ,ddjdkZ-ddldmZ.ddodpZ/ddqdrZ0ddsdtZ1ddwdxZ2dyS)BaseDistribution directoryr"r!cCr#)zLoad the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. r%)clsrCr)r)r*from_directoryezBaseDistribution.from_directorymetadata_contentsbytesfilename 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%)rDrGrIrJr)r)r*from_metadata_file_contentsmsz,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%)rDrLr+r)r)r* from_wheel zBaseDistribution.from_wheelcCs|jd|jd|jdS)N z ())raw_name raw_versionlocationr'r)r)r*__repr__szBaseDistribution.__repr__cCs|jd|jS)NrP)rRrSr'r)r)r*__str__szBaseDistribution.__str__ str | NonecCr#)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*rTrOzBaseDistribution.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_editablerurlrrRrT)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_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)r^r:r;is_filer(r^r)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)rTr:r;suffixr(rTr)r)r*installed_as_eggsz!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^endswithr:r;is_dirrar)r)r*"installed_with_setuptools_egg_infos   z3BaseDistribution.installed_with_setuptools_egg_infocCrf)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-inforgrar)r)r*installed_with_dist_infos   z)BaseDistribution.installed_with_dist_inforcCr#r$r%r'r)r)r*canonical_namer,zBaseDistribution.canonical_namercCr#r$r%r'r)r)r*versionr,zBaseDistribution.versioncCr#r$r%r'r)r)r*rSr,zBaseDistribution.raw_versioncCs|jddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)rRreplacer'r)r)r*setuptools_filenamesz$BaseDistribution.setuptools_filenameDirectUrl | Nonec 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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningrl)r(contenter)r)r*rX$s*   zBaseDistribution.direct_urlc CsPz|d}Wn tttfyYdSw|D] }|}|r%|SqdS)N INSTALLER)rsOSError ValueErrorr splitlinesstrip)r(installer_textline cleaned_liner)r)r* installer>s zBaseDistribution.installercCs |dS)N REQUESTED)r`r'r)r)r* requestedJ zBaseDistribution.requestedcC t|jSr$)r_r\r'r)r)r*editableNrzBaseDistribution.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*localRs  zBaseDistribution.localcC&|jdus tdur dS|jttSNF)r]r startswithrr'r)r)r* in_usersite\zBaseDistribution.in_usersitecCrr)r]rrrr'r)r)r*in_site_packagesbrz!BaseDistribution.in_site_packagespathInfoPathcCr#)z7Check whether an entry in the info directory is a file.r%r(rr)r)r*r`hr,zBaseDistribution.is_file Iterator[str]cCr#)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_nameslrFz,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*rstzBaseDistribution.read_textIterable[BaseEntryPoint]cCr#r$r%r'r)r)r*iter_entry_points}z"BaseDistribution.iter_entry_pointsemail.message.MessagecCr#r$r%r'r)r)r*_metadata_implrzBaseDistribution._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*rs zBaseDistribution.metadatadict[str, Any]cCr)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_versions z!BaseDistribution.metadata_versioncCs|jd|jS)z*Value of "Name:" in distribution metadata.Name)rrrlr'r)r)r*rRszBaseDistribution.raw_namer c 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)rrr r"r ryrzrR)r(r-specr|messager)r)r*requires_pythons z BaseDistribution.requires_pythonr)extrasCollection[str]Iterable[Requirement]cCr#)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_dependenciesrFz"BaseDistribution.iter_dependencies Iterable[str]cCs|jdgS)zRaw Requires-Dist metadata. Requires-Dist)rget_allr'r)r)r*iter_raw_dependenciessz&BaseDistribution.iter_raw_dependenciesIterable[NormalizedName]cCr#)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`. r%r'r)r)r*iter_provided_extrass z%BaseDistribution.iter_provided_extrasIterator[str] | NonecCs<z|d}Wn tyYdSwddt|DS)NRECORDcss"|] }tt|dVqdS)rNr9).0rowr)r)r* s zFBaseDistribution._iter_declared_entries_from_record..)rsrtcsvreaderr)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  ) rsrtrrTr^r:r; relative_torr)r(rpathsrootr6r)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_entriesIterator[RequiresEntry]ccsz|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.txtNr~#[]z[]:)r>r?r@)rsrtrrrrh partitionr=)r(r{r?r@rror)r)r*_iter_requires_txt_entriess    z+BaseDistribution._iter_requires_txt_entriesccs>dh}|D]}t|j}||vrq|||VqdS)z'Get extras from the egg-info directory.r~N)rrr?add)r( known_extrasr4r?r)r)r*_iter_egg_info_extrass   z&BaseDistribution._iter_egg_info_extrasccs|D]9}t|j}|r|jrd|jd|d}n|r%d|d}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 == "r~z ; N)rrr?r@r>)r(r4r?r@r)r)r*_iter_egg_info_dependencies"s   z,BaseDistribution._iter_egg_info_dependenciesrNonecCsH|ds|D]}||d<q |ds |D]}||d<qdSdS)z6Add egg-info requires.txt information to the metadata.rzProvides-ExtraN)rrr)r(rdepr?r)r)r*r>s      z'BaseDistribution._add_egg_info_requiresN)rCr"r!rB)rGrHrIr"rJr"r!rB)rLrMr+r"r!rBr/)r!rW)r!r_)r!r)r!r)r!rr)rrr!r_)r!r)rrr!r")r!r)r!r)r!r)r!r )r))rrr!r)r!r)r!r)r!r)r!r)rrr!r)3r0r1r2 classmethodrErKrNrUrVr3rT functoolscached_propertyr\r]r^rbrerjrkrlrmrSrqrXrrrrrrr`rrsrrrrrrRrrrrrrrrrrrr)r)r)r*rBds                                        rBc@s`eZdZdZedddZed ddZd!d d Zd"ddZd"ddZ de dddfd#ddZ dS)$BaseEnvironmentz6An environment containing distributions to introspect.r!cCr#r$r%)rDr)r)r*defaultKr,zBaseEnvironment.defaultrlist[str] | NonecCr#r$r%)rDrr)r)r* from_pathsOr,zBaseEnvironment.from_pathsr+r"BaseDistribution | NonecCr#)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_distributionSrFz BaseEnvironment.get_distributionIterator[BaseDistribution]cCr#)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_distributions[rz#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)rrematchrl IGNORECASEryrzrT)r(distproject_name_validr)r)r*iter_all_distributionsds  z&BaseEnvironment.iter_all_distributionsTF local_onlyr_skipContainer[str]include_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$)rlrrr)r*rs)r)r(rrrrritr)rr*iter_installed_distributionsysz,BaseEnvironment.iter_installed_distributionsN)r!r)rrr!r)r+r"r!r)r!r) rr_rrrr_rr_rr_r!r) r0r1r2__doc__rrrrrr stdlib_pkgsrr)r)r)r*rHs     rc@s eZdZUded<dddZdS) rMr"rTr!zipfile.ZipFilecCr#r$r%r'r)r)r* as_zipfilerzWheel.as_zipfileNr!r)r0r1r2rArr)r)r)r*rMs rMc@s eZdZd ddZd dd Zd S) FilesystemWheelrTr"r!rcCs ||_dSr$)rTrdr)r)r*__init__s zFilesystemWheel.__init__rcCtj|jddSNT) allowZip64)zipfileZipFilerTr'r)r)r*rzFilesystemWheel.as_zipfileN)rTr"r!rrr0r1r2rrr)r)r)r*rs rc@s eZdZd ddZdd d Zd S) MemoryWheelrTr"stream IO[bytes]r!rcCs||_||_dSr$)rTr)r(rTrr)r)r*rs zMemoryWheel.__init__rcCrr)rrrr'r)r)r*rrzMemoryWheel.as_zipfileN)rTr"rrr!rrrr)r)r)r*rs r)r4r5r6r5r!r")@ __future__rr email.messageemailrrwloggingr:rrcollections.abcrrrrtypingrrr r "pip._vendor.packaging.requirementsr pip._vendor.packaging.specifiersr r pip._vendor.packaging.utilsrrpip._vendor.packaging.versionrpip._internal.exceptionsrpip._internal.locationsrrpip._internal.models.direct_urlrrrpip._internal.utils.egg_linkrpip._internal.utils.miscrrpip._internal.utils.urlsr_jsonrrr"PurePathr getLoggerr0ryr r<r=rBrrMrrr)r)r)r*sH          gU