The base class for package/stack ("stackage") crawlers. Users of the library should use the functionality provided here through one of the derived classes, Rosstack or Rospack. More...

#include <rospack.h>

Inheritance diagram for rospack::Rosstackage:

[legend]

List of all members.

Public Member Functions
bool	contains (const std::string &name, std::string &stack, std::string &path)
	Find the stack that contains a package.
bool	contents (const std::string &name, std::set< std::string > &packages)
	Compute the packages that are contained in a stack.
void	crawl (std::vector< std::string > search_path, bool force)
	Crawl the filesystem, accumulating a database of stackages. May read results from a cache file instead of crawling. This method should be called before any making any queries (find, list, etc.).
bool	deps (const std::string &name, bool direct, std::vector< std::string > &deps)
	Compute dependencies of a stackage (i.e., stackages that this stackages depends on).
bool	depsIndent (const std::string &name, bool direct, std::vector< std::string > &deps)
	Generate indented list of a stackage's dependencies, including duplicates. Intended for visual debugging of dependency structures.
bool	depsManifests (const std::string &name, bool direct, std::vector< std::string > &manifests)
	List the manifests of a stackage's dependencies. Used by rosbuild.
bool	depsMsgSrv (const std::string &name, bool direct, std::vector< std::string > &gens)
	List the marker files in a packages's dependencies that indicate that those packages contain auto-generated message and/or service code. Used by rosbuild.
bool	depsOn (const std::string &name, bool direct, std::vector< std::string > &deps)
	Compute reverse dependencies of a stackage (i.e., stackages that depend on this stackage). Forces crawl.
bool	depsWhy (const std::string &from, const std::string &to, std::string &output)
	Compute all dependency chains from one stackage to another. Intended for visual debugging of dependency structures.
bool	exports (const std::string &name, const std::string &lang, const std::string &attrib, bool deps_only, std::vector< std::string > &flags)
	Compute exports declared in a package and its dependencies. Used by rosbuild.
bool	find (const std::string &name, std::string &path)
	Look for a stackage.
const std::string &	getName ()
	Get the name of the tool that's in use (e.g., "rospack" or "rosstack")
bool	getSearchPathFromEnv (std::vector< std::string > &sp)
	Helper method to construct a directory search path by looking at relevant environment variables. The value of ROS_ROOT goes first, followed by each element of a colon-separated ROS_PACKAGE_PATH.
bool	inStackage (std::string &name)
	Is the current working directory a stackage?
void	list (std::set< std::pair< std::string, std::string > > &list)
	List names and paths of all stackages.
void	listDuplicates (std::vector< std::string > &dups)
	Identify duplicate stackages. Forces crawl.
void	logError (const std::string &msg, bool append_errno=false)
	Log a error (usually goes to stderr).
void	logWarn (const std::string &msg, bool append_errno=false)
	Log a warning (usually goes to stderr).
bool	plugins (const std::string &name, const std::string &attrib, const std::string &top, std::vector< std::string > &flags)
	Compute exported plugins declared in packages that depend on a package. Forces crawl. Used by rosbuild and roslib.
bool	profile (const std::vector< std::string > &search_path, bool zombie_only, int length, std::vector< std::string > &dirs)
	Report on time taken to crawl for stackages. Intended for use in debugging misconfigured stackage trees. Forces crawl.
bool	rosdeps (const std::string &name, bool direct, std::set< std::string > &rosdeps)
	Compute rosdep entries that are declared in manifest of a package and its dependencies. Used by rosmake.
void	setQuiet (bool quiet)
	Control warning and error console output.
virtual const char *	usage ()
	Usage string, to be overridden by derived classes.
bool	vcs (const std::string &name, bool direct, std::vector< std::string > &vcs)
	Compute vcs entries that are declared in manifest of a package and its dependencies. Was used by Hudson build scripts; might not be needed.
virtual	~Rosstackage ()
	Destructor.
Protected Member Functions
	Rosstackage (const std::string &manifest_name, const std::string &cache_name, const std::string &name, const std::string &tag)
	Constructor, only used by derived classes.
