Skip to content
Apache Groovy: A powerful multi-faceted programming language for the JVM platform
Java Groovy HTML CSS ANTLR Shell Other
Branch: master
Clone or download

Latest commit

Latest commit 57a4887 Jun 5, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows GROOVY-9513: Enable indy by default (closes #1226) Apr 25, 2020
benchmark Added a compiler performance test module Sep 21, 2015
buildSrc GROOVY-8480: org.codehaus.groovy.runtime.ExtensionModule should move … Feb 24, 2018
config forgot license header Mar 17, 2020
gradle Remove email address to avoid receiving potential spam mails. May 25, 2020
licenses some more tidy up after antlr2 removal Apr 18, 2020
notices some more tidy up after antlr2 removal Apr 18, 2020
security Grant read "line.separator" property permission to ScriptTest.groovy Apr 24, 2018
src minor fix-ups Jun 5, 2020
subprojects GROOVY-9576: groovydoc: hide enum $INIT static method (closes #1261) May 28, 2020
xdocs/images Remove the Maven 1 build files since we have now officially moved to … May 22, 2007
.asf.yaml add metadata file for AST github integration tweaking Feb 7, 2020
.gitignore Update eclipse gradle scripts May 24, 2019
.travis.yml GROOVY-9513: Enable indy by default (closes #1226) Apr 25, 2020
DOAP.rdf Update the official git link in DOAP Jan 19, 2019
LICENSE tidy up licenses/notices wrt no longer needing groovy-all jar Jul 25, 2018
NOTICE bump copyright year and 'updateNotices' Jan 1, 2020
README.adoc Update README.adoc (closes #1247) May 16, 2020
appveyor.yml add license header Nov 4, 2017
build.gradle GROOVY-9560: Update Spotbugs/Spotbugs plugin to 4.0.3/4.2.0 May 18, 2020
gradle.properties GROOVY-9557: Bump gradle to 6.4.1 May 16, 2020
gradlew GROOVY-9544: Bump gradle to 6.4 May 8, 2020
gradlew.bat GROOVY-9544: Bump gradle to 6.4 May 8, 2020
jitpack.yml Build with JDK9+ and exclude unnecessary tasks Aug 31, 2019
settings.gradle add project for tests which need --enable-preview set Apr 15, 2020
wrapper.gradle GROOVY-8378: Gradle wrapper bootstrapping should be more independent … Nov 14, 2017

README.adoc

Apache Groovy

medium

jdk Apache License 2 travis build status maintainability rating bintray download follow on Twitter

Groovy is a powerful multi-faceted programming language for the JVM platform. It supports a spectrum of programming styles incorporating features from dynamic languages such as optional and duck typing, but also static compilation and static type checking at levels similar to or greater than Java through its extensible static type checker. It aims to greatly increase developer productivity with many powerful features but also a concise, familiar and easy to learn syntax.

It integrates smoothly with any Java class or library, and immediately delivers to your application powerful capabilities, including scripting support, Domain-Specific Language authoring, runtime and compile-time meta-programming and functional programming.

Downloading

Latest Groovy version is available on Bintray Bintray latest version

Binary distribution links are on the package page.

Maven, Gradle and Ivy dependency declaration snippets are available on specific files of a particular module.

Get automatic notifications about new "groovy" versions link=https://bintray.com/groovy/maven/groovy/view?source=watch

Obtaining the Source

You don’t need the source code to use Apache Groovy but if you wish to explore its inner workings or build it for yourself there are two ways to obtain the source files.

Checking out from Version Control

Apache Groovy uses Git. The official Git repository is at:

https://gitbox.apache.org/repos/asf/groovy.git

And a mirror is hosted on Github:

https://github.com/apache/groovy

The Github mirror is read-only and provides convenience to users and developers to explore the code and for the community to accept contributions via Github pull requests.

Simply git clone the repo (or the repo you forked via the github website) and you will have the complete source.

Unpacking the src distribution

Alternatively, you can download the source distribution and unpack it.

If obtaining the source from the source distribution and you intend to build from source, you also need to download and install Gradle and use it to execute one bootstrap step.

Bootstrapping Gradle

As mentioned in the previous paragraph, if you download the source distribution you need to bootstrap Gradle. This isn’t needed if you clone from the Github repo.

Each version of Groovy is built and tested using a specific version of Gradle. That version is specified by the gradle_version property defined in the gradle.properties file within the root directory. Luckily you shouldn’t need to know that version and, after bootstrapping, you should use the gradlew command which will ensure the correct version is always used.

The version of Gradle used for the bootstrap step has some flexibility though in general you might need to download a version similar to the version of Groovy the build is expecting.

To bootstrap Gradle, at the top directory of your unpacked source, run the command:

gradle -b wrapper.gradle wrapper

On Unix-like systems, use ./gradle. If the version of Gradle you have installed is close to the required version, you might be able to get away without the -b wrapper.gradle above, but if in doubt leave it in.

NOTE: At this point, the Gradle wrapper should be set up and from now on you should use the gradlew command instead of gradle. (On Unix-like systems, use ./gradlew).

Building from Source

To build you will need:

To build everything using Gradle, use the following command (./gradlew on Unix-like systems):

gradlew clean dist

Note: The gradlew command automatically downloads the correct Gradle version if needed, you do not need to download it first.

This will generate a distribution similar to the zip you can download on the Groovy download page.

To build everything and launch unit tests, use:

gradlew test

If you want to launch one unit test, use this. <TestClassName> is like groovy.GroovyMethodsTest.

gradlew :test --tests <TestClassName>

To build from IntelliJ IDEA:

gradlew jar idea

Then open the generated project in IDEA.

To build from Eclipse:

gradlew jar eclipse

Then open the generated project and the generated subprojects in Eclipse. But be aware that Eclipse tends to be more limited in its ability to reproduce a Gradle build structure. The generated project files may contain a circular dependency which may or may not prevent Eclipse from using them. It depends on the Eclipse version, if this is an issue or not.

To build the documentation (Groovy Language Documentation):

gradlew asciidoc

All code samples of the documentation guide are pulled from actual test cases. To run a single documentation test case, take for example src/spec/test/semantics/PowerAssertTest.groovy

gradlew testSinglePowerAssertTest

(Note the omission of package name: class is semantics.PowerAssertTest but only PowerAssertTest is added to testSingle.)

Continuous Integration Server

The official CI server runs here and is sponsored by JetBrains.

Java Profiler

Groovy core team tunes performance through YourKit Java Profiler, which is sponsored by YourKit.

Friends of Groovy Open Collective

As an independent initiative, we have set up an open collective for Groovy:

This initiative is designed to complement the Apache project and the many contributions we get from our great community and supporters.

  • Thank you to our Silver Sponsors:

silver sponsor

  • Thank you to our Bronze Sponsors:

bronze sponsor

  • Thank you to our backers (donating monthly):

backer

  • Thank you to all our backers:

backers

Stargazers over time

Stargazers over time

License

Groovy is licensed under the terms of the Apache License, Version 2.0

You can’t perform that action at this time.