Merge branch 'tluanga34-master'

Author: simonh1000

README.md

@@ -1,10 +1,10 @@
-# Angular-HTTP-Server
+# Single Page App dev-server
 
-A very simple application server designed for Single Page App (SPA) developers.
+A simple dev-server designed for Single Page App (SPA) developers. **`angular-http-server` is not, and makes no claims to be, a production server.** 
 
-It returns a file to the browser if it exists (ex. your-icon.png, index.html) and if can't find a file that matches a given URL it re-directs you to index.html rather than giving a 404 error. The only time it will error out is if it can't locate the index.html file.
+It returns a file if it exists (ex. your-icon.png, index.html), routes all other requests to index.html (rather than giving a 404 error) so that you SPO's routing can take over. The only time it will error out is if it can't locate the index.html file.
 
-Originally designed for my Angular work, this server will work with any Single Page App (SPA) framework that uses a router to change the URL (React, Vue JS, Elm,...).
+Originally designed for my Angular work, this dev-server will work with any Single Page App (SPA) framework that uses URL routing (React, Vue JS, Elm,...).
 
 ## To use:
 
@@ -24,6 +24,12 @@ Specify a port using `-p <port number>`
 angular-http-server -p 9000
 ```
 
+Open in a default browser automatically by using `--open` alias `-o`
+
+```sh
+angular-http-server --open
+```
+
 HTTPS can be enabled (using a generated self-signed certificate) with `--https` or `--ssl`
 
 ```sh
@@ -52,18 +58,15 @@ Feedback via: https://github.com/simonh1000/angular-http-server
 
 #### Production
 
-**`angular-http-server` is not, and makes no claims to be, a production server.** The `--https` or `--ssl` flagsare intended for development and/or testing purposes only. Self-signed certificates do not properly verify the identity of the web app and they will cause an end-users web browser to display an error.
-
-Within a production env use `angular-http-server` in http mode and forward traffic to it from an SSL-enabled reverse-proxy server (ie. [NGINX](https://www.nginx.com/resources/admin-guide/reverse-proxy/)).
-
-#### Development
-Only use `angular-http-server` with a self-signed certificate for development and/or testing. This can be accomplished by using the self-signed certificate generated when you pass the `--https`/`--ssl` flag. An example of when you should use this feature is with end-to-end testing suites such as [Protractor](http://www.protractortest.org/). or other suites which require the SPA application to be actively served.
+The `--https` or `--ssl` flags are intended for development and/or testing purposes only. Self-signed certificates do not properly verify the identity of the web app and they will cause an end-users web browser to display an error. Only use `angular-http-server` with a self-signed certificate for development and/or testing. This can be accomplished by using the self-signed certificate generated when you pass the `--https`/`--ssl` flag. An example of when you should use this feature is with end-to-end testing suites such as [Protractor](http://www.protractortest.org/). or other suites which require the SPA application to be actively served.
 
 ## Changelog
 
+1.5.0 - add --open option
 1.4.0 - add --path option
 
 ## Dev notes
+
 Test latest version, e.g.
 ```sh
 node angular-http-server.js --path example --ssl -p 9000

angular-http-server.js

@@ -7,6 +7,9 @@ var path = require("path");
 var pem = require('pem');
 var https = require('https');
 var http = require("http");
+var opn = require('opn');
+
+
 
 var server;
 
@@ -34,6 +37,9 @@ if (argv.ssl || argv.https) {
 
 function start() {
     server.listen(getPort(), function () {
+        if(argv.open == true || argv.o) {
+            opn(((argv.ssl)?'https':'http')+"://localhost:"+getPort());
+        }
         return console.log("Listening on " + getPort());
     });
 }

package.json

@@ -1,6 +1,6 @@
 {
     "name": "angular-http-server",
-    "version": "1.4.5",
+    "version": "1.5.0",
     "author": "Simon Hampton",
     "license": "ISC",
     "description": "Simple http server for developers that supports apps with client side routing",
@@ -37,6 +37,7 @@
     "dependencies": {
         "mime": "^1.3.6",
         "minimist": "^1.2.0",
+        "opn": "^5.3.0",
         "pem": "^1.9.7"
     }
 }