fastlifeweb 0.15.0__tar.gz → 0.16.0__tar.gz

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastlifeweb
-Version: 0.15.0
+Version: 0.16.0
 Summary: High-level web framework
 Home-page: https://github.com/mardiros/fastlife
 License: BSD-derived
@@ -17,8 +17,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Provides-Extra: testing
 Requires-Dist: babel (>=2.16.0,<3.0.0)
-Requires-Dist: beautifulsoup4[testing] (>=4.12.2,<5.0.0)
+Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0) ; extra == "testing"
 Requires-Dist: fastapi[standard] (>=0.115.0,<0.116.0)
 Requires-Dist: itsdangerous (>=2.1.2,<3.0.0)
 Requires-Dist: jinjax (>=0.44,<0.45)
@@ -42,12 +43,12 @@ Description-Content-Type: text/markdown
 > Please note that this project is still in active development. Features and APIs may change frequently.
 > Even the name is not definitive.
 
-An opinionated framework Python web framework (based on FastAPI).
+An opinionated Python web framework (based on FastAPI).
 
 ## Purpose
 
-Fastlife helps at building Web Application with html form generated from pydantic schema
-using customizable widget.
+Fastlife helps at building Web Application with session, security, html test client,
+and html form generated from pydantic schema using customizable widget.
 
 Templates are made using [JinjaX](https://jinjax.scaletti.dev/) and an extensible [set of
 component](https://mardiros.github.io/fastlife/components/index.html) is available

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/README.md

@@ -9,12 +9,12 @@
 > Please note that this project is still in active development. Features and APIs may change frequently.
 > Even the name is not definitive.
 
-An opinionated framework Python web framework (based on FastAPI).
+An opinionated Python web framework (based on FastAPI).
 
 ## Purpose
 
-Fastlife helps at building Web Application with html form generated from pydantic schema
-using customizable widget.
+Fastlife helps at building Web Application with session, security, html test client,
+and html form generated from pydantic schema using customizable widget.
 
 Templates are made using [JinjaX](https://jinjax.scaletti.dev/) and an extensible [set of
 component](https://mardiros.github.io/fastlife/components/index.html) is available

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/pyproject.toml

@@ -15,12 +15,12 @@ classifiers = [
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Internet :: WWW/HTTP",
 ]
-version = "0.15.0"
+version = "0.16.0"
 
 [tool.poetry.dependencies]
 python = "^3.11"
 babel = "^2.16.0"
-beautifulsoup4 = {version = "^4.12.2", extras = ["testing"]}
+beautifulsoup4 = {version = "^4.12.2", optional = true}
 fastapi = { version = "^0.115.0", extras = ["standard"]}
 itsdangerous = "^2.1.2"
 jinjax = "^0.44"
@@ -34,6 +34,9 @@ venusian = "^3.0.0"
 [tool.poetry.group.dev]
 optional = true
 
+[tool.poetry.extras]
+testing = ["beautifulsoup4"]
+
 [tool.poetry.group.dev.dependencies]
 beautifulsoup4 = "^4.12.2"
 behave = "^1.2.6"

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/__init__.py

@@ -2,32 +2,35 @@ from fastapi import Response
 
 from .config import (
     Configurator,
-    Registry,
+    DefaultRegistry,
+    GenericConfigurator,
     Settings,
     configure,
     resource,
     resource_view,
     view_config,
 )
-from .request import Request
+from .request import GenericRequest, Registry, Request, get_request
 
 # from .request.form_data import model
-from .templates import Template, template
+from .services.templates import TemplateParams
 
 __all__ = [
     # Config
     "configure",
+    "GenericConfigurator",
     "Configurator",
-    "template",
-    "Template",
-    "Registry",
+    "DefaultRegistry",
+    "TemplateParams",
     "Settings",
     "view_config",
     "resource",
     "resource_view",
     # Model
     # "model",
-    # Fast API reexport
     "Request",
+    "GenericRequest",
+    "get_request",
+    "Registry",
     "Response",
 ]

fastlifeweb-0.16.0/src/fastlife/adapters/jinjax/widgets/__init__.py

@@ -0,0 +1 @@
+"""HTML Form generation using widgets."""

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/adapters/jinjax/widgets/base.py

@@ -1,3 +1,4 @@
+"""Widget base class."""
 import abc
 import secrets
 from typing import Any, Generic, Mapping, Type, TypeVar

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/components/Tbody.jinja

@@ -8,6 +8,6 @@
 #}
 <tbody
   {%- if id %} id="{{id}}" {%- endif %}
-  {%- if class %} class="{{attrs.class}}" {%- endif %}>
+  {%- if attrs.class %} class="{{attrs.class}}" {%- endif %}>
   {{- content -}}
 </tbody>

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/components/Tfoot.jinja

@@ -8,6 +8,6 @@
 #}
 <tfoot
   {%- if id %} id="{{id}}" {%- endif %}
-  {%- if class %} class="{{attrs.class}}" {%- endif %}>
+  {%- if attrs.class %} class="{{attrs.class}}" {%- endif %}>
   {{- content -}}
 </tfoot>

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/components/Thead.jinja

@@ -8,6 +8,6 @@
 #}
 <thead
   {%- if id %} id="{{id}}" {%- endif %}
-  {%- if class %} class="{{attrs.class}}" {%- endif %}>
+  {%- if attrs.class %} class="{{attrs.class}}" {%- endif %}>
   {{- content -}}
 </thead>

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/components/Tr.jinja

@@ -8,6 +8,6 @@
 #}
 <tr
   {%- if id %} id="{{id}}" {%- endif %}
-  {%- if class %} class="{{attrs.class}}" {%- endif %}>
+  {%- if attrs.class %} class="{{attrs.class}}" {%- endif %}>
   {{- content -}}
 </tr>

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/config/__init__.py

@@ -1,18 +1,18 @@
 """Configure fastlife app for dependency injection."""
 
-from .configurator import Configurator, configure
-from .registry import AppRegistry, Registry
+from .configurator import Configurator, GenericConfigurator, configure
+from .registry import DefaultRegistry
 from .resources import resource, resource_view
 from .settings import Settings
 from .views import view_config
 
 __all__ = [
     "Configurator",
+    "GenericConfigurator",
     "configure",
     "view_config",
     "resource",
     "resource_view",
-    "Registry",
-    "AppRegistry",
+    "DefaultRegistry",
     "Settings",
 ]

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/config/configurator.py

@@ -19,7 +19,7 @@ from collections.abc import Mapping, Sequence
 from enum import Enum
 from pathlib import Path
 from types import ModuleType
-from typing import TYPE_CHECKING, Annotated, Any, Callable, Self, Tuple, Type
+from typing import TYPE_CHECKING, Annotated, Any, Callable, Generic, Self, Tuple, Type
 
 import venusian
 from fastapi import Depends, FastAPI
@@ -38,6 +38,7 @@ from fastlife.security.csrf import check_csrf
 from fastlife.services.policy import check_permission
 from fastlife.shared_utils.resolver import resolve
 
+from .registry import DefaultRegistry, TRegistry
 from .settings import Settings
 
 if TYPE_CHECKING:
@@ -46,7 +47,7 @@ if TYPE_CHECKING:
         AbstractTemplateRendererFactory,  # coverage: ignore
     )
 
-    from .registry import AppRegistry, LocaleNegociator  # coverage: ignore
+from fastlife.services.locale_negociator import LocaleNegociator
 
 log = logging.getLogger(__name__)
 VENUSIAN_CATEGORY = "fastlife"
@@ -109,14 +110,14 @@ def rebuild_router(router: Router) -> Router:
     return _router
 
 
-class Configurator:
+class GenericConfigurator(Generic[TRegistry]):
     """
     Configure and build an application.
 
     Initialize the app from the settings.
     """
 
-    registry: "AppRegistry"
+    registry: TRegistry
 
     def __init__(self, settings: Settings) -> None:
         """
@@ -135,10 +136,14 @@ class Configurator:
         self.api_version = "v1"
         self.api_description: str = ""
         self.api_summary: str | None = None
+        self.api_swagger_ui_url: str | None = None
+        self.api_redoc_url: str | None = None
 
         self._route_prefix: str = ""
         self._routers: dict[str, Router] = defaultdict(Router)
-        self._security_policies: dict[str, "type[AbstractSecurityPolicy[Any]]"] = {}
+        self._security_policies: dict[
+            str, "type[AbstractSecurityPolicy[Any, TRegistry]]"
+        ] = {}
 
         self.scanner = venusian.Scanner(fastlife=self)
         self.include("fastlife.views")
@@ -170,8 +175,8 @@ class Configurator:
             description=self.api_description,
             summary=self.api_summary,
             dependencies=[Depends(check_csrf())],
-            docs_url=self.registry.settings.api_swagger_ui_url,
-            redoc_url=self.registry.settings.api_redocs_url,
+            docs_url=self.api_swagger_ui_url,
+            redoc_url=self.api_redoc_url,
             openapi_tags=[tag.model_dump(by_alias=True) for tag in self.tags.values()]
             if self.tags
             else None,
@@ -241,7 +246,7 @@ class Configurator:
             self._route_prefix = old
         return self
 
-    def set_locale_negociator(self, locale_negociator: "LocaleNegociator") -> Self:
+    def set_locale_negociator(self, locale_negociator: LocaleNegociator) -> Self:
         """Install a locale negociator for the app."""
         self.registry.locale_negociator = locale_negociator
         return self
@@ -263,20 +268,28 @@ class Configurator:
         title: str,
         version: str,
         description: str,
+        *,
         summary: str | None = None,
+        swagger_ui_url: str | None = None,
+        redoc_url: str | None = None,
     ) -> Self:
         """
         Set your api documentation title for application that expose an API.
 
         :param title: OpenAPI documentation title
         :param version: OpenAPI api version
-        :param description: OpenAPI documentation description
-        :param summary: OpenAPI documentation summary
+        :param description: OpenAPI documentation description. Use markdown here.
+        :param summary: OpenAPI documentation summary.
+            A short description: text only.
+        :param swagger_ui_url: Endpoint for {term}`Swagger UI` served by FastAPI
+        :param redoc_url: Endpoint for {term}`Redoc` served by FastAPI
         """
         self.api_title = title
         self.api_version = version
         self.api_description = description
         self.api_summary = summary
+        self.api_swagger_ui_url = swagger_ui_url
+        self.api_redoc_url = redoc_url
         return self
 
     def add_open_tag(self, tag: OpenApiTag) -> Self:
@@ -296,7 +309,7 @@ class Configurator:
         return self
 
     def set_security_policy(
-        self, security_policy: "type[AbstractSecurityPolicy[Any]]"
+        self, security_policy: "type[AbstractSecurityPolicy[Any, TRegistry]]"
     ) -> Self:
         """
         Set a security policy for the application.
@@ -367,7 +380,7 @@ class Configurator:
         :param endpoint: the function that will reveive the request.
         :param permission: a permission to validate by the security policy.
         :param methods: restrict route to a list of http methods.
-        :param description:OpenAPI description for the route.
+        :param description:{term}`OpenAPI` description for the route.
         :param summary: OpenAPI summary for the route.
         :param response_description: OpenAPI description for the response.
         :param operation_id: OpenAPI optional unique string used to identify an
@@ -385,7 +398,7 @@ class Configurator:
         :param response_model_exclude_none: exclude fields instead of serialize to
             null value.
         :param include_in_schema: expose or not the route in the doc.
-        :param openapi_extra: open api documentation extra fields.
+        :param openapi_extra: OpenAPI documentation extra fields.
 
         :return: the configurator.
         """
@@ -549,7 +562,7 @@ class Configurator:
         self.registry.renderers[f".{file_ext.lstrip('.')}"] = renderer  # type: ignore
         return self
 
-    def add_template_search_path(self, path: str) -> Self:
+    def add_template_search_path(self, path: str | Path) -> Self:
         """
         Add a template search path directly from the code.
 
@@ -561,9 +574,17 @@ class Configurator:
         return self
 
 
+class Configurator(GenericConfigurator[DefaultRegistry]):
+    """
+    Configure and build an application.
+
+    Initialize the app from the settings.
+    """
+
+
 def configure(
     wrapped: Callable[[Configurator], None],
-) -> Callable[[Configurator], None]:
+) -> Callable[[Any], None]:
     """
     Decorator used to attach route in a submodule while using the configurator.include.
     """

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/config/registry.py

