# runfiles

{% dynamic setvar source_file "src/main/java/com/google/devtools/build/lib/starlarkbuildapi/RunfilesApi.java" %} {% dynamic setvar version "8.3.0" %} {% dynamic setvar original_path "/rules/lib/builtins/runfiles" %} {% include "_buttons.html" %} 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.

## Members

- empty_filenames
- files
- merge
- merge_all
- root_symlinks
- symlinks

## 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` | runfiles; 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.

## root_symlinks

    depset runfiles.root_symlinks

Returns the set of root symlinks.

## symlinks

    depset runfiles.symlinks

Returns the set of symlinks.