HEX
Server: Apache/2.4.58 (Ubuntu)
System: Linux srvntsweb01 6.8.0-55-generic #57-Ubuntu SMP PREEMPT_DYNAMIC Wed Feb 12 23:42:21 UTC 2025 x86_64
User: admntserv (1000)
PHP: 8.3.6
Disabled: NONE
Upload Files
File: //snap/certbot/5370/lib/python3.12/site-packages/packaging/__pycache__/version.cpython-312.pyc
�

���i�Z�
�*�dZddlmZddlZddlZddlZddlmZmZmZm	Z	m
Z
mZmZm
Z
ddlmZmZmZmZej&rddlmZmZej.dk\rdd	lmZnej&rdd	lmZnddlZddlZd6d
�Zddd
d
d
ddd�Zgd�Zee
eefdfZ e
eeeeeffZ!e
eee
eeefeee
eefffdffZ"eeeedfe!e!e!e"fZ#ee#e#ge$fZ%Gd�ded��Z&d7d�Z'Gd�de(�Z)Gd�d�Z*dZ+e+jYdd�jYdd �Z-ej\j^d!k(rej.d"ks7ej\j^d#k(rej.d$ksej.d%kre-ne+Z0	ejbd&ejd�Z3d8d'�Z4d9d(�Z5d:d)�Z6d;d*�Z7d<d+�Z8d=d,�Z9Gd-�d.e	�Z:Gd/�de*�Z;Gd0�d1e;�Z<						d>d2�Z=ejbd3�Z>d?d4�Z?														d@d5�Z@y)AzB
.. testsetup::

    from packaging.version import parse, Version
�)�annotationsN)�Any�Callable�Literal�
NamedTuple�SupportsInt�Tuple�	TypedDict�Union�)�Infinity�InfinityType�NegativeInfinity�NegativeInfinityType)�Self�Unpack)��
)�
deprecatedc���d�fd�}|S)Nc�H���tj��d��fd��}|S)Nc�L��tj�td���|i|��S)N�)�category�
stacklevel)�warnings�warn�DeprecationWarning)�args�kwargs�func�messages  ����/build/snapcraft-certbot-817459ae66b3942307a8b35b87e7f45e/parts/certbot/install/lib/python3.12/site-packages/packaging/version.py�wrapperz/_deprecated.<locals>.decorator.<locals>.wrapper)s*����
�
��/� ��
�T�,�V�,�,�)r�objectr r&�returnr&)�	functools�wraps)r!r$r"s` �r#�	decoratorz_deprecated.<locals>.decorator(s%���
�_�_�T�
"�
-�#�
-��Nr%)r!r&r'r&�)r"r*s` r#�_deprecatedr,'s���
	��r%�a�b�rc�post)�alpha�beta�c�pre�preview�rev�r)�VERSION_PATTERN�InvalidVersion�Version�parse.c�J�eZdZUded<ded<ded<ded<ded<d	ed
<y)�_VersionReplace�
int | None�epochztuple[int, ...] | None�release�*tuple[Literal['a', 'b', 'rc'], int] | Noner4r0�dev�
str | None�localN��__name__�
__module__�__qualname__�__annotations__r+r%r#r=r=Us%����
#�#�	3�3�
��	�O��r%r=F)�totalr:c��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.
    )r:)�versions r#r;r;^s���7��r%c��eZdZdZy)r9z�Raised 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%r#r9r9js��r%r9c�r�eZdZdZej
