1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
from typing import Any, Sequence, Union
from cyclopts.utils import frozen
@frozen(kw_only=True)
class Number:
"""Limit input number to a value range.
Example Usage:
.. code-block:: python
from cyclopts import App, Parameter, validators
from typing import Annotated
app = App()
@app.default
def main(age: Annotated[int, Parameter(validator=validators.Number(gte=0, lte=150))]):
print(f"You are {age} years old.")
app()
.. code-block:: console
$ my-script 100
You are 100 years old.
$ my-script -1
╭─ Error ───────────────────────────────────────────────────────╮
│ Invalid value "-1" for "AGE". Must be >= 0. │
╰───────────────────────────────────────────────────────────────╯
$ my-script 200
╭─ Error ───────────────────────────────────────────────────────╮
│ Invalid value "200" for "AGE". Must be <= 150. │
╰───────────────────────────────────────────────────────────────╯
"""
lt: Union[int, float, None] = None
"""Input value must be **less than** this value."""
lte: Union[int, float, None] = None
"""Input value must be **less than or equal** this value."""
gt: Union[int, float, None] = None
"""Input value must be **greater than** this value."""
gte: Union[int, float, None] = None
"""Input value must be **greater than or equal** this value."""
modulo: Union[int, float, None] = None
"""Input value must be a multiple of this value."""
def __call__(self, type_: Any, value: Any):
if isinstance(value, Sequence):
if isinstance(value, str):
raise TypeError
for v in value:
self(type_, v)
else:
if not isinstance(value, (int, float)):
return
if self.lt is not None and value >= self.lt:
raise ValueError(f"Must be < {self.lt}.")
if self.lte is not None and value > self.lte:
raise ValueError(f"Must be <= {self.lte}.")
if self.gt is not None and value <= self.gt:
raise ValueError(f"Must be > {self.gt}.")
if self.gte is not None and value < self.gte:
raise ValueError(f"Must be >= {self.gte}.")
if self.modulo is not None and value % self.modulo:
raise ValueError(f"Must be a multiple of {self.modulo}.")
|
