feat(cli): добавлен батч-режим и конфигурационный файл (шаги 8–12)
- Зачем: - обработка нескольких файлов за один вызов с загрузкой модели один раз. - хранение дефолтов (модель, язык, устройство) в .transcriber.toml. - Что: - добавлен config.py: поиск .transcriber.toml (CWD → ~/.config), парсинг, валидация, приоритет CLI > конфиг > хардкод. - рефакторинг transcriber.py: выделены load_model() и _transcribe_file() с TranscribeFileResult для переиспользования модели в батче. - добавлены expand_globs() с дедупликацией и has_existing_transcript() в utils.py. - CLI: files: list[Path], --force/-f, prescan-first батч с итоговой статистикой и временем, Status-спиннер для прогресса. - README: секции батч-режим, конфигурационный файл, --force в таблице опций. - ADR-002: зафиксированы архитектурные решения (prescan-first, TranscribeFileResult, конфиг без мержа). - Проверка: - uv run pytest -q — 94 passed, 1 skipped. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -288,6 +288,69 @@
|
||||
**Критерий готовности**: коллега может по README установить и запустить на Windows/WSL2 без вопросов.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Шаг 8: Конфиг `.transcriber.toml`
|
||||
|
||||
- [x] Зависимость `tomli` в `pyproject.toml` (для Python < 3.11)
|
||||
- [x] Новый файл `src/local_transcriber/config.py`:
|
||||
- `HARDCODED_DEFAULTS` — дефолтные значения
|
||||
- `find_config_file()` — ищет `.transcriber.toml` в CWD, потом `~/.config/transcriber/config.toml`
|
||||
- `load_config()` — парсит TOML, валидирует ключи/значения
|
||||
- `resolve_defaults()` — приоритет CLI > конфиг > хардкод
|
||||
- [x] Тесты `tests/test_config.py` — 11 тестов
|
||||
|
||||
**Критерий готовности**: `uv run pytest tests/test_config.py -v` — все тесты зелёные.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Шаг 9: Рефакторинг transcriber.py — выделить загрузку модели
|
||||
|
||||
- [x] `load_model()` — загрузка модели с CUDA-фолбеком
|
||||
- [x] `_transcribe_file()` — транскрипция одного файла, возвращает `TranscribeFileResult`
|
||||
- [x] `TranscribeFileResult` — dataclass с result, model, actual_device
|
||||
- [x] `transcribe()` — тонкая обёртка для обратной совместимости
|
||||
- [x] Новые тесты: `test_load_model_cuda_fallback`, `test_load_model_strict_raises`, `test__transcribe_file_basic`
|
||||
|
||||
**Критерий готовности**: все существующие тесты `test_transcriber.py` проходят без изменений.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Шаг 10: Утилиты для батч-режима в utils.py
|
||||
|
||||
- [x] `expand_globs()` — раскрытие glob-паттернов
|
||||
- [x] `has_existing_transcript()` — проверка существования транскрипта
|
||||
- [x] Тесты в `test_utils.py` — 5 новых тестов
|
||||
|
||||
**Критерий готовности**: `uv run pytest tests/test_utils.py -v` — все тесты зелёные.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Шаг 11: Батч-режим + конфиг в CLI
|
||||
|
||||
- [x] Изменение сигнатуры CLI: `files: list[Path]`, дефолты `None`, `--force`
|
||||
- [x] Интеграция `load_config()` / `resolve_defaults()` в `main()`
|
||||
- [x] `_run_single()` — текущий flow для одного файла
|
||||
- [x] `_run_batch()` — prescan, загрузка модели, транскрипция с итогами
|
||||
- [x] Обновлённые тесты `test_cli.py` — 11 новых тестов
|
||||
|
||||
**Критерий готовности**: `uv run pytest tests/test_cli.py -v` — все тесты зелёные.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Шаг 12: Документация + ADR
|
||||
|
||||
- [x] ADR-002: Batch mode и config (`docs/adr/002-batch-and-config.md`)
|
||||
- [x] README.md: секции «Батч-режим», «Конфигурационный файл», обновлена таблица опций CLI
|
||||
- [x] `docs/plan.md`: отмечены шаги 8–12
|
||||
|
||||
**Критерий готовности**: README содержит документацию по батч-режиму и конфигу.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Инструкция для агента
|
||||
|
||||
Reference in New Issue
Block a user