From 2a8eb509238e27436d27f789d1f5547138b64c28 Mon Sep 17 00:00:00 2001 From: Laurence Young Date: Tue, 3 Nov 2026 18:05:37 +0800 Subject: [PATCH 1/2] test: add minimal offline smoke tests --- tests/test_smoke.py | 57 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 tests/test_smoke.py diff --git a/tests/test_smoke.py b/tests/test_smoke.py new file mode 100644 index 0000000..c5de40b --- /dev/null +++ b/tests/test_smoke.py @@ -0,0 +1,57 @@ +"""Minimal offline smoke tests for the public API.""" + +import math +import unittest + +import litearm +from litearm import ( + Arm, + CartesianPlanError, + CommandRejectedError, + ForkedSessionError, + LiteArmError, + NotConnectedError, + UnsupportedByFirmwareError, + mat_to_rpy, + rpy_to_mat, +) +from litearm.testing import FakeTransport + + +class PublicApiTest(unittest.TestCase): + def test_version(self): + self.assertEqual(litearm.__version__, "2.1.0") + + def test_error_hierarchy(self): + self.assertTrue(issubclass(UnsupportedByFirmwareError, CommandRejectedError)) + self.assertTrue(issubclass(ForkedSessionError, NotConnectedError)) + self.assertTrue(issubclass(CartesianPlanError, LiteArmError)) + self.assertFalse(issubclass(CartesianPlanError, CommandRejectedError)) + + def test_pose_roundtrip(self): + rpy = (0.2, -0.3, 1.1) + rot = rpy_to_mat(rpy) + back = mat_to_rpy(rot) + for got, want in zip(back, rpy): + self.assertTrue(math.isclose(got, want, abs_tol=1e-9)) + + # A rotation matrix is orthonormal with determinant +1. + for i in range(3): + for j in range(3): + dot = sum(rot[k][i] * rot[k][j] for k in range(3)) + self.assertTrue(math.isclose(dot, 1.0 if i == j else 0.0, abs_tol=1e-9)) + + def test_fake_transport_session(self): + arm = Arm(transport_factory=lambda port: FakeTransport(), move_timeout=2.0) + arm.connect("fake") + try: + state = arm.get_state() + self.assertIsNotNone(state.value) + self.assertEqual(len(state.value.q), 7) + self.assertGreaterEqual(state.hz, 0.0) + finally: + arm.close() + + +if __name__ == "__main__": + unittest.main() From 326cd778ca226cc32622ff6ce22b70110b13a8ff Mon Sep 17 00:00:00 2001 From: Laurence Young Date: Tue, 3 Nov 2026 18:05:46 +0800 Subject: [PATCH 2/2] ci: run the minimal test suite --- .github/workflows/ci.yml | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b14d196..9254579 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,9 +1,9 @@ -# 构建门禁。 +# 测试门禁。 # -# 跑在 PR 与默认分支的 push 上。仓库不包含测试套件:这里只验证包能安装、能 import、 -# 能构建,挡住坏掉的安装与 pyproject.toml。 +# 跑在 PR 与默认分支的 push 上。仓库保留一套最小离线测试:公开 API、错误层级、 +# 位姿数学和 FakeTransport 会话;它不连接真机。 # ⚠ CI 里**绝不**设 LITEARM_LIVE —— 那会去开 /dev/ttyACM0 连真机。 -# 构建单独成 workflow: 它跑在 PR 上, 而 release workflow 跑在默认分支的 push 上。 +# 测试单独成 workflow: 它跑在 PR 上, 而 release workflow 跑在默认分支的 push 上。 # 两者混在一起会让「发布坏了」和「PR 坏了」互相挡住。 name: CI @@ -40,13 +40,16 @@ jobs: with: python-version: ${{ matrix.python-version }} - # 没有测试套件: 装得上、import 得进来, 就说明包结构与依赖没坏。 + # 安装后先跑最小离线测试,再验证构建。 - name: Install run: pip install -e . - name: Import smoke run: python -c "import litearm; print(litearm.__version__)" + - name: Test + run: python -m unittest discover -s tests -v + # release workflow 只在合进默认分支之后才打包, 那时 tag 和 GitHub Release # 都已经生成 —— 构建到那一步才炸, 等于白烧一个版本号。在这里先构建一次, # 让坏掉的 pyproject.toml 挡在 PR 上。