fish_add_path — добавление в путь

Синтаксис

fish_add_path path ...
fish_add_path [(-g | --global) | (-U | --universal) | (-P | --path)] [(-m | --move)] [(-a | --append) | (-p | --prepend)] [(-v | --verbose) | (-n | --dry-run)] PATHS ...

Описание

fish_add_path — простой способ добавления дополнительных компонентов в PATH оболочки fish. Это делается путём добавления компонентов в $fish_user_paths или напрямую в PATH (если используется переключатель --path).

Использовать fish_add_path в файле конфигурации config.fish (по умолчанию) безопасно, или можно использовать его один раз в интерактивном режиме, и пути останутся в будущем благодаря универсальным переменным. Команда имеет стиль «сделай так, как я хочу», если вам нужен больший контроль, попробуйте изменить переменную вручную.

Компоненты нормализуются с помощью realpath. Конечные слэши игнорируются, относительные пути делаются абсолютными (но ссылки не разрешаются). Если компонент уже существует, он не добавляется снова и остаётся на месте, если не используется переключатель --move.

Компоненты добавляются в том порядке, в котором они указаны, и предваряют путь, если не используется переключатель --append (если используется $fish_user_paths, это означает, что они размещаются в конце $fish_user_paths, который сам предваряет PATH, так что они по-прежнему стоят перед системными путями).

Если ни один из компонентов не новый, переменная (fish_user_paths или PATH) не устанавливается повторно или иным образом не изменяется, поэтому обработчики переменных не вызываются.

Если компонент не является существующей директорией, fish_add_path его игнорирует.

Параметры

-a или --append

Добавляет компоненты в конец переменной.

-p или --prepend

Добавляет компоненты в начало переменной (это значение по умолчанию).

-g или --global

Использует глобальную fish_user_paths.

-U или --universal

Использует универсальную fish_user_paths — это значение по умолчанию, если она ещё не существует.

-P или --path

Непосредственно изменяет PATH.

-m или --move

Перемещает уже существующие компоненты в место, где они должны быть добавлены — по умолчанию они остаются на месте и не добавляются повторно.

-v или --verbose

Выводит команду set.

-n или --dry-run

Выводит команду set, которая будет использована без её выполнения.

-h или --help

Отображает справку по использованию этой команды.

Если --move используется, это может привести к изменению порядка путей, поэтому будьте осторожны при использовании в config.fish.

Пример

# I just installed mycoolthing and need to add it to the path to use it.
> fish_add_path /opt/mycoolthing/bin

# I want my ~/.local/bin to be checked first.
> fish_add_path -m ~/.local/bin

# I prefer using a global fish_user_paths
> fish_add_path -g ~/.local/bin ~/.otherbin /usr/local/sbin

# I want to append to the entire $PATH because this directory contains fallbacks
> fish_add_path -aP /opt/fallback/bin

# I want to add the bin/ directory of my current $PWD (say /home/nemo/)
> fish_add_path -v bin/
set fish_user_paths /home/nemo/bin /usr/bin /home/nemo/.local/bin

# I have installed ruby via homebrew
> fish_add_path /usr/local/opt/ruby/bin