aisensiy / osprey-mock-service

Generate an API mock service from a RAML definition using Osprey

Osprey Mock Service

Generate an API mock service from a RAML definition using Osprey.

Usage

Global (CLI)

npm install -g osprey-mock-service

Start the service from the CLI. This will automatically use the baseUri as the path to the mock service. For example, http://example.com/api will result in http://localhost:{PORT}/api.

osprey-mock-service -f api.raml -p 8000

Options

• -f Path to the root RAML definition (E.g. /path/to/api.raml)
• -p Port number to bind the server locally

Locally (JavaScript)

npm install osprey-mock-service --save

The mocking service simply accepts a RAML definition and returns a router that can be mounted into any Connect-style middleware layer or even used with http. Best used with osprey to support incoming validation automatically.

var mockService = require('osprey-mock-service')
var express = require('express')
var parser = require('raml-parser')

var app = express()

parser.loadFile(__dirname + '/api.raml')
  .then(function (raml) {
    app.use(osprey.createServer(raml))
    app.use(mockService(raml))
    app.listen(3000)
  })

Additional methods

• createServer Creates a mock service instance with Osprey
• createServerFromBaseUri Creates a mock service with Osprey and uses the base URI path
• loadFile Creates a mock service with Osprey and the base URI path from a RAML file

License

Apache License 2.0