Mercurial > repos > shellac > sam_consensus_v3
comparison env/lib/python3.9/site-packages/packaging/utils.py @ 0:4f3585e2f14b draft default tip
"planemo upload commit 60cee0fc7c0cda8592644e1aad72851dec82c959"
author | shellac |
---|---|
date | Mon, 22 Mar 2021 18:12:50 +0000 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:4f3585e2f14b |
---|---|
1 # This file is dual licensed under the terms of the Apache License, Version | |
2 # 2.0, and the BSD License. See the LICENSE file in the root of this repository | |
3 # for complete details. | |
4 from __future__ import absolute_import, division, print_function | |
5 | |
6 import re | |
7 | |
8 from ._typing import TYPE_CHECKING, cast | |
9 from .tags import Tag, parse_tag | |
10 from .version import InvalidVersion, Version | |
11 | |
12 if TYPE_CHECKING: # pragma: no cover | |
13 from typing import FrozenSet, NewType, Tuple, Union | |
14 | |
15 BuildTag = Union[Tuple[()], Tuple[int, str]] | |
16 NormalizedName = NewType("NormalizedName", str) | |
17 else: | |
18 BuildTag = tuple | |
19 NormalizedName = str | |
20 | |
21 | |
22 class InvalidWheelFilename(ValueError): | |
23 """ | |
24 An invalid wheel filename was found, users should refer to PEP 427. | |
25 """ | |
26 | |
27 | |
28 class InvalidSdistFilename(ValueError): | |
29 """ | |
30 An invalid sdist filename was found, users should refer to the packaging user guide. | |
31 """ | |
32 | |
33 | |
34 _canonicalize_regex = re.compile(r"[-_.]+") | |
35 # PEP 427: The build number must start with a digit. | |
36 _build_tag_regex = re.compile(r"(\d+)(.*)") | |
37 | |
38 | |
39 def canonicalize_name(name): | |
40 # type: (str) -> NormalizedName | |
41 # This is taken from PEP 503. | |
42 value = _canonicalize_regex.sub("-", name).lower() | |
43 return cast(NormalizedName, value) | |
44 | |
45 | |
46 def canonicalize_version(version): | |
47 # type: (Union[Version, str]) -> Union[Version, str] | |
48 """ | |
49 This is very similar to Version.__str__, but has one subtle difference | |
50 with the way it handles the release segment. | |
51 """ | |
52 if not isinstance(version, Version): | |
53 try: | |
54 version = Version(version) | |
55 except InvalidVersion: | |
56 # Legacy versions cannot be normalized | |
57 return version | |
58 | |
59 parts = [] | |
60 | |
61 # Epoch | |
62 if version.epoch != 0: | |
63 parts.append("{0}!".format(version.epoch)) | |
64 | |
65 # Release segment | |
66 # NB: This strips trailing '.0's to normalize | |
67 parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in version.release))) | |
68 | |
69 # Pre-release | |
70 if version.pre is not None: | |
71 parts.append("".join(str(x) for x in version.pre)) | |
72 | |
73 # Post-release | |
74 if version.post is not None: | |
75 parts.append(".post{0}".format(version.post)) | |
76 | |
77 # Development release | |
78 if version.dev is not None: | |
79 parts.append(".dev{0}".format(version.dev)) | |
80 | |
81 # Local version segment | |
82 if version.local is not None: | |
83 parts.append("+{0}".format(version.local)) | |
84 | |
85 return "".join(parts) | |
86 | |
87 | |
88 def parse_wheel_filename(filename): | |
89 # type: (str) -> Tuple[NormalizedName, Version, BuildTag, FrozenSet[Tag]] | |
90 if not filename.endswith(".whl"): | |
91 raise InvalidWheelFilename( | |
92 "Invalid wheel filename (extension must be '.whl'): {0}".format(filename) | |
93 ) | |
94 | |
95 filename = filename[:-4] | |
96 dashes = filename.count("-") | |
97 if dashes not in (4, 5): | |
98 raise InvalidWheelFilename( | |
99 "Invalid wheel filename (wrong number of parts): {0}".format(filename) | |
100 ) | |
101 | |
102 parts = filename.split("-", dashes - 2) | |
103 name_part = parts[0] | |
104 # See PEP 427 for the rules on escaping the project name | |
105 if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: | |
106 raise InvalidWheelFilename("Invalid project name: {0}".format(filename)) | |
107 name = canonicalize_name(name_part) | |
108 version = Version(parts[1]) | |
109 if dashes == 5: | |
110 build_part = parts[2] | |
111 build_match = _build_tag_regex.match(build_part) | |
112 if build_match is None: | |
113 raise InvalidWheelFilename( | |
114 "Invalid build number: {0} in '{1}'".format(build_part, filename) | |
115 ) | |
116 build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2))) | |
117 else: | |
118 build = () | |
119 tags = parse_tag(parts[-1]) | |
120 return (name, version, build, tags) | |
121 | |
122 | |
123 def parse_sdist_filename(filename): | |
124 # type: (str) -> Tuple[NormalizedName, Version] | |
125 if not filename.endswith(".tar.gz"): | |
126 raise InvalidSdistFilename( | |
127 "Invalid sdist filename (extension must be '.tar.gz'): {0}".format(filename) | |
128 ) | |
129 | |
130 # We are requiring a PEP 440 version, which cannot contain dashes, | |
131 # so we split on the last dash. | |
132 name_part, sep, version_part = filename[:-7].rpartition("-") | |
133 if not sep: | |
134 raise InvalidSdistFilename("Invalid sdist filename: {0}".format(filename)) | |
135 | |
136 name = canonicalize_name(name_part) | |
137 version = Version(version_part) | |
138 return (name, version) |