Also remove unnecesary dramatic remark
30 KiB
git plugin
The git plugin provides many aliases and a few useful functions.
To use it, add git
to the plugins array in your zshrc file:
plugins=(... git)
Aliases
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 |
gapt | git apply --3way |
gb | git branch |
gba | git branch -a |
gbd | git branch -d |
gbda | git branch --no-color --merged | command grep -vE "^(+|*|\s*($(git_main_branch)|development|develop|devel|dev)\s*$)" | command xargs -n 1 git branch -d |
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 |
gcsm | git commit -s -m |
gcb | git checkout -b |
gcf | git config --list |
gcl | git clone --recurse-submodules |
gclean | git clean -id |
gpristine | git reset --hard && git clean -dffx |
gcm | git checkout $(git_main_branch) |
gcd | git checkout develop |
gcmsg | git commit -m |
gco | git checkout |
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 |
gdnolock | git diff $@ ":(exclude)package-lock.json" ":(exclude)*.lock" |
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:" |
git-svn-dcommit-push | git svn dcommit && git push github $(git_main_branch):svntrunk |
gk | gitk --all --branches |
gke | gitk --all $(git log -g --pretty=%h) |
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 |
glol | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' |
glols | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --stat |
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 |
glola | git log --graph --pretty='%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --all |
glog | git log --oneline --decorate --graph |
gloga | git log --oneline --decorate --graph --all |
glp | git log --pretty=<format> |
gm | git merge |
gmom | git merge origin/$(git_main_branch) |
gmt | git mergetool --no-prompt |
gmtvim | git mergetool --no-prompt --tool=vimdiff |
gmum | git merge upstream/$(git_main_branch) |
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 |
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 |
grbd | git rebase develop |
grbi | git rebase -i |
grbm | git rebase $(git_main_branch) |
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 |
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 |
glum | git pull upstream $(git_main_branch) |
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]" |
gam | git am |
gamc | git am --continue |
gams | git am --skip |
gama | git am --abort |
gamscp | git am --show-current-patch |
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
that any aliases and functions that previously used master
, will use main
if master
doesn't exist. We do this via
the function git_main_branch
.
Deprecated aliases
These are aliases that have been removed, renamed, or otherwise modified in a way that may, or may not, receive further support.
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 |
Functions
Current
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: from origin or from local branches, else 'master' |
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 |
Deprecated functions
Command | Description | Reason |
---|---|---|
current_repository | Return the names of the current remotes | Didn't work properly. Use git remote -v instead (grv alias) |