alpha-python 0.6.0__py3-none-any.whl → 0.6.2__py3-none-any.whl

alpha/__init__.py

@@ -20,7 +20,7 @@ from alpha.infra.connectors.oidc_connector import (
     KeyCloakOIDCConnector,
 )
 from alpha.infra.connectors.sql_alchemy import SqlAlchemyDatabase
-from alpha.infra.models.filter_operators import And, Or
+from alpha.infra.models.filter_operators import And, Or, FilterOperator
 from alpha.infra.models.json_patch import JsonPatch
 from alpha.infra.models.order_by import OrderBy, Order
 from alpha.infra.models.search_filter import SearchFilter, Operator
@@ -116,6 +116,7 @@ __all__ = [
     "SqlAlchemyDatabase",
     "And",
     "Or",
+    "FilterOperator",
     "JsonPatch",
     "OrderBy",
     "Order",

alpha/cli.py

@@ -20,18 +20,18 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
 
     # Create the main parser
     parser = argparse.ArgumentParser(
-        description='Alpha command line interface.',
+        description="Alpha command line interface.",
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
     )
     subparsers = parser.add_subparsers(
-        title='Use one of the sub categories to run commands on',
-        dest='section',
+        title="Use one of the sub categories to run commands on",
+        dest="section",
     )
 
     # Parser dict to store in all parsers to match later on when finding a
     # handler.
-    section_parsers = {}
-    command_parsers = {}
+    section_parsers: dict[str, argparse.ArgumentParser] = {}
+    command_parsers: dict[str, dict[str, argparse.ArgumentParser]] = {}
 
     # Create all sections
     for section in sections:
@@ -43,7 +43,7 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
             formatter_class=argparse.ArgumentDefaultsHelpFormatter,
         )
         section_subparser = section_parsers[section.name].add_subparsers(
-            dest='command'
+            dest="command"
         )
 
         # Create all commands per section
@@ -88,8 +88,8 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
     # Get all arguments and remove the section and command so they can be
     # 'kwarged' into the Handler set_arguments function.
     handler_args = vars(args)
-    del handler_args['section']
-    del handler_args['command']
+    del handler_args["section"]
+    del handler_args["command"]
 
     # Find the right handler
     for section in sections:
@@ -102,7 +102,7 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
                 command.handler.handle_command()
                 return
 
-    print('No handler found, you should never read this')
+    print("No handler found, you should never read this")
     return
 
 
@@ -118,53 +118,57 @@ def _guess_current_package_name() -> str:
     """
 
     cwd = os.getcwd()
-    pyproject_path = os.path.join(cwd, 'pyproject.toml')
+    pyproject_path = os.path.join(cwd, "pyproject.toml")
 
     # look for pyproject.toml file in subfolders
     if not os.path.isfile(pyproject_path):
         for entry in os.scandir(cwd):
             if not entry.is_dir():
                 continue
-            possible_path = os.path.join(entry.path, 'pyproject.toml')
+            possible_path = os.path.join(entry.path, "pyproject.toml")
             if os.path.isfile(possible_path):
                 pyproject_path = possible_path
                 break
 
     if os.path.isfile(pyproject_path):
         try:
-            with open(pyproject_path, 'rb') as f:
+            with open(pyproject_path, "rb") as f:
                 pyproject_data = tomllib.load(f)
                 name = None
                 try:
-                    if 'project' in pyproject_data:
-                        name = pyproject_data['project']['name']
-                    elif 'tool' in pyproject_data and 'poetry' in pyproject_data['tool']:
-                        name = pyproject_data['tool']['poetry']['name']
+                    if "project" in pyproject_data:
+                        name = pyproject_data["project"]["name"]
+                    elif (
+                        "tool" in pyproject_data
+                        and "poetry" in pyproject_data["tool"]
+                    ):
+                        name = pyproject_data["tool"]["poetry"]["name"]
                     if name is not None:
-                        return name.replace('-', '_')
+                        return name.replace("-", "_")
                 except KeyError:
-                    print('Could not find project name in pyproject.toml')
+                    print("Could not find project name in pyproject.toml")
         except Exception:
             pass
     else:
-        print('Could not find pyproject.toml')
+        print("Could not find pyproject.toml")
 
     # Fallback to use the current folder name
-    print('Guessing package name from folder')
+    print("Guessing package name from folder")
     return os.path.basename(cwd)
 
+
 def init() -> None:
     """Init the container and wire it to the main function."""
     container = Container()
     guessed_name = _guess_current_package_name()
     if guessed_name:
-        container.config.api_package_name.from_value(f'{guessed_name}_api')
+        container.config.api_package_name.from_value(f"{guessed_name}_api")
         container.config.service_package_name.from_value(guessed_name)
         container.config.container_import.from_value(
-            f'from {guessed_name}.containers.container import Container'
+            f"from {guessed_name}.containers.container import Container"
         )
         container.config.init_container_from.from_value(guessed_name)
-        container.config.init_container_function.from_value('init_container')
+        container.config.init_container_function.from_value("init_container")
     container.wire(modules=[sys.modules[__name__]])
 
     main()

alpha/encoder.py

@@ -10,9 +10,10 @@ from json import encoder
 from typing import Any
 from uuid import UUID
 
-import numpy as np
-import pandas as pd
-import six
+import numpy as np  # type: ignore[import-untyped]
+import pandas as pd  # type: ignore[import-untyped]
+import six  # type: ignore[import-untyped]
+
 
 from alpha.interfaces.openapi_model import OpenAPIModel
 

alpha/factories/jwt_factory.py

@@ -34,7 +34,10 @@ class JWTFactory:
         Parameters
         ----------
         secret
-            The secret key used to sign the JWT.
+            The secret key used to sign the JWT. A secret value should be a
+            minimum of 32 characters for security reasons. This value should be
+            kept confidential and not exposed in the source code or version
+            control system.
         lifetime_hours
             The lifetime of the JWT in hours, by default None. This parameter
             is ignored if lifetime_seconds is provided. The parameter is
@@ -71,13 +74,13 @@ class JWTFactory:
                 stacklevel=2,
             )
 
-        if lifetime_seconds is None and lifetime_hours is None:
-            lifetime_seconds = (
-                900  # Default to 15 minutes if no lifetime is provided
-            )
-        elif lifetime_seconds is None and lifetime_hours is not None:
+        if lifetime_seconds is None and lifetime_hours is not None:
             lifetime_seconds = 3600 * int(lifetime_hours)
 
+        lifetime_seconds = (
+            900 if lifetime_seconds is None else lifetime_seconds
+        )  # Default to 15 minutes if no lifetime is provided
+
         self.JWT_SECRET: str = secret
         self.JWT_ISSUER = issuer
         self.JWT_ALGORITHM = jwt_algorithm
@@ -113,7 +116,7 @@ class JWTFactory:
             The generated JWT token as a string.
         """
         now = datetime.now(tz=timezone.utc)
