pythonic-fp-fptools 5.1.1__tar.gz → 5.2.0__tar.gz

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/CHANGELOG.rst

@@ -17,22 +17,38 @@ See `Semantic Versioning 2.0.0 <https://semver.org>`_.
 Releases and Important Milestones
 ---------------------------------
 
-5.1.0 - 2025-09-09
-~~~~~~~~~~~~~~~~~~
+PyPI 5.2.0 - 2026-01-13
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Added function.compose back on 2025-12-04. Docstring updates for Sphinx.
+
+PyPI 5.1.2 - 2025-09-28
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Patch bump for pythonic-fp PyPI coordinated release 3.3.3.
+
+PyPI 5.1.1 - 2025-09-09
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Spotted a dependency issue when pip installing repo.
+
+
+PyPI 5.1.0 - 2025-09-09
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Updated docstrings for new Sphinx docs structure. Probably just a PATCH release,
 made it a MINOR release due to introducing .pyi files.
 
 
-5.0.0 - 2025-08-02
-~~~~~~~~~~~~~~~~~~
+PyPI 5.0.0 - 2025-08-02
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Coordinated entire project pythonic-fp PyPI deployment.
 
 - moved maybe.py and xor.py from containers, renamed xor.py -> either.py.
 
-4.0.0 - 2025-07-13
-~~~~~~~~~~~~~~~~~~
+PyPI 4.0.0 - 2025-07-13
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Dropped developer status to Beta
 
@@ -42,15 +58,15 @@ Dropped developer status to Beta
 TODO: After next Boring Math (bm) deployment, I should be able to archive
 my dtools namespace repos
 
-3.0.0 - 2025-07-06
-~~~~~~~~~~~~~~~~~~
+PyPI 3.0.0 - 2025-07-06
+~~~~~~~~~~~~~~~~~~~~~~~
 
 First PyPI release as ``pythonic-fp.fptools``
 
 - dropping dtools namespace name because there is a repo by that name.
 
-2.0.0 - 2025-05-22
-~~~~~~~~~~~~~~~~~~
+PyPI 2.0.0 - 2025-05-22
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - Moved dtools.fp.err_handling to the dtools.containers PyPI project
 
@@ -60,8 +76,8 @@ First PyPI release as ``pythonic-fp.fptools``
 
     - will import dtools.fp.lazy directly for this functionality
 
-1.7.0 - 2025-04-22
-~~~~~~~~~~~~~~~~~~
+PyPI 1.7.0 - 2025-04-22
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Last PyPI release as dtools.fp
 
@@ -70,8 +86,8 @@ Last PyPI release as dtools.fp
 - docstring changes
 - pyproject.toml standardization
 
-1.6.1.0 - 2025-04-17
-~~~~~~~~~~~~~~~~~~~~
+PyPI 1.6.1.0 - 2025-04-17
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - MB.sequence and XOR.sequence now return a wrapped iterator
 
@@ -85,13 +101,13 @@ Last PyPI release as dtools.fp
 
 - Also noticed MB and XOR still have camelCase APIs
 
-1.6.0 - 2025-04-07
-~~~~~~~~~~~~~~~~~~
+PyPI 1.6.0 - 2025-04-07
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - typing improvements
 
-1.4.0 - 2025-03-16
-~~~~~~~~~~~~~~~~~~
+PyPI 1.4.0 - 2025-03-16
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - added two state changing methods to dtools.err_handling.MB
 
@@ -109,13 +125,13 @@ Last PyPI release as dtools.fp
 
     - avoid using these methods in pure code
 
-1.3.1 - 2025-02-05
-~~~~~~~~~~~~~~~~~~
+PyPI 1.3.1 - 2025-02-05
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - added class method sequence to class State
 
-1.3.0 - 2025-01-17
-~~~~~~~~~~~~~~~~~~
+PyPI 1.3.0 - 2025-01-17
+~~~~~~~~~~~~~~~~~~~~~~~
 
 First release as dtools.fp
 
@@ -124,25 +140,23 @@ Repo name changes.
 - GitHub: fp -> dtools-fp
 - PyPI: grscheller.fp -> dtools.fp
 
-1.2.0 - 2025-01-04
-~~~~~~~~~~~~~~~~~~
+PyPI 1.2.0 - 2025-01-04
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - added modules lazy and state
 - renamed flatmap methods to bind
 - minor MB and XOR updates/corrections
 
