Metadata-Version: 2.4
Name: faresgen
Version: 0.2.3
Summary: A cryptographically secure password generator
License: MIT
Keywords: cryptography,generator,password,security
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# faresgen

A cryptographically secure password generator with bulk generation and clipboard support.

## Installation

```bash
pip install faresgen
```

## CLI Usage

```bash
# Single password (default 16 chars)
faresgen

# Custom length
faresgen 24

# Generate multiple passwords
faresgen 24 -n 10

# Copy all passwords to clipboard
faresgen 24 -n 10 --copy
```

## Library Usage

```python
import faresgen

# Generate one password
password = faresgen.generate()

# Custom length
password = faresgen.generate(32)

# Generate multiple
passwords = [faresgen.generate(24) for _ in range(10)]

# Copy to clipboard
faresgen.copy_to_clipboard('\n'.join(passwords))
```

## Features

- Guarantees every password contains lowercase, uppercase, digit, and special character
- Strips ambiguous characters (`0`, `O`, `1`, `l`, `I`) to avoid read/copy confusion
- Bulk generation with `-n`
- Cross-platform clipboard copy (`--copy`) — works on macOS and Windows

## Options

| Flag | Default | Description |
|------|---------|-------------|
| `length` | `16` | Password length (positional) |
| `-n`, `--count` | `1` | Number of passwords to generate |
| `--copy` | off | Copy all passwords to clipboard |
