Fuego Diff -- A structural XML diff and patch library
Fuego Diff is a tool and library for calculating the differences between two
XML documents (a bit like the
diff tool does for text files), and for
applying edits to a document (like the
patch tool). It can thus be used e.g.
for three-way merging between documents modified by different people.
- Structural diff based on XML semantics (attribute order does not matter, child element order does matter)
- Detects movement of subtrees from one part of the document to another
- Supports Unicode and XML Namespaces
- Implemented in pure Java
This library was originally developed at the Helsinki Open Source Laboratory (HOSLAB) at the University of Helsinki, under the name Fuego Core XML Diff and Patch Tool. The project was forked by Martin Kleppmann in February 2009, to continue development under the new name Fuego Diff. The underlying algorithms have been described in T. Lindholm, J. Kangasharju, and S. Tarkoma: Fast and Simple XML Tree Differencing by Sequence Alignment, Proceedings of ACM DocEng 2006 (official version of the paper at acm.org).
Fuego Diff is currently available only in source form. You can download the source from GitHub:
...or you can clone the git repository by typing:
git clone git://github.com/ept/fuego-diff.git
Next, go into the directory and download the project's dependencies by typing:
ant -f project-setup.xml
Then you can build the project simply by typing:
You can see it in operation by giving it two XML files,
file2.xml for example, and writing the diff to a file called
ant -Dbase=file1.xml -Dnew=file2.xml -Ddiff=diff.xml diff
And to apply the patch
file1.xml, writing the result to
new.xml, try this:
ant -Dbase=file1.xml -Ddiff=diff.xml -Dnew=new.xml patch
Fuego Diff is currently being refactored significantly, and the patch format or behaviour may change at any time. Feel free to use it and send me comments, bug reports, patches or pull requests. However I wouldn't recommend putting it to production use just yet. Hopefully soon.
You can contact me by email: martin at eptcomputing dot com.
Copyright 2005--2008 Helsinki Institute for Information Technology.
Copyright 2009 Martin Kleppmann.
Fuego Diff is free software; you can redistribute it and/or modify it under the
terms of the MIT license. See the file
MIT-LICENSE in the source distribution