File: //usr/lib/python3.9/site-packages/pip/_internal/utils/__pycache__/misc.cpython-39.pyc
a
?�f�n � @ s d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
Z
d dl Z d dl Z d dl
mZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZmZ d d lmZm Z m Z m Z m Z d d
l m!Z" d d l#m$Z% d d l&m'Z' d d
l(m)Z) d dl*m+Z+m,Z,m-Z-m.Z. d dl/m0Z0m1Z1m2Z2m3Z3 d dl4m5Z5m6Z6 d dl7m8Z8m9Z9 e�r`d dlm:Z; n d dlm;Z; e5�r�d dl<m=Z=m>Z>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZH d dlImJZJ eFeKeKeKf ZLeGd�ZMg d�ZNe�OeP�ZQdd� ZRdd� ZSd d � ZTd d � ZUed d!d"�d�d$d%��ZVd&d'� ZWd(d)� ZXd*d+� ZYd�d-d.�ZZd/d0� Z[d1d2� Z\d3d4� Z]d5d6� Z^d7d8� Z_d9d:� Z`d;d<� Zad=d>� Zbejcfd?d@�Zdd�dBdC�ZedDdE� ZfdFdG� ZgdHdI� ZhdJdK� ZidLdM� ZjdNdO� ZkdPdQ� ZldRdS� ZmdAe2dAd#d#dfdTdU�ZndVdW� ZodXdY� ZpdZd[� Zqd\d]� Zrd^d_� ZsG d`da� daet�ZuG dbdc� dce;�Zvejwddde� �Zxdfdg� Zydhdi� Zzd�djdk�Z{dldm� Z|dndo� Z}dpdq� Z~d�dsdt�Zdudv� Z�dwdx� Z�dydz� Z�d{d|� Z�d}d~� Z�dd�� Z�d�d�� Z�d�d�� Z�d�d�� Z�G d�d�� d�et�Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�dS )�� )�absolute_importN��deque)�tee)�
pkg_resources)�canonicalize_name)�retry)�PY2� text_type)�filter� filterfalse�input�map� zip_longest)�parse)�unquote)� __version__)� CommandError)�distutils_scheme�get_major_minor_version�
site_packages� user_site)�WINDOWS�
expanduser� stdlib_pkgs�str_to_display)�MYPY_CHECK_RUNNING�cast)�running_under_virtualenv�virtualenv_no_global)�BytesIO)�StringIO) �Any�AnyStr�Callable� Container�Iterable�Iterator�List�Optional�Text�Tuple�TypeVar�Union)� Distribution�T)�rmtree� display_path�
backup_dir�ask�splitext� format_size�is_installable_dir�normalize_path�renames�get_prog�captured_stdout�
ensure_dir�get_installed_version�remove_auth_from_urlc 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 )Z pip_pkg_dir� rE �</usr/lib/python3.9/site-packages/pip/_internal/utils/misc.py�get_pip_versionO s ��rG c C sD t | �dk r"| dt | � d 7 } nt | �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 )Zpy_version_inforE rE rF �normalize_version_info[ s
rK c
C sR zt �| � W n> tyL } z&|jtjkr8|jtjkr8� W Y d}~n
d}~0 0 dS )z os.path.makedirs without EEXIST.N)r> �makedirs�OSError�errnoZEEXISTZ ENOTEMPTY)r? �erE rE rF r; o s
r; c
C sP z2t j�tjd �} | dv r*d�tj�W S | W S W n ttt fyJ Y n0 dS )Nr )z __main__.pyz-cz {} -m pip�pip)
r> r? �basename�sys�argvrD �
executable�AttributeError� TypeError�
IndexError)�progrE rE rF r9 z s
r9 i� i� )Zstop_max_delayZ
wait_fixedFc C s t j| |td� d S )N)�
ignore_errors�onerror)�shutilr0 �rmtree_errorhandler)�dirrY rE rE rF r0 � s �r0 c C sV zt �|�jtj@ }W n ttfy0 Y dS 0 |rPt �|tj� | |� dS � 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)r> �stat�st_mode�S_IWRITE�IOErrorrM �chmod)�funcr? �exc_infoZhas_attr_readonlyrE rE rF r\ � s r\ c C sb | du r dS t | t�r| S z| �t�� d�}W n. ty\ trPtd�| ��}nt | �}Y n0 |S )z�
Convert a bytes (or text) path to text (unicode in Python 2) for display
and logging purposes.
This function should never error out. Also, this function is mainly needed
for Python 2 since in Python 3 str paths are already text.
N�strictzb{!r})
�
isinstancer
�decoderR �getfilesystemencoding�UnicodeDecodeErrorr r rD �ascii)r? r1 rE rE rF �path_to_display� s
rk c C st t j�t j�| ��} tjd dkrB| �t�� d�} | �t� � d�} | �
t � � t jj �rpd| t
t � � �d� } | S )zTGives the display value for a given path, making it relative to cwd
if possible.r � �replace�.N)r> r? �normcaserC rR � version_inforg rh �encode�getdefaultencoding�
startswith�getcwd�seprJ �r? rE rE rF r1 � s r1 �.bakc C s6 d}|}t j�| | �r.|d7 }|t|� }q| | S )z\Figure out the name of a directory to back up the given dir to
(adding .bak, .bak2, etc)� )r> r? �exists�str)r] �ext�n� extensionrE rE rF r2 � s r2 c C s2 t j�dd��� D ]}||v r| S qt| |�S )NZPIP_EXISTS_ACTION� )r> �environ�get�splitr3 )�message�options�actionrE rE rF �ask_path_exists� s
r� c C s t j�d�rtd�| ���dS )z&Raise an error if no input is allowed.Z PIP_NO_INPUTz7No input was expected ($PIP_NO_INPUT set); question: {}N)r> r r� � ExceptionrD �r� rE rE rF �_check_no_input� s ��r� c C sF t | � t| �}|�� �� }||vr<td�|d�|��� q |S q dS )z@Ask the message interactively, with the given possible responsesz>Your response ({!r}) was not one of the expected responses: {}z, N)r� r
�strip�lower�printrD r@ )r� r� ZresponserE rE rF r3 � s
��r3 c C s t | � t| �S )z Ask for input interactively.)r� r
r� rE rE rF � ask_input s r� c C s t | � t�| �S )z!Ask for a password interactively.)r� �getpassr� rE rE rF � ask_password s r� c C s\ | dkrd� | d d �S | dkr4d� t| d ��S | dkrJd� | d �S d� t| ��S d S ) Ni@B z {:.1f} MBg @�@i� i' z{} kBz {:.1f} kBz{} bytes)rD �int)�bytesrE rE rF r5 s r5 c 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 s g | ]}t tt|���qS rE )�tupler rz ��.0�rowrE rE rF �
<listcomp># � z tabulate.<locals>.<listcomp>c S s g | ]}t tt|���qS rE )�maxr rJ )r� �colrE rE rF r� $ r� � fillvaluer~ c s$ g | ] }d � ttj|� ���� �qS )� )r@ r rz �ljust�rstripr� �ZsizesrE rF r� % r� )r )Zrows�tablerE r� rF �tabulate s r� c C sP t j�| �sdS t j�| d�}t j�|�r.dS t j�| d�}t j�|�rLdS dS )zBIs path is a directory containing setup.py or pyproject.toml?
Fzsetup.pyTzpyproject.toml)r> r? �isdirr@ �isfile)r? Zsetup_pyZpyproject_tomlrE rE rF r6 ) s r6 c c s | � |�}|sq|V q dS )z7Yield pieces of data from a file-like object until EOF.N)�read)�file�size�chunkrE rE rF � read_chunks8 s
r� Tc C s2 t | �} |rtj�| �} n tj�| �} tj�| �S )zN
Convert a path to its canonical, case-normalized, absolute version.
)r r> r? �realpathrC ro )r? Zresolve_symlinksrE rE rF r7 A s
r7 c C s@ t �| �\}}|�� �d�r8|dd� | }|dd� }||fS )z,Like os.path.splitext, but take off .tar tooz.tar���N)� posixpathr4 r� �endswith)r? �baser{ rE rE rF r4 O s
r4 c C sx t j�|�\}}|r.|r.t j�|�s.t �|� t�| |� t j�| �\}}|rt|rtzt �|� W n tyr Y n0 dS )z7Like os.renames(), but handles renaming across devices.N) r> r? r� ry rL r[ Zmove�
removedirsrM )�old�new�head�tailrE rE rF r8 Y s
r8 c C s t � s
dS | �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 rs r7 rR �prefixrv rE rE rF �is_localk s
r� c C s t t| ��S )z�
Return True if given Distribution object is installed locally
(i.e. within current virtualenv).
Always True if we're not in a virtualenv.
)r� �
dist_location��distrE rE rF �
dist_is_localz s r� c C s t | ��tt��S )zF
Return True if given Distribution is installed in user site.
)r� rs r7 r r� rE rE rF �dist_in_usersite� s r� c C s t | ��tt��S )z[
Return True if given Distribution is installed in
sysconfig.get_python_lib().
)r� rs r7 r r� rE rE rF �dist_in_site_packages� s r� c C s, t t| ��}|�t td�d �d�d ��S )zf
Return True if given Distribution is installed in
path matching distutils_scheme layout.
r~ ZpurelibZpythonr )r7 r� rs r r� )r� Z norm_pathrE rE rF �dist_in_install_path� s �r� c C s6 t jD ]*}tj�|| jd �}tj�|�r dS qdS )zC
Return True if given Distribution is an editable install.
� .egg-linkTF)rR r? r> r@ � project_namer� )r� Z path_item�egg_linkrE rE rF �dist_is_editable� s
r� c s� |rt �|�}nt j}| r t�ndd� �|r6dd� � ndd� � |rLdd� �ndd� �|r^t�nd d
� �� ����fd d �|D �S )
a^
Return a list of installed Distribution objects.
If ``local_only`` is True (default), only return installations
local to the current virtualenv, if in a virtualenv.
``skip`` argument is an iterable of lower-case project names to
ignore; defaults to stdlib_pkgs
If ``include_editables`` is False, don't report editables.
If ``editables_only`` is True , only report editables.
If ``user_only`` is True , only report installations in the user
site directory.
If ``paths`` is set, only report the distributions present at the
specified list of locations.
c S s dS �NTrE ��drE rE rF �
local_test� s z/get_installed_distributions.<locals>.local_testc S s dS r� rE r� rE rE rF �
editable_test� s z2get_installed_distributions.<locals>.editable_testc S s
t | � S �N�r� r� rE rE rF r� � s c S s t | �S r� r� r� rE rE rF �editables_only_test� s z8get_installed_distributions.<locals>.editables_only_testc S s dS r� rE r� rE rE rF r� � s c S s dS r� rE r� rE rE rF � user_test� s z.get_installed_distributions.<locals>.user_testc s: g | ]2}�|�r|j �vr� |�r�|�r�|�r|�qS rE )�key)r� r� �r� r� r� �skipr� rE rF r� � s
�z/get_installed_distributions.<locals>.<listcomp>)r �
WorkingSet� working_setr� r� )�
local_onlyr� �include_editables�editables_only� user_only�pathsr� rE r� rF �get_installed_distributions� s
r� c C s4 t | �} tddddddd�}dd� |D �}|�| �S )z�Find a distribution matching the ``req_name`` in the environment.
This searches from *all* distributions available in the environment, to
match the behavior of ``pkg_resources.get_distribution()``.
FrE TN)r� r� r� r� r� r� c S s i | ]}t |j�|�qS rE )r r� )r� �prE rE rF �
<dictcomp> r� z(_search_distribution.<locals>.<dictcomp>)r r� r� )�req_nameZpackagesZpkg_dictrE rE rF �_search_distribution� s
�r� c C s< t | �}|s4ztj�| � W n tjy2 Y dS 0 t | �S )z�Given a requirement name, return the installed Distribution object.
This searches from *all* distributions available in the environment, to
match the behavior of ``pkg_resources.get_distribution()``.
N)r� r r� ZrequireZDistributionNotFound)r� r� rE rE rF �get_distribution s r� c C sx g }t � r*|�t� t� sBtrB|�t� ntr8|�t� |�t� |D ],}tj�|| j�d }tj� |�rF| S qFdS )a
Return the path for the .egg-link file if it exists, otherwise, None.
There's 3 scenarios:
1) not in a virtualenv
try to find in site.USER_SITE, then site_packages
2) in a no-global virtualenv
try to find in site_packages
3) in a yes-global virtualenv
try to find in site_packages, then site.USER_SITE
(don't look in global location)
For #1 and #3, there could be odd cases, where there's an egg-link in 2
locations.
This method will just return the first one found.
r� N)
r �appendr r r r> r? r@ r� r� )r� ZsitesZsiteZegglinkrE rE rF �
egg_link_path$ s
r� c C s t | �}|rt|�S t| j�S )aO
Get the site-packages location of this distribution. Generally
this is dist.location, except in the case of develop-installed
packages, where dist.location is the source code location, and we
want to know where the egg-link file is.
The returned location is normalized (in particular, with symlinks removed).
)r� r7 �location)r� r� rE rE rF r� H s
r� c G s t j| g|�R � d S r� )�logger�info)�msg�argsrE rE rF � write_outputX s r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) �FakeFilezQWrap a list of lines in an object with readline() to make
ConfigParser happy.c C s t |�| _d S r� )�iter�_gen)�self�linesrE rE rF �__init__` s zFakeFile.__init__c C s& z t | j�W S ty Y dS 0 d S )Nr~ )�nextr� �
StopIteration�r� rE rE rF �readlinec s zFakeFile.readlinec C s | j S r� )r� r� rE rE rF �__iter__i s zFakeFile.__iter__N)�__name__�
__module__� __qualname__�__doc__r� r� r� rE rE rE rF r� ] s r� c @ s$ e Zd Zedd� �Zedd� �ZdS )�
StreamWrapperc C s || _ | � S r� )� orig_stream)�clsr� rE rE rF � from_streamo s zStreamWrapper.from_streamc C s | j jS r� )r� �encodingr� rE rE rF r� u s zStreamWrapper.encodingN)r� r� r� � classmethodr� �propertyr� rE rE rE rF r� m s
r� c
c sL t t| �}tt| t�|�� z t t| �V W tt| |� ntt| |� 0 dS )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)�getattrrR �setattrr� r� )Z stream_nameZ orig_stdoutrE rE rF �captured_outputz s
r� c C s 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� rE rE rE rF r: � s r: c C s t d�S )z
See captured_stdout().
�stderrr� rE rE rE rF �captured_stderr� s r� c C s4 t j�| �}|du r t �� }|�|�}|r0|jS dS )zCGet the installed version of dist_name avoiding pkg_resources cacheN)r Z Requirementr r� �find�version)Z dist_namer� Zreqr� rE rE rF r< � s
r< c C s t | dd� dS )z Consume an iterable at C speed.r )�maxlenNr )�iteratorrE rE rF �consume� s r c O sD t t| tt| ���fi |��}dd� |�� D �}||d< tdd|�S )Nc S s i | ]\}}||�qS rE rE )r� r� �valuerE rE rF r� � r� zenum.<locals>.<dictcomp>Zreverse_mapping�EnumrE )�dict�zip�rangerJ �items�type)Z
sequentialZnamedZenums�reverserE rE rF �enum� s r c C s* |du r | S d| v r d� | �} d� | |�S )z.
Build a netloc from a host-port pair
N�:�[{}]z{}:{})rD )�host�portrE rE rF � build_netloc� s
r �httpsc C s4 | � d�dkr(d| vr(d| vr(d�| �} d�|| �S )z)
Build a full URL from a netloc.
r
rl �@�[r z{}://{})�countrD )�netloc�schemerE rE rF �build_url_from_netloc� s
r c C s t | �}t�|�}|j|jfS )z2
Return the host-port pair from a netloc.
)r � urllib_parse�urlparse�hostnamer
)r �url�parsedrE rE rF � parse_netloc� s
r c C sX d| vr| dfS | � dd�\}} d|v r6|�dd�}n|df}tdd� |D ��}| |fS )zp
Parse out and remove the auth information from a netloc.
Returns: (netloc, (username, password)).
r )NNrx r
Nc s s" | ]}|d u rd nt |�V qd S r� )�urllib_unquote)r� �xrE rE rF � <genexpr>� s z)split_auth_from_netloc.<locals>.<genexpr>)�rsplitr� r� )r �authZ user_passrE rE rF �split_auth_from_netloc� s �r! c C sL t | �\} \}}|du r | S |du r.d}d}nt�|�}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�****r~ z:****z{user}{password}@{netloc})�user�passwordr )r! r �quoterD )r r# r$ rE rE rF �
redact_netloc� s
�r& c C s@ t �| �}||j�}|j|d |j|j|jf}t �|�}||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 )r �urlsplitr r r? �query�fragment�
urlunsplit)r Ztransform_netlocZpurlZ netloc_tupleZ
url_piecesZsurlrE rE rF �_transform_url s
�
r+ c C s t | �S r� )r! �r rE rE rF � _get_netloc$ s r- c C s
t | �fS r� )r& r, rE rE rF �_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 Zurl_without_authr r rE rE rF �split_auth_netloc_from_url, s r0 c C s t | t�d S )z7Return a copy of url with 'username:password@' removed.r r/ �r rE rE rF r= 7 s r= c C s t | t�d S )z.Replace the password in a given url with ****.r )r+ r. r1 rE rE rF �redact_auth_from_url? s r2 c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �
HiddenTextc C s || _ || _d S r� )�secret�redacted)r� r4 r5 rE rE rF r� F s zHiddenText.__init__c C s d� t| ��S )Nz<HiddenText {!r}>)rD rz r� rE rE rF �__repr__O s zHiddenText.__repr__c C s | j S r� �r5 r� rE rE rF �__str__S s zHiddenText.__str__c C s t | �t |�krdS | j|jkS )NF)r r4 �r� �otherrE rE rF �__eq__X s zHiddenText.__eq__c C s
| |k S r� rE r9 rE rE rF �__ne__c s zHiddenText.__ne__N)r� r� r� r� r6 r8 r; r< rE rE rE rF r3 E s
r3 c C s t | dd�S )Nr" r7 )r3 )r rE rE rF �
hide_valueh s r= c C s t | �}t| |d�S )Nr7 )r2 r3 )r r5 rE rE rF �hide_urlm s r> c C sz dd� tjd �dj tjdd� � g}| oBtoBtj�tjd �|v }|rvtjddgtjd d� }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 ...
zpip.exez pip{}.exer z pip{}.{}.exeNrl z-mrP rx z3To modify pip, please run the following command:
{}r� ) rD rR rp r r> r? rQ rS rT r r@ )Z
modifying_pipZ pip_namesZshould_show_use_python_msgZ new_commandrE rE rF �(protect_pip_from_modification_on_windowss s& ���� ���r? c C s t jduot j�� S )z!Is this console interactive?
N)rR �stdin�isattyrE rE rE rF �is_console_interactive� s rB � c C sf t �� }d}t| d��8}t||d�D ]}|t|�7 }|�|� q$W d � n1 sT0 Y ||fS )z:Return (hash, length) for path using hashlib.sha256()
r �rb)r� N)�hashlibZsha256�openr� rJ �update)r? Z blocksize�hZlength�f�blockrE rE rF � hash_file� s *rK c C s& z ddl } W n ty Y dS 0 dS )z8
Return whether the wheel package is installed.
r NFT)�wheel� ImportError)rL rE rE rF �is_wheel_installed� s
rN c C s t | �} t| | �S )zb
Return paired elements.
For example:
s -> (s0, s1), (s2, s3), (s4, s5), ...
)r� r )�iterablerE rE rF �pairwise� s rP c 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 r )ZpredrO �t1�t2rE rE rF � partition� s rS )F)rw )T)N)r )rC )�Z
__future__r �
contextlibrN r� rE �ioZloggingr> r� r[ r^ rR � collectionsr � itertoolsr Z pip._vendorr Zpip._vendor.packaging.utilsr Zpip._vendor.retryingr Zpip._vendor.sixr r
Zpip._vendor.six.movesr r r
r r Z pip._vendor.six.moves.urllibr r Z"pip._vendor.six.moves.urllib.parser r rP r Zpip._internal.exceptionsr Zpip._internal.locationsr r r r Zpip._internal.utils.compatr r r r Zpip._internal.utils.typingr r Z pip._internal.utils.virtualenvr r r r! �typingr" r# r$ r% r& r' r( r) r* r+ r, r- Zpip._vendor.pkg_resourcesr. r� rI r/ �__all__Z getLoggerr� r� rG rK r; r9 r0 r\ rk r1 r2 r� r� r3 r� r� r5 r� r6 �DEFAULT_BUFFER_SIZEr� r7 r4 r8 r� r� r� r� r� r� r� r� r� r� r� r� �objectr� r� �contextmanagerr� r: r� r< r r r r r r! r& r+ r- r. r0 r= r2 r3 r= r> r? rB rK rN rP rS rE rE rE rF �<module> s� 8
"
�
D $
#