A simple helper to make working with different ROS versions and projects easier. Powerful autocompletion included.
Requirements: Bash 4+
-
Download the current version of rh.sh.
-
Add something like the following to your
~/.bashrc(supply your own values):export RH_PROJECTS_DIRS="/some/dir1:/another/dir2:/some/completely/different/dir3" export RH_ROS_INSTALL_DIRS="/opt/ros" export RH_SRC="/absolute/path/to/rh.sh" source "$RH_SRC"
Note: There can be multiple dirs specified in
*_DIRSvariables. Individual dirs are separated by:, the left-most specified directory has the highest priority.
The same info can be also found directly in the INSTALLATION comment in rh.sh.
Upon successful installation, type rh help:
$ rh help
rh - ROS helper
A simple helper to make working with different ROS versions and projects easier.
Homepage: https://github.com/pokusew/rh
Version: 0.0.7
Usage: rh <command> [command options]
Commands:
rh help
prints this help
rh env
prints env variables related to ROS
rh versions
lists all available ROS 1 and ROS 2 versions
versions are searched in dirs specified in RH_ROS_INSTALL_DIRS
rh sw <ros version name>
activates given ROS version
versions are searched in dirs specified in RH_ROS_INSTALL_DIRS
rh projects
lists all available projects
projects are searched in dirs specified in RH_PROJECTS_DIRS
rh cd <project name>
changes into project dir of the given project
projects are searched in dirs specified in RH_PROJECTS_DIRS
rh dev
tries to source install/setup.bash or devel/setup.bash (relative to the current working dir)
rh ldev
tries to source install/local_setup.bash or devel/local_setup.bash (relative to the current working dir)
rh wcd
recursively searches for workspaces dirs and changes to the nearest found
rh rosdep-check-src
runs 'rosdep check -i --from-path src' in the current working dir
rh rosdep-install-src
runs 'rosdep install -i --from-path src' in the current working dir