pythonic-fp-booleans 2.0.0__tar.gz → 3.0.0__tar.gz

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/CHANGELOG.rst

@@ -17,6 +17,17 @@ See `Semantic Versioning 2.0.0 <https://semver.org>`_.
 Releases and Important Milestones
 ---------------------------------
 
+PyPI 2.2.0 - 2025-12-02
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Docstring updates.
+
+PyPI 2.1.0 - 2025-12-02
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Now requires pythonic-fp-gadgets 4.0.1 to be installed.
+
+
 PyPI 2.0.0 - 2025-09-27
 ~~~~~~~~~~~~~~~~~~~~~~~
 

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonic-fp-booleans
-Version: 2.0.0
+Version: 3.0.0
 Summary: Subtypable Boolean Class Hierarchy
 Keywords: booleans,subtypable
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: pythonic-fp-gadgets>=3.1.0
+Requires-Dist: pythonic-fp-gadgets>=4.0.2
 Requires-Dist: pytest>=8.4.1 ; extra == "test"
 Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-booleans/blob/main/CHANGELOG.rst
 Project-URL: Documentation, https://grscheller.github.io/pythonic-fp/booleans/development/build/html/
@@ -31,12 +31,12 @@ PyPI project
 
 Subtypable Boolean like classes.
 
-While still compatible with Python shortcut logic, these classes can be non-shortcut logically
-composed with Python’s bitwise operators.
+While still compatible with Python shortcut logic, these singleton classes
+can be non-shortcut logically composed with Python’s bitwise operators.
 
 Part of the
 `pythonic-fp
-<https://grscheller.github.io/pythonic-fp/homepage/build/html/index.html>`_
+<https://grscheller.github.io/pythonic-fp>`_
 PyPI projects.
 
 Documentation
@@ -44,11 +44,11 @@ Documentation
 
 Documentation for this project is hosted on
 `GitHub Pages
-<https://grscheller.github.io/pythonic-fp/booleans/development/build/html>`_.
+<https://grscheller.github.io/pythonic-fp/booleans>`_.
 
 Copyright and License
 ---------------------
 
-Copyright (c) 2025 Geoffrey R. Scheller. Licensed under the Apache
+Copyright (c) 2025-2026 Geoffrey R. Scheller. Licensed under the Apache
 License, Version 2.0. See the LICENSE file for details.
 

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/README.rst

@@ -7,12 +7,12 @@ PyPI project
 
 Subtypable Boolean like classes.
 
-While still compatible with Python shortcut logic, these classes can be non-shortcut logically
-composed with Python’s bitwise operators.
+While still compatible with Python shortcut logic, these singleton classes
+can be non-shortcut logically composed with Python’s bitwise operators.
 
 Part of the
 `pythonic-fp
-<https://grscheller.github.io/pythonic-fp/homepage/build/html/index.html>`_
+<https://grscheller.github.io/pythonic-fp>`_
 PyPI projects.
 
 Documentation
@@ -20,10 +20,10 @@ Documentation
 
 Documentation for this project is hosted on
 `GitHub Pages
-<https://grscheller.github.io/pythonic-fp/booleans/development/build/html>`_.
+<https://grscheller.github.io/pythonic-fp/booleans>`_.
 
 Copyright and License
 ---------------------
 
-Copyright (c) 2025 Geoffrey R. Scheller. Licensed under the Apache
+Copyright (c) 2025-2026 Geoffrey R. Scheller. Licensed under the Apache
 License, Version 2.0. See the LICENSE file for details.

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pythonic-fp-booleans"
-version = "2.0.0"
+version = "3.0.0"
 readme = "README.rst"
 requires-python = ">=3.13"
 license = { file = "LICENSE" }
@@ -19,7 +19,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "pythonic-fp-gadgets>=3.1.0",
+  "pythonic-fp-gadgets>=4.0.2",
 ]
 dynamic = ["description"]
 

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/src/pythonic_fp/booleans/__init__.py

@@ -35,8 +35,9 @@ Subtypable Boolean Class Hierarchy
 While still compatible with Python shortcut logic, ``SBool`` and its
 subclasses can be non-shortcut logically composed with Python's bitwise
 operators.
+
 """
 
 __author__ = 'Geoffrey R. Scheller'
-__copyright__ = 'Copyright (c) 2025 Geoffrey R. Scheller'
+__copyright__ = 'Copyright (c) 2025-2026 Geoffrey R. Scheller'
 __license__ = 'Apache License 2.0'

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/src/pythonic_fp/booleans/flavored.py

@@ -13,28 +13,29 @@
 # limitations under the License.
 
 """
-**Class F_Bool.**
+.. admonition:: Class Favored Booleans: ``F_Bool``.
 
-When different flavors of the truth matter. Each ``FBool`` is
-an ``SBool`` subtype corresponds to a hashable value
-called its flavor.
+    When different flavors of the truth matter. Each ``FBool`` is
+    an ``SBool`` subtype corresponds to a hashable value
+    called its flavor.
 
-.. warning::
-    
-    Combining ``FBool`` instances of different flavors
-    with bitwise operators will just result in an ``SBool``.
+    .. warning::
+        
+        Combining ``FBool`` instances of different flavors
+        with bitwise operators will just result in an ``SBool``.
 
 ----
 
