o
    [h{c                     @   s  d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl	m
Z
mZmZmZmZmZmZmZmZmZmZmZmZ d dlmZ d dlmZmZ d dlmZmZ d dlm Z  d dl!m"Z" d dl#m$Z$m%Z% d d	l&m'Z'm(Z(m)Z) d d
l*m+Z+ d dl,m-Z- d dl.m/Z/m0Z0 d dl1m2Z2 ddl3m4Z4 ee5ej6f Z7e8e9Z:G dd deZ;dee5df dee5df de5fddZ<G dd deZ=G dd deZ>G dd dZ?G dd deZ@G d d! d!e@ZAG d"d# d#e@ZBdS )$    N)IOAny
Collection	ContainerDictIterableIteratorList
NamedTupleOptionalProtocolTupleUnion)Requirement)InvalidSpecifierSpecifierSet)NormalizedNamecanonicalize_name)Version)NoneMetadataError)site_packages	user_site)DIRECT_URL_METADATA_NAME	DirectUrlDirectUrlValidationError)stdlib_pkgs)egg_link_path_from_sys_path)is_localnormalize_path)url_to_path   )msg_to_jsonc                   @   sB   e Zd ZedefddZedefddZedefddZdS )	BaseEntryPointreturnc                 C      t  NNotImplementedErrorself r*   /home/ubuntu/experiments/live_experiments/Pythonexperiments/Otree/venv/lib/python3.10/site-packages/pip/_internal/metadata/base.pyname2      zBaseEntryPoint.namec                 C   r$   r%   r&   r(   r*   r*   r+   value6   r-   zBaseEntryPoint.valuec                 C   r$   r%   r&   r(   r*   r*   r+   group:   r-   zBaseEntryPoint.groupN)__name__
__module____qualname__propertystrr,   r.   r/   r*   r*   r*   r+   r"   1   s    r"   entry.infor#   c                 C   sj   | r)| d dkr)|r|d dkr|d7 }n|dd }| dd } | r)| d dkst tjg || R  S )a  Convert 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   ..)r7   Nr    r4   pathlibPath)r5   r6   r*   r*   r+   _convert_installed_files_path?   s   
r<   c                   @   s&   e Zd ZU eed< eed< eed< dS )RequiresEntryrequirementextramarkerN)r0   r1   r2   r4   __annotations__r*   r*   r*   r+   r=   ]   s   
 r=   c                	   @   st  e Zd Zededd fddZededededd fdd	Zed
ddedd fddZdefddZ	defddZ
edee fddZedee fddZedee fddZedee fddZedefddZedefddZedefdd Zedefd!d"Zedefd#d$Zedefd%d&Zedefd'd(Zedefd)d*Zedee fd+d,Zedefd-d.Zedefd/d0Zedefd1d2Z edefd3d4Z!edefd5d6Z"edefd7d8Z#d9e$defd:d;Z%de&e fd<d=Z'd9e$defd>d?Z(de)e* fd@dAZ+de,j-j.fdBdCZ/e0j1de,j-j.fdDdEZ2ede3ee4f fdFdGZ5edee fdHdIZ6edefdJdKZ7ede8fdLdMZ9dfdOe:e de)e; fdPdQZ<de)e fdRdSZ=de)e fdTdUZ>dee&e  fdVdWZ?dee&e  fdXdYZ@dee&e  fdZd[ZAde&eB fd\d]ZCde)e fd^d_ZDde)e fd`daZEdbe,j-j.ddcfdddeZFdcS )gBaseDistribution	directoryr#   c                 C   r$   )zLoad the distribution from a metadata directory.

        :param directory: Path to a metadata directory, e.g. ``.dist-info``.
        r&   )clsrC   r*   r*   r+   from_directoryd      zBaseDistribution.from_directorymetadata_contentsfilenameproject_namec                 C   r$   )a  Load 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&   )rD   rG   rH   rI   r*   r*   r+   from_metadata_file_contentsl   s   z,BaseDistribution.from_metadata_file_contentswheelWheelr,   c                 C   r$   )a  Load 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&   )rD   rK   r,   r*   r*   r+   
from_wheel~      zBaseDistribution.from_wheelc                 C   s   | j  d| j d| j dS )N z ())raw_nameraw_versionlocationr(   r*   r*   r+   __repr__   s   zBaseDistribution.__repr__c                 C   s   | j  d| j S )NrO   )rQ   rR   r(   r*   r*   r+   __str__   s   zBaseDistribution.__str__c                 C   r$   )a  Where 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+   rS      rN   zBaseDistribution.locationc                 C   s8   | j }|r| rt|jS dS t| j}|r| jS dS )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_urlis_local_editabler   urlr   rQ   rS   )r)   rV   egg_link_pathr*   r*   r+   editable_project_location   s   
	
