Your IP : 216.73.217.13
�
�jx& � �� � d dl mZ d dlZd dlmZmZmZmZ ddlm Z m
Z
m Z ddl m
Z
mZmZ g d�Zd d�Zeed eeef f Z ed
e� Z G d � d e� Z G d
� de� Z G d� de� Z ej4 dej6 ej8 z � Z ej4 dej8 � Z ej4 dej8 � Z dd�d d�Z d d�Z!dd� d!d�Z"dd� d"d �Z#d#d �Z$y)$� )� annotationsN)�NewType�Tuple�Union�cast� )�Tag�UnsortedTagsError� parse_tag)�InvalidVersion�Version�_TrimmedRelease)
�BuildTag� InvalidName�InvalidSdistFilename�InvalidWheelFilename�NormalizedName�canonicalize_name�canonicalize_version�is_normalized_name�parse_sdist_filename�parse_wheel_filenamec � � t S )N)�__all__� � �/build/snapcraft-certbot-54d6d23c1eba5f776fc280588daee8b3/parts/certbot/install/lib/python3.12/site-packages/packaging/utils.py�__dir__r s � � �Nr r r c � � e Zd ZdZy)r zW
An invalid distribution name; users should refer to the packaging user guide.
N��__name__�
__module__� __qualname__�__doc__r r r r r ' � � �r r c � � e Zd ZdZy)r zM
An invalid wheel filename was found, users should refer to PEP 427.
Nr r r r r r - r% r r c � � e Zd ZdZy)r z^
An invalid sdist filename was found, users should refer to the packaging user guide.
Nr r r r r r 3 r% r r z%[a-z0-9]|[a-z0-9][a-z0-9._-]*[a-z0-9]z+[a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9]z (\d+)(.*)F)�validatec � � |r#t j | � st d| ��� �| j � j dd� j dd� }d|v r|j dd� }d|v r�t d|� S )a]
This function takes a valid Python package or extra name, and returns the
normalized form of it.
The return type is typed as :class:`NormalizedName`. This allows type
checkers to help require that a string has passed through this function
before use.
If **validate** is true, then the function will check if **name** is a valid
distribution name before normalizing.
:param str name: The name to normalize.
:param bool validate: Check whether the name is a valid distribution name.
:raises InvalidName: If **validate** is true and the name is not an
acceptable distribution name.
>>> from packaging.utils import canonicalize_name
>>> canonicalize_name("Django")
'django'
>>> canonicalize_name("oslo.concurrency")
'oslo-concurrency'
>>> canonicalize_name("requests")
'requests'
zname is invalid: �_�-�.z--r )�_validate_regex� fullmatchr �lower�replacer )�namer( �values r r r B s| � �2 ��1�1�$�7�� -�d�X�6�7�7�
�J�J�L� � ��c� *� 2� 2�3�� <�E�
�%�-��
�
�d�C�(�� �%�-� � �%� (�(r c �0 � t j | � duS )a7
Check if a name is already normalized (i.e. :func:`canonicalize_name` would
roundtrip to the same value).
:param str name: The name to check.
>>> from packaging.utils import is_normalized_name
>>> is_normalized_name("requests")
True
>>> is_normalized_name("Django")
False
N)�_normalized_regexr. )r1 s r r r g s � � � &� &�t� ,�D� 8�8r T)�strip_trailing_zeroc � � t | t � r t | � } t |rt | � � S | � S # t $ r t | � cY S w xY w)a Return a canonical form of a version as a string.
This function takes a string representing a package version (or a
:class:`~packaging.version.Version` instance), and returns the
normalized form of it. By default, it strips trailing zeros from
the release segment.
>>> from packaging.utils import canonicalize_version
>>> canonicalize_version('1.0.1')
'1.0.1'
Per PEP 625, versions may have multiple canonical forms, differing
only by trailing zeros.
>>> canonicalize_version('1.0.0')
'1'
>>> canonicalize_version('1.0.0', strip_trailing_zero=False)
'1.0.0'
Invalid versions are returned unaltered.
>>> canonicalize_version('foo bar baz')
'foo bar baz'
>>> canonicalize_version('1.4.0.0.0')
'1.4'
)�
isinstance�strr
r r )�versionr5 s r r r w sU � �< �'�3� � � �g�&�G� �+>��w�'� L�L�G� L�L�� � ��w�<� � �s � 9 �A�A��validate_orderc �� � | j d� st d| ��� �| dd } | j d� }|dvrt d| ��� �| j d|dz
� }|d }d
|v s%t j
d |t j � �t d | ��� �t |� } t |d
� }|dk( rc|d }t j |� } | �t d|� d| ��� �t dt | j d
� � | j d� f� }
nd}
|d } t | |�� } |||
| fS # t $ r}t d| ��� |�d}~ww xY w# t $ r t d| ��� d�w xY w)a
This function takes the filename of a wheel file, and parses it,
returning a tuple of name, version, build number, and tags.
The name part of the tuple is normalized and typed as
:class:`NormalizedName`. The version portion is an instance of
:class:`~packaging.version.Version`. The build number is ``()`` if
there is no build number in the wheel filename, otherwise a
two-item tuple of an integer for the leading digits and
a string for the rest of the build number. The tags portion is a
frozen set of :class:`~packaging.tags.Tag` instances (as the tag
string format allows multiple tags to be combined into a single
string).
If **validate_order** is true, compressed tag set components are
checked to be in sorted order as required by PEP 425.
:param str filename: The name of the wheel file.
:param bool validate_order: Check whether compressed tag set components
are in sorted order.
:raises InvalidWheelFilename: If the filename in question
does not follow the :ref:`wheel specification
<pypug:binary-distribution-format>`.
>>> from packaging.utils import parse_wheel_filename
>>> from packaging.tags import Tag
>>> from packaging.version import Version
>>> name, ver, build, tags = parse_wheel_filename("foo-1.0-py3-none-any.whl")
>>> name
'foo'
>>> ver == Version('1.0')
True
>>> tags == {Tag("py3", "none", "any")}
True
>>> not build
True
.. versionadded:: 26.1
The *validate_order* parameter.
z.whlz3Invalid wheel filename (extension must be '.whl'): N���r+ )� � z0Invalid wheel filename (wrong number of parts): � r �__z ^[\w\d._]*$zInvalid project name: r z*Invalid wheel filename (invalid version): r? zInvalid build number: z in r r ���r: z\Invalid wheel filename (compressed tag set components must be in sorted order per PEP 425): )�endswithr �count�split�re�match�UNICODEr r
r �_build_tag_regexr �int�groupr r
)
�filenamer; �dashes�parts� name_partr1 r9 �e�
build_part� build_match�build�tag_str�tagss
r r r � s� � �Z � � �V� $�"�A�(� � N�
�
� ���}�H�
�^�^�C�
�F�
�V��"�>�x�l� K�
�
�
�N�N�3���
� +�E��a��I� �y��B�H�H�^�Y��
�
� K� S�"�%;�H�<�#H�I�I� �Y� '�D���%��(�#�� ��{��1�X�
�&�,�,�Z�8� � � �&�(�� �D�� �E��
� �Z�#�k�&7�&7��&:�";�[�=N�=N�q�=Q�!R�S�����B�i�G���� �@��
�'�5�$� '�'��/ � �"�8�� � E�
�� ����$ � �"�*�*2� �
7�
� � ��s$ �%D6 �#
E �6 E�?E�E�E/c �b � | j d� r| dt d� }n/| j d� r| dt d� }nt d| ��� �|j d� \ }}}|st d| ��� �t |� } t |� }||fS # t $ r}t d| ��� |�d}~ww xY w)a�
This function takes the filename of a sdist file (as specified
in the `Source distribution format`_ documentation), and parses
it, returning a tuple of the normalized name and version as
represented by an instance of :class:`~packaging.version.Version`.
:param str filename: The name of the sdist file.
:raises InvalidSdistFilename: If the filename does not end
with an sdist extension (``.zip`` or ``.tar.gz``), or if it does not
contain a dash separating the name and the version of the distribution.
>>> from packaging.utils import parse_sdist_filename
>>> from packaging.version import Version
>>> name, ver = parse_sdist_filename("foo-1.0.tar.gz")
>>> name
'foo'
>>> ver == Version('1.0')
True
.. _Source distribution format: https://packaging.python.org/specifications/source-distribution-format/#source-distribution-file-name
z.tar.gzNz.zipz@Invalid sdist filename (extension must be '.tar.gz' or '.zip'): r+ zInvalid sdist filename: z*Invalid sdist filename (invalid version): )rC �lenr �
rpartitionr r
r )rL � file_stemrO �sep� version_partr1 r9 rP s r r r � s� � �, ����#� � .��I���/� � � � �6� "� �^��F� �|�,� �"���|�
�
�
� $-�#7�#7��#<� �I�s�L� �"�%=�h�\�#J�K�K� �Y� '�D���,�'��
�'�?��� � �"�8�� � E�
�� ���s � B � B.�B)�)B.)�returnz list[str])r1 r8 r( �boolr\ r )r1 r8 r\ r] )r9 z
Version | strr5 r] r\ r8 )rL r8 r; r] r\ z8tuple[NormalizedName, Version, BuildTag, frozenset[Tag]])rL r8 r\ z tuple[NormalizedName, Version])%�
__future__r rF �typingr r r r rU r r
r r9 r r
r r r rJ r8 r r �
ValueErrorr r r �compile�
IGNORECASE�ASCIIr- r4 rI r r r r r r r r �<module>rd s; ��
#� � .� .� 3� 3� =� =� �� � ��r��E�#�s�(�O�+� ,���)�3�/���
�*� � �:� � �:� � �"�*�*�,�b�m�m�b�h�h�.F��� �B�J�J� M�r�x�x�X� � �2�:�:�l�B�H�H�5� � 6;� ")�J
9�" <@�#M�
�#M�48�#M��#M�R !�Y(��Y(� �Y(� >� Y(�x/r