[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[a-z0-9]+(?:[-_\.][a-z0-9]+)*))? # local version
c e Zd ZU dZ ej dez dz ej ej z Z de
d< d"d
Z d#d Z d#d Z
ed$d Zed%d Zed&d Zed'd Zed'd Zed(d Zed#d Zed#d Zed)d Zed)d Zed)d Zed$d Zed$d Zed$d Z d!S )*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*$CmpKeyr. r& r' r( Nonec | j | }|st 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 r0 )r .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 groupr tuplesplit_parse_letter_version_parse_local_version_version_cmpkeyr r r r r r r. )r3 r& matchs r% __init__zVersion.__init__ s ""7++ B !@W!@!@AA A !/4{{7/C/CJ#ekk'**+++LL%++i*@*@*F*Fs*K*KLLLLL%ekk'&:&:EKK>> Version('1.0.0')
z
r# r2 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 ) z}A string representation of the version that can be round-tripped.
>>> str(Version("1.0a5"))
'1.0a5'
r !rT c 3 4 K | ]}t | V d S r0 r' rQ xs r% rS z"Version.__str__.. ( ; ;c!ff ; ; ; ; ; ;r$ N c 3 4 K | ]}t | V d S r0 rl rm s r% rS z"Version.__str__.. s( : :AQ : : : : : :r$ z.postz.dev+)r appendjoinr r r r r r3 partss r% __str__zVersion.__str__ s" :?? LLDJ))) * * * SXX ; ;dl ; ; ;;;<<< 8 LL : : : : ::: ; ; ; 9 LL,,, - - - 8 LL*** + + + : ! LL)TZ)) * * *wwu~~ r$ r c | j j S )zThe epoch of the version.
>>> Version("2.0.0").epoch
0
>>> Version("1!2.0.0").epoch
1
)rc r r2 s r% r z
Version.epoch s }""r$ 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.
)rc r r2 s r% r zVersion.release s }$$r$ r 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)
)rc r r2 s r% r z Version.pre& s } r$
int | Nonec 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)rc r r2 s r% r z Version.post5 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)rc r r2 s r% r z Version.dev@ s# (,}'8Bt} ##dBr$
str | Nonec 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'
rT c 3 4 K | ]}t | V d S r0 rl rm s r% rS z Version.local..U s( @@qCFF@@@@@@r$ N)rc r rt r2 s r% r z
Version.localK 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!1.2.3dev1+abc").public
'1!1.2.3.dev1'
rr r
r )r' r` r2 s r% publiczVersion.publicY 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.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 rj rT c 3 4 K | ]}t | V d S r0 rl rm s r% rS z'Version.base_version..{ ro r$ rp )r rs rt r ru s r% base_versionzVersion.base_versionf st :?? LLDJ))) * * * SXX ; ;dl ; ; ;;;<<<wwu~~ r$ r6 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 r2 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 r2 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 r2 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 r2 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 r2 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 r2 s r% microz
Version.micro r r$ N)r& r' r( rM )r( r' rJ r( r )r( r )r( r{ )r( r~ )r( r6 ) r r r! r+ recompiler VERBOSE
IGNORECASEr\ r" rf rh rw propertyr r r r r r r r r r r r r r r# r$ r% r r se . RZ/1G;RZ"-=W
X
XFLLL$
$
$
$
L& & & & B # # # X#
%
%
% X
% ! ! ! X ! E E E XE C C C XC X
*
*
* X
* X 0 < < < X< % % % X% $ $ $ X$ @ @ @ X@ @ @ @ X@ @ @ @ X@ @ @r$ c 0 e Zd Zed fd Z xZS )_TrimmedReleaser( r c t j }d t | D }t |d }|d|dz S )z
Release segment without any trailing zeros.
>>> _TrimmedRelease('1.0.0').release
(1,)
>>> _TrimmedRelease('0.0').release
(0,)
c 3 $ K | ] \ }}||V d S r0 r# )rQ indexvals r% rS z*_TrimmedRelease.release.. s+ BBjeScBEBBBBBBr$ r )defaultNr
)superr enumeratemax)r3 relnonzeros last_nonzero __class__s r% r z_TrimmedRelease.release sQ ggoBBIcNNBBB8Q/// %\A%%&&r$ r )r r r! r r
__classcell__)r s @r% r r sG
' ' ' ' ' X ' ' ' ' 'r$ r letterr~ number str | bytes | SupportsInt | Noner c | rH|d}| } | dk rd} n| dk rd} n
| dv rd} n| dv rd } | t | fS | rJ |rd } | t | fS d S )
Nr alphaabetab)cr previewrc)revrr )lowerr )r r s r% ra ra s # >F
W FF
v
FF
.
.
.FF
|
#
#Fs6{{"":
# s6{{"" 4r$ z[\._-]r 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$ )r_ _local_version_separatorsr` )r s r% rb rb sM
177>>
4r$ r r r r r r r rL 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# )rn s r% z_cmpkey.. s
AF r$ c 3 Z K | ]&}t |t r|d fnt |fV 'dS )rp N)r9 r r
rP s r% rS z_cmpkey..B sP
IJz!S)) DQGG0@!/D
r$ )r_ reversedlist itertools dropwhiler
r ) r r r r r r _release_pre_post_dev_locals r% rd rd s i)*:*:HWr s # " " " " " G G G G G G G G G G G G G G G G W W W W W W W W W W W W
C
C
C %S/3& ' ,( # b@ b@ b@ b@ b@l b@ b@ b@J ' ' ' ' 'g ' ' '"" " " "J 'BJy 1 1 ;6 ;6 ;6 ;6 ;6 ;6r$