File: //usr/local/lib/python3.10/dist-packages/pip/_internal/req/__pycache__/constructors.cpython-310.pyc
o
��h�G �
@ s" d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m
Z
ddl m Z ddl
mZmZ ddlmZ dd lmZ dd
lmZmZ dd lmZ dd lmZ dd
lm Z ddl m Z ddl m Z ddl!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z(m)Z) g d�Z*e�+e,�Z-ej.�/� Z0dgdd�Z1dhd d �Z2did#d$�Z3djd'd(�Z4dkd+d,�Z5dld-d.�Z6e
d/d0�G d1d2� d2��Z7dmd3d4�Z8 dndd5ddd5d5d5dd6�dodGdH�Z9dpdJdK�Z:dqdLdM�Z;drdOdP�Z< dndd5ddd5dd5ddQ�dsdSdT�Z= 5 5dtdudWdX�Z> 5 5 dvdwd[d\�Z?dxd`da�Z@dydbdc�ZAdzdedf�ZBdS ){a~ Backing implementation for InstallRequirement's various constructors
The idea here is that these formed a major chunk of InstallRequirement's size
so, moving them and support code dedicated to them outside of that class
helps creates for better understandability for the rest of the code.
These are meant to be used elsewhere within pip to create instances of
InstallRequirement.
� )� annotationsN)�
Collection)� dataclass)�Marker)�InvalidRequirement� Requirement)� Specifier)�InstallationError)�PyPI�TestPyPI)�Link)�Wheel)�ParsedRequirement)�InstallRequirement)�is_archive_file)�is_installable_dir)�get_requirement)� path_to_url)�is_url�vcs)�install_req_from_editable�install_req_from_line�parse_editable�path�str�return�tuple[str, str | None]c C s< t �d| �}d }|r|�d�}|�d�}||fS | }||fS )Nz^(.+)(\[[^\]]+\])$� � )�re�match�group)r �m�extras�path_no_extras� r% �I/usr/local/lib/python3.10/dist-packages/pip/_internal/req/constructors.py�
_strip_extras. s
�r' r# �
str | None�set[str]c C s | st � S td| �� �jS )N� placeholder)�setr �lowerr# )r# r% r% r& �convert_extras: s r- �reqr �
new_extrasc C s� t jdt| �t jd�}|dusJ d| � d���|�d�}|�d�}|dur)|dus1J d| � d���d �|r<d
�t|��nd �}t|� |� |� ��S ) z�
Returns a new requirement based on the given one, with the supplied extras. If the
given requirement already has extras those are replaced (or dropped if no new extras
are given).
z ([\w\t .-]+)(\[[^\]]*\])?(.*))�flagsNzregex match on requirement z! failed, this should never happenr � z®ex group selection for requirement z[{}]�,� ) r � fullmatchr �ASCIIr! �format�join�sortedr )r. r/ r �pre�postr# r% r% r& �_set_requirement_extras@ s �
�
� r; � editable_req� tuple[str | None, str, set[str]]c C s� | }t |�\}}tj�|�rt|�}|�� �d�r2t|�j}|r,||t d|�� �j
fS ||t � fS t D ]}|�� �|� d��rI|� d|� �} nq4t|�}|j
sad�t j�}t| � d|� d���|j}|sntd| � d ���||t � fS )
a Parses an editable requirement into:
- a requirement name
- an URL
- extras
- editable options
Accepted requirements:
svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir
.[some_extra]
zfile:r* �:�+z, zq is not a valid editable requirement. It should either be a path to a local project or a VCS URL (beginning with z).z'Could not detect requirement name for 'z1', please specify one with #egg=your_package_name)r' �osr �isdirr r, �
startswithr � egg_fragmentr r# r+ r �is_vcsr7 � all_schemesr )r< �url�
url_no_extrasr# � package_name�version_control�link�backendsr% r% r& r Y s>
� � ��
� r �filename�Nonec C s� t | ddd��E}dd� dd� |D �D �}|D ]-}d|v r%|d|�d�� }|�d �r7|dd
� �� t|d � }t|� W d � dS W d � dS 1 sOw Y dS ) a Check if file is parsable as a requirements file.
This is heavily based on ``pkg_resources.parse_requirements``, but
simplified to just check the first meaningful line.
:raises InvalidRequirement: If the first meaningful line cannot be parsed
as an requirement.
zutf-8�ignore)�encoding�errorsc s s" � | ] }|r|� d �s|V qdS )�#N)rB ��.0�liner% r% r& � <genexpr>� s � ��
�z2check_first_requirement_in_file.<locals>.<genexpr>c s s � | ]}|� � V qd S �N)�striprR r% r% r& rU � s � z #N�\���r3 )�open�find�endswithrW �nextr )rL �f�linesrT r% r% r& � check_first_requirement_in_file� s �
�"�r` c C s^ t j�| �s d| � d�S d}zt| � W n ty$ t�d| � Y |S w |d| � d�7 }|S )z�Returns helpful msg in case requirements file does not exist,
or cannot be parsed.
:params req: Requirements file path
z File 'z' does not exist.z The path does exist. z&Cannot parse '%s' as requirements filezThe argument you provided (zx) appears to be a requirements file. If that is the case, use the '-r' flag to install the packages specified within it.)r@ r �existsr` r �logger�debug)r. �msgr% r% r& �deduce_helpful_msg� s ���re T)�frozenc @ s. e Zd ZU ded< ded< ded< ded< d S )
�RequirementPartszRequirement | None� requirementz Link | NonerJ z
Marker | None�markersr) r# N)�__name__�
__module__� __qualname__�__annotations__r% r% r% r& rg � s
rg c
C sj t | �\}}}|d ur(zt|�}W n ty' } z
td|�d|� ���d }~ww d }t|�}t||d |�S )N�Invalid requirement: �: )r r r r r rg )r< �namerF �extras_overrider. �excrJ r% r% r& �parse_req_from_editable� s ��rs F)�
use_pep517�isolated�global_options� hash_options�
constraint�
user_supplied�permit_editable_wheels�config_settings�
comes_from� InstallRequirement | str | Nonert � bool | Noneru �boolrv �list[str] | Nonerw �dict[str, list[str]] | Nonerx ry rz r{ �!dict[str, str | list[str]] | Noner c C s0 t | �}
t|
j||d||
j|||||| |
jd�
S )NT) r| ry �editablerz rJ rx rt ru rv rw r{ r# )rs r rh rJ r# ) r< r| rt ru rv rw rx ry rz r{ �partsr% r% r& r � s
�r rp c C s> t jj| v rdS t jjdurt jj| v rdS | �d�r dS dS )ak Checks whether the string "looks like" a path on the filesystem.
This does not check whether the target actually exists, only judge from the
appearance.
Returns true if any of the following conditions is true:
* a path separator is found (either os.path.sep or os.path.altsep);
* a dot is found (which represents the current directory).
TN�.F)r@ r �sep�altseprB )rp r% r% r& �_looks_like_path s
r� c C s� t |�rtj�| �rt| �rt| �S td|�d���t| �s dS tj�| �r*t| �S |� dd�}t
|�dkr>t |d �s>dS t � d|� t| �S ) aK
First, it checks whether a provided path is an installable directory. If it
is, returns the path.
If false, check if the path is an archive file (such as a .whl).
The function checks if the path is a file. If false, if the path has
an @, it will treat it as a PEP 440 URL requirement and return the path.
z
Directory zC is not installable. Neither 'setup.py' nor 'pyproject.toml' found.N�@r r r zARequirement %r looks like a filename, but the file does not exist)
r� r@ r rA r r r r �isfile�split�lenrb �warning)r rp � urlreq_partsr% r% r& �_get_url_from_path s$
� �r� � line_sourcec s\ t | �rd}nd}|| v r#| �|d�\} }|�� }|s d }nt|�}nd }| �� } d }tj�tj�| ��}d }d }t | �rBt| �}nt |�\} }t
| | �}
|
d urUt|
�}|r�|j dkrrt �
d|j�rrtttj�tj�|j����}|jr�t|j�} | j� d| j� �}n|j}n| }t|�} d� fd
d � �d�fdd� }
|d ur�|
|�}nd }t|||| �S )Nz; �;r �filez\.\./z==�textr r c s � s| S | � d� � d�S )Nz (from �)r% )r� )r� r% r& � with_sourcee s z(parse_req_from_line.<locals>.with_source�
req_as_stringr c
s� zt � �W S tyK } z:tjj� v r d}|t� �7 }nd� v r.t� fdd�tD ��s.d}nd}�d� �d|� ��}|rC|d |� �7 }t|��d }~ww )
NzIt looks like a path.�=c 3 s � | ]}|� v V qd S rV r% )rS �op�r� r% r& rU q s �
�zAparse_req_from_line.<locals>._parse_req_string.<locals>.<genexpr>z,= is not a valid operator. Did you mean == ?r3 rn ro z
Hint: ) r r r@ r r� re �any� operatorsr )r� rr �add_msgrd )r� r� r& �_parse_req_stringj s"
���z.parse_req_from_line.<locals>._parse_req_string)r� r r r )r� r r r )r r� rW r r@ r �normpath�abspathr r' r� �schemer �searchrF r �is_wheelr
rL rp �versionrC r- rg )rp r� �
marker_sep�markers_as_stringri r� r rJ �extras_as_string�prF �wheelr# r� r. r% )r� r� r& �parse_req_from_line5 sH
r� )rt ru rv rw rx r� ry r{ � str | InstallRequirement | Nonec C s2 t | |�}
t|
j||
j|
j||||| ||
j|d� S )a Creates an InstallRequirement from a name, which might be a
requirement, directory containing 'setup.py', filename, or URL.
:param line_source: An optional string describing where the line is from,
for logging purposes in case of an error.
)
rJ ri rt ru rv rw r{ rx r# ry )r� r rh rJ ri r# ) rp r| rt ru rv rw rx r� ry r{ r� r% r% r& r � s
�r �
req_string�InstallRequirement | Nonec
C s� zt | �}W n ty } z
td| �d|� ���d }~ww tjtjg}|jr=|r=|jr=|jj|v r=td|j � d|� d���t
|||||d�S )Nrn ro zZPackages installed from PyPI cannot depend on packages which are not also hosted on PyPI.
z depends on � )ru rt ry ) r r r r
�file_storage_domainr rF rJ �netlocrp r )r� r| ru rt ry r. rr �domains_not_allowedr% r% r& �install_req_from_req_string� s< ������ ����r� �
parsed_reqr c C sv | j rt| j| j|| j|||d�}|S t| j| j||| jr$| j�dg �ng | jr/| j�di �ni | j| j||d�
}|S )N)r| rt rx ru ry r{ rv �hashes) r| rt ru rv rw rx r� ry r{ ) � is_editabler rh r| rx r �options�getr� )r� ru rt ry r{ r. r% r% r& �#install_req_from_parsed_requirement� s4 � ���r� rJ r �ireqc
C s2 t |j|j|j| |j|j|j|j|j|j |j
d� S )N) r. r| r� rJ ri rt ru rv rw r{ ry ) r r. r| r� ri rt ru rv rw r{ ry )rJ r� r% r% r& � install_req_from_link_and_ireq� s �r� c C sR t | jdur
t| jt� �nd| | j| j| j| j| j| j | j
| j g | j | j
| jd�S )z�
Creates a new InstallationRequirement using the given template but without
any extras. Sets the original requirement as the new one's parent
(comes_from).
N)r. r| r� rJ ri rt ru rv rw rx r# r{ ry rz )r r. r; r+ r� rJ ri rt ru rv rw rx r{ ry rz )r� r% r% r& �install_req_drop_extras s �r� �Collection[str]c C sB t � | �}h | j�|�|_| jdur t| j|j�|_|S d|_|S )z�
Returns a copy of an installation requirement with some additional extras.
Makes a shallow copy of the ireq object.
N)�copyr# r. r; )r� r# �resultr% r% r& �install_req_extend_extras# s
����r� )r r r r )r# r( r r) )r. r r/ r) r r )r< r r r= )rL r r rM )r. r r r )r< r r rg rV )r< r r| r} rt r~ ru r rv r� rw r� rx r ry r rz r r{ r� r r )rp r r r )r r rp r r r( )rp r r� r( r rg )rp r r| r� rt r~ ru r rv r� rw r� rx r r� r( ry r r{ r� r r )NFNF) r� r r| r� ru r rt r~ ry r r r )FNFN) r� r ru r rt r~ ry r r{ r� r r )rJ r r� r r r )r� r r r )r� r r# r� r r )C�__doc__�
__future__r r� �loggingr@ r �collections.abcr � dataclassesr � pip._vendor.packaging.markersr �"pip._vendor.packaging.requirementsr r � pip._vendor.packaging.specifiersr �pip._internal.exceptionsr �pip._internal.models.indexr
r �pip._internal.models.linkr �pip._internal.models.wheelr
�pip._internal.req.req_filer � pip._internal.req.req_installr � pip._internal.utils.filetypesr �pip._internal.utils.miscr � pip._internal.utils.packagingr �pip._internal.utils.urlsr �pip._internal.vcsr r �__all__� getLoggerrj rb �
_operators�keysr� r' r- r; r r` re rg rs r r� r� r� r r� r� r� r� r� r% r% r% r& �<module> s�
7
��
"Q��' �( �
(