https://github.com/zendesk/jazon
Test assertions on JSONs have never been easier
https://github.com/zendesk/jazon
Last synced: about 1 year ago
JSON representation
Test assertions on JSONs have never been easier
- Host: GitHub
- URL: https://github.com/zendesk/jazon
- Owner: zendesk
- License: apache-2.0
- Created: 2017-10-12T08:56:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-09T12:52:54.000Z (over 1 year ago)
- Last Synced: 2025-03-25T16:51:41.489Z (over 1 year ago)
- Language: Java
- Homepage:
- Size: 303 KB
- Stars: 22
- Watchers: 275
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Jazon
A library for test assertions on JSON payloads.
Supports Spock and JUnit. Easy to extend for other test frameworks and languages.
## About
Jazon was created to make writing tests on JSON APIs easy. It offers:
* Simple exact-match assertions on JSON
* Matching unordered JSON arrays (ability to ignore the items order)
* User-defined wildcard assertions, e.g.
* Match string to a regex
* Match number to a range
* Match datetime to some specific format
* Verify that float has only 2 decimal points
* Verify that list has only 25 items
* ... anything you need
* Human-readable error messages for fast mismatch tracing
* Optimised to minimise code duplication
## Using Jazon in your project
Jazon is provided as separate libraries (so called adapters) for each supported testing framework.
Depending on the framework you use, pick the adapter library that is applicable for you.
### Spock
[User guide for Spock Adapter](jazon-spock/README.md#Quickstart)
##### Gradle:
```groovy
dependencies {
testCompile 'com.zendesk.jazon:jazon-spock:0.4.1'
}
```
##### Maven:
```xml
com.zendesk.jazon
jazon-spock
0.4.1
test
```
### JUnit:
[User guide for JUnit Adapter](jazon-junit/README.md#Quickstart)
##### Gradle:
```groovy
dependencies {
testCompile 'com.zendesk.jazon:jazon-junit:0.4.1'
}
```
##### Maven:
```xml
com.zendesk.jazon
jazon-junit
0.4.1
test
```
## Copyright and license
Copyright 2019 Zendesk, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.