Add runtime-checkable Protocol typing to all public interfaces.

Enables structural subtyping for consumers while preserving nominal adapter inheritance, instantiation guards, and scan_keys defaults. Co-authored-by: Cursor <[email protected]>
2026-07-11 09:45:42 +02:00
parent 0829354cc4
commit f6ee9a3724
8 changed files with 158 additions and 16 deletions
@@ -1,11 +1,12 @@
-"""Definition of JsonRepositoryInterface abstract base class."""
+"""Definition of JsonRepositoryInterface protocol and abstract base class."""

-from abc import ABC, abstractmethod
+from abc import abstractmethod
 from collections.abc import Iterator
-from typing import Any
+from typing import Any, Protocol, runtime_checkable


-class JsonRepositoryInterface(ABC):
+@runtime_checkable
+class JsonRepositoryInterface(Protocol):
    """Interface that defines JSON document CRUD methods."""

    @abstractmethod