Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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 上。
Expand Down
57 changes: 57 additions & 0 deletions tests/test_smoke.py
Original file line number Diff line number Diff line change
@@ -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()
Loading