-1.1.0 - 2024-11-18
-~~~~~~~~~~~~~~~~~~
+PyPI 1.1.0 - 2024-11-18
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Added fp.function module.
 
 - combine and partially apply functions as first class objects
 - some tests may be lacking
 
-1.0.2.0 - 2024-10-20
-~~~~~~~~~~~~~~~~~~~~
-
-Development environment only.
+Version 1.0.2.0 - 2024-10-20 (Devel environment only)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - breaking API changes, next PyPI release will be 1.1.0.
 - renamed module ``nothingness`` to ``singletons``
@@ -158,16 +172,16 @@ Development environment only.
        
 - will redo docs in docs repo
 
-1.0.1 - 2024-10-20
-~~~~~~~~~~~~~~~~~~
+PyPI 1.0.1 - 2024-10-20
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - removed docs from repo
 - docs for all grscheller namespace projects maintained here
  
   - https://grscheller.github.io/grscheller-pypi-namespace-docs/
 
-1.0.0 - 2024-10-18
-~~~~~~~~~~~~~~~~~~
+PyPI 1.0.0 - 2024-10-18
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Decided to make this release first stable release.
 
@@ -177,33 +191,31 @@ Decided to make this release first stable release.
    
 - pytest improvements based on pytest documentation
 
-0.4.0 - 2024-10-03
-~~~~~~~~~~~~~~~~~~
+PyPI 0.4.0 - 2024-10-03
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Long overdue PyPI release.
 
-0.3.5.1 - 2024-10-03
-~~~~~~~~~~~~~~~~~~~~
-
-Development environment only.
+Version 0.3.5.1 - 2024-10-03 (Devel environment only)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-- New module ``grscheller.fp.nothingness`` for
+New module ``grscheller.fp.nothingness`` which contains
 
-  - Singleton ``noValue`` representing a missing value
+- Singleton ``noValue`` representing a missing value
 
-    - similar to ``None`` but while
+  - similar to ``None`` but while
 
-      - ``None`` represent "returned no values"
-      - ``noValue: _NoValue = _NoValue()`` represents an absent value
+    - ``None`` represent "returned no values"
+    - ``noValue: _NoValue = _NoValue()`` represents an absent value
 
-    - mostly used as an implementation detail
+  - mostly used as an implementation detail
 
-      - allows client code to use ``None`` as a sentinel value
+    - allows client code to use ``None`` as a sentinel value
 
-    - prefer class ``MB`` to represent a missing value in client code
+  - prefer class ``MB`` to represent a missing value in client code
 
-0.3.3 - 2024-08-25
-~~~~~~~~~~~~~~~~~~
+PyPI 0.3.3 - 2024-08-25
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - removed woException ``XOR`` method
 
@@ -214,23 +226,23 @@ Development environment only.
   - makeRight(self, right: R|Nada=nada) -> XOR\[L, R\]:
   - swapRight(self, right: R) -> XOR\[L, R\]:
 
-0.3.0 - 2024-08-17
-~~~~~~~~~~~~~~~~~~
+PyPI 0.3.0 - 2024-08-17
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Class Nothing re-added but renamed class Nada.
 
 Version grscheller.untyped.nothing for more strictly typed code.
 
-0.2.1 - 2024-07-26
-~~~~~~~~~~~~~~~~~~
+PyPI 0.2.1 - 2024-07-26
+~~~~~~~~~~~~~~~~~~~~~~~
 
 PyPI grscheller.fp package release v0.2.1
 
 - forgot to update README.md on last PyPI release
 - simplified README.md to help alleviate this mistake in the future
 
-0.2.0 - 2024-07-26
-~~~~~~~~~~~~~~~~~~
+PyPI 0.2.0 - 2024-07-26
+~~~~~~~~~~~~~~~~~~~~~~~
 
 - from last PyPI release
 
@@ -241,8 +253,8 @@ PyPI grscheller.fp package release v0.2.1
 
   - renamed ``fp.wo_exception`` to ``fp.woException``
 
-0.1.0 - 2024-07-11
-~~~~~~~~~~~~~~~~~~
+PyPI 0.1.0 - 2024-07-11
+~~~~~~~~~~~~~~~~~~~~~~~
 
 Initial PyPI release as grscheller.fp
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pythonic-fp-fptools
-Version: 5.1.1
+Version: 5.2.0
 Summary: Pythonic FP - Functional Programming Tools
 Keywords: either,fp,functional,functional programming,lazy,maybe,monad,non-strict
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
 Requires-Python: >=3.12
 Description-Content-Type: text/x-rst
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -14,14 +14,16 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: pythonic-fp-booleans>=1.1.1
-Requires-Dist: pythonic-fp-circulararray>=5.3.2
-Requires-Dist: pythonic-fp-sentinels>=2.1.0
+Requires-Dist: pythonic-fp-booleans>=2.1.1
+Requires-Dist: pythonic-fp-circulararray>=6.0.1
+Requires-Dist: pythonic-fp-gadgets>=4.0.2
 Requires-Dist: pytest>=8.4.1 ; extra == "test"
