pythonic-fp.containers 4.1.0__tar.gz → 6.0.0__tar.gz

pythonic_fp_containers-6.0.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: pythonic-fp-containers
+Version: 6.0.0
+Summary: Containers with FP interfaces.
+Keywords: functional_containers,functional_tuple,immutable_list
+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-circulararray>=6.4,<7
+Requires-Dist: pythonic-fp-fptools>=6.2,<7
+Requires-Dist: pythonic-fp-iterables>=6,<7
+Project-URL: Changelog, https://github.com/grscheller/pythonic-fp-containers/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://grscheller.github.io/pythonic-fp-containers
+Project-URL: Homepage, https://grscheller.github.io/pythonic-fp
+Project-URL: Source, https://github.com/grscheller/pythonic-fp-containers
+
+# Pythonic FP - Containers
+
+Python package for containers of like data structures with functional
+programming inspired tweaks.
+
+PyPI project
+[pythonic-fp-containers](https://pypi.org/project/pythonic-fp-containers).
+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-containers).
+
+| module | class | name |
+|:------ |:-----:|:---- |
+| pythonic_fp.containers.functional_tuple | FTuple | Functional Tuple |
+| pythonic_fp.containers.immutable_list | IList | Immutable List |
+
+## 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_containers-6.0.0/README.md

@@ -0,0 +1,25 @@
+# Pythonic FP - Containers
+
+Python package for containers of like data structures with functional
+programming inspired tweaks.
+
+PyPI project
+[pythonic-fp-containers](https://pypi.org/project/pythonic-fp-containers).
+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-containers).
+
+| module | class | name |
+|:------ |:-----:|:---- |
+| pythonic_fp.containers.functional_tuple | FTuple | Functional Tuple |
+| pythonic_fp.containers.immutable_list | IList | Immutable List |
+
+## 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_containers-4.1.0 → pythonic_fp_containers-6.0.0}/pyproject.toml

@@ -4,9 +4,10 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "pythonic-fp-containers"
-version = "4.1.0"
-readme = "README.rst"
-requires-python = ">=3.13"
+version = "6.0.0"
+description = "Containers with FP interfaces."
+readme = "README.md"
+requires-python = ">=3.14"  # floor: PEP 649/749 deferred annotations — class-level self-reference NameErrors on <3.14
 authors = [
   { name = "Geoffrey R. Scheller", email = "geoffrey@scheller.com" },
 ]
@@ -22,22 +23,26 @@ classifiers = [
   "License :: OSI Approved :: Apache Software License",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
   "Typing :: Typed",
 ]
 dependencies = [
-  "pythonic-fp-circulararray>=6.0.4",
-  "pythonic-fp-fptools>=5.2.0",
-  "pythonic-fp-iterables>=5.1.3",
+  "pythonic-fp-circulararray>=6.4,<7",
+  "pythonic-fp-fptools>=6.2,<7",
+  "pythonic-fp-iterables>=6,<7",
 ]
-dynamic = ["description"]
 
 [project.urls]
-Changelog = "https://github.com/grscheller/pythonic-fp-containers/blob/main/CHANGELOG.rst"
-Documentation = "https://grscheller.github.io/pythonic-fp/projects/containers.html"
-Homepage = "https://grscheller.github.io/pythonic-fp/"
+Changelog = "https://github.com/grscheller/pythonic-fp-containers/blob/main/CHANGELOG.md"
+Documentation ="https://grscheller.github.io/pythonic-fp-containers"
+Homepage = "https://grscheller.github.io/pythonic-fp"
 Source = "https://github.com/grscheller/pythonic-fp-containers"
 
-[project.optional-dependencies]
+[dependency-groups]
+docs = [
+  "furo>=2025.12.19",
+  "sphinx>=9.1",
+]
 test = [
   "pytest>=8.4.1",
 ]
@@ -45,6 +50,22 @@ test = [
 [tool.flit.module]
 name = "pythonic_fp.containers"
 
+[tool.flit.sdist]
+exclude = [
+  "docs/",
+  "tests/",
+  "**/.mypy_cache/",
+  "**/.ruff_cache/",
+  "**/.pytest_cache/",
+  "**/__pycache__/",
+  "**/.dmypy.json",
+]
+
+[tool.pytest]
+addopts = ["-ra"]
+consider_namespace_packages = true
+testpaths = ["tests/"]
+
 [tool.mypy]
 explicit_package_bases = true
 local_partial_types = true
@@ -53,23 +74,16 @@ 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",
-]
-consider_namespace_packages = true
-testpaths = ["tests/"]
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+strict_equality = false
 
 [tool.ruff]
 target-version = "py314"
 