-        exp = now + timedelta(seconds=self.JWT_LIFETIME_SECONDS)
+        exp = now + timedelta(seconds=float(self.JWT_LIFETIME_SECONDS))
 
         token_payload: dict[str, Any] = {
             "sub": subject,

alpha/factories/password_factory.py

@@ -11,6 +11,11 @@ from alpha import exceptions
 class PasswordFactory:
     """This class provides methods for hashing and verifying passwords using
     the argon2 library.
+
+    Keep in mind that changing the password hasher in a production environment
+    may lead to issues with existing password hashes, so it is recommended to
+    use the default hasher unless you have specific requirements. Or configure
+    the password hasher before you deploy your application to production.
     """
 
     def __init__(
@@ -22,7 +27,9 @@ class PasswordFactory:
         ----------
         password_hasher
             An optional password hasher instance. If not provided, a default
-            argon2.PasswordHasher with a salt length of 16 will be used.
+            argon2.PasswordHasher with a salt length of 16 will be used. This
+            allows for flexibility in case you want to use a custom password
+            hasher.
         """
         self._password_hasher = password_hasher or argon2.PasswordHasher(
             salt_len=16

alpha/handlers/api_generate_handler.py

@@ -187,6 +187,11 @@ class ApiGenerateHandler(BaseHandler):
         """Copy mustache templates to the templates folder in the working
         directory
         """
+        if self.generator_name is None:
+            raise InvalidArgumentsException(
+                "Generator name is required to copy templates."
+            )
+
         shutil.rmtree(self.project_templates_folder, ignore_errors=True)
         shutil.copytree(
             src=os.path.join(

alpha/handlers/templates/python-flask/__main__.mustache

@@ -6,6 +6,7 @@ import os
 import socket
 
 import connexion
+from connexion import request
 {{#featureCORS}}
 from flask_cors import CORS
 {{/featureCORS}}
@@ -56,9 +57,13 @@ LoggingConfigurator(
 )
 {{/disableLoggingConfigurator}}
 {{#featureCORS}}
-# add CORS support
 cors_origins = container.config.cors.origins()
-logging.info(f'Enabling CORS for origins: {cors_origins}')
+if cors_origins is None:
+    logging.info(
+        "CORS origins not configured, defaulting to allow all origins"
+    )
+    cors_origins = ["*"]
+logging.info(f"Enabling CORS for origins: {cors_origins}")
 CORS(app.app, origins=cors_origins)
 {{/featureCORS}}
 
@@ -68,15 +73,27 @@ app.container = container
 
 @app.app.after_request
 def add_headers(response: Response):
-    response.headers["Cache-Control"] = "no-store"
-    # response.headers["Content-Security-Policy"] = "default-src 'self'"
-    response.headers["Strict-Transport-Security"] = (
-        "max-age=31536000; includeSubDomains"
+    response_headers = container.config.response.headers()
+    is_swagger_ui_request = request.path == "/ui" or request.path.startswith(
+        "/ui/"
     )
-    response.headers["X-Content-Type-Options"] = "nosniff"
-    response.headers["X-Frame-Options"] = "DENY"
-    return response
 
+    if response_headers is None:
+        response_headers = {
+            "Cache-Control": "no-store",
+            "Content-Security-Policy": "default-src 'self'",
+            "Strict-Transport-Security": "max-age=31536000; includeSubDomains",
+            "X-Content-Type-Options": "nosniff",
+            "X-Frame-Options": "DENY",
+        }
+    for header, value in response_headers.items():
+        if (
+            is_swagger_ui_request
+            and header.lower() == "content-security-policy"
+        ):
+            continue
+        response.headers[header] = value
+    return response
 
 logging.info(f'Started {{servicePackage}} API on \'{socket.gethostname()}\'')
 

alpha/handlers/templates/python-flask/controller.mustache

@@ -43,9 +43,7 @@ from {{packageName}} import models as api_models
 
 {{#operations}}
 {{#operation}}
-{{#authMethods}}{{#vendorExtensions.x-alpha-service-name}}@inject{{/vendorExtensions.x-alpha-service-name}}{{/authMethods}}
-{{^authMethods}}{{#vendorExtensions.x-alpha-service-name}}@inject{{/vendorExtensions.x-alpha-service-name}}{{/authMethods}}
-{{#authMethods}}{{^vendorExtensions.x-alpha-service-name}}@inject{{/vendorExtensions.x-alpha-service-name}}{{/authMethods}}
+{{#authMethods}}{{#-first}}@inject{{/-first}}{{/authMethods}}{{^authMethods}}{{#vendorExtensions.x-alpha-service-name}}@inject{{/vendorExtensions.x-alpha-service-name}}{{/authMethods}}
 def {{operationId}}(
     {{#allParams}}{{^isBodyParam}}{{paramName}}{{^required}}=None{{/required}},{{/isBodyParam}}{{/allParams}}
     {{#authMethods}}{{#isBasicBearer}}token_factory=Provide[Container.token_factory],{{/isBasicBearer}}{{/authMethods}}
@@ -214,6 +212,8 @@ def {{operationId}}(
     {{/allParams}}
     {{/vendorExtensions.x-alpha-factory}}
 
+    response_object_function = {{^vendorExtensions.x-alpha-custom-response-builder}}create_response_object{{/vendorExtensions.x-alpha-custom-response-builder}}{{#vendorExtensions.x-alpha-custom-response-builder}}{{vendorExtensions.x-alpha-custom-response-builder}}{{/vendorExtensions.x-alpha-custom-response-builder}}
+    
     try:
         # Objects used for authorization
         roles=[{{#vendorExtensions.x-alpha-verify-roles}}"{{.}}",{{/vendorExtensions.x-alpha-verify-roles}}]
@@ -254,7 +254,7 @@ def {{operationId}}(
             {{/vendorExtensions.x-alpha-service-name}}
             {{^vendorExtensions.x-alpha-service-name}}
                 {{#vendorExtensions.x-alpha-custom-function}}
-        result = {{vendorExtensions.x-alpha-custom-function}}
+        result = {{{vendorExtensions.x-alpha-custom-function}}}
                 {{/vendorExtensions.x-alpha-custom-function}}
             {{/vendorExtensions.x-alpha-service-name}}
         {{/vendorExtensions.x-alpha-request-factory}}
@@ -270,7 +270,7 @@ def {{operationId}}(
                     {{/vendorExtensions.x-alpha-custom-function}}
                 {{/vendorExtensions.x-alpha-service-method}}
                 {{#vendorExtensions.x-alpha-custom-function}}
-        result = {{vendorExtensions.x-alpha-custom-function}}
+        result = {{{vendorExtensions.x-alpha-custom-function}}}
                 {{/vendorExtensions.x-alpha-custom-function}}
             {{/vendorExtensions.x-alpha-service-name}}
             {{#vendorExtensions.x-alpha-service-name}}
@@ -302,7 +302,7 @@ def {{operationId}}(
             cls={{vendorExtensions.x-alpha-response-factory}}
         )
         {{/vendorExtensions.x-alpha-response-factory}}
-        response_object, status_code = create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code={{code}},
             status_message='{{message}}',
@@ -310,10 +310,9 @@ def {{operationId}}(
             {{#vendorExtensions.x-content-type}}data_type='{{vendorExtensions.x-content-type}}'{{/vendorExtensions.x-content-type}}
             {{#vendorExtensions.x-alpha-cookie-support}}response_type='flask'{{/vendorExtensions.x-alpha-cookie-support}}
         )
-        return response_object, status_code
         {{/returnType}}
         {{^returnType}}
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=204,
             status_message='{{message}}',
@@ -326,7 +325,7 @@ def {{operationId}}(
     {{#is4xx}}
         {{#vendorExtensions.x-alpha-exception}}
     except {{vendorExtensions.x-alpha-exception}} as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code={{code}},
             status_message=f'{exc}'
@@ -336,7 +335,7 @@ def {{operationId}}(
     {{#is5xx}}
         {{#vendorExtensions.x-alpha-exception}}
     except {{vendorExtensions.x-alpha-exception}} as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code={{code}},
             status_message=f'{exc}'
@@ -345,92 +344,92 @@ def {{operationId}}(
     {{/is5xx}}
     {{/responses}}
     except BadRequestException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=400,
             status_message=f'{exc}'
         )
     except UnauthorizedException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=401,
             status_message=f'{exc}'
         )
     except ForbiddenException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=403,
             status_message=f'{exc}'
         )
     except NotFoundException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=404,
             status_message=f'{exc}'
         )
     except MethodNotAllowedException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=405,
             status_message=f'{exc}'
         )
     except NotAcceptableException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=406,
             status_message=f'{exc}'
         )
     except ConflictException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=409,
             status_message=f'{exc}'
         )
     except PayloadTooLargeException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=413,
             status_message=f'{exc}'
         )
     except UnprocessableContentException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=422,
             status_message=f'{exc}'
         )
     except NotImplementedException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=501,
             status_message=f'{exc}'
         )
     except BadGatewayException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=502,
             status_message=f'{exc}'
         )
     except ServiceUnavailableException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=503,
             status_message=f'{exc}'
         )
     except GatewayTimeoutException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=504,
             status_message=f'{exc}'
         )
     except ServerErrorException as exc:
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=500,
             status_message=f'{exc}'
         )
     except Exception as exc:
         traceback.print_exc()
-        return create_response_object(
+        return response_object_function(
             http_codes=http_codes,
             status_code=500,
             status_message=f'{exc}'

alpha/infra/__init__.py

@@ -3,7 +3,7 @@ from alpha.infra.connectors.oidc_connector import (
     KeyCloakOIDCConnector,
 )
 from alpha.infra.connectors.sql_alchemy import SqlAlchemyDatabase
-from alpha.infra.models.filter_operators import And, Or
+from alpha.infra.models.filter_operators import And, Or, FilterOperator
 from alpha.infra.models.json_patch import JsonPatch
 from alpha.infra.models.order_by import OrderBy, Order
 from alpha.infra.models.search_filter import SearchFilter, Operator
@@ -22,6 +22,7 @@ __all__ = [
     "SqlAlchemyDatabase",
     "And",
     "Or",
+    "FilterOperator",
     "JsonPatch",
     "OrderBy",
     "Order",

alpha/infra/models/filter_operators.py

@@ -4,7 +4,7 @@
 - Or
 """
 
-from typing import Any, Callable, Iterable
+from typing import Any, Callable, Iterable, Self
 
 from sqlalchemy.orm import Query
 from sqlalchemy.sql.expression import ColumnElement, and_, or_
@@ -17,13 +17,11 @@ class FilterOperator:
     search query
     """
 
-    def __init__(self, *search_filters: SearchFilter):
+    def __init__(self, *search_filters: SearchFilter | Self) -> None:
         """Instantiate the filter operator by storing the search filter
         objects
         """
-        self.search_filters: Iterable[SearchFilter | FilterOperator] = (
-            search_filters
-        )
+        self.search_filters: Iterable[SearchFilter | Self] = search_filters
 
     @property
     def filter_operator(

alpha/infra/models/json_patch.py

@@ -1,7 +1,7 @@
 import datetime
 from contextlib import suppress
 
-import jsonpatch
+import jsonpatch  # type: ignore[import-untyped]
 
 
 class JsonPatch(jsonpatch.JsonPatch):

alpha/infra/models/order_by.py

@@ -60,15 +60,17 @@ class OrderBy(QueryClause):
         determines the appropriate subclass based on the order attribute.
         """
         super().__post_init__()
-        self.__class__ = self._get_filter_class()
+        self.__class__ = self._get_filter_class()  # type: ignore
 
-    def _get_filter_class(self) -> object:
+    def _get_filter_class(self) -> type["OrderBy"]:
         """Determine the appropriate subclass based on the order attribute."""
         match self.order:
             case Order.ASC:
                 return AscendingOrder
             case Order.DESC:
                 return DescendingOrder
+            case _:
+                return OrderBy
 
 
 class AscendingOrder(OrderBy):

alpha/infra/models/query_clause.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, NoReturn
 
 from sqlalchemy.orm.attributes import InstrumentedAttribute
 from sqlalchemy.orm.query import Query
@@ -58,7 +58,7 @@ class QueryClause:
                 self.field,  # type: ignore
             )
 
-    def _raise_instrumented_attr_exception(self):
+    def _raise_instrumented_attr_exception(self) -> NoReturn:
         """Raise an exception indicating that the instrumented attribute is
         missing."""
         raise exceptions.InstrumentedAttributeMissing(

alpha/interfaces/sql_database.py

@@ -32,5 +32,3 @@ class SqlDatabase(Protocol):
     def drop_tables(
         self, metadata: sa.MetaData, tables: list[sa.Table] | None = None
     ) -> None: ...
-
-    def _create_schema(self, engine: Engine, schema_name: str) -> None: ...

alpha/interfaces/token_factory.py

@@ -1,5 +1,5 @@
 from datetime import datetime
-from typing import Protocol, runtime_checkable
+from typing import Any, Protocol, runtime_checkable
 
 
 @runtime_checkable
@@ -33,7 +33,9 @@ class TokenFactory(Protocol):
         """
         ...
 
-    def validate(self, token: str) -> bool:
+    def validate(
+        self, token: str, options: dict[str, Any] | None = None
+    ) -> bool:
         """Validate an authentication token.
 
         Parameters
@@ -49,7 +51,7 @@ class TokenFactory(Protocol):
         ...
 
     def get_payload(
-        self, token: str, options: dict[str, bool] | None
+        self, token: str, options: dict[str, bool] | None = None
     ) -> dict[str, str]:
         """Retrieve the payload from an authentication token.
 

alpha/providers/models/identity.py

@@ -267,7 +267,7 @@ class Identity:
         """
         subject = str(user.id) if user.id else user.username
         return cls(
-            subject=subject,
+            subject=subject,  # type: ignore
             username=user.username,
             email=user.email,
             display_name=user.display_name,
@@ -275,7 +275,7 @@ class Identity:
             permissions=user.permissions or [],
             claims={},
             issued_at=datetime.now(tz=timezone.utc),
-            role=user.role,
+            role=user.role,  # type: ignore
             admin=user.admin,
         )
 
@@ -320,7 +320,7 @@ class Identity:
             )
         for group in user.groups or []:
             self.groups = self._append_on_sequence(self.groups, group)
-        self.role = user.role
+        self.role = user.role  # type: ignore
         self.admin = user.admin
 
     def update_from_groups(self, groups: list[Group]) -> None:
@@ -457,8 +457,8 @@ class Identity:
         return groups
 
     def _append_on_sequence(
-        self, sequence: Sequence[str], item: str
-    ) -> Sequence[str]:
+        self, sequence: Sequence[Any], item: Any
+    ) -> Sequence[Any]:
         """Helper method to append an item to a sequence if it's not already
         present.
 

alpha/providers/oidc_provider.py

@@ -1,7 +1,5 @@
 """OIDC identity providers."""
 
-from __future__ import annotations
-
 from datetime import datetime, timezone
 from typing import Any, Mapping, Sequence, cast
 

alpha/services/authentication_service.py

@@ -379,12 +379,12 @@ class AuthenticationService:
             "Logout successful",
         )
 
-    def verify(self, token: str) -> Identity:
-        """Verify a token and return the associated identity.
+    def verify(self, auth_token: str) -> Identity:
+        """Verify an auth_token and return the associated identity.
 
         Parameters
         ----------
-        token
+        auth_token
             Authentication token.
 
         Returns
@@ -392,7 +392,7 @@ class AuthenticationService:
         Identity
             Verified Identity instance.
         """
