KicddZddlmZddlZddlZddlZddlmZmZmZm Z m Z m Z m Z m Z ejrddlmZmZej$dk\rddlmZnejrddlmZn ddlZddlZddZ#d?dZ$Gdde%Z&GddZ'dZ(e(jSddjSdd Z*ejVjXd!k(rej$d"ks7ejVjXd#k(rej$d$ksej$d%kre*ne(Z- ej\d&ej^ej`zZ1e2d'Z3d@d(Z4dAd)Z5dBd*Z6dCd+Z7dDd,Z8dEd-Z9Gd.d/e Z:Gd0de'Z;Gd1d2e;Z< dFd3Z=ej\d4Z>dGd5Z?dd6d7d8Z@d9ZAd:ZBd9ZCeBdddd6dfZD dHd;ZEy)IzZ .. testsetup:: from packaging.version import parse, normalize_pre, Version, _cmpkey ) annotationsN)AnyCallableLiteral NamedTuple SupportsIntTuple TypedDictUnion)SelfUnpack) ) deprecatedcdfd }|S)NcHtjdfd }|S)NcLtjtd|i|S)N)category stacklevel)warningswarnDeprecationWarning)argskwargsfuncmessages ]/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/packaging/version.pywrapperz/_deprecated..decorator..wrapper's* /  T,V,,)robjectrr!returnr!) functoolswraps)rrrs` r decoratorz_deprecated..decorator&s% __T " -# -Nr )rzCallable[[...], object]r"r!)rr%s` r _deprecatedr'%s r abrcpost)alphabetacprepreviewrevr)VERSION_PATTERNInvalidVersionVersion normalize_preparsectSN)__all__r&r r__dir__r;Bs Nr .cJeZdZUded<ded<ded<ded<ded<d ed <y ) _VersionReplace int | Noneepochztuple[int, ...] | Nonereleasetuple[str, int] | Noner/r+dev str | NonelocalN__name__ __module__ __qualname____annotations__r&r rr=r=Qs%  ##   O r r=F)totalcN|j}tj||S)a8Normalize the pre-release segment of a version string. Returns a lowercase version of the string if not a known pre-release identifier. >>> normalize_pre('alpha') 'a' >>> normalize_pre('BETA') 'b' >>> normalize_pre('rc') 'rc' :param letter: .. versionadded:: 26.1 )lower_LETTER_NORMALIZATIONget)letters rr6r6Zs""\\^F $ $VV 44r r5ct|S)aParse the given version string. This is identical to the :class:`Version` constructor. >>> parse('1.0.dev1') :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. )r5)versions rr7r7os 7 r ceZdZdZy)r4zRaised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' N)rFrGrH__doc__r&r rr4r4}sr r4creZdZdZej r ed dZd dZd dZ d dZ ddZ d dZ d dZ dd Zy ) _BaseVersionr&cyr9r&selfs r_keyz_BaseVersion._keys+.r c,t|jSr9)hashrYrWs r__hash__z_BaseVersion.__hash__sDIIr c`t|tstS|j|jkSr9 isinstancerUNotImplementedrYrXothers r__lt__z_BaseVersion.__lt__%%.! !yy5::%%r c`t|tstS|j|jkSr9r^ras r__le__z_BaseVersion.__le__%%.! !yyEJJ&&r c`t|tstS|j|jk(Sr9r^ras r__eq__z_BaseVersion.__eq__rgr c`t|tstS|j|jk\Sr9r^ras r__ge__z_BaseVersion.__ge__rgr c`t|tstS|j|jkDSr9r^ras r__gt__z_BaseVersion.__gt__rdr c`t|tstS|j|jk7Sr9r^ras r__ne__z_BaseVersion.__ne__rgr N)r"ztuple[Any, ...]r"intrbrUr"boolrbr!r"rs)rFrGrH __slots__typing TYPE_CHECKINGpropertyrYr\rcrfrirkrmror&r rrUrUsCI  . . & ' ' ' & 'r rUa3 v?+ # optional leading v (?a: (?:(?P[0-9]+)!)?+ # epoch (?P[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]+)?
        )?+
    )
    (?a:\+
        (?P                                        # local version
            [a-z0-9]+
            (?:[._-][a-z0-9]+)*+
        )
    )?+
