pythonic-fp.containers 4.1.0__py3-none-any.whl → 6.0.0__py3-none-any.whl

pythonic_fp/containers/functional_tuple.py

@@ -14,9 +14,10 @@
 # limitations under the License.
 
 from collections.abc import Callable, Iterator
-from typing import cast, Never, overload, SupportsIndex
+from typing import SupportsIndex, cast, overload
+
 from pythonic_fp.iterables.folding import accumulate
-from pythonic_fp.iterables.merging import blend, concat, MergeEnum
+from pythonic_fp.iterables.merging import MergeEnum, blend, concat
 
 __all__ = ['FTuple']
 
@@ -158,7 +159,7 @@ class FTuple[D](tuple[D, ...]):
             acc = f(v, acc)
         return acc
 
-    def copy(self) -> 'FTuple[D]':
+    def copy(self) -> FTuple[D]:
         """
         .. admonition:: copy
 
@@ -173,7 +174,13 @@ class FTuple[D](tuple[D, ...]):
     def __add__(self, other: object, /) -> tuple[D, ...]:
         if not isinstance(other, tuple):
             msg = 'FTuple being added to something not an FTuple'
-            raise ValueError(msg)
+            raise TypeError(msg)
+        return self.__class__(concat(self, other))
+
+    def __radd__(self, other: object, /) -> tuple[D, ...]:
+        if not isinstance(other, tuple):
+            msg = 'FTuple being added to something not an FTuple'
+            raise TypeError(msg)
         return self.__class__(concat(self, other))
 
     def __mul__(self, num: SupportsIndex) -> tuple[D, ...]:
@@ -184,7 +191,7 @@ class FTuple[D](tuple[D, ...]):
 
     def accummulate[L](
         self, f: Callable[[L, D], L], s: L | None = None, /
-    ) -> 'FTuple[L]':
+    ) -> FTuple[L]:
         """
         .. admonition:: accumulate partial folds
 
@@ -197,7 +204,7 @@ class FTuple[D](tuple[D, ...]):
             return FTuple(accumulate(self, f))
         return FTuple(accumulate(self, f, s))
 
-    def map[U](self, f: Callable[[D], U], /) -> 'FTuple[U]':
+    def map[U](self, f: Callable[[D], U], /) -> FTuple[U]:
         """
         .. admonition:: map
 
@@ -209,10 +216,10 @@ class FTuple[D](tuple[D, ...]):
 
     def bind[U](
         self,
-        f: 'Callable[[D], FTuple[U]]',
+        f: Callable[[D], FTuple[U]],
         merge_type: MergeEnum = MergeEnum.Concat,
         yield_partials: bool = False,
-    ) -> 'FTuple[U] | Never':
+    ) -> FTuple[U]:
         """
         .. admonition:: bind
 

pythonic_fp/containers/immutable_list.py

@@ -12,10 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from collections.abc import Callable, Iterable, Iterator, Hashable
-from typing import cast, Never, overload
+from collections.abc import Callable, Hashable, Iterable, Iterator
+from typing import cast, overload
+
 from pythonic_fp.iterables.folding import accumulate
-from pythonic_fp.iterables.merging import blend, concat, MergeEnum
+from pythonic_fp.iterables.merging import MergeEnum, blend, concat
 
 __all__ = ['IList']
 
@@ -34,7 +35,7 @@ class IList[D](Hashable):
 
     """
 
-    __slots__ = ('_ds', '_len', '_hash')
+    __slots__ = ('_ds', '_hash', '_len')
     __match_args__ = ('_ds', '_len')
 
     def __init__(self, *ds: Iterable[D]) -> None:
@@ -48,7 +49,7 @@ class IList[D](Hashable):
             msg = f'IList expects at most 1 iterable argument, got {size}'
             raise ValueError(msg)
         else:
-            self._ds: tuple[D, ...] = tuple(ds[0]) if size == 1 else tuple()
+            self._ds: tuple[D, ...] = tuple(ds[0]) if size == 1 else ()
             self._len = len(self._ds)
             try:
                 self._hash = hash((self._len, 42) + self._ds)
@@ -118,9 +119,9 @@ class IList[D](Hashable):
     @overload
     def __getitem__(self, idx: int, /) -> D: ...
     @overload
-    def __getitem__(self, idx: slice, /) -> 'IList[D]': ...
+    def __getitem__(self, idx: slice, /) -> IList[D]: ...
 
-    def __getitem__(self, idx: slice | int, /) -> 'IList[D] | D':
+    def __getitem__(self, idx: slice | int, /) -> IList[D] | D:
         """
         .. admonition:: getitem
 
