# pre-release
[-_\.]?
(?P(a|b|c|rc|alpha|beta|pre|preview))
[-_\.]?
(?P[0-9]+)?
)?
(?P # post release
(?:-(?P[0-9]+))
|
(?:
[-_\.]?
(?Ppost|rev|r)
[-_\.]?
(?P[0-9]+)?
)
)?
(?P # dev release
[-_\.]?
(?Pdev)
[-_\.]?
(?P[0-9]+)?
)?
)
(?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version
c . \ rS rSr% Sr\R " S\- S- \R \R - 5 r
\ \ S' S\
SS4S jrS\
4S
jrS\
4S jr\S\4S j5 r\S\\S
4 4S j5 r\S\\\
\4 4S j5 r\S\\ 4S j5 r\S\\ 4S j5 r\S\\
4S j5 r\S\
4S j5 r\S\
4S j5 r \S\ 4S j5 r \S\ 4S j5 r \S\ 4S j5 r \S\4S j5 r!\S\4S j5 r"\S\4S j5 r#Sr$g) r 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
z^\s*z\s*$r* r r Nc U R R U5 nU( d [ SU S35 e[ UR S5 ( a [ UR S5 5 OS[
S UR S5 R S5 5 5 [ UR S5 UR S 5 5 [ UR S
5 UR S 5 =( d UR S 5 5 [ UR S
5 UR S5 5 [ UR S5 5 S9U l
[ U R R U R R U R R U R R U R R U R R" 5 U 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: ''r r c 3 8 # U H n[ U5 v M g 7fr, )rL .0is r #Version.__init__.. s L*KQ#a&&*K r .pre_lpre_npost_lpost_n1post_n2dev_ldev_nr )r r r r r r N)_regexsearchr r grouprL tuplesplit_parse_letter_version_parse_local_version_version_cmpkeyr r r r r r r* )r/ r matchs r __init__Version.__init__ sU ""7+ #5gYa!@A A !/4{{7/C/C#ekk'*+L%++i*@*F*Fs*KLL%ekk'&:EKK>> Version('1.0.0')
z
r r. s r __repr__Version.__repr__ s D6%%r c d / nU R S:w a UR U R S35 UR SR S U R 5 5 5 U R b1 UR SR S U R 5 5 5 U R
b UR SU R
35 U R b UR SU R 35 U R b UR S U R 35 SR U5 $ )
zgA string representation of the version that can be rounded-tripped.
>>> str(Version("1.0a5"))
'1.0a5'
r !rZ c 3 8 # U H n[ U5 v M g 7fr, strrU xs r rW "Version.__str__.. ;lc!fflrY c 3 8 # U H n[ U5 v M g 7fr, rt rv s r rW rx s :AQrY z.postz.dev+)r appendjoinr r r r r r/ partss r __str__Version.__str__ s ::? LLDJJ>> Version("2.0.0").epoch
0
>>> Version("1!2.0.0").epoch
1
)ri r )r/ _epochs r r
Version.epoch s mm))
r .c 2 U R R nU$ )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.
)ri r )r/ _releases r r Version.release s %)MM$9$9r c 2 U R R nU$ )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)
)ri r )r/ _pres r r Version.pre$ s +/--*;*; r c n U R R ( a U R 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)ri r r. s r r Version.post4 s* )-
(:(:t}}!!!$DDr c n U R R ( a U R 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)ri r r. s r r Version.dev? s* (,}}'8'8t}} #BdBr c U R R ( a, SR S U R 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'
rZ c 3 8 # U H n[ U5 v M g 7fr, rt rv s r rW Version.local..T s @,?qCFF,?rY N)ri r r~ r. s r r
Version.localJ s3 == 88@DMM,?,?@@ @r 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.2.3+abc.dev1").public
'1.2.3'
r| r r )ru rf r. s r publicVersion.publicX s 4ysA&q))r c / nU R S:w a UR U R S35 UR SR S U R 5 5 5 SR U5 $ )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.3+abc.dev1").base_version
'1!1.2.3'
The "base version" is the public version of the project without any pre or post
release markers.
r rr rZ c 3 8 # U H n[ U5 v M g 7fr, rt rv s r rW 'Version.base_version..z ry rY rz )r r} r~ r r s r base_versionVersion.base_versione s\ ::? LLDJJ>> 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)r r 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)r 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 lenr 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 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 r. s r micro
Version.micro r r )r* ri )%r! r" r# r$ r% recompiler VERBOSE
IGNORECASErb CmpKeyrK ru rl ro r propertyrL r r r r r r r r r r rM r r r r r r r& r r r r r s . ZZ/1G;RZZ"--=W
XF
L$
$
$
L&# & B s sCx
XeCHo.
Ehsm E E CXc] C C x}
*
*
* c 0 F
W F
v
F
.
.F
|
#Fs6{"" f s6{"" r z[\._-]r 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 7fr, )isdigitr rL )rU parts r rW '_parse_local_version.. s0
> !% DJJLCI =>s =?)re _local_version_separatorsrf )r s r rh rh s4
177>
r r r r r r c $ [ [ [ [ R " S [ U5 5 5 5 5 nUc
Uc
Ub [
nO Uc [ nOUnUc [
nOUnUc [ n OUn Uc [
n
O[ S U 5 5 n
XXxX4$ )Nc U S:H $ )Nr r )rw s r _cmpkey.. s AFr c 3 d # U H& n[ U[ 5 ( a US 4O[ U4v M( g7f)rz N)r5 rL r rT s r rW _cmpkey..0 s.
NSz!S))QG0@!/D Des .0)re reversedlist itertools dropwhiler r
) r r r r r r r r _post_dev_locals r rj rj s i))*:HWr s- E E W W
Cl$889
}eCHo56]C,-
,# $ & 4 5
7
sCx ...)S
#FF#3T#9: ! !C
3 9 Z +' +'` > # e@l e@P ! ! sE; 67!
eCHo !H JJy 1 (; <6 <6
38_<6
%S/ "<6 5c?
# <6
%S/ " <6 E,' (
<6 <6r