3rdstage's Wiki
Advertisement

References

Commands

category command description remark
Setup git config Get and set repository or global options git config --get core.autocrlf
git config core.autocrlf false
Creating git clone Clone a repository into a new directory
git init Create an empty Git repository or reinitialize an existing one
Basic git add
git status Show the working tree status
git diff Show changes between commits, commit and working tree, etc
git commit
git reset Reset current HEAD to the specified state
git reset --hard Resets the index and working tree. Any changes to tracked files in the working tree since commit are discarded.
git restore Restore working tree files
git rm Remove files from the working tree and from the index
git rm -rf --cached Only remove from the index Working tree files, whether modified or not, will be left alone
Branching git branch List, create, or delete branches
git branch --list List branches. -l
git branch --all List both remote-tracking branches and local branches. -a
git branch --move Move/rename a branch and the corresponding reflog. -m
git branch --delete Delete a branch. -d
git checkout Switch branches or restore working tree files
git log Show commit logs git log master -3
git tag Create, list, delete or verify a tag object signed with GPG
git tag -a Make(create) an unsigned, annotated tag object --annotate
git tag --delete Delete existing tags with the given names. -d
Sharing git pull
git push
git push --all Push all branches (i.e. refs under refs/heads/)
git push --tags All refs under refs/tags are pushed
git push --follow-tags
git push --set-upstream For every branch that is up to date or successfully pushed, add upstream (tracking) reference, used by argument-less git-pull and other commands.
git remote Manage set of tracked repositories
Patching git rebase Reapply commits on top of another base tip
git revert Revert some existing commits Requires your working tree to be clean (no modifications from the HEAD commit)
Administration git clean Remove untracked files from the working tree
git archive Create an archive of files from a named tree git archive -o latest.zip HEAD
Plumbing git ls-files Show information about files in the index and the working tree git ls-files | wc -l
git show-ref List references in a local repository
Guides gitignore ($HOME/.config/git/ignore, $GIT_DIR/info/exclude, .gitignore)
Misc git svn Bidirectional operation between a Subversion repository and Git

Refs

Type Format Example Remarks
Local branches refs/heads/... refs/heads/2.x, refs/heads/3.x
Remote tracking branches refs/remotes/... refs/remotes/origin/master, refs/remotes/upstream/master
Tags refs/tags/... refs/tags/v0.9, refs/tags/v1.5.RELEASE, refs/tags/v2.0.GA
           +--- HEAD
           |
           +--- FETCH_HEAD
           |
           +--- ORIG_HEAD
           |
  .git/ ---+--- refs/ ---+--- heads/ ---+--- master
                         |              |
                         |              +--- next
                         |
                         +--- tags/ ----+--- v0.9
                         |              |
                         |              +--- v1.0
                         |              |
                         |              +--- v1.1
                         |
                         +--- remotes/ ---+--- origin/ --- master
                                          |
                                          +--- upstream/ --- master

Reserved Refs

Reserved Full Description
master refs/heads/master local master branch
origin/master refs/remotes/origin/master
v1.0.1 refs/tags/v1.0.1
HEAD currently checkout commit
FETCH_HEAD the result of the last fetch operation
ORIG_HEAD the commit that was checked out before a merge or rebase operation was started
HEAD
$ cat .git/HEAD
ref: refs/heads/master
$ git checkout test
...
$ cat .git/HEAD
ref: refs/heads/test

Configuration

Variable Data Type Description Default Remarks
push.followTags boolean If set to true enable --follow-tags option by default. false --no-follow-tags

Model

File State-chart

  Untracked           Modified            Staged        Committed
      |                  |                 |               |
      +- add ------------|---------------->|               |
      |                  |                 |               |
      |                  +- add ---------->|               |
      |                  |                 |               |
      |                  |                 +- commit ----->|
      |                  |                 |               |
      |                  |                 |               |
      |                  |<----------------|-------- edit -+
      |                  |                 |               |
      |<-----------------+-----------------+------ remove -|
      |                  |                 |               |


                       * Tracked = Modified | Staged | Committed
                            
  +-----------+            +---------+            +------------+
  | Untracked | ---add---> | Staged  | <---add--- | Modified   |
  |(workspace)|            | (index) |            |(workspace)|
  +-----------+            +---------+            +------------+
                                |                      ^
                                |                      |
                             commit                  edit
                                |                      |
                                |     +-----------+    |
                                +---> | Committed | ---+
                                      +-----------+

