CD2H gitForager

metosin/web-schemas

Name: web-schemas

Owner: Metosin

Description: Prismatic Schema extensions for the Web.

Created: 2015-08-09 18:58:05.0

Updated: 2016-02-10 11:22:22.0

Pushed: 2015-11-13 19:59:03.0

Homepage: null

Size: 140

Language: Clojure

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Web-schemas

Prismatic Schema extensions for the Web.

Goals

symmetric serialization & de-serialization of data types via existing libraries & schema coercion
extendable way to add support for new data types (Pattern, DateTime etc.) - for all formats
extendable way to add support for new wire formats (JSON, Transit etc.) - for all data types
out-of-the-box support for all common data types & wire formats
including the Schema-records
test suite to verify all data types are supported in all wire formats (no nasty runtime surprises)
fast, minimalistic single-sweep coercion without reflection
sits on top of schema-tools

Public apis

introduce wire formats (serialize & deserialize)
link type-based coercion matchers to wire formats
serialize and deserialize&coerce based on explicit set of protocols.
coercion matcher also for clojure2clojure - to coerce at least numbers and dates.
test suite (for custom extension)

Why?

Single responsibility principle: besides the swagger-stuff, ring-swagger also contains symmetric serialization & de-serialization for most data types, but only for JSON & String-based protocols. It's serialization & coercion mechanisms are currenly hard extend. Export all the good stuff here, add more coverage, verify and measure performance, make everything extendable and make ring-swagger depend on this lib.

This lib also will serve the ring-middleware-format, enabling easy support to new wire formats like XML (via wire-format based coercion). We are currently jointly developing r-m-f with Nils Gr�nwald.

License

Distributed under the Eclipse Public License, the same as Clojure.

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.