Version 1.0.0-pre.1 (#2)

* WIP commit.  Totes doesnt work because I have a variable being returned before it is assigned in the start function.

* Now koa-karma-proxy promises the servers and their ports.

* Updated the CLI.  Next job is to add argument flags/options.

* WIP commit trying to get karma tests to actually run with the koa-karma-proxy-cli... something isn't picking up.

* Upgraded koa-proxy to the one that doesn't include a .git/index file.

* WIP got the CLI working as desired with a --proxyFile argument too.

* Make the test scripts better.

* WIP added license header to files and .clang-format file.

* Add .travis.yml

* Renamed koa-karma-proxy.ts to karma-proxy.ts and koa-karma-proxy-cli.ts to cli.ts etc.

* Added a random factor to exponential back-off to avoid port binding races on parallel test runs.

* Renamed upsFactor to upstreamProxyServerFactory

* Refining and tightening up the port stuff and layout of the start function.

* Got the middleware working again. Phew.

* Add some documentation to karma.proxy.js

* Updated README to show --proxyFile and also how to await ports from the start method.

* Added comments for public stuff.

* WIP

Author: usergenic

.clang-format

@@ -0,0 +1,12 @@
+BasedOnStyle: Google
+AlignAfterOpenBracket: AlwaysBreak
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+BinPackArguments: false
+# This breaks async functions sometimes, see
+#     https://github.com/Polymer/polymer-analyzer/pull/393
+# BinPackParameters: false

.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+lib/

.travis.yml

@@ -0,0 +1,10 @@
+language: node_js
+node_js:
+  - "node"
+dist: xenial
+cache:
+  directories:
+    - node_modules
+script:
+  - npm run build
+  - npm test

CHANGELOG.md

@@ -0,0 +1,14 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+<!--
+   PRs should document their user-visible changes (if any) in the
+   Unreleased section, uncommenting the header as necessary.
+-->
+
+<!-- ## Unreleased -->
+<!-- Add new unreleased items here -->

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2019 The Polymer Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+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. IN NO EVENT SHALL THE COPYRIGHT HOLDER 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.
+

README.md

@@ -37,10 +37,10 @@ module.exports = (karma) => new Koa()
     .use(karma);
 ```
 
-Use the `koa-karma-proxy` wrapper exactly as you'd use `karma` executable:
+Use the `karma-proxy` wrapper script exactly as you'd use `karma` executable:
 
 ```sh
-$ npx koa-karma-proxy start
+$ npx karma-proxy start
 ```
 
 This will:
@@ -51,22 +51,33 @@ This will:
 4. wait for karma to confirm the port it is listening on.
 5. configure the proxy middleware to start directing requests to karma.
 
+If you want to name your `karma.proxy.js` file differently or put it somewhere else, use the `--proxyFile` command-line argument to specify it like:
+
+```sh
+$ npx karma-proxy start --proxyFile ./lib/my-proxy.js
+```
+
 ## Advanced Usage
 
-You don't have to use `koa-karma-proxy` as an executable from the command-line.  It exposes everything you need to leverage within your own code:
+You don't have to use `karma-proxy` as an executable from the command-line.  It exposes everything you need to leverage within your own code:
 
 ```ts
 const Koa = require('koa');
 const mount = require('koa-mount');
 const {join} = require('path');
-const {karmaProxy} = require('koa-karma-proxy');
+const {start} = require('koa-karma-proxy');
 const {nodeResolve} = require('koa-node-resolve');
 
-karmaProxy.start((karma) => new Koa()
-    .use(mount('/base', nodeResolve())
-    .use(karma), {
-      // Karma config options
-      configFile: join(__dirname, '../karma.conf.js'),
-      singleRun: true
-    });
+(async () => {
+  const {upstreamProxyPort, karmaPort} =
+    await start((karma) => new Koa()
+      .use(mount('/base', nodeResolve())
+      .use(karma), {
+        // Karma config options
+        configFile: join(__dirname, '../karma.conf.js'),
+        singleRun: true
+      });
+  console.log(`Upstream Port ${upstreamProxyPort}`);
+  console.log(`Karma Port ${karmaPort}`);
+})();
 ```