Bei den meisten Vergleichsjobs handelt es sich um eine Prüfung vor einer Übergabe: Ist dieser Export abgeschlossen, wird diese API-Änderung einen Client beschädigen, hat diese Konfiguration nur das geändert, was sie sollte? Diff Anything 1.6 beantwortet weitere dieser Fragen direkt auf Ihrem eigenen Mac oder Windows-PC.
Sie können jetzt einen CSV-Export mit der Arbeitsmappe vergleichen, aus der er stammt, eine API-Schemaprüfung in CI ausführen, die nur bei Breaking Changes fehlschlägt (mit Pro auf Windows), die gleichen Regeln für YAML wie für JSON verwenden und wechseln die Unterschiedsfarben zu Blau und Gelb. Jeder Unterschied kann auch als schriftliche Liste gelesen und über die Tastatur bearbeitet werden.
Überprüfen Sie die Übergabe, bevor sie erfolgt
Beantworten Sie die Frage, nicht nur den Unterschied.
- Vergleichen Sie einen CSV- oder TSV-Export mit dem Arbeitsmappenblatt, aus dem er stammt
- Lassen Sie bei Pro auf Windows einen CI-Job nur dann fehlschlagen, wenn eine API-Änderung wahrscheinlich Clients unterbricht
- Lesen Sie Unterschiede in den Farben, die Sie unterscheiden können, oder als schriftliche Liste
01 / Vergleichen Sie einen Export mit seiner Quelle
Vergleichen Sie eine CSV-Datei mit der Arbeitsmappe, aus der sie stammt
Ein Bericht wird in Excel erstellt, nach CSV exportiert und an ein anderes System gesendet. Wenn die Zahlen auf der anderen Seite falsch aussehen, stellt sich zunächst die Frage, ob der Export noch mit der Arbeitsmappe übereinstimmt. Bisher bedeutete das, dass man eine Datei konvertieren musste, bevor man sie vergleichen konnte.
Öffnen Sie in 1.6 die Datei CSV oder TSV auf der einen Seite und die Arbeitsmappe Excel, OpenDocument oder Apple Numbers auf der anderen Seite. Diff Anything vergleicht sie Zelle für Zelle und verwendet dabei das erste Blatt der Arbeitsmappe, es sei denn, Sie wählen unter „Mit Blatt vergleichen“ ein anderes aus. Jede geänderte Zelle wird mit ihrer Adresse aufgelistet, sodass Sie direkt zu der geänderten Zeile wechseln können.
Werte werden beim Speichern in der Arbeitsmappe verglichen, sodass ein Formatierungsunterschied wie 20 in der Arbeitsmappe und 20,0 in CSV als Änderung angezeigt wird. Das ist nützlich, wenn es dem empfangenden System wichtig ist, welchen genauen Text es erhält.
Zwei Arbeitsmappenrevisionen vergleichen? Folgen Sie dem ausgearbeiteten Beispiel, um zwei Excel-Dateien zu vergleichen und jede geänderte Zelle zu überprüfen, einschließlich der Budgetsummen und Daten auf einem anderen Blatt.
02 / Stoppen Sie inkompatible Änderungen, bevor sie versendet werden
Ein CI-Job schlägt nur dann fehl, wenn eine API-Änderung wahrscheinlich dazu führt, dass Clients unterbrochen werden
Diff Anything hat bereits die Schemaänderungen OpenAPI und JSON mit einem Regelcode gekennzeichnet, z. B. eine entfernte Operation oder eine neue erforderliche Eingabe. Jetzt zeigt das Ergebnis auch ein Breaking-Change-Urteil und eine Zählung, und identische Schemata melden überhaupt keine Unterschiede, selbst wenn eines in JSON und das andere in YAML geschrieben ist.
Führen Sie mit Pro unter Windows den gleichen Vergleich in Ihrer Pipeline mit --mode api --fail-on breaking aus oder legen Sie failOn: breaking für einen Fall in einem Batch-Manifest fest. Der Job wird erfolgreich ausgeführt, wenn die Änderungen additiv sind, und schlägt fehl, wenn eine Änderung fehlerhaft ist oder nicht klassifiziert werden konnte. JUnit- und SARIF-Berichte listen jedes Ergebnis mit seinem Regelcode auf, sodass im Build-Protokoll angegeben ist, was wo kaputt gegangen ist.
Die Regeln sind heuristisch: Sie lösen $ref nicht auf und unterscheiden keine Anforderungs- und Antwortschemata, und einige inkompatible Änderungen, wie beispielsweise ein umbenannter Parameter, werden nicht klassifiziert. Nutzen Sie die Prüfung als automatisches erstes Tor und behalten Sie einen Prüfer für die Änderungen bei, die sie durchlässt.
03 / Weniger falsche Änderungen
Sehen Sie nur die Konfigurationsänderungen, die wichtig sind
YAML hat jetzt die gleichen semantischen Regeln wie JSON. Ignorieren Sie ein generiertes Feld, behandeln Sie eine Liste als ungeordnet, vergleichen Sie einen Pfad ohne Groß- und Kleinschreibung oder lassen Sie eine kleine numerische Toleranz zu, und Pro-Profile speichern diese Regeln für die nächste Ausführung.
Listen von Datensätzen mit einem id-, _id-, uuid- oder key-Feld werden jetzt automatisch von diesem Feld gepaart, sodass ein eingefügter Datensatz nicht mehr dafür sorgt, dass jeder Datensatz geändert aussieht. Zahlen werden nach Wert verglichen, sodass 1 und 1,0 gleich sind. XML-Elemente werden durch ein Schlüsselattribut wie ID oder Name abgeglichen, und jeder Unterschied verfügt über einen lesbaren XPath-Speicherort.
Wenn Sie eine Änderung in eine JSON-Datei kopieren, wird nur dieser Wert geschrieben: Die Datei behält ihre Kommentare, nachgestellten Kommas und Einrückungen. Der HTTP-Antwortvergleich meldet jetzt eine geänderte HTTP-Version und einen geänderten Grundsatz sowie den Statuscode.
04 / Überprüfen Sie es auf eine Weise, die für Sie funktioniert
Lesen Sie jeden Unterschied in den Farben, die Sie unterscheiden können, oder in Worten
Wenn rote und grüne Hervorhebungen schwer zu unterscheiden sind, öffnen Sie die Einstellungen, wählen Sie „Unterschiedsfarben“ und dann „Blau und Gelb“. Hinzufügungen werden in hellen und dunklen Designs im gesamten Code-Editor, in strukturierten Bäumen, Tabellen, Ordnern und Dokumenten blau und Entfernungen gelb. Die Einstellung ist kostenlos; Three-Way Merge nutzt es mit Pro. Weitere Informationen zu den Einrichtungsschritten und dem gleichen Vergleich in beiden Paletten finden Sie im Leitfaden für farbenblinde Diff-Farben.
Der barrierefreie Arbeitsbereich verwandelt einen Vergleich in eine geordnete Seite: die Quellen, eine Zusammenfassung und jeder Unterschied mit seinem Standort, der Änderung sowie den ursprünglichen und aktualisierten Werten. Ein JSON-Feld, das von Ada zu Grace wechselt, lautet „Name: geändert von Ada zu Grace“. Blättern Sie durch die Liste, markieren Sie überprüfte Elemente, fügen Sie Notizen hinzu und übernehmen Sie Änderungen in unterstützten bearbeitbaren Vergleichen ohne die Maus. Öffnen Sie es mit Command-Shift-A auf einem Mac oder Control-Shift-A auf Windows; Auf einem Mac öffnet es sich von selbst, wenn VoiceOver ausgeführt wird.
Im barrierefreien Arbeitsbereich beschreiben Word, PowerPoint, PDF und Tabellenergebnisse ihre Unterschiede auch in Worten, nach Seite, Satz, Folie oder Zelle, und der Vergleich zwischen Word und PowerPoint liest weitere Formate, einschließlich DOCM, PPTM, Vorlagen sowie OpenDocument-Text und -Präsentationen.
05 / Verlassen Sie sich auf das, was Sie sehen
Vertrauen Sie auf das Ergebnis, das Sie erhalten
Ein Vergleich, den Sie abbrechen, wird als abgebrochen und nie als identisch angezeigt, mit einer Schaltfläche, um ihn erneut auszuführen. Bei der Drei-Wege-Zusammenführung Pro werden zwei Änderungen an derselben Zeile nur dann kombiniert, wenn sie separate Wörter berühren. Alles andere wird als Konflikt angezeigt, den Sie entscheiden können, sodass die zusammengeführte Datei niemals einen Wert enthält, den keine Seite geschrieben hat.
Wenn etwas nicht erledigt werden kann, wird in der Meldung jetzt angegeben, was schief gelaufen ist und wo, beispielsweise, dass eine Datei in einer anderen App geöffnet ist, und sie wird über jedem geöffneten Dialogfeld angezeigt. Auf Windows kann git diff neben dem vorhandenen Difftool-Setup Diff Anything als Diff-Treiber für die von Ihnen ausgewählten Dateitypen verwenden.
Der nächste Export, die nächste API-Änderung oder die nächste Konfigurationsüberprüfung ist nur ein paar Klicks entfernt.