Merge pull request #1 from Polymer/initial

Initial commit

Author: justinfagnani

.npmignore

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+'use strict';
+
+/**
+ * @license
+ * Copyright (c) 2014 The Polymer Project Authors. All rights reserved.
+ * This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
+ * The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
+ * The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
+ * Code distributed by Google as part of the polymer project is also
+ * subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
+ */
+var resolve = require('resolve');
+
+process.title = 'polytool';
+
+resolve('polytool', {basedir: process.cwd()}, function(error, path) {
+  let lib = path ? require(path) : require('..');
+  let polytool = new lib.Polytool();
+  polytool.run(process.argv.slice(2));
+});

bin/polytool.js

@@ -0,0 +1,26 @@
+declare module 'command-line-args' {
+  function commandLineArgs(args: commandLineArgs.ArgDescriptor[])
+      : commandLineArgs.CLI;
+
+  module commandLineArgs {
+    interface ArgDescriptor {
+      name: string;
+      alias?: string;
+      description?: string;
+      defaultValue?: any;
+      type?: Object;
+      multiple?: boolean;
+    }
+    interface UsageOpts {
+      title?: string;
+      header?: string;
+      description?: string;
+    }
+    interface CLI {
+      parse(): any;
+      getUsage(opts: UsageOpts): string;
+    }
+  }
+
+  export = commandLineArgs;
+}

custom_typings/command-line-args.d.ts

@@ -0,0 +1,26 @@
+declare module 'command-line-commands' {
+  module commandLineCommands {
+    interface CommandDescriptor {
+      name: string;
+      definitions?: any[];
+      description?: string;
+      defaultOption?: boolean;
+    }
+
+    interface Command {
+      name: string;
+      options: {[name: string]: string};
+    }
+
+    interface CLI {
+      commands: CommandDescriptor[];
+      parse(args?: string[]): Command;
+      getUsage(): string;
+    }
+  }
+
+  function commandLineCommands(args: commandLineCommands.CommandDescriptor[])
+      : commandLineCommands.CLI;
+
+  export = commandLineCommands;
+}

custom_typings/command-line-commands.d.ts

@@ -0,0 +1,23 @@
+{
+  "name": "polytool",
+  "version": "0.0.1",
+  "description": "A commandline tool for Polymer projects",
+  "main": "lib/polytool.js",
+  "bin": "bin/polytool.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Polymer/polytool.git"
+  },
+  "author": "The Polymer Project Authors",
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "command-line-commands": "^0.1.2",
+    "polyserve": "^0.7.1"
+  },
+  "devDependencies": {
+    "typescript": "^1.8.0"
+  }
+}

package.json

@@ -0,0 +1,19 @@
+import {ArgDescriptor} from 'command-line-args';
+
+export interface Command {
+  name: string;
+  description: string;
+  args: ArgDescriptor[];
+  run(options: {[name: string]: string}): Promise<any>;
+}
+
+// TODO(justinfagnani): how do I re-export an interface?
+export interface ArgDescriptor extends ArgDescriptor {
+//   // name: string;
+//   // alias?: string;
+//   // description: string;
+//   // defaultValue?: any;
+//   // type?: Object;
+//   // multiple?: boolean;
+//   // defaultOption?: boolean;
+}

src/commands/command.ts

@@ -0,0 +1,47 @@
+import {Command} from './command';
+import {CLI} from 'command-line-commands';
+import * as commandLineArgs from 'command-line-args';
+
+export class HelpCommand implements Command {
+  name = 'help';
+
+  description = 'Shows this help message, or help for a specific command';
+
+  args = [{
+    name: 'command',
+    description: 'The command to display help for',
+    defaultOption: true,
+  }];
+
+  commands : Map<String, Command> = new Map();
+
+  constructor(commands : Map<String, Command>) {
+    this.commands = commands;
+  }
+
+  run(options): Promise<any> {
+    return new Promise<any>((resolve, _) => {
+      if (options.command) {
+        let command = this.commands.get(options.command);
+        if (!command) {
+          console.log(`unknown command ${command}`);
+        } else {
+          let argsCli = commandLineArgs(command.args);
+          console.log(argsCli.getUsage({
+            title: `polytool ${command.name}`,
+            description: command.description,
+          }));
+        }
+      } else {
+        console.log(`polytool - The Polymer command-line tool\n`);
+        console.log(`usage: polytool <command> [<args>]\n`);
+        console.log(`polytool supports the following commands:`);
+        for (let command of this.commands.values()) {
+          console.log(`  ${command.name}\t\t${command.description}`);
+        }
+        console.log(`\nRun \`polytool help <command>\` for help on a specific command.\n`);
+      }
+      resolve(null);
+    });
+  }
+}

