|
8 years ago | |
---|---|---|
.. | ||
README.md | 8 years ago |
README.md
fisherman - fish plugin manager
fisherman это параллельный менеджер плагинов для fish-shell.
Достоинства fisherman
-
Не нужно настраивать
-
Нет внешних зависимостей
-
Не влияет на время запуска оболочки
-
Можно использовать в интерактивном режиме или через fishfile
-
Плагины устанавливаются и обновляются в параллельном режиме
-
Только необходимые функции: установка, обновление, удаление, список и справка
Установка
Используя curl:
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Использование
Установка отдельного плагина.
fisher simple
Установка из нескольких источников.
fisher z fzf omf/{grc,thefuck}
Установка по ссылке URL.
fisher https://github.com/edc/bass
Установка из gist.
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Установка из локального каталога.
fisher ~/my_aliases
Отредактируйте fishfile и запустите fisher
, чтобы изменения вступили в силу.
$EDITOR fishfile # добавьте плагины
fisher
Список установленных плагинов.
fisher ls
@ my_aliases # этот плагин представляет собой локальный каталог
* simple # этот плагин является текущим оформлением командной строки
bass
fzf
grc
thefuck
z
Список доступных плагинов.
fisher ls-remote
...
spin roach git_util pwd_info
submit flash pyenv host_info
...
Обновление всего сразу.
fisher up
Обновление отдельных плагинов.
fisher up bass z fzf thefuck
Удаление плагинов.
fisher rm simple
Удаление всех плагинов.
fisher ls | fisher rm
Справка по плагину.
fisher help z
Часто задаваемые вопросы
1. Какая версия fish необходима?
fisherman был разработан для fish >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш ~/.config/fish/config.fish
для поддержки cниппетов.
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. Как сделать fish основной командной оболочкой?
Добавьте fish в список командных оболочек /etc/shells и сделайте её оболочкой по умолчанию.
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
3. Как мне удалить fisherman?
fisher self-uninstall
4. Совместим ли fisherman с темами и плагинами oh my fish?
Да.
5. Где fisherman хранит данные?
Скрипт fisherman находится в ~/.config/fish/functions/fisher.fish.
Кэш и настройки плагинов создаются в ~/.cache/fisherman и ~/.config/fisherman соответственно.
fishfile сохраняется в ~/.config/fish/fishfile.
6. Что такое fishfile и как я могу его использовать?
В ~/.config/fish/fishfile хранится список всех установленных плагинов.
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить fisher
, чтобы эти изменения вступили в силу.
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте fisher rm
.
7. Где я могу найти список плагинов для fish?
Используйте поиск по Github организации или онлайн поиск на сайте.
8. Что такое плагин?
Плагином является:
-
каталог или git репозиторий с файлом .fish либо на корневом уровне проекта, либо в директории functions
-
тема или оформление командной строки, т.е. fish_prompt.fish, fish_right_prompt.fish или оба файла
-
сниппет, т.е. один или несколько .fish файлов в директории conf.d, которые загружаются при запуске fish
9. Как я могу объявить зависимости моего плагина?
Создайте новый fishfile в корне вашего проекта со списком зависимостей.
owner/repo
https://github.com/owner/repo
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32