Private Member Functions
void	addStackage (const std::string &path)
void	computeDeps (Stackage *stackage, bool ignore_errors=false)
void	crawlDetail (const std::string &path, bool force, int depth, bool collect_profile_data, std::vector< DirectoryCrawlRecord * > &profile_data, std::tr1::unordered_set< std::string > &profile_hash)
bool	depsDetail (const std::string &name, bool direct, std::vector< Stackage * > &deps)
bool	depsOnDetail (const std::string &name, bool direct, std::vector< Stackage * > &deps)
void	depsWhyDetail (Stackage from, Stackage to, std::list< std::list< Stackage * > > &acc_list)
bool	expandExportString (Stackage *stackage, const std::string &instring, std::string &outstring)
Stackage *	findWithRecrawl (const std::string &name)
void	gatherDeps (Stackage stackage, bool direct, traversal_order_t order, std::vector< Stackage > &deps)
void	gatherDepsFull (Stackage stackage, bool direct, traversal_order_t order, int depth, std::tr1::unordered_set< Stackage > &deps_hash, std::vector< Stackage * > &deps, bool get_indented_deps, std::vector< std::string > &indented_deps)
std::string	getCachePath ()
bool	isStackage (const std::string &path)
void	loadManifest (Stackage *stackage)
void	log (const std::string &level, const std::string &msg, bool append_errno)
bool	readCache ()
FILE *	validateCache ()
void	writeCache ()
Private Attributes
std::string	cache_name_
bool	crawled_
std::tr1::unordered_set < std::string >	dups_
std::string	manifest_name_
std::string	name_
bool	quiet_
std::vector< std::string >	search_paths_
std::tr1::unordered_map < std::string, Stackage * >	stackages_
std::string	tag_

Detailed Description

The base class for package/stack ("stackage") crawlers. Users of the library should use the functionality provided here through one of the derived classes, Rosstack or Rospack.

Definition at line 139 of file rospack.h.

Constructor & Destructor Documentation

rospack::Rosstackage::Rosstackage	(	const std::string &	manifest_name,
		const std::string &	cache_name,
		const std::string &	name,
		const std::string &	tag
	)		`[protected]`

Constructor, only used by derived classes.

Parameters:

manifest_name	What the manifest is called (e.g., "manifest.xml or stack.xml")
cache_name	What the cache is called (e.g., "rospack_cache" or "rosstack_cache")
name	Name of the tool we're building (e.g., "rospack" or "rosstack")
tag	Name of the attribute we look for in a "depend" tag in a manifest (e.g., "package" or "stack")

Definition at line 166 of file rospack.cpp.

rospack::Rosstackage::~Rosstackage ( ) [virtual]

Destructor.

Definition at line 1686 of file rospack.cpp.

Member Function Documentation

void rospack::Rosstackage::addStackage ( const std::string & path ) [private]

Definition at line 1087 of file rospack.cpp.

void rospack::Rosstackage::computeDeps	(	Stackage *	stackage,
		bool	ignore_errors = `false`
	)		`[private]`

Definition at line 1226 of file rospack.cpp.

bool rospack::Rosstackage::contains	(	const std::string &	name,
		std::string &	stack,
		std::string &	path
	)

Find the stack that contains a package.

Parameters:

name	The package to work on.
stack	If the containing stack is found, its name is written here.
path	If the containing stack is found, its absolute path is written here.

Returns:: True if the containing stack could be found, false otherwise.

Definition at line 419 of file rospack.cpp.

bool rospack::Rosstackage::contents	(	const std::string &	name,
		std::set< std::string > &	packages
	)

Compute the packages that are contained in a stack.

Parameters:

name	The stack to work on.
packages	The stack's constituent packages are written here.

Returns:: True if the contents could be computed, false otherwise.

Definition at line 393 of file rospack.cpp.

void rospack::Rosstackage::crawl	(	std::vector< std::string >	search_path,
		bool	force
	)

Crawl the filesystem, accumulating a database of stackages. May read results from a cache file instead of crawling. This method should be called before any making any queries (find, list, etc.).

