Stretch Body low level Python API
Project description
Stretch Body
The stretch_body package provides a low level Python API to the Hello Robot Stretch hardware. This package comes pre-installed on Stretch robots. Tutorials for using this package can be found on the docs.
Installing
This package comes pre-installed on Stretch robots. To install or upgrade to a stable Stretch Body for Python3, run:
$ python3 -m pip install --upgrade hello-robot-stretch-body
To install or upgrade to a pre-release of Stretch Body for Python3, run:
$ python3 -m pip install --upgrade --pre hello-robot-stretch-body
Please report feedback on the Issue Tracker or the Forum.
Running tests
There are a number of unit, functional, and performance tests within the test/
folder, separated into test suites by different files. Suites are separated by a device or functionality within Stretch Body that is being tested.
In Python3, run python3 -m unittest test.test_<suite-name>
.
For example, to run the stretch_body.robot.Robot
functional tests, run:
$ git clone https://github.com/hello-robot/stretch_body.git
$ cd stretch_body/body
$ python3 -m unittest test.test_robot
Developing
The source code for Stretch Body resides within the stretch_body/
folder. You can install Stretch Body as "editable", and directly edit the source code to test changes.
In Python3, run python3 -m pip install -e .
For example, to test changes to stretch_body.robot.Robot
, run:
$ python3 -m pip uninstall hello-robot-stretch-body # ensure previous Stretch Body installations are removed
$ git clone https://github.com/hello-robot/stretch_body.git
$ cd stretch_body/body
$ python3 -m pip install -e .
Now, make desired edits to the stretch_body/body/stretch_body/robot.py file. Software using Stretch Body is now using the modified stretch_body.robot.Robot
class.
Deploying
Increment the version number and run the deploy.sh
script. Verify the new release is reflected on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hello-robot-stretch-body-0.7.22.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c3ef256dc1897b1f58a8a6535d3709481c7e1c4316ce0cc66e23ca5c9c8f5915 |
|
MD5 | 8ce07f12dc4b3ba0b9fb55221e85df6a |
|
BLAKE2b-256 | 6eeeec4254d36ab193c793d4c8f763174a4a5f9b5f952967653f7ae5118b8e3b |
Hashes for hello_robot_stretch_body-0.7.22-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6bbb36f507c2c4884a4c9df7b3883e38f6852cd1808359b35e52644b89283ba7 |
|
MD5 | 2c471cbf3299b598ca6ac494ed1955f9 |
|
BLAKE2b-256 | 1dd4d263a5d97af44e1831effdd97fbd4c19316b8d86556ac2f5d152f35bc2d7 |