cks-runtime 0.4.5__tar.gz → 0.4.6__tar.gz

{cks_runtime-0.4.5 → cks_runtime-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-runtime
-Version: 0.4.5
+Version: 0.4.6
 Summary: Canonical Runtime for the Canonical Knowledge Structure ecosystem
 Author: Vladyslav Hruznov
 License: MIT

{cks_runtime-0.4.5 → cks_runtime-0.4.6}/cks_runtime/config.py

@@ -28,7 +28,7 @@ def _runtime_version() -> str:
     try:
         return version("cks-runtime")
     except PackageNotFoundError:
-        return "0.4.5"
+        return "0.4.6"
 
 
 @dataclass(slots=True)

cks_runtime-0.4.6/cks_runtime/versioning/version.py

@@ -0,0 +1,103 @@
+"""
+Runtime Version.
+
+Represents an immutable Runtime snapshot.
+"""
+
+from __future__ import annotations
+
+from copy import deepcopy
+from dataclasses import dataclass, field
+from datetime import UTC, datetime
+from types import MappingProxyType
+from typing import Any, Mapping
+from uuid import uuid4
+
+
+@dataclass(frozen=True, slots=True)
+class RuntimeVersion:
+    """Immutable Runtime snapshot."""
+
+    session_id: str
+    transaction_id: str
+    knowledge_structure: Any
+    metadata: Mapping[str, Any]
+
+    version_id: str = field(default_factory=lambda: str(uuid4()))
+    created_at: datetime = field(default_factory=lambda: datetime.now(UTC))
+
+    def __post_init__(self) -> None:
+        """Deep-copy mutable state and freeze metadata."""
+        object.__setattr__(
+            self,
+            "knowledge_structure",
+            deepcopy(self.knowledge_structure),
+        )
+        object.__setattr__(
+            self,
+            "metadata",
+            MappingProxyType(deepcopy(dict(self.metadata))),
+        )
+
+    #
+    # ------------------------------------------------------------------
+    # Copy semantics
+    # ------------------------------------------------------------------
+    #
+    # RuntimeVersion.knowledge_structure is `Any`: Runtime is
+    # storage-independent and must not assume a plugged-in Core's
+    # structure type is immutable, so a blanket `return self` here
+    # would silently break the isolation InMemoryStorage relies on
+    # for non-cks-core adapters with mutable structures.
+    #
+    # The only thing the stdlib `copy` module actually can't handle is
+    # `metadata`, which we wrap in MappingProxyType (immutable by our
+    # own contract) — so we deep-copy every field explicitly instead of
+    # deferring to the default pickle-based reduction.
+
+    def __copy__(self) -> "RuntimeVersion":
+        return type(self)(
+            session_id=self.session_id,
+            transaction_id=self.transaction_id,
+            knowledge_structure=self.knowledge_structure,
+            metadata=dict(self.metadata),
+            version_id=self.version_id,
+            created_at=self.created_at,
+        )
+
+    def __deepcopy__(self, memo: dict[int, Any]) -> "RuntimeVersion":
+        new = type(self)(
+            session_id=self.session_id,
+            transaction_id=self.transaction_id,
+            knowledge_structure=deepcopy(self.knowledge_structure, memo),
+            metadata=dict(self.metadata),
+            version_id=self.version_id,
+            created_at=self.created_at,
+        )
+        memo[id(self)] = new
+        return new
+
+    #
+    # ------------------------------------------------------------------
+    # Metadata
+    # ------------------------------------------------------------------
+
+    @property
+    def has_metadata(self) -> bool:
+        return bool(self.metadata)
+
+    @property
+    def age(self):
+        return datetime.now(UTC) - self.created_at
+
+    #
+    # ------------------------------------------------------------------
+    # Debugging
+    # ------------------------------------------------------------------
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}("
+            f"id={self.version_id!r}, "
+            f"session={self.session_id!r})"
+        )

{cks_runtime-0.4.5 → cks_runtime-0.4.6}/cks_runtime.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-runtime
-Version: 0.4.5
+Version: 0.4.6
 Summary: Canonical Runtime for the Canonical Knowledge Structure ecosystem
 Author: Vladyslav Hruznov
 License: MIT

{cks_runtime-0.4.5 → cks_runtime-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cks-runtime"
-version = "0.4.5"
+version = "0.4.6"
 
 description = "Canonical Runtime for the Canonical Knowledge Structure ecosystem"
 

cks_runtime-0.4.5/cks_runtime/versioning/version.py

@@ -1,110 +0,0 @@
-"""
-Runtime Version.
-
-Represents an immutable Runtime snapshot.
-
-A RuntimeVersion records the operational state of a
-RuntimeSession immediately after a committed RuntimeTransaction.
-
-RuntimeVersions are immutable snapshots.
-"""
-
-from __future__ import annotations
-
-from copy import deepcopy
-from dataclasses import dataclass
-from dataclasses import field
-from datetime import UTC
-from datetime import datetime
-from typing import Any
-from uuid import uuid4
-
-
-@dataclass(frozen=True, slots=True)
-class RuntimeVersion:
-    """
-    Immutable Runtime snapshot.
-
-    Ownership:
-
-    - belongs to exactly one RuntimeSession;
-    - originates from exactly one committed RuntimeTransaction;
-    - stores operational state only.
-
-    RuntimeVersion never owns semantic behaviour.
-    """
-
-    session_id: str
-
-    transaction_id: str
-
-    knowledge_structure: Any
-
-    metadata: dict[str, Any]
-
-    version_id: str = field(
-        default_factory=lambda: str(uuid4()),
-    )
-
-    created_at: datetime = field(
-        default_factory=lambda: datetime.now(
-            UTC,
-        ),
-    )
-
-    def __post_init__(self) -> None:
-        """
-        Deep-copy mutable state.
-
-        RuntimeVersion must never share mutable objects
-        with a live RuntimeSession.
-        """
-
-        object.__setattr__(
-            self,
-            "knowledge_structure",
-            deepcopy(self.knowledge_structure),
-        )
-
-        object.__setattr__(
-            self,
-            "metadata",
-            deepcopy(self.metadata),
-        )
-
-    #
-    # ------------------------------------------------------------------
-    # Metadata
-    # ------------------------------------------------------------------
-    #
-
-    @property
-    def has_metadata(self) -> bool:
-        """
-        Whether this RuntimeVersion contains metadata.
-        """
-
-        return bool(self.metadata)
-
-    @property
-    def age(self):
-        """
-        Time elapsed since this RuntimeVersion was created.
-        """
-
-        return datetime.now(
-            UTC,
-        ) - self.created_at
-
-    #
-    # ------------------------------------------------------------------
-    # Debugging
-    # ------------------------------------------------------------------
-    #
-
-    def __repr__(self) -> str:
-        return (
-            f"{self.__class__.__name__}("
-            f"id={self.version_id!r}, "
-            f"session={self.session_id!r})"
-        )