readme.md

cli-meow-help

Generate automatically formatted help text for meow CLI helper

Install

npm install cli-meow-help

Usage

const meow = require('meow');
const meowHelp = require('cli-meow-help');

const commands = {
	new: {desc: `Creates a new user account`},
	duplicate: {desc: `Duplicates a user account`}
};

const flags = {
	random: {
		desc: `Prints random data`,
		type: 'boolean',
		default: true
	}
};

const helpText = meowHelp({
	name: `cli-command`,
	flags,
	commands
});

meow(helpText, {flags});

// Now run `cli-command --help` to view the
// following auto formatted & generated help info.

API

meowHelp(options)

❯ options

Type: object

Default: ↓

{
	name = `(CLI name undefined)`,
	desc,
	commands = {},
	flags = {},
	defaults = true,
	header,
	footer
}

You can specify the options below.

❯ name

Type: string
Default: (CLI name undefined)

The bin command name of the cli that's used to run the CLI. Examples: corona for the corona-cli that's installed globally or npx corona-cli for if npx is the recommended usage.

❯ desc

Type: string
Default: undefined (optional)

Optionally define a description text for the help message.

❯ commands

Type: string
Default: {} (optional)

Optionally, define a JavaScript object containing info on the CLI commands (i.e. meow inputs). Each command has a desc property to define the help text.

❯ flags

Type: string
Default: {}

Define CLI options (i.e. meow flags) just like you do with meow which is the flags JavaScript object containing each flag with an extra desc property to define the help text.

❯ defaults

Type: string
Default: true (optional)

Prints out the default values of flags. Set to false to disable.

❯ header

Type: string
Default: undefined (optional)

Optionally, add additional header information.

❯ footer

Type: string
Default: undefined (optional)

Optionally, add additional footer information.

Changelog

❯ Read the changelog here →

KEY: 📦 NEW, 👌 IMPROVE, 🐛 FIX, 📖 DOC, 🚀 RELEASE, and 🤖 TEST

I use Emoji-log, you should try it and simplify your git commits.

License & Conduct

• MIT © Ahmad Awais
• Thanks to Maarten Brakkee for initial implementation
• Code of Conduct

Connect

 (follow) To stay up to date on free & open-source software

 (follow) To get #OneDevMinute daily hot tips & trolls

 (subscribe) To tech talks & #OneDevMinute videos

 (read) In-depth & long form technical articles

 (connect) On the LinkedIn profile y'all

Sponsor

Me (Ahmad Awais) and my incredible wife (Maedah Batool) are two engineers who fell in love with open source and then with each other. You can read more about me here. If you or your company use any of my projects or like what I’m doing then consider backing me. I'm in this for the long run. An open-source developer advocate.

• 🌟 $9.99/month (recommended) ❯ Two cups of Caffè latte (coffee) every month →
• 🚀 $99.99 (one-time sponsor) ❯ Support an hour of open-source code →
• 🔰 $49.99 (one-time sponsor) ❯ Support an hour of maintenance →
• ☕️ $9.99 (one-time sponsor) ❯ Lunch/coffee →

Or you can back me by checking out my super fun video course. As developers, we spend over 200 Hrs/month with our code editors — it's only fair to learn your next editor deeply. This course will save you 15-20 hours every month. Become a VSCode Power User →

VSCODE