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

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.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.17.0
+Version: 0.18.0
 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.0.dist-info/RECORD

@@ -0,0 +1,44 @@
+haiway/__init__.py,sha256=0ShohKDFyEyUpBpSfJWDFGopBWOdhdWyX3wC9tgmkVU,2243
+haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+haiway/context/__init__.py,sha256=hPQ7e-4515zD7vSEtSvzZpZ6rAqGceyE3jeVH3eE80M,966
+haiway/context/access.py,sha256=Oxl5Hs6jDvD6DMt8Im8MpIXswXaFW5PGWqGF9rsryGE,17951
+haiway/context/disposables.py,sha256=xE8RZYsYgXiOZY_TjWR7UiPG6dirna6y2LBZvMwTkIs,2588
+haiway/context/identifier.py,sha256=i6nO-tozps7iDnpS5Se7CRch7hh6z2akjZthutxHte8,3943
+haiway/context/observability.py,sha256=rkq2YYMSQE3ryXdX_OvUxsWP9G4B6wHJM0_PIgURwo4,11666
+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=bVOCI0RHh6JNY_B8aJyw-fh1pDD10WnCPR8nVGX4NA0,582
+haiway/helpers/asynchrony.py,sha256=k_A0yCWUKSFfzYZ8WvqK4wqTMljv6ykMivmERrDLHIU,6266
+haiway/helpers/caching.py,sha256=4WX2Md5AOncduYB_RLLENI2s9C2zD5kNJgKZjMzPIGY,13257
+haiway/helpers/observability.py,sha256=PdlTR8OGxbkWcVcnTAhpr2OzvgM2Oig1B0KhFKvQjLI,6241
+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=UpwhNEoTefy1oplz_tqMFrN2AcmPRkKU7UYVENVykM0,4161
+haiway/opentelemetry/__init__.py,sha256=TV-1C14mDAtcHhFZ29ActFQdrGH6x5KuGV9w-JlKYJg,91
+haiway/opentelemetry/observability.py,sha256=4c22MqSTBbYoadXTBbbBJTPik1GQ7LjjpMz2qeOKXf4,13439
+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.0.dist-info/METADATA,sha256=HhXh_Dn5VRN-pA94h4iBM3TB9ugkqKIUrbwCWZ6sob4,4527
+haiway-0.18.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+haiway-0.18.0.dist-info/licenses/LICENSE,sha256=3phcpHVNBP8jsi77gOO0E7rgKeDeu99Pi7DSnK9YHoQ,1069
+haiway-0.18.0.dist-info/RECORD,,

haiway/context/logging.py

@@ -1,242 +0,0 @@
-from contextvars import ContextVar, Token
-from logging import DEBUG, ERROR, INFO, WARNING, Logger, getLogger
-from time import monotonic
-from types import TracebackType
-from typing import Any, Self, final
-
-from haiway.context.identifier import ScopeIdentifier
-
-__all__ = [
-    "LoggerContext",
-]
-
-
-@final
-class LoggerContext:
-    _context = ContextVar[Self]("LoggerContext")
-
-    @classmethod
-    def scope(
-        cls,
-        scope: ScopeIdentifier,
-        /,
-        *,
-        logger: Logger | None,
-    ) -> Self:
-        current: Self
-        try:  # check for current scope
-            current = cls._context.get()
-
-        except LookupError:
-            # create root scope when missing
-            return cls(
-                scope=scope,
-                logger=logger,
-            )
-
-        # create nested scope otherwise
-        return cls(
-            scope=scope,
-            logger=logger or current._logger,
-        )
-
-    @classmethod
-    def log_error(
-        cls,
-        message: str,
-        /,
-        *args: Any,
-        exception: BaseException | None = None,
-    ) -> None:
-        try:
-            cls._context.get().log(
-                ERROR,
-                message,
-                *args,
-                exception=exception,
-            )
-
-        except LookupError:
-            getLogger().log(
-                ERROR,
-                message,
-                *args,
-                exc_info=exception,
-            )
-
-    @classmethod
-    def log_warning(
-        cls,
-        message: str,
-        /,
-        *args: Any,
-        exception: Exception | None = None,
-    ) -> None:
-        try:
-            cls._context.get().log(
-                WARNING,
-                message,
-                *args,
-                exception=exception,
-            )
-
-        except LookupError:
-            getLogger().log(
-                WARNING,
-                message,
-                *args,
-                exc_info=exception,
-            )
-
-    @classmethod
-    def log_info(
-        cls,
-        message: str,
-        /,
-        *args: Any,
-    ) -> None:
-        try:
-            cls._context.get().log(
-                INFO,
-                message,
-                *args,
-            )
-
-        except LookupError:
-            getLogger().log(
-                INFO,
-                message,
-                *args,
-            )
-
-    @classmethod
-    def log_debug(
-        cls,
-        message: str,
-        /,
-        *args: Any,
-        exception: Exception | None = None,
-    ) -> None:
-        try:
-            cls._context.get().log(
-                DEBUG,
-                message,
-                *args,
-                exception=exception,
-            )
-
-        except LookupError:
-            getLogger().log(
-                DEBUG,
-                message,
-                *args,
-                exc_info=exception,
-            )
-
-    __slots__ = (
-        "_entered",
-        "_logger",
-        "_prefix",
-        "_token",
-    )
-
-    def __init__(
-        self,
-        scope: ScopeIdentifier,
-        logger: Logger | None,
-    ) -> None:
-        self._prefix: str
-        object.__setattr__(
-            self,
-            "_prefix",
-            scope.unique_name,
-        )
-        self._logger: Logger
-        object.__setattr__(
-            self,
-            "_logger",
-            logger or getLogger(name=scope.label),
-        )
-        self._token: Token[LoggerContext] | None
-        object.__setattr__(
-            self,
-            "_token",
-            None,
-        )
-        self._entered: float | None
-        object.__setattr__(
-            self,
-            "_entered",
-            None,
-        )
-
-    def __setattr__(
-        self,
-        name: str,
-        value: Any,
-    ) -> Any:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be modified"
-        )
-
-    def __delattr__(
-        self,
-        name: str,
-    ) -> None:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be deleted"
-        )
-
-    def log(
-        self,
-        level: int,
-        message: str,
-        /,
-        *args: Any,
-        exception: BaseException | None = None,
-    ) -> None:
-        self._logger.log(
-            level,
-            f"{self._prefix} {message}",
-            *args,
-            exc_info=exception,
-        )
-
-    def __enter__(self) -> None:
-        assert self._token is None, "Context reentrance is not allowed"  # nosec: B101
-        assert self._entered is None, "Context reentrance is not allowed"  # nosec: B101
-        object.__setattr__(
-            self,
-            "_token",
-            LoggerContext._context.set(self),
-        )
-        object.__setattr__(
-            self,
-            "_entered",
-            monotonic(),
-        )
-        self.log(DEBUG, "Entering context...")
-
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> None:
-        assert (  # nosec: B101
-            self._token is not None and self._entered is not None
-        ), "Unbalanced context enter/exit"
-        LoggerContext._context.reset(self._token)
-        object.__setattr__(
-            self,
-            "_token",
-            None,
-        )
-        self.log(DEBUG, f"...exiting context after {monotonic() - self._entered:.2f}s")
-        object.__setattr__(
-            self,
-            "_entered",
-            None,
-        )

