stubber

Stubber.js

Stubber.js a lightweight Resourcefully RESTful Stub API provider. Currently it only supports it's own propriatory format, but plans are to support multiple output formats to allow it to simulate any RESTful API.

See Planned Features for more details

NOTE: This document is a work in progress! Please submit Pull requests with updates/fixes to the project or the documentation.

Requirements

• Node.js
• MongoDB

Why?

Too many times of needing to stand up a temporary stub provider for data that would eventually be replaced with a real RESTful web service. Stubber was started as a generic solution to this problem with the idea of placing it behind a gateway provider that would do any additional transformations of the data as necessary and would be switched over to point at a live provider once one was available.

Installation

npm install stubber

Configuration

Stubber.js is configured by setting the appropriate values in the config.json file within its root path. The default config.json file is:

{
  default: {
    web: {
      webroot: './webroot',
      port: 8080
    },
    mongo: {
      connectionString: 'mongodb://localhost:27017/stubber'
    }
  }
}

• default.web.webroot sets where the static HTML source files are served for the UI.
• default.web.port is the port that the HTTP server will listen on.
• default.mongo.connectionString sets the connection string that should be used for the MongoDB connection and collection used by Stubber.js

API

All endpoints are documented at :// Where HTTP Method is the name of the appropriate HTTP Method to envoke on the resource and resource path is the actual path that the resource resides at. When dynamic properties (or variable values) are concerned the reference name is preceeded by a :

GET://api/v1/schemas

Provides a pagged listing of all available schemas known within the running instance of Stubber.js

GET://api/v1/schema/:schemaName

Provides just the JSON-Schema schema for a particular schema by name (Resource Name). Use this for linking your JSON-Schema's together.

GET://api/v1/resources

Provides a pagged listing of known resource types within the running instance of Stubber.js

POST://api/v1/resource

Creates a new resource type within the running instance of Stubber.js

PUT://api/v1/resource

Creates a new resource type within the running instance of Stubber.js NOTE: You really should use POST://api/v1/resource instead of PUT://api/v1/resource

GET://api/v1/resource/:id

Gets a specific resource by identity and returns its details including the schema attached to it.

PUT://api/v1/resource/:id

Updates a specific resource by identity.

POST://api/v1/resource/:id

Updates a specific resource by identity. NOTE: You really should use PUT://api/v1/resource/:id instead of POST://api/v1/resource/:id

DELETE://api/v1/resource/:id

Deletes a specific resource by identity.

GET://stub/:resourceName

Provides a pagged listing of all of the stub records for the specific resource requested.

POST://stub/:resourceName

Creates a new stub for the named resource within the running instance of Stubber.js

PUT://stub/:resourceName

Creates a new stub for the named resource within the running instance of Stubber.js NOTE: You really should use POST://stub/:resourceName instead of PUT://stub/:resourceName

GET://stub/:resourceName/:id

Gets a specific stub by identity from a named resource and returns its details back to the caller.

PUT://stub/:resourceName/:id

Updates a specific stub by identity from the named resource.

POST://stub/:resourceName/:id

Updates a specific stub by identity from the named resource. NOTE: You really should use PUT://stub/:resourceName/:id instead of POST://stub/:resourceName/:id

DELETE://stub/:resourceName/:id

Deletes a specific stub by identity for a particular named resource.

Output Format

The output from Stubber.js will always be a JSON response that falls in to one of three specific response types. The three response types are detailed below.

Errors

{
  root: "error",
  error: {
    // All of the details associated with the error will be placed here
  }
}

Listing

{
  root: <listingResourceName>,
  <listingResourceName>: [
    // array of resources
  ],
  limit: //number of resources the result is limited to
  offset: // offset of this block within the full result set
  count: // total number of resources that were returned
  length: // total number of resources that could have been returned 
}

Singular

{
  root: <resourceName>,
  <resourceName>: {
    // singular resource result
  }
}

Planned Features

• An actual UI for Resource Type management and stub record management.
• Support for other output formats than the default Stubber.js one.
• Bulk import of stubs.
• Maybe provide some type of authentication or application key concept???

Update History

• v0.0.1
  • Initial Alpha Release
  • This is a really rough release of the general concept