gulp-json-server

Wrapper for json-server.

Important! API versions >1.0.0 are incompatible with ones <1.0.0, see this page for new API, and examples of usage.

Install

$ npm install --save-dev gulp-json-srv

Usage

var gulp = require("gulp");
var jsonServer = require("gulp-json-srv");

var server = jsonServer.create();

gulp.task("start", function(){
    return gulp.src("data.json")
        .pipe(server.pipe());
});

See samples for more information about usage of plugin.

API

Options

Options	Default value	Description
baseUrl	null	The base URL for server API.
bodyParserJson	null	Allows override of default bodyParser.json() method so it is possible to pass in custom options. e.g. bodyParser.json({limit: '10mb', expanded: false}).
cumulative	false	Controls when to merge files from different pipe() calls (i.e. two pipelines execution.)
cumulativeSession	true	Controls when to merge files in one pipe() call (i.e. one pipeline execution.). If not, then only last file passed to plugin will form the DB state.
customRoutes	null	A key-value pairs of custom routes that should be applied to server. Each value should be the object with method and handler properties, describing HTTP method and handler of custom route respectively.
id	"id"	Identity property name of objects. Changing this allows to imitate MongoDB's _id f.e.
port	3000	Port number on which json-server will listen.
rewriteRules	null	A key-value pairs of rewrite rules that should be applied to server.
static	null	If specified and not null, sets the static files folder and lets json-server serve static files from that folder.
verbosity	{     level:"error",     urlTracing:true }	Should be either string or object. In case value is object, specifies log level (see loglevel for details), and urlTracing flag, which allows to control messages about accessed routes. In case value is string, specifies only log level, and urlTracing is considered to be true.

Important: Note that cumulative and cumulativeSession options could be specified in options object, passed to pipe() method and they will override one set at server level.

Methods

Method	Description
kill(callback)	Immediately stops the server and closes all opened connections. If callback is provided, it will be called once server stopped.
pipe(options)	Provides stream trasformation for gulp pipeline. Passing 'options' to this method allows to override options, set at server level (currently cumulative and cumulativeSession are overridable).

Links

• SAMPLES.md - more examples of usage
• CHANGELOG.md
• CONTRIBUTING.md - info for contributors

License

MIT © 2016 Nikita Ivanov