@@ -222,7 +223,7 @@ class IList[D](Hashable):
             acc = f(v, acc)
         return acc
 
-    def __add__(self, other: 'IList[D]', /) -> 'IList[D]':
+    def __add__(self, other: IList[D], /) -> IList[D]:
         """
         .. admonition:: add by concatenation
 
@@ -237,11 +238,11 @@ class IList[D](Hashable):
         """
         if not isinstance(other, IList):
             msg = 'IList being added to something not an IList'
-            raise ValueError(msg)
+            raise TypeError(msg)
 
         return IList(concat(self, other))
 
-    def __mul__(self, num: int, /) -> 'IList[D]':
+    def __mul__(self, num: int, /) -> IList[D]:
         """
         .. admonition:: add by concatenation
 
@@ -255,9 +256,9 @@ class IList[D](Hashable):
                 Maybe define a "column vector" version?
 
         """
-        return IList(self._ds.__mul__(num if num > 0 else 0))
+        return IList(self._ds.__mul__(max(0, num)))
 
-    def __rmul__(self, num: int, /) -> 'IList[D]':
+    def __rmul__(self, num: int, /) -> IList[D]:
         """
         .. admonition:: concatenation with itself
 
@@ -267,11 +268,11 @@ class IList[D](Hashable):
             :raises ValueError: When ``other`` is not an ``IList``.
 
         """
-        return IList(self._ds.__mul__(num if num > 0 else 0))
+        return IList(self._ds.__mul__(max(0, num)))
 
     def accummulate[L](
         self, f: Callable[[L, D], L], s: L | None = None, /
-    ) -> 'IList[L]':
+    ) -> IList[L]:
         """
         .. admonition:: accumulate partial folds
 
@@ -287,7 +288,7 @@ class IList[D](Hashable):
             return IList(accumulate(self, f))
         return IList(accumulate(self, f, s))
 
-    def map[U](self, f: Callable[[D], U], /) -> 'IList[U]':
+    def map[U](self, f: Callable[[D], U], /) -> IList[U]:
         """
         .. admonition:: map
 
