| name | add-fixture |
| description | Add a new OCR regression fixture from an ocr_debug image. Use when a scan misidentified an item and you want to lock in the correct result as a test case. |
| disable-model-invocation | true |
Add OCR Fixture
When OCR misidentifies an item, capture a regression fixture so the failure can never silently recur.
Prerequisites
The ocr_debug/ directory must contain the problem image. Run a dry-run scan if it is empty:
uv run autoscrapper scan --dry-run
Add the fixture
uv run python scripts/capture_ocr_fixture.py IMAGE_PATH EXPECTED_NAME
Example:
uv run python scripts/capture_ocr_fixture.py ocr_debug/infobox_3.png "Rusty Gear"
Output:
tests/fixtures/ocr/rusty_gear.png ← copy of the source image
tests/fixtures/ocr/rusty_gear.json ← sidecar: expected_name, source, captured_at
If the fixture already exists, the script prompts before overwriting.
Verify the fixture passes
uv run pytest tests/autoscrapper/ocr/test_ocr_fixtures.py -v
If it fails, the OCR is still broken - this is now a tracked regression. Fix the OCR logic, then rerun until the fixture passes.
Run the full OCR suite
uv run pytest tests/autoscrapper/ocr/ -v
All existing fixtures must still pass after adding the new one.
Notes
- Fixture slugs are derived from the item name:
"Arc Alloy" → arc_alloy.png
- Do not hand-edit sidecar JSON - recreate via the script if corrections are needed
ocr_debug/ is disposable and is not committed; fixtures in tests/fixtures/ocr/ are committed