-Requires-Dist: pythonic-fp-containers>=3.0.0 ; extra == "test"
+Requires-Dist: pythonic-fp-containers>=4.0.1 ; extra == "test"
+Requires-Dist: pythonic-fp-iterables>=5.1.3 ; extra == "test"
+Requires-Dist: pythonic-fp-queues>=5.1.1 ; extra == "test"
 Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-fptools/blob/main/CHANGELOG.rst
-Project-URL: Documentation, https://grscheller.github.io/pythonic-fp/fptools/development/build/html/releases.html
-Project-URL: Homepage, https://github.com/grscheller/pythonic-fp/blob/main/README.md
+Project-URL: Documentation, https://grscheller.github.io/pythonic-fp/fptools/development/build/html/
+Project-URL: Homepage, https://grscheller.github.io/pythonic-fp/homepage/build/html/
 Project-URL: Source, https://github.com/grscheller/pythonic-fp-fptools
 Provides-Extra: test
 
@@ -49,16 +51,17 @@ endeavoring to be Pythonic.
 
     - the monad encapsulates a state transformation, not a "state"
 
-This PyPI project is part of the
-`pythonic-fp namespace projects
-<https://github.com/grscheller/pythonic-fp/blob/main/README.md>`_
+Part of the
+`pythonic-fp
+<https://grscheller.github.io/pythonic-fp>`_
+PyPI projects.
 
 Documentation
 -------------
 
 Documentation for this project is hosted on
 `GitHub Pages
-<https://grscheller.github.io/pythonic-fp/fptools/development/build/html>`_.
+<https://grscheller.github.io/pythonic-fp/fptools>`_.
 
 Copyright and License
 ---------------------

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/README.rst

@@ -22,16 +22,17 @@ endeavoring to be Pythonic.
 
     - the monad encapsulates a state transformation, not a "state"
 
-This PyPI project is part of the
-`pythonic-fp namespace projects
-<https://github.com/grscheller/pythonic-fp/blob/main/README.md>`_
+Part of the
+`pythonic-fp
+<https://grscheller.github.io/pythonic-fp>`_
+PyPI projects.
 
 Documentation
 -------------
 
 Documentation for this project is hosted on
 `GitHub Pages
-<https://grscheller.github.io/pythonic-fp/fptools/development/build/html>`_.
+<https://grscheller.github.io/pythonic-fp/fptools>`_.
 
 Copyright and License
 ---------------------

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pythonic-fp-fptools"
-version = "5.1.1"
+version = "5.2.0"
 readme = "README.rst"
 requires-python = ">=3.12"
 license = { file = "LICENSE" }
@@ -16,7 +16,7 @@ keywords = [
   "non-strict",
 ]
 classifiers = [
-  "Development Status :: 3 - Alpha",
+  "Development Status :: 4 - Beta",
   "Framework :: Pytest",
   "Intended Audience :: Developers",
   "License :: OSI Approved :: Apache Software License",
@@ -25,22 +25,24 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "pythonic-fp-booleans>=1.1.1",
-  "pythonic-fp-circulararray>=5.3.2",
-  "pythonic-fp-sentinels>=2.1.0",
+  "pythonic-fp-booleans>=2.1.1",
+  "pythonic-fp-circulararray>=6.0.1",
+  "pythonic-fp-gadgets>=4.0.2",
 ]
 dynamic = ["description"]
 
 [project.urls]
 Changelog = "https://github.com/grscheller/pythonic-fp-fptools/blob/main/CHANGELOG.rst"
-Documentation = "https://grscheller.github.io/pythonic-fp/fptools/development/build/html/releases.html"
-Homepage = "https://github.com/grscheller/pythonic-fp/blob/main/README.md"
+Documentation = "https://grscheller.github.io/pythonic-fp/fptools/development/build/html/"
+Homepage = "https://grscheller.github.io/pythonic-fp/homepage/build/html/"
 Source = "https://github.com/grscheller/pythonic-fp-fptools"
 
 [project.optional-dependencies]
 test = [
   "pytest>=8.4.1",
-  "pythonic-fp-containers>=3.0.0",
+  "pythonic-fp-containers>=4.0.1",
+  "pythonic-fp-iterables>=5.1.3",
+  "pythonic-fp-queues>=5.1.1",
 ]
 
 [build-system]

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/either.py

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__all__ = ['Either', 'LEFT', 'RIGHT']
+__all__ = ['Either', 'EitherBool', 'LEFT', 'RIGHT']
 
 from collections.abc import Callable, Iterator, Sequence
 from typing import cast, overload
