[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]+)?
)?+
)
(?:\+
(?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]+)*c r U =( d Sn[ U[ 5 ( a US: a U$ SU 3n[ U5 e)Nr z(epoch must be non-negative integer, got rd r| r; )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 )rd tuplelenallr; )r rC r s r# _validate_releaser sS mdG7E"" L1 ?w? ? ? LWI
VC
r& c U c U $ [ U [ 5 ( a; [ U 5 S:X a, U S S; a# [ U S [ 5 ( a U S S: a U $ SU 3n[ U5 e)Nr r )r/ r0 r1 r z=pre must be a tuple of ('a'|'b'|'rc', non-negative int), got )rd r r r| r; r r s r#
_validate_prer si } 5% J!O !H( ( uQx % % !HM I%
QC
r& c j U c U $ [ U [ 5 ( a
U S: a SU 4$ SU 3n[ U5 e)Nr r2 z'post must be non-negative integer, got 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 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 )rd str_LOCAL_PATTERN fullmatch_parse_local_versionr; 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 ' S rg
)_Versioni- r| rB tuple[int, ...]rC tuple[str, int] | NonerE r6 r2 LocalType | NonerG r- NrH r- r& r# r r - s% J
r& r c \ 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 jrS+S jr\S,S j5 r\\" S5 S-S j5 5 r\R( \" S5 S.S j5 5 rS/S jrS/S jr\S/S j5 r\S0S j5 r\S1S j5 r\S2S j5 r\S3S j5 r\S3S j5 r \S4S j5 r \S/S! j5 r \S/S" j5 r \S5S# j5 r \S5S$ j5 r!\S5S% j5 r"\S0S& j5 r#\S0S' j5 r$\S0S( j5 r%Sr&g))6r< i6 am 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
_dev_epoch
_key_cache_local_post_pre_release)_strz\s*r| r r r r r r r r r z
CmpKey | Noner c U 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 S5 5 U l [ UR S5 UR S 5 =( d UR S
5 5 U l [ UR S 5 UR S 5 5 U l
[ UR S
5 5 U l SU l g)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: rB r rC .pre_lpre_npost_lpost_n1post_n2dev_ldev_nrG N)_regexr r; groupr| r r mapsplitr _parse_letter_versionr r r r r r )r[ rQ matchs r# __init__Version.__init__\ s %%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+?@ 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 nS Ul X(l X8l XHl XXl Xhl Xxl U$ )NrB rC r6 r2 rE rG )r r r r r r r r r r r r __class____new__r ) r[ r rB rC r6 r2 rE rG new_versions r# __replace__Version.__replace__v s; 4;v4Ew04;; F"
fY / 0
/4vomF5M*4991761A~fVn-tzz.3vomF5M*4994;v4Ew04;;
[[ ==(yy
"yy $Knn,,T^^< !% " & "r& c U R cQ [ U R U R U R U R
U R U R 5 U l U R $ rY )r _cmpkeyr r r r r r rZ s r# r\ Version._key sN ?? " %
DO r& z4Version._version is private and will be removed soonc [ U R U R U R U R U R
U R 5 $ rY )r r r r r r r rZ s r# _versionVersion._version 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 g rY )
rB r rC r rE r r6 r r2 r rG r r )r[ r s r# r r sM kk
II II ZZ
kk r& c SU S3$ )zhA representation of the Version that shows all internal state.
>>> Version('1.0.0')
z
r- rZ s r# __repr__Version.__repr__ s D6%%r& c SR [ [ U R 5 5 nU R ( a U R SU 3nU R
b, USR [ [ U R
5 5 -
nU R b USU R 3-
nU R b USU R 3-
nU R b USU R 3-
nU$ )zeA string representation of the version that can be round-tripped.
>>> str(Version("1.0a5"))
'1.0a5'
r ! z.postz.dev+) joinr r rC rB r6 r2 rE rG )r[ rQ s r# __str__Version.__str__ 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 rZ s r# r Version._str s 4yr& c U R $ )zWThe epoch of the version.
>>> Version("2.0.0").epoch
0
>>> Version("1!2.0.0").epoch
1
)r rZ s r# rB
Version.epoch 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 rZ 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 rZ s r# r6 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
r N)r rZ s r# r2 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 rZ 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 7frY r )r xs r# r Version.local.., s 8KqCFFKs N)r r rZ s r# rG
Version.local" s' ;;888DKK88 8r& c > [ U 5 R SS5 S $ )zThe public portion of the version.
>>> 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 rZ s r# publicVersion.public0 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.
>>> 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 r6 rZ s r#
is_prereleaseVersion.is_prereleaseN 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)r2 rZ 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 rZ s r#
is_devreleaseVersion.is_devreleasej 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 rZ s r# major
Version.majoru 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 r rZ 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 r rZ s r# micro
Version.micro r r& N)rQ r r( None)r zUnpack[_VersionReplace]r( r )r( CmpKey)r( r )r r r( r )r( r r{ r( r )r( r )r( rA )r( rF )r( r} )'rI rJ rK rL rT r~ __match_args__recompiler: VERBOSE
IGNORECASEr rM r r r r\ r. r setterr r r rB rC r6 r2 rE rG r r r r r r r r rN r- r& r# r< r< 6 s . XI N
ZZ 0692::
;U
VF K
!! 4 B
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 rY ) rd r< r r r r r r r superr )r[ rQ r s r# r _TrimmedRelease.__init__ 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 )rQ z
str | Versionr( r r )
rI rJ rK rL r~ r r rC rN
__classcell__)r s @r# r r s! I
" 4 4r& r c U ( a; U R 5 n [ R X 5 n U [ U=( d S5 4$ U( a
S[ U5 4$ g )Nr r2 )lower_LETTER_NORMALIZATIONgetr| )letternumbers r# r r sQ
'**6: s6;Q'''
s6{"" r& z[\._-]c T U b% [ S [ R U 5 5 5 $ g)zJ
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 7frY )isdigitr r| )r parts r# r '_parse_local_version.. s0
> !% DJJLCI =>s =?)r _local_version_separatorsr )rG s r# r r s4
177>
r& c 4 [ U5 nUnU( a$ XS-
S:X a US- nU( a
XS-
S:X a M Xv:X a UOUS U nUc
Uc
Ub [ n O Uc [ n OUn Uc [ n
OUn
Uc [ n OUn Uc [ n O[ S U 5 5 n XXX4$ )Nr r c 3 d # U H& n[ U[ 5 ( a US 4O[ U4v M( g7f)r N)rd r| r r s r# r _cmpkey.. s.
NSz!S))QG0@!/D Des .0)r r r
r )
rB rC r6 r2 rE rG r r r r r r r s
r# r r s g,KA
A!# Q A!#*w H {t|"2
|#3 {"* } /
NS
D 55r& )r" r r( r' )rQ r r( r< )r r' r( r| )r r' r( r )r r' r( rD )r r' r( z"tuple[Literal['post'], int] | None)r r' r( z!tuple[Literal['dev'], int] | None)r r' r( r )r rF r! z str | bytes | SupportsInt | Noner( r )rG rF r( r )rB r| rC r r6 r r2 r rE r rG r r( r
)ArT
__future__r r
sysr r r r r r r r
r _structuresr
r r r r typing_extensionsr r version_infor r r. r) r __all__r| r LocalTypeCmpPrePostDevType CmpLocalTyper
r} VersionComparisonMethodr? r=
ValueErrorr; rV _VERSION_PATTERNreplace_VERSION_PATTERN_OLDimplementationnamer: r r r r r r r r r r r< r r r' r r r- r& r# r; s #
X W .w 2 ;
"
D %S/3& ' ,(.>.L
'!
;R]]K z \@l \@~
4g 4D @0 JJy 1 :6 :6
:6
:6 ! :6
:6
:6 :6r&