Почему 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..bashrcUbuntu читает этот файл раньше, чем загружает 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.