U
    j5{ièZ  ã                
   @  sþ  d Z ddlmZ ddlZddlZddlZddlmZmZmZm	Z	m
Z
mZmZmZ ddlmZmZmZmZ ejr~ddlmZmZ ejdkr–dd	lmZ n4ejrªdd	lmZ n ddlZddlZd
ddœdd„ZddddddddœZddddgZeeeef df Z eeeeeef f Z!eeeeeeef eeeeef f f df f Z"eeeedf e!e!e!e"f Z#ee#e#ge$f Z%G dd„ dedd�Z&d
ddœdd„Z'G dd„ de(ƒZ)G d d!„ d!ƒZ*d"Z+e+ ,d#d$¡ ,d%d&¡Z-ej.j/d'k�rèejd(k �sej.j/d)k�rejd*k �sejd+k �re-ne+Z0e 1d,ej2¡Z3dd-d.œd/d0„Z4dd1d.œd2d3„Z5dd4d.œd5d6„Z6dd7d.œd8d9„Z7dd:d.œd;d<„Z8dd=d.œd>d?„Z9G d@dA„ dAe	ƒZ:G dBd„ de*ƒZ;G dCdD„ dDe;ƒZ<dEdFdGdHœdIdJ„Z=e 1dK¡Z>dEd=dLœdMdN„Z?d-d1dGdGdGd=dOdPœdQdR„Z@dS )SzB
.. testsetup::

    from packaging.version import parse, Version
é    )ÚannotationsN)ÚAnyÚCallableÚLiteralÚ
NamedTupleÚSupportsIntÚTupleÚ	TypedDictÚUnioné   )ÚInfinityÚInfinityTypeÚNegativeInfinityÚNegativeInfinityType)ÚSelfÚUnpack)é   é   )Ú
deprecatedÚstrÚobject)ÚmessageÚreturnc                   s   dddœ‡ fdd„}|S )Nr   )Úfuncr   c                   s&   t  ˆ ¡ddddœ‡ ‡fdd„ƒ}|S )Nr   )ÚargsÚkwargsr   c                    s   t jˆtdd� ˆ | |ŽS )Né   )ÚcategoryÚ
stacklevel)ÚwarningsÚwarnÚDeprecationWarning)r   r   )r   r   © ú5/tmp/pip-unpacked-wheel-gcvfa7ey/packaging/version.pyÚwrapper)   s    ýz/_deprecated.<locals>.decorator.<locals>.wrapper)Ú	functoolsÚwraps)r   r$   ©r   )r   r#   Ú	decorator(   s    z_deprecated.<locals>.decoratorr"   )r   r(   r"   r'   r#   Ú_deprecated'   s    r)   ÚaÚbÚrcÚpost)ÚalphaÚbetaÚcÚpreÚpreviewÚrevÚrÚVERSION_PATTERNÚInvalidVersionÚVersionÚparse.c                   @  s>   e Zd ZU ded< ded< ded< ded< ded< d	ed
< dS )Ú_VersionReplaceú
int | NoneÚepochztuple[int, ...] | NoneÚreleaseú,tuple[Literal[('a', 'b', 'rc')], int] | Noner1   r-   Údevú
str | NoneÚlocalN©Ú__name__Ú
__module__Ú__qualname__Ú__annotations__r"   r"   r"   r#   r9   U   s   
r9   F)Útotal©Úversionr   c                 C  s   t | ƒS )z×Parse the given version string.

    >>> parse('1.0.dev1')
    <Version('1.0.dev1')>

    :param version: The version string to parse.
    :raises InvalidVersion: When the version string is not a valid version.
    )r7   )rH   r"   r"   r#   r8   ^   s    	c                   @  s   e Zd ZdZdS )r6   zÉRaised when a version string is not a valid version.

    >>> Version("invalid")
    Traceback (most recent call last):
        ...
    packaging.version.InvalidVersion: Invalid version: 'invalid'
    N)rB   rC   rD   Ú__doc__r"   r"   r"   r#   r6   j   s   c                   @  s–   e Zd ZdZejr$eddœdd„ƒZddœdd„Zd d	d
