https://github.com/stranger6667/jsonschema
A high-performance JSON Schema validator for Rust
https://github.com/stranger6667/jsonschema
jsonschema python rust validation webassembly
Last synced: 5 days ago
JSON representation
A high-performance JSON Schema validator for Rust
- Host: GitHub
- URL: https://github.com/stranger6667/jsonschema
- Owner: Stranger6667
- License: mit
- Created: 2020-03-07T10:35:43.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-08-14T04:25:52.000Z (5 months ago)
- Last Synced: 2025-08-19T09:57:57.570Z (5 months ago)
- Topics: jsonschema, python, rust, validation, webassembly
- Language: Rust
- Homepage: https://docs.rs/jsonschema
- Size: 4.86 MB
- Stars: 661
- Watchers: 9
- Forks: 109
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# jsonschema
[
](https://crates.io/crates/jsonschema)
[
](https://docs.rs/jsonschema)
[
](https://github.com/Stranger6667/jsonschema/actions?query=branch%3Amaster)
[
](https://app.codecov.io/github/Stranger6667/jsonschema)
[
](https://bowtie.report/#/implementations/rust-jsonschema)
A high-performance JSON Schema validator for Rust.
```rust
use serde_json::json;
fn main() -> Result<(), Box> {
let schema = json!({"maxLength": 5});
let instance = json!("foo");
// One-off validation
assert!(jsonschema::is_valid(&schema, &instance));
assert!(jsonschema::validate(&schema, &instance).is_ok());
// Build & reuse (faster)
let validator = jsonschema::validator_for(&schema)?;
// Fail on first error
assert!(validator.validate(&instance).is_ok());
// Iterate over errors
for error in validator.iter_errors(&instance) {
eprintln!("Error: {error}");
eprintln!("Location: {}", error.instance_path);
}
// Boolean result
assert!(validator.is_valid(&instance));
Ok(())
}
```
You also can use it from the command line via the [jsonschema-cli](https://github.com/Stranger6667/jsonschema/tree/master/crates/jsonschema-cli) crate.
```console
$ jsonschema-cli schema.json -i instance.json
```
See more usage examples in the [documentation](https://docs.rs/jsonschema).
> ⚠️ **Upgrading from older versions?** Check our [Migration Guide](https://github.com/Stranger6667/jsonschema/blob/master/MIGRATION.md) for key changes.
## Highlights
- 📚 Full support for popular JSON Schema drafts
- 🔧 Custom keywords and format validators
- 🌐 Blocking & non-blocking remote reference fetching (network/file)
- 🎨 `Basic` output style as per JSON Schema spec
- ✨ Meta-schema validation for schema documents
- 🔗 Bindings for [Python](https://github.com/Stranger6667/jsonschema/tree/master/crates/jsonschema-py)
- 🚀 WebAssembly support
- 💻 Command Line Interface
### Supported drafts
The following drafts are supported:
- [](https://bowtie.report/#/implementations/rust-jsonschema)
- [](https://bowtie.report/#/implementations/rust-jsonschema)
- [](https://bowtie.report/#/implementations/rust-jsonschema)
- [](https://bowtie.report/#/implementations/rust-jsonschema)
- [](https://bowtie.report/#/implementations/rust-jsonschema)
You can check the current status on the [Bowtie Report](https://bowtie.report/#/implementations/rust-jsonschema).
## Notable Users
- Tauri: [Config validation](https://github.com/tauri-apps/tauri/blob/c901d9fdf932bf7c3c77e9d3097fabb1fe0712af/crates/tauri-cli/src/helpers/config.rs#L173)
- Apollo Router: [Config file validation](https://github.com/apollographql/router/blob/855cf6cc0757ca6176970ddf3ae8c98c87c632d1/apollo-router/src/configuration/schema.rs#L120)
- qsv: [CSV record validation with custom keyword & format validator](https://github.com/jqnatividad/qsv/blob/6b6985065a1270f767d881b13aa2a27fae1958fb/src/cmd/validate.rs#L630)
## Performance
`jsonschema` outperforms other Rust JSON Schema validators in most scenarios:
- Up to **20-470x** faster than `valico` and `jsonschema_valid` for complex schemas
- Generally **3-20x** faster than `boon`
For detailed benchmarks, see our [full performance comparison](https://github.com/Stranger6667/jsonschema/tree/master/crates/benchmark-suite).
## Minimum Supported Rust Version (MSRV)
This crate requires Rust 1.71.1 or later.
## Acknowledgements
This library draws API design inspiration from the Python [`jsonschema`](https://github.com/python-jsonschema/jsonschema) package. We're grateful to the Python `jsonschema` maintainers and contributors for their pioneering work in JSON Schema validation.
## Support
If you have questions, need help, or want to suggest improvements, please use [GitHub Discussions](https://github.com/Stranger6667/jsonschema/discussions).
## Sponsorship
If you find `jsonschema` useful, please consider [sponsoring its development](https://github.com/sponsors/Stranger6667).
## Contributing
We welcome contributions! Here's how you can help:
- Share your use cases
- Implement missing keywords
- Fix failing test cases from the [JSON Schema test suite](https://bowtie.report/#/implementations/rust-jsonschema)
See [CONTRIBUTING.md](https://github.com/Stranger6667/jsonschema/blob/master/CONTRIBUTING.md) for more details.
## License
Licensed under [MIT License](https://github.com/Stranger6667/jsonschema/blob/master/LICENSE).