# @hacker-und-koch/getopt

> Options of this type will not lead to collecting a value if provided. Instead it is only checked if either the argument vector or the process environment contain the configured value. The parsed value for an option of this type will always be `true` or `f

Latest version **0.2.1** (published 2021-07-14) · LGPL-3.0 license · 0 weekly downloads

## Install

```sh
npm install @hacker-und-koch/getopt
pnpm add @hacker-und-koch/getopt
yarn add @hacker-und-koch/getopt
bun add @hacker-und-koch/getopt
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.1 |
| Published | 2021-07-14 |
| First published | 2020-03-22 |
| Weekly downloads | 0 |
| License | LGPL-3.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 27.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | hacker-und-koch |

## Links

- npm: https://www.npmjs.com/package/@hacker-und-koch/getopt
- Repository: https://github.com/hacker-und-koch/ts-node-additions
- Homepage: https://github.com/hacker-und-koch/ts-node-additions#readme
- Issues: https://github.com/hacker-und-koch/ts-node-additions/issues
- npm.io page: https://npm.io/package/@hacker-und-koch/getopt

## Recent versions

- 0.2.1 (latest) — 2021-07-14
- 0.2.0 — 2021-07-14
- 0.1.14 — 2021-07-14
- 0.1.13 — 2021-07-14
- 0.1.8 — 2021-07-13
- 0.1.7 — 2021-07-13
- 0.0.7 — 2020-05-31
- 0.0.6 — 2020-05-21
- 0.0.5 — 2020-04-29
- 0.0.4 — 2020-04-25
- 0.0.3 — 2020-03-22
- 0.0.2 — 2020-03-22
- 0.0.1 — 2020-03-22

## README

# @hacker-und-koch/getopt
## Option types
### `'boolean'`
Options of this type will not lead to collecting a value if provided. Instead it is only checked if either the argument vector or the process environment contain the configured value. The parsed value for an option of this type will always be `true` or `false`.

**Example:**
```
$ foo -x -y
getopt.shortOption('x') // true
getopt.shortOption('y') // true
getopt.shortOption('z') // false
```
### `'string'`
The parser will try to collect a value for if a `'string'` option is provided. It will raise an error if it failes to do so.

**Example:**
```
$ foo --bar baz
getopt.option('bar')    // 'baz'
getopt.option('lorem')  // undefined
```
### `'array'`
This option is very similar to the `'string'` type, but it allows for multiple mentions of the same option key. The parsed value of this option will always be a `string[]`.
**Example:**
```
$ foo --key val1 --key val2
getopt.option('key')    // ['val1', 'val2']
```
## Value Population
For every option it is tried to fetch a value in the following order. If none is found the returned value will be `false`, `undefined` or `[]` depending on the type.
```
+----------------------+
|      in command      |
|                      |
| -k=value     OR      |
| -k value     OR      |
| --key=value  OR      |
| --key value          |
+----------v-----------+
           |
+----------v-----------+
|    in environment    |
|                      |
| KEY=value            |
+----------v-----------+
           |
+----------v-----------+
|      in config       |
|                      |
| {                    |
|    ...               |
|    options: [{       |
|      type: 'string'  |
|      short: 'k',     |
|      long: 'key',    |
|      default: 'foo', |  <--
|      ...             | 
|    }]                |
| }                    |
+----------------------+
// use string[] default for 'array' type
```

### Emphasising `'array'` type population
For options of type `'array'` the evironment alias will only be used if there is no mention of the option in the command. It will not be added to the resulting array. Also the default values will only be provided as parsed result if the option is neither provided in the command call, nor the environment. There is no merging of arrays.

---
_Source: https://npm.io/package/@hacker-und-koch/getopt · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