z*+*z?+?cpython)rpypy)rr|r)rr|z[a-z0-9]+(?:[._-][a-z0-9]+)*z.0123456789c\|xsd}t|tr|dk\r|Sd|}t|)Nrz(epoch must be non-negative integer, got r_rqr4)valuer?msgs   r_validate_epochr
s7JQE%%1*4UG
z$_validate_release..s#?!
1c"-qAv-?s!#z@release must be a non-empty tuple of non-negative integers, got )r_tuplelenallr4)rr@rs   r_validate_releasersMmdG7E"L1?w??LWI
VC

r c||St|tr;t|dk(r-|\}}t|}|dvrt|tr	|dk\r||fSd|}t|)Nr>r(r)r*rz=pre must be a tuple of ('a'|'b'|'rc', non-negative int), got )r_rrr6rqr4)rrOnumberrs    r
_validate_prersn}%CJ!Ov&%%*VS*AfPQkF##I%
QC

r c\||St|tr	|dk\rd|fSd|}t|)Nrr+z'post must be non-negative integer, got rrrs  r_validate_postr+s=}%%1*3E7
;C

r c\||St|tr	|dk\rd|fSd|}t|)NrrBz&dev must be non-negative integer, got rrs  r
_validate_devr4s=}%%1*u~25'
:C

r c||St|tr tj|rt	|Sd|}t|)Nz*local must be a valid version string, got )r_str_LOCAL_PATTERN	fullmatch_parse_local_versionr4rs  r_validate_localr=sE}%.":":5"A#E**6ui
@C

r cJeZdZUded<ded<ded<ded<d	ed
<ded<y
)_Versionrqr?tuple[int, ...]r@!tuple[Literal['dev'], int] | NonerB*tuple[Literal['a', 'b', 'rc'], int] | Noner/"tuple[Literal['post'], int] | Noner+LocalType | NonerDNrEr&r rrrGs%J
	**	33
,,r rceZdZUdZdZdZ	ejdezdzejejzZded<ded<d	ed
<ded<d
ed<ded<ded<ded<d7dZ
edddddd													d8dZd9dZed:dZd;dZd<fdZd<fdZd=fdZd<fd Zd<fd!Zd=fd"Zeed#d>d$Zej8ed#d?d%Zd@d&Zd@d'Zed@d(Zed;d)Z edAd*Z!edBd+Z"edCd,Z#edCd-Z$edDd.Z%ed@d/Z&ed@d0Z'edEd1Z(edEd2Z)edEd3Z*ed;d4Z+ed;d5Z,ed;d6Z-xZ.S)Fr5aThis 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

    :class:`Version` is immutable; use :meth:`__replace__` to change
    part of a version.
    )_dev_epoch_hash_cache
