o
EcY& @ s d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZm Z m
Z
m Z m Z m
Z
mZ d dlmZ d dlmZ d dlmZmZmZ d dlmZ d dlmZmZ erVd dl m Z e e Z d Z!G d
d d eZ"G d d
d
e Z#de"de#fddZ$e j%ddde"de"de&fddZ'dS ) N)
TYPE_CHECKINGDictList
NamedTupleOptionalTupleUnion)WHEEL_EXTENSION)Hashes)redact_auth_from_urlsplit_auth_from_netlocsplitext)KeyBasedCompareMixin) path_to_url url_to_path)HTMLPage)Zsha1Zsha224Zsha384Zsha256Zsha512Zmd5c
s6 e Zd ZdZg dZ dBdedeeedf dee d ee d
ed df fd d
Z d efddZ
d efddZ e d efddZ
e d efddZe d efddZe d efddZe d efddZe d efd d Zd eeef fd d Ze d efd d!Ze d efd"d#Zed$Ze d ee fd%d&Zed'Ze d ee fd(d)Z ed*j d+ e d,Z e d ee fd-d.Z!e d ee fd/d0Z"e d efd1d2Z#e d efd3d4Z$d efd5d6Z%e d efd7d8Z&e d efd9d:Z'e d efd;d<Z(e d efd=d>Z)d?ee* d efd@dAZ+ Z,S )CLinkz:Represents a parsed link from a Package Index's simple URL) _parsed_url_url
comes_fromrequires_python
yanked_reasoncache_link_parsingNTurlr r r r r returnc sZ | dr t|}tj|| _|| _|| _|r|nd| _|| _ t
j |t d || _
dS )a
:param url: url of the resource pointed to (href of the link)
:param comes_from: instance of HTMLPage where the link was found,
or string.
:param requires_python: String containing the `Requires-Python`
metadata field, specified in PEP 345. This may be specified by
a data-requires-python attribute in the HTML link tag, as
described in PEP 503.
:param yanked_reason: the reason the file has been yanked, if the
file has been yanked, or None if the file hasn't been yanked.
This is the value of the "data-yanked" attribute, if present, in
a simple repository HTML link. If the file has been yanked but
no reason was provided, this should be the empty string. See
PEP 592 for more information and the specification.
:param cache_link_parsing: A flag that is used elsewhere to determine
whether resources retrieved from this link
should be cached. PyPI index urls should
generally have this set to False, for
example.
z\\N)keyZdefining_class)
startswithr urllibparseurlsplitr r r r r super__init__r r )selfr r r r r __class__ L/opt/alt/python310/lib/python3.10/site-packages/pip/_internal/models/link.pyr! ( s
z
Link.__init__c C sD | j r d| j d}nd}| jrdt| j| j|S tt| jS )Nz (requires-python:) z{} (from {}){})r r formatr r str)r" Zrpr% r% r& __str__V s z Link.__str__c C s d| dS )Nzr% r" r% r% r& __repr__b s z
Link.__repr__c C s | j S N)r r- r% r% r& r e s zLink.urlc C s< | j d}t|}|st| j\}}|S tj|}|S N/) pathrstrip posixpathbasenamer netlocr r unquote)r" r2 namer6 Z user_passr% r% r& filenamei s
z
Link.filenamec C s
t | jS r/ )r r r- r% r% r& file_pathw
zLink.file_pathc C | j jS r/ )r schemer- r% r% r& r= { s z Link.schemec C r< )z4
This can contain auth information.
)r r6 r- r% r% r& r6 s z Link.netlocc C s t j| jjS r/ )r r r7 r r2 r- r% r% r& r2 z Link.pathc C s t t| jdS r0 )r
r4 r5 r2 r3 r- r% r% r& r
s z
Link.splitextc C s | d S N )r
r- r% r% r& ext s zLink.extc C s& | j \}}}}}tj||||dfS )Nr( )r r r
urlunsplit)r" r= r6 r2 queryfragmentr% r% r& url_without_fragment s zLink.url_without_fragmentz[#&]egg=([^&]*)c C | j | j}|s d S |dS r? )_egg_fragment_researchr groupr" matchr% r% r& egg_fragment
zLink.egg_fragmentz[#&]subdirectory=([^&]*)c C rF r? )_subdirectory_fragment_rerH r rI rJ r% r% r& subdirectory_fragment rM zLink.subdirectory_fragmentz({choices})=([a-f0-9]+)|)choicesc C | j | j}|r|dS d S )N _hash_rerH r rI rJ r% r% r& hash
z Link.hashc C rR r? rT rJ r% r% r& hash_name rW zLink.hash_namec C s$ t | jddd ddd S )N#r@ r ?)r4 r5 r splitr- r% r% r& show_url s $z
Link.show_urlc C s
| j dkS )Nfile)r= r- r% r% r& is_file r; z Link.is_filec C s | j o tj| jS r/ )r^ osr2 isdirr: r- r% r% r& is_existing_dir s zLink.is_existing_dirc C s
| j tkS r/ )rA r r- r% r% r& is_wheel r; z
Link.is_wheelc C s ddl m} | j|jv S )Nr )vcs)Zpip._internal.vcsrc r= Z all_schemes)r" rc r% r% r& is_vcs s z Link.is_vcsc C
| j d uS r/ )r r- r% r% r& is_yanked r; zLink.is_yankedc C re r/ )rX r- r% r% r& has_hash r; z
Link.has_hashhashesc C s$ |du s| j s dS |j| j| jdS )zG
Return True if the link has a hash and it is allowed.
NF)Z
hex_digest)rg is_hash_allowedrX rV )r" rh r% r% r& ri s zLink.is_hash_allowed)NNNT)-__name__
__module__ __qualname____doc__ __slots__r* r r boolr! r+ r. propertyr r9 r: r= r6 r2 r r
rA rE recompilerG rL rN rO r) join_SUPPORTED_HASHESrU rV rX r\ r^ ra rb rd rf rg r
ri
__classcell__r% r% r# r& r s .
r c @ sJ e Zd ZU dZejjed< ee e
e f ed< e ed< ee e f ed< dS ) _CleanResulta Convert link for equivalency check.
This is used in the resolver to check whether two URL-specified requirements
likely point to the same distribution and can be considered equivalent. This
equivalency logic avoids comparing URLs literally, which can be too strict
(e.g. "a=1&b=2" vs "b=2&a=1") and produce conflicts unexpecting to users.
Currently this does three things:
1. Drop the basic auth part. This is technically wrong since a server can
serve different content based on auth, but if it does that, it is even
impossible to guarantee two URLs without auth are equivalent, since
the user can input different auth information when prompted. So the
practical solution is to assume the auth doesn't affect the response.
2. Parse the query to avoid the ordering issue. Note that ordering under the
same key in the query are NOT cleaned; i.e. "a=1&a=2" and "a=2&a=1" are
still considered different.
3. Explicitly drop most of the fragment part, except ``subdirectory=`` and
hash values, since it should have no impact the downloaded content. Note
that this drops the "egg=" part historically used to denote the requested
project (and extras), which is wrong in the strictest sense, but too many
people are supplying it inconsistently to cause superfluous resolution
conflicts, so we choose to also ignore them.
parsedrC subdirectoryrh N) rj rk rl rm r r SplitResult__annotations__r r* r r% r% r% r& rv s
rv linkr c s | j }|jddd }|jdkr|sd}tj|j d v r&t d| z d d }W n
t
t fy; d
}Y nw fd d t D }t
|j|d
d
d
tj|j||dS )N@r@ r] Z localhostZeggz Ignoring egg= fragment in %srx r r( c s" i | ]
}| v r| | d qS )r r% ).0krD r% r&
s " z _clean_link..)r6 rC rD )rw rC rx rh )r r6 rsplitr= r r parse_qsrD loggerdebug
IndexErrorKeyErrorrt rv _replacerC )r{ rw r6 rx rh r% r r& _clean_link s& r )maxsizelink1link2c C s t | t |kS r/ )r )r r r% r% r& links_equivalent r> r )( functoolsZloggingr_ r4 rq urllib.parser typingr r r r r r r Z pip._internal.utils.filetypesr Zpip._internal.utils.hashesr
Zpip._internal.utils.miscr r r
Zpip._internal.utils.modelsr Zpip._internal.utils.urlsr r Z pip._internal.index.collectorr Z getLoggerrj r rt r rv r lru_cachero r r% r% r% r& s, $
I