@@ -1,10 +1,7 @@
 from collections.abc import Mapping
-from typing import TYPE_CHECKING, Annotated, Callable
+from typing import TYPE_CHECKING, TypeVar
 
-from fastapi import Depends
-from fastapi import Request as FastAPIRequest
-
-from fastlife.request.request import Request
+from fastlife.services.locale_negociator import LocaleNegociator, default_negociator
 from fastlife.services.translations import LocalizerFactory
 
 if TYPE_CHECKING:
@@ -14,17 +11,8 @@ if TYPE_CHECKING:
 
 from .settings import Settings
 
-LocaleNegociator = Callable[[Request], str]
-
-
-def _default_negociator(settings: Settings) -> LocaleNegociator:
-    def locale_negociator(request: FastAPIRequest) -> str:
-        return settings.default_locale
-
-    return locale_negociator
 
-
-class AppRegistry:
+class DefaultRegistry:
     """
     The application registry got fastlife dependency injection.
     It is initialized by the configurator and accessed by the `fastlife.Registry`.
@@ -37,7 +25,7 @@ class AppRegistry:
 
     def __init__(self, settings: Settings) -> None:
         self.settings = settings
-        self.locale_negociator = _default_negociator(self.settings)
+        self.locale_negociator = default_negociator(self.settings)
         self.renderers = {}
         self.localizer = LocalizerFactory()
 
@@ -48,9 +36,4 @@ class AppRegistry:
         raise RuntimeError(f"No renderer registered for template {template}")
 
 
-def get_registry(request: Request) -> AppRegistry:
-    return request.registry
-
-
-Registry = Annotated[AppRegistry, Depends(get_registry)]
-"""FastAPI dependency to access to the registry."""
+TRegistry = TypeVar("TRegistry", bound=DefaultRegistry, covariant=True)

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/config/settings.py

@@ -29,7 +29,7 @@ class Settings(BaseSettings):
     a python module name. for instance `fastlife:components` is the directory components
     found in the fastlife package.
     """
