Como criar um script com o preenchimento automático?

Question

Quando eu uso programa como svn e eu digito no Terminal do Gnome:

svn upd

e clique em Tab e é autocompleted para:

svn update

É possível fazer algo assim no meu script personalizado?

    

Answer 1

Você pode usar a Conclusão programável . Consulte os /etc/bash_completion e /etc/bash_completion.d/* para alguns exemplos.

    

Answer 2

Estou seis meses atrasado, mas estava procurando a mesma coisa e achei isso:

Você terá que criar um novo arquivo:

/etc/bash_completion.d/foo

Para um autocompletar estático ( --help / --verbose , por exemplo), adicione isto:

_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 é uma matriz contendo todas as palavras individuais na linha de comando atual.
• COMP_CWORD é um índice da palavra que contém a posição atual do cursor.
• COMPREPLY é uma variável de matriz a partir da qual o Bash lê as possíveis conclusões.

E o comando compgen retorna a matriz de elementos de --help , --verbose e --version correspondendo à palavra atual "${cur}" :

compgen -W "--help --verbose --version" -- "<userinput>"

Fonte: link

    

Answer 3

Todas as conclusões do bash são armazenadas em /etc/bash_completion.d/ . Então, se você está construindo software com bash_completion, valeria a pena fazer com que o deb / make install descartasse um arquivo com o nome do software naquele diretório. Aqui está um exemplo de script de conclusão do bash para o 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

Provavelmente vale a pena revisar um dos arquivos de conclusão do bash que melhor corresponde ao seu programa. Um dos exemplos mais simples é o arquivo rrdtool .

    

Answer 4

Aqui está um tutorial completo.

Vamos ter um exemplo de script chamado admin.sh para o qual você gostaria de ter o preenchimento automático em funcionamento.

#!/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

Nota na lista de opções. Chamar script com essa opção imprimirá todas as opções possíveis para este script.

E aqui você tem o script de autocompletar:

_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

Observe que o último argumento a concluir é o nome do script ao qual você deseja adicionar o preenchimento automático. Tudo o que você precisa fazer é adicionar seu script de autocompletar para bashrc como

source /path/to/your/autocomplete.sh

ou copie-o para     /etc/bash.completion.d

    

Answer 5

Se tudo o que você deseja é um preenchimento automático simples baseado em palavras (portanto, nenhuma conclusão de subcomando ou qualquer coisa), o comando complete tem uma opção -W que faz a coisa certa.

Por exemplo, eu tenho as seguintes linhas no meu .bashrc para autocompletar um programa chamado jupyter :

# gleaned from 'jupyter --help'
_jupyter_options='console qtconsole notebook' # shortened for this answer
complete -W "${_jupyter_options}" 'jupyter'

Agora jupyter <TAB> <TAB> autocompletes para mim.

Os documentos em gnu.org são úteis.

Parece que a variável IFS está sendo configurada corretamente, mas isso não causou problemas para mim.

Para adicionar a conclusão do nome do arquivo e a conclusão BASH padrão, use a opção -o :

complete -W "${_jupyter_options}" -o bashdefault -o default 'jupyter'

Para usar isso em zsh, adicione o seguinte código antes de executar o comando complete no seu ~/.zshrc :

# make zsh emulate bash if necessary
if [[ -n "$ZSH_VERSION" ]]; then
    autoload bashcompinit
    bashcompinit
fi