semvec/pypi-packages huggingface dataset:
hello-robot-stretch-body-dev 0.3.0
Stretch RE1 low level Python API

Stretch Body
============

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.
hello-robot-stretch-body-tools-dev 0.3.0
Stretch Body Tools

Stretch Body Command Line Tools
===============================

This package provides Python tools that work with the Hello Robot Stretch Body package. These tools perform common tasks when working with Stretch RE1 (e.g. homing and stowing), and serve as tutorial code for working on various parts of the robot.

Installing
----------

To install stable Stretch Body Command Line Tools for Python2, run:

```bash
$ python -m pip install --upgrade hello-robot-stretch-body-tools
```

To install a pre-release of the Command Line Tools for Python2, run:

```bash
$ python -m pip install --upgrade --pre hello-robot-stretch-body-tools
```

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`.

Usage
-----

All of the command-line tools reside within the `bin/` folder. When this package is installed, they are accessible from anywhere as command-line tools. For example, to perform a robot system check, run:

```bash
$ stretch_robot_system_check.py
```

Developing
----------

The source code for the command-line tools resides within the `bin/` folder. You can install the tools package 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 the  `stretch_robot_home.py` script, run

```bash
$ git clone https://github.com/hello-robot/stretch_body.git
$ cd stretch_body/tools
$ python -m pip install -e .
```

Now, make desired edits to the [stretch_robot_home.py](./bin/stretch_robot_home.py) file. Executing the script on the command-line will now run your modified version.

Deploying
---------

Increment the version number and run the `deploy.sh` script.