pythonic-fp-gadgets 2.2.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

pythonic_fp/gadgets/__init__.py

@@ -12,19 +12,21 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Simple Gadgets.
+"""
+Simple Gadgets
+==============
 
 Library of simple, but useful, functions and classes with minimal dependencies.
 
-+-------------------------------------+-----------------------------------+------------------------------+
-| Gadget                              | Description                       | Module                       |
-+=====================================+===================================+==============================+
-| class ``Box``                       | Single item box                   | ``pythonic_fp.gadgets.box``  |
-+-------------------------------------+-----------------------------------+------------------------------+
-| function ``it``                     | Returns iterator of its arguments | ``pythonic_fp.gadgets.it``   |
-+-------------------------------------+-----------------------------------+------------------------------+
-| function ``latest_common_ancestor`` | Find least common base class      | ``pythonic_fp.gadgets.lca``  |
-+-------------------------------------+-----------------------------------+------------------------------+
++------------------------------+------------------+------------------------------------------------+
+| Description                  | Gadget           | Module                                         |
++==============================+==================+================================================+
+| Single item box              | class ``Box``    | ``pythonic_fp.gadgets.box``                    |
++------------------------------+------------------+------------------------------------------------+
+| Return Iterator of arguments | function ``ita`` | ``pythonic_fp.gadgets.iterate_arguments``      |
++------------------------------+------------------+------------------------------------------------+
+| Find least common base class | function ``lca`` | ``pythonic_fp.gadgets.latest_common_ancestor`` |
++------------------------------+------------------+------------------------------------------------+
 
 """
 

pythonic_fp/gadgets/box.py

@@ -17,11 +17,9 @@
 __all__ = ['Box']
 
 from collections.abc import Callable, Iterator
-from typing import ClassVar, cast, Final, Never, overload, TypeVar
+from typing import ClassVar, cast, Final, overload
 from pythonic_fp.sentinels.flavored import Sentinel
 
-T = TypeVar('T')
-
 
 class Box[T]:
     """Container holding at most one item of a given type.
@@ -83,11 +81,11 @@ class Box[T]:
         return False
 
     @overload
-    def get(self) -> T | Never: ...
+    def get(self) -> T: ...
     @overload
     def get(self, alt: T) -> T: ...
 
-    def get(self, alt: T | Sentinel[str] = Sentinel('_Box')) -> T | Never:
+    def get(self, alt: T | Sentinel[str] = Sentinel('_Box')) -> T:
         """Return the contained item if it exists, otherwise an alternate item.
 
         :param alt: an "optional" item of type ``T`` to return if ``Box`` is empty
@@ -102,7 +100,7 @@ class Box[T]:
             raise ValueError(msg)
         return cast(T, alt)
 
-    def pop(self) -> T | Never:
+    def pop(self) -> T:
         """Pop the contained item if ``Box`` is not empty.
 
         :returns: item contained in the ``Box``
@@ -116,7 +114,7 @@ class Box[T]:
         self._item = self._sentinel
         return popped
 
-    def push(self, item: T) -> None | Never:
+    def push(self, item: T) -> None:
         """Push an item into an empty ``Box``.
 
         :param item: Item to push into the empty ``Box``.
@@ -134,7 +132,7 @@ class Box[T]:
         """Put an item in the Box. Discard any previous contents."""
         self._item = item
 
-    def exchange(self, new_item: T) -> T | Never:
+    def exchange(self, new_item: T) -> T:
         """Exchange an item with what is in the Box.
 
         :param ``new_item``: New item to exchange for current item.

pythonic_fp/gadgets/box.pyi

@@ -1,14 +1,11 @@
 from _typeshed import Incomplete
 from collections.abc import Callable, Iterator
-from typing import Never, TypeVar, overload
+from typing import overload
 
 __all__ = ['Box']
 
-T = TypeVar('T')
-
 class Box[T]:
     __match_args__: Incomplete
-    T = TypeVar('T')
     @overload
     def __init__(self) -> None: ...
     @overload
@@ -18,12 +15,12 @@ class Box[T]:
     def __len__(self) -> int: ...
     def __eq__(self, other: object) -> bool: ...
     @overload
-    def get(self) -> T | Never: ...
+    def get(self) -> T: ...
     @overload
     def get(self, alt: T) -> T: ...
-    def pop(self) -> T | Never: ...
-    def push(self, item: T) -> None | Never: ...
+    def pop(self) -> T: ...
+    def push(self, item: T) -> None: ...
     def put(self, item: T) -> None: ...
-    def exchange(self, new_item: T) -> T | Never: ...
+    def exchange(self, new_item: T) -> T: ...
     def map[U](self, f: Callable[[T], U]) -> Box[U]: ...
     def bind[U](self, f: Callable[[T], 'Box[U]']) -> Box[U]: ...

pythonic_fp/gadgets/{it.py → iterate_arguments.py}

@@ -16,10 +16,10 @@
 
 from collections.abc import Iterator
 
-__all__ = ['it']
+__all__ = ['ita']
 
 
-def it[A](*args: A) -> Iterator[A]:
+def ita[A](*args: A) -> Iterator[A]:
     """Function returning an iterator of its arguments.
 
     .. note::

pythonic_fp/gadgets/iterate_arguments.pyi

