Git – versioning and managing your software L. Grewe

What is Git? GIT = is a distributed revision control system for software. there are a number of free resources to use GIT and host remotely your code - GitHub and Bitbucket are popular you can also buy commercial versions Created by Linus Torvalds for work on the Linux kernel ~2005 Actually implements a replicated versioned file system

The concept Git maintains versions of software over time

The concept you have code on your local development machine (local git repository) that you can create versions of and commit to a remote Git repository. repository = a location storing and mantaining versioned code

The concept

Another view

Another powerful use -- rollback Scenario: there is a bug in the code that was committed --- you need to QUICKLY go back

3 roles of Git The HEAD (master) = last commit snapshot, pointer to the current branch The Index = proposed next commit snapshot The Working Directory = sandbox (local machine)

Common operations/ nominclature Operations to submit/get code Operations to revert code

Operations to submit/get code commit = the code is read to submit to repository push = pushes it to remote repository pull = gets current code from remote repository merge = if you are trying to push code that has been pushed more recently than you pulled it by another person -- the Git system will ask you to merge the files and clean up any descrepencies. o scenario - you and Jill pull down the current code and you are both working on a file called doit.java. Jill pushes her changed code first. Then you try to push your code??? you could have changed the code in the same place --what is the system to do. You need to go through the process of merging the code and figuring out what conflicts might exist

Operations to revert/undo to previous checkout = if you want to revert to a previous version BEFORE you have committed any changes revert = if you want to undo a certain commit o Sometimes you'll want to undo a certain commit. E.g. when you notice that your changes were wrong, when you introduced a bug, or simply when the customer has decided he doesn't want this anymore reset = if you want to go to a previous version but, not remove the commits ---basically it resets the HEAD(master) to an older branch

Groups of Git commands Setup and branch management o init, checkout, branch Modify o add, delete, rename, commit Get information o status, diff, log Create reference points o tag, branch

Some of the operations

Branching The next step

Branching the concept Sometimes you want to have two different paths the development of your software can go. Example: maybe you want to have a version for your corporate customers and a different version for your military customers It lets you create isolated development environments within a single repository.

Another use of branches Want to add a new feature or fix a you can spawn a new branch to encapsulate your changes. o makes sure unstable code is never committed to the main code base, and it gives you the chance to clean up your feature’s history before merging it into the main branch.

You can merge a branch into the master Using the merge command you can merge a branch back into the master Different kinds of merging

Lets look at some operations

Branches – the master is your first branch master A > git commit –m ‘my first commit’ NOTE: we are showing you the command line interface for git.. Note you can use GUI GIT tools for local repositories like SourceTree or others.

Adding commits to master master > git commit ***** ABC NOTE: we are showing you the command line interface for git.. Note you can use GUI GIT tools for local repositories like SourceTree or others.

Creating a New Branch and having master point to it bug123 master > git branch bug123 > git checkout bug123 OR short cut > git checkout –b bug123 > git branch bug123 > git checkout bug123 OR short cut > git checkout –b bug123 ABC NOTE: we are showing you the command line interface for git.. Note you can use GUI GIT tools for local repositories like SourceTree or others. At end of checkout master (start) points to bug123 branch

Continuing commits –will be where the head is pointing to –which is our bug123 branch master > git commit ****** ABC DE bug123 The commits are going to bug123

Lets point back to master master > git checkout master ABC DE bug123

Now we want to merge bug123 into our head (current pointing to master) bug123 master > git merge bug123 ABCDE

The results of merging master > git branch -d bug123 ABCDE Now lets delete our branch bug123

Another use scenario Let’s consider another scenario. Here we created our bug story branch back off of (C). But some changes have happened in master (bug 123 which we just merged) since then. And we made a couple of commits in bug 456.

Our starting place master ABCDE FG bug456

Check out master so we can merge next master ABCDE FG bug456 > git checkout master

Merge bug456 branch into head (master) master ABCDE FG > git merge bug456 H bug456 And now we merge, connecting the new (H) to both (E) and (G). Note that this merge, especially if there are conflicts, can be unpleasant to perform.

The results master ABCDE FG > git branch -d bug456 H Cleanup- delete branch bug456

Working in teams with Git How it can help you….

Working as a team My Local Repo Tom’s Repo Tracey’s Repo Matt’s Repo ABC ABCABC ABC Everyone has initially the same code on their local machines –checked out from remote master repository

Here we are working and we are sharing the remote repository My Local Repo Tom’s Repo Tracey’s Repo Matt’s Repo ABC ABCABC ABC Remote Repo A A B B C C D D D D D D

What will we do…. The next step

What we will use: BitBucket for remote GIT, eGit for support in Eclipse, local client SourceTree for details (try setting up the tutorial example and download SourceTree as part of it). SourceTree can be found directly at See class website for tips on how to setup and of course the websites for each product.

ADVICE: Git has a lot of commands Learn a core subset of them Use GUI tools (we use eGit in Eclipse with Bitbucket online remote Git repository) Then learn the rest as you need them

Have you heard of SVN – what is the difference with Git ….hmmmmm

SVN vs. Git SVN:  central repository approach – the main repository is the only “true” source, only the main repository has the complete file history  Users check out local copies of the current version Git:  Distributed repository approach – every checkout of the repository is a full fledged repository, complete with history  Greater redundancy and speed  Branching and merging repositories is more heavily used as a result  Conclusion –use Git

Who needs Git?