fisher

Fischer

Ein Plugin -Manager für Fisch - Ihre freundliche interaktive Hülle. Schnappen Sie sich frische Plugins!

Übernehmen Sie die Kontrolle über Funktionen, Abschlüsse, Bindungen und Ausschnitte aus der Befehlszeile. Entfesselt das wahre Potenzial Ihrer Shell, perfektionieren Sie Ihre Eingabeaufforderung und erstellen Sie mühelos wiederholbare Konfigurationen über verschiedene Systeme hinweg. Fisher's Null -Auswirkungen auf das Start von Shell hält Ihre Schale faul und reaktionsschnell. Keine Gimmicks, nur glattes Segeln!

• Fisher ist 100% reines Fisch, was es einfach macht, einen Beitrag zu leisten oder zu ändern
• Schnelle gleichzeitige Plugin -Downloads, die Sie in Frage der Realität in Frage stellen können
• Null Konfiguration benötigt - wir machen keine Witze!
• Oh mein Fisch! Auch Plugins unterstützt

☝️ Upgrade von Fisher 3.x oder älter? Schnallen und lesen Sie das!

Installation

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

QuickStart

Mit Fisher können Sie Plugins wie einen Boss installieren, aktualisieren und entfernen. Genießen Sie die Registerkarte von Fish's Tab und eine reichhaltige Syntax -Hervorhebung, während Sie dabei sind.

Plugins installieren

Verwenden Sie zum Installieren von Plugins den Befehl install und richten Sie ihn auf das GitHub -Repository an.

 fisher install jorgebucaran/nvm.fish

Willst du von Gitlab installieren? Kein Problem - Vorbereiten Sie nur gitlab.com/ auf den Plugin -Pfad.

Sie können auch eine bestimmte Version eines Plugins schnappen, indem Sie nach dem Plugin -Namen ein @ -Symbol hinzufügen, gefolgt von einem Tag, einem Zweig oder einem Commit.

 fisher install IlanCosman/tide@v5

Und hey, Sie können Plugins auch aus einem lokalen Verzeichnis installieren!

 fisher install ~/path/to/plugin

