feat: field returns for mapping (#12)

* feat: field returns for mapping
* test: src test path

Signed-off-by: nstarman <nstarman@users.noreply.github.com>

pyproject.toml

@@ -76,7 +76,7 @@ filterwarnings = [
 ]
 log_cli_level = "INFO"
 testpaths = [
-  "tests",
+  "src", "tests",
 ]
 
 

src/dataclasstools/_ext.py

@@ -2,7 +2,7 @@
 
 __all__ = ["field_keys", "field_values", "field_items"]
 
-from collections.abc import Hashable, Iterator, Mapping
+from collections.abc import Hashable, ItemsView, Iterator, KeysView, Mapping, ValuesView
 from typing import Any, TypeVar
 
 from plum import dispatch
@@ -40,19 +40,19 @@ def field_keys(obj: Any, /) -> Iterator[str]:
 
 @dispatch  # type: ignore[no-redef]
 # TODO: def field_keys(obj: Mapping[K, V]) -> Iterator[K]:
-def field_keys(obj: Mapping[Hashable, Any]) -> Iterator[Hashable]:
+def field_keys(obj: Mapping[Hashable, Any]) -> KeysView[Hashable]:
     """Return the keys of a mapping.
 
     Examples
     --------
     >>> from dataclasstools import field_keys
 
     >>> p = {"a": 1, "b": 2.0, "c": "3"}
-    >>> list(field_keys(p))
-    ['a', 'b', 'c']
+    >>> field_keys(p)
+    dict_keys(['a', 'b', 'c'])
 
     """
-    yield from obj.keys()
+    return obj.keys()
 
 
 # ===================================================================
@@ -83,19 +83,19 @@ def field_values(obj: Any, /) -> Iterator[Any]:
 
 @dispatch  # type: ignore[no-redef]
 # TODO: def field_values(obj: Mapping[Any, V]) -> Iterator[V]:
-def field_values(obj: Mapping[Any, Any]) -> Iterator[Any]:
+def field_values(obj: Mapping[Any, Any]) -> ValuesView[Any]:
     """Return the values of a mapping.
 
     Examples
     --------
     >>> from dataclasstools import field_values
 
     >>> p = {"a": 1, "b": 2.0, "c": "3"}
-    >>> list(field_values(p))
-    [1, 2.0, '3']
+    >>> field_values(p)
+    dict_values([1, 2.0, '3'])
 
     """
-    yield from obj.values()
+    return obj.values()
 
 
 # ===================================================================
@@ -126,16 +126,16 @@ def field_items(obj: Any) -> Iterator[tuple[str, Any]]:
 
 @dispatch  # type: ignore[no-redef]
 # TODO: def field_items(obj: Mapping[K, V]) -> Iterator[tuple[K, V]]:
-def field_items(obj: Mapping[Any, Any]) -> Iterator[tuple[Any, Any]]:
+def field_items(obj: Mapping[Any, Any]) -> ItemsView[Any, Any]:
     """Return the items of a mapping.
 
     Examples
     --------
     >>> from dataclasstools import field_items
 
     >>> p = {"a": 1, "b": 2.0, "c": "3"}
-    >>> list(field_items(p))
-    [('a', 1), ('b', 2.0), ('c', '3')]
+    >>> field_items(p)
+    dict_items([('a', 1), ('b', 2.0), ('c', '3')])
 
     """
-    yield from obj.items()
+    return obj.items()