Skip to content

Latest commit

 

History

History
36 lines (22 loc) · 2.95 KB

run_binary.md

File metadata and controls

36 lines (22 loc) · 2.95 KB

Runs a binary as a build action. This rule does not require Bash (unlike native.genrule()).

This fork of bazel-skylib's run_binary adds directory output support and better makevar expansions.

run_binary

run_binary(name, tool, srcs, args, env, outs, out_dirs, output_dir, kwargs)

Runs a binary as a build action.

This rule does not require Bash (unlike native.genrule).

PARAMETERS

Name Description Default Value
name The target name none
tool The tool to run in the action.

Must be the label of a *_binary rule of a rule that generates an executable file, or of a file that can be executed as a subprocess (e.g. an .exe or .bat file on Windows or a binary with executable permission on Linux). This label is available for $(location) expansion in args and env.
none
srcs Additional inputs of the action.

These labels are available for $(location) expansion in args and env.
[]
args Command line arguments of the binary.

Subject to $(location) and makevar expansions.
[]
env Environment variables of the action.

Subject to $(location) and makevar expansions.
{}
outs Output files generated by the action.

These labels are available for $(location) expansion in args and env.

Output files cannot be nested within output directories in out_dirs.
[]
out_dirs Output directories generated by the action.

These labels are not available for $(location) expansion in args and env sincew they are not pre-declared labels created via attr.output_list(). Output directories are declared instead by ctx.actions.declare_directory.

Output directories cannot be nested within other output directories in out_dirs.
[]
output_dir If set to True then an output directory named the same as the target name is added to out_dirs.

Deprecated. For backward compatability with @aspect_bazel_lib 1.x. Use out_dirs instead.
False
kwargs Additional arguments none