Merge pull request #15 from ndsev/release/0.7.0

Release 0.7.0

Author: MisterGC

README.md

@@ -222,8 +222,9 @@ zs-yaml comes with several built-in transformation functions that can be used in
 - `insert_yaml`: Inserts YAML content directly from an external file.
 - `repeat_node`: Repeats a specific node a specified number of times.
 - `extract_extern_as_yaml`: Extracts binary data and saves it as an external YAML file.
+- `py_eval`: Allows to write small snippets like `myArray: {_f: py_eval, _a: "list(range(1, 100))"}` to generate the value for a yaml node.
 
-For more detailed information about these functions and their usage, please refer to the [built_in_transformations.py](https://github.com/ndsev/zs_yaml/blob/main/zs_yaml/built_in_transformations.py) source file.
+For more detailed information about these functions and their usage, please refer to the [built_in_transformations.py](https://github.com/ndsev/zs-yaml/blob/main/zs_yaml/built_in_transformations.py) source file.
 
 Note: We plan to implement automatic source documentation generation in a future release, which will provide more comprehensive information about these functions and their parameters.
 

zs_yaml/_version.py

@@ -1,2 +1,2 @@
 __commit_id__ = '7217bfe'
-__version__ = '0.6.1'
+__version__ = '0.7.0'

zs_yaml/built_in_transformations.py

@@ -230,3 +230,39 @@ def rm_nulls(data):
             'file': file_name
         }
     }
+
+def py_eval(transformer, expr):
+    """
+    Safely evaluate a Python expression and return its result.
+
+    Args:
+        transformer (YamlTransformer): The transformer instance.
+        expr (str): The Python expression to evaluate.
+
+    Returns:
+        The result of the evaluated expression.
+
+    Example YAML usage:
+        my_array:
+          _f: py_eval
+          _a:
+            expr: "[i * 2 for i in range(5)]"
+    """
+    # Create a safe globals dict with limited builtins
+    safe_globals = {
+        'range': range,
+        'len': len,
+        'str': str,
+        'int': int,
+        'float': float,
+        'list': list,
+        'dict': dict,
+        'set': set,
+        'tuple': tuple,
+        'bool': bool,
+    }
+
+    try:
+        return eval(expr, safe_globals, {})
+    except Exception as e:
+        raise ValueError(f"Error evaluating Python expression: {str(e)}")