summaryrefslogtreecommitdiff
path: root/plugins/git-extras/git-extras.plugin.zsh
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/git-extras/git-extras.plugin.zsh')
-rw-r--r--plugins/git-extras/git-extras.plugin.zsh421
1 files changed, 317 insertions, 104 deletions
diff --git a/plugins/git-extras/git-extras.plugin.zsh b/plugins/git-extras/git-extras.plugin.zsh
index 8419166ab..b86d7c5b6 100644
--- a/plugins/git-extras/git-extras.plugin.zsh
+++ b/plugins/git-extras/git-extras.plugin.zsh
@@ -1,45 +1,70 @@
-#compdef git
# ------------------------------------------------------------------------------
# Description
# -----------
#
-# Completion script for git-extras (http://github.com/visionmedia/git-extras).
+# Completion script for git-extras (https://github.com/tj/git-extras).
+#
+# This depends on and reuses some of the internals of the _git completion
+# function that ships with zsh itself. It will not work with the _git that ships
+# with git.
#
# ------------------------------------------------------------------------------
# Authors
# -------
#
# * Alexis GRIMALDI (https://github.com/agrimaldi)
+# * spacewander (https://github.com/spacewander)
#
# ------------------------------------------------------------------------------
# Inspirations
# -----------
#
-# * git-extras (http://github.com/visionmedia/git-extras)
-# * git-flow-completion (http://github.com/bobthecow/git-flow-completion)
+# * git-extras (https://github.com/tj/git-extras)
+# * git-flow-completion (https://github.com/bobthecow/git-flow-completion)
#
# ------------------------------------------------------------------------------
-__git_command_successful () {
- if (( ${#pipestatus:#0} > 0 )); then
- _message 'not a git repository'
- return 1
- fi
- return 0
+# Internal functions
+# These are a lot like their __git_* equivalents inside _git
+
+__gitex_command_successful () {
+ if (( ${#*:#0} > 0 )); then
+ _message 'not a git repository'
+ return 1
+ fi
+ return 0
}
+__gitex_commits() {
+ declare -A commits
+ git log --oneline -15 | sed 's/\([[:alnum:]]\{7\}\) /\1:/' | while read commit
+ do
+ hash=$(echo $commit | cut -d':' -f1)
+ commits[$hash]="$commit"
+ done
+ local ret=1
+ _describe -t commits commit commits && ret=0
+}
-__git_tag_names() {
+__gitex_remote_names() {
+ local expl
+ declare -a remote_names
+ remote_names=(${(f)"$(_call_program remotes git remote 2>/dev/null)"})
+ __git_command_successful || return
+ _wanted remote-names expl remote-name compadd $* - $remote_names
+}
+
+__gitex_tag_names() {
local expl
declare -a tag_names
- tag_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/tags 2>/dev/null)"}#refs/tags/})
+ tag_names=(${${(f)"$(_call_program tags git for-each-ref --format='"%(refname)"' refs/tags 2>/dev/null)"}#refs/tags/})
__git_command_successful || return
_wanted tag-names expl tag-name compadd $* - $tag_names
}
-__git_branch_names() {
+__gitex_branch_names() {
local expl
declare -a branch_names
branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads 2>/dev/null)"}#refs/heads/})
@@ -47,44 +72,40 @@ __git_branch_names() {
_wanted branch-names expl branch-name compadd $* - $branch_names
}
-
-__git_feature_branch_names() {
+__gitex_specific_branch_names() {
local expl
declare -a branch_names
- branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads/feature 2>/dev/null)"}#refs/heads/feature/})
+ branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads/"$1" 2>/dev/null)"}#refs/heads/$1/})
__git_command_successful || return
- _wanted branch-names expl branch-name compadd $* - $branch_names
+ _wanted branch-names expl branch-name compadd - $branch_names
}
-
-__git_refactor_branch_names() {
- local expl
- declare -a branch_names
- branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads/refactor 2>/dev/null)"}#refs/heads/refactor/})
- __git_command_successful || return
- _wanted branch-names expl branch-name compadd $* - $branch_names
+__gitex_chore_branch_names() {
+ __gitex_specific_branch_names 'chore'
}
+__gitex_feature_branch_names() {
+ __gitex_specific_branch_names 'feature'
+}
-__git_bug_branch_names() {
- local expl
- declare -a branch_names
- branch_names=(${${(f)"$(_call_program branchrefs git for-each-ref --format='"%(refname)"' refs/heads/bug 2>/dev/null)"}#refs/heads/bug/})
- __git_command_successful || return
- _wanted branch-names expl branch-name compadd $* - $branch_names
+__gitex_refactor_branch_names() {
+ __gitex_specific_branch_names 'refactor'
}
+__gitex_bug_branch_names() {
+ __gitex_specific_branch_names 'bug'
+}
-__git_submodule_names() {
+__gitex_submodule_names() {
local expl
declare -a submodule_names
- submodule_names=(${(f)"$(_call_program branchrefs git submodule status | awk '{print $2}')"})
+ submodule_names=(${(f)"$(_call_program branchrefs git submodule status | awk '{print $2}')"}) # '
__git_command_successful || return
_wanted submodule-names expl submodule-name compadd $* - $submodule_names
}
-__git_author_names() {
+__gitex_author_names() {
local expl
declare -a author_names
author_names=(${(f)"$(_call_program branchrefs git log --format='%aN' | sort -u)"})
@@ -92,22 +113,93 @@ __git_author_names() {
_wanted author-names expl author-name compadd $* - $author_names
}
+# subcommands
+_git-authors() {
+ _arguments -C \
+ '(--list -l)'{--list,-l}'[show authors]' \
+ '--no-email[without email]' \
+}
+
+_git-bug() {
+ local curcontext=$curcontext state line ret=1
+ declare -A opt_args
+
+ _arguments -C \
+ ': :->command' \
+ '*:: :->option-or-argument' && ret=0
+
+ case $state in
+ (command)
+ declare -a commands
+ commands=(
+ 'finish:merge bug into the current branch'
+ )
+ _describe -t commands command commands && ret=0
+ ;;
+ (option-or-argument)
+ curcontext=${curcontext%:*}-$line[1]:
+ case $line[1] in
+ (finish)
+ _arguments -C \
+ ':branch-name:__gitex_bug_branch_names'
+ ;;
+ -r|--remote )
+ _arguments -C \
+ ':remote-name:__gitex_remote_names'
+ ;;
+ esac
+ return 0
+ esac
+
+ _arguments \
+ '(--remote -r)'{--remote,-r}'[setup remote tracking branch]'
+}
+
_git-changelog() {
_arguments \
'(-l --list)'{-l,--list}'[list commits]' \
}
+_git-chore() {
+ local curcontext=$curcontext state line ret=1
+ declare -A opt_args
+
+ _arguments -C \
+ ': :->command' \
+ '*:: :->option-or-argument' && ret=0
+
+ case $state in
+ (command)
+ declare -a commands
+ commands=(
+ 'finish:merge and delete the chore branch'
+ )
+ _describe -t commands command commands && ret=0
+ ;;
+ (option-or-argument)
+ curcontext=${curcontext%:*}-$line[1]:
+ case $line[1] in
+ (finish)
+ _arguments -C \
+ ':branch-name:__gitex_chore_branch_names'
+ ;;
+ -r|--remote )
+ _arguments -C \
+ ':remote-name:__gitex_remote_names'
+ ;;
+ esac
+ return 0
+ esac
-_git-effort() {
_arguments \
- '--above[ignore file with less than x commits]' \
+ '(--remote -r)'{--remote,-r}'[setup remote tracking branch]'
}
_git-contrib() {
_arguments \
- ':author:__git_author_names'
+ ':author:__gitex_author_names'
}
@@ -116,22 +208,49 @@ _git-count() {
'--all[detailed commit count]'
}
+_git-create-branch() {
+ local curcontext=$curcontext state line
+ _arguments -C \
+ ': :->command' \
+ '*:: :->option-or-argument'
+
+ case "$state" in
+ (command)
+ _arguments \
+ '(--remote -r)'{--remote,-r}'[setup remote tracking branch]'
+ ;;
+ (option-or-argument)
+ curcontext=${curcontext%:*}-$line[1]:
+ case $line[1] in
+ -r|--remote )
+ _arguments -C \
+ ':remote-name:__gitex_remote_names'
+ ;;
+ esac
+ esac
+}
_git-delete-branch() {
_arguments \
- ':branch-name:__git_branch_names'
+ ':branch-name:__gitex_branch_names'
}
_git-delete-submodule() {
_arguments \
- ':submodule-name:__git_submodule_names'
+ ':submodule-name:__gitex_submodule_names'
}
_git-delete-tag() {
_arguments \
- ':tag-name:__git_tag_names'
+ ':tag-name:__gitex_tag_names'
+}
+
+
+_git-effort() {
+ _arguments \
+ '--above[ignore file with less than x commits]'
}
@@ -154,20 +273,7 @@ _git-extras() {
esac
_arguments \
- '(-v --version)'{-v,--version}'[show current version]' \
-}
-
-
-_git-graft() {
- _arguments \
- ':src-branch-name:__git_branch_names' \
- ':dest-branch-name:__git_branch_names'
-}
-
-
-_git-squash() {
- _arguments \
- ':branch-name:__git_branch_names'
+ '(-v --version)'{-v,--version}'[show current version]'
}
@@ -192,10 +298,63 @@ _git-feature() {
case $line[1] in
(finish)
_arguments -C \
- ':branch-name:__git_feature_branch_names'
+ ':branch-name:__gitex_feature_branch_names'
+ ;;
+ -r|--remote )
+ _arguments -C \
+ ':remote-name:__gitex_remote_names'
;;
esac
+ return 0
esac
+
+ _arguments \
+ '(--remote -r)'{--remote,-r}'[setup remote tracking branch]'
+}
+
+_git-graft() {
+ _arguments \
+ ':src-branch-name:__gitex_branch_names' \
+ ':dest-branch-name:__gitex_branch_names'
+}
+
+_git-guilt() {
+ _arguments -C \
+ '(--email -e)'{--email,-e}'[display author emails instead of names]' \
+ '(--ignore-whitespace -w)'{--ignore-whitespace,-w}'[ignore whitespace only changes]' \
+ '(--debug -d)'{--debug,-d}'[output debug information]' \
+ '-h[output usage information]'
+}
+
+_git-ignore() {
+ _arguments -C \
+ '(--local -l)'{--local,-l}'[show local gitignore]' \
+ '(--global -g)'{--global,-g}'[show global gitignore]' \
+ '(--private -p)'{--private,-p}'[show repo gitignore]'
+}
+
+
+_git-ignore() {
+ _arguments -C \
+ '(--append -a)'{--append,-a}'[append .gitignore]' \
+ '(--replace -r)'{--replace,-r}'[replace .gitignore]' \
+ '(--list-in-table -l)'{--list-in-table,-l}'[print available types in table format]' \
+ '(--list-alphabetically -L)'{--list-alphabetically,-L}'[print available types in alphabetical order]' \
+ '(--search -s)'{--search,-s}'[search word in available types]'
+}
+
+
+_git-merge-into() {
+ _arguments '--ff-only[merge only fast-forward]'
+ _arguments \
+ ':src:__gitex_branch_names' \
+ ':dest:__gitex_branch_names'
+}
+
+_git-missing() {
+ _arguments \
+ ':first-branch-name:__gitex_branch_names' \
+ ':second-branch-name:__gitex_branch_names'
}
@@ -220,66 +379,120 @@ _git-refactor() {
case $line[1] in
(finish)
_arguments -C \
- ':branch-name:__git_refactor_branch_names'
+ ':branch-name:__gitex_refactor_branch_names'
+ ;;
+ -r|--remote )
+ _arguments -C \
+ ':remote-name:__gitex_remote_names'
;;
esac
+ return 0
esac
+
+ _arguments \
+ '(--remote -r)'{--remote,-r}'[setup remote tracking branch]'
}
-_git-bug() {
- local curcontext=$curcontext state line ret=1
- declare -A opt_args
+_git-squash() {
+ _arguments \
+ ':branch-name:__gitex_branch_names'
+}
+
+_git-stamp() {
+ _arguments -C \
+ '(--replace -r)'{--replace,-r}'[replace stamps with same id]'
+}
+_git-standup() {
_arguments -C \
- ': :->command' \
- '*:: :->option-or-argument' && ret=0
+ '-a[Specify the author of commits. Use "all" to specify all authors.]' \
+ '-d[Show history since N days ago]' \
+ '-D[Specify the date format displayed in commit history]' \
+ '-f[Fetch commits before showing history]' \
+ '-g[Display GPG signed info]' \
+ '-h[Display help message]' \
+ '-L[Enable the inclusion of symbolic links]' \
+ '-m[The depth of recursive directory search]'
+}
- case $state in
- (command)
- declare -a commands
- commands=(
- 'finish:merge bug into the current branch'
- )
- _describe -t commands command commands && ret=0
- ;;
- (option-or-argument)
- curcontext=${curcontext%:*}-$line[1]:
- case $line[1] in
- (finish)
- _arguments -C \
- ':branch-name:__git_bug_branch_names'
- ;;
- esac
- esac
+_git-summary() {
+ _arguments '--line[summarize with lines rather than commits]'
+ __gitex_commits
+}
+
+
+_git-undo(){
+ _arguments -C \
+ '(--soft -s)'{--soft,-s}'[only rolls back the commit but changes remain un-staged]' \
+ '(--hard -h)'{--hard,-h}'[wipes your commit(s)]'
}
+zstyle -g existing_user_commands ':completion:*:*:git:*' user-commands
-zstyle ':completion:*:*:git:*' user-commands \
- changelog:'populate changelog file with commits since the previous tag' \
- contrib:'display author contributions' \
- count:'count commits' \
- delete-branch:'delete local and remote branch' \
- delete-submodule:'delete submodule' \
- delete-tag:'delete local and remote tag' \
- extras:'git-extras' \
- graft:'merge commits from source branch to destination branch' \
- squash:'merge commits from source branch into the current one as a single commit' \
- feature:'create a feature branch' \
- refactor:'create a refactor branch' \
- bug:'create a bug branch' \
- summary:'repository summary' \
- effort:'display effort statistics' \
- repl:'read-eval-print-loop' \
- commits-since:'list commits since a given date' \
- release:'release commit with the given tag' \
+zstyle ':completion:*:*:git:*' user-commands $existing_user_commands \
alias:'define, search and show aliases' \
- ignore:'add patterns to .gitignore' \
- info:'show info about the repository' \
- create-branch:'create local and remote branch' \
- fresh-branch:'create empty local branch' \
- undo:'remove the latest commit' \
- setup:'setup a git repository' \
- touch:'one step creation of new files' \
- obliterate:'Completely remove a file from the repository, including past commits and tags' \
- local-commits:'list unpushed commits on the local branch' \
+ archive-file:'export the current head of the git repository to an archive' \
+ authors:'generate authors report' \
+ back:'undo and stage latest commits' \
+ bug:'create bug branch' \
+ bulk:'run bulk commands' \
+ changelog:'generate a changelog report' \
+ chore:'create chore branch' \
+ clear-soft:'soft clean up a repository' \
+ clear:'rigorously clean up a repository' \
+ commits-since:'show commit logs since some date' \
+ contrib:'show user contributions' \
+ count:'show commit count' \
+ create-branch:'create branches' \
+ delete-branch:'delete branches' \
+ delete-merged-branches:'delete merged branches' \
+ delete-submodule:'delete submodules' \
+ delete-tag:'delete tags' \
+ delta:'lists changed files' \
+ effort:'show effort statistics on file(s)' \
+ extras:'awesome git utilities' \
+ feature:'create/merge feature branch' \
+ force-clone:'overwrite local repositories with clone' \
+ fork:'fork a repo on GitHub' \
+ fresh-branch:'create fresh branches' \
+ gh-pages:'create the GitHub pages branch' \
+ graft:'merge and destroy a given branch' \
+ guilt:'calculate change between two revisions' \
+ ignore-io:'get sample gitignore file' \
+ ignore:'add .gitignore patterns' \
+ info:'returns information on current repository' \
+ local-commits:'list local commits' \
+ lock:'lock a file excluded from version control' \
+ locked:'ls files that have been locked' \
+ merge-into:'merge one branch into another' \
+ merge-repo:'merge two repo histories' \
+ missing:'show commits missing from another branch' \
+ mr:'checks out a merge request locally' \
+ obliterate:'rewrite past commits to remove some files' \
+ pr:'checks out a pull request locally' \
+ psykorebase:'rebase a branch with a merge commit' \
+ pull-request:'create pull request to GitHub project' \
+ reauthor:'replace the author and/or committer identities in commits and tags' \
+ rebase-patch:'rebases a patch' \
+ refactor:'create refactor branch' \
+ release:'commit, tag and push changes to the repository' \
+ rename-branch:'rename a branch' \
+ rename-tag:'rename a tag' \
+ repl:'git read-eval-print-loop' \
+ reset-file:'reset one file' \
+ root:'show path of root' \
+ scp:'copy files to ssh compatible `git-remote`' \
+ sed:'replace patterns in git-controlled files' \
+ setup:'set up a git repository' \
+ show-merged-branches:'show merged branches' \
+ show-tree:'show branch tree of commit history' \
+ show-unmerged-branches:'show unmerged branches' \
+ squash:'import changes from a branch' \
+ stamp:'stamp the last commit message' \
+ standup:'recall the commit history' \
+ summary:'show repository summary' \
+ sync:'sync local branch with remote branch' \
+ touch:'touch and add file to the index' \
+ undo:'remove latest commits' \
+ unlock:'unlock a file excluded from version control'
generated by cgit v1.2.3-70-g09d2 (git 2.48.1) at 2025-04-09 23:45:28 +0000