jsonschema

Code generation from json schemas with basic support for 2019-09:

Installation

• go install github.com/RossMerr/jsonschema/cmd/jsonschema

Notes for usage

$id

• Top level $id must follow the absolute-URI convention of being a canonical URL. The old 'id' field is not supported.

$ref

• Can resolve to any point in the document or another local file using a JSON Pointer.

"#/definitions/address"

"http://www.sample.com/definitions.json#/address"

$def

• The old 'definitions' field is still supported but merged into the new $def field.

allOf

• Will generate a struct with all of the subschemas embedded.

anyOf

• Will generate an array of a interface with all subschemas implementing its method.

oneOf

• Will generate a interface with all subschemas implementing its method.

Validation

All generated go types will be a value or reference type depending on the 'required' field. All fields and struct's also get generated validation tags mostly conforming to the Well-known struct tags for validate. Additional values for the validate tag include:

• allof
• anyof
• oneof
• regex

Which you can then use for any custom validators.

Not or partial support

String

• Format

Regular Expressions

You can add support with a custom validate field tag. But a regex validator won't be added because commas and = signs can be part of a regex which conflict with the validation definitions.

Numeric

• Multiples

Object

• Property names
• Size
• Dependencies
• Pattern Properties

Array

• List validation - contains
• Tuple validation
• Length
• Uniqueness

Generic

• Enumerated values Require a type of string "type": "string"
• Constant values

Media: string-encoding non-JSON data

Combining schemas

• Not

Applying subschemas conditionally

External JSON Pointer

All schemas must be local