ros-ws 0.6.0.dev2

Simple tools for working with ROS source packages

ros-ws is a collection of simple tools for working with ROS source packages.

Installation

The ros-ws software uses pip to install itself. If you don’t have it yet, it is available as python-pip at Debian and Ubuntu. (Install using sudo apt install python-pip.)

Installation from PyPI

pip install ros-ws

For development it is recommended to install ros-ws with pip install -e. This installs a package in editable mode.

Installation from source

If you like to both use and hack ros-ws, you can ‘install’ the software by pointing the installation to the development code.

1. Make ros-ws available locally, eg by download or cloning the repository, for example

   git clone https://github.com/Rayman/ros-ws.git

2. Install using pip with the editable option -e DIR.

   cd ros-ws
   pip install --user -e .

   The final . says that pip should redirect the ws command relative to this directory (to ./src/ros-ws).

Usage

TODO: create a workspace

ws create /opt/ros/humble
ws list
ws switch myworkspace

Comparison with tue-env

• Separation between distro definition and the tool

• Distro definition according to REP 143

• Dependency definition according to REP 112

• Parallel git clone/pull

• Python (instead of bash)

Uninstall

pip uninstall ros-ws