Parameters:

search_path	List of directories to crawl, in precenence order. Directories should be absolute paths. It's passed by value to allow callers (e.g., find()) to safely pass in search_paths_.
force	If true, then crawl even if the cache looks valid

Definition at line 277 of file rospack.cpp.

void rospack::Rosstackage::crawlDetail	(	const std::string &	path,
		bool	force,
		int	depth,
		bool	collect_profile_data,
		std::vector< DirectoryCrawlRecord * > &	profile_data,
		std::tr1::unordered_set< std::string > &	profile_hash
	)		`[private]`

Definition at line 1106 of file rospack.cpp.

bool rospack::Rosstackage::deps	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	deps
	)

Compute dependencies of a stackage (i.e., stackages that this stackages depends on).

Parameters:

name	The stackage to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
deps	If dependencies are computed, then they're written here.

Returns:: True if dependencies were computed, false otherwise.

Definition at line 479 of file rospack.cpp.

bool rospack::Rosstackage::depsDetail	(	const std::string &	name,
		bool	direct,
		std::vector< Stackage * > &	deps
	)		`[private]`

Definition at line 928 of file rospack.cpp.

bool rospack::Rosstackage::depsIndent	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	deps
	)

Generate indented list of a stackage's dependencies, including duplicates. Intended for visual debugging of dependency structures.

Parameters:

name	The stackage to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
deps	List of the stackage's dependencies, with leading spaces to indicate depth, is written here. Print this list to console, with newlines separating each element. Example output: roscpp_traits cpp_common cpp_common rostime cpp_common

Returns:: True if the indented dependencies were computed, false otherwise.

Definition at line 518 of file rospack.cpp.

bool rospack::Rosstackage::depsManifests	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	manifests
	)

List the manifests of a stackage's dependencies. Used by rosbuild.

Parameters:

name	The stackage to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
manifests	The list of absolute paths to manifests of stackages that the given stackage depends on is written here.

Returns:: True if the manifest list was computed, false otherwise.

Definition at line 587 of file rospack.cpp.

bool rospack::Rosstackage::depsMsgSrv	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	gens
	)

List the marker files in a packages's dependencies that indicate that those packages contain auto-generated message and/or service code. Used by rosbuild.

Parameters:

name	The package to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
gens	The list of absolute paths to marker files (e.g., "/opt/ros/electric/stacks/ros_comm/messages/std_msgs/msg_gen/generated") is written here.

Returns:: True if the list of files was generated, false otherwise.

Definition at line 856 of file rospack.cpp.

bool rospack::Rosstackage::depsOn	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	deps
	)

Compute reverse dependencies of a stackage (i.e., stackages that depend on this stackage). Forces crawl.

Parameters:

name	The stackage to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
deps	If dependencies are computed, then they're written here.

Returns:: True if dependencies were computed, false otherwise.

Definition at line 504 of file rospack.cpp.

bool rospack::Rosstackage::depsOnDetail	(	const std::string &	name,
		bool	direct,
		std::vector< Stackage * > &	deps
	)		`[private]`

Definition at line 990 of file rospack.cpp.

bool rospack::Rosstackage::depsWhy	(	const std::string &	from,
		const std::string &	to,
		std::string &	output
	)

Compute all dependency chains from one stackage to another. Intended for visual debugging of dependency structures.

Parameters:

from	The stackage that depends on.
to	The stackage that is depended on.
output	A list of dependency chains. Print this list to console, with newlines separating each element. Example output: Dependency chains from roscpp to roslib: * roscpp -> roslib * roscpp -> std_msgs -> roslib * roscpp -> rosgraph_msgs -> std_msgs -> roslib

Returns:: True if the dependency chains were computed, false otherwise.

Definition at line 545 of file rospack.cpp.

void rospack::Rosstackage::depsWhyDetail	(	Stackage *	from,
		Stackage *	to,
		std::list< std::list< Stackage * > > &	acc_list
	)		`[private]`

Definition at line 958 of file rospack.cpp.

