fisher

Pescador

Un administrador de complementos para pescado: su captura interactiva amigable. ¡Enganche complementos frescos!

Tome el control de funciones, terminaciones, enlaces y fragmentos desde la línea de comando. Desatara el verdadero potencial de su caparazón, perfeccione su aviso y cree configuraciones repetibles en diferentes sistemas sin esfuerzo. El impacto cero de Fisher en el inicio de la concha mantiene su concha con cremallera y receptiva. Sin trucos, ¡solo navegando suave!

• Fisher es 100% puro en pescado, lo que facilita la contribución o modificación
• Descargas de complementos concurrentes rápidos y abrasadores que le harán hacer realidad realidad
• Se necesita configuración cero: ¡no estamos bromeando!
• ¡Oh, mi pez! complementos admitidos también

☝️ en la actualización de Fisher 3.x o más? ¡Strap y lee esto!

Instalación

 curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher 

Inicio rápido

Fisher le permite instalar, actualizar y eliminar complementos como un jefe. Deleje de completar la pestaña de Fish y la sintaxis rica que lo hace.

Instalación de complementos

Para instalar complementos, use el comando install y apírtelo al repositorio de GitHub.

 fisher install jorgebucaran/nvm.fish

¿Quieres instalar desde Gitlab? No hay problema, solo prepend gitlab.com/ a la ruta del complemento.

También puede obtener una versión específica de un complemento agregando un símbolo @ después del nombre del complemento, seguido de una etiqueta, rama o confirmación.

 fisher install IlanCosman/tide@v5

Y oye, ¡también puedes instalar complementos desde un directorio local!

 fisher install ~/path/to/plugin

¡Aviso! Fisher expande los complementos en su directorio de configuración de pescado de forma predeterminada, sobrescribiendo los archivos existentes. Si esa no es su mermelada, establezca $fisher_path en su ubicación preferida y póngala en su ruta de función (#640).

Complementos de listado

Use el comando list para ver todos sus complementos instalados brillantes.

$ fisher list
jorgebucaran/fisher
ilancosman/tide@v5
jorgebucaran/nvm.fish
/home/jb/path/to/plugin

El comando list también se reproduce bien con expresiones regulares para filtrar la salida.

$ fisher list ^ /
/home/jb/path/to/plugin

Actualización de complementos

update el comando al rescate! Actualiza uno o más complementos a su última y mejor versión.

 fisher update jorgebucaran/fisher

Simplemente escriba fisher update para actualizar todo de una sola vez.

Eliminar complementos

Diga adiós a los complementos instalados con el comando remove .

 fisher remove jorgebucaran/nvm.fish

¿Te sientes destructivo? Limpie todo, incluido el propio Fisher.

 fisher list | fisher remove 

Usando su archivo fish_plugins

Cada vez que instala o elimina un complemento de la línea de comandos, Fisher anota todos los complementos instalados en $__fish_config_dir/fish_plugins . Agregue este archivo a sus puntos o control de versión para compartir fácilmente su configuración en diferentes sistemas.

También puede editar este archivo y ejecutar fisher update para confirmar cambios como un profesional:

 $EDITOR $__fish_config_dir/fish_plugins 

jorgebucaran/fisher
ilancosman/tide@v5
jorgebucaran/nvm.fish
+ PatrickF1/fzf.fish
- /home/jb/path/to/plugin 

 fisher update

Esto instalará Patrickf1 / Fzf.fish , eliminar / home / jb / rath / to / complement , y actualizar todo lo demás.

Creando un complemento

Los complementos pueden incluir cualquier número de archivos en functions , conf.d y directorios completions . La mayoría de los complementos son solo una función única o un fragmento de configuración. Contemplar la anatomía de un complemento típico:

 aleta
├─ ec Enfermations
│ └── pez pez
├── Conf.d
│ └── pez pez
Funciones
    └── pez flipper

Los archivos y directorios no .fish dentro de estas ubicaciones se copiarán a $fisher_path bajo functions , conf.d o completions respectivamente.

Sistema de eventos

Los eventos de peces notifican complementos cuando se instalan, actualizan o eliminan.

Tenga en cuenta que las funciones --on-event deben cargarse cuando se emita su evento. Por lo tanto, coloque sus manejadores de eventos en el directorio conf.d

 # Defined in flipper/conf.d/flipper.fish

function _flipper_install --on-event flipper_install
    # Set universal variables, create bindings, and other initialization logic.
end

function _flipper_update --on-event flipper_update
    # Migrate resources, print warnings, and other update logic.
end

function _flipper_uninstall --on-event flipper_uninstall
    # Erase "private" functions, variables, bindings, and other uninstall logic.
end 

Creando un tema

Un tema es como cualquier otro complemento de pescado, pero con un archivo .theme en el directorio themes . Se introdujeron temas en Fish 3.4 y trabajan con el fish_config Builtin. Un tema también puede tener archivos en functions , conf.d o completions si es necesario. Mira cómo se ve un complemento de tema típico:

 branquias
├── Conf.d
│ └── Brills.fish
Temas
    └iqut Gills.theme

Usando $fisher_path con temas

Si personaliza $fisher_path para usar un directorio que no sea $__fish_config_dir , sus temas no estarán disponibles a través de fish_config . Esto se debe a que Fish espera que sus temas estén en $__fish_config_dir/themes , no $fisher_path/themes . Esto aún no está configurable en Fish, pero hay una solicitud para agregar esa función.

¡No temas! Puede resolver esto fácilmente simulando el directorio themes de Fisher en su configuración de pescado. Primero, haga una copia de seguridad de cualquier directorio de temas existentes.

 mv $__fish_config_dir/themes $__fish_config_dir/themes.bak

A continuación, cree un enlace simbólico para el directorio de temas de Fisher.

 ln -s $fisher_path/themes $__fish_config_dir/themes

¿Quieres usar complementos de temas y mantener tus propios temas locales? También puedes hacerlo (#708).

Descubrimiento

Si bien Fisher no confía en un repositorio central de complementos, descubrir nuevos complementos no tiene que sentirse como navegar por las aguas desconocidas. Para aumentar la visibilidad de su complemento y facilitar la búsqueda de los usuarios, agregue temas relevantes a su repositorio usando fish-plugin . Al hacerlo, no solo está contribuyendo a la comunidad de Fisher, sino que también permite a los usuarios explorar nuevos complementos y mejorar su experiencia de caparazón de pescado. No dejes que el descubrimiento de complementos sea un negocio sospechoso, ¡etiqueta tus complementos hoy!

Expresiones de gratitud

Fisher comenzó su viaje en 2016 por @JorgeBucaran como gerente de configuración de shell para Fish. En el camino, muchos ayudaron a darle forma a lo que es hoy. Oh, mi pez allanó el camino como el primer marco popular de peces. @jethrokuan proporcionó un apoyo crucial durante los primeros años. El comentario sincero de @Patrickf1 resultó invaluable una y otra vez. Bootstrapping Fisher fue originalmente la brillante idea de Ilancosman. ¡Gracias a todos nuestros contribuyentes! <3

Licencia

MIT