Home

Awesome

Build status

📣 [Unmaintained] Groovy Rules

[!WARNING] Due to an absence of any maintainers, this repository is archived and currently unmaintained.

We discourage any new dependencies on the contents of this repository.

If you, or your organization, are interested in revitalizing this project by taking over its maintenance, we welcome your initiative. To discuss the process of un-archiving and assuming ownership of this repository, please reach out to us via email at bazel-contrib@googlegroups.com or join the conversation on our Slack workspace in the #rules channel. You can sign up for Slack access at https://slack.bazel.build.

<div class="toc"> <h2>Rules</h2> <ul> <li><a href="#groovy_library">groovy_library</a></li> <li><a href="#groovy_and_java_library">groovy_and_java_library</a></li> <li><a href="#groovy_binary">groovy_binary</a></li> <li><a href="#groovy_junit_test">groovy_junit_test</a></li> <li><a href="#spock_test">spock_test</a></li> </ul> </div>

Overview

These build rules are used for building Groovy projects with Bazel. Groovy libraries may interoperate with and depend on Java libraries and vice-versa.

<a name="setup"></a>

Setup

To be able to use the Groovy rules, you must provide bindings for the following targets:

The easiest way to do so is to add the following to your WORKSPACE file:

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
    name = "io_bazel_rules_groovy",
    url = "https://github.com/bazelbuild/rules_groovy/archive/0.0.6.tar.gz",
    sha256 = "21c7172786623f280402d3b3a2fc92f36568afad5a4f6f5ea38fd1c6897aecf8",
    strip_prefix = "rules_groovy-0.0.6",
)
load("@io_bazel_rules_groovy//groovy:repositories.bzl", "rules_groovy_dependencies")
rules_groovy_dependencies()

<a name="basic-example"></a>

Basic Example

Suppose you have the following directory structure for a simple Groovy and Java application:

[workspace]/
    WORKSPACE
    src/main/groovy/
        app/
            BUILD
            GroovyApp.groovy
        lib/
            BUILD
            GroovyLib.groovy
            JavaLib.java
    src/test/groovy/
        lib/
            BUILD
            LibTest.groovy

Then, to build the code under src/main/groovy/lib/, your src/main/groovy/lib/BUILD can look like this:

load("@io_bazel_rules_groovy//groovy:groovy.bzl", "groovy_library")

groovy_library(
    name = "groovylib",
    srcs = glob(["*.groovy"]),
    visibility = ["//visibility:public"],
    deps = [
        ":javalib",
    ],
)

java_library(
    name = "javalib",
    srcs = glob(["*.java"]),
)

For simplicity, you can combine Groovy and Java sources into a single library using groovy_and_java_library. Note that this allows the Groovy code to reference the Java code, but not vice-versa. Your src/main/groovy/lib/BUILD file would then look like this:

load("@io_bazel_rules_groovy//groovy:groovy.bzl", "groovy_and_java_library")

groovy_and_java_library(
    name = "lib",
    srcs = glob(["*.groovy", "*.java"]),
)

To build the application under src/main/groovy/app, you can define a binary using groovy_binary as follows:

load("@io_bazel_rules_groovy//groovy:groovy.bzl", "groovy_binary")

groovy_binary(
    name = "GroovyApp",
    srcs = glob(["*.groovy"]),
    main_class = "app.GroovyApp",
    deps = [
         "//src/main/groovy/lib:groovylib",
    ],
)

Finally, you can write tests in Groovy using groovy_test. The srcs of this rule will be converted into names of class files that are passed to JUnit. For this to work, the test sources must be under src/test/groovy or src/test/java. To build the test under src/test/groovy/lib, your BUILD file would look like this:

load("@io_bazel_rules_groovy//groovy:groovy.bzl", "groovy_test", "groovy_library")


groovy_library(
  name = "testlib",
  srcs = glob(["*.groovy"]),
)

groovy_test(
  name = "LibTest",
  srcs = ["LibTest.groovy"],
  deps = [":testlib"],
)

If you're using JUnit or Spock, see <a href="#groovy_junit_test">groovy_junit_test</a> or <a href="#spock_test">spock_test</a> for wrappers that make testing with these systems slightly more convenient.

<a name="groovy_library"></a>

groovy_library

groovy_library(name, srcs, deps, **kwargs)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>srcs</code></td> <td> <code>List of labels, required</code> <p>List of .groovy source files used to build the library.</p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of other libraries to be included on the compile-time classpath when building this library. </p> <p> These can be either other `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>**kwargs</code></td> <td> <code>see <a href="http://bazel.io/docs/be/java.html#java_import">java_binary</a></code> <p> The other arguments of this rule will be passed to the `java_import` that wraps the groovy library. </p> </td> </tr> </tbody> </table>

<a name="groovy_and_java_library"></a>

groovy_and_java_library

groovy_and_java_library(name, srcs, deps, **kwargs)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>srcs</code></td> <td> <code>List of labels, required</code> <p>List of .groovy and .java source files used to build the library.</p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of other libraries to be included on the compile-time classpath when building this library. </p> <p> These can be either other `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>**kwargs</code></td> <td> <code>see <a href="http://bazel.io/docs/be/java.html#java_import">java_binary</a></code> <p> The other arguments of this rule will be passed to the `java_import` that wraps the groovy library. </p> </td> </tr> </tbody> </table>

