Skip to content

Konfigurowalna semantyka błędów importu (on_error) + adopcja download_to_model#607

Open
mpasternak wants to merge 1 commit into
feat/pbn-adopt-api3from
feat/pbn-adopt-api4
Open

Konfigurowalna semantyka błędów importu (on_error) + adopcja download_to_model#607
mpasternak wants to merge 1 commit into
feat/pbn-adopt-api3from
feat/pbn-adopt-api4

Conversation

@mpasternak

Copy link
Copy Markdown
Member

Ostatni element adopcji API PBN 0.2 (stack na #606). Adoptuje pakietowy
download_to_model w sposób opt-in, z zerową zmianą zachowania domyślnego.

Kontekst decyzji

pobierz_mongodb (współdzielony getter sekwencyjny) był fail-fast:
download_pbn_objects woła save() w gołej pętli bez try/except, więc błąd
zapisu jednego rekordu do lokalnego lustra BPP (IntegrityError, zły
kształt danych — po naszej stronie, nie PBN) przerywał cały import. Przy pełnych
synchronizacjach (tysiące–dziesiątki tysięcy rekordów) jeden zepsuty rekord
kasował cały przebieg.

Zmiana — parametr on_error

  • "raise" (default) — fail-fast jak dotąd. Zwraca None. Zero zmiany
    dla istniejących callerów.
  • "skip" — deleguje do pakietowego download_to_model: zły rekord
    logowany (pełny traceback) + liczony, import reszty listy kończy się. Zwraca
    DownloadResult(processed, errored).

Nieznana wartość → ValueError (głośno, bez cichego wyboru trybu).
Adopcja włączana opt-in per-getter po Twojej decyzji — ten PR tylko
udostępnia zdolność.

Dlaczego tak (a nie mechaniczna podmiana)

iter_pages nie pasuje do jedynych dwóch ręcznych page-loopów BPP
(pobierz_skasowane_prace, offline_data — oba multiprocessing per-page).
Wątkowy download_pages już ma paczkową obsługę błędów stron. Jedyny sensowny,
bezpieczny zysk to konfigurowalna semantyka błędów sekwencyjnego importu.

Weryfikacja

  • manage.py check: OK
  • pytest .../test_mongodb_ops.py .../test_pobierz_mongodb_on_error.py:
    15 passed (12 istniejących + 3 nowe: fail-fast default, skip
    kontynuuje+liczy, ValueError)
  • ruff check + format: clean

🤖 Generated with Claude Code

…_to_model)

pobierz_mongodb dostaje parametr on_error sterujący zachowaniem przy błędzie
zapisu POJEDYNCZEGO rekordu do lokalnego lustra BPP (IntegrityError, zły
kształt danych itp. — po naszej stronie, nie PBN):

- "raise" (default) — fail-fast jak dotąd: pierwszy błąd propaguje i przerywa
  batch (download_pbn_objects, goła pętla save bez try/except). Zwraca None.
- "skip" — deleguje do pakietowego download_to_model: zły rekord logowany
  (pełny traceback) + liczony, import reszty kończy się. Zwraca
  DownloadResult(processed, errored). Dla masowych synchronizacji (tysiące
  rekordów), gdzie jeden zepsuty rekord nie powinien wywalać całego przebiegu.

Zachowanie domyślne bez zmian — żaden istniejący caller nie zmienia
zachowania (default "raise"). Adopcja download_to_model włączana opt-in
per-getter po decyzji. Nieznana wartość on_error → ValueError (głośno).

Etykieta progress-baru ujednolicona między trybami (fasada nie forwarduje
pbar_label). Testy: fail-fast default, skip kontynuuje+liczy, ValueError.
3 nowe + 12 istniejących mongodb_ops passed, check OK, ruff clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant