feat: default to current working directory when no plugins are provided (#15)

* feat: default to current working directory when no plugins are provided

* chore: code review

* chore: code review

Author: mdonnalley

messages/main.json

@@ -1,6 +1,6 @@
 {
   "commandDescription": "generate the command reference guide located",
-  "pluginFlagDescription": "comma separated list of plugin names to be part of the generation",
+  "pluginFlagDescription": "comma separated list of plugin names to be part of the generation. Defaults to the oclif plugin in the current working directory",
   "hiddenFlagDescription": "show hidden commands",
   "outputdirFlagDescription": "output directory to put generated files",
   "erroronwarningFlagDescription": "fail the command if there are any warnings"

src/commands/commandreference/generate.ts

@@ -7,9 +7,11 @@
 
 import { IPlugin } from '@oclif/config';
 import { flags, SfdxCommand } from '@salesforce/command';
-import { Messages, SfdxError } from '@salesforce/core';
-import { AnyJson, Dictionary, ensure, JsonMap } from '@salesforce/ts-types';
+import { fs, Messages, SfdxError } from '@salesforce/core';
+import { AnyJson, Dictionary, ensure, getString, JsonMap } from '@salesforce/ts-types';
 import chalk = require('chalk');
+import * as os from 'os';
+import * as path from 'path';
 import { Ditamap } from '../../ditamap/ditamap';
 import { Docs } from '../../docs';
 import { events, mergeDeep } from '../../utils';
@@ -34,15 +36,29 @@ export default class CommandReferenceGenerate extends SfdxCommand {
     }),
     plugins: flags.array({
       char: 'p',
-      description: messages.getMessage('pluginFlagDescription'),
-      required: true
+      description: messages.getMessage('pluginFlagDescription')
     }),
     hidden: flags.boolean({ description: messages.getMessage('hiddenFlagDescription') }),
     erroronwarnings: flags.boolean({ description: messages.getMessage('erroronwarningFlagDescription') })
   };
 
   public async run(): Promise<AnyJson> {
-    const plugins = this.flags.plugins
+    let pluginNames: string[];
+    if (!this.flags.plugins) {
+      const pJsonPath = path.join(process.cwd(), 'package.json');
+      if (await fs.fileExists(pJsonPath)) {
+        const packageJson = await fs.readJson(pJsonPath);
+        pluginNames = [getString(packageJson, 'name')];
+      } else {
+        throw new SfdxError(
+          'No plugins provided. Provide the \'--plugins\' flag or cd into a directory that contains a valid oclif plugin.'
+        );
+      }
+    } else {
+      pluginNames = this.flags.plugins;
+    }
+
+    const plugins = pluginNames
       .map(plugin => plugin.trim())
       .map(name => {
         let pluginName = name;
@@ -57,7 +73,7 @@ export default class CommandReferenceGenerate extends SfdxCommand {
         }
         return pluginName;
       });
-
+    this.ux.log(`Generating command refernce for the following plugins:${plugins.map(name => `${os.EOL}  - ${name}`)}`);
     Ditamap.outputDir = this.flags.outputdir;
 
     Ditamap.cliVersion = this.config.version.replace(/-[0-9a-zA-Z]+$/, '');