haiway/context/metrics.py

@@ -1,176 +0,0 @@
-from contextvars import ContextVar, Token
-from types import TracebackType
-from typing import Any, Protocol, Self, final, runtime_checkable
-
-from haiway.context.identifier import ScopeIdentifier
-from haiway.context.logging import LoggerContext
-from haiway.state import State
-
-__all__ = [
-    "MetricsContext",
-    "MetricsHandler",
-    "MetricsRecording",
-    "MetricsScopeEntering",
-    "MetricsScopeExiting",
-]
-
-
-@runtime_checkable
-class MetricsRecording(Protocol):
-    def __call__(
-        self,
-        scope: ScopeIdentifier,
-        /,
-        metric: State,
-    ) -> None: ...
-
-
-@runtime_checkable
-class MetricsScopeEntering(Protocol):
-    def __call__[Metric: State](
-        self,
-        scope: ScopeIdentifier,
-        /,
-    ) -> None: ...
-
-
-@runtime_checkable
-class MetricsScopeExiting(Protocol):
-    def __call__[Metric: State](
-        self,
-        scope: ScopeIdentifier,
-        /,
-    ) -> None: ...
-
-
-class MetricsHandler(State):
-    record: MetricsRecording
-    enter_scope: MetricsScopeEntering
-    exit_scope: MetricsScopeExiting
-
-
-@final
-class MetricsContext:
-    _context = ContextVar[Self]("MetricsContext")
-
-    @classmethod
-    def scope(
-        cls,
-        scope: ScopeIdentifier,
-        /,
-        *,
-        metrics: MetricsHandler | None,
-    ) -> Self:
-        current: Self
-        try:  # check for current scope
-            current = cls._context.get()
-
-        except LookupError:
-            # create root scope when missing
-            return cls(
-                scope=scope,
-                metrics=metrics,
-            )
-
-        # create nested scope otherwise
-        return cls(
-            scope=scope,
-            metrics=metrics or current._metrics,
-        )
-
-    @classmethod
-    def record(
-        cls,
-        metric: State,
-        /,
-    ) -> None:
-        try:  # catch exceptions - we don't wan't to blow up on metrics
-            metrics: Self = cls._context.get()
-
-            if metrics._metrics is not None:
-                metrics._metrics.record(
-                    metrics._scope,
-                    metric,
-                )
-
-        except Exception as exc:
-            LoggerContext.log_error(
-                "Failed to record metric: %s",
-                type(metric).__qualname__,
-                exception=exc,
-            )
-
-    __slots__ = (
-        "_metrics",
-        "_scope",
-        "_token",
-    )
-
-    def __init__(
-        self,
-        scope: ScopeIdentifier,
-        metrics: MetricsHandler | None,
-    ) -> None:
-        self._scope: ScopeIdentifier
-        object.__setattr__(
-            self,
-            "_scope",
-            scope,
-        )
-        self._metrics: MetricsHandler | None
-        object.__setattr__(
-            self,
-            "_metrics",
-            metrics,
-        )
-        self._token: Token[MetricsContext] | None
-        object.__setattr__(
-            self,
-            "_token",
-            None,
-        )
-
-    def __setattr__(
-        self,
-        name: str,
-        value: Any,
-    ) -> Any:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be modified"
-        )
-
-    def __delattr__(
-        self,
-        name: str,
-    ) -> None:
-        raise AttributeError(
-            f"Can't modify immutable {self.__class__.__qualname__},"
-            f" attribute - '{name}' cannot be deleted"
-        )
-
-    def __enter__(self) -> None:
-        assert self._token is None, "Context reentrance is not allowed"  # nosec: B101
-        object.__setattr__(
-            self,
-            "_token",
-            MetricsContext._context.set(self),
-        )
-        if self._metrics is not None:
-            self._metrics.enter_scope(self._scope)
-
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> None:
-        assert self._token is not None, "Unbalanced context enter/exit"  # nosec: B101
-        MetricsContext._context.reset(self._token)
-        object.__setattr__(
-            self,
-            "_token",
-            None,
-        )
-        if self._metrics is not None:
-            self._metrics.exit_scope(self._scope)