pycraftcore 0.1.0__tar.gz

pycraftcore-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stoufik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycraftcore-0.1.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: pycraftcore
+Version: 0.1.0
+Summary: Provides reusable technical infrastructure and adapter implementations for Python applications
+Author-email: Toufik Saouchi <toufik.saouchi@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/s-toufik/pycraftcore
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: aiohttp
+Requires-Dist: orjson
+Requires-Dist: pyyaml
+Requires-Dist: omegaconf
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: opentelemetry-exporter-otlp
+Requires-Dist: pyinstrument
+Requires-Dist: asyncpg
+Requires-Dist: pydantic>=2
+Requires-Dist: python-dotenv
+Requires-Dist: msgpack>=1.1.2
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: scipy>=1.17.1
+Requires-Dist: httpx
+Requires-Dist: tenacity
+Requires-Dist: aiobreaker
+Requires-Dist: aiosqlite
+Requires-Dist: sqlglot
+Requires-Dist: starlette
+Dynamic: license-file

pycraftcore-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pycraftcore"
+version = "0.1.0"
+authors = [
+    { name = "Toufik Saouchi", email = "toufik.saouchi@gmail.com" },
+]
+description = "Provides reusable technical infrastructure and adapter implementations for Python applications"
+readme = "README.md"
+requires-python = ">=3.14"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+dependencies = [
+    "numpy",
+    "aiohttp",
+    "orjson",
+    "pyyaml",
+    "omegaconf",
+    "opentelemetry-api",
+    "opentelemetry-sdk",
+    "opentelemetry-exporter-otlp",
+    "pyinstrument",
+    "asyncpg",
+    "pydantic>=2",
+    "python-dotenv",
+    "msgpack>=1.1.2",
+    "loguru>=0.7.3",
+    "scipy>=1.17.1",
+    "httpx",
+    "tenacity",
+    "aiobreaker",
+    "aiosqlite",
+    "sqlglot",
+    "starlette",
+]
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "hypothesis>=6.151.9",
+    "pytest-asyncio",
+    "pytest-cov>=7.1.0",
+    "ruff",
+    "scipy-stubs>=1.17.1.3",
+    "Pyright",
+    "mypy"
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py314"
+
+[tool.mypy]
+python_version = "3.14"
+strict = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://github.com/s-toufik/pycraftcore"

pycraftcore-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pycraftcore-0.1.0/src/pycraftcore/app_configuration/__init__.py

@@ -0,0 +1,5 @@
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+from pycraftcore.app_configuration.port.configuration import Configuration
+from pycraftcore.app_configuration.port.configuration_reader import ConfigurationReader
+
+__all__ = ["AppConfiguration", "Configuration", "ConfigurationReader"]

pycraftcore-0.1.0/src/pycraftcore/app_configuration/adapter/load_configuration.py

@@ -0,0 +1,41 @@
+import threading
+from typing import ParamSpec
+
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+from pycraftcore.app_configuration.port.configuration_reader import (
+    ConfigurationReader,
+)
+from pycraftcore.logger.port.logger import Logger
+
+P = ParamSpec("P")
+
+
+class LoadConfiguration:
+    _instance = None
+    _lock = threading.Lock()
+
+    def __new__(cls, *args: P.args, **kwargs: P.kwargs):
+        if not cls._instance:
+            with cls._lock:
+                if not cls._instance:
+                    cls._instance = object.__new__(cls)
+        return cls._instance
+
+    def __init__(self, configuration_reader: ConfigurationReader, logger: Logger):
+        self._configuration_reader = configuration_reader
+        self._logger = logger
+        self._cached_config: AppConfiguration | None = None
+
+    def load(self) -> AppConfiguration | None:
+        if self._cached_config is None:
+            try:
+                self._cached_config = self._configuration_reader.read()
+            except Exception as exception:
+                self._logger.critical(exception.__str__())
+        return self._cached_config
+
+    def reload(self) -> AppConfiguration | None:
+        with self._lock:
+            configuration = self._configuration_reader.read()
+        self._cached_config = configuration
+        return self._cached_config

pycraftcore-0.1.0/src/pycraftcore/app_configuration/adapter/omega_configuration_reader.py

@@ -0,0 +1,52 @@
+from pathlib import Path
+from typing import cast, Any
+
+from omegaconf import OmegaConf, DictConfig
+
+from pycraftcore.app_configuration.adapter.schema import (
+    AppConfigurationSchema,
+    MapperDomainSchema,
+)
+from pycraftcore.app_configuration.enum.run_type_environment import (
+    RunTypeEnvironment,
+)
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+
+
+class OmegaConfigurationReader:
+    FILE_EXTENSION = "yml"
+    ROOT_CONFIG_FILE_NAME = "root"
+    CONNECTOR_CONFIG_FILE_NAME = "connector"
+    OPERATION_CONFIG_FILE_NAME = "operation"
+    CRONJOB_CONFIG_FILE_NAME = "cronjob"
+
+    def __init__(self, env: RunTypeEnvironment, config_directory: Path) -> None:
+        self._env = env
+        self._config_directory = config_directory
+
+    def read(self) -> AppConfiguration:
+        config_root: Path = (
+            self._config_directory / f"{self.ROOT_CONFIG_FILE_NAME}.{self.FILE_EXTENSION}"
+        )
+        config_dir_env = self._config_directory / f"{self._env.value}"
+
+        omega_config: DictConfig = self._omega_read(config_dir_env, config_root)
+        omega_container: Any = OmegaConf.to_container(
+            omega_config.app_configuration, resolve=True, throw_on_missing=True
+        )
+        app_config_schema = AppConfigurationSchema(**omega_container)
+        return MapperDomainSchema.map(app_config_schema)
+
+    def _omega_read(self, config_dir_env: Path, config_root: Path) -> DictConfig:
+        return cast(
+            DictConfig,
+            OmegaConf.merge(
+                *self._load_yml_dir(config_dir_env / self.CONNECTOR_CONFIG_FILE_NAME),
+                *self._load_yml_dir(config_dir_env / self.OPERATION_CONFIG_FILE_NAME),
+                *self._load_yml_dir(config_dir_env / self.CRONJOB_CONFIG_FILE_NAME),
+                OmegaConf.load(config_root),
+            ),
+        )
+
+    def _load_yml_dir(self, directory: Path) -> list:
+        return [OmegaConf.load(f) for f in sorted(directory.glob(f"*.{self.FILE_EXTENSION}"))]

pycraftcore-0.1.0/src/pycraftcore/app_configuration/adapter/schema.py

@@ -0,0 +1,29 @@
+from pydantic import BaseModel
+from typing import Sequence
+
+from pycraftcore.app_configuration.enum.connector_type import ConnectorType
+from pycraftcore.app_configuration.enum.run_type_application import (
+    RunTypeApplication,
+)
+from pycraftcore.app_configuration.enum.run_type_environment import (
+    RunTypeEnvironment,
+)
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+from pycraftcore.app_configuration.model.connector import ConnectorTyping
+
+from pycraftcore.app_configuration.model.cronjob import CronJob
+from pycraftcore.app_configuration.model.operation import OperationTyping
+
+
+class AppConfigurationSchema(BaseModel):
+    env: RunTypeEnvironment
+    run: RunTypeApplication
+    connector: dict[ConnectorType, dict[str, ConnectorTyping]]
+    operation: dict[str, OperationTyping]
+    cronjob: Sequence[CronJob]
+
+
+class MapperDomainSchema:
+    @staticmethod
+    def map(app_configuration_schema: AppConfigurationSchema) -> AppConfiguration:
+        return AppConfiguration(**vars(app_configuration_schema))

pycraftcore-0.1.0/src/pycraftcore/app_configuration/enum/connector_type.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+
+class ConnectorType(Enum):
+    api = "api"
+    database = "database"
+    cache = "cache"
+    file = "file"
+    telemetry = "telemetry"

pycraftcore-0.1.0/src/pycraftcore/app_configuration/enum/file_operation_action.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class FileOperationAction(Enum):
+    read = "read"
+    write = "write"
+    delete = "delete"

pycraftcore-0.1.0/src/pycraftcore/app_configuration/enum/run_type_application.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class RunTypeApplication(Enum):
+    asynchronous = "async"
+    synchronous = "sync"

pycraftcore-0.1.0/src/pycraftcore/app_configuration/enum/run_type_environment.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+
+class RunTypeEnvironment(Enum):
+    debug = "debug"
+    production = "prod"
+    staging = "stg"
+    develop = "dev"

pycraftcore-0.1.0/src/pycraftcore/app_configuration/model/configuration.py

@@ -0,0 +1,22 @@
+from typing import Sequence
+from dataclasses import dataclass
+
+from pycraftcore.app_configuration.enum.connector_type import ConnectorType
+from pycraftcore.app_configuration.enum.run_type_application import (
+    RunTypeApplication,
+)
+from pycraftcore.app_configuration.enum.run_type_environment import (
+    RunTypeEnvironment,
+)
+from pycraftcore.app_configuration.model.connector import ConnectorTyping
+from pycraftcore.app_configuration.model.cronjob import CronJob
+from pycraftcore.app_configuration.model.operation import OperationTyping
+
+
+@dataclass(frozen=True, slots=True)
+class AppConfiguration:
+    env: RunTypeEnvironment
+    run: RunTypeApplication
+    connector: dict[ConnectorType, dict[str, ConnectorTyping]]
+    operation: dict[str, OperationTyping]
+    cronjob: Sequence[CronJob]

pycraftcore-0.1.0/src/pycraftcore/app_configuration/model/connector.py

@@ -0,0 +1,43 @@
+from dataclasses import dataclass, field
+from typing import Union
+
+from pycraftcore.app_configuration.enum.connector_type import ConnectorType
+from pycraftcore.authentication import AuthTyping
+
+
+@dataclass(slots=True)
+class BaseConnector:
+    name: str
+    type: ConnectorType
+    auth: AuthTyping
+
+
+@dataclass(slots=True)
+class ApiConnector(BaseConnector):
+    base_url: str
+    timeout: int
+    retry: int
+    certificate: str | None = field(default=None)
+
+
+@dataclass(slots=True)
+class DatabaseConnector(BaseConnector):
+    engine: str
+    host: str
+    port: int
+    default_name: str
+    pool: dict[str, int]
+
+
+@dataclass(slots=True)
+class FileConnector(BaseConnector):
+    base_path: str
+
+
+@dataclass(slots=True)
+class TelemetryConnector(BaseConnector):
+    host: str
+    port: int
+
+
+ConnectorTyping = Union[ApiConnector, FileConnector, DatabaseConnector, TelemetryConnector]

pycraftcore-0.1.0/src/pycraftcore/app_configuration/model/cronjob.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+
+from pycraftcore.app_configuration.model.operation import OperationTyping
+
+
+@dataclass(slots=True)
+class CronJob:
+    name: str
+    cron: str
+    operation: OperationTyping

pycraftcore-0.1.0/src/pycraftcore/app_configuration/model/operation.py

@@ -0,0 +1,32 @@
+from dataclasses import dataclass
+from typing import Union, List
+
+from pycraftcore.app_configuration.enum.file_operation_action import (
+    FileOperationAction,
+)
+from pycraftcore.app_configuration.model.connector import ConnectorTyping
+from pycraftcore.http.enum.http_method import HttpMethod
+
+ParamType = Union[str, List[str]]
+
+
+@dataclass(slots=True)
+class BaseOperation:
+    name: str
+    connector: ConnectorTyping
+
+
+@dataclass(slots=True)
+class ApiOperation(BaseOperation):
+    endpoint: str
+    method: HttpMethod
+    parameters: dict[str, ParamType]
+
+
+@dataclass(slots=True)
+class FileOperation(BaseOperation):
+    action: FileOperationAction
+    parameters: dict[str, ParamType]
+
+
+OperationTyping = Union[FileOperation, ApiOperation]

