Git is a distributed version control and source code management software. It is a very powerful tool but its distributed nature makes it almost, but not quite, entirely unlike other source code management systems that the developers usually know.
MidPoint development was completely migrated to github in March 2014. This is now the primary source code repository.
Getting Git Client
Linux users usually have git package right in their distribution. Following packages are recommended for Ubuntu Linux users:
- git: basic command-line tool
- gitk: GUI for browsing GUI history, etc.
- git-gui: GUI for committing
Users that are "package management challenged" (mostly windows users) can download git client here:
MidPoint Git Repository
Primary midPoint git repository is maintained at github:
Browsing the Source Code and History
|Github user interface.|
Getting the Source Code
Read-only Public Access
Clone midPoint repository by using following command-line command
Git downloads the repository and provides access to the latest source code (master). Use the following command if you later want to update your source code to the latest version:
You can cooperate in midPoint without a need for read-write access. You can use github user interface to "fork" midPoint. You do not need to ask for any permission to do this. Then you develop your contribution on that "fork". When the contribution is done then you issues a pull request. The pull request is a request to "pull" your contribution to the main midPoint development branch. The pull request will be received by the midPoint maintainer and you will be contacted about the next steps.
Read-write Developer Access
Read-write access to midPoint repository is appropriate for members of the core midPoint team and contributors that are contributing to midPoint frequently.
Make sure you have set up your git identity, e.g. by using the following command-line commands:
The developer access requires github account and the account needs to be added to the development team. Request the account if needed. Github is using SSH and HTTPS protocols to access the repository. For a long-term development it is perhaps best to use SSH and set up a proper SSH credentials before accessing the account. Setting up SSH key-pair authentication is the most convenient and perhaps also the most secure way.
Clone midPoint repository by using following command-line command:
Committing changes (skipping the staging area):
Pushing commits to server
Updating changes from the server
- playground is a place for experiments. Prototypes, ideas, unfinished parts or any other pieces of code in early development stages may be here. Most of that is laboratory stuff. Things may explode here.
- midpoint-design is a place for architecture and design models, diagrams, documents, schemas, etc. It does not relate to any specific midPoint version, it may describe plans for quite a distant future, therefore it is not a part of main midpoint source code repository.