fastapi-cachex 0.1.4__py3-none-any.whl → 0.1.5__py3-none-any.whl

fastapi_cachex/__init__.py

@@ -1,2 +1,4 @@
 from .cache import cache as cache
+from .dependencies import CacheBackend as CacheBackend
+from .dependencies import get_cache_backend as get_cache_backend
 from .proxy import BackendProxy as BackendProxy

fastapi_cachex/backends/base.py

@@ -25,3 +25,26 @@ class BaseCacheBackend(ABC):
     @abstractmethod
     async def clear(self) -> None:
         """Clear all cached responses."""
+
+    @abstractmethod
+    async def clear_path(self, path: str, include_params: bool = False) -> int:
+        """Clear cached responses for a specific path.
+
+        Args:
+            path: The path to clear cache for
+            include_params: Whether to clear all parameter variations of the path
+
+        Returns:
+            Number of cache entries cleared
+        """
+
+    @abstractmethod
+    async def clear_pattern(self, pattern: str) -> int:
+        """Clear cached responses matching a pattern.
+
+        Args:
+            pattern: A glob pattern to match cache keys against (e.g., "/users/*")
+
+        Returns:
+            Number of cache entries cleared
+        """

fastapi_cachex/backends/memcached.py

@@ -1,4 +1,5 @@
 import ast
+import warnings
 from typing import Optional
 
 from fastapi_cachex.backends.base import BaseCacheBackend
@@ -25,7 +26,7 @@ class MemcachedBackend(BaseCacheBackend):
                 "pymemcache is not installed. Please install it with 'pip install pymemcache'"
             )
 
