Stretch RE1 low level Python API
Project description
The stretch_body package provides a low level Python API to the Hello Robot Stretch RE1 hardware.
Installing
To install stable Stretch Body for Python2, run:
`bash $ python -m pip install --upgrade hello-robot-stretch-body `
To install a pre-release of Stretch Body for Python2, run:
`bash $ python -m pip install --upgrade --pre hello-robot-stretch-body `
Please report feedback on the [Issue Tracker](https://github.com/hello-robot/stretch_body/issues) or the [Forum](https://forum.hello-robot.com/).
For Python3, substitute python with python3.
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 Python2, run python -m unittest test.test_<suite-name>. For Python3, substitute python with python3.
For example, to run the stretch_body.robot.Robot functional tests, run
`bash $ git clone https://github.com/hello-robot/stretch_body.git $ cd stretch_body/body $ python -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 Python2, run python -m pip install -e . For Python3, substitute python with python3.
For example, to test changes to stretch_body.robot.Robot, run
`bash $ git clone https://github.com/hello-robot/stretch_body.git $ cd stretch_body/body $ python -m pip install -e . `
Now, make desired edits to the [stretch_body/body/stretch_body/robot.py](./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.
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.1.12.dev5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 90e62c058f2f84d286c58423c5b210ae48e37a94c3352d56ea9ce36160c16287 |
|
MD5 | 5ce64e4acde98980c6584cbef9de5f07 |
|
BLAKE2b-256 | 1046b6c17d1bb2cb55a68c22e374433fa69391f63f2390e7d93f1a89a9036c37 |
Hashes for hello_robot_stretch_body-0.1.12.dev5-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 478ee2b610b07346ab95ac2b50720db8f6d9acd278fb68a9fc9789c0c7bf773d |
|
MD5 | e1ac9768bff0b3b8d833b046041c0d3f |
|
BLAKE2b-256 | 7995cde50a0b78d666b9ba1ac16c75b2fcb0a858dcadd5f4e8e970eda304e1be |