@jakubmazanec/args NPM

@jakubmazanec/args

TypeScript-first library for parsing command line arguments.

Installation

npm install @jakubmazanec/args

⚠️ This is an ESM package! It cannot be required from a CommonJS module.

Prerequisites

Node.js 20 or later
TypeScript 5 or later

Usage

Main purpose of this library is to parse command line arguments. Such command line can look like this:

┌─ 1 ─┐ ┌─ 2 ──┐ ┌─── 3 ───┐ ┌─── 4 ───┐ ┌─ 5 ─┐ ┌ 6 ┐ ┌─── 7 ───┐    ┌─────── 8 ──────┐
binname do stuff --key value --key=value -key -K -aBCd foo bar baz -- --key value bar -B
└───────────────────────────────────────── 9 ──────────────────────────────────────────┘

Binary name. This is never passed to the parser.
Command name.
Option with a value. Option name can be in camel case or kebab case.
Another way to specify an option with a value.
Boolean options don't have to specify value to be true. Options can also be defined using a short option form.
Short options group; usually used for boolean options.
Parameters.
Rest arguments appear after the --; they are not parsed, but still included in the result.
The whole command line.

The parser is strict and returns fully typed result. You can use it by calling parseArguments function with the list of arguments and parser configuration:

import {parseArguments} from '@jakubmazanec/args';

let {command, parameters, options} = parseArguments(process.argv.slice(2), {
  commands: ['run', 'build'],
  parameters: [{
    description: 'File name',
    type: 'string',
    required: true,
  }],
  options: {
    help: {
      type: 'boolean'
    }
  }
});

console.log(command); // type of `command` is `'run' | 'build' | undefined`
console.log(parameters); // type of `parameters` is `[string | undefined]`
console.log(options); // type of `options` is `{help: boolean | undefined}`

See ParserConfig for more information about how to configure the parser.

Documentation

See API reference for auto-generated documentation.

Contributing

If you want to contribute, see CONTRIBUTING for details.

License

This package is licensed under the GNU Lesser General Public License v3. See LICENSE for details.

@jakubmazanec/error @jakubmazanec/ts-utils lodash.camelcase

@everything-registry/sub-chunk-479 @jakubmazanec/cli @jakubmazanec/carson

2.0.2-next.c370ab6

29 days ago

2.0.2-unstable.aabf88a

29 days ago

2.0.2

29 days ago

2.0.1-unstable.8a255cf

3 months ago

2.0.1-unstable.6280310

3 months ago

2.0.1-unstable.328069a

3 months ago

2.0.1-next.1788346

3 months ago

2.0.1-unstable.b6ba69d

3 months ago

2.0.1-next.60933d4

3 months ago

2.0.1-unstable.4c16ac4

3 months ago

2.0.1-unstable.d633ee1

3 months ago

2.0.1-unstable.252f405

3 months ago

2.0.1-unstable.72acda0

3 months ago

2.0.1-next.007199a

3 months ago

2.0.1

3 months ago

2.0.1-unstable.a0f1c6c

3 months ago

2.0.2-unstable.02361ab

3 months ago

2.0.1-next.b10d52c

3 months ago

2.0.1-unstable.4511742

3 months ago

2.0.1-unstable.c1124bc

3 months ago

2.0.1-unstable.e53a283

3 months ago

2.0.1-next.01330c0

3 months ago

2.0.1-unstable.0ca2e80

3 months ago

2.0.1-next.4fd23cd

3 months ago

2.0.1-unstable.8950118

3 months ago

2.0.1-unstable.3a31911

3 months ago

2.0.0

4 months ago

2.0.0-unstable.d2536fd

4 months ago

2.0.0-unstable.2bedd2e

4 months ago

2.0.0-unstable.317a120

4 months ago

2.0.0-unstable.86aab00

4 months ago

2.0.0-next.6fd9f2b

4 months ago

2.0.0-unstable.d608b34

4 months ago

2.0.0-next.2fa8a2c

4 months ago

2.0.0-unstable.6a05f12

4 months ago

2.0.0-unstable.8b424a1

4 months ago

2.0.0-unstable.c99c49a

4 months ago

2.0.0-unstable.910976a

4 months ago

2.0.0-unstable.d770f2b

4 months ago

2.0.0-unstable.8e9645f

4 months ago

2.0.0-unstable.19a45fc

4 months ago

2.0.0-unstable.1ee9ce2

4 months ago

2.0.0-unstable.da6d687

4 months ago

