pycodecad 1.0.0__tar.gz

pycodecad-1.0.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+venv/
+.venv/
+build/
+dist/
+.pytest_cache/
+*.stl
+*.step
+*.3mf
+!examples/assets/*.stl
+.pycodecad/
+revision.md

pycodecad-1.0.0/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 1.0.0
+
+First release.

pycodecad-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 offerrall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycodecad-1.0.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.5
+Name: pycodecad
+Version: 1.0.0
+Summary: Code-CAD with build123d: a desktop window that shows and exports what your Python script builds.
+Project-URL: Repository, https://github.com/offerrall/pycodecad
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 3d,3d-printing,build123d,cad,parametric
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Requires-Python: >=3.12
+Requires-Dist: build123d<0.14,>=0.13
+Requires-Dist: glfw<3,>=2.7
+Requires-Dist: moderngl<6,>=5.10
+Requires-Dist: numpy<3,>=1.26
+Requires-Dist: pytypehint==1.2.0
+Requires-Dist: slimgui<0.9,>=0.8.3
+Description-Content-Type: text/markdown
+
+# pycodecad
+
+[![PyPI](https://img.shields.io/pypi/v/pycodecad)](https://pypi.org/project/pycodecad/)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://pypi.org/project/pycodecad/)
+[![Platform](https://img.shields.io/badge/platform-Linux%20native%20%7C%20Windows%20%26%20macOS%20compatible-lightgrey)](docs/design.md#platforms)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+Code-CAD with [build123d](https://github.com/gumyr/build123d): write a Python script, see the part,
+export it for 3D printing.
+
+![The pycodecad window: the files of the folder, parameters and code on the left, a gear in the 3D view on the right](docs/images/window.png)
+
+```python
+from build123d import Box, Cylinder
+from pycodecad import show
+
+plate = Box(40, 30, 8) - Cylinder(5, 8)
+show(plate, name="plate", color="#F4B02A")
+```
+
+## Install
+
+```bash
+pip install pycodecad        # Python 3.12+, OpenGL 3.3
+```
+
+## Quick start
+
+```bash
+pycodecad examples                    # copy the examples to ./pycodecad-examples and open them
+pycodecad part.py                     # a window on part.py (created from an example if missing)
+pycodecad parts/gear/                 # a window on a folder: a part in several files
+pycodecad check part.py               # run it without a window, print the result as JSON
+pycodecad export part.py part.stl     # also .3mf .step .glb .brep
+```
+
+## What you get
+
+- **A window** on a part: its files, the code and the part side by side. It runs the part once when
+  it opens, then only when you press Run, and writes only when you press Save.
+- **Parameters**: `expose(fn)` turns the arguments of a function into sliders, number boxes and
+  checkboxes.
+- **Animations**: `frame()` saves the scene as a frame; the window plays them. Parts built once and
+  moved with `Pos` are not computed again, so mechanisms play in real time.
+- **A command line**: `check`, `render` and `export` run the same script without a window.
+- **An AI workflow**: an assistant edits the file and checks its own work with `check` and
+  `render`.
+- **Parts for your own app** (experimental): the window's code, parameters and 3D view as Dear
+  ImGui components, in `pycodecad.embed`.
+
+<table>
+  <tr>
+    <td width="33%"><img src="docs/images/parameters.png" alt="The Parameters panel: sliders, a number box and a checkbox made by expose()"></td>
+    <td width="33%"><img src="docs/images/error.png" alt="A failed run: the line marked in the editor and the traceback under it"></td>
+    <td width="33%"><img src="docs/images/render-grid.png" alt="pycodecad render: a gear in iso, front, top and right views"></td>
+  </tr>
+  <tr>
+    <td align="center">Parameters from <code>expose()</code></td>
+    <td align="center">Errors point at the line</td>
+    <td align="center"><code>pycodecad render</code>: what an AI sees</td>
+  </tr>
+</table>
+
+pycodecad is small on purpose, readable in an afternoon: see [Design](docs/design.md#small-on-purpose).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md): install, a first part, run, export.
+- [The window](docs/window.md): layout, Run and Save, Reload, read-only mode, shortcuts.
+- [Parameters](docs/parameters.md): `expose()`, its controls and `--set`.
+- [Scripts](docs/scripts.md): `show`, `clear`, `frame` (animations), `import_mesh`, colors, paths, errors.
+- [Command line](docs/cli.md): `check`, `render`, `export`, `context`, exit codes.
+- [Working with an AI assistant](docs/ai.md): the AI context and how an assistant checks its work.
+- [Files](docs/files.md): everything pycodecad writes, and where.
+- [Embedding](docs/embedding.md): the window's parts in your own app (experimental).
+- [Design](docs/design.md): principles, platforms and plans.
+- [Development](docs/development.md): tests, type checks and releases.
+
+Examples: [examples/](examples/)
+
+## Credits
+
+- [build123d](https://github.com/gumyr/build123d): the modeling language
+- [Open CASCADE](https://dev.opencascade.org/) and [OCP](https://github.com/CadQuery/OCP): the geometry kernel
+- [Dear ImGui](https://github.com/ocornut/imgui) and [slimgui](https://github.com/nurpax/slimgui): the interface
+- [ModernGL](https://github.com/moderngl/moderngl), [GLFW](https://www.glfw.org/) and
+  [pyGLFW](https://github.com/FlorianRhiem/pyGLFW): rendering and windows
+- [NumPy](https://numpy.org/): meshes
+- [pytypehint](https://github.com/offerrall/pytypehint): the parameters of `expose()`
+- [Lucide](https://lucide.dev): icons (ISC)
+
+## License
+
+[MIT](LICENSE)

pycodecad-1.0.0/README.md

@@ -0,0 +1,94 @@
+# pycodecad
+
+[![PyPI](https://img.shields.io/pypi/v/pycodecad)](https://pypi.org/project/pycodecad/)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://pypi.org/project/pycodecad/)
+[![Platform](https://img.shields.io/badge/platform-Linux%20native%20%7C%20Windows%20%26%20macOS%20compatible-lightgrey)](docs/design.md#platforms)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+Code-CAD with [build123d](https://github.com/gumyr/build123d): write a Python script, see the part,
+export it for 3D printing.
+
+![The pycodecad window: the files of the folder, parameters and code on the left, a gear in the 3D view on the right](docs/images/window.png)
+
+```python
+from build123d import Box, Cylinder
+from pycodecad import show
+
+plate = Box(40, 30, 8) - Cylinder(5, 8)
+show(plate, name="plate", color="#F4B02A")
+```
+
+## Install
+
+```bash
+pip install pycodecad        # Python 3.12+, OpenGL 3.3
+```
+
+## Quick start
+
+```bash
+pycodecad examples                    # copy the examples to ./pycodecad-examples and open them
+pycodecad part.py                     # a window on part.py (created from an example if missing)
+pycodecad parts/gear/                 # a window on a folder: a part in several files
+pycodecad check part.py               # run it without a window, print the result as JSON
+pycodecad export part.py part.stl     # also .3mf .step .glb .brep
+```
+
+## What you get
+
+- **A window** on a part: its files, the code and the part side by side. It runs the part once when
+  it opens, then only when you press Run, and writes only when you press Save.
+- **Parameters**: `expose(fn)` turns the arguments of a function into sliders, number boxes and
+  checkboxes.
+- **Animations**: `frame()` saves the scene as a frame; the window plays them. Parts built once and
+  moved with `Pos` are not computed again, so mechanisms play in real time.
+- **A command line**: `check`, `render` and `export` run the same script without a window.
+- **An AI workflow**: an assistant edits the file and checks its own work with `check` and
+  `render`.
+- **Parts for your own app** (experimental): the window's code, parameters and 3D view as Dear
+  ImGui components, in `pycodecad.embed`.
+
+<table>
+  <tr>
+    <td width="33%"><img src="docs/images/parameters.png" alt="The Parameters panel: sliders, a number box and a checkbox made by expose()"></td>
+    <td width="33%"><img src="docs/images/error.png" alt="A failed run: the line marked in the editor and the traceback under it"></td>
+    <td width="33%"><img src="docs/images/render-grid.png" alt="pycodecad render: a gear in iso, front, top and right views"></td>
+  </tr>
+  <tr>
+    <td align="center">Parameters from <code>expose()</code></td>
+    <td align="center">Errors point at the line</td>
+    <td align="center"><code>pycodecad render</code>: what an AI sees</td>
+  </tr>
+</table>
+
+pycodecad is small on purpose, readable in an afternoon: see [Design](docs/design.md#small-on-purpose).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md): install, a first part, run, export.
+- [The window](docs/window.md): layout, Run and Save, Reload, read-only mode, shortcuts.
+- [Parameters](docs/parameters.md): `expose()`, its controls and `--set`.
+- [Scripts](docs/scripts.md): `show`, `clear`, `frame` (animations), `import_mesh`, colors, paths, errors.
+- [Command line](docs/cli.md): `check`, `render`, `export`, `context`, exit codes.
+- [Working with an AI assistant](docs/ai.md): the AI context and how an assistant checks its work.
+- [Files](docs/files.md): everything pycodecad writes, and where.
+- [Embedding](docs/embedding.md): the window's parts in your own app (experimental).
+- [Design](docs/design.md): principles, platforms and plans.
+- [Development](docs/development.md): tests, type checks and releases.
+
+Examples: [examples/](examples/)
+
+## Credits
+
+- [build123d](https://github.com/gumyr/build123d): the modeling language
+- [Open CASCADE](https://dev.opencascade.org/) and [OCP](https://github.com/CadQuery/OCP): the geometry kernel
+- [Dear ImGui](https://github.com/ocornut/imgui) and [slimgui](https://github.com/nurpax/slimgui): the interface
+- [ModernGL](https://github.com/moderngl/moderngl), [GLFW](https://www.glfw.org/) and
+  [pyGLFW](https://github.com/FlorianRhiem/pyGLFW): rendering and windows
+- [NumPy](https://numpy.org/): meshes
+- [pytypehint](https://github.com/offerrall/pytypehint): the parameters of `expose()`
+- [Lucide](https://lucide.dev): icons (ISC)
+
+## License
+
+[MIT](LICENSE)

pycodecad-1.0.0/examples/assembly.py

@@ -0,0 +1,7 @@
+"""The gearbox of gearbox.py: parts from parts.py composed with normal imports."""
+from pycodecad import show
+
+from gearbox import gearbox
+
+for name, parts, color in gearbox():
+    show(parts, name=name, color=color)

pycodecad-1.0.0/examples/assets/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="20mm" height="20mm" viewBox="0 0 20 20"><path d="M0 0 H20 V5 H5 V20 H0 Z"/></svg>

pycodecad-1.0.0/examples/assets/pyramid.stl

@@ -0,0 +1,44 @@
+solid pyramid
+facet normal 0 0 -1
+ outer loop
+  vertex 30 -10 0
+  vertex 50 10 0
+  vertex 50 -10 0
+ endloop
+endfacet
+facet normal 0 0 -1
+ outer loop
+  vertex 30 -10 0
+  vertex 30 10 0
+  vertex 50 10 0
+ endloop
+endfacet
+facet normal 0 -0.83205 0.5547
+ outer loop
+  vertex 30 -10 0
+  vertex 50 -10 0
+  vertex 40 0 15
+ endloop
+endfacet
+facet normal 0.83205 -0 0.5547
+ outer loop
+  vertex 50 -10 0
+  vertex 50 10 0
+  vertex 40 0 15
+ endloop
+endfacet
+facet normal 0 0.83205 0.5547
+ outer loop
+  vertex 50 10 0
+  vertex 30 10 0
+  vertex 40 0 15
+ endloop
+endfacet
+facet normal -0.83205 0 0.5547
+ outer loop
+  vertex 30 10 0
+  vertex 30 -10 0
+  vertex 40 0 15
+ endloop
+endfacet
+endsolid pyramid

pycodecad-1.0.0/examples/embedded_app.py

@@ -0,0 +1,77 @@
+"""An order desk built on pycodecad's ImGui components (pycodecad.embed, experimental in 1.0): pick an
+order and the tray of tray.py is rebuilt to its measures; export it for the printer.
+
+    python examples/embedded_app.py             # the app
+    python examples/embedded_app.py shot.png    # hidden: save a picture after the first run, then quit
+
+tray.py opens read only (a template): the orders never change it. Exports are written next
+to it, one file per order (order_1041.stl ...).
+"""
+import sys
+from pathlib import Path
+
+from slimgui import imgui
+
+import pycodecad.embed as p3
+
+ORDERS = (  # number, customer, width, depth, height (mm), rounded corners
+    ("1041", "Cafe Norte: cutlery", 120.0, 80.0, 30.0, True),
+    ("1042", "Workshop: screws", 60.0, 40.0, 20.0, False),
+    ("1043", "Studio: pencils", 180.0, 50.0, 25.0, True),
+    ("1044", "Kitchen: spices", 150.0, 150.0, 60.0, True),
+)
+FIRST_USE = imgui.Cond.FIRST_USE_EVER
+
+
+def place(title: str, x: float, y: float, width: float, height: float) -> None:
+    imgui.set_next_window_pos((x, y), FIRST_USE)
+    imgui.set_next_window_size((width, height), FIRST_USE)
+    imgui.begin(title)
+
+
+def main(screenshot: str | None = None) -> None:
+    window = p3.create_window("Tray orders", size=(1400, 860), visible=screenshot is None)
+    part = p3.Workspace(Path(__file__).with_name("tray.py"), read_only=True, run=False)
+    part.show_files = False  # only the template, not the other files of its folder
+    preview = p3.Viewer()  # the same tray from the front, with a camera of its own
+    preview.look_from((0.0, -1.0, 0.0))
+    chosen = None
+    while window.frame(keep_open=part.dirty()):
+        place("Template", 350, 10, 1040, 840)  # first: draw() updates it, what follows sees this frame's state
+        part.draw()
+        part.close_prompt(window)
+        imgui.end()
+
+        place("Orders", 10, 10, 330, 400)
+        for index, (number, customer, width, depth, height, rounded) in enumerate(ORDERS):
+            if imgui.selectable(f"{number}  {customer}", chosen == index)[0] or (screenshot and chosen is None):
+                chosen = index
+                part.values.update({"tray.width": width, "tray.depth": depth, "tray.height": height,
+                                    "tray.rounded": rounded})
+                part.run()  # explicit, as always
+        if chosen is not None:
+            number, _, width, depth, height, _ = ORDERS[chosen]
+            imgui.separator()
+            imgui.text(f"Order {number}: {width:g} x {depth:g} x {height:g} mm")
+            imgui.begin_disabled(part.running() or part.error is not None)
+            if imgui.button("Export STL"):
+                part.export("stl", target=f"order_{number}.stl")
+            imgui.same_line()
+            if imgui.button("Export 3MF (Bambu)"):
+                part.export("3mf", "bambu", target=f"order_{number}.3mf")
+            imgui.end_disabled()
+        imgui.text_wrapped("Running..." if part.running() else part.error or part.message)
+        imgui.end()
+
+        place("Preview", 10, 420, 330, 430)
+        preview.draw(part.shown)
+        imgui.end()
+
+        if screenshot and part.ran() and not part.running():
+            window.screenshot(screenshot)
+            window.request_close()
+    window.close()
+
+
+if __name__ == "__main__":
+    main(*sys.argv[1:2])

pycodecad-1.0.0/examples/gear.py

@@ -0,0 +1,6 @@
+"""One loose part made to measure: expose() gives the window a slider per parameter of gear()."""
+from pycodecad import expose, show
+
+from parts import gear
+
+show(expose(gear), name="gear", color="#F4B02A")

pycodecad-1.0.0/examples/gearbox.py

@@ -0,0 +1,30 @@
+"""The parts composed into a gearbox: two meshing gears on shafts, on a plate held by brackets.
+Each part is built once here; gearbox() only places them, so an animation of it is cheap."""
+from build123d import Pos, Rot
+from build123d.topology import Shape
+
+from parts import bracket, gear, pitch_radius, plate, shaft
+
+SMALL, LARGE, MODULE = 12, 24, 2.0
+BACKLASH = 0.3
+DISTANCE = pitch_radius(SMALL, MODULE) + pitch_radius(LARGE, MODULE) + BACKLASH
+AXES = [(-DISTANCE / 2, 0.0), (DISTANCE / 2, 0.0)]
+PLATE = 5.0
+
+PINION, WHEEL = gear(SMALL, MODULE), gear(LARGE, MODULE)
+SHAFT, BRACKET = shaft(6.0, 30.0), bracket(40.0, 4.0)
+WIDTH = DISTANCE + 80
+BASE = plate(WIDTH, 70, PLATE, AXES)
+
+
+def gearbox(angle: float = 0.0) -> list[tuple[str, Shape | list[Shape], str]]:
+    """(name, parts, color) with the pinion turned by angle degrees (the wheel follows)."""
+    (x0, y0), (x1, y1) = AXES
+    half_tooth = 180 / LARGE
+    return [
+        ("plate", BASE, "#9AA3AB"),
+        ("shaft", [Pos(x, y, PLATE) * SHAFT for x, y in AXES], "#D0D4D8"),
+        ("pinion", Pos(x0, y0, PLATE + 12) * Rot(0, 0, angle) * PINION, "#F4B02A"),
+        ("wheel", Pos(x1, y1, PLATE + 12) * Rot(0, 0, half_tooth - angle * SMALL / LARGE) * WHEEL, "#6947AE"),
+        ("bracket", [Pos(-WIDTH / 2, 0, 0) * Rot(0, 0, 180) * BRACKET, Pos(WIDTH / 2, 0, 0) * BRACKET], "#48B5A4"),
+    ]

pycodecad-1.0.0/examples/gears_turning.py

@@ -0,0 +1,11 @@
+"""An animation with frame(): the gearbox turning. The parts are built once (in gearbox.py) and
+only placed in each frame, so 90 frames cost little more than one."""
+from pycodecad import clear, frame, show
+
+from gearbox import gearbox
+
+for step in range(90):
+    clear()
+    for name, parts, color in gearbox(angle=360 * step / 90):
+        show(parts, name=name, color=color)
+    frame()

pycodecad-1.0.0/examples/import_files.py

@@ -0,0 +1,13 @@
+"""Extruded SVG next to a reference STL. The paths start from this file's folder, so the script
+also works with plain `python examples/import_files.py` from any directory."""
+from pathlib import Path
+
+from build123d import extrude, import_svg
+from pycodecad import import_mesh, show
+
+assets = Path(__file__).parent / "assets"
+height = 3.0
+
+logo = extrude(import_svg(assets / "logo.svg"), amount=height)  # pyright: ignore[reportArgumentType]
+show(logo, name="logo", color="gold")
+show(import_mesh(assets / "pyramid.stl"), name="reference", color="blue")

pycodecad-1.0.0/examples/parts.py

@@ -0,0 +1,46 @@
+"""The loose parts: one function per part, no show(). The other scripts compose them."""
+from math import cos, pi, sin
+from typing import Annotated
+
+from build123d import Align, Box, Cylinder, Polygon, Pos, extrude
+from build123d.topology import Shape
+from pytypehint import Label, Max, Min, Slider
+
+BOTTOM = (Align.CENTER, Align.CENTER, Align.MIN)
+
+
+def pitch_radius(teeth: int, module: float) -> float:
+    return module * teeth / 2
+
+
+def gear(teeth: Annotated[int, Min(8), Max(60), Slider(), Label("Teeth")] = 20,
+         module: Annotated[float, Min(0.5), Max(4.0), Slider(), Label("Module")] = 2.0,
+         thickness: Annotated[float, Min(2.0), Max(30.0), Slider(), Label("Thickness")] = 8.0,
+         bore: Annotated[float, Min(2.0), Max(20.0), Label("Bore")] = 6.0) -> Shape:
+    """Spur gear with straight flanks and a hub, centred on the origin, standing on z=0."""
+    root, tip = pitch_radius(teeth, module) - 1.25 * module, pitch_radius(teeth, module) + module
+    outline = [(r * cos(a), r * sin(a))
+               for i in range(teeth)
+               for r, a in ((root, (2 * i - 0.62) * pi / teeth), (tip, (2 * i - 0.3) * pi / teeth),
+                            (tip, (2 * i + 0.3) * pi / teeth), (root, (2 * i + 0.62) * pi / teeth))]
+    body = extrude(Polygon(*outline, align=None), thickness)
+    body += Pos(0, 0, thickness) * Cylinder(bore, thickness / 2, align=BOTTOM)
+    return body - Cylinder(bore / 2, thickness * 4)
+
+
+def shaft(diameter: float = 6.0, length: float = 30.0) -> Shape:
+    return Cylinder(diameter / 2, length, align=BOTTOM)
+
+
+def plate(width: float, depth: float, thickness: float, holes: list[tuple[float, float]]) -> Shape:
+    body = Box(width, depth, thickness, align=BOTTOM)
+    for x, y in holes:
+        body -= Pos(x, y, 0) * Cylinder(3.2, thickness, align=BOTTOM)
+    return body
+
+
+def bracket(length: float = 40.0, thickness: float = 4.0) -> Shape:
+    """L bracket with a mounting hole, its corner on the origin."""
+    base = Pos(length / 2, 0, thickness / 2) * Box(length, 20, thickness)
+    wall = Pos(thickness / 2, 0, 12) * Box(thickness, 20, 24)
+    return base + wall - Pos(length * 0.6, 0, thickness / 2) * Cylinder(3, thickness)

pycodecad-1.0.0/examples/tray.py

@@ -0,0 +1,28 @@
+"""Open tray made to measure: expose() gives the window a control per parameter (units: mm).
+
+Change the values in the window and press Run (Ctrl+R); outside the window the defaults are used,
+or `--set` on the command line: pycodecad export tray.py tray.stl --set width=120
+"""
+from typing import Annotated
+
+from build123d import Axis, Box, Pos, fillet
+from pytypehint import Description, Label, Max, Min, Slider
+from pycodecad import expose, show
+
+
+def tray(width: Annotated[float, Min(20.0), Max(200.0), Slider(), Label("Width")] = 80.0,
+         depth: Annotated[float, Min(20.0), Max(200.0), Slider(), Label("Depth")] = 60.0,
+         height: Annotated[float, Min(5.0), Max(100.0), Slider(), Label("Height")] = 25.0,
+         wall: Annotated[float, Min(0.8), Max(5.0), Label("Wall"),
+                         Description("Also the thickness of the floor")] = 2.0,
+         rounded: Annotated[bool, Label("Rounded corners")] = True):
+    """A box without lid: the outside measures width x depth x height, the floor is one wall thick."""
+    outside = Pos(0, 0, height / 2) * Box(width, depth, height)
+    inside = Pos(0, 0, wall + height / 2) * Box(width - 2 * wall, depth - 2 * wall, height)
+    if rounded:
+        outside = fillet(outside.edges().filter_by(Axis.Z), radius=min(width, depth) / 8)
+        inside = fillet(inside.edges().filter_by(Axis.Z), radius=max(min(width, depth) / 8 - wall, 0.5))
+    return outside - inside
+
+
+show(expose(tray), name="tray", color="#4C9BE8")

pycodecad-1.0.0/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "pycodecad"
+dynamic = ["version"]
+description = "Code-CAD with build123d: a desktop window that shows and exports what your Python script builds."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = ["cad", "build123d", "3d", "parametric", "3d-printing"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+]
+dependencies = [
+    "build123d>=0.13,<0.14",
+    "slimgui>=0.8.3,<0.9",
+    "glfw>=2.7,<3",
+    "moderngl>=5.10,<6",
+    "numpy>=1.26,<3",
+    "pytypehint==1.2.0",
+]
+
+[project.scripts]
+pycodecad = "pycodecad.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.pyright]
+include = ["src", "tests", "examples"]
+pythonVersion = "3.12"
+venvPath = "."
+venv = "venv"
+
+[project.urls]
+Repository = "https://github.com/offerrall/pycodecad"
+
+[tool.hatch.version]
+path = "src/pycodecad/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pycodecad"]
+exclude = ["**/__pycache__", "**/.pycodecad"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"examples" = "pycodecad/examples"
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/pycodecad", "/tests", "/examples", "/README.md", "/CHANGELOG.md", "/pyproject.toml"]
+exclude = ["**/__pycache__", "**/*.pyc"]

pycodecad-1.0.0/src/pycodecad/__init__.py

@@ -0,0 +1,18 @@
+"""Code-CAD with build123d: write a Python script, see the part, export it."""
+from typing import TYPE_CHECKING
+
+__version__ = "1.0.0"
+
+__all__ = ["show", "clear", "frame", "import_mesh", "expose"]
+
+if TYPE_CHECKING:
+    from .api import clear, expose, frame, import_mesh, show
+
+
+def __getattr__(name: str):
+    # Lazy, so `import pycodecad` (and the CLI) start instantly.
+    if name in __all__:
+        from . import api
+
+        return getattr(api, name)
+    raise AttributeError(name)

pycodecad-1.0.0/src/pycodecad/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())