edri 2025.11.1rc4__tar.gz → 2025.12.1__tar.gz

{edri-2025.11.1rc4 → edri-2025.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edri
-Version: 2025.11.1rc4
+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.1rc4 → edri-2025.12.1}/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-2025.11.1rc4 → edri-2025.12.1}/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-2025.11.1rc4 → edri-2025.12.1}/edri/api/handlers/http_handler.py

@@ -32,7 +32,7 @@ from edri.dataclass.directive.base import InternalServerErrorResponseDirective,
 from edri.dataclass.directive.http import CookieResponseDirective, AccessDeniedResponseDirective, \
     NotFoundResponseDirective, \
     ConflictResponseDirective, HeaderResponseDirective, UnprocessableContentResponseDirective, \
-    BadRequestResponseDirective, NotModifiedResponseDirective
+    BadRequestResponseDirective, NotModifiedResponseDirective, ServiceUnavailableResponseDirective
 from edri.dataclass.event import Event
 from edri.dataclass.injection import Injection
 from edri.utility import NormalizedDefaultDict
@@ -276,6 +276,9 @@ class HTTPHandler[T: HTTPResponseDirective](BaseHandler, ABC):
         },
         NotModifiedResponseDirective: {
             "status": HTTPStatus.NOT_MODIFIED,
+        },
+        ServiceUnavailableResponseDirective: {
+            "status": HTTPStatus.SERVICE_UNAVAILABLE,
         }
     }
 

{edri-2025.11.1rc4 → edri-2025.12.1}/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,

{edri-2025.11.1rc4 → edri-2025.12.1}/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-2025.11.1rc4 → edri-2025.12.1}/edri/dataclass/directive/http.py

@@ -66,6 +66,12 @@ class UnprocessableContentResponseDirective(HTTPResponseDirective):
 class BadRequestResponseDirective(HTTPResponseDirective):
     message: str | None = None
 
+
 @dataclass
 class NotModifiedResponseDirective(HTTPResponseDirective):
     pass
+
+
+@dataclass
+class ServiceUnavailableResponseDirective(HTTPResponseDirective):
+    message: str | None = None

edri-2025.12.1/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-2025.11.1rc4 → edri-2025.12.1}/edri.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edri
-Version: 2025.11.1rc4
+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.1rc4 → edri-2025.12.1}/edri.egg-info/SOURCES.txt

@@ -112,6 +112,7 @@ edri/switch/receiver.py
 edri/switch/sender.py
 edri/switch/switch.py
 edri/utility/__init__.py
+edri/utility/cache.py
 edri/utility/function.py
 edri/utility/json_encoder.py
 edri/utility/normalized_default_dict.py

{edri-2025.11.1rc4 → edri-2025.12.1}/edri.egg-info/requires.txt

@@ -8,6 +8,7 @@ watchdog>=6
 websockets>=14
 posix-ipc>=1.2.0
 markdown>=3.0
+pytz>=2024.1
 
 [dev]
 uvicorn>=0.32.0

{edri-2025.11.1rc4 → edri-2025.12.1}/setup.py

@@ -122,7 +122,7 @@ Whether you're building a real-time data processing system, a distributed servic
 
 setup(
     name='edri',
-    version='2025.11.01rc4',
+    version='2025.12.01',
     packages=find_packages(),
     description='Event Driven Routing Infrastructure',
     long_description=long_description,
@@ -140,7 +140,8 @@ setup(
         "watchdog>=6",
         "websockets>=14",
         "posix-ipc>=1.2.0",
-        "markdown>=3.0"
+        "markdown>=3.0",
+        "pytz>=2024.1",
     ],
     extras_require={
         "uvicorn": ["uvicorn[standard]>=0.32.0"],

{edri-2025.11.1rc4 → edri-2025.12.1}/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