[0-9]+(?:\.[0-9]+)*+) # release segment
(?P # pre-release
[._-]?+
(?Palpha|a|beta|b|preview|pre|c|rc)
[._-]?+
(?P[0-9]+)?
)?+
(?P # post release
(?:-(?P[0-9]+))
|
(?:
[._-]?
(?Ppost|rev|r)
[._-]?
(?P[0-9]+)?
)
)?+
(?P # dev release
[._-]?+
(?Pdev)
[._-]?+
(?P[0-9]+)?
)?+
)
(?a:\+
(?P # local version
[a-z0-9]+
(?:[._-][a-z0-9]+)*+
)
)?+
z*+*z?+?cpython)r pypy)r r r )r r z [a-z0-9]+(?:[._-][a-z0-9]+)*z .0123456789c r U =( d Sn[ U[ 5 ( a US: a U$ SU 3n[ U5 e)Nr z(epoch must be non-negative integer, got rh r r6 )valuerB msgs r _validate_epochr
s: JQE% %1* 4UG
$_validate_release.. s# ?w!
1c"-qAv-ws )+z@release must be a non-empty tuple of non-negative integers, got )rh tuplelenallr6 )r rC r s r _validate_releaser sS mdG7E"" L1 ?w? ? ? LWI
VC
r! c U c U $ [ U [ 5 ( aB [ U 5 S:X a3 U u p[ U5 nUS; a [ U[ 5 ( a US: a X4$ SU 3n[ U5 e)Nr > r* r+ r, r z=pre must be a tuple of ('a'|'b'|'rc', non-negative int), got )rh r r r8 r r6 )r rT numberr s r
_validate_prer sp } % CJ!O v& % %*VS*A*AfPQk# # I%
QC
r! c j U c U $ [ U [ 5 ( a
U S: a SU 4$ SU 3n[ U5 e)Nr r- z'post must be non-negative integer, got r r r s r _validate_postr + s@ } % %1* 3E7
;C
r! c j U c U $ [ U [ 5 ( a
U S: a SU 4$ SU 3n[ U5 e)Nr rE z&dev must be non-negative integer, got r r s r
_validate_devr 4 s@ } % %1*u~ 25'
:C
r! c U c U $ [ U [ 5 ( a% [ R U 5 ( a [ U 5 $ SU < 3n[ U5 e)Nz*local must be a valid version string, got )rh str_LOCAL_PATTERN fullmatch_parse_local_versionr6 r s r _validate_localr = sK } % .":":5"A"A#E** 6ui
@C
r! c R \ rS rSr% S\S' S\S' S\S' S\S ' S
\S ' S \S
' Srg)_VersioniG r rB tuple[int, ...]rC !tuple[Literal['dev'], int] | NonerE *tuple[Literal['a', 'b', 'rc'], int] | Noner1 "tuple[Literal['post'], int] | Noner- LocalType | NonerG r( NrH r( r! r r r G s% J
** 33
,, r! r c l ^ \ rS rSr% SrSrSr \R " S\ - S- \R \R - 5 r S\
S' S\
S ' S
\
S ' S \
S
' S\
S' S\
S' S\
S' S\
S' S:S jr\SSSSSS. S;S jj5 rSS jrS?U 4S jjrS?U 4S jjrS@U 4S jjrS?U 4S! jjrS?U 4S" jjrS@U 4S# jjr SAS$ jrSBS% jr \\ " S&5 SCS' j5 5 r \ R> \ " S&5 SDS( j5 5 r SES) jr SES* jr!\SES+ j5 r"\S>S, j5 r#\SFS- j5 r$\SGS. j5 r%\SHS/ j5 r&\SHS0 j5 r'\SIS1 j5 r(\SES2 j5 r)\SES3 j5 r*\SJS4 j5 r+\SJS5 j5 r,\SJS6 j5 r-\S>S7 j5 r.\S>S8 j5 r/\S>S9 j5 r0Sr1U =r2$ )Kr7 iP aT This class abstracts handling of a project's versions.
A :class:`Version` instance is comparison aware and can be compared and
sorted using the standard Python interfaces.
>>> v1 = Version("1.0a5")
>>> v2 = Version("1.0")
>>> v1
>>> v2
>>> v1 < v2
True
>>> v1 == v2
False
>>> v1 > v2
False
>>> v1 >= v2
False
>>> v1 <= v2
True
:class:`Version` is immutable; use :meth:`__replace__` to change
part of a version.
Instances are safe to serialize with :mod:`pickle`. They use a stable
format so the same pickle can be loaded in future packaging releases.
.. versionchanged:: 26.2
Added a stable pickle format. Pickles created with packaging 26.2+ can
be unpickled with future releases. Backward compatibility with pickles
from packaging < 26.2 is supported but may be removed in a future
release.
)_dev_epoch _hash_cache
_key_cache_local_post_pre_release)_strz\s*r r r r r r r r r r r r rA r z
CmpKey | Noner c L [ R U5 ( a` [ [ [ UR S5 5 5 U l SU l SU l
SU l SU l SU l
SU l SU l gU R R# U5 nU( d [ SU< 35 eUR% S5 ( a [ UR% S5 5 OSU l [ [ [ UR% S5 R S5 5 5 U l [' UR% S5 UR% S 5 5 U l
[' UR% S
5 UR% S 5 =( d UR% S 5 5 U l [' UR% S
5 UR% S5 5 U l [) UR% S5 5 U l
SU l SU l g! [ a' SUR S5 ; a [ SU< 35 See f = f)a Initialize a Version object.
:param version:
The string representation of a version which will be parsed and normalized
before use.
:raises InvalidVersion:
If the ``version`` does not conform to PEP 440 in any way then this
exception will be raised.
. zInvalid version: Nr rB rC pre_lpre_npost_lpost_n1post_n2dev_ldev_nrG )_SIMPLE_VERSION_INDICATORS
issupersetr mapr splitr
ValueErrorr6 r r r r r r r _regexr group_parse_letter_versionr )r_ rV matchs r __init__Version.__init__ s & 0 0 9 9
%c#w}}S/A&B C
DK DI DJ DI DK "DO #D %%g. #4WK!@A A38;;w3G3Gc%++g./Q c#u{{9'='C'CC'H IJ
*%++g*> G@TU * KK !5;;y#9#SU[[=S
*%++g*> G@TU *5;;w+?@ G
s++(+>> Version.from_parts(release=(1,2,3))
>>> Version.from_parts(release=(0,1,0), pre=("b", 1))
:param epoch:
:param release: This version tuple is required
.. versionadded:: 26.1
N)r r r r r r __new__r r r r r r r r )clsrB rC r1 r- rE rG r r r r r r new_versions r
from_partsVersion.from_parts s 8 !'$W-%(_}S!$(,(8t$d%(_}S!$+0+< '$kk#& !% "& # ' ! #r! c SU; a [ US 5 O U R nSU; a [ US 5 O U R nSU; a [ US 5 O U R
nSU; a [
US 5 O U R nSU; a [ US 5 O U R nSU; a [ US 5 O U R nX R :X aM X0R :X a> X@R
:X a/ XPR :X a X`R :X a XpR :X a U $ U R R U R 5 nSUl SUl X(l X8l XHl XXl Xhl Xxl U$ )aW
__replace__(*, epoch=..., release=..., pre=..., post=..., dev=..., local=...)
Return a new version with parts replaced.
This returns a new version (unless no parts were changed). The
pre-release is normalized. Setting a value to ``None`` clears it.
>>> v = Version("1.2.3")
>>> v.__replace__(pre=("a", 1))
:param int | None epoch:
:param tuple[int, ...] | None release:
:param tuple[str, int] | None pre:
:param int | None post:
:param int | None dev:
:param str | None local:
.. versionadded:: 26.0
.. versionchanged:: 26.1
The pre-release portion is now normalized.
rB rC r1 r- rE rG N)r r r r r r r r r r r r __class__r r r ) r_ r rB rC r1 r- rE rG r s r __replace__Version.__replace__ sE 2 5 s~ ++ +K 8 ?? "C +$+
%
DOc *.c2;r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR : $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri superrl r_ rk r s r rl Version.__lt__P eW % %&")KKMMIIJJIIKK
# '#*LLNNJJKKJJLL
$ ??U%5%55 5% ..! !w~e$$r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR :* $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri r rp r s r rp Version.__le__k eW % %&")KKMMIIJJIIKK
# '#*LLNNJJKKJJLL
$ ??e&6&66 6% ..! !w~e$$r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR :H $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri r rt r s r rt Version.__eq__ r r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR : $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri r rw r s r rw Version.__ge__ r r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR : $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri r rz r s r rz Version.__gt__ r r! c , > [ U[ 5 ( a U R cQ [ U R U R
U R U R U R U R 5 U l UR cQ [ UR UR
UR UR UR UR 5 Ul U R UR :g $ [ U[ 5 ( d [ $ [ TU ]5 U5 $ r; )rh r7 r r r r r r r r r[ ri r r} r s r r} Version.__ne__ r r! c U R U R U R U R U R U R
4$ r; )r r r r r r r^ s r __getstate__Version.__getstate__ s8
KK MM II JJ II KK
r! c S U l S U l [ U[ 5 ( a [ U5 S:X a( Uu U l U l U l U l U l U l
g [ U5 S:X a Uu p#[ U[ 5 ( am US U l US U l UR S5 U l UR S5 U l UR S5 U l UR S5 U l
g [ U[ 5 ( a{ UR S 5 nUbg UR U l UR U l UR U l UR U l UR" U l UR$ U l
g [' S
U< 35 e) N r r r r r r r _versionz Cannot restore Version from )r r rh r r r r r r r r dictrS rB rC r1 r- rE rG TypeError)r_ state_ slot_dict
version_nts r __setstate__Version.__setstate__ sQ eU # #5zQ KMIJIK5zQ $ i.."+H"5DK$-j$9DM )
f 5DI!* w!7DJ )
f 5DI"+--"9DK eT " " :.J% ( . . * 2 2
&NN '__
&NN ( . . 6ui@AAr! z4Version._version is private and will be removed soonc [ U R U R U R U R U R
U R 5 $ r; )r r r r r r r r^ s r r Version._version5 s6 KK 499djj$++
r! c UR U l UR U l UR U l UR U l UR U l UR U l S U l S U l
g r; )rB r rC r rE r r1 r r- r rG r r r )r_ r s r r r < sU kk
II II ZZ
kk r! c P SU R R S[ U 5 < S3$ )zhA representation of the Version that shows all internal state.
>>> Version('1.0.0')
<(z)>)r rI r r^ s r __repr__Version.__repr__H s( 4>>**+1SYM<>> str(Version("1.0a5"))
'1.0a5'
r !r z.postz.dev+) joinr r rC rB r1 r- rE rG )r_ rV s r __str__Version.__str__P s ((3sDLL12 :: AgY/G 88 rwws3 12 2G 99 tyyk* *G 88 dhhZ( (G :: ! 4::,' 'Gr! c [ U 5 $ )z Internal property for match_argsr r^ s r r Version._stro s 4yr! c U R $ )zWThe epoch of the version.
>>> Version("2.0.0").epoch
0
>>> Version("1!2.0.0").epoch
1
)r r^ s r rB
Version.epocht s {{r! c U R $ )a The components of the "release" segment of the version.
>>> Version("1.2.3").release
(1, 2, 3)
>>> Version("2.0.0").release
(2, 0, 0)
>>> Version("1!2.0.0.post0").release
(2, 0, 0)
Includes trailing zeroes but not the epoch or any pre-release / development /
post-release suffixes.
)r r^ s r rC Version.release s }} r! c U R $ )zThe pre-release segment of the version.
>>> print(Version("1.2.3").pre)
None
>>> Version("1.2.3a1").pre
('a', 1)
>>> Version("1.2.3b1").pre
('b', 1)
>>> Version("1.2.3rc1").pre
('rc', 1)
)r r^ s r r1 Version.pre s yyr! c F U R ( a U R S $ S$ )zqThe post-release number of the version.
>>> print(Version("1.2.3").post)
None
>>> Version("1.2.3.post1").post
1
N)r r^ s r r- Version.post s !%
tzz!}44r! c F U R ( a U R S $ S$ )zmThe development number of the version.
>>> print(Version("1.2.3").dev)
None
>>> Version("1.2.3.dev1").dev
1
r N)r r^ s r rE Version.dev s $yytyy|2d2r! c j U R ( a" SR S U R 5 5 $ g)zwThe local version segment of the version.
>>> print(Version("1.2.3").local)
None
>>> Version("1.2.3+abc").local
'abc'
r c 3 8 # U H n[ U5 v M g 7fr; r )r xs r r Version.local.. s 8KqCFFKs N)r r r^ s r rG
Version.local s' ;;888DKK88 8r! c > [ U 5 R SS5 S $ )a) The public portion of the version.
This returns a string. If you want a :class:`Version` again and care
about performance, use ``v.__replace__(local=None)`` instead.
>>> Version("1.2.3").public
'1.2.3'
>>> Version("1.2.3+abc").public
'1.2.3'
>>> Version("1!1.2.3dev1+abc").public
'1!1.2.3.dev1'
r
r r )r r r^ s r publicVersion.public s 4ysA&q))r! c SR [ [ U R 5 5 nU R ( a U R SU 3$ U$ )a The "base version" of the version.
This returns a string. If you want a :class:`Version` again and care
about performance, use
``v.__replace__(pre=None, post=None, dev=None, local=None)`` instead.
>>> Version("1.2.3").base_version
'1.2.3'
>>> Version("1.2.3+abc").base_version
'1.2.3'
>>> Version("1!1.2.3dev1+abc").base_version
'1!1.2.3'
The "base version" is the public version of the project without any pre or post
release markers.
r r )r r r rC rB )r_ release_segments r base_versionVersion.base_version s> $ ((3sDLL#9:48JJ$** Q /0SOSr! c H U R SL=( d U R SL$ )zWhether this version is a pre-release.
>>> Version("1.2.3").is_prerelease
False
>>> Version("1.2.3a1").is_prerelease
True
>>> Version("1.2.3b1").is_prerelease
True
>>> Version("1.2.3rc1").is_prerelease
True
>>> Version("1.2.3dev1").is_prerelease
True
N)rE r1 r^ s r
is_prereleaseVersion.is_prerelease s! xxt#;txxt';;r! c U R SL$ )zWhether this version is a post-release.
>>> Version("1.2.3").is_postrelease
False
>>> Version("1.2.3.post1").is_postrelease
True
N)r- r^ s r is_postreleaseVersion.is_postrelease s yy$$r! c U R SL$ )zWhether this version is a development release.
>>> Version("1.2.3").is_devrelease
False
>>> Version("1.2.3.dev1").is_devrelease
True
N)rE r^ s r
is_devreleaseVersion.is_devrelease s xxt##r! c V [ U R 5 S: a U R S $ S$ )zYThe first item of :attr:`release` or ``0`` if unavailable.
>>> Version("1.2.3").major
1
r r r rC r^ s r major
Version.major s' #&dll"3q"8t||A?a?r! c V [ U R 5 S: a U R S $ S$ )zsThe second item of :attr:`release` or ``0`` if unavailable.
>>> Version("1.2.3").minor
2
>>> Version("1").minor
0
r r r r2 r^ s r minor
Version.minor ' #&dll"3q"8t||A?a?r! c V [ U R 5 S: a U R S $ S$ )zrThe third item of :attr:`release` or ``0`` if unavailable.
>>> Version("1.2.3").micro
3
>>> Version("1").micro
0
r r r r2 r^ s r micro
Version.micro" r8 r! )rV r r# None)rB r rC r r1 rD r- rA rE rA rG rF r# r )r zUnpack[_VersionReplace]r# r )r# CmpKeyr r r )r# zutuple[int, tuple[int, ...], tuple[str, int] | None, tuple[str, int] | None, tuple[str, int] | None, LocalType | None])r r" r# r< )r# r )r r r# r< )r# r r# r )r# r )r# rA )r# rF )r# r )3rI rJ rK rL rY r __match_args__recompiler5 VERBOSE
IGNORECASEr rM r classmethodr r r r` rd rl rp rt rw rz r} r r r) r setterr r r rB rC r1 r- rE rG r" r& r) r, r/ r3 r6 r: rN
__classcell__r s @r r7 r7 P s "H I N ZZ 0692::
;U
VF K
++
44 -- 0 d &* , , ! ,
$ ,
, , ,
, ,\8t
$%6%6%6%6%6%6
,+BZ GH
I
__GH I = >
5 5 3 3
*
* T T( < < % % $ $ @ @ @ @ @ @r! c J ^ \ rS rSrSrSU 4S jjr\SU 4S jj5 rSrU =r $ )_TrimmedReleasei. r( c > > [ U[ 5 ( ax UR U l UR U l UR U l UR
U l UR U l UR U l UR U l g [ TU ]) U5 g r; ) rh r7 r r r r r r r r r )r_ rV r s r r _TrimmedRelease.__init__1 sq gw ' '!..DK # , ,DM DI DI DJ!..DK % 0 0DO
!r! c > [ TU ] n[ U5 nUnUS: a# XS-
S:X a US- nUS: a
XS-
S:X a M X2:X a U$ USU $ )z
Release segment without any trailing zeros.
>>> _TrimmedRelease('1.0.0').release
(1,)
>>> _TrimmedRelease('0.0').release
(0,)
r r N)r rC r )r_ rel len_releaser r s r rC _TrimmedRelease.release= sc go#h !eE
a
FA !eE
a&s3CG3r! )r r r r r r r )rV z
str | Versionr# r< r> )
rI rJ rK rL r r r rC rN rF rG s @r rI rI . s! I
" 4 4r! rI c U ( a; U R 5 n [ R X 5 n U [ U=( d S5 4$ U( a
S[ U5 4$ g )Nr r- )rQ rR rS r )rT r s r r r P sQ
'**6: s6;Q'''
s6{"" r! z[\._-]c T U b% [ S [ R U 5 5 5 $ g)zT
Takes a string like ``"abc.1.twelve"`` and turns it into
``("abc", 1, "twelve")``.
Nc 3 # U H5 nUR 5 ( d UR 5 O
[ U5 v M7 g 7fr; )isdigitrQ r )r parts r r '_parse_local_version..q s0
> !% DJJLCI =>s =?)r _local_version_separatorsr )rG s r r r k s4
177>
r! r r )r* r+ r, r c [ U5 nUnU( a$ XS-
S:X a US- nU( a
XS-
S:X a M Xv:X a UOUSU nUc Uc Uc Uc X[ 4$ Uc Uc Ub [ SpOUc [ SpO[ US US pUc SOSn Uc SOUS n Uc SOSn
Uc SOUS nXXX4nUc XU4$ [ S U 5 5 nXUU4$ )aA Build a comparison key for PEP 440 ordering.
Returns ``(epoch, release, suffix)`` or
``(epoch, release, suffix, local)`` so that plain tuple
comparison gives the correct order.
Trailing zeros are stripped from the release so that ``1.0.0 == 1``.
The suffix is a flat 6-int tuple that encodes pre/post/dev:
``(pre_rank, pre_n, post_rank, post_n, dev_rank, dev_n)``
pre_rank: dev-only=-1, a=0, b=1, rc=2, no-pre=3
Dev-only releases (no pre or post) get -1 so they sort before
any alpha/beta/rc. Releases without a pre-release tag get 3
so they sort after rc.
post_rank: no-post=0, post=1
Releases without a post segment sort before those with one.
dev_rank: dev=0, no-dev=1
Releases without a dev segment sort after those with one.
Local segments use ``(n, "")`` for ints and ``(-1, s)`` for strings,
following PEP 440: strings sort before ints, strings compare
lexicographically, ints compare numerically, and shorter segments
sort before longer when prefixes match. Versions without a local
segment sort before those with one (3-tuple < 4-tuple).
>>> _cmpkey(0, (1, 0, 0), None, None, None, None)
(0, (1,), (3, 0, 0, 0, 1, 0))
>>> _cmpkey(0, (1,), ("a", 1), None, None, None)
(0, (1,), (0, 1, 0, 0, 1, 0))
>>> _cmpkey(0, (1,), None, None, None, ("ubuntu", 1))
(0, (1,), (3, 0, 0, 0, 1, 0), ((-1, 'ubuntu'), (1, '')))
r r Nc 3 d # U H& n[ U[ 5 ( a US 4O[ U4v M( g7f)r N)rh r _LOCAL_STR_RANK)r segs r r _cmpkey.. s. $QV#ZS))b /EEQVs .0)r _STABLE_SUFFIX_PRE_RANK_DEV_ONLY_PRE_RANK_STABLE _PRE_RANKr )rB rC r1 r- rE rG rN r trimmedpre_rankr post_rankpost_ndev_rankr suffix cmp_locals r r r s T g,KA
A!# Q A!#)gwr{G {t|
~--
{t|,a% *A%#CF+SV%\qI,QDGFKqQHA#a&Ey(
BF }v%% # $QV$ I 69 ,,r! )r r r# r" )r# z list[str])rT r r# r )rV r r# r7 )r r" r# r )r r" r# r )r r" r# r )r r" r# r )r r" r# r )r r" r# r )rT rF r z str | bytes | SupportsInt | Noner# rD )rG rF r# r )rB r rC r r1 rD r- rD rE rD rG r r# r= )FrY
__future__r r@ sysr r r r r r r r
r r typing_extensionsr r
version_infor r r) r$ rR r< r= r r LocalType CmpLocalType CmpSuffixr= r VersionComparisonMethodr? r8 r9 r r6 r[ _VERSION_PATTERNreplace_VERSION_PATTERN_OLDimplementationnamer5 rA rC ASCIIr frozensetr r r r r r r r r7 rI r rV r r` r^ r_ rZ r] r r( r! r rw s #
.w 2 ;
"
U
%S/3& ' U38_c)* #sCc3. / #uS#X
)* #uS#X <
78:
#FF#3T#9: iu 5* Z 3' 3't" H (//c:BB4M 9,1A1AJ1N 6)c.>.>.L
'!
$ ;R]]RXX=UV '} 5
z [ @l [ @| 4g 4D @0 JJy 1
!1 % #Aq!Q2J- J-
J-
J- ! J-
J-
J- J-r!