File: //usr/local/lib/python3.10/site-packages/pip/_internal/utils/__pycache__/misc.cpython-310.pyc
o
��i�V �
@ s2 d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
Z
d dl Z d dl Z
d dlmZ d dlmZmZmZ d dlmZ d dlmZmZmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$ d dl%m&Z& d dl'm(Z(m)Z)m*Z* d dl+m,Z, d d l-m.Z.m/Z/ d d
l0m1Z1 d d l2m3Z3 d d l4m5Z5 g d
�Z6e�7e8�Z9e#d�Z:e!e"e; e;ef Z<e!e=e=e=f Z>e!e?e!e e? e e? f f Z@de?fdd�ZAde!e=df de!e=e=e=f fdd�ZBde?ddfdd�ZCde?fdd�ZDe(de)d �e*d �d �d�d e?d!eEddfd"d#��ZFd$edef de?d%e<ddfd&d'�ZGde?de?fd(d)�ZHd�d e?d+e?de?fd,d-�ZId.e?d/e e? de?fd0d1�ZJd.e?ddfd2d3�ZKd.e?d/e e? de?fd4d5�ZLd.e?de?fd6d7�ZMd.e?de?fd8d9�ZNd:e?de=fd;d<�ZOd=ePde?fd>d?�ZQd@e e e de!e e? e e= f fdAdB�ZRde?deEfdCdD�ZSejTfdEedFe=deeUddf fdGdH�ZVd�de?dIeEde?fdJdK�ZWde?de!e?e?f fdLdM�ZXdNe?dOe?ddfdPdQ�ZYde?deEfdRdS�ZZdTedUeddfdVdW�Z[G dXdY� dYe�Z\e j]dZe?dee\ddf fd[d\��Z^dee\ fd]d^�Z_dee\ fd_d`�Z`daedbede"e fdcdd�Zadee?dfe e= de?fdgdh�Zbd�dje?dke?de?fdldm�Zcdje?de!e?e e= f fdndo�Zddje?de@fdpdq�Zedje?de?fdrds�Zfdte?duee?ge!edf f de!e?e@f fdvdw�Zgdje?de@fdxdy�Zhdje?de!e? fdzd{�Zidte?de!e?e?e!e?e?f f fd|d}�Zjdte?de?fd~d�Zkdte?de?fd�d��ZlG d�d�� d��Zmd�e?demfd�d��Zndte?demfd�d��Zod�eEddfd�d��Zpd�d�d��ZqdeEfd�d��Zrd�de?d�e=de!ee=f fd�d��ZsdeEfd�d��Ztd�e e de e!eef fd�d��Zud�ee:geEf d�e e: de!e e: e e: f fd�d��ZvG d�d�� d�e&�ZwdS )�� N)�StringIO)� filterfalse�tee� zip_longest)�
TracebackType)�Any�BinaryIO�Callable�ContextManager�Dict� Generator�Iterable�Iterator�List�Optional�TextIO�Tuple�Type�TypeVar�cast)�BuildBackendHookCaller)�retry�stop_after_delay�
wait_fixed)� __version__)� CommandError� ExternallyManagedEnvironment)�get_major_minor_version)�WINDOWS)�running_under_virtualenv)�rmtree� display_path�
backup_dir�ask�splitext� format_size�is_installable_dir�normalize_path�renames�get_prog�captured_stdout�
ensure_dir�remove_auth_from_url�check_externally_managed� ConfiguredBuildBackendHookCaller�T�returnc C s4 t j�t j�t�dd�} t j�| �} d�t| t� �S )Nz..zpip {} from {} (python {})) �os�path�join�dirname�__file__�abspath�formatr r )� pip_pkg_dir� r9 �C/usr/local/lib/python3.10/site-packages/pip/_internal/utils/misc.py�get_pip_versionI s �r; �py_version_info.c C sD t | �dk r| dt | � d 7 } n t | �dkr | dd� } td| �S )ax
Convert a tuple of ints representing a Python version to one of length
three.
:param py_version_info: a tuple of ints representing a Python version,
or None to specify no version. The tuple can have any length.
:return: a tuple of length three if `py_version_info` is non-None.
Otherwise, return `py_version_info` unchanged (i.e. None).
� )r N� VersionInfo)�lenr )r< r9 r9 r: �normalize_version_infoT s
r@ r2 c
C s` zt �| � W dS ty/ } z|jtjkr |jtjkr$� W Y d}~dS W Y d}~dS d}~ww )z os.path.makedirs without EEXIST.N)r1 �makedirs�OSError�errno�EEXIST� ENOTEMPTY)r2 �er9 r9 r: r+ g s ���r+ c
C sJ zt j�tjd �} | dv rtj� d�W S | W S tttfy$ Y dS w )Nr )z __main__.pyz-cz -m pip�pip) r1 r2 �basename�sys�argv�
executable�AttributeError� TypeError�
IndexError)�progr9 r9 r: r) q s �r) Tr= g �?)�reraise�stop�waitF�dir�
ignore_errorsc C s t j| |td� d S )N)rT �onerror)�shutilr �rmtree_errorhandler)rS rT r9 r9 r: r � r �func�exc_infoc C sN z t �|�jtj@ }W n
ty Y dS w |r&t �|tj� | |� dS � )z�On Windows, the files in .svn are read-only, so when rmtree() tries to
remove them, an exception is thrown. We catch that here, remove the
read-only attribute, and hopefully continue without problems.N)r1 �stat�st_mode�S_IWRITErB �chmod)rY r2 rZ �has_attr_readonlyr9 r9 r: rW � s �rW c C sF t j�t j�| ��} | �t �� t jj �r!d| tt �� �d� } | S )zTGives the display value for a given path, making it relative to cwd
if possible.�.N)r1 r2 �normcaser6 �
startswith�getcwd�sepr? �r2 r9 r9 r: r! � s r! �.bak�extc C sD d}|}t j�| | �r |d7 }|t|� }t j�| | �s | | S )z\Figure out the name of a directory to back up the given dir to
(adding .bak, .bak2, etc)� )r1 r2 �exists�str)rS rg �n� extensionr9 r9 r: r" � s �r" �message�optionsc C s2 t j�dd��� D ]
}||v r| S q t| |�S )N�PIP_EXISTS_ACTION� )r1 �environ�get�splitr# )rm rn �actionr9 r9 r: �ask_path_exists� s
�
ru c C s t j�d�r
td| � ���dS )z&Raise an error if no input is allowed.� PIP_NO_INPUTz5No input was expected ($PIP_NO_INPUT set); question: N)r1 rq rr � Exception�rm r9 r9 r: �_check_no_input� s
��ry c C sD t | � t| �}|�� �� }||vr td�|d�|��� n|S q)z@Ask the message interactively, with the given possible responsesrh z>Your response ({!r}) was not one of the expected responses: {}z, )ry �input�strip�lower�printr7 r3 )rm rn �responser9 r9 r: r# � s ��r# c C s t | � t| �S )z Ask for input interactively.)ry rz rx r9 r9 r: � ask_input� s r c C s t | � t�| �S )z!Ask for a password interactively.)ry �getpassrx r9 r9 r: � ask_password� s
r� �valc C s. | � � } | dv r
dS | dv rdS td| ����)z�Convert a string representation of truth to true (1) or false (0).
True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if
'val' is anything else.
)�y�yes�t�true�on�1rh )rk �no�f�false�off�0r zinvalid truth value )r| �
ValueError)r� r9 r9 r: � strtobool� s r� �bytesc C sX | dkr
d� | d d �S | dkrd� t| d ��S | dkr%d� | d �S d� t| ��S ) Ni@B z {:.1f} MBg @�@i� i' z{} kBz {:.1f} kBz{} bytes)r7 �int)r� r9 r9 r: r% � s r% �rowsc s@ dd� | D �} dd� t | ddi�D �� � fdd�| D �}|� fS )z�Return a list of formatted rows and a list of column sizes.
For example::
>>> tabulate([['foobar', 2000], [0xdeadbeef]])
(['foobar 2000', '3735928559'], [10, 4])
c S � g | ] }t tt|���qS r9 )�tuple�maprj ��.0�rowr9 r9 r: �
<listcomp>� � z tabulate.<locals>.<listcomp>c S r� r9 )�maxr� r? )r� �colr9 r9 r: r� � r� � fillvaluerp c s$ g | ]}d � ttj|� ���� �qS )� )r3 r� rj �ljust�rstripr� ��sizesr9 r: r� � s $ )r )r� �tabler9 r� r: �tabulate� s r� c C sH t j�| �sdS t j�t j�| d��rdS t j�t j�| d��r"dS dS )at Is path is a directory containing pyproject.toml or setup.py?
If pyproject.toml exists, this is a PEP 517 project. Otherwise we look for
a legacy setuptools layout by identifying setup.py. We don't check for the
setup.cfg because using it without setup.py is only available for PEP 517
projects, which are already covered by the pyproject.toml check.
Fzpyproject.tomlTzsetup.py)r1 r2 �isdir�isfiler3 re r9 r9 r: r& � s r& �file�sizec c s � | � |�}|s dS |V q)z7Yield pieces of data from a file-like object until EOF.TN)�read)r� r� �chunkr9 r9 r: � read_chunks s �
�r� �resolve_symlinksc C s6 t j�| �} |rt j�| �} nt j�| �} t j�| �S )zN
Convert a path to its canonical, case-normalized, absolute version.
)r1 r2 �
expanduser�realpathr6 ra )r2 r� r9 r9 r: r' s
r' c C s@ t �| �\}}|�� �d�r |dd� | }|dd� }||fS )z,Like os.path.splitext, but take off .tar tooz.tar���N)� posixpathr$ r| �endswith)r2 �baserg r9 r9 r: r$ ( s
r$ �old�newc C s� t j�|�\}}|r|rt j�|�st �|� t�| |� t j�| �\}}|r<|r>zt �|� W dS ty; Y dS w dS dS )z7Like os.renames(), but handles renaming across devices.N) r1 r2 rs ri rA rV �move�
removedirsrB )r� r� �head�tailr9 r9 r: r( 1 s
��r( c C s t � sdS | �ttj��S )z�
Return True if path is within sys.prefix, if we're running in a virtualenv.
If we're not in a virtualenv, all paths are considered "local."
Caution: this function assumes the head of path has been normalized
with normalize_path.
T)r rb r' rI �prefixre r9 r9 r: �is_localB s r� �msg�argsc G s t j| g|�R � d S �N)�logger�info)r� r� r9 r9 r: � write_outputP s r� c @ s< e Zd ZU dZeed< ededd fdd��Zedd� �Z dS )�
StreamWrapperN� orig_streamr0 c C s || _ | � S r� )r� )�clsr� r9 r9 r: � from_streamW s zStreamWrapper.from_streamc C s | j jS r� )r� �encoding��selfr9 r9 r: r� ^ s zStreamWrapper.encoding)
�__name__�
__module__� __qualname__r� r �__annotations__� classmethodr� �propertyr� r9 r9 r9 r: r� T s
r� � stream_namec
c sL � t t| �}tt| t�|�� zt t| �V W tt| |� dS tt| |� w )z�Return a context manager used by captured_stdout/stdin/stderr
that temporarily replaces the sys stream *stream_name* with a StringIO.
Taken from Lib/support/__init__.py in the CPython repo.
N)�getattrrI �setattrr� r� )r� � orig_stdoutr9 r9 r: �captured_outputc s �
r� c C � t d�S )z�Capture the output of sys.stdout:
with captured_stdout() as stdout:
print('hello')
self.assertEqual(stdout.getvalue(), 'hello
')
Taken from Lib/support/__init__.py in the CPython repo.
�stdout�r� r9 r9 r9 r: r* r s r* c C r� )z
See captured_stdout().
�stderrr� r9 r9 r9 r: �captured_stderr~ s r� �
sequential�namedc O sD t t| tt| ���fi |��}dd� |�� D �}||d< tdd|�S )Nc S s i | ]\}}||�qS r9 r9 )r� �key�valuer9 r9 r: �
<dictcomp>� s zenum.<locals>.<dictcomp>�reverse_mapping�Enumr9 )�dict�zip�ranger? �items�type)r� r� �enums�reverser9 r9 r: �enum� s r� �host�portc C s. |du r| S d| v rd| � d�} | � d|� �S )z.
Build a netloc from a host-port pair
N�:�[�]r9 )r� r� r9 r9 r: � build_netloc� s
r� �https�netloc�schemec C s8 | � d�dkrd| vrd| vrd| � d�} |� d| � �S )z)
Build a full URL from a netloc.
r� � �@r� r� z://)�count)r� r� r9 r9 r: �build_url_from_netloc� s r� c C s t | �}tj�|�}|j|jfS )z2
Return the host-port pair from a netloc.
)r� �urllib�parse�urlparse�hostnamer� )r� �url�parsedr9 r9 r: � parse_netloc� s r� c C st d| vr| dfS | � dd�\}} d}d|v r |�dd�\}}n|d}}tj�|�}|dur4tj�|�}| ||ffS )zp
Parse out and remove the auth information from a netloc.
Returns: (netloc, (username, password)).
r� �NNrh Nr� )�rsplitrs r� r� �unquote)r� �auth�pw�userr9 r9 r: �split_auth_from_netloc� s
r c C sN t | �\} \}}|du r| S |du rd}d}ntj�|�}d}dj||| d�S )z�
Replace the sensitive data in a netloc with "****", if it exists.
For example:
- "user:pass@example.com" returns "user:****@example.com"
- "accesstoken@example.com" returns "****@example.com"
N�****rp z:****z{user}{password}@{netloc})r �passwordr� )r r� r� �quoter7 )r� r r r9 r9 r: �
redact_netloc� s �r r� �transform_netlocc C sJ t j�| �}||j�}|j|d |j|j|jf}t j�|�}|t d|�fS )aR Transform and replace netloc in a url.
transform_netloc is a function taking the netloc and returning a
tuple. The first element of this tuple is the new netloc. The
entire tuple is returned.
Returns a tuple containing the transformed url as item 0 and the
original tuple returned by transform_netloc as item 1.
r � NetlocTuple)
r� r� �urlsplitr� r� r2 �query�fragment�
urlunsplitr )r� r �purl� netloc_tuple�
url_pieces�surlr9 r9 r: �_transform_url� s
r c C s t | �S r� )r �r� r9 r9 r: � _get_netloc� s r c C s
t | �fS r� )r r r9 r9 r: �_redact_netloc� s
r c C s t | t�\}\}}|||fS )z�
Parse a url into separate netloc, auth, and url with no auth.
Returns: (url_without_auth, netloc, (username, password))
�r r )r� �url_without_authr� r� r9 r9 r: �split_auth_netloc_from_url� s
r c C � t | t�d S )z7Return a copy of url with 'username:password@' removed.r r �r� r9 r9 r: r, s r, c C r )z.Replace the password in a given url with ****.r )r r r r9 r9 r: �redact_auth_from_url s r c @ sP e Zd Zdededdfdd�Zdefdd�Zdefd d
�Zd edefd d
�Z dS )�
HiddenText�secret�redactedr0 Nc C s || _ || _d S r� )r r )r� r r r9 r9 r: �__init__ s
zHiddenText.__init__c C s d� t| ��S )Nz<HiddenText {!r}>)r7 rj r� r9 r9 r: �__repr__ s zHiddenText.__repr__c C s | j S r� �r r� r9 r9 r: �__str__ s zHiddenText.__str__�otherc C s t | �t |�kr
dS | j|jkS )NF)r� r )r� r! r9 r9 r: �__eq__ s zHiddenText.__eq__)
r� r� r� rj r r r r �boolr" r9 r9 r9 r: r s
r r� c C s t | dd�S )Nr r )r )r� r9 r9 r: �
hide_value& s r$ c C s t | �}t| |d�S )Nr )r r )r� r r9 r9 r: �hide_url* s r% �
modifying_pipc C s| ddt jj� �dt jj� dt jj� �g}| o"to"tj�t jd �|v }|r<t j ddgt jdd� }t
d� d� |����dS ) z�Protection of pip.exe from modification on Windows
On Windows, any operation modifying pip should be run as:
python -m pip ...
rG r` r z-mrh Nz3To modify pip, please run the following command:
{}r� )
rI � version_info�major�minorr r1 r2 rH rJ rK r r7 r3 )r& � pip_names�should_show_use_python_msg� new_commandr9 r9 r: �(protect_pip_from_modification_on_windows/ s � ����r- c C s8 t � rdS tj�t�d�d�} tj�| �sdS t�| ��)z�Check whether the current environment is externally managed.
If the ``EXTERNALLY-MANAGED`` config file is found, the current environment
is considered externally managed, and an ExternallyManagedEnvironment is
raised.
N�stdlibzEXTERNALLY-MANAGED) r r1 r2 r3 � sysconfig�get_pathr� r � from_config)�markerr9 r9 r: r- I s
r- c C s t jduo t j�� S )z Is this console interactive?N)rI �stdin�isattyr9 r9 r9 r: �is_console_interactiveX rX r5 � � blocksizec C sl t �� }d}t| d�� }t||d�D ]
}|t|�7 }|�|� qW d � ||fS 1 s-w Y ||fS )z5Return (hash, length) for path using hashlib.sha256()r �rb)r� N)�hashlib�sha256�openr� r? �update)r2 r7 �h�lengthr� �blockr9 r9 r: � hash_file] s �
��r@ c C s$ zddl } W dS ty Y dS w )z8
Return whether the wheel package is installed.
r NFT)�wheel� ImportError)rA r9 r9 r: �is_wheel_installedi s
��rC �iterablec C s t | �} t| | �S )zb
Return paired elements.
For example:
s -> (s0, s1), (s2, s3), (s4, s5), ...
)�iterr )rD r9 r9 r: �pairwiseu s
rF �predc C s t |�\}}t| |�t| |�fS )z�
Use a predicate to partition entries into false entries and true entries,
like
partition(is_odd, range(10)) --> 0 2 4 6 8 and 1 3 5 7 9
)r r �filter)rG rD �t1�t2r9 r9 r: � partition� s
rK c s� e Zd Z d"dedededee deed dee f � fd d
�
Z d#d ed eeeef d
ee def� fdd�
Z d$ded eeeef def� fdd�
Z
d#d ed eeeef d
ee def� fdd�
Z d$d eeeef de e f� fdd�
Z
d$d eeeef de e f� fdd�
Z d$d eeeef de e f� fdd�
Z d%d
ed eeeef d edef� fd d �
Z d%d
ed eeeef d edef� fd d!�
Z� ZS )&r. N�
config_holder�
source_dir�
build_backend� backend_path�runner).N�python_executablec s t � �|||||� || _d S r� )�superr rL )r� rL rM rN rO rP rQ �� __class__r9 r: r � s
�
z)ConfiguredBuildBackendHookCaller.__init__�wheel_directory�config_settings�metadata_directoryr0 c � | j j}t� j|||d�S �N)rV rW )rL rV rR � build_wheel�r� rU rV rW �csrS r9 r: rZ � � �z,ConfiguredBuildBackendHookCaller.build_wheel�sdist_directoryc s | j j}t� j||d�S �N)rV )rL rV rR � build_sdist)r� r^ rV r\ rS r9 r: r` � s z,ConfiguredBuildBackendHookCaller.build_sdistc rX rY )rL rV rR �build_editabler[ rS r9 r: ra � r] z/ConfiguredBuildBackendHookCaller.build_editablec � | j j}t� j|d�S r_ )rL rV rR � get_requires_for_build_wheel�r� rV r\ rS r9 r: rc � � z=ConfiguredBuildBackendHookCaller.get_requires_for_build_wheelc rb r_ )rL rV rR � get_requires_for_build_sdistrd rS r9 r: rf � re z=ConfiguredBuildBackendHookCaller.get_requires_for_build_sdistc rb r_ )rL rV rR � get_requires_for_build_editablerd rS r9 r: rg � re z@ConfiguredBuildBackendHookCaller.get_requires_for_build_editableT�_allow_fallbackc rX �N)rW rV rh )rL rV rR � prepare_metadata_for_build_wheel�r� rW rV rh r\ rS r9 r: rj � � �zAConfiguredBuildBackendHookCaller.prepare_metadata_for_build_wheelc rX ri )rL rV rR �#prepare_metadata_for_build_editablerk rS r9 r: rm � rl zDConfiguredBuildBackendHookCaller.prepare_metadata_for_build_editable)NNNr� r� )NT)r� r� r� r rj r r r r rZ r` ra r rc rf rg r# rj rm �
__classcell__r9 r9 rS r: r. � s� �����
������� ���� ����� ��������� ����������r. )F)rf )T)r� )r0 N)r6 )x�
contextlibrC r� r9 �io�loggingr1 r� rV r[ rI r/ � urllib.parser� r � itertoolsr r r �typesr �typingr r r r
r r r
r r r r r r r r �pip._vendor.pyproject_hooksr �pip._vendor.tenacityr r r rG r �pip._internal.exceptionsr r �pip._internal.locationsr �pip._internal.utils.compatr � pip._internal.utils.virtualenvr �__all__� getLoggerr� r� r/ �
BaseException�ExcInfor� r> rj r r; r@ r+ r) r# r rW r! r" ru ry r# r r� r� �floatr% r� r& �DEFAULT_BUFFER_SIZEr� r� r' r$ r( r� r� r� �contextmanagerr� r* r� r� r� r� r� r r r r r r r, r r r$ r% r- r- r5 r@ rC rF rK r. r9 r9 r9 r: �<module> s� D
$
" * ���
�
��
�$
" ��
