This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# letters
A Python app that displays random historic love letters from authentic sources, downloaded from [Project Gutenberg](https://www.gutenberg.org/).
## Usage
```bash
python3 love_letters.py # Show a random love letter
python3 love_letters.py -n 3# Show 3 random love letters
python3 love_letters.py --list # List available collections
python3 love_letters.py --source keats_brawne # Filter by source
python3 love_letters.py --refresh # Re-download all sources
```
## Sources
| Collection | Author → Recipient | Period |
|---|---|---|
| The Love Letters of Henry VIII to Anne Boleyn | Henry VIII → Anne Boleyn | c. 1527–1528 |
| The Love Letters of Mary Wollstonecraft to Gilbert Imlay | Mary Wollstonecraft → Gilbert Imlay | 1793–1795 |
| Letters of Abelard and Heloise | Abelard & Heloise → each other | 12th century |
| Napoleon's Letters to Josephine | Napoleon Bonaparte → Josephine | 1796–1812 |
| Letters of John Keats to Fanny Brawne | John Keats → Fanny Brawne | 1819–1820 |
All texts are sourced from [Project Gutenberg](https://www.gutenberg.org/) and are in the public domain.
## Requirements
Python 3.10+ (no external dependencies). An internet connection is required on first run to download the letter collections; they are cached locally after that.