2.0.0-next.b3909a5

4 months ago

2.0.0-unstable.2e26ddc

4 months ago

2.0.0-unstable.7dac379

4 months ago

2.0.0-unstable.8e033b6

4 months ago

2.0.0-unstable.6cd4b09

4 months ago

2.0.0-unstable.8e11efb

4 months ago

2.0.0-unstable.51b807c4d510e27482ddb025410253be255728f7

4 months ago

2.0.0-unstable.758e894bb6568ca003ec4d38fce7621342609da0

4 months ago

2.0.0-next.bc04e4f

4 months ago

1.0.3-unstable.8755bd3

8 months ago

1.0.3-unstable.a7030bd

8 months ago

1.0.3-unstable.acde379

8 months ago

2.0.0-unstable.6911d99

7 months ago

1.0.3-unstable.ea6ebc1

8 months ago

1.0.3-unstable.ea63723

8 months ago

1.0.3-unstable.89fc227

8 months ago

1.0.3-unstable.10c91e9

8 months ago

1.0.3-unstable.d9e75d7

7 months ago

2.0.0-unstable.d4f095a

7 months ago

1.0.3-unstable.f5fb396

8 months ago

1.0.3-unstable.bbf0fc1

8 months ago

1.0.3-unstable.a0fe2af

8 months ago

1.0.3-unstable.e9d0080

8 months ago

1.0.3-unstable.7c4ef54

8 months ago

1.0.3-unstable.6e61e25

7 months ago

1.0.3-unstable.6687ed7

8 months ago

1.0.1-next.336fe21

10 months ago

1.0.3-unstable.405ea8c

8 months ago

1.0.3-unstable.9336232

8 months ago

1.0.3-unstable.5d88d67

8 months ago

1.0.3-unstable.5297f2a

8 months ago

1.0.3-unstable.acb858a

8 months ago

1.0.3-next.9befaf5

7 months ago

1.0.3-unstable.de4ec31

8 months ago

1.0.3-unstable.3da3496

8 months ago

1.0.3-unstable.c5ca0a6

8 months ago

1.0.3-unstable.223fef9

8 months ago

1.0.3-unstable.ea47924

8 months ago

1.0.3-unstable.7e16fab

8 months ago

2.0.0-unstable.e1ae458

7 months ago

2.0.0-unstable.b7f011e

7 months ago

1.0.3-unstable.8334afa

8 months ago

2.0.0-unstable.7132654

7 months ago

1.0.3-unstable.46ff02d

8 months ago

1.0.3-unstable.5dfb276

8 months ago

1.0.3-unstable.b091304

8 months ago

1.0.1-6cee770

11 months ago

1.0.3-unstable.4618ac4

8 months ago

1.0.3-unstable.2e438d8

8 months ago

1.0.3-unstable.95bac4e

8 months ago

1.0.3-unstable.4e04330

8 months ago

1.0.1-c2efc51

10 months ago

1.0.3-unstable.295aefc

8 months ago

1.0.3-unstable.8589854

8 months ago

1.0.3-unstable.3da7985

8 months ago

1.0.3-unstable.930003c

8 months ago

1.0.3-unstable.13f3047

8 months ago

1.0.3-unstable.c1b9f9c

8 months ago

1.0.3-unstable.cdaf806

8 months ago

1.0.3-unstable.5c4545f

8 months ago

1.0.3-unstable.38ae9a4

8 months ago

1.0.3-unstable.cadce43

8 months ago

1.0.3-unstable.6b2a867

8 months ago

1.0.3-next.9d07aa7

8 months ago

1.0.3-unstable.388cf16

8 months ago

1.0.3-unstable.ee5adfc

8 months ago

1.0.3-unstable.0dad1d5

8 months ago

1.0.3-unstable.8c049ad

8 months ago

1.0.3-unstable.1aaf72f

8 months ago

1.0.3-unstable.46a7f4b

8 months ago

1.0.3-unstable.2597180

8 months ago

1.0.3-unstable.e6428a6

8 months ago

1.0.3-unstable.b0ca372

8 months ago

1.0.3-unstable.bea1e1c

8 months ago

1.0.3-unstable.e5b73a8

8 months ago

1.0.1-dee6883

10 months ago

1.0.3-unstable.c231c3b

8 months ago

1.0.3-next.b415399

8 months ago

1.0.3-unstable.78c0cef

8 months ago

1.0.3-unstable.602582

8 months ago

1.0.3-unstable.1111aff

8 months ago

2.0.0-next.7a1e391

