fluently 0.9.0__tar.gz → 0.9.1__tar.gz

{fluently-0.9.0 → fluently-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fluently
-Version: 0.9.0
+Version: 0.9.1
 Summary: Fluent data type container implementations for Python.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -55,7 +55,7 @@ using `pip` via the `pip install` command by entering the following into your sh
 
 To use the Fluently library, import the library and the data type or data types you
 need and use them just like their regular counterparts, with the knowledge that they
-support setting and getting values without regard to the casing of any string keys:
+support fluent interfaces which can often be more convenient and expressive to use:
 
 #### Fluent List
 
@@ -125,16 +125,16 @@ from fluently import fluenttuple, flutuple, ftuple
 # Create a new fluenttuple instance
 data = fluenttuple(["A", "B", "C"])
 
-# Assert that the set has the expected class identity, aliases and superclass
+# Assert that the tuple has the expected class identity, aliases and superclass
 assert isinstance(data, fluenttuple)
 assert isinstance(data, flutuple)
 assert isinstance(data, ftuple)
 assert isinstance(data, tuple)
 
-# Assert that the set has the expected length
+# Assert that the tuple has the expected length
 assert data.length() == len(data) == 3
 
-# Assert that the set has the expected contents
+# Assert that the tuple has the expected contents
 assert "A" in data
 assert "B" in data
 assert "C" in data
@@ -169,7 +169,7 @@ by the `list` superclass:
  further chaining, but can be used as the last call on chain of other `fluentlist` methods
  that do support chaining.
 
- * `clone()` (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
  current list, that contains the same items, in a separate `fluentlist` instance.
 
  * `prepend(item: object)` 🔗 (`fluentlist`) – The `prepend()` method supports prepending
@@ -289,10 +289,10 @@ by the `list` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluentlist`)
  – The `filter()` method supports filtering the contents of the current list in the two
  ways noted below, and returns the filtered results as a new list:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the list is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the list must match to be included in the output. Each item
   in the list will be inspected to see if has the specified attribute (as per the keyword
@@ -399,7 +399,7 @@ by the `set` superclass:
  further chaining, but can be used as the last call on chain of other `fluentset` methods
  that do support chaining.
 
- * `clone()` (`fluentset`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentset`) – The `clone()` method supports creating a cloned copy of the
  current set, that contains the same items, in a separate `fluentset` instance.
 
  * `add(item: object)` 🔗 (`fluentset`) – The `add()` method supports adding the specified
@@ -438,7 +438,7 @@ by the `tuple` superclass:
  further chaining, but can be used as the last call on chain of other `fluenttuple` methods
  that do support chaining.
 
- * `clone()` (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
+ * `clone()` 🔗 (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
  the current tuple, that contains the same items, in a separate `fluenttuple` instance.
 
  * `add(item: object)` 🔗 (`fluenttuple`) – The `add()` method supports appending the
@@ -544,10 +544,10 @@ by the `tuple` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluenttuple`)
  – The `filter()` method supports filtering the contents of the current tuple in the two
  ways noted below, and returns the filtered results as a new tuple:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the tuple is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the tuple must match to be included in the output. Each item
   in the tuple will be inspected to see if has the specified attribute (as per the keyword
@@ -667,4 +667,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2025-2026 Daniel Sissman; licensed under the MIT License.

{fluently-0.9.0 → fluently-0.9.1}/README.md

@@ -24,7 +24,7 @@ using `pip` via the `pip install` command by entering the following into your sh
 
 To use the Fluently library, import the library and the data type or data types you
 need and use them just like their regular counterparts, with the knowledge that they
-support setting and getting values without regard to the casing of any string keys:
+support fluent interfaces which can often be more convenient and expressive to use:
 
 #### Fluent List
 
@@ -94,16 +94,16 @@ from fluently import fluenttuple, flutuple, ftuple
 # Create a new fluenttuple instance
 data = fluenttuple(["A", "B", "C"])
 
-# Assert that the set has the expected class identity, aliases and superclass
+# Assert that the tuple has the expected class identity, aliases and superclass
 assert isinstance(data, fluenttuple)
 assert isinstance(data, flutuple)
 assert isinstance(data, ftuple)
 assert isinstance(data, tuple)
 
-# Assert that the set has the expected length
+# Assert that the tuple has the expected length
 assert data.length() == len(data) == 3
 
-# Assert that the set has the expected contents
+# Assert that the tuple has the expected contents
 assert "A" in data
 assert "B" in data
 assert "C" in data
@@ -138,7 +138,7 @@ by the `list` superclass:
  further chaining, but can be used as the last call on chain of other `fluentlist` methods
  that do support chaining.
 
- * `clone()` (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
  current list, that contains the same items, in a separate `fluentlist` instance.
 
  * `prepend(item: object)` 🔗 (`fluentlist`) – The `prepend()` method supports prepending
@@ -258,10 +258,10 @@ by the `list` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluentlist`)
  – The `filter()` method supports filtering the contents of the current list in the two
  ways noted below, and returns the filtered results as a new list:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the list is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the list must match to be included in the output. Each item
   in the list will be inspected to see if has the specified attribute (as per the keyword
@@ -368,7 +368,7 @@ by the `set` superclass:
  further chaining, but can be used as the last call on chain of other `fluentset` methods
  that do support chaining.
 
- * `clone()` (`fluentset`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentset`) – The `clone()` method supports creating a cloned copy of the
  current set, that contains the same items, in a separate `fluentset` instance.
 
  * `add(item: object)` 🔗 (`fluentset`) – The `add()` method supports adding the specified
@@ -407,7 +407,7 @@ by the `tuple` superclass:
  further chaining, but can be used as the last call on chain of other `fluenttuple` methods
  that do support chaining.
 
- * `clone()` (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
+ * `clone()` 🔗 (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
  the current tuple, that contains the same items, in a separate `fluenttuple` instance.
 
  * `add(item: object)` 🔗 (`fluenttuple`) – The `add()` method supports appending the
@@ -513,10 +513,10 @@ by the `tuple` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluenttuple`)
  – The `filter()` method supports filtering the contents of the current tuple in the two
  ways noted below, and returns the filtered results as a new tuple:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the tuple is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the tuple must match to be included in the output. Each item
   in the tuple will be inspected to see if has the specified attribute (as per the keyword
@@ -636,4 +636,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2025-2026 Daniel Sissman; licensed under the MIT License.

{fluently-0.9.0 → fluently-0.9.1}/source/fluently/list.py

@@ -292,7 +292,7 @@ class fluentlist(list):
     ) -> object | None:
         """Supports returning the first element or None if the list is empty."""
 
-        if len(filters) > 0:
+        if callable(predicate) or len(filters) > 0:
             items = self.filter(predicate=predicate, **filters)
         else:
             items = self
@@ -304,7 +304,7 @@ class fluentlist(list):
     ) -> object | None:
         """Supports returning the last element or None if the list is empty."""
 
-        if len(filters) > 0:
+        if callable(predicate) or len(filters) > 0:
             items = self.filter(predicate=predicate, **filters)
         else:
             items = self

{fluently-0.9.0 → fluently-0.9.1}/source/fluently/tuple.py

@@ -282,5 +282,6 @@ class fluenttuple(tuple):
 
         return self.remove(item)
 
+
 # Shorthand aliases
 ftuple = flutuple = fluenttuple

fluently-0.9.1/source/fluently/version.txt

@@ -0,0 +1 @@
+0.9.1

{fluently-0.9.0 → fluently-0.9.1}/source/fluently.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fluently
-Version: 0.9.0
+Version: 0.9.1
 Summary: Fluent data type container implementations for Python.
 Author: Daniel Sissman
 License-Expression: MIT
@@ -55,7 +55,7 @@ using `pip` via the `pip install` command by entering the following into your sh
 
 To use the Fluently library, import the library and the data type or data types you
 need and use them just like their regular counterparts, with the knowledge that they
-support setting and getting values without regard to the casing of any string keys:
+support fluent interfaces which can often be more convenient and expressive to use:
 
 #### Fluent List
 
@@ -125,16 +125,16 @@ from fluently import fluenttuple, flutuple, ftuple
 # Create a new fluenttuple instance
 data = fluenttuple(["A", "B", "C"])
 
-# Assert that the set has the expected class identity, aliases and superclass
+# Assert that the tuple has the expected class identity, aliases and superclass
 assert isinstance(data, fluenttuple)
 assert isinstance(data, flutuple)
 assert isinstance(data, ftuple)
 assert isinstance(data, tuple)
 
-# Assert that the set has the expected length
+# Assert that the tuple has the expected length
 assert data.length() == len(data) == 3
 
-# Assert that the set has the expected contents
+# Assert that the tuple has the expected contents
 assert "A" in data
 assert "B" in data
 assert "C" in data
@@ -169,7 +169,7 @@ by the `list` superclass:
  further chaining, but can be used as the last call on chain of other `fluentlist` methods
  that do support chaining.
 
- * `clone()` (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentlist`) – The `clone()` method supports creating a cloned copy of the
  current list, that contains the same items, in a separate `fluentlist` instance.
 
  * `prepend(item: object)` 🔗 (`fluentlist`) – The `prepend()` method supports prepending
@@ -289,10 +289,10 @@ by the `list` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluentlist`)
  – The `filter()` method supports filtering the contents of the current list in the two
  ways noted below, and returns the filtered results as a new list:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the list is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the list must match to be included in the output. Each item
   in the list will be inspected to see if has the specified attribute (as per the keyword
@@ -399,7 +399,7 @@ by the `set` superclass:
  further chaining, but can be used as the last call on chain of other `fluentset` methods
  that do support chaining.
 
- * `clone()` (`fluentset`) – The `clone()` method supports creating a cloned copy of the
+ * `clone()` 🔗 (`fluentset`) – The `clone()` method supports creating a cloned copy of the
  current set, that contains the same items, in a separate `fluentset` instance.
 
  * `add(item: object)` 🔗 (`fluentset`) – The `add()` method supports adding the specified
@@ -438,7 +438,7 @@ by the `tuple` superclass:
  further chaining, but can be used as the last call on chain of other `fluenttuple` methods
  that do support chaining.
 
- * `clone()` (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
+ * `clone()` 🔗 (`fluenttuple`) – The `clone()` method supports creating a cloned copy of
  the current tuple, that contains the same items, in a separate `fluenttuple` instance.
 
  * `add(item: object)` 🔗 (`fluenttuple`) – The `add()` method supports appending the
@@ -544,10 +544,10 @@ by the `tuple` superclass:
  * `filter(predicate: callable = None, **filters: dict[str, object])` 🔗 (`fluenttuple`)
  – The `filter()` method supports filtering the contents of the current tuple in the two
  ways noted below, and returns the filtered results as a new tuple:
-  - filtering can be performed via a `predicate` callable method that takes as input the
+   - filtering can be performed via a `predicate` callable method that takes as input the
   current item as the tuple is iterated over, where the `predicate` must return `True` for
   items that should remain in the output, and `False` otherwise;
-  - alternatively, filtering can be performed via one or more keyword arguments, excepting
+   - alternatively, filtering can be performed via one or more keyword arguments, excepting
   the reserved `predicate` keyword, which define the names and values of object attributes
   that the item objects held in the tuple must match to be included in the output. Each item
   in the tuple will be inspected to see if has the specified attribute (as per the keyword
@@ -667,4 +667,4 @@ See the documentation for [PyTest](https://docs.pytest.org/en/latest/) regarding
 
 ### Copyright & License Information
 
-Copyright © 2025 Daniel Sissman; licensed under the MIT License.
+Copyright © 2025-2026 Daniel Sissman; licensed under the MIT License.

{fluently-0.9.0 → fluently-0.9.1}/tests/test_list.py

@@ -371,6 +371,7 @@ def test_fluent_list_unique(numbers: fluentlist[int]):
     # values appeared in the original list:
     assert numbers.unique() == newnumbers
 
+
 def test_fluent_list_sort(numbers: fluentlist[int]):
     """Test the 'sort' method of the 'fluentlist' class."""
 

{fluently-0.9.0 → fluently-0.9.1}/tests/test_set.py

@@ -134,6 +134,7 @@ def test_fluent_set_remove():
 
     assert not "D" in letters
 
+
 def test_fluent_set_discard():
     """Test the 'discard' method of the 'fluentset' class."""
 
@@ -160,6 +161,7 @@ def test_fluent_set_discard():
 
     assert not "D" in letters
 
+
 def test_fluent_set_clear():
     """Test the 'clear' method of the 'fluentset' class."""
 

{fluently-0.9.0 → fluently-0.9.1}/tests/test_tuple.py

@@ -447,7 +447,6 @@ def test_fluent_tuple_all():
     assert newletters.count("D") == 2
 
 
-
 def test_fluent_tuple_map(numbers: fluenttuple[int]):
     """Test the 'map' method of the 'fluenttuple' class."""
 
@@ -762,4 +761,3 @@ def test_fluent_tuple_last_with_empty_tuple(things: fluenttuple[Thing]):
 
     # When the tuple is empty, we expect .last() to return None
     assert thing is None
-

fluently-0.9.0/source/fluently/version.txt

@@ -1 +0,0 @@
-0.9.0