basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Tab после алиаса: дополнение для своих коротких команд

    После alias sc='systemctl' Tab по sc подставляет имена файлов: дополнение Bash привязано к имени команды, а не к алиасу. Алиасу из одной команды хватает двух строк в ~/.bash_completion, алиасу с аргументами, как dc='docker compose', нужен скрипт complete-alias.

    Почему Tab молчит

    Дополнение по Tab в Bash — функция, привязанная к имени команды. Для systemctl это _systemctl, её подключает пакет bash-completion при первом Tab после systemctl. Набираем systemctl sta, жмём Tab дважды — получаем start и status.

    У имени sc своей функции нет. Bash не раскрывает алиас перед дополнением и предлагает то, что есть всегда, — имена файлов в текущем каталоге. sc sta и Tab — тишина, sc и Tab — file-one, file-two.

    Алиас из одной команды: две строки

    Если алиас — одна команда без аргументов, привязываем к нему функцию этой команды:

    # ~/.bash_completion — bash-completion читает его последним
    _completion_loader systemctl
    complete -F _systemctl sc

    _completion_loader systemctl подгружает дополнение systemctl сразу, а не при первом Tab. Без этой строки функции _systemctl при входе ещё нет. Имя функции для другой команды показывает complete -p:

    complete -p systemctl
    # complete -F _systemctl systemctl

    Строки пишем в ~/.bash_completion, а не в ~/.bash_aliases. .bashrc в Ubuntu читает ~/.bash_aliases раньше, чем загружает bash-completion, — там этих функций ещё нет. ~/.bash_completion bash-completion читает сам, в конце своей загрузки.

    Алиас с аргументами: complete-alias

    С dc='docker compose' этого мало. Функция _docker дополняет команды самого docker: с ней dc comp и Tab превращается в dc compose, а down и logs она не предложит. Ей нужно, чтобы в строке стояло docker compose.

    Это делает complete-alias — скрипт на Bash с GitHub, лицензия GPL. Перед дополнением он разворачивает алиас в строке и зовёт дополнение настоящей команды. Скачиваем версию по тегу, а не с ветки — так файл не поменяется без нас, — и читаем, прежде чем подключать:

    mkdir -p ~/.local/share
    curl -fsSL -o ~/.local/share/complete_alias \
      https://raw.githubusercontent.com/cykerway/complete-alias/1.18.0/complete_alias
    less ~/.local/share/complete_alias

    В версии 1.18.0 около 1060 строк, в сеть скрипт не ходит. Подключаем в том же ~/.bash_completion и перечисляем алиасы:

    # ~/.bash_completion
    . ~/.local/share/complete_alias
    complete -F _complete_alias sc dc

    Теперь dc do и Tab дописывают down, dc logs --ta — --tail. Алиасы одной команды он тоже обслуживает, поэтому sc можно перечислить здесь, без строк из прошлого раздела.

    Если не работает

    При входе — _completion_loader: command not found, а Tab по sc пишет bash: completion: function … not found

    Причина
    Строки дополнения лежат в ~/.bash_aliases. .bashrc Ubuntu читает этот файл раньше, чем загружает bash-completion, и его функций ещё нет.
    Делаем
    Переносим строки в ~/.bash_completion: его bash-completion читает сам, после своей загрузки.

    После complete -F _docker dc Tab по dc comp дописывает compose, по dc ima — image

    Причина
    Функция _docker дополняет команды самого docker. Что dc — это уже docker compose, она не знает.
    Делаем
    Для алиаса с аргументами — complete-alias: complete -F _complete_alias dc.

    complete -p systemctl отвечает no completion specification

    Причина
    bash-completion подгружает дополнение команды при первом Tab по ней, до этого его нет.
    Делаем
    _completion_loader systemctl, потом снова complete -p systemctl.

    Как проверить

    После нового входа или source ~/.bash_completion:

    complete -p sc dc
    # complete -F _complete_alias sc
    # complete -F _complete_alias dc

    sc sta и Tab дважды — start и status.