haiway 0.8.2__tar.gz → 0.8.3__tar.gz

{haiway-0.8.2/src/haiway.egg-info → haiway-0.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: haiway
-Version: 0.8.2
+Version: 0.8.3
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Maintainer-email: Kacper Kaliński <kacper.kalinski@miquido.com>
 License: MIT License

{haiway-0.8.2 → haiway-0.8.3}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "haiway"
 description = "Framework for dependency injection and state management within structured concurrency model."
-version = "0.8.2"
+version = "0.8.3"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },

{haiway-0.8.2 → haiway-0.8.3}/src/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-0.8.2 → haiway-0.8.3}/src/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-0.8.2 → haiway-0.8.3}/src/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-0.8.3/src/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-0.8.3/src/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 → haiway-0.8.3/src/haiway.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: haiway
-Version: 0.8.2
+Version: 0.8.3
 Summary: Framework for dependency injection and state management within structured concurrency model.
 Maintainer-email: Kacper Kaliński <kacper.kalinski@miquido.com>
 License: MIT License

{haiway-0.8.2 → haiway-0.8.3}/src/haiway.egg-info/SOURCES.txt

@@ -39,9 +39,11 @@ src/haiway/utils/always.py
 src/haiway/utils/env.py
 src/haiway/utils/immutable.py
 src/haiway/utils/logs.py
+src/haiway/utils/mappings.py
 src/haiway/utils/mimic.py
 src/haiway/utils/noop.py
 src/haiway/utils/queue.py
+src/haiway/utils/sequences.py
 tests/test_async_queue.py
 tests/test_attribute_path.py
 tests/test_auto_retry.py