관리-도구
편집 파일: base.cpython-38.pyc
U &?�f�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 m Z d dl 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 ddl3m4Z4 ee5ej6f Z7e�8e9�Z:G dd� de�Z;ee5df ee5df e5d�dd�Z<G dd� de�Z=G dd� de�Z>G dd� d�Z?G d d � d e�Z@G d d � d e@�ZAG d d!� d!e@�ZBdS )"� 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 Zd Zeed�dd��Zeed�dd��Zeed�dd��ZdS ) �BaseEntryPoint��returnc C s t � �d S �N��NotImplementedError��self� r* �I/opt/hc_python/lib/python3.8/site-packages/pip/_internal/metadata/base.py�name2 s zBaseEntryPoint.namec C s t � �d S r% r& r( r* r* r+ �value6 s zBaseEntryPoint.valuec C s t � �d S r% r& r( r* r* r+ �group: s zBaseEntryPoint.groupN)�__name__� __module__� __qualname__�property�strr, r- r. r* r* r* r+ r" 1 s r" .)�entry�infor$ c C sV | rD| d dkrD|r |d dkr*|d7 }n |dd� }| dd� } q t tj|| �� �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 �..���)r6 Nr �r3 �pathlib�Path)r4 r5 r* r* r+ � _convert_installed_files_path? s r; c @ s& e Zd ZU eed< eed< eed< dS )� RequiresEntry� requirement�extra�markerN)r/ r0 r1 r3 �__annotations__r* r* r* r+ r< ] s r< c @ s` 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 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 �d0d1��Z!e ed �d2d3��Z"e ed �d4d5��Z#e$ed6�d7d8�Z%e&e d �d9d:�Z'e$ed6�d;d<�Z(e)e* d �d=d>�Z+e,j-j.d �d?d@�Z/e0j1e,j-j.d �dAdB��Z2e e3ee4f d �dCdD��Z5e e e d �dEdF��Z6e ed �dGdH��Z7e e8d �dIdJ��Z9dce:e e)e; dL�dMdN�Z<e)e d �dOdP�Z=e)e d �dQdR�Z>e e&e d �dSdT�Z?e e&e d �dUdV�Z@e e&e d �dWdX�ZAe&eB d �dYdZ�ZCe)e d �d[d\�ZDe)e d �d]d^�ZEe,j-j.d_d`�dadb�ZFd_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& )�clsrB r* r* r+ �from_directoryd 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& )rC rE rF rG r* r* r+ �from_metadata_file_contentsl 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& )rC rJ r, r* r* r+ � from_wheel~ s zBaseDistribution.from_wheelr# c C s | j � d| j� d| j� d�S )N� z (�))�raw_name� raw_version�locationr( r* r* r+ �__repr__� s zBaseDistribution.__repr__c C s | j � d| j� �S )NrL )rN rO 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+ rP � 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_url�is_local_editabler �urlr rN rP )r) rS � 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 r9 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)rP �endswith�r) rP 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] r9 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+ �version s zBaseDistribution.versionc C s t � �d S r% r& r( r* r* r+ rO s z BaseDistribution.raw_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. �-�_)rN �replacer( r* r* r+ �setuptools_filename s z$BaseDistribution.setuptools_filenamec C sz z| � t�}W n tk r$ Y dS X z t�|�W S ttjtfk rt } z t � dt| j |� W Y �dS d}~X Y nX 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 � from_json�UnicodeDecodeError�json�JSONDecodeErrorr �logger�warningrd )r) �content�er* r* r+ rS " s$ ��zBaseDistribution.direct_urlc C sR z| � d�}W n tttfk r* Y dS X |�� D ]}|�� }|r4| S q4dS )N� INSTALLER� )rj �OSError� ValueErrorr � splitlines�strip)r) �installer_text�line� cleaned_liner* r* r+ � installer< s zBaseDistribution.installerc C s | � d�S )N� REQUESTED)rZ r( r* r* r+ � requestedH s zBaseDistribution.requestedc C s t | j�S r% )�boolrW r( r* r* r+ �editableL s zBaseDistribution.editablec C s | j dkrdS 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+ �localP s zBaseDistribution.localc C s& | j d kstd krdS | j �tt��S �NF)rX r � startswithr r( r* r* r+ � in_usersiteZ s z BaseDistribution.in_usersitec C s& | j d kstd krdS | j �tt��S r� )rX r r� r r( r* r* r+ �in_site_packages` 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 f 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_namesj 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+ rj r 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_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 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+ rN � s zBaseDistribution.raw_namec C sp | j �d�}|dkrt� S ztt|��}W n@ tk rj } z"d}t�|| j|� t� W Y �S d}~X Y nX |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 r3 r rp rq rN )r) r- �specrs �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 | j �dg �S )zRaw Requires-Dist metadata.� Requires-Dist)r� �get_allr( r* r* r+ �iter_raw_dependencies� s z&BaseDistribution.iter_raw_dependenciesc C s t � �dS )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`. Nr& r( r* r* r+ �iter_provided_extras� s z%BaseDistribution.iter_provided_extrasc C s> z| � d�}W n tk r$ Y d S X dd� t�|�� �D �S )N�RECORDc s s | ]}t t�|d ��V qdS )r Nr8 )�.0�rowr* r* r+ � <genexpr>� s zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)rj rk �csv�readerrx )r) �textr* r* r+ �"_iter_declared_entries_from_record� s z3BaseDistribution._iter_declared_entries_from_recordc s� z| � d�}W n tk r$ Y d S X dd� |jdd�D �}| j}| j}|d ksX|d kr\|S zt�|��|�� W n tk r� | Y S X � j s�|S � fdd�|D �S )Nzinstalled-files.txtc s s | ]}|r|V qd 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 qd S r% )r; r9 r: �partsr� ��info_relr* r+ r� � s �) rj rk rx rP rY r9 r: � relative_torw r� )r) r� �paths�rootr5 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 tk r$ Y dS X d }}|�� D ]X}|�� }|r6|�d�rRq6|�d�r~|�d�r~|�d��d�\}}}q6t|||d �V q6dS ) 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.txtNru �#�[�]z[]�:)r= r> r? )rj rk rx ry r� r] � partitionr< )r) rr r> r? r{ rg r* r* r+ �_iter_requires_txt_entries� s z+BaseDistribution._iter_requires_txt_entriesc c s< dh}| � � D ](}t|j�}||kr&q|�|� |V qdS )z'Get extras from the egg-info directory.ru N)r� r r> �add)r) � known_extrasr4 r> r* r* r+ �_iter_egg_info_extras s z&BaseDistribution._iter_egg_info_extrasc c s� | � � D ]r}t|j�}|r6|jr6d|j� d|� d�}n$|rHd|� d�}n|jrV|j}nd}|rr|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 == "ru z ; N)r� r r> r? r= )r) r4 r> r? 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.r� zProvides-ExtraN)r� r� r� )r) r� �depr> r* r* r+ r� < s z'BaseDistribution._add_egg_info_requires)r* )Gr/ r0 r1 � classmethodr3 rD �bytesrH rK rQ rR r2 r rP rW rX rY r� r\ r_ rb rc r rd r re rO ri r rS r} r r� r� r� r� �InfoPathrZ r r� rj r r" r� �emailr� �Messager� � functools�cached_propertyr� r r r� r� rN r r� r r r� r� r� r� r� r� r< r� r� r� r� r* r* r* r+ rA c s� � rA 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& )rC r* r* r+ �defaultI s zBaseEnvironment.default)r� r$ c C s t � �d S r% r& )rC r� r* r* r+ � from_pathsM s zBaseEnvironment.from_pathsrA )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 � IGNORECASErp rq rP )r) �dist�project_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� � s z?BaseEnvironment.iter_installed_distributions.<locals>.<genexpr>c s s | ]}|j s|V qd S r% �r� r� r* r* r+ r� � s c s s | ]}|j r|V qd S r% r� r� r* r* r+ r� � s c s s | ]}|j r|V qd S r% )r� r� r* r* r+ r� � s c 3 s | ]}|j � kr|V qd S r% )rd r� �r� r* r+ r� � s )r� )r) r� r� r� r� r� �itr* r� r+ � iter_installed_distributionsw s z,BaseEnvironment.iter_installed_distributionsN)r/ r0 r1 �__doc__r� r� r r r3 r� r� r r� rA r� r r� r r� r* r* r* r+ r� F s* ��r� c @ s& e Zd ZU eed< ejd�dd�ZdS )rI rP r# c C s t � �d S r% r& r( r* r* r+ � as_zipfile� s zWheel.as_zipfileN)r/ r0 r1 r3 r@ �zipfile�ZipFiler� r* r* r* r+ rI � s rI c @ s, e Zd Zedd�dd�Zejd�dd�ZdS )�FilesystemWheelN)rP r$ c C s || _ d S r% )rP r^ r* r* r+ �__init__� s zFilesystemWheel.__init__r# c C s t j| jdd�S �NT)� allowZip64)r� r� rP r( r* r* r+ r� � s zFilesystemWheel.as_zipfile)r/ r0 r1 r3 r� r� r� r� r* r* r* r+ r� � s r� c @ s2 e Zd Zeee dd�dd�Zejd�dd�Z dS )� MemoryWheelN)rP �streamr$ c C s || _ || _d S r% )rP r� )r) rP 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) r/ r0 r1 r3 r r� r� r� r� r� r* r* r* r+ r� � s r� )Cr� � email.messager� r� rn �loggingr9 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 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! r3 �PurePathr� � getLoggerr/ rp r" r; r< rA r� rI r� r� r* r* r* r+ �<module> sH < � fU