<a name="groovy_binary"></a>

groovy_binary

groovy_binary(name, main_class, srcs, deps, **kwargs)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>main_class</code></td> <td> <code>String, required</code> <p> The name of either a class containing a `main` method or a Groovy script file to use as an entry point (see <a href="http://www.groovy-lang.org/structure.html#_scripts_versus_classes"> here</a> for more details on scripts vs. classes). </p> </td> </tr> <tr> <td><code>srcs</code></td> <td> <code>List of labels, required</code> <p>List of .groovy source files used to build the application.</p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of other libraries to be included on both the compile-time classpath when building this application and the runtime classpath when executing it. </p> <p> These can be `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>**kwargs</code></td> <td> <code>see <a href="http://bazel.io/docs/be/java.html#java_binary">java_binary</a></code> <p> The other arguments of this rule will be passed to the `java_binary` underlying the `groovy_binary`. </p> </td> </tr> </tbody> </table>

<a name="groovy_test"></a>

groovy_test

groovy_test(name, deps, srcs, data, resources, jvm_flags, size, tags)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>srcs</code></td> <td> <code>List of labels, required</code> <p> List of .groovy source files whose names will be converted to classes passed to JUnitCore. </p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of libraries to be included on both the compile-time classpath when building this test and on the runtime classpath when executing it. </p> <p> These can be `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>resources</code></td> <td> <code>List of labels, optional</code> <p> A list of data files to include on the test's classpath. This is accomplished by creating a `java_library` containing only the specified resources and including that library in the test's dependencies. </p> </td> </tr> <tr> <td><code>jvm_flags</code></td> <td> <code>List of strings, optional</code> <p> A list of flags to embed in the wrapper script generated for running this binary. </p> </td> </tr> </tbody> </table>

<a name="groovy_junit_test"></a>

groovy_junit_test

groovy_junit_test(name, tests, deps, groovy_srcs, java_srcs, data, resources, jvm_flags, size, tags)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>tests</code></td> <td> <code>List of labels, required</code> <p> List of .groovy source files that will be used as test specifications that will be executed by JUnit. </p> </td> </tr> <tr> <td><code>groovy_srcs</code></td> <td> <code>List of labels, optional</code> <p> List of additional .groovy source files that will be used to build the test. </p> </td> </tr> <tr> <td><code>java_srcs</code></td> <td> <code>List of labels, optional</code> <p> List of additional .java source files that will be used to build the test. </p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of libraries to be included on both the compile-time classpath when building this test and on the runtime classpath when executing it. </p> <p> These can be `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>resources</code></td> <td> <code>List of labels, optional</code> <p> A list of data files to include on the test's classpath. This is accomplished by creating a `java_library` containing only the specified resources and including that library in the test's dependencies. </p> </td> </tr> <tr> <td><code>jvm_flags</code></td> <td> <code>List of strings, optional</code> <p> A list of flags to embed in the wrapper script generated for running this binary. </p> </td> </tr> </tbody> </table>

<a name="spock_test"></a>

spock_test

spock_test(name, specs, deps, groovy_srcs, java_srcs, data, resources, jvm_flags, size, tags)
<table class="table table-condensed table-bordered table-params"> <colgroup> <col class="col-param" /> <col class="param-description" /> </colgroup> <thead> <tr> <th colspan="2">Attributes</th> </tr> </thead> <tbody> <tr> <td><code>name</code></td> <td> <code>Name, required</code> <p>A unique name for this rule.</p> </td> </tr> <tr> <td><code>specs</code></td> <td> <code>List of labels, required</code> <p> List of .groovy source files that will be used as test specifications that will be executed by JUnit. </p> </td> </tr> <tr> <td><code>groovy_srcs</code></td> <td> <code>List of labels, optional</code> <p> List of additional .groovy source files that will be used to build the test. </p> </td> </tr> <tr> <td><code>java_srcs</code></td> <td> <code>List of labels, optional</code> <p> List of additional .java source files that will be used to build the test. </p> </td> </tr> <tr> <td><code>deps</code></td> <td> <code>List of labels or .jar files, optional</code> <p> List of libraries to be included on both the compile-time classpath when building this test and on the runtime classpath when executing it. </p> <p> These can be `groovy_library` targets, `java_library` targets, `groovy_and_java_library` targets, or raw .jar files. </p> </td> </tr> <tr> <td><code>resources</code></td> <td> <code>List of labels, optional</code> <p> A list of data files to include on the test's classpath. This is accomplished by creating a `java_library` containing only the specified resources and including that library in the test's dependencies. </p> </td> </tr> <tr> <td><code>jvm_flags</code></td> <td> <code>List of strings, optional</code> <p> A list of flags to embed in the wrapper script generated for running this binary. </p> </td> </tr> </tbody> </table>