cachekit 0.24.0__tar.gz → 0.24.1__tar.gz

{cachekit-0.24.0 → cachekit-0.24.1}/Cargo.lock

@@ -280,7 +280,7 @@ dependencies = [
 
 [[package]]
 name = "cachekit-rs"
-version = "0.24.0"
+version = "0.24.1"
 dependencies = [
  "cachekit-core",
  "criterion 0.8.2",

{cachekit-0.24.0 → cachekit-0.24.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachekit
-Version: 0.24.0
+Version: 0.24.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -456,6 +456,7 @@ get_score(2)  # served from cache
 info = get_score.cache_info()
 # CacheInfo has 9 fields: hits, misses, l1_hits, l2_hits, maxsize,
 # currsize, l2_avg_latency_ms, last_operation_at, session_id
+assert (info.hits, info.misses) == (1, 1)  # the second call was a hit
 assert info.l1_hits + info.l2_hits == info.hits  # every hit is L1 or L2
 ```
 

{cachekit-0.24.0 → cachekit-0.24.1}/README.md

@@ -402,6 +402,7 @@ get_score(2)  # served from cache
 info = get_score.cache_info()
 # CacheInfo has 9 fields: hits, misses, l1_hits, l2_hits, maxsize,
 # currsize, l2_avg_latency_ms, last_operation_at, session_id
+assert (info.hits, info.misses) == (1, 1)  # the second call was a hit
 assert info.l1_hits + info.l2_hits == info.hits  # every hit is L1 or L2
 ```
 

{cachekit-0.24.0 → cachekit-0.24.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "cachekit"
-version = "0.24.0"
+version = "0.24.1"
 description = "Backend-agnostic caching for Python — intent-based decorators with circuit breaker, distributed locking, Prometheus metrics, and optional zero-knowledge AES-256-GCM encryption, on a Rust-powered core. Zero-config L1 in-memory; scales to Redis, Memcached, File, or CachekitIO."
 readme = "README.md"
 license = {text = "MIT"}
@@ -158,6 +158,8 @@ python_classes = ["Test*"]
 python_functions = ["test_*"]
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
+# An xfail that starts passing fails the run, so a fixed defect cannot hide behind its marker.
+xfail_strict = true
 addopts = [
     "--strict-markers",
     "--verbose",
@@ -276,4 +278,8 @@ constraint-dependencies = [
     # confusion) and GHSA-jp4c-xjxw-mgf9 (self-update import ordering); 26.2 fixes
     # PYSEC-2026-3721 (doubly-encoded index URLs install to arbitrary paths).
     "pip>=26.2",
+    # certifi is a dev-only transitive dep (pip-audit -> requests -> certifi).
+    # 2026.10.19 fixes PYSEC-2026-4320 (distrusts the emSign ECC Root CA - G3,
+    # whose intermediates had compromised keys).
+    "certifi>=2026.10.19",
 ]

{cachekit-0.24.0 → cachekit-0.24.1}/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cachekit-rs"
-version = "0.24.0"
+version = "0.24.1"
 edition = "2021"
 authors = ["cachekit Contributors"]
 description = "High-performance storage engine for caching with compression and encryption"

{cachekit-0.24.0 → cachekit-0.24.1}/rust/README.md

@@ -402,6 +402,7 @@ get_score(2)  # served from cache
 info = get_score.cache_info()
 # CacheInfo has 9 fields: hits, misses, l1_hits, l2_hits, maxsize,
 # currsize, l2_avg_latency_ms, last_operation_at, session_id
+assert (info.hits, info.misses) == (1, 1)  # the second call was a hit
 assert info.l1_hits + info.l2_hits == info.hits  # every hit is L1 or L2
 ```
 

{cachekit-0.24.0 → cachekit-0.24.1}/src/cachekit/__init__.py

@@ -68,7 +68,7 @@ Example Usage:
     ```
 """
 
-__version__ = "0.24.0"
+__version__ = "0.24.1"
 
 from collections.abc import Callable
 from typing import Any, TypeVar

{cachekit-0.24.0 → cachekit-0.24.1}/src/cachekit/backends/provider.py

@@ -251,12 +251,13 @@ class DefaultBackendProvider(BackendProviderInterface):
     def _is_configured(self) -> bool:
         """Whether the environment names a backend: any prefixed selector, or ``REDIS_URL``.
 
-        Read through pydantic-settings with ``case_sensitive=False``, exactly as ``RedisBackendConfig``
-        reads them: a lowercase ``redis_url`` always reached that Redis through ``get_backend()``'s
-        fallback. ``_detect()`` stays case-sensitive on purpose: a lowercase prefixed selector counts as
-        configured here and still resolves Redis there, as before; aligning either method changes routing.
-        A selector ``_detect()`` matches always counts too: with two spellings set, pydantic keeps one
-        (an empty one can win), while ``_detect()`` still routes on the exact-case one.
+        A selector ``_matched()`` finds counts first, because ``_detect()`` routes on it: with two
+        spellings of one set, pydantic keeps one (an empty one can win), while ``_detect()`` still routes
+        on the exact-case one. Then ``_BackendEnv`` reads every name through pydantic-settings with
+        ``case_sensitive=False``, exactly as ``RedisBackendConfig`` reads them: a lowercase ``redis_url``
+        always reached that Redis through ``get_backend()``'s fallback. ``_detect()`` stays case-sensitive
+        on purpose: a lowercase prefixed selector counts as configured here and still resolves Redis
+        there, as before; aligning either method changes routing.
         Never raises: two selectors count as configured, so ``get_backend()`` raises the ambiguity
         error where the decorator already handles a backend that fails to build.
         """

{cachekit-0.24.0 → cachekit-0.24.1}/src/cachekit/decorators/wrapper.py

@@ -288,6 +288,21 @@ class CacheInfo(NamedTuple):
         >>> total = info.hits + info.misses
         >>> round(info.hits / total, 2)
         0.83
+
+        Read a decorated function's statistics with ``cache_info()``. With nothing configured, the
+        second call is an L1 hit:
+
+        >>> from cachekit import cache
+        >>> @cache()
+        ... def square(x):
+        ...     return x * x
+        >>> square(4), square(4)
+        (16, 16)
+        >>> info = square.cache_info()
+        >>> info.hits, info.misses, info.l1_hits, info.l2_hits
+        (1, 1, 1, 0)
+        >>> info.maxsize is None and info.currsize is None
+        True
     """
 
     hits: int  # Total cache hits (L1 + L2)
@@ -3143,16 +3158,7 @@ def create_cache_wrapper(
             are unaffected.
 
         Returns:
-            CacheInfo: Named tuple with hits, misses, maxsize, currsize
-
-        Examples:
-            >>> @cache()
-            ... def factorial(n):
-            ...     return n * factorial(n-1) if n else 1
-            >>> factorial(5)
-            120
-            >>> factorial.cache_info()
-            CacheInfo(hits=4, misses=6, maxsize=None, currsize=6)
+            CacheInfo: Named tuple of nine fields; see ``CacheInfo`` for them and an example.
         """
         return _stats.get_info()