Git is a free and open source distributed version control system. It allows to track changes in source and allows multiple people to work on the same code base.
We currently switching from svn to git and the repositories are/will be hosted on GitHub.
The analysis code for LCLS is currently hosted in the lcls-psana organization on GitHub.
Once the code is cleaned up and we have less repositories we will move the code to the slac-lcls organization. This organization will also be used by the DAQ group and allows to group all of your code development together.
GitHub account
If you do not already have a GitHub account, sign up for a new account on GitHub.Setup git
The following steps describe how to setup git. This setup has to done only once for the machine where you are planing to develop code.
Setting the user name in git:
git config --global user.name "my name"
Setting the email address in git:
git config --global user.email "my email"
Confirm that your user name is correct by:
git config --global user.name
Confirm that your email is correct by:
git config --global user.email
Setup ssh keys for your GitHub account
To make the development more convenient it is recommended to setup ssh keys for your GitHub account.
Detailed instructions can be found here:
https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/
Adding ssh keys can be done in the settings of your GitHub account (top right button on GitHub) and in the settings menu there is a "SSH and PGP keys" section.
Check if you already have an ssh key by checking if the following file exists: ~/.ssh/id_rsa.pub
If yes, create a new ssh key on GitHub and copy the content of ~/.ssh/id_rsa.pub to the Key section.
If you don't already have a ssh key, create a new one with the following command
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
Afterwards create a new ssh key on GitHub and copy the content of ~/.ssh/id_rsa.pub to the Key section.
Useful Commands
Check status of the repo
git status
Show current and available branches in the repository
git branch
Show local changes in the code since the last commit
git diff
Git workflow
The following section describes the workflow for developing software with git.
Clone repository
The first step is to clone the repository you want to contribute by using the flowing command:
git clone git@github.com:lcls-psana/"the repository you want to clone".git
The repository where you clone from is typically called "upstream". This is the global copy of the repository that all developers share and work on together.
Git clone creates a local copy of the repository in a new folder with the same name as the repository. Any changes that you do to the repository only effect your local copy until you push the changes upstream.
All git commands have to be issued from inside the directory of the git repository.
Make changes to the code
After cloning the repository make changes to the code
Adding new files to the git repo
If you created new file they can be added to git with the following command:
git add "file"
Commit changes
After changing the code these changes have to be committed with:
git commit -a -m "commit message"
Push commits upstream
After committing the changes into the local repository they have to be pushed upstream to make them available for the other developers.
git push origin master
This can fail if upstream is ahead of you local version. In this case you first have to get the most recent changes from upstream:
git fetch origin git rebase -p origin
if
git rebase --skip ignores local change
change file locally and commit changes
git rebase --continue
git push origin masterMore information https://www.derekgourlay.com/blog/git-when-to-merge-vs-when-to-rebase/
git push origin "branch name"Overview
Content Tools