nx
Version:
221 lines (220 loc) • 7.62 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.printHelp = void 0;
const chalk = require("chalk");
const stringWidth = require("string-width");
// cliui is the CLI layout engine developed by, and used within, yargs
const cliui = require("cliui");
const logger_1 = require("./logger");
const output_1 = require("./output");
const versions_1 = require("./versions");
function printHelp(header, schema, meta) {
const allPositional = Object.keys(schema.properties).filter((key) => {
const p = schema.properties[key];
return p['$default'] && p['$default']['$source'] === 'argv';
});
const positional = allPositional.length > 0 ? ` [${allPositional[0]}]` : '';
logger_1.logger.info(`
${output_1.output.applyNxPrefix('cyan', chalk.bold(`${`${header + chalk.reset.cyan(positional)} ${chalk.reset.cyan('[options,...]')}`}`))}
${generateOverviewOutput({
pluginName: meta.plugin,
name: meta.entity,
description: schema.description,
mode: meta.mode,
aliases: meta.mode === 'generate' ? meta.aliases : [],
})}
${generateOptionsOutput(schema)}
${generateExamplesOutput(schema)}
${generateLinkOutput({
pluginName: meta.plugin,
name: meta.entity,
type: meta.mode === 'generate' ? 'generators' : 'executors',
})}
`);
}
exports.printHelp = printHelp;
function generateOverviewOutput({ pluginName, name, description, mode, aliases, }) {
switch (mode) {
case 'generate':
return generateGeneratorOverviewOutput({
pluginName,
name,
description,
aliases,
});
case 'run':
return generateExecutorOverviewOutput({
pluginName,
name,
description,
});
default:
throw new Error(`Unexpected mode ${mode}`);
}
}
function generateGeneratorOverviewOutput({ pluginName, name, description, aliases, }) {
const ui = cliui();
const overviewItemsLabelWidth =
// Chars in labels "From" and "Name"
4 +
// The `:` char
1;
ui.div(...[
{
text: chalk.bold('From:'),
padding: [1, 0, 0, 0],
width: overviewItemsLabelWidth,
},
{
text: pluginName +
(pluginName.startsWith('@nrwl/')
? chalk.dim(` (v${versions_1.nxVersion})`)
: ''),
padding: [1, 0, 0, 2],
},
]);
ui.div(...[
{
text: chalk.bold('Name:'),
padding: [0, 0, 0, 0],
width: overviewItemsLabelWidth,
},
{
text: `${name}${aliases.length ? chalk.dim(` (aliases: ${aliases.join(', ')})`) : ''}`,
padding: [0, 0, 0, 2],
},
]);
ui.div(...[
{
text: description,
padding: [2, 0, 1, 2],
},
]);
return ui.toString();
}
function generateExecutorOverviewOutput({ pluginName, name, description, }) {
const ui = cliui();
const overviewItemsLeftPadding = 2;
const overviewItemsLabelWidth = overviewItemsLeftPadding + 'Executor:'.length;
ui.div(...[
{
text: chalk.bold('Executor:'),
padding: [1, 0, 0, 0],
width: overviewItemsLabelWidth,
},
{
text: `${pluginName}:${name}` +
(pluginName.startsWith('@nrwl/')
? chalk.dim(` (v${versions_1.nxVersion})`)
: ''),
padding: [1, 0, 0, 0],
},
]);
ui.div(...[
{
text: description,
padding: [2, 0, 1, 2],
},
]);
return ui.toString();
}
const formatOptionVal = (maybeStr) => typeof maybeStr === 'string' ? `"${maybeStr}"` : JSON.stringify(maybeStr);
// From our JSON schemas an option could possibly have more than one valid type
const formatOptionType = (optionConfig) => {
if (Array.isArray(optionConfig.oneOf)) {
return optionConfig.oneOf
.map((typeConfig) => formatOptionType(typeConfig))
.join(' OR ');
}
return `[${optionConfig.type}]`;
};
function generateOptionsOutput(schema) {
const ui = cliui();
const flagAndAliasLeftPadding = 4;
const flagAndAliasRightPadding = 4;
// Construct option flags (including optional aliases) and descriptions and track the required space to render them
const optionsToRender = new Map();
let requiredSpaceToRenderAllFlagsAndAliases = 0;
for (const [optionName, optionConfig] of Object.entries(schema.properties)) {
const renderedFlagAndAlias = `--${optionName}` +
(optionConfig.alias ? `, -${optionConfig.alias}` : '');
const renderedFlagAndAliasTrueWidth = stringWidth(renderedFlagAndAlias);
if (renderedFlagAndAliasTrueWidth > requiredSpaceToRenderAllFlagsAndAliases) {
requiredSpaceToRenderAllFlagsAndAliases = renderedFlagAndAliasTrueWidth;
}
const renderedDescription = optionConfig.description;
const renderedTypesAndDefault = `${formatOptionType(optionConfig)}${optionConfig.enum
? ` [choices: ${optionConfig.enum
.map((e) => formatOptionVal(e))
.join(', ')}]`
: ''}${optionConfig.default
? ` [default: ${formatOptionVal(optionConfig.default)}]`
: ''}`;
optionsToRender.set(optionName, {
renderedFlagAndAlias,
renderedDescription,
renderedTypesAndDefault,
});
}
ui.div({
text: 'Options:',
padding: [1, 0, 0, 0],
});
for (const { renderedFlagAndAlias, renderedDescription, renderedTypesAndDefault, } of optionsToRender.values()) {
const cols = [
{
text: renderedFlagAndAlias,
width: requiredSpaceToRenderAllFlagsAndAliases +
flagAndAliasLeftPadding +
flagAndAliasRightPadding,
padding: [0, flagAndAliasRightPadding, 0, flagAndAliasLeftPadding],
},
{
text: renderedDescription,
padding: [0, 0, 0, 0],
},
{
text: renderedTypesAndDefault,
padding: [0, 0, 0, 0],
align: 'right',
},
];
ui.div(...cols);
}
return ui.toString();
}
function generateExamplesOutput(schema) {
if (!schema.examples || schema.examples.length === 0) {
return '';
}
const ui = cliui();
const xPadding = 4;
ui.div({
text: 'Examples:',
padding: [1, 0, 0, 0],
});
for (const { command, description } of schema.examples) {
const cols = [
{
text: command,
padding: [0, xPadding, 0, xPadding],
},
{
text: description || '',
padding: [0, 2, 0, 0],
},
];
ui.div(...cols);
}
return ui.toString();
}
// TODO: generalize link generation so it works for non @nrwl plugins as well
function generateLinkOutput({ pluginName, name, type, }) {
const nrwlPackagePrefix = '@nrwl/';
if (!pluginName.startsWith(nrwlPackagePrefix)) {
return '';
}
const link = `https://nx.dev/packages/${pluginName.substring(nrwlPackagePrefix.length)}/${type}/${name}`;
return `\n\n${chalk.dim('Find more information and examples at:')} ${chalk.bold(link)}`;
}
//# sourceMappingURL=print-help.js.map