You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
142 lines
4.3 KiB
142 lines
4.3 KiB
# 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], *, strip_trailing_zero: bool = True
|
|
) -> 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
|
|
release_segment = ".".join(str(x) for x in parsed.release)
|
|
if strip_trailing_zero:
|
|
# NB: This strips trailing '.0's to normalize
|
|
release_segment = re.sub(r"(\.0)+$", "", release_segment)
|
|
parts.append(release_segment)
|
|
|
|
# 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)
|