Looking to get the Mifos source code? You've come to the right place. Instructions Instructions on getting, and contributing to, the Mifos source code through our Git repository can be found below.
Effective use of version control is critical to effective team collaboration on Mifos. Our version control system is how we communicate code changes with one another.
Table of Contents | ||||
---|---|---|---|---|
|
Browse Source
Download a snapshot
- Download the latest code without version control
- Current Mifos source code under development Zip archives (not release)
If you want to do download source code of some previous release then you should browse the repository and use "snapshot" link to download that code as a tar.gz archive.
Developer Setup
Follow Please follow this section completely before cloning any Mifos repositories!.
1. Install Git
...
The following sections outline how to install git on Windows, Ubuntu and the Mac OS:
Installing Git on Windows:
- Install msysGit (look for a file named similarly to
Git-1.7.0.2-preview20100309.exe
) - select default components
- in "Adjusting your PATH environment" select "Run Git from the Windows Command Prompt"
- choose the default for the "Configuring the line ending conversions": "Checkout Windows-style, commit Unix-style line endings"
...
Installing Git on Ubuntu:
No Format |
---|
sudo apt-get install git-core
|
...
You may also find Step 4 of the Ubuntu install guide to be a handy reference.
Installing Git on Mac OS:
To install using macports, follow instructions here.
Alternately, an installer (.dmg) can be found at git's web site. (This .dmg file has been found to work just fine on Snow Leopard as well, despite being labeled as for as for Leopard.)
...
2. Configure Git line endings
Tell Git to handle line endings for you so folks on different platforms can live in harmony.
Configure line endings on Windows:
Do this on the Git Bash MINGW msysGit command line:
No Format |
---|
git config --global core.autocrlf true |
Configure line endings on Linux
...
or Mac
...
Do thisOS:
No Format |
---|
git config --global core.autocrlf input |
More
...
information on line endings is available at the following URLs:
- http://help.github.com/dealing-with-lineendings/
- http://article.gmane.org/gmane.comp.version-control.git/146485
3. Configure Git Author Info
To make all commits clear/legible/accessible, please configure git to use your full, real name and email.
This means...means user.name
must be your real/legal first and last name. Do not abbreviate either. If you have more than two names, pick the two you are most commonly known by.
...
No Format |
---|
git config --global user.email joe@example.com |
Day to day usage
For a quick summary, see the Git homepage.
Clone
...
4. Clone the codebase (read-only)
This is basically similar to a checkout operation - you'll get a read-only personal copy of the source code, which you can examine and modify .
For read-only access:
No Format |
---|
git clone git://mifos.git.sourceforge.net/gitroot/mifos/REPOSITORY_NAME
|
Where REPOSITORY_NAME is "head", or as you like.
In the following example, we clone the "head" repository, but you can clone any of the repositories listed at httphttps://mifos.git.sf.net/github.com/mifos (also see below for a table tables explaining purposes of the various repositories). To clone the head repository:
No Format |
---|
git clone git://mifos.git.sourceforge.net/gitroot/mifos/head
|
Read-write access uses a url with an "ssh" schema, and permission granted by a current Mifos maintainer.
No Format |
---|
ssh://USERNAME@mifos.git.sourceforge.net/gitroot/mifos/head
|
Where USERNAME is your sf.net username.
Which repository should I clone?
Active/current repositories
...
repository
...
github.com/mifos/head.git
|
Active repositories:
Repository | Purpose |
---|---|
bi | |
cloud | Code related to the Mifos cloud. |
documents | Mifos documentation and various files that don't belong in head. |
head | Most work on the Mifos MIS Java Web application happens here. Many development branches exist. Mifos release maintenance branches are also found in head, one for each release since 1.6.x. |
maven | Maven-related code used for building code in the head repository. |
plugins | Mifos plugins. Projects in this repository build plugins to assist with imports of various kinds of transactions into Mifos. |
www | Code for mifos.com and mifos.org. |
Archived/deprecated/old/inactive repositories:
repository | purpose |
---|---|
cheetah | A spike on a complete Mifos rewrite. Mostly incorporated into head. |
htmlcss | Static version of Mifos UI used during a Summer of Code 2010 CSS redesign project. |
marketplace | A An old spike. |
1.4.x | "master" in this repository is an old (1.4.x) release maintenance branch. See head for code for 1.6.x and later releases. |
1.45.x | "master" in this repository is an old (1.5.x) release maintenance branch. See head for code for 1.6.x and later releases. |
Key-based auth
Unless you want to enter your password for every push, post your public SSH key on sf.net. Once you have logged onto your sourceforge account, navigate the the account/ssh page and paste your authorized public key on the form. To reach the edit ssh keys page on sourceforge, click on Account in the upper right corner, then click the Services Tab. Look for "Edit SSH Keys for Shell/CVS" link.
...
5. Fork the repository
To obtain a personal copy of the source code, which you can immediately commit to, head to Github (http://www.github.com/) and create an account there. You can fork the main Mifos repository by:
No Format |
---|
git clone git@github.com:username/head.git
|
Add the Mifos repository as the upstream repository (the repository the fork came from):
No Format |
---|
git remote add upstream git://github.com/mifos/head.git
|
If, whilst you've been inspecting the code or making changes, other commits have been made to the Mifos repository that you cloned, you can pull in upstream changes from the original repository with:
No Format |
---|
git fetch upstream
|
More help is available here: https://help.github.com/articles/fork-a-repo
6. Commit to a local repository
Add files to the git "index" so they will be committed with "git add". Optionally, instead of running "git add", include -a when running "git commit" to commit all local modifications except new files. Then, commit:
...
In Git, the first 80 characters of the first line are, by convention, a summary of the rest of the log message. See Commit Log Guide.
7. Push your changes to a remote repository
If the remote repository is called "origin", you might do:
No Format |
---|
git push origin master |
8. Update your master branch
No Format |
---|
git pull --rebase origin master |
Using rebase is recommended to keep the commit history graph clean. Specifically, trivial merges cause a great deal of clutter. We may eventually institute a server side hook to prevent trivial merges.
9. Creating a patch
Instead of forking the Mifos repository you want to contribute to, you can create a patch. Here are two suggestions.:
1) Create an emailable (or JIRA-attachable) patch from your last local commit:
...
Either way, send the output to the mifos-developer mailing list, and describe your patch following Commit Log Guide.
You can also action the pull request via the Github user interface - just update the Mifos bug ticket with a helpful notification. For example:
No Format |
---|
Submitted in github pull request #x (pending).
|
Branching basics
Please refer to Pro Git: Basic Branching and Merging.
...
Hudson automatically tags commits as they are built. These are currently only stored locally in Hudson's clones. It might be convenient to automatically propagate these tags elsewhere.
Where to get more help
Eclipse IDE Integration
EGit provides "Team" (version control) capabilities in Eclipse.
...
Test restores were performed by copying the backup back to sf.net and cloning.
We moved from sf.net to github https://groups.google.com/forum/#!topic/mifosdeveloper/ksIORnLVHlA/discussion|https://groups.google.com/forum/#!topic/mifosdeveloper/ksIORnLVHlA/discussion