A Python script for comparing XML files for structural or textual differences.
improve word order in README.md
Added tag 2.4 for changeset 0fbf0ff12899
rename option "-c" to "-P"




xdiff.py is a Python 3 script for comparing XML files. It outputs structural and textual differences -- i.e. differences beyond different attribute orders or different whitespace formatting.

The script is released 'as is' with no warranty under the GNU General Public License, version 2.0.

It requires the following Python 3 packages:

The lxml package internally calls the libxml2 and libxslt C libraries.

On Debian-based systems, the prerequisites can be installed as follows:

sudo apt-get install python3-blessings python3-lxml


xdiff.py [-a] [--all-context]
         [-C] [--force-color]
         [-i] [--indent]
         [-n] [--no-context]
         [-N] [--no-meta]
         [-p] [--pis]
         [-P] [--comments]
         [-q] [--quiet]
         [-w] [--words]
         <XML file 1>
         <XML file 2>

xdiff.py [-v] [--version]

xdiff.py [-h] [--help]

The output of xdiff.py mimics the unified format of GNU diff, with three context lines by default. The -a option outputs all context lines, while the -n option outputs none. The option -N suppresses metadata output (files header and hunk numbers). If the option -i is set, the diff is constructed from indented XML trees. The option -w option compares the content word-wise (one word per line). Processing instructions and comments in the XML files are ignored unless the options -p and -P are used. The -C option preserves color and formatting codes when piping output through GNU less and similar programs.

The -q suppresses output altogether, but still returns the exit status (1 if there are structural or textual differences, 0 if there are none, and 2 for errors).

Andreas Nolda (andreas@nolda.org)