mloda 0.4.4__py3-none-any.whl → 0.4.5__py3-none-any.whl

mloda/core/abstract_plugins/components/domain.py

@@ -3,18 +3,31 @@ from typing import Any
 
 
 class Domain:
-    """
-    Documentation domain:
-
-    default value is default_domain. The purpose of this is to allow for a default domain to be used if no domain is given.
-    Usecase: Testing, POCS etc. This is a tool to make life easier for the user.
-
-    can be defined by:
-    feature.domain: either by options or by domain
-    feature_group.domain: returns the domain name rule for the feature group
-
-    We validate in IdentifyFeatureGroupClass that there is atleast one feature group with the same domain as the feature.
-    If the feature does not have a domain, and we have not exactly one matching feature group to the feature, we raise an error.
+    """Represents a domain for isolating features across business contexts.
+
+    Domains enable data isolation between different contexts (Sales, Finance, Test, etc.).
+    The framework matches feature domains to feature group domains for resolution.
+
+    Definition:
+        - Feature: via `domain` parameter or `options={"domain": "..."}`
+        - FeatureGroup: via `get_domain()` classmethod (default: "default_domain")
+
+    Propagation:
+        When a parent feature has a domain, child features inherit it automatically.
+        You can override this by setting an explicit domain on each dependent feature.
+
+        +------------------------------------------+---------------+------------------+
+        | Child Definition                         | Parent Domain | Result           |
+        +------------------------------------------+---------------+------------------+
+        | "child" (string)                         | "Sales"       | Inherits "Sales" |
+        | Feature("child")                         | "Sales"       | Inherits "Sales" |
+        | Feature("child", domain="Finance")       | "Sales"       | Keeps "Finance"  |
+        | Any                                      | None          | No domain        |
+        +------------------------------------------+---------------+------------------+
+
+    Validation:
+        IdentifyFeatureGroupClass ensures at least one feature group matches the feature's domain.
+        If a feature has no domain and multiple groups match, an error is raised.
     """
 
     def __init__(self, name: str):

mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser.py

@@ -92,11 +92,8 @@ class FeatureChainParser:
         """Internal method for matching pattern-based features - used by match_configuration_feature_chain_parser."""
         _feature_name: FeatureName = FeatureName(feature_name) if isinstance(feature_name, str) else feature_name
 
-        try:
-            has_prefix_configuration, source_feature = cls.parse_feature_name(_feature_name, prefix_patterns, pattern)
-            if has_prefix_configuration is None or source_feature is None:
-                return False
-        except ValueError:
+        has_prefix_configuration, source_feature = cls.parse_feature_name(_feature_name, prefix_patterns, pattern)
+        if has_prefix_configuration is None or source_feature is None:
             return False
         return True
 
@@ -304,7 +301,6 @@ class FeatureChainParser:
                 return True
 
         # configuration-based
-
         if property_mapping is not None:
             return cls._validate_options_against_property_mapping(options, property_mapping)
 

mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser_mixin.py

@@ -131,13 +131,16 @@ class FeatureChainParserMixin:
         prefix_patterns = cls._get_prefix_patterns()
         property_mapping = cls._get_property_mapping()
 
-        # Use the unified parser for basic matching
-        result = FeatureChainParser.match_configuration_feature_chain_parser(
-            _feature_name,
-            options,
-            property_mapping=property_mapping,
-            prefix_patterns=prefix_patterns,
-        )
+        try:
+            # Use the unified parser for basic matching
+            result = FeatureChainParser.match_configuration_feature_chain_parser(
+                _feature_name,
+                options,
+                property_mapping=property_mapping,
+                prefix_patterns=prefix_patterns,
+            )
+        except ValueError:
+            return False
 
         # If basic match succeeded and it's a string-based feature, call validation hook
         if result:

mloda/core/abstract_plugins/components/feature_collection.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 from typing import Generator, List, Optional, Set, Union
 from uuid import UUID
+from mloda.core.abstract_plugins.components.domain import Domain
 from mloda.core.abstract_plugins.components.feature import Feature
 from mloda.core.abstract_plugins.components.options import Options
 from mloda_plugins.feature_group.experimental.default_options_key import DefaultOptionKeys
@@ -17,9 +18,11 @@ class Features:
         features: List[Union[Feature, str]],
         child_options: Optional[Options] = None,
         child_uuid: Optional[UUID] = None,
+        parent_domain: Optional[str] = None,
     ) -> None:
         self.collection: List[Feature] = []
         self.child_uuid: Optional[UUID] = child_uuid
+        self.parent_domain: Optional[str] = parent_domain
 
         self.parent_uuids: set[UUID] = set()
 
@@ -36,7 +39,11 @@ class Features:
             if child_options.group == {} and child_options.context == {}:
                 child_options = Options({})
 
-            feature = Feature(name=feature, options=child_options) if isinstance(feature, str) else feature
+            if isinstance(feature, str):
+                feature = Feature(name=feature, options=child_options, domain=self.parent_domain)
+            else:
+                if feature.domain is None and self.parent_domain is not None:
+                    feature.domain = Domain(self.parent_domain)
             if child_uuid:
                 self.parent_uuids.add(feature.uuid)
                 self.child_uuid = child_uuid

mloda/core/core/engine.py

@@ -116,7 +116,10 @@ class Engine:
         added = self.add_feature_to_collection(feature_group_class, feature, features.child_uuid)
 
         if added:
-            self._handle_input_features_recursion(feature_group_class, feature.uuid, feature.options, feature.name)
+            parent_domain = feature.domain.name if feature.domain else None
+            self._handle_input_features_recursion(
+                feature_group_class, feature.uuid, feature.options, feature.name, parent_domain=parent_domain
+            )
 
         if self.global_filter:
             self._add_filter_feature(feature_group_class, feature_group, feature, features)
@@ -265,7 +268,12 @@ class Engine:
             self.feature_link_parents[child_uuid].add(wanted_uuid)
 
     def _handle_input_features_recursion(
-        self, feature_group_class: Type[FeatureGroup], uuid: UUID, options: Options, feature_name: FeatureName
+        self,
+        feature_group_class: Type[FeatureGroup],
+        uuid: UUID,
+        options: Options,
+        feature_name: FeatureName,
+        parent_domain: Optional[str] = None,
     ) -> None:
         """Handles recursion for input features of a feature group."""
         feature_group = feature_group_class()
@@ -278,7 +286,9 @@ class Engine:
             input_features = None
 
         if input_features:
-            features = Features(list(input_features), child_options=options, child_uuid=uuid)
+            features = Features(
+                list(input_features), child_options=options, child_uuid=uuid, parent_domain=parent_domain
+            )
             if features.child_uuid is None:
                 raise ValueError(f"Features {features} has no parent uuid although it should have one.")
             self.feature_link_parents[features.child_uuid] = features.parent_uuids

{mloda-0.4.4.dist-info → mloda-0.4.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mloda
-Version: 0.4.4
+Version: 0.4.5
 Summary: mloda.ai: Open Data Access for ML and AI
 Author-email: Tom Kaltofen <info@mloda.ai>
 License: Apache-2.0

{mloda-0.4.4.dist-info → mloda-0.4.5.dist-info}/RECORD

@@ -10,9 +10,9 @@ mloda/core/abstract_plugins/components/base_feature_group_version.py,sha256=JNnr
 mloda/core/abstract_plugins/components/base_validator.py,sha256=-8sING9RE9vl5BuZZHtqaMbhF8w1WTS-fjXK5VwMuYY,2363
 mloda/core/abstract_plugins/components/data_access_collection.py,sha256=PVO6w8UOV6qyyYtlkzXAs-qM7WXsyrHqQP5CYCYu3G8,1551
 mloda/core/abstract_plugins/components/data_types.py,sha256=uiq26Z7pikUiZIfdi28VbWoxLQUQ1wCH2rp7uI5XrvA,5033
-mloda/core/abstract_plugins/components/domain.py,sha256=AzVvWgG3oeHUCXJDtN2heyiUQ1zRK7u5O6az5kWxj_I,1226
+mloda/core/abstract_plugins/components/domain.py,sha256=Jr1bRpaJP3-tYF0ii0tIYv_bpJUqv8SDAk6LljyAAfo,2099
 mloda/core/abstract_plugins/components/feature.py,sha256=WHK_FIe5EMq1v4ORod3ae8oaDHt4J1uktb9H-0v5m08,10478
-mloda/core/abstract_plugins/components/feature_collection.py,sha256=vT4vlZyCRM3G9PtAJHovLoER4ElY08PlTlFzYPcCVyo,4636
+mloda/core/abstract_plugins/components/feature_collection.py,sha256=OfLCspXxAHBBeLri6zIwXs17KWciv1tvXrPq4n3ixqM,4995
 mloda/core/abstract_plugins/components/feature_name.py,sha256=AgWceOqyHNYGVM5XE1NrGFeZKf9AKtLRoRRaxL7tHzk,673
 mloda/core/abstract_plugins/components/feature_set.py,sha256=hVJ_t4p30BNOknkMKiyDkYRWbbEd_GtpGf2lW9n3PdM,4226
 mloda/core/abstract_plugins/components/hashable_dict.py,sha256=xzUIn2wbujo3jwwGayHnSbrrADSiVYU_xUV1nt5Yk8M,426
@@ -21,8 +21,8 @@ mloda/core/abstract_plugins/components/options.py,sha256=z2hzPSl-B-trh1UELdBekAe
 mloda/core/abstract_plugins/components/parallelization_modes.py,sha256=QeU83qUlg4smUW9Q_cs0XaaBcKDxI7vh8pILUHZd_YM,143
 mloda/core/abstract_plugins/components/utils.py,sha256=_ofeiOBQLwYU3_p9JBe61Ihps4dpFUcsrqI6XrA92Yo,530
 mloda/core/abstract_plugins/components/feature_chainer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser.py,sha256=aGO10OgAfaVs-y4kgSbAtVL2jI7E3EDsfWOkuWlPgDA,14149
-mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser_mixin.py,sha256=yOyWmVd560pV6hL02PyiShNqi6-hMhkME7U80EHWdC8,7444
+mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser.py,sha256=kjLO0VSGXh53L8HBXWO5bYmaqLmek917AA_qqPLrZBo,14071
+mloda/core/abstract_plugins/components/feature_chainer/feature_chain_parser_mixin.py,sha256=NQfipxPQ6LPN2zXuJAbMj6JaGa6voTBnvb34vp0Y1og,7537
 mloda/core/abstract_plugins/components/framework_transformer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda/core/abstract_plugins/components/framework_transformer/base_transformer.py,sha256=3eRSOzYZZ4OHRezvUnw4RLTUjirMGtcZCKQYJ1MuuZU,5793
 mloda/core/abstract_plugins/components/framework_transformer/cfw_transformer.py,sha256=xuK3DSuSdmos1w639ZRQEO6ZwihjQmBG3RSp5jU1gk4,4298
@@ -63,7 +63,7 @@ mloda/core/api/prepare/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 mloda/core/api/prepare/setup_compute_framework.py,sha256=In6o7YuBpJFKa6Brrrtsjf1bxhiv43toJr9NBQCAiH4,2658
 mloda/core/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda/core/core/cfw_manager.py,sha256=DNmbEOIhjKX_G0lva6XqCL0GJIIKy9PfOTXT4g8N9FM,8769
-mloda/core/core/engine.py,sha256=yXNbV4LZZaAro1iSEmeFNOKgt5m8P9IIotTjT8jixg4,13690
+mloda/core/core/engine.py,sha256=jQRDyjmDyhGT-LmWyTX_qS87NBz7-xC0ZK0-Ti6OtEo,13962
 mloda/core/core/step/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda/core/core/step/abstract_step.py,sha256=hIsvJ21hvDXDH1HJSc76WL22FtEvSEN5g7pVpQBEoEU,1304
 mloda/core/core/step/feature_group_step.py,sha256=3lGaaF0r4FhsSUhdAN7hh3QiNz_0dpW3cRBoKOtaTus,5293
@@ -106,8 +106,8 @@ mloda/steward/__init__.py,sha256=PPXY3o4OM_daV6wD3DJNuPPCEEQg5NeETlG6cAmkzRE,696
 mloda/steward/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda/user/__init__.py,sha256=TG00kApwQzj8FCRIsTy-PomisoULbSTh5CgqlUT6Wvc,1879
 mloda/user/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mloda-0.4.4.dist-info/licenses/LICENSE.TXT,sha256=gmhQwSkHxjiShsqQ1FpJ-20YFtaa4vRCE7aCx55-6nk,11366
-mloda-0.4.4.dist-info/licenses/NOTICE.md,sha256=Hu10B2sPnGLIHxZ4QhACSLLxukJpeJzjvkzCu48q5fY,520
+mloda-0.4.5.dist-info/licenses/LICENSE.TXT,sha256=gmhQwSkHxjiShsqQ1FpJ-20YFtaa4vRCE7aCx55-6nk,11366
+mloda-0.4.5.dist-info/licenses/NOTICE.md,sha256=Hu10B2sPnGLIHxZ4QhACSLLxukJpeJzjvkzCu48q5fY,520
 mloda_plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda_plugins/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda_plugins/compute_framework/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -244,8 +244,8 @@ mloda_plugins/function_extender/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm
 mloda_plugins/function_extender/base_implementations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda_plugins/function_extender/base_implementations/otel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mloda_plugins/function_extender/base_implementations/otel/otel_extender.py,sha256=cKFWuVHOzk78Jm4zFfHxdTYcNVAzaM-ORSV0QCkScQM,660
-mloda-0.4.4.dist-info/METADATA,sha256=b5c9VSB_4IgwuUtbIFE3KT-EaZQHIn5VCMGRi5zqmQ8,12199
-mloda-0.4.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-mloda-0.4.4.dist-info/entry_points.txt,sha256=f7hp7s4laABj9eN5YwEjQAyInF-fa687MXdz-hKYMIA,80
-mloda-0.4.4.dist-info/top_level.txt,sha256=zImHD-7ilfeB7QZ6Bd9Htwwx5O-Z84D0T2pUgKrGDdc,20
-mloda-0.4.4.dist-info/RECORD,,
+mloda-0.4.5.dist-info/METADATA,sha256=GLEbX7dVW2UqWlG57Mn-_umPJcXvD0v3mVqJTIWNTtw,12199
+mloda-0.4.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+mloda-0.4.5.dist-info/entry_points.txt,sha256=f7hp7s4laABj9eN5YwEjQAyInF-fa687MXdz-hKYMIA,80
+mloda-0.4.5.dist-info/top_level.txt,sha256=zImHD-7ilfeB7QZ6Bd9Htwwx5O-Z84D0T2pUgKrGDdc,20
+mloda-0.4.5.dist-info/RECORD,,