Skip to main content

An implementation of JSON Schema validation for Python

Project description

PyPI version Supported Python versions Build status ReadTheDocs status pre-commit.ci status Zenodo DOI

jsonschema is an implementation of the JSON Schema specification for Python.

>>> from jsonschema import validate

>>> # A sample schema, like what we'd get from json.load()
>>> schema = {
...     "type" : "object",
...     "properties" : {
...         "price" : {"type" : "number"},
...         "name" : {"type" : "string"},
...     },
... }

>>> # If no exception is raised by validate(), the instance is valid.
>>> validate(instance={"name" : "Eggs", "price" : 34.99}, schema=schema)

>>> validate(
...     instance={"name" : "Eggs", "price" : "Invalid"}, schema=schema,
... )                                   # doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
    ...
ValidationError: 'Invalid' is not of type 'number'

It can also be used from the command line by installing check-jsonschema.

Features

Installation

jsonschema is available on PyPI. You can install using pip:

$ pip install jsonschema

Extras

Two extras are available when installing the package, both currently related to format validation:

  • format

  • format-nongpl

They can be used when installing in order to include additional dependencies, e.g.:

$ pip install jsonschema'[format]'

Be aware that the mere presence of these dependencies – or even the specification of format checks in a schema – do not activate format checks (as per the specification). Please read the format validation documentation for further details.

About

I’m Julian Berman.

jsonschema is on GitHub.

Get in touch, via GitHub or otherwise, if you’ve got something to contribute, it’d be most welcome!

If you feel overwhelmingly grateful, you can also sponsor me.

And for companies who appreciate jsonschema and its continued support and growth, jsonschema is also now supportable via TideLift.

Release Information

v4.24.0

  • Fix improper handling of unevaluatedProperties in the presence of additionalProperties (#1351).

  • Support for Python 3.8 has been dropped, as it is end-of-life.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jsonschema-4.24.0.tar.gz (353.5 kB view details)

Uploaded Source

Built Distribution

jsonschema-4.24.0-py3-none-any.whl (88.7 kB view details)

Uploaded Python 3

File details

Details for the file jsonschema-4.24.0.tar.gz.

File metadata

  • Download URL: jsonschema-4.24.0.tar.gz
  • Upload date:
  • Size: 353.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for jsonschema-4.24.0.tar.gz
Algorithm Hash digest
SHA256 0b4e8069eb12aedfa881333004bccaec24ecef5a8a6a4b6df142b2cc9599d196
MD5 168a114dcc5c3f977b7a10795fe3d99d
BLAKE2b-256 bfd31cf5326b923a53515d8f3a2cd442e6d7e94fcc444716e879ea70a0ce3177

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonschema-4.24.0.tar.gz:

Publisher: ci.yml on python-jsonschema/jsonschema

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jsonschema-4.24.0-py3-none-any.whl.

File metadata

  • Download URL: jsonschema-4.24.0-py3-none-any.whl
  • Upload date:
  • Size: 88.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for jsonschema-4.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a462455f19f5faf404a7902952b6f0e3ce868f3ee09a359b05eca6673bd8412d
MD5 9286bb24c413e2eecf3b20162117fd9e
BLAKE2b-256 a23d023389198f69c722d039351050738d6755376c8fd343e91dc493ea485905

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonschema-4.24.0-py3-none-any.whl:

Publisher: ci.yml on python-jsonschema/jsonschema

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page