gitoxide: Git in Rust neu implementiert, als Bibliothek und CLI

Ein Rust-Git mit zwei Einstiegen

gitoxide ist eine in Rust geschriebene Git-Implementierung; die Repository-Beschreibung nennt sie eine idiomatische, schlanke, schnelle und sichere reine-Rust-Implementierung. Das README führt zwei Verwendungsweisen auf. Anwendungscode kann die gix-Crate als Cargo-Abhängigkeit nutzen, um auf die API zuzugreifen. Daneben gibt es zwei Kommandozeilenprogramme: gix als Werkzeug auf niedriger Ebene, um die API an echten Repositories zu testen, und ein mit Kommandos für den Arbeitsablauf auf höherer Ebene. Das README warnt, beide Binärdateien könnten für immer instabil bleiben und man solle sich in Skripten nicht auf sie verlassen.

Crate-Status und der gix-Einstieg

Das README verweist für Einzelheiten zu jeder Crate auf ein eigenes crate-status-Dokument und nennt gix die Einstiegs-Crate, die niedrigere Plumbing-Crates wie gix-config zusammenführt. Der Produktionsreifegrad ist in Stabilitätsstufen geteilt: gix-lock steht auf Stufe eins, gix-tempfile auf Stufe zwei. Eine Reihe von Stabilisierungskandidaten, darunter gix-mailmap, gix-ref und gix-config, gelten als funktional vollständig, aber noch nicht als 1.0 veröffentlicht. Darunter sind die meisten Crates als brauchbar markiert, mit grober, aber vollständiger Doku und möglicherweise unvollständiger Funktionalität; gix-blame ist sehr früh, und eine Gruppe wie gix-lfs, gix-rebase und gix-fsck existiert nur als Namensplatzhalter auf Ideenebene.

Umgesetzte und offene Funktionen

Das README führt eine Checkliste auf hoher Ebene. Clone, fetch, status, blob- und tree-diff, commit-graph-Durchlauf, Worktree-Checkout sowie das Lesen und Schreiben von Objekten, Referenzen, Index, Konfiguration, Pathspecs, Revspecs sowie ignore- und attributes-Dateien sind abgehakt. Push, rebase, reset, Commit-Hooks und das Zusammenführen von Commits nicht. Das Zusammenführen von Blobs und Trees ist erledigt. Beim Stresstesten sind die Prüfung riesiger Packs, das Entpacken eines Packs auf die Platte und das Erzeugen und Prüfen großer Commit-Graphen abgehakt; das Erzeugen eines riesigen Packs aus vielen losen Objekten bleibt offen. Das README verweist zudem auf ein eigenes SHORTCOMINGS-Dokument, statt Einschränkungen selbst zusammenzufassen.

Installationswege

Das README dokumentiert mehrere Installationswege. Binär-Releases lassen sich nach Installation von cargo-binstall mit cargo binstall gitoxide holen. Homebrew, das community-Repository von Arch und das Rust-Repository von Exherbo haben jeweils einen Befehl. Aus dem Quellcode wird cargo install gitoxide mit drei Feature-Profilen gezeigt: max ist die Standard- und schnellste Variante, braucht aber cmake; max-pure vermeidet die Anforderungen einer C-Toolchain; lean tauscht eine weniger aufwendige CLI gegen kleinere Binärdateien und schnellere Builds. Ein Docker-Beispiel baut ein Image aus etc/docker/Dockerfile.alpine, mit dem Hinweis, dass es kein offizielles Image gibt und das Dockerfile nicht kontinuierlich getestet wird und möglicherweise schon kaputt ist.

Projektziele und ausdrückliche Nicht-Ziele

Der Zielabschnitt nennt eine reine-Rust-Implementierung, die Transport, Objektdatenbank, Referenzen, CLI und TUI abdeckt, mit einer einfachen Kommandozeile für die häufigsten Operationen. libgit2 wird als Referenz für bewährte Abstraktionen genannt; Rusts Typsystem soll Missbrauch unmöglich machen; Ziel ist die leistungsfähigste Implementierung, mit Parallelität von Anfang an. Konsistenz auf der Platte heißt: Lesen stört nie nebenläufige Schreibvorgänge, und mehrere nebenläufige Schreibvorgänge verursachen keine Probleme. Plattformübergreifende Unterstützung inklusive Windows wird ausdrücklich genannt, mit Tests in der CI. Die Nicht-Ziele sind ebenso konkret: git nicht perfekt nachbilden, das Plattenformat kompatibel halten und nicht überall asynchrones IO einsetzen.

Beitragsablauf und Fahrplan

Beitragende sollen just test ausführen, damit CI grün bleibt. Die Arbeit wird über ein im README verlinktes Kanban-Board verfolgt, mit Diskussionen und einem Kollaborationsleitfaden als Alternativen. Drei Video-Playlists behandeln Rust lernen mit gitoxide, eine Einführung in gitoxide und die Begutachtung von Pull-Requests. Der Fahrplan für 1.0 listet das Initialisieren eines Repositories, fetch, clone mit Arbeitsbaum, das Erstellen eines Commits nach dem Hinzufügen von Arbeitsbaumdateien und das Pushen eines dünnen Packs als grundlegenden Nutzerpfad; nur ein Teil davon ist abgehakt. Das README nennt außerdem Ideen für Beispiele und Ableger, ausdrücklich ohne Zusage.

Lizenz und nicht verifizierte Punkte

Das README erklärt, das Projekt stehe wahlweise unter Apache License 2.0 oder MIT-Lizenz, während die Metadaten des Repositories als SPDX-Kennung Apache-2.0 angeben. Der für diesen Artikel gelieferte Lizenzauszug enthält nur den Hinweis, dass unter dem üblichen Pfad keine LICENSE-Datei gefunden wurde; der tatsächliche Gewährungstext konnte hier also nicht geprüft werden. Der Auszug sagt nichts über Sicherheitslage, Support oder Gewährleistung. Ebenso nennt das README die Mindestversion von Rust nicht als Zahl, sondern verweist auf das Cargo-Paket. Push, Commit-Merge, rebase und reset sind im README als nicht implementiert gelistet; Einzelheiten müssen in crate-status.md und SHORTCOMINGS.md nachgelesen werden.

Redaktionelles Fazit

Das README stellt gitoxide als von Grund auf in Rust geschriebene Git-Implementierung dar; clone, fetch, status sowie blob- und tree-diff sind abgehakt, push, Commit-Merge, rebase und reset nicht. Alles Weitere verweist es auf die immer wieder verlinkten Dokumente crate-status und SHORTCOMINGS, statt es selbst zusammenzufassen.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes