Aperçu des capacités
Comment puis-je utiliser des rapports et des préprocesseurs approuvés dans Diff Anything ?
Pro exporte des rapports HTML qui montrent les comparaisons de texte et de documents côte à côte ou sur une seule colonne, des rapports de dossiers avec chaque fichier texte modifié, des rapports JSON et Markdown, des diffs unifiés et des patchs de dossiers avec les en-têtes de Git, ainsi que des JSON Patch et JSON Merge Patch pour les formats de données. « Imprimer… » ouvre le rapport dans votre navigateur, qui l’imprime ou l’enregistre en PDF. « Appliquer un patch… » montre d’abord, section par section, comment un diff unifié s’applique ; avec Pro, vous l’appliquez et pouvez l’annuler.
La transformation locale exécute un programme installé sur l’ordinateur, tel que jq, xmllint ou Black. L’application n’inclut pas ces programmes. La version Mac App Store s’exécute dans App Sandbox d’Apple, ce qui la limite aux fichiers et dossiers que vous choisissez dans l’application. La transformation locale est donc décrite pour la version Microsoft Store sur Windows.
Formats de rapport
Choisir un rapport pour la personne qui le lira
Cliquez sur Exporter dans la barre d’outils et choisissez un format de rapport. Le bouton est disponible une fois qu’une comparaison présente au moins une différence, et rien n’est écrit jusqu’à ce que vous choisissiez un endroit avec Choisir l’emplacement d’enregistrement….
- Tableau des différences HTML : un fichier avec ses styles inclus, avec les décomptes récapitulatifs et un tableau avec chaque emplacement, type, les deux valeurs, description et état de révision.
- Rapport JSON : le même contenu pour les scripts et autres outils.
- Rapport de révision Markdown : texte qui se lit bien dans une demande d’extraction, un ticket ou une page wiki.
- HTML autonome d’une comparaison de texte ou de document : les deux fichiers côte à côte, ou entrelacés comme une différence unifiée, avec des numéros de ligne, des mots modifiés marqués et des lignes inchangées réduites autour de chaque modification ou de l’ensemble des fichiers affichés. Un rapport de dossier peut intégrer la comparaison côte à côte de chaque fichier texte modifié.
- Diff de texte unifié : un patch standard de deux textes ou documents, ou d’une comparaison de dossier avec les en-têtes de Git, que git apply ou Apply patch… peut appliquer au dossier de gauche.
- Correctif JSON (RFC 6902) et correctif de fusion JSON (RFC 7386) : proposé pour les comparaisons de listes de propriétés JSON, YAML, TOML, INI ; Copier en tant que patch JSON dans la palette de commandes place le patch dans le presse-papiers.
- Lignes modifiées CSV : une liste conviviale pour les feuilles de calcul avec des colonnes d’état de révision et de notes, proposée pour les comparaisons CSV.
Ce qui entre
Contrôler le contenu d’un rapport
Inclure uniquement les différences marquées comme révisées limite le rapport aux éléments que vous avez approuvés, ce qui transforme une longue comparaison en une courte liste d’approbation. L’état de l’examen et les notes font partie de chaque rapport, de sorte que la raison de chaque décision l’accompagne.
Pour les fichiers d’environnement, l’option Réduire les valeurs d’environnement est activée par défaut. Si vous la désactivez, l’application demande une confirmation avant d’écrire un rapport contenant des valeurs réelles.
Imprimer… (Command-P ou Control-P) ouvre le rapport HTML dans votre navigateur par défaut, dont la boîte de dialogue d’impression l’imprime ou l’enregistre sous le nom de PDF. Si le navigateur ne peut pas l’ouvrir, Afficher le fichier de rapport affiche le rapport dans Finder ou dans l’Explorateur de fichiers.
Transformation locale
Normaliser les deux côtés avec un outil que vous utilisez déjà
Certains fichiers ne deviennent comparables qu’après l’exécution d’un formateur. Ouvrez Outils et choisissez Transformation locale. Entrez le programme et ses arguments, ou choisissez un préréglage : JSON · Clés triées jq, XML · Format xmllint ou Python · Stdin noir. Les préréglages remplissent uniquement les champs ; le programme lui-même doit déjà être installé.
Exécuter la transformation sécurisée demande une confirmation, puis transmet le texte de chaque côté au programme et utilise sa sortie comme nouveau contenu gauche et droit. Annuler ramène le texte original. Le texte transformé est marqué Modifié, alors enregistrez-le uniquement si vous souhaitez que la version formatée soit écrite dans le fichier. Aucun shell n’est impliqué, donc les arguments sont divisés en espaces et les tuyaux ou variables ne fonctionnent pas. Une exécution s’arrête après 30 secondes, l’entrée est limitée à 20 Mo et la sortie à 32 Mo, et la sortie doit être du texte UTF-8. Si le programme échoue, son message d’erreur s’affiche.
Les rapports, l’impression et la transformation locale font partie de Pro.
Application de correctifs
Prévisualisation et application d’un correctif que quelqu’un vous a envoyé
Apply patch… lit les différences unifiées de diff -u et git diff, y compris les fichiers nouveaux, supprimés, renommés et copiés de Git, et les prévisualise par rapport à un fichier ou un dossier avant que quoi que ce soit ne soit écrit : où chaque morceau s’applique, avec quel décalage ou fuzz, ou pourquoi il a échoué. Compare ouvre un fichier et son texte corrigé comme une comparaison ordinaire.
La prévisualisation est gratuite. Avec Pro, Apply patch écrit le résultat, après avoir vérifié qu’aucun fichier n’a changé depuis l’aperçu, et Undo patch restitue ce que le patch a remplacé.
Lecteurs de rapports
Faire correspondre le rapport à la personne qui le reçoit
Le rapport HTML est un fichier unique, donc un client, un auditeur ou un responsable peut l’ouvrir dans un navigateur Web sans installer Diff Anything. Son en-tête indique les deux sources, le type de comparaison et la date de génération du rapport, ce qui évite qu’un ancien rapport ne soit confondu avec un nouveau.
Le rapport JSON convient à un script qui vérifie les décomptes ou copie la liste dans un autre système. Les lignes modifiées CSV s’ouvrent dans n’importe quel tableur, où les colonnes reviewStatus et reviewNote peuvent être triées et filtrées. Le rapport Markdown est en texte brut, il peut donc être collé dans une demande d’extraction, un ticket ou un message de discussion et lu tel quel.
Dans le workflow
Comment l’utiliser
Préparer les sources
Si le formatage vous gêne, exécutez une transformation locale afin que les deux côtés utilisent la même mise en page.
Vérifier le résultat
Marquez chaque différence Révisée ou Ignorée et ajoutez des notes lorsqu’une décision nécessite une raison.
Choisissez un format
Choisissez HTML pour les personnes, JSON pour les outils, Markdown pour une demande d’extraction ou les options de correctif et CSV lorsqu’elles sont proposées.
Exporter
Décidez si vous souhaitez inclure uniquement les éléments révisés, puis choisissez où enregistrer le rapport.
Utile en pratique
Quand l’utiliser
Manuel associé
Profils, règles, statut d’examen et rapports
Faire d’une comparaison ponctuelle un examen reproductible, avec des règles d’exclusion, des notes et, avec Pro, des profils enregistrés et des rapports exportés.
Lire le guideRéponses directes
Questions sur les rapports et les préprocesseurs de confiance.
Quel format de rapport dois-je joindre à une demande d’extraction ?
Rapport d’examen des démarques. Il s’intègre proprement dans la plupart des outils de révision de code et inclut l’état de révision et les notes.
Puis-je envoyer une comparaison .env sans divulguer de secrets ?
Oui. La rédaction des valeurs d’environnement est activée par défaut pour les fichiers d’environnement et sa désactivation nécessite une confirmation.
Pourquoi mes arguments cités ne fonctionnent-ils pas dans la transformation locale ?
Le programme est démarré directement sans shell, et les arguments sont répartis sur des espaces. Utilisez des arguments sans guillemets ni syntaxe shell.
L’application inclut-elle jq, xmllint ou Black ?
Non. Les préréglages remplissent la commande pour vous, mais le programme doit être installé sur votre ordinateur.
Gratuit & Pro : ce qui est inclus
Disponible sur le Mac App Store et le Microsoft Store. L’utilisation de la version gratuite de l’app vous permet d’essayer tous les moteurs de comparaison pour des fichiers jusqu’à 5 Mo par côté et 10 nouvelles sessions de comparaison par jour local ; les aperçus de collection affichent les 100 premiers éléments, les comparaisons binaires les 100 premiers octets de différences et les aperçus PDF des 3 premières pages. La comparaison du texte brut, des notebooks JSON et Jupyter est complète et l’ouverture de fichiers à partir du Finder ou de l’Explorateur de fichiers, des liens diffanything:// et AppleScript est gratuite. La CLI gratuite prend en charge le texte, JSON et les notebooks. Un achat Pro unique supprime les limites d’aperçu et de session et déverrouille des sources plus volumineuses dans les limites techniques, les profils et l’historique enregistrés, l’enregistrement des instantanés de dossiers, l’exportation et l’impression de rapports, l’exportation de correctifs JSON, l’application de correctifs, la fusion à trois voies et la résolution des conflits, le pilote de fusion et l’outil de fusion Git, la synchronisation des dossiers, les manifestes par lots, les préprocesseurs de confiance et chaque mode CLI.