z*BaseDistribution.editable_project_locationc                 C   r$   )a  The 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_location   s   z#BaseDistribution.installed_locationc                 C   r$   )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_location   s   zBaseDistribution.info_locationc                 C   s   | j }|sdS t| S )a  Whether 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_filer)   r\   r*   r*   r+   installed_by_distutils   s   z'BaseDistribution.installed_by_distutilsc                 C   s   | j }|sdS t|jdkS )zWhether this distribution is installed as an egg.

        This usually indicates the distribution was installed by (older versions
        of) easy_install.
        Fz.egg)rS   r:   r;   suffixr)   rS   r*   r*   r+   installed_as_egg   s   z!BaseDistribution.installed_as_eggc                 C   *   | j }|sdS |dsdS t| S )a  Whether 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r\   endswithr:   r;   is_dirr^   r*   r*   r+   "installed_with_setuptools_egg_info   s   
z3BaseDistribution.installed_with_setuptools_egg_infoc                 C   rc   )aa  Whether 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-inford   r^   r*   r*   r+   installed_with_dist_info   s   	
z)BaseDistribution.installed_with_dist_infoc                 C   r$   r%   r&   r(   r*   r*   r+   canonical_name  r-   zBaseDistribution.canonical_namec                 C   r$   r%   r&   r(   r*   r*   r+   version  r-   zBaseDistribution.versionc                 C   r$   r%   r&   r(   r*   r*   r+   rR     r-   zBaseDistribution.raw_versionc                 C   s   | j ddS )zConvert a project name to its setuptools-compatible filename.

        This is a copy of ``pkg_resources.to_filename()`` for compatibility.
        -_)rQ   replacer(   r*   r*   r+   setuptools_filename  s   z$BaseDistribution.setuptools_filenamec              
   C   sr   z|  t}W n
 ty   Y dS w zt|W S  ttjtfy8 } zt	
dt| j| W Y d}~dS d}~ww )zObtain a DirectUrl from this distribution.

        Returns None if the distribution has no `direct_url.json` metadata,
        or if `direct_url.json` is invalid.
        NzError parsing %s for %s: %s)	read_textr   FileNotFoundErrorr   	from_jsonUnicodeDecodeErrorjsonJSONDecodeErrorr   loggerwarningri   )r)   contenter*   r*   r+   rV   $  s*   zBaseDistribution.direct_urlc              
   C   sP   z|  d}W n tttfy   Y dS w | D ]}| }|r%|  S qdS )N	INSTALLER )ro   OSError
ValueErrorr   
splitlinesstrip)r)   installer_textlinecleaned_liner*   r*   r+   	installer>  s   zBaseDistribution.installerc                 C   s
   |  dS )N	REQUESTED)r]   r(   r*   r*   r+   	requestedJ     
zBaseDistribution.requestedc                 C   
   t | jS r%   )boolrZ   r(   r*   r*   r+   editableN  r   zBaseDistribution.editablec                 C   s   | j du rdS t| j S )z|If distribution is installed in the current virtual environment.

        Always True if we're not in a virtualenv.
        NF)r[   r   r(   r*   r*   r+   localR  s   

zBaseDistribution.localc                 C   &   | j d u s	td u rdS | j ttS NF)r[   r   
startswithr   r(   r*   r*   r+   in_usersite\     zBaseDistribution.in_usersitec                 C   r   r   )r[   r   r   r   r(   r*   r*   r+   in_site_packagesb  r   z!BaseDistribution.in_site_packagespathc                 C   r$   )z7Check whether an entry in the info directory is a file.r&   r)   r   r*   r*   r+   r]   h  r-   zBaseDistribution.is_filec                 C   r$   )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_namesl  rF   z,BaseDistribution.iter_distutils_script_namesc                 C   r$   )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&   r   r*   r*   r+   ro   t     zBaseDistribution.read_textc                 C   r$   r%   r&   r(   r*   r*   r+   iter_entry_points}     z"BaseDistribution.iter_entry_pointsc                 C   r$   r%   r&   r(   r*   r*   r+   _metadata_impl  r   zBaseDistribution._metadata_implc                 C   s   |   }| | |S )a  Metadata 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   	
zBaseDistribution.metadatac                 C   r   )a  PEP 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_dict  s   
	zBaseDistribution.metadata_dictc                 C   s   | j dS )zDValue of "Metadata-Version:" in distribution metadata, if available.zMetadata-Version)r   getr(   r*   r*   r+   metadata_version  s   z!BaseDistribution.metadata_versionc                 C   s   | j d| jS )z*Value of "Name:" in distribution metadata.Name)r   r   ri   r(   r*   r*   r+   rQ     s   zBaseDistribution.raw_namec              
   C   sl   | j d}|du rt S z	tt|}W |S  ty5 } zd}t|| j| t W  Y d}~S d}~ww )zValue of "Requires-Python:" in distribution metadata.

        If the key does not exist or contains an invalid value, an empty
        SpecifierSet should be returned.
        zRequires-PythonNz-Package %r has an invalid Requires-Python: %s)r   r   r   r4   r   ru   rv   rQ   )r)   r.   specrx   messager*   r*   r+   requires_python  s   z BaseDistribution.requires_pythonr*   extrasc                 C   r$   )zDependencies of this distribution.

        For modern .dist-info distributions, this is the collection of
        "Requires-Dist:" entries in distribution metadata.
        r&   )r)   r   r*   r*   r+   iter_dependencies  rF   z"BaseDistribution.iter_dependenciesc                 C   s   | j dg S )zRaw Requires-Dist metadata.Requires-Dist)r   get_allr(   r*   r*   r+   iter_raw_dependencies  s   z&BaseDistribution.iter_raw_dependenciesc                 C   r$   )aj  Extras 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_extras  s   
