Skip to content

Adopcja API PBN 0.2 batch 2: normalize_author_name + helpery oświadczeń#604

Open
mpasternak wants to merge 2 commits into
feat/pbn-adopt-apifrom
feat/pbn-adopt-api2
Open

Adopcja API PBN 0.2 batch 2: normalize_author_name + helpery oświadczeń#604
mpasternak wants to merge 2 commits into
feat/pbn-adopt-apifrom
feat/pbn-adopt-api2

Conversation

@mpasternak

@mpasternak mpasternak commented Jul 14, 2026

Copy link
Copy Markdown
Member

Kontynuacja adopcji API PBN 0.2 (stack na #603). Dwa kroki, oba zastępują
własne kopie logiki jednym źródłem prawdy z paczek.

1. normalize_author_name (2 site'y)

  • pbn_api/models/publication.py (_normalizuj_autora) — wcześniej
    lastName + firstName/givenNames/name, bez familyName.
  • pbn_import/.../pbn_importuj_uid.py (display-line) — wcześniej
    familyName/lastName + givenNames/name, bez firstName, bez guardu
    na nie-dict.

Oba delegują do pbn_client.normalize_author_name (unia: familyName→lastName,
firstName→givenNames→name). Paczka zwraca None dla braku — koercja
None→""
zachowuje kontrakt konsumentów (szablon rekordu, str(autorzy)
w logach, f-string importu). Zamrożony ""-kontrakt (test goły-UID) zielony;
dodany test familyName.

2. Helpery oświadczeń w pbn_test_wysylka_interaktywna (narzędzie debug)

Decyzja usera: narzędzie rzadko używane → przyjmujemy nowe, paczkowe
zachowania
i dopisujemy brakujące.

  • _extract_object_iddecode_publication_object_id (mapowanie
    endpoint_choice→bez_oswiadczen). Paczka przy niejednoznacznej odpowiedzi
    (lista != 1 element) rzuca zamiast po cichu None — narzędzie łapie to
    głośno, pokazuje surową odpowiedź i pyta: wyjść czy kontynuować
    z objectId=None.
  • lokalny _keystatement_key_pbn/statement_key_intended; różnice
    liczy diff_statements, część wspólną (której paczka nie zwraca)
    liczymy lokalnie na tych samych kluczach.

Nowe testy: integracyjny (niejednoznaczna odpowiedź → głośny błąd +
przerwanie) + unit gałęzi „kontynuuj" (zwraca None).

Weryfikacja

  • manage.py check: OK
  • pytest src/pbn_api/tests/: 339 passed (w tym 16 w suicie komendy)
  • pytest .../test_command_pbn_importuj_uid.py: 14 passed
  • ruff check + format: clean

Nadal WSTRZYMANE (do decyzji usera)

P3 (rozpoznanie PublicationNotFound w endpoincie paczki,
BrakIDPracyPoStroniePBN=alias, decyzja 404) oraz download_to_model/
iter_pages w getterach — zmieniają ścieżki błędów/pobierania, osobny PR.

🤖 Generated with Claude Code

mpasternak and others added 2 commits July 14, 2026 21:24
Dwa miejsca normalizowały dane osobowe autora z PBN własnymi,
rozjeżdżającymi się łańcuchami preferencji:

- pbn_api/models/publication.py (_normalizuj_autora): lastName +
  firstName/givenNames/name, brak familyName;
- pbn_import/.../pbn_importuj_uid.py: familyName/lastName +
  givenNames/name, brak firstName, brak guardu na nie-dict.

Oba delegują teraz do jednego źródła prawdy — pbn_client.normalize_author_name
(unia kluczy: familyName→lastName, firstName→givenNames→name; nie-dict →
brak danych). Paczka używa None jako sentinela pustki; oba site'y koerują go
do "" (szablon rekordu i str(autorzy) w logach zakładają puste stringi, a
display-line importu składa f-string).

Zysk: rozpoznanie familyName (publication) i firstName (import) tam, gdzie
wcześniej wypadało puste; bezpieczeństwo na nie-dict w komendzie importu.
Zachowany zamrożony ""-kontrakt (test goły-UID) + nowy test familyName.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Interaktywne narzędzie diagnostyczne trzymało własne kopie logiki, którą
mamy teraz w pbn-client. Podmienione na jedno źródło prawdy:

- _extract_object_id → pbn_client.decode_publication_object_id
  (mapowanie endpoint_choice → bez_oswiadczen: "publications"=all-in-one
  → False, "repositorium" → True). Paczka przy niejednoznacznej odpowiedzi
  (lista != 1 element, zły typ) RZUCA zamiast po cichu zwracać None —
  narzędzie łapie to głośno, pokazuje surową odpowiedź i pyta usera czy
  wyjść czy jechać dalej z objectId=None (decyzja usera: rzadko używane,
  niech krzyczy i pyta).
- lokalny _key → pakietowe statement_key_pbn / statement_key_intended;
  różnice liczy diff_statements, część wspólną (której paczka nie zwraca)
  liczymy lokalnie na tych samych kluczach.

Testy: nowy test integracyjny (niejednoznaczna odpowiedź → głośny błąd +
przerwanie pod --yes-all) + unit gałęzi "kontynuuj" (zwraca None).
16 passed w suicie komendy, 339 w całym pbn_api. ruff clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mpasternak mpasternak changed the title Adoptuj pbn_client.normalize_author_name w BPP (batch 2) Adopcja API PBN 0.2 batch 2: normalize_author_name + helpery oświadczeń Jul 14, 2026
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