Mercurial > repos > guerler > hhblits

comparison lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py @ 1:64071f2a4cf0 draft default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Deleted selected files
author guerler
date Mon, 27 Jul 2020 03:55:49 -0400
parents 9e54283cc701
children
comparison
equal deleted inserted replaced
0:9e54283cc701 1:64071f2a4cf0
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 string
7 import re
8
9 from setuptools.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
10 from setuptools.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
11 from setuptools.extern.pyparsing import Literal as L # noqa
12 from setuptools.extern.six.moves.urllib import parse as urlparse
13
14 from .markers import MARKER_EXPR, Marker
15 from .specifiers import LegacySpecifier, Specifier, SpecifierSet
16
17
18 class InvalidRequirement(ValueError):
19 """
20 An invalid requirement was found, users should refer to PEP 508.
21 """
22
23
24 ALPHANUM = Word(string.ascii_letters + string.digits)
25
26 LBRACKET = L("[").suppress()
27 RBRACKET = L("]").suppress()
28 LPAREN = L("(").suppress()
29 RPAREN = L(")").suppress()
30 COMMA = L(",").suppress()
31 SEMICOLON = L(";").suppress()
32 AT = L("@").suppress()
33
34 PUNCTUATION = Word("-_.")
35 IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
36 IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))
37
38 NAME = IDENTIFIER("name")
39 EXTRA = IDENTIFIER
40
41 URI = Regex(r"[^ ]+")("url")
42 URL = AT + URI
43
44 EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
45 EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")
46
47 VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
48 VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)
49
50 VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
51 VERSION_MANY = Combine(
52 VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False
53 )("_raw_spec")
54 _VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
55 _VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "")
56
57 VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
58 VERSION_SPEC.setParseAction(lambda s, l, t: t[1])
59
60 MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
61 MARKER_EXPR.setParseAction(
62 lambda s, l, t: Marker(s[t._original_start : t._original_end])
63 )
64 MARKER_SEPARATOR = SEMICOLON
65 MARKER = MARKER_SEPARATOR + MARKER_EXPR
66
67 VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
68 URL_AND_MARKER = URL + Optional(MARKER)
69
70 NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)
71
72 REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
73 # setuptools.extern.pyparsing isn't thread safe during initialization, so we do it eagerly, see
74 # issue #104
75 REQUIREMENT.parseString("x[]")
76
77
78 class Requirement(object):
79 """Parse a requirement.
80
81 Parse a given requirement string into its parts, such as name, specifier,
82 URL, and extras. Raises InvalidRequirement on a badly-formed requirement
83 string.
84 """
85
86 # TODO: Can we test whether something is contained within a requirement?
87 # If so how do we do that? Do we need to test against the _name_ of
88 # the thing as well as the version? What about the markers?
89 # TODO: Can we normalize the name and extra name?
90
91 def __init__(self, requirement_string):
92 try:
93 req = REQUIREMENT.parseString(requirement_string)
94 except ParseException as e:
95 raise InvalidRequirement(
96 'Parse error at "{0!r}": {1}'.format(
97 requirement_string[e.loc : e.loc + 8], e.msg
98 )
99 )
100
101 self.name = req.name
102 if req.url:
103 parsed_url = urlparse.urlparse(req.url)
104 if parsed_url.scheme == "file":
105 if urlparse.urlunparse(parsed_url) != req.url:
106 raise InvalidRequirement("Invalid URL given")
107 elif not (parsed_url.scheme and parsed_url.netloc) or (
108 not parsed_url.scheme and not parsed_url.netloc
109 ):
110 raise InvalidRequirement("Invalid URL: {0}".format(req.url))
111 self.url = req.url
112 else:
113 self.url = None
114 self.extras = set(req.extras.asList() if req.extras else [])
115 self.specifier = SpecifierSet(req.specifier)
116 self.marker = req.marker if req.marker else None
117
118 def __str__(self):
119 parts = [self.name]
120
121 if self.extras:
122 parts.append("[{0}]".format(",".join(sorted(self.extras))))
123
124 if self.specifier:
125 parts.append(str(self.specifier))
126
127 if self.url:
128 parts.append("@ {0}".format(self.url))
129 if self.marker:
130 parts.append(" ")
131
132 if self.marker:
133 parts.append("; {0}".format(self.marker))
134
135 return "".join(parts)
136
137 def __repr__(self):
138 return "<Requirement({0!r})>".format(str(self))