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

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

Built distributions (wheels)

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

Total release size: 71.4 MB

Release files / openscad_cpp_evaluator-1.55.1.tar.gz

Download URL openscad_cpp_evaluator-1.55.1.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
54c86e9e62b16f7b4c23f9c5bddd84675214cb3c23bf42c7771aa32708993e28
BLAKE2b-256 checksum
How to use checksums
92412b65eb2eece806779b852e5f567c86028e44d7b2ba2a8bc61f0e01ecf16d
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.1-cp312-abi3-win_arm64.whl

Download URL openscad_cpp_evaluator-1.55.1-cp312-abi3-win_arm64.whl
Size 17.2 MB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
34e042953eec79c245fbab6e4cafdde4b0b4ebe1457f7a9ae02ab074135e6226
BLAKE2b-256 checksum
How to use checksums
c0f8819c3b3a800e705bec45e3781c1c4dacdf9ec6566b1c9b4541c368506142
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.1-cp312-abi3-win_amd64.whl

Download URL openscad_cpp_evaluator-1.55.1-cp312-abi3-win_amd64.whl
Size 17.3 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
e1f77520a56542d602677de3fa70d187a987582bb32348ad81113c45d84e880a
BLAKE2b-256 checksum
How to use checksums
ff2ec34626f9c9ab380a250c3e7872b26ebb10a4518186db52e9213bc0ddcde8
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.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.1-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
49203513c884393c72798071eb5b4e55b879c2a93b3c763ca433ed5ff9586041
BLAKE2b-256 checksum
How to use checksums
85b0b2d96789d277f5bb68a2386329fc80ead5289a7c2734e1709090fa17dcdc
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.1-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL openscad_cpp_evaluator-1.55.1-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
727e790bd065addc2bdcb54e09e7492ca2fe69cc6c55b8f8ddc3d68734972340
BLAKE2b-256 checksum
How to use checksums
3693ce88f843794b8c994c6ae272e79e557b7c3a9c414403ccc66a86b56e94a4
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.1-cp312-abi3-macosx_13_0_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.1-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
658193aa0adfcc9e7e669d6652d6380b58512071d52a86da490e62f95b866d33
BLAKE2b-256 checksum
How to use checksums
ee801e5daa33a3ab5db0992d9e2416c948506947f1a66e482bec272ff1522a8f
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.1-cp312-abi3-macosx_13_0_arm64.whl

Download URL openscad_cpp_evaluator-1.55.1-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
3c17ef00652e42d217af3d5da8aad09ea2ee1c92160d9d81a1e6d9c5e8446e6f
BLAKE2b-256 checksum
How to use checksums
cd9937c567451a5cf2f9ff05947db925a87f101cb5e3c850de267d2f127e8571
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.1

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