Répertoires
Concernant les répertoires, vous pouvez consulter le résultat de comparaison dans un format de texte ou XML, en configurant l'option --output-mode=text, ou --output-mode=xml, respectivement. L'option --output-mode vous permet de spécifier le format du rapport de comparaison (texte ou XML), alors que l'option --output-file vous permet de spécifier le nom du fichier de rapport.
L'option --output-mode=text n'est pas prise en charge si les répertoires comparés contiennent des fichiers XML, et si --dir-compare-contents=true. Le résultat de la comparaison des fichiers XML peut uniquement être rapporté en format XML. |
Pour comprendre comment DiffDog Server rapporte des différences entre les répertoires, imaginons que les deux répertoires suivants doivent être comparés côte à côte.
dir1/ |-- documents/ |-- Don Quixote.txt |-- Metamorphosis.txt | dir2/ |-- Don Quixote.txt |-- img1.png |-- Metamorphosis.txt |
dir1 | dir2 |
Lors d'une comparaison avec un outil de différenciation graphique comme DiffDog (en utilisant le mode de comparaison rapide), les différences entre les deux répertoires sont représentées comme ci-dessous. Comme vous pouvez le voir, le sous-répertoire documents a été supprimé et le fichier img1.png a été ajouté dans le répertoire de droite. De même, le fichier Metamorphosis.txt présente une heure de modification différente.
Rapport de comparaison DiffDog
Dans DiffDog Server, vous pouvez exécuter une comparaison rapide entre ces deux répertoires avec la commande :
<exec> diff dir1 dir2 --output-mode=text --output-file=report.txt --dir-compare-sizes=true --dir-compare-mod-times=true |
| Note : | La comparaison ci-dessus est considérée "rapide" parce qu'aucun contenu de répertoire n'a été comparé, seule la taille et la date de modification des fichiers contenus dans les deux répertoires. Pour effectuer une comparaison en profondeur , incluant le contenu du fichier, ajouter l'option --dir-compare-contents=true. |
Dans le rapport de texte produit après l'exécution de la comparaison, les différences sont rapportées comme suit :
< documents/ ! Metamorphosis.txt > img1.png |
Rapport de comparaison DiffDogServer (texte)
Le caractère "<" indique le côté gauche de la comparaison, alors que le caractère ">" indique le côté droit. La barre oblique inclinée vers l'avant à la fin de la ligne indique un répertoire (par rapport à un fichier). Le caractère "!" indique des différences dans le fichier correspondant.
Comme c'est le cas avec des rapports de fichier, l'information ci-dessus doit être interprétée comme des instructions à suivre pour rendre les deux répertoires égaux. Dans cet exemple, les instructions doivent être interprétées comme suit :
1.Ajouter le sous-répertoire documents dans le répertoire de "gauche"
2.Copier le fichier Metamorphosis.txt du répertoire de gauche au répertoire de droite ou inversement.
3.Ajouter le fichier img1.png au répertoire de "droite".
| Note : | Le verbe "add" doit être transformé en "delete" selon la direction de la fusion intentionnée. Dans cet exemple, pour fusionner des modifications de gauche à droite, la première instruction est "add" et la seconde est "delete". Si la direction de fusion est de droite à gauche, la première instruction est "delete" et la seconde est "add". |
Rapport XML
Nous allons à présent exécuter la même comparaison, et ne modifierons que le format du fichier de rapport de texte à XML. Autrement dit, la commande de différenciation est devenue :
<exec> diff dir1 dir2 --output-mode=xml --output-file=report.xml --dir-compare-sizes=true --dir-compare-mod-times=true |
Dans le rapport XML produit après avoir exécuté la comparaison, les différences sont rapportées comme suit :
<?xml version="1.0" encoding="UTF-8"?> |
Rapport de comparaison DiffDog Server (XML)
L'élément diff_info fournit des informations concernant les répertoires qui ont été comparés (y compris le mode de comparaison utilisé, et le chemin des fichiers comparés). Cet élément ne se produit qu'une seule fois.
Dans les rapports de comparaison de répertoire, l'élément file_diff ne se produit qu'une seule fois. Il peut avoir plusieurs occurrences d'un des éléments enfants suivants : left_content, changed_content, et right_content. Ce sont les équivalents de "<", ">", et "!" dans les rapports de texte et ils ont la même signification qu'au-dessus.