pycraftcore-0.1.0/src/pycraftcore/app_configuration/port/configuration.py

@@ -0,0 +1,9 @@
+from typing import Protocol
+
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+
+
+class Configuration(Protocol):
+    def load(self) -> AppConfiguration | None: ...
+
+    def reload(self) -> AppConfiguration | None: ...

pycraftcore-0.1.0/src/pycraftcore/app_configuration/port/configuration_reader.py

@@ -0,0 +1,7 @@
+from typing import Protocol
+
+from pycraftcore.app_configuration.model.configuration import AppConfiguration
+
+
+class ConfigurationReader(Protocol):
+    def read(self) -> AppConfiguration: ...

pycraftcore-0.1.0/src/pycraftcore/authentication/__init__.py

@@ -0,0 +1,5 @@
+from pycraftcore.authentication.model.basic_auth import BasicAuth
+from pycraftcore.authentication.model.no_auth import NoAuth
+from pycraftcore.authentication.model.token_auth import TokenAuth
+
+AuthTyping = NoAuth | TokenAuth | BasicAuth

pycraftcore-0.1.0/src/pycraftcore/authentication/model/auth_type.py

@@ -0,0 +1,7 @@
+import enum
+
+
+class AuthType(enum.Enum):
+    token = "token"
+    basic = "basic"
+    none = "none"

pycraftcore-0.1.0/src/pycraftcore/authentication/model/basic_auth.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass, field
+
+from .auth_type import AuthType
+
+
+@dataclass(frozen=True, slots=True)
+class BasicAuth:
+    username: str
+    password: str
+    type: AuthType = field(default=AuthType.basic)

pycraftcore-0.1.0/src/pycraftcore/authentication/model/no_auth.py

@@ -0,0 +1,8 @@
+from dataclasses import dataclass, field
+
+from .auth_type import AuthType
+
+
+@dataclass(frozen=True, slots=True)
+class NoAuth:
+    type: AuthType = field(default=AuthType.none)

pycraftcore-0.1.0/src/pycraftcore/authentication/model/token_auth.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass, field
+
+from .auth_type import AuthType
+
+
+@dataclass(frozen=True, slots=True)
+class TokenAuth:
+    key_name: str
+    key_value: str
+    type: AuthType = field(default=AuthType.token)

pycraftcore-0.1.0/src/pycraftcore/computation_engine/adapter/compute_engine.py

@@ -0,0 +1,20 @@
+from pycraftcore.computation_engine.port.arithmetic_operation import (
+    ArithmeticOperation,
+)
+from pycraftcore.computation_engine.port.calculus_operation import (
+    CalculusOperation,
+)
+
+
+class ComputeEngine:
+    def __init__(self, arithmetic: ArithmeticOperation, calculus: CalculusOperation):
+        self._arithmetic = arithmetic
+        self._calculus = calculus
+
+    @property
+    def arithmetic(self) -> ArithmeticOperation:
+        return self._arithmetic
+
+    @property
+    def calculus(self) -> CalculusOperation:
+        return self._calculus

pycraftcore-0.1.0/src/pycraftcore/computation_engine/adapter/numpy_arithmetic_operation.py

