haiway 0.11.1__py3-none-any.whl → 0.12.0__py3-none-any.whl

haiway/state/validation.py

@@ -4,7 +4,7 @@ from enum import Enum
 from pathlib import Path
 from re import Pattern
 from types import EllipsisType, NoneType, UnionType
-from typing import Any, Literal, Protocol, Self, Union, is_typeddict
+from typing import Any, Literal, Protocol, Self, Union, final, is_typeddict
 from uuid import UUID
 
 from haiway.state.attributes import AttributeAnnotation
@@ -29,6 +29,7 @@ class AttributeValidationError(Exception):
     pass
 
 
+@final
 class AttributeValidator[Type]:
     @classmethod
     def of(
@@ -51,32 +52,86 @@ class AttributeValidator[Type]:
         recursion_guard[str(annotation)] = validator
 
         if common := VALIDATORS.get(annotation.origin):
-            validator.validation = common(annotation, recursion_guard)
+            object.__setattr__(
+                validator,
+                "validation",
+                common(annotation, recursion_guard),
+            )
 
         elif hasattr(annotation.origin, "__IMMUTABLE__"):
-            validator.validation = _prepare_validator_of_type(annotation, recursion_guard)
+            object.__setattr__(
+                validator,
+                "validation",
+                _prepare_validator_of_type(annotation, recursion_guard),
+            )
 
         elif is_typeddict(annotation.origin):
-            validator.validation = _prepare_validator_of_typed_dict(annotation, recursion_guard)
+            object.__setattr__(
+                validator,
+                "validation",
+                _prepare_validator_of_typed_dict(annotation, recursion_guard),
+            )
 
         elif issubclass(annotation.origin, Protocol):
-            validator.validation = _prepare_validator_of_type(annotation, recursion_guard)
+            object.__setattr__(
+                validator,
+                "validation",
+                _prepare_validator_of_type(annotation, recursion_guard),
+            )
 
         elif issubclass(annotation.origin, Enum):
-            validator.validation = _prepare_validator_of_type(annotation, recursion_guard)
+            object.__setattr__(
+                validator,
+                "validation",
+                _prepare_validator_of_type(annotation, recursion_guard),
+            )
 
         else:
             raise TypeError(f"Unsupported type annotation: {annotation}")
 
         return validator
 
+    __slots__ = (
+        "annotation",
+        "validation",
+    )
+
     def __init__(
         self,
         annotation: AttributeAnnotation,
         validation: AttributeValidation[Type] | Missing,
     ) -> None:
-        self.annotation: AttributeAnnotation = annotation
-        self.validation: AttributeValidation[Type] | Missing = validation
+        self.annotation: AttributeAnnotation
+        object.__setattr__(
+            self,
+            "annotation",
+            annotation,
+        )
+        self.validation: AttributeValidation[Type] | Missing
+        object.__setattr__(
+            self,
+            "validation",
+            validation,
+        )
+
+    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 __call__(
         self,

haiway/types/default.py

@@ -12,6 +12,8 @@ __all__ = [
 
 @final
 class DefaultValue[Value]:
+    __slots__ = ("_value",)
+
     @overload
     def __init__(
         self,

haiway/utils/__init__.py

@@ -1,6 +1,13 @@
 from haiway.utils.always import always, async_always
 from haiway.utils.collections import as_dict, as_list, as_set, as_tuple
-from haiway.utils.env import getenv_bool, getenv_float, getenv_int, getenv_str, load_env
+from haiway.utils.env import (
+    getenv_base64,
+    getenv_bool,
+    getenv_float,
+    getenv_int,
+    getenv_str,
+    load_env,
+)
 from haiway.utils.freezing import freeze
 from haiway.utils.logs import setup_logging
 from haiway.utils.mimic import mimic_function
@@ -17,6 +24,7 @@ __all__ = [
     "async_always",
     "async_noop",
     "freeze",
+    "getenv_base64",
     "getenv_bool",
     "getenv_float",
     "getenv_int",

haiway/utils/env.py

@@ -1,7 +1,10 @@
+from base64 import b64decode
+from collections.abc import Callable
 from os import environ, getenv
 from typing import Literal, overload
 
 __all__ = [
+    "getenv_base64",
     "getenv_bool",
     "getenv_float",
     "getenv_int",
@@ -182,6 +185,53 @@ def getenv_str(
         return default
 
 
+@overload
+def getenv_base64[Value](
+    key: str,
+    /,
+    *,
+    decoder: Callable[[bytes], Value],
+) -> Value | None: ...
+
+
+@overload
+def getenv_base64[Value](
+    key: str,
+    /,
+    default: Value,
+    *,
+    decoder: Callable[[bytes], Value],
+) -> Value: ...
+
+
+@overload
+def getenv_base64[Value](
+    key: str,
+    /,
+    *,
+    decoder: Callable[[bytes], Value],
+    required: Literal[True],
+) -> Value: ...
+
+
+def getenv_base64[Value](
+    key: str,
+    /,
+    default: Value | None = None,
+    *,
+    decoder: Callable[[bytes], Value],
+    required: bool = False,
+) -> Value | None:
+    if value := getenv(key=key):
+        return decoder(b64decode(value))
+
+    elif required and default is None:
+        raise ValueError(f"Required environment value `{key}` is missing!")
+
+    else:
+        return default
+
+
 def load_env(
     path: str | None = None,
     override: bool = True,

haiway/utils/queue.py

@@ -1,6 +1,7 @@
 from asyncio import AbstractEventLoop, CancelledError, Future, get_running_loop
 from collections import deque
 from collections.abc import AsyncIterator
+from typing import Any
 
 __all__ = [
     "AsyncQueue",
@@ -13,15 +14,61 @@ class AsyncQueue[Element](AsyncIterator[Element]):
     Cannot be concurrently consumed by multiple readers.
     """
 
+    __slots__ = (
+        "_finish_reason",
+        "_loop",
+        "_queue",
+        "_waiting",
+    )
+
     def __init__(
         self,
         *elements: Element,
         loop: AbstractEventLoop | None = None,
     ) -> None:
-        self._loop: AbstractEventLoop = loop or get_running_loop()
-        self._queue: deque[Element] = deque(elements)
-        self._waiting: Future[Element] | None = None
-        self._finish_reason: BaseException | None = None
+        self._loop: AbstractEventLoop
+        object.__setattr__(
+            self,
+            "_loop",
+            loop or get_running_loop(),
+        )
+        self._queue: deque[Element]
+        object.__setattr__(
+            self,
+            "_queue",
+            deque(elements),
+        )
+        self._waiting: Future[Element] | None
+        object.__setattr__(
+            self,
+            "_waiting",
+            None,
+        )
+        self._finish_reason: BaseException | None
+        object.__setattr__(
+            self,
+            "_finish_reason",
+            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"
+        )
 
     @property
     def is_finished(self) -> bool:
@@ -48,7 +95,11 @@ class AsyncQueue[Element](AsyncIterator[Element]):
         if self.is_finished:
             return  # already finished, ignore
 
-        self._finish_reason = exception or StopAsyncIteration()
+        object.__setattr__(
+            self,
+            "_finish_reason",
+            exception or StopAsyncIteration(),
+        )
 
         if self._waiting is not None and not self._waiting.done():
             # checking loop only on finish as the rest of operations
@@ -57,11 +108,11 @@ class AsyncQueue[Element](AsyncIterator[Element]):
             if get_running_loop() is not self._loop:
                 self._loop.call_soon_threadsafe(
                     self._waiting.set_exception,
-                    self._finish_reason,
+                    self._finish_reason,  # pyright: ignore[reportArgumentType]
                 )
 
             else:
-                self._waiting.set_exception(self._finish_reason)
+                self._waiting.set_exception(self._finish_reason)  # pyright: ignore[reportArgumentType]
 
     def cancel(self) -> None:
         self.finish(exception=CancelledError())
@@ -77,10 +128,18 @@ class AsyncQueue[Element](AsyncIterator[Element]):
 
         try:
             # create a new future to wait for next
-            self._waiting = self._loop.create_future()
+            object.__setattr__(
+                self,
+                "_waiting",
+                self._loop.create_future(),
+            )
             # wait for the result
-            return await self._waiting
+            return await self._waiting  # pyright: ignore[reportGeneralTypeIssues]
 
         finally:
             # cleanup
-            self._waiting = None
+            object.__setattr__(
+                self,
+                "_waiting",
+                None,
+            )

{haiway-0.11.1.dist-info → haiway-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.11.1
+Version: 0.12.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

haiway-0.12.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+haiway/__init__.py,sha256=ONC4Hk0GaPzhQ3oYmgh6Z4kJdXQiyJ8ZQcM_hCUz-IY,2045
+haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+haiway/context/__init__.py,sha256=feqd0eJnGQwh4B8BZXpS0fQRE-DqoFCFOHipF1jOY8A,762
+haiway/context/access.py,sha256=3dloiRk4v3ljIJ8LkjW0Tj4vx6G_mDvjEy0lKLU3Wug,18963
+haiway/context/disposables.py,sha256=vcsh8jRaJ8Q1ob7oh5LsrSPw9f5AMTcaD_p_Gb7tXAI,2588
+haiway/context/identifier.py,sha256=lz-FuspOtsaEsfb7QPrEVWYfbcMJgd3A6BGG3kLbaV0,3914
+haiway/context/logging.py,sha256=F3dr6MLjodg3MX5WTInxn3r3JuihG-giBzumI0GGUQw,5590
+haiway/context/metrics.py,sha256=N20XQtC8au_e_3iWrsZdej78YBEIWF44fdtWcZBWono,5223
+haiway/context/state.py,sha256=E3Z49XeE_EsXfYcPGtd-5_YLD5idK1WMMLZQ02of6cg,4554
+haiway/context/tasks.py,sha256=J1BFQJis_15SIXbFclppxL-AOIThg2KS4SX8Hg_-YRY,2828
+haiway/context/types.py,sha256=VvJA7wAPZ3ISpgyThVguioYUXqhHf0XkPfRd0M1ERiQ,142
+haiway/helpers/__init__.py,sha256=8XRJWNhidWuBKqRZ1Hyc2xqt7DeWLcoOs2V-oexl8VY,579
+haiway/helpers/asynchrony.py,sha256=-yJsttRhKw0GgnzMc0FqIigS5UJl_G0YgkK12V5IzJg,6292
+haiway/helpers/caching.py,sha256=mz8IMKs6KWWVY62PosPbNQ9sGstC6xCWAAWLYZT2oSg,10132
+haiway/helpers/metrics.py,sha256=lCSvat3IrkmytFdqTvsqkVqYcVOK_bByfwYAe0hJIWg,13614
+haiway/helpers/retries.py,sha256=gIkyUlqJLDYaxIZd3qzeqGFY9y5Gp8dgZLlZ6hs8hoc,7538
+haiway/helpers/throttling.py,sha256=RfQn8GGPqTuPWzA1CJvZvb1s00vryVpo-eqz5EY9vD4,4150
+haiway/helpers/timeouted.py,sha256=T2I2fThDuP_wDq_3QnZdEaUgAD16uRacbSF1fRnzAaE,3326
+haiway/helpers/tracing.py,sha256=8Gpcc_DguuHAdaxM4rGP0mB-S-8E7DKt7ZGym9f6x6Q,4018
+haiway/state/__init__.py,sha256=emTuwGFn7HyjyTJ_ass69J5jQIA7_WHO4teZz_dR05Y,355
+haiway/state/attributes.py,sha256=3chvq3ENoIX688RSYiqZnOCpxbzt-kQ2Wl8Fc3vVyMo,23311
+haiway/state/path.py,sha256=5CLPDDi3xQ-XlrIqMfhkdaA-UzgNyY542PQpQXMIjrk,21324
+haiway/state/requirement.py,sha256=qFAbchAOH0Ivgywr8cLlATX-GnNjOyAlQieart6vHSE,7040
+haiway/state/structure.py,sha256=kWpDVadrjJOKLNozFvEJKqsS24ivdoVh9T1ZjOn0yrw,13418
+haiway/state/validation.py,sha256=G-jnP5IQl4l4RcssSlKM63cU3-KHp89wJqOb2-8dNtE,14996
+haiway/types/__init__.py,sha256=-j4uDN6ix3GBXLBqXC-k_QOJSDlO6zvNCxDej8vVzek,342
+haiway/types/default.py,sha256=h38-zFkbn_UPEiw1SdDF5rkObVmD9UJpmyhOgS1gQ9U,2208
+haiway/types/frozen.py,sha256=CZhFCXnWAKEhuWSfILxA8smfdpMd5Ku694ycfLh98R8,76
+haiway/types/missing.py,sha256=rDnyA2wxPkTbJl0L-zbo0owp7IJ04xkCIp6xD6wh8NI,1712
+haiway/utils/__init__.py,sha256=YBq9hYhrHFB-4d_M53A620-2KEz5SMU31GDBW6gXFnQ,804
+haiway/utils/always.py,sha256=2abp8Lm9rQkrfS3rm1Iqhb-IcWyVfH1BULab3KMxgOw,1234
+haiway/utils/collections.py,sha256=pKHZhXqTMcOth7gV6mXcC5WcSyBl70MmVIELbDSmMoA,3320
+haiway/utils/env.py,sha256=-hI4CgLkzdyueuECVjm-TfR3lQjE2bDsc72w7vNC4nQ,5339
+haiway/utils/freezing.py,sha256=K34ZIMzbkpgkHKH-KF73plEbXExsajNRkRTYp9nJEf4,620
+haiway/utils/logs.py,sha256=oDsc1ZdqKDjlTlctLbDcp9iX98Acr-1tdw-Pyg3DElo,1577
+haiway/utils/mimic.py,sha256=BkVjTVP2TxxC8GChPGyDV6UXVwJmiRiSWeOYZNZFHxs,1828
+haiway/utils/noop.py,sha256=qgbZlOKWY6_23Zs43OLukK2HagIQKRyR04zrFVm5rWI,344
+haiway/utils/queue.py,sha256=Tk1bXvuNbEgapeC3-h_PYBASqVjhEoL8mUvtJnM29xI,4000
+haiway-0.12.0.dist-info/METADATA,sha256=Jh6XHQuZ9lJP851DbdhqZYDvLJKu6Wx0gR4jwWk6Pdk,3857
+haiway-0.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+haiway-0.12.0.dist-info/licenses/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
+haiway-0.12.0.dist-info/RECORD,,

haiway-0.11.1.dist-info/RECORD

@@ -1,42 +0,0 @@
-haiway/__init__.py,sha256=PYMHx7JZwwSsALewho7v6EgIb5MUwYgZEWrVH-OhVx0,2005
-haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-haiway/context/__init__.py,sha256=feqd0eJnGQwh4B8BZXpS0fQRE-DqoFCFOHipF1jOY8A,762
-haiway/context/access.py,sha256=KeAgxGf78TufqEUSwvw2LPY2aPE00z6xo3hvQ8L6QO4,17146
-haiway/context/disposables.py,sha256=DZjnMp-wMfF-em2Wjhbm1MvXubNpuzFBT70BQNIxC7M,2019
-haiway/context/identifier.py,sha256=Fyb6OHx5FPaSLLRK249HUEr_KlBSG5F-eW01Oxg_Ke8,2570
-haiway/context/logging.py,sha256=ptwgENuyw-WFgokVsYx9OXZGhJENuO_wgfVjcBryUKM,4251
-haiway/context/metrics.py,sha256=Ve628X39u0rdLm0vYmVZt7aGeoEeRquR6f67vJIXClY,4213
-haiway/context/state.py,sha256=LCcFxXqDBu6prvPyPicN-ecONSNHyR56PfQ5u5jNFCU,3000
-haiway/context/tasks.py,sha256=h6OxLxHHqkw0LfQi81NtbsCKfACKxYRZAkDhlJTpqCM,1904
-haiway/context/types.py,sha256=VvJA7wAPZ3ISpgyThVguioYUXqhHf0XkPfRd0M1ERiQ,142
-haiway/helpers/__init__.py,sha256=8XRJWNhidWuBKqRZ1Hyc2xqt7DeWLcoOs2V-oexl8VY,579
-haiway/helpers/asynchrony.py,sha256=9lo9wT3G0TyPb4vfmTnWGBvB_eN6p6nIlj46_9Ag8fQ,6022
-haiway/helpers/caching.py,sha256=Ok_WE5Whe7XqnIuLZo4rNNBFeWap-aUWX799s4b1JAQ,9536
-haiway/helpers/metrics.py,sha256=0oFBiO-hAzihyC5jvXevNrYOoTcUGc2yGhE1A_866Mc,13314
-haiway/helpers/retries.py,sha256=gIkyUlqJLDYaxIZd3qzeqGFY9y5Gp8dgZLlZ6hs8hoc,7538
-haiway/helpers/throttling.py,sha256=zo0OwFq64si5KUwhd58cFHLmGAmYwRbFRJMbv9suhPs,3844
-haiway/helpers/timeouted.py,sha256=1xU09hQnFdj6p48BwZl5xUvtIr3zC0ZUXehkdrduCjs,3074
-haiway/helpers/tracing.py,sha256=8Gpcc_DguuHAdaxM4rGP0mB-S-8E7DKt7ZGym9f6x6Q,4018
-haiway/state/__init__.py,sha256=emTuwGFn7HyjyTJ_ass69J5jQIA7_WHO4teZz_dR05Y,355
-haiway/state/attributes.py,sha256=plCcYGE5LVU1Nvo0GHkhThqFG96uLR3tFsisQyK1jK0,23122
-haiway/state/path.py,sha256=p-ZVSDU02qAUDln12SDc1pGWzhZ88-1zYEBC0hqceXM,17930
-haiway/state/requirement.py,sha256=3iQqzp5Q7w6y5uClamJGH7S5Hib9pciuTAV27PP5lS8,6161
-haiway/state/structure.py,sha256=bSIj0S_HG-F1Z5GxSlY6VpGtrtiwG82-AIL_PL1lRLo,12465
-haiway/state/validation.py,sha256=r0EMIs-nvoXsmSA74oGu6Lrbw8lkzmseaY82_-E8ous,13814
-haiway/types/__init__.py,sha256=-j4uDN6ix3GBXLBqXC-k_QOJSDlO6zvNCxDej8vVzek,342
-haiway/types/default.py,sha256=IVQsNzDnfukL3-XlScYv2PgTcJ1x_BNP9i5UlS5oEbg,2179
-haiway/types/frozen.py,sha256=CZhFCXnWAKEhuWSfILxA8smfdpMd5Ku694ycfLh98R8,76
-haiway/types/missing.py,sha256=rDnyA2wxPkTbJl0L-zbo0owp7IJ04xkCIp6xD6wh8NI,1712
-haiway/utils/__init__.py,sha256=O7qmAmUktX-X_5D1L5FJMeCFEiOVrrnyYSyiycm4nyg,739
-haiway/utils/always.py,sha256=2abp8Lm9rQkrfS3rm1Iqhb-IcWyVfH1BULab3KMxgOw,1234
-haiway/utils/collections.py,sha256=pKHZhXqTMcOth7gV6mXcC5WcSyBl70MmVIELbDSmMoA,3320
-haiway/utils/env.py,sha256=vlW21LEp8uOVNnUXpBfPtj3zKi9Kkjoemb_H5hQpYPQ,4433
-haiway/utils/freezing.py,sha256=K34ZIMzbkpgkHKH-KF73plEbXExsajNRkRTYp9nJEf4,620
-haiway/utils/logs.py,sha256=oDsc1ZdqKDjlTlctLbDcp9iX98Acr-1tdw-Pyg3DElo,1577
-haiway/utils/mimic.py,sha256=BkVjTVP2TxxC8GChPGyDV6UXVwJmiRiSWeOYZNZFHxs,1828
-haiway/utils/noop.py,sha256=qgbZlOKWY6_23Zs43OLukK2HagIQKRyR04zrFVm5rWI,344
-haiway/utils/queue.py,sha256=jmz5b4cDvdXpuFnAfrNsGB5wXx4ThCgLHbFlH54o8UY,2657
-haiway-0.11.1.dist-info/METADATA,sha256=RAlc7LEyW8N7fizrJI0n_E1e52LlDscJDuEnD_nJdAM,3857
-haiway-0.11.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-haiway-0.11.1.dist-info/licenses/LICENSE,sha256=GehQEW_I1pkmxkkj3NEa7rCTQKYBn7vTPabpDYJlRuo,1063
-haiway-0.11.1.dist-info/RECORD,,