For Developers

Rebuilding the executable

python -m pip install pywebview pyinstaller pillow
build.bat

build.bat bundles app/ (including the 23 MB OpenCascade WebAssembly kernel) and razorcad.py into RazorCAD.exe with PyInstaller. If RazorCAD is open, the running copy is renamed to RazorCAD.old.exe and the new build is used from the next launch.

installer\build_installer.bat builds RazorCAD.exe and then RazorCAD-Setup.exe. Set the version in version.txt first.

Code signing

Both builds sign RazorCAD.exe, the thumbnail DLL and the setup once a code-signing certificate is set up; until then they say "Not signed" and carry on. tools\sign.py --check shows how signing is set up. installer\SIGNING.md explains how to get a certificate and set it up (a certificate on a USB token or in Windows by its thumbprint, a .pfx file, or a cloud signing service).

Regression tests

python tests/run_tests.py

This rebuilds the test parts in tests/parts with the real geometry kernel in headless Microsoft Edge. It compares every body's volume, area, faces and edges (and flat patterns) with tests/expected.json. It also runs checks done as a user does them: sketching, dimensioning and extruding, drawings, assemblies, mates, references, cosmetic threads, inch units, exploded drawing views, balloons and more. It needs Python's playwright package and exits with 1 on any difference. --update stores new expected results, --only runs some of them, and --make-parts makes the test parts again from tests/make_parts.js. See tests/README.md.

Working on the UI

Run python serve.py and open http://localhost:8765/ in a browser. In that mode files are downloaded instead of saved through dialogs. Set the RAZORCAD_DATA_DIR environment variable to keep a test run's recent-files list separate from your own.

Project layout