robot-folders 0.7.0

robot_folders is your workspace handling utility around the ROS ecosystem.

Robot Folders

Welcome to robot_folders! robot_folders is a collection of utility scripts designed to streamline and facilitate the management of workspaces used for (ROS) development. It is designed to enhance efficiency in handling different environments, consisting of multiple workspaces like a catkin_workspace and colcon_workspace or a plain CMake workspace.

It focuses on optimizing the management of various subworkspaces, contributing to a seamless development experience.

Documentation

Documentation can be found on our GH pages.

Quick start

It is recommended to install robot_folders using pipx (You can install pipx using sudo apt install pipx).

pipx install robot-folders

Upgrade

To upgrade robot_folders using pipx do

pipx upgrade robot-folders

Shell setup

In order to use robot_folders you’ll have to call its source file. How to do this depends on the way you installed robot_folders and on the version of the installation tool.

In case you have installed robot_folders using pipx as described above (and given you use the bash shell), do:

# pipx < 1.3.0 or if ${HOME}/.local/pipx already existed
echo "source ${HOME}/.local/pipx/venvs/robot-folders/bin/rob_folders_source.sh" >> ~/.bashrc
# pipx >= 1.3.0
echo "source ${HOME}/.local/share/pipx/venvs/robot-folders/bin/rob_folders_source.sh" >> ~/.bashrc

In case you manually installed robot_folders using a python virtualenv the path is similarly

echo "source <your-virtualenv-path>/bin/rob_folders_source.sh" >> ~/.bashrc

Basic usage

After installation open up a new terminal to use robot_folders. The main command for using robot_folders is fzirob. Type

fzirob --help

to get an overview over all available commands.