Metadata-Version: 2.2
Name: kzupass
Version: 0.1.0
Summary: A configurable password generator with CLI and Python API
License: MIT
Keywords: password,generator,security,passgen
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyperclip>=1.8
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: build; extra == "dev"

# kzupass

A configurable password generator. Generate random passwords with custom character sets or memorable XKCD-style word-based passwords.

## Installation

```bash
pip install kzupass
```

## CLI Usage

```bash
# 16-char random password with special characters, copied to clipboard
kzupass --length 16 --special --clip

# 4-word XKCD-style password
kzupass --words 4 --separator "-"

# Custom character set with minimum entropy
kzupass --chars "abc123!@" --entropy 60

# Generate 5 passwords at once
kzupass --length 12 --count 5
```

## Python API

```python
from kzupass import generate_password, generate_word_password, entropy_of_password

pw = generate_password(length=20, use_special=True)
print(pw, entropy_of_password(pw))

phrase = generate_word_password(num_words=4, separator="-")
print(phrase)
```
# kzupass
# kzupass
