rs-random

Secure String Generator

A blazing-fast Rust command-line tool for generating secure random strings with the tiniest possible footprint.

Features

True cryptographic security: Uses operating system entropy (OsRng) for cryptographically secure randomness
Flexible character sets: Includes alphabets, numbers, symbols, and more
Tiny binary size: Aggressively optimized for size
Zero dependencies: Only uses Rust's rand crate with minimal features

Security

rs-random uses OsRng from Rust's rand crate, which is cryptographically secure and implements the CryptoRng trait. It pulls entropy directly from:

Linux/Unix: /dev/urandom (via getrandom syscall when available)
Windows: CryptGenRandom
macOS: SecRandomCopyBytes

This is more secure than OpenSSL's RAND_bytes() which uses a userland PRNG.

Installation

Windows

Download the latest Windows executable from the releases page.

From Source

git clone https://git.caileb.com/Caileb/rs-random.git
cd rs-random
cargo build --release

Usage

rs-random [LENGTH]
rs-random -l <LENGTH> [-s <SETS>] [-c <COUNT>]
rs-random -h

LENGTH <number>: Length of each string (default: 16)
-l <LENGTH>: Specify the string length
-s <SETS>: Comma-separated list of character sets to include (default: lowercase,uppercase,numbers,special-safe)
-c <COUNT>: Number of strings to generate (default: 1)
-h: Show help information

Default Character Sets

When you run rs-random without specifying sets, it uses: lowercase + uppercase + numbers + special-safe

This gives you a secure password with:

26 lowercase letters (a-z)
26 uppercase letters (A-Z)
10 numbers (0-9)
15 safe special characters: !@#$%^&*_+-=<>?
Total: 77 possible characters per position

Available Character Sets

Name	Description
lowercase	English lowercase letters (a-z)
uppercase	English uppercase letters (A-Z)
numbers	Numbers (0-9)
hex	Hexadecimal (0-9, a-f)
special	Special characters
special-safe	Safe special chars (no pipes/brackets)
cyrillic-lower	Cyrillic lowercase letters
cyrillic-upper	Cyrillic uppercase letters
greek-lower	Greek lowercase letters
greek-upper	Greek uppercase letters
symbols	Extended symbols (©®, ™, €, £, etc.)

Examples

Generate a single 32-character string (default sets):

rs-random 32

Generate a 32-character hex string (like openssl rand -hex 16):

rs-random -l 32 -s hex

Generate five 12-character strings using only lowercase and numbers:

rs-random -l 12 -s lowercase,numbers -c 5

3 KiB Raw Permalink Blame History