Areas

Area Role Description Remarks
Workspace Working directory Consists of files that you are currently working on. Local checkout
Index Staging area, Cache Where commits are prepared.
Stash A place to hide modifications while you work on something else
Local Repository
Upstream Repository

Branching

$ git commit -a -m "..."

                         << master, HEAD >>
                                  |  
    +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+

$ git branch iss31  # branch to work on issue 31 - new feature

                         << master, HEAD >>
                                  |  
    +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+
                                  |
                             << iss31 >>

$ git checkout iss31

                             << master >>
                                  |  
    +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+
                                  |
                          << iss31, HEAD >>

$ # edits or adds some files
$ git commit -a -m ...

                             << master >>
                                  |  
    +----+        +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | <----- | c4 |
    +----+        +----+        +----+        +----+
                                                |
                                        << iss31, HEAD >>

$ # a simple bug is found, create anothter branch for hotfix on 'master' 
$ git checkout master
$ git checkout -b hotfix  # same with 'git branch hotfix; git checkout hotfix'
 
                         << master, HEAD >>
                                  |  
    +----+        +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | <----- | c4 |
    +----+        +----+        +----+        +----+
                                                |
                                           << iss31 >>

                          << hotfix, HEAD >> 
                             << master >>
                                  |  
    +----+        +----+        +----+        +----+
    | c1 | <----- | c2 | <----- | c3 | <----- | c4 |
    +----+        +----+        +----+        +----+
                                                |
                                           << iss31 >>

$ # edits some files to fix the bug
$ git commit -a -m ...

                                           << hotfix, HEAD >>
                                                   |
                                                 +----+
                              << master >>   +-- | c5 |
                                   |         |   +----+
    +----+        +----+        +----+ <-----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+ <-----+ 
                                             |   +----+ 
                                             +-- | c4 |
                                                 +----+
                                                   |
                                              << iss31 >>

$ # after successful testing on hotfix, merge 'hotfix' to 'master'. remove 'hotfix' after merge
$ git checkout master
$ git merge hotfix   # 'master' fast-forwarded
$ git branch --delete hotfix   # --delete == -d

                                              << hotfix >>
                                          << master, HEAD >>
                                                   |
                                                 +----+
                                             +-- | c5 |
                                             |   +----+
    +----+        +----+        +----+ <-----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+ <-----+ 
                                             |   +----+ 
                                             +-- | c4 |
                                                 +----+
                                                   |
                                              << iss31 >>

                                          << master, HEAD >>
                                                   |
                                                 +----+
                                             +-- | c5 |
                                             |   +----+
    +----+        +----+        +----+ <-----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+ <-----+ 
                                             |   +----+ 
                                             +-- | c4 |
                                                 +----+
                                                   |
                                              << iss31 >>

$ # after hotfix, works on 'iss31' branch with other commits
$ git checkout iss31

                                              << master >>
                                                   |
                                                 +----+
                                             +-- | c5 |
                                             |   +----+
    +----+        +----+        +----+ <-----+
    | c1 | <----- | c2 | <----- | c3 | 
    +----+        +----+        +----+ <-----+ 
                                             |   +----+      +----+      +----+  
                                             +-- | c4 | <--- | c6 | <--- | c7 | 
                                                 +----+      +----+      +----+
                                                                           |
                                                                   << iss31, HEAD >>

$ # when 'iss31' implemented successfully
$ git checkout mater
$ git merge iss31   # if no conflict, simple three-way merge with another new commit

                                                                                  << master, HEAD >>
                                                                                           |
                                                 +----+ <------------------------------- +----+
                                             +-- | c5 |                                  | c8 |
                                             |   +----+                           +----- +----+
    +----+        +----+        +----+ <-----+                                    |        |
    | c1 | <----- | c2 | <----- | c3 |                                            |   << iss31 >>
    +----+        +----+        +----+ <-----+                                    | 
                                             |   +----+      +----+      +----+   |
                                             +-- | c4 | <--- | c6 | <--- | c7 | --+
                                                 +----+      +----+      +----+

Commands

merge
      A---B---C topic
     /
D---E---F---G master
git merge topic
      A---B---C topic
     /         \
D---E---F---G---H master
rebase
      A---B---C topic
     /
D---E---F---G master
git rebase master topic
              A'--B'--C' topic
             /
D---E---F---G master
      A---B---C topic
     /
D---E---A'---F master
git rebase master topic
               B'---C' topic
              /
