A suite of utilities for webpack projects which expose a CLI. The aim of this module is to provide a uniform experience for displaying CLI help (--help), parsing options for CLI flags, flag recommendations - or "did you mean", and validation of flags.

This module requires a minimum of Node v6.9.0 and Webpack v4.0.0.

To begin, you'll need to install cli-utils:

$ npm install @webpack-contrib/cli-utils --save

The exported functions of this module assume that flags are stored in a JSON schema compatible with meow. The schema should follow the format of:

{
  key: { object description }
}

Where key represents a flag, including any hyphens, but excluding the leading hyphen(s). And object description matches the following format:

{
  "alias": <String>,
  "deprecated": <Boolean>,
  "desc": <String>,
  "type": <Array|String> of [array, boolean, object, string]
}

For which all keys are optional, but a desc should be provided at a minimum.

The alias property contains a flag which can be used as an alias to the parent key/flag.
The deprecated property indicates that a flag has been deprecated and requires special notation.
The desc property should contain a reasonable description of the flag. This can include newline characters which will be considered when rendering help.
The type property specifies the type of value that the flag should contain. If this property is omitted, any type is considered valid. If more than one type is possible, specify an array of the valid types. eg. ["boolean", "string"].

This module exports three functions: getHelp, getOpts, and validate.

Returns: String
Parameters:

Type: Object
Required

An object containing a valid flag schema.

Returns: Object Parameters:

Type: Object
Required

An object containing a valid flag schema.

Returns: Boolean Parameters:

Type: Object { argv, flags, prefix, throw }
Required

An object containing properties used to validate a set of flags against a flag schema.

Type: Object
Required

An object containing the parsed result from either minimist or yargs-parser.

Type: Object
Required

An object containing a valid flag schema.

Type: String
Default: 'webpack'

A String specifying a prefix identifier for the consuming module, used when reporting errors.

Type: Boolean
Default: true

A Boolean specifying whether or not to throw an error when a validation error is encountered. If false, will simply log the error and return false.

Please take a moment to read our contributing guidelines if you haven't yet done so.