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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-cachex
-Version: 0.2.7
+Version: 0.2.8
 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

fastapi_cachex-0.2.8/fastapi_cachex/proxy.py

@@ -0,0 +1,100 @@
+"""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
+from .session.manager import SessionManager
+
+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 = "Instance is not set. Please set the instance first."
+            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:
+        """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:
+        """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)
+
+
+class SessionManagerProxy(ProxyBase[SessionManager]):
+    """FastAPI CacheX Proxy for session manager management."""

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

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-cachex"
-version = "0.2.7"
+version = "0.2.8"
 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