2019-05-21 16:53:11 +08:00
# git plugin
2013-06-05 21:16:51 +08:00
2019-05-21 16:53:11 +08:00
The git plugin provides many [aliases ](#aliases ) and a few useful [functions ](#functions ).
2013-07-12 21:26:04 +08:00
2019-05-21 16:53:11 +08:00
To use it, add `git` to the plugins array in your zshrc file:
2013-07-12 21:26:04 +08:00
2019-05-21 16:53:11 +08:00
```zsh
plugins=(... git)
```
2013-07-12 21:26:04 +08:00
2019-05-21 16:53:11 +08:00
## Aliases
2013-07-12 21:26:04 +08:00
2020-02-19 04:05:52 +08:00
| Alias | Command |
|:---------------------|:---------------------------------------------------------------------------------------------------------------------------------|
| g | git |
| ga | git add |
| gaa | git add --all |
| gapa | git add --patch |
| gau | git add --update |
| gav | git add --verbose |
| gap | git apply |
2020-05-22 22:56:03 +08:00
| gapt | git apply --3way |
2020-02-19 04:05:52 +08:00
| gb | git branch |
| gba | git branch -a |
| gbd | git branch -d |
2021-08-28 00:07:19 +08:00
| gbda | git branch --no-color --merged \| grep -vE "^([+*]\|\s*($(git_main_branch)\|$(git_develop_branch))\s*$)" \| xargs git branch -d 2>/dev/null |
2020-02-19 04:05:52 +08:00
| gbD | git branch -D |
| gbl | git blame -b -w |
| gbnm | git branch --no-merged |
| gbr | git branch --remote |
| gbs | git bisect |
| gbsb | git bisect bad |
| gbsg | git bisect good |
| gbsr | git bisect reset |
| gbss | git bisect start |
| gc | git commit -v |
| gc! | git commit -v --amend |
| gcn! | git commit -v --no-edit --amend |
| gca | git commit -v -a |
| gca! | git commit -v -a --amend |
| gcan! | git commit -v -a --no-edit --amend |
| gcans! | git commit -v -a -s --no-edit --amend |
| gcam | git commit -a -m |
2021-05-03 23:35:13 +08:00
| gcas | git commit -a -s |
| gcasm | git commit -a -s -m |
2020-02-19 04:05:52 +08:00
| gcsm | git commit -s -m |
| gcb | git checkout -b |
| gcf | git config --list |
| gcl | git clone --recurse-submodules |
2019-10-06 10:19:14 +08:00
| gccd | git clone --recurse-submodules "$@" & & cd "$(basename $_ .git)" |
2020-02-19 04:05:52 +08:00
| gclean | git clean -id |
2020-03-03 21:06:40 +08:00
| gpristine | git reset --hard & & git clean -dffx |
2021-08-10 22:31:49 +08:00
| gcm | git checkout $(git_main_branch) |
| gcd | git checkout $(git_develop_branch) |
2020-02-19 04:05:52 +08:00
| gcmsg | git commit -m |
| gco | git checkout |
2021-06-14 01:25:27 +08:00
| gcor | git checkout --recurse-submodules |
2020-02-19 04:05:52 +08:00
| gcount | git shortlog -sn |
| gcp | git cherry-pick |
| gcpa | git cherry-pick --abort |
| gcpc | git cherry-pick --continue |
| gcs | git commit -S |
| gd | git diff |
| gdca | git diff --cached |
| gdcw | git diff --cached --word-diff |
| gdct | git describe --tags $(git rev-list --tags --max-count=1) |
| gds | git diff --staged |
| gdt | git diff-tree --no-commit-id --name-only -r |
2020-05-24 00:57:13 +08:00
| gdnolock | git diff $@ ":(exclude)package-lock.json" ":(exclude)* .lock" |
2021-10-06 16:13:38 +08:00
| gdup | git diff @{upstream} |
2020-02-19 04:05:52 +08:00
| gdv | git diff -w $@ \| view - |
| gdw | git diff --word-diff |
| gf | git fetch |
| gfa | git fetch --all --prune |
| gfg | git ls-files \| grep |
| gfo | git fetch origin |
| gg | git gui citool |
| gga | git gui citool --amend |
| ggf | git push --force origin $(current_branch) |
| ggfl | git push --force-with-lease origin $(current_branch) |
| ggl | git pull origin $(current_branch) |
| ggp | git push origin $(current_branch) |
| ggpnp | ggl & & ggp |
| ggpull | git pull origin "$(git_current_branch)" |
| ggpur | ggu |
| ggpush | git push origin "$(git_current_branch)" |
| ggsup | git branch --set-upstream-to=origin/$(git_current_branch) |
| ggu | git pull --rebase origin $(current_branch) |
| gpsup | git push --set-upstream origin $(git_current_branch) |
| ghh | git help |
| gignore | git update-index --assume-unchanged |
| gignored | git ls-files -v \| grep "^[[:lower:]]" |
2021-08-10 22:31:49 +08:00
| git-svn-dcommit-push | git svn dcommit & & git push github $(git_main_branch):svntrunk |
2021-10-04 16:43:13 +08:00
| gk | gitk --all --branches & ! |
| gke | gitk --all $(git log -g --pretty=%h) & ! |
2020-02-19 04:05:52 +08:00
| gl | git pull |
| glg | git log --stat |
| glgp | git log --stat -p |
| glgg | git log --graph |
| glgga | git log --graph --decorate --all |
| glgm | git log --graph --max-count=10 |
| glo | git log --oneline --decorate |
2021-09-06 17:21:44 +08:00
| glol | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%ar) %C(bold blue)< %an>%Creset' |
| glols | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%ar) %C(bold blue)< %an>%Creset' --stat |
2020-02-19 04:05:52 +08:00
| glod | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%ad) %C(bold blue)< %an>%Creset' |
| glods | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%ad) %C(bold blue)< %an>%Creset' --date=short |
2021-09-06 17:21:44 +08:00
| glola | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%ar) %C(bold blue)< %an>%Creset' --all |
2020-02-19 04:05:52 +08:00
| glog | git log --oneline --decorate --graph |
| gloga | git log --oneline --decorate --graph --all |
2020-07-04 01:03:04 +08:00
| glp | git log --pretty=\<format\> |
2020-02-19 04:05:52 +08:00
| gm | git merge |
2021-08-10 22:31:49 +08:00
| gmom | git merge origin/$(git_main_branch) |
2021-09-06 19:25:35 +08:00
| gmtl | git mergetool --no-prompt |
| gmtlvim | git mergetool --no-prompt --tool=vimdiff |
2021-08-10 22:31:49 +08:00
| gmum | git merge upstream/$(git_main_branch) |
2020-02-19 04:05:52 +08:00
| gma | git merge --abort |
| gp | git push |
| gpd | git push --dry-run |
| gpf | git push --force-with-lease |
| gpf! | git push --force |
| gpoat | git push origin --all & & git push origin --tags |
2021-06-12 21:06:09 +08:00
| gpr | git pull --rebase |
2020-02-19 04:05:52 +08:00
| gpu | git push upstream |
| gpv | git push -v |
| gr | git remote |
| gra | git remote add |
| grb | git rebase |
| grba | git rebase --abort |
| grbc | git rebase --continue |
2021-08-10 22:31:49 +08:00
| grbd | git rebase $(git_develop_branch) |
2020-02-19 04:05:52 +08:00
| grbi | git rebase -i |
2021-08-10 22:31:49 +08:00
| grbm | git rebase $(git_main_branch) |
| grbo | git rebase --onto |
2020-02-19 04:05:52 +08:00
| grbs | git rebase --skip |
| grev | git revert |
| grh | git reset |
| grhh | git reset --hard |
| groh | git reset origin/$(git_current_branch) --hard |
| grm | git rm |
| grmc | git rm --cached |
| grmv | git remote rename |
| grrm | git remote remove |
| grs | git restore |
| grset | git remote set-url |
| grss | git restore --source |
2020-05-15 17:01:18 +08:00
| grst | git restore --staged |
2020-02-19 04:05:52 +08:00
| grt | cd "$(git rev-parse --show-toplevel \|\| echo .)" |
| gru | git reset -- |
| grup | git remote update |
| grv | git remote -v |
| gsb | git status -sb |
| gsd | git svn dcommit |
| gsh | git show |
| gsi | git submodule init |
| gsps | git show --pretty=short --show-signature |
| gsr | git svn rebase |
| gss | git status -s |
| gst | git status |
| gsta | git stash push |
| gsta | git stash save |
| gstaa | git stash apply |
| gstc | git stash clear |
| gstd | git stash drop |
| gstl | git stash list |
| gstp | git stash pop |
| gsts | git stash show --text |
| gstu | git stash --include-untracked |
| gstall | git stash --all |
| gsu | git submodule update |
| gsw | git switch |
| gswc | git switch -c |
| gts | git tag -s |
| gtv | git tag \| sort -V |
| gtl | gtl(){ git tag --sort=-v:refname -n -l ${1}* }; noglob gtl |
| gunignore | git update-index --no-assume-unchanged |
| gunwip | git log -n 1 \| grep -q -c "\-\-wip\-\-" && git reset HEAD~1 |
| gup | git pull --rebase |
| gupv | git pull --rebase -v |
| gupa | git pull --rebase --autostash |
| gupav | git pull --rebase --autostash -v |
2021-08-10 22:31:49 +08:00
| glum | git pull upstream $(git_main_branch) |
2020-02-19 04:05:52 +08:00
| gwch | git whatchanged -p --abbrev-commit --pretty=medium |
| gwip | git add -A; git rm $(git ls-files --deleted) 2> /dev/null; git commit --no-verify --no-gpg-sign -m "--wip-- [skip ci]" |
2020-05-22 22:56:03 +08:00
| gam | git am |
| gamc | git am --continue |
| gams | git am --skip |
| gama | git am --abort |
| gamscp | git am --show-current-patch |
2019-05-21 16:53:11 +08:00
2020-07-04 01:03:04 +08:00
### Main branch preference
Following the recent push for removing racially-charged words from our technical vocabulary, the git plugin favors using
a branch name other than `master` . In this case, we favor the shorter, neutral and descriptive term `main` . This means
2020-07-15 23:02:49 +08:00
that any aliases and functions that previously used `master` , will use `main` if that branch exists. We do this via the
function `git_main_branch` .
2020-07-04 01:03:04 +08:00
2020-03-12 02:57:46 +08:00
### Deprecated aliases
2019-05-21 16:53:11 +08:00
These are aliases that have been removed, renamed, or otherwise modified in a way that may, or may not, receive further support.
2020-02-19 04:05:52 +08:00
| Alias | Command | Modification |
| :----- | :----------------------------------------------------- | :----------------------------------------------------- |
| gap | `git add --patch` | new alias `gapa` |
| gcl | `git config --list` | new alias `gcf` |
| gdc | `git diff --cached` | new alias `gdca` |
| gdt | `git difftool` | no replacement |
| ggpull | `git pull origin $(current_branch)` | new alias `ggl` (`ggpull` still exists for now though) |
| ggpur | `git pull --rebase origin $(current_branch)` | new alias `ggu` (`ggpur` still exists for now though) |
| ggpush | `git push origin $(current_branch)` | new alias `ggp` (`ggpush` still exists for now though) |
| gk | `gitk --all --branches` | now aliased to `gitk --all --branches` |
| glg | `git log --stat --max-count = 10` | now aliased to `git log --stat --color` |
| glgg | `git log --graph --max-count = 10` | now aliased to `git log --graph --color` |
| gwc | `git whatchanged -p --abbrev-commit --pretty = medium` | new alias `gwch` |
2019-05-21 16:53:11 +08:00
## Functions
### Current
2021-08-10 22:31:49 +08:00
| Command | Description |
|:-----------------------|:---------------------------------------------------------------------------------------------------------|
| `grename <old> <new>` | Rename `old` branch to `new` , including in origin remote |
| current_branch | Return the name of the current branch |
| git_current_user_name | Returns the `user.name` config value |
| git_current_user_email | Returns the `user.email` config value |
| git_main_branch | Returns the name of the main branch: `main` if it exists, `master` otherwise |
| git_develop_branch | Returns the name of the develop branch: `dev` , `devel` , `development` if they exist, `develop` otherwise |
2019-05-21 16:53:11 +08:00
### Work in Progress (WIP)
These features allow to pause a branch development and switch to another one (_"Work in Progress"_, or wip). When you want to go back to work, just unwip it.
| Command | Description |
|:-----------------|:------------------------------------------------|
| work_in_progress | Echoes a warning if the current branch is a wip |
| gwip | Commit wip branch |
| gunwip | Uncommit wip branch |
2019-05-21 16:57:37 +08:00
2020-03-12 02:57:46 +08:00
### Deprecated functions
2019-05-21 16:57:37 +08:00
| Command | Description | Reason |
|:-----------------------|:----------------------------------------|:----------------------------------------------------------------|
| current_repository | Return the names of the current remotes | Didn't work properly. Use `git remote -v` instead (`grv` alias) |
