# 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

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

## Usage

```bash
rs-random [LENGTH]
rs-random -l <LENGTH> [-s <SETS>] [-c <COUNT>]
rs-random -h | --help
```

- `LENGTH` &lt;number&gt;: 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):

```bash
rs-random 32
```

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

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