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