giv

Crates.io	giv
lib.rs	giv
version	0.2.3
created_at	2025-10-01 21:24:31.792948+00
updated_at	2025-10-31 21:35:45.229689+00
description	A CLI for generating useful values.
homepage
repository	https://github.com/theroyalwhee0/giv
max_upload_size
id	1863518
size	300,677

Adam Mill (theroyalwhee0)

documentation

README

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:
- HTML entities: giv chars " " "©" "<"
- Fractions: giv chars 1/4 1/2 3/4
- Symbols: giv chars "(c)" "(r)" "(tm)"
- Arrows: giv chars -- "->" "<-" "=>"
- Punctuation: giv chars "..." em (em-dash: —)
- Greek: giv chars alpha beta gamma delta lambda pi omega
- Multiple: giv chars 1/4 :smile: "(c)" lambda → ¼ 😄 © λ
- Note: Patterns starting with - (like -- or ->) require quoting or using -- separator: giv chars -- "--" "->" or giv chars em for em-dash
giv date: Prints the date in various formats.
- giv now: Prints the current time in various formats.
giv uuid: Generate UUIDs with multiple versions and formats.
- UUID v7 (default): giv uuid
- UUID v4: giv uuid --version v4
- Simple format: giv uuid --format simple
- Braced format: giv uuid --format braced
- URN format: giv uuid --format urn
- Hex format: giv uuid --format hex
- Uppercase: giv uuid --uppercase
giv key: Prints a strong random key with a 'key_' prefix.
giv lorem: Generate lorem ipsum placeholder text.
- Words (default): giv lorem 50
- Sentences: giv lorem -s 3
- Paragraphs: giv lorem -p 2
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.

Global Options

--clip / -c: Copy output to clipboard (still prints to stdout)
--json / -j: Format output as JSON

Examples:

giv --clip uuid           # Copy UUID to clipboard + print
giv -c now                # Copy timestamp to clipboard + print
giv --json uuid           # Output UUID as JSON
giv --clip --json key 32  # Copy JSON to clipboard + print

Development Notes

This project uses a whitelist approach to the .gitignore.

Security

For security vulnerabilities and reporting guidelines, see SECURITY.md.

License

Licensed under the Apache License, Version 2.0. See LICENSE.txt for details.

Commit count: 0

giv