@@ -21,6 +21,12 @@ from .maybe import MayBe
 
 
 class EitherBool(SBool):
+    """Boolean-like type used by Either constructor.
+
+    - A "truthy" value passed to constructor produces the unique ``LEFT`` value.
+    - A "falsy" value passed to constructor produces the unique ``RIGHT`` value.
+
+    """
     def __repr__(self) -> str:
         if self:
             return 'LEFT'
@@ -28,36 +34,38 @@ class EitherBool(SBool):
 
 
 LEFT = EitherBool(True)
+"""Singleton value signaling ``Either`` constructor to produce a ``LEFT`` Either, the default."""
+
 RIGHT = EitherBool(False)
+"""Singleton value signaling ``Either`` constructor to produce a ``RIGHT`` Either."""
 
 
 class Either[L, R]:
     """
-    Either Monad
-    ------------
+    .. admonition:: Either Monad
 
-    Data structure semantically containing either a left
-    or a right value, but not both.
+        Data structure semantically containing either a left
+        or a right value, but not both.
 
-    Implements a left biased Either Monad.
+        Implements a left biased Either Monad.
 
-    - ``Either(value: +L, LEFT)`` produces a left ``Either``
-    - ``Either(value: +L, RIGHT)`` produces a right ``Either``
+        - ``Either(value: +L, LEFT)`` produces a left ``Either``
+        - ``Either(value: +L, RIGHT)`` produces a right ``Either``
 
-    In a Boolean context
+        In a Boolean context
 
-    - A left ``Either`` is "truthy"
-    - A right ``Either`` is "falsy"
+        - A left ``Either`` is "truthy"
+        - A right ``Either`` is "falsy"
 
-    Two ``Either`` objects compare as equal when
+        Two ``Either`` objects compare as equal when
 
-    - both are left values or both are right values whose values
+        - both are left values or both are right values whose values
 
-      - are the same object
-      - compare as equal
+        - are the same object
+        - compare as equal
 
-    Immutable, an ``Either`` does not change after being created.
-    Therefore ``map`` & ``bind`` return new instances.
+        Immutable, an ``Either`` does not change after being created.
+        Therefore ``map`` & ``bind`` return new instances.
 
     .. warning::
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/either.pyi

@@ -4,7 +4,7 @@ from collections.abc import Callable, Iterator, Sequence
 from pythonic_fp.booleans.subtypable import SBool
 from typing import overload
 
-__all__ = ['Either', 'LEFT', 'RIGHT']
+__all__ = ['Either', 'EitherBool', 'LEFT', 'RIGHT']
 
 class EitherBool(SBool): ...
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/function.py

@@ -13,32 +13,28 @@
 # limitations under the License.
 
 """
-FP tools for functions
-======================
+.. admonition:: FP tools for functions
 
-FP utilities to manipulate and partially apply functions
+    FP utilities to manipulate and partially apply functions.
 
