Bash Autocompletion - How to pass this array to compgen without significant whitespace being collapsed?

Question

The following bash completion passes an array of possible words (i.e. completions) to compgen.

basenames=("foo" "fu bar" "baz");

COMPREPLY=($(compgen -W "${basenames[*]}" -- "${COMP_WORDS[COMP_CWORD]}"))

The problem is that the whitespace in the array elements is not preserved, that is "foo bar" is treated as to elements thanks to word splitting. Is there some way to preserve the whitespace, so that 3 elements are shown, and not 4?

EDIT

basenames contains filenames, that is nearly every character (apart from / and \0) is allowed.

EDIT 2

The -W flag expects a single word, that is something like foo bar foobar. Passing multiple elements to it (this is what ${basenames[@]} would do) won't work.

EDIT 3

Changed examplary basenames array (so the foo and the foo from foo bar won't get collapsed).

Using a newline to separate the words works:

local IFS=$'\n'
COMPREPLY=($(compgen -W "$(printf "%s\n" "${basenames[@]}")" --  ${COMP_WORDS[COMP_CWORD]}"))

Using \0 doesn't:

local IFS=$'\0'
COMPREPLY=($(compgen -W "$(printf "%s\0" "${basenames[@]}")" --  ${COMP_WORDS[COMP_CWORD]}"))

Answer 1

Why bother with compgen? Just add them to COMPREPLY manually. The following will complete the matching filenames from /some/path, handling filenames safely.

some_completion_function() {
    local files=("/some/path/$2"*)
    [[ -e ${files[0]} ]] && COMPREPLY=( "${files[@]##*/}" )
}

It's not possible to have compgen handle filenames safely.

Answer 2

You should almost always use an at sign instead of an asterisk to subscript an array.

COMPREPLY=($(compgen -W "${basenames[@]}" -- "${COMP_WORDS[COMP_CWORD]}"))

from man bash (or see the Bash Reference Manual):

If subscript is @ or *, the word expands to all members of name. These subscripts differ only when the word appears within double quotes. If the word is double-quoted, ${name[*]} expands to a single word with the value of each array member separated by the first character of the IFS special variable, and ${name[@]} expands each element of name to a separate word.

In other words, the at sign form "flattens" the array. The asterisk form preserves it.

Answer 3

Perhaps this might do:

COMPREPLY=($(compgen -W "$(printf "%q " "${basenames[*]}")" -- "${COMP_WORDS[COMP_CWORD]}"))

Answer 4

Read better solution there

Use readarray and printf

readarray -t words < /etc/passwd
compgen -W  "$(printf "'%s' " "${words[@]}")" -- "man"
# OUTPUTS: man:x:6:12:man:/var/cache/man:/usr/sbin/nologin

• readarray: Avoid dealing with IFS
• printf: Escape: or @Q parameter transformation after bash 4.4 (20170 man bash search parameter@operator

Answer 5

I solved this problem by creating a bash function:

    # Helper function to complete arguments
    function __get_completion()
    {
        # No arguments or command failure
        (( ! $# || $? )) && COMPREPLY=() && return $?

        local comp_list=$*

        COMPREPLY=($(compgen -W "$comp_list" -- \'${COMP_WORDS[COMP_CWORD]}\'))
        return $?
    }

Now you can use it like so:

basenames=("foo" "fu bar" "baz")
switches=('--source' '--destination' '--flag')
__get_completion "${basenames[@]}" "${switches[@]}"; return $?

As you can see it even works with multiple arguments or passing a command in:

__get_completion "$(ls -a)"; return &?