edri 2025.11.1rc3__py3-none-any.whl → 2025.12.1__py3-none-any.whl

edri/abstract/__init__.py

@@ -2,9 +2,16 @@ from .manager.manager_base import ManagerBase
 from .manager.manager_priority_base import ManagerPriorityBase
 
 
-def request(func):
-    func.__purpose__ = "request"
-    return func
+def request(func=None, /, *, cache: str = None):
+    def wrapper(func):
+        func.__purpose__ = "request"
+        func.__cache__ = cache
+        return func
+
+    if func is None:
+        return wrapper
+
+    return wrapper(func)
 
 
 def response(func):

edri/abstract/manager/manager_base.py

@@ -1,7 +1,7 @@
 from abc import ABC, ABCMeta
 from copy import deepcopy
-from dataclasses import dataclass
 from datetime import datetime
+from http import HTTPMethod
 from importlib import invalidate_caches, import_module, reload
 from inspect import signature, Signature, ismethod, isfunction
 from logging import getLogger, Logger
@@ -12,16 +12,21 @@ from random import randint
 from time import sleep
 from traceback import format_exc
 from types import UnionType
-from typing import Optional, Type, Tuple, Callable, Union, Generic, TypeVar, Never, get_args, Iterable, get_origin
+from typing import Optional, Type, Tuple, Callable, Union, TypeVar, Never, get_args, Iterable, get_origin
 
 from edri.abstract.manager.worker import Worker
-from edri.abstract.worker import WorkerThread, WorkerProcess
+from edri.abstract.worker import WorkerProcess
+from edri.api.dataclass.api_event import api_events
+from edri.config.setting import API_CACHE_CONTROL, API_CACHE_HEADERS
+from edri.dataclass.directive.http import NotModifiedResponseDirective, HeaderResponseDirective
 from edri.dataclass.event import Event
 from edri.dataclass.health_checker import Status
+from edri.dataclass.response import ResponseStatus
 from edri.events.edri.group import Manager
 from edri.events.edri.manager import StreamCreate, StreamMessage, StreamClose, WorkerQuit, Restart
 from edri.events.edri.router import Subscribe, HealthCheck, UnsubscribeAll
 from edri.events.edri.store import Get
+from edri.utility.cache import Cache
 from edri.utility.storage import Storage
 
 T = TypeVar("T", bound=Event)
@@ -30,11 +35,23 @@ T = TypeVar("T", bound=Event)
 class ManagerBaseMeta(ABCMeta):
 
     def __new__(mcls, name, bases, namespace, /, **kwargs):
+        namespace["_cache_keys"] = dict()
+        namespace["_cache_methods"] = dict()
         for attr_name, attr_value in list(namespace.items()):
-            if callable(attr_value) and (
-                    purpose := getattr(attr_value, "__purpose__", None)):  # Check for the decorator's marker
+            if not callable(attr_value):
+                continue
+            if purpose := getattr(attr_value, "__purpose__", None):  # Check for the decorator's marker
                 if purpose == "request":
                     new_name = f"solve_req_{attr_name}"
+
+                    if cache := getattr(attr_value, "__cache__", None):
+                        namespace["_cache_keys"][attr_name] = cache
+                        event = signature(attr_value).parameters["event"].annotation
+                        for api_event in api_events:
+                            if api_event.event == event:
+                                break
+                        namespace["_cache_methods"][event] = api_event.method
+
                 elif purpose == "response":
                     new_name = f"solve_res_{attr_name}"
                 else:
@@ -109,6 +126,10 @@ class ManagerBase(ABC, Process, metaclass=ManagerBaseMeta):
         self._from_time = from_time
         self._store_get: Optional[Callable] = None
         self._exceptions: list[tuple[str, dict, Exception, str]] = []
