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

Синтаксис

fish_add_path [paths...]
fish_add_path (-h | --help)
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, которая будет использована, без её выполнения

Использование --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