Files
gerrit/lib/maven.defs
Shawn Pearce fd6bb9f6a5 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
2013-05-09 13:40:36 +00:00

107 lines
2.8 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.
GERRIT = 'http://gerrit-maven.commondatastorage.googleapis.com'
MAVEN_CENTRAL = 'http://repo1.maven.org/maven2'
def define_license(name):
n = 'LICENSE-' + name
genrule(
name = n,
cmd = 'ln -s $SRCS $OUT',
srcs = [n],
out = n,
visibility = ['PUBLIC'],
)
def maven_jar(
name,
id,
license,
exclude = [],
exclude_java_sources = False,
deps = [],
sha1 = '', bin_sha1 = '', src_sha1 = '',
repository = MAVEN_CENTRAL,
attach_source = True,
visibility = ['PUBLIC']):
from os import path
parts = id.split(':')
if len(parts) != 3:
raise NameError('expected id="groupId:artifactId:version"')
group, artifact, version = parts
jar = path.join(name, artifact.lower() + '-' + version)
url = '/'.join([
repository,
group.replace('.', '/'), artifact, version,
artifact + '-' + version])
binjar = jar + '.jar'
binurl = url + '.jar'
srcjar = jar + '-src.jar'
srcurl = url + '-sources.jar'
cmd = ['${//tools:download_jar}', '-o', '$OUT', '-u', binurl]
if sha1:
cmd.extend(['-v', sha1])
elif bin_sha1:
cmd.extend(['-v', bin_sha1])
for x in exclude:
cmd.extend(['-x', x])
if exclude_java_sources:
cmd.append('--exclude_java_sources')
genrule(
name = name + '__download_bin',
cmd = ' '.join(cmd),
srcs = [],
deps = ['//tools:download_jar'],
out = binjar,
)
download = [':' + name + '__download_bin']
license = ['//lib:LICENSE-' + license]
if src_sha1 or attach_source:
cmd = ['${//tools:download_jar}', '-o', '$OUT', '-u', srcurl]
if src_sha1:
cmd.extend(['-v', src_sha1])
genrule(
name = name + '__download_src',
cmd = ' '.join(cmd),
srcs = [],
deps = ['//tools:download_jar'],
out = srcjar,
)
if src_sha1:
prebuilt_jar(
name = name + '_src',
binary_jar = genfile(srcjar),
deps = [':' + name + '__download_src'] + license,
visibility = visibility,
)
download.append(':' + name + '__download_src')
else:
srcjar = None
prebuilt_jar(
name = name,
deps = deps + download + license,
binary_jar = genfile(binjar),
source_jar = genfile(srcjar) if srcjar else None,
visibility = visibility,
)