r	edd��Zdd�Zd
d�Z	d
d�Z
dd�Zd
d�Zd
d�Z
dd	�Zy
)�_BaseVersionr+c��y�Nr+��selfs r#�_keyz_BaseVersion._key|s��+.r%c�,�t|j�SrR)�hashrUrSs r#�__hash__z_BaseVersion.__hash__s���D�I�I��r%c�`�t|t�stS|j|jkSrR��
isinstancerP�NotImplementedrU�rT�others  r#�__lt__z_BaseVersion.__lt__��%���%��.�!�!��y�y�5�:�:�%�%r%c�`�t|t�stS|j|jkSrRrZr]s  r#�__le__z_BaseVersion.__le__��%���%��.�!�!��y�y�E�J�J�&�&r%c�`�t|t�stS|j|jk(SrRrZr]s  r#�__eq__z_BaseVersion.__eq__�rcr%c�`�t|t�stS|j|jk\SrRrZr]s  r#�__ge__z_BaseVersion.__ge__�rcr%c�`�t|t�stS|j|jkDSrRrZr]s  r#�__gt__z_BaseVersion.__gt__�r`r%c�`�t|t�stS|j|jk7SrRrZr]s  r#�__ne__z_BaseVersion.__ne__�rcr%N)r'ztuple[Any, ...]�r'�int)r^rPr'�bool)r^r&r'rn)rFrGrH�	__slots__�typing�
TYPE_CHECKING�propertyrUrXr_rbrergrirkr+r%r#rPrPtsC���I�
���	�.�
�.��&�'�'�'�&�'r%rPa1
    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)rrvr)rrvz[a-z0-9]+(?:[._-][a-z0-9]+)*c�\�|xsd}t|t�r|dk\r|Sd|��}t|��)Nrz(epoch must be non-negative integer, got �r[rmr9)�valuer?�msgs   r#�_validate_epochr}�s7���J�Q�E��%���%�1�*���4�U�G�
<�C�
��
�r%c��|�dn|}t|t�r"t|�dkDrtd�|D��r|Sd|��}t	|��)N)rrc3�JK�|]}t|t�xr|dk\���y�w)rN)r[rm��.0�is  r#�	<genexpr>z$_validate_release.<locals>.<genexpr>�s#����?�!�
�1�c�"�-�q�A�v�-�?�s�!#z@release must be a non-empty tuple of non-negative integers, got )r[�tuple�len�allr9)r{r@r|s   r#�_validate_releaser��sM���m�d��G��7�E�"���L�1���?�w�?�?���L�W�I�
V�C�
��
�r%c��|�|St|t�r2t|�dk(r$|ddvrt|dt�r
|ddk\r|Sd|��}t	|��)Nrr)r-r.r/rz=pre must be a tuple of ('a'|'b'|'rc', non-negative int), got )r[r�r�rmr9�r{r|s  r#�
_validate_prer�sc���}����5�%� ���J�!�O��!�H�(�(��u�Q�x��%��!�H��M���I�%��
Q�C�
��
�r%c�\�|�|St|t�r	|dk\rd|fSd|��}t|��)Nrr0z'post must be non-negative integer, got rzr�s  r#�_validate_postr�s=���}����%���%�1�*�����3�E�7�
;�C�
��
�r%c�\�|�|St|t�r	|dk\rd|fSd|��}t|��)NrrBz&dev must be non-negative integer, got rzr�s  r#�
_validate_devr�s=���}����%���%�1�*��u�~��2�5�'�
:�C�
��
�r%c��|�|St|t�r tj|�rt	|�Sd|��}t|��)Nz*local must be a valid version string, got )r[�str�_LOCAL_PATTERN�	fullmatch�_parse_local_versionr9r�s  r#�_validate_localr�#sE���}����%���.�":�":�5�"A�#�E�*�*�6�u�i�
@�C�
��
�r%c�J�eZdZUded<ded<ded<ded<ded<d	ed
<y)�_Versionrmr?�tuple[int, ...]r@�tuple[str, int] | NonerBr4r0�LocalType | NonerDNrEr+r%r#r�r�-s%���J�
��	��	��
 � ��r%r�c�d�eZdZUdZdZdZejdezdzejejz�Zded<ded<d	ed
