grunt-appverse-jsonserver
v0.0.2
Published
Grunt tasks to build and run a REST Server with JSON Files.
Downloads
8
Maintainers
Readme
Appverse
grunt-appverse-jsonserver
Grunt tasks to build and run a REST Server with JSON Files
Getting Started
This plugin requires Grunt.
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-appverse-jsonserver --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-appverse-jsonserver');
The "jsonserver" task
Overview
In your project's Gruntfile, add a section named jsonserver
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
jsonserver: {
options: {
keepAlive:true
},
your_target: {
apidir: 'api',
port: 8888,
options : {
keepAlive:true
}
},
},
})
Settings
apidir
Type: String
A string value with project directory with JSON files to route by the json-server
port
Type: Integer
The port number to use by the json-server
options.keepAlive
Type: Boolean
Default value: false
Keep the server alive indefinitely. Note that if this option is enabled, any tasks specified after this task will never run. By default, once grunt's tasks have completed, the web server stops. This option changes that behavior. Use it when you run jsonserver task as standalone task, it is not necessary to use it with watch task combination.
Usage Examples
Multiple instances
In this example, we are setting different servers that will serve different JSON folders.
grunt.initConfig({
jsonserver: {
server_api: {
apidir: 'api',
port: 8989
},
server_api2: {
apidir: 'api2',
port: 8999
},
},
})
You can run one target:
grunt jsonserver:server_api
or
grunt jsonserver:server_api2
Or run all the targets:
grunt jsonserver
keepAlive multiple instances
Grunt multi target task will run all targets found if no target specified, so in order to keep alive all instances, you only need to set the flag in the last target.
grunt.initConfig({
jsonserver: {
server_api: {
apidir: 'api',
port: 8989
},
server_api2: {
apidir: 'api2',
port: 8999,
options: {
keepAlive: true
}
},
},
})
The "jserver" task
This task no needs configuration, it just will run the json-server with default behaviour.
Directory: api
Port: 8888
Keep Alive: false
License
Copyright (c) 2012 GFT Appverse, S.L., Sociedad Unipersonal.
This Source Code Form is subject to the terms of the Appverse Public License Version 2.0 ("APL v2.0"). If a copy of the APL was not distributed with this file, You can obtain one at http://appverse.org/legal/appverse-license/.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the conditions of the AppVerse Public License v2.0 are met.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. EXCEPT IN CASE OF WILLFUL MISCONDUCT OR GROSS NEGLIGENCE, IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.