How geisteswille/aicorpusx-python works
aicorpusx is a Python translation library for text, structured rows, and CSV/XLSX corpora. Callers use its public API for in-memory translation or the resumable trans() file workflow; that workflow prepares translation tasks, schedules concurrent provider requests, and writes translated results. Supporting branches cover glossary constraints, file/row I/O, resumable checkpoints, and progress display. The excerpts show the scheduler and several integrations, but omit portions of _core.py; unverified runtime calls are therefore not asserted as solid edges.
Main entry points: _core.py Translation workflows · __init__.py Package API · _providers.py Provider adapter · _io.py Row I/O API
Components 13
Public interfaces
- Package API
src/aicorpusx/__init__.py - Translation workflows
src/aicorpusx/_core.py
Translation runtime
- Concurrent scheduler
src/aicorpusx/_core.py - Provider adapter
src/aicorpusx/_providers.py - Glossary matching
src/aicorpusx/_glossary.py
Corpus data
- Table adapters
src/aicorpusx/_tables.py - Row I/O API
src/aicorpusx/_io.py
Runtime support
- Progress reporting
src/aicorpusx/_progress.py - JSON checkpoint
src/aicorpusx/_core.py - SQLite checkpoint
src/aicorpusx/_core.py
Other components
- Python caller
- CSV/XLSX corpus
- Chat-completions service
Connections 14
- Python caller → Package API: calls
README.md - Package API → Translation workflows: exports
src/aicorpusx/__init__.py - Translation workflows → Concurrent scheduler: schedules tasks
src/aicorpusx/_core.py - Concurrent scheduler → Provider adapter: requests translation
src/aicorpusx/_core.py - Provider adapter → Chat-completions service: sends requests
src/aicorpusx/_providers.py - Translation workflows → Glossary matching: loads terms
src/aicorpusx/_core.py - Translation workflows → Table adapters: uses tables
src/aicorpusx/_core.py - Row I/O API → Table adapters: reads and writes
src/aicorpusx/_io.py - Python caller → Row I/O API: calls
README.md - CSV/XLSX corpus → Translation workflows: provides corpus
- Translation workflows → CSV/XLSX corpus: writes results
- Translation workflows → JSON checkpoint: persists state
src/aicorpusx/_core.py - Translation workflows → SQLite checkpoint: persists state
src/aicorpusx/_core.py - Concurrent scheduler → Progress reporting: reports progress
src/aicorpusx/_core.py