minmax-cli 0.1.0-beta.5

programs computing min and max argument values
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# min / max cli programs

[![Version](https://img.shields.io/crates/v/minmax-cli.svg)](https://crates.io/crates/minmax-cli)
[![License](https://img.shields.io/crates/l/minmax-cli)](https://unlicense.org)
[![MSRV](https://img.shields.io/crates/msrv/minmax-cli?logo=rust&label=MSRV&labelColor=orange)](https://blog.rust-lang.org/2022/05/19/Rust-1.61.0/)
[![Safe Rust](https://img.shields.io/badge/Rust-safe-brightgreen.svg)](https://doc.rust-lang.org/nomicon/meet-safe-and-unsafe.html)
[![Dependency status](https://deps.rs/repo/gitlab/hsn10/minmax-cli/status.svg)](https://deps.rs/repo/gitlab/hsn10/minmax-cli)
[![Downloads](https://img.shields.io/crates/d/minmax-cli)](https://crates.io/crates/minmax-cli/versions)
[![](https://tokei.rs/b1/gitlab/hsn10/minmax-cli?category=code)](https://github.com/XAMPPRocky/tokei)

Two small Rust command‑line tools that reads numeric arguments, validates them,
and prints the value with the lowest / highest comparable magnitude.

The comparison can be done either on the raw numbers or on their absolute values.
Optionally, absolute value of selected number can be printed.

## Features

- Accepts any number of positional arguments and parses them as `f64`.
- Rejects invalid input, including:
  - Non‑numeric values
  - `NaN`
  - `+∞` or `−∞`
- Supports selecting the minimum by **absolute value**.
- Supports **printing** absolute value of *returned* number.
- Provides version and help output.
- Returns meaningful exit codes for different error conditions.

---

## Usage

min|max [-v | -?] | [-a | -A] \<number\> ...

### Options

- `-v`
  Print program version and exit.
- `-?`
  Show help message.
- `-a`
  Compare numbers by their **absolute value** instead of their raw value.
- `-A`
  Print absolute value of **returned** number. Implies `-a`.

### Positional Arguments

- One or more numeric values (`f64`).
- All values must be finite and valid floating point numbers.
- If any argument fails validation, the program exits with an error code.

## Behavior

### Normal Operation

1. Parse all positional arguments as floating‑point numbers.
2. Reject any argument that:
   - Cannot be parsed
   - Is `NaN`
   - Is infinite
3. Optionally compare all numbers by their absolute values (`-a`).
4. Find the index of the smallest / largest comparable number.
5. Print the **original** number at that index, unless (`-A`) is used.
   In that case print absolute value of number.

### Exit Codes

| Code | Meaning |
|------|---------|
| `0`  | Success |
| `1`  | No numeric arguments provided |
| `2`  | One or more arguments failed to parse or were invalid |

## Example

```
$ min 5 -3 9
-3
$ min -a 5 -3 9 1
1
$ min -a -20 34 566 -105
-20
$ min -A -20 34 566 -105
20
$ min 10 foo 2
Error parsing 'foo': invalid float literal
```

### MSRV

*min* and *max* cli programs needs Rust [version 1.61](https://blog.rust-lang.org/2022/05/19/Rust-1.61.0/).

## License

This is free and unencumbered software released into the public domain.

This code can be used under terms of [CC0-1.0](https://creativecommons.org/publicdomain/zero/1.0/) or
the [Unlicense](https://unlicense.org).

![Unlicense logo](https://unlicense.org/pd-icon.png)