CacheToolsUtils 8.4__py3-none-any.whl → 8.6__py3-none-any.whl

{CacheToolsUtils-8.4.dist-info → CacheToolsUtils-8.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CacheToolsUtils
-Version: 8.4
+Version: 8.6
 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'
@@ -90,6 +91,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 +107,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.6.dist-info/RECORD

@@ -0,0 +1,6 @@
+CacheToolsUtils.py,sha256=kqZNczVcgP_F8oioXBDCqEA5Ux9FovbO_VhlJ67pjiE,18135
+CacheToolsUtils-8.6.dist-info/LICENSE,sha256=y_yFW1bmBAUFCF-ZDyDiq10Ykns_19If5pFnZUzYgeU,33
+CacheToolsUtils-8.6.dist-info/METADATA,sha256=8L90Zezt3-y8LPTq4zHB8TIbjKvV0urezYd5LroZAJ4,4378
+CacheToolsUtils-8.6.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+CacheToolsUtils-8.6.dist-info/top_level.txt,sha256=qCyE4jGot5mOmvIQrZueCnPtbYtRe2hqke4sGojm3zI,16
+CacheToolsUtils-8.6.dist-info/RECORD,,

{CacheToolsUtils-8.4.dist-info → CacheToolsUtils-8.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: setuptools (72.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

CacheToolsUtils.py

@@ -2,7 +2,7 @@
 CacheTools Utilities. This code is public domain.
 """
 
-from typing import Any, Callable, MutableMapping as MutMap
+from typing import Any, Callable, MutableMapping
 import abc
 
 import cachetools
@@ -25,7 +25,7 @@ _NO_DEFAULT = object()
 class _MutMapMix:
     """Convenient MutableMapping Mixin, forward to _cache."""
 
-    _cache: MutMap
+    _cache: MutableMapping
 
     def __contains__(self, key):
         return self._cache.__contains__(key)
@@ -102,7 +102,7 @@ class _RedisMix:  # pragma: no cover
 # CACHETOOLS EXTENSIONS
 #
 
-class DebugCache:
+class DebugCache(MutableMapping):
     """Debug class.
 
     :param cache: actual cache
@@ -110,7 +110,7 @@ class DebugCache:
     :param name: name of instance for output
     """
 
-    def __init__(self, cache: MutMap, log: logging.Logger, name="cache"):
+    def __init__(self, cache: MutableMapping, log: logging.Logger, name="cache"):
         self._cache = cache
         self._log = log
         self._name = name
@@ -152,7 +152,7 @@ class DebugCache:
         return self._cache.reset()  # type: ignore
 
 
-class DictCache(_MutMapMix):
+class DictCache(_MutMapMix, MutableMapping):
     """Cache class based on dict."""
 
     def __init__(self):
@@ -162,7 +162,7 @@ class DictCache(_MutMapMix):
         self._cache.clear()
 
 
-class LockedCache(_MutMapMix, _StatsMix, _RedisMix, MutMap):
+class LockedCache(_MutMapMix, _StatsMix, _RedisMix, MutableMapping):
     """Cache class with a lock.
 
     :param cache: actual cache.
@@ -178,7 +178,7 @@ class LockedCache(_MutMapMix, _StatsMix, _RedisMix, MutMap):
        cache = ctu.LockedCache(ct.LFUCache(), threading.RLock())
     """
 
-    def __init__(self, cache: MutMap, lock):
+    def __init__(self, cache: MutableMapping, lock):
         self._cache = cache
         self._lock = lock
 
@@ -199,14 +199,14 @@ class LockedCache(_MutMapMix, _StatsMix, _RedisMix, MutMap):
             return self._cache.__delitem__(key)
 
 
-class PrefixedCache(_KeyMutMapMix, _StatsMix, MutMap):
+class PrefixedCache(_KeyMutMapMix, _StatsMix, MutableMapping):
     """Cache class to add a key prefix.
 
     :param cache: actual cache.
     :param prefix: prefix to prepend to keys.
     """
 
-    def __init__(self, cache: MutMap, prefix: str|bytes = ""):
+    def __init__(self, cache: MutableMapping, prefix: str|bytes = ""):
         self._prefix = prefix
         self._cache = cache
         # dynamic cast
@@ -220,7 +220,7 @@ class PrefixedCache(_KeyMutMapMix, _StatsMix, MutMap):
         return self._prefix + self._cast(key)  # type: ignore
 
 
-class StatsCache(_MutMapMix, MutMap):
+class StatsCache(_MutMapMix, MutableMapping):
     """Cache class to keep stats.
 
     :param cache: actual cache.
@@ -237,7 +237,7 @@ class StatsCache(_MutMapMix, MutMap):
     However, this only works for its own classes.
     """
 
-    def __init__(self, cache: MutMap):
+    def __init__(self, cache: MutableMapping):
         self._cache = cache
         self.reset()
 
@@ -267,7 +267,7 @@ class StatsCache(_MutMapMix, MutMap):
         return self._cache.clear()
 
 
-class TwoLevelCache(_MutMapMix, MutMap):
+class TwoLevelCache(_MutMapMix, MutableMapping):
     """Two-Level Cache class for CacheTools.
 
     :param cache: first (smaller, shorter TTL) cache
@@ -275,7 +275,7 @@ class TwoLevelCache(_MutMapMix, MutMap):
     :param resilient: whether to ignore cache2 failures
     """
 
-    def __init__(self, cache: MutMap, cache2: MutMap, resilient=False):
+    def __init__(self, cache: MutableMapping, cache2: MutableMapping, resilient=False):
         self._resilient = resilient
         self._cache = cache
         self._cache2 = cache2
@@ -370,10 +370,10 @@ def cached(cache, *args, **kwargs):
 
 
 # short generator type name
-MapGen = Callable[[MutMap, str], MutMap]
+MapGen = Callable[[MutableMapping, str], MutableMapping]
 
 
-def cacheMethods(cache: MutMap, obj: Any, gen: MapGen = PrefixedCache, **funs):
+def cacheMethods(cache: MutableMapping, obj: Any, gen: MapGen = PrefixedCache, **funs):
     """Cache some object methods.
 
     :param cache: cache to use.
@@ -394,7 +394,7 @@ def cacheMethods(cache: MutMap, obj: Any, gen: MapGen = PrefixedCache, **funs):
 
 
 def cacheFunctions(
-    cache: MutMap, globs: MutMap[str, Any], gen: MapGen = PrefixedCache, **funs
+    cache: MutableMapping, globs: MutableMapping[str, Any], gen: MapGen = PrefixedCache, **funs
 ):
     """Cache some global functions, with a prefix.
 
@@ -445,7 +445,7 @@ class JsonSerde:
             raise Exception("Unknown serialization format")
 
 
-class MemCached(_KeyMutMapMix, MutMap):
+class MemCached(_KeyMutMapMix, MutableMapping):
     """MemCached-compatible wrapper class for cachetools with key encoding.
 
     :param cache: actual memcached cache.
@@ -528,7 +528,7 @@ class StatsMemCached(MemCached):
 #
 
 
-class RedisCache(MutMap):
+class RedisCache(MutableMapping):
     """Redis TTL-ed wrapper for cachetools (``redis``).
 
     :param cache: actual redis cache.

CacheToolsUtils-8.4.dist-info/RECORD

@@ -1,6 +0,0 @@
-CacheToolsUtils.py,sha256=RisKLtsf49plnqP3XIb4TdqPuNPdseGmma9tyVRSjc0,17969
-CacheToolsUtils-8.4.dist-info/LICENSE,sha256=y_yFW1bmBAUFCF-ZDyDiq10Ykns_19If5pFnZUzYgeU,33
-CacheToolsUtils-8.4.dist-info/METADATA,sha256=RvB7NTOT_3y56aCF0BXpenPKFhRScFH3cjCMSXO2lTY,4110
-CacheToolsUtils-8.4.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-CacheToolsUtils-8.4.dist-info/top_level.txt,sha256=qCyE4jGot5mOmvIQrZueCnPtbYtRe2hqke4sGojm3zI,16
-CacheToolsUtils-8.4.dist-info/RECORD,,