gitui

GitUI bietet Ihnen den Komfort einer Git-GUI, aber direkt in Ihrem Terminal

Inhaltsverzeichnis

1. Merkmale
2. Motivation
3. Benchmarks
4. Roadmap
5. Einschränkungen
6. Installation
7. Bauen
8. FAQs
9. Diagnose
10. Farbthema
11. Tastenkombinationen
12. Sponsoring
13. Inspiration
14. Mitwirken
15. Mitwirkende

1. Funktionen ^{Oben ▲}

• Schnelle und intuitive Steuerung nur über die Tastatur
• Kontextbasierte Hilfe ( Sie müssen sich nicht jede Menge Hotkeys merken )
• Änderungen prüfen, festschreiben und ändern (inkl. Hooks: pre-commit , commit-msg , post-commit , Prepare-commit-msg )
• Dateien, Hunks und Zeilen bereitstellen, aus der Bereitstellung entfernen, zurücksetzen und zurücksetzen
• Verstecken (Speichern, Pop, Anwenden, Ablegen und Überprüfen)
• Drücken/Abrufen zur/von der Fernbedienung
• Filialliste (Erstellen, Umbenennen, Löschen, Auschecken, Remotes)
• Commit-Protokoll durchsuchen/ durchsuchen , festgeschriebene Änderungen unterscheiden
• Reaktionsfähige Terminal-Benutzeroberfläche
• Asynchrone Git-API für flüssige Kontrolle
• Unterstützung von Submodulen
• gpg-Commit-Signatur mit Mängeln (siehe #97))

2. Motivation ^{Oben ▲}

Ich erledige den Großteil meiner Git-Arbeit in einem Terminal, aber ich habe häufig Git-GUIs für einige Anwendungsfälle wie Index, Commit, Diff, Stash, Blame und Log verwendet.

Leider versagen beliebte Git-GUIs alle in riesigen Repositories oder reagieren nicht mehr und sind unbrauchbar.

GitUI bietet Ihnen die Benutzererfahrung und den Komfort einer Git-GUI, aber direkt in Ihrem Terminal und ist gleichzeitig portabel, schnell, kostenlos und Open Source.

3. Benchmarks ^{Oben ▲}

Für eine RustBerlin-Meetup-Präsentation (Folien) habe ich lazygit , tig und gitui verglichen, indem ich das gesamte Linux-Git-Repository analysiert habe (das über 900.000 Commits enthält):

	Zeit	Speicher (GB)	Binär (MB)	Friert ein	Abstürze
gitui	24 s ✅	0,17 ✅	10	Nein ✅	Nein ✅
lazygit	57 s	2.6	25	Ja	Manchmal
tig	4 m 20 s	1.3	0,6 ✅	Manchmal	Nein ✅

4. Road(map) zu 1.0 ^{Oben ▲}

Dies sind die übergeordneten Ziele vor der Ausrufung von 1.0 :

• Verzweigungsstruktur im Protokoll-Tab visualisieren (#81)
• interaktive Rebase (#32)

5. Bekannte Einschränkungen ^{Oben ▲}

• keine spärliche Repo-Unterstützung (siehe #1226)
• keine Git-LFS-Unterstützung (siehe #1089)
• credential.helper für https muss explizit konfiguriert werden (siehe #800)

Derzeit ersetzt dieses Tool die Git-Shell nicht vollständig, beide Tools funktionieren jedoch gut zusammen.

Die Prioritäten für gitui liegen auf Funktionen, die mich wütend machen, wenn ich mit der Git-Shell fertig bin, wie Stashing, Staging Lines oder Hunks. Irgendwann werde ich daran arbeiten können, gitui zu einer Komplettlösung zu machen – aber dafür brauche ich Hilfe – das ist vorerst nur ein Freizeitprojekt.

Jede Unterstützung ist willkommen! Auch Sponsoren! ❤️

6. Installation ^{oben ▲}

GitUI befindet sich in der Betaphase und kann Fehler und fehlende Funktionen enthalten. Für den persönlichen Gebrauch ist es jedoch einigermaßen stabil und wird während der Entwicklung verwendet.

Verschiedene Paketmanager

Installationsanweisungen

Arch Linux

pacman -S gitui

Fedora

sudo dnf install gitui

Gentoo

Verfügbar im dm9pZCAq-Overlay

sudo eselect repository enable dm9pZCAq
sudo emerge --sync dm9pZCAq
sudo emerge dev-vcs/gitui::dm9pZCAq

openSUSE

sudo zypper install gitui

Homebrew (macOS)

brew install gitui

MacPorts (macOS)

port install gitui

Winget (Windows)

 winget install gitui

Scoop (Windows)

 scoop install gitui

Schokoladend (Windows)

 choco install gitui

Nix (Nix/NixOS)

Nixpkg

 nix-env -iA nixpkgs.gitui

NixOS

 nix-env -iA nixos.gitui

Termux (Android)

 pkg install gitui

Anakonda

 conda install -c conda-forge gitui

Binärdateien freigeben

Verfügbar zum Download in Veröffentlichungen

Verfügbare Binärdateien für:

Linux

• gitui-linux-x86_64.tar.gz (Linux muss statisch verknüpft sein)
• gitui-linux-aarch64.tar.gz (Linux auf 64-Bit-Arm)
• gitui-linux-arm.tar.gz
• gitui-linux-armv7.tar.gz

Alle enthalten eine einzige Binärdatei

macOS

• gitui-mac.tar.gz (arm64)
• gitui-mac-x86.tar.gz (Intel x86)

Windows

• gitui-win.tar.gz (einzelne 64-Bit-Binärdatei)
• gitui-win.msi (64-Bit-Installationspaket)

Nächtliche Builds

siehe NIGHTLIES.md

7. Aufbau ^{oben ▲}

Anforderungen

• Mindestens unterstützte rust / cargo : 1.70

  • Siehe Rust installieren

• So erstellen Sie eine OpenSSL-Abhängigkeit (siehe https://docs.rs/openssl/latest/openssl/)

  • Perl >= 5.12 (Strawberry Perl funktioniert für Windows https://strawberryperl.com/)
  • AC-Compiler (MSVC, GCC oder Clang, Cargo wird es finden)

• Um die komplette Testsuite auszuführen, ist Python erforderlich (und es muss als python aufrufbar sein)

Frachtinstallation

Der einfachste Weg, mit gitui herumzuspielen, besteht darin, cargo mit cargo install gitui --locked erstellen und installieren zu lassen. Wenn Sie mit Rost und Ladung nicht vertraut sind: Erste Schritte mit Rust

Frachtfunktionen

Trace-Libgit

Aktivieren Sie libgit2 Ablaufverfolgung

Funktioniert, wenn libgit2 mit -DENABLE_TRACE=ON erstellt wurde

Diese Funktion ist standardmäßig aktiviert, zum Deaktivieren: cargo install --no-default-features

8. FAQs ^{Oben ▲}

siehe FAQ-Seite

9. Diagnose ^{Oben ▲}

Um es mit aktivierter Protokollierung auszuführen, führen Sie gitui -l aus.

Dies wird protokolliert unter:

• macOS: $HOME/Library/Caches/gitui/gitui.log
• Linux mit XDG : $XDG_CACHE_HOME/gitui/gitui.log
• Linux: $HOME/.cache/gitui/gitui.log
• Windows: %LOCALAPPDATA%/gitui/gitui.log

10. Farbthema ^{oben ▲}

gitui sollte automatisch sowohl bei hellen als auch bei dunklen Terminalthemen funktionieren.

Sie können jedoch alles nach Ihren Wünschen anpassen: Siehe Themen.

11. Tastenbelegung ^{Oben ▲}

Die Tastenbelegungen können angepasst werden: Unter Key Config erfahren Sie, wie Sie sie auf vim -ähnliche Bindungen einstellen.

12. Sponsoring ^{Oben ▲}

13. Inspiration ^{oben ▲}

• faul
• tig
• GitUp
  • Es wäre schön, eine Möglichkeit zu finden, die Kartenansicht in einem Terminal-Tool verfügbar zu machen
• Git-Brunch

14. Beitrag leisten ^{Oben ▲}

Siehe CONTRIBUTING.md.

15. Mitwirkende ^{Oben ▲}

Vielen Dank an alle Mitwirkenden, die dazu beitragen, GitUI großartig zu machen! ❤️

Möchten Sie Mitbetreuer werden? Wir suchen Dich!