Skip to content

Latest commit

 

History

History
30 lines (18 loc) · 2.6 KB

params_file.md

File metadata and controls

30 lines (18 loc) · 2.6 KB

params_file public API

params_file

params_file(name, out, args, data, newline, kwargs)

Generates a UTF-8 encoded params file from a list of arguments.

Handles variable substitutions for args.

PARAMETERS

Name Description Default Value
name Name of the rule. none
out Path of the output file, relative to this package. none
args Arguments to concatenate into a params file.

- Subject to 'Make variable' substitution. See https://docs.bazel.build/versions/main/be/make-variables.html.

- Subject to predefined source/output path variables substitutions.

The predefined variables execpath, execpaths, rootpath, rootpaths, location, and locations take label parameters (e.g. $(execpath //foo:bar)) and substitute the file paths denoted by that label.

See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_label_variables for more info.

NB: This $(location) substitution returns the manifest file path which differs from the *_binary & *_test args and genrule bazel substitutions. This will be fixed in a future major release. See docs string of expand_location_into_runfiles macro in internal/common/expand_into_runfiles.bzl for more info.

- Subject to predefined variables & custom variable substitutions.

Predefined "Make" variables such as $(COMPILATION_MODE) and $(TARGET_CPU) are expanded. See https://docs.bazel.build/versions/main/be/make-variables.html#predefined_variables.

Custom variables are also expanded including variables set through the Bazel CLI with --define=SOME_VAR=SOME_VALUE. See https://docs.bazel.build/versions/main/be/make-variables.html#custom_variables.

Predefined genrule variables are not supported in this context.
[]
data Data for $(location) expansions in args. []
newline Line endings to use. One of ["auto", "unix", "windows"].

- "auto" for platform-determined - "unix" for LF - "windows" for CRLF
"auto"
kwargs undocumented named arguments none