Metadata-Version: 2.4
Name: three-dice-words
Version: 0.1.0
Summary: Generate human-readable 3-word identifiers from the EFF long Diceware wordlist
License: MIT
Author: Tim Cotten
Author-email: tcotten@scrypted.ai
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Description-Content-Type: text/markdown

# three-dice-words (Python)

Generate 3-word hyphenated identifiers from the EFF long Diceware wordlist.

**Minimal API (defaults: bundled wordlist, crypto RNG):**

```python
from three_dice_words import generate_threewords, generate_threewords_batch

generate_threewords()           # e.g. "lantern-galaxy-cactus"
generate_threewords_batch(10)   # list of 10 IDs
```

**Customize (wordlist path, RNG):** `load_wordlist`, `generate`, `generate_batch`.

**Test scaling (serial vs batch, 1 … 1M):** `poetry run python scripts/test_scaling.py`

