Переопределить завершение bash для git clone

официальный FAQ bash-completion содержит очень интересную информацию.

Во-первых, если вы на 100 % уверены, что ваши переменные среды $BASH_COMPLETION_USER_DIR и $XDG_DATA_HOME пусты, то, что вы указали в своем исходном вопросе, является хорошим местом для добавления ваших собственных сценариев завершения bash:

~/.local/share/bash-completion/completions/git

Следует отметить, что расширение .bash не требуется.

Дело в том, что скрипты bash-дополнения загружаются благодаря файлу /etc/profile.d/bash_completion.sh.

Если вы что-то сделаете в своем .bashrc файле, вы как-то сломаете что-то в цепочке загрузки.

Тем не менее, если вы переопределяете существующую функцию завершения, вам все равно необходимо обеспечить правильный порядок загрузки. Поэтому загрузка первого сценария завершения bash обязательна, чтобы убедиться, что все завершилось успешно. Вы можете легко это сделать, добавив эту начальную инструкцию в начало вашего ~/.local/share/bash-completion/completions/git файла:

# Ensures git bash-completion is loaded before overriding any function (be careful to avoid endless loop).
! complete -p git &> /dev/null && [ ${ENDLESS_LOOP_SAFEGUARD:-0} -eq 0 ] && ENDLESS_LOOP_SAFEGUARD=1 BASH_COMPLETION_USER_DIR=/dev/null  _completion_loader git

Сначала он проверяет, загружено ли уже git bash-completion, а затем, если это не так, загружаются все определения git для bash-completion. Изменить: трюк ENDLESS_LOOP_SAFEGUARD позволяет избежать бесконечного цикла, когда это первый раз, когда завершение bash загружает часть git.

При необходимости вы можете получить использование:

complete --help

Complete: Complete [-abcdefgjksuv] [-pr] [-DE] [-o опция] [-A действие] [-G globpat] [-W список слов] [-F функция] [-C команда] [-X filterpat] [-P префикс] [-S суффикс] [имя ...] Укажите, как аргументы должны быть дополнены Readline.

Для каждого ИМЯ укажите, как аргументы должны быть завершены. Если параметры не указаны, существующие спецификации завершения распечатываются таким образом, чтобы их можно было повторно использовать в качестве входных данных.

Опции:

-p распечатать существующие спецификации завершения в повторно используемом формате -r удалить спецификацию завершения для каждого ИМЯ или, если ИМЕНА не указаны, все спецификации завершения -D применить завершения и действия по умолчанию для команд без какого-либо определенного завершения -E применять завершения и действия к «пустым» командам — попытка завершения на пустой строке

При попытке завершения действия применяются в том порядке, в котором параметры заглавных букв перечислены выше. Параметр -D имеет приоритет над параметром -E.

Состояние выхода: возвращает успех, если не указан недопустимый параметр или не возникает ошибка.

Тогда и только тогда вы можете определить все, что хотите, включая ваш старый способ переопределить завершение git clone bash:

# Ensures git bash-completion is loaded before overriding any function (be careful to avoid endless loop).
! complete -p git &> /dev/null && [ ${ENDLESS_LOOP_SAFEGUARD:-0} -eq 0 ] && ENDLESS_LOOP_SAFEGUARD=1 BASH_COMPLETION_USER_DIR=/dev/null  _completion_loader git

# https://github.com/scop/bash-completion/blob/d2f14a7/bash_completion#L498
__ltrim_colon_completions() {
    if [[ "$1" == *:* && "$COMP_WORDBREAKS" == *:* ]]; then
        # Remove colon-word prefix from COMPREPLY items
        local colon_word=${1%"${1##*:}"}
        local i=${#COMPREPLY[*]}
        while [[ $((--i)) -ge 0 ]]; do
            COMPREPLY[$i]=${COMPREPLY[$i]#"$colon_word"}
        done
    fi
}


_git_clone() {
    case "$cur" in
    --*)
        __gitcomp_builtin clone
        return
        ;;
    *)
        argc=0
        for word in "${words[@]}"; do
            case "$word" in
            git|clone|--*)
                continue
                ;;
            *)
                argc=$((argc + 1))
                ;;
            esac
        done

        if [ $argc -le 1 ]; then
            __gitcomp "https://github.com/git/git https://github.com/python/cpython"
            __ltrim_colon_completions "$cur"
        fi
        ;;
    esac
}

Каждый раз, когда вы вносите изменения и хотите проверить результат, вам просто нужно запросить перезагрузку bash-completion для git:

_completion_loader git

Таким образом, вы никогда не потеряете свои изменения, потому что вы оставляете файлы пакета нетронутыми; и все еще можете улучшить любое существующее bash-дополнение своими собственными функциями.

Изменить:

О вашем страхе с _completion_loader function => , но после проверки исходного кода эта функция существует с момента коммита cad3abfc7 из 2015-07-15 20:53:05, поэтому я думаю, что он должен быть обратно совместимым, но это правда без гарантии. Я отредактирую свой ответ, чтобы предложить несколько альтернатив

В качестве альтернативы, это должен быть другой способ получить собственное определение завершения git (поместить в начало вашего собственного скрипта):

# Ensures git bash-completion is loaded before overriding any function
# Be careful to avoid endless loop with dedicated $ENDLESS_LOOP_SAFEGUARD environment variable.
if ! complete -p git &> /dev/null && [ ${ENDLESS_LOOP_SAFEGUARD:-0} -eq 0 ]; then
    # Trick: define $BASH_COMPLETION_USER_DIR environment variable here to ensure bash-completion rule are loaded once.
    export BASH_COMPLETION_USER_DIR=/usr/share
    complete -D git

    unset BASH_COMPLETION_USER_DIR
    ENDLESS_LOOP_SAFEGUARD=1 complete -D git
fi

В ваших .bashrc / .bash_profile вы можете принудительно загрузить завершения по умолчанию для git перед переопределением завершения для git clone:

if ! complete -p git &> /dev/null
then
    # Instead of hardcoding the name of the dynamic completion loader
    # function, you can obtain it by parsing the output of 'complete -p -D'
    _completion_loader git
fi

_git_clone() {
    COMPREPLY=("My own completion for 'git clone'")
}

ИЗМЕНИТЬ

Далее следует лениво загружаемая версия описанного выше подхода (которая не с готовностью загружает завершения bash по умолчанию для git):

if ! complete -p git &> /dev/null
then
    _my_git_clone()
    {
        COMPREPLY=("My own completion for 'git clone'")
    }

    # A placeholder for git completion that will load the real
    # completion script on first use     
    _my_git_comp_stub()
    {
        # Remove the old completion handler (which should be this very function)
        complete -r git

        # and load the git bash completion
        _completion_loader git

        # Rebind _git_clone to our own version
        eval 'function _git_clone() { _my_git_clone "$@"; }'

        # Tell the completion machinery to retry the completion attempt
        # using the updated completion handler
        return 124
    }

    # Install a lazy loading handler for git completion    
    complete -o bashdefault -o default -o nospace -F _my_git_comp_stub git
fi