timer-cli-rs 1.0.0

A super lightweight command-line countdown timer.
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

# Timer CLI

## Description

A simple command-line countdown timer written in Rust.

## Features

- Accepts human-friendly duration formats (e.g., `10s`, `5m`, `2h`, `1d`, `10 seconds`).
- Defaults to 10 seconds if no duration is provided.
- Caps maximum duration at 10 years.
- Displays time remaining in `HH:MM:SS`.
- Clears and updates the line dynamically.
- Handles *most* errors gracefully.

## Usage

```bash
timer <duration>
```

### Duration format

- `10s`, `30sec`, `45seconds`
- `500ms`, `1500msec`
- `5m`, `2min`, `10minutes`
- `1h`, `2hr`, `3hours`
- `1d`, `2days`

If no duration is provided, defaults to **10 seconds**.
Maximum supported duration: **10 years**.
Ignores whitespace between time and duration (`5 s`).

## Examples

```bash
timer 10s     # 10 seconds
timer 5m      # 5 minutes
timer 2h      # 2 hours
timer 1d      # 1 day
```

## Build

```bash
git clone https://github.com/Andrew-McCall/timer-cli-rs.git
cd timer-cli-rs
cargo build --release
./target/release/timer 30s
```

## License

MIT License
Copyright (c) 2025 Andrew McCall