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
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, 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