-- *function* **swap** - Swap the arguments of a 2 argument function
-- *function* **sequenced** - Convert function to take a sequence of its arguments
-- *function* **negate** - Transforms a predicate to its negation
-- *function* **partial** - Returns a partially applied function
+    - *function* **swap** - Swap the arguments of a 2 argument function
+    - *function* **compose** - Function composition
+    - *function* **negate** - Transforms a predicate to its negation
+    - *function* **sequenced** - Convert function to take a sequence of its arguments
+    - *function* **partial** - Returns a partially applied function
 
 """
 
 from collections.abc import Callable
 from typing import Any, ParamSpec
 
-__all__ = ['swap', 'sequenced', 'partial', 'negate']
+__all__ = ['swap', 'compose', 'negate', 'sequenced', 'partial']
 
 P = ParamSpec('P')
 
 
 def swap[U, V, R](f: Callable[[U, V], R]) -> Callable[[V, U], R]:
-    """
-    Swap args
-    ---------
-
-    Swap arguments of a two argument function.
+    """Swap arguments of a two argument function.
 
     :param f: Two argument function.
     :returns: A version of ``f`` with its arguments swapped.
@@ -47,17 +43,23 @@ def swap[U, V, R](f: Callable[[U, V], R]) -> Callable[[V, U], R]:
     return lambda v, u: f(u, v)
 
 
-def negate[**P](f: Callable[P, bool]) -> Callable[P, bool]:
+def compose[D, T, R](f: Callable[[D], T], g: Callable[[T], R]) -> Callable[[D], R]:
+    """Function Composition
+
+    :param f: Function called first with domain D and range T.
+    :param g: Function called on result with domain T and range R.
+    :returns: The composite function g∘f(d) = g(f(d))
+
     """
-    Negate predicate
-    ----------------
+    return lambda d: g(f(d))
+
 
-    Take a predicate and return its negation.
+def negate[**P](f: Callable[P, bool]) -> Callable[P, bool]:
+    """Take a predicate and return its negation.
 
     :param f: a function ``f`` which returns a bool
     :returns: the function ``not f``
     """
-
     def ff(*args: P.args, **kwargs: P.kwargs) -> bool:
         return not f(*args, **kwargs)
 
@@ -65,9 +67,7 @@ def negate[**P](f: Callable[P, bool]) -> Callable[P, bool]:
 
 
 def sequenced[R](f: Callable[..., R]) -> Callable[[tuple[Any]], R]:
-    """
-    Multi-to-single valued
-    ----------------------
+    """Convert a function from multi-to-single valued.
 
     Convert a function with arbitrary positional arguments to one taking
     a tuple of the original arguments.
@@ -80,7 +80,6 @@ def sequenced[R](f: Callable[..., R]) -> Callable[[tuple[Any]], R]:
     TODO: Look into replacing this function with a Callable class?
 
     """
-
     def ff(tupled_args: tuple[Any]) -> R:
         return f(*tupled_args)
 
@@ -88,9 +87,7 @@ def sequenced[R](f: Callable[..., R]) -> Callable[[tuple[Any]], R]:
 
 
 def partial[**P, R](f: Callable[P, R], *args: Any) -> Callable[..., R]:
-    """
-    Partial application
-    -------------------
+    """Partial function application.
 
     Partially apply arguments to a function, left to right.
 
@@ -98,7 +95,6 @@ def partial[**P, R](f: Callable[P, R], *args: Any) -> Callable[..., R]:
     - best practice is to cast the result immediately
 
     """
-
     def finish(*rest: Any) -> R:
         return sequenced(f)(args + rest)
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/function.pyi

@@ -1,11 +1,12 @@
 from collections.abc import Callable
 from typing import Any, ParamSpec
 
-__all__ = ['swap', 'sequenced', 'partial', 'negate']
+__all__ = ['swap', 'compose', 'negate', 'sequenced', 'partial']
 
 P = ParamSpec('P')
 
 def swap[U, V, R](f: Callable[[U, V], R]) -> Callable[[V, U], R]: ...
+def compose[D, T, R](f: Callable[[D], T], g: Callable[[T], R]) -> Callable[[D], R]: ...
 def negate[**P](f: Callable[P, bool]) -> Callable[P, bool]: ...
 def sequenced[R](f: Callable[..., R]) -> Callable[[tuple[Any]], R]: ...
 def partial[**P, R](f: Callable[P, R], *args: Any) -> Callable[..., R]: ...

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/lazy.py

@@ -13,17 +13,16 @@
 # limitations under the License.
 
 """
-Lazy function evaluation
-========================
+.. admonition:: Lazy function evaluation
 
-Delayed function evaluations. FP tools for "non-strict" function evaluations.
-Useful to delay a function's evaluation until some inner scope.
+    Delayed function evaluations. FP tools for "non-strict" function evaluations.
+    Useful to delay a function's evaluation until some inner scope.
 
-Non-strict delayed function evaluation.
+    Non-strict delayed function evaluation.
 
-- *class* **Lazy** - Delay evaluation of functions taking & returning single values
-- *function* **lazy** - Delay evaluation of functions taking any number of values
-- *function* **real_lazy** - Version of ``lazy`` which caches its result
+    - *class* **Lazy** - Delay evaluation of functions taking & returning single values
+    - *function* **lazy** - Delay evaluation of functions taking any number of values
+    - *function* **real_lazy** - Version of ``lazy`` which caches its result
 
 """
 
@@ -38,14 +37,13 @@ __all__ = ['Lazy', 'lazy', 'real_lazy']
 
 class Lazy[D, R]:
     """
