These are some common issues and questions with writing extensions.
Bazel only executes the actions needed to produce the requested output files.
If the file you want has a label, you can request it directly:
bazel build //pkg:myfile.txt
If the file is in an output group of the target, you may need to specify that
output group on the command line:
bazel build //pkg:mytarget --output_groups=foo
If you want the file to be built automatically whenever your target is
mentioned on the command line, add it to your rule's default outputs by
See the Rules page for more information.
Bazel analyzes only the targets that are requested for the build. You should either name the target on the command line, or something that depends on the target.
Make sure that 1) the file has been registered as an input to the action or binary, and 2) the script or tool being executed is accessing the file using the correct path.
For actions, you declare inputs by passing them to the
that creates the action. The proper path for the file can be obtained using
For binaries (the executable outputs run by a
bazel run or
command), you declare inputs by including them in the
runfiles. Instead of using the
path field, use
File.short_path, which is file's path relative to
the runfiles directory in which the binary executes.
bazel build //pkg:mytarget?
A tool can be declared as a target, just like any other part of your build, and
run during the execution phase to help build other targets. To create an action
that runs a tool, use
ctx.actions.run and pass in the
tool as the
During the loading and analysis phases, a tool cannot run, nor can you perform file I/O. This means that tools and file contents (except the contents of BUILD and .bzl files) cannot affect how the target and action graphs get created.
You can format the structured data as a .bzl file. You can
load() the file to
access it during the loading and analysis phases. You can pass it as an input or
runfile to actions and executables that need it during the execution phase.
For rules and rule attributes, you can pass a docstring literal (possibly
triple-quoted) to the
doc parameter of
attr.*(). For helper
functions and macros, use a triple-quoted docstring literal following the format
given here. Rule implementation functions generally do
not need their own docstring.
Using string literals in the expected places makes it easier for automated tooling to extract documentation. Feel free to use standard non-string comments wherever it may help the reader of your code.