如何为路径上的所有可执行文件编写 bash 完成脚本?
How to write a bash completion script for all executables on path?
我已经为我编写或修改的几个不同的脚本提出了这个用例。本质上,我希望 bash 完成选项 '-x' 以完成 PATH 上的可执行文件。这是两个问题合二为一的问题。
到目前为止我遇到了麻烦,因为 bash 不容易区分别名、内置函数、函数等和 PATH 上的可执行文件。 /usr/share/bash-completion/bash_completion 中的 _commands
包装函数完成了上述所有操作,但我没有使用别名、内置函数、函数等,只想完成恰好是可执行文件的命令路径。
例如...如果我输入 scriptname -x bas[TAB]
,它应该以 base64、bash、basename、bashbug.
完成
这是我的完成脚本现在的样子:
_have pygsparkle && {
_pygsparkle(){
local cur prev
COMPREPLY=()
cur=${COMP_WORDS[COMP_CWORD]}
prev=${COMP_WORDS[COMP_CWORD-1]}
case $prev in
-x|--executable)
# _command
executables=$({ compgen -c; compgen -abkA function; } | sort | uniq -u)
COMPREPLY=( $( compgen -W "$executables" -- "$cur" ) )
return 0
;;
esac
if [[ $cur = -* ]]; then
COMPREPLY=( $( compgen -W '--executable -h --help -x' -- "$cur" ) )
fi
}
complete -F _pygsparkle pygsparkle
}
它似乎按预期工作,但 { compgen -c; compgen -abkA function; } | sort | uniq -u
是一个非常肮脏的 hack。在 zsh 中,您可以在 PATH 运行 print -rl -- ${(ko)commands}
上获得可执行文件的排序列表。所以看来我至少缺少 60 多个 exec,可能是因为 uniq -u
正在转储与别名或函数同名的 exec。
有更好的方法吗?是获取 PATH 上所有可执行文件的更好命令,还是服务于相同目的的预先存在的完成函数?
更新:
好的,下面的函数执行时间不到 1/6 秒,看起来是最佳选择。除非有任何其他建议,否则我可能会关闭这个问题。
_executables(){
while read -d $'[=12=]' path; do
echo "${path##*/}"
done < <(echo -n "$PATH" | xargs -d: -n1 -I% -- find -L '%' -maxdepth 1 -mindepth 1 -type f -executable -print0 2>/dev/null) | sort -u
}
您似乎在寻找 compgen -c
对于如何列出用户 PATH 上所有可用的可执行文件的问题,似乎没有简单的答案。唉,我已经四处寻找答案了。
compgen
乍一看似乎是正确的方向,但它缺少仅显示可执行文件的选项
compgen -c
将显示所有命令(这包括别名、内置命令、可执行文件、函数和关键字)
compgen -abkA function
将显示所有命令 除了 可执行文件
因此,'diffing' 两者可以推测出可用的可执行文件的近似值,即 { compgen -c; compgen -abkA function; } | sort | uniq -u
,但这显然存在一些问题。
注意:要确认 compgen -c
不起作用,您所要做的就是扫描结果并识别出许多不可执行的条目。您也可以尝试 diff -u <(compgen -A function -abck | sort -u) <(compgen -c | sort -u)
并查看这些命令是否等效(当然是在删除重复项后)。
所以看来最好的选择是扫描路径上的每个目录。
总而言之,以下是现代系统上的最佳选择。 它具有与 compgen -c
相当的快速运行时间(~0.05 秒)并且适合完成.
executables(){
echo -n "$PATH" | xargs -d: -I{} -r -- find -L {} -maxdepth 1 -mindepth 1 -type f -executable -printf '%P\n' 2>/dev/null | sort -u
}
如果您使用的是 find/xargs 的旧版本(即 busybox 或 BSD)and/or 使用不支持的 mksh(Android 的默认 shell)过程替换,您将需要以下内容。没那么快(~3.5 秒)。
executables(){
find ${PATH//:/ } -follow -maxdepth 1 -type f -exec test -x '{}' \; -print0 2>/dev/null \
| while read -d $'[=11=]' path; do
echo "${path##*/}"
done \
| sort -u
}
如果您正在使用上述设置并且出于某种原因在您的 PATH 中有空格,那么这应该有效。
executables(){
echo "$PATH" \
| tr ':' '\n' \
| while IFS= read path; do
find "$path" -follow -maxdepth 1 -type f -exec test -x '{}' \; -print0 2>/dev/null
done \
| while read -d $'[=12=]' path; do
echo "${path##*/}"
done \
| sort -u
}
我有一个run-in-background script。为了让它自动完成,我使用 bash 的内置 complete
:
> complete -c <script-name>
> <script-name> ech[TAB]
> <script-name> echo
来自 the docs:
command
Command names. May also be specified as -c.
为了处理 non-executables,我的第一个想法是使用 which
或 type -P
进行过滤,但这非常慢。更好的方法是只检查未知数。使用@Six 的解决方案或其他一些解决方案来查找 compgen -c
中但不在 compgen -abkA function
中的项目。对于两个列表中的所有内容,请检查 type -P
。例如:
function _executables {
local exclude=$(compgen -abkA function | sort)
local executables=$(
comm -23 <(compgen -c) <(echo $exclude)
type -tP $( comm -12 <(compgen -c) <(echo $exclude) )
)
COMPREPLY=( $(compgen -W "$executables" -- ${COMP_WORDS[COMP_CWORD]}) )
}
complete -F _executables <script-name>
我已经尝试了几次,但将 -F
引入 complete
似乎是一种缓慢的做事方式。更不用说现在必须处理 absolute/relative 可执行文件的路径补全,极其繁琐的 complete-the-directory-but-don't-add-a-space 位和正确处理路径中的空格。
我已经为我编写或修改的几个不同的脚本提出了这个用例。本质上,我希望 bash 完成选项 '-x' 以完成 PATH 上的可执行文件。这是两个问题合二为一的问题。
到目前为止我遇到了麻烦,因为 bash 不容易区分别名、内置函数、函数等和 PATH 上的可执行文件。 /usr/share/bash-completion/bash_completion 中的 _commands
包装函数完成了上述所有操作,但我没有使用别名、内置函数、函数等,只想完成恰好是可执行文件的命令路径。
例如...如果我输入 scriptname -x bas[TAB]
,它应该以 base64、bash、basename、bashbug.
这是我的完成脚本现在的样子:
_have pygsparkle && {
_pygsparkle(){
local cur prev
COMPREPLY=()
cur=${COMP_WORDS[COMP_CWORD]}
prev=${COMP_WORDS[COMP_CWORD-1]}
case $prev in
-x|--executable)
# _command
executables=$({ compgen -c; compgen -abkA function; } | sort | uniq -u)
COMPREPLY=( $( compgen -W "$executables" -- "$cur" ) )
return 0
;;
esac
if [[ $cur = -* ]]; then
COMPREPLY=( $( compgen -W '--executable -h --help -x' -- "$cur" ) )
fi
}
complete -F _pygsparkle pygsparkle
}
它似乎按预期工作,但 { compgen -c; compgen -abkA function; } | sort | uniq -u
是一个非常肮脏的 hack。在 zsh 中,您可以在 PATH 运行 print -rl -- ${(ko)commands}
上获得可执行文件的排序列表。所以看来我至少缺少 60 多个 exec,可能是因为 uniq -u
正在转储与别名或函数同名的 exec。
有更好的方法吗?是获取 PATH 上所有可执行文件的更好命令,还是服务于相同目的的预先存在的完成函数?
更新: 好的,下面的函数执行时间不到 1/6 秒,看起来是最佳选择。除非有任何其他建议,否则我可能会关闭这个问题。
_executables(){
while read -d $'[=12=]' path; do
echo "${path##*/}"
done < <(echo -n "$PATH" | xargs -d: -n1 -I% -- find -L '%' -maxdepth 1 -mindepth 1 -type f -executable -print0 2>/dev/null) | sort -u
}
您似乎在寻找 compgen -c
对于如何列出用户 PATH 上所有可用的可执行文件的问题,似乎没有简单的答案。唉,我已经四处寻找答案了。
compgen
乍一看似乎是正确的方向,但它缺少仅显示可执行文件的选项
compgen -c
将显示所有命令(这包括别名、内置命令、可执行文件、函数和关键字)
compgen -abkA function
将显示所有命令 除了 可执行文件
因此,'diffing' 两者可以推测出可用的可执行文件的近似值,即 { compgen -c; compgen -abkA function; } | sort | uniq -u
,但这显然存在一些问题。
注意:要确认 compgen -c
不起作用,您所要做的就是扫描结果并识别出许多不可执行的条目。您也可以尝试 diff -u <(compgen -A function -abck | sort -u) <(compgen -c | sort -u)
并查看这些命令是否等效(当然是在删除重复项后)。
所以看来最好的选择是扫描路径上的每个目录。
总而言之,以下是现代系统上的最佳选择。 它具有与 compgen -c
相当的快速运行时间(~0.05 秒)并且适合完成.
executables(){
echo -n "$PATH" | xargs -d: -I{} -r -- find -L {} -maxdepth 1 -mindepth 1 -type f -executable -printf '%P\n' 2>/dev/null | sort -u
}
如果您使用的是 find/xargs 的旧版本(即 busybox 或 BSD)and/or 使用不支持的 mksh(Android 的默认 shell)过程替换,您将需要以下内容。没那么快(~3.5 秒)。
executables(){
find ${PATH//:/ } -follow -maxdepth 1 -type f -exec test -x '{}' \; -print0 2>/dev/null \
| while read -d $'[=11=]' path; do
echo "${path##*/}"
done \
| sort -u
}
如果您正在使用上述设置并且出于某种原因在您的 PATH 中有空格,那么这应该有效。
executables(){
echo "$PATH" \
| tr ':' '\n' \
| while IFS= read path; do
find "$path" -follow -maxdepth 1 -type f -exec test -x '{}' \; -print0 2>/dev/null
done \
| while read -d $'[=12=]' path; do
echo "${path##*/}"
done \
| sort -u
}
我有一个run-in-background script。为了让它自动完成,我使用 bash 的内置 complete
:
> complete -c <script-name>
> <script-name> ech[TAB]
> <script-name> echo
来自 the docs:
command Command names. May also be specified as -c.
为了处理 non-executables,我的第一个想法是使用 which
或 type -P
进行过滤,但这非常慢。更好的方法是只检查未知数。使用@Six 的解决方案或其他一些解决方案来查找 compgen -c
中但不在 compgen -abkA function
中的项目。对于两个列表中的所有内容,请检查 type -P
。例如:
function _executables {
local exclude=$(compgen -abkA function | sort)
local executables=$(
comm -23 <(compgen -c) <(echo $exclude)
type -tP $( comm -12 <(compgen -c) <(echo $exclude) )
)
COMPREPLY=( $(compgen -W "$executables" -- ${COMP_WORDS[COMP_CWORD]}) )
}
complete -F _executables <script-name>
我已经尝试了几次,但将 -F
引入 complete
似乎是一种缓慢的做事方式。更不用说现在必须处理 absolute/relative 可执行文件的路径补全,极其繁琐的 complete-the-directory-but-don't-add-a-space 位和正确处理路径中的空格。