fastapi-cachex 0.2.7__tar.gz → 0.2.9__tar.gz

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-cachex
-Version: 0.2.7
+Version: 0.2.9
 Summary: A caching library for FastAPI with support for Cache-Control, ETag, and multiple backends.
 Keywords: fastapi,cache,etag,cache-control,redis,memcached,in-memory
 Author: allen0099
@@ -186,7 +186,7 @@ from fastapi_cachex.backends import MemoryBackend
 from fastapi_cachex import BackendProxy
 
 backend = MemoryBackend()
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Note**: In-memory cache is not suitable for production with multiple processes.
@@ -199,7 +199,7 @@ from fastapi_cachex.backends import MemcachedBackend
 from fastapi_cachex import BackendProxy
 
 backend = MemcachedBackend(servers=["localhost:11211"])
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Limitations**:
@@ -214,7 +214,7 @@ from fastapi_cachex.backends import AsyncRedisCacheBackend
 from fastapi_cachex import BackendProxy
 
 backend = AsyncRedisCacheBackend(host="127.0.0.1", port=6379, db=0)
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Features**:
@@ -232,7 +232,7 @@ backend = AsyncRedisCacheBackend(
     port=6379,
     key_prefix="myapp:cache:",
 )
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 ## Performance Considerations

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/README.md

@@ -150,7 +150,7 @@ from fastapi_cachex.backends import MemoryBackend
 from fastapi_cachex import BackendProxy
 
 backend = MemoryBackend()
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Note**: In-memory cache is not suitable for production with multiple processes.
@@ -163,7 +163,7 @@ from fastapi_cachex.backends import MemcachedBackend
 from fastapi_cachex import BackendProxy
 
 backend = MemcachedBackend(servers=["localhost:11211"])
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Limitations**:
@@ -178,7 +178,7 @@ from fastapi_cachex.backends import AsyncRedisCacheBackend
 from fastapi_cachex import BackendProxy
 
 backend = AsyncRedisCacheBackend(host="127.0.0.1", port=6379, db=0)
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 **Features**:
@@ -196,7 +196,7 @@ backend = AsyncRedisCacheBackend(
     port=6379,
     key_prefix="myapp:cache:",
 )
