a5e6bf8eb6
Plural topology getters (get_edges/get_faces/get_wires/get_vertices/ get_solids/get_inner_wires/get_edge_occurrences and the Compound variants) now accept ONLY an index. The no-argument list form raises a SimpleCADError with migration guidance (enumerate via ql.<kind>().resolve(shape), pick via get_X(index)). This closes the selection channel that escapes the graph: Python loops over bare lists lose the predicate, capture kernel artifacts (the periodic-face seam edges that broke FCStd translation), and leave no cardinality contract. - each shape class keeps its enumeration logic as private _iter_<kind>(); indexed picks record geo-select nodes as before (contract test added); Compound getters gain the same indexed recording they lacked - _TopologySelectionList (the __getitem__ recording vehicle, which also made get_X()[i] a silent escape hatch) is retired - all 109 internal call sites, 165 test call sites, and 31 example call sites migrated: SDK/tests use the private channel, user-facing examples use ql.<kind>().resolve(...) - QL _resolve_scope_items switches to the private channel; scene contract profile descriptions synced; error strings recommending bracket indexing rewritten - skill docs: strict prohibition added to SKILL.md global rules (new rule 6), core README contract statement rewritten, solid/wire/face/ shell/tagged_mixin pages re-exemplified with QL, geometric-validation anti-pattern section updated; mirrors rebuilt via tools/skillbuild.py Gates: full suite 1418 passed / 5 skipped; translator suites 133 passed; u_link stage verifiers + render check ALL PASS; scadpkg->FCStd retranslation verified (5 visible deliverables, 167-object editable tree).
145 lines
5.3 KiB
Python
145 lines
5.3 KiB
Python
"""Tests for tracking transforms and feature operations."""
|
|
|
|
import unittest
|
|
import numpy as np
|
|
|
|
import simplecadapi as scad
|
|
from simplecadapi.topology import TopoKind, TopoEvent, TopoRef, TopoDelta
|
|
from simplecadapi.topology.tracking import (
|
|
tracked_translate,
|
|
tracked_rotate,
|
|
tracked_extrude,
|
|
tracked_fillet,
|
|
tracked_chamfer,
|
|
TrackedResult,
|
|
)
|
|
|
|
|
|
class TestTrackedTranslate(unittest.TestCase):
|
|
def setUp(self):
|
|
self.box = scad.make_box_rsolid(10, 10, 10)
|
|
|
|
def test_translate_returns_tracked_result(self):
|
|
result = tracked_translate(self.box, (5, 0, 0))
|
|
self.assertIsInstance(result, TrackedResult)
|
|
self.assertIsNotNone(result.shape)
|
|
|
|
def test_translate_preserves_volume(self):
|
|
result = tracked_translate(self.box, (5, 0, 0))
|
|
self.assertAlmostEqual(
|
|
result.shape.get_volume(), self.box.get_volume(), places=6
|
|
)
|
|
|
|
def test_translate_all_faces_modified(self):
|
|
result = tracked_translate(self.box, (5, 0, 0))
|
|
modified = [r for r in result.delta.modified if r.kind == TopoKind.FACE]
|
|
original_faces = len(self.box._iter_faces())
|
|
self.assertEqual(len(modified), original_faces)
|
|
|
|
def test_translate_no_generated(self):
|
|
result = tracked_translate(self.box, (5, 0, 0))
|
|
self.assertEqual(len(result.delta.generated), 0)
|
|
self.assertEqual(len(result.delta.deleted), 0)
|
|
|
|
def test_translate_result_is_solid(self):
|
|
result = tracked_translate(self.box, (5, 0, 0))
|
|
self.assertIsInstance(result.shape, scad.Solid)
|
|
|
|
|
|
class TestTrackedRotate(unittest.TestCase):
|
|
def setUp(self):
|
|
self.box = scad.make_box_rsolid(10, 10, 10)
|
|
|
|
def test_rotate_returns_tracked_result(self):
|
|
result = tracked_rotate(self.box, 45.0, (0, 0, 1))
|
|
self.assertIsInstance(result, TrackedResult)
|
|
self.assertIsNotNone(result.shape)
|
|
|
|
def test_rotate_preserves_volume(self):
|
|
result = tracked_rotate(self.box, 45.0, (0, 0, 1))
|
|
self.assertAlmostEqual(
|
|
result.shape.get_volume(), self.box.get_volume(), places=4
|
|
)
|
|
|
|
def test_rotate_all_faces_modified(self):
|
|
result = tracked_rotate(self.box, 45.0, (0, 0, 1))
|
|
modified = [r for r in result.delta.modified if r.kind == TopoKind.FACE]
|
|
original_faces = len(self.box._iter_faces())
|
|
self.assertEqual(len(modified), original_faces)
|
|
|
|
def test_rotate_no_generated(self):
|
|
result = tracked_rotate(self.box, 45.0, (0, 0, 1))
|
|
self.assertEqual(len(result.delta.generated), 0)
|
|
|
|
|
|
class TestTrackedExtrude(unittest.TestCase):
|
|
def setUp(self):
|
|
self.profile = scad.make_rectangle_rface(5.0, 3.0)
|
|
|
|
def test_extrude_returns_tracked_result(self):
|
|
result = tracked_extrude(self.profile, (0, 0, 1), 10.0)
|
|
self.assertIsInstance(result, TrackedResult)
|
|
self.assertIsNotNone(result.shape)
|
|
|
|
def test_extrude_has_correct_volume(self):
|
|
result = tracked_extrude(self.profile, (0, 0, 1), 10.0)
|
|
expected_vol = self.profile.get_area() * 10.0
|
|
self.assertAlmostEqual(result.shape.get_volume(), expected_vol, places=5)
|
|
|
|
def test_extrude_generates_new_faces(self):
|
|
result = tracked_extrude(self.profile, (0, 0, 1), 10.0)
|
|
self.assertGreater(len(result.delta.generated), 0)
|
|
|
|
def test_extrude_has_modified_or_preserved_face(self):
|
|
result = tracked_extrude(self.profile, (0, 0, 1), 10.0)
|
|
# The profile face becomes part of the extruded solid (either modified or
|
|
# generated depending on OCC version)
|
|
has_changes = (
|
|
len(result.delta.modified) > 0
|
|
or len(result.delta.preserved) > 0
|
|
or len(result.delta.generated) > 0
|
|
)
|
|
self.assertTrue(has_changes)
|
|
|
|
|
|
class TestTrackedFillet(unittest.TestCase):
|
|
def setUp(self):
|
|
self.box = scad.make_box_rsolid(10, 10, 10)
|
|
# Select some edges for filleting
|
|
self.edges = [self.box.get_edges(i) for i in range(4)]
|
|
|
|
def test_fillet_returns_tracked_result(self):
|
|
result = tracked_fillet(self.box, self.edges, 0.5)
|
|
self.assertIsInstance(result, TrackedResult)
|
|
self.assertIsNotNone(result.shape)
|
|
|
|
def test_fillet_volume_decreased(self):
|
|
result = tracked_fillet(self.box, self.edges, 0.5)
|
|
self.assertLess(result.shape.get_volume(), self.box.get_volume())
|
|
|
|
def test_fillet_has_modified_faces(self):
|
|
result = tracked_fillet(self.box, self.edges, 0.5)
|
|
# Fillet modifies edge-adjacent faces; OCC may report new toroidal faces
|
|
# as Modified rather than Generated
|
|
total_changes = len(result.delta.modified) + len(result.delta.generated)
|
|
self.assertGreater(total_changes, 0)
|
|
|
|
|
|
class TestTrackedChamfer(unittest.TestCase):
|
|
def setUp(self):
|
|
self.box = scad.make_box_rsolid(10, 10, 10)
|
|
self.edges = [self.box.get_edges(i) for i in range(4)]
|
|
|
|
def test_chamfer_returns_tracked_result(self):
|
|
result = tracked_chamfer(self.box, self.edges, 0.5)
|
|
self.assertIsInstance(result, TrackedResult)
|
|
self.assertIsNotNone(result.shape)
|
|
|
|
def test_chamfer_volume_decreased(self):
|
|
result = tracked_chamfer(self.box, self.edges, 0.5)
|
|
self.assertLess(result.shape.get_volume(), self.box.get_volume())
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|