<d	ed<d	ed<d
ed<ded<d)d�Z
d*d�Zed+d��Zeed�d,d���Zej&ed�d-d���Zd.d�Zd.d�Zed.d��Zed/d��Zed0d��Zed1d��Zed2d��Zed2d��Zed3d��Zed.d ��Zed.d!��Zed4d"��Zed4d#��Z ed4d$��Z!ed/d%��Z"ed/d&��Z#ed/d'��Z$y()5r: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*rmr�r�r�r�r�r�r�r�r�z
CmpKey | Noner�c���|jj|�}|std|����|jd�rt	|jd��nd|_t
tt|jd�jd���|_	t|jd�|jd��|_t|jd�|jd	�xs|jd
��|_t|jd�|jd��|_
t|jd
��|_d|_y)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: r?rr@�.�pre_l�pre_n�post_l�post_n1�post_n2�dev_l�dev_nrDN)�_regexr�r9�grouprmr�r��map�splitr��_parse_letter_versionr�r�r�r�r�r�)rTrL�matchs   r#�__init__zVersion.__init__\s�����%�%�g�.��� �#4�W�K�!@�A�A�38�;�;�w�3G�c�%�+�+�g�.�/�Q����c�#�u�{�{�9�'=�'C�'C�C�'H�I�J��
�)�%�+�+�g�*>����G�@T�U��	�*��K�K��!�5�;�;�y�#9�#S�U�[�[��=S�
��
�*�%�+�+�g�*>����G�@T�U��	�*�5�;�;�w�+?�@�����r%c���d|vrt|d�n|j}d|vrt|d�n|j}d|vrt	|d�n|j
}d|vrt
|d�n|j}d|vrt|d�n|j}d|vrt|d�n|j}||jk(rM||jk(r>||j
k(r/||jk(r ||jk(r||jk(r|S|jj|j�}d|_||_||_||_||_||_	||_|S)Nr?r@r4r0rBrD)r}r�r�r�r�r�r�r�r�r�r�r��	__class__�__new__r�)	rTr r?r@r4r0rBrD�new_versions	         r#�__replace__zVersion.__replace__vsS��4;�v�4E���w��0�4�;�;���F�"�
�f�Y�/�0����	�
/4�v�o�m�F�5�M�*�4�9�9��17�6�1A�~�f�V�n�-�t�z�z��.3�v�o�m�F�5�M�*�4�9�9��4;�v�4E���w��0�4�;�;��
�T�[�[� ��4�=�=�(��t�y�y� ���
�
�"��t�y�y� �����$��K��n�n�,�,�T�^�^�<��!%���"���&������ ������"����r%c���|j�Qt|j|j|j|j
|j|j�|_|jSrR)r��_cmpkeyr�r�r�r�r�r�rSs r#rUzVersion._key�sN���?�?�"�%�����
�
��	�	��
�
��	�	����
�D�O����r%z4Version._version is private and will be removed soonc��t|j|j|j|j|j
|j�SrR)r�r�r�r�r�r�r�rSs r#�_versionzVersion._version�s6����K�K�����	�	�4�9�9�d�j�j�$�+�+�
�	
r%c���|j|_|j|_|j|_|j|_|j|_	|j|_d|_yrR)
r?r�r@r�rBr�r4r�r0r�rDr�r�)rTr{s  r#r�zVersion._version�sM���k�k����
�
��
��I�I��	��I�I��	��Z�Z��
��k�k�����r%c��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+rSs r#�__repr__zVersion.__repr__�s���D�6��%�%r%c��djtt|j��}|jr|j�d|��}|j
�,|djtt|j
��z
}|j�|d|j��z
}|j�|d|j��z
}|j�|d|j��z
}|S)z}A string representation of the version that can be round-tripped.

        >>> str(Version("1.0a5"))
        '1.0a5'
        r��!�z.postz.dev�+)	�joinr�r�r@r?r4r0rBrD)rTrLs  r#�__str__zVersion.__str__�s����(�(�3�s�D�L�L�1�2���:�:�����A�g�Y�/�G��8�8���r�w�w�s�3����1�2�2�G��9�9� ���t�y�y�k�*�*�G��8�8����d�h�h�Z�(�(�G��:�:�!���4�:�:�,�'�'�G��r%c��t|�S)z Internal property for match_args�r�rSs r#r�zVersion._str�s���4�y�r%c��|jS)zThe epoch of the version.

        >>> Version("2.0.0").epoch
        0
        >>> Version("1!2.0.0").epoch
        1
        )r�rSs r#r?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.
        )r�rSs r#r@zVersion.release�s���}�}�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)
        )r�rSs r#r4zVersion.pre�s���y�y�r%c�<�|jr|jdSdS)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�rSs r#r0zVersion.posts��!%�
