alpha-python 0.1.0__tar.gz

alpha_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 breijling
+
+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.

alpha_python-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: alpha-python
+Version: 0.1.0
+Summary: Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction.
+Author-email: Bart Reijling <bart@reijling.eu>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs>=25.4.0
+Requires-Dist: gunicorn>=23.0.0
+Requires-Dist: jsonpatch>=1.33
+Requires-Dist: numpy>=2.3.5
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: six>=1.17.0
+Requires-Dist: sqlalchemy>=2.0.44
+Dynamic: license-file
+
+# alpha
+
+Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction. 

alpha_python-0.1.0/README.md

@@ -0,0 +1,3 @@
+# alpha
+
+Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction. 

alpha_python-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "alpha-python"
+version = "0.1.0"
+description = "Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction."
+readme = "README.md"
+authors = [
+    { name = "Bart Reijling", email = "bart@reijling.eu" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "attrs>=25.4.0",
+    "gunicorn>=23.0.0",
+    "jsonpatch>=1.33",
+    "numpy>=2.3.5",
+    "pandas>=2.3.3",
+    "pydantic>=2.12.5",
+    "pyjwt>=2.10.1",
+    "six>=1.17.0",
+    "sqlalchemy>=2.0.44",
+]
+
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[dependency-groups]
+dev = [
+    "black>=25.11.0",
+    "coverage>=7.12.0",
+    "isort>=7.0.0",
+    "mypy>=1.18.2",
+    "pytest>=9.0.1",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.7",
+]
+
+[tool.pytest.ini_options]
+minversion = 7.0
+python_files = "test_*.py"
+addopts = "-v -p no:warnings --cov --cov-report=lcov:./coverage/lcov.info --cov-report=term --cov-report=term-missing"
+testpaths = [
+    "tests"
+]
+
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "tests/*",
+    "__init__.py",
+    "_http_codes.py"
+]
+
+[tool.black]
+line-length = 79
+skip-string-normalization = true
+target-version = ['py310', 'py311', 'py312', 'py313']
+
+[tool.isort]
+py_version = 311
+profile = "black"
+line_length = 79
+force_grid_wrap = 0
+
+[tool.mypy]
+python_version = "3.11"
+exclude = ['^tests/']
+
+[tool.ruff]
+line-length = 79

alpha_python-0.1.0/setup.cfg

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

alpha_python-0.1.0/src/alpha/adapters/sqla_unit_of_work.py

@@ -0,0 +1,120 @@
+"""Contains the SQLAlchemy Unit of Work implementation."""
+
+from typing import Any, TypeVar
+
+from sqlalchemy.orm.session import Session
+
+from alpha import exceptions
+from alpha.interfaces.sql_database import SqlDatabase
+from alpha.repositories.models.repository_model import RepositoryModel
+
+UOW = TypeVar("UOW", bound="SqlAlchemyUnitOfWork")
+
+
+class SqlAlchemyUnitOfWork:
+    """Unit of Work implementation for SQLAlchemy databases."""
+
+    def __init__(self, db: SqlDatabase, repos: list[RepositoryModel]) -> None:
+        """Initialize the Unit of Work with a database and repositories.
+
+        Parameters
+        ----------
+        db : SqlDatabase
+            The database instance to use.
+        repos : list[RepositoryModel]
+            The list of repository models to use.
+
+        Raises
+        ------
+        TypeError
+            If the provided database is not a valid SqlDatabase instance.
+        TypeError
+            If the provided repositories list is empty or contains invalid
+            models.
+        """
+        if not isinstance(db, SqlDatabase):  # type: ignore
+            raise TypeError("No valid database provided")
+
+        self._db = db
+        self._repositories = repos
+        self._session: Session | None = None
+
+    def __enter__(self: UOW) -> UOW:
+        """Initialize the Unit of Work context.
+
+        Returns
+        -------
+            The Unit of Work instance.
+
+        Raises
+        ------
+        TypeError
+            If the provided repositories list is empty or contains invalid
+            models.
+        """
+        self._session = self._db.get_session()
+
+        for repo in self._repositories:
+            session = self._session
+            model = repo.default_model
+
+            name: str = repo.name
+            repository = repo.repository
+            interface: Any = repo.interface
+
+            self.__setattr__(
+                name,
+                repository(session=session, default_model=model),  # type: ignore
+            )
+            if interface:
+                if not isinstance(getattr(self, name), interface):
+                    raise TypeError(f"Repository for {name} has no interface")
+
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        """Finalize the Unit of Work context."""
+        if not self._session:
+            raise exceptions.DatabaseSessionError(
+                "No active database session is defined"
+            )
+        self._session.close()
+        self.rollback()
+        self._session = None  # type: ignore
+
+    def commit(self) -> None:
+        """Commit the current transaction."""
+        if not self._session:
+            raise exceptions.DatabaseSessionError(
+                "No active database session is defined"
+            )
+        self._session.commit()
+
+    def flush(self) -> None:
+        """Flush the current transaction."""
+        if not self._session:
+            raise exceptions.DatabaseSessionError(
+                "No active database session is defined"
+            )
+        self._session.flush()
+
+    def rollback(self) -> None:
+        """Rollback the current transaction."""
+        if not self._session:
+            raise exceptions.DatabaseSessionError(
+                "No active database session is defined"
+            )
+        self._session.rollback()
+
+    def refresh(self, obj: object) -> None:
+        """Refresh the state of a given object."""
+        if not self._session:
+            raise exceptions.DatabaseSessionError(
+                "No active database session is defined"
+            )
+        self._session.refresh(obj)
+
+    @property
+    def session(self) -> Session | None:
+        """Get the current database session."""
+        return self._session

