haiway 0.17.0__py3-none-any.whl → 0.18.1__py3-none-any.whl

haiway/state/structure.py

@@ -1,5 +1,5 @@
 import typing
-from collections.abc import Callable, Mapping
+from collections.abc import ItemsView, Mapping, Sequence
 from types import EllipsisType, GenericAlias
 from typing import (
     Any,
@@ -10,7 +10,6 @@ from typing import (
     cast,
     dataclass_transform,
     final,
-    overload,
 )
 from weakref import WeakValueDictionary
 
@@ -19,32 +18,7 @@ from haiway.state.path import AttributePath
 from haiway.state.validation import AttributeValidation, AttributeValidator
 from haiway.types import MISSING, DefaultValue, Missing, not_missing
 
-__all__ = [
-    "State",
-]
-
-
-@overload
-def Default[Value](
-    value: Value,
-    /,
-) -> Value: ...
-
-
-@overload
-def Default[Value](
-    *,
-    factory: Callable[[], Value],
-) -> Value: ...
-
-
-def Default[Value](
-    value: Value | Missing = MISSING,
-    /,
-    *,
-    factory: Callable[[], Value] | Missing = MISSING,
-) -> Value:  # it is actually a DefaultValue, but type checker has to be fooled
-    return cast(Value, DefaultValue(value, factory=factory))
+__all__ = ("State",)
 
 
 @final
@@ -392,11 +366,27 @@ class State(metaclass=StateMeta):
     ) -> Self:
         return self.__replace__(**kwargs)
 
-    def as_dict(self) -> dict[str, Any]:
+    def to_str(
+        self,
+        pretty: bool = False,
+    ) -> str:
+        if pretty:
+            return _state_str(self)
+
+        else:
+            return self.__str__()
+
+    def to_mapping(
+        self,
+        recursive: bool = False,
+    ) -> Mapping[str, Any]:
         dict_result: dict[str, Any] = {}
         for key in self.__ATTRIBUTES__.keys():
             value: Any | Missing = getattr(self, key, MISSING)
-            if not_missing(value):
+            if recursive and isinstance(value, State):
+                dict_result[key] = value.to_mapping(recursive=recursive)
+
+            elif not_missing(value):
                 dict_result[key] = value
 
         return dict_result
@@ -458,3 +448,144 @@ class State(metaclass=StateMeta):
                 **kwargs,
             }
         )
+
+
+def _attribute_str(
+    *,
+    key: str,
+    value: str,
+) -> str:
+    return f"┝ {key}: {value}"
+
+
+def _element_str(
+    *,
+    key: Any,
+    value: Any,
+) -> str:
+    return f"[{key}]: {value}"
+
+
+def _state_str(
+    state: State,
+    /,
+) -> str:
+    variables: ItemsView[str, Any] = vars(state).items()
+
+    parts: list[str] = [f"┍━ {type(state).__name__}:"]
+    for key, value in variables:
+        value_string: str | None = _value_str(value)
+
+        if value_string:
+            parts.append(
+                _attribute_str(
+                    key=key,
+                    value=value_string,
+                )
+            )
+
+        else:
+            continue  # skip empty elements
+
+    if parts:
+        return "\n".join(parts) + "\n┕━"
+
+    else:
+        return "╍"
+
+
+def _mapping_str(
+    dictionary: Mapping[Any, Any],
+    /,
+) -> str | None:
+    elements: ItemsView[Any, Any] = dictionary.items()
+
+    parts: list[str] = []
+    for key, value in elements:
+        value_string: str | None = _value_str(value)
+
+        if value_string:
+            parts.append(
+                _element_str(
+                    key=key,
+                    value=value_string,
+                )
+            )
+
+        else:
+            continue  # skip empty elements
+
+    if parts:
+        return "\n|  " + "\n".join(parts).replace("\n", "\n|  ")
+
+    else:
+        return None
+
+
+def _sequence_str(
+    sequence: Sequence[Any],
+    /,
+) -> str | None:
+    parts: list[str] = []
+    for idx, element in enumerate(sequence):
+        element_string: str | None = _value_str(element)
+
+        if element_string:
+            parts.append(
+                _element_str(
+                    key=idx,
+                    value=element_string,
+                )
+            )
+
+        else:
+            continue  # skip empty elements
+
+    if parts:
+        return "\n|  " + "\n".join(parts).replace("\n", "\n|  ")
+
+    else:
+        return None
+
+
+def _raw_value_str(
+    value: Any,
+    /,
+) -> str | None:
+    if value is MISSING:
+        return None  # skip missing
+
+    else:
+        return str(value).strip().replace("\n", "\n|  ")
+
+
+def _value_str(  # noqa: PLR0911
+    value: Any,
+    /,
+) -> str | None:
+    # check for string
+    if isinstance(value, str):
+        if "\n" in value:
+            return f'"""\n{value}\n"""'.replace("\n", "\n|  ")
+
+        else:
+            return f'"{value}"'
+
+    # check for bytes
+    elif isinstance(value, bytes):
+        return f'b"{value}"'
+
+    # try unpack state
+    elif isinstance(value, State):
+        return _state_str(value)
+
+    # try unpack mapping
+    elif isinstance(value, Mapping):
+        return _mapping_str(value)
+
+    # try unpack sequence
+    elif isinstance(value, Sequence):
+        return _sequence_str(value)
+
+    else:  # fallback to other
+        return _raw_value_str(value)

