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.
1 maintainer
Release files for hello-robot-stretch-body 0.7.31
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hello_robot_stretch_body-0.7.31.tar.gz | 163.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hello_robot_stretch_body-0.7.31-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 354.6 kB
Release files / hello_robot_stretch_body-0.7.31.tar.gz
| Download URL | hello_robot_stretch_body-0.7.31.tar.gz |
|---|---|
| Size | 163.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3858bb54939a48869927e24967d6b66e188f82281ae1ec263ac59183ec5843a
|
|
BLAKE2b-256 checksum How to use checksums |
8b5b10866cf61edcf4815fff786af290c449f5cbd2261381ad12373ee94ddac2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / hello_robot_stretch_body-0.7.31-py3-none-any.whl
| Download URL | hello_robot_stretch_body-0.7.31-py3-none-any.whl |
|---|---|
| Size | 190.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4e73403e125afdb613d806a073f7c8d1fe4566e2fef9091c101e58a634844f8
|
|
BLAKE2b-256 checksum How to use checksums |
00707b263201d3815bedf81a588857466effbcf5c2c8931d50f29a1596d2b7d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
