cachu 0.1.2__tar.gz → 0.1.3__tar.gz

{cachu-0.1.2 → cachu-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachu
-Version: 0.1.2
+Version: 0.1.3
 Summary: Flexible caching library built on dogpile.cache
 Author: bissli
 License-Expression: 0BSD
@@ -81,7 +81,7 @@ cachu.configure(
 
 ### Package Isolation
 
-Each package automatically gets isolated configuration. This prevents conflicts when multiple libraries use the cachu package:
+Each package automatically gets isolated configuration, preventing conflicts when multiple libraries use cachu:
 
 ```python
 # In library_a/config.py
@@ -92,7 +92,18 @@ cachu.configure(key_prefix='lib_a:', redis_url='redis://redis-a:6379/0')
 import cachu
 cachu.configure(key_prefix='lib_b:', redis_url='redis://redis-b:6379/0')
 
-# Each library uses its own configuration automatically
+# Each library's @cache calls use its own configuration automatically
+```
+
+To override the automatic detection, specify the `package` parameter:
+
+```python
+from cachu import cache
+
+# This function will use library_a's configuration
+@cache(ttl=300, package='library_a')
+def get_shared_data(id: int) -> dict:
+    return fetch(id)
 ```
 
 Retrieve configuration:

{cachu-0.1.2 → cachu-0.1.3}/README.md

@@ -62,7 +62,7 @@ cachu.configure(
 
 ### Package Isolation
 
-Each package automatically gets isolated configuration. This prevents conflicts when multiple libraries use the cachu package:
+Each package automatically gets isolated configuration, preventing conflicts when multiple libraries use cachu:
 
 ```python
 # In library_a/config.py
@@ -73,7 +73,18 @@ cachu.configure(key_prefix='lib_a:', redis_url='redis://redis-a:6379/0')
 import cachu
 cachu.configure(key_prefix='lib_b:', redis_url='redis://redis-b:6379/0')
 
-# Each library uses its own configuration automatically
+# Each library's @cache calls use its own configuration automatically
+```
+
+To override the automatic detection, specify the `package` parameter:
+
+```python
+from cachu import cache
+
+# This function will use library_a's configuration
+@cache(ttl=300, package='library_a')
+def get_shared_data(id: int) -> dict:
+    return fetch(id)
 ```
 
 Retrieve configuration:

{cachu-0.1.2 → cachu-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cachu"
-version = "0.1.2"
+version = "0.1.3"
 description = "Flexible caching library built on dogpile.cache"
 readme = "README.md"
 license = "0BSD"

{cachu-0.1.2 → cachu-0.1.3}/setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.2
+current_version = 0.1.3
 commit = True
 tag = True
 

{cachu-0.1.2 → cachu-0.1.3}/src/cachu/__init__.py

@@ -1,6 +1,6 @@
 """Flexible caching library with support for memory, file, and Redis backends.
 """
-__version__ = '0.1.2'
+__version__ = '0.1.3'
 
 from .backends.redis import get_redis_client
 from .config import configure, disable, enable, get_all_configs, get_config

{cachu-0.1.2 → cachu-0.1.3}/src/cachu/backends/file.py

@@ -115,7 +115,7 @@ class FileBackend(Backend):
 
                 with dbm.open(self._filepath, 'c') as db:
                     keys_to_delete = [
-                        k for k in db
+                        k for k in db.keys()
                         if fnmatch.fnmatch(k.decode(), pattern)
                     ]
                     for key in keys_to_delete:
@@ -131,7 +131,7 @@ class FileBackend(Backend):
         with self._lock:
             try:
                 with dbm.open(self._filepath, 'c') as db:
-                    all_keys = [k.decode() for k in db]
+                    all_keys = [k.decode() for k in db.keys()]
             except Exception:
                 return
 

{cachu-0.1.2 → cachu-0.1.3}/src/cachu/decorator.py

@@ -220,12 +220,7 @@ def get_cache_info(fn: Callable[..., Any]) -> CacheInfo:
     Returns
         CacheInfo with hits, misses, and currsize
     """
-    if hasattr(fn, '__wrapped__'):
-        actual_fn = fn
-    else:
-        actual_fn = fn
-
-    fn_id = id(actual_fn)
+    fn_id = id(fn)
 
     with _stats_lock:
         hits, misses = _stats.get(fn_id, (0, 0))

{cachu-0.1.2 → cachu-0.1.3}/src/cachu/operations.py

@@ -1,8 +1,8 @@
 """Cache CRUD operations.
 """
 import logging
-from typing import Any
 from collections.abc import Callable
+from typing import Any
 
 from .backends import NO_VALUE
 from .config import _get_caller_package, get_config
@@ -124,8 +124,6 @@ def cache_clear(
     if package is None:
         package = _get_caller_package()
 
-    cfg = get_config(package)
-
     if backend is not None:
         backends_to_clear = [backend]
     else:
@@ -141,19 +139,29 @@ def cache_clear(
 
     from .decorator import _backends, _backends_lock
 
-    with _backends_lock:
-        for (pkg, btype, bttl), backend_instance in list(_backends.items()):
-            if pkg != package:
-                continue
-            if btype not in backends_to_clear:
-                continue
-            if ttl is not None and bttl != ttl:
-                continue
-
-            cleared = backend_instance.clear(pattern)
-            if cleared > 0:
-                total_cleared += cleared
-                logger.debug(f'Cleared {cleared} entries from {btype} backend (ttl={bttl})')
+    # When both backend and ttl are specified, directly get/create and clear that backend.
+    # This is essential for distributed caches (Redis) where cache_clear may be called
+    # from a different process than the one that populated the cache.
+    if backend is not None and ttl is not None:
+        backend_instance = _get_backend(package, backend, ttl)
+        cleared = backend_instance.clear(pattern)
+        if cleared > 0:
+            total_cleared += cleared
+            logger.debug(f'Cleared {cleared} entries from {backend} backend (ttl={ttl})')
+    else:
+        with _backends_lock:
+            for (pkg, btype, bttl), backend_instance in list(_backends.items()):
+                if pkg != package:
+                    continue
+                if btype not in backends_to_clear:
+                    continue
+                if ttl is not None and bttl != ttl:
+                    continue
+
+                cleared = backend_instance.clear(pattern)
+                if cleared > 0:
+                    total_cleared += cleared
+                    logger.debug(f'Cleared {cleared} entries from {btype} backend (ttl={bttl})')
 
     return total_cleared
 

{cachu-0.1.2 → cachu-0.1.3}/src/cachu.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachu
-Version: 0.1.2
+Version: 0.1.3
 Summary: Flexible caching library built on dogpile.cache
 Author: bissli
 License-Expression: 0BSD
@@ -81,7 +81,7 @@ cachu.configure(
 
 ### Package Isolation
 
-Each package automatically gets isolated configuration. This prevents conflicts when multiple libraries use the cachu package:
+Each package automatically gets isolated configuration, preventing conflicts when multiple libraries use cachu:
 
 ```python
 # In library_a/config.py
@@ -92,7 +92,18 @@ cachu.configure(key_prefix='lib_a:', redis_url='redis://redis-a:6379/0')
 import cachu
 cachu.configure(key_prefix='lib_b:', redis_url='redis://redis-b:6379/0')
 
-# Each library uses its own configuration automatically
+# Each library's @cache calls use its own configuration automatically
+```
+
+To override the automatic detection, specify the `package` parameter:
+
+```python
+from cachu import cache
+
+# This function will use library_a's configuration
+@cache(ttl=300, package='library_a')
+def get_shared_data(id: int) -> dict:
+    return fetch(id)
 ```
 
 Retrieve configuration:

{cachu-0.1.2 → cachu-0.1.3}/tests/test_clearing.py

@@ -111,3 +111,64 @@ def test_cache_clear_redis_by_tag(redis_docker):
     get_product(1)
 
     cachu.cache_clear(tag='users', backend='redis', ttl=300)
+
+
+def test_cache_clear_without_instantiated_backend():
+    """Verify cache_clear creates backend when none exists.
+
+    This tests that cache_clear() properly creates a backend instance when
+    both backend and ttl are specified, even if no cached function has been called.
+
+    This is essential for distributed caches (Redis) where cache_clear may be called
+    from a different process than the one that populated the cache.
+    """
+    from cachu.decorator import _backends, clear_backends
+
+    # Clear all backends to simulate a fresh process
+    clear_backends()
+
+    # Verify no backends exist (simulates import script that hasn't called cached functions)
+    assert len(_backends) == 0
+
+    # Call cache_clear with specific backend and ttl
+    # Before the fix, this would do nothing because no backend existed
+    # After the fix, this should create the backend and attempt to clear it
+    cachu.cache_clear(backend='memory', ttl=999, tag='test_tag')
+
+    # With the fix, a backend should have been created
+    assert len(_backends) == 1
+    key = list(_backends.keys())[0]
+    assert key[1] == 'memory'  # backend type
+    assert key[2] == 999  # ttl
+
+
+def test_cache_clear_creates_backend_and_clears(temp_cache_dir):
+    """Verify cache_clear can clear data in file backend without prior instantiation.
+
+    File backend persists data to disk, allowing us to verify that cache_clear
+    can find and delete cached data even when called from a 'fresh' process state.
+    """
+    from cachu.backends import NO_VALUE
+    from cachu.config import _get_caller_package
+    from cachu.decorator import _backends, _get_backend, clear_backends
+
+    package = _get_caller_package()
+
+    # First, create some cached data in a file backend
+    backend = _get_backend(package, 'file', 888)
+    backend.set('14m:test_func||file_tag||x=1', 'test_value', 888)
+    assert backend.get('14m:test_func||file_tag||x=1') == 'test_value'
+
+    # Clear backend instances (but file data persists on disk)
+    clear_backends()
+    assert len(_backends) == 0
+
+    # cache_clear should create a new backend instance and clear the persisted data
+    cleared = cachu.cache_clear(backend='file', ttl=888, tag='file_tag')
+
+    # Backend should have been created
+    assert len(_backends) == 1
+
+    # Data should have been cleared (verify by getting a fresh backend)
+    backend = _get_backend(package, 'file', 888)
+    assert backend.get('14m:test_func||file_tag||x=1') is NO_VALUE