alpha-python 0.5.1__tar.gz → 0.6.1__tar.gz

alpha_python-0.6.1/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: alpha-python
+Version: 0.6.1
+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.1/README.md

@@ -0,0 +1,153 @@
+# 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.5.1 → alpha_python-0.6.1}/pyproject.toml

@@ -1,18 +1,30 @@
 [project]
 name = "alpha-python"
-version = "0.5.1"
+version = "0.6.1"
 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"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+license = "MIT"
+license-files = ['LICENSE']
+requires-python = ">=3.11, <3.15"
 dependencies = [
     "attrs>=25.4.0",
     "gunicorn>=23.0.0",
     "jsonpatch>=1.33",
     "numpy>=2.3.5",
-    "pandas>=2.3.3",
+    "pandas>=1.13",
     "pydantic>=2.12.5",
     "pyjwt>=2.10.1",
     "six>=1.17.0",
@@ -20,8 +32,16 @@ dependencies = [
     "requests>=2.28.1",
     "dependency-injector[yaml]>=4.42.0,<5.0.0,!=4.48.3",
     "argon2-cffi>=25.1.0",
+    "httpx",
+    "cryptography",
 ]
 
+[project.urls]
+Homepage = "https://github.com/breijling/alpha"
+Issues = "https://github.com/breijling/alpha/issues"
+Documentation = "https://alpha-python.readthedocs.io/en/latest/"
+Changelog = "https://alpha-python.readthedocs.io/en/latest/changelog/"
+
 [project.scripts]
 alpha = "alpha.cli:init"
 
@@ -60,11 +80,21 @@ dev = [
     "ipykernel>=7.2.0",
     "flask<2",
     "httpx>=0.28.1",
+    "tox>=4.0.0",
+    "types-ldap3",
+    "types-requests",
+    "pandas-stubs",
 ]
+# docs = [
+#     "mkdocs-material>=9.5",
+#     "mkdocstrings[python]>=0.29",
+#     "mkdocs-autorefs>=1.0",
+#     "mkdocs-mermaid2-plugin>=1.2.0"
+# ]
 
 [project.optional-dependencies]
 api-generator = [
-    "openapi-generator-cli==7.14.0 ; python_version >= '3.11' and python_version < '4.0'",
+    "openapi-generator-cli==7.14.0",
     "jdk4py"
 ]
 flask = [
@@ -97,18 +127,46 @@ testpaths = [
     "tests"
 ]
 
+[tool.tox]
+legacy_tox_ini = """
+[tox]
+min_version = 4.0
+env_list = py311,py312,py313,py314
+isolated_build = true
+
+[testenv]
+description = Run full test suite on {basepython}
+package = editable
+extras = flask,postgresql,mysql,ldap,api-generator
+deps =
+    pytest>=9.0.1
+    pytest-cov>=7.0.0
+    uv
+commands =
+    pytest {posargs}
+pass_env =
+    GITHUB_ACTIONS
+    TEST_PSQL_HOST
+    TEST_PSQL_PORT
+    TEST_PSQL_USERNAME
+    TEST_PSQL_PASSWORD
+    TEST_PSQL_DATABASE
+"""
+
+
 [tool.coverage.run]
 source = ["src"]
 omit = [
     "tests/*",
     "__init__.py",
-    "_http_codes.py"
+    "_http_codes.py",
+    "src/alpha/utils/openapi_test/*"
 ]
 
 [tool.black]
 line-length = 79
 skip-string-normalization = true
-target-version = ['py310', 'py311', 'py312', 'py313']
+target-version = ['py311', 'py312', 'py313', 'py314']
 
 [tool.isort]
 py_version = 311
@@ -118,10 +176,13 @@ force_grid_wrap = 0
 
 [tool.mypy]
 python_version = "3.11"
-exclude = ['^tests/']
+exclude = ["^tests/", "src/alpha/utils/openapi_test"]
 
 [[tool.mypy.overrides]]
-module = ["flask", "flask.*"]
+module = [
+    "flask", 
+    "flask.*", 
+]
 ignore_missing_imports = true
 
 [tool.ruff]

{alpha_python-0.5.1 → alpha_python-0.6.1}/src/alpha/__init__.py

@@ -1,16 +1,25 @@
+from importlib.metadata import version
+
 from alpha.adapters.rest_api_unit_of_work import RestApiUnitOfWork
 from alpha.adapters.sqla_unit_of_work import SqlAlchemyUnitOfWork
 from alpha.factories.jwt_factory import JWTFactory
 from alpha.factories.logging_handler_factory import LoggingHandlerFactory
 from alpha.factories.model_class_factory import ModelClassFactory
 from alpha.domain.models.user import User
-from alpha.domain.models.base_model import BaseDomainModel, DomainModel
+from alpha.domain.models.group import Group
+from alpha.domain.models.role import Role
+from alpha.domain.models.base_model import (
+    BaseDomainModel,
+    DomainModel,
+    DomainModelCovariant,
+    DomainModelContravariant,
+)
 from alpha.domain.models.life_cycle_base import LifeCycleBase
 from alpha.infra.connectors.oidc_connector import (
     OIDCConnector,
     KeyCloakOIDCConnector,
 )
-from alpha.infra.databases.sql_alchemy import SqlAlchemyDatabase
+from alpha.infra.connectors.sql_alchemy import SqlAlchemyDatabase
 from alpha.infra.models.filter_operators import And, Or
 from alpha.infra.models.json_patch import JsonPatch
 from alpha.infra.models.order_by import OrderBy, Order
@@ -19,7 +28,7 @@ from alpha.interfaces.attrs_instance import AttrsInstance
 from alpha.interfaces.dataclass_instance import DataclassInstance
 from alpha.interfaces.pydantic_instance import PydanticInstance
 from alpha.interfaces.openapi_model import OpenAPIModel
-from alpha.interfaces.updateable import Updateable
+from alpha.interfaces.updatable import Updatable
 from alpha.interfaces.patchable import Patchable
 from alpha.interfaces.api_repository import ApiRepository
 from alpha.interfaces.sql_repository import SqlRepository
@@ -36,6 +45,8 @@ from alpha.interfaces.providers import (
 )
 from alpha.interfaces.token_factory import TokenFactory
 from alpha.mixins.jwt_provider import JWTProviderMixin
+from alpha.mixins.user_lifecycle import UserLifecycleMixin
+from alpha.mixins.group_lifecycle import GroupLifecycleMixin
 from alpha.providers.models.identity import (
     Identity,
     DEFAULT_LDAP_MAPPINGS,
@@ -44,7 +55,12 @@ from alpha.providers.models.identity import (
 )
 from alpha.providers.models.credentials import PasswordCredentials
 from alpha.providers.models.token import Token
-from alpha.providers.oidc_provider import OIDCProvider, KeyCloakProvider
+from alpha.providers.oidc_provider import (
+    OIDCProvider,
+    KeyCloakProvider,
+    DEFAULT_OIDC_MAPPINGS,
+    DEFAULT_KEYCLOAK_MAPPINGS,
+)
 from alpha.repositories.models.repository_model import RepositoryModel
 from alpha.repositories.rest_api_repository import RestApiRepository
 from alpha.repositories.sql_alchemy_repository import SqlAlchemyRepository
@@ -63,6 +79,7 @@ from alpha.utils.verify_identity import verify_identity
 from alpha.utils.version_checker import minor_version_gte
 from alpha.encoder import JSONEncoder
 
+
 # Optional LDAP support - only import if ldap3 is available
 try:
     from alpha.infra.connectors.ldap_connector import (
@@ -77,6 +94,9 @@ try:
 except ImportError:
     _LDAP_AVAILABLE = False  # type: ignore
 
+
+__version__ = version("alpha-python")
+
 __all__ = [
     "RestApiUnitOfWork",
     "SqlAlchemyUnitOfWork",
@@ -85,8 +105,12 @@ __all__ = [
     "ModelClassFactory",
     "BaseDomainModel",
     "DomainModel",
+    "DomainModelCovariant",
+    "DomainModelContravariant",
     "LifeCycleBase",
     "User",
+    "Group",
+    "Role",
     "OIDCConnector",
     "KeyCloakOIDCConnector",
     "SqlAlchemyDatabase",
@@ -101,7 +125,7 @@ __all__ = [
     "DataclassInstance",
     "PydanticInstance",
     "OpenAPIModel",
-    "Updateable",
+    "Updatable",
     "Patchable",
     "ApiRepository",
     "SqlRepository",
@@ -116,6 +140,8 @@ __all__ = [
     "TokenIssuer",
     "TokenFactory",
     "JWTProviderMixin",
+    "UserLifecycleMixin",
+    "GroupLifecycleMixin",
     "Identity",
     "DEFAULT_LDAP_MAPPINGS",
     "DEFAULT_AD_MAPPINGS",
@@ -124,6 +150,8 @@ __all__ = [
     "Token",
     "OIDCProvider",
     "KeyCloakProvider",
+    "DEFAULT_OIDC_MAPPINGS",
+    "DEFAULT_KEYCLOAK_MAPPINGS",
     "RepositoryModel",
     "RestApiRepository",
     "SqlAlchemyRepository",
@@ -151,3 +179,27 @@ if _LDAP_AVAILABLE:
             "ADProvider",
         ]
     )
+
+
+def _ensure_ast_str_compat() -> None:
+    """Provide ast.Str compatibility for Python 3.14+.
+
+    Older Werkzeug versions (used by Flask 1.x) still instantiate ast.Str.
+    Python 3.14 removed that alias, so we recreate it with ast.Constant.
+    """
+    if hasattr(ast, "Str"):
+        return
+
+    class _StrCompat(ast.Constant):
+        def __new__(cls, s: str = "", **kwargs):  # noqa: N804
+            return ast.Constant(value=s, **kwargs)
+
+    setattr(ast, "Str", _StrCompat)
+
+
+try:
+    import ast
+
+    _ensure_ast_str_compat()
+except ImportError:
+    pass

{alpha_python-0.5.1 → alpha_python-0.6.1}/src/alpha/adapters/rest_api_unit_of_work.py

@@ -11,7 +11,13 @@ UOW = TypeVar("UOW", bound="RestApiUnitOfWork")
 
 
 class RestApiUnitOfWork:
-    """Unit of Work implementation for REST API interactions."""
+    """Unit of Work implementation for REST API interactions.
+
+    This class manages the lifecycle of a shared HTTP session and provides
+    access to configured repositories for API interactions. It does not support
+    transactional operations like commit, flush, rollback, or refresh, as these
+    concepts do not apply to REST API interactions.
+    """
 
     def __init__(
         self,
@@ -22,9 +28,9 @@ class RestApiUnitOfWork:
 
         Parameters
         ----------
-        repos : list[RepositoryModel]
+        repos
             The list of repository models to use.
-        session : requests.sessions.Session | None
+        session
             The requests session (or compatible HTTP client, e.g., httpx) to
             use for context management, by default None