blender-tests

name	blender-tests
description	Run this repo's headless Blender test suite (tests/run_tests.py) via podman against one or more pinned Blender versions. Use before a commit/PR, or to check cross-version compatibility.

Run the headless Blender test suite

A fixed script instead of an ad-hoc podman run ... -v "$(pwd)":/repo:Z ... invocation, so it can be whitelisted in permission settings by exact path rather than needing a broader podman run * rule (the $(pwd)-based mount is what made the ad-hoc version unsafe to whitelist as a fixed pattern — every invocation embeds a dynamic shell substitution).

.claude/skills/blender-tests/run_blender_tests.sh <version> [<version> ...]
# e.g.
.claude/skills/blender-tests/run_blender_tests.sh 5.2
.claude/skills/blender-tests/run_blender_tests.sh 4.1 4.5 5.0 5.1 5.2

Pulls docker.io/blenderkit/headless-blender:blender-<version>-stable if not already present, mounts the repo read-write at /repo inside the container, and runs blender --background --python-exit-code 1 --python /repo/tests/run_tests.py. Exit 0 only if every version's test run exits 0. Doesn't rely on the caller's $(pwd) or take a repo path — it derives the repo root from its own on-disk location, so call it directly from any cwd.

Matches this repo's CI matrix (currently 4.1/5.2, see .github/workflows/ci.yml) — use the full 4.1 4.5 5.0 5.1 5.2 set for a broader local check before a version-support-affecting change, matching what CLAUDE.md's "Known Blender version support" section says has been spot-checked.