�
�t�z�z�!�}�4��4r%c�<�|jr|jdSdS)z�The development number of the version.

        >>> print(Version("1.2.3").dev)
        None
        >>> Version("1.2.3.dev1").dev
        1
        rN)r�rSs r#rBzVersion.devs�� $�y�y�t�y�y��|�2�d�2r%c�`�|jr"djd�|jD��Sy)z�The local version segment of the version.

        >>> print(Version("1.2.3").local)
        None
        >>> Version("1.2.3+abc").local
        'abc'
        r�c3�2K�|]}t|����y�wrRr�)r��xs  r#r�z Version.local.<locals>.<genexpr>,s����8�q�C��F�8�s�N)r�r�rSs r#rDz
Version.local"s'���;�;��8�8�8�D�K�K�8�8�8�r%c�>�t|�jdd�dS)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�rSs r#�publiczVersion.public0s���4�y���s�A�&�q�)�)r%c��djtt|j��}|jr|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?)rT�release_segments  r#�base_versionzVersion.base_version=s>���(�(�3�s�D�L�L�#9�:��48�J�J�$�*�*��Q��/�0�S�O�Sr%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)rBr4rSs r#�
is_prereleasezVersion.is_prereleaseNs!���x�x�t�#�;�t�x�x�t�';�;r%c��|jduS)z�Whether this version is a post-release.

        >>> Version("1.2.3").is_postrelease
        False
        >>> Version("1.2.3.post1").is_postrelease
        True
        N)r0rSs r#�is_postreleasezVersion.is_postrelease_s���y�y��$�$r%c��|jduS)z�Whether this version is a development release.

        >>> Version("1.2.3").is_devrelease
        False
        >>> Version("1.2.3.dev1").is_devrelease
        True
        N)rBrSs r#�
is_devreleasezVersion.is_devreleasejs���x�x�t�#�#r%c�T�t|j�dk\r|jdSdS)zqThe first item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").major
        1
        rr�r�r@rSs r#�majorz
Version.majorus'��#&�d�l�l�"3�q�"8�t�|�|�A��?�a�?r%c�T�t|j�dk\r|jdSdS)z�The second item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").minor
        2
        >>> Version("1").minor
        0
        rrrr�rSs r#�minorz
Version.minor~�'��#&�d�l�l�"3�q�"8�t�|�|�A��?�a�?r%c�T�t|j�dk\r|jdSdS)z�The third item of :attr:`release` or ``0`` if unavailable.

        >>> Version("1.2.3").micro
        3
        >>> Version("1").micro
        0
        rrrr�rSs r#�microz
Version.micro�r�r%N)rLr�r'�None)r zUnpack[_VersionReplace]r'r)r'�CmpKey)r'r�)r{r�r'r�)r'r�rl�r'r�)r'r�)r'r>)r'rC)r'rn)%rFrGrHrNro�__match_args__�re�compiler8�VERBOSE�
IGNORECASEr�rIr�r�rrrUr,r��setterr�r�r�r?r@r4r0rBrDr�r�r�r�r�r�r�r�r+r%r#r:r:6s
���.X�I��N�
�R�Z�Z���0�6�9�2�:�:��
�
�;U�
V�F��K���
 � �
 � �!�!������4�B�
��
���G�H�
�I��
�
�_�_��G�H��I���&��>���������
��
������5��5��3��3������
*��
*��T��T� �<��<� �%��%��$��$��@��@��@��@��@��@r%c�:��eZdZdZd�fd�Zed�fd��Z�xZS)�_TrimmedReleaser+c�4��t|t�rx|j|_|j|_|j|_|j
|_|j|_|j|_|j|_yt�|�)|�yrR)r[r:r�r�r�r�r�r�r��superr�)rTrLr�s  �r#r�z_TrimmedRelease.__init__�sn����g�w�'�!�.�.�D�K�#�,�,�D�M����D�I����D�I� ���D�J�!�.�.�D�K�%�0�0�D�O��
����!r%c���t�|�}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,)
        rrN)r�r@r�)rT�rel�len_releaser�r�s    �r#r@z_TrimmedRelease.release�si����g�o���#�h�����!�e��A��E�
�a��
��F�A��!�e��A��E�
�a���;�&�s�3�C���G�3r%)rLz
str | Versionr'r�r�)rFrGrHror�rrr@�
__classcell__)r�s@r#r�r��s!����I�
"��4��4r%r�c��|r7|j�}tj||�}|t|xsd�fS|r
dt|�fSy)Nrr0)�lower�_LETTER_NORMALIZATION�getrm)�letter�numbers  r#r�r��sS��������
'�*�*�6�6�:���s�6�;�Q�'�'�'�
��s�6�{�"�"�r%z[\._-]c�R�|�%td�tj|�D��Sy)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Nc3�rK�|]/}|j�s|j�n
t|����1y�wrR)�isdigitr�rm)r��parts  r#r�z'_parse_local_version.<locals>.<genexpr>�s/����
��!%����D�J�J�L�C��I�=�
�s�57)r��_local_version_separatorsr�)rDs r#r�r��s4��
���
�1�7�7��>�
�
�	
�r%c��t|�}|}|r||dz
dk(r|dz}|r||dz
dk(r�||k(r|n|d|}|�|�	|�t}	n|�t}	n|}	|�t}
n|}
|�t}n|}|�t}ntd�|D��}|||	|
||fS)Nrrc3�TK�|] }t|t�r|dfnt|f���"y�w)r�N)r[rmrr�s  r#r�z_cmpkey.<locals>.<genexpr>s-����
�IJ�z�!�S�)�Q��G�0@�!�/D�D�
�s�&()r�rr
r�)
r?r@r4r0rBrDr�r�r�r�r�r�r�s
             r#r�r��s����g�,�K��A�
���A���!�#�	�Q������A���!�#��{�*�w�����H��{�t�|���"2��

�������|�#3�����{�"*�����}�/���
�NS�
�
���(�D�%��v�5�5r%)r"r�r'r&)rLr�r'r:)r{r&r'rm)r{r&r'r�)r{r&r'rA)r{r&r'z"tuple[Literal['post'], int] | None)r{r&r'z!tuple[Literal['dev'], int] | None)r{r&r'r�)r�rCr�z str | bytes | SupportsInt | Noner'r�)rDrCr'r�)r?rmr@r�r4r�r0r�rBr�rDr�r'r�)ArN�
__future__rr��sysrprrrrrr	r
r�_structuresr
rrrrq�typing_extensionsrr�version_inforrr,r(r��__all__rmr��	LocalType�CmpPrePostDevType�CmpLocalTyper�rn�VersionComparisonMethodr=r;�
ValueErrorr9rP�_VERSION_PATTERN�replace�_VERSION_PATTERN_OLD�implementation�namer8r�r�r�r}r�r�r�r�r�r�r:r�r�r�r�r�r+r%r#�<module>rs����#�	�
�
�	�	�	�X�W�	���.����w��2����;���
�"��	
����	���D���%��S��/�3�&�'�	��,�(<�e�C��H�o�M�N����	�%��c�3�h���';�U�3��8�_�'L�!M�M�
N�PS�
S�T�V���
��	�#�s�(�O������
��#�F�F�#3�T�#9�:���i�u��	��Z��3'�3'�t"��H(�/�/��c�:�B�B�4��M��	�����9�,��1A�1A�J�1N������6�)�c�.>�.>��.L�
���'�!��
��	�����;�R�]�]�K���	������z��\@�l�\@�~
4�g�4�D��� @����0'�B�J�J�y�1��	�:6��:6�
�:6�
 �:6�!�	:6�

 �:6��
:6��:6r%