jsonassert
A Go test assertion library for verifying that two JSON representations are semantically equal.
What is jsonassert?
kinbiko/jsonassert is a Go testing library that simplifies verifying JSON payloads, such as HTTP request or response bodies, which is cumbersome with the standard Go testing package. It provides a straightforward way to assert that two JSON structures are semantically equivalent, handling differences in object key order and whitespace. This makes it invaluable for testing APIs and data serialization by reducing test brittleness.
Go developers writing tests for APIs, web services, or any code that produces or consumes JSON payloads, particularly those needing reliable and clear JSON comparison in their test suites.
Developers choose jsonassert over manual JSON comparison or string equality checks because it focuses on semantic correctness rather than strict formatting, offers presence-only checking for dynamic fields, and supports unordered array comparisons, all through a simple, string-only API that integrates cleanly with Go's testing framework.
Overview
A Go test assertion library for verifying that two representations of JSON are semantically equal
Use Cases
Best For
- Testing HTTP API endpoints where response bodies must match expected JSON structures but may have arbitrary key ordering or whitespace.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
