ROS environment variable access

The environment APIs of rospkg provide convenient access to ROS package-related environment variables, including methods that provide default values when environment variable overrides are not active.

ROS_PACKAGE_PATH

Name of ROS_PACKAGE_PATH environment variable.

ROS_ROOT

Name of ROS_ROOT environment variable.

ROS_HOME

Name of ROS_HOME environment variable.

ROS_LOG_DIR

Name of ROS_LOG_DIR environment variable.

ROS_TEST_RESULTS_DIR

Name of ROS_TEST_RESULTS_DIR environment variable.

get_ros_root([env=None]) → str

Get the current ROS_ROOT.

Parameters:env – override environment dictionary

get_ros_package_path([env=None])

Get the current ROS_PACKAGE_PATH.

Parameters:env – (optional) environment override.

get_ros_home([env=None]) → str

Get directory location of .ros directory (aka ROS_HOME). possible locations for this. The ROS_LOG_DIR environment variable has priority. If that is not set, then ROS_HOME/log is used. If ROS_HOME is not set, $HOME/.ros/log is used.

Parameters:env – override environment dictionary Returns:path to use use for log file directory

get_log_dir([env=None]) → str

Get directory to use for writing log files. There are multiple possible locations for this. The ROS_LOG_DIR environment variable has priority. If that is not set, then ROS_HOME/log is used. If ROS_HOME is not set, $HOME/.ros/log is used.

Parameters:env – override environment dictionary Returns:path to use use for log file directory

get_test_results_dir(env=None) → str

Get directory to use for writing test result files. There are multiple possible locations for this. The ROS_TEST_RESULTS_DIR environment variable has priority. If that is set, ROS_TEST_RESULTS_DIR is returned. If ROS_TEST_RESULTS_DIR is not set, then ROS_HOME/test_results is used. If ROS_HOME is not set, $HOME/.ros/test_results is used.

Parameters:env – override environment dictionary Returns:path to use use for log file directory

on_ros_path(p[, env=None]) → bool

Check to see if filesystem path is on paths specified in ROS environment (ROS_ROOT, ROS_PACKAGE_PATH).

Parameters:p – path, str Returns:True if p is on the ROS path (ROS_ROOT, ROS_PACKAGE_PATH)