Bash:如何使用已经可用的 bash 完成函数来简化自定义创建函数的自动完成？

Question

如何重用 /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 ()
[...]

Also, another trick I learned while researching this: if I type on my shell git branch -d, press <Tab>, and then run complete -p git, I can see the whole complete command that was used for that (you really have to run it once before it works):

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 一起工作得很好？

Answer 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。