Type Python shard log entry details
This commit is contained in:
parent
ef2501f767
commit
b12d1ee7b4
3 changed files with 25 additions and 2 deletions
|
|
@ -39,7 +39,9 @@ CultCache, CultNet, and CultMesh. It is evidence, not confetti.
|
|||
- Python CultNet shard log:
|
||||
Provides typed `CultNetShardLogResponse` and `CultNetShardLogEntry` helpers
|
||||
for inspecting mutation-log entries, resync pressure, and sequence cursors,
|
||||
while cache mutation remains owned by the existing replication helpers.
|
||||
including typed put-document and delete identity projections on individual
|
||||
entries while cache mutation remains owned by the existing replication
|
||||
helpers.
|
||||
`apply_shard_log_response(...)`, `CultMeshDatabase`, and
|
||||
`CultMeshGameSession` can consume typed shard-log responses directly for
|
||||
database sync and prediction reconciliation.
|
||||
|
|
|
|||
|
|
@ -3,6 +3,8 @@ from __future__ import annotations
|
|||
from dataclasses import dataclass
|
||||
from typing import Any
|
||||
|
||||
from .snapshot import CultNetRawDocumentRecord
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class CultNetShardLogEntry:
|
||||
|
|
@ -10,6 +12,9 @@ class CultNetShardLogEntry:
|
|||
change_kind: str
|
||||
put: dict[str, Any] | None = None
|
||||
delete: dict[str, Any] | None = None
|
||||
raw_document: CultNetRawDocumentRecord | None = None
|
||||
delete_schema_id: str | None = None
|
||||
delete_record_key: str | None = None
|
||||
committed_at: str | None = None
|
||||
|
||||
@classmethod
|
||||
|
|
@ -22,11 +27,21 @@ class CultNetShardLogEntry:
|
|||
raise ValueError(f"unsupported shard log changeKind {change_kind!r}")
|
||||
put = value.get("put")
|
||||
delete = value.get("delete")
|
||||
put_document = put.get("document") if isinstance(put, dict) else None
|
||||
raw_document = (
|
||||
CultNetRawDocumentRecord.from_wire(put_document)
|
||||
if isinstance(put_document, dict)
|
||||
else None
|
||||
)
|
||||
delete_record = dict(delete) if isinstance(delete, dict) else None
|
||||
return cls(
|
||||
sequence=sequence,
|
||||
change_kind=change_kind,
|
||||
put=dict(put) if isinstance(put, dict) else None,
|
||||
delete=dict(delete) if isinstance(delete, dict) else None,
|
||||
delete=delete_record,
|
||||
raw_document=raw_document,
|
||||
delete_schema_id=_optional_string(delete_record.get("schemaId")) if delete_record is not None else None,
|
||||
delete_record_key=_optional_string(delete_record.get("recordKey")) if delete_record is not None else None,
|
||||
committed_at=_optional_string(value.get("committedAt")),
|
||||
)
|
||||
|
||||
|
|
|
|||
|
|
@ -1076,6 +1076,10 @@ class CultCacheTests(unittest.TestCase):
|
|||
self.assertEqual(response.last_sequence, 3)
|
||||
self.assertFalse(response.resync_required)
|
||||
self.assertEqual(response.entries[0].put["document"]["recordKey"], "note:1")
|
||||
self.assertIsInstance(response.entries[0].raw_document, CultNetRawDocumentRecord)
|
||||
self.assertEqual(response.entries[0].raw_document.record_key, "note:1")
|
||||
self.assertEqual(response.entries[1].delete_schema_id, "schema-note")
|
||||
self.assertEqual(response.entries[1].delete_record_key, "note:1")
|
||||
self.assertEqual(response.to_wire()["entries"][1]["delete"]["recordKey"], "note:1")
|
||||
self.assertIs(response.require_usable(), response)
|
||||
|
||||
|
|
@ -2024,6 +2028,8 @@ class CultCacheTests(unittest.TestCase):
|
|||
self.assertEqual(shard_log["entries"][0]["changeKind"], "added")
|
||||
self.assertEqual(typed_shard_log.last_sequence, 1)
|
||||
self.assertEqual(typed_shard_log.entries[0].put["document"]["recordKey"], "note:1")
|
||||
self.assertIsInstance(typed_shard_log.entries[0].raw_document, CultNetRawDocumentRecord)
|
||||
self.assertEqual(typed_shard_log.entries[0].raw_document.record_key, "note:1")
|
||||
self.assertEqual(fetched_verses[0].verse_id, "server-verse")
|
||||
self.assertEqual(fetched_peers[0].peer_id, "mesh-server")
|
||||
self.assertIsInstance(subscription_snapshot, CultNetRawSnapshotResponse)
|
||||
|
|
|
|||
Loading…
Reference in a new issue