IMPORTANT: The Bazel docs have moved! Please update your bookmark to https://bazel.build/rules/lib/runfiles

You can read about the migration, and let us know what you think.

Extensions > API reference > runfiles

runfiles

A container of information regarding a set of files required at runtime execution. This object should be passed via DefaultInfo in order to tell the build system about the runfiles needed by the outputs produced by the rule.

See runfiles guide for details.

empty_filenames

depset runfiles.empty_filenames

Returns names of empty files to create.

files

depset runfiles.files

Returns the set of runfiles as files.

merge

runfiles runfiles.merge(other)

Returns a new runfiles object that includes all the contents of this one and the argument.

Note: When you have many runfiles objects to merge, use merge_all() rather than calling merge in a loop. This avoids constructing deep depset structures which can cause build failures.

Parameters

Parameter Description
other required
The runfiles object to merge into this.

merge_all

runfiles runfiles.merge_all(other)

Returns a new runfiles object that includes all the contents of this one and of the runfiles objects in the argument.

Parameters

Parameter Description
other sequence of runfiless; required
The sequence of runfiles objects to merge into this.

depset runfiles.root_symlinks

Returns the set of root symlinks.

depset runfiles.symlinks

Returns the set of symlinks.