Cargo.lock

@@ -83,7 +83,7 @@ dependencies = [
 
 [[package]]
 name = "rs-random"
-version = "0.2.1"
+version = "0.1.0"
 dependencies = [
  "rand",
 ]

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rs-random"
-version = "0.2.1"
+version = "0.1.0"
 edition = "2024"
 
 [dependencies]

README.md

@@ -2,30 +2,21 @@
 
 **Secure String Generator**
 
-A blazing-fast Rust command-line tool for generating secure random strings with the tiniest possible footprint.
+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
 
-- **True cryptographic security**: Uses operating system entropy (`OsRng`) for cryptographically secure randomness
+- Uses operating system entropy (`OsRng`) for cryptographically secure randomness
-- **Flexible character sets**: Includes alphabets, numbers, symbols, and more
+- Very small binary size (optimized release profile)
-- **Tiny binary size**: Aggressively optimized for size
+- Minimal dependencies (only the `rand` crate with `std_rng` and `getrandom` features)
-- **Zero dependencies**: Only uses Rust's `rand` crate with minimal features
+- Flexible selection of character sets, including alphabets, numbers, symbols, and more
 
-## Security
+## About
 
-`rs-random` uses `OsRng` from Rust's `rand` crate, which is cryptographically secure and implements the `CryptoRng` trait. It pulls entropy directly from:
+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.
-- 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](https://git.caileb.com/Caileb/rs-random/releases).
-
 ### From Source
 
 ```bash
@@ -39,25 +30,14 @@ cargo build --release
 ```bash
 rs-random [LENGTH]
 rs-random -l <LENGTH> [-s <SETS>] [-c <COUNT>]
-rs-random -h
+rs-random -h | --help
 ```
 
 - `LENGTH` &lt;number&gt;: Length of each string (default: `16`)
-- `-l <LENGTH>`: Specify the string length
+- `-l, --length <LENGTH>`: Specify the string length
-- `-s <SETS>`: Comma-separated list of character sets to include (default: `lowercase,uppercase,numbers,special-safe`)
+- `-s, --sets <SETS>`: Comma-separated list of character sets to include (default: `lowercase,uppercase,numbers,special-safe`)
-- `-c <COUNT>`: Number of strings to generate (default: `1`)
+- `-c, --count <COUNT>`: Number of strings to generate (default: `1`)
-- `-h`: Show help information
+- `-h, --help`: 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
 
@@ -66,7 +46,6 @@ This gives you a secure password with:
 | 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               |
@@ -83,14 +62,8 @@ Generate a single 32-character string (default sets):
 rs-random 32
 ```
 
-Generate a 32-character hex string (like `openssl rand -hex 16`):
-
-```bash
-rs-random -l 32 -s hex
-```
-
 Generate five 12-character strings using only lowercase and numbers:
 
 ```bash
 rs-random -l 12 -s lowercase,numbers -c 5
-```
+```

src/main.rs

@@ -3,11 +3,10 @@ use std::collections::HashSet;
 use std::env;
 use std::process;
 
-static CHARACTER_SETS: [(&str, &str, &str); 11] = [
+static CHARACTER_SETS: [(&str, &str, &str); 10] = [
     ("lowercase", "abcdefghijklmnopqrstuvwxyz", "English lowercase letters (a-z)"),
     ("uppercase", "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "English uppercase letters (A-Z)"),
     ("numbers", "0123456789", "Numbers (0-9)"),
-    ("hex", "0123456789abcdef", "Hexadecimal (0-9, a-f)"),
     ("special", "!@#$%^&*()_+-=[]{}|;:,.<>?", "Special characters"),
     ("special-safe", "!@#$%^&*_+-=<>?", "Safe special chars (no pipes/brackets)"),
     ("cyrillic-lower", "абвгдежзийклмнопрстуфхцчшщъыьэюя", "Cyrillic lowercase"),
@@ -17,23 +16,20 @@ static CHARACTER_SETS: [(&str, &str, &str); 11] = [
     ("symbols", "©®™€£¥§¶†‡•…‰′″‹›\"\'–—", "Extended symbols"),
 ];
 
-#[inline(never)]
 fn print_help() {
     println!("rs-random: Secure String Generator\n");
     println!("Usage:");
     println!("  rs-random [LENGTH]                   (uses safe defaults)");
     println!("  rs-random -l <LEN> [-s <SETS>] [-c <COUNT>]");
-    println!("  rs-random -h\n");
+    println!("  rs-random -h | --help\n");
     println!("Available sets (for -s, comma-separated):");
     for &(name, _, desc) in &CHARACTER_SETS {
         println!("  {:<15} - {}", name, desc);
     }
 }
 
-#[inline]
 fn get_chars(selected_sets: &[&str]) -> Result<Vec<char>, String> {
-    // Pre-allocate with estimated capacity
+    let mut all_chars = Vec::new();
-    let mut all_chars = Vec::with_capacity(selected_sets.len() * 32);
     let mut unknown = Vec::new();
 
     for &set_name in selected_sets {
@@ -50,55 +46,29 @@ fn get_chars(selected_sets: &[&str]) -> Result<Vec<char>, String> {
         return Err("Empty character pool".to_string());
     }
 
-    // Optimize for common case where no duplicates exist
+    // Remove duplicates
-    if selected_sets.len() == 1 || 
+    let mut unique_chars = Vec::new();
-       (selected_sets.len() <= 4 && !selected_sets.iter().any(|&s| 
+    let mut seen = HashSet::new();
-           s == "numbers" && (selected_sets.contains(&"hex") || 
-           selected_sets.contains(&"lowercase") || 
-           selected_sets.contains(&"uppercase")))) {
-        return Ok(all_chars);
-    }
-
-    // Remove duplicates only when necessary
-    let mut unique_chars = Vec::with_capacity(all_chars.len());
-    let mut seen = HashSet::with_capacity(all_chars.len());
     for ch in all_chars {
         if seen.insert(ch) {
             unique_chars.push(ch);
         }
     }
-    unique_chars.shrink_to_fit();
 
     Ok(unique_chars)
 }
 
-#[inline]
 fn generate_random_string(chars: &[char], length: usize) -> String {
     let mut rng = OsRng;
-    let mut result = String::with_capacity(length);
+    (0..length)
-    
+        .map(|_| *chars.choose(&mut rng).unwrap())
-    // Unroll loop for better performance on small strings
+        .collect()
-    let chunks = length / 4;
-    let remainder = length % 4;
-    
-    for _ in 0..chunks {
-        result.push(*chars.choose(&mut rng).unwrap());
-        result.push(*chars.choose(&mut rng).unwrap());
-        result.push(*chars.choose(&mut rng).unwrap());
-        result.push(*chars.choose(&mut rng).unwrap());
-    }
-    
-    for _ in 0..remainder {
-        result.push(*chars.choose(&mut rng).unwrap());
-    }
-    
-    result
 }
 
 fn main() {
     let args: Vec<String> = env::args().collect();
 
-    if args.len() < 2 || args.contains(&"-h".to_string()) {
+    if args.len() < 2 || args.contains(&"-h".to_string()) || args.contains(&"--help".to_string()) {
         print_help();
         return;
     }
@@ -110,14 +80,13 @@ fn main() {
     let mut i = 1;
     while i < args.len() {
         match args[i].as_str() {
-            "-l" => {
+            "-l" | "--length" => {
                 if i + 1 < args.len() {
-                    match args[i + 1].parse::<usize>() {
+                    if let Ok(n) = args[i + 1].parse::<usize>() {
-                        Ok(n) => length = n,
+                        length = n;
-                        Err(_) => {
+                    } else {
-                            eprintln!("Error: Invalid length");
+                        eprintln!("Error: Invalid length");
-                            process::exit(1);
+                        process::exit(1);
-                        }
                     }
                     i += 2;
                 } else {
@@ -125,7 +94,7 @@ fn main() {
                     process::exit(1);
                 }
             }
-            "-s" => {
+            "-s" | "--sets" => {
                 if i + 1 < args.len() {
                     sets = &args[i + 1];
                     i += 2;
@@ -134,14 +103,13 @@ fn main() {
                     process::exit(1);
                 }
             }
-            "-c" => {
+            "-c" | "--count" => {
                 if i + 1 < args.len() {
-                    match args[i + 1].parse::<usize>() {
+                    if let Ok(n) = args[i + 1].parse::<usize>() {
-                        Ok(n) => count = n,
+                        count = n;
-                        Err(_) => {
+                    } else {
-                            eprintln!("Error: Invalid count");
+                        eprintln!("Error: Invalid count");
-                            process::exit(1);
+                        process::exit(1);
-                        }
                     }
                     i += 2;
                 } else {
@@ -149,13 +117,12 @@ fn main() {
                     process::exit(1);
                 }
             }
-            arg if i == 1 && !arg.starts_with('-') => {
+            arg if i == 1 && !arg.starts_with("-") => {
-                match arg.parse::<usize>() {
+                if let Ok(n) = arg.parse::<usize>() {
-                    Ok(n) => length = n,
+                    length = n;
-                    Err(_) => {
+                } else {
-                        eprintln!("Error: Invalid length");
+                    eprintln!("Error: Invalid length");
-                        process::exit(1);
+                    process::exit(1);
-                    }
                 }
                 i += 1;
             }