@@ -299,10 +300,10 @@ class IList[D](Hashable):
 
     def bind[U](
         self,
-        f: 'Callable[[D], IList[U]]',
+        f: Callable[[D], IList[U]],
         merge_enum: MergeEnum = MergeEnum.Concat,
         yield_partials: bool = False,
-    ) -> 'IList[U] | Never':
+    ) -> IList[U]:
         """
         .. admonition:: bind
 

pythonic_fp_containers-6.0.0.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: pythonic-fp-containers
+Version: 6.0.0
+Summary: Containers with FP interfaces.
+Keywords: functional_containers,functional_tuple,immutable_list
+Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+License-File: LICENSE
+Requires-Dist: pythonic-fp-circulararray>=6.4,<7
+Requires-Dist: pythonic-fp-fptools>=6.2,<7
+Requires-Dist: pythonic-fp-iterables>=6,<7
+Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-containers/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://grscheller.github.io/pythonic-fp-containers
+Project-URL: Homepage, https://grscheller.github.io/pythonic-fp
+Project-URL: Source, https://github.com/grscheller/pythonic-fp-containers
+
+# Pythonic FP - Containers
+
+Python package for containers of like data structures with functional
+programming inspired tweaks.
+
+PyPI project
+[pythonic-fp-containers](https://pypi.org/project/pythonic-fp-containers).
+Part of the
+[pythonic-fp](https://grscheller.github.io/pythonic-fp)
+PyPI projects.
+
+## Documentation
+
+Documentation and other links for this project are hosted on
+[GitHub Pages](https://grscheller.github.io/pythonic-fp-containers).
+
+| module | class | name |
+|:------ |:-----:|:---- |
+| pythonic_fp.containers.functional_tuple | FTuple | Functional Tuple |
+| pythonic_fp.containers.immutable_list | IList | Immutable List |
+
+## Copyright and License
+
+Copyright (c) 2023-2026 Geoffrey R. Scheller. Licensed under the Apache
+License, Version 2.0. See the LICENSE file for details.
+

pythonic_fp_containers-6.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pythonic_fp/containers/__init__.py,sha256=J1UvKHza0iDCR1GrVSUeps5LHsPc56xISvkbnGXOJtA,1034
+pythonic_fp/containers/functional_tuple.py,sha256=tIfCjildvY-WZctFq-zpwHABbUnHffoo7aw6lZY8BIk,7724
+pythonic_fp/containers/immutable_list.py,sha256=9IJfUQ0dqOzNQ5U06acN69kyl5qaUl5upeHdYhjEWBg,9736
+pythonic_fp/containers/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonic_fp_containers-6.0.0.dist-info/licenses/LICENSE,sha256=IJMkVWQUVy-SonK6SMaMotDQ6Zb-lVi2bUTiGp1GUO8,10774
+pythonic_fp_containers-6.0.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+pythonic_fp_containers-6.0.0.dist-info/METADATA,sha256=IX9TGjaaRMa1iCdugL1JI5HxSZG7pEasS9vun0r6Ie8,1927
+pythonic_fp_containers-6.0.0.dist-info/RECORD,,

pythonic_fp/containers/functional_tuple.pyi

@@ -1,22 +0,0 @@
-from collections.abc import Callable, Iterator
-from pythonic_fp.iterables.merging import MergeEnum
-from typing import Never, SupportsIndex, overload
-
-__all__ = ['FTuple']
-
-class FTuple[D](tuple[D, ...]):
-    def __reversed__(self) -> Iterator[D]: ...
-    def __eq__(self, other: object) -> bool: ...
-    @overload
-    def __getitem__(self, idx: SupportsIndex) -> D: ...
-    @overload
-    def __getitem__(self, idx: slice) -> tuple[D, ...]: ...
-    def foldl[L](self, f: Callable[[L, D], L], /, start: L | None = None, default: L | None = None) -> L: ...
-    def foldr[R](self, f: Callable[[D, R], R], /, start: R | None = None, default: R | None = None) -> R: ...
-    def copy(self) -> FTuple[D]: ...
-    def __add__(self, other: object) -> tuple[D, ...]: ...
-    def __mul__(self, num: SupportsIndex) -> tuple[D, ...]: ...
-    def __rmul__(self, num: SupportsIndex) -> tuple[D, ...]: ...
-    def accummulate[L](self, f: Callable[[L, D], L], s: L | None = None, /) -> FTuple[L]: ...
-    def map[U](self, f: Callable[[D], U], /) -> FTuple[U]: ...
-    def bind[U](self, f: Callable[[D], FTuple[U]], merge_type: MergeEnum = ..., yield_partials: bool = False) -> FTuple[U] | Never: ...

pythonic_fp/containers/immutable_list.pyi

@@ -1,28 +0,0 @@
-from _typeshed import Incomplete
-from collections.abc import Callable, Hashable, Iterable, Iterator
-from pythonic_fp.iterables.merging import MergeEnum
-from typing import Never, overload
-
-__all__ = ['IList']
-
-class IList[D](Hashable):
-    __match_args__: Incomplete
-    def __init__(self, *ds: Iterable[D]) -> None: ...
-    def __hash__(self) -> int: ...
-    def __iter__(self) -> Iterator[D]: ...
-    def __reversed__(self) -> Iterator[D]: ...
-    def __bool__(self) -> bool: ...
-    def __len__(self) -> int: ...
-    def __eq__(self, other: object) -> bool: ...
-    @overload
-    def __getitem__(self, idx: int) -> D: ...
-    @overload
-    def __getitem__(self, idx: slice) -> IList[D]: ...
-    def foldl[L](self, f: Callable[[L, D], L], /, start: L | None = None, default: L | None = None) -> L | None: ...
-    def foldr[R](self, f: Callable[[D, R], R], /, start: R | None = None, default: R | None = None) -> R | None: ...
-    def __add__(self, other: IList[D]) -> IList[D]: ...
-    def __mul__(self, num: int) -> IList[D]: ...
-    def __rmul__(self, num: int) -> IList[D]: ...
-    def accummulate[L](self, f: Callable[[L, D], L], s: L | None = None, /) -> IList[L]: ...
-    def map[U](self, f: Callable[[D], U], /) -> IList[U]: ...
-    def bind[U](self, f: Callable[[D], IList[U]], merge_enum: MergeEnum = ..., yield_partials: bool = False) -> IList[U] | Never: ...

pythonic_fp_containers-4.1.0.dist-info/METADATA

@@ -1,62 +0,0 @@
-Metadata-Version: 2.4
-Name: pythonic-fp-containers
-Version: 4.1.0
-Summary: Containers with FP interfaces
-Keywords: functional_containers,functional_tuple,immutable_list
-Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
-Requires-Python: >=3.13
-Description-Content-Type: text/x-rst
-Classifier: Development Status :: 3 - Alpha
-Classifier: Framework :: Pytest
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Typing :: Typed
-License-File: LICENSE
-Requires-Dist: pythonic-fp-circulararray>=6.0.4
-Requires-Dist: pythonic-fp-fptools>=5.2.0
-Requires-Dist: pythonic-fp-iterables>=5.1.3
-Requires-Dist: pytest>=8.4.1 ; extra == "test"
-Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-containers/blob/main/CHANGELOG.rst
-Project-URL: Documentation, https://grscheller.github.io/pythonic-fp/projects/containers.html
-Project-URL: Homepage, https://grscheller.github.io/pythonic-fp/
-Project-URL: Source, https://github.com/grscheller/pythonic-fp-containers
-Provides-Extra: test
-
-Pythonic FP - Containers
-========================
-
-PyPI project
-`pythonic-fp-containers
-<https://pypi.org/project/pythonic-fp-containers>`_.
-
-Python package of container like data structures with functional
-programming inspired tweaks.
-
-+---------------------------------------------+-----------+------------------+
-| module                                      | class     | name             |
-+=============================================+===========+==================+
-| ``pythonic_fp.containers.functional_tuple`` | FTuple    | Functional Tuple |
-+---------------------------------------------+-----------+------------------+
-| ``pythonic_fp.containers.immutable_list``   | IList     | Immutable List   |
-+---------------------------------------------+-----------+------------------+
-
-Part of the
-`pythonic-fp
-<https://grscheller.github.io/pythonic-fp/>`_
-PyPI projects.
-
-Documentation
--------------
-
-Documentation and other links for this project are hosted on
-`GitHub Pages
-<https://grscheller.github.io/pythonic-fp/projects/containers.html>`_.
-
-Copyright and License
----------------------
-
-Copyright (c) 2023-2026 Geoffrey R. Scheller. Licensed under the Apache
-License, Version 2.0. See the LICENSE file for details.
-

pythonic_fp_containers-4.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-pythonic_fp/containers/__init__.py,sha256=J1UvKHza0iDCR1GrVSUeps5LHsPc56xISvkbnGXOJtA,1034
-pythonic_fp/containers/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonic_fp/containers/functional_tuple.py,sha256=3Vdg3Fri5wGDdWv4bomS7xqWLy0B_eMQuXojZhgvKYM,7498
-pythonic_fp/containers/functional_tuple.pyi,sha256=g8IvlIhPxecEsetEexZ7WmN9Ifdh-vAeK0z9SwLiCGE,1182
-pythonic_fp/containers/immutable_list.py,sha256=9qtSF5R7O2f-Dzji2G11CneC0BTrk3WA5EV3z2sdnms,9796
-pythonic_fp/containers/immutable_list.pyi,sha256=1p7w7FP-OpCHvCBJIlztoP_uUoZIoj9uI_XGKEib-kU,1371
-pythonic_fp/containers/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonic_fp_containers-4.1.0.dist-info/licenses/LICENSE,sha256=IJMkVWQUVy-SonK6SMaMotDQ6Zb-lVi2bUTiGp1GUO8,10774
-pythonic_fp_containers-4.1.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pythonic_fp_containers-4.1.0.dist-info/METADATA,sha256=I5j_6Nc6ykHEfx6ThA1S9x3ifqyHyYxdktbMw5wNr_w,2387
-pythonic_fp_containers-4.1.0.dist-info/RECORD,,