CultLib/tests/vectors/document-variants-c0/generate.py
Meta Vens f96a0e7f7a Catalog writers merge entries that share an id; every reader resolves an id by its owner first
Entries that share a schema id are one schema seen by different writers, so the writer lists every id any of them lists, in any
order: C# single-file and directory (CultSchemaCatalogEntry.MergeById), TypeScript and Python. Rust synthesises one entry per id and
has no such merge. An id that one entry owns and another lists as compatible names the owner in Rust, TypeScript, Python and the TS
inspector, as C# already did (own-id-over-compatible-v3). Also: a directory manifest in an unreadable format is the typed refusal
naming it, cultnet-py applies and reports a record under the local schema id, and Rust's error prints its cause once.
Vectors for the Mesh layout discriminator: a nil and an integer at catalog slot 5.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-09-30 08:17:59 +02:00

72 lines
4.5 KiB
Python

"""Generates the shared C0 refusal vectors from the pre-Cut 2 v1 store (written before any
variant code existed). Every runtime's tests read the committed bytes; nothing regenerates them
at test time. Run: python generate.py (needs msgpack).
unknown-header.msgpack header cultcache.store.v9, otherwise the v1 store
extra-slot-full-payload.msgpack v1 header, record item:anvil gains slot 4, payload stays full
legacy-catalog-extra-slot.msgpack
v1 header, catalog entry in the older layout (contentHash at slot
5), so CultMesh's legacy snapshot reader takes it, plus the
extra-slot record
legacy-catalog-plain.msgpack v1 header, the older-layout catalog entry, the plain v1 records: a store CultMesh's
legacy reader accepts
legacy-catalog-trailing.msgpack legacy-catalog-plain plus three bytes after the array: one array is
required of the legacy layout too
current-catalog-bad-canonical.msgpack
current-catalog-bad-members.msgpack
current-catalog-bad-compat.msgpack
v1 header, plain records, and the first catalog entry of the current layout with one slot
malformed (canonical schema json an int; members an int; a compatible id an int). Not the
older layout, so CultMesh refuses them as CultCache does
current-catalog-bad-slot5-nil.msgpack
current-catalog-bad-slot5-int.msgpack
the same, with slot 5 (the compatible ids) nil or an integer: neither is a string, so neither is
the older layout
v1-base.msgpack NOT generated here: written once by the Python runtime at CultLib
69a21bb (SingleFileMessagePackBackingStore.push of alpha and
beta, type vectors.item, before any C0 code existed)
variant-v2.msgpack the wire shape of a variant record, hand-built: header v2, record slot 4 =
[baseKey, overrides[]], empty payload (override op Set = 0, path steps
are [slot, elementId]). C1 does not write this store and refuses to load
it: the variant resolves to its base's name (R6). It exercises readers
that refuse a variant by version or record.
"""
import pathlib
import msgpack
here = pathlib.Path(__file__).resolve().parent
source = here.parent.parent / "GameCult.Caching.Tests" / "Fixtures" / "pre-cut2" / "single-file-v1" / "store.msgpack"
header, catalog, records = msgpack.unpackb(source.read_bytes(), raw=False)
assert header == "cultcache.store.v1"
anvil = records[0]
assert anvil[0] == "item:anvil"
def write(name, snapshot):
(here / name).write_bytes(msgpack.packb(snapshot, use_bin_type=True))
write("unknown-header.msgpack", ["cultcache.store.v9", catalog, records])
write("extra-slot-full-payload.msgpack",
[header, catalog, [anvil + [["item:bellows", []]]] + records[1:]])
variant = ["item:anvil-big", anvil[1], anvil[2], b"", ["item:anvil", [[0, [[1, ""]], "", 99]]]]
write("variant-v2.msgpack", ["cultcache.store.v2", catalog, records + [variant]])
legacy = lambda entry: [entry[0], entry[1], entry[2], entry[4], None, entry[3], []]
legacy_entry = legacy(catalog[0])
write("legacy-catalog-extra-slot.msgpack",
[header, [legacy_entry], [anvil + [["item:bellows", []]]]])
write("legacy-catalog-plain.msgpack", [header, [legacy(entry) for entry in catalog], records])
(here / "legacy-catalog-trailing.msgpack").write_bytes(
msgpack.packb([header, [legacy(entry) for entry in catalog], records], use_bin_type=True) + b"\x01\x02\x03")
current = catalog[0]
for name, entry in (
("current-catalog-bad-canonical", current[:4] + [5]),
("current-catalog-bad-members", current[:6] + [5]),
("current-catalog-bad-compat", current[:5] + [[7]] + current[6:]),
("current-catalog-bad-slot5-nil", current[:5] + [None] + current[6:]),
("current-catalog-bad-slot5-int", current[:5] + [7] + current[6:]),
):
# One catalog entry and the records that use it: the older-layout reader takes an entry's slot 5 for a string, so a second
# current-layout entry would make it refuse for that reason, not for the malformed slot under test.
write(name + ".msgpack", [header, [entry], [record for record in records if record[1] == current[0]]])