Use the following command to install:
$ pip install -e .[dev]
The [dev] option includes tools for developers.
Check out the examples folder for jupyter notebooks and example scripts.
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"
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 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]
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)