pythonic-fp.splitends 2.0.3__py3-none-any.whl → 6.0.0__py3-none-any.whl

pythonic_fp/splitends/splitend.py

@@ -37,10 +37,12 @@ Class SplitEnds
 """
 
 from collections.abc import Callable, Iterator
-from typing import cast, Final, overload
+from typing import Final, cast, overload
+
 from pythonic_fp.gadgets.sentinels.flavored import Sentinel
-from pythonic_fp.iterables.folding import reduce_left, fold_left
+from pythonic_fp.iterables.folding import fold_left, reduce_left
 from pythonic_fp.queues.lifo import LIFOQueue
+
 from .splitend_node import SENode
 
 __all__ = ['SplitEnd']
@@ -52,7 +54,7 @@ _sentinel: Final[_Sentinel] = Sentinel(_secret_value)
 
 
 class SplitEnd[D]:
-    __slots__ = '_end', '_root', '_count'
+    __slots__ = '_count', '_end', '_root'
 
     def __init__(self, *ds: D, root: SENode[D] | _Sentinel = _sentinel) -> None:
         """
@@ -259,7 +261,7 @@ class SplitEnd[D]:
         """
         return self._root
 
-    def reroot(self, root: SENode[D]) -> 'SplitEnd[D]':
+    def reroot(self, root: SENode[D]) -> SplitEnd[D]:
         """
         .. admonition:: re-root SplitEnd
 
@@ -297,7 +299,7 @@ class SplitEnd[D]:
 
         return SplitEnd(*lifo, root = root)
 
-    def split(self, *ds: D) -> 'SplitEnd[D]':
+    def split(self, *ds: D) -> SplitEnd[D]:
         """
         .. admonition:: split
 

pythonic_fp/splitends/splitend_node.py

@@ -36,7 +36,8 @@
 """
 
 from collections.abc import Callable, Iterator
-from typing import cast, Final, overload, Self
+from typing import Final, Self, cast, overload
+
 from pythonic_fp.gadgets.sentinels.flavored import Sentinel
 
 __all__ = ['SENode']
@@ -106,9 +107,7 @@ class SENode[D]:
 
         if self._prev is not other._prev:
             return False
-        if self._data == other._data:
-            return True
-        return False
+        return self._data == other._data
 
     def data(self) -> D:
         """
@@ -119,7 +118,7 @@ class SENode[D]:
         """
         return self._data
 
-    def prev(self) -> Self:
+    def prev(self) -> SENode[D]:
         """
         .. admonition:: peak at previous node
 
@@ -128,7 +127,7 @@ class SENode[D]:
         """
         return self._prev
 
