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
Metadata
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 | Provenance | |
|---|---|---|---|---|
| hello_robot_stretch_body-0.7.31.tar.gz | 163.9 kB | Without provenance | 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
|
Security for hello-robot-stretch-body 0.7.31
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
