haiway 0.21.1__py3-none-any.whl → 0.21.3__py3-none-any.whl

haiway/context/access.py

@@ -302,7 +302,7 @@ class ctx:
     def scope(
         label: str,
         /,
-        *state: State,
+        *state: State | None,
         disposables: Disposables | Iterable[Disposable] | None = None,
         task_group: TaskGroup | None = None,
         observability: Observability | Logger | None = None,
@@ -316,7 +316,7 @@ class ctx:
         label: str
             name of the scope context
 
-        *state: State | Disposable
+        *state: State | None
             state propagated within the scope context, will be merged with current state by\
              replacing current with provided on conflict.
 
@@ -355,14 +355,14 @@ class ctx:
         return ScopeContext(
             label=label,
             task_group=task_group,
-            state=state,
+            state=tuple(element for element in state if element is not None),
             disposables=resolved_disposables,
             observability=observability,
         )
 
     @staticmethod
     def updated(
-        *state: State,
+        *state: State | None,
     ) -> StateContext:
         """
         Update scope context with given state. When called within an existing context\
@@ -370,7 +370,7 @@ class ctx:
 
         Parameters
         ----------
-        *state: State
+        *state: State | None
             state propagated within the updated scope context, will be merged with current if any\
              by replacing current with provided on conflict
 
@@ -380,7 +380,7 @@ class ctx:
             state part of context object intended to enter context manager with it
         """
 
-        return StateContext.updated(state)
+        return StateContext.updated(element for element in state if element is not None)
 
     @staticmethod
     def spawn[Result, **Arguments](

haiway/state/requirement.py

@@ -1,4 +1,6 @@
-from collections.abc import Callable, Collection, Iterable
+import re
+import unicodedata
+from collections.abc import Callable, Collection, Iterable, Sequence, Set
 from typing import Any, Literal, Self, cast, final
 
 from haiway.state.path import AttributePath
@@ -66,6 +68,83 @@ class AttributeRequirement[Root]:
             check=check_equal,
         )
 
+    @classmethod
+    def text_match[Parameter](
+        cls,
+        value: str,
+        /,
+        path: AttributePath[Root, str] | str,
+    ) -> Self:
+        """
+        Create a requirement that performs text matching on an attribute.
+
+        Parameters
+        ----------
+        value : str
+            The search term (can contain multiple words separated by spaces/punctuation)
+        path : AttributePath[Root, str] | str
+            The path to the string attribute to search in
+
+        Returns
+        -------
+        Self
+            A new requirement instance
+
+        Raises
+        ------
+        AssertionError
+            If path is not an AttributePath
+        """
+        assert isinstance(  # nosec: B101
+            path, AttributePath
+        ), "Prepare attribute path by using Self._.path.to.property or explicitly"
+
+        def check_like(root: Root) -> None:
+            checked: Any = cast(AttributePath[Root, str], path)(root)
+            if not isinstance(checked, str):
+                raise ValueError(
+                    f"Attribute value must be a string for like operation, got {type(checked)}"
+                    f" for '{path.__repr__()}'"
+                )
+
+            # Perform full text search with proper Unicode support and word boundaries
+            def tokenize_text(text: str) -> Sequence[str]:
+                # Normalize and case-fold the text
+                normalized = unicodedata.normalize("NFC", text).casefold()
+                # Split on word boundaries and filter out empty strings
+                # re.UNICODE handles international characters, multiline text works by default
+                tokens = re.findall(r"\b\w+\b", normalized, re.UNICODE)
+                return tokens
+
+            # Tokenize both search terms and target text
+            search_tokens: Sequence[str] = tokenize_text(value)
+            target_tokens: Sequence[str] = tokenize_text(checked)
+            target_tokens_set: Set[str] = set(target_tokens)
+
+            # Check if all search tokens are found as complete words in target text
+            missing_terms = [
+                original_term
+                for original_term, token in zip(
+                    value.split(),
+                    search_tokens,
+                    strict=False,
+                )
+                if token not in target_tokens_set
+            ]
+
+            if missing_terms:
+                raise ValueError(
+                    f"Text search failed: '{checked}' is not like '{value}'. "
+                    f"Missing tokens: {missing_terms} for '{path.__repr__()}'"
+                )
+
+        return cls(
+            path,
+            "like",
+            value,
+            check=check_like,
+        )
+
     @classmethod
     def not_equal[Parameter](
         cls,
@@ -266,6 +345,7 @@ class AttributeRequirement[Root]:
         lhs: Any,
         operator: Literal[
             "equal",
+            "like",
             "not_equal",
             "contains",
             "contains_any",
@@ -298,6 +378,7 @@ class AttributeRequirement[Root]:
         )
         self.operator: Literal[
             "equal",
+            "like",
             "not_equal",
             "contains",
             "contains_any",

{haiway-0.21.1.dist-info → haiway-0.21.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: haiway
-Version: 0.21.1
+Version: 0.21.3
 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.21.1.dist-info → haiway-0.21.3.dist-info}/RECORD

@@ -1,7 +1,7 @@
 haiway/__init__.py,sha256=keuz9FN8VqLamqrzvjK2IAjkdyyFcnboDrB9xkFPgXk,1861
 haiway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 haiway/context/__init__.py,sha256=1N_SvdPkTfIZDZybm3y0rY2dGrDLWTm0ryzUz2XD4f8,1174
-haiway/context/access.py,sha256=lDvkMoqUOwzBt-P8mI-VggS2wrP_BJLmYrArdj8z4SE,21644
+haiway/context/access.py,sha256=60guObLq5lYjBxSnT9iaEZI5x35Xen_doxY4oCrbn9Q,21758
 haiway/context/disposables.py,sha256=0vf6kOZ80o6oa8IuU4xQttqtzMT4ODh33XuDh4SGOnc,4742
 haiway/context/identifier.py,sha256=dCCwLneXJzH__ZWFlGRUHvoCmbT4lM0QVbyokYIbUHg,5255
 haiway/context/observability.py,sha256=gLKbMPNvt5ozrfyc4TGahN8A_dFFtyCjUIMZu9_wZHA,23722
@@ -22,7 +22,7 @@ haiway/opentelemetry/observability.py,sha256=5fsHsFgjcxUcA0hIOM18lVvVdYSRO91ER52
 haiway/state/__init__.py,sha256=AaMqlMhO4zKS_XNevy3A7BHh5PxmguA-Sk_FnaNDY1Q,355
 haiway/state/attributes.py,sha256=sububiFP23aBB8RGk6OvTUp7BEY6S0kER_uHC09yins,26733
 haiway/state/path.py,sha256=bv5MI3HmUyku78k0Sz5lc7Q_Bay53iom1l3AL5KZs-4,32143
-haiway/state/requirement.py,sha256=NbXL7JrB-zGE6KShcRRtq-wJbKu5lHlhFdmfhyJZdkc,12797
+haiway/state/requirement.py,sha256=uj-mezofTEPDXUuvlHreIjy5Ya-Hig8TR8VE6R8wdyY,15611
 haiway/state/structure.py,sha256=KKIId-mrHAzGjYKKlvnlscMijVZVM8nDLnAwCFn1sTc,23259
 haiway/state/validation.py,sha256=eDOZKRrfd-dmdbqoHcLacdCVKmVCEpwt239EG6ljNF8,23557
 haiway/types/__init__.py,sha256=jFr5kf36SvVGdgngvik6_HzG8YNa3NVsdDDSqxVuGm4,281
@@ -39,7 +39,7 @@ haiway/utils/mimic.py,sha256=xaZiUKp096QFfdSw7cNIKEWt2UIS7vf880KF54gny38,1831
 haiway/utils/noop.py,sha256=U8ocfoCgt-pY0owJDPtrRrj53cabeIXH9qCKWMQnoRk,1336
 haiway/utils/queue.py,sha256=6v2u3pA6A44IuCCTOjmCt3yLyOcm7PCRnrIGo25j-1o,6402
 haiway/utils/stream.py,sha256=lXaeveTY0-AYG5xVzcQYaiC6SUD5fUtHoMXiQcrQAAM,5723
-haiway-0.21.1.dist-info/METADATA,sha256=LdHoQk1LAFTONT6SFzeZ07x9hKvRqNZP4a7hGdhWdiE,4919
-haiway-0.21.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-haiway-0.21.1.dist-info/licenses/LICENSE,sha256=3phcpHVNBP8jsi77gOO0E7rgKeDeu99Pi7DSnK9YHoQ,1069
-haiway-0.21.1.dist-info/RECORD,,
+haiway-0.21.3.dist-info/METADATA,sha256=iUkk5Z8qoOqq41SjzBEkBlhoFEeBO_eO6pns1C0W08I,4919
+haiway-0.21.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+haiway-0.21.3.dist-info/licenses/LICENSE,sha256=3phcpHVNBP8jsi77gOO0E7rgKeDeu99Pi7DSnK9YHoQ,1069
+haiway-0.21.3.dist-info/RECORD,,