haiway 0.8.1__tar.gz → 0.8.3__tar.gz

{haiway-0.8.1/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.1
+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.1 → 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.1"
+version = "0.8.3"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },

{haiway-0.8.1 → 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.1 → haiway-0.8.3}/src/haiway/context/access.py

@@ -46,11 +46,6 @@ class ScopeContext:
         self._state: tuple[State, ...] = state
         self._disposables: Disposables | None = disposables
         # pre-building metrics context to ensure nested context registering
-        if __debug__:
-            if self._identifier.is_root and metrics is None:
-                from haiway.helpers import MetricsLogger
-
-                metrics = MetricsLogger.handler()
         self._metrics_context: MetricsContext = MetricsContext.scope(
             self._identifier,
             metrics=metrics,

{haiway-0.8.1 → haiway-0.8.3}/src/haiway/helpers/metrics.py

@@ -1,19 +1,16 @@
 from collections.abc import Sequence
 from itertools import chain
 from time import monotonic
-from typing import Any, Final, Self, cast, final
+from typing import Any, Self, cast, final
 
 from haiway.context import MetricsHandler, ScopeIdentifier, ctx
 from haiway.state import State
 from haiway.types import MISSING, Missing
-from haiway.utils import getenv_bool
 
 __all_ = [
     "MetricsLogger",
 ]
 
-DEBUG_LOGGING: Final[bool] = getenv_bool("DEBUG_LOGGING", __debug__)
-
 
 class MetricsScopeStore:
     def __init__(
@@ -96,13 +93,12 @@ class MetricsLogger:
             metrics[type(metric)] = current.__add__(metric)  # pyright: ignore[reportUnknownMemberType, reportAttributeAccessIssue]
 
         metrics[type(metric)] = metric
-        if DEBUG_LOGGING:
-            if log := _state_log(
-                metric,
-                list_items_limit=self.items_limit,
-                redact_content=self.redact_content,
-            ):
-                ctx.log_info(f"Recorded metric:\n⎡ {type(metric).__qualname__}:{log}\n⌊")
+        if log := _state_log(
+            metric,
+            list_items_limit=self.items_limit,
+            redact_content=self.redact_content,
+        ):
+            ctx.log_debug(f"Recorded metric:\n⎡ {type(metric).__qualname__}:{log}\n⌊")
 
     def enter_scope[Metric: State](
         self,
@@ -118,7 +114,7 @@ class MetricsLogger:
                     self.scopes[key].nested.append(scope_metrics)
                     return
 
-            ctx.log_error(
+            ctx.log_debug(
                 "Attempting to enter nested scope metrics without entering its parent first"
             )
 
@@ -130,14 +126,13 @@ class MetricsLogger:
         assert scope in self.scopes  # nosec: B101
         self.scopes[scope].exited = monotonic()
 
-        if DEBUG_LOGGING:
-            if scope.is_root and self.scopes[scope].finished:
-                if log := _tree_log(
-                    self.scopes[scope],
-                    list_items_limit=self.items_limit,
-                    redact_content=self.redact_content,
-                ):
-                    ctx.log_info(f"Metrics summary:\n{log}")
+        if scope.is_root and self.scopes[scope].finished:
+            if log := _tree_log(
+                self.scopes[scope],
+                list_items_limit=self.items_limit,
+                redact_content=self.redact_content,
+            ):
+                ctx.log_debug(f"Metrics summary:\n{log}")
 
 
 def _tree_log(

{haiway-0.8.1 → 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.1 → 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.1 → 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.1
+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.1 → 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