We’re excited to announce the availability of JSONassertify v0.0.2, released on September 28, 2024. This release marks a significant milestone in the project’s journey from an initial experimental release to a well-documented, production-ready testing library for Java developers.

What’s New

While v0.0.2 doesn’t introduce new API features or functionality changes to the core library, it delivers substantial improvements that make JSONassertify easier to adopt, use, and trust:

Comprehensive Documentation
For the first time, JSONassertify ships with complete documentation including a cookbook with practical assertion patterns and detailed examples showing how to replace verbose test code with concise JSON strings. The new “Just the Docs” static site provides a clean, navigable documentation experience.

Official Project Status
The “work in progress” disclaimer has been removed. JSONassertify is now officially active and production-ready, signaling confidence in the library’s stability and API for testing REST interfaces and JSON output in unit tests.

Modernized Dependencies
This release updates key dependencies to their latest versions:

  • JUnit 5 (5.10.2 → 5.11.1) for improved test support
  • Hamcrest (2.2 → 3.0) for enhanced assertion matchers
  • Maven plugins for better build performance and reliability

Reliable Release Pipeline
A new GitHub Actions workflow automates publishing to Maven Central with build provenance attestations, ensuring every release is reproducible and its origins verifiable for supply chain security.

Why It Matters

For teams adopting JSONassertify to simplify their JSON testing workflows, v0.0.2 removes the friction of onboarding. The new documentation means developers can quickly learn how to write cleaner tests without searching through sparse README files or inferring usage from scattered examples.

The removal of the work-in-progress status is more than cosmetic—it signals that the library’s core API has stabilized and teams can depend on JSONassertify for long-term maintenance without fear of breaking changes.

The dependency updates ensure your test suite benefits from the latest security patches and improvements in JUnit 5 and Hamcrest, while the automated release pipeline means future versions will arrive more reliably and consistently.

Upgrade Instructions

Upgrading to v0.0.2 is straightforward for existing v0.0.1 users—no code changes are required since the library API remains unchanged. Simply update your Maven dependency:

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

Note: If your project has direct dependencies on Hamcrest, review the Hamcrest 3.0 migration guide as this release upgrades from version 2.2. Most users will not experience issues since JSONassertify’s API is unchanged.

For teams migrating from the original JSONassert (skyscreamer), the upgrade path remains the same—swap the groupId and artifactId and update your imports from org.skyscreamer.jsonassert.JSONAssert to com.unitvectory.jsonassertify.JSONAssert.

Get Started

Explore the new documentation at the JSONassertify docs to see how you can cut your JSON test code in half while improving readability. Download v0.0.2 from Maven Central or check out the source on GitHub.

This release announcement was AI-generated using the unsloth/Qwen3.5-122B-A10B-GGUF:Q4_K_M model. The original release v0.0.2 was published on September 28, 2024. This post was generated by release-storyteller.