Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kinbiko/jsonassert
A Go test assertion library for verifying that two representations of JSON are semantically equal
https://github.com/kinbiko/jsonassert
assertion-library assertions go golang hacktoberfest json json-payload testing
Last synced: 3 months ago
JSON representation
A Go test assertion library for verifying that two representations of JSON are semantically equal
- Host: GitHub
- URL: https://github.com/kinbiko/jsonassert
- Owner: kinbiko
- License: mit
- Created: 2018-10-26T20:31:01.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-03-04T11:35:43.000Z (10 months ago)
- Last Synced: 2024-07-31T20:53:00.063Z (5 months ago)
- Topics: assertion-library, assertions, go, golang, hacktoberfest, json, json-payload, testing
- Language: Go
- Homepage:
- Size: 244 KB
- Stars: 122
- Watchers: 3
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-go - jsonassert - Package for verifying that your JSON payloads are serialized correctly. (Testing / Testing Frameworks)
- awesome-golang-repositories - jsonassert
- awesome-go-extra - jsonassert - 10-26T20:31:01Z|2022-08-21T06:37:52Z| (Testing / Testing Frameworks)
README
[](https://github.com/avelino/awesome-go)
[](https://github.com/kinbiko/jsonassert/actions)
[](https://goreportcard.com/report/github.com/kinbiko/jsonassert)
[](https://coveralls.io/github/kinbiko/jsonassert)
[](https://github.com/kinbiko/jsonassert/releases)
[](https://pkg.go.dev/github.com/kinbiko/jsonassert)
[](https://github.com/kinbiko/jsonassert/blob/master/LICENSE)
It's difficult to confirm that a JSON payload, e.g. a HTTP request or response body, does indeed look the way you want using the built-in Go testing package.
`jsonassert` is an easy-to-use Go test assertion library for verifying that two representations of JSON are semantically equal.
## Usage
Create a new `*jsonassert.Asserter` in your test and use this to make assertions against your JSON payloads:
```go
func TestWhatever(t *testing.T) {
ja := jsonassert.New(t)
// find some sort of payload
name := "River Tam"
age := 16
ja.Assertf(payload, `
{
"name": "%s",
"age": %d,
"averageTestScore": "%s",
"skills": [
{ "name": "martial arts", "level": 99 },
{ "name": "intelligence", "level": 100 },
{ "name": "mental fortitude", "level": 4 }
]
}`, name, age, "99%")
}
```
You may pass in `fmt.Sprintf` arguments after the expected JSON structure.
This feature may be useful for the case when you already have variables in your test with the expected data or when your expected JSON contains a `%` character which could be misinterpreted as a format directive.
`ja.Assertf()` supports assertions against **strings only**.
### Check for presence only
Some properties of a JSON payload may be difficult to know in advance.
E.g. timestamps, UUIDs, or other randomly assigned values.
For these types of values, place the string `"<>"` as the expected value, and `jsonassert` will only verify that this key exists (i.e. the actual JSON has the expected key, and its value is not `null`), but this does not check its value.
For example:
```go
func TestWhatever(t *testing.T) {
ja := jsonassert.New(t)
ja.Assertf(`
{
"time": "2019-01-28T21:19:42",
"uuid": "94ae1a31-63b2-4a55-a478-47764b60c56b"
}`, `
{
"time": "<>",
"uuid": "<>"
}`)
}
```
The above will pass your test, but:
```go
func TestWhatever(t *testing.T) {
ja := jsonassert.New(t)
ja.Assertf(`
{
"date": "2019-01-28T21:19:42",
"uuid": null
}`, `
{
"time": "<>",
"uuid": "<>"
}`)
}
```
The above will fail your tests because the `time` key was not present in the actual JSON, and the `uuid` was `null`.
### Ignore ordering in arrays
If your JSON payload contains an array with elements whose ordering is not deterministic, then you can use the `"<>"` directive as the first element of the array in question:
```go
func TestUnorderedArray(t *testing.T) {
ja := jsonassert.New(t)
payload := `["bar", "foo", "baz"]`
ja.Assertf(payload, `["foo", "bar", "baz"]`) // Order matters, will fail your test.
ja.Assertf(payload, `["<>", "foo", "bar", "baz"]`) // Order agnostic, will pass your test.
}
```
## Docs
You can find the [GoDocs for this package here](https://pkg.go.dev/github.com/kinbiko/jsonassert).
## Contributing
Contributions are welcome. Please read the [contribution guidelines](./.github/CONTRIBUTING.md) and discuss feature requests in an issue before opening a PR.