œdd„Z	d d	d
œdd„Z
dd	d
œdd„Zd d	d
œdd„Zd d	d
œdd„Zdd	d
œdd„ZdS )Ú_BaseVersionr"   ztuple[Any, ...]©r   c                 C  s   d S ©Nr"   ©Úselfr"   r"   r#   Ú_key|   s    z_BaseVersion._keyÚintc                 C  s
   t | jƒS rL   )ÚhashrO   rM   r"   r"   r#   Ú__hash__   s    z_BaseVersion.__hash__Úbool)Úotherr   c                 C  s   t |tƒstS | j|jk S rL   ©Ú
isinstancerJ   ÚNotImplementedrO   ©rN   rT   r"   r"   r#   Ú__lt__…   s    
z_BaseVersion.__lt__c                 C  s   t |tƒstS | j|jkS rL   rU   rX   r"   r"   r#   Ú__le__‹   s    
z_BaseVersion.__le__r   c                 C  s   t |tƒstS | j|jkS rL   rU   rX   r"   r"   r#   Ú__eq__‘   s    
z_BaseVersion.__eq__c                 C  s   t |tƒstS | j|jkS rL   rU   rX   r"   r"   r#   Ú__ge__—   s    
z_BaseVersion.__ge__c                 C  s   t |tƒstS | j|jkS rL   rU   rX   r"   r"   r#   Ú__gt__�   s    
z_BaseVersion.__gt__c                 C  s   t |tƒstS | j|jkS rL   rU   rX   r"   r"   r#   Ú__ne__£   s    
z_BaseVersion.__ne__N)rB   rC   rD   Ú	__slots__ÚtypingÚTYPE_CHECKINGÚpropertyrO   rR   rY   rZ   r[   r\   r]   r^   r"   r"   r"   r#   rJ   t   s   rJ   a1  
    v?+                                                   # optional leading v
    (?:
        (?:(?P<epoch>[0-9]+)!)?+                          # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*+)                 # release segment
        (?P<pre>                                          # pre-release
            [._-]?+
            (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc)
            [._-]?+
            (?P<pre_n>[0-9]+)?
        )?+
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [._-]?
                (?P<post_l>post|rev|r)
                [._-]?
                (?P<post_n2>[0-9]+)?
            )
        )?+
        (?P<dev>                                          # dev release
            [._-]?+
            (?P<dev_l>dev)
            [._-]?+
            (?P<dev_n>[0-9]+)?
        )?+
    )
    (?:\+
        (?P<local>                                        # local version
            [a-z0-9]+
            (?:[._-][a-z0-9]+)*+
        )
    )?+
z*+Ú*z?+ú?Úcpython)r   é   é   Úpypy)r   rf   r   )r   rf   z[a-z0-9]+(?:[._-][a-z0-9]+)*rP   ©Úvaluer   c                C  s4   | pd}t |tƒr|dkr|S d|› �}t|ƒ‚d S )Nr   z(epoch must be non-negative integer, got ©rV   rP   r6   )rj   r;   Úmsgr"   r"   r#   Ú_validate_epochî   s
    
