forgekey 0.2.0

A fast, minimal password generator CLI built in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# 🔑 forgekey

[![CI](https://github.com/vmagueta/forge/actions/workflows/ci.yml/badge.svg)](https://github.com/vmagueta/forge/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/forgekey)](https://crates.io/crates/forgekey)
[![codecov](https://codecov.io/gh/vmagueta/forge/branch/main/graph/badge.svg)](https://codecov.io/gh/vmagueta/forge)
[![docs.rs](https://img.shields.io/docsrs/forgekey)](https://docs.rs/forgekey)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

A fast, minimal password generator CLI built in Rust.

## Installation

```bash
cargo install forgekey
```

## Usage

```bash
# Generate a password (default: 16 characters)
forgekey

# Custom length
forgekey --length 32

# Generate multiple passwords
forgekey -n 5

# Exclude symbols
forgekey --no-symbols

# Exclude numbers and uppercase
forgekey --no-numbers --no-uppercase

# Combine flags
forgekey -l 32 -n 5 --no-symbols
```

## Options

| Flag | Short | Description | Default |
|------|-------|-------------|---------|
| `--length` | `-l` | Password length | `16` |
| `--number` | `-n` | Number of passwords | `1` |
| `--no-symbols` | | Exclude symbols | `false` |
| `--no-numbers` | | Exclude numbers | `false` |
| `--no-uppercase` | | Exclude uppercase | `false` |

## Built with

- [clap](https://crates.io/crates/clap) — CLI argument parsing
- [rand](https://crates.io/crates/rand) — Cryptographically secure randomness
- [colored](https://crates.io/crates/colored) — Terminal colors

## Contributing

Contributions are welcome! Check out the [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and ideas.

## License

MIT