anemoi-utils 0.4.17__py3-none-any.whl → 0.4.18__py3-none-any.whl

anemoi/utils/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.4.17'
-__version_tuple__ = version_tuple = (0, 4, 17)
+__version__ = version = '0.4.18'
+__version_tuple__ = version_tuple = (0, 4, 18)

anemoi/utils/rules.py

@@ -0,0 +1,218 @@
+# (C) Copyright 2025 Anemoi contributors.
+#
+# This software is licensed under the terms of the Apache Licence Version 2.0
+# which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# In applying this licence, ECMWF does not waive the privileges and immunities
+# granted to it by virtue of its status as an intergovernmental organisation
+# nor does it submit to any jurisdiction.
+
+from typing import Any
+from typing import Dict
+from typing import List
+from typing import Mapping
+from typing import Optional
+from typing import Union
+
+
+class Rule:
+
+    def __init__(self, match: Dict[str, Any], result: Any):
+        """Initialize a Rule object.
+
+        Parameters
+        ----------
+        match : Dict[str, Any]
+            A dictionary defining the conditions for the rule to match.
+        result : Any
+            The result to return if the rule matches.
+        """
+        self._match = match
+        self._result = result
+
+    def match(self, obj: Mapping[str, Any]) -> bool:
+        """Check if the rule matches the given object.
+
+        Parameters
+        ----------
+        obj : Mapping[str, Any]
+            The object to check against the rule's conditions.
+
+        Returns
+        -------
+        bool
+            True if the rule matches, False otherwise.
+        """
+        for key, value in self._match.items():
+            if key not in obj or obj[key] != value:
+                return False
+
+        return True
+
+    @property
+    def result(self) -> Any:
+        return self._result
+
+    @property
+    def condition(self) -> Dict[str, Any]:
+        return self._match
+
+
+class RuleSet:
+
+    def __init__(self, rules: List[Union[Rule, Dict[str, Any], List[Any]]]):
+        """Initialize a RuleSet object.
+
+        Parameters
+        ----------
+        rules : List[Union[Rule, Dict[str, Any], List[Any]]]
+            A list of rules, where each rule can be a Rule object, a dictionary with
+            'match' and 'result' keys, or a list with two elements (match and result).
+        """
+        assert isinstance(rules, list), "rules must be a list"
+
+        self.rules: List[Rule] = []
+
+        for rule in rules:
+            if isinstance(rule, Rule):
+                self.rules.append(rule)
+                continue
+
+            if isinstance(rule, dict):
+
+                assert len(rule) == 2, "Rule dictionary must contain exactly two key-value pair."
+
+                match = rule.get("match")
+                if match is None:
+                    raise ValueError("Rule dictionary must contain a 'match' key.")
+
+                result = rule.get("result")
+                if result is None:
+                    raise ValueError("Rule dictionary must contain a 'result' key.")
+
+                self.rules.append(Rule(match, result))
+                continue
+
+            if isinstance(rule, list):
+                assert len(rule) == 2, "Rule list must contain exactly two elements."
+                match = rule[0]
+                result = rule[1]
+                self.rules.append(Rule(match, result))
+                continue
+
+            raise ValueError(
+                "Rule must be either a Rule object, a dictionary with 'match' and 'result' keys, or a list with two elements."
+            )
+
+    @classmethod
+    def from_list(cls, rules: List[Any]) -> "RuleSet":
+        """Create a RuleSet from a list of rules.
+
+        Parameters
+        ----------
+        rules : List[Any]
+            A list of rules to initialize the RuleSet.
+
+        Returns
+        -------
+        RuleSet
+            A new RuleSet object.
+        """
+        return cls(rules)
+
+    @classmethod
+    def from_files(cls, path: str) -> "RuleSet":
+        """Create a RuleSet from a file.
+
+        Parameters
+        ----------
+        path : str
+            The path to the file containing the rules. Supported formats are .json and .yaml/.yml.
+
+        Returns
+        -------
+        RuleSet
+            A new RuleSet object.
+
+        Raises
+        ------
+        ValueError
+            If the file format is unsupported.
+        """
+        if path.endswith(".json"):
+            import json
+
+            with open(path, "r") as f:
+                return cls.from_list(json.load(f))
+
+        if path.endswith(".yaml") or path.endswith(".yml"):
+            import yaml
+
+            with open(path, "r") as f:
+                return cls.from_list(yaml.safe_load(f))
+
+        raise ValueError("Unsupported file format. Supported formats are .json and .yaml/.yml.")
+
+    @classmethod
+    def from_any(cls, rules: Union[str, List[Any]]) -> "RuleSet":
+        """Create a RuleSet from a list or a file path.
+
+        Parameters
+        ----------
+        rules : Union[str, List[Any]]
+            The rules to initialize the RuleSet, either as a list or a file path.
+
+        Returns
+        -------
+        RuleSet
+            A new RuleSet object.
+
+        Raises
+        ------
+        ValueError
+            If the rules format is unsupported.
+        """
+        if isinstance(rules, str):
+            return cls.from_files(rules)
+
+        if isinstance(rules, list):
+            return cls.from_list(rules)
+
+        raise ValueError("Unsupported rules format. Must be a list or a file path.")
+
+    def match(self, obj: Mapping[str, Any], strategy: str = "first-match") -> Optional[Rule]:
+        """Match an object against the rules in the RuleSet.
+
+        Parameters
+        ----------
+        obj : Mapping[str, Any]
+            The object to match against the rules.
+        strategy : str, optional
+            The matching strategy to use. Currently, only 'first-match' is supported.
+
+        Returns
+        -------
+        Optional[Rule]
+            The first matching rule, or None if no match is found.
+
+        Raises
+        ------
+        AssertionError
+            If an unsupported strategy is provided.
+        """
+        assert strategy == "first-match", "Only 'first-match' strategy is supported for now."
+        for rule in self.rules:
+            if rule.match(obj):
+                return rule
+
+        return None
+
+    def __iter__(self) -> iter:
+        """Return an iterator over the rules in the RuleSet.
+
+        Returns
+        -------
+        iter
+            An iterator over the Rule objects in the RuleSet.
+        """
+        return iter(self.rules)