rm   útuple[int, ...]c                C  sR   | d krdn| }t |tƒr<t|ƒdkr<tdd„ |D ƒƒr<|S d|› �}t|ƒ‚d S )N)r   r   c                 s  s    | ]}t |tƒo|d kV  qdS )r   N)rV   rP   ©Ú.0Úir"   r"   r#   Ú	<genexpr>û   s     z$_validate_release.<locals>.<genexpr>z@release must be a non-empty tuple of non-negative integers, got )rV   ÚtupleÚlenÚallr6   )rj   r<   rl   r"   r"   r#   Ú_validate_releaseö   s    ÿ
þý
rv   r=   c                C  sb   | d kr| S t | tƒrLt| ƒdkrL| d dkrLt | d tƒrL| d dkrL| S d| › �}t|ƒ‚d S )Nr   r   )r*   r+   r,   r   z=pre must be a tuple of ('a'|'b'|'rc', non-negative int), got )rV   rs   rt   rP   r6   ©rj   rl   r"   r"   r#   Ú_validate_pre  s    ÿ
þ
ýü
û
rx   z"tuple[Literal['post'], int] | Nonec                C  s<   | d kr| S t | tƒr&| dkr&d| fS d| › �}t|ƒ‚d S )Nr   r-   z'post must be non-negative integer, got rk   rw   r"   r"   r#   Ú_validate_post  s    
ry   z!tuple[Literal['dev'], int] | Nonec                C  s<   | d kr| S t | tƒr&| dkr&d| fS d| › �}t|ƒ‚d S )Nr   r>   z&dev must be non-negative integer, got rk   rw   r"   r"   r#   Ú_validate_dev  s    
rz   úLocalType | Nonec                C  s>   | d kr| S t | tƒr(t | ¡r(t| ƒS d| ›�}t|ƒ‚d S )Nz*local must be a valid version string, got )rV   r   Ú_LOCAL_PATTERNÚ	fullmatchÚ_parse_local_versionr6   rw   r"   r"   r#   Ú_validate_local#  s    
r   c                   @  s>   e Zd ZU ded< ded< ded< ded< ded< d	ed
< dS )Ú_VersionrP   r;   rn   r<   útuple[str, int] | Noner>   r1   r-   r{   r@   NrA   r"   r"   r"   r#   r€   -  s   
r€   c                   @  s  e Zd ZU dZdZdZe de d ej	ej
B ¡Zded< ded< d	ed
< d	ed< d	ed< ded< ded< dddœdd„Zdddœdd„Zeddœdd„ƒZeedƒd dœd!d"„ƒƒZejedƒd dd#œd$d"„ƒƒZddœd%d&„Zddœd'd(„Zeddœd)d*„ƒZeddœd+d,„ƒZeddœd-d.„ƒZed	dœd/d0„ƒZed1dœd2d3„ƒZed1dœd4d5„ƒZed6dœd7d8„ƒZeddœd9d:„ƒZeddœd;d<„ƒZed=dœd>d?„ƒZed=dœd@dA„ƒZ ed=dœdBdC„ƒZ!eddœdDdE„ƒZ"eddœdFdG„ƒZ#eddœdHdI„ƒZ$dJS )Kr7   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
    <Version('1.0a5')>
    >>> v2
    <Version('1.0')>
    >>> v1 < v2
    True
    >>> v1 == v2
    False
    >>> v1 > v2
    False
    >>> v1 >= v2
    False
    >>> v1 <= v2
    True
    )Ú_devÚ_epochÚ
_key_cacheÚ_localÚ_postÚ_preÚ_release)Ú_strz\s*rP   rƒ   rn   rˆ   r�   r‚   r‡   r†   r{   r…   zCmpKey | Noner„   r   ÚNonerG   c                 C  sÄ   | j  |¡}|std|›�ƒ‚| d¡r6t| d¡ƒnd| _ttt| d¡ d¡ƒƒ| _	t
| d¡| d¡ƒ| _t
| d¡| d	¡pŒ| d
¡ƒ| _t
| d¡| d¡ƒ| _t| d¡ƒ| _d| _dS )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.
        zInvalid version: r;   r   r<   Ú.Úpre_lÚpre_nÚpost_lÚpost_n1Úpost_n2Údev_lÚdev_nr@   N)Ú_regexr}   r6   ÚgrouprP   rƒ   rs   ÚmapÚsplitrˆ   Ú_parse_letter_versionr‡   r†   r‚   r~   r…   r„   )rN   rH   Úmatchr"   r"   r#   Ú__init__\  s     ÿzVersion.__init__zUnpack[_VersionReplace]r   )r   r   c           	      K  s  d|krt |d ƒn| j}d|kr.t|d ƒn| j}d|krHt|d ƒn| j}d|krbt|d ƒn| j}d|kr|t|d ƒn| j	}d|kr–t
|d ƒn| j}|| jkrÜ|| jkrÜ|| jkrÜ|| jkrÜ|| j	krÜ|| jkrÜ| S | j | j¡}d |_||_||_||_||_||_	||_|S )Nr;   r<   r1   r-   r>   r@   )rm   rƒ   rv   rˆ   rx   r‡   ry   r†   rz   r‚   r   r…   Ú	__class__Ú__new__r„   )	rN   r   r;   r<   r1   r-   r>   r@   Znew_versionr"   r"   r#   Ú__replace__v  s>    ÿýÿþýüûúzVersion.__replace__ÚCmpKeyrK   c                 C  s0   | j d kr*t| j| j| j| j| j| jƒ| _ | j S rL   )r„   Ú_cmpkeyrƒ   rˆ   r‡   r†   r‚   r…   rM   r"   r"   r#   rO   —  s    
úzVersion._keyz4Version._version is private and will be removed soonr€   c                 C  s   t | j| j| j| j| j| jƒS rL   )r€   rƒ   rˆ   r‚   r‡   r†   r…   rM   r"   r"   r#   Ú_version¤  s         ÿzVersion._versionri   c                 C  s:   |j | _|j| _|j| _|j| _|j| _	|j
| _d | _d S rL   )r;   rƒ   r<   rˆ   r>   r‚   r1   r‡   r-   r†   r@   r…   r„   )rN   rj   r"   r"   r#   rŸ   «  s    c                 C  s   d| › d�S )z€A representation of the Version that shows all internal state.

        >>> Version('1.0.0')
        <Version('1.0.0')>
        z
