自定义脚本的 zsh 补全:URL + 可选参数

自定义脚本的 zsh 补全:URL + 可选参数

我有自定义脚本的 zsh 补全,其中一个参数必须是 URL(即字符串),然后有几个可选参数: --AAA --BBB --CCC:

_arguments -S : \
    '--AAA' \
    '--BBB' \
    '--CCC' \
    '1: :'

然而,补全仅在提供 URL 参数后才起作用,即:

myscript URL --A<TAB>

这将自动完成--AAA

但是当我有:

myscript --A<TAB>

然后它会列出唯一匹配的选项 --AAA,但即使我这样做它也不会自动完成它--AA<TAB>。我必须手动输入。

当我将完成脚本更改为:

_arguments -S : \
    '--AAA' \
    '--BBB' \
    '--CCC'

参数自动完成功能有效,但一旦我提供 URL,就不会完成其他选项。

那么我如何告诉 zsh 完成,我的脚本需要一个 URL(即一个字符串参数 - 我不希望 zsh 在当前位置开始完成文件名),并且可选参数可以在此 URL 之前或之后完成?

注意:我并不是想自动完成 URL。我只是想在这个 URL 字符串之前和之后完成工作。

答案1

使用发布的代码后myscript --ATab,zsh 尝试完成选项或非选项参数编号 1。参数 1 的操作为空,它属于手动的在“(单个不带引号的空格)”下描述(如果操作仅包含零个或多个空格字符,则实际上会触发这种情况):

当需要参数但不可能或不希望为其生成匹配项时,这非常有用。将显示该消息,但不会列出完成情况。

没有要显示的消息:消息输入是单个空格,因此“显示”动作没有视觉效果。但是,显示消息的内部操作(在_message)执行,特别是compstate[insert]被设置为空。这向完成的用户界面发出信号,表明该完成是不明确的,即使事实证明只有一个有效的完成。

解决方法是明确安排 zsh 认为没有完成,而不是让它认为有完成但无法生成。以下任何一项都可以:

_arguments … '1: :()'
_arguments … '1: :{}'
_arguments … '1: : true'

请注意,如果参数是 URL,您可能应该使用_urls.这仍然会导致在键入后仅完成选项-(只要没有 URL 以 a 开头-或者您有一些非常激进的子字符串完成设置)。

相关内容