Skip to content
Browse files

Rewrite and add shell command example

  • Loading branch information...
brandjon committed May 29, 2019
1 parent dbf8a0c commit 5d8c8961a2516ebf875787df35e98cadd08d43dc
Showing with 103 additions and 30 deletions.
  1. +2 −1 rules/
  2. +16 −3 rules/shell_command/BUILD
  3. +1 −1 rules/shell_command/foo.txt
  4. +84 −0 rules/shell_command/rules.bzl
  5. +0 −25 rules/shell_command/size.bzl
@@ -20,7 +20,8 @@ passing information from a dependency to a target.
* [expand_template](expand_template/): Example where a file is generated based
on a template.

* [shell command](shell_command/): Example where a shell command is executed.
* [shell command](shell_command/): Example where a shell command is executed to
do simple text file processing.

* [mandatory provider](mandatory_provider/): Example with a mandatory provider,
to access information from a dependency.
@@ -1,6 +1,19 @@
load(":size.bzl", "size")
# A small example that takes a text file and generates modified versions of it,
# and metadata about it. These rules depend on unix shell commands like `tr`
# and `stat`.
# Build with:
# bazel build //shell_command:*

name = "foo_size",
load(":rules.bzl", "emit_size", "convert_to_uppercase")

name = "foo",
file = "foo.txt",

name = "make_uppercase",
input = "foo.txt",
output = "upper_foo.txt",
@@ -1 +1 @@
The Quick Brown Fox Jumps Over The Lazy Dog.
@@ -0,0 +1,84 @@
"""Rules that execute shell commands to do simple transformations.
While shell commands are convenient, they should be used carefully. Shell
commands are subject to escaping and injection issues, as well as portability
problems. It is often better to declare a binary target in a BUILD file and
execute it.
For very simple commands that are only used for a small number of targets, it
may be simpler to use genrule()s in a BUILD file instead of a custom rule that
invokes shell commands.

def _emit_size_impl(ctx):
# The input file is given to us from the BUILD file via an attribute.
in_file = ctx.file.file

# The output file is declared with a name based on the target's name.
out_file = ctx.actions.declare_file("%s.size" %

# Input files visible to the action.
inputs = [in_file],
# Output files that must be created by the action.
outputs = [out_file],
# The progress message uses `short_path` (the workspace-relative path)
# since that's most meaningful to the user. It omits details from the
# full path that would help distinguish whether the file is a source
# file or generated, and (if generated) what configuration it is built
# for.
progress_message = "Getting size of %s" % in_file.short_path,
# The command to run. Alternatively we could use '$1', '$2', etc., and
# pass the values for their expansion to `run_shell`'s `arguments`
# param (see convert_to_uppercase below). This would be more robust
# against escaping issues. Note that actions require the full `path`,
# not the ambiguous truncated `short_path`.
command = "stat -L -c%%s '%s' > '%s'" %
(in_file.path, out_file.path),

# Tell Bazel that the files to build for this target includes
# `out_file`.
return [DefaultInfo(files = depset([out_file]))]

emit_size = rule(
implementation = _emit_size_impl,
attrs = {
"file": attr.label(
mandatory = True,
allow_single_file = True,
doc = "The file whose size is computed",
doc = """
Given an input file, creates an output file with the extension `.size`
containing the file's size in bytes.

def _convert_to_uppercase_impl(ctx):
# Both the input and output files are specified by the BUILD file.
in_file = ctx.file.input
out_file = ctx.outputs.output
outputs = [out_file],
inputs = [in_file],
arguments = [in_file.path, out_file.path],
command = "tr '[:lower:]' '[:upper:]' < \"$1\" > \"$2\"",
# No need to return anything telling Bazel to build `out_file` when
# building this target -- It's implied because the output is declared
# as an attribute rather than with `declare_file()`.

convert_to_uppercase = rule(
implementation = _convert_to_uppercase_impl,
attrs = {
"input": attr.label(
allow_single_file = True,
mandatory = True,
doc = "The file to transform",
"output": attr.output(doc = "The generated file"),
doc = "Transforms a text file by changing its characters to uppercase.",

This file was deleted.

0 comments on commit 5d8c896

Please sign in to comment.
You can’t perform that action at this time.