Released on September 28, 2024, JSONassertify v0.0.2 focuses on empowering developers with comprehensive guidance and a more stable foundation. This maintenance release significantly improves the onboarding experience and ensures the library remains secure and up-to-date.

What’s new

The centerpiece of this release is a complete overhaul of the project documentation. We have transitioned from a single index page to a structured documentation suite designed to help you get the most out of the library:

  • The JSONassertify Cookbook: A new, comprehensive guide that dives deep into the nuances of JSON comparison. It provides clear explanations of Strict Mode (where array order and extra fields are enforced) versus Loose Mode (which allows for reordering and ignores unexpected fields), and details the rules for handling complex, nested JSON structures.
  • Dedicated Examples: A new examples page that showcases the library in action and explains how to interpret its intuitive error messages to debug failing tests faster.
  • Modernized Dependencies: We’ve updated core dependencies to keep the project stable and secure, including bumps to junit-jupiter-api (v5.11.1) and hamcrest (v3.0), along with several Maven plugin updates.
  • Formal Identity: The project name has been formally updated to “JSONassertify” within the project metadata to better reflect its identity as a modernized fork of the original JSONassert.

Why it matters

For developers testing REST interfaces, the clarity of JSON assertions is critical. By providing a dedicated Cookbook and expanded examples, we’ve lowered the barrier to entry, making it easier for teams to implement robust tests without guessing how “loose” or “strict” comparisons will behave.

Additionally, the dependency updates ensure that your testing stack remains compatible with the latest versions of JUnit 5 and Hamcrest, reducing technical debt and improving the overall reliability of your build pipeline.

Getting Started and Upgrading

If you are already using JSONassertify, upgrading to v0.0.2 is seamless as there are no breaking changes to the public API. Simply update the version in your pom.xml:

<dependency>
    <groupId>com.unitvectory</groupId>
    <artifactId>jsonassertify</artifactId>
    <version>0.0.2</version>
    <scope>test</scope>
</dependency>

We invite you to explore the new documentation to discover more efficient ways to assert your JSON responses.

This post was AI-generated by release-storyteller using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. Based on the release of JSONassertify v0.0.2 on 2024-09-28.