mirror of
https://github.com/balena-io/balena-cli.git
synced 2024-12-27 17:18:51 +00:00
fcad35402a
Add oclif support for piped input Change-type: patch Signed-off-by: Scott Lowe <scott@balena.io>
93 lines
2.7 KiB
TypeScript
93 lines
2.7 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2019 Balena Ltd.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
import * as _ from 'lodash';
|
|
import * as path from 'path';
|
|
|
|
import { getCapitanoDoc } from './capitanodoc';
|
|
import { CapitanoCommand, Category, Document, OclifCommand } from './doc-types';
|
|
import * as markdown from './markdown';
|
|
|
|
/**
|
|
* Generates the markdown document (as a string) for the CLI documentation
|
|
* page on the web: https://www.balena.io/docs/reference/cli/
|
|
*/
|
|
export async function renderMarkdown(): Promise<string> {
|
|
const capitanodoc = await getCapitanoDoc();
|
|
const result: Document = {
|
|
title: capitanodoc.title,
|
|
introduction: capitanodoc.introduction,
|
|
categories: [],
|
|
};
|
|
|
|
for (const commandCategory of capitanodoc.categories) {
|
|
const category: Category = {
|
|
title: commandCategory.title,
|
|
commands: [],
|
|
};
|
|
|
|
for (const jsFilename of commandCategory.files) {
|
|
category.commands.push(
|
|
...(jsFilename.includes('actions-oclif')
|
|
? importOclifCommands(jsFilename)
|
|
: importCapitanoCommands(jsFilename)),
|
|
);
|
|
}
|
|
result.categories.push(category);
|
|
}
|
|
|
|
return markdown.render(result);
|
|
}
|
|
|
|
function importCapitanoCommands(jsFilename: string): CapitanoCommand[] {
|
|
const actions = require(path.join(process.cwd(), jsFilename));
|
|
const commands: CapitanoCommand[] = [];
|
|
|
|
if (actions.signature) {
|
|
commands.push(_.omit(actions, 'action') as any);
|
|
} else {
|
|
for (const actionName of Object.keys(actions)) {
|
|
const actionCommand = actions[actionName];
|
|
commands.push(_.omit(actionCommand, 'action') as any);
|
|
}
|
|
}
|
|
return commands;
|
|
}
|
|
|
|
function importOclifCommands(jsFilename: string): OclifCommand[] {
|
|
// TODO: Currently oclif commands with no `usage` overridden will cause
|
|
// an error when parsed. This should be improved so that `usage` does not have
|
|
// to be overridden if not necessary.
|
|
const command: OclifCommand = require(path.join(process.cwd(), jsFilename))
|
|
.default as OclifCommand;
|
|
return [command];
|
|
}
|
|
|
|
/**
|
|
* Print the CLI docs markdown to stdout.
|
|
* See package.json for how the output is redirected to a file.
|
|
*/
|
|
async function printMarkdown() {
|
|
try {
|
|
console.log(await renderMarkdown());
|
|
} catch (error) {
|
|
console.error(error);
|
|
process.exit(1);
|
|
}
|
|
}
|
|
|
|
printMarkdown();
|