-    registry_class: str = Field(default="fastlife.config.registry:AppRegistry")
+    registry_class: str = Field(default="fastlife.config.registry:DefaultRegistry")
     """Implementation class for the application regitry."""
     template_renderer_class: str = Field(
         default="fastlife.templates.renderer:JinjaxTemplateRenderer"
@@ -108,9 +108,3 @@ class Settings(BaseSettings):
 
     decode_reverse_proxy_headers: bool = Field(default=True)
     """Ensure that the request object has information based on http proxy headers."""
-
-    api_swagger_ui_url: str | None = Field(default=None)
-    """Path to the automatic API documentation using Swagger UI."""
-
-    api_redocs_url: str | None = Field(default=None)
-    """Path to the automatic API documentation using ReDoc."""

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/middlewares/reverse_proxy/__init__.py

@@ -12,6 +12,7 @@ Note that uvicorn or hypercorn offer the same kind middleware.
 
 Norw, every website is in https, so, this middleware is active by default.
 """
+
 from fastlife import Configurator, configure
 
 from .x_forwarded import XForwardedStar

fastlifeweb-0.16.0/src/fastlife/request/__init__.py

@@ -0,0 +1,5 @@
+"""HTTP Request."""
+
+from .request import GenericRequest, Registry, Request, get_request
+
+__all__ = ["Request", "Registry", "GenericRequest", "get_request"]

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/request/form.py

@@ -5,7 +5,7 @@ from typing import Any, Callable, Generic, Mapping, Type, TypeVar, get_origin
 from fastapi import Depends
 from pydantic import BaseModel, ValidationError
 
-from fastlife.config.registry import Registry
+from fastlife import Registry
 from fastlife.request.form_data import MappingFormData
 from fastlife.shared_utils.infer import is_union
 

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/request/form_data.py

@@ -12,9 +12,9 @@ from typing import (
     Sequence,
 )
 
-from fastapi import Depends, Request
+from fastapi import Depends
 
-from fastlife.config.registry import Registry
+from fastlife import Request
 
 
 def unflatten_struct(
@@ -80,13 +80,11 @@ def unflatten_struct(
     return unflattened_output
 
 
-async def unflatten_mapping_form_data(
-    request: Request, registry: Registry
-) -> Mapping[str, Any]:
+async def unflatten_mapping_form_data(request: Request) -> Mapping[str, Any]:
     """
     Parse the {meth}`fastlife.request.request.form` and build a nested structure.
     """
-
+    registry = request.registry
     form_data = await request.form()
     form_data_decode_list: MutableMapping[str, Any] = {}
     for key, val in form_data.multi_items():
@@ -109,17 +107,16 @@ async def unflatten_mapping_form_data(
     return ret  # type: ignore
 
 
-async def unflatten_sequence_form_data(
-    request: Request, reg: Registry
-) -> Sequence[str]:
+async def unflatten_sequence_form_data(request: Request) -> Sequence[str]:
     """
     Parse the {meth}`fastlife.request.request.form` and build a list of structure.
     """
+    registry = request.registry
     form_data = await request.form()
     # Could raise a value error !
-    return unflatten_struct(
-        form_data, [], csrf_token_name=reg.settings.csrf_token_name
-    )  # type: ignore
+    return unflatten_struct(  # type: ignore
+        form_data, [], csrf_token_name=registry.settings.csrf_token_name
+    )
 
 
 MappingFormData = Annotated[Mapping[str, Any], Depends(unflatten_mapping_form_data)]

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/request/request.py

@@ -3,27 +3,30 @@
 from typing import TYPE_CHECKING, Any
 
 from fastapi import Request as FastAPIRequest
+from fastapi.params import Depends
+from typing_extensions import Annotated, Generic
+
+from fastlife.config.registry import DefaultRegistry, TRegistry
 
 if TYPE_CHECKING:
-    from fastlife.config.registry import AppRegistry  # coverage: ignore
     from fastlife.security.policy import (  # coverage: ignore
         AbstractSecurityPolicy,
         HasPermission,
     )
 
 
-class Request(FastAPIRequest):
+class GenericRequest(FastAPIRequest, Generic[TRegistry]):
     """HTTP Request representation."""
 
-    registry: "AppRegistry"
+    registry: TRegistry
     """Direct access to the application registry."""
     locale_name: str
     """Request locale used for the i18n of the response."""
 
-    security_policy: "AbstractSecurityPolicy[Any] | None"
+    security_policy: "AbstractSecurityPolicy[Any, TRegistry] | None"
     """Request locale used for the i18n of the response."""
 
-    def __init__(self, registry: "AppRegistry", request: FastAPIRequest) -> None:
+    def __init__(self, registry: TRegistry, request: FastAPIRequest) -> None:
         super().__init__(request.scope, request.receive)
         self.registry = registry
         self.locale_name = registry.locale_negociator(self)
@@ -47,3 +50,25 @@ class Request(FastAPIRequest):
             )
 
         return await self.security_policy.has_permission(permission)
+
+
+def get_request(request: FastAPIRequest) -> GenericRequest[Any]:
+    return request  # type: ignore
+
+
+Request = Annotated[GenericRequest[DefaultRegistry], Depends(get_request)]
+"""A request that is associated to the default registry."""
+# FastAPI handle its Request objects using a lenient_issubclass,
+# basically a issubclass(Request), doe to the Generic[T], it does not work.
+
+
+AnyRequest = Annotated[GenericRequest[Any], Depends(get_request)]
+"""A request version that is associated to the any registry."""
+
+
+def get_registry(request: Request) -> DefaultRegistry:
+    return request.registry
+
+
+Registry = Annotated[DefaultRegistry, Depends(get_registry)]
+"""FastAPI dependency to access to the registry."""

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/routing/route.py

@@ -8,7 +8,7 @@ from starlette.responses import Response
 from fastlife.request.request import Request
 
 if TYPE_CHECKING:
-    from fastlife.config.registry import AppRegistry  # coverage: ignore
+    from fastlife.config.registry import DefaultRegistry  # coverage: ignore
 
 
 class Route(APIRoute):
@@ -19,7 +19,7 @@ class Route(APIRoute):
     have the registry property available in every received request.
     """
 
-    _registry: "AppRegistry"
+    _registry: "DefaultRegistry"
     """
     The application registry.
 

{fastlifeweb-0.15.0 → fastlifeweb-0.16.0}/src/fastlife/security/policy.py

@@ -2,14 +2,16 @@
 
 import abc
 import logging
-from typing import Any, Callable, Coroutine, Literal, TypeVar
+from typing import Annotated, Any, Callable, Coroutine, Literal, TypeVar
 from uuid import UUID
 
-from fastapi import HTTPException
+from fastapi import Depends, HTTPException
 from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN
 from typing_extensions import Generic
 
-from fastlife import Request
+from fastlife import get_request
+from fastlife.config.registry import TRegistry
+from tests.fastlife_app.config import GenericRequest
 
 CheckPermissionHook = Callable[..., Coroutine[Any, Any, None]] | Callable[..., None]
 CheckPermission = Callable[[str], CheckPermissionHook]
@@ -93,7 +95,7 @@ class Denied(HasPermission):
     reason = "Access denied to this resource"
 
 
-class AbstractSecurityPolicy(abc.ABC, Generic[TUser]):
+class AbstractSecurityPolicy(abc.ABC, Generic[TUser, TRegistry]):
     """Security policy base classe."""
 
     Forbidden = Forbidden
@@ -101,7 +103,12 @@ class AbstractSecurityPolicy(abc.ABC, Generic[TUser]):
     Unauthorized = Unauthorized
     """The exception raised if no user has been identified."""
 
-    def __init__(self, request: Request):
+    request: GenericRequest[TRegistry]
+    """Request where the security policy is applied."""
+
+    def __init__(
+        self, request: Annotated[GenericRequest[TRegistry], Depends(get_request)]
+    ):
         """
         Build the security policy.
 
@@ -141,7 +148,7 @@ class AbstractSecurityPolicy(abc.ABC, Generic[TUser]):
         """Destroy the request session."""
 
 
-class InsecurePolicy(AbstractSecurityPolicy[None]):
+class InsecurePolicy(AbstractSecurityPolicy[None, Any]):
     """
     An implementation of the security policy made for explicit unsecured access.
 

fastlifeweb-0.16.0/src/fastlife/services/locale_negociator.py

@@ -0,0 +1,25 @@
+"""Find the localization gor the given request."""
+
+from typing import TYPE_CHECKING, Any, Callable
+
+from fastlife.config.settings import Settings
+
+LocaleName = str
+"""The LocaleName is a locale such as en, fr that will be consume for translations."""
+
+if TYPE_CHECKING:
+    from fastlife.request.request import GenericRequest  # coverage: ignore
+
+    LocaleNegociator = Callable[[GenericRequest[Any]], LocaleName]  # coverage: ignore
+    """Interface to implement to negociate a locale"""  # coverage: ignore
+else:
+    LocaleNegociator = Any
+
+
+def default_negociator(settings: Settings) -> LocaleNegociator:
+    """The default local negociator return the locale set in the conf."""
+
+    def locale_negociator(request: "GenericRequest[Any]") -> str:
+        return settings.default_locale
+
+    return locale_negociator