future-framework 1.1.2__tar.gz → 2.0.0__tar.gz

{future_framework-1.1.2 → future_framework-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: future-framework
-Version: 1.1.2
+Version: 2.0.0
 Summary: ASGI-based framework for web APIs
 License: LICENSE
 License-File: LICENSE
@@ -11,14 +11,16 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: aiomysql (>=0.2.0,<0.3.0)
+Requires-Dist: aiosqlite (>=0.21.0,<0.22.0)
+Requires-Dist: asynch (>=0.2.5,<0.3.0)
+Requires-Dist: asyncpg (>=0.30.0,<0.31.0)
 Requires-Dist: clickhouse-driver (>=0.2.11,<0.3.0)
-Requires-Dist: elasticsearch (>=9.4.0,<10.0.0)
+Requires-Dist: elasticsearch (>=8.15.0,<9)
 Requires-Dist: faker (>=40.0.0,<41.0.0)
 Requires-Dist: httpx (>=0.28.1,<0.29.0)
 Requires-Dist: inflection (>=0.5.1,<0.6.0)
-Requires-Dist: psycopg2-binary (>=2.9.12,<3.0.0)
 Requires-Dist: pymongo (>=4.17.0,<5.0.0)
-Requires-Dist: pymysql (>=1.2.0,<2.0.0)
 Requires-Dist: python-dotenv (>=1.2.2,<2.0.0)
 Requires-Dist: redis (>=8.0.0,<9.0.0)
 Requires-Dist: rich (>=15.0.0,<16.0.0)
@@ -32,11 +34,11 @@ Project-URL: Repository, https://github.com/nicolaipre/future-framework
 Description-Content-Type: text/markdown
 
 # Future
-Minimal, decorator-free [ASGI](https://asgi.readthedocs.io/)-based framework for web APIs — routing, middleware, Active Record, migrations, seeds, OpenAPI, and interval tasks.
+[ASGI](https://asgi.readthedocs.io/)-based framework for web APIs — routing, middleware, Active Record, migrations, seeds, OpenAPI, and interval tasks.
 
 [![Build Status](https://github.com/nicolaipre/future-framework/actions/workflows/ci.yml/badge.svg)](https://github.com/nicolaipre/future-framework/actions)
-[![Package version](https://badge.fury.io/py/future-framework.svg)](https://pypi.org/project/future-framework/)
-[![codecov](https://codecov.io/gh/nicolaipre/future-framework/branch/master/graph/badge.svg)](https://codecov.io/gh/nicolaipre/future-framework)
+[![Package Version](https://img.shields.io/pypi/v/future-framework)](https://pypi.org/project/future-framework/)
+[![Coverage](https://codecov.io/gh/nicolaipre/future-framework/branch/master/graph/badge.svg)](https://codecov.io/gh/nicolaipre/future-framework)
 
 ## Documentation
 Published at **[nicolaipre.github.io/future-framework](https://nicolaipre.github.io/future-framework/)**. To preview locally: `poetry install --with docs && poetry run mkdocs serve`.
@@ -52,12 +54,12 @@ Import name is `future` (`from future.application import Future`).
 ## Hello
 ```python
 from future.application import Future
-from future.controllers import Controller
+from future.interfaces.IController import IController
 from future.lifespan import Lifespan
 from future.response import Response
 from future.routing import Get, RouteGroup
 
-class HomeController(Controller):
+class HomeController(IController):
     async def index(self) -> Response:
         return self.response.json({"ok": True})
 

{future_framework-1.1.2 → future_framework-2.0.0}/README.md

@@ -1,9 +1,9 @@
 # Future
-Minimal, decorator-free [ASGI](https://asgi.readthedocs.io/)-based framework for web APIs — routing, middleware, Active Record, migrations, seeds, OpenAPI, and interval tasks.
+[ASGI](https://asgi.readthedocs.io/)-based framework for web APIs — routing, middleware, Active Record, migrations, seeds, OpenAPI, and interval tasks.
 
 [![Build Status](https://github.com/nicolaipre/future-framework/actions/workflows/ci.yml/badge.svg)](https://github.com/nicolaipre/future-framework/actions)
-[![Package version](https://badge.fury.io/py/future-framework.svg)](https://pypi.org/project/future-framework/)
-[![codecov](https://codecov.io/gh/nicolaipre/future-framework/branch/master/graph/badge.svg)](https://codecov.io/gh/nicolaipre/future-framework)
+[![Package Version](https://img.shields.io/pypi/v/future-framework)](https://pypi.org/project/future-framework/)
+[![Coverage](https://codecov.io/gh/nicolaipre/future-framework/branch/master/graph/badge.svg)](https://codecov.io/gh/nicolaipre/future-framework)
 
 ## Documentation
 Published at **[nicolaipre.github.io/future-framework](https://nicolaipre.github.io/future-framework/)**. To preview locally: `poetry install --with docs && poetry run mkdocs serve`.
@@ -19,12 +19,12 @@ Import name is `future` (`from future.application import Future`).
 ## Hello
 ```python
 from future.application import Future
-from future.controllers import Controller
+from future.interfaces.IController import IController
 from future.lifespan import Lifespan
 from future.response import Response
 from future.routing import Get, RouteGroup
 
-class HomeController(Controller):
+class HomeController(IController):
     async def index(self) -> Response:
         return self.response.json({"ok": True})
 

{future_framework-1.1.2 → future_framework-2.0.0}/future/application.py

@@ -17,7 +17,7 @@ from rich.text import Text
 
 from future.exceptions import ErrorHandler, HTTPException
 from future.logger import log
-from future.middleware import Middleware
+from future.interfaces.IMiddleware import IMiddleware
 from future.openapi import get_openapi_config, is_docs_path, openapi_routes, rebuild_spec_from_routes, set_openapi_config, spec_path
 from future.request import Request
 from future.response import Response, WebSocketResponse
@@ -80,8 +80,8 @@ class Future:
         self.config = config or {}
         self.databases = self.config.get("DATABASES")
         if self.databases:
-            from future.databases.Connections import Connections
-            Connections().set_connection_details(self.databases)
+            from future.database import Database
+            Database().set_connection_details(self.databases)
 
         domain = self.config.get("APP_DOMAIN", "")
 
@@ -133,7 +133,7 @@ class Future:
                         return cls, endpoint.__name__
         return None, None
 
-    def _add_route(self, route: Route, subdomain: str = "", parent_middlewares: Optional[list[Middleware]] = None, group: Optional[dict[str, str]] = None) -> None:
+    def _add_route(self, route: Route, subdomain: str = "", parent_middlewares: Optional[list[IMiddleware]] = None, group: Optional[dict[str, str]] = None) -> None:
         """Internal method to add single routes to the application.
 
         Args:
@@ -165,7 +165,7 @@ class Future:
             group=group or {"name": "", "prefix": "", "subdomain": ""},
         )
 
-        self._check_route_conflicts(route, key)
+        self._check_route_conflicts(route, key, group)
         # Path + methods so Get("/x") and Post("/x") can coexist
         self.routes[key][f"{','.join(route.methods)} {route.path}"] = route_config
 
@@ -211,7 +211,7 @@ class Future:
         route_group: RouteGroup,
         parent_subdomain: str = "",
         parent_prefix: str = "",
-        parent_middlewares: Optional[list[Middleware]] = None,
+        parent_middlewares: Optional[list[IMiddleware]] = None,
         nesting_depth: int = 0,
         parent_group_names: Optional[list[str]] = None,
     ) -> None:
@@ -310,7 +310,7 @@ class Future:
 
         return full_prefix
 
-    def _check_route_conflicts(self, route: Route, domain: str) -> None:
+    def _check_route_conflicts(self, route: Route, domain: str, group: Optional[dict[str, str]] = None) -> None:
         """Conflict only when the same path shares an HTTP method."""
         existing_routes = self.routes.get(domain, {})
         for existing in existing_routes.values():
@@ -318,8 +318,14 @@ class Future:
             if other is None or getattr(other, "path", None) != route.path:
                 continue
             overlap = set(other.methods) & set(route.methods)
-            if overlap:
-                raise ValueError(f"Route conflict detected: {','.join(sorted(overlap))} {route.path} already exists in domain {domain}")
+            if not overlap:
+                continue
+            methods = ",".join(sorted(overlap))
+            incoming_sub = (group or {}).get("subdomain") or ""
+            existing_sub = (existing.get("group") or {}).get("subdomain") or ""
+            if getattr(self, "domainless_mode", False) and incoming_sub != existing_sub and (incoming_sub or existing_sub):
+                raise ValueError(f"Route conflict detected: {methods} {route.path} already exists. In domainless mode (APP_DOMAIN is empty), RouteGroup subdomains are ignored, so {existing_sub!r} and {incoming_sub!r} both register {route.path}. Set APP_DOMAIN to enable subdomain routing, or use different prefixes.")
+            raise ValueError(f"Route conflict detected: {methods} {route.path} already exists in domain {domain}")
 
     def _validate_domain_access(self, host_domain: str) -> bool:
         """Validate if the host domain is allowed to access routes."""

future_framework-2.0.0/future/authentication/Auth0Authentication.py

@@ -0,0 +1,9 @@
+"""
+Auth0 authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class Auth0Authentication(IAuthentication):
+    auth_type = "oauth"

future_framework-2.0.0/future/authentication/AzureADAuthentication.py

@@ -0,0 +1,9 @@
+"""
+Azure AD authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class AzureADAuthentication(IAuthentication):
+    auth_type = "basic"

{future_framework-1.1.2 → future_framework-2.0.0}/future/authentication/BasicAuthentication.py

@@ -2,8 +2,8 @@
 Regular username & password authentication (check against SQL database, generating a JWT).
 """
 
-from future.authentication.Authentication import Authentication
+from future.interfaces.IAuthentication import IAuthentication
 
 
-class BasicAuthentication(Authentication):
+class BasicAuthentication(IAuthentication):
     auth_type = "basic"

future_framework-2.0.0/future/authentication/KerberosAuthentication.py

@@ -0,0 +1,9 @@
+"""
+Kerberos Single Sign-On authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class KerberosAuthentication(IAuthentication):
+    auth_type = "sso"

future_framework-2.0.0/future/authentication/KeycloakAuthentication.py

@@ -0,0 +1,9 @@
+"""
+Keycloak authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class KeycloakAuthentication(IAuthentication):
+    auth_type = "oauth"

future_framework-2.0.0/future/authentication/OAuth2Authentication.py

@@ -0,0 +1,9 @@
+"""
+OAuth 2 authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class OAuth2Authentication(IAuthentication):
+    auth_type = "oauth"

future_framework-2.0.0/future/authentication/OpenIdConnectAuthentication.py

@@ -0,0 +1,9 @@
+"""
+OpenID Connect authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class OpenIdConnectAuthentication(IAuthentication):
+    auth_type = "oidc"

future_framework-2.0.0/future/authentication/SAMLAuthentication.py

@@ -0,0 +1,9 @@
+"""
+SAML Single Sign-On authentication.
+"""
+
+from future.interfaces.IAuthentication import IAuthentication
+
+
+class SAMLAuthentication(IAuthentication):
+    auth_type = "sso"