+        self._cache: Cache
+        self._cache_vary = "Accept,Accept-Encoding"
+        if API_CACHE_HEADERS:
+            self._cache_vary += f",{API_CACHE_HEADERS}"
 
     def _subscribe(self) -> None:
         """
@@ -609,10 +630,25 @@ class ManagerBase(ABC, Process, metaclass=ManagerBaseMeta):
                 self.resolve_unknown(event)
             else:
                 had_response = event.has_response()
+                cache_key = self._cache_keys.get(resolver.__name__, None)
+                if cache_key:
+                    etag = self._cache.tag(cache_key)
+                    method = self._cache_methods[event.__class__]
+                    if etag and hasattr(event, "etag") and event.etag and etag in event.etag and method == HTTPMethod.GET:
+                        event.response.add_directive(NotModifiedResponseDirective())
+                        self.router_queue.put(event)
+                        return
                 resolver(event)
                 if not had_response and event.has_response() and event.response._changed:
                     if event._switch:
                         event._switch.received = False
+                    if cache_key and etag:
+                        if event.response.get_status() == ResponseStatus.OK and method in (HTTPMethod.POST, HTTPMethod.PUT, HTTPMethod.PATCH, HTTPMethod.DELETE):
+                            self._cache.renew(cache_key)
+                        else:
+                            event.response.add_directive(HeaderResponseDirective(name="ETag", value=etag))
+                            event.response.add_directive(HeaderResponseDirective(name="Cache-Control", value=API_CACHE_CONTROL))
+                            event.response.add_directive(HeaderResponseDirective(name="Vary", value=self._cache_vary))
                     self.router_queue.put(event)
 
     def get_pipes(self) -> set[Connection]:
@@ -828,7 +864,7 @@ class ManagerBase(ABC, Process, metaclass=ManagerBaseMeta):
         """
         Hook method called after the manager process starts. Can be overridden to perform initialization tasks.
         """
-        pass
+        self._cache = Cache()
 
     def quit(self) -> None:
         self.router_queue.close()

edri/api/broker.py

@@ -21,8 +21,8 @@ from edri.dataclass.response import ResponseStatus, Response
 from edri.events.api import group, manage, client
 from edri.events.edri.router import HealthCheck, Subscribe
 from edri.utility import Storage
-from edri.utility.validation import StringValidation, IntegerValidation, FloatValidation, DateValidation, \
-    TimeValidation, DateTimeValidation
+from edri.utility.validation import StringValidator, IntegerValidator, FloatValidator, DateValidator, \
+    TimeValidator, DateTimeValidator
 
 
 class TrieNode:
@@ -391,12 +391,12 @@ class Broker(ManagerBase):
 
         def extract_parameters_response(event_cls: Type[Event]) -> tuple[dict[str, Any], dict[str, Any]]:
             VALIDATION_MAP: dict[type, tuple[str, type]] = {
-                StringValidation: ("string", StringValidation.__bases__[0]),
-                IntegerValidation: ("integer", IntegerValidation.__bases__[0]),
-                FloatValidation: ("float", FloatValidation.__bases__[0]),
-                DateValidation: ("date", DateValidation.__bases__[0]),
-                TimeValidation: ("time", TimeValidation.__bases__[0]),
-                DateTimeValidation: ("datetime", DateTimeValidation.__bases__[0]),
+                StringValidator: ("string", StringValidator.__bases__[0]),
+                IntegerValidator: ("integer", IntegerValidator.__bases__[0]),
+                FloatValidator: ("float", FloatValidator.__bases__[0]),
+                DateValidator: ("date", DateValidator.__bases__[0]),
+                TimeValidator: ("time", TimeValidator.__bases__[0]),
+                DateTimeValidator: ("datetime", DateTimeValidator.__bases__[0]),
             }
 
             def resolve_validation(field_type: Injection) -> tuple[str | None, dict[str, Any]]:

edri/api/dataclass/api_event.py

@@ -16,7 +16,7 @@ from edri.config.constant import ApiType
 from edri.dataclass.event import EventHandlingType, _event, Event
 from edri.dataclass.injection import Injection
 from edri.utility.function import camel2snake
-from edri.utility.validation import ListValidation
+from edri.utility.validation import ListValidator
 
 
 @dataclass
@@ -113,7 +113,7 @@ def api(cls=None, /, *, init=True, repr=True, eq=True, order=False,
                     raise TypeError(f"{field.type} cannot be used as a type for API event")
             elif isinstance(field.type, Injection):
                 for validator in field.type.classes:
-                    if validator == ListValidation:
+                    if validator == ListValidator:
                         raise TypeError(
                             "ListValidation must be used as ListValidation[T], "
                             "e.g. ListValidation[Any] or ListValidation[inject(...)]."

edri/api/handlers/base_handler.py

@@ -72,7 +72,6 @@ class BaseHandler[T: ResponseDirective](ABC):
     def create_event(self, event_constructor: Type[Event]) -> Event:
         self.insert_default_parameters(event_constructor)
         self.check_parameters(event_constructor)
-        # noinspection PyArgumentList
         event = event_constructor(**self.parameters)
         event._timing.stamp(self.__class__.__name__, "Created")
         return event

edri/api/handlers/http_handler.py

@@ -29,14 +29,16 @@ from edri.config.setting import MAX_BODY_SIZE, ASSETS_PATH, UPLOAD_FILES_PREFIX,
     CORS_MAX_AGE, UPLOAD_FILES_PATH
 from edri.dataclass.directive import HTTPResponseDirective, ResponseDirective
 from edri.dataclass.directive.base import InternalServerErrorResponseDirective, UnauthorizedResponseDirective
-from edri.dataclass.directive.http import CookieResponseDirective, AccessDeniedResponseDirective, NotFoundResponseDirective, \
-    ConflictResponseDirective, HeaderResponseDirective, UnprocessableContentResponseDirective, BadRequestResponseDirective
+from edri.dataclass.directive.http import CookieResponseDirective, AccessDeniedResponseDirective, \
+    NotFoundResponseDirective, \
+    ConflictResponseDirective, HeaderResponseDirective, UnprocessableContentResponseDirective, \
+    BadRequestResponseDirective, NotModifiedResponseDirective, ServiceUnavailableResponseDirective
 from edri.dataclass.event import Event
 from edri.dataclass.injection import Injection
 from edri.utility import NormalizedDefaultDict
 from edri.utility.function import camel2snake
 from edri.utility.shared_memory_pipe import SharedMemoryPipe
-from edri.utility.validation import StringValidation
+from edri.utility.validation import StringValidator
 
 
 class EventTypesExtensionsDict(TypedDict):
@@ -194,7 +196,7 @@ class URLNode:
                             raise TypeError("All classes in 'inject' must have the same base class when used as URL parameters.")
                         break  # Only check the first valid base class regex
 
-            if vot is StringValidation:
+            if vot is StringValidator:
                 regex = type_.parameters.get("regex", None)
                 if regex is not None:
                     regex_function = lambda name, _: rf"^(?P<{escape(name)}>{sub(r'^\^(.*)\$$', r'\1', regex.pattern)})$"
@@ -271,6 +273,12 @@ class HTTPHandler[T: HTTPResponseDirective](BaseHandler, ABC):
         },
         BadRequestResponseDirective: {
             "status": HTTPStatus.BAD_REQUEST,
+        },
+        NotModifiedResponseDirective: {
+            "status": HTTPStatus.NOT_MODIFIED,
+        },
+        ServiceUnavailableResponseDirective: {
+            "status": HTTPStatus.SERVICE_UNAVAILABLE,
         }
     }
 
@@ -716,6 +724,23 @@ class HTTPHandler[T: HTTPResponseDirective](BaseHandler, ABC):
                     })
         except Exception as e:
             self.logger.error(e, exc_info=e)
+
+    async def response_headers(self, status: HTTPStatus, *args, **kwargs: Unpack[ResponseKW]):
+        headers = kwargs["headers"]
+        if headers is None:
+            headers = NormalizedDefaultDict(list)
+        await self.send({
+            'type': 'http.response.start',
+            'status': status,
+            'headers': self.get_headers_binary(headers),
+        })
+
+        await self.send({
+            'type': 'http.response.body',
+            'body': b"",
+            'more_body': False
+        })
+
     def get_event_constructors(self) -> tuple[dict[HTTPMethod, Type[Event]], dict[str, Any]]:
         return self.url_root.find_methods(self.scope["path"].lower())
 

edri/api/listener.py

@@ -147,7 +147,7 @@ class Listener(Process):
                 if isinstance(handler, HTMLHandler):
                     if await handler.response_assets(scope["path"]):
                         return
-                self.logger.debug("Unknown url %s", scope["path"])
+                self.logger.warning("Unknown url %s", scope["path"])
                 await handler.response_error(HTTPStatus.NOT_FOUND, {
                     "reasons": [{
                         "status_code": HTTPStatus.NOT_FOUND,
@@ -270,6 +270,8 @@ class Listener(Process):
                     await handler.response_file(event_response, headers=headers)
                 else:
                     await handler.response(status, event_response, headers=headers)
+            elif status.is_redirection:
+                await handler.response_headers(status, headers=headers)
             else:
                 await handler.response_error(status, event_response, headers=headers)
             self.unregister(pipe, event._api)

edri/config/setting.py

@@ -1,6 +1,8 @@
 from os import getenv
 from typing import Literal
 
+from pytz import timezone
+
 
 def getenv_bool(name: str, default: bool) -> bool:
     """Read an environment variable as a boolean, fallback to default if unset."""
@@ -13,9 +15,18 @@ ENVIRONMENT: Literal["development", "production"] = "production" if getenv("ENVI
 
 HEALTH_CHECK_TIMEOUT = int(getenv("EDRI_HEALTH_CHECK_TIMEOUT", 10))
 HEALTH_CHECK_FAILURE_LIMIT = int(getenv("EDRI_HEALTH_CHECK_FAILURE_LIMIT", 3))
+
+CORS_ORIGINS = getenv("EDRI_CORS_ORIGINS")
+CORS_HEADERS = getenv("EDRI_CORS_HEADERS")
+CORS_CREDENTIALS = bool(getenv("EDRI_CORS_CREDENTIALS", False))
+CORS_MAX_AGE = getenv("EDRI_CORS_MAX_AGE", None)
+
+TIMEZONE = timezone(getenv("EDRI_TIMEZONE", "UTC"))
 API_RESPONSE_TIMEOUT = int(getenv("EDRI_API_RESPONSE_TIMEOUT", 60))
 API_RESPONSE_WRAPPED = getenv_bool("EDRI_API_RESPONSE_WRAPPED", True)
 API_RESPONSE_TIMING = getenv_bool("EDRI_API_RESPONSE_TIMING", ENVIRONMENT == 'development')
+API_CACHE_CONTROL = getenv("EDRI_API_CACHE_CONTROL", "max-age=0, must-revalidate")
+API_CACHE_HEADERS = getenv("EDRI_API_CACHE_HEADERS", CORS_HEADERS)
 
 SWITCH_KEY_LENGTH = int(getenv("EDRI_SWITCH_KEY_LENGTH ", 8))
 SWITCH_HOST = getenv("EDRI_SWITCH_HOST", "localhost")
@@ -37,7 +48,4 @@ ASSETS_PATH = getenv("EDRI_ASSETS_PATH", "assets")
 MAX_BODY_SIZE = int(getenv("EDRI_MAX_BODY_SIZE", 4096 * 1024))
 CHUNK_SIZE = int(getenv("EDRI_CHUNK_SIZE", 256 * 1024))
 
-CORS_ORIGINS = getenv("EDRI_CORS_ORIGINS")
-CORS_HEADERS = getenv("EDRI_CORS_HEADERS")
-CORS_CREDENTIALS = bool(getenv("EDRI_CORS_CREDENTIALS", False))
-CORS_MAX_AGE = getenv("EDRI_CORS_MAX_AGE", None)
+

edri/dataclass/directive/http.py

@@ -65,3 +65,13 @@ class UnprocessableContentResponseDirective(HTTPResponseDirective):
 @dataclass
 class BadRequestResponseDirective(HTTPResponseDirective):
     message: str | None = None
+
+
+@dataclass
+class NotModifiedResponseDirective(HTTPResponseDirective):
+    pass
+
+
+@dataclass
+class ServiceUnavailableResponseDirective(HTTPResponseDirective):
+    message: str | None = None

edri/utility/cache.py

@@ -0,0 +1,19 @@
+from collections import defaultdict
+from datetime import datetime
+from pytz import timezone
+
+
+class Cache:
+    timezone = timezone("Europe/Prague")
+
+    def __init__(self):
+        self.last_modified = defaultdict(lambda: datetime.now(tz=self.timezone))
+
+    def last_change(self, key: str) -> datetime:
+        return self.last_modified[key]
+
+    def tag(self, key: str) -> str:
+        return f"{key}-{int(self.last_change(key).timestamp())}"
+
+    def renew(self, key: str) -> None:
+        self.last_modified[key] = datetime.now(tz=self.timezone)

edri/utility/validation.py

@@ -3,7 +3,7 @@ from re import Pattern
 from typing import Self, Iterable, Any
 
 
-class StringValidation(str):
+class StringValidator(str):
     """
     A string type that performs validation on initialization.
 
