stark-engine 4.5.3__tar.gz → 4.5.4__tar.gz

{stark_engine-4.5.3 → stark_engine-4.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stark-engine
-Version: 4.5.3
+Version: 4.5.4
 Summary: S.T.A.R.K - Speech and Text Algorithmic Recognition Kit. Modern framework for creating powerfull voice assistants.
 License: CC BY-NC-SA 4.0
 License-File: LICENSE.md

{stark_engine-4.5.3 → stark_engine-4.5.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "stark-engine"
-version = "4.5.3"
+version = "4.5.4"
 description = "S.T.A.R.K - Speech and Text Algorithmic Recognition Kit. Modern framework for creating powerfull voice assistants."
 authors = ["MarkParker5 <mark@parker-programs.com>"]
 license = "CC BY-NC-SA 4.0"

{stark_engine-4.5.3 → stark_engine-4.5.4}/stark/core/parsing.py

@@ -12,6 +12,7 @@ from stark.core.types.string import String
 from stark.core.types.union import Union, _all_subclasses
 from stark.core.types.word import Word
 from stark.general.cache import alru_cache
+from stark.general.feature_flags import FeatureFlag, get_flag
 from stark.general.localisation import LanguageCode, LocaleString, Localizer
 from stark.models.transcription_string import Correction
 from stark.tools.common.span import Span
@@ -192,7 +193,7 @@ class PatternParser:
             string = from_string._with(object_pattern_match.substring)  # TODO: review _with usage
 
             parser: ObjectParser = self.parameter_types_by_name[object_type.__name__].parser
-            obj = object_type(string)  # temp/default value, may be overridden by did_parse
+            obj = object_type()  # object_type(string)  # temp/default value, may be overridden by did_parse
 
             matched_subparams = object_pattern_match.parameters
             assert matched_subparams.keys() <= {p.name for p in pattern.parameters.values() if not p.optional}
@@ -213,9 +214,10 @@ class PatternParser:
             assert substring in string, ValueError(
                 f"Parsed substring must be a part of the original string. There is no '{substring}' in '{string}'. Object: {obj!r}, Parser: {parser!r}"
             )
-            assert obj.value is not None, ValueError(
-                f"Parsed object {obj!r} must have a `value` property set in did_parse method. Object: {obj!r}, Parser: {parser!r}"
-            )
+            if not get_flag(FeatureFlag.TYPE_NO_REQUIRED_VALUE):
+                assert obj.value is not None, ValueError(
+                    f"Parsed object {obj!r} must have a `value` property set at the time did_parse method returns. Object: {obj!r}, Parser: {parser!r}"
+                )
 
             yield ParseResult(obj, substring)
 

{stark_engine-4.5.3 → stark_engine-4.5.4}/stark/core/types/object.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import copy
 from abc import ABCMeta
-from typing import Any
 
 from stark.core.patterns.pattern import Pattern
 from stark.general.classproperty import classproperty
@@ -40,7 +39,7 @@ class UnionMeta(ABCMeta):
 # TODO: review programmable init vs did_parse
 # TODO: consider storing parsing metadata here like substr and span
 class Object[T](metaclass=UnionMeta):
-    value: T
+    value: T = None
 
     @classproperty
     def pattern(cls) -> Pattern:
@@ -60,9 +59,13 @@ class Object[T](metaclass=UnionMeta):
         """
         return False  # TODO: review default behavior
 
-    def __init__(self, value: Any):
-        """Just init with wrapped value."""
-        self.value = value
+    def __init__(self, *args, **kwargs):
+        """Init with wrapped value, if provided. Otherwise leave `value` untouched so a static
+        value set at class declaration time (e.g. `value = "foo"`) survives instantiation."""
+        if "value" in kwargs:
+            self.value = kwargs["value"]
+        elif args:
+            self.value = args[0]
 
     async def did_parse(self, from_string: LocaleString) -> str:
         """
@@ -79,6 +82,8 @@ class Object[T](metaclass=UnionMeta):
         Raises:
             ParseError: if parsing failed.
         """
+        if not self.value:
+            self.value = from_string
         return from_string
 
     def copy(self) -> Object:

{stark_engine-4.5.3 → stark_engine-4.5.4}/stark/general/feature_flags.py

@@ -5,11 +5,13 @@ from enum import StrEnum
 class FeatureFlag(StrEnum):
     ENABLE_VOICE_CLI = "STARK_ENABLE_VOICE_CLI"
     ENABLE_MULTILANG_MATRIX = "STARK_ENABLE_MULTILANG_MATRIX"
+    TYPE_NO_REQUIRED_VALUE = "STARK_TYPE_NO_REQUIRED_VALUE"
 
 
 _DEFAULTS: dict[FeatureFlag, str] = {
     FeatureFlag.ENABLE_VOICE_CLI: "0",
     FeatureFlag.ENABLE_MULTILANG_MATRIX: "1",
+    FeatureFlag.TYPE_NO_REQUIRED_VALUE: "0",
 }