fish_delta - сравнение функций и дополнений с предустановленными

Синтаксис

fish_delta name ...
fish_delta [-f | --no-functions] [-c | --no-completions] [-C | --no-config] [-d | --no-diff] [-n | --new] [-V | --vendor=]
fish_delta [-h | --help]

Описание

Функция fish_delta позволяет быстро определить, какие ваши функции и дополнения отличаются от набора, поставляемого с fish.

Для этого она проходит по соответствующим переменным (fish_function_path для функций и fish_complete_path для дополнений) и сравнивает файлы с предустановленными каталогами fish.

Если указаны какие-либо имена, сравнение будет производиться только по этим именам (плюс расширение ".fish").

По умолчанию, она также использует diff для отображения различий между файлами. Если diff недоступна, она пропустит этот этап, но в этом случае не сможет определить, действительно ли файлы различаются.

Код выхода равен 1, если были найдены различия, и 2 в случае других ошибок, в противном случае 0.

Параметры

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

-f или --no-functions

Останавливает проверку функций

-c или --no-completions

Останавливает проверку дополнений

-C или --no-config

Останавливает проверку конфигурационных файлов, таких как config.fish или сниппетов в каталогах conf.d.

-d или --no-diff

Удаляет отображение различий (это происходит автоматически, если diff не найдена)

-n или --new

Также выводит новые файлы (т.е. те, которые не могут быть найдены в предустановленных каталогах fish).

-Vvalue или --vendor=value

Определяет, как обрабатывать каталоги vendor. Допустимые значения:

• “default” - считает файлы vendor как принадлежащие предустановленным. Любые изменения в других каталогах будут считаться изменениями по отношению к ним. Это значение по умолчанию.
• “user” - считает файлы vendor как принадлежащие пользователю. Любые изменения в них будут считаться новыми или изменёнными файлами.
• “ignore” - игнорирует каталоги vendor. Файлы с одинаковыми именами будут считаться «новыми», если в предустановленных каталогах fish нет файла с таким же именем.

-h или --help

Выводит справку по fish_delta (этой команде).

Пример

Выполнение только:

fish_delta

покажет список всех изменённых функций и дополнений, включая различия (если у вас есть команда diff).

Это может выглядеть так:

> fish_delta
New: /home/alfa/.config/fish/functions/battery.fish
Changed: /home/alfa/.config/fish/test/completions/cargo.fish
--- /home/alfa/.config/fish/test/completions/cargo.fish 2022-09-02 12:57:55.579229959 +0200
+++ /usr/share/fish/completions/cargo.fish      2022-09-25 17:51:53.000000000 +0200
# the output of `diff` follows

Параметры предназначены для выбора частей вывода. С помощью --no-completions можно сравнивать только функции, а с помощью --no-diff можно отключить отображение diff.

Для сравнения только fish_git_prompt, можно использовать:

fish_delta --no-completions fish_git_prompt

что сравнит только файлы с именем “fish_git_prompt.fish”.