Caileb/rs-random
1
0
Fork 0
Code Issues Pull requests Releases 3 Activity
A minimal, blazing-fast Rust command-line tool for generating secure random strings with the tiniest possible footprint. Perfect for standalone use or integration into other applications.
3 commits 1 branch 3 tags 40 KiB
Find a file
Exact
Caileb 476982919a Version bump
2025-06-13 11:59:55 -05:00
src Added hex, speed improvements, size reduction 2025-06-13 11:54:44 -05:00
.gitignore Initial Commit 2025-05-28 21:42:50 -05:00
Cargo.lock Version bump 2025-06-13 11:59:55 -05:00
Cargo.toml Version bump 2025-06-13 11:59:55 -05:00
README.md Added hex, speed improvements, size reduction 2025-06-13 11:54:44 -05:00

README.md

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