7 months ago

1.0.3-unstable.e3501ac

8 months ago

1.0.3-unstable.98d288d

8 months ago

1.0.3-unstable.a140fa7

8 months ago

1.0.3-unstable.e450c3c

8 months ago

1.0.3-unstable.220b226

8 months ago

1.0.3-unstable.dce03f8

8 months ago

1.0.3-unstable.3dd2bcd

8 months ago

1.0.3-unstable.ce2ac63

8 months ago

1.0.3-unstable.21627cc

8 months ago

1.0.3-unstable.e04c147

8 months ago

1.0.3-unstable.7a069e8

8 months ago

1.0.3-unstable.6b9057c

8 months ago

1.0.3-unstable.1ccb0cc

8 months ago

1.0.3-unstable.3ad3cf0

8 months ago

1.0.3-unstable.545e925

8 months ago

1.0.3-unstable.8a2d633

8 months ago

1.0.3-unstable.bdbbb4e

8 months ago

1.0.3-unstable.d29d212

8 months ago

1.0.3-unstable.d4769e9

8 months ago

1.0.3-unstable.72268f3

8 months ago

1.0.3-unstable.dfc4b9f

8 months ago

1.0.3-unstable.cbdae0f

8 months ago

1.0.3-unstable.d49edce

8 months ago

1.0.3-unstable.94dacaf

8 months ago

1.0.3-unstable.167071b

7 months ago

2.0.0-unstable.3667788

7 months ago

1.0.3-unstable.2a98151

8 months ago

1.0.3-unstable.e74e3b0

8 months ago

1.0.3-unstable.543e40b

7 months ago

1.0.3-unstable.e9e0a11

8 months ago

1.0.3-unstable.5215a84

8 months ago

1.0.3-unstable.81f2778

8 months ago

2.0.0-unstable.3ac9fee

7 months ago

1.0.3-unstable.e257438

8 months ago

1.0.3-unstable.57484e0

8 months ago

1.0.3-unstable.fe64d91

8 months ago

1.0.1-8a0a4d5

10 months ago

1.0.3-unstable.b58591f

7 months ago

1.0.3-unstable.1d3f3cf

8 months ago

1.0.3-unstable.5bce5ef

8 months ago

1.0.3-unstable.4404435

8 months ago

1.0.3-unstable.a9a85c7

8 months ago

1.0.3-unstable.ae0125b

8 months ago

1.0.3-unstable.d1212bb

7 months ago

1.0.3-unstable.45b2fab

8 months ago

1.0.3-unstable.1d5fc05

8 months ago

1.0.3-unstable.67cc17a

8 months ago

1.0.3-unstable.d787d0f

8 months ago

1.0.3-unstable.8eee6d8

8 months ago

1.0.3-unstable.aa82b1b

8 months ago

1.0.3-unstable.39e69e6

8 months ago

1.0.3-unstable.0e66c97

8 months ago

1.0.3-unstable.6a8381c

8 months ago

1.0.3-unstable.631622e

8 months ago

1.0.2-a1d4551

10 months ago

1.0.3-unstable.9902dec

8 months ago

1.0.3-unstable.eb2431b

8 months ago

1.0.3-next.d2852b5

8 months ago

1.0.3-unstable.08c966c

8 months ago

1.0.3-unstable.073c0e5

8 months ago

1.0.3-unstable.caa501a

8 months ago

1.0.3-unstable.4a58d5e

8 months ago

1.0.3-unstable.6c890e9

8 months ago

1.0.3-unstable.36cf477

8 months ago

1.0.3-unstable.2591690

8 months ago

1.0.1-2f12db0

10 months ago

1.0.3-unstable.299fb5c

8 months ago

1.0.3-unstable.5bc869e

8 months ago

1.0.3-unstable.7512f15

8 months ago

1.0.3-unstable.43a2026

8 months ago

1.0.3-unstable.14bb66b

8 months ago

1.0.3-unstable.2df275d

8 months ago

1.0.3-unstable.f923fd1

8 months ago

1.0.3-unstable.c6b7682

8 months ago

1.0.3-unstable.a9aedfa

8 months ago

1.0.3-unstable.97f7e79

8 months ago

1.0.3-unstable.35999f0

8 months ago

2.0.0-unstable.a0cd1f8

7 months ago

1.0.3-unstable.725c222

8 months ago

1.0.3-unstable.1f723d4

8 months ago

1.0.3-unstable.c5e3212

8 months ago

1.0.3-unstable.666d04c