-    def both(self) -> tuple[D, Self]:
+    def both(self) -> tuple[D, SENode[D]]:
         """
         .. admonition:: both data and previous node
 

pythonic_fp_splitends-6.0.0.dist-info/METADATA

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: pythonic-fp-splitends
+Version: 6.0.0
+Summary: Mutable stack datastructures that can safely share data.
+Keywords: SplitEnd,lifo,stack
+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-fptools>=6.2,<7
+Requires-Dist: pythonic-fp-iterables>=6,<7
+Requires-Dist: pythonic-fp-queues>=6,<7
+Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-splitends/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://grscheller.github.io/pythonic-fp-splitends
+Project-URL: Homepage, https://grscheller.github.io/pythonic-fp
+Project-URL: Source, https://github.com/grscheller/pythonic-fp-splitends
+
+# Pythonic FP - SplitEnds
+
+Package Implementing a singularly linked LIFO queue called
+a `SplitEnd`. These data structures can safely share data nodes
+between themselves.
+
+PyPI project
+[pythonic-fp.splitends](https://pypi.org/project/pythonic-fp-splitends/).
+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-splitends).
+
+- each `SplitEnd` is a very simple stateful (mutable) LIFO stack
+- data can be "extended" to or "snipped" off of the end (tip)
+- the "root" value of a `SplitEnd` is fixed and cannot be "snipped"
+- different mutable split ends can safely share the same "tail"
+- each `SplitEnd` sees itself as a singularly linked list
+- bush-like datastructures can be formed using multiple `SplitEnds`
+- the ``SplitEnd`` copy method and ``len`` are O(1)
+- in boolean context returns true if the `SplitEnd` is not just a "root"
+
+## 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_splitends-6.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pythonic_fp/splitends/__init__.py,sha256=4em0AExIcd7slGzjUD5iUDiYVSHyrgQdqce0UosgBno,1893
+pythonic_fp/splitends/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pythonic_fp/splitends/splitend.py,sha256=SPuJsC4K0SQLImVklasr5YPQrpoNMU6Lx3_q_Y62mG8,10332
+pythonic_fp/splitends/splitend_node.py,sha256=glJ694I78DVsUI7lSwEdU7wM15_zIKUjaW6KJAOARp8,5108
+pythonic_fp_splitends-6.0.0.dist-info/licenses/LICENSE,sha256=IJMkVWQUVy-SonK6SMaMotDQ6Zb-lVi2bUTiGp1GUO8,10774
+pythonic_fp_splitends-6.0.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+pythonic_fp_splitends-6.0.0.dist-info/METADATA,sha256=oTyn0P96qcS11x65pFHQCAy5FEYVrS3ziVUvkOjPpEI,2266
+pythonic_fp_splitends-6.0.0.dist-info/RECORD,,

pythonic_fp/splitends/splitend.pyi

@@ -1,31 +0,0 @@
-from .splitend_node import SENode
-from collections.abc import Callable, Iterator
-from pythonic_fp.gadgets.sentinels.flavored import Sentinel
-from typing import overload
-
-__all__ = ['SplitEnd']
-
-type _SecretType = tuple[str, str, str]
-type _Sentinel = Sentinel[_SecretType]
-class SplitEnd[D]:
-    def __init__(self, *ds: D, root: SENode[D] | _Sentinel = ...) -> None: ...
-    def __iter__(self) -> Iterator[D]: ...
-    def __reversed__(self) -> Iterator[D]: ...
-    def __bool__(self) -> bool: ...
-    def __len__(self) -> int: ...
-    def __eq__(self, other: object) -> bool: ...
-    def cut(self, num: int | None = None) -> tuple[D, ...]: ...
-    def extend(self, *ds: D) -> None: ...
-    def peak(self) -> D: ...
-    def root(self) -> SENode[D]: ...
-    def reroot(self, root: SENode[D]) -> SplitEnd[D]: ...
-    def snip(self) -> D: ...
-    def split(self, *ds: D) -> SplitEnd[D]: ...
-    @overload
-    def fold[T](self, f: Callable[[D, D], D]) -> D: ...
-    @overload
-    def fold[T](self, f: Callable[[T, D], T], init: T) -> T: ...
-    @overload
-    def rev_fold[T](self, f: Callable[[D, D], D]) -> D: ...
-    @overload
-    def rev_fold[T](self, f: Callable[[T, D], T], init: T) -> T: ...

pythonic_fp/splitends/splitend_node.pyi

@@ -1,20 +0,0 @@
-from collections.abc import Callable, Iterator
-from pythonic_fp.gadgets.sentinels.flavored import Sentinel
-from typing import Self, overload
-
-__all__ = ['SENode']
-
-type _Sentinel = Sentinel[str]
-class SENode[D]:
-    def __init__(self, data: D, prev: Self | _Sentinel = ...) -> None: ...
-    def __bool__(self) -> bool: ...
-    def __iter__(self) -> Iterator[D]: ...
-    def __eq__(self, other: object) -> bool: ...
-    def both(self) -> tuple[D, Self]: ...
-    def data(self) -> D: ...
-    def prev(self) -> Self: ...
-    def push(self, data: D) -> Self: ...
-    @overload
-    def fold(self, f: Callable[[D, D], D]) -> D: ...
-    @overload
-    def fold[T](self, f: Callable[[T, D], T], init: T) -> T: ...

pythonic_fp_splitends-2.0.3.dist-info/METADATA

@@ -1,68 +0,0 @@
-Metadata-Version: 2.4
-Name: pythonic-fp-splitends
-Version: 2.0.3
-Summary: .. admonition:: Mutable stack objects that can safely share data
-Keywords: SplitEnd,lifo,stack
-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-fptools>=5.2.0
-Requires-Dist: pythonic-fp-iterables>=5.1.3
-Requires-Dist: pythonic-fp-queues>=5.1.1
-Requires-Dist: pytest>=8.4.1 ; extra == "test"
-Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-splitends/blob/main/CHANGELOG.rst
-Project-URL: Documentation, https://grscheller.github.io/pythonic-fp/projects/splitends.html
-Project-URL: Homepage, https://grscheller.github.io/pythonic-fp/
-Project-URL: Source, https://github.com/grscheller/pythonic-fp-splitends
-Provides-Extra: test
-
-Pythonic FP - SplitEnds
-=======================
-
-PyPI project
-`pythonic-fp.splitends
-<https://pypi.org/project/pythonic-fp-splitends/>`_.
-
-Python package Implementing a singularly linked LIFO queue called
-a ``SplitEnd``. These data structures can safely share data nodes
-between themselves.
-
-- each ``SplitEnd`` is a very simple stateful (mutable) LIFO stack
-- data can be "extended" to or "snipped" off of the end (tip)
-- the "root" value of a ``SplitEnd`` is fixed and cannot be "snipped"
-- different mutable split ends can safely share the same "tail"
-- each ``SplitEnd`` sees itself as a singularly linked list
-- bush-like datastructures can be formed using multiple ``SplitEnds``
-- the ``SplitEnd`` copy method and ``len`` are O(1)
-- in boolean context returns true if the ``SplitEnd`` is not just a "root"
-
-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/splitends.html>`_.
-
-Documentation for this project is hosted on
-`GitHub Pages
-<https://grscheller.github.io/pythonic-fp-splitends/development/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_splitends-2.0.3.dist-info/RECORD

@@ -1,11 +0,0 @@
-pythonic_fp/splitends/__init__.py,sha256=4em0AExIcd7slGzjUD5iUDiYVSHyrgQdqce0UosgBno,1893
-pythonic_fp/splitends/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonic_fp/splitends/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pythonic_fp/splitends/splitend.py,sha256=RFBsJcEh-NGRAtOizbYShNznseutIRoeOJbCeEJBxCM,10334
-pythonic_fp/splitends/splitend.pyi,sha256=OdTRATFXX5smbpwc8wm3gt4yyeTd_kN8VbMeNYl2Cho,1193
-pythonic_fp/splitends/splitend_node.py,sha256=E8MIZEDg6ZRY_0JfQnZyTD2Xek2JAg_epEu8sCzLadY,5139
-pythonic_fp/splitends/splitend_node.pyi,sha256=TozeGg4lmjMf0UPfZRTxRJR2kRpq0053VjbjIBUeosk,705
-pythonic_fp_splitends-2.0.3.dist-info/licenses/LICENSE,sha256=IJMkVWQUVy-SonK6SMaMotDQ6Zb-lVi2bUTiGp1GUO8,10774
-pythonic_fp_splitends-2.0.3.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pythonic_fp_splitends-2.0.3.dist-info/METADATA,sha256=PzPaGNd0cHqu3Ey8QRlUlC__RhQL3LRDLxT6mlKgzH8,2531
-pythonic_fp_splitends-2.0.3.dist-info/RECORD,,