o
    JAf                     @   s   d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl	m
Z
 ddlmZ eeef Zed	ejZed
ejZdedefddZdedefddZdedefddZdedefddZdedefddZdedefddZdedefddZdS )zZ
Helpers for normalization as expected in wheel/sdist/module file names
and core metadata
    N)cleandoc)Path)Union)	packaging   )SetuptoolsDeprecationWarningz)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$z[^A-Z0-9.]+namereturnc                 C   s   t dd| }| sJ |S )zMake a string safe to be used as Python identifier.
    >>> safe_identifier("12abc")
    '_12abc'
    >>> safe_identifier("__editable__.myns.pkg-78.9.3_local")
    '__editable___myns_pkg_78_9_3_local'
    z
\W|^(?=\d)_)resubisidentifier)r   safe r   [/usr/lib/python3.10/site-packages/setuptools-67.5.1-py3.10.egg/setuptools/_normalization.pysafe_identifier   s   r   	componentc                 C   s   t d| S )zEscape a component used as a project name according to Core Metadata.
    >>> safe_name("hello world")
    'hello-world'
    >>> safe_name("hello?world")
    'hello-world'
    -)_UNSAFE_NAME_CHARSr   )r   r   r   r   	safe_name"   s   r   versionc                 C   sR   |  dd}z	ttj|W S  tjjy(   td|}ttj| Y S w )a  Convert an arbitrary string into a valid version string.
    >>> safe_version("1988 12 25")
    '1988.12.25'
    >>> safe_version("v0.2.1")
    '0.2.1'
    >>> safe_version("v0.2?beta")
    '0.2b0'
    >>> safe_version("v0.2 beta")
    '0.2b0'
    >>> safe_version("ubuntu lts")
    Traceback (most recent call last):
    ...
    setuptools.extern.packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts'
     .r   )replacestrr   r   VersionInvalidVersionr   r   )r   vattemptr   r   r   safe_version-   s   r   c                 C   sX   zt | W S  tjjy+   d| d| d}tt|t | dd}t	| Y S w )a  Convert an arbitrary string into a version-like string.
    >>> best_effort_version("v0.2 beta")
    '0.2b0'

    >>> import warnings
    >>> warnings.simplefilter("ignore", category=SetuptoolsDeprecationWarning)
    >>> best_effort_version("ubuntu lts")
    'ubuntu.lts'
    zInvalid version: zk.
        !!


        ###################
        # Invalid version #
        ###################
        z is not valid according to PEP 440.

        Please make sure specify a valid version for your package.
        Also note that future releases of setuptools may halt the build process
        if an invalid version is given.
        

!!
        r   r   )
r   r   r   r   warningswarnr   r   r   r   )r   msgr   r   r   r   best_effort_versionD   s   
r#   valuec                 C   s   |  dddS )zNormalize each component of a filename (e.g. distribution/version part of wheel)
    Note: ``value`` needs to be already normalized.
    >>> filename_component("my-pkg")
    'my_pkg'
    r   r
   )r   stripr$   r   r   r   filename_componentb   s   r'   c                 C      t t| S )zBLike ``safe_name`` but can be used as filename component for wheel)r'   r   r&   r   r   r   
safer_namek   s   r)   c                 C   r(   )zLLike ``best_effort_version`` but can be used as filename component for wheel)r'   r#   r&   r   r   r   safer_best_effort_versionq   s   r*   )__doc__r   r    inspectr   pathlibr   typingr   setuptools.externr   _deprecation_warningr   r   _PathcompileI_VALID_NAMEr   r   r   r   r#   r'   r)   r*   r   r   r   r   <module>   s$    	