)h{c.ddlZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZddlmZmZddlmZmZddlm 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 l1m2Z2ddl3m4Z4ee5ejlfZ7ejpe9Z:GddeZ;dee5dfdee5dfde5fdZ<GddeZ=GddeZ>GddZ?GddeZ@Gdd e@ZAGd!d"e@ZBy)#N) IOAny Collection ContainerDictIterableIteratorList NamedTupleOptionalProtocolTupleUnion) 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_jsoncNeZdZedefdZedefdZedefdZy)BaseEntryPointreturnctNNotImplementedErrorselfs N/var/www/html/venv/lib/python3.12/site-packages/pip/_internal/metadata/base.pynamezBaseEntryPoint.name2 !##ctr'r(r*s r,valuezBaseEntryPoint.value6r.r/ctr'r(r*s r,groupzBaseEntryPoint.group:r.r/N)__name__ __module__ __qualname__propertystrr-r1r3r/r,r$r$1sQ $c$$$s$$$s$$r/r$entry.infor%c|r-|ddk(r%|r|ddk(r|dz }n|dd}|dd}|r |ddk(r%ttjg||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. r..)r=Nr!r8pathlibPath)r:r;s r,_convert_installed_files_pathrB?sm* E!H$tBx4' GOD9Dab  E!H$ w||*T*E* ++r/c,eZdZUeed<eed<eed<y) RequiresEntry requirementextramarkerN)r4r5r6r8__annotations__r9r/r,rDrD]s J Kr/rDc heZdZededdfdZededededdfdZedd d eddfd Zdefd Z defd Z e de efdZ e de efdZe de efdZe de efdZe defdZe defdZe defdZe defdZe defdZe defdZe defdZe defdZe de efdZe defdZe defdZe defdZ e defdZ!e defdZ"e defd Z#d!e$defd"Z%de&efd#Z'd!e$defd$Z(de)e*fd%Z+de,jZj\fd&Z/e0jbde,jZj\fd'Z2e de3ee4ffd(Z5e de efd)Z6e defd*Z7e de8fd+Z9d9d,e:ede)e;fd-Zde e&efd0Z?de e&efd1Z@de e&efd2ZAde&eBfd3ZCde)efd4ZDde)efd5ZEd6e,jZj\dd7fd8ZFy7):BaseDistribution directoryr%ct)zLoad the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. r()clsrKs r,from_directoryzBaseDistribution.from_directoryd "##r/metadata_contentsfilename project_namect)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()rMrPrQrRs r,from_metadata_file_contentsz,BaseDistribution.from_metadata_file_contentsls "##r/wheelWheelr-ct)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()rMrUr-s r, from_wheelzBaseDistribution.from_wheel~ "##r/cT|jd|jd|jdS)N z ())raw_name raw_versionlocationr*s r,__repr__zBaseDistribution.__repr__s*--$"2"2!32dmm_AFFr/c8|jd|jS)Nr[)r]r^r*s r,__str__zBaseDistribution.__str__s--$"2"2!344r/ct)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*s r,r_zBaseDistribution.locationrYr/c|j}|r&|jrt|jSyt |j }|r |j Sy)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_editabler urlrr]r_)r+re egg_link_paths r,editable_project_locationz*BaseDistribution.editable_project_locationsR__ ++-":>>22 8 FM}}$r/ct)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*s r,installed_locationz#BaseDistribution.installed_locations "##r/ct)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*s r, info_locationzBaseDistribution.info_locations "##r/cf|j}|sytj|jS)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)rmr@rAis_filer+rms r,installed_by_distutilsz'BaseDistribution.installed_by_distutilss-** ||M*2244r/cd|j}|sytj|jdk(S)zWhether this distribution is installed as an egg. This usually indicates the distribution was installed by (older versions of) easy_install. Fz.egg)r_r@rAsuffixr+r_s r,installed_as_eggz!BaseDistribution.installed_as_eggs/==||H%,,66r/c|j}|sy|jdsytj|j 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-informendswithr@rAis_dirrps r,"installed_with_setuptools_egg_infoz3BaseDistribution.installed_with_setuptools_egg_infos>** %%k2||M*1133r/c|j}|sy|jdsytj|j 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-inforwrps r,installed_with_dist_infoz)BaseDistribution.installed_with_dist_infos>** %%l3||M*1133r/ctr'r(r*s r,canonical_namezBaseDistribution.canonical_namer.r/ctr'r(r*s r,versionzBaseDistribution.versionr.r/ctr'r(r*s r,r^zBaseDistribution.raw_versionr.r/c:|jjddS)zConvert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. -_)r]replacer*s r,setuptools_filenamez$BaseDistribution.setuptools_filenames }}$$S#..r/c |jt} tj|S#t$rYywxYw#t t jtf$r0}tjdt|j|Yd}~yd}~wwxYw)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_jsonUnicodeDecodeErrorjsonJSONDecodeErrorrloggerwarningr~)r+contentes r,rezBaseDistribution.direct_url$s nn%=>G &&w/ /!     $  NN-(##    s!-< 99B &BB c |jd}|j D]}|j }|s|cSy#tttf$rYywxYw)N INSTALLER)rOSError ValueErrorr splitlinesstrip)r+installer_textline cleaned_lines r, installerzBaseDistribution.installer>sd !^^K8N#--/ $D:: ! "E +D    "EG NN7DMM1 5> ! "s? A?,A:4A?:A?extrasct)zDependencies of this distribution. For modern .dist-info distributions, this is the collection of "Requires-Dist:" entries in distribution metadata. r()r+rs r,iter_dependenciesz"BaseDistribution.iter_dependenciesrOr/c:|jjdgS)zRaw Requires-Dist metadata. Requires-Dist)rget_allr*s r,iter_raw_dependenciesz&BaseDistribution.iter_raw_dependenciess}}$$_b99r/ct)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*s r,iter_provided_extrasz%BaseDistribution.iter_provided_extrass "##r/c |jd}dtj|j DS#t$rYywxYw)NRECORDc3^K|]%}ttj|d'yw)rNr?).0rows r, zFBaseDistribution._iter_declared_entries_from_record..s"ScGLLQ()Ss+-)rrcsvreaderr)r+texts r,"_iter_declared_entries_from_recordz3BaseDistribution._iter_declared_entries_from_recordsG >>(+DTSZZ@Q5RSS!  s= A A cR |jd}d|jdD}|j}|j}|||S t j |j|js|Sfd|DS#t$rYywxYw#t$r|cYSwxYw)Nzinstalled-files.txtc3&K|] }|s| ywr'r9)rps r,rzFBaseDistribution._iter_declared_entries_from_legacy..sAqqAsF)keependsc3K|]7}ttj|jj9ywr')rBr@rAparts)rrinfo_rels r,rzFBaseDistribution._iter_declared_entries_from_legacy..s2  *',,q/*?*? P s=A) rrrr_rmr@rA relative_torr)r+rpathsrootr;rs @r,"_iter_declared_entries_from_legacyz3BaseDistribution._iter_declared_entries_from_legacys >>"78DBDOOUO;A}}!! <4<L ||D)55d;H~~L   !   L s#B $B BB B&%B&cF|jxs|jS)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*s r,iter_declared_entriesz&BaseDistribution.iter_declared_entriess&  3 3 5 9668 r/c#vK |jd}dx}}|jD]}}|j}|r|j dr'|j dr6|j dr%|jdj d\}}}nt||| y#t$rYywxYww) 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[]:)rErFrG)rrrrrrx partitionrD)r+rrFrGrrs r,_iter_requires_txt_entriesz+BaseDistribution._iter_requires_txt_entriess nn^4G&&( ND::si0779 0,/) 0 01335 3-2)* 32r/)r9)Gr4r5r6 classmethodr8rNbytesrTrXr`rbr7r r_rirkrmrrqrurzr|rr~rrr^rrrerrrrrrInfoPathror rrrr$remailrMessager functoolscached_propertyrrrrrr]rrrrrrrrrrrDrrrrr9r/r,rJrJcs$s$/A$$$ $$ $  $$" $w $c $6H $ $G#G55 $(3- $ $8C=* $HSM $ $ $x} $ $ 5 5 5 7$ 7 74D44" 4$ 4 4$$$$$$$S$$/S//HY/2 3  )4))4$441t11MTMM Q$QQ $H$$$Xc]$$h$3$$8N#;$$ 5 5$ %--//  *tCH~**5(3-55>#>> $$ 3$+AV$:x}: $h~&> $THXc]4KT HXc]4K * x '> NH],CN2x}(Xc](83u}}/D/D33r/rJceZdZdZeddZedeeeddfdZ dededfdZ de dfd Z de e fd Zd ed d d fd edeedededede e f dZy)BaseEnvironmentz6An environment containing distributions to introspect.r%ctr'r()rMs r,defaultzBaseEnvironment.defaultKr.r/rctr'r()rMrs r, from_pathszBaseEnvironment.from_pathsOr.r/r-rJct)zGiven a requirement name, return the installed distributions. The name may not be normalized. The implementation must canonicalize it for lookup. r()r+r-s r,get_distributionz BaseEnvironment.get_distributionSrOr/ct)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*s r,_iter_distributionsz#BaseEnvironment._iter_distributions[rr/c#K|jD]d}tjd|jtj}|s,t j d|j|ja|fyw)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~ IGNORECASErrr_)r+distproject_name_valids r,iter_all_distributionsz&BaseEnvironment.iter_all_distributionsdsp,,. D "$<##mm"  &;''MM J# sA9A;TF local_onlyskipinclude_editableseditables_only user_onlyc|j}|r d|D}|s d|D}|r d|D}|r d|D}fd|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. c3:K|]}|js|ywr')rrds r,rz?BaseEnvironment.iter_installed_distributions..s+177!+c3:K|]}|jr|ywr'rrs r,rz?BaseEnvironment.iter_installed_distributions..s2qzz!2rc3:K|]}|js|ywr'rrs r,rz?BaseEnvironment.iter_installed_distributions..s.1::!.rc3:K|]}|js|ywr')rrs r,rz?BaseEnvironment.iter_installed_distributions..s11==!1rc3@K|]}|jvs|ywr')r~)rrrs r,rz?BaseEnvironment.iter_installed_distributions..s>a!1!1!=>s)r)r+rrrrrits ` r,iter_installed_distributionsz,BaseEnvironment.iter_installed_distributionsysR0 ( ( * +R+B 2R2B .R.B 1R1B>2>>r/N)r%r)r4r5r6__doc__rrr r r8rrr rrJrrrrrr9r/r,rrHs@$$$xS 2$7H$$$S$X6H-I$$X.@%A$1A(B. *"&$ !?!?n!? !?  !?  !? " #!?r/rc8eZdZUeed<dej fdZy)rVr_r%ctr'r(r*s r, as_zipfilezWheel.as_zipfilerr/N)r4r5r6r8rHzipfileZipFiler#r9r/r,rVrVsM$GOO$r/rVc<eZdZdeddfdZdej fdZy)FilesystemWheelr_r%Nc||_yr')r_rts r,__init__zFilesystemWheel.__init__s   r/cDtj|jdSNT) allowZip64)r$r%r_r*s r,r#zFilesystemWheel.as_zipfilest}}>>r/)r4r5r6r8r)r$r%r#r9r/r,r'r's%!!!?GOO?r/r'cFeZdZdedeeddfdZdejfdZ y) MemoryWheelr_streamr%Nc ||_||_yr')r_r/)r+r_r/s r,r)zMemoryWheel.__init__s   r/cDtj|jdSr+)r$r%r/r*s r,r#zMemoryWheel.as_zipfilest{{t<rCs    ;KI16< 3D=0 g&&& '   8 $ $X $, c?, S/, ,<J b3xb3JR?R?j$H$?e?=%=r/