reachy2-sdk 1.0.3

Reachy 2 SDK

Python SDK for Reachy 2

Install

Use the following command to install:

$ pip install -e .[dev]

The [dev] option includes tools for developers.

Usage

Check out the examples folder for jupyter notebooks and example scripts.

Documentation

Documentation is generated via pdoc. It can be generated locally with:

pdoc reachy2_sdk --output-dir docs --logo "https://www.pollen-robotics.com/img/company/logo/pollen_logo_square_black.svg"

Unit tests

To ensure everything is functioning correctly, run the unit tests. There are two groups of tests: offline and online. Offline tests check internal functions using mock objects. Online tests require a connection to a simulated robot (e.g., in rviz), and the virtual robot should exhibit movement during these tests.

To execute the tests, use pytest with an optional category:

$ pytest [-m offline|online]

Note that only offline tests are executed by the Continuous Integration/Continuous Deployment (CI/CD) pipeline, as they don't require a gRPC connection.

Camera tests

Camera tests have their own marks because it requires the camera to be plugged to the sdk server (sr_camera and/or teleop_camera).

$ pytest -m [sr_camera | teleop_camera]

Logs

The SDK relies on the python logging system. Set the desired debug level to see messages from the SDK.

import logging
logging.basicConfig(level=logging.DEBUG)