-**Function truthy(flavor: Hashable)**
+.. admonition:: Function truthy: ``truthy(flavor: Hashable)``.
 
-Returns the truthy ``FBool`` of a particular ``flavor``.
+    Returns the truthy singleton ``FBool`` of a particular ``flavor``.
 
 ----
 
-**Function falsy(flavor: Hashable)**
+.. admonition:: Function falsy: ``falsy(flavor: Hashable)``.
+
+    Returns the falsy singleton ``FBool`` of a particular ``flavor``.
 
-Returns the falsy ``FBool`` of a particular ``flavor``.
 """
 
 import threading

pythonic_fp_booleans-3.0.0/src/pythonic_fp/booleans/flavored.pyi

@@ -0,0 +1,19 @@
+from .subtypable import SBool
+from collections.abc import Hashable
+
+__all__ = ['FBool', 'truthy', 'falsy']
+
+class FBool(SBool):
+    def __new__(cls, witness: object, flavor: Hashable) -> FBool: ...
+    def __init__(self, witness: object, flavor: Hashable) -> None: ...
+    def __invert__(self) -> FBool: ...
+    def __and__(self, other: int) -> SBool: ...
+    def __rand__(self, other: int) -> SBool: ...
+    def __or__(self, other: int) -> SBool: ...
+    def __ror__(self, other: int) -> SBool: ...
+    def __xor__(self, other: int) -> SBool: ...
+    def __rxor__(self, other: int) -> SBool: ...
+    def flavor(self) -> Hashable: ...
+
+def truthy(flavor: Hashable) -> FBool: ...
+def falsy(flavor: Hashable) -> FBool: ...

{pythonic_fp_booleans-2.0.0 → pythonic_fp_booleans-3.0.0}/src/pythonic_fp/booleans/subtypable.py

@@ -56,7 +56,7 @@ operator to return an opposite ``SBool`` class or subclass.
 import threading
 from collections.abc import Hashable
 from typing import cast, ClassVar, Final, overload
-from pythonic_fp.gadgets.latest_common_ancestor import lca
+from pythonic_fp.gadgets import first_common_ancestor as fca
 from pythonic_fp.gadgets.sentinels.novalue import NoValue
 
 __all__ = ['SBool', 'TRUTH', 'LIE']
@@ -110,7 +110,7 @@ class SBool(int):
 
     def __and__(self, other: int) -> int:
         try:
-            base_class = lca(type(self), type(other))
+            base_class = fca(type(self), type(other))
         except TypeError:
             if type(other) is bool:
                 base_class = int
@@ -127,7 +127,7 @@ class SBool(int):
 
     def __or__(self, other: int) -> int:
         try:
-            base_class = lca(type(self), type(other))
+            base_class = fca(type(self), type(other))
         except TypeError:
             if type(other) is bool:
                 base_class = int
@@ -144,7 +144,7 @@ class SBool(int):
 
     def __xor__(self, other: int) -> int:
         try:
-            base_class = lca(type(self), type(other))
+            base_class = fca(type(self), type(other))
         except TypeError:
             if type(other) is bool:
                 base_class = int

pythonic_fp_booleans-3.0.0/src/pythonic_fp/booleans/subtypable.pyi

@@ -0,0 +1,18 @@
+from collections.abc import Hashable
+from typing import Final, overload
+
+__all__ = ['SBool', 'TRUTH', 'LIE']
+
+class SBool(int):
+    @overload
+    def __new__(cls) -> SBool: ...
+    @overload
+    def __new__(cls, witness: object) -> SBool: ...
+    def __init__(self, witness: object = False, flavor: Hashable = ...) -> None: ...
+    def __invert__(self) -> SBool: ...
+    def __and__(self, other: int) -> int: ...
+    def __or__(self, other: int) -> int: ...
+    def __xor__(self, other: int) -> int: ...
+
+TRUTH: Final[SBool]
+LIE: Final[SBool]

pythonic_fp_booleans-3.0.0/src/pythonic_fp/booleans/truthy_falsy.pyi

@@ -0,0 +1,21 @@
+from .subtypable import SBool
+from collections.abc import Hashable
+from typing import Final
+
+__all__ = ['TF_Bool', 'T_Bool', 'F_Bool', 'ALWAYS', 'NEVER', 'TF_Boolean']
+
+class TF_Bool(SBool):
+    def __new__(cls, witness: object, flavor: Hashable = ...) -> TF_Bool: ...
+    def __invert__(self) -> TF_Bool: ...
+    def __and__(self, other: int) -> SBool: ...
+    def __or__(self, other: int) -> SBool: ...
+    def __xor__(self, other: int) -> SBool: ...
+
+class T_Bool(TF_Bool):
+    def __new__(cls, witness: object = ..., flavor: Hashable = ...) -> T_Bool: ...
+
+class F_Bool(TF_Bool):
+    def __new__(cls, witness: object = ..., flavor: Hashable = ...) -> F_Bool: ...
+TF_Boolean = T_Bool | F_Bool | TF_Bool
+ALWAYS: Final[TF_Boolean]
+NEVER: Final[TF_Boolean]