관리-도구
편집 파일: base.cpython-38.pyc
U ʗRea � @ 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%m&Z& d d l'm(Z(m)Z)m*Z* d d l+m,Z, d d l-m.Z. d d l/m0Z0m1Z1 d d l2m3Z3 d dl4m5Z5 ddl6m7Z7 e �rHd dl m8Z8 ne9Z8ee e f Z:ee;ej<f Z=e�>e?�Z@G dd� de8�ZAee;df ee;df e;d�dd�ZBG dd� de�ZCG dd� de8�ZDG d d � d �ZEG d d � d e8�ZFG d d!� d!eF�ZGG d"d#� d#eF�ZHdS )$� N) �IO� TYPE_CHECKING�Any� Collection� Container�Dict�Iterable�Iterator�List� NamedTuple�Optional�Tuple�Union)� Requirement)�InvalidSpecifier� SpecifierSet)�NormalizedName)� LegacyVersion�Version)�NoneMetadataError)� get_scheme� 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- ��/builddir/build/BUILDROOT/alt-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/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/ r0 r1 r- r- r- r. r% 9 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 �..���)r9 Nr" �r6 �pathlib�Path)r7 r8 r- r- r. � _convert_installed_files_pathG s r> c @ s& e Zd ZU eed< eed< eed< dS )� RequiresEntry� requirement�extra�markerN)r2 r3 r4 r6 �__annotations__r- r- r- r. r? e s r? c @ sR e Zd Zeed d�dd��Zeded d�dd��Zed�d d �Zed�d d �Ze e e d�d d��Z e e e d�dd��Z e e e d�dd��Z e e e d�dd��Ze ed�dd��Ze ed�dd��Ze ed�dd��Ze ed�dd ��Ze ed�d d ��Ze ed�d d ��Ze ed�d!d"��Ze e e d�d#d$��Ze ed�d%d&��Ze ed�d'd(��Z e ed�d)d*��Z e ed�d+d,��Z e ed�d-d.��Z e ed�d/d0��Z e!ed1�d2d3�Z"e#e d�d4d5�Z$e!ed1�d6d7�Z%e&e' d�d8d9�Z(e)j*j+d�d:d;�Z,e-j.d<d=�e)j*j+d�d>d?��Z/e e)j*j+d�d@dA��Z0e e1ee2f d�dBdC��Z3e e e d�dDdE��Z4e ed�dFdG��Z5e e6d�dHdI��Z7dbe8e e&e9 dK�dLdM�Z:e&e d�dNdO�Z;e e#e d�dPdQ�Z<e e#e d�dRdS�Z=e e#e d�dTdU�Z>e#e? d�dVdW�Z@e&e d�dXdY�ZAe&e d�dZd[�ZBe)j*j+d\d]�d^d_�ZCe ed�d`da��ZDd\S )c�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) )�clsrE r- r- r. �from_directoryl s z BaseDistribution.from_directory�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) )rF rI r/ r- r- r. � from_wheelt 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 )NrK )rM rN 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. rO � 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 rM rO )r, rR � 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)rX r< r= �is_file�r, rX 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)rO �endswith�r, rO 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�rX r\ r< r= �is_dirrZ 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_ rZ 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. rN 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. �-�_)rM �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�warningrc )r, �content�er- r- r. rR s$ ��zBaseDistribution.direct_urlc C sR z| � d�}W n tttfk r* Y dS X |�� D ]}|�� }|r4| S q4dS )N� INSTALLER� )rh �OSError� ValueErrorr � splitlines�strip)r, �installer_text�line� cleaned_liner- r- r. � installer. s zBaseDistribution.installerc C s | � d�S )N� REQUESTED)rY r+ r- r- r. � requested: s zBaseDistribution.requestedc C s t | j�S r( )�boolrV r+ r- r- r. �editable> 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)rW r r+ r- r- r. �localB s zBaseDistribution.localc C s& | j d kstd krdS | j �tt��S �NF)rW r � startswithr r+ r- r- r. � in_usersiteL s z BaseDistribution.in_usersitec C s& | j d kstd krdS | j �tt��S r� )rW r r� r r+ r- r- r. �in_site_packagesR 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. rY X 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_names\ 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. rh d s zBaseDistribution.read_textc C s t � �d S r( r) r+ r- r- r. �iter_entry_pointsm s z"BaseDistribution.iter_entry_pointsc C s t � �d S r( r) r+ r- r- r. �_metadata_implp s z BaseDistribution._metadata_implr" )�maxsizec C s | � � }| �|� |S r( )r� �_add_egg_info_requires)r, �metadatar- r- r. �_metadata_cacheds 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� rc r+ r- r- r. rM � 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 r6 r rn ro rM )r, r0 �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 tk r$ Y d S X dd� t�|�� �D �S )N�RECORDc s s | ]}t t�|d ��V qdS )r Nr; )�.0�rowr- r- r. � <genexpr>� s zFBaseDistribution._iter_declared_entries_from_record.<locals>.<genexpr>)rh ri �csv�readerrv )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> r< r= �partsr� ��info_relr- r. r� � s �) rh ri rv rO rX r< r= � relative_toru r� )r, r� �paths�rootr8 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.txtNrs �#�[�]z[]�:)r@ rA rB )rh ri rv rw r� r\ � partitionr? )r, rp rA rB ry re r- r- r. �_iter_requires_txt_entries� s z+BaseDistribution._iter_requires_txt_entriesc c s8 dh}| � � D ]$}|j|kr q|�|j� |jV qdS )z'Get extras from the egg-info directory.rs N)r� rA �add)r, � known_extrasr7 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 == "rs z ; N)r� rA rB r r@ )r, r7 rB 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� �deprA r- r- r. r� * s z'BaseDistribution._add_egg_info_requiresc C s( t | j�}|�t td�j�d�d ��S )zr Return True if given Distribution is installed in path matching distutils_scheme layout. rs �pythonr )r rW r� r �purelib�split)r, � norm_pathr- r- r. �in_install_path3 s �z BaseDistribution.in_install_path)r- )Er2 r3 r4 � classmethodr6 rG rJ rP rQ r5 r rO rV rW rX r~ r[ r^ ra rb r rc �DistributionVersionrN rg r rR r{ r} r r� r� r� �InfoPathrY r r� rh r r% r� �emailr� �Messager� � functools� lru_cacher� r� r r r� r� rM r r� r r r� r� r� r� r� r? r� r� r� r� r� r- r- r- r. rD k s� rD 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) )rF r- r- r. �defaultA s zBaseEnvironment.default)r� r' c C s t � �d S r( r) )rF r� r- r- r. � from_pathsE s zBaseEnvironment.from_pathsrD )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_distributionI 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_distributionsQ 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�matchrc � IGNORECASErn ro rO )r, �dist�project_name_validr- r- r. �iter_all_distributionsZ 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( )rc r� �r� r- r. r� � s )r� )r, r� r� r� r� r� �itr- r� r. � iter_installed_distributionso s z,BaseEnvironment.iter_installed_distributionsN)r2 r3 r4 �__doc__r� r� r r r6 r� r� r r� rD r� r r~ r r� r- r- r- r. r� > s* ��r� c @ s& e Zd ZU eed< ejd�dd�ZdS )rH rO r& c C s t � �d S r( r) r+ r- r- r. � as_zipfile� s zWheel.as_zipfileN)r2 r3 r4 r6 rC �zipfile�ZipFiler� r- r- r- r. rH � s rH c @ s, e Zd Zedd�dd�Zejd�dd�ZdS )�FilesystemWheelN)rO r' c C s || _ d S r( )rO r] r- r- r. �__init__� s zFilesystemWheel.__init__r& c C s t j| jdd�S �NT)� allowZip64)r� r� rO r+ r- r- r. r� � s zFilesystemWheel.as_zipfile)r2 r3 r4 r6 r� r� r� r� r- r- r- r. r� � s r� c @ s2 e Zd Zeee dd�dd�Zejd�dd�Z dS )� MemoryWheelN)rO �streamr' c C s || _ || _d S r( )rO r� )r, rO 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) r2 r3 r4 r6 r �bytesr� r� r� r� r- r- r- r. r� � s r� )Ir� � 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 �pip._vendor.packaging.utilsr Z pip._vendor.packaging.versionr r �pip._internal.exceptionsr �pip._internal.locationsr r 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.packagingr �pip._internal.utils.urlsr! �_jsonr# r$ �objectr� r6 �PurePathr� � getLoggerr2 rn r% r> r? rD r� rH r� r� r- r- r- r. �<module> sR < � VU