_key_cache_local_post_pre_release)_strz\s*rqrrrrrrrrrrrr>rz
CmpKey | Nonerctj|r`	ttt|jd|_d|_	d|_
d|_d|_d|_
d|_d|_y|j j#|}|std||j%drt	|j%dnd|_	ttt|j%djd|_t'|j%d|j%d	|_
t'|j%d
|j%dxs|j%d|_t'|j%d
|j%d|_t)|j%d|_
d|_d|_y#t$r$d|jdvrtd|dwxYw)aCInitialize 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: Nrr?r@pre_lpre_npost_lpost_n1post_n2dev_ldev_nrD)_SIMPLE_VERSION_INDICATORS
issupersetrmaprqsplitr
ValueErrorr4rrrrrrr_regexrgroup_parse_letter_versionr)rXrQmatchs   r__init__zVersion.__init__s&009	
 %c#w}}S/A&B C
DKDIDJDIDK"DO#D%%g. #4WK!@AA38;;w3Gc%++g./Qc#u{{9'='C'CC'HIJ
*%++g*>G@TU	*KK!5;;y#9#SU[[=S

*%++g*>G@TU	*5;;w+?@G
s++(+>> Version.from_parts(release=(1,2,3))
        
        >>> Version.from_parts(release=(0,1,0), pre=("b", 1))
        

        :param epoch:
        :param release: This version tuple is required

        .. versionadded:: 26.1
        N)rrrrrr__new__rrrrrrrr)clsr?r@r/r+rBrDrrrrrrnew_versions              r
from_partszVersion.from_partss8!'$W-%(_}S!$(,(8t$d%(_}S!$+0+<'$kk#&!%"&#'!#r cd|vrt|dn|j}d|vrt|dn|j}d|vrt	|dn|j
}d|vrt
|dn|j}d|vrt|dn|j}d|vrt|dn|j}||jk(rM||jk(r>||j
k(r/||jk(r ||jk(r||jk(r|S|jj|j}d|_d|_||_||_||_||_||_	||_|S)a
        __replace__(*, epoch=..., release=..., pre=..., post=..., dev=..., local=...)

        Return a new version with parts replaced.

        This returns a new version (unless no parts were changed). The
        pre-release is normalized. Setting a value to ``None`` clears it.

        >>> v = Version("1.2.3")
        >>> v.__replace__(pre=("a", 1))
        

        :param int | None epoch:
        :param tuple[int, ...] | None release:
        :param tuple[str, int] | None pre:
        :param int | None post:
        :param int | None dev:
        :param str | None local:

        .. versionadded:: 26.0
        .. versionchanged:: 26.1

           The pre-release portion is now normalized.
        r?r@r/r+rBrDN)rrrrrrrrrrrr	__class__rrr)	rXrr?r@r/r+rBrDrs	         r__replace__zVersion.__replace__s]25>> Version('1.0.0')
        
        <(z)>)rrFrrWs r__repr__zVersion.__repr__s(4>>**+1SYM<>> str(Version("1.0a5"))
        '1.0a5'
        r!rz.postz.dev+)	joinrrr@r?r/r+rBrD)rXrQs  r__str__zVersion.__str__s((3sDLL12::AgY/G88rwws3122G99 tyyk**G88dhhZ((G::!4::,''Gr ct|S)z Internal property for match_argsrrWs rrzVersion._str"s4yr c|jS)zThe epoch of the version.

        >>> Version("2.0.0").epoch
        0
        >>> Version("1!2.0.0").epoch
        1
        )rrWs rr?z
Version.epoch's{{r c|jS)adThe 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.
        )rrWs rr@zVersion.release2s}}r c|jS)aThe 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)
        )rrWs rr/zVersion.preBsyyr c<|jr|jdSdS)zThe post-release number of the version.

        >>> print(Version("1.2.3").post)
        None
        >>> Version("1.2.3.post1").post
        1
        N)rrWs rr+zVersion.postQs!%

tzz!}44r c<|jr|jdSdS)zThe development number of the version.

        >>> print(Version("1.2.3").dev)
        None
        >>> Version("1.2.3.dev1").dev
        1
        rN)rrWs rrBzVersion.dev\s $yytyy|2d2r c`|jr"djd|jDSy)zThe local version segment of the version.

        >>> print(Version("1.2.3").local)
        None
        >>> Version("1.2.3+abc").local
        'abc'
        rc32K|]}t|ywr9r)rxs  rrz Version.local..qs8qCF8sN)rrrWs rrDz
