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

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.2.dist-info → haiway-0.21.3.dist-info}/METADATA

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

@@ -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.2.dist-info/METADATA,sha256=9mHlQYan6RnsCcixkZBb8lt2v4SSNTV3q6_8u_X5uFE,4919
-haiway-0.21.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-haiway-0.21.2.dist-info/licenses/LICENSE,sha256=3phcpHVNBP8jsi77gOO0E7rgKeDeu99Pi7DSnK9YHoQ,1069
-haiway-0.21.2.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,,