pythonic-fp-booleans 4.0.0__tar.gz → 4.1.0__tar.gz

{pythonic_fp_booleans-4.0.0 → pythonic_fp_booleans-4.1.0}/PKG-INFO

@@ -1,11 +1,11 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: pythonic-fp-booleans
-Version: 4.0.0
-Summary: Booleans
+Version: 4.1.0
+Summary: True Booleans which are subtypable.
 Keywords: booleans,subtypable
 Author-email: "Geoffrey R. Scheller" <geoffrey@scheller.com>
 Requires-Python: >=3.13
-Description-Content-Type: text/x-rst
+Description-Content-Type: text/markdown
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
@@ -15,39 +15,34 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 License-File: LICENSE
 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/projects/booleans.html
+Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-booleans/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://grscheller.github.io/pythonic-fp-booleans/release/html/
 Project-URL: Homepage, https://grscheller.github.io/pythonic-fp/
 Project-URL: Source, https://github.com/grscheller/pythonic-fp-booleans
-Provides-Extra: test
+Import-Name: pythonic_fp.booleans
+Import-Namespace: pythonic_fp
 
-Pythonic FP - Booleans
-======================
-
-PyPI project
-`pythonic-fp-booleans
-<https://pypi.org/project/pythonic-fp-booleans>`_.
+# Pythonic FP - Booleans
 
 Subtypable Boolean like classes.
 
