2biSQ S SK r S SKrS SKrS SKrS SKrS SKrS SKrS SKJ r S SK
J r J r J
r
JrJrJrJrJrJr S SKJr S SKJr S SKJr S SKJrJ r J r J r S SK J r S S K!J"r"J#r# \ ( a S S
K$J%r% \RL " \'5 r(S r)\ " S S
9 " S S5 5 r*\ " S S
9 " S S5 5 r+S\\
\,\,4 S\\
\,\,4 4S jr-S\,S\,4S jr.S\,S\,4S jr/\R` " S\Rb 5 r2S\,S\3S\,4S jr4S \,S\,4S jr5 " S S \ 5 r6 " S S!\5 r7S"\6S\74S# jr8\ Rr " SS$9S%\6S&\6S\34S' j5 r:g)( N) dataclass)
TYPE_CHECKINGAnyDictListMapping
NamedTupleOptionalTupleUnion)
deprecated)WHEEL_EXTENSION)Hashes)pairwiseredact_auth_from_urlsplit_auth_from_netlocsplitext)KeyBasedCompareMixin) path_to_url url_to_path) IndexContent)sha512sha384sha256sha224sha1md5T)frozenc ( \ rS rSr% Sr\\S' \\S' \R " SR SR S \ 5 5 S95 r SS jr
\\R " S
S 9S
\S \S 4S j5 5 rS \\\4 4S jrS \4S jrS\\ S \4S jrSrg
)LinkHash, a Links to content may have embedded hash values. This class parses those.
`name` must be any member of `_SUPPORTED_HASHES`.
This class can be converted to and from `ArchiveInfo`. While ArchiveInfo intends to
be JSON-serializable to conform to PEP 610, this class contains the logic for
parsing a hash name and value for correctness, and then checking whether that hash
conforms to a schema with `.is_hash_allowed()`.namevaluez[#&]({choices})=([^&]*)|c # N # U H n[ R " U5 v M g 7fN)reescape).0 hash_names ڋ/builddir/build/BUILDROOT/alt-python313-pip-23.3.1-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/pip/_internal/models/link.py LinkHash.A s UCTiRYYy 1 1CTs #%)choicesreturnNc 0 U R [ ; d eg r& )r" _SUPPORTED_HASHESselfs r+
__post_init__LinkHash.__post_init__E s yy ---- maxsizeurlc p U R R U5 nUc gUR 5 u p4U " X4S9$ )zGSearch a string for a checksum algorithm name and encoded output value.Nr" r# )_hash_url_fragment_researchgroups)clsr9 matchr" r# s r+ find_hash_url_fragment LinkHash.find_hash_url_fragmentH s: ))005 =lln **r6 c 2 U R U R 0$ r& r; r2 s r+ as_dictLinkHash.as_dictR s 4::&&r6 c F [ U R U R /05 $ )z@Return a Hashes instance which checks only for the current hash.)r r" r# r2 s r+ as_hashesLinkHash.as_hashesU s tyy4::,/00r6 hashesc R Uc gUR U R U R S9$ )z9
Return True if the current hash is allowed by `hashes`.
F)
hex_digest)is_hash_allowedr" r# r3 rI s r+ rL LinkHash.is_hash_allowedY s* >%%diiDJJ%GGr6 r/ N)__name__
__module__ __qualname____firstlineno____doc__str__annotations__r' compileformatjoinr1 r< r4 classmethod functools lru_cacher
rA r rD r rG boolrL __static_attributes__rO r6 r+ r r , s 7 I J JJ #))HH UCT UU *
. &+ +*1E + ' +'c3h '16 1Hhv&6 H4 Hr6 r c > \ rS rSr% Sr\\\\4 \S' SS jr Sr
g) MetadataFileb zFInformation about a core metadata file associated with a distribution.rI Nc f U R b$ [ S U R 5 5 ( d eg g )Nc 3 2 # U H
o[ ; v M g 7fr& )r1 )r) r" s r+ r, -MetadataFile.__post_init__..j s I[T 00[s )rI allr2 s r+ r4 MetadataFile.__post_init__h s, ;; "IT[[III II #r6 rO rP ) rQ rR rS rT rU r
r rV rW r4 r_ rO r6 r+ ra ra b s P T#s(^ $$Jr6 ra rI r/ c U c g U R 5 VVs0 s H u pU[ ; d M X_M n nnU ( d g U $ s snnf r& )itemsr1 )rI nvs r+ supported_hashesrl m sE ~ %||~
H~tq6G1Gdad~F
H M Is ??partc z [ R R [ R R U 5 5 $ )zH
Clean a "part" of a URL path (i.e. after splitting on "@" characters).
)urllibparsequoteunquoterm s r+ _clean_url_path_partrt x s(
<< fll 2 24 8 99r6 c z [ R R [ R R U 5 5 $ )z
Clean the first part of a URL path that corresponds to a local
filesystem path (i.e. the first part after splitting on "@" characters).
)ro request pathname2url url2pathnamers s r+ _clean_file_url_pathry s( >> & &v~~'B'B4'H IIr6 z(@|%2F)path
is_local_pathc : U( a [ nO[ n[ R U 5 n/ n[ [
R " US/5 5 H; u pVUR U" U5 5 UR UR 5 5 M= SR U5 $ )z"
Clean the path portion of a URL.
)
ry rt _reserved_chars_resplitr itertoolschainappendupperrZ )rz r{
clean_funcparts
cleaned_partsto_cleanreserveds r+ _clean_url_pathr s )
)
$ $T *EM &yurd'C D Z 12 X^^ -. E
77= !!r6 r9 c [ R R U 5 nUR ( + n[ UR
US9n[ R R
UR US95 $ )z
Make sure a link is fully quoted.
For example, if ' ' occurs in the URL, it will be replaced with "%20",
and without double-quoting other characters.
)r{ )rz )ro rp urlparsenetlocr rz
urlunparse_replace)r9 resultr{ rz s r+ _ensure_quoted_urlr sT \\
"
"3
'F
%M 6;;m DD << " "6???#= >>r6 c ^ \ rS rSrSr/ SQr S2S\S\\\S4 S\\ S \\ S
\\ S \
S \\ \\4 S
S4U 4S jjjr \
S\\\4 S\S
\S 4S j5 r\
S\\\\ 4 S\S\S
\S 4S j5 rS
\4S jrS
\4S jr\S
\4S j5 r\S
\4S j5 r\S
\4S j5 r\S
\4S j5 r\S
\4S j5 r\S
\4S j5 rS
\\\4 4S jr \S
\4S j5 r \S
\4S j5 r \ R@ " S 5 r!\ R@ " S!\ RD 5 r#S
\\ 4S" jr$\ R@ " S#5 r%\S
\\ 4S$ j5 r&S
\S 4S% jr'S
\(4S& jr)\S
\\ 4S' j5 r*\S
\\ 4S( j5 r+\S
\4S) j5 r,\S
\
4S* j5 r-S
\
4S+ jr.\S
\
4S, j5 r/\S
\
4S- j5 r0\S
\
4S. j5 r1\S
\
4S/ j5 r2S \\( S
\
4S0 jr3S1r4U =r5$ )3Link z:Represents a parsed link from a Package Index's simple URL) _parsed_url_url_hashes
comes_fromrequires_python
yanked_reasonmetadata_file_datacache_link_parsing egg_fragmentNr9 r r r r r r rI r/ c > UR S5 ( a [ U5 n[ R R U5 U l Xl [ R U5 nUc 0 OUR 5 n Uc Xl
O 0 UEU EU l
X l U( a UOSU l X@l
XPl [ T
U ]A U[" S9 X`l U R' 5 U l g)a
:param url: url of the resource pointed to (href of the link)
:param comes_from: instance of IndexContent 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 metadata_file_data: the metadata attached to the file, or None if
no such metadata is provided. This argument, if not None, indicates
that a separate metadata file exists, and also optionally supplies
hashes for that file.
:param cache_link_parsing: A flag that is used elsewhere to determine
whether resources retrieved from this link should be cached. PyPI
URLs should generally have this set to False, for example.
:param hashes: A mapping of hash names to digests to allow us to
determine the validity of a download.
z\\N)keydefining_class)
startswithr ro rp urlsplitr r r rA rD r r r r r super__init__r r
_egg_fragmentr ) r3 r9 r r r r r rI link_hashhashes_from_link __class__s r+ r
Link.__init__ s P >>& ! ! c"C!<<005 33C8 !*!22 8I8I8K >+L9f9(89DL$2At *"4
S6"4 . . 0r6 file_datapage_urlc UR S5 nUc g[ [ R R X#5 5 nUR S5 nUR S5 nUR S0 5 nUR S5 nUc UR S5 n[ U[ 5 ( a [ [ U5 5 n OU( a [ S5 n OSn U( a [ U[ 5 ( d SnO U( d SnU " UUUUUU S 9$ )
zJ
Convert an pypi json document from a simple repository page into a Link.
r9 Nzrequires-pythonyankedrI z
core-metadatazdist-info-metadatar} )r r r rI r )
getr ro rp urljoin
isinstancedictra rl rV )
r? r r file_urlr9 pyrequirer rI
metadata_infor s
r+ from_jsonLink.from_json s ==' !5!5h!IJ MM"34 !
h/
x, "
o6
%MM*> ?M mT * *!-.>}.M!N
!-d!3 "& M3!?!? M M %' 1
r6 anchor_attribsbase_urlc UR S5 nU( d g[ [ R R X45 5 nUR S5 nUR S5 nUR S5 nUc UR S5 nUS:X a [ S5 n OWUc Sn OQUR
S5 u pn U S:X a [ [ X05 5 n O![ R S U5 [ S5 n U " UUUUU S
9$ ) zO
Convert an anchor element's attributes in a simple repository page to a Link.
hrefNzdata-requires-pythonz data-yankedzdata-core-metadatazdata-dist-info-metadatatrue=z8Index returned invalid data-dist-info-metadata value: %s)r r r r )
r r ro rp r ra partitionrl loggerdebug)
r? r r r r r9 r r r r hashnamesephashvals
r+ from_elementLink.from_element9 s !!&) !5!5h!EF"&&'=> &**=9
'**+?@
* . ./H IM F "!-d!3
"!% &3%<%rO r2 s r+ __repr__
Link.__repr__y s vQ r6 c U R $ r& )r r2 s r+ r9 Link.url| s yyr6 c U R R S5 n[ R " U5 nU( d [ U R
5 u p4U$ [ R R U5 nU( d SU R < S35 eU$ )N/zURL z produced no filename)
rz rstrip posixpathbasenamer r ro rp rr r )r3 rz r" r user_passs r+ filename
Link.filename su yy $!!$' !7t{{ C FM||##D)>tDII=(=>>t r6 c , [ U R 5 $ r& )r r9 r2 s r+ file_pathLink.file_path s 488$$r6 c . U R R $ r& )r schemer2 s r+ r Link.scheme s &&&r6 c . U R R $ )z$
This can contain auth information.
)r r r2 s r+ r Link.netloc s
&&&r6 c h [ R R U R R 5 $ r& )ro rp rr r rz r2 s r+ rz Link.path s# ||##D$4$4$9$9::r6 c r [ [ R " U R R S5 5 5 $ )Nr )r r r rz r r2 s r+ r
Link.splitext s' **499+;+;C+@ABBr6 c ( U R 5 S $ N )r r2 s r+ extLink.ext s }}q!!r6 c f U R u pp4n[ R R XX4S45 $ )Nr} )r ro rp
urlunsplit)r3 r r rz queryfragments r+ url_without_fragmentLink.url_without_fragment s0 040@0@-X||&&R'HIIr6 z[#&]egg=([^&]*)z)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$c U R R U R 5 nU( d g UR S5 nU R R U5 ( d [
U S3SSSS9 U$ )Nr z1 contains an egg fragment with a non-PEP 508 namez8to use the req @ url syntax, and remove the egg fragmentz25.0ia- )reason replacementgone_inissue)_egg_fragment_rer= r group_project_name_rer@ r
)r3 r@ project_names r+ r Link._egg_fragment sl %%,,TYY7 {{1~ $$**<88 PQ V
r6 z[#&]subdirectory=([^&]*)c ~ U R R U R 5 nU( d g UR S5 $ r )_subdirectory_fragment_rer= r r )r3 r@ s r+ subdirectory_fragmentLink.subdirectory_fragment s0 ..55dii@{{1~ r6 c U R c gU R S3nU R R c [ U5 $ [ XR R S9$ )z " " ) ) 1 % %L)@)@)G)GHHr6 c [ U R R 5 VVs0 s H u pX/_M
snn5 $ s snnf r& )r r ri )r3 krk s r+ rG Link.as_hashes s4 $,,*<*<*>?*>$!q#v*>?@@?s :
c \ [ [ U R R 5 5 S 5 $ r& )nextiterr valuesr2 s r+ hash Link.hash s! D ,,./66r6 c @ [ [ U R 5 S 5 $ r& )r r r r2 s r+ r* Link.hash_name s D &--r6 c [ R " U R R SS5 S R SS5 S 5 $ )N#r r ?)r r r r r2 s r+ show_url
Link.show_url s9 !!$))//#q"9!"<"B"B3"J1"MNNr6 c U R S:H $ )Nfile)r r2 s r+ is_file Link.is_file s {{f$$r6 c z U R =( a) [ R R U R 5 $ r& )r osrz isdirr r2 s r+ is_existing_dirLink.is_existing_dir s" ||=
dnn ==r6 c ( U R [ :H $ r& )r r r2 s r+ is_wheel
Link.is_wheel s xx?**r6 c @ SSK Jn U R UR ; $ )Nr )vcs)pip._internal.vcsr r all_schemes)r3 r s r+ is_vcs Link.is_vcs s ){{coo--r6 c U R S L$ r& )r r2 s r+ is_yankedLink.is_yanked s !!--r6 c , [ U R 5 $ r& )r^ r r2 s r+ has_hash
Link.has_hash s DLL!!r6 c f ^ Tc g[ U4S jU R R 5 5 5 $ )zC
Return True if the link has a hash and it is allowed by `hashes`.
Fc 3 J ># U H u pTR X5 v M g 7fr& )rL )r) r rk rI s r+ r, 'Link.is_hash_allowed.. s# QQDLL0
0
& 0
0
d 1
S(3- /01
1
1
& 1
1
f
8
8 # S # %3 % % ' ' ' ' ' ' ;c ; ;C%S/ C "S " " Jc J J zz"45 zz4bmm x} $ !#
+F G
x} Ix / IA6 A 7hsm 7 7 .8C= . . O# O O % % %> > +$ + + . . .
.4 . . "$ " "Rhv&6 R4 R Rr6 r c \ rS rSr% Sr\R R \S' \ \
\ \
4 \S' \
\S' \ \
\
4 \S' Sr g) _CleanResulti aE 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.
parsedr subdirectoryrI rO N)
rQ rR rS rT rU ro rp SplitResultrW r rV r r_ rO r6 r+ r2 r2 s@ 2
LL $ $$ T#Y cNr6 r2 linkc * U R nUR R SS5 S nUR S:X a U( d Sn[ R
R
UR 5 nSU; a [ R SU 5 US S n[ Vs0 s H oUU; d M
XSU S _M nn[ UR US
S
S 9[ R
R
UR 5 UUS 9$ ! [ [ 4 a S
n Nyf = fs snf )
N@r r localhosteggz Ignoring egg= fragment in %sr4 r r} )r r r )r3 r r4 rI )r r rsplitr ro rp parse_qsr r r
IndexErrorKeyErrorr1 r2 r r )r6 r3 r r r4 r rI s r+ _clean_linkr@ ) s
F
]]
!
!#q
)"
-F
}} v ||$$V__5H 3T: /2
*;
L):A8m a!Q ):F
L fBDll##FLL1!
! Ms C8 D( D8D
D
r7 link1link2c 0 [ U 5 [ U5 :H $ r& )r@ )rA rB s r+ links_equivalentrD C s u U!3 33r6 );r\ r loggingr r r' urllib.parsero dataclassesr typingr r r r r r r
r r pip._internal.utils.deprecationr
pip._internal.utils.filetypesr pip._internal.utils.hashesr pip._internal.utils.miscr r r r pip._internal.utils.modelsr pip._internal.utils.urlsr r pip._internal.index.collectorr getLoggerrQ r r1 r ra rV rl rt ry rX r/ r~ r^ r r r r2 r@ r] rD rO r6 r+ rQ s !
7 9 - < =: 8 $
L $2H 2H 2Hj $J J JXd38n 5 (4S>:R :s :s :
Js
Js
J ZZ 2==9 "# "d "s ", ?C ?C ? PR PRf
: @d | 4 T"4D 4 4$ 4 #4r6