Zy Filemanager

📁 File Browser

Name	Size	Permissions	Actions
📁 __pycache__	DIR	0755	🗑️
📄 __about__.py (661 bytes)	661 B	0644	✍️ ⬇️ 🗑️
📄 __init__.py (497 bytes)	497 B	0644	✍️ ⬇️ 🗑️
📄 _manylinux.py (11,488 bytes)	11.22 KB	0644	✍️ ⬇️ 🗑️
📄 _musllinux.py (4,378 bytes)	4.28 KB	0644	✍️ ⬇️ 🗑️
📄 _structures.py (1,431 bytes)	1.4 KB	0644	✍️ ⬇️ 🗑️
📄 markers.py (8,487 bytes)	8.29 KB	0644	✍️ ⬇️ 🗑️
📄 py.typed (0 bytes)	0 B	0644	✍️ ⬇️ 🗑️
📄 requirements.py (4,676 bytes)	4.57 KB	0644	✍️ ⬇️ 🗑️
📄 specifiers.py (30,110 bytes)	29.4 KB	0644	✍️ ⬇️ 🗑️
📄 tags.py (15,699 bytes)	15.33 KB	0644	✍️ ⬇️ 🗑️
📄 utils.py (4,200 bytes)	4.1 KB	0644	✍️ ⬇️ 🗑️
📄 version.py (14,479 bytes)	14.14 KB	0644	✍️ ⬇️ 🗑️

📤 Upload Files

Single File

Multiple Files

ZIP Extract

ZIP file will be deleted after extraction

➕ Create New

New Folder

New File

✍️ Editing: utils.py

            File: /opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/packaging/utils.py

            Size: 4.1 KB | 
            Last Modified: 2026-01-09 02:19:46        

# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.

import re
from typing import FrozenSet, NewType, Tuple, Union, cast

from .tags import Tag, parse_tag
from .version import InvalidVersion, Version

BuildTag = Union[Tuple[()], Tuple[int, str]]
NormalizedName = NewType("NormalizedName", str)

class InvalidWheelFilename(ValueError):
    """
    An invalid wheel filename was found, users should refer to PEP 427.
    """

class InvalidSdistFilename(ValueError):
    """
    An invalid sdist filename was found, users should refer to the packaging user guide.
    """

_canonicalize_regex = re.compile(r"[-_.]+")
# PEP 427: The build number must start with a digit.
_build_tag_regex = re.compile(r"(\d+)(.*)")

def canonicalize_name(name: str) -> NormalizedName:
    # This is taken from PEP 503.
    value = _canonicalize_regex.sub("-", name).lower()
    return cast(NormalizedName, value)

def canonicalize_version(version: Union[Version, str]) -> str:
    """
    This is very similar to Version.__str__, but has one subtle difference
    with the way it handles the release segment.
    """
    if isinstance(version, str):
        try:
            parsed = Version(version)
        except InvalidVersion:
            # Legacy versions cannot be normalized
            return version
    else:
        parsed = version

parts = []

# Epoch
    if parsed.epoch != 0:
        parts.append(f"{parsed.epoch}!")

# Release segment
    # NB: This strips trailing '.0's to normalize
    parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in parsed.release)))

# Pre-release
    if parsed.pre is not None:
        parts.append("".join(str(x) for x in parsed.pre))

# Post-release
    if parsed.post is not None:
        parts.append(f".post{parsed.post}")

# Development release
    if parsed.dev is not None:
        parts.append(f".dev{parsed.dev}")

# Local version segment
    if parsed.local is not None:
        parts.append(f"+{parsed.local}")

return "".join(parts)

def parse_wheel_filename(
    filename: str,
) -> Tuple[NormalizedName, Version, BuildTag, FrozenSet[Tag]]:
    if not filename.endswith(".whl"):
        raise InvalidWheelFilename(
            f"Invalid wheel filename (extension must be '.whl'): {filename}"
        )

filename = filename[:-4]
    dashes = filename.count("-")
    if dashes not in (4, 5):
        raise InvalidWheelFilename(
            f"Invalid wheel filename (wrong number of parts): {filename}"
        )

parts = filename.split("-", dashes - 2)
    name_part = parts[0]
    # See PEP 427 for the rules on escaping the project name
    if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None:
        raise InvalidWheelFilename(f"Invalid project name: {filename}")
    name = canonicalize_name(name_part)
    version = Version(parts[1])
    if dashes == 5:
        build_part = parts[2]
        build_match = _build_tag_regex.match(build_part)
        if build_match is None:
            raise InvalidWheelFilename(
                f"Invalid build number: {build_part} in '{filename}'"
            )
        build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2)))
    else:
        build = ()
    tags = parse_tag(parts[-1])
    return (name, version, build, tags)

def parse_sdist_filename(filename: str) -> Tuple[NormalizedName, Version]:
    if filename.endswith(".tar.gz"):
        file_stem = filename[: -len(".tar.gz")]
    elif filename.endswith(".zip"):
        file_stem = filename[: -len(".zip")]
    else:
        raise InvalidSdistFilename(
            f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):"
            f" {filename}"
        )

# We are requiring a PEP 440 version, which cannot contain dashes,
    # so we split on the last dash.
    name_part, sep, version_part = file_stem.rpartition("-")
    if not sep:
        raise InvalidSdistFilename(f"Invalid sdist filename: {filename}")

name = canonicalize_name(name_part)
    version = Version(version_part)
    return (name, version)

↩️ Back