bool rospack::Rosstackage::expandExportString	(	Stackage *	stackage,
		const std::string &	instring,
		std::string &	outstring
	)		`[private]`

Definition at line 1602 of file rospack.cpp.

bool rospack::Rosstackage::exports	(	const std::string &	name,
		const std::string &	lang,
		const std::string &	attrib,
		bool	deps_only,
		std::vector< std::string > &	flags
	)

Compute exports declared in a package and its dependencies. Used by rosbuild.

Parameters:

name	The package to work on.
lang	The value of the 'lang' attribute to search for.
attrib	The value of the 'attrib' attribute to search for.
deps_only	If true, then only return information from the pacakge's dependencies; if false, then also include the package's own export information.
flags	The accumulated flags are written here.

Returns:: True if the flags were computed, false otherwise.

Definition at line 700 of file rospack.cpp.

bool rospack::Rosstackage::find	(	const std::string &	name,
		std::string &	path
	)

Look for a stackage.

Parameters:

name	The stackage to look for.
path	If found, the absolute path to the stackage is written here.

Returns:: True if the stackage is found, false otherwise.

Definition at line 380 of file rospack.cpp.

Stackage * rospack::Rosstackage::findWithRecrawl ( const std::string & name ) [private]

Definition at line 911 of file rospack.cpp.

void rospack::Rosstackage::gatherDeps	(	Stackage *	stackage,
		bool	direct,
		traversal_order_t	order,
		std::vector< Stackage * > &	deps
	)		`[private]`

Definition at line 1290 of file rospack.cpp.

void rospack::Rosstackage::gatherDepsFull	(	Stackage *	stackage,
		bool	direct,
		traversal_order_t	order,
		int	depth,
		std::tr1::unordered_set< Stackage * > &	deps_hash,
		std::vector< Stackage * > &	deps,
		bool	get_indented_deps,
		std::vector< std::string > &	indented_deps
	)		`[private]`

Definition at line 1302 of file rospack.cpp.

std::string rospack::Rosstackage::getCachePath ( ) [private]

Definition at line 1357 of file rospack.cpp.

const std::string& rospack::Rosstackage::getName ( ) [inline]

Get the name of the tool that's in use (e.g., "rospack" or "rosstack")

Returns:: The name of the tool.

Definition at line 242 of file rospack.h.

bool rospack::Rosstackage::getSearchPathFromEnv ( std::vector< std::string > & sp )

Helper method to construct a directory search path by looking at relevant environment variables. The value of ROS_ROOT goes first, followed by each element of a colon-separated ROS_PACKAGE_PATH.

Parameters:

sp	The computed search path is written here.

Returns:: True if a search path was computed, false otherwise (e.g., ROS_ROOT not set).

defined(WIN32)

Definition at line 192 of file rospack.cpp.

bool rospack::Rosstackage::inStackage ( std::string & name )

Is the current working directory a stackage?

Parameters:

name	If in a stackage, then the stackage's name is written here.

Returns:: True if the current working directory contains a manifest file

Definition at line 344 of file rospack.cpp.

bool rospack::Rosstackage::isStackage ( const std::string & path ) [private]

Definition at line 243 of file rospack.cpp.

void rospack::Rosstackage::list ( std::set< std::pair< std::string, std::string > > & list )

List names and paths of all stackages.

Parameters:

list	Pairs of (name,path) are written here.

Definition at line 451 of file rospack.cpp.

void rospack::Rosstackage::listDuplicates ( std::vector< std::string > & dups )

Identify duplicate stackages. Forces crawl.

Parameters:

dups	Names of stackages that are found more than once while crawling are written here.

Definition at line 465 of file rospack.cpp.

void rospack::Rosstackage::loadManifest ( Stackage * stackage ) [private]

Definition at line 1211 of file rospack.cpp.

void rospack::Rosstackage::log	(	const std::string &	level,
		const std::string &	msg,
		bool	append_errno
	)		`[private]`

Definition at line 896 of file rospack.cpp.

void rospack::Rosstackage::logError	(	const std::string &	msg,
		bool	append_errno = `false`
	)

