golden hour
/opt/saltstack/salt/lib/python3.10/site-packages/pip/_internal/metadata/__pycache__
⬆️ Go Up
Upload
File/Folder
Size
Actions
__init__.cpython-310.pyc
4.6 KB
Del
OK
_json.cpython-310.pyc
2.12 KB
Del
OK
base.cpython-310.pyc
26.02 KB
Del
OK
pkg_resources.cpython-310.pyc
9.91 KB
Del
OK
Edit: base.cpython-310.pyc
o �xe�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 r�d dl m7Z7 ne8Z7ee e f Z9ee:ej;f Z<e�=e>�Z?G dd� de7�Z@dee:df dee:df de:fdd�ZAG dd� de�ZBG d d � d e7�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 Zedefdd��Zedefdd��Zedefdd��ZdS ) �BaseEntryPoint�returnc C � t � ��N��NotImplementedError��self� r, �O/opt/saltstack/salt/lib/python3.10/site-packages/pip/_internal/metadata/base.py�name: � zBaseEntryPoint.namec C r& r' r( r* r, r, r- �value> r/ zBaseEntryPoint.valuec C r& r' r( r* r, r, r- �groupB r/ zBaseEntryPoint.groupN)�__name__� __module__� __qualname__�property�strr. r0 r1 r, r, r, r- r$ 9 s r$ �entry.�infor% c C sj | r)| d dkr)|r|d dkr|d7 }n|dd� }| dd� } | r)| d dkst 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 �..���)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 @ sl e Zd Zededd fdd��Zededededd fdd ��Zed d d edd fd d��Zdefdd�Z defdd�Z e de e fdd��Z e de e fdd��Ze de e fdd��Ze de e fdd��Ze defdd ��Ze defd d ��Ze defd d ��Ze defd!d"��Ze defd#d$��Ze defd%d&��Ze defd'd(��Ze de e fd)d*��Z e defd+d,��Z e defd-d.��Z e defd/d0��Z e defd1d2��Z e defd3d4��Z!e defd5d6��Z"d7e#defd8d9�Z$de%e fd:d;�Z&d7e#defd<d=�Z'de(e) fd>d?�Z*de+j,j-fd@dA�Z.e/j0dBdC�de+j,j-fdDdE��Z1e de+j,j-fdFdG��Z2e de3ee4f fdHdI��Z5e de e fdJdK��Z6e defdLdM��Z7e de8fdNdO��Z9dfdQe:e de(e; fdRdS�Z<de(e fdTdU�Z=de e%e fdVdW�Z>de e%e fdXdY�Z?de e%e fdZd[�Z@de%eA fd\d]�ZBde(e fd^d_�ZCde(e fd`da�ZDdbe+j,j-ddcfddde�ZEdcS )g�BaseDistribution� directoryr% c C r& )z�Load the distribution from a metadata directory. :param directory: Path to a metadata directory, e.g. ``.dist-info``. r( )�clsrE r, r, r- �from_directoryl � 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( )rF rI rJ rK r, r, r- �from_metadata_file_contentst 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( )rF rM r. r, r, r- � from_wheel� � zBaseDistribution.from_wheelc 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 )NrQ )rS rT r* r, r, r- �__str__� s zBaseDistribution.__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- rU � rP zBaseDistribution.locationc C s8 | j }|r|�� rt|j�S dS t| j�}|r| 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 rS rU )r+ rX Z 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 }|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)r\ r< r= �is_file�r+ r\ 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)rU �endswith�r+ rU r, r, r- �installed_as_egg� s z!BaseDistribution.installed_as_eggc C �* | j }|sdS |�d�sdS 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\ r` r< 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- rT r/ 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. �-�_)rS �replacer* r, r, r- �setuptools_filename s z$BaseDistribution.setuptools_filenamec C sr z| � t�}W n ty Y dS w zt�|�W S ttjtfy8 } zt � dt| j |� W Y d}~dS d}~ww )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�warningrh )r+ �content�er, r, r- rX & s* � ����zBaseDistribution.direct_urlc C sP z| � d�}W n tttfy Y dS w |�� D ] }|�� }|r%| S qdS )NZ INSTALLER� )rm �OSError� ValueErrorr � splitlines�strip)r+ Zinstaller_text�lineZ cleaned_liner, r, r- � installer@ s � �zBaseDistribution.installerc C s | � d�S )NZ REQUESTED)r] r* r, r, r- � requestedL � zBaseDistribution.requestedc C � t | j�S r' )�boolrZ r* r, r, r- �editableP r~ 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)r[ r r* r, r, r- �localT s zBaseDistribution.localc C �& | j d u s td u r dS | j �tt��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_packagesd 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] j r/ zBaseDistribution.is_filec C r& )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. r( r* r, r, r- �iter_distutils_script_namesn rH z,BaseDistribution.iter_distutils_script_namesc C r& )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. r( r� r, r, r- rm v � zBaseDistribution.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_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 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.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� rh r* r, r, r- rS � s zBaseDistribution.raw_namec C sl | j �d�}|du r t� S z tt|��}W |S ty5 } zd}t�|| j|� t� W Y d}~S d}~ww )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 rr rs rS )r+ r0 �specru �messager, r, r- �requires_python� s ���z BaseDistribution.requires_pythonr, �extrasc C r& )z�Dependencies 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� rH z"BaseDistribution.iter_dependenciesc C r& )z�Extras provided by this distribution. For modern .dist-info distributions, this is the collection of "Provides-Extra:" entries in distribution metadata. r( r* r, r, r- �iter_provided_extras� rH z%BaseDistribution.iter_provided_extrasc C s< z| � d�}W n ty Y d S w 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>)rm rn �csv�readerry )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 w dd� |jdd�D �}| j}| j}|d u s+|d u r-|S z t�|��|�� W n tyB | Y S w � j sH|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� �Zinfo_relr, r- r� � s � � �) rm rn ry rU r\ r< r= � relative_torx 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 ty Y dS w d }}|�� D ],}|�� }|r(|�d�r)q|�d�r?|�d�r?|�d��d�\}}}qt|||d �V qdS ) 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.txtNrv �#�[�]z[]�:)r@ rA rB )rm rn ry rz r� r` � partitionr? )r+ rt rA rB r{ rj r, r, r- �_iter_requires_txt_entries� s � � �z+BaseDistribution._iter_requires_txt_entriesc c s: � dh}| � � D ]}|j|v rq|�|j� |jV qdS )z'Get extras from the egg-info directory.rv N)r� rA �add)r+ Z known_extrasr7 r, r, r- �_iter_egg_info_extras s � �z&BaseDistribution._iter_egg_info_extrasc c s� � | � � D ]<}|jr|jrd|j� dt|j�� d�}n|jr(dt|j�� d�}n |jr/|j}nd}|r=|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 == "rv z ; N)r� rA rB r r@ )r+ r7 rB 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< qdS dS )z6Add egg-info requires.txt information to the metadata.z Requires-DistzProvides-ExtraN)�get_allr� r� )r+ r� ZdeprA r, r, r- r� < s �z'BaseDistribution._add_egg_info_requires)r, )Fr2 r3 r4 � classmethodr6 rG �bytesrL rO rV rW r5 r rU rZ r[ r\ r� r_ rb rf rg r rh �DistributionVersionrT rl r rX r| r} r� r� r� r� �InfoPathr] r r� rm r r$ r� �emailr� �Messager� � functools� lru_cacher� r� r r r� r� rS 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 ZdZeddd��Zedeee dd fdd��Z deded fd d �Z de d fd d �Z de e fdd�Zdedddfdedee dededede e f dd�ZdS )�BaseEnvironmentz6An environment containing distributions to introspect.r% c C r& r' r( )rF r, r, r- �defaultI r/ zBaseEnvironment.defaultr� c C r& r' r( )rF r� r, r, r- � from_pathsM r/ zBaseEnvironment.from_pathsr. rD c C r& )z�Given 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_distributionQ rH 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_distributionsY r� z#BaseEnvironment._iter_distributionsc c sF � | � � D ]}tjd|jtjd�}|s t�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�matchrh � IGNORECASErr rs rU )r+ �distZproject_name_validr, r, r- �iter_all_distributionsb s � ���z&BaseEnvironment.iter_all_distributionsTF� local_only�skip�include_editables�editables_only� user_onlyc sb | � � }|r dd� |D �}|sdd� |D �}|r dd� |D �}|r(dd� |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 � � | ]}|j r|V qd S r' )r� �r� �dr, 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 r� r' r� r� r, r, r- r� � r� c s r� r' )r� r� r, r, r- r� � r� c 3 s � | ] }|j � vr|V qd S r' )rh 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% r� )r2 r3 r4 �__doc__r� r� r r r6 r� r� r r� rD r� r r� r r� r, r, r, r- r� F s6 �������r� c @ s& e Zd ZU eed< dejfdd�ZdS )rN rU r% c C r& r' r( r* r, r, r- � as_zipfile� r� zWheel.as_zipfileN)r2 r3 r4 r6 rC �zipfile�ZipFiler� r, r, r, r- rN � s rN c @ s. e Zd Zdeddfdd�Zdejfdd�ZdS )�FilesystemWheelrU r% Nc C s || _ d S r' )rU ra r, r, r- �__init__� s zFilesystemWheel.__init__c C � t j| jdd�S �NT)Z allowZip64)r� r� rU r* r, r, r- r� � � zFilesystemWheel.as_zipfile)r2 r3 r4 r6 r� r� r� r� r, r, r, r- r� � s r� c @ s6 e Zd Zdedee ddfdd�Zdejfdd�Z dS ) � MemoryWheelrU �streamr% Nc C s || _ || _d S r' )rU r� )r+ rU r� r, r, r- r� � s zMemoryWheel.__init__c C r� r� )r� r� r� r* r, r, r- r� � r� zMemoryWheel.as_zipfile) r2 r3 r4 r6 r r� r� r� r� r� r, r, r, r- r� � s r� )Hr� � email.messager� r� rp Zloggingr< r� r� �typingr r r r r r r r r r r r r Z"pip._vendor.packaging.requirementsr Z pip._vendor.packaging.specifiersr r Zpip._vendor.packaging.utilsr Z pip._vendor.packaging.versionr r Zpip._internal.exceptionsr �pip._internal.locationsr r Z pip._internal.models.direct_urlr r r Zpip._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� r6 �PurePathr� Z getLoggerr2 rr r$ r> r? rD r� rN r� r� r, r, r, r- �<module> sZ < � � � ^U
Save