Skip to content

RELEASE_NOTES.md

Latest commit

 

History

History
251 lines (196 loc) · 10.7 KB

RELEASE_NOTES.md

File metadata and controls

251 lines (196 loc) · 10.7 KB

Release Notes

XMLUnit for Java 2.6.3 - /not released, yet/

XMLUnit for Java 2.6.2 - /Released 2018-08-27/

  • xmlunit-assertj can now be used with AssertJ 3.9.1+ as well as 2.9.x. Issue #135.

  • added a new TypeMatcher to the xmlunit-matchers module that can be used to conveniently translate XPath result strings into numbers or booleans and verify they match type safe assertions. Issue #133 via PR #137.

  • fixed the Automatic-Module-Name of all modules to be valid Java identifiers. Issue #136.

XMLUnit for Java 2.6.1 - /Released 2018-08-16/

  • add a new module with AssertJ support. This module requires Java7 at runtime. Issue #117 via PRs #120, #126, #128, and #129 by @krystiankaluzny.

  • The XPathFactory used by the XPath related Hamcrest matchers is now configurable. Issue #131 via PRs #132

XMLUnit for Java 2.6.0 - /Released 2018-04-22/

  • add a new experimental project xmlunit-placeholders which aims to use ${xmlunit.FOO} expressions inside of the control document to allow for a DSL-like approach of defining more complex tests. This initial seed only supports ${xmlunit.ignore} which can be used to make XMLUnit ignore the element containing this text. PR #105 by @zheng-wang.

  • added withDocumentBuilderFactory methods to HasXPathMatcher and EvaluateXPathMatcher to allow explicit configuration of the DocumentBuilderFactory used. Issue #108.

  • the DocmentBuilderFactory and TransformerFactory instances used by XMLUnit are now configured to not load any external DTDs or parse external entities. They are now configured according to the OWASP recommendations for XML eXternal Entity injection preventions. The TransformerFactory used by the org.xmlunit.transform.Transformation class is still configured to load external stylesheets, though.

    For the legacy package XXE prevention has to be enabled via XMLUnit.enableXXEProtection explicitly.

    This is a breaking change and you may need to provide DocmentBuilderFactory or TransformerFactory instances of your own if you need to load external entities.

    The SAXParserFactory and SchemaFactory instances used inside of the validation package have not been changed as their use is likely to require loading of external DTDs or schemas.

    Issue #91.

  • the configured NodeFilter is now applied before comparing DocumentType nodes.

    This change breaks backwards compatibility as the old behavior was to ignore DocumentType when counting the children of the Document node but not when actually comparing the DocumentType. Prior to this change if one document had a document type declaration but the other didn't, a HAS_DOCTYPE_DECLARATION difference was detected, this will no longer be the case now. If you want to detect this difference, you need to use a more lenient NodeFilter than NodeFilters.Default (i.e. NodeFilters.AcceptAll) but then you will see an additional CHILD_NODELIST_LENGTH difference.

    The legacy package has been adapted and will behave as before even when using NewDifferenceEngine.

    Issue #116.

  • added a new Source implementation ElementContentWhitespaceStrippedSource which is similar to WhitespaceStrippedSource but only affects text nodes that solely consist of whitespace and doesn't affect any other text nodes. Also added convenience ignoreElementContentWhitespace methods to DiffBuilder and CompareMatcher. Issue #119.

XMLUnit for Java 2.5.1 - /Released 2017-11-09/

  • Made Travis build work with OpenJDK6 again. PR #101 by @PascalSchumacher.

  • CompareMatcher's describeTo method threw an exception if the comparison yielded no differences. Issue #107.

XMLUnit for Java 2.5.0 - /Released 2017-09-03/

  • CommentLessSource, DiffBuilder#ignoreComments and CompareMatcher#ignoreComments now all use XSLT version 2.0 stylesheets in order to strip comments. New constructors and methods have been added if you need a different version of XSLT (in particular if you need 1.0 which used to be the default up to XMLUnit 2.4.0). Issue #99.

