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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-cachex
-Version: 0.2.8
+Version: 0.2.10
 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
@@ -27,8 +27,8 @@ Requires-Dist: redis[hiredis] ; extra == 'redis'
 Requires-Dist: orjson ; extra == 'redis'
 Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/allen0099/FastAPI-CacheX
-Project-URL: Issues, https://github.com/allen0099/FastAPI-CacheX/issues
 Project-URL: Repository, https://github.com/allen0099/FastAPI-CacheX.git
+Project-URL: Issues, https://github.com/allen0099/FastAPI-CacheX/issues
 Provides-Extra: jwt
 Provides-Extra: memcache
 Provides-Extra: redis
@@ -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.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/fastapi_cachex/proxy.py

@@ -9,7 +9,6 @@ from typing import TypeVar
 
 from .backends import BaseCacheBackend
 from .exceptions import BackendNotFoundError
-from .session.manager import SessionManager
 
 ProxyInstance = TypeVar("ProxyInstance")
 
@@ -38,7 +37,7 @@ class ProxyBase(Generic[ProxyInstance], metaclass=ProxyMeta):
             The current instance
         """
         if cls._instance is None:
-            msg = "Instance is not set. Please set the instance first."
+            msg = f"No instance set for proxy {cls.__name__}"
             raise BackendNotFoundError(msg)
         return cls._instance
 
@@ -49,7 +48,7 @@ class ProxyBase(Generic[ProxyInstance], metaclass=ProxyMeta):
         Args:
             instance: The instance to set, or None to clear
         """
-        logger.info(
+        logger.debug(
             "Setting instance to: <%s>",
             instance.__class__.__name__ if instance else "None",
         )
@@ -60,7 +59,7 @@ class BackendProxy(ProxyBase[BaseCacheBackend]):
     """FastAPI CacheX Proxy for backend management."""
 
     @staticmethod
-    def get_backend() -> BaseCacheBackend:
+    def get_backend() -> BaseCacheBackend:  # pragma: no cover
         """Get the current backend instance.
 
         .. deprecated:: 0.3.0
@@ -78,7 +77,7 @@ class BackendProxy(ProxyBase[BaseCacheBackend]):
         return BackendProxy.get()
 
     @staticmethod
-    def set_backend(backend: BaseCacheBackend | None) -> None:
+    def set_backend(backend: BaseCacheBackend | None) -> None:  # pragma: no cover
         """Set the backend instance.
 
         .. deprecated:: 0.3.0
@@ -94,7 +93,3 @@ class BackendProxy(ProxyBase[BaseCacheBackend]):
             stacklevel=2,
         )
         BackendProxy.set(backend)
-
-
-class SessionManagerProxy(ProxyBase[SessionManager]):
-    """FastAPI CacheX Proxy for session manager management."""

{fastapi_cachex-0.2.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/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.10/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.8 → fastapi_cachex-0.2.10}/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.8 → fastapi_cachex-0.2.10}/pyproject.toml

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