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

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

Built distributions (wheels)

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

Total release size: 71.3 MB

Release files / openscad_cpp_evaluator-1.55.4.tar.gz

Download URL openscad_cpp_evaluator-1.55.4.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
72b69dd2c0939e4aa7c26493d773b7ca50a823233d373ff7ae405ccf122bb343
BLAKE2b-256 checksum
How to use checksums
e4fe18883a19abb84e2833ecb6388d9df90d10ddbea45d31b22498a0ec793f0f
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.4-cp312-abi3-win_arm64.whl

Download URL openscad_cpp_evaluator-1.55.4-cp312-abi3-win_arm64.whl
Size 17.1 MB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
9eef222f6e8023d4ef924740a720ccac057d345007b830c80f4d5f13c1dd00ce
BLAKE2b-256 checksum
How to use checksums
31442633538d836e41eed0f82529b8119e84148440a2e96db5e754f4460318fd
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.4-cp312-abi3-win_amd64.whl

Download URL openscad_cpp_evaluator-1.55.4-cp312-abi3-win_amd64.whl
Size 17.2 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
eca8a2cdb12d113e49e4961bce9925c0e0e27a5ff086275f1de575c917471963
BLAKE2b-256 checksum
How to use checksums
ca817e3e7661d970c90baf58da3dc336a2fac0509ea04c0da4662139043696db
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.4-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.4-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
c67ca680e630270816aead4f1b48a25da7bc2e77bc475f5abd3fa4813e98ffde
BLAKE2b-256 checksum
How to use checksums
abffcde428adcc9994c07be6c3060f9813eee9d1cab4955bcf15574f0d3a536c
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.4-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL openscad_cpp_evaluator-1.55.4-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
8368c5ce49ecfa69c9e114481450d0db67d69de34baf583aed3342fa2d41ade6
BLAKE2b-256 checksum
How to use checksums
8061c22d1c1ee1818ddc6167b8d4103ca6e7c68ea62f6c8714fa3ba42c4f628e
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.4-cp312-abi3-macosx_13_0_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.4-cp312-abi3-macosx_13_0_x86_64.whl
Size 8.1 MB
Tags CPython 3.12 abi3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
8a37226b111a64529bfc43e451a183f20f53a86368cc0e08e87e7d6313e0505f
BLAKE2b-256 checksum
How to use checksums
46731ae6602acf800b5f6a0c21dc95fecdc3f3999f5372afdc0bb4b1ba976b87
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.4-cp312-abi3-macosx_13_0_arm64.whl

Download URL openscad_cpp_evaluator-1.55.4-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
db8ae72a9c1288490aa4dc69178dcd72bc302344806be83e1e34413445ea2060
BLAKE2b-256 checksum
How to use checksums
30e9137876c46132b22a3f4f6972f053b408cb063779d906c878035e90c7c75a
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.4

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