@@ -21,7 +21,7 @@ class StringValidation(str):
                     or its length is outside the allowed bounds.
 
     Example:
-        >>> StringValidation("hello", minimum_length=3, maximum_length=10)
+        >>> StringValidator("hello", minimum_length=3, maximum_length=10)
         'hello'
     """
 
@@ -49,7 +49,7 @@ class StringValidation(str):
         return (v[:max_len] + "…") if len(v) > max_len else v
 
 
-class IntegerValidation(int):
+class IntegerValidator(int):
     """
     An integer type that performs validation on initialization.
 
@@ -65,7 +65,7 @@ class IntegerValidation(int):
         ValueError: If the value is less than `minimum` or greater than `maximum`.
 
     Example:
-        >>> IntegerValidation(5, minimum=1, maximum=10)
+        >>> IntegerValidator(5, minimum=1, maximum=10)
         5
     """
 
@@ -78,7 +78,7 @@ class IntegerValidation(int):
         return value
 
 
-class FloatValidation(float):
+class FloatValidator(float):
     """
     A float type that performs validation on initialization.
 
@@ -94,7 +94,7 @@ class FloatValidation(float):
         ValueError: If the value is less than `minimum` or greater than `maximum`.
 
     Example:
-        >>> FloatValidation(3.14, minimum=1.0, maximum=5.0)
+        >>> FloatValidator(3.14, minimum=1.0, maximum=5.0)
         3.14
     """
 
@@ -107,7 +107,7 @@ class FloatValidation(float):
         return value
 
 
-class DateValidation(date):
+class DateValidator(date):
     """
     A date type that performs validation on initialization.
 
