Skip to content

xliiauo/protoc-gen-jsonschema

 
 

Repository files navigation

Protobuf to JSON-Schema compiler

This takes protobuf definitions and converts them into JSONSchemas, which can be used to dynamically validate JSON messages.

This will hopefully be useful for people who define their data using ProtoBuf, but use JSON for the "wire" format.

"Heavily influenced" by Google's protobuf-to-BigQuery-schema compiler.

Links

Usage

  • Allow NULL values (by default, JSONSchemas will reject NULL values unless we explicitly allow them): protoc --jsonschema_out=allow_null_values:. --proto_path=testdata/proto testdata/proto/ArrayOfPrimitives.proto
  • Disallow additional properties (JSONSchemas won't validate JSON containing extra parameters): protoc --jsonschema_out=disallow_additional_properties:. --proto_path=testdata/proto testdata/proto/ArrayOfPrimitives.proto
  • Disallow permissive validation of big-integers as strings (eg scientific notation): protoc --jsonschema_out=disallow_bigints_as_strings:. --proto_path=testdata/proto testdata/proto/ArrayOfPrimitives.proto
  • Enable debug logging: protoc --jsonschema_out=debug:. --proto_path=testdata/proto testdata/proto/ArrayOfPrimitives.proto

Sample protos (for testing)

About

Protobuf to JSON-Schema compiler

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 90.2%
  • Makefile 9.8%