+[tool.ruff.lint]
+ignore = ["RUF022", "E741"]
+
 [tool.ruff.lint.flake8-quotes]
 docstring-quotes = "double"
 
@@ -78,8 +92,12 @@ docstring-quotes = "double"
   "E731",
   "C901",
 ]
-"**/*.py" = ["E741"]
 
 [tool.ruff.format]
 quote-style = "single"
 docstring-code-line-length = 72
+
+[tool.uv.sources]
+pythonic-fp-circulararray = { path = "../pythonic-fp-circulararray", editable = true }
+pythonic-fp-fptools = { path = "../pythonic-fp-fptools", editable = true }
+pythonic-fp-iterables = { path = "../pythonic-fp-iterables", editable = true }

{pythonic_fp_containers-4.1.0 → pythonic_fp_containers-6.0.0}/src/pythonic_fp/containers/functional_tuple.py

@@ -14,9 +14,10 @@
 # limitations under the License.
 
 from collections.abc import Callable, Iterator
-from typing import cast, Never, overload, SupportsIndex
+from typing import SupportsIndex, cast, overload
+
 from pythonic_fp.iterables.folding import accumulate
-from pythonic_fp.iterables.merging import blend, concat, MergeEnum
+from pythonic_fp.iterables.merging import MergeEnum, blend, concat
 
 __all__ = ['FTuple']
 
@@ -158,7 +159,7 @@ class FTuple[D](tuple[D, ...]):
             acc = f(v, acc)
         return acc
 
-    def copy(self) -> 'FTuple[D]':
+    def copy(self) -> FTuple[D]:
         """
         .. admonition:: copy
 
@@ -173,7 +174,13 @@ class FTuple[D](tuple[D, ...]):
     def __add__(self, other: object, /) -> tuple[D, ...]:
         if not isinstance(other, tuple):
             msg = 'FTuple being added to something not an FTuple'
-            raise ValueError(msg)
+            raise TypeError(msg)
+        return self.__class__(concat(self, other))
+
+    def __radd__(self, other: object, /) -> tuple[D, ...]:
+        if not isinstance(other, tuple):
+            msg = 'FTuple being added to something not an FTuple'
+            raise TypeError(msg)
         return self.__class__(concat(self, other))
 
     def __mul__(self, num: SupportsIndex) -> tuple[D, ...]:
@@ -184,7 +191,7 @@ class FTuple[D](tuple[D, ...]):
 
     def accummulate[L](
         self, f: Callable[[L, D], L], s: L | None = None, /
-    ) -> 'FTuple[L]':
+    ) -> FTuple[L]:
         """
         .. admonition:: accumulate partial folds
 
@@ -197,7 +204,7 @@ class FTuple[D](tuple[D, ...]):
             return FTuple(accumulate(self, f))
         return FTuple(accumulate(self, f, s))
 
-    def map[U](self, f: Callable[[D], U], /) -> 'FTuple[U]':
+    def map[U](self, f: Callable[[D], U], /) -> FTuple[U]:
         """
         .. admonition:: map
 
@@ -209,10 +216,10 @@ class FTuple[D](tuple[D, ...]):
 
     def bind[U](
         self,
-        f: 'Callable[[D], FTuple[U]]',
+        f: Callable[[D], FTuple[U]],
         merge_type: MergeEnum = MergeEnum.Concat,
         yield_partials: bool = False,
-    ) -> 'FTuple[U] | Never':
+    ) -> FTuple[U]:
         """
         .. admonition:: bind
 

{pythonic_fp_containers-4.1.0 → pythonic_fp_containers-6.0.0}/src/pythonic_fp/containers/immutable_list.py

@@ -12,10 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from collections.abc import Callable, Iterable, Iterator, Hashable
-from typing import cast, Never, overload
+from collections.abc import Callable, Hashable, Iterable, Iterator
+from typing import cast, overload
+
 from pythonic_fp.iterables.folding import accumulate
