_iv d Z ddlZddlmZ ddlmZ ddlmZ eeef Z ej dej Z ej dej Z
ej d ej Z ej d
ej Zd ed efd
Zded efdZded efdZded efdZded efdZded efdZded efdZded efdZy)zZ
Helpers for normalization as expected in wheel/sdist/module file names
and core metadata
N)Path)Union ) packagingz)^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$z [^A-Z0-9.]+z
[^A-Z0-9]+z,^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)namereturnc X t j dd| }|j sJ |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)_)resub isidentifier)r safes /builddir/build/BUILDROOT/alt-python312-setuptools-69.0.2-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/setuptools/_normalization.pysafe_identifierr s- 66-d +D K componentc . t j 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 s r safe_namer s ! !#y 11r versionc : | j dd } t t j j | S # t j j
$ rA t j d| }t t j j | cY S w xY w)a
Convert an arbitrary string into a valid version string.
Can still raise an ``InvalidVersion`` exception.
To avoid exceptions use ``best_effort_version``.
>>> 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 )replacestrr r VersionInvalidVersionr r )r vattempts r safe_versionr! + s~ " S!A79$$,,Q/00 + + 7$((a09$$,,W5667s '< ABBc t t | S # t j j $ r | j dd }t
j
| }|r|d }|t | d }nd}| }t j d| j d }d| j d }t | d| cY S w xY w)a Convert an arbitrary string into a version-like string.
Fallback when ``safe_version`` is not safe enough.
>>> best_effort_version("v0.2 beta")
'0.2b0'
>>> best_effort_version("ubuntu lts")
'0.dev0+sanitized.ubuntu.lts'
>>> best_effort_version("0.23ubuntu1")
'0.23.dev0+sanitized.ubuntu1'
>>> best_effort_version("0.23-")
'0.23.dev0+sanitized'
>>> best_effort_version("0.-_")
'0.dev0+sanitized'
>>> best_effort_version("42.+?1")
'42.dev0+sanitized.1'
r r r N0z
sanitized.z.dev0+) r! r r r r _PEP440_FALLBACKsearchlen_NON_ALPHANUMERICr strip)r r matchr rest safe_restlocals r best_effort_versionr- D s "
4G$$ + + 4 OOC % ''* =DSY[>DDD%))#t4::3? YK(..s3tfF5' 233 4s
B'B76B7extrac h t j d| j d j S )zNormalize extra name according to PEP 685
>>> safe_extra("_FrIeNdLy-._.-bArD")
'friendly-bard'
>>> safe_extra("FrIeNdLy-._.-bArD__._-")
'friendly-bard'
r )r' r r( lower)r. s r
safe_extrar1 e s+ e , 2 23 7 = = ??r valuec D | j dd j 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 r( r2 s r filename_componentr5 o s ==c " ( ( --r c * t t | S )zBLike ``safe_name`` but can be used as filename component for wheel)r5 r r4 s r
safer_namer7 x s i . //r c * t t | S )zLLike ``best_effort_version`` but can be used as filename component for wheel)r5 r- r4 s r safer_best_effort_versionr9 ~ s 1% 8 99r )__doc__r pathlibr typingr externr r _PathcompileI _VALID_NAMEr r' r$ r r r! r- r1 r5 r7 r9 r r rC s!
c4i bjjErttL RZZ5 BJJ}bdd3 2:: MrttT # # 2 2 27# 7# 72 4 4 4B@c @c @.c .c .0c 0c 0 :S :S :r