D---E---A'---F master

Readings

Revision

Basic Snapshotting

add, status, diff, commit, restore, reset

status

diff

reset

command Description Remark
restore about restoring files in the working tree from either the index or another commit. does not update your branch
reset updating your branch, moving the tip in order to add or remove commits from the branch. can also be used to restore the index, overlapping with git restore.
revert about making a new commit that reverts the changes made by other commits.

git revert is used to record some new commits to reverse the effect of some earlier commits (often only a faulty one). If you want to throw away all uncommitted changes in your working directory, you should see git-reset, particularly the --hard option. If you want to extract specific files as they were in another commit, you should see git-restore, specifically the --source option. Take care with these alternatives as both will discard uncommitted changes in your working directory.

rm

Branching

branch, checkout, switch, merge, log, tag

branch

  • A branch in Git is simply a lightweight movable pointer to one of these commits.
  • Every time you commit, the master branch pointer moves forward automatically.
  • HEAD is a pointer to the local branch you’re currently on.
Term Description Remark
Remote-tracking Branch
Upstream Branch

checkout

tag

Sharing

fetch, pull, push, remote

Workflow

Hooks

Tools

Misc

Subtree

Typical Usage

List all configuration

$ git config --list --show-scope --show-origin

Adding new items, committing and pushing them

$ git status .                    // identifies added, modified or untracked items under current local directory
$ git add .                       // updates index
$ git status .                    // confirms the changes to be committed
$ git commit -m "message ..."     // commits changes into local repository
$ git status .                    // confirms all changes are committed
$ git push                        // pushes changes in local repository onto the remote repository
$ git log --name-only -1         // lists files in the last commit

When the HEAD of 'origin/master' has changed since the last sync, '$ git push' would fail with messages including fast-forwards. Then,

$ git pull --rebase
...
may need manual merge.
...
$ git push

Working with remote repositories

$ git remote -v          // lists tracking repositories
$ git remote add upstream https://github.com/jpmorganchase/quorum.git     // add a new remote repository to track
$ git branch -r          // lists branches in tracking repositories

Working with branches or tags

$ git tag -ln                                // lists tags
$ git tag -a v2.0.2 -m "before new branch"   // creates a new annotated tag(v2.0.2)
$ git tag origin v2.0.2                      // push a tag to a remote 
$ git push origin --tags                     // pushes all local tags to remote 'origin'

$ git branch                                 // lists branches
$ git branch -a                              // lists both local and remote-tracking branches
$ git branch -avv                            // lists all branches showing hash and upstream branch if any

$ git branch 1.1                             // creates a new branch(1.1) from the master (branch)
$ git branch 2.0.2-ext v2.0.2                // creates a new branch(2.0.2-ext) from a tag(v2.0.2)
$ git push origin advanced:advanced          // creates remote branch 'origin/advanced' from local branch 'advanced'
$ git push --set-upstream origin advanced    // sets upstream(tracking) reference for current branch to 

$ git checkout release-1.1                   // updates working tree to release-1.1
$ git checkout -b gh-pages origin/gh-pages   // copies remote branch to local repository

Tracking changes

$ git log master -3                          // lists 3 recent commits for master branch
$ git log v2.0.2 -3                          // lists 3 last commits before the tag of 'v2.0.2'
$ git log origin/master -1                   // lists last commit of remote branch 'origin/master'
$ git log upstream/master -1                 // lists last commit of remote branch 'upstream/master'
$ git log --name-only -1                    // lists files in the last commit.

Undoing

Use-case Solution Remarks
Removing untracked files and directories git clean -dx
Removing uncommitted changes on all the tracked files git reset --hard
Removing uncommitted changes on a single or selected tracked files
Removing committed changes git revert

Removing untracked files and directories in the working tree

$ git clean -ndx          // -n: dry run, -d: directory also, -x: skip gitignore
...
$ git clean -ffdx         // -ff: force including files manged by different Git repository
...

For more, refer

Undoing tracked files

  • To remove uncommitted changes on tracked files in the working tree, use 'git reset --hard'.
$ git reset --hard          // resets the index and working tree. Any changes to tracked files in the working tree since <commit> are discarded.
  • To unstage a staged file, use 'git reset HEAD <<file>>'.
$ git reset HEAD CONTRIBUTING.md
  • To unmodify a modified file, use 'git checkout -- <<file>>'.
$ git checkout -- CONTRIBUTING.md


Removing committed changes

@TODO

