Files
lanspread/tools/test_catalog_source_cache.py
T
ddidderr 6b65a66465 feat(catalog): separate generated production and local test authority
The launcher previously defaulted to fixtures and production generation used
the source database directly. Generate a separate database and manifest set
from package directories, validating staged output with the application loader
before installation. Keep strict selection by default, with independent
opt-ins for missing games and package version overrides in the copied database.
Share database filtering and staging with the fixture publisher, and include
source metadata and generation modes in the publication cache.

Make normal runs consume existing production authority. Add an explicit local
test recipe with separate resources, app settings, and a compiled startup game
directory. Build-time gates exclude local authority from production and require
Tauri development mode. Document the generation and launch workflows.

Clear generated catalog copies before Tauri copies the selected resource tree
so mode switches and reduced catalogs cannot retain stale manifests. Watch the
copied files to repair deletion and preserve prior output mtimes only when the
bytes are unchanged, allowing subsequent builds to become fresh.

Test Plan:
- `just fmt` -- passed.
- `just clippy` -- passed with warnings denied.
- `just test` -- workspace tests passed using fixture authority.
- `just frontend-test` -- 94 passed.
- `python3 -m unittest discover -s tools -p 'test_catalog_source_cache.py'`
  -- 4 passed.
- `git diff --cached --check` -- passed.
- Interactive GUI launches and production bundles were not exercised.
2026-09-12 19:41:35 +02:00

164 lines
5.2 KiB
Python

from __future__ import annotations
import json
import tempfile
import unittest
from pathlib import Path
import catalog_source_cache
class CatalogSourceCacheTests(unittest.TestCase):
def setUp(self) -> None:
self.temporary = tempfile.TemporaryDirectory()
self.root = Path(self.temporary.name)
self.packages = self.root / "packages"
self.packages.mkdir()
self.package = self.packages / "game"
self.package.mkdir()
(self.package / "version.ini").write_text("20260820\n", encoding="utf-8")
(self.package / "game.eti").write_bytes(b"eti")
self.catalog_db = self.root / "game.db"
self.catalog_db.write_bytes(b"catalog")
self.source_catalog_db = self.root / "source-game.db"
self.source_catalog_db.write_bytes(b"source catalog")
self.unrar = self.root / "unrar"
self.unrar.write_bytes(b"unrar")
self.manifests = self.root / "manifests"
self.manifests.mkdir()
(self.manifests / "catalog-content-index-v1.jsonl").write_text(
"{}\n", encoding="utf-8"
)
self.stamp = self.root / "cache" / "catalog.json"
def tearDown(self) -> None:
self.temporary.cleanup()
def test_record_then_check_and_source_change(self) -> None:
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
)
catalog_source_cache.record_cache(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
self.assertTrue(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
)
(self.package / "payload.bin").write_bytes(b"payload")
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
)
def test_missing_or_incomplete_output_never_hits(self) -> None:
catalog_source_cache.record_cache(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
(self.manifests / "catalog-content-index-v1.jsonl").unlink()
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
)
def test_stamp_is_structured_and_sorted(self) -> None:
catalog_source_cache.record_cache(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
stamp = json.loads(self.stamp.read_text(encoding="utf-8"))
self.assertEqual(stamp["schema"], 3)
self.assertEqual(stamp["catalog_db"]["size"], len(b"catalog"))
self.assertEqual(
stamp["source_catalog_db"]["size"], len(b"source catalog")
)
self.assertEqual(stamp["unrar"]["size"], len(b"unrar"))
self.assertEqual(stamp["packages_dir"], str(self.packages.absolute()))
def test_source_catalog_and_generation_modes_are_cache_inputs(self) -> None:
catalog_source_cache.record_cache(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
self.source_catalog_db.write_bytes(b"changed source catalog")
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
)
)
self.source_catalog_db.write_bytes(b"source catalog")
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
allow_missing_games=True,
)
)
self.assertFalse(
catalog_source_cache.cache_is_current(
self.stamp,
self.packages,
self.catalog_db,
self.source_catalog_db,
self.manifests,
self.unrar,
allow_version_mismatch=True,
)
)
if __name__ == "__main__":
unittest.main()