argsclopts

argsclopts

cliclopts but for Node.js parseArgs. A library that formats standard usage strings using the node:util parseArgs options object shape with an additional help field added to it.

npm install argsclopts

Usage

import { formatHelpText, printHelpText } from 'argsclopts'
import { join } from 'node:path'
import { parseArgs } from 'node:util'

const pkgPath = join(import.meta.dirname, 'package.json')

/** @type {ArgscloptsParseArgsOptionsConfig} */
const options = {
  foo: {
    type: 'boolean',
    short: 'f',
    help: 'A foo flag thats a boolean'
  },
  bar: {
    type: 'string',
    help: 'A bar flag thats a string'
  }
}

await printHelpText({
  options,
  pkgPath
})
/*

Usage: argsclopts [options]

    Example: argsclopts

    --foo, -f             A foo flag thats a boolean
    --bar                 A bar flag thats a string

argsclopts (v1.0.0)

 */

const args = ['-f', '--bar', 'b']
const { values } = parseArgs({ args, options })
// { foo: true, bar: 'b' }

License

MIT

Changelog

v1.0.1 - 2023-12-26

Commits

• Fix type exports 124b00f
• Fix matrix 1373c20
• Fix minimum node.js version ff96dd5