8 months ago

1.0.3-unstable.9467133

8 months ago

1.0.3-unstable.06e7dac

8 months ago

1.0.3-unstable.192ddba

8 months ago

1.0.1-bc209e5

11 months ago

2.0.0-next.7305494

7 months ago

1.0.3-unstable.cf4d1a0

8 months ago

1.0.3-unstable.885a28b

8 months ago

1.0.3-unstable.e435446

8 months ago

1.0.3-unstable.0b889ab

8 months ago

1.0.3-unstable.a353e66

8 months ago

1.0.3-unstable.97b73cf

8 months ago

1.0.3-unstable.5ce2b3e

8 months ago

1.0.3-unstable.feec6e4

8 months ago

1.0.3-unstable.f75ec2c

8 months ago

1.0.3-unstable.90a960b

8 months ago

1.0.3-unstable.90386ed

7 months ago

1.0.3-unstable.4ff14d2

7 months ago

1.0.3-next.9d6cd14

8 months ago

1.0.3-unstable.e6dbd8e

8 months ago

2.0.0-unstable.189c423

7 months ago

1.0.3-unstable.2f413d0

8 months ago

2.0.0-next.b19329b

7 months ago

1.0.3-unstable.8a71f81

8 months ago

1.0.3-unstable.ce0f6d1

8 months ago

1.0.3-unstable.8e590dd

8 months ago

1.0.3-unstable.3be4421

7 months ago

1.0.3-unstable.cb9bdb5

7 months ago

1.0.3-unstable.8436744

8 months ago

1.0.3-unstable.2817fd8

8 months ago

2.0.0-next.f3375f0

7 months ago

1.0.3-unstable.8213cd0

8 months ago

1.0.3-unstable.ee79c72

8 months ago

1.0.3-unstable.3b9577f

8 months ago

1.0.3-unstable.586a409

7 months ago

1.0.3-unstable.6938500

8 months ago

1.0.3-unstable.48a6bfe

8 months ago

1.0.3-unstable.530e73b

8 months ago

1.0.3-unstable.4b690ca

8 months ago

1.0.3-unstable.572511b

8 months ago

1.0.3-unstable.b59ddc3

8 months ago

1.0.3-next.50761cf

8 months ago

1.0.3-next.439463c

8 months ago

1.0.3-unstable.3637af5

8 months ago

1.0.3-unstable.615da07

8 months ago

1.0.3-unstable.2cb2a47

7 months ago

1.0.3-unstable.9236437

8 months ago

1.0.3-unstable.877d034

8 months ago

1.0.3-unstable.4f716aa

8 months ago

1.0.3-unstable.66aafb1

8 months ago

1.0.3-next.75b0d46

8 months ago

1.0.3-unstable.5ff2aeb

8 months ago

1.0.3-unstable.cc465af

8 months ago

1.0.3-unstable.f940d9d

8 months ago

1.0.3-unstable.b52c849

8 months ago

1.0.3-unstable.340471e

8 months ago

1.0.3-unstable.b1b56c3

8 months ago

1.0.3-unstable.962c7ae

8 months ago

1.0.3-unstable.e85d9ba

8 months ago

1.0.3-unstable.7f9cc58

8 months ago

1.0.3-unstable.bf82559

8 months ago

1.0.1-7dbb232

10 months ago

1.0.3-unstable.c8f5ee0

8 months ago

1.0.3-unstable.b80d0cb

8 months ago

1.0.3-unstable.d8bf4ea

8 months ago

1.0.3-unstable.e8eb8d0

8 months ago

1.0.3-unstable.7092a41

8 months ago

1.0.3-unstable.584de52

8 months ago

2.0.0-next.f9ef3d7

7 months ago

1.0.3-unstable.6fcabe8

8 months ago

1.0.3-unstable.e413f6f

7 months ago

1.0.3-unstable.d3385e0

8 months ago

1.0.3-unstable.f8ff4ab

8 months ago

2.0.0-unstable.3c15a37

7 months ago

1.0.3-unstable.22b5b18

8 months ago

1.0.3-unstable.29ebd36

8 months ago

1.0.3-unstable.deecda2

8 months ago

1.0.3-unstable.ef6259f

8 months ago

1.0.3-unstable.24d65b3

8 months ago

1.0.3-unstable.e69a5f6

8 months ago

1.0.3-unstable.c704980

7 months ago

1.0.3-unstable.5229d4f

8 months ago

1.0.3-unstable.2865932

8 months ago

