voluptuary 0.0.3

convert json schemas to voluptuous schemas

voluptuary

This is a tool and library to convert a JSON Schema to a Voluptuous schema.

Usage

from voluptuary import to_voluptuous

# some JSON Schema
json_schema = {
    'type': 'object',
    'properties': {
        'value': {'type': 'integer'},
    },
}

# convert to a voluptuous schema
schema = to_voluptuous(json_schema)

# validate something
schema({'value': 1})

Tests

To run the tests, use tox.

$ tox

Why?

This library is for the people who aren’t satisfied with JSON Schema but can’t justify rewriting schemas (“tedious”, “time-consuming”, “little benefit”). But with a library to rewrite the schemas for you, there are no more excuses!

If you are wondering “why voluptuous over JSON Schema”, there are some good reasons listed here. I find voluptuous models to be nicer: more Pythonic, more expressive, easier to read and maintain, easier to customize, better error messages, and so on.

How do I know my converted schema will validate correctly?

First of all, you should always test the validation behavior of your schemas. No library is going to write correct schemas for you.

Aside from that, this library follows the following principles:

1. Familiar behavior: This library strives to match the validation behavior of the (Draft 4) validator from jsonschema.

2. Proactive testing: This library includes and actively runs a comprehensive suite of tests to ensure behavior in the first point.

3. Documentation: This library includes detailed documentation of support for JSON Schema validation features, and strive to keep this up to date.