@@ -0,0 +1,49 @@
+from typing import Sequence, Any
+
+import numpy as np
+
+from pycraftcore.computation_engine.const_typing import Numeric
+
+
+class NumPyArithmeticOperation:
+    def to_array(self, sequence: Sequence[Any]) -> np.ndarray:
+        return self._as_array(sequence)
+
+    def log_returns(self, sequence: Sequence[Numeric]) -> np.ndarray:
+
+        if len(sequence) < 2:
+            return self._empty_array()
+
+        array = self._as_array(sequence)
+
+        ratio = array[1:] / array[:-1]
+        ratio = np.where(ratio <= 0, np.nan, ratio)
+        return np.log(ratio)
+
+    def rolling_average(self, sequence: Sequence[Numeric], window: int = 5) -> np.ndarray:
+        if len(sequence) < window:
+            return self._empty_array()
+
+        array = self._as_array(sequence)
+        kernel = self._as_array((np.ones(window) / window).astype(np.float64))
+        return np.convolve(array, kernel)
+
+    def rolling_standard_deviation(
+        self, sequence: Sequence[Numeric], window: int = 5
+    ) -> np.ndarray:
+        if len(sequence) < window:
+            return self._empty_array()
+
+        array = self._as_array(sequence)
+
+        return np.array([np.std(array[i : i + window]) for i in range(len(array) - window + 1)])
+
+    @staticmethod
+    def _empty_array() -> np.ndarray:
+        return np.array([], dtype=np.float64)
+
+    @staticmethod
+    def _as_array(sequence: Sequence[Any]) -> np.ndarray:
+        if isinstance(sequence, np.ndarray):
+            return sequence
+        return np.asarray(sequence, dtype=np.float64)

pycraftcore-0.1.0/src/pycraftcore/computation_engine/adapter/scipy_calculus_operation.py

@@ -0,0 +1,21 @@
+from typing import Sequence, Any
+
+import numpy as np
+from scipy import interpolate, integrate
+
+from pycraftcore.computation_engine.const_typing import Numeric, Kind
+
+
+class ScipyCalculusOperation:
+    def _to_array(self, sequence: Sequence[Any]) -> np.ndarray:
+        return np.asarray(sequence, dtype=np.float64)
+
+    def integrate(self, sequence: Sequence[Numeric], dx: float) -> float:
+        arr = self._to_array(sequence)
+        return float(integrate.trapezoid(arr, dx=dx))
+
+    def interpolate(self, sequence: Sequence[Numeric], kind: Kind = "linear") -> Sequence[Numeric]:
+        arr = self._to_array(sequence)
+        x = np.arange(len(arr))
+        f = interpolate.interp1d(x, arr, kind=kind)
+        return f(x)

pycraftcore-0.1.0/src/pycraftcore/computation_engine/const_typing.py

@@ -0,0 +1,15 @@
+from typing import Literal
+
+Numeric = int | float
+
+Kind = Literal[
+    "linear",
+    "nearest",
+    "nearest-up",
+    "zero",
+    "slinear",
+    "quadratic",
+    "cubic",
+    "previous",
+    "next",
+]

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

@@ -0,0 +1,15 @@
+from typing import Sequence, 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.1.0/src/pycraftcore/computation_engine/port/calculus_operation.py

@@ -0,0 +1,11 @@
+from typing import Sequence, Protocol
+
+from pycraftcore.computation_engine.const_typing import Numeric, Kind
+
+
+class CalculusOperation(Protocol):
+    def integrate(self, sequence: Sequence[Numeric], dx: float) -> float: ...
+
+    def interpolate(
+        self, sequence: Sequence[Numeric], kind: Kind = "linear"
+    ) -> Sequence[Numeric]: ...

pycraftcore-0.1.0/src/pycraftcore/computation_engine/port/engine.py

@@ -0,0 +1,16 @@
+from typing import Protocol
+
+from pycraftcore.computation_engine.port.arithmetic_operation import (
+    ArithmeticOperation,
+)
+from pycraftcore.computation_engine.port.calculus_operation import (
+    CalculusOperation,
+)
+
+
+class Engine(Protocol):
+    @property
+    def arithmetic(self) -> ArithmeticOperation: ...
+
+    @property
+    def calculus(self) -> CalculusOperation: ...