giv 0.2.0

A CLI for generating useful values.
Documentation 
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

# giv

[![Crates.io](https://img.shields.io/crates/v/giv.svg)](https://crates.io/crates/giv)
[![Documentation](https://docs.rs/giv/badge.svg)](https://docs.rs/giv)
[![Downloads](https://img.shields.io/crates/d/giv.svg)](https://crates.io/crates/giv)
[![License](https://img.shields.io/crates/l/giv.svg)](https://github.com/theroyalwhee0/giv)

A CLI for generating useful values.

## Available Commands

- `giv bytes`: Generate random bytes with various encodings.
  - Base64 (default, no padding): `giv bytes`
  - Hex encoding: `giv bytes -e hex`
  - Base64 with padding: `giv bytes -e base64 --pad`
  - Rust array: `giv bytes -e rust 16`
  - JavaScript array: `giv bytes -e javascript 16`
  - TypeScript array: `giv bytes -e typescript 16`
  - Raw bytes: `giv bytes -e raw 100 | hexyl`
- `giv chars`: Convert emoji shortcodes and character patterns to Unicode.
  - Emoji: `giv chars :smile: :rocket: :thumbsup:`
  - Fractions: `giv chars 1/4 1/2 3/4`
  - Symbols: `giv chars "(c)" "(r)" "(tm)"`
  - Arrows: `giv chars -- "->" "<-" "=>"`
  - Punctuation: `giv chars "..." "--"`
  - Greek: `giv chars alpha beta gamma delta lambda pi omega`
  - Multiple: `giv chars 1/4 :smile: "(c)" lambda` → `¼ 😄 © λ`
- `giv date`: Prints the date in various formats.
  - `giv now`: Prints the current time in various formats.
- `giv uuid`: Print a random UUID v7.
- `giv key`: Prints a strong random key with a 'key_' prefix.
- `giv pi`: Prints the requested number of digits of PI with rounding.
- `giv rng`: Generate cryptographically secure random numbers.
  - Dice notation: `giv rng 2d6`, `giv rng d20`
  - Integer ranges: `giv rng 1..100`
  - Float ranges: `giv rng 0.0..1.0`, `giv rng 0.000..1`
  - Multiple specs: `giv rng 2d6 1..100 0.0..1.0`

`giv --help` for basic help. `giv <COMMAND> --help` for help on a specific command.

## Development Notes

- This project uses a whitelist approach to the `.gitignore`.

## Security

For security vulnerabilities and reporting guidelines, see [SECURITY.md](SECURITY.md).

## License

Copyright © 2025 Adam Mill

Licensed under the Apache License, Version 2.0. See [LICENSE.txt](LICENSE.txt) for details.