gerrit/Documentation/asciidoc.defs
Shawn Pearce 9e4e243cfd Fix genantlr() to support buck caching
genrule() can only produce one output. This is critical to the way
buck caching works for build results. The solution I learned from
the Buck team is to have the genrule() produce a ZIP file containing
all of the outputs, and use a unique genrule() to extract each
output from the ZIP.

Developers can now opt-into the buck cache by writing a local
config file:

  cat >.buckconfig.local <<EOF
  [cache]
    mode = dir
    dir = buck-cache
  EOF

This can be very useful when switching commits around with GWT UI
code. If the UI code does not modify between commits there is no
rebuild time. If UI code does modify, rebuild time is reduced to
0 when switching back to a prior version you had previously built.

The cache needs local disk, so its not enabled by default.

Change-Id: If8f79637004fbc13ea37c419e5c9bb582a489ab5
2013-05-30 14:12:07 -07:00

55 lines
1.4 KiB
Plaintext

# Copyright (C) 2013 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
def genasciidoc(
name,
srcs = [],
outs = [],
deps = [],
attributes = [],
backend = None,
conf_file = None,
visibility = []):
cmd = ['asciidoc', '-o', '$OUT']
if backend:
cmd.extend(['-b', backend])
for attribute in attributes:
cmd.extend(['-a', attribute])
if conf_file:
cmd.append('-f')
cmd.append('$SRCS')
for p in zip(srcs, outs):
s, o = p
if conf_file:
src_list = [conf_file, s]
else:
src_list = [s]
genrule(
name = o,
cmd = ' '.join(cmd),
srcs = src_list,
deps = deps,
out = o,
visibility = visibility,
)
genrule(
name = name,
cmd = ':>$OUT',
srcs = [],
deps = [':' + o for o in outs],
out = name + '__done',
visibility = visibility,
)