svn
のようなプログラムを使用して、Gnomeターミナルに入力すると:
svn upd
ヒット Tab 自動補完されます:
svn update
私のカスタムbashスクリプトでそのようなことをすることは可能ですか?
Programmable Completion を使用できます。いくつかの例については、/etc/bash_completion
と/etc/bash_completion.d/*
をご覧ください。
私は6ヶ月遅れていますが、同じことを探していて、これを見つけました:
新しいファイルを作成する必要があります。
/etc/bash_completion.d/foo
静的オートコンプリート(--help
/--verbose
など)の場合、これを追加します:
_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
は、現在のコマンドラインの個々の単語をすべて含む配列です。COMP_CWORD
は、現在のカーソル位置を含むWordのインデックスです。COMPREPLY
は、Bashが可能な補完を読み取る配列変数です。compgen
コマンドは、現在のWord --help
に一致する--verbose
、--version
、および"${cur}"
から要素の配列を返します。
compgen -W "--help --verbose --version" -- "<userinput>"
すべてのbash補完は/etc/bash_completion.d/
に保存されます。したがって、bash_completionを使用してソフトウェアを構築している場合、deb/make installにそのディレクトリ内のソフトウェアの名前のファイルをドロップさせることは価値があります。 Rsyncのbash完了スクリプトの例を次に示します。
# 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完了ファイルの1つを確認する価値があります。最も単純な例の1つは、rrdtool
ファイルです。
これが完全なチュートリアルです。
オートコンプリートを機能させたいadmin.shというスクリプトの例を見てみましょう。
#!/bin/bash
while [ $# -gt 0 ]; do
arg=$1
case $arg in
option_1)
# do_option_1
;;
option_2)
# do_option_1
;;
shortlist)
echo option_1 option_2 shortlist
;;
*)
echo Wrong option
;;
esac
shift
done
オプションの候補リストに注意してください。このオプションを使用してスクリプトを呼び出すと、このスクリプトで使用可能なすべてのオプションが出力されます。
そして、ここにオートコンプリートスクリプトがあります:
_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にコピーします
必要なのが単純なWordベースのオートコンプリートだけである場合(サブコマンドの完了などはありません)、complete
コマンドには正しいことを行う-W
オプションがあります。
たとえば、 jupyter というプログラムを自動補完するために、.bashrc
に次の行があります。
# gleaned from `jupyter --help`
_jupyter_options='console qtconsole notebook' # shortened for this answer
complete -W "${_jupyter_options}" 'jupyter'
jupyter <TAB> <TAB>
が自動補完されます。
Gnu.orgの docs が役立ちます。
IFS
変数が正しく設定されていることに依存しているように見えますが、それは問題を引き起こしていません。
ファイル名補完とデフォルトのBASH補完を追加するには、-o
オプションを使用します。
complete -W "${_jupyter_options}" -o bashdefault -o default 'jupyter'
これをzshで使用するには、~/.zshrc
でcomplete
コマンドを実行する前に次のコードを追加します。
# make zsh emulate bash if necessary
if [[ -n "$ZSH_VERSION" ]]; then
autoload bashcompinit
bashcompinit
fi