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.55.2

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.55.2
File Size Uploaded Provenance Actions
openscad_cpp_evaluator-1.55.2.tar.gz 1.9 MB Without provenance Details for openscad_cpp_evaluator-1.55.2.tar.gz

Built distributions (wheels)

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

Total release size: 71.4 MB

Release files / openscad_cpp_evaluator-1.55.2.tar.gz

Download URL openscad_cpp_evaluator-1.55.2.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
9b6a7be2b86f6622b5f2a2a922f0b9726a957a85424a08f74f79f665ddc14704
BLAKE2b-256 checksum
How to use checksums
b05b7fcabf4c275505388ff4ac9f7e48de50a73224da49b5d15a743b445f8e0c
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.55.2-cp312-abi3-win_arm64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-win_arm64.whl
Size 17.2 MB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
9e353ec7747906c782df5de65f18bc9bcf19380527b7c58b5c3e2f7af5bfa658
BLAKE2b-256 checksum
How to use checksums
a5c7bee7da4b5a2c0debb3b30212c0dceb8ee48f87bbc2a45a47f87f5a32d2ec
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.55.2-cp312-abi3-win_amd64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-win_amd64.whl
Size 17.3 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
f52ced67058412dea990b98afb157644aacea9da85744f834f496e81d6d26760
BLAKE2b-256 checksum
How to use checksums
279f5a671c8dc69f5627dc36ad04a1e0137728504682b3c7678bb720cf87544f
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.55.2-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 9.9 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
3a5a66af9a3128c3114d308483a993661f975dddee5058aefc6743e1bd5812a4
BLAKE2b-256 checksum
How to use checksums
bd938afb9f5b418a9b3e7e29c5070f76071fc8983375855c4301287e8715fa00
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.55.2-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 9.4 MB
Tags CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
a55741c7d7d28628094994c4a8cace58d47eccbc2fa3a9952754e21013c40655
BLAKE2b-256 checksum
How to use checksums
0ecbcf76ecbaa531a29926691ae86d9392f90b9a68345e3f7a27cccec0d97006
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.55.2-cp312-abi3-macosx_13_0_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-macosx_13_0_x86_64.whl
Size 8.0 MB
Tags CPython 3.12 abi3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
2d442d2a758470d35efffc74fcf469e20125463a38634ea48fb32a633b5ab025
BLAKE2b-256 checksum
How to use checksums
d8a75b8d8d5235f09fdf9545d1353a99e39159f21cca6c6269b6532268b7a1e2
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.55.2-cp312-abi3-macosx_13_0_arm64.whl

Download URL openscad_cpp_evaluator-1.55.2-cp312-abi3-macosx_13_0_arm64.whl
Size 7.6 MB
Tags CPython 3.12 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
e50774b9aee4b7ccbaa34a7427e395ed708e8a8d4097e474306ba6125669e9d5
BLAKE2b-256 checksum
How to use checksums
9808c7126c772521e52747a72c280f607adf99f36e22cef12c4a49672914bd1b
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.55.2

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.55.2 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