1. Schluss mit „Binary files differ“: OmniDiff zeigt, was anders ist

Git meldet eine geänderte Bilddatei – doch was genau ist darauf anders? Das Open-Source-Werkzeug OmniDiff macht die Unterschiede im Terminal sichtbar, auch bei PDFs und Schriftdateien. Die jüngste Version 0.5.0 erweitert die Ausgabe und die Git-Integration.

Bei Binärdateien meldet Git normalerweise nur, dass sich die beiden Versionen unterscheiden. Zwar lassen sich Inhalte mit zusätzlichen Werkzeugen in Text umwandeln, etwa um Metadaten zu vergleichen. Die Git-Dokumentation erklärt aber auch die Grenzen dieser Konvertierung: Bildinhalte können dabei beispielsweise verloren gehen. Das in Rust geschriebene OmniDiff von Marko Ivankovic vergleicht stattdessen die jeweiligen Inhalte direkt.

Geänderte Pixel statt bloßer Binärmeldung

Bei Rasterbildern zeigt OmniDiff, wie viel sich geändert hat und wo die Unterschiede liegen. Es unterstützt unter anderem PNG, JPEG und WebP. Die interaktive Terminaloberfläche markiert geänderte Bereiche und zeigt ein Differenzbild oder legt beide Versionen direkt übereinander. Animationen vergleicht das Werkzeug Bild für Bild und erkennt auch hinzugefügte oder entfernte Frames.

PDF-Seiten und die Glyphen einer Schriftdatei rendert OmniDiff, damit Nutzer sie visuell vergleichen können. Die Beispiele auf der GitHub-Projektwebsite zeigen unter anderem ein PDF-Diagramm mit einer umbenannten Beschriftung. Die Ausgabe grenzt die Änderung auf einen Bereich der ersten Seite ein. Bei einer WOFF2-Schriftdatei weist sie 20 überarbeitete Icons und geänderte Metadaten aus, statt die gesamte Datei pauschal als geänderte Binärdatei abzutun.

Lesen Sie auch

Auch Archive untersucht OmniDiff anhand ihres Inhalts. Das Tool ordnet die enthaltenen Dateien nach Namen zu und vergleicht die geänderten Einträge passend zu ihrem Format. Das funktioniert auch mit verschachtelten Archiven. So kann OmniDiff Dokumentformate vergleichen, die auf ZIP-Archiven basieren: Mit einer OpenDocument-Datei demonstriert das Projekt getrennte Unterschiede in XML-Dateien und im eingebetteten Vorschaubild. Das ist allerdings keine Gegenüberstellung des fertig formatierten Dokuments.

Quellcode nach seiner Struktur vergleichen

Für Quellcode nutzt OmniDiff Tree-sitter, um die Syntaxstruktur zu erfassen. Laut Dokumentation unterstützt die Software 26 Programmiersprachen und Formate, darunter Rust, Python, JavaScript, TypeScript, JSON und YAML. Der Strukturvergleich hilft, Änderungen am Code von bloßen Änderungen an der Formatierung zu unterscheiden.

Prinzipiell ist dieser Ansatz nicht neu: Auch Difftastic vergleicht Code anhand seiner Syntax und kann Änderungen trotz anderer Zeilenumbrüche herausarbeiten. OmniDiff verbindet den strukturellen Codevergleich jedoch mit den beschriebenen Verfahren für Bilder und andere Inhalte. Textdateien mit unbekannter Endung vergleicht OmniDiff zeilenweise.

Version 0.5.0 ergänzt die strukturelle Auswertung von SQL, und zwar mit der Tree-sitter-Grammatik von nvim-treesitter. Voraussetzung ist, dass die verwendete Grammatik die Datei ohne Parse-Fehler einliest. Andernfalls erscheint ein Text-Diff. Bei sehr großen Syntaxbäumen zieht das Werkzeug eine Grenze: Übersteigt eine der beiden Dateien 300.000 Knoten, wechselt es zum Textvergleich.

Interaktiv in Git, als Textausgabe für Skripte

Die Konfiguration ist einfach: Mit omnidiff git configure lässt sich das Werkzeug für Git einrichten. git difftool öffnet anschließend die interaktive Ansicht, während die Einbindung in git diff eine nicht interaktive Textausgabe liefert. Außerhalb von Git kann OmniDiff zwei Dateien direkt vergleichen. Für Skripte und CI gibt es einen Headless-Modus.

Laut den Release Notes zur Version 0.5.0 kann nun auch die Headless-Ausgabe beide Versionen im Side-by-Side-Modus anzeigen. Ein automatisches Layout berücksichtigt dabei die verfügbare Terminalbreite. Hinzu kommt eine lazygit-Integration, die dargestellte Zeilen ihren Positionen im Patch zuordnet. Dadurch kann lazygit aus der OmniDiff-Ansicht heraus navigieren, Zeilen öffnen und Änderungen für den Commit stagen.

Vorkompilierte Versionen gibt es für Linux, macOS und Windows. OmniDiff steht als Open-Source-Software unter der AGPL-3.0-only.

(fo)

Source: Heise · Moritz Förster

At a glance

Topic
Technology
Country
🇩🇪 DE
Publisher language
DE
Added to Allnira