Jschematic

Jschematic is a JSON Schema Validator for Ruby. Its aim is to validate schemas conforming to the most recent version of the JSON Schema draft standard, which today means v3.

Supporting older versions of the standard is not out of the question, but it is not a primary development focus.

Status

Core schema: fully supported Hyper schema: not supported

The format attribute supports only these formats:

  • date-time
  • date
  • ip-address
  • ipv6
  • uri

Adding ad-hoc support for different formats should be relatively painless. Look in jschematic/attributes/format.rb to get started.

Please report any bugs you find in the issue tracker here: https://github.com/msassak/jschematic/issues.

Basic Usage

require 'jschematic'
Jschematic.validate(json, schema)  # => true or false
Jschematic.validate!(json, schema) # => true or raise Jschematic::ValidationError

json and schema above must be Ruby data structures, not real JSON.

Jschematic doesn't care how you turn JSON into Ruby (though we use the fine yajl-ruby gem for testing).

Advanced Usage

Pass extra schemas to inform the validation context:

Jschematic.validate(json, schema, :context => [cs1, cs2])

Each context schema will be consulted in those cases where cross-schema referencing is allowed, e.g. $ref.

To enable debugging support, set :debug to true in the options hash:

Jschematic.validate!(json, schema, :debug => true)

With debugging on a warning is printed when schema contain unknown attributes.

Testing

$ cucumber
$ rspec spec

Or rake if you want to run both.

Copyright (c) 2011 Mike Sassak. See LICENSE for details.