OwlCyberSecurity - MANAGER
Edit File: base.cpython-39.pyc
a )��e�b � @ s d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZ d dlmZ d dlmZmZ d dl m Z d dl m Z m Z d dl!m"Z" d dl#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 dl3m4Z4 ddl5m6Z6 e �rDd dl m7Z7 ne8Z7ee e f Z9ee:ej;f Z<e�=e>�Z?G dd� de7�Z@ee:df ee:df e:d�dd�ZAG dd� de�ZBG dd� de7�ZCG d d � d �ZDG d d � d e7�ZEG d d!� d!eE�ZFG d"d#� d#eE�ZGdS )$� N) �IO� TYPE_CHECKING�Any� Collection� Container�Dict�Iterable�Iterator�List� NamedTuple�Optional�Tuple�Union)� Requirement)�InvalidSpecifier� SpecifierSet)�NormalizedName)� LegacyVersion�Version)�NoneMetadataError)� site_packages� user_site)�DIRECT_URL_METADATA_NAME� DirectUrl�DirectUrlValidationError)� stdlib_pkgs)�egg_link_path_from_sys_path)�is_local�normalize_path)� safe_extra)� url_to_path� )� msg_to_json)�Protocolc @ sB e Zd Zeed�dd��Zeed�dd��Zeed�dd��ZdS ) �BaseEntryPoint��returnc C s t � �d S �N��NotImplementedError��self� r, �\/home/gouroczh/virtualenv/pat/3.9/lib/python3.9/site-packages/pip/_internal/metadata/base.py�name: s zBaseEntryPoint.namec C s t � �d S r' r( r* r, r, r- �value> s zBaseEntryPoint.valuec C s t � �d S r' r( r* r, r, r- �groupB s zBaseEntryPoint.groupN)�__name__� __module__� __qualname__�property�strr. r/ r0 r, r, r, r- r$ 9 s r$ .)�entry�infor& c C s\ | rD| d dkrD|r |d dkr*|d7 }n |dd� }| dd� } q t tjg |�| �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 �..���)r8 Nr! �r5 �pathlib�Path)r6 r7 r, r, r- � _convert_installed_files_pathG s r= c @ s& e Zd ZU eed< eed< eed< dS )� RequiresEntry� requirement�extra�markerN)r1 r2 r3 r5 �__annotations__r, r, r, r- r> e s r> c @ sX e Zd Zeed d�dd��Zeeeed d�dd��Zeded d�d d ��Zed �d d �Z ed �dd�Z e e e d �dd��Z e e e d �dd��Ze e e d �dd��Ze e e d �dd��Ze ed �dd��Ze ed �dd��Ze ed �d d ��Ze ed �d d ��Ze ed �d d!��Ze ed �d"d#��Ze ed �d$d%��Ze e e d �d&d'��Z e ed �d(d)��Z e ed �d*d+��Z e ed �d,d-��Z e ed �d.d/��Z e ed �d0d1��Z!e ed �d2d3��Z"e#ed4�d5d6�Z$e%e d �d7d8�Z&e#ed4�d9d:�Z'e(e) d �d;d<�Z*e+j,j-d �d=d>�Z.e/j0d?d@�e+j,j-d �dAdB��Z1e e+j,j-d �dCdD��Z2e e3ee4f d �dEdF��Z5e e e d �dGdH��Z6e ed �dIdJ��Z7e e8d �dKdL��Z9dce:e e(e; dN�dOdP�Z<e(e d �dQdR�Z=e e%e d �dSdT�Z>e e%e d �dUdV�Z?e e%e d �dWdX�Z@e%eA d �dYdZ�ZBe(e d �d[d\�ZCe(e d �d]d^�ZDe+j,j-d_d`�dadb�ZEd_S )d�BaseDistribution)� directoryr& c C s t � �dS )z�Load the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. Nr( )�clsrD r, r, r- �from_directoryl s z BaseDistribution.from_directory)�metadata_contents�filename� project_namer& c C s t � �dS )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. Nr( )rE rG rH rI r, r, r- �from_metadata_file_contentst s z,BaseDistribution.from_metadata_file_contents�Wheel)�wheelr. r& c C s t � �dS )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. Nr( )rE rL r. r, r, r- � from_wheel� s zBaseDistribution.from_wheelr% c C s | j � d| j� d| j� d�S )N� z (�))�raw_name�version�locationr* r, r, r- �__repr__� s zBaseDistribution.__repr__c C s | j � d| j� �S )NrN )rP rQ r* r, r, r- �__str__� s zBaseDistribution.__str__c C s t � �dS )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. Nr( r* r, r, r- rR � s zBaseDistribution.locationc C s6 | j }|r |�� r2t|j�S nt| j�}|r2| jS dS )z�The 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 �urlr rP rR )r+ rU Z egg_link_pathr, r, r- �editable_project_location� s z*BaseDistribution.editable_project_locationc C s t � �dS )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). Nr( r* r, r, r- �installed_location� s z#BaseDistribution.installed_locationc C s t � �dS )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_location� s z BaseDistribution.info_locationc C s | j }|sdS 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)rY r; r< �is_file�r+ rY r, r, r- �installed_by_distutils� s z'BaseDistribution.installed_by_distutilsc C s | j }|sdS |�d�S )z�Whether this distribution is installed as an egg. This usually indicates the distribution was installed by (older versions of) easy_install. Fz.egg)rR �endswith�r+ rR r, r, r- �installed_as_egg� s z!BaseDistribution.installed_as_eggc C s* | j }|sdS |�d�s dS 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�rY r] r; r< �is_dirr[ r, r, r- �"installed_with_setuptools_egg_info� s z3BaseDistribution.installed_with_setuptools_egg_infoc C s* | j }|sdS |�d�s dS t�|��� S )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-infor` r[ r, r, r- �installed_with_dist_info s z)BaseDistribution.installed_with_dist_infoc C s t � �d S r' r( r* r, r, r- �canonical_name s z BaseDistribution.canonical_namec C s t � �d S r' r( r* r, r, r- rQ s zBaseDistribution.versionc C s | j �dd�S )z�Convert a project name to its setuptools-compatible filename. This is a copy of ``pkg_resources.to_filename()`` for compatibility. �-�_)rP �replacer* r, r, r- �setuptools_filename s z$BaseDistribution.setuptools_filenamec C sv z| � t�}W n ty" Y dS 0 z t�|�W S ttjtfyp } z t � dt| j |� W Y d}~dS d}~0 0 dS )z�Obtain 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_textr �FileNotFoundErrorr Z from_json�UnicodeDecodeError�json�JSONDecodeErrorr �logger�warningrd )r+ �content�er, r, r- rU & s$ � �zBaseDistribution.direct_urlc C sP z| � d�}W n tttfy( Y dS 0 |�� D ]}|�� }|r2| S q2dS )NZ INSTALLER� )ri �OSError� ValueErrorr � splitlines�strip)r+ Zinstaller_text�lineZ cleaned_liner, r, r- � installer@ s zBaseDistribution.installerc C s | � d�S )NZ REQUESTED)rZ r* r, r, r- � requestedL s zBaseDistribution.requestedc C s t | j�S r' )�boolrW r* r, r, r- �editableP s zBaseDistribution.editablec C s | j du rdS t| j �S )z|If distribution is installed in the current virtual environment. Always True if we're not in a virtualenv. NF)rX r r* r, r, r- �localT s zBaseDistribution.localc C s& | j d u std u rdS | j �tt��S �NF)rX r � startswithr r* r, r, r- � in_usersite^ s z BaseDistribution.in_usersitec C s& | j d u std u rdS | j �tt��S r} )rX r r~ r r* r, r, r- �in_site_packagesd s z!BaseDistribution.in_site_packages)�pathr& c C s t � �dS )z7Check whether an entry in the info directory is a file.Nr( �r+ r� r, r, r- rZ j s zBaseDistribution.is_filec C s t � �dS )z�Find 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_namesn s z,BaseDistribution.iter_distutils_script_namesc C s t � �dS )z�Read 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( r� r, r, r- ri v s zBaseDistribution.read_textc C s t � �d S r' r( r* r, r, r- �iter_entry_points s z"BaseDistribution.iter_entry_pointsc C s t � �d S r' r( r* r, r, r- �_metadata_impl� s z BaseDistribution._metadata_implr! )�maxsizec C s | � � }| �|� |S r' )r� �_add_egg_info_requires)r+ �metadatar, r, r- �_metadata_cached� s z!BaseDistribution._metadata_cachedc 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� r* r, r, r- r� � s zBaseDistribution.metadatac C s t | j�S )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.zMetadata-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� rd r* r, r, r- rP � s zBaseDistribution.raw_namec C sn | j �d�}|du rt� S ztt|��}W n> tyh } z&d}t�|| j|� t� W Y d}~S d}~0 0 |S )z�Value 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� r� r r5 r rn ro rP )r+ r/ �specrq �messager, r, r- �requires_python� s z BaseDistribution.requires_pythonr, )�extrasr& c C s t � �dS )z�Dependencies of this distribution. For modern .dist-info distributions, this is the collection of "Requires-Dist:" entries in distribution metadata. Nr( )r+ r� r, r, r- �iter_dependencies� s z"BaseDistribution.iter_dependenciesc C s t � �dS )z�Extras provided by this distribution. For modern .dist-info distributions, this is the collection of "Provides-Extra:" entries in distribution metadata. Nr( r* r, r, r- �iter_provided_extras� s z%BaseDistribution.iter_provided_extrasc C s< z| � d�}W n ty" Y d S 0 dd� t�|�� �D �S )NZRECORDc s s | ]}t t�|d ��V qdS )r Nr: )�.0�rowr, r, r- � <genexpr>� � zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)ri rj �csv�readerru )r+ �textr, r, r- �"_iter_declared_entries_from_record� s z3BaseDistribution._iter_declared_entries_from_recordc s� z| � d�}W n ty" Y d S 0 dd� |jdd�D �}| j}| j}|d u sV|d u rZ|S zt�|��|�� W n ty� | Y S 0 � j s�|S � fdd�|D �S )Nzinstalled-files.txtc s s | ]}|r|V qd S r' r, �r� �pr, r, r- r� � r� zFBaseDistribution._iter_declared_entries_from_legacy.<locals>.<genexpr>F)�keependsc 3 s" | ]}t t�|�j� j�V qd S r' )r= r; r< �partsr� �Zinfo_relr, r- r� � s �) ri rj ru rR rY r; r< � relative_tort r� )r+ r� �paths�rootr7 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 ty" Y dS 0 d }}|�� D ]X}|�� }|r4|�d�rPq4|�d�r||�d�r||�d��d�\}}}q4t|||d �V q4dS ) 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.txtNrr �#�[�]z[]�:)r? r@ rA )ri rj ru rv r~ r] � partitionr> )r+ rp r@ rA rw rf r, r, r- �_iter_requires_txt_entries� s z+BaseDistribution._iter_requires_txt_entriesc c s8 dh}| � � D ]$}|j|v r q|�|j� |jV qdS )z'Get extras from the egg-info directory.rr N)r� r@ �add)r+ Z known_extrasr6 r, r, r- �_iter_egg_info_extras s z&BaseDistribution._iter_egg_info_extrasc c s� | � � D ]x}|jr4|jr4d|j� dt|j�� d�}n,|jrNdt|j�� d�}n|jr\|j}nd}|rx|j� d|� �V q|jV qdS )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 == "rr z ; N)r� r@ rA r r? )r+ r6 rA r, r, r- �_iter_egg_info_dependencies! s z,BaseDistribution._iter_egg_info_dependenciesN)r� r& c C sD |� d�s | �� D ] }||d< q|� d�s@| �� D ] }||d< q2dS )z6Add egg-info requires.txt information to the metadata.z Requires-DistzProvides-ExtraN)�get_allr� r� )r+ r� Zdepr@ r, r, r- r� < s z'BaseDistribution._add_egg_info_requires)r, )Fr1 r2 r3 � classmethodr5 rF �bytesrJ rM rS rT r4 r rR rW rX rY rz r\ r_ rb rc r rd �DistributionVersionrQ rh r rU rx ry r{ r| r r� �InfoPathrZ r r� ri r r$ r� �emailr� �Messager� � functools� lru_cacher� r� r r r� r� rP r r� r r r� r� r� r� r� r> r� r� r� r� r, r, r, r- rC k s� � rC c @ s� e Zd ZdZed d�dd��Zeeee d d�dd��Z eed d �d d �Z e d d�d d �Z e e d�dd�Zdedddfeee eeee e d�dd�ZdS )�BaseEnvironmentz6An environment containing distributions to introspect.r% c C s t � �d S r' r( )rE r, r, r- �defaultI s zBaseEnvironment.default)r� r& c C s t � �d S r' r( )rE r� r, r, r- � from_pathsM s zBaseEnvironment.from_pathsrC )r. r& c C s t � �dS )z�Given 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_distributionQ s z BaseEnvironment.get_distributionc C s t � �dS )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. Nr( r* r, r, r- �_iter_distributionsY s z#BaseEnvironment._iter_distributionsc c sD | � � D ]6}tjd|jtjd�}|s8t�d|j|j� q|V qdS )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�matchrd � IGNORECASErn ro rR )r+ �distZproject_name_validr, r, r- �iter_all_distributionsb s ��z&BaseEnvironment.iter_all_distributionsTF)� local_only�skip�include_editables�editables_only� user_onlyr& c sb | � � }|rdd� |D �}|s,dd� |D �}|r>dd� |D �}|rPdd� |D �}� fdd�|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 s | ]}|j r|V qd S r' )r| �r� �dr, r, r- r� � r� z?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>c s s | ]}|j s|V qd S r' �r{ r� r, r, r- r� � r� c s s | ]}|j r|V qd S r' r� r� r, r, r- r� � r� c s s | ]}|j r|V qd S r' )r r� r, r, r- r� � r� c 3 s | ]}|j � vr|V qd S r' )rd r� �r� r, r- r� � r� )r� )r+ r� r� r� r� r� �itr, r� r- � iter_installed_distributionsw s z,BaseEnvironment.iter_installed_distributionsN)r1 r2 r3 �__doc__r� r� r r r5 r� r� r r� rC r� r rz r r� r, r, r, r- r� F s* ��r� c @ s& e Zd ZU eed< ejd�dd�ZdS )rK rR r% c C s t � �d S r' r( r* r, r, r- � as_zipfile� s zWheel.as_zipfileN)r1 r2 r3 r5 rB �zipfile�ZipFiler� r, r, r, r- rK � s rK c @ s, e Zd Zedd�dd�Zejd�dd�ZdS )�FilesystemWheelN)rR r& c C s || _ d S r' )rR r^ r, r, r- �__init__� s zFilesystemWheel.__init__r% c C s t j| jdd�S �NT)� allowZip64)r� r� rR r* r, r, r- r� � s zFilesystemWheel.as_zipfile)r1 r2 r3 r5 r� r� r� r� r, r, r, r- r� � s r� c @ s2 e Zd Zeee dd�dd�Zejd�dd�Z dS )� MemoryWheelN)rR �streamr& c C s || _ || _d S r' )rR r� )r+ rR r� r, r, r- r� � s zMemoryWheel.__init__r% c C s t j| jdd�S r� )r� r� r� r* r, r, r- r� � s zMemoryWheel.as_zipfile) r1 r2 r3 r5 r r� r� r� r� r� r, r, r, r- r� � s r� )Hr� � email.messager� r� rl �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 Zpip._vendor.packaging.utilsr � pip._vendor.packaging.versionr r �pip._internal.exceptionsr �pip._internal.locationsr r Z pip._internal.models.direct_urlr r r �pip._internal.utils.compatr Z pip._internal.utils.egg_linkr �pip._internal.utils.miscr r Z pip._internal.utils.packagingr Zpip._internal.utils.urlsr �_jsonr" r# �objectr� r5 �PurePathr� � getLoggerr1 rn r$ r= r> rC r� rK r� r� r, r, r, r- �<module> sR < � ^U