Continue Blender Web parity task handoff

tools/web/check-action-armature-symmetrize-desktop.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+import hashlib
+import json
+import os
+import pathlib
+import shutil
+import sys
+import tempfile
+
+import bpy
+
+
+ARMATURE_NAME = "WebGapArmatureSymmetrizeArmature"
+OBJECT_NAME = "WebGapArmatureSymmetrizeObject"
+SOURCE_BONE = "WebGapArmatureSymmetrizeSource.L"
+MIRRORED_BONE = "WebGapArmatureSymmetrizeSource.R"
+OTHER_BONE = "WebGapArmatureSymmetrizeOther"
+
+
+def vector(value):
+    return [round(float(component), 6) for component in value]
+
+
+def ensure_edit_mode():
+    armature = bpy.data.armatures.get(ARMATURE_NAME)
+    obj = bpy.data.objects.get(OBJECT_NAME)
+    if armature is None or obj is None or obj.type != "ARMATURE" or obj.data != armature:
+        raise RuntimeError("armature.symmetrize fixture is missing")
+    bpy.context.view_layer.objects.active = obj
+    obj.select_set(True)
+    if obj.mode != "EDIT":
+        bpy.ops.object.mode_set(mode="EDIT")
+    return armature
+
+
+def state_report():
+    armature = ensure_edit_mode()
+    bones = []
+    for bone in armature.edit_bones:
+        bones.append({
+            "name": bone.name,
+            "selected": bool(bone.select),
+            "hidden": bool(bone.hide),
+            "parent": bone.parent.name if bone.parent else None,
+            "connected": bool(bone.use_connect),
+            "head": vector(bone.head),
+            "tail": vector(bone.tail),
+        })
+    return {
+        "object": OBJECT_NAME,
+        "armature": ARMATURE_NAME,
+        "activeBone": armature.edit_bones.active.name if armature.edit_bones.active else None,
+        "bones": bones,
+    }
+
+
+def stable(value):
+    return {
+        "object": value["object"],
+        "armature": value["armature"],
+        "activeBone": value["activeBone"],
+        "bones": sorted(value["bones"], key=lambda bone: bone["name"]),
+    }
+
+
+def main():
+    arguments = sys.argv[sys.argv.index("--") + 1 :]
+    if len(arguments) != 2:
+        raise SystemExit("usage: blender -b --factory-startup --python checker -- FIXTURE REPORT")
+    fixture, output = (pathlib.Path(value).resolve() for value in arguments)
+    bpy.ops.wm.open_mainfile(filepath=str(fixture), load_ui=False)
+    before = state_report()
+    names = {bone["name"] for bone in before["bones"]}
+    already_applied = MIRRORED_BONE in names and SOURCE_BONE in names
+    if not already_applied:
+        if names != {SOURCE_BONE, OTHER_BONE}:
+            raise RuntimeError(f"unexpected armature.symmetrize fixture: {before}")
+        if not next(bone for bone in before["bones"] if bone["name"] == SOURCE_BONE)["selected"]:
+            raise RuntimeError(f"symmetrize source is not selected: {before}")
+    ensure_edit_mode()
+    poll = bool(bpy.ops.armature.symmetrize.poll())
+    if not poll:
+        raise RuntimeError("ARMATURE_OT_symmetrize poll failed")
+    if not already_applied:
+        result = bpy.ops.armature.symmetrize(direction="NEGATIVE_X")
+        if result != {"FINISHED"}:
+            raise RuntimeError(f"ARMATURE_OT_symmetrize returned {result}")
+    after = state_report()
+    by_name = {bone["name"]: bone for bone in after["bones"]}
+    if MIRRORED_BONE not in by_name or SOURCE_BONE not in by_name or OTHER_BONE not in by_name:
+        raise RuntimeError(f"symmetrize did not create the mirrored bone: {after}")
+    source = by_name[SOURCE_BONE]
+    mirrored = by_name[MIRRORED_BONE]
+    other = by_name[OTHER_BONE]
+    if source["head"] != [1.0, 0.0, 0.0] or source["tail"] != [1.0, 1.0, 0.0]:
+        raise RuntimeError(f"symmetrize changed source geometry: {after}")
+    if mirrored["head"] != [-1.0, 0.0, 0.0] or mirrored["tail"] != [-1.0, 1.0, 0.0]:
+        raise RuntimeError(f"symmetrize mirror geometry mismatch: {after}")
+    if other["selected"]:
+        raise RuntimeError(f"symmetrize selected unrelated bone: {after}")
+    bpy.ops.object.mode_set(mode="OBJECT")
+    descriptor, temporary = tempfile.mkstemp(prefix="m16-armature-symmetrize-reopen-", suffix=".blend")
+    os.close(descriptor)
+    temporary_path = pathlib.Path(temporary)
+    try:
+        bpy.ops.wm.save_as_mainfile(filepath=str(temporary_path), check_existing=False, compress=True)
+        bpy.ops.wm.open_mainfile(filepath=str(temporary_path), load_ui=False)
+        reopened = state_report()
+        if stable(reopened) != stable(after):
+            raise RuntimeError(f"armature.symmetrize save/reopen drift: {after} != {reopened}")
+        shutil.copyfile(temporary_path, fixture)
+        report = {
+            "schemaVersion": 1,
+            "task": "M16-GAP-00263",
+            "operation": "ARMATURE_SYMMETRIZE_DESKTOP",
+            "fixture": str(fixture),
+            "fixtureSha256": hashlib.sha256(fixture.read_bytes()).hexdigest(),
+            "before": before,
+            "after": reopened,
+            "sourceBone": SOURCE_BONE,
+            "mirroredBone": MIRRORED_BONE,
+            "otherBone": OTHER_BONE,
+            "direction": "NEGATIVE_X",
+            "operatorStatus": "FINISHED" if not already_applied else "SKIPPED_ALREADY_APPLIED",
+            "mainMutation": "MIRRORED_SELECTED_BONE" if not already_applied else "MIRRORED_BONE_ALREADY_PRESENT",
+            "poll": poll,
+            "saveReopen": "EXACT",
+            "blenderVersion": bpy.app.version_string,
+        }
+        output.parent.mkdir(parents=True, exist_ok=True)
+        output.write_text(json.dumps(report, indent=2, sort_keys=True) + "\n", encoding="utf-8")
+        print(f"armature-symmetrize-desktop-ok source={SOURCE_BONE} mirrored={MIRRORED_BONE} direction=negative_x saveReopen=exact")
+    finally:
+        temporary_path.unlink(missing_ok=True)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except Exception as error:
+        print(f"armature-symmetrize-desktop-failed: {error}")
+        raise SystemExit(1)