a0biv S r SSKrSSKJr SSKJr SSKJr \\\4 r \R " S\R 5 r \R " S\R 5 r
\R " S \R 5 r\R " S
\R 5 rS \S \4S
jrS\S \4S jrS\S \4S jrS\S \4S jrS\S \4S jrS\S \4S jrS\S \4S jrS\S \4S jrg)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 d [ R " SSU 5 nUR 5 ( d eU$ )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-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_normalization.pysafe_identifierr s0 66-d +D K componentc . [ R SU 5 $ )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 < U R SS5 n [ [ R R U5 5 $ ! [ R R
aA [ R SU5 n[ [ R R U5 5 s $ f = f)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 '< A BBc [ U 5 $ ! [ R R a U R SS5 n[
R
U5 nU( a US nU[ U5 S nOSnU n[ R SU5 R S5 nSU 3R S5 n[ U SU 35 s $ f = f)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-B=<B=extrac h [ R SU 5 R S5 R 5 $ )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 U R SS5 R S5 $ )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 * [ [ U 5 5 $ )zBLike ``safe_name`` but can be used as filename component for wheel)r5 r r4 s r
safer_namer7 x s i . //r c * [ [ U 5 5 $ )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 jjErttL ZZ5 JJ}bdd3 :: MrttT # # 2 2 27# 7# 72 4 4 4B@c @c @.c .c .0c 0c 0 :S :S :r