-    Non-strict function evaluation
-    ------------------------------
+    .. admonition:: Non-strict function evaluation
 
-    Delayed evaluation of a singled valued function.
+        Delayed evaluation of a singled valued function.
 
-    Class instance delays the executable of a function where ``Lazy(f, arg)``
-    constructs an object that can evaluate the Callable ``f`` with its argument
-    at a later time.
+        Class instance delays the executable of a function where ``Lazy(f, arg)``
+        constructs an object that can evaluate the Callable ``f`` with its argument
+        at a later time.
 
     .. note::
 
@@ -153,11 +151,10 @@ def lazy[**P, R](
     f: Callable[P, R], *args: P.args, **kwargs: P.kwargs
 ) -> Lazy[tuple[Any, ...], R]:
     """
-    Delayed evaluations
-    -------------------
+    .. admonition:: Delayed evaluations
 
-    Function returning a delayed evaluation of a function of an arbitrary number
-    of positional arguments.
+        Function returning a delayed evaluation of a function of an arbitrary number
+        of positional arguments.
 
     :param f: Function whose evaluation is to be delayed.
     :param args: Positional arguments to be passed to ``f``.
@@ -172,11 +169,10 @@ def real_lazy[**P, R](
     f: Callable[P, R], *args: P.args, **kwargs: P.kwargs
 ) -> Lazy[tuple[Any, ...], R]:
     """
-    Cached Delayed evaluations
-    --------------------------
+    .. admonition:: Cached Delayed evaluations
 
-    Function returning a delayed evaluation of a function of an arbitrary number
-    of positional arguments. Evaluation is cached.
+        Function returning a delayed evaluation of a function of an
+        arbitrary number of positional arguments. Evaluation is cached.
 
     :param f: Function whose evaluation is to be delayed.
     :param args: Positional arguments to be passed to ``f``.

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/maybe.py

@@ -18,23 +18,22 @@ __all__ = ['MayBe']
 
 from collections.abc import Callable, Iterator, Sequence
 from typing import cast, Final, overload
-from pythonic_fp.sentinels.flavored import Sentinel
+from pythonic_fp.gadgets.sentinels.flavored import Sentinel
 
 
 class MayBe[D]:
     """
-    Maybe Monad
-    -----------
+    .. admonition:: Maybe Monad
 
-    Data structure wrapping a potentially missing item.
+        Data structure wrapping a potentially missing item.
 
-    Immutable semantics
+        Immutable semantics
 
-    - can store any item of any type, including ``None``
+        - can store any item of any type, including ``None``
 
-      - with one hidden implementation dependent exception
+        - with one hidden implementation dependent exception
 
-    - immutable semantics, therefore covariant
+        - immutable semantics
 
     .. warning::
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/src/pythonic_fp/fptools/state.py

@@ -20,17 +20,16 @@ from pythonic_fp.circulararray.auto import CA
 
 class State[S, A]:
     """
-    State Monad
-    -----------
+    .. admonition:: State Monad
 
-    Data structure generating values while propagating changes of state.
-    A pure FP implementation for the State Monad
+        Data structure generating values while propagating changes of state.
+        A pure FP implementation for the State Monad
 
-    - class ``State`` represents neither a state nor (value, state) pair
+        - class ``State`` represents neither a state nor a (value, state) pair
 
-      - it wraps a transformation old_state -> (value, new_state)
-      - the ``run`` method is this wrapped transformation
-      - ``bind`` is just state propagating function composition
+        - it wraps a transformation old_state -> (value, new_state)
+        - the ``run`` method is this wrapped transformation
+        - ``bind`` is just state propagating function composition
 
     """
 

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/tests/either/test_sequence_either.py

@@ -15,7 +15,7 @@
 from typing import Final
 from pythonic_fp.containers.functional_tuple import FTuple
 from pythonic_fp.fptools.either import Either, LEFT, RIGHT
-from pythonic_fp.containers.queues.fifo import FIFOQueue
+from pythonic_fp.queues.fifo import FIFOQueue
 
 
 class TestEitherSequence:

{pythonic_fp_fptools-5.1.1 → pythonic_fp_fptools-5.2.0}/tests/maybe/test_sequence_maybe.py

@@ -14,7 +14,7 @@
 
 from pythonic_fp.containers.functional_tuple import FTuple
 from pythonic_fp.fptools.maybe import MayBe
-from pythonic_fp.containers.queues.de import DEQueue, de_queue
+from pythonic_fp.queues.de import DEQueue, de_queue
 
 
 class Test_MB_sequence: