testsAndMisc/python_pkg/warsaw_districts

Warsaw Districts Anki Generator

Generate Anki flashcards for learning the 18 districts (dzielnice) of Warsaw, Poland.

Features

• Generates flashcards for all 18 Warsaw districts
• Front of card: Map showing only the district in question with its borders highlighted
• Back of card: District name in Polish
• Anki-compatible output format (semicolon-separated)
• Compatible with AnkiWeb and AnkiDroid

Installation

pip install matplotlib

Usage

Generate flashcards

# From the repository root
python -m python_pkg.warsaw_districts.warsaw_districts_anki

This creates:

• warsaw_districts_anki.txt - Anki import file
• warsaw_districts_images/ - Directory with 18 PNG map images

Custom options

# Custom output file and image directory
python -m python_pkg.warsaw_districts.warsaw_districts_anki \
    --output my_cards.txt \
    --image-dir my_maps

# Custom deck name
python -m python_pkg.warsaw_districts.warsaw_districts_anki \
    --deck-name "Warszawa - Dzielnice"

Importing into Anki

1. Open Anki
2. File → Import
3. Select the generated warsaw_districts_anki.txt file
4. Copy all images from warsaw_districts_images/ to your Anki profile's collection.media folder
   • On Linux: ~/.local/share/Anki2/[Profile]/collection.media/
   • On Windows: %APPDATA%\Anki2\[Profile]\collection.media\
   • On macOS: ~/Library/Application Support/Anki2/[Profile]/collection.media/
5. Click Import

Warsaw Districts

The generator includes all 18 official districts of Warsaw:

1. Bemowo
2. Białołęka
3. Bielany
4. Mokotów
5. Ochota
6. Praga-Południe
7. Praga-Północ
8. Rembertów
9. Śródmieście
10. Targówek
11. Ursus
12. Ursynów
13. Wawer
14. Wesoła
15. Wilanów
16. Włochy
17. Wola
18. Żoliborz

Output Format

The generated file uses Anki's standard import format:

#separator:semicolon
#html:true
#deck:Warsaw Districts
#tags:geography warsaw poland
#columns:Front;Back

<img src="Bemowo.png">;Bemowo
<img src="Białołęka.png">;Białołęka
...

Development

Running tests

pytest python_pkg/warsaw_districts/tests/

Code quality

ruff check python_pkg/warsaw_districts/

License

Same as the parent repository.