-BackendProxy.set_backend(backend)
+BackendProxy.set(backend)
 ```
 
 ## Performance Considerations

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/cache.py

@@ -151,11 +151,11 @@ def cache(
 
     def decorator(func: HandlerCallable) -> AsyncResponseCallable:
         try:
-            cache_backend = BackendProxy.get_backend()
+            cache_backend = BackendProxy.get()
         except BackendNotFoundError:
             # Fallback to memory backend if no backend is set
             cache_backend = MemoryBackend()
-            BackendProxy.set_backend(cache_backend)
+            BackendProxy.set(cache_backend)
             logger.debug("No backend configured; using MemoryBackend fallback")
 
         # Analyze the original function's signature

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/dependencies.py

@@ -10,7 +10,7 @@ from .proxy import BackendProxy
 
 def get_cache_backend() -> BaseCacheBackend:
     """Dependency to get the current cache backend instance."""
-    return BackendProxy.get_backend()
+    return BackendProxy.get()
 
 
 CacheBackend = Annotated[BaseCacheBackend, Depends(get_cache_backend)]

fastapi_cachex-0.2.9/fastapi_cachex/proxy.py

@@ -0,0 +1,95 @@
+"""Backend proxy for managing cache backend instances."""
+
+from __future__ import annotations
+
+import warnings
+from logging import getLogger
+from typing import Generic
+from typing import TypeVar
+
+from .backends import BaseCacheBackend
+from .exceptions import BackendNotFoundError
+
+ProxyInstance = TypeVar("ProxyInstance")
+
+logger = getLogger(__name__)
+
+
+class ProxyMeta(type):
+    """Metaclass for BackendProxy to prevent instantiation."""
+
+    def __call__(cls) -> None:
+        """Prevent instantiation of BackendProxy."""
+        msg = "Proxy class cannot be instantiated. Use static methods instead."
+        raise TypeError(msg)
+
+
+class ProxyBase(Generic[ProxyInstance], metaclass=ProxyMeta):
+    """Abstract base class for proxy classes."""
+
+    _instance: ProxyInstance | None = None
+
+    @classmethod
+    def get(cls) -> ProxyInstance:
+        """Get the current instance of the proxy.
+
+        Returns:
+            The current instance
+        """
+        if cls._instance is None:
+            msg = f"No instance set for proxy {cls.__name__}"
+            raise BackendNotFoundError(msg)
+        return cls._instance
+
+    @classmethod
+    def set(cls, instance: ProxyInstance | None) -> None:
+        """Set the instance for the proxy.
+
+        Args:
+            instance: The instance to set, or None to clear
+        """
+        logger.info(
+            "Setting instance to: <%s>",
+            instance.__class__.__name__ if instance else "None",
+        )
+        cls._instance = instance
+
+
+class BackendProxy(ProxyBase[BaseCacheBackend]):
+    """FastAPI CacheX Proxy for backend management."""
+
+    @staticmethod
+    def get_backend() -> BaseCacheBackend:  # pragma: no cover
+        """Get the current backend instance.
+
+        .. deprecated:: 0.3.0
+            Use :meth:`get` instead. Will be removed in version 0.4.0.
+
+        Returns:
+            The current backend instance
+        """
+        warnings.warn(
+            "get_backend() is deprecated, use get() instead. "
+            "Will be removed in version 0.4.0.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return BackendProxy.get()
+
+    @staticmethod
+    def set_backend(backend: BaseCacheBackend | None) -> None:  # pragma: no cover
+        """Set the backend instance.
+
+        .. deprecated:: 0.3.0
+            Use :meth:`set` instead. Will be removed in version 0.4.0.
+
+        Args:
+            backend: The backend instance to set, or None to clear
+        """
+        warnings.warn(
+            "set_backend() is deprecated, use set() instead. "
+            "Will be removed in version 0.4.0.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        BackendProxy.set(backend)

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/routes.py

@@ -266,7 +266,7 @@ def add_routes(
             CacheHitsResponse containing cache hit records and statistics
         """
         try:
-            backend: BaseCacheBackend = BackendProxy.get_backend()
+            backend: BaseCacheBackend = BackendProxy.get()
         except BackendNotFoundError:
             return CacheHitsResponse(
                 cached_hits=[],
@@ -294,7 +294,7 @@ def add_routes(
             CachedRecordsResponse containing cached records and statistics
         """
         try:
-            backend: BaseCacheBackend = BackendProxy.get_backend()
+            backend: BaseCacheBackend = BackendProxy.get()
         except BackendNotFoundError:
             return CachedRecordsResponse(
                 cached_records=[],

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/session/__init__.py

@@ -9,11 +9,13 @@ from .manager import SessionManager
 from .middleware import SessionMiddleware
 from .models import Session
 from .models import SessionUser
+from .proxy import SessionManagerProxy
 
 __all__ = [
     "Session",
     "SessionConfig",
     "SessionManager",
+    "SessionManagerProxy",
     "SessionMiddleware",
     "SessionUser",
     "get_optional_session",

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/session/middleware.py

@@ -12,6 +12,7 @@ from starlette.types import ASGIApp
 from .config import SessionConfig
 from .exceptions import SessionError
 from .manager import SessionManager
+from .proxy import SessionManagerProxy
 
 if TYPE_CHECKING:
     from .models import Session
@@ -25,7 +26,7 @@ class SessionMiddleware(BaseHTTPMiddleware):
     def __init__(
         self,
         app: ASGIApp,
-        session_manager: SessionManager,
+        session_manager: SessionManager | None = None,
         config: SessionConfig | None = None,
     ) -> None:
         """Initialize session middleware.
@@ -36,7 +37,7 @@ class SessionMiddleware(BaseHTTPMiddleware):
             config: Session configuration
         """
         super().__init__(app)
-        self.session_manager = session_manager
+        self.session_manager = session_manager or SessionManagerProxy.get()
 
         if config is None:
             config = self.session_manager.config

fastapi_cachex-0.2.9/fastapi_cachex/session/proxy.py

@@ -0,0 +1,9 @@
+"""FastAPI CacheX Proxy for session manager management."""
+
+from fastapi_cachex.proxy import ProxyBase
+
+from .manager import SessionManager
+
+
+class SessionManagerProxy(ProxyBase[SessionManager]):
+    """FastAPI CacheX Proxy for session manager management."""

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/fastapi_cachex/state/manager.py

@@ -35,7 +35,7 @@ class StateManager:
             key_prefix: Prefix for state keys in cache backend
             default_ttl: Default time-to-live in seconds for state
         """
-        self.backend = BackendProxy.get_backend()
+        self.backend = BackendProxy.get()
         self.key_prefix = key_prefix
         self.default_ttl = default_ttl
 

{fastapi_cachex-0.2.7 → fastapi_cachex-0.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-cachex"
-version = "0.2.7"
+version = "0.2.9"
 description = "A caching library for FastAPI with support for Cache-Control, ETag, and multiple backends."
 readme = "README.md"
 requires-python = ">=3.10"

fastapi_cachex-0.2.7/fastapi_cachex/proxy.py

@@ -1,43 +0,0 @@
-"""Backend proxy for managing cache backend instances."""
-
-from logging import getLogger
-
-from .backends import BaseCacheBackend
-from .exceptions import BackendNotFoundError
-
-_default_backend: BaseCacheBackend | None = None
-logger = getLogger(__name__)
-
-
-class BackendProxy:
-    """FastAPI CacheX Proxy for backend management."""
-
-    @staticmethod
-    def get_backend() -> BaseCacheBackend:
-        """Get the current cache backend instance.
-
-        Returns:
-            The current cache backend
-
-        Raises:
-            BackendNotFoundError: If no backend has been set
-        """
-        if _default_backend is None:
-            msg = "Backend is not set. Please set the backend first."
-            raise BackendNotFoundError(msg)
-
-        return _default_backend
-
-    @staticmethod
-    def set_backend(backend: BaseCacheBackend | None) -> None:
-        """Set the backend for caching.
-
-        Args:
-            backend: The backend to use for caching, or None to clear the current backend
-        """
-        global _default_backend
-        logger.info(
-            "Setting backend to: <%s>",
-            backend.__class__.__name__ if backend else "None",
-        )
-        _default_backend = backend