![20
Create a local copy of a repo
2. Two common scenarios: (only do one of these)
a) To clone an already existing repo to your current directory:
$ git clone <url> [local dir name]
This will create a directory named local dir name, containing a working copy of the
files from the repo, and a .git directory which you can ignore (used to hold
the staging area and your local repo)
Example: git clone git@gitlab.cs.washington.edu:rea/superTest.git
b) To create a Git repo in your current directory:
$ git init
This will create a .git directory in your current directory which you can ignore (used to
hold the staging area and your local repo).
Then you can commit files in your current directory into the local repo:
$ git add file1.java
$ git commit ām āinitial project versionā](https://image.slidesharecdn.com/391lecture09-git-18wi-240908075409-7ecd6974/85/391Lecture0909-Vision-control-of-git-ppt-20-320.jpg)
![21
Git commands
command description
git clone url [dir] copy a git repository so you can add to it
git add files adds file contents to the staging area
git commit records a snapshot of the staging area
git status view the status of your files in the working
directory and staging area
git diff shows diff of what is staged and what is
modified but unstaged
git help [command] get help info about a particular command
git pull fetch from a remote repo and try to merge
into the current branch
git push push your new branches and data to a
remote repository
others: init, reset, branch, checkout, merge, log, tag](https://image.slidesharecdn.com/391lecture09-git-18wi-240908075409-7ecd6974/85/391Lecture0909-Vision-control-of-git-ppt-21-320.jpg)
391Lecture0909 Vision control of git.ppt
- 1. 1 CSE 391 Lecture 9 Version control with Git slides created by Ruth Anderson & Marty Stepp, images from http://git-scm.com/book/en/ http://www.cs.washington.edu/391/
- 2. 2 Problems Working Alone ā¢ Ever done one of the following? ļ§ Had code that worked, made a bunch of changes and saved it, which broke the code, and now you just want the working version backā¦ ļ§ Accidentally deleted a critical file, hundreds of lines of code goneā¦ ļ§ Somehow messed up the structure/contents of your code base, and want to just āundoā the crazy action you just did ļ§ Hard drive crash!!!! Everythingās gone, the day before deadline. ā¢ Possible options: ļ§ Save as (MyClass-v1.java) ā¢ Ugh. Just ugh. And now a single line change results in duplicating the entire fileā¦
- 3. 3 Problems Working in teams ļ§ Whose computer stores the "official" copy of the project? ā¢ Can we store the project files in a neutral "official" location? ļ§ Will we be able to read/write each other's changes? ā¢ Do we have the right file permissions? ā¢ Lets just email changed files back and forth! Yay! ļ§ What happens if we both try to edit the same file? ā¢ Bill just overwrote a file I worked on for 6 hours! ļ§ What happens if we make a mistake and corrupt an important file? ā¢ Is there a way to keep backups of our project files? ļ§ How do I know what code each teammate is working on?
- 4. 4 Solution: Version Control ā¢ version control system: Software that tracks and manages changes to a set of files and resources. ā¢ You use version control all the time ļ§ Built into word processors/spreadsheets/presentation software ā¢ The magical āundoā button takes you back to āthe version before my last actionā ļ§ Wikiās ā¢ Wikiās are all about version control, managing updates, and allowing rollbacks to previous versions
- 5. 5 Software Version control ā¢ Many version control systems are designed and used especially for software engineering projects ļ§ examples: CVS, Subversion (SVN), Git, Monotone, BitKeeper, Perforce ā¢ helps teams to work together on code projects ļ§ a shared copy of all code files that all users can access ļ§ keeps current versions of all files, and backups of past versions ļ§ can see what files others have modified and view the changes ļ§ manages conflicts when multiple users modify the same file ļ§ not particular to source code; can be used for papers, photos, etc. ā¢ but often works best with plain text/code files
- 6. 6 Repositories ā¢ Repository (aka ārepoā): a location storing a copy of all files. ļ§ you don't edit files directly in the repo; ļ§ you edit a local working copy or āworking treeā ļ§ then you commit your edited files into the repo ā¢ There may be only one repository that all users share (CVS, Subversion) ā¢ Or each user could also have their own copy of the repository (Git, Mercurial) ā¢ Files in your working directory must be added to the repo in order to be tracked.
- 7. 7 What to put in a Repo? ā¢ Everything needed to create your project: ļ§ Source code (Examples: .java, .c, .h, .cpp ) ļ§ Build files (Makefile, build.xml) ļ§ Other resources needed to build your project: icons, text etc. ā¢ Things generally NOT put in a repo (these can be easily re-created and just take up space): ļ§ Object files (.o) ļ§ Executables (.exe)
- 8. 8 Repository Location ā¢ Can create the repository anywhere ļ§ Can be on the same computer that youāre going to work on, which might be ok for a personal project where you just want rollback protection ā¢ But, usually you want the repository to be robust: ļ§ On a computer thatās up and running 24/7 ā¢ Everyone always has access to the project ļ§ On a computer that has a redundant file system (ie RAID) ā¢ No more worries about that hard disk crash wiping away your project! ā¢ Options: ļ§ attu, CSE GitLab, GitHub (do NOT use GitHub for homework!!!)
- 9. 9 Aside: So what is GitHub? ā¢ GitHub.com is a site for online storage of Git repositories. ā¢ Many open source projects use it, such as the Linux kernel. ā¢ You can get free space for open source projects or you can pay for private projects. ā¢ Do NOT use GitHub to store your homework!! Question: Do I have to use GitHub to use Git? Answer: No! ā¢ you can use Git completely locally for your own purposes, or ā¢ you can use the CSE GitLab server, or ā¢ you could share a repo with users on the same file system (e.g. attu) as long everyone has the needed file permissions.
- 10. 10 CSE GitLab Everyone in this course has been given an account on CSE GitLab To use CSE GitLab: 1.Log onto CSE GitLab: https://gitlab.cs.washington.edu/ ļ§ IMPORTANT: If you have a CSENetID use that, otherwise use your UWNetID 2.Add an ssh key: https://gitlab.cs.washington.edu/help/ssh/README.md ļ§ Follow the instructions in README.md which say to type: ssh-keygen -t rsa -C "[email protected]" -b 4096 1.Just hit return to accept the default file location and you do not need a password so hit return both times when prompted for a password ļ§ Then type: cat ~/.ssh/id_rsa.pub ļ§ Copy-paste the key to the 'SSH Keys' section under āProfile Settings' in your user profile on CSE GitLab. Or go directly here: https://gitlab.cs.washington.edu/profile/keys
- 12. 12 Git Resources ā¢ At the command line: (where <verb> = config, add, commit, etc.) $ git help <verb> $ git <verb> --help $ man git-<verb> ā¢ Free on-line book: https://git-scm.com/book/en/v2 ā¢ Git tutorial: http://schacon.github.com/git/gittutorial.html ā¢ Reference page for Git: http://gitref.org/index.html ā¢ Git website: http://git-scm.com/ ā¢ Git for Computer Scientists: http://eagain.net/articles/git-for-computer-scientists/
- 13. 13 History of Git ā¢ Came out of Linux development community ā¢ Linus Torvalds, 2005 ā¢ Initial goals: ļ§ Speed ļ§ Support for non-linear development (thousands of parallel branches) ļ§ Fully distributed ļ§ Able to handle large projects like Linux efficiently
- 14. 14 Git uses a distributed model Centralized Model Distributed Model (CVS, Subversion, Perforce) (Git, Mercurial) Result: Many operations are local
- 15. 15 Ways to use Git Using Git on your own computer, one user Using Git on multiple computers, multiple users or one user on multiple computers Possible servers: ā¢CSE GitLab ā¢attu ā¢GitHub (NOT for homework!)
- 16. 16 A Local Git project has three areas Unmodified/modified Files Staged Files Committed Files Note: working directory sometimes called the āworking treeā, staging area sometimes called the āindexā.
- 18. 18 Basic Workflow Basic Git workflow: 1.Modify files in your working directory. 2.Stage files, adding snapshots of them to your staging area. 3.Do a commit, which takes the files as they are in the staging area and stores that snapshot permanently to your local Git directory (your local copy of the repo). ā¢Notes: 1. If a particular version of a file is in your local git directory, itās considered committed. 2. If itās modified but has been added to the staging area, it is staged. 3. If it was changed since it was checked out but has not been staged, it is modified.
- 19. 19 Get ready to use Git! 1. Set the name and email for Git to use when you commit: $ git config --global user.name āBugs Bunnyā $ git config --global user.email [email protected] 1.You can call git config ā-list to verify these are set. 2.These will be set globally for all Git projects you work with. 3.You can set variables on a project-only basis by not using the --global flag. 2. The latest version of git will also prompt you that push.default is not set, you can make this warning go away with: $ git config --global push.default simple ā¢ You can also set the editor used for writing commit messages: $ git config --global core.editor emacs (it is vim by default) vim tips: āaā add, āescā when done adding, āwq:ā to save and quit vim editor: http://www.gentoo.org/doc/en/vi-guide.xml vim ref card: http://tnerual.eriogerg.free.fr/vimqrc.pdf
- 20. 20 Create a local copy of a repo 2. Two common scenarios: (only do one of these) a) To clone an already existing repo to your current directory: $ git clone <url> [local dir name] This will create a directory named local dir name, containing a working copy of the files from the repo, and a .git directory which you can ignore (used to hold the staging area and your local repo) Example: git clone [email protected]:rea/superTest.git b) To create a Git repo in your current directory: $ git init This will create a .git directory in your current directory which you can ignore (used to hold the staging area and your local repo). Then you can commit files in your current directory into the local repo: $ git add file1.java $ git commit ām āinitial project versionā
- 21. 21 Git commands command description git clone url [dir] copy a git repository so you can add to it git add files adds file contents to the staging area git commit records a snapshot of the staging area git status view the status of your files in the working directory and staging area git diff shows diff of what is staged and what is modified but unstaged git help [command] get help info about a particular command git pull fetch from a remote repo and try to merge into the current branch git push push your new branches and data to a remote repository others: init, reset, branch, checkout, merge, log, tag
- 22. 22 Adding & Committing files 1. The first time we ask a file to be tracked, and every time before we commit a file we must add it to the staging area: $ git add README.txt hello.java This takes a snapshot of these files at this point in time and adds it to the staging area. Note: To unstage a change on a file before you have committed it: $ git reset HEAD filename 2. To move staged changes into the local repo we commit: $ git commit ām āFixing bug #22ā Note: You can edit your most recent commit message (if you have not pushed your commit yet) using: git commit ā-amend Note: These commands are just acting on your local version of repo.
- 23. 23 Use Good Commit Messages HTTP://XKCD.COM/1296/
- 24. 24 Status and Diff ā¢ To view the status of your files in the working directory and staging area: $ git status or $ git status ās (-s shows a short one line version) ā¢ To see difference between your working directory and the staging area (This shows what is modified but unstaged): $ git diff ā¢ To see difference between the staging area and your local copy of the repo (This shows staged changes): (--staged is synonymous) $ git diff --cached
- 25. 25 After editing a fileā¦ $emacs rea.txt $ git status # On branch master # Changes not staged for commit: # (use "git add <file>..." to update what will be committed) # (use "git checkout -- <file>..." to discard changes in working directory) # # modified: rea.txt # no changes added to commit (use "git add" and/or "git commit -a") $ git status -s M rea.txt ļ Note: M is in second column = āworking treeā $ git diff ļ Shows modifications that have not been staged. diff --git a/rea.txt b/rea.txt index 66b293d..90b65fd 100644 --- a/rea.txt +++ b/rea.txt @@ -1,2 +1,4 @@ Here is rea's file. + +One new line added. $ git diff --cached ļ Shows nothing, no modifications have been staged yet. $
- 26. 26 After adding file to staging areaā¦ $ git add rea.txt $ git status # On branch master # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # modified: rea.txt # $ git status -s M rea.txt ļ Note: M is in first column = āstaging areaā $ git diff ļ Note: Shows nothing, no modifications that have not been staged. $ git diff --cached ļ Note: Shows staged modifications. diff --git a/rea.txt b/rea.txt index 66b293d..90b65fd 100644 --- a/rea.txt +++ b/rea.txt @@ -1,2 +1,4 @@ Here is rea's file. + +One new line added.
- 27. 27 Viewing logs To see a log of all changes in your local repo: ā¢$ git log or ā¢$ git log --oneline (to show a shorter version) 1677b2d Edited first line of readme 258efa7 Added line to readme 0e52da7 Initial commit ā¢git log -5 (to show only the 5 most recent updates, etc.) Note: changes will be listed by commitID #, (SHA-1 hash) Note: changes made to the remote repo before the last time you cloned/pulled from it will also be included here
- 28. 28 Pulling and Pushing Good practice: 1.Add and Commit your changes to your local repo 2.Pull from remote repo to get most recent changes (fix conflicts if necessary, then add and commit those changes to your local repo) 3.Push your changes to the remote repo To fetch the most recent updates from the remote repo into your local repo, and put them into your working directory: $ git pull origin master To push your changes from your local repo to the remote repo: $ git push origin master Notes: origin = an alias for the URL you cloned from master = the remote branch you are pulling from/pushing to, (the local branch you are pulling to/pushing from is your current branch)
- 29. 29 Avoiding Common Problems From CSE 331: http://courses.cs.washington.edu/courses/cse331/18wi/tools/versioncontrol.html#git-pitfalls ā¢Do not edit the repository (the .git directory) manually. It wasn't designed for modifications by humans. ā¢Try not to make many drastic changes at once. Instead, make multiple commits, each of which has a single logical purpose. This will minimize merge conflicts. This is good coding practice in general. ā¢Always git pull before editing a file. It's easy to forget this. If you forget, you may end up editing an outdated version, which can cause nasty merge conflicts. ā¢Don't forget git push after you have made and committed changes. They are not copied to the remote repository until you do a push.
- 30. 30 Branching To create a branch called experimental: ā¢$ git branch experimental To list all branches: (* shows which one you are currently on) ā¢$ git branch To switch to the experimental branch: ā¢$ git checkout experimental Later on, changes between the two branches differ, to merge changes from experimental into the master: ā¢$ git checkout master ā¢$ git merge experimental Note: git log --graph can be useful for showing branches. Note: These branches are in your local repo!
- 31. 31 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
- 32. 32 Wrap-up ā¢ You *will* use version control software when working on projects, both here and in industry ļ§ Rather foolish not to ļ§ Advice: just set up a repository, even for small projects, it will save you time and hassle ā¢ HW9 (Git) has more details and walks you through creating a Git repo and adding to a shared repo.
Editor's Notes
- #11: HTTP://XKCD.COM/1597/
- #13: Initial goals were to support development of Linux
- #14: http://git-scm.com/book/en/Getting-Started-About-Version-Control
- #22: Note: To unstage a change on a file before you have committed it: $ git reset HEAD filename Note: To unmodify a modified file: $ git checkout -- filename
- #23: HTTP://XKCD.COM/1296/
- #24: Git diff HEAD will show diff between working tree and staging area vs. the repo
- #28: $ git remote -v origin https://github.com/rea2000/santalist.git (fetch) origin https://github.com/rea2000/santalist.git (push)