CacheToolsUtils 9.0__py3-none-any.whl → 9.2__py3-none-any.whl

{CacheToolsUtils-9.0.dist-info → CacheToolsUtils-9.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: CacheToolsUtils
-Version: 9.0
+Version: 9.2
 Summary: Cachetools Utilities
 Author-email: Fabien Coelho <cachetools.utils@coelho.net>
 License: CC0
@@ -18,29 +18,29 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: cachetools
 Provides-Extra: dev
-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'
-Requires-Dist: types-redis ; extra == 'dev'
-Requires-Dist: types-cachetools ; extra == 'dev'
+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"
+Requires-Dist: types-redis; extra == "dev"
+Requires-Dist: types-cachetools; extra == "dev"
 Provides-Extra: doc
-Requires-Dist: sphinx ; extra == 'doc'
-Requires-Dist: sphinx-rtd-theme ; extra == 'doc'
-Requires-Dist: sphinx-autoapi ; extra == 'doc'
-Requires-Dist: sphinx-lint ; extra == 'doc'
-Requires-Dist: myst-parser ; extra == 'doc'
-Provides-Extra: pub
-Requires-Dist: build ; extra == 'pub'
-Requires-Dist: wheel ; extra == 'pub'
-Requires-Dist: twine ; extra == 'pub'
+Requires-Dist: sphinx; extra == "doc"
+Requires-Dist: sphinx_rtd_theme; extra == "doc"
+Requires-Dist: sphinx-autoapi; extra == "doc"
+Requires-Dist: sphinx-lint; extra == "doc"
+Requires-Dist: myst_parser; extra == "doc"
 Provides-Extra: tests
-Requires-Dist: pymemcache ; extra == 'tests'
-Requires-Dist: redis ; extra == 'tests'
+Requires-Dist: pymemcache; extra == "tests"
+Requires-Dist: redis; extra == "tests"
+Provides-Extra: pub
+Requires-Dist: build; extra == "pub"
+Requires-Dist: wheel; extra == "pub"
+Requires-Dist: twine; extra == "pub"
 
 # CacheToolsUtils
 
@@ -51,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-19%20✓-success)
+![Tests](https://img.shields.io/badge/tests-21%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)
@@ -91,6 +91,7 @@ with `cachetools`.
 - `cached` decorator: a cachetools replacement which allows to test if a
   function result is in cache, and to delete such an entry.
 - `cacheFunctions` and `cacheMethods`: add caching to functions or methods.
+- `json_key` and `hash_json_key`: JSON-based cache key serialization functions
 
 ## License
 

CacheToolsUtils-9.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+CacheToolsUtils.py,sha256=2IzulFpw9WH-7-aJs7cztR-NPdLH3TVMxN2eFyZXRc0,20350
+CacheToolsUtils-9.2.dist-info/LICENSE,sha256=y_yFW1bmBAUFCF-ZDyDiq10Ykns_19If5pFnZUzYgeU,33
+CacheToolsUtils-9.2.dist-info/METADATA,sha256=jWWKCdp-ShOLRzX4DvYVziFAVdh-JDPA_nvGxK7ZKnE,4483
+CacheToolsUtils-9.2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+CacheToolsUtils-9.2.dist-info/top_level.txt,sha256=qCyE4jGot5mOmvIQrZueCnPtbYtRe2hqke4sGojm3zI,16
+CacheToolsUtils-9.2.dist-info/RECORD,,

{CacheToolsUtils-9.0.dist-info → CacheToolsUtils-9.2.dist-info}/WHEEL

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

CacheToolsUtils.py

@@ -451,6 +451,42 @@ def cacheFunctions(
         globs[fun] = cached(cache=gen(cache, prefix))(f)
 
 
+# JSON-based key function
+# NOTE obviously this only works if parameters are json-serializable…
+def json_key(*args, **kwargs):
+    if kwargs:  # object
+        if args:
+            val = {"*": args, "**": kwargs}
+        else:
+            val = {"**": kwargs}
+    else:  # array
+        val = args
+    return json.dumps(val, sort_keys=True, separators=(",", ":"))
+
+
+# Hmmm…
+class _HashJsonKey:
+    """A cache key with a persistant hash value."""
+
+    def __init__(self, *args, **kwargs):
+        self._hashed = None
+        self._args = args
+        self._kwargs = kwargs
+        self._key = json_key(*args, **kwargs)
+
+    def __hash__(self):
+        if self._hashed is None:
+            self._hashed = self._key.__hash__()
+        return self._hashed
+
+    def __str__(self):
+        return self._key
+
+
+def hash_json_key(*args, **kwargs):
+    return _HashJsonKey(*args, **kwargs)
+
+
 #
 # MEMCACHED
 #

CacheToolsUtils-9.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-CacheToolsUtils.py,sha256=HSfiQx6NkUa0yWgyyj4j3eAMEA-QyLznrztd4QAKBtQ,19464
-CacheToolsUtils-9.0.dist-info/LICENSE,sha256=y_yFW1bmBAUFCF-ZDyDiq10Ykns_19If5pFnZUzYgeU,33
-CacheToolsUtils-9.0.dist-info/METADATA,sha256=MHZGUt_7_7ATiQn0ZetFecucS5Mjjs-dmqlJj3prots,4424
-CacheToolsUtils-9.0.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-CacheToolsUtils-9.0.dist-info/top_level.txt,sha256=qCyE4jGot5mOmvIQrZueCnPtbYtRe2hqke4sGojm3zI,16
-CacheToolsUtils-9.0.dist-info/RECORD,,