@@ -126,7 +126,7 @@ class DateValidation(date):
         ValueError: If the date is outside the allowed bounds.
 
     Example:
-        >>> DateValidation(2024, 3, 28, minimum_date=date(2024, 1, 1))
+        >>> DateValidator(2024, 3, 28, minimum_date=date(2024, 1, 1))
         datetime.date(2024, 3, 28)
     """
 
@@ -144,7 +144,7 @@ class DateValidation(date):
         return value
 
 
-class TimeValidation(time):
+class TimeValidator(time):
     """
     A time type that performs validation on initialization.
 
@@ -164,7 +164,7 @@ class TimeValidation(time):
         ValueError: If the time is outside the allowed bounds.
 
     Example:
-        >>> TimeValidation(12, 30, maximum_time=time(20, 0))
+        >>> TimeValidator(12, 30, maximum_time=time(20, 0))
         datetime.time(12, 30)
     """
 
@@ -182,7 +182,7 @@ class TimeValidation(time):
         return value
 
 
-class DateTimeValidation(datetime):
+class DateTimeValidator(datetime):
     """
     A datetime type that performs validation on initialization.
 
@@ -205,7 +205,7 @@ class DateTimeValidation(datetime):
         ValueError: If the datetime is outside the allowed bounds.
 
     Example:
-        >>> DateTimeValidation(2024, 3, 28, 15, 45,
+        >>> DateTimeValidator(2024, 3, 28, 15, 45,
         ...     minimum_datetime=datetime(2024, 3, 1))
         datetime.datetime(2024, 3, 28, 15, 45)
     """
@@ -224,7 +224,7 @@ class DateTimeValidation(datetime):
         return instance
 
 
-class ListValidation(list):
+class ListValidator(list):
     """
     A list type that performs validation on initialization.
 
@@ -241,9 +241,9 @@ class ListValidation(list):
         ValueError: If the list length is outside the allowed bounds.
 
     Example:
-        >>> ListValidation([1, 2, 3], minimum_length=2)
+        >>> ListValidator([1, 2, 3], minimum_length=2)
         [1, 2, 3]
-        >>> ListValidation([1, 2, 3], maximum_length=2)
+        >>> ListValidator([1, 2, 3], maximum_length=2)
         ValueError: List length '3' is greater than maximum allowed '2'
     """
 

{edri-2025.11.1rc3.dist-info → edri-2025.12.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edri
-Version: 2025.11.1rc3
+Version: 2025.12.1
 Summary: Event Driven Routing Infrastructure
 Author: Marek Olšan
 Author-email: marek.olsan@gmail.com
@@ -26,6 +26,7 @@ Requires-Dist: watchdog>=6
 Requires-Dist: websockets>=14
 Requires-Dist: posix-ipc>=1.2.0
 Requires-Dist: markdown>=3.0
+Requires-Dist: pytz>=2024.1
 Provides-Extra: uvicorn
 Requires-Dist: uvicorn[standard]>=0.32.0; extra == "uvicorn"
 Provides-Extra: hypercorn

{edri-2025.11.1rc3.dist-info → edri-2025.12.1.dist-info}/RECORD

@@ -1,7 +1,7 @@
 edri/__init__.py,sha256=bBVs4ynkUzMRudKZyuRScpPmUZTIL1LDfIytZ_L7oKE,6257
-edri/abstract/__init__.py,sha256=u51dxLMk2DM1Ywb-DR0NgX918y5yiaSbmhTqP9Fp1TU,325
+edri/abstract/__init__.py,sha256=C6ew041GNVcQlfkE77kHeZ9Ts1rIaWRqqh3bKz7Kb1E,488
 edri/abstract/manager/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-edri/abstract/manager/manager_base.py,sha256=aQ9UerJglo94mO6z1Xp0jy-t7KzeMMuFk1iM1ghvhCE,40194
+edri/abstract/manager/manager_base.py,sha256=mguHncpNnx-5RSAPdkzzl74NpOghpl2pI76H0biyZEo,42373
 edri/abstract/manager/manager_priority_base.py,sha256=1bUGsIr6MUrCNsJsLNF_tYaiFDX5t8vK2794vdZumQo,8219
 edri/abstract/manager/worker.py,sha256=xMJMDQtcH-j8s37cUoMsF_ZrWS4elbU7vnjdKfAv0gM,403
 edri/abstract/worker/__init__.py,sha256=qcCF2MnReil9G9ojrr7I3hjMks-1tsap4yrYH5Vr07Q,164
@@ -9,20 +9,20 @@ edri/abstract/worker/worker.py,sha256=JSTItljxBiCm_ljXctzTiKwb90Yk8Cy6EzZJTchtv9
 edri/abstract/worker/worker_process.py,sha256=QiNxOuwkMds0sV2MBLyp7bjrovm5xColC7I7TNcSO4s,1957
 edri/abstract/worker/worker_thread.py,sha256=xoMPuDn-hAkWk6kFY3Xf8mxOVP__5t7-x7f-b396-8M,2176
 edri/api/__init__.py,sha256=ZDxCpHKFGajJ1RwDpV7CzxLDUaKpozJRfOCv1OPv5ZY,142
-edri/api/broker.py,sha256=6O-B2Io7WF9KPXJCXsCzcyxpwjieIx5vqR06cSEi1oI,37276
-edri/api/listener.py,sha256=QaBlrlWH8j5OsD0mFMeTd95eP2nq7J-B6FCPL9OtFac,20289
+edri/api/broker.py,sha256=I3z_bKbcTDnKXk82yteGEQmuxpqHgp5KrhQaJmk3US0,37258
+edri/api/listener.py,sha256=8ffX8ntJ5XbHAqT5hM38teMRsd1cBjcJ7PJAMa4Ez7c,20403
 edri/api/middleware.py,sha256=6_x55swthVDczT-fu_1ufY1cDsHTZ04jMx6J6xfjbsM,5483
 edri/api/dataclass/__init__.py,sha256=8Y-zcaJtzMdALnNG7M9jsCaB1qAJKM8Ld3h9MDajYjA,292
-edri/api/dataclass/api_event.py,sha256=vAP5JOqlrg3XBZtKd_a721dPSKa2N1NlMtebD_kpP2Q,6589
+edri/api/dataclass/api_event.py,sha256=08edshexI9FxdebPIgTQMSQ4fEtGpAa3K_VYCmN1jFs,6587
 edri/api/dataclass/client.py,sha256=ctc2G4mXJR2wUSujANudT3LqxW7qxk_YkpM_TEXD0tM,216
 edri/api/dataclass/file.py,sha256=OJfJlrCTjSnzCF8yFVnxr8rGeL0l08WVMsXJx00S4qc,225
 edri/api/extensions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 edri/api/extensions/url_extension.py,sha256=rZKumjR7J6pDTiSLIZf8IzxGgDZP7p2g0Kgs0USug_U,1971
 edri/api/extensions/url_prefix.py,sha256=kNI6g5ZlW0w-J_IMacYLco1EQvmTtMJyEkN6-SK1wC0,491
 edri/api/handlers/__init__.py,sha256=MI6OGDf1rM8jf_uCKK_JYeOGMts62CNy10BwwNlG0Tk,200
-edri/api/handlers/base_handler.py,sha256=wENi5nfXaz2heyypzN8ikbN0ucPGxyRMcnxCpD9_o9Q,13151
+edri/api/handlers/base_handler.py,sha256=aZN95tWX7hkmJ3D401c-JPfF2azjH0t1jJy_zsjPc_4,13113
 edri/api/handlers/html_handler.py,sha256=OprcTg1IQDI7eBK-_oHqA60P1H30LA9xIQpD7iV-Neg,7464
-edri/api/handlers/http_handler.py,sha256=Il16LpIMjSreUXohn4c2R79Bx9mKqz7a08LfTVvPwws,35567
+edri/api/handlers/http_handler.py,sha256=AC-8oi4ez5LcNfCd-wrkGSc9fLo2fBNw51yEg8MDiPs,36368
 edri/api/handlers/rest_handler.py,sha256=GAG5lVTsRMCf9IUmYb_pokxyPcOfbnKZ2p3jxfy_-Dw,3300
 edri/api/handlers/websocket_handler.py,sha256=Dh2XannDuW0eFj5CEzf3owlGc1VTyQ8ehjpxYRrCYW8,8144
 edri/api/static_pages/documentation.j2,sha256=Fe7KLsbqp9P-pQYqG2z8rbhhGVDDFf3m6SQ2mc3PFG4,8934
@@ -32,7 +32,7 @@ edri/api/static_pages/status_400.j2,sha256=ArSvsNy9GG-Gbqt6fbRSqETmGV4aTJa3Zgwwt
 edri/api/static_pages/status_500.j2,sha256=39T6VeU_7m-6-RJyVsS48dD56Hp3ZcOeVC397T8GlsY,1468
 edri/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 edri/config/constant.py,sha256=5angk0yL3LlMWShzt0D7TflK5d2yLj2HDWoVqCqSLbY,783
-edri/config/setting.py,sha256=-6_BDFM-RdxIenYhE1Ykm8uGL73YhYUYbdz5YmI08xo,1833
+edri/config/setting.py,sha256=kzii_wmx4C8-uE_TNfBvRlJMkpJrvVLXvZam-2pm3eE,2065
 edri/dataclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 edri/dataclass/event.py,sha256=3XwbS_8Nst0V5D6vQ0FYhrX5rx6KfLGd3-9ba71xUMQ,9866
 edri/dataclass/health_checker.py,sha256=62H5wGUtOhql3acPwFtMhpGKPUTmFwWQ4hlqIn6tjfo,1784
@@ -41,7 +41,7 @@ edri/dataclass/response.py,sha256=VBMmVdna1IOKC5YGBXor6AayYOoiEYb9xx_RZ3bpKnw,38
 edri/dataclass/directive/__init__.py,sha256=nfvsh1BmxhACW7Q8gnwy7y3l3_cI1P0k2WP0jV5RJhI,608
 edri/dataclass/directive/base.py,sha256=2ghQpv1bGcNHYEMA0nyWGumIplXBzj9cPQ34aJ7uVr0,296
 edri/dataclass/directive/html.py,sha256=UCuwksxt_Q9b1wha1DjEygJWAyq2Hdnir5zG9lGi8as,946
-edri/dataclass/directive/http.py,sha256=k4ZDHZSwr4TerA6s0xeV58qpyjk2mdInTlWymBVluGI,2536
+edri/dataclass/directive/http.py,sha256=_kxof6aSZV1IK3awbK2KKG12gWM4d4l_GDzWt_TZTqs,2727
 edri/events/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 edri/events/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 edri/events/api/client/__init__.py,sha256=6q7CJ4eLMAuz_EFIs7us-xDXudy0Z5DIHd0YCVtTeuo,170
@@ -105,6 +105,7 @@ edri/switch/receiver.py,sha256=e2ugVM_DHWspVzHT5HBWajwo0YTexKeisqkXXEYscQ8,4240
 edri/switch/sender.py,sha256=xNXL6PeP9UMmMFr_Ol-cXJ5aYRVEWzx3GX1OchRbq-k,1173
 edri/switch/switch.py,sha256=ODxhUU5JQvdQRnw8idZIIW0EJc-DUzfdLdZGY_mwNdI,3388
 edri/utility/__init__.py,sha256=3ZpwOHlERrIru5wOGNtuhKb3kwvUFv5ALzP2CRyV6lg,136
+edri/utility/cache.py,sha256=fcKa-RDOq3_pMV0HO0s2iV8R2knjiyjNdFeu9N5lOpA,549
 edri/utility/function.py,sha256=xoW3SUjKbSgDvcArJskHh3wq_17kwMu3X362zbVU15c,6549
 edri/utility/json_encoder.py,sha256=2VZrVgUKFbkBRCX0V7lZEWiS1DzpFRn5LtJKx36zPaY,3952
 edri/utility/normalized_default_dict.py,sha256=EgzO-cdpekH3IkldGiD7nwj_2aTYIdGrlXvheEu6uNc,5011
@@ -112,7 +113,7 @@ edri/utility/queue.py,sha256=xBbeu1DT3Krdxni0YABk7gDZ5fLQL9eX-H3U-1jSqag,3628
 edri/utility/shared_memory_pipe.py,sha256=kmtd-1999s-cUVThxXVtw4N-rp_WgrHtl-h4hhEliXA,6396
 edri/utility/storage.py,sha256=AbZwtj8py0OBy3dM5C0fJ97uV88TERZO79heEmyE9Yk,3781
 edri/utility/transformation.py,sha256=4FeRNav-ifxuqgwq9ys3G5WtMzUAC3_2B3tnFhMENho,1450
-edri/utility/validation.py,sha256=V4EYvuDRsuVgfQTUSF-109O7tDtnNA78tsT231oeST4,9624
+edri/utility/validation.py,sha256=wDQb55CBB-I-KaevucmSWlevYAGxMJ8Pok0Ya3S8cLk,9609
 edri/utility/watcher.py,sha256=9nwU-h6B_QCd02-z-2-Hvf6huro8B9yVcZAepoFtXQ4,4623
 edri/utility/manager/__init__.py,sha256=bNyqET60wyq-QFmNwk52UKRweK5lYTDH_TF2UgS6enk,73
 edri/utility/manager/scheduler.py,sha256=3wRPph-FGNrVMN3TG7SvZ_PDW8mNK7UdM3PnjI_QTH8,11624
@@ -121,7 +122,7 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/test_edri_init.py,sha256=CME8WwikVgbz3qyjalLauShMcCjERyDBjlFD98xZIgs,4209
 tests/abstract/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/abstract/manager/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/abstract/manager/test_manager_base.py,sha256=ogpWnrfJULSbMn-78ti3_Z8s5wKL_Vo5gOJ48t7Q_7U,16445
+tests/abstract/manager/test_manager_base.py,sha256=btKW00EmllyL_LFN7cp4I68vho8wNTEG-sF79ocksnc,16484
 tests/abstract/manager/test_manager_base_priority.py,sha256=-z4Y1zkOGXNk1ytGla1UeLQutrfXjeWaSNBBsN5gqQk,5869
 tests/abstract/worker/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/abstract/worker/test_worker.py,sha256=4i2MuLSBaQh_wBMK5DEbx-k1F-rs15oRWzvQ_wktN8I,5298
@@ -152,11 +153,11 @@ tests/utility/test_normalized_default_dict.py,sha256=Utd4EhN6uW6m3eBxz1hhUwRCOWq
 tests/utility/test_shared_memory_pipe.py,sha256=JVzr-h8rjjlB6Uk_OnUBAlRwD2X4e74VKHBKCOE8KFM,7308
 tests/utility/test_storage.py,sha256=DD7H-xk3kTuz3x2zuJuJyHDV4eJMYy5iEsHoPAAfjuQ,1349
 tests/utility/test_transformation.py,sha256=4IJFuP3tp3Bd4vH3ohwxLb8yy4m1teK-e7UJbxJzevc,2840
-tests/utility/test_validation.py,sha256=OEM9hGzlFoSvZdwf5_pyH-Xg9ISxw0QJFbgMaDP8jtQ,9154
+tests/utility/test_validation.py,sha256=wZcXjLrj3JheVLKnYKkkYfyC8CCpHVAw9Jn_uDnuEfk,9103
 tests/utility/manager/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/utility/manager/test_scheduler.py,sha256=sROffYvSOaWsYQxQGTy6l9Mn_qeNPRmJoXLVPKU3XNY,9153
 tests/utility/manager/test_store.py,sha256=xlo1JUsPLIhPJyQn7AXldAgWDo_O8ba2ns25TEaaGdQ,2821
-edri-2025.11.1rc3.dist-info/METADATA,sha256=d0LFmSlm3cYRVlw79-cj59_Pa33mweHzTS7Ox063e4Y,8346
-edri-2025.11.1rc3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-edri-2025.11.1rc3.dist-info/top_level.txt,sha256=himES6JgPlx4Zt8aDrQEj2fxAd7IDD6MBOsiNZkzKHQ,11
-edri-2025.11.1rc3.dist-info/RECORD,,
+edri-2025.12.1.dist-info/METADATA,sha256=4Z-LtT8w_wnSd7I64CpMEAz00c0ya2fgv0kiobSD37w,8371
+edri-2025.12.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+edri-2025.12.1.dist-info/top_level.txt,sha256=himES6JgPlx4Zt8aDrQEj2fxAd7IDD6MBOsiNZkzKHQ,11
+edri-2025.12.1.dist-info/RECORD,,

tests/abstract/manager/test_manager_base.py

@@ -229,6 +229,7 @@ class TestManagerBase(unittest.TestCase):
         event_response = MagicMock(spec=Event)
         event_response._stream = None
         resolver = MagicMock(side_effect=add_response)
+        resolver.__name__ = "resolver"
 
         self.manager._requests[event.__class__] = resolver
         event.has_response.return_value = False

tests/utility/test_validation.py

@@ -2,44 +2,44 @@ import unittest
 from datetime import date, time, datetime
 from re import compile
 
-from edri.utility.validation import StringValidation, IntegerValidation, FloatValidation, DateValidation, TimeValidation, DateTimeValidation
+from edri.utility.validation import StringValidator, IntegerValidator, FloatValidator, DateValidator, TimeValidator, DateTimeValidator
 
 
 class TestStringValidation(unittest.TestCase):
     def test_valid_string(self):
-        value = StringValidation('hello', minimum_length=3, maximum_length=10)
+        value = StringValidator('hello', minimum_length=3, maximum_length=10)
         self.assertEqual(value, 'hello')
 
     def test_too_short_string(self):
         with self.assertRaises(ValueError) as cm:
-            StringValidation('hi', minimum_length=3)
+            StringValidator('hi', minimum_length=3)
         self.assertIn("too short", str(cm.exception))
 
     def test_too_long_string(self):
         with self.assertRaises(ValueError) as cm:
-            StringValidation('this is a long string', maximum_length=10)
+            StringValidator('this is a long string', maximum_length=10)
         self.assertIn("too long", str(cm.exception))
 
     def test_regex_match(self):
         pattern = compile(r'^[a-z]+$')
-        value = StringValidation('hello', regex=pattern)
+        value = StringValidator('hello', regex=pattern)
         self.assertEqual(value, 'hello')
 
     def test_regex_no_match(self):
         pattern = compile(r'^[a-z]+$')
         with self.assertRaises(ValueError) as cm:
-            StringValidation('Hello123', regex=pattern)
+            StringValidator('Hello123', regex=pattern)
         self.assertIn("not match", str(cm.exception))
 
     def test_all_constraints_pass(self):
         pattern = compile(r'^[a-z]+$')
-        value = StringValidation('hello', minimum_length=3, maximum_length=10, regex=pattern)
+        value = StringValidator('hello', minimum_length=3, maximum_length=10, regex=pattern)
         self.assertEqual(value, 'hello')
 
     def test_all_constraints_fail(self):
         pattern = compile(r'^[a-z]+$')
         with self.assertRaises(ValueError) as cm:
-            StringValidation('Hi', minimum_length=3, maximum_length=4, regex=pattern)
+            StringValidator('Hi', minimum_length=3, maximum_length=4, regex=pattern)
         self.assertTrue(
             any(msg in str(cm.exception) for msg in ["not match", "too short", "too long"])
         )
@@ -48,142 +48,142 @@ class TestStringValidation(unittest.TestCase):
 class TestIntegerValidation(unittest.TestCase):
     def test_valid_integer_no_constraints(self):
         # No constraints applied should return the number as-is.
-        value = IntegerValidation(10)
+        value = IntegerValidator(10)
         self.assertEqual(value, 10)
 
     def test_valid_integer_with_constraints(self):
         # Valid integer within the specified range.
-        value = IntegerValidation(5, minimum=1, maximum=10)
+        value = IntegerValidator(5, minimum=1, maximum=10)
         self.assertEqual(value, 5)
 
     def test_integer_below_minimum(self):
         # Should raise a ValueError because 0 is below the minimum of 1.
         with self.assertRaises(ValueError) as cm:
-            IntegerValidation(0, minimum=1)
+            IntegerValidator(0, minimum=1)
         self.assertIn("too small", str(cm.exception))
 
     def test_integer_above_maximum(self):
         # Should raise a ValueError because 11 is above the maximum of 10.
         with self.assertRaises(ValueError) as cm:
-            IntegerValidation(11, maximum=10)
+            IntegerValidator(11, maximum=10)
         self.assertIn("too big", str(cm.exception))
 
 
 class TestFloatValidation(unittest.TestCase):
     def test_valid_float_no_constraints(self):
         # No constraints applied should return the float as-is.
-        value = FloatValidation(3.14)
+        value = FloatValidator(3.14)
         self.assertEqual(value, 3.14)
 
     def test_valid_float_with_constraints(self):
         # Valid float within the specified range.
-        value = FloatValidation(3.14, minimum=1.0, maximum=5.0)
+        value = FloatValidator(3.14, minimum=1.0, maximum=5.0)
         self.assertEqual(value, 3.14)
 
     def test_float_below_minimum(self):
         # Should raise a ValueError because 0.5 is below the minimum of 1.0.
         with self.assertRaises(ValueError) as cm:
-            FloatValidation(0.5, minimum=1.0)
+            FloatValidator(0.5, minimum=1.0)
         self.assertIn("too small", str(cm.exception))
 
     def test_float_above_maximum(self):
         # Should raise a ValueError because 6.0 is above the maximum of 5.0.
         with self.assertRaises(ValueError) as cm:
-            FloatValidation(6.0, maximum=5.0)
+            FloatValidator(6.0, maximum=5.0)
         self.assertIn("too big", str(cm.exception))
 
 
 class TestDateValidation(unittest.TestCase):
 
     def test_valid_date_no_constraints(self):
-        d = DateValidation(2024, 3, 28)
+        d = DateValidator(2024, 3, 28)
         self.assertEqual(d, date(2024, 3, 28))
 
     def test_valid_date_within_constraints(self):
-        d = DateValidation(2024, 3, 28,
-                           minimum_date=date(2024, 1, 1),
-                           maximum_date=date(2024, 12, 31))
+        d = DateValidator(2024, 3, 28,
+                          minimum_date=date(2024, 1, 1),
+                          maximum_date=date(2024, 12, 31))
         self.assertEqual(d, date(2024, 3, 28))
 
     def test_date_equal_to_minimum(self):
-        d = DateValidation(2024, 1, 1, minimum_date=date(2024, 1, 1))
+        d = DateValidator(2024, 1, 1, minimum_date=date(2024, 1, 1))
         self.assertEqual(d, date(2024, 1, 1))
 
     def test_date_equal_to_maximum(self):
-        d = DateValidation(2024, 12, 31, maximum_date=date(2024, 12, 31))
+        d = DateValidator(2024, 12, 31, maximum_date=date(2024, 12, 31))
         self.assertEqual(d, date(2024, 12, 31))
 
     def test_date_below_minimum_raises(self):
         with self.assertRaises(ValueError) as context:
-            DateValidation(2023, 12, 31, minimum_date=date(2024, 1, 1))
+            DateValidator(2023, 12, 31, minimum_date=date(2024, 1, 1))
         self.assertIn("earlier than minimum allowed", str(context.exception))
 
     def test_date_above_maximum_raises(self):
         with self.assertRaises(ValueError) as context:
-            DateValidation(2025, 1, 1, maximum_date=date(2024, 12, 31))
+            DateValidator(2025, 1, 1, maximum_date=date(2024, 12, 31))
         self.assertIn("later than maximum allowed", str(context.exception))
 
     def test_invalid_date_raises(self):
         with self.assertRaises(ValueError):
-            DateValidation(2024, 2, 30)  # Invalid day in February
+            DateValidator(2024, 2, 30)  # Invalid day in February
 
 
 class TestTimeValidation(unittest.TestCase):
 
     def test_valid_time_no_constraints(self):
-        t = TimeValidation(12, 30)
+        t = TimeValidator(12, 30)
         self.assertEqual(t, time(12, 30))
 
     def test_valid_time_within_constraints(self):
-        t = TimeValidation(14, 45,
-                           minimum_time=time(12, 0),
-                           maximum_time=time(20, 0))
+        t = TimeValidator(14, 45,
+                          minimum_time=time(12, 0),
+                          maximum_time=time(20, 0))
         self.assertEqual(t, time(14, 45))
 
     def test_time_equal_to_minimum(self):
-        t = TimeValidation(8, 0, minimum_time=time(8, 0))
+        t = TimeValidator(8, 0, minimum_time=time(8, 0))
         self.assertEqual(t, time(8, 0))
 
     def test_time_equal_to_maximum(self):
-        t = TimeValidation(22, 0, maximum_time=time(22, 0))
+        t = TimeValidator(22, 0, maximum_time=time(22, 0))
         self.assertEqual(t, time(22, 0))
 
     def test_time_below_minimum_raises(self):
         with self.assertRaises(ValueError) as context:
-            TimeValidation(6, 59, minimum_time=time(7, 0))
+            TimeValidator(6, 59, minimum_time=time(7, 0))
         self.assertIn("earlier than minimum allowed", str(context.exception))
 
     def test_time_above_maximum_raises(self):
         with self.assertRaises(ValueError) as context:
-            TimeValidation(23, 1, maximum_time=time(23, 0))
+            TimeValidator(23, 1, maximum_time=time(23, 0))
         self.assertIn("later than maximum allowed", str(context.exception))
 
     def test_time_with_seconds_and_microseconds(self):
-        t = TimeValidation(10, 15, 30, 500000)
+        t = TimeValidator(10, 15, 30, 500000)
         self.assertEqual(t, time(10, 15, 30, 500000))
 
     def test_time_with_timezone(self):
         tz = time(0, 0).tzinfo  # no tzinfo set, just testing the arg
-        t = TimeValidation(10, 0, 0, 0, tz)
+        t = TimeValidator(10, 0, 0, 0, tz)
         self.assertEqual(t, time(10, 0))
 
     def test_invalid_hour_raises(self):
         with self.assertRaises(ValueError):
-            TimeValidation(25, 0)  # hour out of range
+            TimeValidator(25, 0)  # hour out of range
 
     def test_invalid_minute_raises(self):
         with self.assertRaises(ValueError):
-            TimeValidation(12, 60)  # minute out of range
+            TimeValidator(12, 60)  # minute out of range
 
 
 class TestDateTimeValidation(unittest.TestCase):
 
     def test_valid_datetime_no_constraints(self):
-        dt = DateTimeValidation(2024, 3, 28, 15, 30)
+        dt = DateTimeValidator(2024, 3, 28, 15, 30)
         self.assertEqual(dt, datetime(2024, 3, 28, 15, 30))
 
     def test_valid_datetime_within_constraints(self):
-        dt = DateTimeValidation(
+        dt = DateTimeValidator(
             2024, 3, 28, 12, 0,
             minimum_datetime=datetime(2024, 3, 1, 0, 0),
             maximum_datetime=datetime(2024, 12, 31, 23, 59)
@@ -191,14 +191,14 @@ class TestDateTimeValidation(unittest.TestCase):
         self.assertEqual(dt, datetime(2024, 3, 28, 12, 0))
 
     def test_datetime_equal_to_minimum(self):
-        dt = DateTimeValidation(
+        dt = DateTimeValidator(
             2024, 3, 1, 0, 0,
             minimum_datetime=datetime(2024, 3, 1, 0, 0)
         )
         self.assertEqual(dt, datetime(2024, 3, 1, 0, 0))
 
     def test_datetime_equal_to_maximum(self):
-        dt = DateTimeValidation(
+        dt = DateTimeValidator(
             2024, 12, 31, 23, 59,
             maximum_datetime=datetime(2024, 12, 31, 23, 59)
         )
@@ -206,7 +206,7 @@ class TestDateTimeValidation(unittest.TestCase):
 
     def test_datetime_below_minimum_raises(self):
         with self.assertRaises(ValueError) as context:
-            DateTimeValidation(
+            DateTimeValidator(
                 2024, 2, 29, 23, 59,
                 minimum_datetime=datetime(2024, 3, 1)
             )
@@ -214,21 +214,21 @@ class TestDateTimeValidation(unittest.TestCase):
 
     def test_datetime_above_maximum_raises(self):
         with self.assertRaises(ValueError) as context:
-            DateTimeValidation(
+            DateTimeValidator(
                 2025, 1, 1, 0, 0,
                 maximum_datetime=datetime(2024, 12, 31, 23, 59)
             )
         self.assertIn("later than maximum allowed", str(context.exception))
 
     def test_datetime_with_seconds_and_microseconds(self):
-        dt = DateTimeValidation(2024, 3, 28, 12, 45, 30, 999999)
+        dt = DateTimeValidator(2024, 3, 28, 12, 45, 30, 999999)
         self.assertEqual(dt, datetime(2024, 3, 28, 12, 45, 30, 999999))
 
     def test_invalid_datetime_raises(self):
         with self.assertRaises(ValueError):
-            DateTimeValidation(2024, 2, 30, 12, 0)  # Invalid date
+            DateTimeValidator(2024, 2, 30, 12, 0)  # Invalid date
 
     def test_timezone_argument_is_applied(self):
         tz = datetime.now().astimezone().tzinfo
-        dt = DateTimeValidation(2024, 3, 28, 10, 0, 0, 0, tz)
+        dt = DateTimeValidator(2024, 3, 28, 10, 0, 0, 0, tz)
         self.assertEqual(dt.tzinfo, tz)