dycw-utilities 0.124.0__tar.gz → 0.124.1__tar.gz

{dycw_utilities-0.124.0 → dycw_utilities-0.124.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.124.0
+Version: 0.124.1
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12
 Requires-Dist: typing-extensions<4.14,>=4.13.1
 Provides-Extra: test
-Requires-Dist: hypothesis<6.132,>=6.131.21; extra == 'test'
+Requires-Dist: hypothesis<6.132,>=6.131.24; extra == 'test'
 Requires-Dist: pytest-asyncio<0.27,>=0.26.0; extra == 'test'
 Requires-Dist: pytest-cov<6.2,>=6.1.1; extra == 'test'
 Requires-Dist: pytest-instafail<0.6,>=0.5.0; extra == 'test'
@@ -80,7 +80,7 @@ Provides-Extra: zzz-test-hypothesis
 Requires-Dist: aiosqlite<0.22,>=0.21.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: asyncpg<0.31,>=0.30.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: greenlet<3.3,>=3.2.0; extra == 'zzz-test-hypothesis'
-Requires-Dist: hypothesis<6.132,>=6.131.21; extra == 'zzz-test-hypothesis'
+Requires-Dist: hypothesis<6.132,>=6.131.24; extra == 'zzz-test-hypothesis'
 Requires-Dist: luigi<3.7,>=3.6.0; extra == 'zzz-test-hypothesis'
 Requires-Dist: numpy<2.3,>=2.2.6; extra == 'zzz-test-hypothesis'
 Requires-Dist: pathvalidate<3.3,>=3.2.3; extra == 'zzz-test-hypothesis'

{dycw_utilities-0.124.0 → dycw_utilities-0.124.1}/pyproject.toml

@@ -26,7 +26,7 @@ dev = [
   "fpdf2 >= 2.8.3, < 2.9",
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
   "httpx >= 0.28.1, < 0.29",  # for fastapi
-  "hypothesis >= 6.131.21, < 6.132",
+  "hypothesis >= 6.131.24, < 6.132",
   "img2pdf >= 0.6.0, < 0.7",
   "lightweight-charts >= 2.1, < 2.2",
   "loguru >= 0.7.3, < 0.8",
@@ -92,11 +92,11 @@ dependencies = [
 name = "dycw-utilities"
 readme = "README.md"
 requires-python = ">= 3.12"
-version = "0.124.0"
+version = "0.124.1"
 
 [project.optional-dependencies]
 test = [
-  "hypothesis >= 6.131.21, < 6.132",
+  "hypothesis >= 6.131.24, < 6.132",
   "pytest >= 8.3.5, < 8.4",
   "pytest-asyncio >= 0.26.0, < 0.27",
   "pytest-cov >= 6.1.1, < 6.2",
@@ -174,7 +174,7 @@ zzz-test-hypothesis = [
   "aiosqlite >= 0.21.0, < 0.22",
   "asyncpg >= 0.30.0, < 0.31",  # for sqlalchemy async
   "greenlet >= 3.2.0, < 3.3",  # for sqlalchemy async
-  "hypothesis >= 6.131.21, < 6.132",
+  "hypothesis >= 6.131.24, < 6.132",
   "luigi >= 3.6.0, < 3.7",
   "numpy >= 2.2.6, < 2.3",
   "pathvalidate >= 3.2.3, < 3.3",
@@ -334,7 +334,7 @@ zzz-test-zoneinfo = [
 # bump-my-version
 [tool.bumpversion]
 allow_dirty = true
-current_version = "0.124.0"
+current_version = "0.124.1"
 
 [[tool.bumpversion.files]]
 filename = "src/utilities/__init__.py"

{dycw_utilities-0.124.0 → dycw_utilities-0.124.1}/src/tests/test_more_itertools.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from collections.abc import Iterator
 from typing import TYPE_CHECKING, Any, ClassVar, TypeGuard
 
 from pytest import mark, param, raises
@@ -24,17 +25,45 @@ class TestBucketMapping:
     def test_main(self) -> None:
         mapping = bucket_mapping(self.iterable, lambda x: x[0])
         assert set(mapping) == {"a", "b", "c"}
+        for value in mapping.values():
+            assert isinstance(value, Iterator)
+            assert not isinstance(value, list)
         assert list(mapping["a"]) == ["a1", "a2"]
         assert list(mapping["b"]) == ["b1", "b2", "b3"]
         assert list(mapping["c"]) == ["c1", "c2"]
 
+    def test_transform(self) -> None:
+        mapping = bucket_mapping(
+            self.iterable, lambda x: x[0], transform=lambda x: int(x[-1])
+        )
+        assert set(mapping) == {"a", "b", "c"}
+        for value in mapping.values():
+            assert isinstance(value, Iterator)
+            assert not isinstance(value, list)
+        assert list(mapping["a"]) == [1, 2]
+        assert list(mapping["b"]) == [1, 2, 3]
+        assert list(mapping["c"]) == [1, 2]
+
     def test_list(self) -> None:
         mapping = bucket_mapping(self.iterable, lambda x: x[0], list=True)
         assert set(mapping) == {"a", "b", "c"}
+        for value in mapping.values():
+            assert isinstance(value, list)
         assert mapping["a"] == ["a1", "a2"]
         assert mapping["b"] == ["b1", "b2", "b3"]
         assert mapping["c"] == ["c1", "c2"]
 
+    def test_transform_and_list(self) -> None:
+        mapping = bucket_mapping(
+            self.iterable, lambda x: x[0], transform=lambda x: int(x[-1]), list=True
+        )
+        assert set(mapping) == {"a", "b", "c"}
+        for value in mapping.values():
+            assert isinstance(value, list)
+        assert mapping["a"] == [1, 2]
+        assert mapping["b"] == [1, 2, 3]
+        assert mapping["c"] == [1, 2]
+
 
 class TestPartitionList:
     def test_main(self) -> None:

{dycw_utilities-0.124.0 → dycw_utilities-0.124.1}/src/utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.124.0"
+__version__ = "0.124.1"

{dycw_utilities-0.124.0 → dycw_utilities-0.124.1}/src/utilities/more_itertools.py

@@ -37,25 +37,81 @@ _U = TypeVar("_U")
 
 @overload
 def bucket_mapping(
-    iterable: Iterable[_T], func: Callable[[_T], THashable], /, *, list: Literal[True]
+    iterable: Iterable[_T],
+    func: Callable[[_T], THashable],
+    /,
+    *,
+    transform: Callable[[_T], _U],
+    list: Literal[True],
+) -> Mapping[THashable, Sequence[_U]]: ...
+@overload
+def bucket_mapping(
+    iterable: Iterable[_T],
+    func: Callable[[_T], THashable],
+    /,
+    *,
+    transform: Callable[[_T], _U],
+    list: bool = False,
+) -> Mapping[THashable, Iterator[_U]]: ...
+@overload
+def bucket_mapping(
+    iterable: Iterable[_T],
+    func: Callable[[_T], THashable],
+    /,
+    *,
+    transform: Callable[[_T], _U] | None = None,
+    list: Literal[True],
 ) -> Mapping[THashable, Sequence[_T]]: ...
 @overload
 def bucket_mapping(
-    iterable: Iterable[_T], func: Callable[[_T], THashable], /, *, list: bool = False
+    iterable: Iterable[_T],
+    func: Callable[[_T], THashable],
+    /,
+    *,
+    transform: Callable[[_T], _U] | None = None,
+    list: bool = False,
 ) -> Mapping[THashable, Iterator[_T]]: ...
+@overload
+def bucket_mapping(
+    iterable: Iterable[_T],
+    func: Callable[[_T], THashable],
+    /,
+    *,
+    transform: Callable[[_T], _U] | None = None,
+    list: bool = False,
+) -> (
+    Mapping[THashable, Iterator[_T]]
+    | Mapping[THashable, Iterator[_U]]
+    | Mapping[THashable, Sequence[_T]]
+    | Mapping[THashable, Sequence[_U]]
+): ...
 def bucket_mapping(
     iterable: Iterable[_T],
     func: Callable[[_T], THashable],
     /,
     *,
+    transform: Callable[[_T], _U] | None = None,
     list: bool = False,  # noqa: A002
-) -> Mapping[THashable, Iterator[_T]] | Mapping[THashable, Sequence[_T]]:
+) -> (
+    Mapping[THashable, Iterator[_T]]
+    | Mapping[THashable, Iterator[_U]]
+    | Mapping[THashable, Sequence[_T]]
+    | Mapping[THashable, Sequence[_U]]
+):
     """Bucket the values of iterable into a mapping."""
     b = bucket(iterable, func)
     mapping = {key: b[key] for key in b}
-    if list:
-        return {key: builtins.list(value) for key, value in mapping.items()}
-    return mapping
+    match transform, list:
+        case None, False:
+            return mapping
+        case None, True:
+            return {k: builtins.list(v) for k, v in mapping.items()}
+        case _, False:
+            return {k: map(transform, v) for k, v in mapping.items()}
+        case _, True:
+            return {k: builtins.list(map(transform, v)) for k, v in mapping.items()}
+        case _ as never:
+            assert_never(never)
 
 
 ##