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.
Find a file
2025-05-28 21:42:50 -05:00
src Initial Commit 2025-05-28 21:42:50 -05:00
.gitignore Initial Commit 2025-05-28 21:42:50 -05:00
Cargo.lock Initial Commit 2025-05-28 21:42:50 -05:00
Cargo.toml Initial Commit 2025-05-28 21:42:50 -05:00
README.md Initial Commit 2025-05-28 21:42:50 -05:00

rs-random

Secure String Generator

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.

Features

  • Uses operating system entropy (OsRng) for cryptographically secure randomness
  • Very small binary size (optimized release profile)
  • Minimal dependencies (only the rand crate with std_rng and getrandom features)
  • Flexible selection of character sets, including alphabets, numbers, symbols, and more

About

I created rs-random to have a super simple, minimal way to generate secure strings that I could build into other applications, ensuring security, speed, and a tiny footprint.

Installation

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

Available Character Sets

Name Description
lowercase English lowercase letters (a-z)
uppercase English uppercase letters (A-Z)
numbers Numbers (0-9)
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 five 12-character strings using only lowercase and numbers:

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