-        return self._identity_provider.validate(Token(value=token))
+        return self._identity_provider.validate(Token(value=auth_token))
 
     def refresh_token(
         self, refresh_token: str, auth_token: str | None = None
@@ -443,6 +443,12 @@ class AuthenticationService:
             identity = self._identity_provider.get_user(
                 subject=stored_refresh_token.subject
             )
+            # If configured to merge with database users and groups, perform
+            # the merge operations on the identity.
+            if self._merge_with_database_users:
+                identity = self._merge_identity_with_user(identity)
+            if self._merge_with_database_groups:
+                identity = self._merge_identity_with_groups(identity)
 
         # If an auth token is provided and the identity could not be retrieved
         # using the refresh token, attempt to retrieve the identity from the

alpha/utils/logging_configurator.py

@@ -4,7 +4,7 @@ import logging
 from logging.config import dictConfig
 from typing import Any
 
-from gunicorn import glogging
+from gunicorn import glogging  # type: ignore[import-untyped]
 
 from alpha.factories.logging_handler_factory import LoggingHandlerFactory
 

alpha/utils/openapi_test/response.py

@@ -0,0 +1,12 @@
+from typing import Any
+
+
+def custom_response_builder(
+    status_code: int,
+    **kwargs: Any,
+) -> tuple[dict[str, Any], int]:
+    """Custom response builder for testing purposes."""
+    return {
+        "status_code": status_code,
+        **kwargs,
+    }, status_code

alpha/utils/openapi_test/service.py

@@ -96,12 +96,6 @@ class TestService:
     def is_list(self, obj: Any) -> bool:
         return isinstance(obj, list)
 
-    # def return_object(self, obj: Any) -> Any:
-    #     return obj
-
-    # def count_unique_items(self, obj: Any) -> int:
-    #     return len(set(obj))
-
     def check_dataclass(self, pet: Pet) -> Pet:
         if isinstance(pet, Pet):
             return pet

alpha/utils/response_object.py

@@ -57,6 +57,10 @@ def create_response_object(
 ) -> tuple[Response, int] | tuple[dict[str, Any], int]:
     """Create a HTTP response object.
 
+    The response object can be either a dictionary or a Flask Response object,
+    depending on the value of `response_type`. The response will include the
+    status code, a human-readable message, and optionally additional data.
+
     Parameters
     ----------
     status_code
@@ -79,7 +83,12 @@ def create_response_object(
 
     Returns
     -------
-        A tuple containing the response object and the HTTP status code.
+    tuple[dict[str, Any], int]
+        A tuple containing the response object as a dictionary and the HTTP
+        status code. When response_type is "dict".
+    tuple[Response, int]
+        A tuple containing the flask.Response object and the HTTP status code.
+        When response_type is "flask".
     """
     if response_type is None:
         response_type = "dict"

alpha/utils/verify_identity.py

@@ -35,22 +35,22 @@ def verify_identity(
     if isinstance(identity, Identity):
         identity = identity.to_dict()
 
-    identity_subject = identity.get("subject")
-    identity_role = identity.get("role")
-    identity_permissions = identity.get("permissions")
-    identity_groups = identity.get("groups")
+    identity_subject: str | None = identity.get("subject")
+    identity_role: str | None = identity.get("role")
+    identity_permissions: list[str] = identity.get("permissions", [])
+    identity_groups: list[str] = identity.get("groups", [])
 
     # Verify if identity role is present in required roles
     if roles and identity_role not in roles:
         raise InsufficientPermissionsException(
-            f"Role \'{identity_role}\' of \'{identity_subject}\' is not "
+            f"Role '{identity_role}' of '{identity_subject}' is not "
             f"sufficient. Required roles: {roles}"
         )
 
     # Verify if identity groups intersect with required groups
     if groups and not set(identity_groups).intersection(set(groups)):
         raise InsufficientPermissionsException(
-            f"Groups \'{identity_groups}\' of \'{identity_subject}\' do not "
+            f"Groups '{identity_groups}' of '{identity_subject}' do not "
             f"intersect with required groups: {groups}"
         )
 
@@ -59,6 +59,6 @@ def verify_identity(
         set(identity_permissions)
     ):
         raise InsufficientPermissionsException(
-            f"Permissions \'{identity_permissions}\' of \'{identity_subject}\'"
+            f"Permissions '{identity_permissions}' of '{identity_subject}'"
             f" do not include required permissions: {permissions}"
         )

alpha_python-0.6.2.dist-info/METADATA

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: alpha-python
+Version: 0.6.2
+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>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/breijling/alpha
+Project-URL: Issues, https://github.com/breijling/alpha/issues
+Project-URL: Documentation, https://alpha-python.readthedocs.io/en/latest/
+Project-URL: Changelog, https://alpha-python.readthedocs.io/en/latest/changelog/
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=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>=1.13
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: six>=1.17.0
+Requires-Dist: sqlalchemy>=2.0.44
+Requires-Dist: requests>=2.28.1
+Requires-Dist: dependency-injector[yaml]!=4.48.3,<5.0.0,>=4.42.0
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: httpx
+Requires-Dist: cryptography
+Provides-Extra: api-generator
+Requires-Dist: openapi-generator-cli==7.14.0; extra == "api-generator"
+Requires-Dist: jdk4py; extra == "api-generator"
+Provides-Extra: flask
+Requires-Dist: connexion[swagger-ui]<3,>=2.14.2; extra == "flask"
+Requires-Dist: swagger-ui-bundle>=0.0.2; extra == "flask"
+Requires-Dist: python_dateutil>=2.6.0; extra == "flask"
+Requires-Dist: itsdangerous==1.1.0; extra == "flask"
+Requires-Dist: MarkupSafe<2.0.2; extra == "flask"
+Requires-Dist: Jinja2==2.11.2; extra == "flask"
+Requires-Dist: Flask<2,>=1.1.2; extra == "flask"
+Requires-Dist: Werkzeug<2.1.0,>=1.0.1; extra == "flask"
+Requires-Dist: flask-cors>=3.0.10; extra == "flask"
+Requires-Dist: Flask-Compress>=1.13; extra == "flask"
+Provides-Extra: mysql
+Requires-Dist: pymysql>=1.1.2; extra == "mysql"
+Provides-Extra: postgresql
+Requires-Dist: psycopg2-binary>=2.9.11; extra == "postgresql"
+Provides-Extra: ldap
+Requires-Dist: ldap3>=2.9.1; extra == "ldap"
+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.
+
+## Badges
+
+[![PyPI version](https://badge.fury.io/py/alpha-python.svg?icon=si%3Apython)](https://badge.fury.io/py/alpha-python)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/alpha-python.svg?label=PyPI%20downloads)](https://pypistats.org/packages/alpha-python)
+[![Build Status](https://github.com/breijling/alpha/actions/workflows/python-app.yml/badge.svg?branch=main)](https://github.com/breijling/alpha/actions/workflows/python-app.yml)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/alpha-python.svg?color=%2334D058)](https://pypi.org/project/alpha-python)
+[![Coverage Status](https://coveralls.io/repos/github/BReijling/alpha/badge.svg?branch=main)](https://coveralls.io/github/BReijling/alpha?branch=main)
+[![uv](https://img.shields.io/badge/package%20manager-uv-5C4EE5)](https://docs.astral.sh/uv/)
+[![mypy](https://img.shields.io/badge/type%20check-mypy-2A6DB2)](https://mypy-lang.org/)
+[![Pytest](https://img.shields.io/badge/testing-pytest-0A9EDC)](https://docs.pytest.org/)
+[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Documentation Status](https://readthedocs.org/projects/alpha-python/badge/?version=latest)](https://alpha-python.readthedocs.io/en/latest/)
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink?logo=github)](https://github.com/sponsors/BReijling)
+
+## TL;DR
+
+Alpha provides a comprehensive set of tools for building Python applications that interact with APIs and databases, including API code generation, authentication and authorization, database access layers, error handling, logging, and more. It is designed to be the first dependency you add to your project, providing a solid foundation for your application's architecture.
+
+## Documentation
+
+Full documentation is available at [alpha-python.readthedocs.io](https://alpha-python.readthedocs.io/).
+
+## Installation
+
+The library is still in development, but you can already install it using pip:
+
+```shell
+pip install alpha-python
+```
+
+If you want to use the alpha cli for generating API code, you can install it using pip as well:
+
+```shell
+pip install alpha-python[api-generator]
+```
+
+If you want to add the library to your API project, you can add it to your pyproject.toml file:
+
+```shell
+# Poetry example
+poetry add alpha-python --extras "flask, postgresql"
+poetry add --dev alpha-python --extras "api-generator"
+
+# UV example
+uv add alpha-python --extra flask --extra postgresql
+uv add --dev alpha-python --extra api-generator
+```
+
+## Features
+
+- API code generation
+- Authentication and authorization
+- Database interaction
+- Logging
+- Error handling
+- And much more!
+
+## Usage
+
+The library contains many components. Below are a few practical examples that map to the guides in the documentation.
+
+### 1) API code generation using OpenAPI spec
+
+```shell
+alpha api gen --spec-file specification/openapi.yaml --service-package my_app
+
+alpha api run --port 8080
+```
+
+### 2) Authenticate with Keycloak (OIDC)
+
+```python
+from alpha import KeyCloakOIDCConnector, KeyCloakProvider, PasswordCredentials
+
+keycloak_connector = KeyCloakOIDCConnector(
+	base_url="https://keycloak.example.com",
+	realm="myrealm",
+	client_id="myclient",
+	client_secret="myclientsecret",
+)
+
+keycloak_provider = KeyCloakProvider(connector=keycloak_connector)
+
+credentials = PasswordCredentials(username="user1", password="user1_password")
+identity = keycloak_provider.authenticate(credentials)
+```
+
+### 3) Query data using SqlAlchemyDatabase + SqlAlchemyRepository
+
+```python
+from alpha import SqlAlchemyDatabase, SqlAlchemyRepository
+from my_app import User
+
+db = SqlAlchemyDatabase(conn_str="postgresql://user:password@localhost:5432/mydatabase")
+
+with db.get_session() as session:
+	users = SqlAlchemyRepository[User](session=session, default_model=User)
+	user = users.get_by_id(1)
+```
+
+### 4) Use Unit of Work for transactional operations
+
+```python
+from alpha import (
+	RepositoryModel,
+	SqlAlchemyDatabase,
+	SqlAlchemyRepository,
+	SqlAlchemyUnitOfWork,
+)
+from my_app import User, OrmMapper
+
+db = SqlAlchemyDatabase(..., mapper=OrmMapper)
+repositories = [
+	RepositoryModel(
+		name="users",
+		repository=SqlAlchemyRepository[User],
+		default_model=User,
+	)
+]
+
+uow = SqlAlchemyUnitOfWork(db=db, repos=repositories)
+
+with uow:
+	user = uow.users.get_by_id(1)
+```
+
+See also:
+
+- Design principles and patterns: https://alpha-python.readthedocs.io/en/latest/concepts/design-principles/
+- Dependency injection concept: https://alpha-python.readthedocs.io/en/latest/concepts/dependency-injection/
+- API code generation guide: https://alpha-python.readthedocs.io/en/latest/guides/api-generation/
+- Authentication guide: https://alpha-python.readthedocs.io/en/latest/guides/authentication/
+- Database interaction guide: https://alpha-python.readthedocs.io/en/latest/guides/database-interaction/
+
+## Contributing
+
+If you want to contribute to the development of this library, you can fork the repository and create a pull request with your changes.
+
+## Support
+
+If Alpha saves you time in production, consider supporting development by buying me a coffee! Your support helps me to continue improving the library and adding new features. Thank you!
+
+<a href="https://www.buymeacoffee.com/breijling"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=breijling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
+
+## License
+
+This library is licensed under the MIT License. See the LICENSE file for more information.

{alpha_python-0.6.0.dist-info → alpha_python-0.6.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-alpha/__init__.py,sha256=tktKTmPjYOf91PvLdmlczAyjguUt9UnSdN8qGBU4npw,6115
-alpha/cli.py,sha256=YdBvz_nqvC1c4kA-Xb1KtS-1Or6rbDu2VcF3ClatP6o,5657
-alpha/encoder.py,sha256=g06nYgwvFK37M8QtjvURBDj-eaNiOobfSGQealwWBdY,2513
+alpha/__init__.py,sha256=FnXcEv9PSCLWDKE4-9GCqI7HSAvzo3WW_mfcBLPBBxo,6153
+alpha/cli.py,sha256=YTWM7lzmydYazXMJ6LULywvJTMHzvfTO6yNuPrUgHCY,5813
+alpha/encoder.py,sha256=sNYZ30uNiJWV0xpeIiTVCDAsM86Nk_914kF7Ye2Woao,2610
 alpha/exceptions.py,sha256=AHoFMPyHvjj6j_1X2TS40dSaFBzCDtgzAmucimSZjfc,5793
 alpha/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 alpha/adapters/__init__.py,sha256=pGpAtLuVs-jOyRShjO1BwSHpB5MyStJ3Hs9wPm49Q2s,201
@@ -21,17 +21,17 @@ alpha/factories/_type_mapping.py,sha256=f8cRfu8KUfw1ggY0Txs6fEX2e6GaXrsNcc2SCeYF
 alpha/factories/class_factories.py,sha256=e0NCQDU1qCOQxoApICjZi3dnLLZ85Py5JOHqzLRbOSQ,17131
 alpha/factories/default_field_factory.py,sha256=J8fM48Yar1KpXX8SR1iB3buGr1hkYeayH5IYWoBqaHk,1770
 alpha/factories/field_iterator.py,sha256=q4B1bUuY1ZCWdS0F5mRGfaYcbKM-WlPUNixRzk6yAS8,6305
-alpha/factories/jwt_factory.py,sha256=7FtX3rtb21xUy2_rhD1KwyGxOBX6eWXXVreVe15hD5E,8238
+alpha/factories/jwt_factory.py,sha256=ZuamKmi12uZve-TQByppeMlH1aiBNWraejd2wpZuB3k,8429
 alpha/factories/logging_handler_factory.py,sha256=ZoVkD2S3Pl7NMMfhcFF8k76BlKTsvis75udLX-JqQ30,3063
 alpha/factories/model_class_factory.py,sha256=VK80vLHGF-XdlW3aln5C9tHSQv81NLxz5ti5jYxdv4w,5862
-alpha/factories/password_factory.py,sha256=rSdM57SMNRCU1QxYTgKHWEcJRH6Lp6toSqOXoS0om_s,4618
+alpha/factories/password_factory.py,sha256=uK8X5bNvlyUtxvJXH7MXmYLiaM4jmsS6sZrx7Ew07kM,5031
 alpha/factories/request_factory.py,sha256=vjkvsBkKKUZ7me5a8cEcFYet03qnUZ6f5Qyktfxospw,7159
 alpha/factories/response_factory.py,sha256=mmHRWa7TRjZMuIPojI69At1Q21bBa-qiH9LLtKngGM8,6497
 alpha/factories/type_factories.py,sha256=3MCSQ1g1neBVPk0cSbhmGED7O4AQNMmBK8OmTLwuaGM,6478
 alpha/factories/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 alpha/factories/models/factory_classes.py,sha256=RpmJdPmC5MUNTD4TK6TaqBzd2ezLGSjsHGltl-_6tqo,1131
 alpha/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-alpha/handlers/api_generate_handler.py,sha256=BEL_NWUTfIfAHpM4rTTyutl_ruecbfrFjTcsRiP2q-w,7320
+alpha/handlers/api_generate_handler.py,sha256=AV8-vnhrkn1omsNQ3RTAFO_wfQ6j5lsgle97AZ-m4RY,7484
 alpha/handlers/api_run_handler.py,sha256=wuYCJCFuFpKeX9Jqu6vi4rVK8Bm6VmI9FNHny_PrKNA,1414
 alpha/handlers/base_handler.py,sha256=iBNFhG0d-Si02uJashxmD7tHj16kaYPGP8i2RPljK30,523
 alpha/handlers/gen-code.sh,sha256=vhWfFzooKxgrSzR9cYXg0UKe4aT9eG8ZiaAasjTPXnY,1066
@@ -46,9 +46,9 @@ alpha/handlers/templates/python-flask/Dockerfile.mustache,sha256=nyginFsU-nKyq0b
 alpha/handlers/templates/python-flask/README.mustache,sha256=X-giJMN_juUrVoW2mj_2Npw6q1s8NGsAgToK2um3NLQ,1368
 alpha/handlers/templates/python-flask/__init__model.mustache,sha256=JRwyJmOCAD8nskG1DnYjt7orBTmza8qPQ2N24JaPcuY,209
 alpha/handlers/templates/python-flask/__init__test.mustache,sha256=wUxDXcyE4rPh3sDp8MvR5m8vqzoU25Fw1bo_xh6InnY,438
-alpha/handlers/templates/python-flask/__main__.mustache,sha256=GetXHmF7BXxrwVajfkI6OjLQV7ekFxD9SPYHjZLNNWY,2393
+alpha/handlers/templates/python-flask/__main__.mustache,sha256=D11Z_bhka_NsK3EP8iSzV8_Hcc15L-uOntH2IbzrKng,2942
 alpha/handlers/templates/python-flask/base_model.mustache,sha256=B--jl9LmfiHACq9n1kDxm6YTi6tb1oSUFnZya_IKOhU,2184
-alpha/handlers/templates/python-flask/controller.mustache,sha256=XQPbgy4VkzzNlRsj4z8uE0RZB2D7BR3au4wGvu_lvCU,17231
+alpha/handlers/templates/python-flask/controller.mustache,sha256=iOIpFCFVj0y_fvKqY8quwTR4Cdsk0TaKZuOCKojUfOE,17341
 alpha/handlers/templates/python-flask/controller_test.mustache,sha256=2i2cwgQonT1RMJQwdxeq8B3x8-hLjpK7YkI--LkKLOI,2848
 alpha/handlers/templates/python-flask/dockerignore.mustache,sha256=hqlHuqIMLuuwvVqK6xhIcfaezKoChriR3D7TvxtkjGo,906
 alpha/handlers/templates/python-flask/encoder.mustache,sha256=03rsvhN_QdqaWsQC2v3772UvrLEXna9WcvxQsl6mwiU,866
@@ -65,7 +65,7 @@ alpha/handlers/templates/python-flask/tox.mustache,sha256=iuEc1JquvGZ0UlCCJus2X_
 alpha/handlers/templates/python-flask/travis.mustache,sha256=M9UNXQnfg8F6uFvOSsay8FQ0YvPDi8EF6HIiu4UW4-o,319
 alpha/handlers/templates/python-flask/typing_utils.mustache,sha256=mGDTJkj9V9w7NsFSljw33GKB-gWfqoceAot-iHTViNs,809
 alpha/handlers/templates/python-flask/util.mustache,sha256=iQVhsAN_ZCQuQGOxoqATTE90fkIEojKyrfooFqa7Jck,3534
-alpha/infra/__init__.py,sha256=M52HIbeT0yvgwtU2yEPpOpF12p2dxXfCBfm_Fj796mU,980
+alpha/infra/__init__.py,sha256=4eIKsW1N06_vVBrO2u1ESU5iURBb0cGvxcscaPsB4PE,1018
 alpha/infra/connectors/__init__.py,sha256=kEh_mOIIqkWeY4cilislM8ZjKXNFp8zBuMThfbJ1CGc,647
 alpha/infra/connectors/ldap_connector.py,sha256=ntBheImY90qtZ8tTYv0Dh64vxNho0k8FwTOAYkVdZsU,4019
 alpha/infra/connectors/oidc_connector.py,sha256=z9AY1lMVK5nULd80zOvJzo8zPbp6CHJ7fv2smp71eIs,15675
@@ -73,10 +73,10 @@ alpha/infra/connectors/sql_alchemy.py,sha256=8DivUj25_OAVaXmaCsbSnHgOD1w5_ewAXSl
 alpha/infra/databases/__init__.py,sha256=IyA_aB9h_7rOM-aa50QLsA_q4e9W4HnJOqh76aDyrj4,106
 alpha/infra/databases/sql_alchemy.py,sha256=7t17M8UEgW1NMX9LYW6A14EM5UxEJZyp-8a_xLEONAs,235
 alpha/infra/models/__init__.py,sha256=SIakw9bAPXwFmx3I7exCRBs3e2Ug3etOJy6JyIOR1Uc,348
-alpha/infra/models/filter_operators.py,sha256=SbI5jlFYOdoNPfIYYKvvhesAENipWj2Zlh31g4e6EKQ,2812
-alpha/infra/models/json_patch.py,sha256=OVThIWzg4n0SixHqoU5UQkLdHvu2t1IgL2gjDBYSvMc,1721
-alpha/infra/models/order_by.py,sha256=HY3eRwHNW2JflavKvHpDiQKJuC5rY9HU5cuXPywR560,4493
-alpha/infra/models/query_clause.py,sha256=R7CWIin99_0XckhyVKK4qwNnOV-QtWwMceMveVxq63w,2533
+alpha/infra/models/filter_operators.py,sha256=LJw2w8v1FvDhQnEZ8hKq3Rq54_MwolGn7SSDT5t5rT4,2797
+alpha/infra/models/json_patch.py,sha256=w8L59E6w-aSeEknww-JLCrB1kEpFbPXcRlweKP4kU1A,1753
+alpha/infra/models/order_by.py,sha256=QN4ALsbJ-zoh1dx5OHZ2L9pijwfjBM5G0pBbpNrNHnM,4569
+alpha/infra/models/query_clause.py,sha256=xLWxm-cWrODMqpqqVIu1veSVBWLENt97TTHq8CinP7M,2555
 alpha/infra/models/search_filter.py,sha256=5Q0lbeAYOnyzudX7HfEwZSzLKC9oJgT62jnHaNrRGmg,21755
 alpha/interfaces/__init__.py,sha256=XGCncGbfzjkGEq8aN7_2m9vZyCfcNVUe8IhMj8krbzk,1441
 alpha/interfaces/api_repository.py,sha256=ysnzKi_cBdbzGBL_GVdEGftp_gbl8wb4odjTUKOAaN4,21836
@@ -88,10 +88,10 @@ alpha/interfaces/openapi_model.py,sha256=9QayfwbwTg_3-reFso_ktwNqGI2f2C4AQOAPvPH
 alpha/interfaces/patchable.py,sha256=9L42VdrvfDhKKlfjQAMDX6FDA0R-U6QkOWlAHUdxneQ,705
 alpha/interfaces/providers.py,sha256=S0uBThEI_qqRpxyQmwNNSPGMcAVIU2ngXIimflDqUbc,4162
 alpha/interfaces/pydantic_instance.py,sha256=S96jLEWRmDyvYV3VqofSqjiN-lcjfkjiNp7Vpumw49A,245
-alpha/interfaces/sql_database.py,sha256=H52NR1ti2j9G9zJsibPtKmXL7WdHOzeSyPXO4Zq9wlA,996
+alpha/interfaces/sql_database.py,sha256=-YiMBSrGkd2NTS4FEBjXenlPnVQW2t3SvQJMDRyHDjA,919
 alpha/interfaces/sql_mapper.py,sha256=OSGIwbtlQ5-cBHUIiJfLgJlkBU3MgMAbSdxj8X2v-eI,624
 alpha/interfaces/sql_repository.py,sha256=nJCdF_G8YS7_VST_OL14wBA_Ne_DyGZhQQDAta1zqYk,9814
-alpha/interfaces/token_factory.py,sha256=d0_Jbj6rA8tI0O2rIp5vZzyZKI47B-sDQNMAW_zCgCs,1817
+alpha/interfaces/token_factory.py,sha256=MeSvnyH699vBG0c7Oli4M6RT1wEsCVTNy7V4XQpu31o,1882
 alpha/interfaces/unit_of_work.py,sha256=P32wTGw4N54QV_x2BBusrApANmI88wgA7bLmC-1AozI,1464
 alpha/interfaces/updatable.py,sha256=vGpxvqrn9dCMumP_Ty3EGs-bp3KiPG8l-v-9rfjOLSQ,472
 alpha/mixins/__init__.py,sha256=aPTNpi4JEzdsFW9Joq0ktgtoP2MJqNLOc1uRPxJkl4A,252
@@ -102,10 +102,10 @@ alpha/providers/__init__.py,sha256=DM0Zu_hYNc9JI7cKVQD7J84lwpv5-GNTntMzM1k_ZPI,9
 alpha/providers/api_key_provider.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 alpha/providers/database_provider.py,sha256=Q0qAdJYgEg1hjVHUenB-Qy-pW69E5p0cZ5IMP_JWE9Q,7974
 alpha/providers/ldap_provider.py,sha256=R3jCammHPS8Krd4G6W1t-nT7RAmPW-JCoirhJwdr2Bo,13542
-alpha/providers/oidc_provider.py,sha256=9qgKLNVFpZNUCUzXuzvBcrQY4ne2PiMQDQk2qBkfhEk,13848
+alpha/providers/oidc_provider.py,sha256=t1ftGcDjZuopuvb0qyPexFdNzhsKhiatxnfLb2HBP8g,13812
 alpha/providers/models/__init__.py,sha256=SI-qTA3JMOxXx4o1h7frk8x3PRj0g_GSCEbLzyvw7CI,409
 alpha/providers/models/credentials.py,sha256=IjGm1MpnUrwnTo1Of5eacNtkh72Iqj2uKTsoyq1po_o,1304
-alpha/providers/models/identity.py,sha256=IWd7m3aO1TsL4JhsbVZ7Q2EAk6oGeMqwU_gclZFLKFY,14930
+alpha/providers/models/identity.py,sha256=6-OezJs7Ld_4HIcnAHKREymDcOUhV5YmR7JJNVYxrrA,14978
 alpha/providers/models/token.py,sha256=CiEKTcv5CpusF7-jlvUPKtBEsCo2vrV_btt-f1fwIz0,3625
 alpha/repositories/__init__.py,sha256=qN7iefBr93_fXo8cTn_RUFaz8PPhsUlzojKbYFM2m-c,306
 alpha/repositories/rest_api_repository.py,sha256=vWfl6oTHJ6kzesCM31zag3je7R6hh8GBnO1mgOOdBNI,45797
@@ -113,7 +113,7 @@ alpha/repositories/sql_alchemy_repository.py,sha256=QMBbtSwv7HkrIgl-qQOQ9gRuiF_u
 alpha/repositories/models/__init__.py,sha256=PY3kFG0z5r5ALcwBFXVNO9GAVNn1tVTkvUp8XoZEMuY,109
 alpha/repositories/models/repository_model.py,sha256=WpfW90HpDvwDK5jcqNcprIKugqxcMaQWoqEFEgr0FoA,1038
 alpha/services/__init__.py,sha256=yeUbS-N0127DSejbCAv9jbdKuHRa_H5Ue0CtsWf4ghI,224
-alpha/services/authentication_service.py,sha256=2hwhnajiOkio_AJ8Ptf1c7r319dcrckGxMRiBIu48s8,38052
+alpha/services/authentication_service.py,sha256=B-KuXdav66dk5ts8TXck8i9DCAvLyBhuTiM6Cdqskq0,38437
 alpha/services/user_lifecycle_management.py,sha256=yj0ITtD_WOCVo54KaNSC29XPixxdKi9ArvCMeQm6WKA,2696
 alpha/services/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 alpha/services/models/cookie.py,sha256=vxNLPtMmOGlxFLKdccxEV7hd_mPKmFCEao8SczNOilo,132
@@ -122,22 +122,23 @@ alpha/utils/_http_codes.py,sha256=8b0oieqi8iCWGBvKT2ShcKxj_7JZ5rpXyzxPft2T2po,68
 alpha/utils/cookie.py,sha256=V0BTBG_AsvJEGoBv5_6n4LYWt36YJfGT2MVkTvWfxTU,1654
 alpha/utils/is_attrs.py,sha256=7EOltIJlhK9uF_nVLLCbaQV5EH8PO-ssqZcTs94y3Ic,426
 alpha/utils/is_pydantic.py,sha256=-P4n3n59_YftVqvIIQ_GovxUxQMFIt8htTDd0j2hFis,629
-alpha/utils/logging_configurator.py,sha256=lji_hDxY_c4RHp30etWB4H8R6YjQJt3n0a9IK1RAPUo,3785
+alpha/utils/logging_configurator.py,sha256=wnwcBjI4wzvz2R0oMgEHffoGo9FfgPhf-1ZIlA9Eydo,3817
 alpha/utils/logging_level_checker.py,sha256=elCxkVW07BnVGPhIHf_TQyHCAPpdNY8xp5bszrziRS0,697
 alpha/utils/request_headers.py,sha256=z_0mDT4NoQimG1zPCyM5-7T64BJ91eQXNILuIc08cYI,4310
-alpha/utils/response_object.py,sha256=OTi0WoXs0zn9sDxtzn1LjL02jr65hDvchhGtUVgyAyI,4912
+alpha/utils/response_object.py,sha256=AymBt3qrirpLRkS0DcVkoxVLKZ3R0Eb6A5cN4cgFs9E,5372
 alpha/utils/secret_generator.py,sha256=LjsKb8oDfsfmCCcTKrqtw_duqJ7u3V_o6zGGuG26_XE,393
-alpha/utils/verify_identity.py,sha256=tnh9JAez8FlrqN4Bqh1bfTdnEOM2VA1ZAVLfZCqI-ZU,2229
+alpha/utils/verify_identity.py,sha256=Y1pdcVl8Z_I4ibw2KY7i5QwTQrY29WwpBOJ6j0YOAow,2271
 alpha/utils/version_checker.py,sha256=W8v69hDbrr0VvJ40gpFmXMtVawrDmUz_YGWssKUTmVE,380
 alpha/utils/openapi_test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 alpha/utils/openapi_test/container.py,sha256=70XIe_ue6TjVkAVEf8mEG3_7tkSsJKp8-sP_KYgIQG8,6404
 alpha/utils/openapi_test/exceptions.py,sha256=FfVodhZrajSGQEZngKZRmlJCxjQP502OqQgu3qdtuN4,298
 alpha/utils/openapi_test/models.py,sha256=vAHbjmwc0rVsCj9m8iKqkwPpSkSmkTOT8UQvffkrHig,2364
 alpha/utils/openapi_test/orm.py,sha256=Py95GV_0e7wI1MYDZR1_EHkvTgev6eNo70SVmnD7kGc,3045
-alpha/utils/openapi_test/service.py,sha256=MhlmUmJ-m-0dGacBjUQvURufESkDPOlSKkMuwObQCYA,5158
-alpha_python-0.6.0.dist-info/licenses/LICENSE,sha256=5KwEqC3KUoH4lVXgZ9tGriKOl-LGxHkXBWo16mFmAYM,1070
-alpha_python-0.6.0.dist-info/METADATA,sha256=10l6fkaMRY_HP0LY_uximYw0KQIJDn1r7PLtimEPmTQ,4678
-alpha_python-0.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-alpha_python-0.6.0.dist-info/entry_points.txt,sha256=LBEXdcofOugYYdZ46nz5Dxj_aj1QbRBkumfPGhy-GXI,41
-alpha_python-0.6.0.dist-info/top_level.txt,sha256=tqmNnOmi2RSSiPo99C03fD5Cc3r9za9xTjPAoQC1EGA,6
-alpha_python-0.6.0.dist-info/RECORD,,
+alpha/utils/openapi_test/response.py,sha256=IxbQ6Nw258LLViHkgfjOpc7zWGTP8ofVOX1zrwDoR50,270
+alpha/utils/openapi_test/service.py,sha256=ycrEUlQmygKthnOhEiir-wtbPFi5cT-bepVclaL9FAk,5003
+alpha_python-0.6.2.dist-info/licenses/LICENSE,sha256=5KwEqC3KUoH4lVXgZ9tGriKOl-LGxHkXBWo16mFmAYM,1070
+alpha_python-0.6.2.dist-info/METADATA,sha256=K6meojtl5hwwRM-AA3uvAfsg3oKZL42l3lK4S53jlTE,8645
+alpha_python-0.6.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+alpha_python-0.6.2.dist-info/entry_points.txt,sha256=LBEXdcofOugYYdZ46nz5Dxj_aj1QbRBkumfPGhy-GXI,41
+alpha_python-0.6.2.dist-info/top_level.txt,sha256=tqmNnOmi2RSSiPo99C03fD5Cc3r9za9xTjPAoQC1EGA,6
+alpha_python-0.6.2.dist-info/RECORD,,

alpha_python-0.6.0.dist-info/METADATA

@@ -1,117 +0,0 @@
-Metadata-Version: 2.4
-Name: alpha-python
-Version: 0.6.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>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/breijling/alpha
-Project-URL: Issues, https://github.com/breijling/alpha/issues
-Project-URL: Documentation, https://alpha-python.readthedocs.io/en/latest/
-Project-URL: Changelog, https://alpha-python.readthedocs.io/en/latest/changelog/
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Python: <3.15,>=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>=1.13
-Requires-Dist: pydantic>=2.12.5
-Requires-Dist: pyjwt>=2.10.1
-Requires-Dist: six>=1.17.0
-Requires-Dist: sqlalchemy>=2.0.44
-Requires-Dist: requests>=2.28.1
-Requires-Dist: dependency-injector[yaml]!=4.48.3,<5.0.0,>=4.42.0
-Requires-Dist: argon2-cffi>=25.1.0
-Requires-Dist: httpx
-Requires-Dist: cryptography
-Provides-Extra: api-generator
-Requires-Dist: openapi-generator-cli==7.14.0; extra == "api-generator"
-Requires-Dist: jdk4py; extra == "api-generator"
-Provides-Extra: flask
-Requires-Dist: connexion[swagger-ui]<3,>=2.14.2; extra == "flask"
-Requires-Dist: swagger-ui-bundle>=0.0.2; extra == "flask"
-Requires-Dist: python_dateutil>=2.6.0; extra == "flask"
-Requires-Dist: itsdangerous==1.1.0; extra == "flask"
-Requires-Dist: MarkupSafe<2.0.2; extra == "flask"
-Requires-Dist: Jinja2==2.11.2; extra == "flask"
-Requires-Dist: Flask<2,>=1.1.2; extra == "flask"
-Requires-Dist: Werkzeug<2.1.0,>=1.0.1; extra == "flask"
-Requires-Dist: flask-cors>=3.0.10; extra == "flask"
-Requires-Dist: Flask-Compress>=1.13; extra == "flask"
-Provides-Extra: mysql
-Requires-Dist: pymysql>=1.1.2; extra == "mysql"
-Provides-Extra: postgresql
-Requires-Dist: psycopg2-binary>=2.9.11; extra == "postgresql"
-Provides-Extra: ldap
-Requires-Dist: ldap3>=2.9.1; extra == "ldap"
-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.
-
-## Badges
-
-[![PyPI version](https://badge.fury.io/py/alpha-python.svg)](https://badge.fury.io/py/alpha-python)
-[![Build Status](https://travis-ci.com/breijling/alpha.svg?branch=main)](https://travis-ci.com/breijling/alpha)
-[![Coverage Status](https://coveralls.io/repos/github/breijling/alpha/badge.svg?branch=main)](https://coveralls.io/github/breijling/alpha?branch=main)
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
-
-## Documentation
-
-[![Documentation Status](https://readthedocs.org/projects/alpha-python/badge/?version=latest)](https://alpha-python.readthedocs.io/en/latest/)
-
-Full documentation is available at [alpha-python.readthedocs.io](https://alpha-python.readthedocs.io/).
-
-## Installation
-
-The library is still in development, but you can already install it using pip:
-
-```shell
-pip install alpha-python
-```
-
-If you want to use the alpha cli for generating API code, you can install it using pip as well:
-
-```shell
-pip install alpha-python[api-generator]
-```
-
-If you want to add the library to your API project, you can add it to your pyproject.toml file:
-
-```shell
-# Poetry example
-poetry add alpha-python --extras "flask, postgresql"
-poetry add --dev alpha-python --extras "api-generator"
-
-# UV example
-uv add alpha-python --extra flask --extra postgresql
-uv add --dev alpha-python --extra api-generator
-```
-
-## Usage
-
-The library contains a lot of different components, but the most important ones are:
-
-- `alpha.encoder.JSONEncoder`: A JSON encoder that can be used to serialize complex objects to JSON.
-
-## Features
-
-
-
-## Contributing
-
-If you want to contribute to the development of this library, you can fork the repository and create a pull request with your changes.
-
-## License
-
-This library is licensed under the MIT License. See the LICENSE file for more information.