alpha_python-0.1.0/src/alpha/domain/models/base_model.py

@@ -0,0 +1,25 @@
+from dataclasses import dataclass
+from typing import Any, TypeVar
+
+DomainModel = TypeVar("DomainModel", bound="BaseDomainModel")
+DomainModelCovariant = TypeVar(
+    "DomainModelCovariant", bound="BaseDomainModel", covariant=True
+)
+DomainModelContravariant = TypeVar(
+    "DomainModelContravariant", bound="BaseDomainModel", contravariant=True
+)
+
+
+@dataclass
+class BaseDomainModel:
+    def to_dict(self) -> dict[str, Any]:
+        obj: dict[str, Any] = {}
+        for attr in self.__dataclass_fields__.keys():
+            if not attr.startswith("_"):
+                obj[attr] = getattr(self, attr)
+            if attr == "_id":
+                obj[attr] = str(getattr(self, attr))
+        return obj
+
+    def update(self, obj: DomainModel) -> DomainModel:
+        raise NotImplementedError("Subclasses must implement the update method")

alpha_python-0.1.0/src/alpha/encoder.py

@@ -0,0 +1,62 @@
+import json
+from dataclasses import asdict, is_dataclass
+from datetime import date, datetime, time
+from enum import Enum
+from json import encoder
+from typing import Any
+from uuid import UUID
+
+import numpy as np
+import pandas as pd
+import six
+
+from alpha.interfaces.openapi_model import OpenAPIModel
+
+
+class JSONEncoder(encoder.JSONEncoder):
+    include_nulls = False
+
+    def default(self, o: Any) -> Any:
+        if isinstance(o, list):
+            return [self.default(item) for item in o]  # type: ignore
+        if isinstance(o, OpenAPIModel):
+            dikt: dict[str, Any] = {}
+            for attr, _ in six.iteritems(o.openapi_types):
+                value = getattr(o, attr)
+                if value is None and not self.include_nulls:
+                    continue
+                attr = o.attribute_map[attr]
+                dikt[attr] = value
+            return dikt
+        if hasattr(o, "to_dict"):
+            return o.to_dict()
+        if hasattr(o, "to_list"):
+            return o.to_list()
+        if isinstance(o, set):
+            return list(o)  # type: ignore
+        if isinstance(o, Enum):
+            return o.name
+        if isinstance(o, UUID):
+            return str(o)
+        if isinstance(o, np.int64):  # type: ignore
+            return int(o)
+        if isinstance(o, np.float32):  # type: ignore
+            return float(o)
+        if isinstance(o, pd.Timestamp):
+            return o.isoformat()
+        if isinstance(o, datetime):
+            return o.isoformat()
+        if isinstance(o, date):
+            return o.isoformat()
+        if isinstance(o, time):
+            return o.isoformat()
+        if is_dataclass(o):
+            if isinstance(o, type):
+                cls = getattr(o, "__class__")
+                return cls.__name__
+            return asdict(o)
+
+        try:
+            return json.JSONEncoder.default(self, o)
+        except Exception:
+            return None

alpha_python-0.1.0/src/alpha/exceptions.py