Creating and pushing tag

$ git tag -a v1.0 -m "Ready to offer externally"
...
$ git push origin v1.0
...

Creating local repository using existing artifacts and pushing it to the remote bare repository

$ git init
$ git add .
$ git status .
$ git commit -m "..."
$ git remote add origin https://github.com/.../....git
$ git push --set-upstream origin master
$ git remote -v

Look around local repository

$ git status .          // show the working tree status
$ git branch -avv       // list both remote-tracking branches and local branches.
$ git tag -ln           // list tags
$ git remote -v         // list tracking repositories
$ git show-ref --head   // list references in a local repository 
$ git log origin/master -3  // lists 3 recent commits for remote branch 'origin/master'
$ git ls-files         // show information about files in the index and the working tree
$ git config -l        // list all variables set in config file, along with their values.

Companions

GitHub

Markup Extension Library
Markdown .markdown, .md https://github.com/gjtorikian/commonmarker
MediaWiki .mediawiki, .wiki https://github.com/nricciar/wikicloth
Textile .textile https://github.com/jgarber/redcloth
AsciiDoc .asciidoc, .adoc http://asciidoctor.org/
reStructuredText .rst

GitHub Pages

EGit

Gitorious

  • Desc : Git hosting and collaboration software that you can install yourself
  • License : GNU Affero General Public License

GitLab

Gogs

Tips and Tricks

Typical .gitignore

A typical .gitignore file contains

# references
#   https://git-scm.com/docs/gitignore
#   https://github.com/github/gitignore

# source version control related
CVS/
.svn/
.hg

# IDEs or tools related
/.idea/
/.vscode/
.gradle/

# directories for intermediate or final compiled artifacts
/bin/
/target/
/build/
/output/
/Debug/
/Release/
/x86/
/x64/
/obj/

# dependencies
/node_modules/*
/pkg/

# generated artifacts
/reports/
/_site/
.apt_generated/
.atp_generated_tests/

# runtime outputs
/run/
/log/
/logs/
/test-output/
*.log
npm-debug.log

# backups, caches, or temporary artifacts
.~*
._*
*.bak
.cache*
.*.swp
*.md.html
package-lock.json
Gemfile.lock
.sass-cache
__pycache__/
.pytest_cache/
packer_cache/

# misc
config.gypi
.npmrc
.jekyll-metadata
.DS_Store
.lock-wscript
.wafpickle-N

# build outputs of Remix-IDE for smart contracts - https://remix-ide.readthedocs.io/en/latest/contract_metadata.html
contracts/**/artifacts/


# don't ignore OpenZeppelin contracts
# !/node_modules/@openzeppelin
# /node_modules/@openzeppelin/*
# !/node_modules/@openzeppelin/contracts-3
# /node_modules/@openzeppelin/contracts-3/build
# /node_modules/@openzeppelin/contracts-3/package.json
# /node_modules/@openzeppelin/contracts-3/**/artifacts
# !/node_modules/@openzeppelin/contracts-4
# /node_modules/@openzeppelin/contracts-4/build
# /node_modules/@openzeppelin/contracts-4/package.json
# /node_modules/@openzeppelin/contracts-4/**/artifacts

For more, refer

Typical .gitattribute

* -text

*.tag -text
*.MF -text
*.aj -text
*.ftl -text
*.mediawiki -text
*.textile -text
*.q -text
*.g -text
*.tokens -text
*.script -text
*.cfg -text
.classpath -text
.project -text
.jsdtscope -text
*.prefs -text
*.component -text
*.launch -text
.springBeans -text
.euml2 -text
.umlproject -text
.clay -text
.fbprefs -text
.pmd -text
.lint4jprefs -text
.jshintrc -text

*.sol linguist-language=Solidity

# Declare files that will always have CRLF line endings on checkout.
*.sln text eol=crlf

# Denote all files that are truly binary and should not be modified.
*.a binary
*.o binary
*.so binary
*.lib binary
*.com binary
*.exe binary
*.dll binary
*.bin binary
*.zip binary
*.7z binary
*.png binary
*.jpeg binary
*.jpg binary
*.gif binary
*.bmp binary
*.tif binary
*.tiff binary
*.mp3 binary
*.mp4 binary
*.avi binary
*.flv binary
*.ico binary
*.class binary
*.jar binary
*.doc binary
*.docx binary
*.xls binary
*.xlsx binary
*.ppt binary
*.pptx binary
*.pdf binary
Advertisement