{anemoi_utils-0.4.17.dist-info → anemoi_utils-0.4.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anemoi-utils
-Version: 0.4.17
+Version: 0.4.18
 Summary: A package to hold various functions to support training of ML models on ECMWF data.
 Author-email: "European Centre for Medium-Range Weather Forecasts (ECMWF)" <software.support@ecmwf.int>
 License:                                  Apache License

{anemoi_utils-0.4.17.dist-info → anemoi_utils-0.4.18.dist-info}/RECORD

@@ -1,6 +1,6 @@
 anemoi/utils/__init__.py,sha256=uVhpF-VjIl_4mMywOVtgTutgsdIsqz-xdkwxeMhzuag,730
 anemoi/utils/__main__.py,sha256=6LlE4MYrPvqqrykxXh7XMi50UZteUY59NeM8P9Zs2dU,910
-anemoi/utils/_version.py,sha256=UwtfX--7I9I_2cUoyH0-NALXkddhkqIyGBlxSkUZCdU,513
+anemoi/utils/_version.py,sha256=k9MQ8BJ_knOnasrd-KVQ3E0l9YzHo7DymdQPhaKLLNU,513
 anemoi/utils/caching.py,sha256=rXbeAmpBcMbbfN4EVblaHWKicsrtx1otER84FEBtz98,6183
 anemoi/utils/checkpoints.py,sha256=N4WpAZXa4etrpSEKhHqUUtG2-x9w3FJMHcLO-dDAXPY,9600
 anemoi/utils/cli.py,sha256=IyZfnSw0u0yYnrjOrzvm2RuuKvDk4cVb8pf8BkaChgA,6209
@@ -15,6 +15,7 @@ anemoi/utils/humanize.py,sha256=pjnFJAKHbEAOfcvn8c48kt-8eFy6FGW_U2ruJvfamrA,2518
 anemoi/utils/logs.py,sha256=naTgrmPwWHD4eekFttXftS4gtcAGYHpCqG4iwYprNDA,1804
 anemoi/utils/provenance.py,sha256=xC6mTstF7f_asqtPSrulC7c34xjOSuAxWhkwc3yKhHg,14629
 anemoi/utils/registry.py,sha256=vIaHMT66m0_w8lrY3u5GmT70tIRNyA_Z_p_T7pTFx_k,9637
+anemoi/utils/rules.py,sha256=xYCiUV_HXTGFe93diqMLQsMJCWGi5umd_bWEeYP8XFY,6318
 anemoi/utils/s3.py,sha256=xMT48kbcelcjjqsaU567WI3oZ5eqo88Rlgyx5ECszAU,4074
 anemoi/utils/sanitise.py,sha256=ZYGdSX6qihQANr3pHZjbKnoapnzP1KcrWdW1Ul1mOGk,3668
 anemoi/utils/sanitize.py,sha256=43ZKDcfVpeXSsJ9TFEc9aZnD6oe2cUh151XnDspM98M,462
@@ -30,9 +31,9 @@ anemoi/utils/mars/requests.py,sha256=VFMHBVAAl0_2lOcMBa1lvaKHctN0lDJsI6_U4BucGew
 anemoi/utils/remote/__init__.py,sha256=swPWHQoh-B6Xq9R489tPw0FykMue7f-bJ8enneFYSYE,20776
 anemoi/utils/remote/s3.py,sha256=spQ8l0rwQjLZh9dZu5cOsYIvNwKihQfCJ6YsFYegeqI,17339
 anemoi/utils/remote/ssh.py,sha256=xNtsawh8okytCKRehkRCVExbHZj-CRUQNormEHglfuw,8088
-anemoi_utils-0.4.17.dist-info/licenses/LICENSE,sha256=8HznKF1Vi2IvfLsKNE5A2iVyiri3pRjRPvPC9kxs6qk,11354
-anemoi_utils-0.4.17.dist-info/METADATA,sha256=XkTQFxHQ9BRkUl77BycvPb3F6yPGxqS9x5w-aRQlLYc,15360
-anemoi_utils-0.4.17.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-anemoi_utils-0.4.17.dist-info/entry_points.txt,sha256=LENOkn88xzFQo-V59AKoA_F_cfYQTJYtrNTtf37YgHY,60
-anemoi_utils-0.4.17.dist-info/top_level.txt,sha256=DYn8VPs-fNwr7fNH9XIBqeXIwiYYd2E2k5-dUFFqUz0,7
-anemoi_utils-0.4.17.dist-info/RECORD,,
+anemoi_utils-0.4.18.dist-info/licenses/LICENSE,sha256=8HznKF1Vi2IvfLsKNE5A2iVyiri3pRjRPvPC9kxs6qk,11354
+anemoi_utils-0.4.18.dist-info/METADATA,sha256=JfNRSTBhVM7aDRWBmhpDWtrkCoTVT1fUwGYyWcR45BU,15360
+anemoi_utils-0.4.18.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+anemoi_utils-0.4.18.dist-info/entry_points.txt,sha256=LENOkn88xzFQo-V59AKoA_F_cfYQTJYtrNTtf37YgHY,60
+anemoi_utils-0.4.18.dist-info/top_level.txt,sha256=DYn8VPs-fNwr7fNH9XIBqeXIwiYYd2E2k5-dUFFqUz0,7
+anemoi_utils-0.4.18.dist-info/RECORD,,