TheThing
/
spserver
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
spserver/README.md

119 lines
3.5 KiB
Markdown
Raw Permalink Normal View History

Update README.md
2015-02-02 10:35:59 +00:00
spserver
=======
Update README.md
2015-02-02 10:40:46 +00:00
spserver (or single page server) is a simple helper utlity for creating/running a server for using in pure single-page applications in true MVVM fashion without having to write any node code or using nginx or anything. This can be helpful to jump start making any single-page applications and get it running in seconds.
Update README.md
2015-02-02 10:35:59 +00:00
How it works
------------
spserver has two modes of serving files (minimum either has to be specified):
* Single file
* Static folder
When specifying a single file, all url requests will resolve with the contents of said file. This is handy for MVVM applications where the front-end javascript handles all url path routing.
When specifying a static folder, it will first look up the url request on the static folder to see if the file exists. If it doesn't, it falls back to the single file (above) or 404 (if single file was not specified).
A combination of these two will allow you to create a single base.html that will bootstrap your MVVM application with the static folder containing the javascript files. For an example, see the [nfp_www](https://github.com/nfp-projects/nfp_www) project.
API
===
`spserver(settings)`
* Settings for the server (see config below)
CLI
===
How to use
----------
```bash
Update README.md
2015-04-23 11:16:00 +00:00
npm install [-g] spserver
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
spserver --file ./myfile.html --serve ./public -p 3000
Update README.md
2015-02-02 10:35:59 +00:00
```
Options
-------
`spserver --help`
By default, spserver will use the settings located in `config.json`. You can also override them or run it directly using only the commands below.
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--config` Location of the config file for the server [default: config.json]
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--port` The port server should bind to [default: 3001 or 80 in production mode]
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--file` Single static file the server should serve on all unknown requests
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--bunyan` Use bunyan instead of console to log to [default: true in production mode]
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--template` Parse the static file as lodash template with all options/settings being passed to it
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--name` The name for this server for logging [default: spserver]
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--serve` Folder path to serve static files from [default: public]
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--prod` Force run the server in production mode
Update README.md
2015-02-02 10:35:59 +00:00
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`--debug` Force run the server in development mode
Update README.md
2015-02-02 10:35:59 +00:00
Config
======
The config file (default `config.json`) provides means to configure spserver in greater detail as well as provide optional settings to pass into our template (see template below).
A sample `config.json` file:
```
{
"production": {
"port": 80,
Fixed error in example
2015-02-06 11:14:09 +00:00
"bunyan": {
Update README.md
2015-02-02 10:35:59 +00:00
"name": "myserver",
"use_bunyan": true,
"streams": [{
"file": "/var/log/server.log",
"level": "info"
}]
}
},
"development": {
"port": 5000,
"use_bunyan": false
}
}
```
Any of the settings in the `config.json` file can be overridden using the CLI options above.
Template
========
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
spserver can also help provide any additional info to your single file thanks to lodash: `template`. If template mode is specified, it will parse the single file first through `lodash.template` with the whole config file. This can allow you to specify configuration in your config file and expose them in your single file.
Update README.md
2015-02-02 10:35:59 +00:00
Example:
`config.json`
```
{
"api": "http://api.mysite.com"
}
```
`base.html`
```
<!doctype html>
<body>
<script>
var apiUrl = "<%- api %>"
</script>
<script src="/js/lib/mithril.js"></script>
<script src="/js/main.js"></script>
</body
```
Then you can run it like this:
General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller
2021-10-12 13:43:05 +00:00
`spserver --config ./config.json --template --file ./base.html --serve ./public`