How karslioglu/oxford3000 works
Oxford 3000 is a command-line pipeline that downloads the Oxford word-list PDF, parses word/part-of-speech/CEFR records into SQLite, enriches records with Turkish translations and example sentences, and produces CSV, Excel, and pronunciation files. The README documents these capabilities; the shown code confirms the CLI routing, PDF parsing and SQLite writing, database reads, and external-service calls. The graph omits unsampled implementation details and includes only relationships supported by the excerpts or README.
Main entry points: oxford3000.py Command router · db_reader.py Word reader · export_sqlite.py Oxford database · translate.py Turkish translation
Components 15
PDF ingestion
- Command router
oxford3000.py - PDF downloader
scripts/download_pdf.py - PDF parser
scripts/pdf_parser.py - SQLite importer
scripts/export_sqlite.py
Database enrichment
- Turkish translation
scripts/translate.py - Example sentences
scripts/examples.py
Exports and audio
- CSV export
scripts/export_csv.py - Excel export
scripts/export_xlsx.py - Pronunciation downloader
scripts/sounds.py
Shared storage
- Oxford database
scripts/export_sqlite.py - Word reader
scripts/db_reader.py
Other components
- CLI user
- Oxford PDF source
- Gemini API
- Sound of Text
Connections 20
- CLI user → Command router: runs commands
README.md - Command router → PDF downloader: dispatches download
oxford3000.py - Oxford PDF source → PDF downloader: serves PDF
scripts/download_pdf.py - Command router → SQLite importer: dispatches import
oxford3000.py - SQLite importer → PDF parser: calls parse_pdf
scripts/export_sqlite.py - SQLite importer → Oxford database: writes records
scripts/export_sqlite.py - Command router → Turkish translation: dispatches translate
oxford3000.py - Turkish translation → Gemini API: requests translations
scripts/translate.py - Turkish translation → Oxford database: updates translations
scripts/translate.py - Command router → Example sentences: dispatches examples
oxford3000.py - Example sentences → Gemini API: requests sentences
scripts/examples.py - Example sentences → Oxford database: writes examples
scripts/examples.py - Command router → CSV export: dispatches CSV
oxford3000.py - Command router → Excel export: dispatches Excel
oxford3000.py - Command router → Pronunciation downloader: dispatches audio
oxford3000.py - CSV export → Word reader: fetches words
scripts/export_csv.py - Excel export → Word reader: fetches words
scripts/export_xlsx.py - Pronunciation downloader → Word reader: fetches words
scripts/sounds.py - Word reader → Oxford database: reads words
scripts/db_reader.py - Pronunciation downloader → Sound of Text: requests audio
scripts/sounds.py