-While still compatible with Python shortcut logic, these singleton classes
-can be non-shortcut logically composed with Python’s bitwise operators.
-
+PyPI project
+[pythonic-fp-booleans](https://pypi.org/project/pythonic-fp-booleans).
 Part of the
-`pythonic-fp
-<https://grscheller.github.io/pythonic-fp/>`_
+[pythonic-fp](https://grscheller.github.io/pythonic-fp/)
 PyPI projects.
 
-Documentation
--------------
+## Documentation
 
 Documentation and other links for this project are hosted on
-`GitHub Pages
-<https://grscheller.github.io/pythonic-fp/projects/booleans.html>`_.
+[GitHub Pages](https://grscheller.github.io/pythonic-fp/projects/booleans.html).
+
+While still compatible with Python shortcut logic, these singleton
+classes can be non-shortcut logically composed with Python’s bitwise
+operators. Unlike Python booleans which bitwise compose as integers,
+these compose as true Booleans in a contravariant way.
 
-Copyright and License
----------------------
+## Copyright and License
 
 Copyright (c) 2025-2026 Geoffrey R. Scheller. Licensed under the Apache
 License, Version 2.0. See the LICENSE file for details.

pythonic_fp_booleans-4.1.0/README.md

@@ -0,0 +1,24 @@
+# Pythonic FP - Booleans
+
+Subtypable Boolean like classes.
+
+PyPI project
+[pythonic-fp-booleans](https://pypi.org/project/pythonic-fp-booleans).
+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/booleans.html).
+
+While still compatible with Python shortcut logic, these singleton
+classes can be non-shortcut logically composed with Python’s bitwise
+operators. Unlike Python booleans which bitwise compose as integers,
+these compose as true Booleans in a contravariant way.
+
+## Copyright and License
+
+Copyright (c) 2025-2026 Geoffrey R. Scheller. Licensed under the Apache
+License, Version 2.0. See the LICENSE file for details.

{pythonic_fp_booleans-4.0.0 → pythonic_fp_booleans-4.1.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "pythonic-fp-booleans"
-version = "4.0.0"
-readme = "README.rst"
+version = "4.1.0"
+readme = "README.md"
 requires-python = ">=3.13"
 authors = [
   { name = "Geoffrey R. Scheller", email = "geoffrey@scheller.com" },
@@ -26,15 +26,22 @@ classifiers = [
 dependencies = [
   "pythonic-fp-gadgets>=4.0.2",
 ]
-dynamic = ["description"]
+description = "True Booleans which are subtypable."
 
 [project.urls]
-Changelog = "https://github.com/grscheller/pythonic-fp-booleans/blob/main/CHANGELOG.rst"
-Documentation = "https://grscheller.github.io/pythonic-fp/projects/booleans.html"
+Changelog = "https://github.com/grscheller/pythonic-fp-booleans/blob/main/CHANGELOG.md"
+Documentation ="https://grscheller.github.io/pythonic-fp-booleans/release/html/"
 Homepage = "https://grscheller.github.io/pythonic-fp/"
 Source = "https://github.com/grscheller/pythonic-fp-booleans"
 
-[project.optional-dependencies]
+[dependency-groups]
+docs = [
+  "furo>=2025.12.19",
+  "sphinx>=9.1",
+]
+pub = [
+  "flit",
+]
 test = [
   "pytest>=8.4.1",
 ]
@@ -42,6 +49,12 @@ test = [
 [tool.flit.module]
 name = "pythonic_fp.booleans"
 
+[tool.flit.sdist]
+exclude = [
+  "docs/",
+  "tests/",
+]
+
 [tool.mypy]
 explicit_package_bases = true
 local_partial_types = true
@@ -50,23 +63,17 @@ warn_redundant_casts = true
 warn_return_any = true
 warn_unused_configs = true
 
-[tool.pylsp-mypy]
-enabled = true
-live-mode = true
-dmypy = false
-strict = true
-report_progress = true
-
 [tool.pytest]
-addopts = [
-  "-ra",
-]
+addopts = ["-ra"]
 consider_namespace_packages = true
 testpaths = ["tests/"]
 
 [tool.ruff]
 target-version = "py314"
 
+[tool.ruff.lint]
+ignore = ["RUF022", "E741"]
+
 [tool.ruff.lint.flake8-quotes]
 docstring-quotes = "double"
 
@@ -75,7 +82,6 @@ docstring-quotes = "double"
   "E731",
   "C901",
 ]
-"**/*.py" = ["E741"]
 
 [tool.ruff.format]
 quote-style = "single"

{pythonic_fp_booleans-4.0.0 → pythonic_fp_booleans-4.1.0}/src/pythonic_fp/booleans/flavored.py

@@ -1,4 +1,4 @@
-# Copyright 2023-2025 Geoffrey R. Scheller
+# Copyright 2023-2026 Geoffrey R. Scheller
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,9 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import threading
 from collections.abc import Hashable
-from typing import ClassVar, final, Self
+from threading import Lock
+from typing import ClassVar, Self, final
+
 from .subtypable import SBool
 
 __all__ = ['FBool', 'truthy', 'falsy']
@@ -25,8 +26,8 @@ class FBool(SBool):
     """
     .. admonition:: Favored Booleans
 
-        When different flavors of the truth matter. Each FBool is
-        an SBool subtype corresponding to a hashable flavor.
+        When different flavors of the truth matter. Each ``FBool`` is
+        an ``SBool`` subtype corresponding to a hashable flavor.
 
         .. warning::
 
@@ -36,11 +37,11 @@ class FBool(SBool):
 
     """
 
-    _falsy_dict: 'ClassVar[dict[Hashable, FBool]]' = {}
-    _falsy_dict_lock: ClassVar[threading.Lock] = threading.Lock()
+    _falsy_dict: ClassVar[dict[Hashable, FBool]] = {}
+    _falsy_dict_lock: ClassVar[Lock] = Lock()
 
-    _truthy_dict: 'ClassVar[dict[Hashable, FBool]]' = {}
-    _truthy_dict_lock: ClassVar[threading.Lock] = threading.Lock()
+    _truthy_dict: ClassVar[dict[Hashable, FBool]] = {}
+    _truthy_dict_lock: ClassVar[Lock] = Lock()
 
     def __new__(cls, witness: object, flavor: Hashable) -> Self:
         """
@@ -123,17 +124,17 @@ class FBool(SBool):
 
             Create strings of the form
 
-            - `FBool(True, repr_flavor)'
-            - `FBool(False, repr_flavor)'
+            - ``FBool(True, repr_flavor)``
+            - ``FBool(False, repr_flavor)``
 
-            Where repr_flavor = repr(self.flavor())
+            Where ``repr_flavor = repr(self.flavor())``
 
             :returns: A String to reproduce the flavored boolean.
 
         """
         if self:
-            return f'FBool(True, {repr(self._flavor)})'
-        return f'FBool(False, {repr(self._flavor)})'
+            return f'FBool(True, {self._flavor!r})'
+        return f'FBool(False, {self._flavor!r})'
 
     def __str__(self) -> str:
         """
@@ -141,23 +142,23 @@ class FBool(SBool):
 
             Create strings of the form
 
-            - `FBool(True, str_flavor)'
-            - `FBool(False, str_flavor)'
+            - ``FBool(True, str_flavor)``
+            - ``FBool(False, str_flavor)``
 
-            Where str_flavor = str(self.flavor())
+            Where ``str_flavor = str(self.flavor())``
 
-            :returns: A String to meaningful to an end user.
+            :returns: A String meaningful to an end user.
 
         """
         if self:
-            return f'FBool(True, {str(self._flavor)})'
-        return f'FBool(False, {str(self._flavor)})'
+            return f'FBool(True, {self._flavor!s})'
+        return f'FBool(False, {self._flavor!s})'
 
     def flavor(self) -> Hashable:
         """
         .. admonition:: flavor
 
-            Get the flavor of the FBool, a hashable value.
+            Get the flavor of the ``FBool``, a hashable value.
 
             :returns: The flavor.
 
@@ -169,7 +170,7 @@ def truthy(flavor: Hashable) -> FBool:
     """
     .. admonition:: function truthy
 
-        Returns the truthy singleton FBool of a particular flavor.
+        Returns the truthy singleton ``FBool`` of a particular flavor.
 
         :param flavor: Hashable value to determine which
                        singleton flavor to return.
@@ -183,7 +184,7 @@ def falsy(flavor: Hashable) -> FBool:
     """
     .. admonition:: Function falsy
 
-        Returns the falsy singleton FBool of a particular flavor.
+        Returns the falsy singleton ``FBool`` of a particular flavor.
 
         :param flavor: Hashable value to determine which
                        singleton flavor to return.

{pythonic_fp_booleans-4.0.0 → pythonic_fp_booleans-4.1.0}/src/pythonic_fp/booleans/subtypable.py

@@ -12,47 +12,38 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import threading
 from collections.abc import Hashable
-from typing import cast, ClassVar, Final, overload, Self
+from threading import Lock
+from typing import ClassVar, Final, Self, cast, overload
+
 from pythonic_fp.gadgets import first_common_ancestor as fca
 from pythonic_fp.gadgets.sentinels.novalue import NoValue
 
 __all__ = ['SBool', 'TRUTH', 'LIE']
 
+no_value = NoValue()
 
 class SBool(int):
     """
-    .. depricated:: 3.1.0
-
-        Will re-architecture the entire pythonic-fp-booleans effort for
-        the PyPI version 4.0.0 release.
-
-        Going forward, subtypable Booleans will no longer be a subclass
-        of int. The maintainer has found this approach is a maintenance
-        burden. Maintainer also feels the current version is somewhat
-        "unpythonic" in the typing sophistication it requires for
-        end user code to leverage the project.
-
     .. admonition:: Subtypable Boolean
 
-        Like Python's built in bool, class SBool is a singleton subclass
-        of int. Unlike bool, it can be further subclassed.
+        Like Python's built in ``bool``, class ``SBool`` is a singleton
+        subclass of ``int``. Unlike ``bool``, it can be further subclassed.
 
-        SBool and its subtypes can also do (non-shortcut) Boolean logic
+        ``SBool`` and its subtypes can also do (non-shortcut) Boolean logic
         using Python bitwise operators.
 
-        +-------------------+--------+------------+
-        | Boolean operation | symbol | dunder     |
-        +===================+========+============+
-        |       not         | ``~``  | __invert__ |
-        +-------------------+--------+------------+
-        |       and         | ``&``  | __and__    |
-        +-------------------+--------+------------+
-        |       or          | ``|``  | __or__     |
-        +-------------------+--------+------------+
-        |       xor         | ``^``  | __xor__    |
-        +-------------------+--------+------------+
+        +-------------------+--------+----------------+
+        | Boolean operation | symbol | dunder         |
+        +===================+========+================+
+        |       not         | ``~``  | ``__invert__`` |
+        +-------------------+--------+----------------+
+        |       and         | ``&``  | ``__and__``    |
+        +-------------------+--------+----------------+
+        |       or          | ``|``  | ``__or__``     |
+        +-------------------+--------+----------------+
+        |       xor         | ``^``  | ``__xor__``    |
+        +-------------------+--------+----------------+
 
         While compatible with Python  short-cut logic, , the not
         operator unfortunately always returns a bool.
@@ -78,28 +69,30 @@ class SBool(int):
 
     """
 
-    _falsy: 'ClassVar[SBool | NoValue]' = NoValue()
-    _falsy_lock: ClassVar[threading.Lock] = threading.Lock()
+    _falsy: ClassVar[SBool | NoValue] = NoValue()
+    _falsy_lock: ClassVar[Lock] = Lock()
 
-    _truthy: 'ClassVar[SBool | NoValue]' = NoValue()
-    _truthy_lock: ClassVar[threading.Lock] = threading.Lock()
+    _truthy: ClassVar[SBool | NoValue] = NoValue()
+    _truthy_lock: ClassVar[Lock] = Lock()
 
     @overload
     def __new__(cls, witness: object) -> Self: ...
     @overload
-    def __new__(cls, witness: object, flavor: Hashable | NoValue = NoValue()) -> Self: ...
+    def __new__(
+        cls, witness: object, flavor: Hashable | NoValue = no_value
+    ) -> Self: ...
 
     def __new__(
         cls,
         witness: object,
-        flavor: Hashable | NoValue = NoValue(),
-    ) -> 'SBool':
+        flavor: Hashable | NoValue = no_value,
+    ) -> Self:
         """
         .. admonition:: new
 
-            :param witness: Determines truthiness of the SBool.
-            :param flavor: Ignored 
-            :returns: The truthy or falsy SBool class instance.
+            :param witness: Determines truthiness of the ``SBool``.
+            :param flavor: Ignored
+            :returns: The truthy or falsy ``SBool`` class instance.
 
         """
         if witness:
@@ -107,13 +100,13 @@ class SBool(int):
                 with cls._truthy_lock:
                     if cls._truthy is NoValue():
                         cls._truthy = super().__new__(cls, 1)
-            return cast(SBool, cls._truthy)
+            return cast(Self, cls._truthy)
         else:
             if cls._falsy is NoValue():
                 with cls._falsy_lock:
                     if cls._falsy is NoValue():
                         cls._falsy = super().__new__(cls, 0)
-            return cast(SBool, cls._falsy)
+            return cast(Self, cls._falsy)
 
     @overload
     def __init__(self, witness: object) -> None: ...
@@ -123,14 +116,14 @@ class SBool(int):
     def __init__(
         self,
         witness: object = False,
-        flavor: Hashable | NoValue = NoValue(),
+        flavor: Hashable | NoValue = no_value,
     ) -> None:
         """
         .. admonition:: init
 
-            :param witness: Determines the truthiness of the SBool.
-            :param flavor: Ignored by SBool, here only for support the
-                           Liskov Substitution Principle.
+            :param witness: Determines the truthiness of the ``SBool``.
+            :param flavor: Ignored by ``SBool``, here only to support
+                           the Liskov Substitution Principle.
         """
         self._flavor: Hashable | NoValue = NoValue()
 
@@ -213,7 +206,7 @@ class SBool(int):
             - 'SBool(True)' if truthy
             - 'SBool(False)' if falsy
 
-            :returns: A string to reproduce the SBool.
+            :returns: A string to reproduce the ``SBool``.
 
         """
         if self:
@@ -240,7 +233,7 @@ TRUTH: Final[SBool] = SBool(True)
 """
 .. admonition:: TRUTH
 
-    :var TRUTH: The truthy singleton of type SBool.
+    :var TRUTH: The truthy singleton of type ``SBool``.
 
 """
 

{pythonic_fp_booleans-4.0.0 → pythonic_fp_booleans-4.1.0}/src/pythonic_fp/booleans/truthy_falsy.py

@@ -12,10 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import threading
 from collections.abc import Hashable
-from typing import cast, ClassVar, Final, Self
+from threading import Lock
+from typing import ClassVar, Final, Self, cast
+
 from pythonic_fp.gadgets.sentinels.novalue import NoValue
+
 from .subtypable import SBool
 
 __all__ = [
@@ -55,10 +57,12 @@ class TF_Bool(SBool):
 
     """
 
+    no_value = NoValue()
+
     def __new__(
         cls,
         witness: object,
-        flavor: Hashable = NoValue(),
+        flavor: Hashable = no_value,
     ) -> Self:
         """
         .. admonition:: new
@@ -114,13 +118,16 @@ class T_Bool(TF_Bool):
          A distinct type from F_Bool.
 
     """
-    _truthy: 'ClassVar[T_Bool | NoValue]' = NoValue()
-    _lock: ClassVar[threading.Lock] = threading.Lock()
+
+    no_value = NoValue()
+
+    _truthy: ClassVar[T_Bool | NoValue] = no_value
+    _lock: ClassVar[Lock] = Lock()
 
     def __new__(
         cls,
-        witness: object = NoValue(),
-        flavor: Hashable | NoValue = NoValue(),
+        witness: object = no_value,
+        flavor: Hashable | NoValue = no_value,
     ) -> Self:
         """
         .. admonition:: new
@@ -130,9 +137,9 @@ class T_Bool(TF_Bool):
             :returns: The truthy T_Bool singleton instance.
 
         """
-        if cls._truthy is NoValue():
+        if cls._truthy is (no_value := NoValue()):
             with cls._lock:
-                if cls._truthy is NoValue():
+                if cls._truthy is no_value:
                     cls._truthy = super(SBool, cls).__new__(cls, 1)
         return cast(Self, cls._truthy)
 
@@ -162,13 +169,16 @@ class F_Bool(TF_Bool):
          A distinct type from T_Bool.
 
     """
-    _falsy: 'ClassVar[F_Bool | NoValue]' = NoValue()
-    _lock: ClassVar[threading.Lock] = threading.Lock()
+
+    no_value = NoValue()
+
+    _falsy: ClassVar[F_Bool | NoValue] = no_value
+    _lock: ClassVar[Lock] = Lock()
 
     def __new__(
         cls,
         witness: object = NoValue(),
-        flavor: Hashable | NoValue = NoValue(),
+        flavor: Hashable | NoValue = no_value,
     ) -> Self:
         """
         .. admonition:: new
@@ -178,9 +188,9 @@ class F_Bool(TF_Bool):
             :returns: The falsy F_Bool singleton instance.
 
         """
-        if cls._falsy is NoValue():
+        if cls._falsy is (no_value := NoValue()):
             with cls._lock:
-                if cls._falsy is NoValue():
+                if cls._falsy is no_value:
                     cls._falsy = super(SBool, cls).__new__(cls, 0)
         return cast(Self, cls._falsy)
 

pythonic_fp_booleans-4.0.0/.github/workflows/static.yml

@@ -1,64 +0,0 @@
-name: Build and Deploy Furo Themed Sphinx Documentation
-
-on:
-  push:
-    branches: ["main"]
-  workflow_dispatch:
-
-env:
-  RELEASE: '4.0.0'
-  DEVEL: '4.0.1'
-  PYTHON: '3.14'
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-
-      - name: Select Python
-        uses: actions/setup-python@v6
-        with:
-          python-version: ${{ env.PYTHON }}
-
-      - name: Install Sphinx Dependencies
-        run: |
-          pip install -r docs/requirements.txt
-          sudo apt-get install -y graphviz
-
-      - name: Build Release Docs
-        run: |
-          pip install pythonic-fp-booleans
-          docs/gen_conf.py release ${{ env.RELEASE }} Booleans booleans > docs/source/conf.py
-          sphinx-build -M html docs/source docs/build/release
-
-      - name: Build Development Docs
-        run: |
-          pip install -e .
-          docs/gen_conf.py devel ${{ env.DEVEL }} Booleans booleans > docs/source/conf.py
-          sphinx-build -M html docs/source docs/build/development
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v6
-
-      - name: Upload Artifact
-        uses: actions/upload-pages-artifact@v5
-        with:
-          path: docs/build
-
-      - name: Deploy to GitHub Pages
-        uses: actions/deploy-pages@v5
-        id: deployment

pythonic_fp_booleans-4.0.0/.gitignore

@@ -1,9 +0,0 @@
-# Minimal version - only add to when necessary
-**/__pycache__/
-dist/
-docs/build/
-docs/source/conf.py
-**/.dmypy.json
-**/.mypy_cache/
-**/.pytest_cache/
-**/.ruff_cache