Eric Wagoner
2273ac7cf7
One self-contained page (inline CSS/JS, system fonts, works offline): match cards show source photos, extracted cues, and candidates with cached-XML thumbnails (placeholder tiles until real fixtures exist); actions are pick / manual BGG id / reject, plus a skippable editions pass (pick or unknown). Keyboard-first: j/k navigate, 1-9 pick, r reject, m manual, u unknown, d dismiss. Every decision writes matches.csv through the same ReviewSession methods the TUI now shares — the TUI remains as the no-flag fallback. unidentified.json renders as visually distinct reshoot work-orders with dismissals persisted in data/unidentified_dismissed.json (survives extract rebuilds). Progress tally and a diff-ready done screen; photo serving is allowlisted to photos/ contents; server binds 127.0.0.1 only. Layout leaves room for a later games.json browse view. Provenance guard: fixture generators now write STUB_FIXTURES.marker into their cache dirs, and CLAUDE.md gains the hard rule that stub- resolved version_ids are placeholders — upload must refuse to run while data/bgg_cache/STUB_FIXTURES.marker exists. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
124 lines
4.7 KiB
Python
124 lines
4.7 KiB
Python
"""Write hand-crafted stub XML fixtures into tests/fixtures/bgg_cache/.
|
|
|
|
BGG's XML API now requires a registered application token, which we don't
|
|
have yet, so these fixtures are realistic approximations of real responses
|
|
(shapes verified against the API docs) rather than recordings. Once a
|
|
BGG_API_TOKEN exists: delete tests/fixtures/bgg_cache/ and run
|
|
scripts/record_fixtures.py — it writes real recordings under the SAME
|
|
filenames, and the test suite must still pass.
|
|
|
|
Usage: uv run python scripts/write_stub_fixtures.py
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
from bggpipe.bgg_client import cache_key
|
|
|
|
FIXTURE_CACHE = Path("tests/fixtures/bgg_cache")
|
|
SEARCH_TYPES = "boardgame,boardgameexpansion"
|
|
|
|
|
|
def search_item(bgg_id: int, name: str, year: int | None, type_: str) -> str:
|
|
year_xml = f'<yearpublished value="{year}"/>' if year else ""
|
|
return (
|
|
f'<item type="{type_}" id="{bgg_id}">'
|
|
f'<name type="primary" value="{name}"/>{year_xml}</item>'
|
|
)
|
|
|
|
|
|
WINGSPAN_FAMILY = (
|
|
search_item(266192, "Wingspan", 2019, "boardgame")
|
|
+ search_item(290448, "Wingspan: European Expansion", 2019, "boardgameexpansion")
|
|
+ search_item(300580, "Wingspan: Oceania Expansion", 2020, "boardgameexpansion")
|
|
+ search_item(366161, "Wingspan Asia", 2022, "boardgame")
|
|
)
|
|
|
|
SEARCHES = {
|
|
"Catan": (
|
|
search_item(13, "CATAN", 1995, "boardgame")
|
|
+ search_item(926, "CATAN: Seafarers", 1997, "boardgameexpansion")
|
|
+ search_item(27760, "Catan Dice Game", 2007, "boardgame")
|
|
+ search_item(133038, "CATAN 3D Collector's Edition", 2005, "boardgame")
|
|
),
|
|
"Wingspan": WINGSPAN_FAMILY,
|
|
"Wingspan: European Expansion": WINGSPAN_FAMILY,
|
|
"Wingspan Europe": WINGSPAN_FAMILY,
|
|
"Café International": (
|
|
search_item(373, "Café International", 1989, "boardgame")
|
|
+ search_item(8103, "Café International: Das Kartenspiel", 2001, "boardgame")
|
|
),
|
|
"Citadels": (
|
|
search_item(478, "Citadels", 2000, "boardgame")
|
|
+ search_item(205398, "Citadels", 2016, "boardgame")
|
|
),
|
|
"Blorvath: Quest of the Zzyzx": "",
|
|
"Blorvath": "", # truncation-retry head of the nonsense title
|
|
}
|
|
|
|
THINGS = {
|
|
# Citadels tie-break: neither edition dominates 10x -> stays ambiguous.
|
|
("478,205398", "stats"): """<items>
|
|
<item type="boardgame" id="478">
|
|
<name type="primary" value="Citadels"/><yearpublished value="2000"/>
|
|
<statistics><ratings><owned value="85000"/>
|
|
<ranks><rank type="subtype" id="1" name="boardgame" value="250"/></ranks>
|
|
</ratings></statistics>
|
|
</item>
|
|
<item type="boardgame" id="205398">
|
|
<name type="primary" value="Citadels"/><yearpublished value="2016"/>
|
|
<statistics><ratings><owned value="24000"/>
|
|
<ranks><rank type="subtype" id="1" name="boardgame" value="400"/></ranks>
|
|
</ratings></statistics>
|
|
</item>
|
|
</items>""",
|
|
# Wingspan versions: 2019 Stonemaier English must beat the 2020 printing.
|
|
("266192", "versions"): """<items>
|
|
<item type="boardgame" id="266192">
|
|
<name type="primary" value="Wingspan"/><yearpublished value="2019"/>
|
|
<versions>
|
|
<item type="boardgameversion" id="465063">
|
|
<name type="primary" value="English first edition"/>
|
|
<yearpublished value="2019"/>
|
|
<link type="boardgamepublisher" id="23202" value="Stonemaier Games"/>
|
|
<link type="language" id="2184" value="English"/>
|
|
</item>
|
|
<item type="boardgameversion" id="521212">
|
|
<name type="primary" value="English fourth printing"/>
|
|
<yearpublished value="2020"/>
|
|
<link type="boardgamepublisher" id="23202" value="Stonemaier Games"/>
|
|
<link type="language" id="2184" value="English"/>
|
|
</item>
|
|
<item type="boardgameversion" id="472430">
|
|
<name type="primary" value="German edition"/>
|
|
<yearpublished value="2019"/>
|
|
<link type="boardgamepublisher" id="22160" value="Feuerland Spiele"/>
|
|
<link type="language" id="2188" value="German"/>
|
|
</item>
|
|
</versions>
|
|
</item>
|
|
</items>""",
|
|
}
|
|
|
|
|
|
def main() -> None:
|
|
FIXTURE_CACHE.mkdir(parents=True, exist_ok=True)
|
|
(FIXTURE_CACHE / "STUB_FIXTURES.marker").write_text(
|
|
"This cache contains hand-written stub XML, not real BGG "
|
|
"responses. Data resolved from it must not be uploaded.\n"
|
|
)
|
|
for query, items in SEARCHES.items():
|
|
key = cache_key("search", {"query": query, "type": SEARCH_TYPES})
|
|
total = items.count("<item ")
|
|
(FIXTURE_CACHE / key).write_text(f'<items total="{total}">{items}</items>')
|
|
for (ids, flavor), xml in THINGS.items():
|
|
key = cache_key("thing", {"id": ids, flavor: "1"})
|
|
(FIXTURE_CACHE / key).write_text(xml)
|
|
for f in sorted(FIXTURE_CACHE.iterdir()):
|
|
print(f" {f.name}")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|