haiway 0.8.2__tar.gz → 0.8.4__tar.gz

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

@@ -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 → haiway-0.8.4}/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.4"
 readme = "README.md"
 maintainers = [
   { name = "Kacper Kaliński", email = "kacper.kalinski@miquido.com" },
@@ -29,12 +29,12 @@ Repository = "https://github.com/miquido/haiway.git"
 [project.optional-dependencies]
 dev = [
   "haiway",
-  "ruff~=0.8.0",
+  "ruff~=0.9",
   "pyright~=1.1",
   "bandit~=1.7",
   "pytest~=7.4",
   "pytest-cov~=4.1",
-  "pytest-asyncio~=0.23.0",
+  "pytest-asyncio~=0.23",
 ]
 
 [tool.ruff]
@@ -42,7 +42,7 @@ target-version = "py312"
 line-length = 100
 extend-exclude = [".venv", ".git", ".cache"]
 lint.select = ["E", "F", "A", "I", "B", "PL", "W", "C", "RUF", "UP"]
-lint.ignore = []
+lint.ignore = ["A005"]
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401", "E402"]

{haiway-0.8.2 → haiway-0.8.4}/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.4}/src/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-0.8.2 → haiway-0.8.4}/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.4}/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.4/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.4/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.4/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.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 → haiway-0.8.4}/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

{haiway-0.8.2 → haiway-0.8.4}/src/haiway.egg-info/requires.txt

@@ -1,9 +1,9 @@
 
 [dev]
 haiway
-ruff~=0.8.0
+ruff~=0.9
 pyright~=1.1
 bandit~=1.7
 pytest~=7.4
 pytest-cov~=4.1
-pytest-asyncio~=0.23.0
+pytest-asyncio~=0.23

{haiway-0.8.2 → haiway-0.8.4}/tests/test_state.py

@@ -1,4 +1,5 @@
 from collections.abc import Callable, Sequence, Set
+from copy import copy, deepcopy
 from datetime import date, datetime
 from enum import StrEnum
 from typing import Any, Literal, NotRequired, Protocol, Required, Self, TypedDict, runtime_checkable
@@ -222,3 +223,16 @@ def test_generic_subtypes_validation() -> None:
 
     # not raises
     _ = Container(generic=Generic(nested=NestedGeneric(value="ok")))
+
+
+def test_copying_leaves_same_object() -> None:
+    class Nested(State):
+        string: str
+
+    class Copied(State):
+        string: str
+        nested: Nested
+
+    origin = Copied(string="42", nested=Nested(string="answer"))
+    assert copy(origin) is origin
+    assert deepcopy(origin) is origin