@@ -0,0 +1,5 @@
+from collections.abc import Iterator
+
+__all__ = ['ita']
+
+def ita[A](*args: A) -> Iterator[A]: ...

pythonic_fp/gadgets/{lca.py → latest_common_ancestor.py}

@@ -12,15 +12,14 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""Lastest Common Ancestor of Two Classes."""
+"""Last Common Ancestor of Two Classes."""
 
 from inspect import getmro
-from typing import Never
 
-__all__ = ['latest_common_ancestor']
+__all__ = ['lca']
 
 
-def latest_common_ancestor(cls1: type, cls2: type) -> type | Never:
+def lca(cls1: type, cls2: type) -> type:
     """Find the least upper bound in the inheritance graph
     of two classes.
 

pythonic_fp/gadgets/latest_common_ancestor.pyi

@@ -0,0 +1,3 @@
+__all__ = ['lca']
+
+def lca(cls1: type, cls2: type) -> type: ...

{pythonic_fp_gadgets-2.2.0.dist-info → pythonic_fp_gadgets-3.0.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: pythonic-fp-gadgets
-Version: 2.2.0
-Summary: Simple Gadgets.
+Version: 3.0.0
+Summary: Simple Gadgets
 Keywords: gadgets
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
 Requires-Python: >=3.13
@@ -26,7 +26,7 @@ Pythonic FP - Gadgets
 =====================
 
 PyPI project
-`pythonic-fp
+`pythonic-fp-gadgets
 <https://pypi.org/project/pythonic-fp>`_.
 
 Library of simple, but useful, data structures with minimal dependencies.

pythonic_fp_gadgets-3.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+pythonic_fp/gadgets/__init__.py,sha256=2nrTFkbHHW2ZbbEwmMypXrU5aO70JwLZrQt131pdF7E,1755
+pythonic_fp/gadgets/box.py,sha256=VR_MOCRDH5tyM6BaM7uFcHW-jKqDJlxfb_WbxKuZ6fs,5244
+pythonic_fp/gadgets/box.pyi,sha256=4TAYuLnnxzXsADX8JwblsH-020pYkXJRsPqeDqkK44Q,813
+pythonic_fp/gadgets/iterate_arguments.py,sha256=7gFQgqn8vpBQIxOPYlpAgW26Fyzfjnux3Y2cxHYZuSM,1057
+pythonic_fp/gadgets/iterate_arguments.pyi,sha256=BXyRZUTToIVQls9jpIbRGAtp8PCmZ-onJeKH29UzQkM,98
+pythonic_fp/gadgets/latest_common_ancestor.py,sha256=CHN5q82p8n05XPuA5rTq9gwtOkvuz9U-QMJEqOjlqqM,1689
+pythonic_fp/gadgets/latest_common_ancestor.pyi,sha256=dDta0kOY7T4mjPknJnMWDV9X4pveW4euxi_0V176hbc,64
+pythonic_fp/gadgets/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonic_fp_gadgets-3.0.0.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+pythonic_fp_gadgets-3.0.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+pythonic_fp_gadgets-3.0.0.dist-info/METADATA,sha256=uWPQwLeEFGtq5Mzsd2dpYd5FVcpDVr61aT33DTmnAYM,1828
+pythonic_fp_gadgets-3.0.0.dist-info/RECORD,,

pythonic_fp/gadgets/it.pyi

@@ -1,5 +0,0 @@
-from collections.abc import Iterator
-
-__all__ = ['it']
-
-def it[A](*args: A) -> Iterator[A]: ...

pythonic_fp/gadgets/lca.pyi

@@ -1,5 +0,0 @@
-from typing import Never
-
-__all__ = ['latest_common_ancestor']
-
-def latest_common_ancestor(cls1: type, cls2: type) -> type | Never: ...

pythonic_fp_gadgets-2.2.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-pythonic_fp/gadgets/__init__.py,sha256=lXVeP7kcS60TErlGUjUCfnZ8uWNF0FAoVTQ5dLHjOB0,1794
-pythonic_fp/gadgets/box.py,sha256=_3OA7Idvy7Oce3V8hp1pg8YSG7ch8kq36LVcU7OgHU8,5318
-pythonic_fp/gadgets/box.pyi,sha256=yap1syNrDMbO05bi8rltaKtaZssZrKdy7mQ1LXWKNt8,900
-pythonic_fp/gadgets/it.py,sha256=Zwk0ZE49sky_LRKwvzKjjv-_64cq7omVT1JZO5irxhI,1055
-pythonic_fp/gadgets/it.pyi,sha256=BI_0BuEd5lYSRhx591iUsQbfR2tSAcRiz5jn1Go4ASg,96
-pythonic_fp/gadgets/lca.py,sha256=I841udZLmm6WbF7SLI8xHzGCGUKM-QIp1bNHgGycklI,1763
-pythonic_fp/gadgets/lca.pyi,sha256=PYWPpmrM7238cpXmYyi5uPlSUsAiYVA0Chgq3VUUbyY,136
-pythonic_fp/gadgets/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonic_fp_gadgets-2.2.0.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
-pythonic_fp_gadgets-2.2.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pythonic_fp_gadgets-2.2.0.dist-info/METADATA,sha256=ys2SZaA5nNiMrLa_D2WW8uBv6AYXPXpdehJtvcTNbHo,1821
-pythonic_fp_gadgets-2.2.0.dist-info/RECORD,,