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

Built distributions (wheels)

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

Total release size: 71.4 MB

Release files / openscad_cpp_evaluator-1.55.0.tar.gz

Download URL openscad_cpp_evaluator-1.55.0.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
2938c55437b6f609fd8d4a226567c07a536184014d8896426535f6e0267a77ea
BLAKE2b-256 checksum
How to use checksums
6e7b3883464ef7431d6b15a45f2778c24de5aa48e38826c540ae0a51f8ac64b9
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.0-cp312-abi3-win_arm64.whl

Download URL openscad_cpp_evaluator-1.55.0-cp312-abi3-win_arm64.whl
Size 17.2 MB
Tags CPython 3.12 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
5f37c988b2f048e93b5ad29eabb6bada2f985451b47fed5609560749adbcb5b9
BLAKE2b-256 checksum
How to use checksums
0943554f8761e0f0b87290761a002e5515cb05e7e7ae6e28b3dc3e7c3f4d3ee5
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.0-cp312-abi3-win_amd64.whl

Download URL openscad_cpp_evaluator-1.55.0-cp312-abi3-win_amd64.whl
Size 17.3 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
86ee0440b1de74a5e3df05b544173b808e1d33a5b4fbb7a7dddae591f565d04f
BLAKE2b-256 checksum
How to use checksums
124c75f61d4d9c8ca34065bb7ea614f492efcfb6e4653d3adee1338b1e8bc3ae
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.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.0-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
de71ca2e9aa04d4362524218f86384d6fd704254751a3805d8e0d6db7637fe46
BLAKE2b-256 checksum
How to use checksums
85570f2154d9ad2430bca77c0c30ad70b07f5c4dc08423a55c2737ac2951e7f2
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.0-cp312-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL openscad_cpp_evaluator-1.55.0-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
56a34d3f40d74810b28e5062341e83fa4fba6c5b9baca246db2ad9caedbe0f4f
BLAKE2b-256 checksum
How to use checksums
fa7fdb0abaca18d1f77bea7673971663996ebb7388a6f74d89e75d7ae79a2e00
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.0-cp312-abi3-macosx_13_0_x86_64.whl

Download URL openscad_cpp_evaluator-1.55.0-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
0e868ccc209b7174b5a8987822544bd4fc40a59a6c4d4a32f46194400e5db349
BLAKE2b-256 checksum
How to use checksums
b79b3b6849d7b7a13a73b284d9feb1d28494e072616b15cba98265f9514a5228
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.0-cp312-abi3-macosx_13_0_arm64.whl

Download URL openscad_cpp_evaluator-1.55.0-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
10e3a1efbdd1d5c443bc6d80a23e8323a7a6cf021253c565745108324de02fac
BLAKE2b-256 checksum
How to use checksums
2e9d38f7b745fab630438712287e92ef0a8ff9a7b797f6c1358eb01b28ad68cc
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.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.55.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