Socket
Socket
Sign inDemoInstall

boutique

Package Overview
Dependencies
3
Maintainers
3
Versions
8
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    boutique

The finest representations to emphasize natural beauty of your MSON AST


Version published
Weekly downloads
8
decreased by-66.67%
Maintainers
3
Install size
540 kB
Created
Weekly downloads
 

Readme

Source

Boutique

Circle CI Status

Looking for the best fashion for your MSON AST? Boutique offers the finest quality, luxury representations to emphasize natural beauty of your AST.

illustration

Introduction

Imagine you have some MSON to describe body attributes in your API Blueprint. Drafter should be able not only to parse it, but also to provide representations of those body attributes in formats you specified, e.g. in application/json. Boutique is a simple tool to do exactly that.

Boutique takes an MSON AST and provides a representation of it in JSON, JSON Schema or other formats.

diagram

NOTE: Boutique knows nothing about hypermedia. For example, it understands that application/hal+json means it should generate JSON, but it generates plain JSON. To generate HAL document properly, the AST has to explicitly contain all HAL structures already on input to this tool.

Usage

Using the MSON AST from this example as the ast variable, we can convert it by Boutique to a representation:

boutique = require 'boutique'
boutique.represent
    ast: ast,
    contentType: 'application/json'
  , (err, body) ->
    # body contains following string:
    # '{"id":"1","name":"A green door","price":12.50,"tags":["home","green"],"vector":["1","2","3"]}'

boutique.represent
    ast: ast,
    contentType: 'application/schema+json'
  , (err, body) ->
    # body contains following string:
    # '{"type":"object","properties":"id":{"type":"string"},"name":{"type":"string"},"price":{"type":"number"},"tags":{"type":"array"},"vector":{"type":"array"}}'

API

NOTE: Refer to the MSON Specification for the explanation of terms used throughout this documentation.

Represent (function)

Generate representation for given content type from given MSON AST.

Signature
boutique.represent({ast, contentType}, cb)
Parameters
  • ast (object) - MSON AST in form of tree of plain JavaScript objects.

  • contentType: application/schema+json (string, default)

    Smart matching takes place. For example, if following formats are implemented and provided by Boutique...

    • application/json
    • application/xml
    • application/schema+json

    ...then matching will work like this:

    • image/svg+xml; charset=utf-8application/xml

    • application/schema+jsonapplication/schema+json

    • application/hal+jsonapplication/json

    NOTE: Distinguishing JSON Schema draft versions by matching according to profile parameter is not implemented yet.

  • cb (Represent Callback, required) - callback function

Represent Callback (function)

Signature
callback(err, repr, contentType)
Parameters
  • err: null (object, default) - Exception object in case of error
  • repr (string) - final string representation of given AST in given format
  • contentType (string) - selected content type, which was actually used for rendering the representation

Testing

Inside the Boutique repository you can execute the following to run the test suite:

$ npm install
$ npm test

Contribute

Fork & Pull Request.

License

Boutique is released under the BSD license. See LICENSE.

FAQs

Last updated on 30 Apr 2015

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc