GroovyCompileOptions

A Groovy script file that configures the compiler, allowing extensive control over how the code is compiled.

The script is executed as Groovy code, with the following context:

This facilitates the following pattern:

withConfig(configuration) {
  // use compiler configuration DSL here
}

For example, to activate type checking for all Groovy classes…

import groovy.transform.TypeChecked

withConfig(configuration) {
    ast(TypeChecked)
}

Please see the Groovy compiler customization builder documentation for more information about the compiler configuration DSL.

This feature is only available if compiling with Groovy 2.1 or later.

Tells the source encoding. Defaults to UTF-8.

Tells whether the compilation task should fail if compile errors occurred. Defaults to true.

The list of acceptable source file extensions. Only takes effect when compiling against Groovy 1.7 or higher. Defaults to ImmutableList.of("java", "groovy").

Tells whether to run the Groovy compiler in a separate process. Defaults to true.

Returns options for running the Groovy compiler in a separate process. These options only take effect if fork is set to true.

Tells whether Java stubs for Groovy classes generated during Java/Groovy joint compilation should be kept after compilation has completed. Useful for joint compilation debugging purposes. Defaults to false.

Tells whether to print which source files are to be compiled. Defaults to false.

Returns optimization options for the Groovy compiler. Allowed values for an option are true and false. Only takes effect when compiling against Groovy 1.8 or higher.

Known options are:

The directory where Java stubs for Groovy classes will be stored during Java/Groovy joint compilation. Defaults to null, in which case a temporary directory will be used.

Tells whether to turn on verbose output. Defaults to false.

Convenience method to set GroovyForkOptions with named parameter syntax. Calling this method will set fork to true.