1.0.4 • Published 6 years ago
reserve-cmd v1.0.4
REserve/cmd
Command line handler for REserve. It allows execution and output capturing of command lines.
Usage
{
  "handlers": {
    "cmd": "reserve-cmd"
  },
  "mappings": [{
    "match": "\\/test",
    "cmd": "./test.cmd"
  }]
}Capturing group values substitutions can be used, space escaping is done with the character `.
Options
| Option | Default Value | Explanation | 
|---|---|---|
| env | {} | Additional variables to be used in the created process (see child_process.execFile) (interpolated) | 
| html-footer | '' | Additional content to be added in the footer of the HTML output (interpolated) | 
| html-header | '' | Additional content to be added in the header of the HTML output (interpolated) | 
| html-tracking | false | Injects JavaScript code to scroll the HTML output while executing | 
| text-only | false | When set, the output is always text | 
| timeout | 0 | Automatic kill of the process (see child_process.execFile) | 
NOTE : interpolated values are transformed as described in the custom handlers section of REserve.
Any command can be executed (use it carefully). If a process can not be started, the request ends with a 500 error.
Supported verbs
GET
The handler adapts the output based on the accepted mime-type. If text/html is found in the accept header, the content is formatted to HTML. Otherwise, the output uses text format.