Prep export of launcher as a standalone module (#2358)

* prep to publish to npm
* Use logger from lighthouse.
* Add launcher README
* Add notes for releasing chrome launcher
* Launcher readme tweaks
* docs (contributing): launcher rls tweak

CONTRIBUTING.md

@@ -97,7 +97,7 @@ echo "Upload the package zip to CWS dev dashboard"
 
 echo "Verify the npm package won't include unncessary files"
 yarn global add irish-pub pkgfiles
-irish-pub; pkgfiles;  
+irish-pub; pkgfiles;
 
 echo "ship it"
 npm publish
@@ -110,6 +110,17 @@ echo "Generate the release notes, and update the release page"
 echo "Inform various peoples"
 ```
 
+### Releasing chrome launcher.
+
+```sh
+cd chrome-launcher
+echo "build the launcher source code"
+yarn build
+yarn version
+echo "version bump will be committed"
+npm publish
+```
+
 ### Canary release
 
 ```sh

chrome-launcher/.npmignore

@@ -0,0 +1,11 @@
+# folders
+.vscode/
+test/
+
+# dev files
+.appveyor.yml
+.editorconfig
+.eslintignore
+.eslintrc.js
+.travis.yml
+gulpfile.js

chrome-launcher/README.md

@@ -0,0 +1,95 @@
+# Chrome Launcher
+
+Launch Google Chrome with ease from node.
+
+### Installing
+
+```
+yarn add chrome-launcher
+```
+
+or
+
+```
+npm install chrome-launcher
+```
+
+
+## API
+
+### `.launch([opts])`
+
+#### Launch options
+
+```ts
+{
+  // (optional) remote debugging port number to use. If provided port is already busy, launch() will reject
+  // Default: an available port is autoselected
+  port: number;
+
+  // (optional) Additional flags to pass to Chrome, for example: ['--headless', '--disable-gpu']
+  // See all flags here: http://peter.sh/experiments/chromium-command-line-switches/
+  // Do note, many flags are set by default: https://github.com/GoogleChrome/lighthouse/blob/master/chrome-launcher/flags.ts
+  chromeFlags: Array<string>;
+
+  // (optional) Close the Chrome process on `Ctrl-C`
+  // Default: true
+  handleSIGINT: boolean;
+
+  // (optional) Explicit path of intended Chrome binary
+  // By default, any detected Chrome Canary or Chrome (stable) will be launched
+  chromePath: string;
+
+  // (optional) Chrome profile path to use
+  // By default, a fresh Chrome profile will be created
+  userDataDir: string;
+
+  // (optional) Starting URL to open the browser with
+  // Default: `about:blank`
+  startingUrl: string;
+};
+```
+
+#### Launched chrome interface
+
+#### `.launch().then(chrome => ...`
+
+```ts
+// The remote debugging port exposed by the launched chrome
+chrome.port: number;
+
+// Method kill Chrome (and cleanup the profile folder)
+chrome.kill: () => Promise<{}>;
+
+// The process id
+chrome.pid: number;
+```
+
+
+## Examples
+
+#### Launching chrome:
+
+```js
+const chromeLauncher = require('chrome-launcher');
+
+chromeLauncher.launch({
+  startingUrl: 'https://google.com'
+}).then(chrome => {
+  console.log(`Chrome debugging port running on ${chrome.port}`);
+});
+```
+
+
+#### Launching headless chrome:
+
+```js
+const chromeLauncher = require('chrome-launcher');
+
+chromeLauncher.launch({
+  startingUrl: 'https://google.com',
+  chromeFlags: ['--headless', '--disable-gpu']
+}).then(chrome => {
+  console.log(`Chrome debugging port running on ${chrome.port}`);
+});
+```

chrome-launcher/chrome-launcher.ts

@@ -13,7 +13,7 @@ import {DEFAULT_FLAGS} from './flags';
 import {makeTmpDir, defaults, delay} from './utils';
 import * as net from 'net';
 const rimraf = require('rimraf');
-const log = require('../lighthouse-core/lib/log');
+const log = require('lighthouse/lighthouse-core/lib/log');
 const spawn = childProcess.spawn;
 const execSync = childProcess.execSync;
 const isWindows = process.platform === 'win32';

chrome-launcher/package.json

@@ -1,6 +1,5 @@
 {
   "name": "chrome-launcher",
-  "private": true,
   "main": "chrome-launcher.js",
   "scripts": {
     "build": "tsc",
@@ -19,6 +18,12 @@
   "dependencies": {
     "@types/core-js": "^0.9.41",
     "@types/mkdirp": "^0.3.29",
-    "@types/node": "6.0.66"
-  }
+    "@types/node": "6.0.66",
+    "lighthouse": "2.1"
+  },
+  "version": "0.1.0",
+  "description": "Launch latest Chrome with the devtools-protocol port open",
+  "repository": "https://github.com/GoogleChrome/lighthouse/tree/master/chrome-launcher",
+  "author": "The Chromium Authors",
+  "license": "Apache-2.0"
 }