-from pythonic_fp.iterables.merging import blend, concat, MergeEnum
+from pythonic_fp.iterables.merging import MergeEnum, blend, concat
 
 __all__ = ['IList']
 
@@ -34,7 +35,7 @@ class IList[D](Hashable):
 
     """
 
-    __slots__ = ('_ds', '_len', '_hash')
+    __slots__ = ('_ds', '_hash', '_len')
     __match_args__ = ('_ds', '_len')
 
     def __init__(self, *ds: Iterable[D]) -> None:
@@ -48,7 +49,7 @@ class IList[D](Hashable):
             msg = f'IList expects at most 1 iterable argument, got {size}'
             raise ValueError(msg)
         else:
-            self._ds: tuple[D, ...] = tuple(ds[0]) if size == 1 else tuple()
+            self._ds: tuple[D, ...] = tuple(ds[0]) if size == 1 else ()
             self._len = len(self._ds)
             try:
                 self._hash = hash((self._len, 42) + self._ds)
@@ -118,9 +119,9 @@ class IList[D](Hashable):
     @overload
     def __getitem__(self, idx: int, /) -> D: ...
     @overload
-    def __getitem__(self, idx: slice, /) -> 'IList[D]': ...
+    def __getitem__(self, idx: slice, /) -> IList[D]: ...
 
-    def __getitem__(self, idx: slice | int, /) -> 'IList[D] | D':
+    def __getitem__(self, idx: slice | int, /) -> IList[D] | D:
         """
         .. admonition:: getitem
 
@@ -222,7 +223,7 @@ class IList[D](Hashable):
             acc = f(v, acc)
         return acc
 
-    def __add__(self, other: 'IList[D]', /) -> 'IList[D]':
+    def __add__(self, other: IList[D], /) -> IList[D]:
         """
         .. admonition:: add by concatenation
 
@@ -237,11 +238,11 @@ class IList[D](Hashable):
         """
         if not isinstance(other, IList):
             msg = 'IList being added to something not an IList'
-            raise ValueError(msg)
+            raise TypeError(msg)
 
         return IList(concat(self, other))
 
-    def __mul__(self, num: int, /) -> 'IList[D]':
+    def __mul__(self, num: int, /) -> IList[D]:
         """
         .. admonition:: add by concatenation
 
@@ -255,9 +256,9 @@ class IList[D](Hashable):
                 Maybe define a "column vector" version?
 
         """
-        return IList(self._ds.__mul__(num if num > 0 else 0))
+        return IList(self._ds.__mul__(max(0, num)))
 
-    def __rmul__(self, num: int, /) -> 'IList[D]':
+    def __rmul__(self, num: int, /) -> IList[D]:
         """
         .. admonition:: concatenation with itself
 
@@ -267,11 +268,11 @@ class IList[D](Hashable):
             :raises ValueError: When ``other`` is not an ``IList``.
 
         """
-        return IList(self._ds.__mul__(num if num > 0 else 0))
+        return IList(self._ds.__mul__(max(0, num)))
 
     def accummulate[L](
         self, f: Callable[[L, D], L], s: L | None = None, /
-    ) -> 'IList[L]':
+    ) -> IList[L]:
         """
         .. admonition:: accumulate partial folds
 
@@ -287,7 +288,7 @@ class IList[D](Hashable):
             return IList(accumulate(self, f))
         return IList(accumulate(self, f, s))
 
-    def map[U](self, f: Callable[[D], U], /) -> 'IList[U]':
+    def map[U](self, f: Callable[[D], U], /) -> IList[U]:
         """
         .. admonition:: map
 
@@ -299,10 +300,10 @@ class IList[D](Hashable):
 
     def bind[U](
         self,
-        f: 'Callable[[D], IList[U]]',
+        f: Callable[[D], IList[U]],
         merge_enum: MergeEnum = MergeEnum.Concat,
         yield_partials: bool = False,
-    ) -> 'IList[U] | Never':
+    ) -> IList[U]:
         """
         .. admonition:: bind
 

pythonic_fp_containers-4.1.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.1.0'
-  DEVEL: '5.0.0'
-  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-circulararray
-          docs/gen_conf.py release ${{ env.RELEASE }} Containers containers > 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 }} Containers containers > 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_containers-4.1.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