plexus-python-common 1.1.83__py3-none-any.whl → 1.1.84__py3-none-any.whl

plexus/common/utils/iterutils.py

@@ -557,9 +557,9 @@ def dicttree_value[K, V](tree: dicttree[K, V], path: list[K]) -> V | None:
     """
     Gets the value stored at the specified path in the dicttree.
 
-    :param tree: the dicttree to retrieve the value from.
-    :param path: the list of keys representing the path to the desired value.
-    :return: the value at the specified path, or ``None`` if the path does not exist.
+    :param tree: The dicttree to retrieve the value from.
+    :param path: The list of keys representing the path to the desired value.
+    :return: The value at the specified path, or ``None`` if the path does not exist.
     """
     value = None
     for key in path:
@@ -573,9 +573,9 @@ def dicttree_subtree[K, V](tree: dicttree[K, V], path: list[K]) -> dicttree[K, V
     """
     Gets the subtree located at the specified path in the dicttree.
 
-    :param tree: the dicttree to retrieve the subtree from.
-    :param path: the list of keys representing the path to the desired subtree.
-    :return: the subtree at the specified path, or ``None`` if the path does not exist.
+    :param tree: The dicttree to retrieve the subtree from.
+    :param path: The list of keys representing the path to the desired subtree.
+    :return: The subtree at the specified path, or ``None`` if the path does not exist.
     """
     for key in path:
         if key not in tree:
@@ -588,9 +588,9 @@ def dicttree_children[K, V](tree: dicttree[K, V], *, leaves_only: bool = False)
     """
     Yields all values in the dicttree. If ``leaves_only`` is ``True``, only yields values at leaf nodes.
 
-    :param tree: the dicttree to traverse.
-    :param leaves_only: whether to yield only values at leaf nodes.
-    :return: a generator yielding all values in the dicttree.
+    :param tree: The dicttree to traverse.
+    :param leaves_only: Whether to yield only values at leaf nodes.
+    :return: A generator yielding all values in the dicttree.
     """
     for value, subtree in tree.values():
         if value is not None and (not leaves_only or not subtree):
@@ -602,9 +602,9 @@ def dicttree_lineage[K, V](tree: dicttree[K, V], path: list[K]) -> Generator[V,
     """
     Yields all values along the specified path in the dicttree.
 
-    :param tree: the dicttree to traverse.
-    :param path: the list of keys representing the path to follow.
-    :return: a generator yielding all values along the specified path.
+    :param tree: The dicttree to traverse.
+    :param path: The list of keys representing the path to follow.
+    :return: A generator yielding all values along the specified path.
     """
     for key in path:
         if key not in tree:
@@ -618,9 +618,9 @@ def dicttree_make[K, V](tree: dicttree[K, V], path: list[K]) -> dicttree[K, V]:
     """
     Ensures that the specified path exists in the dicttree, creating any missing nodes along the way.
 
-    :param tree: the dicttree to modify.
-    :param path: the list of keys representing the path to create.
-    :return: the subtree at the end of the created path.
+    :param tree: The dicttree to modify.
+    :param path: The list of keys representing the path to create.
+    :return: The subtree at the end of the created path.
     """
     for key in path:
         tree.setdefault(key, (None, {}))
@@ -640,12 +640,12 @@ def dicttree_add[K, V](
     Adds a value at the specified path in the dicttree. If ``create_prefix`` is ``True``, any missing nodes along the
     path are created. If ``overwrite`` is ``False``, raises an error if the path already exists.
 
-    :param tree: the dicttree to modify.
-    :param path: the list of keys representing the path to add the value to.
-    :param value: the value to add at the specified path.
-    :param create_prefix: whether to create missing nodes along the path.
-    :param overwrite: whether to overwrite an existing value at the path.
-    :return: the modified dicttree.
+    :param tree: The dicttree to modify.
+    :param path: The list of keys representing the path to add the value to.
+    :param value: The value to add at the specified path.
+    :param create_prefix: Whether to create missing nodes along the path.
+    :param overwrite: Whether to overwrite an existing value at the path.
+    :return: The modified dicttree.
     """
     if len(path) == 0:
         raise ValueError("path cannot be empty")
@@ -673,10 +673,10 @@ def dicttree_remove[K, V](
     Removes the value at the specified path in the dicttree. If ``recursive`` is ``True``, removes the entire subtree
     at that path; otherwise, only removes the value, leaving any child nodes intact.
 
-    :param tree: the dicttree to modify.
-    :param path: the list of keys representing the path to remove the value from.
-    :param recursive: whether to remove the entire subtree at the path.
-    :return: the modified dicttree.
+    :param tree: The dicttree to modify.
+    :param path: The list of keys representing the path to remove the value from.
+    :param recursive: Whether to remove the entire subtree at the path.
+    :return: The modified dicttree.
     """
     if len(path) == 0:
         raise ValueError("path cannot be empty")
@@ -695,8 +695,8 @@ def dicttree_purge[K, V](tree: dicttree[K, V]) -> dicttree[K, V]:
     """
     Recursively removes all nodes in the dicttree that have no value and no children.
 
-    :param tree: the dicttree to purge.
-    :return: the purged dicttree.
+    :param tree: The dicttree to purge.
+    :return: The purged dicttree.
     """
     for key in list(tree.keys()):
         value, subtree = tree[key]

{plexus_python_common-1.1.83.dist-info → plexus_python_common-1.1.84.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python-common
-Version: 1.1.83
+Version: 1.1.84
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13

{plexus_python_common-1.1.83.dist-info → plexus_python_common-1.1.84.dist-info}/RECORD

@@ -6,7 +6,7 @@ plexus/common/utils/csvutils.py,sha256=quGN_F-WxtznhCLqst2coXaK-DVgxzwe2FA0qiisk
 plexus/common/utils/dbutils.py,sha256=0GhnW1P1fJsqB4NjS4V6R-oV8d4R-ZZzi-IpiZCRjAs,16575
 plexus/common/utils/dtutils.py,sha256=A_upNJJJ3q6e3QZ2m5jXkDLwpAtUU9lEBY2MotAV5aY,12229
 plexus/common/utils/funcutils.py,sha256=5ciB_kiASUfQelRkKrtNkRru7E7835e5g-8j33Qb8V4,9789
-plexus/common/utils/iterutils.py,sha256=Ct8JMCo_aIqI4_scF3o9gUCZvlYxkulNWJlGdufxcb8,30988
+plexus/common/utils/iterutils.py,sha256=JL8j8plIoc2hF8D-BY6dOHEBoeoFZ1nLrhw4dFth_lA,30988
 plexus/common/utils/jsonutils.py,sha256=BDtqkvmWHiVFo4d5nGkmFtC00JQkGLC7ybchrpID5pU,18529
 plexus/common/utils/logger.py,sha256=FJaai6Sbchy4wKHcUMUCrrkBcXvIxq4qByERZ_TJBps,3881
 plexus/common/utils/numutils.py,sha256=p6Rz1qyCcUru3v1zDy2PM-nds2NWJdL5A_vLmG-kswk,4294
@@ -17,7 +17,7 @@ plexus/common/utils/span.py,sha256=RqgUuupN01xCjm4l5uxrr8BFFrUrytRVGihmENUawpk,6
 plexus/common/utils/strutils.py,sha256=PGOSYRgTnQcP0YXORzeTpiU9RweInxd5f6YcIHm6yiY,5096
 plexus/common/utils/testutils.py,sha256=D-EvK-Og8chyiks377PGDjqYid-l4F4Xfq9Q4yzrJtM,5441
 plexus/common/utils/typeutils.py,sha256=RVkYkFRgDrx77OHFH7PavMV0AIB0S8ly40rs4g7JWE4,8220
-plexus_python_common-1.1.83.dist-info/METADATA,sha256=G-IQyqrs6j0FZ69iSnoPnDacONBu7lk9GNRth2RTRr4,871
-plexus_python_common-1.1.83.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-plexus_python_common-1.1.83.dist-info/top_level.txt,sha256=ug_g7CVwaMQuas5UzAXbHUrQvKGCn8ezc6ZNvvRlJOE,7
-plexus_python_common-1.1.83.dist-info/RECORD,,
+plexus_python_common-1.1.84.dist-info/METADATA,sha256=R5q4cnQLocbTnpHRWc98ORvSirQ8Af92mTo5Auez84o,871
+plexus_python_common-1.1.84.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+plexus_python_common-1.1.84.dist-info/top_level.txt,sha256=ug_g7CVwaMQuas5UzAXbHUrQvKGCn8ezc6ZNvvRlJOE,7
+plexus_python_common-1.1.84.dist-info/RECORD,,