Jsonary - use JSON Schema in your client
WARNING: rendering functionality is rather limited at the moment
This package makes the Jsonary library available on Node.js.
Jsonary is a library for dealing with data and APIs that are described by JSON (Hyper-)Schema. It can find and fetch schemas referenced from HTTP headers, allowing you to use the API in a flexible way.
It also contains a rendering system, using schema constraints and hyper-schema links to assemble adaptive clients for your APIs. This is currently only in the browser, but the final steps for getting it working on Node are being worked on.
The goal is that you should be able to write a Jsonary renderer once, and it should generate static HTML on Node, and provide part of a snazzy AJAX client on the browser.
Right now, the rendering system doesn't quite work, but you can still other (slightly less cool) schema-aware features of Jsonary.
For example, here is a short script that scrapes a (JSON Hyper-Schema described) API, starring every document written by someone whose name begins with 'J':
var Jsonary = require'jsonary'instance;var results = ;JsonarygetData''documentsitemsvar authorLink = docDatagetLink'author';var starLink = docDatagetLink'star';if authorLink && starLinkauthorLinkfollownull falsegetDatavar authorName = authorDataget'/name';if /^J/testauthorNamestarLinkfollownull false;;;;
That script knows nothing about any URL apart from the entry-point - the link information is taken from the hyper-schema referenced by the data.
Jsonary also implements a basic cookie store, so your scripts can log in to an API before using it:
var Jsonary = require'jsonary'instance;JsonarygetData''var loginLink = basePagegetLink'login';loginLinkfollowusername: "hello" password: "world" falsegetDataassertloginResultget'/success' == true;performLoggedInActions;;;
loginLink will be followed at whatever URL, and with whatever method and Content-Type is appropriate. For maximum flexibility, the login data should probably have used
link.createSubmissionData(), in case there are other required parameters:
var loginLink = basePagegetLink'login';loginLinkcreateSubmissionDataloginDataset'/username' "hello";loginDataset'/password' "world";loginLinkfollowloginData falsegetData;;