abbr - управление сокращениями команд

Синтаксис

abbr --add [SCOPE] WORD EXPANSION
abbr --erase WORD...
abbr --rename [SCOPE] OLD_WORD NEW_WORD
abbr --show
abbr --list
abbr --query WORD...

Описание

abbr управляет сокращениями — определёнными пользователем словами, которые заменяются более длинными фразами после их ввода.

Например, часто используемая команда, например git checkout может быть сокращена до gco. После ввода gco и нажатия Пробел или Ввод, полное содержание git checkout появится в командной строке.

Параметры

Доступны следующие параметры:

• -a WORD EXPANSION или --add WORD EXPANSION Добавляет новое сокращение, заставляя слово WORD расширяться до EXPANSION.
• -r OLD_WORD NEW_WORD или --rename OLD_WORD NEW_WORD Переименовывает сокращение со старого слова OLD_WORD на новое NEW_WORD.
• -s или --show Показывает все сокращения в формате, подходящем для экспорта и импорта.
• -l или --list Выводит список всех сокращённых слов.
• -e WORD или --erase WORD... Удаляет заданные сокращения.
• -q или --query Возвращает 0 (true), если одно из слов WORD является сокращением.

Кроме того, при добавлении или переименовании сокращений:

• -g или --global использовать глобальную переменную.
• -U или --universal использовать универсальную переменную (по умолчанию).

Более подробная информация об этом приведена в разделе «Внутреннее устройство».

Примеры

abbr -a -g gco git checkout

Добавить новое сокращение, где gco будет заменено на git checkout глобально для текущей оболочки. Это сокращение не будет автоматически отображаться в других оболочках, если не будет запущена аналогичная команда в этих оболочках (например, при выполнении команд в config.fish).

abbr -a -U l less

Добавить новое сокращение, где l будет заменено на less универсально для всех оболочек. Обратите внимание, что вы опускаете -U, так как это значение по умолчанию.

abbr -r gco gch

Переименовывает существующее сокращение с gco на gch.

abbr -e gco

Удалить сокращение gco.

ssh another_host abbr -s | source

Импортировать сокращения, определённые на другом хосте по SSH.

Внутреннее устройство

Каждое сокращение хранится в своей собственной глобальной или универсальной переменной. Имя состоит из префикса _fish_abbr_ и слова WORD после преобразования с помощью string escape style=var. Слово WORD не может содержать пробелы, но все остальные символы допустимы.

Определение сокращения с глобальным охватом немного быстрее, чем с универсальным (который является значением по умолчанию). Но в общем случае вы захотите использовать глобальный охват только при определении сокращений в скрипте запуска, например, ~/.config/fish/config.fish следующим образом:

if status --is-interactive
    abbr --add --global first 'echo my first abbreviation'
    abbr --add --global second 'echo my second abbreviation'
    abbr --add --global gco git checkout
    # etcetera
end

Вы можете создавать сокращения интерактивно, и они будут видны в других сессиях fish, если вы используете флаги -U или --universal, или не указываете явно область действия, и сокращение ещё не определено с глобальным охватом. Если вы хотите, чтобы оно было видно только в текущей оболочке, используйте флаги -g или --global.