Puff

Puff is a command-line tool designed to quickly generate random values in various formats such as hexadecimal strings, UUIDs, and binary blobs. Whether for testing, cryptographic purposes, or data seeding, Puff makes the process straightforward.

Installation

macOS

brew install chronohq/tap/puff

Linux

1. Download the latest binary release for your system
2. Extract the binary into /usr/local/bin, for example:

rm /usr/local/bin/puff && tar -C /usr/local/bin xvzf puff-1.2.3.linux-amd64.tar.gz

Windows

1. Download the latest binary release for your system
2. Extract the binary using the built-in Windows file explorer or a tool like 7-Zip
3. Move puff.exe to a directory in your PATH
4. Open Windows Terminal and run puff.exe from any directory

Quickstart

Print Hexadecimal Values (Default: 16 Bytes)

Use puff hex --help to view available command options.

# Print a single hex-encoded value
puff hex
2cc84ba90e5277f6733aa71386a4de3b

# Print two hex-encoded values
puff hex -n 2
f906e2fa87fbf6e9f0b0b44e2fc81993
5d7347c2fe7fda44097604c06ae4f25f

# Print a hex-encoded value with custom byte length (32 bytes)
puff hex --bytes 32
8c5955a659c59d4414072b45bac872964a8a8077ffbd0f0083ffad47e5b33c66

# Print hex-encoded values separated by a comma
puff hex -n 2 --delimiter ","
d4bc48da024a728fee985a6257e88611,63100951b7ff67de3f7e9c1d0b98101d

Print UUIDs as Hexadecimal Values

By default, Puff generates version 7 UUIDs, but version 4 is also supported. Use puff uuid --help to view available command options.

# Print two version 7 UUIDs in the standard dashed format
puff uuid -n 2
019191ac-e84b-7e58-8ca9-d44d68ecd15f
019191ac-e84b-7e92-b277-07c67a7db551

# Print two compact, dash-less version 7 UUIDs
puff uuid -n 2 --compact
019191ace35c71bfb517a4c1269716b8
019191ace35c71fa8d14ddf9e56c1faf

# Print a compact, dash-less UUID version 4 value
puff uuid --version 4 --compact
f357e1d4dc0d4aa285cb7cef37cb3ad0

Print Base64 Values (Default: 16 Bytes)

Use puff base64 --help to view available command options.

# Print a single base64-encoded value
puff base64
4YamGT7lPlJakROuu7zN5w==

# Print a base64-encoded value with custom byte length (32 bytes)
puff base64 --bytes 32
YPjRDxaUYFkurRAhz0MUzzl8Hh3Y0Z79DZcrJX5R/4g=

# Print a base64-encoded value using URL-safe encoding
puff base64 --url-safe
7KtUKGFAvVHoDdsQDIuRtQ

Create a Binary File with Random Bytes

Similar to using dd for generating test data, you can use puff to create a binary file with random bytes:

# Create a 10MB binary file with random bytes
puff binary --bytes 10485760 -o /tmp/puff-10mb.bin

# Verify the file size
stat -c %s /tmp/puff-10mb.bin
10485760

Contributing

Contributions of any kind are welcome. If you're submitting a PR, please follow Go's commit message structure.

License

Puff is available under the MIT license. See the LICENSE file for details.