Module stacks

Returns: str

name of stack that pkg is in, or None if pkg is not part of a stack

Raises:

• roslib.packages.InvalidROSPkgException - if pkg cannot be located

Returns: [str]

name of packages that are part of stack

Raises:

• InvalidROSStackException - if stack cannot be located
• ValueError - if stack name is invalid

Get the directory of a ROS stack. This will initialize an internal cache and return cached results if possible.

This routine is not thread-safe to os.environ changes.

Parameters:

• stack (str) - name of ROS stack to locate on disk

Returns: str

directory of stack.

Raises:

• InvalidROSStackException - if stack cannot be located.

Get list of all ROS stacks. This uses an internal cache.

This routine is not thread-safe to os.environ changes.

Returns: [str]

complete list of stacks names in ROS environment

List ROS stacks within the specified path.

Optionally, a cache dictionary can be provided, which will be updated with the stack->path mappings. list_stacks_by_path() does NOT returned cached results -- it only updates the cache.

Parameters:

• path (str) - path to list stacks in
• stacks ([str]) - list of stacks to append to. If stack is already present in stacks, it will be ignored.
• cache ({str: str}) - (optional) stack path cache to update. Maps stack name to directory path.

Returns: [str]

complete list of stack names in ROS environment. Same as stacks parameter.

Expand names into a list of packages. Names can either be of packages or stacks.

Parameters:

• names ([str]) - names of stacks or packages

Returns: ([str], [str])

([packages], [not_found]). expand_packages() returns two lists. The first is of packages names. The second is a list of names for which no matching stack or package was found. Lists may have duplicates.