Exportieren Sie Vergleichsnachweise oder transformieren Sie Text mit einer ausführbaren Datei, der Sie vertrauen

Funktionsübersicht

Wie kann ich Berichte und vertrauenswürdige Präprozessoren in Diff Anything verwenden?

Pro exportiert HTML-Berichte, die Text- und Dokumentvergleiche nebeneinander oder einspaltig zeigen, Ordnerberichte mit jeder geänderten Textdatei, JSON- und Markdown-Berichte, Unified Diffs und Ordner-Patches mit Git-Kopfzeilen sowie JSON Patch und JSON Merge Patch für Datenformate. „Drucken …“ öffnet den Bericht im Browser, der ihn druckt oder als PDF speichert. „Patch anwenden …“ zeigt vorab Block für Block, wie sich ein Unified Diff anwenden lässt; mit Pro wenden Sie ihn an und können ihn rückgängig machen.

Die lokale Transformation führt ein auf dem Computer installiertes Programm aus, z. B. jq, xmllint oder Black. Die App enthält diese Programme nicht. Die Mac App Store-Version wird in der App Sandbox von Apple ausgeführt, die sie auf Dateien und Ordner beschränkt, die Sie in der App auswählen. Daher wird die lokale Transformation für die Microsoft Store-Version auf Windows beschrieben.

Berichtsformate

Einen Bericht für die Person auswählen, die ihn lesen wird

Klicken Sie in der Symbolleiste auf „Exportieren“ und wählen Sie ein Berichtsformat aus. Die Schaltfläche ist verfügbar, sobald ein Vergleich mindestens einen Unterschied aufweist, und es wird nichts geschrieben, bis Sie mit „Standort auswählen“ einen Ort auswählen.

• HTML-Unterschiedstabelle: eine Datei mit ihren enthaltenen Stilen, mit den Zusammenfassungszahlen und einer Tabelle mit jedem Speicherort, Typ, beiden Werten, Beschreibung und Überprüfungsstatus.
• JSON-Bericht: der gleiche Inhalt für Skripte und andere Tools.
• Markdown-Überprüfungsbericht: Text, der sich gut in einer Pull-Anfrage, einem Ticket oder einer Wiki-Seite liest.
• Eigenständiger HTML eines Text- oder Dokumentvergleichs: die beiden Dateien nebeneinander oder wie ein einheitliches Diff verschachtelt, mit Zeilennummern, geänderten Wörtern markiert und unveränderten Zeilen, die um jede Änderung herum eingeblendet sind, oder die gesamten Dateien werden angezeigt. Ein Ordnerbericht kann den direkten Vergleich jeder geänderten Textdatei einbetten.
• Einheitlicher Textunterschied: ein Standard-Patch zweier Texte oder Dokumente oder eines Ordnervergleichs mit den Headern von Git, der mit git apply oder Apply patch… auf den linken Ordner angewendet werden kann.
• JSON Patch (RFC 6902) und JSON Merge Patch (RFC 7386): werden für JSON, YAML, TOML, INI und Eigenschaftenlistenvergleiche angeboten; Kopieren als JSON Patch in der Befehlspalette legt den Patch in der Zwischenablage ab.
• CSV geänderte Zeilen: eine tabellenfreundliche Liste mit Überprüfungsstatus und Notizspalten, die für CSV-Vergleiche angeboten wird.

Was reinkommt

Steuern, was ein Bericht enthält

Mit „Nur als überprüft markierte Unterschiede einbeziehen“ wird der Bericht auf die von Ihnen genehmigten Elemente beschränkt, wodurch aus einem langen Vergleich eine kurze Freigabeliste wird. Der Überprüfungsstatus und Notizen sind Teil jedes Berichts, sodass der Grund für jede Entscheidung mitgeführt wird.

Für Umgebungsdateien ist „Umgebungswerte redigieren“ standardmäßig aktiviert. Wenn Sie es deaktivieren, fragt die App nach einer Bestätigung, bevor sie einen Bericht mit echten Werten schreibt.

Drucken… (Command-P oder Strg-P) öffnet den HTML-Bericht in Ihrem Standardbrowser, dessen Druckdialog ihn druckt oder als PDF speichert. Wenn der Browser ihn nicht öffnen kann, zeigt „Berichtsdatei anzeigen“ den Bericht im Finder oder im Datei-Explorer an.

Lokale Transformation

Normalisierung beider Seiten mit einem Werkzeug, das Sie bereits verwenden

