a ifF? @sdZddlmZddlZddlZddlmZmZmZm Z m Z m Z ddl m Z mZmZmZgdZe e eefdfZe eee eeffZe ee e e eefe ee eefffdffZe ee edfeeeefZeeegefZGd d d eZd d d ddZGdddeZGdddZdZeZ Gdd d eZ!ddddddZ"e#dZ$ddddd Z%d!d"ddddd#d$d%d&Z&dS)'zB .. testsetup:: from packaging.version import parse, Version ) annotationsN)AnyCallable NamedTuple SupportsIntTupleUnion)Infinity InfinityTypeNegativeInfinityNegativeInfinityType)VERSION_PATTERNparseVersionInvalidVersion.c@s>eZdZUded<ded<ded<ded<ded<d ed <d S) _Versionintepochtuple[int, ...]releasetuple[str, int] | NonedevprepostLocalType | NonelocalN)__name__ __module__ __qualname____annotations__r!r!u/sparta/input/_build_configuration/image_build+validate/lib/bmcenv/lib64/python3.9/site-packages/packaging/version.pyr&s rstrrversionreturncCst|S)zParse the given version string. >>> parse('1.0.dev1') :param version: The version string to parse. :raises InvalidVersion: When the version string is not a valid version. )r)r%r!r!r"r/s rc@seZdZdZdS)rzRaised when a version string is not a valid version. >>> Version("invalid") Traceback (most recent call last): ... packaging.version.InvalidVersion: Invalid version: 'invalid' N)rrr__doc__r!r!r!r"r;src@seZdZUded<ddddZdddd d Zdddd d Zd ddddZdddddZdddddZ d ddddZ dS) _BaseVersionztuple[Any, ...]_keyrr&cCs t|jSN)hashr)selfr!r!r"__hash__Hsz_BaseVersion.__hash__bool)otherr&cCst|tstS|j|jkSr+ isinstancer(NotImplementedr)r.r1r!r!r"__lt__Ns z_BaseVersion.__lt__cCst|tstS|j|jkSr+r2r5r!r!r"__le__Ts z_BaseVersion.__le__objectcCst|tstS|j|jkSr+r2r5r!r!r"__eq__Zs z_BaseVersion.__eq__cCst|tstS|j|jkSr+r2r5r!r!r"__ge__`s z_BaseVersion.__ge__cCst|tstS|j|jkSr+r2r5r!r!r"__gt__fs z_BaseVersion.__gt__cCst|tstS|j|jkSr+r2r5r!r!r"__ne__ls z_BaseVersion.__ne__N) rrrr r/r6r7r9r:r;r<r!r!r!r"r(Es r(a v? (?: (?:(?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]+)?
        )?
    )
    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s^eZdZUdZededejejBZ	de
d<dddd	d
Zdddd
ZddddZ
eddddZeddddZeddddZeddddZeddddZedddd Zeddd!d"Zeddd#d$Zed%dd&d'Zed%dd(d)Zed%dd*d+Zeddd,d-Zeddd.d/Zeddd0d1Zd2S)3raThis 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#Noner$c
Cs|j|}|s td|dt|dr:t|dndtdd|ddDt|d	|d
t|d|dp|d
t|d|dt	|dd|_
t|j
j|j
j
|j
j|j
j|j
j|j
j|_dS)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: ''rrcss|]}t|VqdSr+)r.0ir!r!r"	z#Version.__init__..r.pre_lpre_npost_lpost_n1post_n2dev_ldev_nr)rrrrrrN)_regexsearchrrgrouprtuplesplit_parse_letter_version_parse_local_version_version_cmpkeyrrrrrrr))r.r%matchr!r!r"__init__s*zVersion.__init__r*cCsd|dS)zA representation of the Version that shows all internal state.

        >>> Version('1.0.0')
        
        z
r!r-r!r!r"__repr__szVersion.__repr__cCsg}|jdkr ||jd|ddd|jD|jdurb|ddd|jD|jdur~|d	|j|jdur|d
|j|jdur|d|jd|S)zA string representation of the version that can be rounded-tripped.

        >>> str(Version("1.0a5"))
        '1.0a5'
        r!rEcss|]}t|VqdSr+r#rAxr!r!r"rCrDz"Version.__str__..Ncss|]}t|VqdSr+rZr[r!r!r"rCrDz.postz.dev+)rappendjoinrrrrrr.partsr!r!r"__str__s




