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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
from dataclasses import KW_ONLY, dataclass # pyright: ignore[reportAttributeAccessIssue]
from pathlib import Path
from typing import Annotated, Literal, NamedTuple, Union
import cyclopts
from cyclopts import App, Parameter
from cyclopts.types import UInt8
toml_path = Path("draw.toml")
toml_data = """\
[tool.draw]
units = "meters"
no_exit_on_error = false
[tool.draw.line]
units = "feet"
"""
toml_path.write_text(toml_data)
app = App(
help="Demo drawing app.",
config=(
cyclopts.config.Toml(toml_path, root_keys=("tool", "draw")),
cyclopts.config.Toml(toml_path, root_keys=("tool", "draw"), use_commands_as_keys=False),
),
)
class Coordinate(NamedTuple):
x: float
"X coordinate."
y: float
"Y coordinate."
@Parameter(name="*")
@dataclass
class Config:
_: KW_ONLY
units: Literal["meters", "feet"] = "meters"
"Drawing units."
color: tuple[UInt8, UInt8, UInt8] = (0x00, 0x00, 0x00)
"RGB uint8 triple."
@app.command
def line(
start: Coordinate,
end: Coordinate,
*,
config: Config,
):
"""Draw a line.
Parameters
----------
start: Coordinate
Start of line.
end: Coordinate
End of line.
"""
print(f"Drawing a line with from {start} to {end} {config.units} in {config.color=}.")
@app.command
def elliptic_curve(
start_point: Coordinate,
end_point: Coordinate,
r1: float,
r2: float,
*,
config: Config,
):
"""Draw a elliptical curve."""
@app.command
def circle(
center: Coordinate,
radius: Union[Literal["unit"], float],
*,
config: Config,
):
"""Draw a circle.
Parameters
----------
center: Literal["origin"] | Coordinate
Center of the circle to be drawn.
center.x: float
Circle center's X position.
center.y: float
Circle center's Y position.
radius: float
Radius of the circle.
"""
if radius == "unit":
radius = 1.0
print(f"Drawing a circle with {radius=} {config.units} at {center=}")
@app.command
def polygon(*vertices: Annotated[Coordinate, Parameter(required=True)], config: Config):
"""Draw a polygon.
Parameters
----------
vertices: Coordinate
List of (x, y) coordinates that make up the polygon.
"""
print(f"Drawing a polygon with {vertices=} {config.units} in {config.color=}.")
@app.command
def polygon2(vertices: list[Coordinate], /, *, config: Config):
"""Draw a polygon (alternative implementation).
Parameters
----------
vertices: Coordinate
List of (x, y) coordinates that make up the polygon.
"""
print(f"Drawing a polygon with {vertices=} {config.units} in {config.color=}.")
@app.meta.default
def meta(
*tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
no_exit_on_error: Annotated[bool, Parameter(negative=())] = False,
):
"""
Parameters
----------
exit_on_error: bool
Exit on error.
"""
app(tokens, exit_on_error=not no_exit_on_error, print_error=not no_exit_on_error)
toml_path.unlink()
if __name__ == "__main__":
app.meta(print_error=False, exit_on_error=False)
|
