Create test_reachy2.py

tests/robots/test_reachy2.py

@@ -0,0 +1,167 @@
+#!/usr/bin/env python
+
+# Copyright 2025 The HuggingFace Inc. team. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from contextlib import contextmanager
+from unittest.mock import MagicMock, patch
+
+import pytest
+import numpy as np
+
+from lerobot.robots.reachy2 import (
+    Reachy2Robot,
+    Reachy2RobotConfig,
+)
+
+
+# {lerobot_keys: reachy2_sdk_keys}
+REACHY2_JOINTS = {
+    "head.neck.yaw": "neck_yaw.pos",
+    "head.neck.pitch": "neck_pitch.pos",
+    "head.neck.roll": "neck_roll.pos",
+    "head.l_antenna": "l_antenna.pos",
+    "head.r_antenna": "r_antenna.pos",
+    "r_arm.shoulder.pitch": "r_shoulder_pitch.pos",
+    "r_arm.shoulder.roll": "r_shoulder_roll.pos",
+    "r_arm.elbow.yaw": "r_elbow_yaw.pos",
+    "r_arm.elbow.pitch": "r_elbow_pitch.pos",
+    "r_arm.wrist.roll": "r_wrist_roll.pos",
+    "r_arm.wrist.pitch": "r_wrist_pitch.pos",
+    "r_arm.wrist.yaw": "r_wrist_yaw.pos",
+    "r_arm.gripper": "r_gripper.pos",
+    "l_arm.shoulder.pitch": "l_shoulder_pitch.pos",
+    "l_arm.shoulder.roll": "l_shoulder_roll.pos",
+    "l_arm.elbow.yaw": "l_elbow_yaw.pos",
+    "l_arm.elbow.pitch": "l_elbow_pitch.pos",
+    "l_arm.wrist.roll": "l_wrist_roll.pos",
+    "l_arm.wrist.pitch": "l_wrist_pitch.pos",
+    "l_arm.wrist.yaw": "l_wrist_yaw.pos",
+    "l_arm.gripper": "l_gripper.pos",
+}
+
+REACHY2_VEL = {
+    "mobile_base.vx": "vx",
+    "mobile_base.vy": "vy",
+    "mobile_base.vtheta": "vtheta",
+}
+
+PARAMS = [
+    {},  # config par défaut
+    {"with_mobile_base": False},
+    {"with_mobile_base": False, "with_l_arm": False, "with_antennas": False},
+    {"with_r_arm": False, "with_neck": False, "with_antennas": False},
+]
+
+
+def _make_reachy2_sdk_mock():
+    r = MagicMock(name="ReachySDKMock")
+    r.is_connected.return_value = True
+
+    def _connect():
+        r.is_connected.return_value = True
+
+    def _disconnect():
+        r.is_connected.return_value = False
+
+    # Mock joints with some dummy positions
+    joints = {
+        k: MagicMock(present_position=round(0.1 + 0.01 * i, 2))
+        for i, k in enumerate(REACHY2_JOINTS.keys())
+    }
+    r.joints = joints
+
+    # Mock mobile base with some dummy odometry
+    r.mobile_base = MagicMock()
+    r.mobile_base.odometry = {
+        "x": 0.1,
+        "y": -0.2,
+        "theta": 21.3,
+        "vx": 0.001,
+        "vy": 0.002,
+        "vtheta": 0.0,
+    }
+
+    r.connect = MagicMock(side_effect=_connect)
+    r.disconnect = MagicMock(side_effect=_disconnect)
+
+    # Mock methods
+    r.turn_on = MagicMock()
+    r.reset_default_limits = MagicMock()
+    r.send_goal_positions = MagicMock()
+    r.turn_off_smoothly = MagicMock()
+    r.mobile_base.set_goal_speed = MagicMock()
+    r.mobile_base.send_speed_command = MagicMock()
+
+    return r
+
+
+@pytest.fixture(params=PARAMS, ids=lambda p: "default" if not p else ",".join(p.keys()))
+def reachy2(request):
+    # Mock cameras
+    fake_cams = {
+        "teleop_left": MagicMock(
+            width=640,
+            height=480,
+            connect=MagicMock(),
+            disconnect=MagicMock(),
+            async_read=MagicMock(return_value=np.zeros((10, 10, 3), dtype=np.uint8)),
+        ),
+    }
+
+    with (
+        patch(
+            "lerobot.robots.reachy2.robot_reachy2.ReachySDK",
+            side_effect=lambda *a, **k: _make_reachy2_sdk_mock(),
+        ),
+        patch(
+            "lerobot.robots.reachy2.robot_reachy2.make_cameras_from_configs",
+            return_value=fake_cams,
+        ),
+    ):
+        overrides = request.param
+        cfg = Reachy2RobotConfig(ip_address="192.168.0.200", **overrides)
+        robot = Reachy2Robot(cfg)
+        yield robot
+        if robot.is_connected:
+            robot.disconnect()
+
+
+def test_connect_disconnect(reachy2):
+    assert not reachy2.is_connected
+
+    reachy2.connect()
+    assert reachy2.is_connected
+
+    reachy2.reachy.turn_on.assert_called_once()
+    reachy2.reachy.reset_default_limits.assert_called_once()
+
+    reachy2.disconnect()
+    assert not reachy2.is_connected
+
+    reachy2.reachy.turn_off_smoothly.assert_called_once()
+    reachy2.reachy.disconnect.assert_called_once()
+
+
+def test_get_observation(reachy2):
+    reachy2.connect()
+    obs = reachy2.get_observation()
+
+    expected_keys = {f"{REACHY2_JOINTS[m]}" for m in reachy2.joints_dict.values()}
+    expected_keys.update(
+        f"{v}" for v in REACHY2_VEL.keys() if reachy2.config.with_mobile_base
+    )
+    expected_keys.update(reachy2.cameras.keys())
+    assert set(obs.keys()) == expected_keys
+