Bash:如何通过使用现有的bash补全功能来简化自定义创建函数的自动补全?

时间:2019-03-22 01:34:35

标签: bash autocomplete

如何将/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>

1 个答案:

答案 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。