XMLUnit for Java 2.4.0 - /Released 2017-07-23/

  • made DefaultComparisonFormatter more subclass friendly. Issue #93.

XMLUnit for Java 2.3.0 - /Released 2016-11-12/

  • JAXPValidator and ValidationMatcher now accept using Schema instances for the schema when validating instance documents. Issue #89.

  • updated test dependency to Mockito 2.1.0 PR #87 by @PascalSchumacher.

XMLUnit for Java 2.2.1 - /Released 2016-06-19/

  • The DocumentBuilderFactory set on DiffBuilder wasn't used properly when ignoreWhitespace or normalizeWhitespace has been set. Issue #86.

XMLUnit for Java 2.2.0 - /Released 2016-06-04/

  • Input.fromByteArray and Input.fromString now return Sources that can be used multiple times. Issue #84.

  • The DocumentBuilderFactory used by DOMDifferenceEngine is now configurable. Issue #83.

XMLUnit for Java 2.1.1 - /Released 2016-04-09/

  • various code style fixes PR #74, PR #75, PR #78, PR #79, PR #80 by @georgekankava.

  • CompareMatcher and ValidationMatcher threw NullPointerExceptions when combined with another failing Matcher. Issue #81.

XMLUnit for Java 2.1.0 - /Released 2016-03-26/

  • fixed swapped constant assignments in DifferenceEvaluators PR #53 by @cboehme.

  • added CompareMatcher#withNamespaceContext PR #54 by @cboehme.

  • DiffBuilder#withNamespaceContext falsely claimed the map would pass prefixes to URIs rather than the other way around. PR #62 and issue #52 by @mariusneo.

  • various code style fixes PR #64, PR #65, PR #67, PR #68, PR #69, PR #70 and PR #71 by @georgekankava.

  • new hasXPath matchers that check for the existence of an XPath inside of a piece of XML or verify additional assertions on the XPath's stringified result. PR #63 and PR #66 by @mariusneo.

  • added new implementations inside DifferenceEvaluators for common tasks like changing the outcome for specific differences or ignoring changes inside the XML prolog.

  • DiffBuilder.withComparisonFormatter now also fully applies to the Differences contained within the Diff. Issue #55

XMLUnit for Java 2.0.0 - /Released 2016-03-06/

  • implemented DiffBuilder.withComparisonFormatter mentioned in user guide. Issue #51
  • eliminated dead-stores. PR #52 by @georgekankava.

XMLUnit for Java 2.0.0-alpha-04 - /Released 2016-02-06/

  • the schemaURI in Validator has been pushed down to ParsingValidator since it is only used inside this class.
  • the mapping of DifferenceEngine#setNamespaceContext has been inverted from prefix -> URI to URI -> prefix in order to be consistent with the same concept in XPathEngine.
  • CommentLessSource uses an XSLT stylesheet internally which lacked the required version attribute. PR #47 by @phbenisc.
  • Comparison now also contains the XPath of the parent of the compared nodes or attributes which is most useful in cases of missing nodes/attributes because the XPath on one side is null in these cases. Issue #48 implemented via PR #50 by @eguib.

XMLUnit for Java 2.0.0-alpha-03 - /Released 2015-12-13/

  • the xmlunit-parent POM no longer uses the deprecated org.sonatype.oss:oss-parent as its parent.
  • added new overloads to XPathEngine
  • fixed the XPath context used by the byXPath element selector so that "." now refers to the current element. Issue #39
  • ElementSelectors#conditionalBuilder now stops at the first predicate returning true, even if the associated ElementSelector returns false. Issue #40

XMLUnit for Java 2.0.0-alpha-02 - /Released 2015-11-21/

This is the initial alpha release of XMLUnit.NET. We expect the API to change for the next release based on user feedback.