JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 10
  • Score
    100M100P100Q21526F
  • License MIT

Options parsing & nothing else.

Package Exports

  • toptions

Readme

toptions

Options parsing & nothing else.

Features

  • Parses options
  • Optional configuration
  • TypeScript support
  • No coercion
  • No validation
  • No dependencies

Install

npm install toptions
# or
pnpm add toptions
# or
yarn add toptions
# or
bun add toptions

Example

import options from "toptions"

const parse = options({
  // Positional option
  path: options.arg(0),
  // Named option (type is: string | undefined)
  dist: options.flag("d"),
  // Named option with a default (type is: string)
  port: options.flag("p", 3000),
  // Append multiple values to "exclude"
  exclude: options.list("e"),
  // Boolean --help option
  help: options.bit("h"),
  // Increments the "log" option
  log: options.level("l"),
  // Parses everything after a --
  nodeargs: options.raw(),
  // Parses everything after given positional index
  // Other options will still be parsed
  // Useful for conditionally passing the rest of the options to another command
  args: options.rest(0),
})

const { path, dist, port, exclude, help, log, nodeargs, args } = parse(process.argv.slice(2))