1.0.3-unstable.e988018

8 months ago

1.0.2

9 months ago

1.0.1

10 months ago

1.0.3-unstable.8c1e38b

8 months ago

1.0.3-unstable.a00c537

8 months ago

1.0.3-unstable.d79a5d6

8 months ago

1.0.3-unstable.2f2be89

8 months ago

1.0.3-unstable.abc6b38

8 months ago

1.0.2-2487994

10 months ago

1.0.3-unstable.d62cd2d

8 months ago

1.0.3-unstable.ac162c7

8 months ago

1.0.3-unstable.5283b6c

8 months ago

1.0.3-unstable.ea41475

8 months ago

1.0.3-unstable.a7d88fd

8 months ago

1.0.3-unstable.e147f50

8 months ago

1.0.3-unstable.aa3dec1

8 months ago

1.0.3-unstable.3c60a9c

8 months ago

1.0.3-unstable.14a1cb1

8 months ago

1.0.3-unstable.7591857

7 months ago

1.0.3-unstable.b092e35

8 months ago

1.0.3-unstable.7ebe8ea

8 months ago

1.0.3-unstable.3da3299

8 months ago

1.0.3-unstable.0a46009

8 months ago

1.0.3-unstable.9445fd0

8 months ago

1.0.3-unstable.252f790

8 months ago

2.0.0-unstable.8493a76

7 months ago

1.0.3-unstable.4e972e4

8 months ago

1.0.3-unstable.d10e94c

8 months ago

1.0.3-unstable.77a5659

8 months ago

1.0.3-unstable.4003198

7 months ago

1.0.3-unstable.702ab33

8 months ago

1.0.3-unstable.7244fec

8 months ago

1.0.3-unstable.71facd5

8 months ago

1.0.3-unstable.18ca4d7

8 months ago

1.0.3-unstable.7a242bf

8 months ago

1.0.3-unstable.ed5e468

8 months ago

1.0.3-unstable.de587b4

8 months ago

1.0.3-unstable.b5b5157

8 months ago

1.0.3-unstable.b4c8081

8 months ago

1.0.3-unstable.dca66ea

8 months ago

1.0.3-unstable.8dfdd38

8 months ago

1.0.3-unstable.8970b19

8 months ago

2.0.0-unstable.c786328

7 months ago

1.0.3-unstable.90fd70e

8 months ago

1.0.3-unstable.55120fe

8 months ago

2.0.0-next.a956e19

7 months ago

1.0.3-unstable.ec85702

8 months ago

1.0.3-unstable.61110d2

8 months ago

1.0.3-unstable.958c081

8 months ago

1.0.3-unstable.23e5fdb

8 months ago

1.0.3-unstable.2d137c8

8 months ago

1.0.3-unstable.6a7b21e

8 months ago

1.0.3-unstable.5126cab

8 months ago

1.0.3-next.ce9dbc3

8 months ago

1.0.3-unstable.4abdd23

8 months ago

1.0.3-unstable.85be58e

8 months ago

1.0.3-unstable.ee1b9cf

8 months ago

1.0.3-unstable.7558bcb

8 months ago

1.0.3-unstable.ea51d67

8 months ago

1.0.2-b8faa49

9 months ago

1.0.3-unstable.7a8377c

8 months ago

1.0.3-unstable.89f927f

8 months ago

1.0.3-unstable.bba77a6

8 months ago

1.0.3-unstable.27ccd20

8 months ago

1.0.3-unstable.5ed9143

8 months ago

1.0.3-unstable.7611550

8 months ago

1.0.3-unstable.2543f27

8 months ago

1.0.3-unstable.8fd9941

8 months ago

1.0.3-unstable.0b27125

8 months ago

1.0.3-unstable.6741606

8 months ago

1.0.3-unstable.51b6b15

8 months ago

1.0.2-next.121ef1e

9 months ago

1.0.3-unstable.a0049f7

8 months ago

1.0.3-unstable.653a9d8

8 months ago

1.0.3-unstable.598569d

8 months ago

1.0.3-unstable.6786638

8 months ago

1.0.3-unstable.bfb41e2

8 months ago

1.0.3-unstable.b54933a

8 months ago

1.0.3-next.1b2cc9c

8 months ago

1.0.3-unstable.cb196ab

8 months ago

1.0.3-unstable.23d35f2

8 months ago

1.0.3-unstable.170aae6

8 months ago

1.0.3-unstable.66840f2

7 months ago

1.0.3-unstable.bcab553

8 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago