Git plugins for Gradle.


Keywords
git, gradle, gradle-plugin
License
Apache-2.0

Documentation

gradle-git

Bintray Travis GitHub license

Project Status

gradle-git has been around since 2012 and has evolved quite a bit from the original release. In order to continue to evolve these features, this project is being broken up into multiple repositories. As such:

  • gradle-git will no longer be maintained
feature replacement comments
org.ajoberstar.grgit grgit Grgit has been an independent project since 2013 and has been stable for quite a while. Version 2.0 removed some deprecated features, but otherwise is fully compatible with existing usage. It also integrates the org.ajoberstar.grgit plugin directly into the project.
org.ajoberstar.github-pages gradle-git-publish org.ajoberstar.git-publish is a more robust version of the old plugin. It is functionally equivalent (or better), but does require porting configuration over as noted in the README.
org.ajoberstar.release-* reckon Reckon focuses solely on determining your project version (and assisting with tagging and pushing that tag). It provides an opinionated model of how to apply semantic versioning, with more finite configuration options.
org.ajoberstar.release-* nebula-release If reckon doesn't suit your needs, nebula-release has forked the gradle-git release plugin and can serve as a replacement for this.

Why do you care?

Git is immensely popular and being able to interact with it as part of a build process can be very valuable to provide a more powerful and consistent result.

What is it?

gradle-git is a set of Gradle plugins:

  • org.ajoberstar.grgit - provides a Grgit instance, allowing interaction with the Git repository the Gradle project is contained in
  • org.ajoberstar.github-pages - publishes files to the gh-pages branch of a Github repository
  • org.ajoberstar.release-base - general structure for inferring a project version and releasing it
  • org.ajoberstar.release-opinion - opinionated defaults for org.ajoberstar.release-base

See Grgit for details on the Git library used underneath, including configuration for authentication.

Usage

NOTE: gradle-git modules require Java 7 (or higher).

Questions, Bugs, and Features

gradle-git is not maintained anymore. See the Project Status section above for details.

Contributing

gradle-git is not maintained anymore. See the Project Status section above for details.

Acknowledgements

Thanks to all of the contributors.

Credit goes to Peter Ledbrook for the initial idea for the org.ajoberstar.github-pages plugin.

Thanks to Zafar Khaja for the very helpful java-semver library.