roborean-storage-base 0.1.2__py3-none-any.whl

roborean_storage_base/__init__.py

@@ -0,0 +1,16 @@
+"""Persistence ports for Roborean projects and durable runs."""
+
+from .errors import ConflictError, IntegrityError, NotFoundError, StorageError
+from .ports import ArtifactStore, ProjectRepository, RunRepository
+
+__version__ = "0.2.0"
+
+__all__ = [
+    "ArtifactStore",
+    "ConflictError",
+    "IntegrityError",
+    "NotFoundError",
+    "ProjectRepository",
+    "RunRepository",
+    "StorageError",
+]

roborean_storage_base/errors.py

@@ -0,0 +1,17 @@
+"""Shared storage failure types."""
+
+
+class StorageError(Exception):
+    """Base storage failure."""
+
+
+class NotFoundError(StorageError):
+    """Entity missing from the store."""
+
+
+class ConflictError(StorageError):
+    """Idempotency or optimistic-lock conflict."""
+
+
+class IntegrityError(StorageError):
+    """Corrupt or incomplete package."""

roborean_storage_base/ports.py

@@ -0,0 +1,57 @@
+"""Repository and artifact store protocols."""
+
+from typing import Protocol
+
+from roborean_spec import Project, RunRecord
+
+
+class ProjectRepository(Protocol):
+    """Load and save portable projects by identifier."""
+
+    def get(self, project_id: str) -> Project:
+        """Return the current revision of a project."""
+
+    def get_revision(self, project_id: str, revision: str) -> Project:
+        """Return a pinned project revision."""
+
+    def save(self, project: Project, *, revision: str | None = None) -> str:
+        """Persist a project and return the revision identifier."""
+
+    def list_ids(self) -> list[str]:
+        """List stored project identifiers."""
+
+    def delete(self, project_id: str) -> None:
+        """Remove a project and its revisions."""
+
+
+class RunRepository(Protocol):
+    """Persist durable run records with idempotency lookup."""
+
+    def get(self, run_id: str) -> RunRecord:
+        """Return one run by identifier."""
+
+    def get_by_idempotency(
+        self, project_id: str, idempotency_key: str
+    ) -> RunRecord | None:
+        """Return an existing run for an idempotency key, if any."""
+
+    def save(self, record: RunRecord) -> None:
+        """Insert a new run record."""
+
+    def update(self, record: RunRecord) -> None:
+        """Replace an existing run record."""
+
+    def list_for_project(
+        self, project_id: str, *, limit: int = 50
+    ) -> list[RunRecord]:
+        """List recent runs for a project, newest first."""
+
+
+class ArtifactStore(Protocol):
+    """Store opaque binary artifacts referenced by runs."""
+
+    def put_bytes(self, key: str, data: bytes, *, content_type: str) -> str:
+        """Store bytes and return the storage key."""
+
+    def get_bytes(self, key: str) -> bytes:
+        """Load previously stored bytes."""

roborean_storage_base/types.py

@@ -0,0 +1,5 @@
+"""Re-exports used by storage adapters."""
+
+from roborean_spec import CompiledProject, Project, RunRecord, RunResults
+
+__all__ = ["CompiledProject", "Project", "RunRecord", "RunResults"]

roborean_storage_base-0.1.2.dist-info/METADATA

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: roborean-storage-base
+Version: 0.1.2
+Summary: Persistence ports for Roborean projects and runs
+Project-URL: Homepage, https://github.com/TNick/roborean
+Project-URL: Repository, https://github.com/TNick/roborean
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: roborean-spec>=0.1.1
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == 'dev'
+Requires-Dist: flake8>=7.0; extra == 'dev'
+Requires-Dist: isort>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# roborean-storage-base
+
+Persistence ports for Roborean projects and durable runs.
+
+```python
+from roborean_storage_base import ProjectRepository, RunRepository
+```
+
+Adapters implement these protocols; the engine never writes files directly
+from `runner.py`.

roborean_storage_base-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+roborean_storage_base/__init__.py,sha256=59ZG0PuTFD2lHpnvc5d8soWl7upg2JD-KTeKyVSngFo,400
+roborean_storage_base/errors.py,sha256=7v8ZUZn5xE8ZxSBdJG-EYpgZ1ErP_RR_PlgAkC2upFk,346
+roborean_storage_base/ports.py,sha256=nB2OpjIPrwj80-TgeBhyoHolhQSGj_C37Sp28VFOB8c,1792
+roborean_storage_base/types.py,sha256=WXCiU9i_k_IgcO2SddbdBssBG2aLigoxKVU8WEO9k4s,187
+roborean_storage_base-0.1.2.dist-info/METADATA,sha256=FYqZSo_3fJ8etWxgZLyRvUQk_tJrP2-iv3HExpks1W8,814
+roborean_storage_base-0.1.2.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+roborean_storage_base-0.1.2.dist-info/RECORD,,

roborean_storage_base-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any