@@ -0,0 +1,99 @@
+# HTTP Exceptions
+class BadRequestException(Exception):
+    """Equivalent to HTTP code 400"""
+
+
+class UnauthorizedException(Exception):
+    """Equivalent to HTTP code 401"""
+
+
+class ForbiddenException(Exception):
+    """Equivalent to HTTP code 403"""
+
+
+class NotFoundException(Exception):
+    """Equivalent to HTTP code 404"""
+
+
+class NotAcceptableException(Exception):
+    """Equivalent to HTTP code 406"""
+
+
+class ConflictException(Exception):
+    """Equivalent to HTTP code 409"""
+
+
+class PayloadTooLargeException(Exception):
+    """Equivalent to HTTP code 413"""
+
+
+class UnprocessableContentException(Exception):
+    """Equivalent to HTTP code 422"""
+
+
+class ErrorException(Exception): ...
+
+
+class InternalServerErrorException(ErrorException):
+    """Equivalent to HTTP code 500"""
+
+
+class NotImplementedException(ErrorException):
+    """Equivalent to HTTP code 501"""
+
+
+class BadGatewayException(ErrorException):
+    """Equivalent to HTTP code 502"""
+
+
+class ServiceUnavailableException(ErrorException):
+    """Equivalent to HTTP code 503"""
+
+
+## Common exceptions
+class DatabaseMapperError(Exception): ...
+
+
+class DatabaseSessionError(InternalServerErrorException): ...
+
+
+class InstrumentedAttributeMissing(Exception): ...
+
+
+class AlreadyExistsException(ForbiddenException): ...
+
+
+class TypingFactoryException(Exception): ...
+
+
+class ModelClassFactoryException(Exception): ...
+
+
+class DefaultFactoryException(Exception): ...
+
+
+class ObjectConversionNotSupported(Exception): ...
+
+
+class ObjectConversionNotAllowed(Exception): ...
+
+
+class ObjectConversionError(Exception): ...
+
+
+class UnionArgumentError(Exception): ...
+
+
+class MixedArgumentTypesError(Exception): ...
+
+
+class MissingAttributeError(Exception): ...
+
+
+class ClassMismatchException(Exception): ...
+
+
+class LoggingHandlerException(Exception): ...
+
+
+class ClassFactoryException(Exception): ...

alpha_python-0.1.0/src/alpha/factories/_type_conversion_matrix.py

@@ -0,0 +1,233 @@
+"""Contains the TYPE_CONVERSION_MATRIX constant which can be used to determine
+if it is allowed to cast an object to a different type.
+"""
+
+import datetime
+import uuid
+
+TYPE_CONVERSION_MATRIX: dict[type, dict[type, bool]] = {
+    str: {
+        str: True,
+        complex: True,
+        int: True,
+        float: True,
+        bytes: True,
+        bytearray: True,
+        list: True,
+        dict: False,
+        set: True,
+        tuple: True,
+        bool: True,
+        datetime.datetime: True,
+        datetime.date: True,
+        uuid.UUID: True,
+    },
+    complex: {
+        str: True,
+        complex: True,
+        int: False,
+        float: False,
+        bytes: False,
+        bytearray: False,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    int: {
+        str: True,
+        complex: True,
+        int: True,
+        float: True,
+        bytes: True,
+        bytearray: True,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: True,
+        datetime.date: True,
+        uuid.UUID: False,
+    },
+    float: {
+        str: True,
+        complex: True,
+        int: True,
+        float: True,
+        bytes: False,
+        bytearray: False,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    bytes: {
+        str: False,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: True,
+        bytearray: True,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    bytearray: {
+        str: False,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: True,
+        bytearray: True,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    list: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: True,
+        bytearray: True,
+        list: True,
+        dict: False,
+        set: True,
+        tuple: True,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    dict: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: False,
+        bytearray: False,
+        list: True,
+        dict: True,
+        set: True,
+        tuple: True,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    set: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: True,
+        bytearray: True,
+        list: True,
+        dict: False,
+        set: True,
+        tuple: True,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    tuple: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: True,
+        bytearray: True,
+        list: True,
+        dict: False,
+        set: True,
+        tuple: True,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    bool: {
+        str: True,
+        complex: True,
+        int: True,
+        float: True,
+        bytes: True,
+        bytearray: True,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+    datetime.datetime: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: False,
+        bytearray: False,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: True,
+        datetime.date: True,
+        uuid.UUID: False,
+    },
+    datetime.date: {
+        str: True,
+        complex: False,
+        int: False,
+        float: False,
+        bytes: False,
+        bytearray: False,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: True,
+        datetime.datetime: True,
+        datetime.date: True,
+        uuid.UUID: False,
+    },
+    uuid.UUID: {
+        str: True,
+        complex: False,
+        int: True,
+        float: False,
+        bytes: False,
+        bytearray: False,
+        list: False,
+        dict: False,
+        set: False,
+        tuple: False,
+        bool: False,
+        datetime.datetime: False,
+        datetime.date: False,
+        uuid.UUID: False,
+    },
+}