mirror of https://github.com/jorgebucaran/fisher synced 2024-07-06 23:11:48 +02:00

History

Jorge Bucaran 85f897104d Ahoy my mateys! fisherman 2.0.0 (beta) is here. A lot has changed, in fact, fisherman as you knew it, is no longer with us. Let me explain. The new fisherman, is in fact a rewired clone of ``fin´´, a short-lived 2 week experiment that started because it was easier to rewrite everything than moving fisherman forward. Let me explain. I was longing for a lightweight, simpler fisherman with minimal maintanance cost. This fin lad is one of the most pragmatic pieces of code I've ever written, but attempting to maintain two drastically different plugin managers was not a sane decision. fin's goal was to get out of my way and let me be productive with fish and it did. Now fin is fisherman and fisherman is fin. The most notable change is that fisherman no longer depends on an index, so like fin, it's neutral and agnostic to what plugins you use. No index means fisherman completions are no longer as clever as to show you description of plugins, but you will still get enough information to know whether the plugin is a theme or not. I hope you always check the plugin's README / online docs before installing anything anyway. With the index gone, we had no use for ``search``, so this command is also gone. If you were using search often or depended on the removed features above, I am afraid they are gone gone, but trust me it's all for the very best. Now, with this out of the way, it's all unicorns and dartfish. Almost. To upgrade to fisherman 2.0.0 you need to REMOVE your current version of fisherman: 1. ```rm -rf "$fisher_home" "$fisher_config"``` 2. Open your config.fish and remove the fisherman initialization code. 3. ```exec fish < /dev/tty``` to reload the session. 4. Run `curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman` That's it. Probably. The new fisherman brings a lot more stability and maturity to the project and we need this change in order to move forward. I will be actively fixing any bugs that may have sneaked in during the ```fin->fisherman``` rewiring, but please do ping me: @bucaran on GitHub or directly to my email j@bucaran.me if you find anything out of place. Feel free and invited to go wild with issues in order to get this into shape ASAP. Cheers!	2016-04-22 00:34:06 +09:00
..
README.md	Ahoy my mateys! fisherman 2.0.0 (beta) is here.	2016-04-22 00:34:06 +09:00

Ahoy my mateys! fisherman 2.0.0 (beta) is here.

A lot has changed, in fact, fisherman as you knew it, is
no longer with us. Let me explain. The new fisherman, is
in fact a rewired clone of ``fin´´, a short-lived 2 week
experiment that started because it was easier to rewrite
everything than moving fisherman forward.

Let me explain. I was longing for a lightweight, simpler
fisherman with minimal maintanance cost. This fin lad is
one of the most pragmatic pieces of code I've ever written,
but attempting to maintain two drastically different plugin
managers was not a sane decision. fin's goal was to get out
of my way and let me be productive with fish and it did.

Now fin is fisherman and fisherman is fin. The most notable
change is that fisherman no longer depends on an index, so
like fin, it's neutral and agnostic to what plugins you use.

No index means fisherman completions are no longer as clever
as to show you description of plugins, but you will still get
enough information to know whether the plugin is a theme or not.

I hope you always check the plugin's README / online docs before
installing anything anyway.

With the index gone, we had no use for ``search``, so this command
is also gone.

If you were using search often or depended on the removed features
above, I am afraid they are gone *gone*, but trust me it's all for
the very best.

Now, with this out of the way, it's all unicorns and dartfish. Almost.

To upgrade to fisherman 2.0.0 you need to REMOVE your current version
 of fisherman:

1. ```rm -rf "$fisher_home" "$fisher_config"```
2. Open your config.fish and remove the fisherman initialization code.
3. ```exec fish < /dev/tty``` to reload the session.
4. Run `curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman`

That's it. Probably.

The new fisherman brings a lot more stability and maturity to the
project and we need this change in order to move forward. I will
be actively fixing any bugs that may have sneaked in during the
```fin->fisherman``` rewiring, but please do ping me:

@bucaran on GitHub or directly to my email j@bucaran.me

if you find anything out of place. Feel free and invited to  go
wild with issues in order to get this into shape ASAP.

Cheers!

2016-04-22 00:34:06 +09:00

README.md

Ahoy my mateys! fisherman 2.0.0 (beta) is here.

2016-04-22 00:34:06 +09:00

README.md

fisherman - fish shell plugin manager

fisherman es un gestionador de paquetes para el fish shell de procesamiento en paralelo libre de configuración.

Lee este documento en otro idioma: English, 日本語, 简体中文.

Motivo