-        self.client = HashClient(servers)
+        self.client = HashClient(servers, connect_timeout=5, timeout=5)
 
     async def get(self, key: str) -> Optional[ETagContent]:
         """Get value from cache.
@@ -72,3 +73,29 @@ class MemcachedBackend(BaseCacheBackend):
     async def clear(self) -> None:
         """Clear all values from cache."""
         self.client.flush_all()
+
+    async def clear_path(self, path: str, include_params: bool = False) -> int:
+        """Clear cached responses for a specific path."""
+        if include_params:
+            warnings.warn(
+                "Memcached backend does not support pattern-based key clearing. "
+                "The include_params option will have no effect.",
+                RuntimeWarning,
+                stacklevel=2,
+            )
+            return 0
+
+        # If we're not including params, we can just try to delete the exact path
+        if self.client.delete(path, noreply=False):
+            return 1
+        return 0
+
+    async def clear_pattern(self, pattern: str) -> int:  # noqa: ARG002
+        """Clear cached responses matching a pattern."""
+        warnings.warn(
+            "Memcached backend does not support pattern matching. "
+            "Pattern-based cache clearing is not available.",
+            RuntimeWarning,
+            stacklevel=2,
+        )
+        return 0

fastapi_cachex/backends/memory.py

@@ -53,6 +53,40 @@ class MemoryBackend(BaseCacheBackend):
         async with self.lock:
             self.cache.clear()
 
+    async def clear_path(self, path: str, include_params: bool = False) -> int:
+        """Clear cached responses for a specific path."""
+        cleared_count = 0
+        async with self.lock:
+            keys_to_delete = []
+            for key in self.cache:
+                cache_path, *params = key.split(":", 1)
+                if cache_path == path and (include_params or not params):
+                    keys_to_delete.append(key)
+                    cleared_count += 1
+
+            for key in keys_to_delete:
+                del self.cache[key]
+
+        return cleared_count
+
+    async def clear_pattern(self, pattern: str) -> int:
+        """Clear cached responses matching a pattern."""
+        import fnmatch
+
+        cleared_count = 0
+        async with self.lock:
+            keys_to_delete = []
+            for key in self.cache:
+                cache_path = key.split(":", 1)[0]  # Get path part only
+                if fnmatch.fnmatch(cache_path, pattern):
+                    keys_to_delete.append(key)
+                    cleared_count += 1
+
+            for key in keys_to_delete:
+                del self.cache[key]
+
+        return cleared_count
+
     async def _cleanup_task_impl(self) -> None:
         try:
             while True:

fastapi_cachex/dependencies.py

@@ -0,0 +1,14 @@
+from typing import Annotated
+
+from fastapi import Depends
+
+from fastapi_cachex.backends.base import BaseCacheBackend
+from fastapi_cachex.proxy import BackendProxy
+
+
+def get_cache_backend() -> BaseCacheBackend:
+    """Dependency to get the current cache backend instance."""
+    return BackendProxy.get_backend()
+
+
+CacheBackend = Annotated[BaseCacheBackend, Depends(get_cache_backend)]

{fastapi_cachex-0.1.4.dist-info → fastapi_cachex-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-cachex
-Version: 0.1.4
+Version: 0.1.5
 Summary: A caching library for FastAPI with support for Cache-Control, ETag, and multiple backends.
 Author-email: Allen <s96016641@gmail.com>
 License-Expression: Apache-2.0

fastapi_cachex-0.1.5.dist-info/RECORD

@@ -0,0 +1,17 @@
+fastapi_cachex/__init__.py,sha256=_g7ewsAAjvbeMoDOttsfSD-G5ebPCN7MVPl-p2fY0tU,202
+fastapi_cachex/cache.py,sha256=b-55IR0kdcVj4yUk8dplqqUy2avW49P-oI01ART9pyU,9174
+fastapi_cachex/dependencies.py,sha256=K4565NSU7j8ktqe5ib_hs-fBB6IbIrM0nw6pTHpjLc4,385
+fastapi_cachex/directives.py,sha256=kJCmsbyQ89m6tsWo_c1vVJn3rk0pD5JZaY8xtNLcRh0,530
+fastapi_cachex/exceptions.py,sha256=coYct4u6uK_pdjetUWDwM5OUCfhql0OkTECynMRUq4M,379
+fastapi_cachex/proxy.py,sha256=vFShY7_xp4Sh1XU9dJzsBv2ICN8Rtwx6g1qCcCvmdf8,810
+fastapi_cachex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastapi_cachex/types.py,sha256=YkXlBARIr5lHQE4PYQrwXjEoLHdz9CIjfX7V-S9N8p0,328
+fastapi_cachex/backends/__init__.py,sha256=U65JrCeh1eusklqUfV5yvZGK7Kfy5RctzfVrRfFPuaI,166
+fastapi_cachex/backends/base.py,sha256=oBoHUaejZNQ_ex1n1YrpUP4CU94w2TbsXd6qau0F_T8,1383
+fastapi_cachex/backends/memcached.py,sha256=vy7isgu2qW2odBPTl8Q8ulqUo36KIsnZ3YVCr3sflfc,3211
+fastapi_cachex/backends/memory.py,sha256=4TBdvxnjMY0BnN1Gjr93rJllWJjU055RxG12QJixrrM,3611
+fastapi_cachex-0.1.5.dist-info/licenses/LICENSE,sha256=asJkHbd10YDSnjeAOIlKafh7E_exwtKXY5rA-qc_Mno,11339
+fastapi_cachex-0.1.5.dist-info/METADATA,sha256=OoxnkzzbW8iLikvibtF0Oud0xEUPwZDx9XIGMVNqmLM,4669
+fastapi_cachex-0.1.5.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+fastapi_cachex-0.1.5.dist-info/top_level.txt,sha256=97FfG5FDycd3hks-_JznEr-5lUOgg8AZd8pqK5imWj0,15
+fastapi_cachex-0.1.5.dist-info/RECORD,,

fastapi_cachex-0.1.4.dist-info/RECORD

@@ -1,16 +0,0 @@
-fastapi_cachex/__init__.py,sha256=K8zRD7pEOo77Ged7SJQ-BFNMe6Pnz8yM5ePFq97nI_s,82
-fastapi_cachex/cache.py,sha256=b-55IR0kdcVj4yUk8dplqqUy2avW49P-oI01ART9pyU,9174
-fastapi_cachex/directives.py,sha256=kJCmsbyQ89m6tsWo_c1vVJn3rk0pD5JZaY8xtNLcRh0,530
-fastapi_cachex/exceptions.py,sha256=coYct4u6uK_pdjetUWDwM5OUCfhql0OkTECynMRUq4M,379
-fastapi_cachex/proxy.py,sha256=vFShY7_xp4Sh1XU9dJzsBv2ICN8Rtwx6g1qCcCvmdf8,810
-fastapi_cachex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastapi_cachex/types.py,sha256=YkXlBARIr5lHQE4PYQrwXjEoLHdz9CIjfX7V-S9N8p0,328
-fastapi_cachex/backends/__init__.py,sha256=U65JrCeh1eusklqUfV5yvZGK7Kfy5RctzfVrRfFPuaI,166
-fastapi_cachex/backends/base.py,sha256=eGfn0oZNQ8_drNHz4ZtqBVFSxKxEwW8y4ojw5iShgLQ,707
-fastapi_cachex/backends/memcached.py,sha256=g3184fHpFK7LH1UY9xfzRszBBzqmzeaLG806B5MsZDM,2190
-fastapi_cachex/backends/memory.py,sha256=7KFSn5e1CvDzflZ5zqUPDQsBf6emcV0ob_tCsLQcDLw,2445
-fastapi_cachex-0.1.4.dist-info/licenses/LICENSE,sha256=asJkHbd10YDSnjeAOIlKafh7E_exwtKXY5rA-qc_Mno,11339
-fastapi_cachex-0.1.4.dist-info/METADATA,sha256=6qK6F6Pi338JYWN0NEv5SnR8gN4eJaXyFntNmFAu57s,4669
-fastapi_cachex-0.1.4.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-fastapi_cachex-0.1.4.dist-info/top_level.txt,sha256=97FfG5FDycd3hks-_JznEr-5lUOgg8AZd8pqK5imWj0,15
-fastapi_cachex-0.1.4.dist-info/RECORD,,