2bi[ S r SSKrSSKrSSKJr SSKJr / SQr\R " \ 5 r
" S S\ 5 r " S S
\
5 r " S S \
5 r\R " S
5 rS r\r " S S\5 rS r " S S\5 r\R " S5 S4\R " S5 S4\R " S5 S4\R " S5 S4\R " S5 S 4\R " S 5 S 4\R " S 5 S 4\R " S 5 S!4\R " S"5 S#4\R " S$5 S%44
r\R " S&5 S4\R " S'5 S4\R " S(5 S 4\R " S 5 S 4\R " S)5 S44r\R " S*5 rS+ rS, r\R " S-\R8 5 r S.S.S/S.S0SSS1.r S2 r " S3 S4\5 r " S5 S6\5 r!\R " S7\R8 5 r"S8 r#S9 r$ " S: S;\5 r% " S< S=\5 r& " S> S?\
5 r'\'" \\\5 \'" \ \!S@ 5 \'" \$\&\5 SA.r(\(SB \(SC' SD r)g)Ez~
Implementation of a flexible versioning scheme providing support for PEP-440,
setuptools-compatible and semantic versioning.
N ) string_typesparse_requirement)NormalizedVersionNormalizedMatcher
LegacyVersion
LegacyMatcherSemanticVersionSemanticMatcherUnsupportedVersionError
get_schemec \ rS rSrSrSrg)r
z This is an unsupported version. N)__name__
__module__ __qualname____firstlineno____doc____static_attributes__r ڍ/builddir/build/BUILDROOT/alt-python313-pip-23.3.1-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/pip/_vendor/distlib/version.pyr
r
s )r r
c l \ rS rSrS rS rS rS rS rS r S r
S r S
r S r
S rS
r\S 5 rSrg)Version c UR 5 =U l nU R U5 =U l n[ U[
5 ( d e[
U5 S: d eg )Nr )strip_stringparse_parts
isinstancetuplelen)selfspartss r __init__Version.__init__ sK 779$ q "jjm+ e%''''5zA~ ~r c [ S5 e)Nz please implement in a subclassNotImplementedErrorr% r& s r r
Version.parse% s !"BCCr c Z [ U 5 [ U5 :w a [ SU < SU< 35 eg Nzcannot compare z and )type TypeErrorr% others r _check_compatibleVersion._check_compatible( s' :e $$ FG G %r c V U R U5 U R UR :H $ Nr5 r! r3 s r __eq__Version.__eq__, s# u%{{ell**r c . U R U5 ( + $ r8 r: r3 s r __ne__Version.__ne__0 ;;u%%%r c V U R U5 U R UR : $ r8 r9 r3 s r __lt__Version.__lt__3 s# u%{{U\\))r c ^ U R U5 =( d U R U5 ( + $ r8 rB r: r3 s r __gt__Version.__gt__7 s" KK&<$++e*<==r c T U R U5 =( d U R U5 $ r8 rE r3 s r __le__Version.__le__: {{5!7T[[%77r c T U R U5 =( d U R U5 $ r8 )rF r: r3 s r __ge__Version.__ge__= rK r c , [ U R 5 $ r8 )hashr! r% s r __hash__Version.__hash__A s DKK r c R U R R < SU R < S3$ )Nz('z') __class__r r rQ s r __repr__Version.__repr__D s !^^ 4 4dllCCr c U R $ r8 r rQ s r __str__Version.__str__G ||r c [ S5 e)Nz Please implement in subclasses.r+ rQ s r
is_prereleaseVersion.is_prereleaseJ s !"CDDr )r! r N)r r r r r( r r5 r: r> rB rF rI rM rR rW r[ propertyr_ r r r r r r sW DH+&*>88!D E Er r c \ rS rSrSrS S S S S S S S
S .rS rS
rS r\ S 5 r
S r S r S r
S rS rS rSrg)MatcherO Nc
X: $ r8 r vcps r Matcher.T QUr c
X: $ r8 r rf s r rj rk U rl r c X:H =( d X: $ r8 r rf s r rj rk V afoor c X:H =( d X: $ r8 r rf s r rj rk W ro r c
X:H $ r8 r rf s r rj rk X afr c
X:H $ r8 r rf s r rj rk Y s qvr c X:H =( d X: $ r8 r rf s r rj rk [ ro r c
X:g $ r8 r rf s r rj rk \ rr r )<><=>======~=!=c [ U5 $ r8 r r- s r r Matcher.parse_requirementa s
##r c L U R c [ S5 eUR 5 =U l nU R U5 nU( d [ SU- 5 eUR
U l U R
R
5 U l / nUR ( a| UR Hl u pAUR S5 ( a, US; a [ SU- 5 eUS S SpeU R U5 OU R U5 SpeUR XEU45 Mn [ U5 U l g ) Nz Please specify a version classz
Not valid: %rz.*)rz r} z#'.*' not allowed for %r constraintsTF)
version_class
ValueErrorr r r namelowerkey constraintsendswithappendr# r! )r% r& rclistopvnprefixs r r( Matcher.__init__d s
% => > 779$ q " "1 % _q 01 1FF 99??$ == ::d## - ( *:<>*? @ @ "#3B&&r* "&!3!3A!6 bf -. ' El r c p [ U[ 5 ( a U R U5 nU R H u p#nU R R U5 n[ U[ 5 ( a [
X5 nU( d( U< SU R R < 3n[ U5 eU" XU5 ( a M g g)z
Check if the provided version matches the constraints.
:param version: The version to match against this instance.
:type version: String or :class:`Version` instance.
z not implemented for FT)
r" r r r!
_operatorsgetgetattrrV r r, )r% versionoperator
constraintr fmsgs r match
Matcher.match s g| , ,((1G,0KK (H&##H-A!\**D$#+T^^-D-DF)#..W&11 -8 r c S n[ U R 5 S:X a( U R S S S; a U R S S nU$ )Nr r )rz r{ )r$ r! )r% results r
exact_versionMatcher.exact_version sC t{{ q T[[^A%6-%G[[^A&F
r c [ U 5 [ U5 :w d U R UR :w a [ SU < SU< 35 eg r0 )r1 r r2 r3 s r r5 Matcher._check_compatible s7 :e $ UZZ(?$ FG G )@r c U R U5 U R UR :H =( a U R UR :H $ r8 )r5 r r! r3 s r r: Matcher.__eq__ s5 u%xx599$D )DDr c . U R U5 ( + $ r8 r= r3 s r r> Matcher.__ne__ r@ r c X [ U R 5 [ U R 5 - $ r8 )rP r r! rQ s r rR Matcher.__hash__ s DHH~T[[ 111r c R U R R < SU R < S3$ )N()rU rQ s r rW Matcher.__repr__ s >>22DLLAAr c U R $ r8 rZ rQ s r r[ Matcher.__str__ r] r )r! r r r )r r r r r r r r( r ra r r5 r: r> rR rW r[ r r r r rc rc O sl M #
"--$%-$
J $#:* HE&2B r rc zk^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?(\.(post)(\d+))?(\.(dev)(\d+))?(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$c U R 5 n [ R U 5 nU( d [ SU - 5 eUR 5 n[ S US R
S5 5 5 n[ U5 S: a( US S:X a US S n[ U5 S: a US S:X a M US ( d SnO[ US S S 5 nUSS nUS S
nUS S nUS
nUS:X a SnOUS [ US 5 4nUS:X a SnOUS [ US 5 4nUS:X a SnOUS [ US 5 4nUc SnO]/ n UR
S5 H; n
U
R 5 ( a S[ U
5 4n
OSU
4n
U R U
5 M= [ U 5 nU( d U( d
U( a SnOSnU( d SnU( d SnXCXVXx4$ )NzNot a valid version: %sc 3 8 # U H n[ U5 v M g 7fr8 int.0rg s r _pep_440_key.. s 6!5AQ!5 r .r
)NNr )ar )z)_)final) r PEP440_VERSION_REr r
groupsr# splitr$ r isdigitr ) r& mr numsepochprepostdevlocalr' parts r _pep_440_keyr s A "A %&?!&CDD
XXZF 6 !56 6D
d)a-DHMCRy d)a-DHM !9F1IcrN#
1+C !A;D
B-C 2JE
l!fc#a&k! |AwDG $
l!fc#a&k! }KK$D ||~~3t9~4y LL % e CC 3 --r c B \ rS rSrSrS r\" / SQ5 r\S 5 r Sr
g)r a A rational version.
Good:
1.2 # equivalent to "1.2.0"
1.2.0
1.2a1
1.2.3a2
1.2.3b1
1.2.3c1
1.2.3.4
TODO: fill this out
Bad:
1 # minimum two numbers
1.2a # release level must have a release serial
1.2.3b
c [ U5 n[ R U5 nUR 5 n[ S US R S5 5 5 U l U$ )Nc 3 8 # U H n[ U5 v M g 7fr8 r r s r r *NormalizedVersion.parse.. s $J5ISVV5Ir r r )_normalized_keyr r r r# r _release_clause)r% r& r r r s r r NormalizedVersion.parse
sN #
# #A & $$JVAY__S5I$J J
r )r brh rcr c B ^ [ U 4S jT R 5 5 $ )Nc 3 X ># U H o( d M US TR ; v M! g7f)r N) PREREL_TAGS)r tr% s r r 2NormalizedVersion.is_prerelease.. s% F[A+1Q44+++[s
**)anyr! rQ s `r r_ NormalizedVersion.is_prerelease s FT[[FFFr )r N) r r r r r r setr ra r_ r r r r r r s- " 23K
G Gr r c [ U 5 n [ U5 nX:X a gU R U5 ( d g[ U5 nX S:H $ )NTFr )str
startswithr$ )xyns r
_match_prefixr sA AA AAv <<?? AA 43;r c d \ rS rSr\rSSSSSSSS S
.rS rS rS
r S r
S r S r S r
S rS rSrg)r i' _match_compatible _match_lt _match_gt _match_le _match_ge _match_eq_match_arbitrary _match_ne)r| rv rw rx ry rz r{ r} c U( a SU; =( a UR S nO*UR S ( + =( a UR S nU( a0 UR R SS5 S nU R U5 nX4$ )N+r r r )r! r r r )r% r r r strip_localr& s r
_adjust_local NormalizedMatcher._adjust_local6 sw Z/FGNN24FK ) / / 33Jr8JK %%c1-a0A((+G""r c U R XU5 u pX: a gUR nSR U Vs/ s H n[ U5 PM sn5 n[ X5 ( + $ s snf NFr r r joinr r r% r r r release_clauseipfxs r r NormalizedMatcher._match_ltD _ " 0 0f M #33hh71A78 ... 8 A"c U R XU5 u pX:: a gUR nSR U Vs/ s H n[ U5 PM sn5 n[ X5 ( + $ s snf r r r s r r NormalizedMatcher._match_gtL r r c 2 U R XU5 u pX:* $ r8 r r% r r r s r r NormalizedMatcher._match_leT " 0 0f M$$r c 2 U R XU5 u pX: $ r8 r r s r r NormalizedMatcher._match_geX r r c ^ U R XU5 u pU( d X:H nU$ [ X5 nU$ r8 r r r% r r r r s r r NormalizedMatcher._match_eq\ s: " 0 0f M +F
#77F
r c 0 [ U5 [ U5 :H $ r8 )r r s r r "NormalizedMatcher._match_arbitraryd s 7|s:..r c h U R XU5 u pU( d X:g nU$ [ X5 ( + nU$ r8 r r
s r r NormalizedMatcher._match_neg s= " 0 0f M +F
'w;;F
r c U R XU5 u pX:X a gX: a gUR n[ U5 S: a US S nSR U Vs/ s H n[ U5 PM sn5 n[ X5 $ s snf )NTFr r r )r r r$ r r r r s r r #NormalizedMatcher._match_compatibleo s " 0 0f M $33 ~ " +CR 0Nhh71A78 W** 8s A7r N)r r r r r r r r r r r r r r r r r r r r r r ' sU %M "
! J # //%%/ +r r z[.+-]$ z^[.](\d)z0.\1z^[.-]z
^\((.*)\)$\1z^v(ersion)?\s*(\d+)z\2z^r(ev)?\s*(\d+)z[.]{2,}r z\b(alfa|apha)\balphaz\b(pre-alpha|prealpha)\bz pre.alphaz \(beta\)$betaz
^[:~._+-]+z
[,*")([\]]z[~:+_ -]z\.$z
(\d+(\.\d+)*)c U R 5 R 5 n[ H u p#UR X15 nM U( d Sn[ R U5 nU( d SnUnGOUR
5 S R S5 nU Vs/ s H n[ U5 PM nn[ U5 S: a" UR S5 [ U5 S: a M" [ U5 S:X a XR 5 S nOFSR USS Vs/ s H n[ U5 PM sn5 XR 5 S - nUSS nSR U Vs/ s H n[ U5 PM sn5 nUR 5 nU( a [ H u p#UR X65 nM U( d UnOSU; a SOSnXX- U- n[ U5 ( d SnU$ s snf s snf s snf ) zt
Try to suggest a semantic form for a version for which
_suggest_normalized_version couldn't come up with anything.
z0.0.0r r Nr -r )r r
_REPLACEMENTSsub_NUMERIC_PREFIXr r r r r$ r endr r _SUFFIX_REPLACEMENTS is_semver) r& r patreplr r suffixr seps r _suggest_semantic_versionr& s
WWY__
F" & #
f%A A $$S)"()&Q#a&&)&kAo MM! &kAo v;! EEGH%FXXvabz :z!s1vz :;fUUWX>NNFBQZF626a3q6623
.ICWWT*F . f_c# & V M/ * ;2s G GGc [ U 5 U $ ! [ a Of = fU R 5 nS H u p#UR X#5 nM [ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SS U5 n[ R
" S
S U5 nUR
S 5 ( a US
S n[ R
" SS U5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" SSU5 n[ R
" S SU5 n[ R
" S S U5 n[ R
" S S U5 n [ U5 U$ ! [ a Sn U$ f = f)!a Suggest a normalized version close to the given version string.
If you have a version string that isn't rational (i.e. NormalizedVersion
doesn't like it) then you might be able to get an equivalent (or close)
rational version from this function.
This does a number of simple normalizations to the given string, based
on observation of versions currently in use on PyPI. Given a dump of
those version during PyCon 2009, 4287 of them:
- 2312 (53.93%) match NormalizedVersion without change
with the automatic suggestion
- 3474 (81.04%) match when using this suggestion method
@param s {str} An irrational version string.
@returns A rational version string, or None, if couldn't determine one.
))z-alphar )z-betar )r r )r r )r rh )z-finalr )z-prerh )z-releaser )z.releaser )z-stabler )r r )r r ) r )z.finalr )r r zpre$pre0zdev$dev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?r rg r Nz\b0+(\d+)(?!\d)z (\d+[abc])$z\g<1>0z\.?(dev-r|dev\.r)\.?(\d+)$z.dev\2z-(a|b|c)(\d+)$z[\.\-](dev|devel)$z.dev0z(?![\.\-])dev$z(final|stable)$r z\.?(r|-|-r)\.?(\d+)$z.post\2z\.?(dev|git|bzr)\.?(\d+)$z\.?(pre|preview|-c)(\d+)$zc\g<2>zp(\d+)$z.post\1)r r
r replacerer r )r& rsorigr# s r _suggest_normalized_versionr/ s "
"
B&
ZZ
#
&
" %B " %B
)7B 7B
-x .get_partsC s $$QWWY/A $$Q*Aq!BQ%&3&
AaA
a 0
h
r r7 r8 r z*final-00000000)r popr r# )r& r< r ri s r _legacy_keyr@ B s F
q\ << 8| y!8JJL y!8VBZ: 5
VBZ: 5
a =r c * \ rS rSrS r\S 5 rSrg)r i\ c [ U5 $ r8 )r@ r- s r r LegacyVersion.parse] s 1~ r c SnU R H= n[ U[ 5 ( d M UR S5 ( d M2 US: d M: Sn U$ U$ )NFr7 r8 T)r! r" r r )r% r r s r r_ LegacyVersion.is_prerelease` sK A1l++ S0A0AH
r r Nr r r r r ra r_ r r r r r r \ s r r c p \ rS rSr\r\" \R 5 rS\S' \ R " S5 r S r Sr
g)r
ik r r| z^(\d+(\.\d+)*)c X: a gU R R [ U5 5 nU( d [ R SX5 gUR 5 S nSU; a UR
SS5 S n[ X5 $ )NFzACannot compute compatible match for version %s and constraint %sTr r r )
numeric_rer r loggerwarningr rsplitr )r% r r r r r& s r r LegacyMatcher._match_compatibles st OO ! !#j/ 2 NN 018
F
HHJqM !8a #A W((r r N)r r r r r r dictrc r r, compilerI r r r r r r
r
k s5 !Mg(()J*Jt -.J )r r
zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$c , [ R U 5 $ r8 )
_SEMVER_REr )r& s r r! r! s A r c S n[ U 5 nU( d [ U 5 eUR 5 nUS S Vs/ s H n[ U5 PM snu pVnU" US S5 U" US S5 pXVU4X4$ s snf )Nc U c U4nU$ U SS R S5 n[ U Vs/ s H* oDR 5 ( a UR S5 OUPM, sn5 nU$ s snf )Nr r r6 )r r# r r; )r& absentr r' ri s r
make_tuple!_semantic_key..make_tuple sf 9 YF
abEKK$E eLe))++AGGAJ1 > !F
^^A&F
r rg r8 )
r r r r r( rn rq ru rx r r r r re re s #
<r re c U$ r8 r r- s r rj rj s r )
normalizedlegacysemanticr{ defaultc D U [ ; a [ SU - 5 e[ U $ )Nzunknown scheme name: %r)_SCHEMESr )r s r r r s% 82T9:: D>r )*r loggingr, compatr utilr __all__ getLoggerr rJ r r
objectr rc rO r r r r r r r r r r& r/ Ir9 r: r@ r r
rQ r! r] r r re r r r r r r s
# 4
8 $ j
.Ef .Eba f a H JJ F G
:.z !G !GHT+ T+n ZZ2 ZZ g&ZZ" ZZ
&ZZ&'/ZZ"#U+ZZ C ZZ"#W-ZZ+, ZZ v&
ZZ r"ZZ
#ZZ
S!ZZ C ZZ ** -.+\ld
0"$$7
4 G )G )2 ZZ :;=44A
-*(g ($g $$F $N 1B ;=K 8IJ m_ 79 |, r