z%BaseDistribution.iter_provided_extrasc                 C   s<   z|  d}W n
 ty   Y d S w dd t| D S )NRECORDc                 s   s"    | ]}t t|d  V  qdS )r   Nr9   ).0rowr*   r*   r+   	<genexpr>  s     zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)ro   rp   csvreaderr}   )r)   textr*   r*   r+   "_iter_declared_entries_from_record  s   z3BaseDistribution._iter_declared_entries_from_recordc                    s   z|  d}W n
 ty   Y d S w dd |jddD }| j}| j}|d u s+|d u r-|S z
t|| W n tyB   | Y S w  j	sH|S  fdd|D S )Nzinstalled-files.txtc                 s   s    | ]}|r|V  qd S r%   r*   r   pr*   r*   r+   r     s    zFBaseDistribution._iter_declared_entries_from_legacy.<locals>.<genexpr>F)keependsc                 3   s$    | ]}t t|j jV  qd S r%   )r<   r:   r;   partsr   info_relr*   r+   r     s
    
)
ro   rp   r}   rS   r\   r:   r;   relative_tor|   r   )r)   r   pathsrootr6   r*   r   r+   "_iter_declared_entries_from_legacy  s(   
z3BaseDistribution._iter_declared_entries_from_legacyc                 C   s   |   p|  S )a  Iterate 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``.
        )r   r   r(   r*   r*   r+   iter_declared_entries  s   z&BaseDistribution.iter_declared_entriesc                 c   s    z|  d}W n
 ty   Y dS w d }}| D ],}| }|r(|dr)q|dr?|dr?|dd\}}}qt|||d	V  qdS )
a  Parse 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.txtNrz   #[]z[]:)r>   r?   r@   )ro   rp   r}   r~   r   re   	partitionr=   )r)   rw   r?   r@   r   rl   r*   r*   r+   _iter_requires_txt_entries  s    z+BaseDistribution._iter_requires_txt_entriesc                 c   s>    dh}|   D ]}t|j}||v rq|| |V  qdS )z'Get extras from the egg-info directory.rz   N)r   r   r?   add)r)   known_extrasr5   r?   r*   r*   r+   _iter_egg_info_extras  s   

z&BaseDistribution._iter_egg_info_extrasc                 c   s    |   D ]9}t|j}|r|jrd|j d| d}n|r%d| d}n	|jr,|j}nd}|r:|j d| V  q|jV  qdS )a  Get 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 == "rz   z ; N)r   r   r?   r@   r>   )r)   r5   r?   r@   r*   r*   r+   _iter_egg_info_dependencies"  s   


z,BaseDistribution._iter_egg_info_dependenciesr   Nc                 C   sH   | ds|  D ]}||d< q	| ds |  D ]}||d< qdS dS )z6Add egg-info requires.txt information to the metadata.r   zProvides-ExtraN)r   r   r   )r)   r   depr?   r*   r*   r+   r   >  s   



