Build 060.20.1: implement Trade Runtime Layer

app/src/market_data/__init__.py

@@ -0,0 +1 @@
+# app/src/market_data/__init__.py

app/src/market_data/acquisition/runtime/__init__.py

@@ -0,0 +1 @@
+# app/src/market_data/acquisition/runtime/__init__.py

app/src/market_data/acquisition/runtime/trade/trade_runtime_exceptions.py

@@ -0,0 +1,43 @@
+# app/src/market_data/acquisition/runtime/trade/trade_runtime_exceptions.py
+
+from __future__ import annotations
+
+"""
+Инфраструктурные исключения Trade Runtime.
+
+Build 060.20 вводит инфраструктурный слой Trade Runtime.
+
+Данный модуль содержит только инфраструктурные исключения,
+связанные с регистрацией и получением Runtime-компонентов.
+
+Бизнес-исключения отдельных Runtime-модулей (Recovery,
+Stream Consistency и других) должны оставаться
+внутри соответствующих подсистем.
+"""
+
+
+class TradeRuntimeError(Exception):
+    """
+    Базовый класс для всех инфраструктурных исключений Trade Runtime.
+    """
+
+
+class RuntimeAlreadyRegisteredError(TradeRuntimeError):
+    """
+    Вызывается при попытке повторной регистрации Runtime-компонента
+    под уже существующим ключом.
+    """
+
+
+class RuntimeNotRegisteredError(TradeRuntimeError):
+    """
+    Вызывается при попытке получить Runtime-компонент,
+    который отсутствует в TradeRuntimeRegistry.
+    """
+
+
+class InvalidRuntimeComponentError(TradeRuntimeError):
+    """
+    Вызывается при попытке зарегистрировать объект,
+    который не может являться Runtime-компонентом.
+    """

app/src/market_data/acquisition/runtime/trade/trade_runtime_protocol.py

@@ -0,0 +1,85 @@
+# app/src/market_data/acquisition/runtime/trade/trade_runtime_protocol.py
+
+from __future__ import annotations
+
+"""
+Протокол Trade Runtime.
+
+Build 060.20 вводит единый Runtime Layer для управления
+жизненным циклом компонентов, обеспечивающих обработку
+биржевого потока сделок.
+
+TradeRuntimeProtocol определяет минимальный контракт,
+которому должна соответствовать реализация Runtime Registry.
+
+Протокол не описывает внутреннюю реализацию хранения
+компонентов и не содержит бизнес-логики.
+"""
+
+from typing import Any, Protocol
+
+
+class TradeRuntimeProtocol(Protocol):
+    """
+    Протокол реестра Runtime-компонентов.
+    """
+
+    def register(self, key: str, component: Any) -> None:
+        """
+        Регистрирует Runtime-компонент.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+            component:
+                Экземпляр Runtime-компонента.
+        """
+        ...
+
+    def unregister(self, key: str) -> None:
+        """
+        Удаляет Runtime-компонент из реестра.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+        """
+        ...
+
+    def get(self, key: str) -> Any:
+        """
+        Возвращает зарегистрированный Runtime-компонент.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+        Returns:
+            Зарегистрированный Runtime-компонент.
+
+        Raises:
+            RuntimeNotRegisteredError:
+                Если компонент отсутствует в реестре.
+        """
+        ...
+
+    def is_registered(self, key: str) -> bool:
+        """
+        Проверяет наличие Runtime-компонента в реестре.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+        Returns:
+            True, если компонент зарегистрирован,
+            иначе False.
+        """
+        ...
+
+    def clear(self) -> None:
+        """
+        Полностью очищает реестр Runtime-компонентов.
+        """
+        ...

app/src/market_data/acquisition/runtime/trade/trade_runtime_registry.py

@@ -0,0 +1,132 @@
+# app/src/market_data/acquisition/runtime/trade/trade_runtime_registry.py
+
+from __future__ import annotations
+
+"""
+Реестр компонентов Trade Runtime.
+
+Build 060.20 вводит единый инфраструктурный реестр,
+который владеет экземплярами Runtime-компонентов
+и предоставляет их по уникальным строковым ключам.
+
+Реестр не управляет бизнес-состоянием компонентов
+и не содержит логики Stream Consistency, Recovery
+или других подсистем обработки потока сделок.
+"""
+
+from typing import Any
+
+from src.market_data.acquisition.runtime.trade.trade_runtime_exceptions import (
+    InvalidRuntimeComponentError,
+    RuntimeAlreadyRegisteredError,
+    RuntimeNotRegisteredError,
+)
+from src.market_data.acquisition.runtime.trade.trade_runtime_protocol import (
+    TradeRuntimeProtocol,
+)
+
+
+class TradeRuntimeRegistry(TradeRuntimeProtocol):
+    """
+    Реестр Runtime-компонентов потока сделок.
+
+    Каждый компонент регистрируется под уникальным строковым ключом.
+    Повторная регистрация под тем же ключом запрещена.
+    """
+
+    def __init__(self) -> None:
+        """
+        Создаёт пустой реестр Runtime-компонентов.
+        """
+        self._components: dict[str, Any] = {}
+
+    def register(self, key: str, component: Any) -> None:
+        """
+        Регистрирует Runtime-компонент под уникальным ключом.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+            component:
+                Экземпляр Runtime-компонента.
+
+        Raises:
+            InvalidRuntimeComponentError:
+                Если вместо Runtime-компонента передан None.
+
+            RuntimeAlreadyRegisteredError:
+                Если указанный ключ уже используется.
+        """
+        if component is None:
+            raise InvalidRuntimeComponentError(
+                f"Runtime-компонент для ключа {key!r} не может быть None."
+            )
+
+        if key in self._components:
+            raise RuntimeAlreadyRegisteredError(
+                f"Runtime-компонент с ключом {key!r} уже зарегистрирован."
+            )
+
+        self._components[key] = component
+
+    def unregister(self, key: str) -> None:
+        """
+        Удаляет Runtime-компонент из реестра.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+        Raises:
+            RuntimeNotRegisteredError:
+                Если компонент с указанным ключом отсутствует.
+        """
+        if key not in self._components:
+            raise RuntimeNotRegisteredError(
+                f"Runtime-компонент с ключом {key!r} не зарегистрирован."
+            )
+
+        del self._components[key]
+
+    def get(self, key: str) -> Any:
+        """
+        Возвращает зарегистрированный Runtime-компонент.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+        Returns:
+            Зарегистрированный Runtime-компонент.
+
+        Raises:
+            RuntimeNotRegisteredError:
+                Если компонент с указанным ключом отсутствует.
+        """
+        try:
+            return self._components[key]
+        except KeyError as error:
+            raise RuntimeNotRegisteredError(
+                f"Runtime-компонент с ключом {key!r} не зарегистрирован."
+            ) from error
+
+    def is_registered(self, key: str) -> bool:
+        """
+        Проверяет наличие Runtime-компонента в реестре.
+
+        Args:
+            key:
+                Уникальный идентификатор Runtime-компонента.
+
+        Returns:
+            True, если компонент зарегистрирован,
+            иначе False.
+        """
+        return key in self._components
+
+    def clear(self) -> None:
+        """
+        Удаляет из реестра все зарегистрированные Runtime-компоненты.
+        """
+        self._components.clear()