bdbox 0.3.0

Parametric configuration and tooling for build123d models.

bdbox

Parametric configuration and tooling for build123d models.

Installation

pip install bdbox

Features

Easily add configurable parameters to build123d models! Declare typed parameters with defaults, then override them individually or with named presets.

Great for simple models:

from bdbox import Float, Int, Params, Preset, show
from build123d import Box

class P(Params):
    width = Float(10.0, min=5, max=100)
    length = Float(20.0, min=5, max=100)
    thickness = Int(2, min=1, max=10)
    presets = (
        Preset("small", width=5.0, length=8.0),
        Preset("large", width=80.0, length=40.0, thickness=5),
    )

result = Box(P.width, P.length, P.thickness)
show(result)

Or inherit from the provided base class for reusable, importable models:

from bdbox import Float, Int, Model, Preset
from build123d import Box

class MyBox(Model):
    width = Float(10.0, min=5, max=100)
    length = Float(20.0, min=5, max=100)
    thickness = Int(2, min=1, max=10)
    presets = (
        Preset("small", width=5.0, length=8.0),
        Preset("large", width=80.0, length=40.0, thickness=5),
    )

    def build(self):
        return Box(self.width, self.length, self.thickness)

This provides a CLI with parameter value arguments, preset selection, and usage information:

python mybox.py                 # Run with default values
python mybox.py --width 50      # Override a field value
python mybox.py --preset large  # Apply a named preset of values
python mybox.py --help          # Usage info with all parameters

Export geometry to STEP or STL files using the built-in export action:

python mybox.py export output.step  # Export to STEP
python mybox.py export output.stl   # Export to STL

Or use the bdbox runner to export plain build123d models:

bdbox mybox.py export output.step

See full details in the documentation!

Project template

This project is generated and maintained with copier-python.