Skip to main content

openscad_cpp_evaluator

A C++20 port of openscad_evaluator (Python): an AST-walking geometry engine that takes a parsed OpenSCAD AST and produces Manifold CSG geometry, ready to export to STL/OBJ/OFF/3MF or hand off to a renderer.

Built on:

  • openscad_cpp_parser (git submodule) for lexing/parsing/AST/scope resolution.
  • Manifold v3.5.2 for the actual CSG boolean/mesh engine.
  • Boost.Polygon for roof()'s Voronoi-diagram construction.
  • nothings/stb (header-only) for surface()'s image loader and the built-in font provider's TrueType parsing/rasterization.

All fetched automatically via CMake FetchContent — no manual dependency installation beyond the toolchain below.

Status

All planned phases (0–9) are complete: the full primitive/transform/boolean/modifier/control-flow language surface, every builtin function, STL/OBJ/OFF/3MF import and export, hull()/minkowski()/ linear_extrude()/rotate_extrude()/roof()/offset()/surface()/DXF & SVG import/text(), an opt-in content-hash geometry cache, per-call-site profiling, and a gdb-style --debug REPL. See CLAUDE.md for the full phase-by-phase history and architecture notes.

Build

Requires:

  • CMake ≥ 3.24
  • A C++20 compiler (Clang, GCC, or MSVC — all three are covered by CI)
  • Bison ≥ 3.8 and Flex
    • macOS: brew install bison flex (the system bison is too old; CMake auto-detects Homebrew's)
    • Linux: sudo apt-get install bison flex
    • Windows: MSYS2's bison/flex (pacman -S bison flex) — GitHub's windows-latest runner ships MSYS2 pre-installed at C:\msys64; CMake auto-detects it there too

GoogleTest and every other C++ dependency are fetched automatically.

git clone --recurse-submodules <this-repo>
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

(Omitting -DCMAKE_BUILD_TYPE=Release builds unoptimized — pass it explicitly for anything performance-sensitive.)

On Windows, CMake defaults to the multi-config Visual Studio generator, which ignores CMAKE_BUILD_TYPE; pass --config Release to cmake --build (and -C Release to ctest) instead.

Test

ctest --test-dir build --output-on-failure

Run a single binary or filter:

build/tests/oscad_eval_tests
build/tests/oscad_eval_tests --gtest_filter='FormatNumber.*'

The suite runs twice in CI — once with the bytecode VM on (the default) and once with it off (OSCAD_BYTECODE_VM=0) — so a regression in either the compiled or interpreted expression-eval path is caught.

CLI

build/tools/cli/openscad-cpp-evaluator <input.scad> -o <output.{stl,obj,off,3mf}> [--format stl|obj|off|3mf] [--debug]

The output format is inferred from -o's extension, or set explicitly with --format. --debug drops into a gdb-style REPL (break/run/continue/step/next/finish/print/ backtrace/set/list/quit/help) before and during evaluation.

build/tools/cli/openscad-cpp-evaluator model.scad -o model.stl

Architecture

See CLAUDE.md for the full per-file architecture map, the Python-reference cross-check history, and the rationale behind every non-obvious design choice (the two-pass resolve/generate CSG pipeline, the FontProvider injection seam, the closure-detection rule, etc.).

CI

GitHub Actions builds and tests on Linux, macOS, and Windows on every push/PR (.github/workflows/ci.yml).

Metadata

Release files for openscad-cpp-evaluator 1.51.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openscad-cpp-evaluator 1.51.0
File Size Uploaded Provenance Actions
openscad_cpp_evaluator-1.51.0.tar.gz 1.9 MB Without provenance Details for openscad_cpp_evaluator-1.51.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for openscad-cpp-evaluator 1.51.0
File Actions
openscad_cpp_evaluator-1.51.0-cp312-abi3-win_arm64.whl CPython 3.12 abi3 Windows ARM64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-win_arm64.whl
openscad_cpp_evaluator-1.51.0-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-win_amd64.whl
openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.28+ ARM64, Linux glibc 2.27+ ARM64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_x86_64.whl CPython 3.12 abi3 macOS 13.0+ x86-64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_x86_64.whl
openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_arm64.whl CPython 3.12 abi3 macOS 13.0+ ARM64 Details for openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_arm64.whl

Total release size: 50.3 MB

Release files / openscad_cpp_evaluator-1.51.0.tar.gz

Download URL openscad_cpp_evaluator-1.51.0.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
d391edee6a8c8b6cfce04f39cbd8c1c15c05572acb84589a19834a0f00556d00
BLAKE2b-256 checksum
How to use checksums
f587ca68be1739e0ac36fc06e204d59b06d45704ba0f955afe6229716851e734
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-win_arm64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-win_arm64.whl
Size 10.6 MB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
9ea642272ff5abdea4b91d799c6184fc386acc5ed1152baabf5e54e8cd43db15
BLAKE2b-256 checksum
How to use checksums
5b6bd756dfc0423627887d93fe355123730c70c9efaba0089b4ac4278686b234
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-win_amd64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-win_amd64.whl
Size 11.0 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
0fa52ba36bf1d40182ab0f4d29f7934f123fe041bbe60d08040b4f7edf60539b
BLAKE2b-256 checksum
How to use checksums
e1fcfbb1302d21811b31cc777d362eb19fdea1a6d503c285082b02995fab0bbc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 7.7 MB
Tags CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
64823bbb402fb1f149639992357b75f9984329bbd0d426f55841552d01b970dd
BLAKE2b-256 checksum
How to use checksums
bccf279b937ccfbe51ae9cac8425d2ab16f75fb534019c1ac34001de8b75136d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 7.2 MB
Tags CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
7c885ee3cb7e2709263b38f65780c828f4d8fbcae0c03f13a6554349fba83d2c
BLAKE2b-256 checksum
How to use checksums
aabf4bc93d37a71024f8aa3429b7d0a194667d889e8112ffb9f49f561c2264ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_x86_64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_x86_64.whl
Size 6.1 MB
Tags CPython 3.12 abi3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
407257a490e9f3366723921ef3f7841cb89d33f206bb0b33a657e886943cb0fe
BLAKE2b-256 checksum
How to use checksums
1a757a06ac872dd02455b730b88e4f41f826efcd5166a4d96041c9004d396c2d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_arm64.whl

Download URL openscad_cpp_evaluator-1.51.0-cp312-abi3-macosx_13_0_arm64.whl
Size 5.8 MB
Tags CPython 3.12 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
27f19f976351f3f35f39ca0ec33b5907f5ebce9a6ed4448d415e6509fa72bc14
BLAKE2b-256 checksum
How to use checksums
dc28fe730a8dc13ea758fdb50217ed5123028f1559c4c02c7c50b2265a554b96
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for openscad-cpp-evaluator 1.51.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.51.0 This release

7 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page