An open-source entry in TopGit's GitHub warehouse: apache/groovy, 5.5k stars, Groovy. Apache Groovy: A powerful multi-faceted programming language for the JVM platform
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you 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.
{groovy-www}[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
Distribution links are on the https://groovy.apache.org/download.html[download] page.
Maven, Gradle and Ivy dependency declaration snippets are available on specific files of a particular module.
== 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 https://gradle.org/downloads/[download] and install https://gradle.org/[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 -p bootstrap
[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:
{jdk}[JDK 17+]
The build compiles with whichever JDK runs gradlew. To target a different bytecode level, or to run tests on a different JDK, see the "Building and testing against a specific JDK" section in CONTRIBUTING.md.
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. is like groovy.GroovyMethodsTest.
gradlew :test --tests <TestClassName>
To build a runnable local installation of Groovy with your changes applied, use:
gradlew :groovy-binary:installGroovy
The installation is generated under subprojects/groovy-binary/build/install. Its bin directory contains the groovy, groovysh, and groovyc launchers, so you can invoke subprojects/groovy-binary/build/install/bin/groovy <script> to run a script against the build you just produced.
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.
== Verifying dependencies
The build uses Gradle dependency verification, so adding or bumping a dependency requires regenerating gradle/verification-metadata.xml.
For the regeneration recipe (including the preferred --dry-run approach), see the Dependency verification section of link:CONTRIBUTING.md[CONTRIBUTING.md].
== Continuous Integration
Builds run primarily on {github-ci}[GitHub Actions]; the workflows live under .github/workflows.
A TeamCity server, sponsored by https://www.jetbrains.com[JetBrains], also runs builds {groovy-ci}[here].
== Java Profiler
Groovy core team tunes performance through YourKit Java Profiler, which is sponsored by https://www.yourkit.com[YourKit].
== Friends of Groovy Open Collective
As an independent initiative, community members have set up an open collective for Groovy:
https://opencollective.com/friends-of-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:
image:{sponsors-silver-img}[]
Thank you to our Bronze Sponsors:
image:{sponsors-bronze-img}[]
Thank you to our backers (donating monthly):
image:{backers-monthly-img}[]
Thank you to all our backers:
image:{backers-all-img}[]
== License
Groovy is licensed under the terms of the http://www.apache.org/licenses/LICENSE-2.0.html[Apache License, Version 2.0]
Apache, Apache Groovy, Groovy, and the ASF logo are registered trademarks of The Apache Software Foundation.
The most recent commit recorded on apache/groovy was 3 months ago, based on the GitHub push timestamp. The repository has 1.9k forks — one of the better signals of community interest.
How many stars does apache/groovy have?
apache/groovy has 5.5k GitHub stars — refresh the page for the live number, or check github.com/apache/groovy. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is apache/groovy written in?
apache/groovy is written primarily in Groovy. GitHub's language field is based on the largest share of bytes in the default branch.
What license does apache/groovy use?
apache/groovy is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is apache/groovy associated with?
GitHub's repository topics for apache/groovy: "apache", "compiler", "dynamic-typing", "functional-programming", "groovy", "jvm-languages", "metaprogramming", "programming-language", "static-typing". TopGit's editorial category is open-source.
Where can I see apache/groovy in action?
The project maintains a homepage at https://groovy-lang.org. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about apache/groovy?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/apache/groovy is the definitive source.
Read full README in the tab above.
Still deciding about groovy?
One click hands the question to an AI along with this page — see what it says about groovy.