Groovy sources
The sources of the Groovy project are hosted on Codehaus Git infrastructure.
- You can browse the sources online: http://git.codehaus.org/gitweb.cgi?p=groovy-git.git
- And you can learn about the repository details on the Xircles Codehaus admin interface: http://xircles.codehaus.org/projects/groovy/repo/git/repo
Additionally, the sources are mirrored on GitHub: https://github.com/groovy/groovy-core
If you're interested in contributing, you can send us GitHub pull requests, or submit patches through JIRA. Please see our contribution page for more.
Checkout the code
First of all, you'll need to have Git installed on your machine, whether through the support of your IDE, or as a command-line tool.
If you want to checkout the source code of Groovy, there are two different URLs you can use:
- if you're a Groovy developer, please use: ssh://git@git.codehaus.org/groovy-git.git
- otherwise, use the anonymous access: git://git.codehaus.org/groovy-git.git
From the command-line, if you're a Groovy developer, you can use the command:
Or for anonymous access:
You can checkout different branches, in particular:
masteris the latest Groovy branch, for the upcoming major versionGROOVY_1_8_Xis the branch of the curret Groovy 1.8.x versions (current stable version)GROOVY_1_7_Xis the branch for the previous official version of Groovy 1.7.x
For fetching a branch the first time, simply use:
To checkout a particular branch:
|
Developers: Make sure your SSH information is up-to-date in Xircles and that your SSH key is available to your command-line client or IDE integration. |
Committing your changes (developers)
Use the commit command:
Picking commits from another branch
Say you have committed your changes on master and want to merge a particular comming on GROOVY_1_8_X, you can procede as follows:
Staying up-to-date
To see what's the status of your source tree, you can call:
And if you want to see all the latest commits that you have locally, you can do:
To retrieve the changes that have been pushed to the server, you can do:
Of more explicitely:
Pushing your changes upstream
The various commits you've made are done locally, now is the time to share them with the world by pushing your changes:
If you're a Groovy despot, you can also push your changes to github. But for that, first, you'll have to have configured an additional remote with:
Then you can push the changes back to GitHub as well:
Additional links
If you want to learn more about Git, there are many available resources online, such as:
- the GitHub cheatsheet
- the Pro Git book