Git HowTo

Setup ssh keys

It is recommended to use git via ssh instead of https. To save yourself the trouble of entering your password everytime, copy your ssh public key into your git account. The public key is in $HOME/.ssh/id_rsa.pub file; if you dont have it, then generate it by typing this in terminal 

ssh-keygen

and press enter to all the questions. Now log in to your git account in your browser, go to settings page where you will find a place to copy the ssh key.

Watch repositories

When you are collaborating with me on some project, we have to share code via git. When I update the code in my repository, you must get a notification that there is an update. For this to happen, you must watch the repository. Go to the webpage of the repository and look for "Watch" link and enable it.

Some rules to follow

  1. Do not commit trivial changes like adding extra blank line or blank space.
  2. Before a commit or when creating a pull request, check every changed line and ensure that you made the change and that you would like to check it in.
  3. Make sure that files you add don't have execute permission.

Adding files

To add all modified files which are already tracked

git add -u

Undoing commit which is not yet pushed

Suppose you have not pushed your commit to remote. Then undo last commit while keeping changes from it (unstaged) 

git reset HEAD^

An equivalent command is 

git reset --soft HEAD~1

If you want to undo last commit and throw away the changes 

git reset --hard HEAD~1

Cleaning up

To remove all untracked files in the current directory

git clean . -fx

To remove all untracked files and directories in the current directory

git clean . -fxd

Checkout old version

If you want to use an old version of the code, then find the SHA checksum of the commit using git log and then do

git checkout <checksum>

The HEAD is now set to the selected commit and you can see this by doing git branch. If you now want to go back to master, do

git checkout master

Making a branch

Create a new branch 

git branch my_branch

Checkout your new branch 

git checkout my_branch

Make changes in this branch, add files and commit them to your branch. Then push them to remote 

git push origin my_branch

To merge your branch into master 

git checkout master
git merge my_branch

You can now push master to your origin and then create a pull request.

Make your fork track original upstream repo

git checkout master
git remote add upstream git@github.com:upstreamname/projectname.git

Now you can get updates from upstream 

git fetch upstream
git merge upstream/master

To send these changes to your own remote 

git push origin master

Rebase branch to master

git checkout master 
git pull origin master
git pull upstream master
git checkout my_branch
git rebase master

The last step might indicate some conflicts which have to be resolved.

Squash commits

You may want to squash several commits into one before creating a pull request.

  1. git rebase -i yourbranchname
  2. A file in an editor program will be automatically open.
  3. Change all commits from "pick" to "fixup" but one commit must have "pick"!
  4. Save the file and close the editor.
  5. git push -f origin yourbranchname

Delete branch which is not merged

git branch -D my_branch
git push origin :my_branch

Accepting and merging a pull request

git checkout master
git remote add contributor git://github.com/contributor/projectname
git fetch contributor
git merge contributor/newfeature
git push origin master

Download private repo via ssh

git archive --remote=ssh://git@bitbucket.org/USERNAME/REPO.git --format=zip \
    --output="FILENAME.zip" master

Create archive locally (without .git)

cd DIRECTORY
git archive -o latest.zip HEAD

Find hash for your local version of code

git describe --abbrev=16 --dirty --always

Get a pull request for testing purpose

To test the commits in a pull request, you can fetch the pull, create a branch and then test it. 

git fetch origin pull/9874/head:9874
git checkout 9874