CacheToolsUtils 8.5__tar.gz → 9.0__tar.gz

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/CacheToolsUtils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CacheToolsUtils
-Version: 8.5
+Version: 9.0
 Summary: Cachetools Utilities
 Author-email: Fabien Coelho <cachetools.utils@coelho.net>
 License: CC0
@@ -22,6 +22,7 @@ Requires-Dist: mypy; extra == "dev"
 Requires-Dist: pyright; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
 Requires-Dist: pymarkdownlnt; extra == "dev"
@@ -50,7 +51,7 @@ Classes to add key prefix and stats to
 and other cache-related utils.
 
 ![Status](https://github.com/zx80/cachetools-utils/actions/workflows/cachetools-utils.yml/badge.svg?branch=main&style=flat)
-![Tests](https://img.shields.io/badge/tests-17%20✓-success)
+![Tests](https://img.shields.io/badge/tests-19%20✓-success)
 ![Coverage](https://img.shields.io/badge/coverage-100%25-success)
 ![Issues](https://img.shields.io/github/issues/zx80/cachetools-utils?style=flat)
 ![Python](https://img.shields.io/badge/python-3-informational)
@@ -74,12 +75,13 @@ with `cachetools`.
   class for Memcached.
 - `DictCache` a very simple `dict` cache.
 
-### Other wrappers to extend cache capabilities
+### Wrappers to extend cache capabilities
 
 - `PrefixedCache`, `PrefixedMemCached` and `PrefixedRedisCache` add a prefix to
   distinguish sources on a shared cache.
-- `StatsCache`, `StatsMemCached` and `StatsRedisCache` add a `hits()` method
-  to report the cache hit rate.
+- `StatsCache`, `MemCached` and `RedisCache` add a `hits` method
+  to report the cache hit rate, `stats` to report statistics and
+  `reset` to reset statistics.
 - `LockedCache` use a (thread) lock to control cache accesses.
 - `TwoLevelCache` allows to combine two caches.
 - `DebugCache` to trace cache calls using `logging`.
@@ -90,6 +92,14 @@ with `cachetools`.
   function result is in cache, and to delete such an entry.
 - `cacheFunctions` and `cacheMethods`: add caching to functions or methods.
 
+## License
+
+This code is [Public Domain](https://creativecommons.org/publicdomain/zero/1.0/).
+
+All software has bug, this is software, hence… Beware that you may lose your
+hairs or your friends because of it. If you like it, feel free to send a
+postcard to the author.
+
 ## More
 
 See the
@@ -98,7 +108,3 @@ See the
 [issues](https://github.com/zx80/cachetools-utils/issues) on GitHub.
 
 See [packages](https://pypi.org/project/CacheToolsUtils/) on PyPI.
-
-## License
-
-This code is public domain.

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/CacheToolsUtils.egg-info/requires.txt

@@ -5,6 +5,7 @@ mypy
 pyright
 black
 flake8
+ruff
 pytest
 coverage
 pymarkdownlnt

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/CacheToolsUtils.py

@@ -25,7 +25,8 @@ _NO_DEFAULT = object()
 class _MutMapMix:
     """Convenient MutableMapping Mixin, forward to _cache."""
 
-    _cache: MutableMapping
+    # FIXME coverage reports this as missing with Python 3.14
+    _cache: MutableMapping  # pragma: no cover
 
     def __contains__(self, key):
         return self._cache.__contains__(key)
@@ -69,9 +70,12 @@ class _KeyMutMapMix(_MutMapMix):
 class _StatsMix:
     """Convenient Mixin to forward stats methods to _cache."""
 
-    def hits(self):
+    def hits(self) -> float|None:
         return self._cache.hits()  # type: ignore
 
+    def stats(self) -> dict[str, Any]:
+        return self._cache.stats()  # type: ignore
+
     def reset(self):
         return self._cache.reset()  # type: ignore
 
@@ -102,7 +106,7 @@ class _RedisMix:  # pragma: no cover
 # CACHETOOLS EXTENSIONS
 #
 
-class DebugCache(MutableMapping):
+class DebugCache(_StatsMix, MutableMapping):
     """Debug class.
 
     :param cache: actual cache
@@ -241,14 +245,25 @@ class StatsCache(_MutMapMix, MutableMapping):
         self._cache = cache
         self.reset()
 
-    def hits(self):
+    def hits(self) -> float:
         """Return the cache hit ratio."""
-        return float(self._hits) / float(max(self._reads, 1))
+        return float(self._hits) / max(self._reads, 1)
 
     def reset(self):
         """Reset internal stats data."""
         self._reads, self._writes, self._dels, self._hits = 0, 0, 0, 0
 
+    def stats(self) -> dict[str, Any]:
+        """Return available stats data as dict."""
+        return {
+            "type": 1,
+            "reads": self._reads,
+            "writes": self._writes,
+            "dels": self._dels,
+            "hits": self.hits(),
+            "size": self._cache.__len__()
+        }
+
     def __getitem__(self, key):
         self._reads += 1
         res = self._cache.__getitem__(key)
@@ -324,6 +339,27 @@ class TwoLevelCache(_MutMapMix, MutableMapping):
         # NOTE not passed on cache2…
         return self._cache.clear()
 
+    def stats(self) -> dict[str, Any]:
+        data = {"type": 2}
+        try:
+            data["cache1"] = self._cache.stats()  # type: ignore
+        except Exception:
+            data["cache1"] = {}  # type: ignore
+        try:
+            data["cache2"] = self._cache2.stats()  # type: ignore
+        except Exception:
+            data["cache2"] = {}  # type: ignore
+        return data
+
+    def hits(self) -> float|None:
+        data = self.stats()
+        c1, c2 = data["cache1"], data["cache2"]
+        if (c1 and "type" in c1 and c1["type"] == 1 and
+            c2 and "type" in c2 and c2["type"] == 1):
+            return float(c1["hits"] + c2["hits"]) / max(c1["reads"] + c2["reads"], 1)
+        # else
+        return None
+
     def reset(self):  # pragma: no cover
         self._cache.reset()  # type: ignore
         self._cache2.reset()  # type: ignore
@@ -586,6 +622,9 @@ class RedisCache(MutableMapping):
         """Return redis informations."""
         return self._cache.info(*args, **kwargs)
 
+    def stats(self) -> dict[str, Any]:
+        return self.info(section="stats")
+
     def dbsize(self, *args, **kwargs):
         """Return redis database size."""
         return self._cache.dbsize(*args, **kwargs)
@@ -606,9 +645,9 @@ class RedisCache(MutableMapping):
         del self[index]
 
     # stats
-    def hits(self):
+    def hits(self) -> float:
         """Return cache hits."""
-        stats = self.info(section="stats")
+        stats = self.stats()
         return float(stats["keyspace_hits"]) / (
             stats["keyspace_hits"] + stats["keyspace_misses"]
         )

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CacheToolsUtils
-Version: 8.5
+Version: 9.0
 Summary: Cachetools Utilities
 Author-email: Fabien Coelho <cachetools.utils@coelho.net>
 License: CC0
@@ -22,6 +22,7 @@ Requires-Dist: mypy; extra == "dev"
 Requires-Dist: pyright; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: coverage; extra == "dev"
 Requires-Dist: pymarkdownlnt; extra == "dev"
@@ -50,7 +51,7 @@ Classes to add key prefix and stats to
 and other cache-related utils.
 
 ![Status](https://github.com/zx80/cachetools-utils/actions/workflows/cachetools-utils.yml/badge.svg?branch=main&style=flat)
-![Tests](https://img.shields.io/badge/tests-17%20✓-success)
+![Tests](https://img.shields.io/badge/tests-19%20✓-success)
 ![Coverage](https://img.shields.io/badge/coverage-100%25-success)
 ![Issues](https://img.shields.io/github/issues/zx80/cachetools-utils?style=flat)
 ![Python](https://img.shields.io/badge/python-3-informational)
@@ -74,12 +75,13 @@ with `cachetools`.
   class for Memcached.
 - `DictCache` a very simple `dict` cache.
 
-### Other wrappers to extend cache capabilities
+### Wrappers to extend cache capabilities
 
 - `PrefixedCache`, `PrefixedMemCached` and `PrefixedRedisCache` add a prefix to
   distinguish sources on a shared cache.
-- `StatsCache`, `StatsMemCached` and `StatsRedisCache` add a `hits()` method
-  to report the cache hit rate.
+- `StatsCache`, `MemCached` and `RedisCache` add a `hits` method
+  to report the cache hit rate, `stats` to report statistics and
+  `reset` to reset statistics.
 - `LockedCache` use a (thread) lock to control cache accesses.
 - `TwoLevelCache` allows to combine two caches.
 - `DebugCache` to trace cache calls using `logging`.
@@ -90,6 +92,14 @@ with `cachetools`.
   function result is in cache, and to delete such an entry.
 - `cacheFunctions` and `cacheMethods`: add caching to functions or methods.
 
+## License
+
+This code is [Public Domain](https://creativecommons.org/publicdomain/zero/1.0/).
+
+All software has bug, this is software, hence… Beware that you may lose your
+hairs or your friends because of it. If you like it, feel free to send a
+postcard to the author.
+
 ## More
 
 See the
@@ -98,7 +108,3 @@ See the
 [issues](https://github.com/zx80/cachetools-utils/issues) on GitHub.
 
 See [packages](https://pypi.org/project/CacheToolsUtils/) on PyPI.
-
-## License
-
-This code is public domain.

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/README.md

@@ -7,7 +7,7 @@ Classes to add key prefix and stats to
 and other cache-related utils.
 
 ![Status](https://github.com/zx80/cachetools-utils/actions/workflows/cachetools-utils.yml/badge.svg?branch=main&style=flat)
-![Tests](https://img.shields.io/badge/tests-17%20✓-success)
+![Tests](https://img.shields.io/badge/tests-19%20✓-success)
 ![Coverage](https://img.shields.io/badge/coverage-100%25-success)
 ![Issues](https://img.shields.io/github/issues/zx80/cachetools-utils?style=flat)
 ![Python](https://img.shields.io/badge/python-3-informational)
@@ -31,12 +31,13 @@ with `cachetools`.
   class for Memcached.
 - `DictCache` a very simple `dict` cache.
 
-### Other wrappers to extend cache capabilities
+### Wrappers to extend cache capabilities
 
 - `PrefixedCache`, `PrefixedMemCached` and `PrefixedRedisCache` add a prefix to
   distinguish sources on a shared cache.
-- `StatsCache`, `StatsMemCached` and `StatsRedisCache` add a `hits()` method
-  to report the cache hit rate.
+- `StatsCache`, `MemCached` and `RedisCache` add a `hits` method
+  to report the cache hit rate, `stats` to report statistics and
+  `reset` to reset statistics.
 - `LockedCache` use a (thread) lock to control cache accesses.
 - `TwoLevelCache` allows to combine two caches.
 - `DebugCache` to trace cache calls using `logging`.
@@ -47,6 +48,14 @@ with `cachetools`.
   function result is in cache, and to delete such an entry.
 - `cacheFunctions` and `cacheMethods`: add caching to functions or methods.
 
+## License
+
+This code is [Public Domain](https://creativecommons.org/publicdomain/zero/1.0/).
+
+All software has bug, this is software, hence… Beware that you may lose your
+hairs or your friends because of it. If you like it, feel free to send a
+postcard to the author.
+
 ## More
 
 See the
@@ -55,7 +64,3 @@ See the
 [issues](https://github.com/zx80/cachetools-utils/issues) on GitHub.
 
 See [packages](https://pypi.org/project/CacheToolsUtils/) on PyPI.
-
-## License
-
-This code is public domain.

{CacheToolsUtils-8.5 → cachetoolsutils-9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "CacheToolsUtils"
-version = "8.5"
+version = "9.0"
 authors = [ { name = "Fabien Coelho", email = "cachetools.utils@coelho.net" } ]
 description = "Cachetools Utilities"
 readme = "README.md"
@@ -30,7 +30,7 @@ package = "https://pypi.org/project/CacheToolsUtils/"
 py-modules = [ "CacheToolsUtils" ]
 
 [project.optional-dependencies]
-dev = [ "mypy", "pyright", "black", "flake8", "pytest", "coverage", "pymarkdownlnt", "types-redis", "types-cachetools" ]
+dev = [ "mypy", "pyright", "black", "flake8", "ruff", "pytest", "coverage", "pymarkdownlnt", "types-redis", "types-cachetools" ]
 doc = [ "sphinx", "sphinx_rtd_theme", "sphinx-autoapi", "sphinx-lint", "myst_parser" ]
 tests = [ "pymemcache", "redis" ]
 pub = [ "build", "wheel", "twine" ]