Когда я использую такую программу, как svn
, и я печатаю в Gnome Terminal:
svn upd
и нажимаю Tab kbd>, она автоматически завершается до:
svn update
Можно ли сделать что-то подобное в моем собственном скрипте bash?
Вы можете использовать Программируемое завершение . Посмотрите на /etc/bash_completion
и /etc/bash_completion.d/*
для некоторых примеров.
Jums būs jāizveido jauns fails:
/etc/bash_completion.d/foo
Statiskai automātiskai pabeigšanai ( - palīdzība
/ - piemēram, daudzskaitlīgs
) pievienot šo:
_foo()
{
local cur prev opts
COMPREPLY=()
cur="${COMP_WORDS[COMP_CWORD]}"
prev="${COMP_WORDS[COMP_CWORD-1]}"
opts="--help --verbose --version"
if [[ ${cur} == -* ]] ; then
COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
return 0
fi
}
complete -F _foo foo
COMP_WORDS
ir masīvs, kas satur visus atsevišķos vārdus pašreizējā komandrindā. COMP_CWORD
ir vārda indekss, kas satur pašreizējo kursora pozīciju. COMPREPLY
ir masīva mainīgais, no kura Bašs nolasa iespējamos papildinājumus. Un compgen
komanda atgriež elementu masīvu no - help
, - verbose
un - versija
, kas atbilst pašreizējam vārdam "$ {cur}"
:
compgen -W "--help --verbose --version" -- "<userinput>"
Все завершения bash хранятся в /etc/bash_completion.d/
. Поэтому, если вы создаете программное обеспечение с помощью bash_completion, было бы целесообразно, чтобы команда deb / make install удаляла файл с именем программного обеспечения в этом каталоге. Вот пример сценария завершения bash для Rsync:
# bash completion for rsync
have rsync &&
_rsync()
{
# TODO: _split_longopt
local cur prev shell i userhost path
COMPREPLY=()
cur=`_get_cword`
prev=${COMP_WORDS[COMP_CWORD-1]}
_expand || return 0
case "$prev" in
--@(config|password-file|include-from|exclude-from))
_filedir
return 0
;;
-@(T|-temp-dir|-compare-dest))
_filedir -d
return 0
;;
-@(e|-rsh))
COMPREPLY=( $( compgen -W 'rsh ssh' -- "$cur" ) )
return 0
;;
esac
case "$cur" in
-*)
COMPREPLY=( $( compgen -W '-v -q -c -a -r -R -b -u -l -L -H \
-p -o -g -D -t -S -n -W -x -B -e -C -I -T -P \
-z -h -4 -6 --verbose --quiet --checksum \
--archive --recursive --relative --backup \
--backup-dir --suffix= --update --links \
--copy-links --copy-unsafe-links --safe-links \
--hard-links --perms --owner --group --devices\
--times --sparse --dry-run --whole-file \
--no-whole-file --one-file-system \
--block-size= --rsh= --rsync-path= \
--cvs-exclude --existing --ignore-existing \
--delete --delete-excluded --delete-after \
--ignore-errors --max-delete= --partial \
--force --numeric-ids --timeout= \
--ignore-times --size-only --modify-window= \
--temp-dir= --compare-dest= --compress \
--exclude= --exclude-from= --include= \
--include-from= --version --daemon --no-detach\
--address= --config= --port= --blocking-io \
--no-blocking-io --stats --progress \
--log-format= --password-file= --bwlimit= \
--write-batch= --read-batch= --help' -- "$cur" ))
;;
*:*)
# find which remote shell is used
shell=ssh
for (( i=1; i < COMP_CWORD; i++ )); do
if [[ "${COMP_WORDS[i]}" == -@(e|-rsh) ]]; then
shell=${COMP_WORDS[i+1]}
break
fi
done
if [[ "$shell" == ssh ]]; then
# remove backslash escape from :
cur=${cur/\\:/:}
userhost=${cur%%?(\\):*}
path=${cur#*:}
# unescape spaces
path=${path//\\\\\\\\ / }
if [ -z "$path" ]; then
# default to home dir of specified
# user on remote host
path=$(ssh -o 'Batchmode yes' $userhost pwd 2>/dev/null)
fi
# escape spaces; remove executables, aliases, pipes
# and sockets; add space at end of file names
COMPREPLY=( $( ssh -o 'Batchmode yes' $userhost \
command ls -aF1d "$path*" 2>/dev/null | \
sed -e 's/ /\\\\\\\ /g' -e 's/[*@|=]$//g' \
-e 's/[^\/]$/& /g' ) )
fi
;;
*)
_known_hosts_real -c -a "$cur"
_filedir
;;
esac
return 0
} &&
complete -F _rsync $nospace $filenames rsync
# Local variables:
# mode: shell-script
# sh-basic-offset: 4
# sh-indent-comment: t
# indent-tabs-mode: nil
# End:
# ex: ts=4 sw=4 et filetype=sh
Вероятно, стоит просмотреть один из содержащихся в нем файлов завершения bash, который наиболее точно соответствует вашей программе. Один из простейших примеров - файл rrdtool
.
Вот полное руководство.
Давайте есть пример сценария с именем admin.sh
, для которого вы хотите, чтобы работала функция автозаполнения.
#!/bin/bash
while [ $# -gt 0 ]; do
arg=$1
case $arg in
option_1)
# do_option_1
;;
option_2)
# do_option_2
;;
shortlist)
echo option_1 option_2 shortlist
;;
*)
echo Wrong option
;;
esac
shift
done
Обратите внимание на параметр shortlist
. Вызов сценария с этой опцией распечатает все возможные варианты для этого сценария.
И здесь у вас есть сценарий автозаполнения:
_script()
{
_script_commands=$(/path/to/your/script.sh shortlist)
local cur
COMPREPLY=()
cur="${COMP_WORDS[COMP_CWORD]}"
COMPREPLY=( $(compgen -W "${_script_commands}" -- ${cur}) )
return 0
}
complete -o nospace -F _script ./admin.sh
Обратите внимание, что последний аргумент для завершения - это имя сценария, в который вы хотите добавить автозаполнение. Все, что вам нужно сделать, это добавить свой скрипт автозаполнения в bashrc как
source /path/to/your/autocomplete.sh
или скопировать его в /etc/bash.completion.d
Если вам нужно простое автозаполнение на основе слов ( так что нет завершения подкоманды или чего-то еще), команда complete
имеет параметр -W
, который просто делает правильные вещи.
Например, у меня есть следующие строки в моем ] .bashrc
для автозаполнения программы с именем jupyter :
# gleaned from `jupyter --help`
_jupyter_options='console qtconsole notebook' # shortened for this answer
complete -W "${_jupyter_options}" 'jupyter'
Теперь jupyter
автозаполнение для меня.
Кажется, это полагается на правильную установку переменной IFS
, но это не вызвало у меня никаких проблем.
Чтобы добавить завершение имени файла и значение по умолчанию Завершение BASH, используйте параметр -o
:
complete -W "${_jupyter_options}" -o bashdefault -o default 'jupyter'
Чтобы использовать это в zsh, добавьте следующий код перед запуском команды complete
в вашем ~ / .zshrc
:
# make zsh emulate bash if necessary
if [[ -n "$ZSH_VERSION" ]]; then
autoload bashcompinit
bashcompinit
fi
Просто добавляю сюда на случай, если это кому-то поможет.
Помимо примеров, исчерпывающий источник / ссылку для получения дополнительной информации по этой теме - это само руководство по bash (например, введите man bash
в терминале).
Найдите заголовки «Завершение» и «Программируемое завершение». ". (в текущей версии документации bash они появляются вокруг строк 2219 и 2332 соответственно), а также соответствующих встроенных ключевых слов bash, упомянутых в этих разделах (например, compgen (строка 2627), complete (строка 2637) и т. д.)