<Version('z')>r"   rM   r"   r"   r#   Ú__repr__¶  s    zVersion.__repr__c                 C  sš   d  tt| jƒ¡}| jr(| j› d|› �}| jdk	rH|d  tt| jƒ¡7 }| jdk	rb|d| j› �7 }| jdk	r||d| j› �7 }| jdk	r–|d| j› �7 }|S )z}A string representation of the version that can be round-tripped.

        >>> str(Version("1.0a5"))
        '1.0a5'
        r‹   ú!NÚ z.postz.devú+)	Újoinr•   r   r<   r;   r1   r-   r>   r@   ©rN   rH   r"   r"   r#   Ú__str__¾  s    



zVersion.__str__c                 C  s   t | ƒS )z Internal property for match_args©r   rM   r"   r"   r#   r‰   Ý  s    zVersion._strc                 C  s   | j S )zThe epoch of the version.

        >>> Version("2.0.0").epoch
        0
        >>> Version("1!2.0.0").epoch
        1
        )rƒ   rM   r"   r"   r#   r;   â  s    	zVersion.epochc                 C  s   | 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ˆ   rM   r"   r"   r#   r<   í  s    zVersion.releasec                 C  s   | 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‡   rM   r"   r"   r#   r1   ý  s    zVersion.prer:   c                 C  s   | j r| j d S dS )z™The post-release number of the version.

        >>> print(Version("1.2.3").post)
        None
        >>> Version("1.2.3.post1").post
        1
        r   N)r†   rM   r"   r"   r#   r-     s    	zVersion.postc                 C  s   | j r| j d S dS )z•The development number of the version.

        >>> print(Version("1.2.3").dev)
        None
        >>> Version("1.2.3.dev1").dev
        1
        r   N)r‚   rM   r"   r"   r#   r>     s    	zVersion.devr?   c                 C  s$   | j rd dd„ | j D ƒ¡S dS dS )zŸThe local version segment of the version.

        >>> print(Version("1.2.3").local)
        None
        >>> Version("1.2.3+abc").local
        'abc'
        r‹   c                 s  s   | ]}t |ƒV  qd S rL   r§   )rp   Úxr"   r"   r#   rr   ,  s     z Version.local.<locals>.<genexpr>N)r…   r¤   rM   r"   r"   r#   r@   "  s    	zVersion.localc                 C  s   t | ƒ dd¡d S )zÝThe 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'
        r£   r   r   )r   r–   rM   r"   r"   r#   Úpublic0  s    zVersion.publicc                 C  s,   d  tt| jƒ¡}| jr(| j› d|› �S |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‹   r¡   )r¤   r•   r   r<   r;   )rN   Zrelease_segmentr"   r"   r#   Úbase_version=  s    zVersion.base_versionrS   c                 C  s   | j dk	p| jdk	S )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>   r1   rM   r"   r"   r#   Úis_prereleaseN  s    zVersion.is_prereleasec                 C  s
   | j dk	S )zªWhether this version is a post-release.

        >>> Version("1.2.3").is_postrelease
        False
        >>> Version("1.2.3.post1").is_postrelease
        True
        N)r-   rM   r"   r"   r#   Úis_postrelease_  s    	zVersion.is_postreleasec                 C  s
   | j dk	S )z®Whether this version is a development release.

        >>> Version("1.2.3").is_devrelease
        False
        >>> Version("1.2.3.dev1").is_devrelease
        True
        N)r>   rM   r"   r"   r#   Úis_devreleasej  s    	zVersion.is_devreleasec                 C  s   t | jƒdkr| jd S dS )zqThe first item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").major
        1
        r   r   ©rt   r<   rM   r"   r"   r#   Úmajoru  s    zVersion.majorc                 C  s   t | jƒdkr| jd S dS )z›The second item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").minor
        2
        >>> Version("1").minor
        0
        r   r   r   r®   rM   r"   r"   r#   Úminor~  s    	zVersion.minorc                 C  s   t | jƒdkr| jd S dS )zšThe third item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").micro
        3
        >>> Version("1").micro
        0
        r   r   r   r®   rM   r"   r"   r#   Úmicro‰  s    	zVersion.microN)%rB   rC   rD   rI   r_   Z__match_args__ÚreÚcompiler5   ÚVERBOSEÚ