z'BaseDistribution._add_egg_info_requires)r*   )Gr0   r1   r2   classmethodr4   rE   bytesrJ   rM   rT   rU   r3   r   rS   rZ   r[   r\   r   r_   rb   rg   rh   r   ri   r   rj   rR   rn   r   rV   r   r   r   r   r   r   InfoPathr]   r   r   ro   r   r"   r   emailr   Messager   	functoolscached_propertyr   r   r   r   r   rQ   r   r   r   r   r   r   r   r   r   r   r=   r   r   r   r   r*   r*   r*   r+   rB   c   s    		

rB   c                   @   s   e Zd ZdZedddZedeee  dd fddZ	deded	 fd
dZ
ded	 fddZdee fddZdedddfdedee dedededee fddZdS )BaseEnvironmentz6An environment containing distributions to introspect.r#   c                 C   r$   r%   r&   )rD   r*   r*   r+   defaultK  r-   zBaseEnvironment.defaultr   c                 C   r$   r%   r&   )rD   r   r*   r*   r+   
from_pathsO  r-   zBaseEnvironment.from_pathsr,   rB   c                 C   r$   )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_distributionS  rF   z BaseEnvironment.get_distributionc                 C   r$   )a  Iterate 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[  r   z#BaseEnvironment._iter_distributionsc                 c   sF    |   D ]}tjd|jtjd}|std|j|j q|V  qdS )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)r   rematchri   
IGNORECASEru   rv   rS   )r)   distproject_name_validr*   r*   r+   iter_all_distributionsd  s    z&BaseEnvironment.iter_all_distributionsTF
local_onlyskipinclude_editableseditables_only	user_onlyc                    sb   |   }|rdd |D }|sdd |D }|rdd |D }|r(dd |D } fdd|D S )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.
        c                 s       | ]}|j r|V  qd S r%   )r   r   dr*   r*   r+   r         z?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>c                 s   s    | ]}|j s|V  qd S r%   r   r   r*   r*   r+   r     r   c                 s   r   r%   r   r   r*   r*   r+   r     r   c                 s   r   r%   )r   r   r*   r*   r+   r     r   c                 3   s    | ]
}|j  vr|V  qd S r%   )ri   r   r   r*   r+   r     s    )r   )r)   r   r   r   r   r   itr*   r   r+   iter_installed_distributionsy  s   z,BaseEnvironment.iter_installed_distributionsN)r#   r   )r0   r1   r2   __doc__r   r   r   r	   r4   r   r   r   r   rB   r   r   r   r   r   r*   r*   r*   r+   r   H  s6    	r   c                   @   s&   e Zd ZU eed< dejfddZdS )rL   rS   r#   c                 C   r$   r%   r&   r(   r*   r*   r+   
as_zipfile  r   zWheel.as_zipfileN)r0   r1   r2   r4   rA   zipfileZipFiler   r*   r*   r*   r+   rL     s   
 rL   c                   @   s.   e Zd ZdeddfddZdejfddZdS )FilesystemWheelrS   r#   Nc                 C   s
   || _ d S r%   )rS   ra   r*   r*   r+   __init__  s   
zFilesystemWheel.__init__c                 C      t j| jddS NT)
allowZip64)r   r   rS   r(   r*   r*   r+   r        zFilesystemWheel.as_zipfile)r0   r1   r2   r4   r   r   r   r   r*   r*   r*   r+   r     s    r   c                   @   s6   e Zd Zdedee ddfddZdejfddZ	dS )	MemoryWheelrS   streamr#   Nc                 C   s   || _ || _d S r%   )rS   r   )r)   rS   r   r*   r*   r+   r     s   
zMemoryWheel.__init__c                 C   r   r   )r   r   r   r(   r*   r*   r+   r     r   zMemoryWheel.as_zipfile)
r0   r1   r2   r4   r   r   r   r   r   r   r*   r*   r*   r+   r     s    r   )Cr   email.messager   r   rs   loggingr:   r   r   typingr   r   r   r   r   r   r   r	   r
   r   r   r   r   "pip._vendor.packaging.requirementsr   Z pip._vendor.packaging.specifiersr   r   Zpip._vendor.packaging.utilsr   r   Zpip._vendor.packaging.versionr   pip._internal.exceptionsr   pip._internal.locationsr   r   pip._internal.models.direct_urlr   r   r   pip._internal.utils.compatr   pip._internal.utils.egg_linkr   pip._internal.utils.miscr   r   pip._internal.utils.urlsr   _jsonr!   r4   PurePathr   	getLoggerr0   ru   r"   r<   r=   rB   r   rL   r   r   r*   r*   r*   r+   <module>   sP    <



   hU