haiway 0.10.10__py3-none-any.whl → 0.10.11__py3-none-any.whl

haiway/utils/collections.py

@@ -1,4 +1,5 @@
 from collections.abc import Mapping, Sequence, Set
+from typing import overload
 
 __all__ = [
     "as_dict",
@@ -8,24 +9,43 @@ __all__ = [
 ]
 
 
+@overload
 def as_list[T](
     collection: Sequence[T],
     /,
-) -> list[T]:
+) -> list[T]: ...
+
+
+@overload
+def as_list[T](
+    collection: Sequence[T] | None,
+    /,
+) -> list[T] | None: ...
+
+
+def as_list[T](
+    collection: Sequence[T] | None,
+    /,
+) -> list[T] | None:
     """
     Converts any given Sequence into a list.
 
     Parameters
     ----------
-    collection : Sequence[T]
+    collection : Sequence[T] | None
         The input collection to be converted.
 
     Returns
     -------
-    list[T]
-        A new list containing all elements of the input collection,
-        or the original list if it was already one.
+    list[T] | None
+        A new list containing all elements of the input collection,\
+         or the original list if it was already one.
+        None if no value was provided.
     """
+
+    if collection is None:
+        return None
+
     if isinstance(collection, list):
         return collection
 
@@ -33,24 +53,43 @@ def as_list[T](
         return list(collection)
 
 
+@overload
 def as_tuple[T](
     collection: Sequence[T],
     /,
-) -> tuple[T, ...]:
+) -> tuple[T, ...]: ...
+
+
+@overload
+def as_tuple[T](
+    collection: Sequence[T] | None,
+    /,
+) -> tuple[T, ...] | None: ...
+
+
+def as_tuple[T](
+    collection: Sequence[T] | None,
+    /,
+) -> tuple[T, ...] | None:
     """
     Converts any given Sequence into a tuple.
 
     Parameters
     ----------
-    collection : Sequence[T]
+    collection : Sequence[T] | None
         The input collection to be converted.
 
     Returns
     -------
-    tuple[T]
-        A new tuple containing all elements of the input collection,
-        or the original tuple if it was already one.
+    tuple[T] | None
+        A new tuple containing all elements of the input collection,\
+         or the original tuple if it was already one.
+        None if no value was provided.
     """
+
+    if collection is None:
+        return None
+
     if isinstance(collection, tuple):
         return collection
 
@@ -58,10 +97,24 @@ def as_tuple[T](
         return tuple(collection)
 
 
+@overload
 def as_set[T](
     collection: Set[T],
     /,
-) -> set[T]:
+) -> set[T]: ...
+
+
+@overload
+def as_set[T](
+    collection: Set[T] | None,
+    /,
+) -> set[T] | None: ...
+
+
+def as_set[T](
+    collection: Set[T] | None,
+    /,
+) -> set[T] | None:
     """
     Converts any given Set into a set.
 
@@ -73,9 +126,14 @@ def as_set[T](
     Returns
     -------
     set[T]
-        A new set containing all elements of the input collection,
-        or the original set if it was already one.
+        A new set containing all elements of the input collection,\
+         or the original set if it was already one.
+        None if no value was provided.
     """
+
+    if collection is None:
+        return None
+
     if isinstance(collection, set):
         return collection
 
@@ -83,10 +141,24 @@ def as_set[T](
         return set(collection)
 
 
+@overload
 def as_dict[K, V](
     collection: Mapping[K, V],
     /,
-) -> dict[K, V]:
+) -> dict[K, V]: ...
+
+
+@overload
+def as_dict[K, V](
+    collection: Mapping[K, V] | None,
+    /,
+) -> dict[K, V] | None: ...
+
+
+def as_dict[K, V](
+    collection: Mapping[K, V] | None,
+    /,
+) -> dict[K, V] | None:
     """
     Converts any given Mapping into a dict.
 
@@ -98,9 +170,14 @@ def as_dict[K, V](
     Returns
     -------
     dict[K, V]
-        A new dict containing all elements of the input collection,
-        or the original dict if it was already one.
+        A new dict containing all elements of the input collection,\
+         or the original dict if it was already one.
+        None if no value was provided.
     """
+
+    if collection is None:
+        return None
+
     if isinstance(collection, dict):
         return collection
 

{haiway-0.10.10.dist-info → haiway-0.10.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.10.10
+Version: 0.10.11
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Project-URL: Homepage, https://miquido.com
 Project-URL: Repository, https://github.com/miquido/haiway.git

{haiway-0.10.10.dist-info → haiway-0.10.11.dist-info}/RECORD

@@ -29,14 +29,14 @@ haiway/types/frozen.py,sha256=CZhFCXnWAKEhuWSfILxA8smfdpMd5Ku694ycfLh98R8,76
 haiway/types/missing.py,sha256=rDnyA2wxPkTbJl0L-zbo0owp7IJ04xkCIp6xD6wh8NI,1712
 haiway/utils/__init__.py,sha256=O7qmAmUktX-X_5D1L5FJMeCFEiOVrrnyYSyiycm4nyg,739
 haiway/utils/always.py,sha256=2abp8Lm9rQkrfS3rm1Iqhb-IcWyVfH1BULab3KMxgOw,1234
-haiway/utils/collections.py,sha256=_MwB4o8sCZeAjrwry8Pu9JvGlt8m7O7MqWSFFmPjJ6k,2120
+haiway/utils/collections.py,sha256=pKHZhXqTMcOth7gV6mXcC5WcSyBl70MmVIELbDSmMoA,3320
 haiway/utils/env.py,sha256=vlW21LEp8uOVNnUXpBfPtj3zKi9Kkjoemb_H5hQpYPQ,4433
 haiway/utils/freezing.py,sha256=K34ZIMzbkpgkHKH-KF73plEbXExsajNRkRTYp9nJEf4,620
 haiway/utils/logs.py,sha256=oDsc1ZdqKDjlTlctLbDcp9iX98Acr-1tdw-Pyg3DElo,1577
 haiway/utils/mimic.py,sha256=BkVjTVP2TxxC8GChPGyDV6UXVwJmiRiSWeOYZNZFHxs,1828
 haiway/utils/noop.py,sha256=qgbZlOKWY6_23Zs43OLukK2HagIQKRyR04zrFVm5rWI,344
 haiway/utils/queue.py,sha256=oQ3GXCJ-PGNtMEr6EPdgqAvYZoj8lAa7Z2drBKBEoBM,2345
-haiway-0.10.10.dist-info/METADATA,sha256=PhcebR048J2VPSVrFIQOnQSEIvQpwolFKMmRuOGTWAg,3858
-haiway-0.10.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-haiway-0.10.10.dist-info/licenses/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
-haiway-0.10.10.dist-info/RECORD,,
+haiway-0.10.11.dist-info/METADATA,sha256=Xz9EVwzVcqiYBNaDv0QZQ4gXv3482M9eV9n82ba6kJo,3858
+haiway-0.10.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+haiway-0.10.11.dist-info/licenses/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
+haiway-0.10.11.dist-info/RECORD,,