rediscache 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

rediscache/tools.py

@@ -0,0 +1,30 @@
+"""
+Extra tools provided to help with the cache main purpose.
+"""
+
+from functools import wraps
+from typing import Callable, ParamSpec, TypeVar
+
+P = ParamSpec("P")
+InT = TypeVar("InT")
+OutT = TypeVar("OutT")
+
+
+def decorate(transform: Callable[[InT], OutT]) -> Callable[[Callable[P, InT]], Callable[P, OutT]]:
+    """
+    This decorator helps to transform the output of a function from type InT to type OuT providing the
+    appropriate function.
+    It is especially meant to be used to serialize the output of a function to be cached.
+    It can also be used to deserialize the cached value, but this should be used with great caution
+    since it could be worse than not caching the function at all.
+    """
+
+    def decorator(function: Callable[P, InT]) -> Callable[P, OutT]:
+        @wraps(function)
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> OutT:
+            value = function(*args, **kwargs)
+            return transform(value)
+
+        return wrapper
+
+    return decorator

{rediscache-0.3.1.dist-info → rediscache-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: rediscache
-Version: 0.3.1
+Version: 0.3.2
 Summary: Redis caching of functions evolving over time
 Home-page: https://github.com/AmadeusITGroup/RedisCache
 License: MIT
@@ -158,6 +158,41 @@ def myfunc():
 print(myfunc.function())
 ```
 
+## The `decorate` decorator
+
+In the `tools` submodule, the `decorate` decorator is a little helper to transform a serializer or deserializer function into a decorator.
+The transformation function is expected to take a single argument of a certain type and transform it into another type.
+For example, a typical serializer would transform a dictionary into a string.
+
+```python
+from json import dumps
+
+from rediscache.tools import decorate
+
+@decorate(dumps)
+def myfunc():
+    return {"toto": 42}
+
+assert isinstance(myfunc(), str)
+```
+
+You may use partial functions if your transformation function requires extra parameters.
+
+```python
+from datetime import date
+from functools import partial
+from json import dumps
+
+from rediscache.tools import decorate
+
+@decorate(partial(dumps, skipkeys=True))
+def func_with_id():
+    """My func_with_id"""
+    return {"name": "Toto", "age": 25, date.today(): "today"}
+
+assert func_with_id() == '{"name": "Toto", "age": 25}'
+```
+
 ## Development
 
 ### Poetry

rediscache-0.3.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+rediscache/__init__.py,sha256=48eo_z_ohwxRYIeZxZTp373XxsCx6nEtC1EqE7FBfyk,14447
+rediscache/tools.py,sha256=0I4l2f-SKZR6ec5y-GJOMhLdWimPjs6gGzHtPdPdYpg,995
+rediscache-0.3.2.dist-info/LICENSE,sha256=glwtaJmUmkPhzLEfrVcc2JmLoCyTnHst84tadlSIK_8,1123
+rediscache-0.3.2.dist-info/METADATA,sha256=1wOtgyEM_4R1xti4LSA5sczhI6N1uoySIIl4-zkBi3k,9975
+rediscache-0.3.2.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+rediscache-0.3.2.dist-info/RECORD,,

rediscache-0.3.1.dist-info/RECORD

@@ -1,5 +0,0 @@
-rediscache/__init__.py,sha256=48eo_z_ohwxRYIeZxZTp373XxsCx6nEtC1EqE7FBfyk,14447
-rediscache-0.3.1.dist-info/LICENSE,sha256=glwtaJmUmkPhzLEfrVcc2JmLoCyTnHst84tadlSIK_8,1123
-rediscache-0.3.1.dist-info/METADATA,sha256=44jsqPxY_QU5S1WgVzatYwe2sRHNVlj6FInv8R9RLxU,9012
-rediscache-0.3.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-rediscache-0.3.1.dist-info/RECORD,,