stlbench 0.2.0__tar.gz

stlbench-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nikita Dmitryuk
+
+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.

stlbench-0.2.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: stlbench
+Version: 0.2.0
+Summary: STL preparation toolkit for resin 3D printing: uniform scaling, bed packing, fill, autopack.
+License: MIT
+License-File: LICENSE
+Keywords: stl,3d-printing,resin,scaling,packing,sla,dlp
+Author: NikitaDmitryuk
+Author-email: dmitryuk.nikita@gmail.com
+Requires-Python: >=3.10
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Manufacturing
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Scientific/Engineering
+Provides-Extra: hollow
+Requires-Dist: numpy (>=1.23)
+Requires-Dist: pydantic (>=2.0,<3)
+Requires-Dist: rectpack (>=0.2.2)
+Requires-Dist: rich (>=13.0)
+Requires-Dist: scipy (>=1.9) ; extra == "hollow"
+Requires-Dist: tomli (>=1.1) ; python_version < "3.11"
+Requires-Dist: trimesh (>=3.21)
+Requires-Dist: typer (>=0.9)
+Project-URL: Bug Tracker, https://github.com/NikitaDmitryuk/stlbench/issues
+Project-URL: Homepage, https://github.com/NikitaDmitryuk/stlbench
+Project-URL: Repository, https://github.com/NikitaDmitryuk/stlbench
+Description-Content-Type: text/markdown
+
+# stlbench
+
+[![PyPI version](https://img.shields.io/pypi/v/stlbench.svg)](https://pypi.org/project/stlbench/)
+[![Python versions](https://img.shields.io/pypi/pyversions/stlbench.svg)](https://pypi.org/project/stlbench/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**STL preparation toolkit for resin 3D printing.**
+
+stlbench takes STL files and prepares them for SLA/DLP printers: uniform scaling to
+fit the build volume, packing parts onto rectangular print plates, filling the bed with
+copies, and combined scale-and-pack in one step. Supports are **not** generated --
+use your slicer (Lychee, Chitubox, PrusaSlicer, etc.) after export.
+
+## Installation
+
+```bash
+pip install stlbench
+```
+
+For hollow shell support (optional, requires `scipy`):
+
+```bash
+pip install "stlbench[hollow]"
+```
+
+### Development install
+
+```bash
+git clone https://github.com/NikitaDmitryuk/stlbench.git
+cd stlbench
+poetry install --with dev
+```
+
+## Quick Start
+
+```bash
+# Inspect model parts
+stlbench info -i ./parts -c configs/mars5_ultra.toml
+
+# Scale all parts to fit the printer
+stlbench scale -i ./parts -o ./scaled -c configs/mars5_ultra.toml
+
+# Pack scaled parts onto plates
+stlbench layout -i ./scaled -o ./plates -c configs/mars5_ultra.toml
+
+# Scale + pack all on one plate in one step
+stlbench autopack -i ./parts -o ./packed -c configs/mars5_ultra.toml
+
+# Fill the bed with copies of a single part
+stlbench fill -i ./part.stl -o ./filled -c configs/mars5_ultra.toml
+```
+
+Or specify the printer inline without a config file:
+
+```bash
+stlbench scale -i ./parts -o ./scaled -p "153.36,77.76,165"
+```
+
+## Commands
+
+### `info` -- Analyze models (read-only)
+
+```bash
+stlbench info -i ./parts -c configs/mars5_ultra.toml
+```
+
+Displays a table with AABB dimensions, volume, vertex/face counts, whether each
+part fits the bed, maximum scale factor, and how many copies would fit (`fill`).
+No files are written.
+
+### `scale` -- Uniform scaling
+
+```bash
+stlbench scale -i ./parts -o ./out -c configs/mars5_ultra.toml
+```
+
+Computes a single scale factor so that **every** part fits inside the printer
+build volume. The largest part determines the factor; all parts share the same
+scale. Supports two methods: `sorted` (default) and `conservative`.
+
+Key options: `--dry-run`, `--no-upscale`, `--method`, `--orientation free`,
+`--hollow`, `--supports-scale`.
+
+### `layout` -- Pack parts onto plates
+
+```bash
+stlbench layout -i ./scaled -o ./plates -c configs/mars5_ultra.toml
+```
+
+Arranges already-scaled STL files onto rectangular print plates using `rectpack`.
+Exports `plate_01.stl` + `plate_01.json` with positions. Multiple plates are
+created if parts do not fit on one.
+
+Key options: `--dry-run`, `--gap-mm`, `--algorithm shelf|rectpack`.
+
+### `autopack` -- Scale + layout on one plate
+
+```bash
+stlbench autopack -i ./parts -o ./packed -c configs/mars5_ultra.toml
+```
+
+Binary-searches for the maximum scale factor at which **all** parts fit onto a
+single plate simultaneously. Combines `scale` and `layout` into one step with a
+different goal: all parts on one plate, not each part fitting individually.
+
+Key options: `--dry-run`, `--gap-mm`, `--margin`, `--supports-scale`.
+
+### `fill` -- Maximum copies of one part
+
+```bash
+stlbench fill -i ./part.stl -o ./filled -c configs/mars5_ultra.toml
+```
+
+Packs as many copies of a single STL file as possible onto one plate. Useful for
+batch printing identical parts.
+
+Key options: `--scale` (scale the part to fit before filling), `--dry-run`, `--gap-mm`.
+
+### `hollow` / `supports`
+
+- `stlbench hollow` -- reminder to configure `[hollow]` in the TOML config and use `--hollow` with `scale`.
+- `stlbench supports` -- reminder that supports are added in the slicer.
+
+## Configuration
+
+Printer profiles are TOML files. See [`configs/mars5_ultra.toml`](configs/mars5_ultra.toml)
+for a complete example (ELEGOO Mars 5 Ultra).
+
+Key sections:
+
+| Section         | Purpose                                          |
+|-----------------|--------------------------------------------------|
+| `[printer]`     | Build volume: `width_mm`, `depth_mm`, `height_mm`|
+| `[scaling]`     | `bed_margin`, `supports_scale`                   |
+| `[orientation]` | `mode` (axis/free), `samples`, `seed`            |
+| `[packing]`     | `algorithm` (rectpack/shelf), `gap_mm`, `report` |
+| `[hollow]`      | `enabled`, `wall_thickness_mm`, `voxel_mm`       |
+
+## Examples
+
+See [`examples/README.md`](examples/README.md) for a full walkthrough using the
+included Gendalf model (3 parts tracked via Git LFS).
+
+## Package Structure
+
+| Module             | Purpose                                    |
+|--------------------|--------------------------------------------|
+| `stlbench.cli`     | Typer CLI application                      |
+| `stlbench.core`    | Scale factor computation and orientation   |
+| `stlbench.config`  | Pydantic schema + TOML loader              |
+| `stlbench.packing` | Shelf and rectpack algorithms              |
+| `stlbench.export`  | Plate STL assembly and JSON manifest       |
+| `stlbench.hollow`  | Voxel shell hollowing (optional, scipy)    |
+| `stlbench.pipeline`| Command runners (scale, layout, fill, etc.)|
+
+## Limitations
+
+- Boolean and voxel operations are sensitive to non-manifold STL. For complex
+  models use a mesh repair tool first.
+- Hollow shells in this package are a simplified voxel approach; for production
+  use your slicer's built-in hollowing.
+- Supports are **not** generated -- always add them in your slicer.
+
+## License
+
+[MIT](LICENSE)
+

stlbench-0.2.0/README.md

@@ -0,0 +1,166 @@
+# stlbench
+
+[![PyPI version](https://img.shields.io/pypi/v/stlbench.svg)](https://pypi.org/project/stlbench/)
+[![Python versions](https://img.shields.io/pypi/pyversions/stlbench.svg)](https://pypi.org/project/stlbench/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**STL preparation toolkit for resin 3D printing.**
+
+stlbench takes STL files and prepares them for SLA/DLP printers: uniform scaling to
+fit the build volume, packing parts onto rectangular print plates, filling the bed with
+copies, and combined scale-and-pack in one step. Supports are **not** generated --
+use your slicer (Lychee, Chitubox, PrusaSlicer, etc.) after export.
+
+## Installation
+
+```bash
+pip install stlbench
+```
+
+For hollow shell support (optional, requires `scipy`):
+
+```bash
+pip install "stlbench[hollow]"
+```
+
+### Development install
+
+```bash
+git clone https://github.com/NikitaDmitryuk/stlbench.git
+cd stlbench
+poetry install --with dev
+```
+
+## Quick Start
+
+```bash
+# Inspect model parts
+stlbench info -i ./parts -c configs/mars5_ultra.toml
+
+# Scale all parts to fit the printer
+stlbench scale -i ./parts -o ./scaled -c configs/mars5_ultra.toml
+
+# Pack scaled parts onto plates
+stlbench layout -i ./scaled -o ./plates -c configs/mars5_ultra.toml
+
+# Scale + pack all on one plate in one step
+stlbench autopack -i ./parts -o ./packed -c configs/mars5_ultra.toml
+
+# Fill the bed with copies of a single part
+stlbench fill -i ./part.stl -o ./filled -c configs/mars5_ultra.toml
+```
+
+Or specify the printer inline without a config file:
+
+```bash
+stlbench scale -i ./parts -o ./scaled -p "153.36,77.76,165"
+```
+
+## Commands
+
+### `info` -- Analyze models (read-only)
+
+```bash
+stlbench info -i ./parts -c configs/mars5_ultra.toml
+```
+
+Displays a table with AABB dimensions, volume, vertex/face counts, whether each
+part fits the bed, maximum scale factor, and how many copies would fit (`fill`).
+No files are written.
+
+### `scale` -- Uniform scaling
+
+```bash
+stlbench scale -i ./parts -o ./out -c configs/mars5_ultra.toml
+```
+
+Computes a single scale factor so that **every** part fits inside the printer
+build volume. The largest part determines the factor; all parts share the same
+scale. Supports two methods: `sorted` (default) and `conservative`.
+
+Key options: `--dry-run`, `--no-upscale`, `--method`, `--orientation free`,
+`--hollow`, `--supports-scale`.
+
+### `layout` -- Pack parts onto plates
+
+```bash
+stlbench layout -i ./scaled -o ./plates -c configs/mars5_ultra.toml
+```
+
+Arranges already-scaled STL files onto rectangular print plates using `rectpack`.
+Exports `plate_01.stl` + `plate_01.json` with positions. Multiple plates are
+created if parts do not fit on one.
+
+Key options: `--dry-run`, `--gap-mm`, `--algorithm shelf|rectpack`.
+
+### `autopack` -- Scale + layout on one plate
+
+```bash
+stlbench autopack -i ./parts -o ./packed -c configs/mars5_ultra.toml
+```
+
+Binary-searches for the maximum scale factor at which **all** parts fit onto a
+single plate simultaneously. Combines `scale` and `layout` into one step with a
+different goal: all parts on one plate, not each part fitting individually.
+
+Key options: `--dry-run`, `--gap-mm`, `--margin`, `--supports-scale`.
+
+### `fill` -- Maximum copies of one part
+
+```bash
+stlbench fill -i ./part.stl -o ./filled -c configs/mars5_ultra.toml
+```
+
+Packs as many copies of a single STL file as possible onto one plate. Useful for
+batch printing identical parts.
+
+Key options: `--scale` (scale the part to fit before filling), `--dry-run`, `--gap-mm`.
+
+### `hollow` / `supports`
+
+- `stlbench hollow` -- reminder to configure `[hollow]` in the TOML config and use `--hollow` with `scale`.
+- `stlbench supports` -- reminder that supports are added in the slicer.
+
+## Configuration
+
+Printer profiles are TOML files. See [`configs/mars5_ultra.toml`](configs/mars5_ultra.toml)
+for a complete example (ELEGOO Mars 5 Ultra).
+
+Key sections:
+
+| Section         | Purpose                                          |
+|-----------------|--------------------------------------------------|
+| `[printer]`     | Build volume: `width_mm`, `depth_mm`, `height_mm`|
+| `[scaling]`     | `bed_margin`, `supports_scale`                   |
+| `[orientation]` | `mode` (axis/free), `samples`, `seed`            |
+| `[packing]`     | `algorithm` (rectpack/shelf), `gap_mm`, `report` |
+| `[hollow]`      | `enabled`, `wall_thickness_mm`, `voxel_mm`       |
+
+## Examples
+
+See [`examples/README.md`](examples/README.md) for a full walkthrough using the
+included Gendalf model (3 parts tracked via Git LFS).
+
+## Package Structure
+
+| Module             | Purpose                                    |
+|--------------------|--------------------------------------------|
+| `stlbench.cli`     | Typer CLI application                      |
+| `stlbench.core`    | Scale factor computation and orientation   |
+| `stlbench.config`  | Pydantic schema + TOML loader              |
+| `stlbench.packing` | Shelf and rectpack algorithms              |
+| `stlbench.export`  | Plate STL assembly and JSON manifest       |
+| `stlbench.hollow`  | Voxel shell hollowing (optional, scipy)    |
+| `stlbench.pipeline`| Command runners (scale, layout, fill, etc.)|
+
+## Limitations
+
+- Boolean and voxel operations are sensitive to non-manifold STL. For complex
+  models use a mesh repair tool first.
+- Hollow shells in this package are a simplified voxel approach; for production
+  use your slicer's built-in hollowing.
+- Supports are **not** generated -- always add them in your slicer.
+
+## License
+
+[MIT](LICENSE)

stlbench-0.2.0/pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+name = "stlbench"
+version = "0.2.0"
+description = "STL preparation toolkit for resin 3D printing: uniform scaling, bed packing, fill, autopack."
+authors = [
+    {name = "NikitaDmitryuk", email = "dmitryuk.nikita@gmail.com"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["stl", "3d-printing", "resin", "scaling", "packing", "sla", "dlp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Manufacturing",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "numpy>=1.23",
+    "pydantic>=2.0,<3",
+    "rectpack>=0.2.2",
+    "rich>=13.0",
+    "tomli>=1.1; python_version < '3.11'",
+    "trimesh>=3.21",
+    "typer>=0.9",
+]
+
+[project.optional-dependencies]
+hollow = ["scipy>=1.9"]
+
+[project.urls]
+Homepage = "https://github.com/NikitaDmitryuk/stlbench"
+Repository = "https://github.com/NikitaDmitryuk/stlbench"
+"Bug Tracker" = "https://github.com/NikitaDmitryuk/stlbench/issues"
+
+[project.scripts]
+stlbench = "stlbench.cli:main"
+
+[tool.poetry]
+packages = [{ include = "stlbench" }]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "isort>=5.12",
+    "mypy>=1.5",
+    "ruff>=0.1",
+    "black>=23.0",
+    "twine>=5.0",
+    "build>=1.0",
+]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.black]
+line-length = 100
+target-version = ["py310"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+src_paths = ["stlbench", "tests"]
+known_first_party = ["stlbench"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["stlbench", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "UP", "B", "SIM"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+packages = ["stlbench"]
+warn_return_any = true
+warn_unused_ignores = true
+ignore_missing_imports = true
+disallow_untyped_defs = false

stlbench-0.2.0/stlbench/__init__.py

@@ -0,0 +1,3 @@
+"""STL preparation toolkit for resin 3D printing: scale, layout, fill, autopack, info."""
+
+__version__ = "0.2.0"

stlbench-0.2.0/stlbench/__main__.py

@@ -0,0 +1,4 @@
+from stlbench.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())