haiway 0.8.2__py3-none-any.whl → 0.8.4__py3-none-any.whl

haiway/__init__.py

@@ -35,6 +35,9 @@ from haiway.types import (
 from haiway.utils import (
     AsyncQueue,
     always,
+    as_dict,
+    as_list,
+    as_tuple,
     async_always,
     async_noop,
     freeze,
@@ -69,6 +72,9 @@ __all__ = [
     "ScopeIdentifier",
     "State",
     "always",
+    "as_dict",
+    "as_list",
+    "as_tuple",
     "async_always",
     "async_noop",
     "asynchronous",

haiway/state/structure.py

@@ -1,6 +1,5 @@
 import typing
 from collections.abc import Mapping
-from copy import deepcopy
 from types import EllipsisType, GenericAlias
 from typing import (
     Any,
@@ -362,22 +361,13 @@ class State(metaclass=StateMeta):
         )
 
     def __copy__(self) -> Self:
-        return self.__class__(**vars(self))
+        return self  # State is immutable, no need to provide an actual copy
 
     def __deepcopy__(
         self,
         memo: dict[int, Any] | None,
     ) -> Self:
-        copy: Self = self.__class__(
-            **{
-                key: deepcopy(
-                    value,
-                    memo,
-                )
-                for key, value in vars(self).items()
-            }
-        )
-        return copy
+        return self  # State is immutable, no need to provide an actual copy
 
     def __replace__(
         self,

haiway/utils/__init__.py

@@ -2,13 +2,18 @@ from haiway.utils.always import always, async_always
 from haiway.utils.env import getenv_bool, getenv_float, getenv_int, getenv_str, load_env
 from haiway.utils.immutable import freeze
 from haiway.utils.logs import setup_logging
+from haiway.utils.mappings import as_dict
 from haiway.utils.mimic import mimic_function
 from haiway.utils.noop import async_noop, noop
 from haiway.utils.queue import AsyncQueue
+from haiway.utils.sequences import as_list, as_tuple
 
 __all__ = [
     "AsyncQueue",
     "always",
+    "as_dict",
+    "as_list",
+    "as_tuple",
     "async_always",
     "async_noop",
     "freeze",

haiway/utils/env.py

@@ -1,5 +1,5 @@
 from os import environ, getenv
-from typing import overload
+from typing import Literal, overload
 
 __all__ = [
     "getenv_bool",
@@ -25,13 +25,28 @@ def getenv_bool(
 ) -> bool: ...
 
 
+@overload
+def getenv_bool(
+    key: str,
+    /,
+    *,
+    required: Literal[True],
+) -> bool: ...
+
+
 def getenv_bool(
     key: str,
     /,
     default: bool | None = None,
+    *,
+    required: bool = False,
 ) -> bool | None:
     if value := getenv(key=key):
         return value.lower() in ("true", "1", "t")
+
+    elif required and default is None:
+        raise ValueError(f"Required environment value `{key}` is missing!")
+
     else:
         return default
 
@@ -51,13 +66,31 @@ def getenv_int(
 ) -> int: ...
 
 
+@overload
+def getenv_int(
+    key: str,
+    /,
+    *,
+    required: Literal[True],
+) -> int: ...
+
+
 def getenv_int(
     key: str,
     /,
     default: int | None = None,
+    *,
+    required: bool = False,
 ) -> int | None:
     if value := getenv(key=key):
-        return int(value)
+        try:
+            return int(value)
+
+        except Exception as exc:
+            raise ValueError(f"Environment value `{key}` is not a valid int!") from exc
+
+    elif required and default is None:
+        raise ValueError(f"Required environment value `{key}` is missing!")
 
     else:
         return default
@@ -78,13 +111,31 @@ def getenv_float(
 ) -> float: ...
 
 
+@overload
+def getenv_float(
+    key: str,
+    /,
+    *,
+    required: Literal[True],
+) -> float: ...
+
+
 def getenv_float(
     key: str,
     /,
     default: float | None = None,
+    *,
+    required: bool = False,
 ) -> float | None:
     if value := getenv(key=key):
-        return float(value)
+        try:
+            return float(value)
+
+        except Exception as exc:
+            raise ValueError(f"Environment value `{key}` is not a valid float!") from exc
+
+    elif required and default is None:
+        raise ValueError(f"Required environment value `{key}` is missing!")
 
     else:
         return default
@@ -105,13 +156,28 @@ def getenv_str(
 ) -> str: ...
 
 
+@overload
+def getenv_str(
+    key: str,
+    /,
+    *,
+    required: Literal[True],
+) -> str: ...
+
+
 def getenv_str(
     key: str,
     /,
     default: str | None = None,
+    *,
+    required: bool = False,
 ) -> str | None:
     if value := getenv(key=key):
         return value
+
+    elif required and default is None:
+        raise ValueError(f"Required environment value `{key}` is missing!")
+
     else:
         return default
 

haiway/utils/mappings.py

@@ -0,0 +1,30 @@
+from collections.abc import Mapping
+
+__all__ = [
+    "as_dict",
+]
+
+
+def as_dict[K, V](
+    mapping: Mapping[K, V],
+    /,
+) -> dict[K, V]:
+    """
+    Converts any given mapping into a dict.
+
+    Parameters
+    ----------
+    mapping : Mapping[K, V]
+        The input mapping to be converted.
+
+    Returns
+    -------
+    dict[K, V]
+        A new dict containing all elements of the input mapping,
+        or the original dict if it was already one.
+    """
+    if isinstance(mapping, dict):
+        return mapping
+
+    else:
+        return dict(mapping)

haiway/utils/sequences.py

@@ -0,0 +1,56 @@
+from collections.abc import Sequence
+
+__all__ = [
+    "as_list",
+    "as_tuple",
+]
+
+
+def as_list[T](
+    sequence: Sequence[T],
+    /,
+) -> list[T]:
+    """
+    Converts any given sequence into a list.
+
+    Parameters
+    ----------
+    sequence : Sequence[T]
+        The input sequence to be converted.
+
+    Returns
+    -------
+    list[T]
+        A new list containing all elements of the input sequence,
+        or the original list if it was already one.
+    """
+    if isinstance(sequence, list):
+        return sequence
+
+    else:
+        return list(sequence)
+
+
+def as_tuple[T](
+    sequence: Sequence[T],
+    /,
+) -> tuple[T, ...]:
+    """
+    Converts any given sequence into a tuple.
+
+    Parameters
+    ----------
+    sequence : Sequence[T]
+        The input sequence to be converted.
+
+    Returns
+    -------
+    tuple[T]
+        A new tuple containing all elements of the input sequence,
+        or the original tuple if it was already one.
+    """
+    if isinstance(sequence, tuple):
+        return sequence
+
+    else:
+        return tuple(sequence)

{haiway-0.8.2.dist-info → haiway-0.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: haiway
-Version: 0.8.2
+Version: 0.8.4
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Maintainer-email: Kacper Kaliński <kacper.kalinski@miquido.com>
 License: MIT License
@@ -37,12 +37,12 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
 Requires-Dist: haiway; extra == "dev"
-Requires-Dist: ruff~=0.8.0; extra == "dev"
+Requires-Dist: ruff~=0.9; extra == "dev"
 Requires-Dist: pyright~=1.1; extra == "dev"
 Requires-Dist: bandit~=1.7; extra == "dev"
 Requires-Dist: pytest~=7.4; extra == "dev"
 Requires-Dist: pytest-cov~=4.1; extra == "dev"
-Requires-Dist: pytest-asyncio~=0.23.0; extra == "dev"
+Requires-Dist: pytest-asyncio~=0.23; extra == "dev"
 
 # 🚗 haiway 🚕 🚚 🚙
 

{haiway-0.8.2.dist-info → haiway-0.8.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-haiway/__init__.py,sha256=W11mHfW3WnYhVAuNOHeEHVc-BQkOodHM9j4_o36j4dA,1669
+haiway/__init__.py,sha256=Llf80-CD62BLe-sI01SCctZqlawNlOwWUUoK0jV-_XQ,1755
 haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 haiway/context/__init__.py,sha256=FDPD92cVaZKbQoyXl8lO1GzrscfTSrvST_gtfxOxxcM,620
 haiway/context/access.py,sha256=7UfhtDCjkVtdLfdWc5nR58KwKI3r693LcjFAlRtYHa0,15653
@@ -21,21 +21,23 @@ haiway/state/__init__.py,sha256=emTuwGFn7HyjyTJ_ass69J5jQIA7_WHO4teZz_dR05Y,355
 haiway/state/attributes.py,sha256=iQ7TJHnT3hlcYwKcxchXE56zU8WbOTJZhsVn_HocXBc,22903
 haiway/state/path.py,sha256=4vh-fYQv8_xRWjS0ErMQslKDWRI6-KVECAr8JhYk0UY,17503
 haiway/state/requirement.py,sha256=3iQqzp5Q7w6y5uClamJGH7S5Hib9pciuTAV27PP5lS8,6161
-haiway/state/structure.py,sha256=KvWC9_gE9pjtyUAzcFnQ12K8SyBqwbdPK_z8D2xzqDs,11862
+haiway/state/structure.py,sha256=N8lh_yKyROm5GG1NjIxmidYttWZkYH0S3fhEpNIx5FY,11694
 haiway/state/validation.py,sha256=n5cHcJTbv3Zf-qs05yzuLJIMBReV_4yYVwcH6IL58N0,13836
 haiway/types/__init__.py,sha256=00Ulp2BxcIWm9vWXKQPodpFEwE8hpqj6OYgrNxelp5s,252
 haiway/types/frozen.py,sha256=CZhFCXnWAKEhuWSfILxA8smfdpMd5Ku694ycfLh98R8,76
 haiway/types/missing.py,sha256=JiXo5xdi7H-PbIJr0fuK5wpOuQZhjrDYUkMlfIFcsaE,1705
-haiway/utils/__init__.py,sha256=2-qlRK876IIfLIn24SxZ_8zKvkmTmBimurNOQLN9rNw,608
+haiway/utils/__init__.py,sha256=pBeKpaPNfEHeKe8tT81JV-zADS1Qj32WnYcFP9ThtKk,749
 haiway/utils/always.py,sha256=2abp8Lm9rQkrfS3rm1Iqhb-IcWyVfH1BULab3KMxgOw,1234
-haiway/utils/env.py,sha256=lhJZphHhb32jgbTrMO58g-tK_UDTulAP-rhpJMFdfGQ,3136
+haiway/utils/env.py,sha256=vlW21LEp8uOVNnUXpBfPtj3zKi9Kkjoemb_H5hQpYPQ,4433
 haiway/utils/immutable.py,sha256=K34ZIMzbkpgkHKH-KF73plEbXExsajNRkRTYp9nJEf4,620
 haiway/utils/logs.py,sha256=oDsc1ZdqKDjlTlctLbDcp9iX98Acr-1tdw-Pyg3DElo,1577
+haiway/utils/mappings.py,sha256=XxELxCpGEPfRERO54ySIbcV7t4Sxcb7NuQmyayU5GoY,555
 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.8.2.dist-info/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
-haiway-0.8.2.dist-info/METADATA,sha256=2yT8bWdZuQZa_3HecsgNxVFsESFWNDvnBxw79KSO6LY,3898
-haiway-0.8.2.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-haiway-0.8.2.dist-info/top_level.txt,sha256=_LdXVLzUzgkvAGQnQJj5kQfoFhpPW6EF4Kj9NapniLg,7
-haiway-0.8.2.dist-info/RECORD,,
+haiway/utils/sequences.py,sha256=mXLAzH94HZHi0P7fF593FHNNTn1eNMRHA4Uxlr3UOu0,1064
+haiway-0.8.4.dist-info/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
+haiway-0.8.4.dist-info/METADATA,sha256=kgICAuwSBcUZR47tc1Vtvj4EoRwPaWcQCRATc1epLMY,3894
+haiway-0.8.4.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+haiway-0.8.4.dist-info/top_level.txt,sha256=_LdXVLzUzgkvAGQnQJj5kQfoFhpPW6EF4Kj9NapniLg,7
+haiway-0.8.4.dist-info/RECORD,,

{haiway-0.8.2.dist-info → haiway-0.8.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any