flpit 0.2.3__tar.gz → 0.3.0__tar.gz

{flpit-0.2.3 → flpit-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: flpit
-Version: 0.2.3
+Version: 0.3.0
 Summary: Fluent LINQ for Python — flip your iterables
 Project-URL: Homepage, https://github.com/riemar/flpit
 Project-URL: Repository, https://github.com/riemar/flpit
@@ -24,6 +24,9 @@ Description-Content-Type: text/markdown
 
 # FlpIt
 
+**[🌐 View on GitHub](https://github.com/riemar/flpit)** | [📦 View on PyPI](https://pypi.org/project/flpit/)
+
+
 > **Fluent LINQ for Python — LINQ semantics, Python-native execution**
 
 `FlpIt` brings a strongly typed, LINQ-style API to standard Python iterables. It combines the fluent query model and semantics of .NET LINQ with Python's native iterable and generator model.
@@ -32,17 +35,14 @@ Description-Content-Type: text/markdown
 > Where Python's language or type system requires a different API contract, the contract is adapted accordingly. 
 > The implementation is actively developed, and semantic deviations may still exist.
 
-> **⚠️ Breaking Change — `FlpList` — v0.2.0**
->
-> `FlpList` no longer derives from `collections.UserList`.
->
-> **Retained:** Python collection behavior such as iteration, `len()`, `in`, indexing, and slicing.
->
-> **LINQ:** `append()`, `concat()`, and other LINQ operations remain available with lazy semantics.
->
-> **`List<T>` semantics:** `add()`, `add_range()`, and other mutating operations follow the `List<T>` API where applicable.
->
-> **Removed:** `copy()`, `+`, `*`, and other `UserList`-specific operations that are not part of the `FlpList` API.
+## Familiar LINQ, Now in Python
+
+FlpIt is a Python implementation of the popular .NET Language Integrated Query (LINQ), adapted to Python.
+
+If you know C# LINQ, you already know most of FlpIt. Existing LINQ examples, query patterns, and documentation can generally be translated directly.
+FlpIt aims to make its implemented LINQ operators behave like their corresponding .NET `System.Linq.Enumerable` counterparts.
+
+This makes the extensive .NET LINQ ecosystem a valuable reference for developers and AI coding assistants alike.
 
 ## ⚡ Key Features
 
@@ -405,8 +405,13 @@ Key features:
 - **Task coordination:** `Task.when_all()` waits for all tasks while preserving input order; `Task.when_any()` returns the first completed task; `Task.collect()` yields tasks as they complete.
 - **Cancellation:** `CancellationToken` and `CancellationTokenSource` support cooperative cancellation, cancellation callbacks, timeouts, and linked cancellation tokens.
 - **Resource management:** Configure worker capacity and pending background-work limits, handle queue saturation explicitly, and shut down the process-wide runtime with an observable shutdown report.
+- **Asyncio interoperability:** FlpIt Tasks can be awaited directly inside asyncio coroutines when Task.asyncio_interop is enabled. 
+  - This is disabled by default. 
+  - Enabling it adds runtime-detection overhead to every pending await.
+    - await in flpit runtime: 200ish nano sec (just loop detection)
+    - await in asyncio loop: 
 
-The runtime starts lazily and manages its own lifecycle. It is deliberately not an `asyncio` compatibility layer; cancellation of running synchronous functions is cooperative.
+The runtime starts lazily and manages its own lifecycle. Cancellation of running synchronous functions is cooperative.
 
 See the [Task Runtime examples](https://github.com/riemar/flpit/tree/main/examples/task) for usage examples.
 
@@ -427,25 +432,43 @@ Distributed under the MIT License. See `LICENSE` for more information.
 > Note: The test cases exercise both core types, `FlpIt` and `FlpList`, with transitions between lazy and eager execution occurring as part of the individual test cases.
 
 ```
-================================================================
-| Test Module File                               |  Test Cases |
-----------------------------------------------------------------
-| tests/nettests/                                |             |
-| ├── test_all.py                                |          80 |
-| ├── test_any.py                                |          90 |
-| ├── test_average.py                            |         572 |
-| ├── test_concat.py                             |          64 |
-| ├── test_count.py                              |          37 |
-| ├── test_generic_list.py                       |          95 |
-| ├── test_last.py                               |          29 |
-| ├── test_order_by.py                           |         100 |
-| ├── test_order_descending_by.py                |          45 |
-| ├── test_skip.py                               |          75 |
-| ├── test_sum.py                                |         134 |
-| ├── test_take.py                               |          39 |
-| ├── test_then_by.py                            |          40 |
-| └── test_then_descending_by.py                 |          34 |
-----------------------------------------------------------------
-| GRAND TOTALS                                   |        1434 |
-================================================================
+================================================================================
+| Test Module File                                               |  Test Cases |
+--------------------------------------------------------------------------------
+| tests/nettests/                                                |             |
+| ├── linq/                                                      |             |
+| │   ├── test_aggregate.py                                      |          42 |
+| │   ├── test_all.py                                            |          80 |
+| │   ├── test_any.py                                            |          90 |
+| │   ├── test_average.py                                        |         572 |
+| │   ├── test_concat.py                                         |          64 |
+| │   ├── test_count.py                                          |          37 |
+| │   ├── test_distinct.py                                       |          87 |
+| │   ├── test_element_at.py                                     |          43 |
+| │   ├── test_first.py                                          |          29 |
+| │   ├── test_first_or_default.py                               |          50 |
+| │   ├── test_generic_list.py                                   |          95 |
+| │   ├── test_group_by.py                                       |          23 |
+| │   ├── test_last.py                                           |          29 |
+| │   ├── test_order_by.py                                       |          98 |
+| │   ├── test_order_descending_by.py                            |          45 |
+| │   ├── test_select.py                                         |         140 |
+| │   ├── test_select_many.py                                    |          85 |
+| │   ├── test_single.py                                         |          34 |
+| │   ├── test_single_or_default.py                              |          48 |
+| │   ├── test_skip.py                                           |          75 |
+| │   ├── test_sum.py                                            |         134 |
+| │   ├── test_take.py                                           |          39 |
+| │   ├── test_then_by.py                                        |          40 |
+| │   ├── test_then_descending_by.py                             |          34 |
+| │   └── test_where.py                                          |          76 |
+| └── task/                                                      |             |
+|     ├── test_cancellation.py                                   |          69 |
+|     ├── test_task_completion_source.py                         |          26 |
+|     ├── test_task_factory.py                                   |           3 |
+|     ├── test_task_rt.py                                        |          12 |
+|     └── test_task_rt_core.py                                   |          22 |
+--------------------------------------------------------------------------------
+| GRAND TOTALS                                                   |        2221 |
+================================================================================
 ```

{flpit-0.2.3 → flpit-0.3.0}/README.md

@@ -1,5 +1,8 @@
 # FlpIt
 
+**[🌐 View on GitHub](https://github.com/riemar/flpit)** | [📦 View on PyPI](https://pypi.org/project/flpit/)
+
+
 > **Fluent LINQ for Python — LINQ semantics, Python-native execution**
 
 `FlpIt` brings a strongly typed, LINQ-style API to standard Python iterables. It combines the fluent query model and semantics of .NET LINQ with Python's native iterable and generator model.
@@ -8,17 +11,14 @@
 > Where Python's language or type system requires a different API contract, the contract is adapted accordingly. 
 > The implementation is actively developed, and semantic deviations may still exist.
 
-> **⚠️ Breaking Change — `FlpList` — v0.2.0**
->
-> `FlpList` no longer derives from `collections.UserList`.
->
-> **Retained:** Python collection behavior such as iteration, `len()`, `in`, indexing, and slicing.
->
-> **LINQ:** `append()`, `concat()`, and other LINQ operations remain available with lazy semantics.
->
-> **`List<T>` semantics:** `add()`, `add_range()`, and other mutating operations follow the `List<T>` API where applicable.
->
-> **Removed:** `copy()`, `+`, `*`, and other `UserList`-specific operations that are not part of the `FlpList` API.
+## Familiar LINQ, Now in Python
+
+FlpIt is a Python implementation of the popular .NET Language Integrated Query (LINQ), adapted to Python.
+
+If you know C# LINQ, you already know most of FlpIt. Existing LINQ examples, query patterns, and documentation can generally be translated directly.
+FlpIt aims to make its implemented LINQ operators behave like their corresponding .NET `System.Linq.Enumerable` counterparts.
+
+This makes the extensive .NET LINQ ecosystem a valuable reference for developers and AI coding assistants alike.
 
 ## ⚡ Key Features
 
@@ -381,8 +381,13 @@ Key features:
 - **Task coordination:** `Task.when_all()` waits for all tasks while preserving input order; `Task.when_any()` returns the first completed task; `Task.collect()` yields tasks as they complete.
 - **Cancellation:** `CancellationToken` and `CancellationTokenSource` support cooperative cancellation, cancellation callbacks, timeouts, and linked cancellation tokens.
 - **Resource management:** Configure worker capacity and pending background-work limits, handle queue saturation explicitly, and shut down the process-wide runtime with an observable shutdown report.
+- **Asyncio interoperability:** FlpIt Tasks can be awaited directly inside asyncio coroutines when Task.asyncio_interop is enabled. 
+  - This is disabled by default. 
+  - Enabling it adds runtime-detection overhead to every pending await.
+    - await in flpit runtime: 200ish nano sec (just loop detection)
+    - await in asyncio loop: 
 
-The runtime starts lazily and manages its own lifecycle. It is deliberately not an `asyncio` compatibility layer; cancellation of running synchronous functions is cooperative.
+The runtime starts lazily and manages its own lifecycle. Cancellation of running synchronous functions is cooperative.
 
 See the [Task Runtime examples](https://github.com/riemar/flpit/tree/main/examples/task) for usage examples.
 
@@ -403,25 +408,43 @@ Distributed under the MIT License. See `LICENSE` for more information.
 > Note: The test cases exercise both core types, `FlpIt` and `FlpList`, with transitions between lazy and eager execution occurring as part of the individual test cases.
 
 ```
-================================================================
-| Test Module File                               |  Test Cases |
-----------------------------------------------------------------
-| tests/nettests/                                |             |
-| ├── test_all.py                                |          80 |
-| ├── test_any.py                                |          90 |
-| ├── test_average.py                            |         572 |
-| ├── test_concat.py                             |          64 |
-| ├── test_count.py                              |          37 |
-| ├── test_generic_list.py                       |          95 |
-| ├── test_last.py                               |          29 |
-| ├── test_order_by.py                           |         100 |
-| ├── test_order_descending_by.py                |          45 |
-| ├── test_skip.py                               |          75 |
-| ├── test_sum.py                                |         134 |
-| ├── test_take.py                               |          39 |
-| ├── test_then_by.py                            |          40 |
-| └── test_then_descending_by.py                 |          34 |
-----------------------------------------------------------------
-| GRAND TOTALS                                   |        1434 |
-================================================================
+================================================================================
+| Test Module File                                               |  Test Cases |
+--------------------------------------------------------------------------------
+| tests/nettests/                                                |             |
+| ├── linq/                                                      |             |
+| │   ├── test_aggregate.py                                      |          42 |
+| │   ├── test_all.py                                            |          80 |
+| │   ├── test_any.py                                            |          90 |
+| │   ├── test_average.py                                        |         572 |
+| │   ├── test_concat.py                                         |          64 |
+| │   ├── test_count.py                                          |          37 |
+| │   ├── test_distinct.py                                       |          87 |
+| │   ├── test_element_at.py                                     |          43 |
+| │   ├── test_first.py                                          |          29 |
+| │   ├── test_first_or_default.py                               |          50 |
+| │   ├── test_generic_list.py                                   |          95 |
+| │   ├── test_group_by.py                                       |          23 |
+| │   ├── test_last.py                                           |          29 |
+| │   ├── test_order_by.py                                       |          98 |
+| │   ├── test_order_descending_by.py                            |          45 |
+| │   ├── test_select.py                                         |         140 |
+| │   ├── test_select_many.py                                    |          85 |
+| │   ├── test_single.py                                         |          34 |
+| │   ├── test_single_or_default.py                              |          48 |
+| │   ├── test_skip.py                                           |          75 |
+| │   ├── test_sum.py                                            |         134 |
+| │   ├── test_take.py                                           |          39 |
+| │   ├── test_then_by.py                                        |          40 |
+| │   ├── test_then_descending_by.py                             |          34 |
+| │   └── test_where.py                                          |          76 |
+| └── task/                                                      |             |
+|     ├── test_cancellation.py                                   |          69 |
+|     ├── test_task_completion_source.py                         |          26 |
+|     ├── test_task_factory.py                                   |           3 |
+|     ├── test_task_rt.py                                        |          12 |
+|     └── test_task_rt_core.py                                   |          22 |
+--------------------------------------------------------------------------------
+| GRAND TOTALS                                                   |        2221 |
+================================================================================
 ```

{flpit-0.2.3 → flpit-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flpit"
-version = "0.2.3"
+version = "0.3.0"
 description = "Fluent LINQ for Python — flip your iterables"
 readme = "README.md"
 requires-python = ">=3.12"

{flpit-0.2.3 → flpit-0.3.0}/src/flpit/__init__.py

@@ -1,7 +1,6 @@
 """
 Fluent LINQ for Python — flip your iterables.
 """
-from __future__ import annotations
 from importlib.metadata import version
 __version__ = version("flpit")
 
@@ -9,7 +8,7 @@ from flpit import flp
 from flpit.core.linq import (
     FlpIt,
     FlpList,
-    Grouping,
+    # Grouping,
     OrderedIt,
 
     #====================
@@ -31,11 +30,15 @@ from flpit.core.linq import (
     CollectionNoneError,
     SelectorNoneError,
     SecondNoneError,
+    FuncNoneError,
+    ResultSelectorNoneError,
     ArgumentOutOfRangeError,
     ArgumentNonNegError,
     ArgumentOutOfBoundsError
 )
 
+from flpit.core._grouping import Grouping
+
 __all__ = [
     "flp",
     "FlpIt",
@@ -56,6 +59,8 @@ __all__ = [
     "CollectionNoneError",
     "SelectorNoneError",
     "SecondNoneError",
+    "FuncNoneError",
+    "ResultSelectorNoneError",
     "ArgumentOutOfRangeError",
     "ArgumentNonNegError",
     "ArgumentOutOfBoundsError",

flpit-0.3.0/src/flpit/core/_grouping.py

@@ -0,0 +1,29 @@
+from typing import Any
+from flpit.core.linq import FlpList
+from typing import override
+from collections.abc import Iterable
+
+class Grouping[TKey, TItem](FlpList[TItem]):
+    """Represents a collection of elements sharing a common key (.NET IGrouping<TKey, TElement>)."""
+    __slots__ = ("_key", )
+
+    def __init__(self, key: TKey, elements: Iterable[TItem]) -> None:
+        self._key: TKey = key
+        super().__init__(elements)
+
+    @property
+    def key(self) -> TKey:
+        return self._key
+
+    @override
+    def __repr__(self) -> str:
+        return f"Grouping(key={self.key!r}, elements={self.to_list()!r})"
+
+    @override
+    def __eq__(self, other: Any) -> bool:
+        # Check if the other object is a Grouping (or subclass)
+        if not isinstance(other, Grouping):
+            return False
+
+        # Compare the keys, then compare the elements inside FlpIt
+        return self.key == other.key and self.to_list() == other.to_list()

{flpit-0.2.3 → flpit-0.3.0}/src/flpit/core/linq.py

@@ -100,6 +100,14 @@ class SecondNoneError(ArgumentNullError):
     def __init__(self):
         super().__init__("second")
 
+class FuncNoneError(ArgumentNullError):
+    def __init__(self):
+        super().__init__("func")
+
+class ResultSelectorNoneError(ArgumentNullError):
+    def __init__(self):
+        super().__init__("resultSelector")
+
 class ArgumentOutOfRangeError(ArgumentError):
     def __init__(self, argument: str, pattern:str="Index was out of range. Must be non-negative and less than the size of the collection."):
         super().__init__(f"{pattern} (Parameter '{argument}')")
@@ -257,6 +265,9 @@ class FlpIt[TItem](Iterable[TItem]):
 
     def where(self, predicate: Callable[[TItem], bool]) -> FlpIt[TItem]:
         """Filters elements based on a predicate."""
+        if predicate is None:
+            raise PredicateNoneError()
+
         def _generator() -> Iterator[TItem]:
             for item in self:
                 if predicate(item):
@@ -266,6 +277,9 @@ class FlpIt[TItem](Iterable[TItem]):
 
     def select[TResult](self, selector: Callable[[TItem], TResult]) -> FlpIt[TResult]:
         """Projects each element into a new form."""
+        if selector is None:
+            raise SelectorNoneError()
+
         def _generator() -> Iterator[TResult]:
             for item in self:
                 yield selector(item)
@@ -276,6 +290,9 @@ class FlpIt[TItem](Iterable[TItem]):
             self, selector: Callable[[TItem], Iterable[TResult]]
     ) -> FlpIt[TResult]:
         """Flattens sequence projections."""
+        if selector is None:
+            raise SelectorNoneError()
+
         def _generator() -> Iterator[TResult]:
             for item in self:
                 yield from selector(item)
@@ -353,6 +370,9 @@ class FlpIt[TItem](Iterable[TItem]):
             self, key_selector: Callable[[TItem], TKey]
     ) -> FlpIt[TItem]:
         """Returns distinct elements from a sequence according to a key selector function."""
+        if key_selector is None:
+            raise SelectorNoneError()
+
         def _generator() -> Iterator[TItem]:
             seen: Set[TKey] = set()
             for item in self:
@@ -421,6 +441,9 @@ class FlpIt[TItem](Iterable[TItem]):
             self, key_selector: Callable[[TItem], TKey]
     ) -> FlpIt[Grouping[TKey, TItem]]:
         """Groups elements according to a specified key selector function."""
+        if key_selector is None:
+            raise SelectorNoneError()
+
         def _generator() -> Iterator[Grouping[TKey, TItem]]:
             groups: dict[TKey, List[TItem]] = {}
             for item in self:
@@ -434,31 +457,66 @@ class FlpIt[TItem](Iterable[TItem]):
     # --- Immediate Execution (Materialization & Aggregation) ---
 
     @overload
-    def aggregate(self, func: Callable[[TItem, TItem], TItem]) -> TItem: ...
+    def aggregate(self, func: Callable[[TItem, TItem], TItem], /) -> TItem: ...
 
     @overload
     def aggregate(
-            self, func: Callable[[TAccumulate, TItem], TAccumulate], seed: TAccumulate
+            self, seed: TAccumulate, func: Callable[[TAccumulate, TItem], TAccumulate], /
     ) -> TAccumulate: ...
 
-    def aggregate(
+    @overload
+    def aggregate[TAcc, TResult](
             self,
-            func: Callable[[Any, Any], Any],
-            seed: Any = _SENTINEL,
-    ) -> TItem | TAccumulate:
-        """Applies an accumulator function over a sequence."""
+            seed: TAcc,
+            func: Callable[[TAcc, TItem], TAcc],
+            result_selector: Callable[[TAcc], TResult],
+            /,
+    ) -> TResult: ...
+
+    def aggregate(self, *args: Any) -> Any:
+        """Applies an accumulator function over a sequence.
+
+        aggregate(func)                         first element is the seed; raises
+                                                EmptySequenceError for an empty source
+        aggregate(seed, func)                   seed is the initial accumulator
+        aggregate(seed, func, result_selector)  result_selector is applied to the
+                                                final accumulator value
+        """
+        if len(args) == 1:
+            (func,) = args
+            has_seed = False
+            seed = None
+            result_selector = _SENTINEL
+        elif len(args) == 2:
+            seed, func = args
+            has_seed = True
+            result_selector = _SENTINEL
+        elif len(args) == 3:
+            seed, func, result_selector = args
+            has_seed = True
+        else:
+            raise TypeError(
+                f"aggregate() takes from 1 to 3 positional arguments but {len(args)} were given"
+            )
+
+        if func is None:
+            raise FuncNoneError()
+        if result_selector is None:
+            raise ResultSelectorNoneError()
+
         it = iter(self)
-        if seed is _SENTINEL:
+        if has_seed:
+            accumulator = seed
+        else:
             try:
                 accumulator = next(it)
             except StopIteration:
                 raise EmptySequenceError()
-            for item in it:
-                accumulator = func(accumulator, item)
-        else:
-            accumulator = seed
-            for item in it:
-                accumulator = func(accumulator, item)
+        for item in it:
+            accumulator = func(accumulator, item)
+
+        if result_selector is not _SENTINEL:
+            return result_selector(accumulator)
         return accumulator
 
     @overload
@@ -632,6 +690,51 @@ class FlpIt[TItem](Iterable[TItem]):
 
         raise MultipleMatchesError() if has_predicate else MultipleElementsError()
 
+    def single_or_default[TResult](
+            self,
+            default: TResult,
+            predicate: Callable[[TItem], bool] | _Sentinel = _SENTINEL,
+    ) -> TItem | TResult:
+        """Returns the single matching element, or the specified default."""
+        try:
+            return self.single(predicate)
+        except (EmptySequenceError, NoMatchError):
+            return default
+
+    @overload
+    def to_dictionary[TKey](
+            self, key_selector: Callable[[TItem], TKey], /
+    ) -> dict[TKey, TItem]: ...
+
+    @overload
+    def to_dictionary[TKey, TValue](
+            self,
+            key_selector: Callable[[TItem], TKey],
+            element_selector: Callable[[TItem], TValue],
+            /,
+    ) -> dict[TKey, TValue]: ...
+
+    def to_dictionary(
+            self,
+            key_selector: Callable[[TItem], Any],
+            element_selector: Callable[[TItem], Any] | _Sentinel = _SENTINEL,
+    ) -> dict[Any, Any]:
+        """Materializes the sequence as a dictionary using the selected key and optional value."""
+        if key_selector is None:
+            raise SelectorNoneError()
+        if element_selector is None:
+            raise SelectorNoneError()
+
+        result: dict[Any, Any] = {}
+        for item in self:
+            key = key_selector(item)
+            if key in result:
+                raise ValueError(f"An item with the same key has already been added. Key: {key!r}")
+            value = item if element_selector is _SENTINEL else element_selector(item)
+            result[key] = value
+
+        return result
+
     def to_list(self) -> FlpList[TItem]:
         """Explicitly materializes the query into a FlpList."""
         return FlpList[TItem](self)
@@ -744,30 +847,6 @@ class OrderedIt[TItem](FlpIt[TItem]):
         )
 
 
-class Grouping[TKey, TItem](FlpIt[TItem]):
-    """Represents a collection of elements sharing a common key (.NET IGrouping<TKey, TElement>)."""
-    __slots__ = ("_key", )
-
-    def __init__(self, key: TKey, elements: Iterable[TItem]) -> None:
-        self._key: TKey = key
-        super().__init__(elements)
-
-    @property
-    def key(self) -> TKey:
-        return self._key
-
-    def __repr__(self) -> str:
-        return f"Grouping(key={self.key!r}, elements={self.to_list()!r})"
-
-    def __eq__(self, other: Any) -> bool:
-        # Check if the other object is a Grouping (or subclass)
-        if not isinstance(other, Grouping):
-            return False
-
-        # Compare the keys, then compare the elements inside FlpIt
-        return self.key == other.key and self.to_list() == other.to_list()
-
-
 class FlpList[TItem](Collection[TItem]):
     """
     | Fluent List
@@ -1110,19 +1189,24 @@ class FlpList[TItem](Collection[TItem]):
         return FlpIt(self.__list.data).group_by(key_selector)
 
     @overload
-    def aggregate(self, func: Callable[[TItem, TItem], TItem]) -> TItem: ...
+    def aggregate(self, func: Callable[[TItem, TItem], TItem], /) -> TItem: ...
 
     @overload
     def aggregate(
-            self, func: Callable[[TAccumulate, TItem], TAccumulate], seed: TAccumulate
+            self, seed: TAccumulate, func: Callable[[TAccumulate, TItem], TAccumulate], /
     ) -> TAccumulate: ...
 
-    def aggregate(
+    @overload
+    def aggregate[TAcc, TResult](
             self,
-            func: Callable[[Any, Any], Any],
-            seed: Any = _SENTINEL,
-    ) -> TItem | TAccumulate:
-        return FlpIt(self.__list.data).aggregate(func, seed=seed)
+            seed: TAcc,
+            func: Callable[[TAcc, TItem], TAcc],
+            result_selector: Callable[[TAcc], TResult],
+            /,
+    ) -> TResult: ...
+
+    def aggregate(self, *args: Any) -> Any:
+        return FlpIt(self.__list.data).aggregate(*args)
 
     @_guard_empty
     def min(self) -> TItem:
@@ -1219,6 +1303,36 @@ class FlpList[TItem](Collection[TItem]):
     def single(self, predicate: Callable[[TItem], bool] | _Sentinel = _SENTINEL) -> TItem:
         return FlpIt(self.__list.data).single(predicate)
 
+    def single_or_default[TResult](
+            self,
+            default: TResult,
+            predicate: Callable[[TItem], bool] | _Sentinel = _SENTINEL,
+    ) -> TItem | TResult:
+        return FlpIt(self.__list.data).single_or_default(default, predicate)
+
+    @overload
+    def to_dictionary[TKey](
+            self, key_selector: Callable[[TItem], TKey], /
+    ) -> dict[TKey, TItem]: ...
+
+    @overload
+    def to_dictionary[TKey, TValue](
+            self,
+            key_selector: Callable[[TItem], TKey],
+            element_selector: Callable[[TItem], TValue],
+            /,
+    ) -> dict[TKey, TValue]: ...
+
+    def to_dictionary(
+            self,
+            key_selector: Callable[[TItem], Any],
+            element_selector: Callable[[TItem], Any] | _Sentinel = _SENTINEL,
+    ) -> dict[Any, Any]:
+        return FlpIt(self.__list.data).to_dictionary(key_selector, element_selector)
+
+    def to_list(self) -> FlpList[TItem]:
+        """Explicitly returns a shallow copy instance to isolate mutations."""
+        return FlpList(self.__list.data.copy())
     def to_list(self) -> FlpList[TItem]:
         """Explicitly returns a shallow copy instance to isolate mutations."""
         return FlpList(self.__list.data.copy())
@@ -1243,4 +1357,7 @@ class FlpList[TItem](Collection[TItem]):
             output: BinaryIO,
             jso: JsonSerializerOptions | None = None,
     ) -> None:
-        JsonConvert.serialize_to(self, item_type, output, jso)
+        JsonConvert.serialize_to(self, item_type, output, jso)
+
+# I hate it, but Python being Python
+from ._grouping import Grouping