如何将/usr/share/bash-completion/completions
内部已经存在的完成功能重新用于自己的自定义功能,而不必编写另一个功能来构建可能的完成列表?
如果问题不清楚,请举以下示例:
•我在.bashrc
上创建了一个函数:
function gitdelbranch {
git branch --delete ${1} && git push origin --delete ${1}
}
•我已经在. /usr/share/bash-completion/bash_completion
.bashrc
•现在,我希望能够使用与gitdelbranch
相同的选项来自动完成git branch -d
函数。
•内向 /usr/share/bash-completion/completions/git:599
,我可以看到已经有一个完成本地分支的函数,称为__git_heads()
:
[...]
# Lists branches from the local repository.
# 1: A prefix to be added to each listed branch (optional).
# 2: List only branches matching this word (optional; list all branches if
# unset or empty).
# 3: A suffix to be appended to each listed branch (optional).
__git_heads ()
[...]
此外,这是我在研究此技巧时学到的另一个技巧:如果我在shell
git branch -d
上键入,按<Tab>
,然后运行complete -p git
,则可以看到完整的完整命令用于(您必须先运行一次,然后才能起作用):
complete -o bashdefault -o default -o nospace -F __git_wrap__git_main git
但是,无论我尝试什么,我都无法使用单个命令(例如complete -o [...] -F __[...] gitdelbranch
)自动完成自定义功能。
问题是:为什么?有什么解决办法,还是我真的必须编写一个新的自定义完成功能,构建选项列表和COMMREPLY,只是为了获得我想要的行为?在我看来,这必须是可能的,鉴于我的系统上已经有写得很好的完成文件。
一个额外的问题:为什么甚至不 complete -o bashdefault -o default -o nospace -F __git_wrap__git_main gitdelbranch
正常工作,因为它已在shell中使用并且可以与git branch -d
正常工作? / em>
答案 0 :(得分:1)
Git完成实际上很容易添加到您自己的bash函数中,例如,此小脚本会自动完成git分支:
my_func () { return; }
source /usr/share/bash-completion/completions/git
__git_complete my_func __git_complete_refs
现在my_func
可以自动完成分支名称。
或者像这样,您可以将g
设为git
并具有自动完成功能:
source /usr/share/bash-completion/completions/git
alias g=git
__git_complete g __git_main
在/usr/share/bash-completion/completions/git
文件中查找所有可能的完成。源代码中的原始文件:https://github.com/git/git/blob/master/contrib/completion/git-completion.bash
有一堆默认的完整函数,但是它们不一定总能满足您的要求,因为它们是专门为git命令而设计的。在某些情况下,您可能需要进行自定义自动完成功能。查看git-completion.bash
的源代码,您可以找出问题所在。例如,此自动完成功能仅完成本地分支名称:
source /usr/share/bash-completion/completions/git
git_local_branches () {
__gitcomp_direct "$(__git_heads "" "$cur" " ")"
}
my_func () { return; }
__git_complete my_func git_local_branches
另请参见this answer for有关常规bash完成如何工作的更多信息。通常,您会使用complete
命令,但是Git创建了自己的完整函数__git_complete
,您应该使用该函数来完成git。