-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.html
216 lines (187 loc) · 10.4 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
<!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.10.0 released on 2024-04-28 and XMLUnit.NET
2.10.0 released on 2024-08-08</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.10.0 has been released on 2024-04-28 and XMLUnit.NET 2.10.0 has been released
on 2024-08-08.</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.10.0/">Source
and Binaries of XMLUnit for Java 2.10.0</a></li>
<li><a href="api/java/2.10.0/index.html">Javadocs of
XMLUnit for Java 2.10.0</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.10.0/">Source
and Binaries of XMLUnit.NET 2.10.0</a></li>
<li><a href="api/net/2.10.0/index.html">API docs of
XMLUnit.NET 2.10.0</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 is no longer maintained, the old home
has
been <a href="http://sourceforge.net/p/xmlunit">sourceforge</a>.
If you want to report bugs, please use the github issue
tracker but most likely things will only get fixed in the
legacy mdule of XMLUnit 2.x. 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.</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 — Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
</footer>
</div>
<script src="javascripts/scale.fix.js"></script>
</body>
</html>