Change typing on CacheTransformer to reflect that mutation of kwargs shouldn't happen

Author: mikeshardmind

src/async_utils/__init__.py

@@ -9,7 +9,7 @@
 __author__ = "Michael Hall"
 __license__ = "Apache-2.0"
 __copyright__ = "Copyright 2020-Present Michael Hall"
-__version__ = "2025.07.07b"
+__version__ = "2025.07.08b"
 
 import os
 import sys

src/async_utils/_paramkey.py

@@ -14,7 +14,7 @@
 
 from __future__ import annotations
 
-from collections.abc import Hashable
+from collections.abc import Hashable, Mapping
 
 from . import _typings as t
 
@@ -40,7 +40,7 @@ def __eq__(self, other: object, /) -> bool:
 _marker: tuple[object] = (object(),)
 
 
-def make_key(args: tuple[t.Any, ...], kwds: dict[t.Any, t.Any], /) -> Hashable:
+def make_key(args: tuple[t.Any, ...], kwds: Mapping[t.Any, object], /) -> Hashable:
     key: tuple[t.Any, ...] = args
     if kwds:
         key += _marker

src/async_utils/corofunc_cache.py

@@ -16,7 +16,7 @@
 
 import asyncio
 import concurrent.futures as cf
-from collections.abc import Awaitable, Callable, Coroutine, Hashable
+from collections.abc import Awaitable, Callable, Coroutine, Hashable, Mapping
 from functools import partial, wraps
 
 from . import _typings as t
@@ -32,7 +32,7 @@
 #: rather than a ParamSpec of the decorated function.
 #: Warning: Mutations will impact callsite, return new objects as needed.
 type CacheTransformer = Callable[
-    [tuple[t.Any, ...], dict[str, t.Any]], tuple[tuple[t.Any, ...], dict[str, t.Any]]
+    [tuple[t.Any, ...], Mapping[str, t.Any]], tuple[tuple[t.Any, ...], Mapping[str, t.Any]]
 ]
 
 TYPE_CHECKING = False

src/async_utils/task_cache.py

@@ -16,7 +16,7 @@
 
 import asyncio
 import concurrent.futures as cf
-from collections.abc import Callable, Coroutine, Hashable
+from collections.abc import Callable, Coroutine, Hashable, Mapping
 from functools import partial, wraps
 
 from . import _typings as t
@@ -29,11 +29,11 @@
 type TaskFunc[**P, R] = Callable[P, asyncio.Task[R]]
 type TaskCoroFunc[**P, R] = CoroFunc[P, R] | TaskFunc[P, R]
 
-#: Note CacheTransformers recieve a tuple (args) and dict(kwargs)
+#: Note CacheTransformers recieve a tuple (args) and dict (kwargs)
 #: rather than a ParamSpec of the decorated function.
 #: Warning: Mutations will impact callsite, return new objects as needed.
 type CacheTransformer = Callable[
-    [tuple[t.Any, ...], dict[str, t.Any]], tuple[tuple[t.Any, ...], dict[str, t.Any]]
+    [tuple[t.Any, ...], Mapping[str, t.Any]], tuple[tuple[t.Any, ...], Mapping[str, t.Any]]
 ]
 
 TYPE_CHECKING = False