zVersion.__str__rcCs|jjS)zThe epoch of the version.

        >>> Version("2.0.0").epoch
        0
        >>> Version("1!2.0.0").epoch
        1
        )rTrr-r!r!r"rs	z
Version.epochrcCs|jjS)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.
        )rTrr-r!r!r"rszVersion.releasercCs|jjS)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)
        )rTrr-r!r!r"r&s
zVersion.prez
int | NonecCs|jjr|jjdSdS)zThe post-release number of the version.

        >>> print(Version("1.2.3").post)
        None
        >>> Version("1.2.3.post1").post
        1
        r	N)rTrr-r!r!r"r5s	zVersion.postcCs|jjr|jjdSdS)zThe development number of the version.

        >>> print(Version("1.2.3").dev)
        None
        >>> Version("1.2.3.dev1").dev
        1
        r	N)rTrr-r!r!r"r@s	zVersion.dev
str | NonecCs(|jjr ddd|jjDSdSdS)zThe local version segment of the version.

        >>> print(Version("1.2.3").local)
        None
        >>> Version("1.2.3+abc").local
        'abc'
        rEcss|]}t|VqdSr+rZr[r!r!r"rCUrDz Version.local..N)rTrr`r-r!r!r"rKs	z
Version.localcCst|dddS)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)r#rQr-r!r!r"publicYszVersion.publiccCsFg}|jdkr ||jd|ddd|jDd|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.
        rrYrEcss|]}t|VqdSr+rZr[r!r!r"rC{rDz'Version.base_version..r])rr_r`rrar!r!r"base_versionfs

zVersion.base_versionr0cCs|jdup|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)rrr-r!r!r"
is_prereleaseszVersion.is_prereleasecCs
|jduS)zWhether this version is a post-release.

        >>> Version("1.2.3").is_postrelease
        False
        >>> Version("1.2.3.post1").is_postrelease
        True
        N)rr-r!r!r"is_postreleases	zVersion.is_postreleasecCs
|jduS)zWhether this version is a development release.

        >>> Version("1.2.3").is_devrelease
        False
        >>> Version("1.2.3.dev1").is_devrelease
        True
        N)rr-r!r!r"
is_devreleases	zVersion.is_devreleasecCst|jdkr|jdSdS)zqThe first item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").major
        1
        r	rlenrr-r!r!r"majorsz
Version.majorcCst|jdkr|jdSdS)zThe second item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").minor
        2
        >>> Version("1").minor
        0
        r	rrjr-r!r!r"minors	z
Version.minorcCst|jdkr|jdSdS)zThe third item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").micro
        3
        >>> Version("1").micro
        0
        rmrrjr-r!r!r"micros	z
Version.microN)rrrr'recompilerVERBOSE
IGNORECASErMr rWrXrcpropertyrrrrrrrerfrgrhrirlrnrpr!r!r!r"rsD
&!






rdz str | bytes | SupportsInt | Noner)letternumberr&cCsv|rZ|durd}|}|dkr&d}n(|dkr4d}n|dvrBd}n|dvrNd	}|t|fS|sr|rrd	}|t|fSdS)
Nralphaabetab)crpreviewrc)revrr)lowerr)rvrwr!r!r"rRs"rRz[\._-]r)rr&cCs$|dur tddt|DSdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|s|nt|VqdSr+)isdigitrr)rApartr!r!r"rCsz'_parse_local_version..)rP_local_version_separatorsrQ)rr!r!r"rSs
rSrrr=)rrrrrrr&cCsttttddt|}|dur>|dur>|dur>t}n|durLt}n|}|dur^t}n|}|durpt}	n|}	|durt}
ntdd|D}
|||||	|
fS)NcSs|dkS)Nrr!)r\r!r!r"rDz_cmpkey..css(|] }t|tr|dfnt|fVqdS)r]N)r3rrr@r!r!r"rC/sz_cmpkey..)rPreversedlist	itertools	dropwhilerr
)rrrrrr_release_pre_post_dev_localr!r!r"rUs(
	rU)'r'
__future__rrrqtypingrrrrrr_structuresr
rrr
__all__rr#	LocalTypeCmpPrePostDevTypeCmpLocalTyper=r0VersionComparisonMethodrr
ValueErrorrr(_VERSION_PATTERNrrrRrrrrSrUr!r!r!r"sH *
	
0
'#