MeiliFinder

MeiliFinder ʕʘ̅͜ʘ̅ʔ

Der ultimative Meilisearch-Client für Ihr Terminal!

MeiliFinder ist ein schöner und schneller terminalbasierter Meilisearch-Client, der mit Rust erstellt wurde? und Ratatui.

Warum MeiliFinder?

Meilisearch ist großartig; Es ist jedoch kein offizieller Client dafür verfügbar. Es gibt zwar einige von der Community erstellte Clients, diese sind jedoch größtenteils webbasiert und verfügen nicht über wichtige Funktionen. Wenn Sie wie ich ein Terminal-Liebhaber sind oder Maus hassen, möchten Sie vielleicht einen terminalbasierten Client verwenden, um mit Meilisearch zu interagieren. Hier kommt MeiliFinder ins Spiel. Es ist schnell, robust, leicht und einfach zu bedienen. Es ist außerdem Open Source, sodass Sie zum Projekt beitragen und es verbessern können.

Merkmale

• Nach Dokumenten suchen
• Suchen Sie nach Dokumenten mit Sortier- und Filterabfragen
• Suchen Sie nach Dokumenten mit Paginierung
• Einzelne Dokumente löschen
• Massenlöschung von Dokumenten nach Filter
• Stellen Sie eine Verbindung zu mehreren Meilisearch-Instanzen her
• Dokumente bearbeiten
• Indexeinstellungen aktualisieren
• Wechseln Sie im Handumdrehen zwischen Indizes und Instanzen
• Aufgabenvorschau
• Settings.json-Datei zum Anpassen der App
• Toast-Benachrichtigungen

Benutzen

Klonen Sie das Repository und führen Sie cargo run im Stammverzeichnis aus. Falls Sie keine Datei instances.json im Stammverzeichnis haben, werden Sie aufgefordert, die Meilisearch-Instanz-URL und den API-Schlüssel einzugeben. Sobald Sie die Details eingegeben haben, speichert die App die Informationen in einer neuen Datei instances.json und Sie können mit der Suche nach Dokumenten beginnen.

Um die App zu verlassen, drücken Sie q oder Ctrl+C .

Screenshots

Verknüpfungen

Normaler Modus

• tab – Wechseln Sie zwischen verschiedenen Tabs in der App.
• r – Aktuelle Liste aktualisieren.
• s – Wechseln Sie in den Suchmodus (Suchanfragen einfügen).
• Up/Down – Navigieren Sie durch die aktuelle Liste.
• Enter – Wählen Sie den aktuellen Index/die aktuelle Instanz aus.
• Space – Schnelle Vorschau des markierten Dokuments.
• Ctrl+u – Alle Suchanfragen zurücksetzen.
• q – Beenden Sie die App.
• Ctrl+C – Beenden Sie die App.

Suchmodus

• Esc – Suchmodus verlassen.
• tab – Navigieren Sie durch Such-/Filter-/Sortierabfragen.
• Enter – Suche durchführen.

Vorschaumodus

• Esc – Vorschaumodus verlassen.
• backspace – Wechseln Sie in den Löschmodus.

Löschmodus

• Esc – Löschmodus beenden.
• backspace – Bestätigen Sie den Löschvorgang.

Datei „instances.json“ (optional)

Die Datei instances.json ist eine JSON-Datei, die die Meilisearch-Instanz-URL und den API-Schlüssel speichert. Die App verwendet diese Datei, um eine Verbindung zur Meilisearch-Instanz herzustellen. Sie können der Datei mehrere Instanzen hinzufügen und im Handumdrehen zwischen ihnen wechseln.

Die Datei sollte so aussehen:

[
	{
		"id" : " 1 " ,
		"name" : " Your Meilisearch Instance Name " ,
		"host" : " https://your-Meilisearch-instance.com " ,
		"primary_key" : " your-api-key "
	}
]

Weitere Informationen finden Sie in der Beispieldatei sample.instances.json im Stammverzeichnis. Sie können es in instances.json umbenennen und Ihre Meilisearch-Instanzdetails hinzufügen.

Global installieren

Um es global auszuführen, können Sie die App mit cargo binstall MeiliFinder installieren. Stellen Sie sicher, dass Sie binstall binstall repo installiert haben. Nach der Installation können Sie die App aufrufen, indem Sie einfach MeiliFinder im Terminal ausführen. Dies ist eine Binärkiste und keine Bibliothek, daher sollten Sie sie nicht als Abhängigkeit verwenden.

Möglicherweise stelle ich in Zukunft einige vorgefertigte Binärdateien für Windows/MacOS/Linux bereit oder veröffentliche sie auf Homebrew/Winget.

Credits

• Meilisearch für die Bereitstellung des Rust SDK.
• Ratatui für das schöne TUI-Framework.

Lizenz

MIT

Einschränkungen

Derzeit verarbeitet die App nur ASCII- oder 1-Byte-UTF-8-Zeicheneingaben. Wenn Sie ein Nicht-ASCII-Zeichen eingeben (z. B. „ö“, „ß“ usw.), ignoriert die App die Eingabe.