Einige Dateien werden erst vergleichbar, nachdem ein Formatierer auf ihnen ausgeführt wurde. Öffnen Sie „Extras“ und wählen Sie „Lokale Transformation“. Geben Sie das Programm und seine Argumente ein oder wählen Sie eine Voreinstellung: JSON · jq-sortierte Schlüssel, XML · xmllint-Format oder Python · Black stdin. Die Voreinstellungen füllen nur die Felder aus; Das Programm selbst muss bereits installiert sein.

„Trusted Transform ausführen“ fragt nach einer Bestätigung, übergibt dann den Text jeder Seite an das Programm und verwendet seine Ausgabe als neuen linken und rechten Inhalt. Mit „Rückgängig“ wird der ursprüngliche Text wiederhergestellt. Der transformierte Text ist als „Geändert“ gekennzeichnet. Speichern Sie ihn daher nur, wenn Sie möchten, dass die formatierte Version in die Datei geschrieben wird. Es ist keine Shell beteiligt, daher werden Argumente in Leerzeichen aufgeteilt und Pipes oder Variablen funktionieren nicht. Ein Lauf stoppt nach 30 Sekunden, die Eingabe ist auf 20 MB und die Ausgabe auf 32 MB begrenzt und die Ausgabe muss UTF-8-Text sein. Wenn das Programm fehlschlägt, wird seine Fehlermeldung angezeigt.

Berichte, Drucken und lokale Transformation sind Teil von Pro.

Anwenden von Patches

Vorschau und Anwendung eines Patches, den Ihnen jemand gesendet hat

Patch anwenden… liest einheitliche Diffs von diff -u und git diff, einschließlich der neuen, gelöschten, umbenannten und kopierten Dateien von Git, und zeigt sie in der Vorschau einer Datei oder eines Ordners an, bevor etwas geschrieben wird: wo jeder Hunk angewendet wird, mit welchem Offset oder Fuzz oder warum er fehlgeschlagen ist. „Vergleichen“ öffnet eine Datei und ihren gepatchten Text als gewöhnlichen Vergleich.

Die Vorschau ist kostenlos. Bei Pro schreibt „Patch anwenden“ das Ergebnis, nachdem überprüft wurde, dass sich seit der Vorschau keine Datei geändert hat, und „Patch rückgängig machen“ gibt zurück, was der Patch ersetzt hat.

Leser melden

Zuordnung des Berichts zur Person, die ihn erhält

Der HTML-Bericht ist eine einzelne Datei, sodass ein Kunde, Prüfer oder Manager ihn in einem Webbrowser öffnen kann, ohne Diff Anything zu installieren. In der Kopfzeile werden die beiden Quellen, der Vergleichstyp und der Zeitpunkt der Berichtserstellung genannt, sodass ein alter Bericht nicht mit einem neuen verwechselt werden kann.

Der Bericht JSON eignet sich für ein Skript, das die Zählungen überprüft oder die Liste in ein anderes System kopiert. CSV geänderte Zeilen werden in jedem Tabellenkalkulationsprogramm geöffnet, in dem die Spalten „reviewStatus“ und „reviewNote“ sortiert und gefiltert werden können. Der Markdown-Bericht besteht aus reinem Text und kann daher in eine Pull-Anfrage, ein Ticket oder eine Chat-Nachricht eingefügt und so gelesen werden, wie er ist.

Im Workflow

So verwenden Sie es

1. Bereiten Sie die Quellen vor

   Wenn die Formatierung im Weg ist, führen Sie eine lokale Transformation durch, damit beide Seiten dasselbe Layout verwenden.

2. Überprüfen Sie das Ergebnis

   Markieren Sie jeden Unterschied als „Überprüft“ oder „Ignorieren“ und fügen Sie Notizen hinzu, wenn für eine Entscheidung eine Begründung erforderlich ist.

3. Wählen Sie ein Format

   Wählen Sie HTML für Personen, JSON für Tools, Markdown für eine Pull-Anfrage oder die Optionen Patch und CSV, sofern angeboten.

4. Exportieren

   Entscheiden Sie, ob nur überprüfte Elemente einbezogen werden sollen, und wählen Sie dann aus, wo der Bericht gespeichert werden soll.

Nützlich in der Praxis

Wann man es verwenden sollte

Zugehöriges Handbuch

Profile, Regeln, Prüfstatus und Berichte

Aus einem einmaligen Vergleich eine wiederholbare Prüfung machen, mit Ignorierregeln, Notizen und mit Pro gespeicherten Profilen und Berichten.

Direkte Antworten

Fragen zu Berichten und vertrauenswürdigen Präprozessoren.