Generate JSON Schemas from clojure.specs

[ikitommi]

• related: Support for clojure.spec ring-swagger#95
• initial vomitation: https://github.com/metosin/spec-tools/tree/spec-parsing

[miikka]

I didn't really understand what is the aim of the spec-parsing branch, but here's my sketch of this: miikka@8a52296

[miikka]

I looked at arohner/spectrum again and it might make sense to take my tests and write a version based on spectrum against them.

[ikitommi]

Sketch looks great. Let's merge that in?

[miikka]

I have some some new code, but unfortunately right now the predicates for collection specs aren't resolved by the clojure.spec macros. This prevents spec-tools.json-schema from recognizing them. Hopefully it's fixed soon, the bug is here: CLJ-2035.

[ikitommi]

Nice.

Is it possible to configure how the JSON Schema generation process works? For example, the Swagger JSON Schema doesn't currently allow nulls, any-of or one-ofs.

[miikka]

Progress report: as of #13, the ::person example from README can be converted into reasonable JSON Schema. CLJ-2035 is still open, but it can be worked around by fully qualifying the predicates when writing the specs.

I'm not sure what should be done w.r.t. Swagger - maybe spec-tools should only target the Swagger-compliant JSON Schema, since that's probably the main use case anyway - or maybe it should be somehow configurable, or maybe there should a separate function for that.

[ikitommi]

Awesome! I think both are valid cases in the future: swagger & pure json schema. Looking forward to see / hear how these should be separated. Also, we should be able to collect all map-specs from a nested definition and optionally convert to $refs for better reuse. I have a use case for "collect ALL registered referenced specs", so that should be doable too.

[ikitommi]

s/merge is the last to be implemented.

[ikitommi]

done!