Build with Buck
Implement a new build system using Buck[1], Facebook's
open source clone of Google's internal build system.
Pros:
- Concise build language
- Test and build output is concise
- Test failures and stack traces show on terminal
- Reliable incrementals; clean is unnecessary
- Extensible with simple blocks of Python
- Fast
buck: clean: 0.452s, full 1m21.083s [*], no-op: 7.145s,
mvn: clean: 4.596s, full 2m53.776s, no-op: 59.108s,
[*] full build includes downloading all dependencies,
time can vary due to remote server performance.
Cons:
- No Windows support
- No native Maven Central support (added by macros)
- No native GWT, Prolog, or WAR support (added by macros)
- Bootstrap of buck requires Ant
Getting started:
git clone https://gerrit.googlesource.com/buck
cd buck
ant
Mac OS X:
PATH="`pwd`/bin:/System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands:$PATH"
Linux:
PATH="`pwd`/bin:$PATH"
Importing into Eclipse:
$ time buck build :eclipse
0m48.949s
Import existing project from `pwd`
Import 'gerrit' (do not import other Maven based projects)
Expand 'gerrit'
Right click 'buck-out' > Properties
Under Attributes check 'Derived'
If the code doesn't currently compile but an updated classpath
is needed, refresh the configs and obtain missing JARs:
$ buck build :eclipse_project :download
Running JUnit tests:
$ time buck test --all -e slow # skip slow tests
0m19.320s
$ time buck test --all # includes acceptance tests
5m17.517s
Building WAR:
$ buck build :gerrit
$ java -jar buck-out/gen/gerrit.war
Building release:
$ buck test --all && buck build :api :release
$ java -jar buck-out/gen/release.war
$ ls -lh buck-out/gen/{extension,plugin}-api.jar
Downloading dependencies:
Dependencies are normally downloaded automatically, but Buck can
inspect its graph and download missing dependencies so future
compiles can run without the network:
$ buck build :download
[1] http://facebook.github.io/buck/
Change-Id: I40853b108bd8e153cefa0896a5280a9a5ff81655
diff --git a/plugins/BUCK b/plugins/BUCK
new file mode 100644
index 0000000..707b38e
--- /dev/null
+++ b/plugins/BUCK
@@ -0,0 +1,36 @@
+BASE = get_base_path()
+CORE = [
+ 'commit-message-length-validator',
+ 'replication',
+ 'reviewnotes',
+]
+
+# buck audit parses and resolves all deps even if not reachable
+# from the root(s) passed to audit. Filter dependencies to only
+# the ones that currently exist to allow buck to parse cleanly.
+# TODO(sop): buck should more lazily resolve deps
+def filter(names):
+ from os import path
+ h, n = [], []
+ for p in names:
+ if path.exists(path.join(BASE, p, 'BUCK')):
+ h.append(p)
+ else:
+ n.append(p)
+ return h, n
+HAVE, NEED = filter(CORE)
+
+genrule(
+ name = 'core',
+ cmd = '' +
+ ';'.join(['echo >&2 plugins/'+n+' is required.' for n in NEED]) +
+ (';echo >&2;exit 1;' if NEED else '') +
+ 'mkdir -p $TMP/WEB-INF/plugins &&' +
+ 'for s in $SRCS;do ln -s $s $TMP/WEB-INF/plugins;done;' +
+ 'cd $TMP &&' +
+ 'zip -qr $OUT .',
+ srcs = [genfile('%s/%s.jar' % (n, n)) for n in CORE],
+ deps = ['//%s/%s:%s' % (BASE, n, n) for n in HAVE],
+ out = 'core.zip',
+ visibility = ['//:release'],
+)