Version.localgs';;888DKK888r c>t|jdddS)aqThe public portion of the version.

        This returns a string. If you want a :class:`Version` again and care
        about performance, use ``v.__replace__(local=None)`` instead.

        >>> 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'
        rrr)rrrWs rpubliczVersion.publicus4ysA&q))r cdjtt|j}|jr|jd|S|S)aThe "base version" of the version.

        This returns a string. If you want a :class:`Version` again and care
        about performance, use
        ``v.__replace__(pre=None, post=None, dev=None, local=None)`` instead.

        >>> 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.
        rr)rrrr@r?)rXrelease_segments  rbase_versionzVersion.base_versions>$((3sDLL#9:48JJ$**Q/0SOSr c>|jduxs|jduS)aTWhether 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)rBr/rWs r
is_prereleasezVersion.is_prereleases!xxt#;txxt';;r c|jduS)zWhether this version is a post-release.

        >>> Version("1.2.3").is_postrelease
        False
        >>> Version("1.2.3.post1").is_postrelease
        True
        N)r+rWs ris_postreleasezVersion.is_postreleasesyy$$r c|jduS)zWhether this version is a development release.

        >>> Version("1.2.3").is_devrelease
        False
        >>> Version("1.2.3.dev1").is_devrelease
        True
        N)rBrWs r
is_devreleasezVersion.is_devreleasesxxt##r cTt|jdk\r|jdSdS)zqThe first item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").major
        1
        rrrr@rWs rmajorz
Version.majors'#&dll"3q"8t||A?a?r cTt|jdk\r|jdSdS)zThe second item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").minor
        2
        >>> Version("1").minor
        0
        rrrrrWs rminorz
Version.minor'#&dll"3q"8t||A?a?r cTt|jdk\r|jdSdS)zThe third item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").micro
        3
        >>> Version("1").micro
        0
        rrrrrWs rmicroz
Version.microrr )rQrr"None)r?rqr@rr/rAr+r>rBr>rDrCr"r)rzUnpack[_VersionReplace]r"r)r"CmpKeyrprrrt)r"r)rrr"r)r"rr"r)r"r)r"r>)r"rC)r"rs)/rFrGrHrSru__match_args__recompiler3VERBOSE
IGNORECASErrIrclassmethodrrrxrYr\rcrfrirkrmror'rsetterrrrr?r@r/r+rBrDrrrrrrrr
__classcell__rs@rr5r5Ps4	INRZZ0692::

;U
VFK
++
44--0 d&* ,,!	,
$,
,,,
,,\8t

$%6%6%6%6%6%6GH
I

__GH I =>

5533
*
*TT(<< %%$$@@@@@@r c:eZdZdZdfdZedfdZxZS)_TrimmedReleaser&c4t|trx|j|_|j|_|j|_|j
|_|j|_|j|_|j|_yt|)|yr9)r_r5rrrrrrrrr)rXrQrs  rrz_TrimmedRelease.__init__sngw'!..DK#,,DMDIDI DJ!..DK%00DO
!r ct|}t|}|}|dkDr!||dz
dk(r|dz}|dkDr||dz
dk(r||k(r|S|d|S)z
        Release segment without any trailing zeros.

        >>> _TrimmedRelease('1.0.0').release
        (1,)
        >>> _TrimmedRelease('0.0').release
        (0,)
        rrN)rr@r)rXrellen_releaserrs    rr@z_TrimmedRelease.releasesigo#h!eAE