IGNORECASEr“   rE   r™   rœ   rb   rO   r)   rŸ   Úsetterr    r¦   r‰   r;   r<   r1   r-   r>   r@   r©   rª   r«   r¬   r­   r¯   r°   r±   r"   r"   r"   r#   r7   6  sj   
!	





c                      s>   e Zd ZdZdddœ‡ fdd„Zeddœ‡ fd	d
„ƒZ‡  ZS )Ú_TrimmedReleaser"   zstr | VersionrŠ   rG   c                   sV   t |tƒrF|j| _|j| _|j| _|j| _|j| _|j| _|j| _d S t	ƒ  
|¡ d S rL   )rV   r7   rƒ   rˆ   r‚   r‡   r†   r…   r„   Úsuperr™   r¥   ©rš   r"   r#   r™   ˜  s    
z_TrimmedRelease.__init__rn   rK   c                   sN   t ƒ j}t|ƒ}|}|dkr6||d  dkr6|d8 }q||krB|S |d|… S )z°
        Release segment without any trailing zeros.

        >>> _TrimmedRelease('1.0.0').release
        (1,)
        >>> _TrimmedRelease('0.0').release
        (0,)
        r   r   N)r¸   r<   rt   )rN   ÚrelÚlen_releaserq   r¹   r"   r#   r<   ¤  s    
z_TrimmedRelease.release)rB   rC   rD   r_   r™   rb   r<   Ú__classcell__r"   r"   r¹   r#   r·   •  s   r·   r?   z str | bytes | SupportsInt | Noner�   )ÚletterÚnumberr   c                 C  s<   | r(|   ¡ } t | | ¡} | t|p"dƒfS |r8dt|ƒfS d S )Nr   r-   )ÚlowerÚ_LETTER_NORMALIZATIONÚgetrP   )r½   r¾   r"   r"   r#   r—   ·  s    r—   z[\._-])r@   r   c                 C  s$   | dk	r t dd„ t | ¡D ƒƒS dS )zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Nc                 s  s&   | ]}|  ¡ s| ¡ nt|ƒV  qd S rL   )Úisdigitr¿   rP   )rp   Úpartr"   r"   r#   rr   ×  s   ÿz'_parse_local_version.<locals>.<genexpr>)rs   Ú_local_version_separatorsr–   )r@   r"   r"   r#   r~   Ò  s
    þr~   r�   )r;   r<   r1   r-   r>   r@   r   c                 C  sÆ   t |ƒ}|}|r*||d  dkr*|d8 }q||kr6|n
|d |… }|d kr`|d kr`|d k	r`t}	n|d krnt}	n|}	|d kr€t}
n|}
|d kr’t}n|}|d kr¤t}ntdd„ |D ƒƒ}| ||	|
||fS )Nr   r   c                 s  s(   | ] }t |tƒr|d fnt|fV  qdS )r¢   N)rV   rP   r   ro   r"   r"   r#   rr     s    z_cmpkey.<locals>.<genexpr>)rt   r   r   rs   )r;   r<   r1   r-   r>   r@   r»   rq   rˆ   r‡   r†   r‚   r…   r"   r"   r#   rž   Þ  s,    

	ÿrž   )ArI   Ú
__future__r   r²   Úsysr`   r   r   r   r   r   r   r	   r
   Ú_structuresr   r   r   r   ra   Ztyping_extensionsr   r   Úversion_infor   r   r)   r%   rÀ   Ú__all__rP   r   Z	LocalTypeZCmpPrePostDevTypeZCmpLocalTyper�   rS   ZVersionComparisonMethodr9   r8   Ú
ValueErrorr6   rJ   Z_VERSION_PATTERNÚreplaceZ_VERSION_PATTERN_OLDÚimplementationÚnamer5   r³   rµ   r|   rm   rv   rx   ry   rz   r   r€   r7   r·   r—   rÄ   r~   rž   r"   r"   r"   r#   Ú<module>   s–   (
ù
*ÿÿ
ûÿ	
:$
ÿÿ
þþýû		
	  a"