Log a error (usually goes to stderr).

Parameters:

msg	The error.
append_errno	If true, then append a colon, a space, and the return from 'sterror(errno)'.

Definition at line 185 of file rospack.cpp.

void rospack::Rosstackage::logWarn	(	const std::string &	msg,
		bool	append_errno = `false`
	)

Log a warning (usually goes to stderr).

Parameters:

msg	The warning.
append_errno	If true, then append a colon, a space, and the return from 'sterror(errno)'.

Definition at line 179 of file rospack.cpp.

bool rospack::Rosstackage::plugins	(	const std::string &	name,
		const std::string &	attrib,
		const std::string &	top,
		std::vector< std::string > &	flags
	)

Compute exported plugins declared in packages that depend on a package. Forces crawl. Used by rosbuild and roslib.

Parameters:

name	The package to work on.
attrib	The value of the 'attrib' attribute to search for.
top	If non-empty, then limit the reverse dependency search to packages that 'top' depends on. Otherwise, examine all packages that depend on 'name'.
flags	The accumulated flags are written here.

Returns:: True if the flags were computed, false otherwise.

Definition at line 790 of file rospack.cpp.

bool rospack::Rosstackage::profile	(	const std::vector< std::string > &	search_path,
		bool	zombie_only,
		int	length,
		std::vector< std::string > &	dirs
	)

Report on time taken to crawl for stackages. Intended for use in debugging misconfigured stackage trees. Forces crawl.

Parameters:

search_path	Directories to search; passed to crawl().
zombie_only	If false, then produce formatted output, with timing information. Example output: Full tree crawl took 0.014954 seconds. Directories marked with (*) contain no manifest. You may want to delete these directories. To get just of list of directories without manifests, re-run the profile with --zombie-only ------------------------------------------------------------- 0.013423 /opt/ros/electric/stacks 0.002989 /opt/ros/electric/stacks/ros_comm If true, then produce a list of absolute paths that contain no stackages ("zombies"); these directories can likely be safely deleted. Example output: /opt/ros/electric/stacks/pr2_controllers/trajectory_msgs /opt/ros/electric/stacks/pr2_controllers/trajectory_msgs/msg
length	Limit on how many directories to include in report (ordered in decreasing order of time taken to crawl).
dirs	Profile output. Print this list to console, with newlines separating each element.

Definition at line 1027 of file rospack.cpp.

bool rospack::Rosstackage::readCache ( ) [private]

Definition at line 1405 of file rospack.cpp.

bool rospack::Rosstackage::rosdeps	(	const std::string &	name,
		bool	direct,
		std::set< std::string > &	rosdeps
	)

Compute rosdep entries that are declared in manifest of a package and its dependencies. Used by rosmake.

Parameters:

name	The package to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
rosdeps	List of rosdep entries found in the package and its dependencies is written here.

Returns:: True if the rosdep list is computed, false otherwise.

Definition at line 612 of file rospack.cpp.

void rospack::Rosstackage::setQuiet ( bool quiet )

Control warning and error console output.

Parameters:

quiet If true, then don't output any warnings or errors to console. If false, then output warnings and errors to stderr (default behavior).

Definition at line 237 of file rospack.cpp.

virtual const char* rospack::Rosstackage::usage ( ) [inline, virtual]

Usage string, to be overridden by derived classes.

Returns:: Command-line usage statement.

Reimplemented in rospack::Rosstack, and rospack::Rospack.

Definition at line 211 of file rospack.h.

FILE * rospack::Rosstackage::validateCache ( ) [private]

Definition at line 1525 of file rospack.cpp.

bool rospack::Rosstackage::vcs	(	const std::string &	name,
		bool	direct,
		std::vector< std::string > &	vcs
	)

Compute vcs entries that are declared in manifest of a package and its dependencies. Was used by Hudson build scripts; might not be needed.

Parameters:

name	The package to work on.
direct	If true, then compute only direct dependencies. If false, then compute full (including indirect) dependencies.
vcs	List of vcs entries found in the package and its dependencies is written here.