a
FA!eAE
a;&s3CG3r )rQz
str | Versionr"rr)rFrGrHrurrxr@rrs@rrrs!I
"44r rc|r7|j}tj||}|t|xsdfS|r
dt|fSy)Nrr+)rLrMrNrq)rOrs  rrrsS
'**66:s6;Q'''
s6{""r z[\._-]cR|%tdtj|DSy)z`
    Takes a string like ``"abc.1.twelve"`` and turns it into
    ``("abc", 1, "twelve")``.
    Nc3rK|]/}|js|jn
t|1ywr9)isdigitrLrq)rparts  rrz'_parse_local_version..$s/
!%DJJLCI=
s57)r_local_version_separatorsr)rDs rrrs4


177>

	
r rr)r(r)r*rcvt|}|}|r||dz
dk(r|dz}|r||dz
dk(r||k(r|n|d|}||
||	||tfS|
||	td}
}	n|	td}
}	nt|d|d}
}	|dnd}|dn|d}|dnd}
|dn|d}|	|
|||
|f}||||fStd|D}||||fS)aBuild a comparison key for PEP 440 ordering.

    Returns ``(epoch, release, suffix)`` or
    ``(epoch, release, suffix, local)`` so that plain tuple
    comparison gives the correct order.

    Trailing zeros are stripped from the release so that ``1.0.0 == 1``.

    The suffix is a flat 6-int tuple that encodes pre/post/dev:
    ``(pre_rank, pre_n, post_rank, post_n, dev_rank, dev_n)``

    pre_rank: dev-only=-1, a=0, b=1, rc=2, no-pre=3
        Dev-only releases (no pre or post) get -1 so they sort before
        any alpha/beta/rc.  Releases without a pre-release tag get 3
        so they sort after rc.
    post_rank: no-post=0, post=1
        Releases without a post segment sort before those with one.
    dev_rank: dev=0, no-dev=1
        Releases without a dev segment sort after those with one.

    Local segments use ``(n, "")`` for ints and ``(-1, s)`` for strings,
    following PEP 440: strings sort before ints, strings compare
    lexicographically, ints compare numerically, and shorter segments
    sort before longer when prefixes match.  Versions without a local
    segment sort before those with one (3-tuple < 4-tuple).

    >>> _cmpkey(0, (1, 0, 0), None, None, None, None)
    (0, (1,), (3, 0, 0, 0, 1, 0))
    >>> _cmpkey(0, (1,), ("a", 1), None, None, None)
    (0, (1,), (0, 1, 0, 0, 1, 0))
    >>> _cmpkey(0, (1,), None, None, None, ("ubuntu", 1))
    (0, (1,), (3, 0, 0, 0, 1, 0), ((-1, 'ubuntu'), (1, '')))
    rrNc3TK|] }t|tr|dfnt|f"yw)rN)r_rq_LOCAL_STR_RANK)rsegs  rrz_cmpkey..s,$JMZS)b	/EE$s&()r_STABLE_SUFFIX_PRE_RANK_DEV_ONLY_PRE_RANK_STABLE	_PRE_RANKr)r?r@r/r+rBrDrrtrimmedpre_rankr	post_rankpost_ndev_rankrsuffix	cmp_locals                 rrr8s0Tg,KA
A!#	QA!#k)gwr{G{t|
g~--
{t|,a%	*A%#CF+SV%\qI,QDGFKqQHA#a&Ey&(E
BF}gv%%#$QV$I'69,,r )rrr"r!)r"z	list[str])rOrr"r)rQrr"r5)rr!r"rq)rr!r"r)rr!r"r)rr!r"r)rr!r"r)rr!r"r)rOrCrz str | bytes | SupportsInt | Noner"rA)rDrCr"r)r?rqr@rr/rAr+rArBrArDrr"r)FrS
__future__rrsysrvrrrrrr	r
rrwtyping_extensionsrr
version_inforrr'r#rMr:r;rqr	LocalTypeCmpLocalType	CmpSuffixrrsVersionComparisonMethodr=r6r7rr4rU_VERSION_PATTERNreplace_VERSION_PATTERN_OLDimplementationnamer3rrASCIIr	frozensetrrrrrrrrr5rrrrr!rr rrrr&r rr8s#	

			
.w2;
"	
	U
%S/3&'	U38_c)*#sCc3./			#uS#X	
)*	#uS#X	<
78:
#FF#3T#9:iu5*Z3'3't"H(//c:BB4M	9,1A1AJ1N6)c.>.>.L
'!
$;R]]RXX=UV'}5	
zN
@lN
@b4g4D @0'BJJy1
!1%	#Aq!Q2J-J-
J-
 J-!	J-

 J-
J-J-r