index.html

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="chrome=1">
    <title>XMLUnit - Unit Testing XML for Java and .NET</title>

    <link rel="stylesheet" href="stylesheets/styles.css">
    <link rel="stylesheet" href="stylesheets/pygment_trac.css">
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <!--[if lt IE 9]>
    <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
    <![endif]-->
  </head>
  <body>
    <div class="wrapper">
      <header>
        <h1>XMLUnit</h1>
        <p>Unit Testing XML for Java and .NET</p>
      </header>
      <section>
        <h3>
          <a id="latest" class="anchor"
             href="#latest-release" aria-hidden="true">
            <span class="octicon octicon-link"></span></a>XMLUnit for
            Java 2.8.4 released on 2021-12-16 and XMLUnit.NET
            2.9.1 released on 2021-12-16</h3>

        <h3>
<a id="about-xmlunit" class="anchor"
   href="#about-xmlunit"
   aria-hidden="true"><span class="octicon octicon-link"></span></a>About XMLUnit</h3>

        <p>When testing XML your application creates, simple string
          comparisons don't cut it as there are many different ways the
          same XML content is serialized to a string.  It doesn't even
          stop with serialization as sometimes you don't care for the
          order of XML elements and sometimes you do.</p>

        <p>XMLUnit provides you with the tools to verify the XML you
          emit is the one you want to create.  It provides helpers to
          validate against an XML Schema, assert the values of XPath
          queries or compare XML documents against expected
          outcomes.</p>
        
        <p>The most important part is a diff-engine that provides you
          with full control over what kind of difference is important
          to you and which part of the generated document to compare
          with which part of your reference document.</p>

        <h4>
          <a id="about-xmlunit2" class="anchor" href="#about-xmlunit2"
             aria-hidden="true"><span class="octicon
             octicon-link"></span></a>About XMLUnit 2.x</h4>

        <p>XMLUnit 2.x is developed for Java and .NET.</p>
        
        <p>XMLUnit 2.x is a complete rewrite and is based on the
        experience of XMLUnit for Java 1.x.  It's main goals are:</p>

        <ul>
          <li>create .NET and Java versions that are compatible in design while
            trying to be idiomatic for each platform</li>
          <li>focus on the parts that are useful for testing:
            <ul>
              <li>XPath</li>
              <li>(Schema) validation</li>
              <li>comparisons</li>
            </ul>
          </li>
          <li>be test framework agnostic (this applies to the Java
            version more than to XMLUnit.NET)</li>
          <li>remove all static configuration (the
            old <code>XMLUnit</code> class setter methods)</li>
        </ul>

        <p>The code has been split into separate git repositories for
          Java and .NET, but both share quite a bit of history.  The
          user's guide is available as
          a <a href="https://github.com/xmlunit/user-guide/wiki">github
          wiki</a>.</p>

        <p>XMLUnit for Java 2.8.4 has been released on 2021-12-16 and XMLUnit.NET 2.9.1 has been released
          on 2021-12-16.</p>

        <ul>
          <li>XMLUnit 2.x is distibuted
            under <a href="https://github.com/xmlunit/xmlunit/blob/main/LICENSE">the
              Apache License Version 2.0</a></li>
          <li><a href="https://github.com/xmlunit/user-guide/wiki">XMLUnit
              2.x user guide</a></li>
          <li><a href="https://github.com/xmlunit/xmlunit/wiki">XMLUnit
              2.x developer guide</a></li>
        </ul>

        <h5>
          <a id="about-xmlunit2-java" class="anchor"
             href="#about-xmlunit2-java"
             aria-hidden="true"><span class="octicon
             octicon-link"></span></a>XMLUnit for Java 2.x</h5>

        <p>XMLUnit for Java also contains a <code>legacy</code> module
          that provides an API compatible to XMLUnit 1.x on top of the
          new API.  The legacy component is distributed using the
          same <a href="https://github.com/xmlunit/xmlunit/blob/main/xmlunit-legacy/LICENSE.txt">three-clause
          BSD license XMLUnit 1.x used</a>.</p>
        
        <ul>
          <li><a href="https://github.com/xmlunit/xmlunit/releases/tag/v2.8.4/">Source
              and Binaries of XMLUnit for Java 2.8.4</a></li>
          <li><a href="api/java/2.8.4/index.html">Javadocs of
              XMLUnit for Java 2.8.4</a></li>
          <li>XMLUnit for Java is available
            from <a href="http://search.maven.org/#search|ga|1|org.xmlunit.xmlunit-core">Maven
            Central <img src="https://maven-badges.herokuapp.com/maven-central/org.xmlunit/xmlunit-core/badge.svg"></a>.</li>
          
          <li><a href="https://github.com/xmlunit/xmlunit">Source Repository</a></li>
          <li>Travis CI build status: <a href="https://travis-ci.com/xmlunit/xmlunit"><img src="https://travis-ci.com/xmlunit/xmlunit.svg?branch=main"></a></li>
          <li><a href="api/java/main/index.html">Javadocs of XMLUnit for
              Java's main branch</a></li>
          <li><code>SNAPSHOT</code> builds are available
            from <a href="https://oss.sonatype.org/content/repositories/snapshots/">Sonatype's
            OSS Nexus</a>, we use
            the <a href="https://oss.sonatype.org/content/repositories/snapshots/org/xmlunit/">the <code>org.xmlunit</code>
            groupId</a></li>
        </ul>

        <h5>
          <a id="about-xmlunit2-net" class="anchor"
             href="#about-xmlunit2-net"
             aria-hidden="true"><span class="octicon
             octicon-link"></span></a>XMLUnit.NET 2.x</h5>

        <p>XMLUnit.NET doesn't share anything with the old 0.x
          releases.  Snapshot assemblies and nuget packages are
          available from our AppVeyour builds.</p>
        
        <ul>
          <li><a href="https://github.com/xmlunit/xmlunit.net/releases/tag/v2.9.1/">Source
              and Binaries of XMLUnit.NET 2.9.1</a></li>
          <li><a href="api/net/2.9.1/index.html">API docs of
              XMLUnit.NET 2.9.1</a></li>
          <li>XMLUnit.NET is available
            from nuget <a href="https://www.nuget.org/packages/XMLUnit.Core/">XMLUnit.Core
            <img src="https://img.shields.io/nuget/v/XMLUnit.Core.svg"></a>.
            The constraint as well as the experimental placeholders
            library are available as separate nuget
            packages <a href="https://www.nuget.org/packages/XMLUnit.NUnit2.Constraints/">XMLUnit.NUnit2.Constraints
            <img src="https://img.shields.io/nuget/v/XMLUnit.NUnit2.Constraints.svg"></a>,
            <a href="https://www.nuget.org/packages/XMLUnit.NUnit3.Constraints/">XMLUnit.NUnit3.Constraints
              <img src="https://img.shields.io/nuget/v/XMLUnit.NUnit3.Constraints.svg"></a>
            and <a href="https://www.nuget.org/packages/XMLUnit.Placeholders/">XMLUnit.Placeholders
            <img src="https://img.shields.io/nuget/v/XMLUnit.Placeholders.svg"></a></li>
          
          <li><a href="https://github.com/xmlunit/xmlunit.net">Source Repository</a></li>
          <li>Travis CI build status (Mono): <a href="https://travis-ci.com/xmlunit/xmlunit.net"><img src="https://travis-ci.com/xmlunit/xmlunit.net.svg?branch=main"></a></li>
          <li>AppVeyor CI build status (Windows): <a href="https://ci.appveyor.com/project/bodewig/xmlunit-net"><img src="https://ci.appveyor.com/api/projects/status/am34dfbr4vbcarr3?svg=true"></a></li>
          <li><a href="api/net/main/index.html">API docs of
              XMLUnit.NET's main branch</a></li>
        </ul>
        
        <h4>
          <a id="about-xmlunit1" class="anchor"
             href="#about-xmlunit1"
             aria-hidden="true"><span class="octicon octicon-link"></span></a>XMLUnit 1.x</h4>

        <p>XMLUnit for Java 1.x still has its home at <a href="http://sourceforge.net/p/xmlunit">sourceforge</a>, if you want to report bugs, please use the issue tracker <a href="http://sourceforge.net/p/xmlunit/bugs/?source=navbar">over there</a> - any feature request should go against the 2.x version here.</p>

        <ul>
          <li><a href="http://sourceforge.net/projects/xmlunit/files/xmlunit%20for%20Java/XMLUnit%20for%20Java%201.6/">Source
              and Binaries of XMLUnit 1.6</a></li>
          <li><a href="http://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/">Source Repository</a></li>
          <li>XMLUnit 1.x user
              guide: <a href="http://xmlunit.sourceforge.net/userguide/html/index.html">HTML</a>
              / <a href="http://xmlunit.sourceforge.net/userguide/XMLUnit-Java.pdf">PDF</a></li>
          <li><a href="http://xmlunit.sourceforge.net/api/index.html">Javadocs
              of XMLUnit for Java 1.6</a></li>
          <li><a href="http://sourceforge.net/projects/xmlunit/files/xmlunit%20for%20.Net/XMLUnit%20for%20.NET%200.4/">Source
              and Binaries of XMLUnit.NET 0.4</a></li>
        </ul>

        <h3>
          <a id="contributing" class="anchor"
             href="#contributing"
             aria-hidden="true"><span class="octicon octicon-link"></span></a>Contributing</h3>

        <p>We need your help!</p>

        <p>Some ideas are
          outlined <a href="https://github.com/xmlunit/xmlunit/blob/main/HELP_WANTED.md">here</a>.
          Contributions of tests, documentation and code are more than
          welcome.  Please
          see <a href="https://github.com/xmlunit/xmlunit/blob/main/CONTRIBUTING.md">our
          contributing page</a> for details.  In short, we like pull
          requests, please use github's infrastructure for XMLUnit 2.x
          and Sourceforge's infrastructure for XMLUnit 1.x.</p>

        <p>The future of XMLUnit is discussed on
          the <code>xmlunit-general</code> mailing list hosted at <a href="http://sourceforge.net/p/xmlunit/mailman/?source=navbar">Sourceforge</a></p>

      </section>
      <footer>
        <p class="view"><a href="https://github.com/xmlunit">View XMLUnit's github Profile</a></p>
        <p><small>Hosted on GitHub Pages &mdash; Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
      </footer>
    </div>
    <script src="javascripts/scale.fix.js"></script>
    
  </body>
</html>