Kopf hoch! Fisher erweitert die Plugins standardmäßig in Ihr Fischkonfigurationsverzeichnis und überschreiben vorhandene Dateien. Wenn das nicht Ihr Marmelade ist, stellen Sie $fisher_path an Ihren bevorzugten Ort und setzen Sie ihn in Ihren Funktionspfad (#640).

Plugins auflisten

Verwenden Sie den Befehl list , um alle Ihre glänzenden installierten Plugins anzuzeigen.

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

Der Befehl list spielt auch gut mit regulären Ausdrücken für die Filterung der Ausgabe.

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

Plugins aktualisieren

update den Befehl zur Rettung! Es aktualisiert ein oder mehrere Plugins in der neuesten und größten Version.

 fisher update jorgebucaran/fisher

Geben Sie einfach fisher update ein, um alles auf einen Sturz zu aktualisieren.

Plugins entfernen

Verabschieden Sie sich von installierten Plugins mit dem Befehl remove .

 fisher remove jorgebucaran/nvm.fish

Fühlen Sie sich zerstörerisch? Wischen Sie alles aus, einschließlich Fisher selbst.

 fisher list | fisher remove 

Verwenden Sie Ihre fish_plugins -Datei

Wenn Sie ein Plugin aus der Befehlszeile installieren oder entfernen, räumen Fisher alle installierten Plugins in $__fish_config_dir/fish_plugins . Fügen Sie diese Datei zu Ihren Punktfilmen oder Versionen hinzu, um Ihre Konfiguration einfach über verschiedene Systeme hinweg weiterzugeben.

Sie können diese Datei auch bearbeiten und fisher update ausführen, um Änderungen wie ein Profi zu begehen:

 $EDITOR $__fish_config_dir/fish_plugins 

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

 fisher update

Dadurch werden Patrickf1 / Fzf.fish , REMET / HOME / JB / PATH / TO / Plugin installiert und alles andere aktualisiert.

Erstellen eines Plugins

Plugins können eine beliebige Anzahl von Dateien in Verzeichnissen functions , conf.d und completions enthalten. Die meisten Plugins sind nur eine einzelne Funktion oder ein Konfigurationsausschnitt. Sehen Sie sich die Anatomie eines typischen Plugins an:

 Flipper
├── Vervollständigungen
│ └── Flipper.fish
├── conf.d
│ └── Flipper.fish
└── Funktionen
    └── Flipper.fish

Nicht .fish -Dateien und -verzeichnisse in diesen Standorten werden unter functions , conf.d oder completions auf $fisher_path kopiert.

Ereignissystem

Fischveranstaltungen benachrichtigen Plugins, wenn sie installiert, aktualisiert oder entfernt werden.

Denken Sie daran, --on-event -Funktionen geladen werden müssen, wenn ihr Ereignis emittiert wird. Legen Sie also Ihre Event -Handler in das conf.d -Verzeichnis.

 # 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 

Ein Thema erstellen

Ein Thema ist wie jedes andere Fisch -Plugin, jedoch mit einer .theme -Datei im themes . Die Themen wurden in FISH 3.4 eingeführt und arbeiten mit dem fish_config -Bauarbeiten zusammen. Ein Thema kann bei Bedarf auch Dateien in functions , conf.d oder completions haben. Schauen Sie sich an, wie ein typisches Themen -Plugin aussieht:

 Kiemen
├── conf.d
│ └── Gill.fish
└── Themen
    └── Gill.theme

Verwenden Sie $fisher_path mit Themen

Wenn Sie $fisher_path an die Verwendung eines anderen Verzeichnisses als $__fish_config_dir anpassen, sind Ihre Themen nicht über fish_config verfügbar. Das liegt daran, dass Fisch erwartet, dass Ihre Themen in $__fish_config_dir/themes sind, nicht $fisher_path/themes . Dies ist in FISH noch nicht konfigurierbar, aber es gibt eine Anfrage, diese Funktion hinzuzufügen.

Angst nicht! Sie können dies problemlos durch SYMLINKING Fisher's themes -Verzeichnis in Ihre Fischkonfiguration lösen. Sichern Sie zunächst ein bestehendes Themenverzeichnis.

 mv $__fish_config_dir/themes $__fish_config_dir/themes.bak

Erstellen Sie als nächstes einen Symlink für Fisher's Themes Directory.

 ln -s $fisher_path/themes $__fish_config_dir/themes

Möchten Sie Themen -Plugins verwenden und Ihre eigenen lokalen Themen pflegen? Sie können das auch tun (#708).

Entdeckbarkeit

Während Fisher nicht auf ein zentrales Plugin -Repository angewiesen ist, muss das Entdecken neuer Plugins nicht wie das Navigieren von Uncharted Waters fühlen. Um die Sichtbarkeit Ihres Plugins zu steigern und den Benutzern das Finden von Benutzern zu erleichtern, fügen Sie Ihrem Repository mit fish-plugin relevante Themen hinzu. Auf diese Weise tragen Sie nicht nur zur Fisher -Community bei, sondern ermöglichen es Benutzern auch, neue Plugins zu erkunden und ihre Fisch -Shell -Erfahrung zu verbessern. Lassen Sie die Plugin -Entdeckung nicht ein fischiges Geschäft sein, markieren Sie noch heute Ihre Plugins!

Anerkennung

Fisher begann seine Reise im Jahr 2016 von @jorgeBucaran als Shell Configuration Manager für Fisch. Auf dem Weg dazu haben viele dazu beigetragen, es zu dem zu formen, was es heute ist. Oh mein Fisch ebnete den Weg als das erste beliebte Fischrahmen. @jethrokuan unterstützte in den ersten Jahren entscheidende Unterstützung. @Patrickf1s offenes Feedback erwies sich immer wieder von unschätzbarem Wert. Bootstrapping Fisher war ursprünglich @Ilancosmans brillante Idee. Vielen Dank an alle unsere Mitwirkenden! <3

Lizenz

MIT