La plupart des tâches de comparaison consistent en une vérification avant un transfert : cette exportation est-elle terminée, cette modification d’API va-t-elle casser un client, cette configuration a-t-elle changé uniquement ce qu’elle devrait ? Diff Anything 1.6 répond directement à davantage de ces questions, sur votre propre Mac ou PC Windows.
Vous pouvez désormais comparer une exportation CSV avec le classeur d’où elle provient, exécuter une vérification de schéma API dans CI qui échoue uniquement en cas de modifications incompatibles (avec Pro sur Windows), utiliser les mêmes règles pour YAML que pour JSON, et changez les couleurs de différence en bleu et jaune. Chaque différence peut également être lue sous forme de liste écrite et gérée depuis le clavier.
Vérifiez le transfert avant qu’il ne s’éteigne
Répondez à la question, pas seulement à la différence.
- Comparez une exportation CSV ou TSV avec la feuille de classeur d’où elle provient
- Avec Pro sur Windows, laissez un travail CI échouer uniquement lorsqu’une modification d’API est susceptible de rompre les clients.
- Lisez les différences de couleurs que vous pouvez distinguer ou sous forme de liste écrite
01 / Vérifier un export par rapport à sa source
Comparez un fichier CSV avec le classeur dont il provient
Un rapport est créé dans Excel, exporté vers CSV et envoyé vers un autre système. Lorsque les chiffres semblent erronés de l’autre côté, la première question est de savoir si l’exportation correspond toujours au classeur. Jusqu’à présent, cela signifiait convertir un fichier avant de pouvoir les comparer.
Dans la version 1.6, ouvrez le fichier CSV ou TSV d’un côté et le classeur Excel, OpenDocument ou Apple Numbers de l’autre. Diff Anything les compare cellule par cellule, en utilisant la première feuille du classeur, sauf si vous en choisissez une autre sous Comparer avec la feuille. Chaque cellule modifiée est répertoriée avec son adresse, vous pouvez donc accéder directement à la ligne qui a changé.
Les valeurs sont comparées au fur et à mesure que le classeur les stocke, donc une différence de formatage telle que 20 dans le classeur et 20,0 dans le CSV est affichée comme un changement. Cela est utile lorsque le système récepteur se soucie du texte exact qu’il reçoit.
Vous comparez deux révisions de classeur ? Suivez l’exemple concret pour comparez deux fichiers Excel et examinez chaque cellule modifiée, y compris les totaux budgétaires et les dates sur une autre feuille.
02 / Arrêter les modifications avant leur expédition
Échec d’une tâche CI uniquement lorsqu’une modification API est susceptible d’interrompre les clients
Diff Anything déjà étiqueté susceptible de rompre les modifications de schéma OpenAPI et JSON avec un code de règle, comme une opération supprimée ou une nouvelle entrée requise. Désormais, le résultat montre également un verdict et un décompte de changements incompatibles, et les schémas identiques ne signalent aucune différence, même lorsque l’un est écrit en JSON et l’autre en YAML.
Avec Pro sous Windows, exécutez la même comparaison dans votre pipeline avec --mode api --fail-on breaking, ou définissez failOn: breaking pour un cas dans un manifeste par lots. Le travail réussit lorsque les modifications sont additives et échoue lorsqu’une modification est rompue ou n’a pas pu être classée. Les rapports JUnit et SARIF répertorient chaque résultat avec son code de règle, de sorte que le journal de construction indique ce qui s’est cassé et où.
Les règles sont heuristiques : elles ne résolvent pas $ref et ne distinguent pas les schémas de demande et de réponse, et certaines modifications incompatibles, comme un paramètre renommé, ne sont pas classées. Utilisez le chèque comme une première porte automatique et gardez un réviseur pour les modifications qu’il laisse passer.
03 / Moins de faux changements
Afficher uniquement les modifications de configuration importantes
YAML a désormais les mêmes règles sémantiques que JSON. Ignorez un champ généré, traitez une liste comme non ordonnée, comparez un chemin sans casse ou autorisez une petite tolérance numérique, et les profils Pro enregistrent ces règles pour la prochaine exécution.
Les listes d’enregistrements avec un champ id, _id, uuid ou key sont désormais automatiquement associées à ce champ, de sorte qu’un enregistrement inséré ne donne plus à chaque enregistrement une apparence modifiée. Les nombres se comparent par valeur, donc 1 et 1,0 sont égaux. Les éléments XML correspondent à un attribut clé tel que l’identifiant ou le nom, et chaque différence possède un emplacement XPath lisible.
Lorsque vous copiez une modification dans un fichier JSON, seule cette valeur est écrite : le fichier conserve ses commentaires, ses virgules de fin et son indentation. La comparaison des réponses HTTP signale désormais une version et une phrase de motif modifiées de HTTP, ainsi que le code d’état.
04 / Révisez d’une manière qui vous convient
Lisez toutes les différences de couleurs que vous pouvez distinguer ou en mots
Si les reflets rouges et verts sont difficiles à distinguer, ouvrez Réglages, choisissez Différence de couleurs, puis Bleu et jaune. Les ajouts deviennent bleus et les suppressions jaunes dans les thèmes clairs et sombres, dans l’éditeur de code, les arborescences structurées, les tableaux, les dossiers et les documents. La mise en place est gratuite ; la fusion à trois voies l’utilise avec Pro. Consultez le guide des couleurs différentielles adaptées aux daltoniens pour connaître les étapes de configuration et la même comparaison dans les deux palettes.
L’espace de travail accessible transforme une comparaison en une seule page ordonnée : les sources, un résumé et chaque différence écrite avec son emplacement, le changement et les valeurs originales et mises à jour. Un champ JSON passant d’Ada à Grace indique « nom : changé d’Ada à Grace ». Parcourez la liste, marquez les éléments examinés, ajoutez des notes et appliquez les modifications dans les comparaisons modifiables prises en charge sans la souris. Ouvrez-le avec Command-Shift-A sur un Mac ou Control-Shift-A sur Windows ; sur un Mac, il s’ouvre tout seul lorsque VoiceOver est en cours d’exécution.
Dans l’espace de travail accessible, les résultats Word, PowerPoint, PDF et les feuilles de calcul décrivent également leurs différences en mots, par page, clause, diapositive ou cellule, et la comparaison Word et PowerPoint lit davantage de formats, notamment DOCM, PPTM, modèles et texte et présentations OpenDocument.
05 / Fiez-vous à ce que vous voyez
Faites confiance au résultat que vous obtenez
Une comparaison que vous annulez est affichée comme annulée, jamais comme identique, avec un bouton pour la relancer. Dans la fusion à trois voies Pro, deux modifications apportées à la même ligne sont combinées uniquement lorsqu’elles touchent des mots distincts ; tout le reste est affiché comme un conflit que vous devez décider, de sorte que le fichier fusionné ne contient jamais de valeur qu’aucune des deux parties n’a écrite.
Lorsque quelque chose ne peut pas être fait, le message indique désormais ce qui n’a pas fonctionné et où, par exemple qu’un fichier est ouvert dans une autre application, et il apparaît au-dessus de toute boîte de dialogue ouverte. Sur Windows, git diff peut utiliser Diff Anything comme pilote de comparaison pour les types de fichiers que vous choisissez, parallèlement à la configuration existante de l’outil de comparaison.
La prochaine exportation, la modification API ou la révision de la configuration sont à quelques clics.