Generate documentation for only one cmdlet

Author: Fogolan

tools/office-cmdlet-updater/controllers/cli.controller.js

@@ -23,13 +23,23 @@ class CliController {
 
 		this.cliServoce.addOption({
 			option: '-c --cmdlet <cmdet>',
-			description: 'update documentation for cmdlet in module'
+			description: 'update documentation for cmdlet in module',
+			action: (cli) => {
+				const { module, cmdlet } = cli;
+
+				if (module === 'all' && cmdlet) {
+					throw new Error('You must specify a module for cmdet.');
+				}
+			}
 		});
 
 		this.cliServoce.start(argv, async (cli) => {
 			const { module, cmdlet } = cli;
 
-			this.markdownController.updateMarkdown({ moduleName: module });
+			this.markdownController.updateMarkdown({
+				moduleName: module,
+				cmdlet
+			});
 			console.log(module);
 			console.log(cmdlet);
 		});

tools/office-cmdlet-updater/controllers/markdown.controller.js

@@ -19,7 +19,7 @@ class MarkdownController {
 					throw new Error(powerShellErrors.DOC_PATH_DOESNT_EXIST);
 				}
 
-				[, err] = await of(this.markdownService.updateMd(doc));
+				[, err] = await of(this.markdownService.updateMd(doc, cmdlet));
 
 				if (err) {
 					this.powerShellService.dispose();

tools/office-cmdlet-updater/services/markdown.service.js

@@ -31,12 +31,14 @@ class MarkdownService {
 		this.installedDependencies = [];
 	}
 
-	async updateMd(doc) {
-		return this.addMdFilesInQueue(doc);
+	async updateMd(doc, cmdlet) {
+		return this.addMdFilesInQueue(doc, cmdlet);
 	}
 
-	async addMdFilesInQueue(doc) {
-		const mdFiles = await this.fsService.getModuleFiles(doc);
+	async addMdFilesInQueue(doc, cmdlet) {
+		const mdFiles = (await this.fsService.getModuleFiles(doc)).filter(
+			(file) => this._filterCmdlets(file, cmdlet)
+		);
 
 		mdFiles.forEach((file) => {
 			this.queue
@@ -46,6 +48,16 @@ class MarkdownService {
 		});
 	}
 
+	_filterCmdlets(mdPath, cmdletName) {
+		if (!cmdletName) {
+			return true;
+		}
+
+		const mdExt = '.md';
+
+		return mdPath.endsWith(`${cmdletName}${mdExt}`);
+	}
+
 	async processQueue({ file, doc }, cb) {
 		let result, err;