Guide de cas d’utilisation macOSWindows

Examiner les modifications de configuration sans perdre la structure

Comparez JSON, YAML, TOML, INI, la liste de propriétés, XML et les fichiers d’environnement en tant que données, également dans tous les formats. Les règles sémantiques peuvent ignorer les chemins attendus ou l’ordre du tableau, les enregistrements avec un champ id sont automatiquement appariés, les éléments XML sont appariés par un attribut clé et peuvent ignorer l’ordre des enfants sous les éléments choisis, et les valeurs .env restent masquées avec une option permettant de comparer uniquement la présence de variables.

Le travail à faire

Recherchez le paramètre qui a changé, pas les lignes qui ont bougé.

Les formateurs et les outils de déploiement réécrivent constamment les fichiers de configuration. Un déplacement de clé ou une liste générée apparaît dans un nouvel ordre, et une différence de ligne enterre la seule valeur qui compte : un port différent, un indicateur de fonctionnalité supprimé ou une variable que la production n’a pas encore.

Diff Anything lit JSON, YAML, TOML, INI, les listes de propriétés et XML en tant que données, même lorsque les deux fichiers utilisent des formats différents, et répertorie chaque modification avec son chemin, par exemple $.services.api.port, à côté de l’ancienne et de la nouvelle valeur. Les fichiers d’environnement sont lus en tant que variables nommées dont les valeurs restent masquées jusqu’à ce que vous choisissiez d’en afficher une.

Diff Anything comparant deux fichiers JSON, avec des enregistrements utilisateur correspondant par identifiant et une valeur de rôle modifiée sélectionnée
Le mode sémantique répertorie les chemins et les valeurs modifiés. Ici, une règle de comparaison par identifiant correspond aux enregistrements utilisateur, donc une liste réorganisée affiche uniquement les changements réels. Afficher en taille réelle

Chemin recommandé

Examinez un environnement par rapport à un autre.

Mettez la configuration à laquelle vous faites confiance à gauche, comme le fichier déployé aujourd’hui, et la version proposée à droite.

  1. Ouvrir la paire

    Choisissez deux fichiers JSON, YAML, TOML, INI, liste de propriétés, XML ou .env, ou collez leur contenu. Sélectionne automatiquement le mode à partir du nom et du contenu du fichier, et un fichier JSON à côté d’un fichier TOML ou YAML est comparé par ses données.

  2. Masquer les changements que vous attendez

    En mode JSON, YAML, TOML, INI ou liste de propriétés, ouvrez les règles sémantiques et ajoutez les chemins d’ignorer pour les champs générés tels qu’un horodatage de construction. Les règles recommandées proposent davantage de règles à partir des différences trouvées.

  3. Associer correctement les éléments de la liste

    Les enregistrements avec un identifiant unique, _id, uuid ou un champ clé sont automatiquement associés. Pour les autres, ajoutez une règle Clés de tableau, par exemple $.services = nom, ou répertoriez le chemin sous Chemins de tableau non ordonnés. Les éléments XML sont associés par un attribut clé tel que l’identifiant ou le nom ; ajoutez l’élément parent sous Éléments non ordonnés lorsque l’ordre des frères et sœurs n’a aucune signification.

  4. Vérifier les variables sans les exposer

    Le mode Fichier d’environnement répertorie les variables manquantes, supplémentaires et modifiées avec leurs valeurs masquées. Activez Comparer la présence uniquement lorsque seuls les noms doivent correspondre.

  5. Copiez les corrections que vous approuvez

    Choisissez une différence et copiez-la avec Droite → gauche ou Gauche → droite. Les cibles de liste de propriétés JSON, TOML, INI et XML sont modifiées sur place et conservent leurs commentaires et leur présentation ; Les cibles YAML et XML sont reconstruites à partir des données analysées après une confirmation, qui supprime les commentaires et la mise en page personnalisée.

Capacités impliquées

Trois parties de Diff Anything font le travail ici.

Limites à connaître

Où les règles s’appliquent et où elles s’arrêtent.

Les règles sémantiques, notamment Ignorer les chemins, les clés de tableau et la tolérance numérique, fonctionnent en mode JSON, YAML, TOML, INI et liste de propriétés, y compris des paires de deux formats différents. XML propose des éléments non ordonnés pour la commande enfant et .env propose uniquement la présence de comparaison.

Les valeurs sont comparées telles qu’analysées et les nombres par valeur, donc 1 et 1,0 sont égaux. Les listes sans champ de type identifiant sont mises en correspondance par position, de sorte qu’un élément inséré peut marquer les positions ultérieures comme modifiées ; ajoutez une règle de clés de tableau lorsque les enregistrements ont un autre champ d’identification.

Le masquage couvre la vue de comparaison et les rapports exportés masquent les valeurs d’environnement par défaut. Les instantanés d’historique Pro des fichiers .env conservent les noms de variables avec chaque valeur masquée, et vous pouvez désactiver les instantanés dans Réglages.

Le plan gratuit exécute tous les formats de configuration de l’application avec des résultats complets pour des fichiers jusqu’à 5 Mo chacun et 10 comparaisons par jour. Les profils enregistrés, l’historique, l’exportation de rapports et les exécutions de ligne de commande de tous les modes, à l’exception du texte, JSON et des notebooks, nécessitent Pro.

Manuel associé

Choisir le bon type de comparaison

Choisir les sources, comprendre la détection automatique et prendre le type de comparaison qui répond à votre question.

Ses sections couvrent le début par la question de révision, le choix et le chargement des sources, la façon dont le mode automatique est résolu, la lecture du texte et les résultats structurés, la comparaison des feuilles de calcul entre formats, le choix du diff intelligent ou du diff de ligne pour le code, la navigation et la révision, la résolution d’une fusion à trois voies, la récupération des problèmes de saisie. Utilisez-le lorsque vous êtes prêt à reproduire ce flux de travail avec vos propres données de projet.

Lire le guide

Réponses directes

Questions sur ce cas d’utilisation.

Puis-je ignorer un champ d’horodatage dans un fichier de configuration JSON ?

Oui. Ajoutez son chemin sous Ignorer les chemins dans les règles sémantiques, par exemple $.build.generatedAt, ou terminez un chemin par .* pour laisser de côté tout ce qui se trouve en dessous. Les règles sont gratuites ; les conserver pour la prochaine exécution nécessite un profil Pro.

Les clés réorganisées ou le YAML réindenté apparaîtront-ils en tant que modifications ?

Non. Les deux fichiers sont lus en tant que données, donc l’ordre des touches, l’indentation et les commentaires ne sont pas comparés. Si une liste change uniquement d’ordre, le résultat indique cette réorganisation au lieu d’un changement à chaque position.

Quelqu’un qui regarde mon écran peut-il lire les valeurs secrètes ?

Pas à moins que vous les révéliez. Les variables modifiées sont mises en évidence avec leurs valeurs masquées. Révéler la valeur affiche une valeur à la fois, Révéler tout demande d’abord une confirmation et la modification de l’un ou l’autre fichier masque à nouveau les valeurs révélées.

Puis-je comparer un manifeste YAML avec le JSON à partir duquel il a été généré ?

Oui. Placez le fichier JSON et le fichier YAML sur les côtés opposés ; Auto traite la paire comme des données YAML. Les alias sont remplacés par les valeurs définies par leurs ancres avant que quoi que ce soit ne soit comparé.

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.

Suivant

Explorez davantage de flux de travail Diff Anything.

Retour aux cas d’utilisation