src/commands/help.ts

@@ -0,0 +1,61 @@
+import {Command} from './command';
+import {startServer} from 'polyserve';
+
+export class ServeCommand implements Command {
+  name = 'serve';
+
+  description = 'Runs the polyserve development server';
+
+  args = [
+    {
+      name: 'port',
+      alias: 'p',
+      description: 'The port to serve files from. Defaults to 8080',
+      type: Number,
+    },
+    {
+      name: 'hostname',
+      alias: 'h',
+      description: 'The hostname to serve. Defaults to localhost',
+      type: String,
+    },
+    {
+      name: 'component-dir',
+      alias: 'c',
+      description: 'The component directory to use. Defaults to reading from' +
+          ' the Bower config (usually bower_components/)',
+      type: String,
+    },
+    {
+      name: 'package-name',
+      alias: 'n',
+      description: 'Package name. Defaults to reading from bower.json',
+      type: String,
+    },
+    {
+      name: 'open',
+      alias: 'o',
+      description: 'Open page in default browser on startup.' +
+          ' Defaults to index.html',
+      type: String,
+    },
+    {
+      name: 'browser',
+      alias: 'b',
+      description: 'The browser to open when using the --open option.' +
+          ' Defaults to chrome',
+      type: String,
+    },
+  ];
+
+  run(options): Promise<any> {
+    return startServer({
+      port: options['port'],
+      componentDir: options['component-dir'],
+      packageName: options['package-name'],
+      page: options['open'],
+      host: options['hostname'],
+      browser: options['browser'],
+    });
+  }
+}

src/commands/serve.ts

@@ -0,0 +1,48 @@
+'use strict';
+
+import * as commandLineCommands from 'command-line-commands';
+import {HelpCommand} from './commands/help';
+import {ServeCommand} from './commands/serve';
+import {Command} from './commands/command';
+
+export class Polytool {
+
+  commandDescriptors = [];
+  commands : Map<String, Command> = new Map();
+  cli : commandLineCommands.CLI;
+
+  constructor() {
+    this.addCommand(new HelpCommand(this.commands));
+    this.addCommand(new ServeCommand());
+  }
+
+  addCommand(command) {
+    this.commands.set(command.name, command);
+    this.commandDescriptors.push({
+      name: command.name,
+      definitions: command.args,
+      description: command.description,
+    });
+  }
+
+  run(args) {
+    this.cli = commandLineCommands(this.commandDescriptors);
+    let cliCommand = this.cli.parse(args);
+
+    if (!cliCommand.name) {
+      if (args[2]) {
+        console.error('unknown command', args[2]);
+      } else {
+        console.error('must specify a command');
+      }
+      process.exit(1);
+    }
+
+    const command = this.commands.get(cliCommand.name);
+    command.run(cliCommand.options).then((result) => {
+      // success
+    }, (err) => {
+      console.error('error', err);
+    });
+  }
+}

src/polytool.ts

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    "target": "es6",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "isolatedModules": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "declaration": false,
+    "noImplicitAny": false,
+    "removeComments": false,
+    "noLib": false,
+    "preserveConstEnums": true,
+    "suppressImplicitAnyIndexErrors": true,
+    "outDir": "lib"
+  },
+  "filesGlob": [
+    "**/*.ts",
+    "**/*.tsx",
+    "!node_modules/**",
+    "custom_typings/*.d.ts",
+    "typings/**/*.d.ts"
+  ],
+  "files": [
+    "custom_typings/command-line-args.d.ts",
+    "custom_typings/command-line-commands.d.ts",
+    "src/commands/command.ts",
+    "src/commands/help.ts",
+    "src/commands/serve.ts",
+    "src/polytool.ts",
+    "typings/node/node.d.ts"
+  ],
+  "atom": {
+    "rewriteTsconfig": true
+  }
+}