Text-Tools

Zwei Textblöcke zu vergleichen ist etwas, das Menschen ständig tun – fast immer in einem unpassenden Moment: eine Konfiguration, die auf dem einen Host funktioniert und auf dem anderen nicht, ein Response-Body, der sich zwischen zwei Deploys geändert hat, eine Vertragsklausel, die jemand ohne Änderungsverfolgung bearbeitet hat, eine Log-Zeile, die fast, aber nicht ganz die von gestern ist.

Die Versuchung liegt darin, es mit bloßem Auge zu vergleichen. Bei drei Zeilen funktioniert das, bei dreißig scheitert es geräuschlos, denn die menschliche Aufmerksamkeit ist außerordentlich gut darin, das zu sehen, was sie erwartet. Ein Diff ist in dieser Situation keine Annehmlichkeit; er ist der Unterschied zwischen der Änderung auf die Spur zu kommen und sich einzureden, es gebe keine.

Was ein Diff-Tool gut macht, ist die Granularität. Der Vergleich auf Zeilenebene ist der richtige Standard und das, was die Versionsverwaltung zeigt, aber bei zwei Klassen von Eingaben führt er aktiv in die Irre: bei minifizierten oder einzeiligen Dateien, wo das gesamte Dokument eine einzige Zeile ist und der Diff zu „diese Zeile hat sich geändert“ verkümmert; und bei langen Fließtextzeilen, wo eine Ein-Wort-Änderung einen ganzen Absatz als umgeschrieben ausweist. Wort- und Zeichenmodus existieren genau für diese Fälle, und zwischen allen dreien umschalten zu können, ohne erneut einfügen zu müssen, ist der größte Teil des Nutzens.

Die andere Hälfte ist, dass die Ausgabe portabel sein muss. Ein Diff, das man sich nur ansehen kann, ist weniger wert als eines, das man jemandem weitergeben kann; deshalb erzeugt der Unified-Patch-Export einen Standard-Patch mit ordentlichen Hunk-Headern – das Format, das patch(1) akzeptiert, und das Format, das ein Code-Review-Tool korrekt darstellt, wenn Sie es in einen Kommentar einfügen.

Text ist oft das Sensibelste auf dieser Website. Eine JSON-Payload sind meist Maschinendaten; ein Text-Diff ist häufig ein Vertragsentwurf, eine interne Notiz, eine Incident-Timeline oder eine Kunden-E-Mail. Genau deshalb findet der Vergleich in Ihrem Browser statt und nicht auf einem Server: nicht als Feature, sondern weil es ein schlechtes Geschäft ist, dieses Material an einen unbekannten Host zu schicken, um eine Frage zu beantworten, die Sie lokal beantworten könnten – egal zu welchem Preis.

Wenn das, was Sie vergleichen, JSON statt Fließtext ist, nehmen Sie stattdessen JSON vergleichen. Das Tool vergleicht die geparste Struktur statt des Texts, sodass Neuformatierung und umsortierte Schlüssel – die ein Text-Diff als hunderte Änderungen meldet – korrekt als keinerlei Änderung erscheinen.