Skip to main content

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.1

  • Properly escape segments in ValidationError.json_path (#139).

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.1.tar.gz (356.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jsonschema-4.24.1-py3-none-any.whl (89.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jsonschema-4.24.1.tar.gz
  • Upload date:
  • Size: 356.6 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.1.tar.gz
Algorithm Hash digest
SHA256 fe45a130cc7f67cd0d67640b4e7e3e2e666919462ae355eda238296eafeb4b5d
MD5 d95170bd788516b324166efbd84e59ed
BLAKE2b-256 f16e35174c1d3f30560848c82d3c233c01420e047d70925c897a4d6e932b4898

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonschema-4.24.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: jsonschema-4.24.1-py3-none-any.whl
  • Upload date:
  • Size: 89.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6b916866aa0b61437785f1277aa2cbd63512e8d4b47151072ef13292049b4627
MD5 4a7d0a931a0b85b4ec2c576469641b6b
BLAKE2b-256 857fea48ffb58f9791f9d97ccb35e42fea1ebc81c67ce36dc4b8b2eee60e8661

See more details on using hashes here.

Provenance

The following attestation bundles were made for jsonschema-4.24.1-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.

Release history Release notifications | RSS feed

Supported by

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