support ssl/https mode

README.md

@@ -29,8 +29,8 @@ budo src/index.js:static/bundle.js
 # pass some options to browserify
 budo index.js --live -- -t babelify
 
-# set the header to use CORS (`Access-Control-Allow-Origin: *`)
-budo index.js --live --cors
+# use HTTPS and enable CORS headers
+budo index.js --ssl --cors --cert=cert.pem --key=key.pem
 ```
 
 Then open [http://localhost:9966/](http://localhost:9966/) to see the content in action.
@@ -91,6 +91,9 @@ Options:
   --poll=N         use polling for file watch, with optional interval N
   --title          optional title for default index.html
   --css            optional stylesheet href for default index.html
+  --ssl, -S        create an HTTPS server instead of HTTP
+  --cert, -C       the cert for SSL (default cert.pem)
+  --key, -K        the key for SSL (default key.pem)
   --cors           set header to use CORS (Access-Control-Allow-Origin: *)
   --ndjson         print ndjson instead of pretty-printed logs
   --verbose, -v    also include debug messages

bin/help.txt

@@ -16,6 +16,10 @@ Options:
   --poll=N         use polling for file watch, with optional interval N
   --title          optional title for default index.html
   --css            optional stylesheet href for default index.html
+  --ssl, -S        create an HTTPS server instead of HTTP
+  --cert, -C       the cert for SSL (default cert.pem)
+  --key, -K        the key for SSL (default key.pem)
+  --cors           set header to use CORS (Access-Control-Allow-Origin: *)
   --ndjson         print ndjson instead of pretty-printed logs
   --verbose, -v    also include debug messages
   --no-stream      do not print messages to stdout

docs/api-usage.md

@@ -46,6 +46,12 @@ All settings are optional.
     will trigger LiveReload events
 - `cors` (Boolean)
   - Set the header to use CORS (`Access-Control-Allow-Origin: *`)
+- `ssl` (Boolean)
+  - Creates an HTTPS server instead of HTTP
+- `cert` (String)
+  - The SSL public certificate file path (default `'cert.pem'`)
+- `key` (String)
+  - The SSL private key file path (default `'key.pem'`)
 - `watchGlob` (Array|String)
   - a glob string or array of glob strings to use as the default when `opts.live` is specified, or when `live()` is called without arguments
   - defaults to `'**/*.{html,css}'`

lib/budo.js

@@ -257,7 +257,8 @@ function createBudo (entries, opts) {
     opts.host = getHostAddress(opts.host)
 
     var port = opts.port
-    var uri = 'http://' + opts.host + ':' + port + '/'
+    var protocol = opts.ssl ? 'https' : 'http'
+    var uri = protocol + '://' + opts.host + ':' + port + '/'
 
     log.info({ message: 'Server running at', url: uri, type: 'connect' })
 

lib/parse-args.js

@@ -12,7 +12,8 @@ function parseArgs (args, opt) {
       'portfind',
       'ndjson',
       'verbose',
-      'cors'
+      'cors',
+      'ssl'
     ],
     string: [
       'host',
@@ -21,11 +22,16 @@ function parseArgs (args, opt) {
       'onupdate',
       'serve',
       'title',
-      'watchGlob'
+      'watchGlob',
+      'cert',
+      'key'
     ],
     default: module.exports.defaults,
     alias: {
       port: 'p',
+      ssl: 'S',
+      cert: 'C',
+      key: 'K',
       verbose: 'v',
       help: 'h',
       host: 'H',

lib/server.js

@@ -1,10 +1,18 @@
-// TODO: https support
 var http = require('http')
+var https = require('https')
 var createMiddleware = require('./middleware')
+var fs = require('fs')
 
 module.exports = function createServer (entryMiddleware, opts) {
+  var httpsOpts = opts.ssl ? {
+    cert: fs.readFileSync(opts.cert || 'cert.pem'),
+    key: fs.readFileSync(opts.key || 'key.pem')
+  } : undefined
+
   var handler = createMiddleware(entryMiddleware, opts)
-  var server = http.createServer(handler)
+  var server = httpsOpts
+    ? https.createServer(httpsOpts, handler)
+    : http.createServer(handler)
   server.setLiveOptions = handler.setLiveOptions
   return server
 }