i= e4 d Z ddlZddlZddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZmZmZmZmZ e deeef ee ef Zedegef Z edd Z d
ed efd Z d
Z G d d Z e Z dS )z6Version handling by a semver compatible version class. N)wraps) AnyDictIterableOptional SupportsIntTupleUnioncastCallable
CollectionTypeTypeVar ) VersionTuple VersionDictVersionIteratorString VersionPartVersionT)boundoperatorreturnc ^ t dddt dt f fd }|S )z0Wrap a Version binary op method in a type-check.selfr otherr c t t t t gt j R }t
|| st S | | S N)r dicttuplelistr __args__
isinstanceNotImplemented)r r comparable_typesr s `/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/semver/version.pywrapperz _comparator..wrapper' sW
_
%!122 "! !xe$$$ )r
Comparablebool)r r( s ` r' _comparatorr, $ sO 8__
%i
%
%t
%
%
%
%
% _
% Nr) c | |k | |k z
S )z6Return negative if ab. abs r' _cmpr2 7 s
Ea!e r) c t e Zd ZdZdZ ed eD Z ej d Z dZ
ej e
dd ej Z
ej e
dd ej Z dFd ed ed
edeeeef deeeef f
dZed Zedefd Zej d Zedefd Zej d Zedefd Zej d Zedee fd Z e j d Z edee fd Z e j d Z de fd Z de!fd Z"de#fd Z$e%d e de fd! Z&dGd"Z'dGd#Z(dGd$Z)dHd&ee dd fd'Z*dId&ee dd fd(Z+d)e,defd*Z-dHd+e d,e dd fd-Z.e/d)e,de0fd. Z1e/d)e,de0fd/ Z2e/d)e,de0fd0 Z3e/d)e,de0fd1 Z4e/d)e,de0fd2 Z5e/d)e,de0fd3 Z6d4eee7f deeee e8eee f d5f f fd6Z9de fd7Z:de fd8Z;defd9Ze dJd>e?e@ d?ed@e0de@fdA ZAdBeeee f dd fdCZBed?e de0fdD ZCd)d de0fdEZDd
S )Kr a
A semver compatible version class.
See specification at https://semver.org.
:param major: version when you make incompatible API changes.
:param minor: version when you add functionality in a backwards-compatible manner.
:param patch: version when you make backwards-compatible bug fixes.
:param prerelease: an optional prerelease string
:param build: an optional build string
)_major_minor_patch _prerelease_buildc " g | ] }|d d
S )r Nr. ).0items r'
zVersion.L s 22248222r) z(?:[^\d]*(\d+)[^\d]*)+a3
^
(?P0|[1-9]\d*)
(?:
\.
(?P0|[1-9]\d*)
(?:
\.
(?P0|[1-9]\d*)
){opt_patch}
){opt_minor}
(?:-(?P
(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)
(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*
))?
(?:\+(?P
[0-9a-zA-Z-]+
(?:\.[0-9a-zA-Z-]+)*
))?
$
) opt_patch opt_minor?r Nmajorminorpatch
prereleasebuildc t | t | t | d}| D ]-\ }}|dk r"t d | .|d | _ |d | _ |d | _ |d nt | | _ |d nt | | _ d S )N)rA rB rC r z1{!r} is negative. A version can only be positive.rA rB rC )
intitems
ValueErrorformatr4 r5 r6 strr7 r8 ) r rA rB rC rD rE
version_partsnamevalues r' __init__zVersion.__init__q s #&e**s5zzCPUJJWW
(..00 KD%qyy GNNtTT
$G, #G, #G, #-#5443z?? #mddU r) c H d }|pd|pd}}| d | d }}d |D }d |D }t || D ]\ }} ||| }|dk r|c S t t | t | S )Nc t | t r%t |t rt | | S t | t rdS t |t rdS t | | S )Nr )r$ rG r2 r/ s r' cmp_prerelease_tagz,Version._nat_cmp..cmp_prerelease_tag so !S!!
"jC&8&8
"Aqzz!As##
"rAs##
"qAqzz!r) r= .c Z g | ](}t j d | rt | n|)S z^\d+$rematchrG r: xs r' r< z$Version._nat_cmp.. 3 KKKaRXh 2 293q666KKKr) c Z g | ](}t j d | rt | n|)S rV rW rZ s r' r< z$Version._nat_cmp.. r\ r) r )splitzipr2 len) clsr0 r1 rS a_partsb_partssub_asub_b
cmp_results r' _nat_cmpzVersion._nat_cmp s " " " wBR1 773<< KK7KKKKK7KKK 1 1 ( (LE5++E599JQ!!!! AA'' 'r) r c | j S )z(The major part of a version (read-only).)r4 r s r' rA z
Version.major {r) c t d )Nz attribute 'major' is readonlyAttributeErrorr rN s r' rA z
Version.major <===r) c | j S )z(The minor part of a version (read-only).)r5 ri s r' rB z
Version.minor rj r) c t d )Nz attribute 'minor' is readonlyrl rn s r' rB z
Version.minor ro r) c | j S )z(The patch part of a version (read-only).)r6 ri s r' rC z
Version.patch rj r) c t d )Nz attribute 'patch' is readonlyrl rn s r' rC z
Version.patch ro r) c | j S )z-The prerelease part of a version (read-only).)r7 ri s r' rD zVersion.prerelease s
r) c t d )Nz"attribute 'prerelease' is readonlyrl rn s r' rD zVersion.prerelease s ABBBr) c | j S )z(The build part of a version (read-only).)r8 ri s r' rE z
Version.build rj r) c t d )Nz attribute 'build' is readonlyrl rn s r' rE z
Version.build ro r) c B | j | j | j | j | j fS )a[
Convert the Version object to a tuple.
.. versionadded:: 2.10.0
Renamed :meth:`Version._astuple` to :meth:`Version.to_tuple` to
make this function available in the public API.
:return: a tuple with all the parts
>>> semver.Version(5, 3, 1).to_tuple()
(5, 3, 1, None, None)
rA rB rC rD rE ri s r' to_tuplezVersion.to_tuple s
DJ
DOTZPPr) c z t j d| j fd| j fd| j fd| j fd| j ff S )a
Convert the Version object to an OrderedDict.
.. versionadded:: 2.10.0
Renamed :meth:`Version._asdict` to :meth:`Version.to_dict` to
make this function available in the public API.
:return: an OrderedDict with the keys in the order ``major``, ``minor``,
``patch``, ``prerelease``, and ``build``.
>>> semver.Version(3, 2, 1).to_dict()
OrderedDict([('major', 3), ('minor', 2), ('patch', 1), ('prerelease', None), ('build', None)])
rA rB rC rD rE ) collections OrderedDictrA rB rC rD rE ri s r' to_dictzVersion.to_dict sP &$*%$*%$*% t/$*%
r) c # > K | E d{V dS )zReturn iter(self).N)rz ri s r' __iter__zVersion.__iter__ s, ==??"""""""""r) stringc H t j | }|rt t | d dz }| d \ }}| dt |t | z
| |z | |d z } | S )a
Look for the last sequence of number(s) in a string and increment.
:param string: the string to search for.
:return: the incremented string
Source:
http://code.activestate.com/recipes/442460-increment-numbers-in-a-string/#c1
r N) r _LAST_NUMBERsearchrK rG groupspanmaxr` )r rY next_startends r' _increment_stringzVersion._increment_string s $++F33 SEKKNN++a/00E A JE3 :c#E
"2E : : :;eCfSTTlRF
r) c F t | } || j dz S )a2
Raise the major part of the version, return a new object but leave self
untouched.
:return: new object with the raised major part
>>> ver = semver.parse("3.4.5")
>>> ver.bump_major()
Version(major=4, minor=0, patch=0, prerelease=None, build=None)
r )typer4 r ra s r'
bump_majorzVersion.bump_major
s% 4jjs4;?###r) c R t | } || j | j dz S )a2
Raise the minor part of the version, return a new object but leave self
untouched.
:return: new object with the raised minor part
>>> ver = semver.parse("3.4.5")
>>> ver.bump_minor()
Version(major=3, minor=5, patch=0, prerelease=None, build=None)
r )r r4 r5 r s r'
bump_minorzVersion.bump_minor s) 4jjs4; a000r) c ^ t | } || j | j | j dz S )a2
Raise the patch part of the version, return a new object but leave self
untouched.
:return: new object with the raised patch part
>>> ver = semver.parse("3.4.5")
>>> ver.bump_patch()
Version(major=3, minor=4, patch=6, prerelease=None, build=None)
r )r r4 r5 r6 r s r'
bump_patchzVersion.bump_patch& s- 4jjs4; T[1_===r) rctokenc t | }| j | j }n |dk rd}n|d}nt | dz }| | } || j | j | j | S )a
Raise the prerelease part of the version, return a new object but leave
self untouched.
:param token: defaults to ``'rc'``
:return: new :class:`Version` object with the raised prerelease part.
The original object is not modified.
>>> ver = semver.parse("3.4.5")
>>> ver.bump_prerelease().prerelease
'rc.2'
>>> ver.bump_prerelease('').prerelease
'1'
>>> ver.bump_prerelease(None).prerelease
'rc.1'
Nr= 0zrc.0.0)r r7 rK r r4 r5 r6 )r r ra rD s r' bump_prereleasezVersion.bump_prerelease4 s} " 4jj ' )JJ
b[[ JJ
] JJ Ud*J**:66
s4; T[*EEEr) c v t | }| j | j }n |dk rd}n|d}nt | dz }| | }| j | j }n |dk rd}n|d}nt | dz }| | } || j | j | j | j | S )a
Raise the build part of the version, return a new object but leave self
untouched.
:param token: defaults to ``'build'``
:return: new :class:`Version` object with the raised build part.
The original object is not modified.
>>> ver = semver.parse("3.4.5-rc.1+build.9")
>>> ver.bump_build()
Version(major=3, minor=4, patch=5, prerelease='rc.1', build='build.10')
Nr= r zbuild.0r )r r8 rK r r4 r5 r6 r7 )r r ra rE s r'
bump_buildzVersion.bump_buildR s 4jj ; "KEE
b[[EE
] EEJJ%E %%e,, ; "KEE
b[[EE
] EEJJ%E %%e,,s4; T[$:JERRRr) r c j t | }t |t j r| | }nwt |t
r |di |}nYt |t t f r || }n7t || s't d|j dt | |
dd }|
dd }t || }|r|S | j |j }}|
|| }|sdS |sdS |sdS |S ) a
Compare self with other.
:param other: the second version
:return: The return value is negative if ver1 < ver2,
zero if ver1 == ver2 and strictly positive if ver1 > ver2
>>> semver.compare("2.0.0")
-1
>>> semver.compare("1.0.0")
1
>>> semver.compare("2.0.0")
0
>>> semver.compare(dict(major=2, minor=0, patch=0))
0
z+Expected str, bytes, dict, tuple, list, or z instance, but got N r r rR r. )r r$ r r# parser r! r" TypeError__name__rz r2 rD rg ) r r ra v1v2r[ rc1rc2rccmps r' comparezVersion.comparey s_ " 4jj eV_ - -
IIe$$EE
t
$
$ CLL%LLEE
t}
-
- CKEEE3'' )cl ) ) ;;) )
]]__RaR
^^
bqb
! RLL H?E$4S
c3'' 1 1 2 r) partprerelease_tokenc t | }|j dd }||vrt d| d| | }|j s|j rN|dk s1|dk r |j dk s |dk r1|j |j cxk rdk rn n| dd S ||j dd
v r t |d |z S |j s| }|
| S ) a
Determines next version, preserving natural order.
.. versionadded:: 2.10.0
This function is taking prereleases into account.
The "major", "minor", and "patch" raises the respective parts like
the ``bump_*`` functions. The real difference is using the
"prerelease" part. It gives you the next patch version of the
prerelease, for example:
>>> str(semver.parse("0.1.4").next_version("prerelease"))
'0.1.5-rc.1'
:param part: One of "major", "minor", "patch", or "prerelease"
:param prerelease_token: prefix string of prerelease, defaults to 'rc'
:return: new object with the appropriate part raised
NrR z Invalid part. Expected one of z
, but got rC rB r rA )rD rE r bump_) r NAMESrI rD rE rC rB replacegetattrr r )r r r ra
validpartsversions r' next_versionzVersion.next_version s1 & 4jjYss^
z ! ! OOOtOO
@'- @ GOOGMQ$6$6GMW]$G$G$G$Ga$G$G$G$G$G??d$??? ? 39RaR= 377GdN3355 5! + ((**G&&'7888r) c 4 | | dk S Nr r r r s r' __eq__zVersion.__eq__ ||E""a''r) c 4 | | dk S r r r s r' __ne__zVersion.__ne__ r r) c 4 | | dk S r r r s r' __lt__zVersion.__lt__ ||E""Q&&r) c 4 | | dk S r r r s r' __le__zVersion.__le__ r r) c 4 | | dk S r r r s r' __gt__zVersion.__gt__ r r) c 4 | | dk S r r r s r' __ge__zVersion.__ge__ r r) index.c
t |t rt ||dz }t t | }t |t r|j |j dk s|j |j dk rt
d t t d t t |
| }t | dk r|d S |st
d |S )a[
self.__getitem__(index) <==> self[index] Implement getitem.
If the part requested is undefined, or a part of the range requested
is undefined, it will throw an index error.
Negative indices are not supported.
:param index: a positive integer indicating the
offset or a :func:`slice` object
:raises IndexError: if index is beyond the range or a part is None
:return: the requested part of the version at position index
>>> ver = semver.Version.parse("3.4.5")
>>> ver[0], ver[1], ver[2]
(3, 4, 5)
r Nr z Version index cannot be negativec
| d uS r r. )ps r' z%Version.__getitem__..
s
Qd] r) zVersion part undefined) r$ rG slicer r stop
IndexErrorr! filterr rz r` )r r r s r' __getitem__zVersion.__getitem__ s & eS ! ! ,%++EUE""
ue $ $ A(U[1__
&5:>> ?@@ @ **D4==??5;Q,R,R S S
t99>>7N 7 566 6 r) c d d | D }t | j d|dS )N, c 3 * K | ]\ }}|d |V dS )=Nr. )r: keyvals r' z#Version.__repr__.. s1 RRxsCcc*RRRRRRr) ())joinr~ rH r r )r ss r' __repr__zVersion.__repr__ sT IIRR4<<>>;O;O;Q;QRRR R R ::...22r) c d| j | j | j fz }| j r
|d| j z z
}| j r
|d| j z z
}|S )Nz%d.%d.%dz-%sz+%sry )r r s r' __str__zVersion.__str__ sT
DJ
CC ? / ut. .G : * utz) )Gr) c T t | d d S )N )hashrz ri s r' __hash__zVersion.__hash__ s! DMMOOBQB'(((r) c X t | } || j | j | j S )z
Remove any prerelease and build metadata from the version.
:return: a new instance with the finalized version string
>>> str(semver.Version.parse('1.2.3-rc.5').finalize_version())
'1.2.3'
)r rA rB rC r s r' finalize_versionzVersion.finalize_version" s) 4jjs4:tz4:666r)
match_exprc |dd }|dv r |dd }nB|r |d dv r|d }|dd }n#|r|d dv rd}|}nt d |z d
d d d
ddd}|| }| | }||v S )a
Compare self to match a match expression.
:param match_expr: optional operator and version; valid operators are
``<`` smaller than
``>`` greater than
``>=`` greator or equal than
``<=`` smaller or equal than
``==`` equal
``!=`` not equal
:return: True if the expression matches the version, otherwise False
>>> semver.Version.parse("2.0.0").match(">=1.0.0")
True
>>> semver.Version.parse("1.0.0").match(">1.0.0")
False
>>> semver.Version.parse("4.0.4").match("4.0.4")
True
N )>=<===!=r )>, where is one of ['<', '>', '==', '<=', '>=', '!=']. You provided: %r)r )rR )r )rR r )r r )rR r )r r r r r r )rI r )r r prefix
match_versionpossibilities_dict
possibilitiescmp_ress r' rY z
Version.match. s ( BQB - - - &qrrNMM
q Z//AYF &qrrNMM
JqM\ 9 9F &MM # &00
+62
,,}---''r) Fra r optional_minor_and_patchc t |t r| d }n9t |t j s t dt
| z |r| j | }n| j | }|t | d | }|d sd|d< |d sd|d< | di |S ) a
Parse version string to a Version instance.
.. versionchanged:: 2.11.0
Changed method from static to classmethod to
allow subclasses.
.. versionchanged:: 3.0.0
Added optional parameter ``optional_minor_and_patch`` to allow
optional minor and patch parts.
:param version: version string
:param optional_minor_and_patch: if set to true, the version string to parse can contain optional minor and patch parts. Optional parts are set to zero.
By default (False), the version string to parse has to follow the semver
specification.
:return: a new :class:`Version` instance
:raises ValueError: if version is invalid
:raises TypeError: if version contains the wrong type
>>> semver.Version.parse('3.4.5-pre.2+build.4')
Version(major=3, minor=4, patch=5, prerelease='pre.2', build='build.4')
zUTF-8znot expecting type '%s'Nz is not valid SemVer stringrB r rC r. ) r$ bytesdecoder r# r r _REGEX_OPTIONAL_MINOR_AND_PATCHrY _REGEXrI groupdict)ra r r rY matched_version_partss r' r z
Version.parsea s 6 gu % % G nnW--GGGV_55 G 5W
EFF F # .7==gFFEEJ$$W--E = D D DEE E050A0A $W- /-. !' *$W- /-. !' *s++*+++r) partsc X | }| | t di |S # t $ rh t | t | z
}dt | d | fz }t | w xY w)a
Replace one or more parts of a version and return a new
:class:`Version` object, but leave self untouched
.. versionadded:: 2.9.0
Added :func:`Version.replace`
:param parts: the parts to be updated. Valid keys are:
``major``, ``minor``, ``patch``, ``prerelease``, or ``build``
:return: the new :class:`~semver.version.Version` object with
the changed parts
:raises TypeError: if ``parts`` contain invalid keys
z3replace() got %d unexpected keyword argument(s): %sr Nr. )r~ updater r setr` r )r r r unknownkeyserrors r' r zVersion.replace s ,,..u #%%W%% % # # # e**s4<<>>':'::KIK +&&M E E"" "
#s
7 A2B)c T | | dS # t $ r Y dS w xY w)ab
Check if the string is a valid semver version.
.. versionadded:: 2.9.1
.. versionchanged:: 3.0.0
Renamed from :meth:`~semver.version.Version.isvalid`
:param version: the version string to check
:return: True if the version string is a valid semver version, False
otherwise.
TF)r rI )ra r s r' is_validzVersion.is_valid s@ IIg 4 55 s
''c . t |t s t dt | d| j cxk r |j k rn n| dd |dd k rdS | j |j k o |j | j k o| j |j k S )aC
Check if current version is compatible with other version.
The result is True, if either of the following is true:
* both versions are equal, or
* both majors are equal and higher than 0. Same for both minors.
Both pre-releases are equal, or
* both majors are equal and higher than 0. The minor of b's
minor version is higher then a's. Both pre-releases are equal.
The algorithm does *not* check patches.
.. versionadded:: 3.0.0
:param other: the version to check for compatibility
:return: True, if ``other`` is compatible with the old version,
otherwise False
>>> Version(1, 1, 0).is_compatible(Version(1, 0, 0))
False
>>> Version(1, 0, 0).is_compatible(Version(1, 1, 0))
True
z Expected a Version type but got r Nr F)r$ r r r rA rB rD r s r'
is_compatiblezVersion.is_compatible s 2 %)) N LtE{{ L LMM M
* * * *u{ * * * * *bqbU2A2Y1F1F5 Z5;
&
6
*
6 E$44
r) )r r NN)r r )r )rE )F)Er
__module__ __qualname____doc__ __slots__r! r rX compiler _REGEX_TEMPLATErJ VERBOSEr r r r r
r rG rO classmethodrg propertyrA setterrB rC rK rD rE r rz r r~ r r staticmethodr r r r r r r* r r r, r+ r r r r r r r r r r r r r rY r r r r r r r. r) r' r r < s
HI
E22 222 3 3E 2: 788L O, RZ r ::
F
'1bj <<
' '# 37.2
< << < <
U63; /0 < fck*+
< < < <. ( ( [(, s X \> > \> s X \> > \> s X \> > \> HSM X C C C x} X \> > \>
Q,
Q
Q
Q
Q
2#/ # # # # # # \" $ $ $ $ 1 1 1 1 > > > > F FXc] Fi F F F F<%S %S
%SI %S %S %S %SN.Z .C . . . .`(9 (9 (9 (9y (9 (9 (9 (9T (J (4 ( ( ( [( (J (4 ( ( ( [( 'J '4 ' ' ' [' (J (4 ( ( ( [( 'J '4 ' ' ' [' (J (4 ( ( ( [(&3:&& sHSM5sCx #)=#>> ?& & & &P3# 3 3 3 3 )# ) ) ) )
7
7
7
71( 1( 1( 1( 1( 1(f HM,, ,,
!W,, %,,AE,,
,, ,, ,, [,,\#uS(3-%7 8 #Y # # # #4 s t [&$
9 $
$
$
$
$
$
$
r) )!r r| rX functoolsr typingr r r r r r r
r r r
r r _typesr r r r r rK r* r+
Comparatorr r, r2 r VersionInfor. r) r' r s < <
9d3 #3 4j6MsR
S
y*-t3
4
GCy!!!* &
f
f
f
f
f
f
f
f
T r)