5 Minutes git tutorial

What is git?

Git is a distributed version control system that not only automatically records the changes of each file, but also allows colleagues to collaborate and edit, so that users do not need to manage a bunch of files, and do not need to transfer files from / to colleagues. It keeps track of any change to any files (git diff, git log and git blame) in your project. It allows you to easily see history of modifications of a file, or restore the file to any time point in the history.

In the context of research I see git as a way to collaborate with yourself over time. With git you never have to (or allowed to) keep multiple versions of your script like code_v1.R, code_version_20191015.py, etc. It will of course also make it easy for others to contribute to your project in a trackable fashion.

Install git

In command terminal type git to check if it is installed. If not please try search online for installation instructions specific to your operating system. One way to do it is to first install conda then use conda install -c anaconda git to install git.

Your first github project

Create a github repository and clone to local computer

We use “repo” to stand for “repository”. You can simply understand it as an inventory of files. Files in this inventory will be managed by git to track changes, additions and modifications.

1. Create a GitHub repo online at https://github.com/<your github account>' where <your github account> is your github username.
2. Under repositories tag click new repository and type in any name for it. Here I suggest let’s call it *compbio-recipes* (for reasons to be revealed later). You can either choose Private or Public repo it does not matter at this point. When creating the repository I sugget you select the option “Include a README.md file” so github will create an actual repo on github with that file instead of creating an empty repo.
3. Now you can download, make changes and contribute back to it. To download (or “clone” in git’s terminology) this repo to your local computer, type git clone https://github.com/<your github account/compbio-recipes in your shell command terminal.
4. Use cd compbio-recipes to navigate to the downloaded compbio-recipes repo.

Add files to the repository

Under this folder let’s create a file called software-config.md using the following commands

 $ echo "# Recipes for software configurations" > software-config.md
 $ git add software-config.md
 $ git commit -am "Add an example`
 [master (root-commit) 703f32e] Add an example
 1 file changed, 1 insertion(+)
 create mode 100644 software-config.md 

Here -m carries a message to explain this change. This will help others — and more importantly, yourself — to understand the change easily without looking into the code.

Push your change to repo into GitHub.com

The previous step wrote changes to a local copy of the git repo on your computer. To upload your changes to the online repository you have to push your change to repo into GitHub. It is very important that you push to the online repo to “finalize” your changes to the project.

git push

Update the local clone of repos

Update the local clone of repositories before editing and commiting new information,

git pull

Keep notes of what you do

Now you are in a good position to use git/github for various purposes! Let’s start with notes keeping – the repo you just created, compbio-recipes, can be used to keep your own notes of various “recipes” to setup your computational environment that are specific to your own computer and projects that we don’t discuss in this wiki.

Beyond 5 minutes

Here is a table of most essential git commands:

I think it is about 95% of the daily git commands I use! There are plenty material online to learn about these commands. I suggest you experiment with / learn these commands as you use git, hopefully starting from now.

Additionally here are some (random) git tips I find useful for more advanced uses.