<h2>Editing File: /opt/imunify360/venv/lib/python3.11/site-packages/setuptools/_normalization.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;
Helpers for normalization as expected in wheel/sdist/module file names
and core metadata
&quot;&quot;&quot;
import re
from pathlib import Path
from typing import Union

from .extern import packaging

_Path = Union[str, Path]

# https://packaging.python.org/en/latest/specifications/core-metadata/#name
_VALID_NAME = re.compile(r&quot;^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$&quot;, re.I)
_UNSAFE_NAME_CHARS = re.compile(r&quot;[^A-Z0-9.]+&quot;, re.I)
_NON_ALPHANUMERIC = re.compile(r&quot;[^A-Z0-9]+&quot;, re.I)
_PEP440_FALLBACK = re.compile(r&quot;^v?(?P&lt;safe&gt;(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)&quot;, re.I)


def safe_identifier(name: str) -&gt; str:
    &quot;&quot;&quot;Make a string safe to be used as Python identifier.
    &gt;&gt;&gt; safe_identifier(&quot;12abc&quot;)
    '_12abc'
    &gt;&gt;&gt; safe_identifier(&quot;__editable__.myns.pkg-78.9.3_local&quot;)
    '__editable___myns_pkg_78_9_3_local'
    &quot;&quot;&quot;
    safe = re.sub(r'\W|^(?=\d)', '_', name)
    assert safe.isidentifier()
    return safe


def safe_name(component: str) -&gt; str:
    &quot;&quot;&quot;Escape a component used as a project name according to Core Metadata.
    &gt;&gt;&gt; safe_name(&quot;hello world&quot;)
    'hello-world'
    &gt;&gt;&gt; safe_name(&quot;hello?world&quot;)
    'hello-world'
    &quot;&quot;&quot;
    # See pkg_resources.safe_name
    return _UNSAFE_NAME_CHARS.sub(&quot;-&quot;, component)


def safe_version(version: str) -&gt; str:
    &quot;&quot;&quot;Convert an arbitrary string into a valid version string.
    Can still raise an ``InvalidVersion`` exception.
    To avoid exceptions use ``best_effort_version``.
    &gt;&gt;&gt; safe_version(&quot;1988 12 25&quot;)
    '1988.12.25'
    &gt;&gt;&gt; safe_version(&quot;v0.2.1&quot;)
    '0.2.1'
    &gt;&gt;&gt; safe_version(&quot;v0.2?beta&quot;)
    '0.2b0'
    &gt;&gt;&gt; safe_version(&quot;v0.2 beta&quot;)
    '0.2b0'
    &gt;&gt;&gt; safe_version(&quot;ubuntu lts&quot;)
    Traceback (most recent call last):
    ...
    setuptools.extern.packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts'
    &quot;&quot;&quot;
    v = version.replace(' ', '.')
    try:
        return str(packaging.version.Version(v))
    except packaging.version.InvalidVersion:
        attempt = _UNSAFE_NAME_CHARS.sub(&quot;-&quot;, v)
        return str(packaging.version.Version(attempt))


def best_effort_version(version: str) -&gt; str:
    &quot;&quot;&quot;Convert an arbitrary string into a version-like string.
    Fallback when ``safe_version`` is not safe enough.
    &gt;&gt;&gt; best_effort_version(&quot;v0.2 beta&quot;)
    '0.2b0'
    &gt;&gt;&gt; best_effort_version(&quot;ubuntu lts&quot;)
    '0.dev0+sanitized.ubuntu.lts'
    &gt;&gt;&gt; best_effort_version(&quot;0.23ubuntu1&quot;)
    '0.23.dev0+sanitized.ubuntu1'
    &gt;&gt;&gt; best_effort_version(&quot;0.23-&quot;)
    '0.23.dev0+sanitized'
    &gt;&gt;&gt; best_effort_version(&quot;0.-_&quot;)
    '0.dev0+sanitized'
    &gt;&gt;&gt; best_effort_version(&quot;42.+?1&quot;)
    '42.dev0+sanitized.1'
    &quot;&quot;&quot;
    # See pkg_resources._forgiving_version
    try:
        return safe_version(version)
    except packaging.version.InvalidVersion:
        v = version.replace(' ', '.')
        match = _PEP440_FALLBACK.search(v)
        if match:
            safe = match[&quot;safe&quot;]
            rest = v[len(safe) :]
        else:
            safe = &quot;0&quot;
            rest = version
        safe_rest = _NON_ALPHANUMERIC.sub(&quot;.&quot;, rest).strip(&quot;.&quot;)
        local = f&quot;sanitized.{safe_rest}&quot;.strip(&quot;.&quot;)
        return safe_version(f&quot;{safe}.dev0+{local}&quot;)


def safe_extra(extra: str) -&gt; str:
    &quot;&quot;&quot;Normalize extra name according to PEP 685
    &gt;&gt;&gt; safe_extra(&quot;_FrIeNdLy-._.-bArD&quot;)
    'friendly-bard'
    &gt;&gt;&gt; safe_extra(&quot;FrIeNdLy-._.-bArD__._-&quot;)
    'friendly-bard'
    &quot;&quot;&quot;
    return _NON_ALPHANUMERIC.sub(&quot;-&quot;, extra).strip(&quot;-&quot;).lower()


def filename_component(value: str) -&gt; str:
    &quot;&quot;&quot;Normalize each component of a filename (e.g. distribution/version part of wheel)
    Note: ``value`` needs to be already normalized.
    &gt;&gt;&gt; filename_component(&quot;my-pkg&quot;)
    'my_pkg'
    &quot;&quot;&quot;
    return value.replace(&quot;-&quot;, &quot;_&quot;).strip(&quot;_&quot;)


def safer_name(value: str) -&gt; str:
    &quot;&quot;&quot;Like ``safe_name`` but can be used as filename component for wheel&quot;&quot;&quot;
    # See bdist_wheel.safer_name
    return filename_component(safe_name(value))


def safer_best_effort_version(value: str) -&gt; str:
    &quot;&quot;&quot;Like ``best_effort_version`` but can be used as filename component for wheel&quot;&quot;&quot;
    # See bdist_wheel.safer_verion
    # TODO: Replace with only safe_version in the future (no need for best effort)
    return filename_component(best_effort_version(value))
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Fimunify360%2Fvenv%2Flib%2Fpython3.11%2Fsite-packages%2Fsetuptools'>Back to Directory</a>