haiway/state/validation.py

@@ -10,11 +10,11 @@ from uuid import UUID
 from haiway.state.attributes import AttributeAnnotation
 from haiway.types import MISSING, Missing
 
-__all__ = [
+__all__ = (
     "AttributeValidation",
     "AttributeValidationError",
     "AttributeValidator",
-]
+)
 
 
 class AttributeValidation[Type](Protocol):

haiway/types/__init__.py

@@ -2,7 +2,7 @@ from haiway.types.default import Default, DefaultValue
 from haiway.types.frozen import frozenlist
 from haiway.types.missing import MISSING, Missing, is_missing, not_missing, when_missing
 
-__all__ = [
+__all__ = (
     "MISSING",
     "Default",
     "DefaultValue",
@@ -11,4 +11,4 @@ __all__ = [
     "is_missing",
     "not_missing",
     "when_missing",
-]
+)

haiway/types/default.py

@@ -4,10 +4,10 @@ from typing import Any, cast, final, overload
 from haiway.types.missing import MISSING, Missing, not_missing
 from haiway.utils.always import always
 
-__all__ = [
+__all__ = (
     "Default",
     "DefaultValue",
-]
+)
 
 
 @final

haiway/types/frozen.py

@@ -1,5 +1,3 @@
-__all__ = [
-    "frozenlist",
-]
+__all__ = ("frozenlist",)
 
 type frozenlist[Value] = tuple[Value, ...]

haiway/types/missing.py

@@ -1,12 +1,12 @@
 from typing import Any, Final, TypeGuard, cast, final
 
-__all__ = [
+__all__ = (
     "MISSING",
     "Missing",
     "is_missing",
     "not_missing",
     "when_missing",
-]
+)
 
 
 class MissingType(type):

haiway/utils/__init__.py

@@ -15,7 +15,7 @@ from haiway.utils.noop import async_noop, noop
 from haiway.utils.queue import AsyncQueue
 from haiway.utils.stream import AsyncStream
 
-__all__ = [
+__all__ = (
     "AsyncQueue",
     "AsyncStream",
     "always",
@@ -36,4 +36,4 @@ __all__ = [
     "noop",
     "setup_logging",
     "without_missing",
-]
+)

haiway/utils/always.py

@@ -1,10 +1,10 @@
 from collections.abc import Callable, Coroutine
 from typing import Any
 
-__all__ = [
+__all__ = (
     "always",
     "async_always",
-]
+)
 
 
 def always[Value](

haiway/utils/collections.py

@@ -3,13 +3,13 @@ from typing import Any, cast, overload
 
 from haiway.types.missing import MISSING
 
-__all__ = [
+__all__ = (
     "as_dict",
     "as_list",
     "as_set",
     "as_tuple",
     "without_missing",
-]
+)
 
 
 @overload

haiway/utils/env.py

@@ -3,14 +3,14 @@ from collections.abc import Callable
 from os import environ, getenv
 from typing import Literal, overload
 
-__all__ = [
+__all__ = (
     "getenv_base64",
     "getenv_bool",
     "getenv_float",
     "getenv_int",
     "getenv_str",
     "load_env",
-]
+)
 
 
 @overload

haiway/utils/freezing.py

@@ -1,8 +1,6 @@
 from typing import Any
 
-__all__ = [
-    "freeze",
-]
+__all__ = ("freeze",)
 
 
 def freeze(

haiway/utils/logs.py

@@ -2,9 +2,7 @@ from logging.config import dictConfig
 
 from haiway.utils.env import getenv_bool
 
-__all__ = [
-    "setup_logging",
-]
+__all__ = ("setup_logging",)
 
 
 def setup_logging(

haiway/utils/mimic.py

@@ -1,9 +1,7 @@
 from collections.abc import Callable
 from typing import Any, cast, overload
 
-__all__ = [
-    "mimic_function",
-]
+__all__ = ("mimic_function",)
 
 
 @overload

haiway/utils/noop.py

@@ -1,9 +1,9 @@
 from typing import Any
 
-__all__ = [
+__all__ = (
     "async_noop",
     "noop",
-]
+)
 
 
 def noop(

haiway/utils/queue.py

@@ -3,9 +3,7 @@ from collections import deque
 from collections.abc import AsyncIterator
 from typing import Any
 
-__all__ = [
-    "AsyncQueue",
-]
+__all__ = ("AsyncQueue",)
 
 
 class AsyncQueue[Element](AsyncIterator[Element]):

haiway/utils/stream.py

@@ -6,9 +6,7 @@ from asyncio import (
 )
 from collections.abc import AsyncIterator
 
-__all__ = [
-    "AsyncStream",
-]
+__all__ = ("AsyncStream",)
 
 
 class AsyncStream[Element](AsyncIterator[Element]):

{haiway-0.17.0.dist-info → haiway-0.18.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.17.0
+Version: 0.18.1
 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
@@ -35,12 +35,16 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Provides-Extra: dev
-Requires-Dist: bandit~=1.7; extra == 'dev'
+Requires-Dist: bandit~=1.8; extra == 'dev'
 Requires-Dist: pyright~=1.1; extra == 'dev'
-Requires-Dist: pytest-asyncio~=0.23; extra == 'dev'
-Requires-Dist: pytest-cov~=4.1; extra == 'dev'
-Requires-Dist: pytest~=7.4; extra == 'dev'
+Requires-Dist: pytest-asyncio~=0.26; extra == 'dev'
+Requires-Dist: pytest-cov~=6.1; extra == 'dev'
+Requires-Dist: pytest~=8.3; extra == 'dev'
 Requires-Dist: ruff~=0.11; extra == 'dev'
+Provides-Extra: opentelemetry
+Requires-Dist: opentelemetry-api; extra == 'opentelemetry'
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc; extra == 'opentelemetry'
+Requires-Dist: opentelemetry-sdk; extra == 'opentelemetry'
 Description-Content-Type: text/markdown
 
 # 🚗 haiway 🚕 🚚 🚙

haiway-0.18.1.dist-info/RECORD

@@ -0,0 +1,44 @@
+haiway/__init__.py,sha256=GAukz1qQxO0mhvxSXdabC0JYiWw4nGKIGnmuImtDWdQ,2389
+haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+haiway/context/__init__.py,sha256=eoxqxUmFtkWLhc_gH6tqax9m90tSDie-jiP1BHruTdk,1102
+haiway/context/access.py,sha256=49yzFt9yJU6p0pDE3jV_ZIvmgSk6_czzOOT2gijSJk8,18648
+haiway/context/disposables.py,sha256=xE8RZYsYgXiOZY_TjWR7UiPG6dirna6y2LBZvMwTkIs,2588
+haiway/context/identifier.py,sha256=i6nO-tozps7iDnpS5Se7CRch7hh6z2akjZthutxHte8,3943
+haiway/context/observability.py,sha256=Z89y2MYTMBwfsEprm9fGP-s_ZqrA9NLtLZo4Fj2JDGM,13738
+haiway/context/state.py,sha256=0oq7ctNO0urJd7rVzwwNtgpguoXuI6Tp1exfCsxrS2M,5981
+haiway/context/tasks.py,sha256=QOxFdjmMp4IYff0ihHElKLCQrcVksSJmxqTlOKfoH4o,2907
+haiway/context/types.py,sha256=WulPvpqUbI1vYyny-s2NItldDnk3zh1O-n_hGibFZRY,142
+haiway/helpers/__init__.py,sha256=awAEVFv9_talefS6ymMbofDXigB-Klsxkj2uth8la-g,615
+haiway/helpers/asynchrony.py,sha256=k_A0yCWUKSFfzYZ8WvqK4wqTMljv6ykMivmERrDLHIU,6266
+haiway/helpers/caching.py,sha256=4WX2Md5AOncduYB_RLLENI2s9C2zD5kNJgKZjMzPIGY,13257
+haiway/helpers/observability.py,sha256=-UXr7dHWTq-rmGe5HAR-tx2gzCbzAIoO42mwTISnMDE,6990
+haiway/helpers/retries.py,sha256=unssUKBDOENvquh6R4Ud65TuSKl4mTHgZ5N_b7mAYa4,7533
+haiway/helpers/throttling.py,sha256=U6HJvSzffw47730VeiXxXSW4VVxpDx48k0oIAOpL-O4,4115
+haiway/helpers/timeouted.py,sha256=_M8diuD_GN49pl5KQA5fMKn4iUHsUuhkDSatAwWXiK8,3331
+haiway/helpers/tracing.py,sha256=0KIpr-phVHikfoFrbgzeQi581tjp65fZnMqX0h0MRDo,3653
+haiway/opentelemetry/__init__.py,sha256=TV-1C14mDAtcHhFZ29ActFQdrGH6x5KuGV9w-JlKYJg,91
+haiway/opentelemetry/observability.py,sha256=oOjIVZldk14SfffWQh5FO1lGMW3Dce1PMLbiDZ9lV5s,14264
+haiway/state/__init__.py,sha256=AaMqlMhO4zKS_XNevy3A7BHh5PxmguA-Sk_FnaNDY1Q,355
+haiway/state/attributes.py,sha256=p6jUBzg62bOl0zAYTCa7NIllsaNY2Kt68IooQ9tb-y8,23311
+haiway/state/path.py,sha256=-IpbUpF2QHWg3hEITkWYHJ6ZPoRVixu-SOSuWk-bbBY,21318
+haiway/state/requirement.py,sha256=oKh9eqgTwxcJF4JNhU-DAbHbHsaACMNSlX-mkVjeJeY,7034
+haiway/state/structure.py,sha256=rlA7qTr7rmJ_cU7_lJYq_y9Y-GO1wsaeHtjyDiIB8y8,16195
+haiway/state/validation.py,sha256=LiCkItybUHT3oKG6IyLu2x6IKKvnWnabuEcVkTbEP9Y,14996
+haiway/types/__init__.py,sha256=73DMgf60Ftf1gLRCSQG66Nyu3_QFjdRJggBtS4-RQkY,342
+haiway/types/default.py,sha256=IIU6QA73aDUKXLNu78KQ2dLQFbyBrU74w7jlFswHl-8,2208
+haiway/types/frozen.py,sha256=zLVkj85_lj6LrXjXAdv06Yy0MCj4spC8FQ-AhZMDPKg,70
+haiway/types/missing.py,sha256=769MX5qpJ3zjNu6xLUH75On8FgheY06f2JYFR21gs9o,1712
+haiway/utils/__init__.py,sha256=RqeTPXTVhvYp8rd5YLMSyH0hYF9y4j6aSxdbjG4VZtA,907
+haiway/utils/always.py,sha256=dd6jDQ1j4DpJjTKO1J2Tv5xS8X1LnMC4kQ0D7DtKUvw,1230
+haiway/utils/collections.py,sha256=pSBXhtLdhrLqmYo9YZEx716JI9S_sIztLJ5z5wi2d7Y,4162
+haiway/utils/env.py,sha256=gdZcQS9l82hKm4Jojy1vnE42s89JqPFbiYODAE8I2sA,5339
+haiway/utils/freezing.py,sha256=QsThd6FJ8TgErio7pCsHSnUKmVQbHZu6iEDYiqvJteo,614
+haiway/utils/logs.py,sha256=NuwoqKQnMNi1FMIA91cVFnAPefUFeg3UIT50IOl3sJk,1571
+haiway/utils/mimic.py,sha256=L5AS4WEL2aPMZAQZlvLvRzHl0cipI7ivky60_eL4iwY,1822
+haiway/utils/noop.py,sha256=f54PSLHGEwCQNYXQHkPAW5NDE-tk5yjzkNL1pZj0TJQ,344
+haiway/utils/queue.py,sha256=YTvCn3wgSwLJiLqolMx44sa3304Xkv3tJG77gvfWnZs,4114
+haiway/utils/stream.py,sha256=Mjhy2S-ZDR1g_NsgS_nuBA8AgVbhrGXKvG3wjJ5mCJQ,2826
+haiway-0.18.1.dist-info/METADATA,sha256=dIvIkA3j0iGbQuF5VGH2vhdgPMTWYQS0LXG7GwDKw7E,4527
+haiway-0.18.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+haiway-0.18.1.dist-info/licenses/LICENSE,sha256=3phcpHVNBP8jsi77gOO0E7rgKeDeu99Pi7DSnK9YHoQ,1069
+haiway-0.18.1.dist-info/RECORD,,