[0-9]+(?:\.[0-9]+)*) # release segment
(?P # 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 f e Zd ZU dZ ej dez dz ej ej z Z e
e d< de ddfdZ
de fd Zde fd
Zedefd Zedeed f fd
Zedeee ef fd Zedee fd Zedee fd Zedee fd Zede fd Zede fd Zede fd Z ede fd Z ede fd Z edefd Z edefd Z!edefd Z"dS )r a 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 | j | }|st d| d t | d r"t | d ndt
d | d d D t | d | d t | d
| d p| d t | d
| d t | d | _
t | j
j | j
j
| j
j | j
j | j
j | j
j | _ dS )aC 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 4 K | ]}t | V d S r( )rA .0is r z#Version.__init__.. s( LLQ#a&&LLLLLLr r .pre_lpre_npost_lpost_n1post_n2dev_ldev_nr )r r r r r r N)_regexsearchr r grouprA tuplesplit_parse_letter_version_parse_local_version_version_cmpkeyr r r r r r r& )r+ r matchs r __init__zVersion.__init__ s ""7++ B !@g!@!@!@AA A !/4{{7/C/CJ#ekk'**+++LL%++i*@*@*F*Fs*K*KLLLLL%ekk'&:&:EKK>> Version('1.0.0')
z
r# r* s r __repr__zVersion.__repr__ s &D%%%%r c B g }| j dk r | | j d | d d | j D | j 7| d d | j D | j | d| j | j | d | j | j | d
| j d | S ) zA string representation of the version that can be rounded-tripped.
>>> str(Version("1.0a5"))
'1.0a5'
r !rL c 3 4 K | ]}t | V d S r( strrI xs r rK z"Version.__str__.. ( ; ;c!ff ; ; ; ; ; ;r N c 3 4 K | ]}t | V d S r( rd rf s r rK z"Version.__str__.. s( : :AQ : : : : : :r z.postz.dev+)r appendjoinr r r r r r+ partss r __str__zVersion.__str__ s" :?? LLDJ))) * * * SXX ; ;dl ; ; ;;;<<< 8 LL : : : : ::: ; ; ; 9 LL,,, - - - 8 LL*** + + + : ! LL)TZ)) * * *wwu~~ r c | j j }|S )zThe epoch of the version.
>>> Version("2.0.0").epoch
0
>>> Version("1!2.0.0").epoch
1
)r[ r )r+ _epochs r r z
Version.epoch s m)
r .c | j j }|S )ad 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 )r+ _releases r r zVersion.release s %)M$9r c | j j }|S )a The 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 )r+ _pres r r z Version.pre$ s +/-*; r c B | j j r| j j d ndS )zThe post-release number of the version.
>>> print(Version("1.2.3").post)
None
>>> Version("1.2.3.post1").post
1
r N)r[ r r* s r r z Version.post4 s# )-
(:Dt}!!$$Dr c B | j j r| j j d ndS )zThe development number of the version.
>>> print(Version("1.2.3").dev)
None
>>> Version("1.2.3.dev1").dev
1
r N)r[ r r* s r r z Version.dev? s# (,}'8Bt} ##dBr c p | j j r)d d | j j D S dS )zThe local version segment of the version.
>>> print(Version("1.2.3").local)
None
>>> Version("1.2.3+abc").local
'abc'
rL c 3 4 K | ]}t | V d S r( rd rf s r rK z Version.local..T s( @@qCFF@@@@@@r N)r[ r rm r* s r r z
Version.localJ s< = 88@@DM,?@@@@@ @4r c T t | dd d 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'
rk r r )re rX r* s r publiczVersion.publicX s# 4yysA&&q))r c g }| j dk r | | j d | d d | j D d | S )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 rb rL c 3 4 K | ]}t | V d S r( rd rf s r rK z'Version.base_version..z rh r ri )r rl rm r rn s r base_versionzVersion.base_versione st :?? LLDJ))) * * * SXX ; ;dl ; ; ;;;<<<wwu~~ r c & | j dup| j duS )aT Whether 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)r r r* s r
is_prereleasezVersion.is_prerelease~ s xt#;txt';;r c | j duS )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_postreleasezVersion.is_postrelease s y$$r c | j duS )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_devreleasezVersion.is_devrelease s xt##r c P t | j dk r
| j d ndS )zqThe first item of :attr:`release` or ``0`` if unavailable.
>>> Version("1.2.3").major
1
r r lenr r* s r majorz
Version.major s( #&dl"3"3q"8"8t|Aa?r c P t | j dk r
| j d ndS )zThe 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 minorz
Version.minor ( #&dl"3"3q"8"8t|Aa?r c P t | j dk r
| j d ndS )zThe 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 microz
Version.micro r r )#r r r! r" recompiler VERBOSE
IGNORECASErT CmpKeyr@ re r^ r` rp propertyrA r r r r r r r r r| r rB r r r r r r r# r r r r s . RZ/1G;RZ"-=W
X
XF
LLL$
$
$
$
$
$
L&# & & & & B s X sCx X
XeCHo.
X
Ehsm E E E XE CXc] C C C XC x} X
*
*
*
* X
* c X 0 F
W FF
v
FF
.
.
.FF
|
#
#Fs6{{"" #f # s6{{"" 4r z[\._-]r c l | 1t d t | D S dS )zR
Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
Nc 3 K | ];}| s| nt | V . sU
!% =DJJLLLCII
r )rW _local_version_separatorsrX )r s r rZ rZ sM
177>>
4r r r r r r c P t t t t j d t | }| |
|t
}n |t }n|}|t
}n|}|t } n|} |t
}
nt d |D }
| |||| |
fS )Nc | dk S )Nr r# )rg s r z_cmpkey.. s
AF r c 3 Z K | ]&}t |t r|d fnt |fV 'dS )ri N)r0 rA r rH s r rK z_cmpkey..0 sP
IJz!S)) DQGG0@!/D
r )rW reversedlist itertools dropwhiler r
) r r r r r r rt rv _post_dev_locals r r\ r\ s i)*:*:HWr sQ E E E E E E E E E E E E E E E E W W W W W W W W W W W W
C
C
Cl$889
}eCHo56]C,-
,# $ & 4 5
7
sCx ...)S
#FF#3T#9: !; !CCC
3 9 Z +' +' +' +' +' +' +' +'` > # e@ e@ e@ e@ e@l e@ e@ e@P ! ! sE; 67!
eCHo ! ! ! !H 'BJy 1 1 (; <6 <6
38_<6
%S/ "<6 5c?
# <6
%S/ " <6 E,' (
<6 <6 <6 <6 <6 <6 <6r