pycraftcore 0.2.2__tar.gz → 0.2.3__tar.gz

{pycraftcore-0.2.2/src/pycraftcore.egg-info → pycraftcore-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycraftcore
-Version: 0.2.2
+Version: 0.2.3
 Summary: Provides reusable technical infrastructure and adapter implementations for Python applications
 Author-email: Toufik Saouchi <toufik.saouchi@gmail.com>
 License-Expression: MIT
@@ -174,8 +174,12 @@ they load as.
 ```python
 from pathlib import Path
 
-from pycraftcore.application_configuration.adapter.load_application_configuration import LoadApplicationConfiguration
-from pycraftcore.application_configuration.adapter.omega_configuration_reader import OmegaConfigurationReader
+from pycraftcore.application_configuration.adapter.load_application_configuration import (
+    LoadApplicationConfiguration,
+)
+from pycraftcore.application_configuration.adapter.omega_configuration_reader import (
+    OmegaConfigurationReader,
+)
 from pycraftcore.application_configuration.enum.run_type_environment import RunTypeEnvironment
 from pycraftcore.logger.adapter.loguru_logger import LoguruLogger
 
@@ -184,8 +188,8 @@ loader = LoadApplicationConfiguration(reader, LoguruLogger())
 
 config = loader.load()
 
-connector = config.connector.api("<connector_tag>")   # ApiConnector
-operation = config.operation.api("<operation_tag>")   # ApiOperation
+connector = config.connector.api("<connector_tag>")  # ApiConnector
+operation = config.operation.api("<operation_tag>")  # ApiOperation
 ```
 
 `config.connector`/`config.operation` return the concrete connector/operation type for a given tag (`.api()`,

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/Readme.md

@@ -137,8 +137,12 @@ they load as.
 ```python
 from pathlib import Path
 
-from pycraftcore.application_configuration.adapter.load_application_configuration import LoadApplicationConfiguration
-from pycraftcore.application_configuration.adapter.omega_configuration_reader import OmegaConfigurationReader
+from pycraftcore.application_configuration.adapter.load_application_configuration import (
+    LoadApplicationConfiguration,
+)
+from pycraftcore.application_configuration.adapter.omega_configuration_reader import (
+    OmegaConfigurationReader,
+)
 from pycraftcore.application_configuration.enum.run_type_environment import RunTypeEnvironment
 from pycraftcore.logger.adapter.loguru_logger import LoguruLogger
 
@@ -147,8 +151,8 @@ loader = LoadApplicationConfiguration(reader, LoguruLogger())
 
 config = loader.load()
 
-connector = config.connector.api("<connector_tag>")   # ApiConnector
-operation = config.operation.api("<operation_tag>")   # ApiOperation
+connector = config.connector.api("<connector_tag>")  # ApiConnector
+operation = config.operation.api("<operation_tag>")  # ApiOperation
 ```
 
 `config.connector`/`config.operation` return the concrete connector/operation type for a given tag (`.api()`,

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pycraftcore"
-version = "0.2.2"
+version = "0.2.3"
 authors = [
     { name = "Toufik Saouchi", email = "toufik.saouchi@gmail.com" },
 ]
@@ -71,8 +71,8 @@ ignore = [
 ]
 
 [tool.ty.src]
-include = ["src"]
-exclude = ["tests", ".venv"]
+include = ["src", "tests/ducktype"]
+exclude = [".venv"]
 
 [tool.setuptools.packages.find]
 where = ["src"]

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/application_configuration/adapter/schema.py

@@ -27,7 +27,6 @@ from pycraftcore.application_configuration.model.operation import (
 
 
 def _kind_tag(value: Any) -> str:
-    """Discriminator: read `type` off a raw dict (pre-coercion) or an already-built dataclass."""
     return value["type"] if isinstance(value, dict) else value.type.value
 
 

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/application_configuration/model/operation.py

@@ -43,13 +43,6 @@ _OPERATION_CLASS_BY_TYPE: dict[OperationType, type[OperationTyping]] = {
 
 @dataclass(frozen=True, slots=True)
 class OperationRegistry:
-    """Operations keyed by name, with per-kind typed lookups.
-
-    Mirrors `ConnectorRegistry`: each operation declares its own `OperationType`, and a
-    mismatch between that declared type and its concrete dataclass is rejected eagerly here
-    instead of surfacing later as a wrong-typed lookup.
-    """
-
     by_name: dict[str, OperationTyping] = field(default_factory=dict)
 
     def __post_init__(self) -> None:

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/application_configuration/port/configuration.py

@@ -1,11 +1,10 @@
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from pycraftcore.application_configuration.model.configuration import (
     ApplicationConfiguration,
 )
 
 
+@runtime_checkable
 class Configuration(Protocol):
     def load(self) -> ApplicationConfiguration | None: ...
-
-    def reload(self) -> ApplicationConfiguration | None: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/application_configuration/port/configuration_reader.py

@@ -1,9 +1,10 @@
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from pycraftcore.application_configuration.model.configuration import (
     ApplicationConfiguration,
 )
 
 
+@runtime_checkable
 class ConfigurationReader(Protocol):
     def read(self) -> ApplicationConfiguration: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/computation_engine/adapter/compute_engine.py

@@ -1,3 +1,5 @@
+from typing import Any
+
 from pycraftcore.computation_engine.port.arithmetic_operation import (
     ArithmeticOperation,
 )
@@ -7,14 +9,14 @@ from pycraftcore.computation_engine.port.calculus_operation import (
 
 
 class ComputeEngine:
-    def __init__(self, arithmetic: ArithmeticOperation, calculus: CalculusOperation):
+    def __init__(self, arithmetic: ArithmeticOperation[Any], calculus: CalculusOperation[Any]):
         self._arithmetic = arithmetic
         self._calculus = calculus
 
     @property
-    def arithmetic(self) -> ArithmeticOperation:
+    def arithmetic(self) -> ArithmeticOperation[Any]:
         return self._arithmetic
 
     @property
-    def calculus(self) -> CalculusOperation:
+    def calculus(self) -> CalculusOperation[Any]:
         return self._calculus

pycraftcore-0.2.3/src/pycraftcore/computation_engine/port/arithmetic_operation.py

@@ -0,0 +1,15 @@
+from collections.abc import Sequence
+from typing import Any, Protocol, runtime_checkable
+
+from pycraftcore.computation_engine.const_typing import Numeric
+
+
+@runtime_checkable
+class ArithmeticOperation[T](Protocol):
+    def to_array(self, sequence: Sequence[Any]) -> T: ...
+
+    def log_returns(self, sequence: Sequence[Numeric]) -> T: ...
+
+    def rolling_average(self, sequence: Sequence[Numeric], window: int) -> T: ...
+
+    def rolling_standard_deviation(self, sequence: Sequence[Numeric], window: int) -> T: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/computation_engine/port/calculus_operation.py

@@ -1,12 +1,13 @@
 from collections.abc import Sequence
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from pycraftcore.computation_engine.const_typing import Kind, Numeric
 
 
-class CalculusOperation(Protocol):
+@runtime_checkable
+class CalculusOperation[T](Protocol):
     def integrate(self, sequence: Sequence[Numeric], dx: float) -> float: ...
 
     def interpolate(
         self, sequence: Sequence[Numeric], kind: Kind = "linear", num: int | None = None
-    ) -> Sequence[Numeric]: ...
+    ) -> T: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/computation_engine/port/engine.py

@@ -1,4 +1,4 @@
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from pycraftcore.computation_engine.port.arithmetic_operation import (
     ArithmeticOperation,
@@ -8,9 +8,10 @@ from pycraftcore.computation_engine.port.calculus_operation import (
 )
 
 
-class Engine(Protocol):
+@runtime_checkable
+class Engine[T](Protocol):
     @property
-    def arithmetic(self) -> ArithmeticOperation: ...
+    def arithmetic(self) -> ArithmeticOperation[T]: ...
 
     @property
-    def calculus(self) -> CalculusOperation: ...
+    def calculus(self) -> CalculusOperation[T]: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/http/adapter/aiohttp_client.py

@@ -1,6 +1,6 @@
 import ssl
 from collections.abc import Mapping
-from typing import Any, Self
+from typing import Any, NoReturn, Self
 
 import aiohttp
 import orjson
@@ -156,7 +156,7 @@ class AioHttpClientFactory:
         return False
 
     @property
-    def resilient_client_instance(self) -> None:
+    def resilient_client_instance(self) -> NoReturn:
         raise NotImplementedError(
             "For aiohttp adapter compose the resilient client using the resilient implementation"
         )

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/http/adapter/resilient_client.py

@@ -1,6 +1,6 @@
-from collections.abc import Callable, Awaitable
+from collections.abc import Awaitable, Callable
 from dataclasses import asdict
-from typing import Final, ParamSpec, TypeVar
+from typing import Any, Final, ParamSpec, TypeVar
 
 from pycraftcore.http.enum.http_method import HttpMethod
 from pycraftcore.http.port.async_circuit_breaker import AsyncCircuitBreaker
@@ -13,6 +13,10 @@ R = TypeVar("R")
 
 
 class ResilientClient:
+
+    get: Callable[..., Awaitable[Any]]
+    post: Callable[..., Awaitable[Any]]
+
     def __init__(
         self,
         base_client: AsyncHttpClient,

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/http/port/async_circuit_breaker.py

@@ -1,5 +1,5 @@
 from collections.abc import Awaitable, Callable
-from typing import ParamSpec, Protocol, TypeVar
+from typing import ParamSpec, Protocol, TypeVar, runtime_checkable
 
 from pycraftcore.http.configuration.circuite_breaker_configuration import (
     CircuitBreakerSettings,
@@ -9,6 +9,7 @@ P = ParamSpec("P")
 R = TypeVar("R")
 
 
+@runtime_checkable
 class AsyncCircuitBreaker(Protocol):
     def _can_attempt(self) -> bool: ...
     def _on_success(self) -> None: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/http/port/async_http_client.py

@@ -1,9 +1,8 @@
-from typing import Any, Protocol, TypeVar
+from typing import Any, Protocol, runtime_checkable
 
-T = TypeVar("T")
 
-
-class AsyncHttpFactory(Protocol):
+@runtime_checkable
+class AsyncHttpFactory[T](Protocol):
     async def start(self) -> None: ...
     async def close(self) -> None: ...
     def create_client(self) -> AsyncHttpClient: ...
@@ -11,6 +10,7 @@ class AsyncHttpFactory(Protocol):
     def resilient_client_instance(self) -> T: ...
 
 
+@runtime_checkable
 class AsyncHttpClient(Protocol):
     async def get(
         self,

pycraftcore-0.2.3/src/pycraftcore/http/port/async_resilient_http_client.py

@@ -0,0 +1,8 @@
+from collections.abc import Awaitable
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class AsyncResilientHttpClient(Protocol):
+    def get(self, *args: Any, **kwargs: Any) -> Awaitable[Any]: ...
+    def post(self, *args: Any, **kwargs: Any) -> Awaitable[Any]: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/http/port/retry.py

@@ -1,5 +1,5 @@
 from collections.abc import Awaitable, Callable
-from typing import ParamSpec, Protocol, TypeVar
+from typing import ParamSpec, Protocol, TypeVar, runtime_checkable
 
 from pycraftcore.http.configuration.retry_configuration import RetrySettings
 
@@ -7,6 +7,7 @@ P = ParamSpec("P")
 R = TypeVar("R")
 
 
+@runtime_checkable
 class Retry(Protocol):
     @property
     def settings(self) -> RetrySettings: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/logger/port/logger.py

@@ -1,6 +1,7 @@
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 
+@runtime_checkable
 class Logger(Protocol):
     def info(self, message: str) -> None: ...
 

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/query_language/sql/sql_handler.py

@@ -1,11 +1,13 @@
-from typing import Protocol, TypeVar
+from typing import Protocol, TypeVar, runtime_checkable
 
 T = TypeVar("T")
 
 
+@runtime_checkable
 class SqlFactory(Protocol):
     def __call__(self, expression: str, dialect: str) -> SqlHandler: ...
 
 
+@runtime_checkable
 class SqlHandler(Protocol):
     def transpile(self, expressions: T | None = None) -> str: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/repository/repository.py

@@ -1,8 +1,9 @@
 from __future__ import annotations
 
-from typing import Any, Protocol
+from typing import Any, Protocol, runtime_checkable
 
 
+@runtime_checkable
 class AsyncRepository(Protocol):
     async def execute(
         self,
@@ -11,6 +12,7 @@ class AsyncRepository(Protocol):
     ) -> list[dict[str, Any]]: ...
 
 
+@runtime_checkable
 class AsyncRepositoryFactory(Protocol):
     async def connection(self) -> Any: ...
     async def disconnect(self) -> None: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/runtime/code.py

@@ -1,12 +1,14 @@
 from string import Template
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from pycraftcore.runtime.python.schema import CodeStdout
 
 
+@runtime_checkable
 class CodeFactory(Protocol):
     def __call__(self, code: str, code_template: Template | None = None) -> Code: ...
 
 
+@runtime_checkable
 class Code(Protocol):
     async def execute(self) -> CodeStdout: ...

pycraftcore-0.2.3/src/pycraftcore/serializer/port/serializer.py

@@ -0,0 +1,12 @@
+from typing import Protocol, TypeVar, runtime_checkable
+
+T = TypeVar("T")
+
+
+@runtime_checkable
+class Serializer[W](Protocol):
+    @staticmethod
+    def serialize(inputs: T) -> W: ...
+
+    @staticmethod
+    def deserialize(inputs: W, cls: type[T]) -> T: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3}/src/pycraftcore/telemetry/port/telemetry.py

@@ -1,16 +1,18 @@
 from collections.abc import Awaitable, Callable
-from typing import Any, ParamSpec, Protocol, TypeVar
+from typing import Any, ParamSpec, Protocol, TypeVar, runtime_checkable
 
 P = ParamSpec("P")
 R = TypeVar("R")
 
 
+@runtime_checkable
 class TelemetryTracer(Protocol):
     def trace(
         self, span_name: str, static_attributes: dict[str, Any]
     ) -> Callable[[Callable[P, Awaitable[R]]], Callable[P, Awaitable[R]]]: ...
 
 
+@runtime_checkable
 class TelemetryProvider(Protocol):
     def tracer(self, service_name: str) -> TelemetryTracer: ...
     def shutdown(self) -> None: ...

{pycraftcore-0.2.2 → pycraftcore-0.2.3/src/pycraftcore.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycraftcore
-Version: 0.2.2
+Version: 0.2.3
 Summary: Provides reusable technical infrastructure and adapter implementations for Python applications
 Author-email: Toufik Saouchi <toufik.saouchi@gmail.com>
 License-Expression: MIT
@@ -174,8 +174,12 @@ they load as.
 ```python
 from pathlib import Path
 
-from pycraftcore.application_configuration.adapter.load_application_configuration import LoadApplicationConfiguration
-from pycraftcore.application_configuration.adapter.omega_configuration_reader import OmegaConfigurationReader
+from pycraftcore.application_configuration.adapter.load_application_configuration import (
+    LoadApplicationConfiguration,
+)
+from pycraftcore.application_configuration.adapter.omega_configuration_reader import (
+    OmegaConfigurationReader,
+)
 from pycraftcore.application_configuration.enum.run_type_environment import RunTypeEnvironment
 from pycraftcore.logger.adapter.loguru_logger import LoguruLogger
 
@@ -184,8 +188,8 @@ loader = LoadApplicationConfiguration(reader, LoguruLogger())
 
 config = loader.load()
 
-connector = config.connector.api("<connector_tag>")   # ApiConnector
-operation = config.operation.api("<operation_tag>")   # ApiOperation
+connector = config.connector.api("<connector_tag>")  # ApiConnector
+operation = config.operation.api("<operation_tag>")  # ApiOperation
 ```
 
 `config.connector`/`config.operation` return the concrete connector/operation type for a given tag (`.api()`,

pycraftcore-0.2.2/src/pycraftcore/computation_engine/port/arithmetic_operation.py

@@ -1,16 +0,0 @@
-from collections.abc import Sequence
-from typing import Any, Protocol
-
-from pycraftcore.computation_engine.const_typing import Numeric
-
-
-class ArithmeticOperation(Protocol):
-    def to_array(self, sequence: Sequence[Any]) -> Sequence[Any]: ...
-
-    def log_returns(self, sequence: Sequence[Numeric]) -> Sequence[Numeric]: ...
-
-    def rolling_average(self, sequence: Sequence[Numeric], window: int) -> Sequence[Numeric]: ...
-
-    def rolling_standard_deviation(
-        self, sequence: Sequence[Numeric], window: int
-    ) -> Sequence[Numeric]: ...

pycraftcore-0.2.2/src/pycraftcore/http/port/async_resilient_http_client.py

@@ -1,6 +0,0 @@
-from typing import Protocol, Any
-
-
-class AsyncResilientHttpClient(Protocol):
-    async def get(self, *args: Any, **kwargs: Any) -> Any: ...
-    async def post(self, *args: Any, **kwargs: Any) -> Any: ...

pycraftcore-0.2.2/src/pycraftcore/serializer/port/serializer.py

@@ -1,11 +0,0 @@
-from typing import Protocol, TypeVar
-
-T = TypeVar("T")
-
-
-class Serializer(Protocol):
-    @staticmethod
-    def serialize(inputs: T) -> bytes: ...
-
-    @staticmethod
-    def deserialize(inputs: bytes, cls: type[T]) -> T: ...