Simple
Sin configuración
Sin dependencias externas
No influye en el tiempo de inicio de la sesión
Se puede utilizar de manera interactiva o a la vundle
Solo lo fundamental, install, update, remove, list y help

Instalación

Copia fisher.fish en ~/.config/fish/functions y listo.

curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman

Uso

Instala paquetes.

fisher simple

Instala de múltiples fuentes.

fisher z fzf omf/{grc,thefuck}

Instala URLs.

fisher https://github.com/edc/bass

Instala gists.

fisher https://gist.github.com/username/1f40e1c6e0551b2666b2

Instala un directorio.

fisher ~/my_aliases

A la vundle. Edita el fishfile y entra fisher para satisfacer los cambios.

¿Qué es el fishfile y cómo lo utilizo?

$EDITOR fishfile # añade paquetes
fisher

Muestra que está instalado actualmente.

fisher ls
@ my_aliases    # este paquete es un directorio
* simple        # este paquete es el tema actual
  bass
  fzf
  grc
  thefuck
  z

Actualiza todo.

fisher up

Actualiza algunos paquetes.

fisher up bass z fzf thefuck

Elimina paquetes.

fisher rm simple

Elimina todos los paquetes.

fisher ls | fisher rm

Muestra ayuda.

fisher help z

FAQ

1. ¿Qué versión de fish se requiere?

fisherman está diseñado para el último fish, pero se requiere 2.0.0 mínimo. Si no puedes actualizar fish, añade este código a ~/.config/fish/config.fish para poder ejecutar snippets.

for file in ~/.config/fish/conf.d/*.fish
    source $file
end

2. ¿Cómo puedo instalar fish en OS X?

Via Homebrew.

brew install fish

3. ¿Cómo puedo instalar el útlimo fish en algunos Linux?

Via git, compilando el código.

sudo apt-get -y install git gettext automake autoconf \
    ncurses-dev build-essential libncurses5-dev

git clone -q --depth 1 https://github.com/fish-shell/fish-shell
cd fish-shell
autoreconf && ./configure
make && sudo make install

4. ¿Cómo hago fish mi shell por defecto?

Añade fish a la lista de login shells in /etc/shells.

echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

5. ¿Cómo puedo desinstalar fisherman?

Entra

fisher self-uninstall

6. ¿Es fisherman compatible con paquetes y temas de oh my fish?

Sí.

7. ¿Por qué fisherman? ¿Por qué no ____?

fisherman tiene / es:

Diminuto y cabe en un solo archivo
No influye en el tiempo de inicio de la sesión
Rápido y fácil de instalar, actualizar y desinstalar
No requiere modificar tu configuración de fish
Usa el sistema XDG de directions base correctamente

8. ¿Dónde guarda fisherman las cosas?

fisherman mismo va en ~/.config/fish/functions/fisher.fish.

El caché y la configuración en ~/.cache/fisherman y ~/.config/fisherman respectivamente.

El fishfile en ~/.config/fish/fishfile.

9. ¿Qué es el fishfile y cómo lo uso?

El fishfile ~/.config/fish/fishfile registra todos los paquetes que están instalados.

Puedes dejar que fisherman se encargue de este archivo automáticamente, o ingresar los paquetes que requieres y entrar fisher para satisfacer los cambios.

fisherman/simple
fisherman/z
omf/thefuck
omf/grc

Este mecanismo solo instala paquetes y dependecias necesarias. Para remover paquetes, usa fisher rm.

10. ¿Dónde consigo las lista de paquetes para fish?

Diríjete a la organización o usa la búsqueda en línea para descrubir contenido.

11. ¿Cómo puedo migrar desde ____?

fisherman no interfiere con otros sistemas conocidos. Si quieres desinstalar oh my fish, diríjete a su documentación

13. ¿Qué es un paquete?

Un paquete es:

un directorio o repositorio de git con una función / archivo .fish bien sea en el nivel raíz del proyecto o en un directorio llamado functions.
un tema o prompt, es decir, fish_prompt.fish, fish_right_prompt.fish o ambos.
un snippet, es decir, uno o más archivos .fish en un directorio llamado conf.d que son ejecutados por fish al inicio de la sesión.

14. ¿Cómo puedo añadir dependencias a mi plugin?

Crea un fishfile en el nivel raíz de tu proyecto y escribe los paquetes.

owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32

15. ¿Qué puedes decir de fundle?

fundle fue la inspiración para utilizar el fishfile, pero todavía es limitado en sus capacidades y hace requisito modificar la configuración de fish.

16. Tengo una pregunta que no aparece aquí. ¿Dónde pregunto?

Crea un nuevo ticket en el issue tracker:

https://github.com/fisherman/fisherman/issues