pydpm_xl 0.2.8__tar.gz → 0.2.9__tar.gz

{pydpm_xl-0.2.8/pydpm_xl.egg-info → pydpm_xl-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydpm_xl
-Version: 0.2.8
+Version: 0.2.9
 Summary: Python library for DPM-XL data processing and analysis
 Author-email: "MeaningfulData S.L." <info@meaningfuldata.eu>
 License: GPL-3.0-or-later
@@ -210,22 +210,21 @@ else:
     print(f"Error: {result.error}")
 ```
 
-#### Complete AST Generation
+#### Validations Script Generation
 
 ```python
-from py_dpm.api import generate_complete_ast, generate_enriched_ast
+from py_dpm.api import generate_validations_script
 
-# Generate complete AST with data fields
-result = generate_complete_ast("{tT_01.00, r0010, c0010}", release_id=123)
-if result.success:
-    print(f"AST: {result.ast}")
-    print(f"Data fields: {result.data_fields}")
+# Generate engine-ready validations script
+result = generate_validations_script(
+    "{tT_01.00, r0010, c0010}",
+    database_path="data.db",
+    release_code="4.2"
+)
+if result["success"]:
+    print(f"Enriched AST: {result['enriched_ast']}")
 else:
-    print(f"Errors: {result.errors}")
-
-# Generate enriched AST (ready for execution engine)
-enriched = generate_enriched_ast("{tT_01.00, r0010, c0010}", release_id=123)
-print(f"Enriched AST: {enriched}")
+    print(f"Error: {result['error']}")
 ```
 
 #### Migration

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/README.md

@@ -177,22 +177,21 @@ else:
     print(f"Error: {result.error}")
 ```
 
-#### Complete AST Generation
+#### Validations Script Generation
 
 ```python
-from py_dpm.api import generate_complete_ast, generate_enriched_ast
+from py_dpm.api import generate_validations_script
 
-# Generate complete AST with data fields
-result = generate_complete_ast("{tT_01.00, r0010, c0010}", release_id=123)
-if result.success:
-    print(f"AST: {result.ast}")
-    print(f"Data fields: {result.data_fields}")
+# Generate engine-ready validations script
+result = generate_validations_script(
+    "{tT_01.00, r0010, c0010}",
+    database_path="data.db",
+    release_code="4.2"
+)
+if result["success"]:
+    print(f"Enriched AST: {result['enriched_ast']}")
 else:
-    print(f"Errors: {result.errors}")
-
-# Generate enriched AST (ready for execution engine)
-enriched = generate_enriched_ast("{tT_01.00, r0010, c0010}", release_id=123)
-print(f"Enriched AST: {enriched}")
+    print(f"Error: {result['error']}")
 ```
 
 #### Migration

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/py_dpm/__init__.py

@@ -41,7 +41,7 @@ Available packages:
 - pydpm.api: Main APIs for migration, syntax, and semantic analysis
 """
 
-__version__ = "0.2.8"
+__version__ = "0.2.9"
 __author__ = "MeaningfulData S.L."
 __email__ = "info@meaningfuldata.eu"
 __license__ = "GPL-3.0-or-later"

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/py_dpm/api/__init__.py

@@ -11,10 +11,7 @@ from py_dpm.api.dpm_xl import (
     SemanticAPI,
     ASTGeneratorAPI,
     OperationScopesAPI,
-    generate_complete_ast,
-    generate_enriched_ast,
-    enrich_ast_with_metadata,
-    parse_with_data_fields,
+    generate_validations_script,
 )
 
 # Import from general DPM API
@@ -40,9 +37,6 @@ __all__ = [
     "SemanticAPI",
     "ASTGeneratorAPI",
     "OperationScopesAPI",
-    # Complete AST functions (backwards compatibility)
-    "generate_complete_ast",
-    "generate_enriched_ast",
-    "enrich_ast_with_metadata",
-    "parse_with_data_fields",
+    # Standalone function
+    "generate_validations_script",
 ]

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/py_dpm/api/dpm_xl/__init__.py

@@ -9,13 +9,7 @@ from py_dpm.api.dpm_xl.semantic import SemanticAPI
 from py_dpm.api.dpm_xl.ast_generator import ASTGeneratorAPI
 from py_dpm.api.dpm_xl.operation_scopes import OperationScopesAPI
 
-# Backwards-compatible standalone functions (delegate to ASTGeneratorAPI)
-from py_dpm.api.dpm_xl.complete_ast import (
-    generate_complete_ast,
-    generate_enriched_ast,
-    enrich_ast_with_metadata,
-    parse_with_data_fields,
-)
+from py_dpm.api.dpm_xl.complete_ast import generate_validations_script
 
 __all__ = [
     # Class-based APIs
@@ -23,9 +17,6 @@ __all__ = [
     "SemanticAPI",
     "ASTGeneratorAPI",
     "OperationScopesAPI",
-    # Standalone functions (backwards compatibility)
-    "generate_complete_ast",
-    "generate_enriched_ast",
-    "enrich_ast_with_metadata",
-    "parse_with_data_fields",
+    # Standalone function
+    "generate_validations_script",
 ]

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/py_dpm/api/dpm_xl/ast_generator.py

@@ -32,7 +32,7 @@ class ASTGeneratorAPI:
        - Returns: AST with data fields populated (datapoint IDs, operand references)
        - Use for: AST analysis with complete metadata, matching json_scripts/*.json format
 
-    3. **Enriched AST** (generate_enriched_ast):
+    3. **Validations Script** (generate_validations_script):
        - Requires database connection
        - Extends complete AST with framework structure for execution engines
        - Returns: Engine-ready AST with operations, variables, tables, preconditions sections
@@ -90,7 +90,7 @@ class ASTGeneratorAPI:
 
         **What you DON'T get:**
         - Data fields (datapoint IDs, operand references) - use generate_complete_ast()
-        - Framework structure - use generate_enriched_ast()
+        - Framework structure - use generate_validations_script()
 
         Args:
             expression: DPM-XL expression string
@@ -347,7 +347,7 @@ class ASTGeneratorAPI:
             return [(expressions, "default_code", None)]
         return expressions
 
-    def generate_enriched_ast(
+    def generate_validations_script(
         self,
         expressions: Union[str, List[Tuple[str, str, Optional[str]]]],
         release_code: Optional[str] = None,
@@ -360,9 +360,9 @@ class ASTGeneratorAPI:
         module_version_number: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
-        Generate enriched, engine-ready AST with framework structure (Level 3).
+        Generate validations script with engine-ready AST and framework structure.
 
-        This extends generate_complete_ast() by wrapping the complete AST in an engine-ready
+        This method generates the complete validations script by wrapping ASTs in an engine-ready
         framework structure with operations, variables, tables, and preconditions sections.
         This is the format required by business rule execution engines.
 
@@ -370,7 +370,7 @@ class ASTGeneratorAPI:
         expression/operation/precondition tuples for generating scripts with multiple operations.
 
         **What you get:**
-        - Everything from generate_complete_ast() PLUS:
+        - Complete AST with data fields PLUS:
         - Framework structure: operations, variables, tables, preconditions
         - Module metadata: version, release info, dates
         - Dependency information (including cross-module dependencies)
@@ -428,14 +428,14 @@ class ASTGeneratorAPI:
 
         Example:
             >>> generator = ASTGeneratorAPI(database_path="data.db")
-            >>> # Single expression (backward compatible)
-            >>> result = generator.generate_enriched_ast(
+            >>> # Single expression
+            >>> result = generator.generate_validations_script(
             ...     "{tF_01.00, r0010, c0010}",
             ...     release_code="4.2",
             ... )
             >>>
             >>> # Multiple expressions with operations and preconditions
-            >>> result = generator.generate_enriched_ast(
+            >>> result = generator.generate_validations_script(
             ...     [
             ...         ("{tF_01.00, r0010, c0010} = 0", "v1234_m", None),
             ...         ("{tF_01.00, r0020, c0010} > 0", "v1235_m", "{v_F_44_04}"),

pydpm_xl-0.2.9/py_dpm/api/dpm_xl/complete_ast.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""
+Validations Script API - Generate engine-ready ASTs for validation frameworks.
+
+This module provides a standalone function that delegates to ASTGeneratorAPI.
+
+For direct class usage:
+    from py_dpm.api.dpm_xl import ASTGeneratorAPI
+
+    generator = ASTGeneratorAPI(database_path="data.db")
+    result = generator.generate_validations_script(expressions)
+"""
+
+from typing import Dict, Any, Optional, List, Union, Tuple
+from py_dpm.api.dpm_xl.ast_generator import ASTGeneratorAPI
+
+
+def generate_validations_script(
+    expressions: Union[str, List[Tuple[str, str, Optional[str]]]],
+    database_path: Optional[str] = None,
+    connection_url: Optional[str] = None,
+    release_code: Optional[str] = None,
+    table_context: Optional[Dict[str, Any]] = None,
+    release_id: Optional[int] = None,
+    primary_module_vid: Optional[int] = None,
+    module_code: Optional[str] = None,
+    preferred_module_dependencies: Optional[List[str]] = None,
+) -> Dict[str, Any]:
+    """
+    Generate validations script with engine-ready AST from DPM-XL expression(s).
+
+    This function delegates to ASTGeneratorAPI.generate_validations_script().
+
+    Supports both single expressions and multiple expression/operation/precondition
+    tuples for generating scripts with multiple operations.
+
+    Args:
+        expressions: Either a single DPM-XL expression string,
+            or a list of tuples: [(expression, operation_code, precondition), ...].
+            Each tuple contains:
+            - expression (str): The DPM-XL expression (required)
+            - operation_code (str): The operation code (required)
+            - precondition (Optional[str]): Optional precondition reference (e.g., {v_F_44_04})
+        database_path: Path to SQLite database (or None for PostgreSQL)
+        connection_url: PostgreSQL connection URL (takes precedence over database_path)
+        release_code: DPM release code (e.g., "4.0", "4.1", "4.2")
+        table_context: Optional table context dict with keys: 'table', 'columns', 'rows', 'sheets', 'default', 'interval'
+        release_id: Optional release ID to filter database lookups by specific release.
+            If None, uses all available data (release-agnostic).
+        primary_module_vid: Optional module version ID of the module being exported.
+            When provided, enables detection of cross-module dependencies.
+        module_code: Optional module code (e.g., "FINREP9") to specify the main module.
+        preferred_module_dependencies: Optional list of module codes to prefer when
+            multiple dependency scopes are possible.
+
+    Returns:
+        dict: {
+            'success': bool,
+            'enriched_ast': dict,  # Engine-ready AST with framework structure
+            'error': str           # Error message if failed
+        }
+
+    Example:
+        >>> # Single expression
+        >>> result = generate_validations_script(
+        ...     "{tF_01.00, r0010, c0010}",
+        ...     database_path="data.db",
+        ...     release_code="4.2",
+        ... )
+        >>>
+        >>> # Multiple expressions
+        >>> result = generate_validations_script(
+        ...     [
+        ...         ("{tF_01.00, r0010, c0010} = 0", "v1234_m", None),
+        ...         ("{tF_01.00, r0020, c0010} > 0", "v1235_m", "{v_F_44_04}"),
+        ...     ],
+        ...     database_path="data.db",
+        ...     release_code="4.2",
+        ...     module_code="FINREP9",
+        ... )
+    """
+    generator = ASTGeneratorAPI(
+        database_path=database_path,
+        connection_url=connection_url,
+        enable_semantic_validation=True
+    )
+    return generator.generate_validations_script(
+        expressions=expressions,
+        release_code=release_code,
+        table_context=table_context,
+        release_id=release_id,
+        primary_module_vid=primary_module_vid,
+        module_code=module_code,
+        preferred_module_dependencies=preferred_module_dependencies,
+    )

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/py_dpm/dpm_xl/utils/serialization.py

@@ -452,6 +452,21 @@ class ASTToJSONVisitor(NodeVisitor):
             'shift_number': node.shift_number
         }
 
+    def visit_RenameOp(self, node):
+        """Visit RenameOp nodes and serialize as RenameClauseOp."""
+        return {
+            'class_name': 'RenameClauseOp',
+            'operand': self.visit(node.operand),
+            'clauses': [self._serialize_rename_node(rn) for rn in node.rename_nodes]
+        }
+
+    def _serialize_rename_node(self, node):
+        """Serialize a RenameNode as a clause dictionary."""
+        return {
+            'from_component': node.old_name,
+            'to_component': node.new_name
+        }
+
     def visit_PreconditionItem(self, node):
         """Visit PreconditionItem nodes."""
         result = {

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9/pydpm_xl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydpm_xl
-Version: 0.2.8
+Version: 0.2.9
 Summary: Python library for DPM-XL data processing and analysis
 Author-email: "MeaningfulData S.L." <info@meaningfuldata.eu>
 License: GPL-3.0-or-later
@@ -210,22 +210,21 @@ else:
     print(f"Error: {result.error}")
 ```
 
-#### Complete AST Generation
+#### Validations Script Generation
 
 ```python
-from py_dpm.api import generate_complete_ast, generate_enriched_ast
+from py_dpm.api import generate_validations_script
 
-# Generate complete AST with data fields
-result = generate_complete_ast("{tT_01.00, r0010, c0010}", release_id=123)
-if result.success:
-    print(f"AST: {result.ast}")
-    print(f"Data fields: {result.data_fields}")
+# Generate engine-ready validations script
+result = generate_validations_script(
+    "{tT_01.00, r0010, c0010}",
+    database_path="data.db",
+    release_code="4.2"
+)
+if result["success"]:
+    print(f"Enriched AST: {result['enriched_ast']}")
 else:
-    print(f"Errors: {result.errors}")
-
-# Generate enriched AST (ready for execution engine)
-enriched = generate_enriched_ast("{tT_01.00, r0010, c0010}", release_id=123)
-print(f"Enriched AST: {enriched}")
+    print(f"Error: {result['error']}")
 ```
 
 #### Migration

{pydpm_xl-0.2.8 → pydpm_xl-0.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pydpm_xl"
-version = "0.2.8"
+version = "0.2.9"
 description = "Python library for DPM-XL data processing and analysis"
 authors = [
     {name = "MeaningfulData S.L.", email = "info@meaningfuldata.eu"}
@@ -52,7 +52,7 @@ exclude = []
 
 [tool.poetry]
 name = "pydpm_xl"
-version = "0.2.8"
+version = "0.2.9"
 description = "Python library for DPM-XL data processing and analysis"
 authors = ["MeaningfulData S.L. <info@meaningfuldata.eu>"]
 readme = "README.md"

pydpm_xl-0.2.8/py_dpm/api/dpm_xl/complete_ast.py

@@ -1,208 +0,0 @@
-#!/usr/bin/env python3
-"""
-Complete AST API - Generate ASTs exactly like the JSON examples
-
-This module provides backwards-compatible standalone functions that delegate to ASTGeneratorAPI.
-All AST-related functionality is now consolidated in the ASTGeneratorAPI class.
-
-For new code, prefer using ASTGeneratorAPI directly:
-    from py_dpm.api.dpm_xl import ASTGeneratorAPI
-
-    generator = ASTGeneratorAPI(database_path="data.db")
-    result = generator.generate_complete_ast(expression)
-"""
-
-from typing import Dict, Any, Optional, List, Union, Tuple
-from py_dpm.api.dpm_xl.ast_generator import ASTGeneratorAPI
-
-
-def generate_complete_ast(
-    expression: str,
-    database_path: str = None,
-    connection_url: str = None,
-    release_id: Optional[int] = None,
-):
-    """
-    Generate complete AST with all data fields, exactly like json_scripts examples.
-
-    This function delegates to ASTGeneratorAPI for backwards compatibility.
-
-    Args:
-        expression: DPM-XL expression string
-        database_path: Path to SQLite database file (e.g., "./database.db")
-        connection_url: SQLAlchemy connection URL for PostgreSQL (optional)
-        release_id: Optional release ID to filter database lookups by specific release.
-            If None, uses all available data (release-agnostic).
-
-    Returns:
-        dict with keys:
-            success, ast, context, error, data_populated, semantic_result
-    """
-    generator = ASTGeneratorAPI(
-        database_path=database_path,
-        connection_url=connection_url,
-        enable_semantic_validation=True
-    )
-    return generator.generate_complete_ast(expression, release_id=release_id)
-
-
-# Convenience function with cleaner interface
-def parse_with_data_fields(
-    expression: str,
-    database_path: str = None,
-    connection_url: str = None,
-    release_id: Optional[int] = None,
-):
-    """
-    Simple function to parse expression and get AST with data fields.
-
-    This function delegates to ASTGeneratorAPI for backwards compatibility.
-
-    Args:
-        expression: DPM-XL expression string
-        database_path: Path to SQLite database file
-        connection_url: SQLAlchemy connection URL for PostgreSQL (optional)
-        release_id: Optional release ID to filter database lookups by specific release.
-            If None, uses all available data (release-agnostic).
-
-    Returns:
-        dict: AST dictionary with data fields, or None if failed
-    """
-    result = generate_complete_ast(
-        expression, database_path, connection_url, release_id=release_id
-    )
-    return result["ast"] if result["success"] else None
-
-
-# ============================================================================
-# AST Enrichment Functions - Create engine-ready ASTs
-# ============================================================================
-
-
-def generate_enriched_ast(
-    expressions: Union[str, List[Tuple[str, str, Optional[str]]]],
-    database_path: Optional[str] = None,
-    connection_url: Optional[str] = None,
-    release_code: Optional[str] = None,
-    table_context: Optional[Dict[str, Any]] = None,
-    release_id: Optional[int] = None,
-    primary_module_vid: Optional[int] = None,
-    module_code: Optional[str] = None,
-    preferred_module_dependencies: Optional[List[str]] = None,
-) -> Dict[str, Any]:
-    """
-    Generate enriched, engine-ready AST from DPM-XL expression(s).
-
-    This function delegates to ASTGeneratorAPI for backwards compatibility.
-
-    Supports both single expressions (for backward compatibility) and multiple
-    expression/operation/precondition tuples for generating scripts with multiple operations.
-
-    Args:
-        expressions: Either a single DPM-XL expression string (backward compatible),
-            or a list of tuples: [(expression, operation_code, precondition), ...].
-            Each tuple contains:
-            - expression (str): The DPM-XL expression (required)
-            - operation_code (str): The operation code (required)
-            - precondition (Optional[str]): Optional precondition reference (e.g., {v_F_44_04})
-        database_path: Path to SQLite database (or None for PostgreSQL)
-        connection_url: PostgreSQL connection URL (takes precedence over database_path)
-        release_code: DPM release code (e.g., "4.0", "4.1", "4.2")
-        table_context: Optional table context dict with keys: 'table', 'columns', 'rows', 'sheets', 'default', 'interval'
-        release_id: Optional release ID to filter database lookups by specific release.
-            If None, uses all available data (release-agnostic).
-        primary_module_vid: Optional module version ID of the module being exported.
-            When provided, enables detection of cross-module dependencies.
-        module_code: Optional module code (e.g., "FINREP9") to specify the main module.
-        preferred_module_dependencies: Optional list of module codes to prefer when
-            multiple dependency scopes are possible.
-
-    Returns:
-        dict: {
-            'success': bool,
-            'enriched_ast': dict,  # Engine-ready AST with framework structure
-            'error': str           # Error message if failed
-        }
-
-    Example:
-        >>> # Single expression (backward compatible)
-        >>> result = generate_enriched_ast(
-        ...     "{tF_01.00, r0010, c0010}",
-        ...     database_path="data.db",
-        ...     release_code="4.2",
-        ... )
-        >>>
-        >>> # Multiple expressions
-        >>> result = generate_enriched_ast(
-        ...     [
-        ...         ("{tF_01.00, r0010, c0010} = 0", "v1234_m", None),
-        ...         ("{tF_01.00, r0020, c0010} > 0", "v1235_m", "{v_F_44_04}"),
-        ...     ],
-        ...     database_path="data.db",
-        ...     release_code="4.2",
-        ...     module_code="FINREP9",
-        ... )
-    """
-    generator = ASTGeneratorAPI(
-        database_path=database_path,
-        connection_url=connection_url,
-        enable_semantic_validation=True
-    )
-    return generator.generate_enriched_ast(
-        expressions=expressions,
-        release_code=release_code,
-        table_context=table_context,
-        release_id=release_id,
-        primary_module_vid=primary_module_vid,
-        module_code=module_code,
-        preferred_module_dependencies=preferred_module_dependencies,
-    )
-
-
-def enrich_ast_with_metadata(
-    ast_dict: Dict[str, Any],
-    expression: str,
-    context: Optional[Dict[str, Any]],
-    database_path: Optional[str] = None,
-    connection_url: Optional[str] = None,
-    release_code: Optional[str] = None,
-    operation_code: Optional[str] = None,
-    precondition: Optional[str] = None,
-    release_id: Optional[int] = None,
-    primary_module_vid: Optional[int] = None,
-) -> Dict[str, Any]:
-    """
-    Add framework structure (operations, variables, tables, preconditions) to complete AST.
-
-    This function delegates to ASTGeneratorAPI for backwards compatibility.
-
-    Args:
-        ast_dict: Complete AST dictionary (from generate_complete_ast)
-        expression: Original DPM-XL expression
-        context: Context dict with table, rows, columns, sheets, default, interval
-        database_path: Path to SQLite database
-        connection_url: PostgreSQL connection URL (takes precedence)
-        release_code: DPM release code (e.g., "4.2")
-        operation_code: Operation code (defaults to "default_code")
-        precondition: Precondition variable reference (e.g., {v_F_44_04})
-        release_id: Optional release ID to filter database lookups
-        primary_module_vid: Optional module VID of the module being exported
-
-    Returns:
-        dict: Engine-ready AST with framework structure
-    """
-    generator = ASTGeneratorAPI(
-        database_path=database_path,
-        connection_url=connection_url,
-        enable_semantic_validation=True
-    )
-    return generator._enrich_ast_with_metadata(
-        ast_dict=ast_dict,
-        expression=expression,
-        context=context,
-        release_code=release_code,
-        operation_code=operation_code,
-        precondition=precondition,
-        release_id=release_id,
-        primary_module_vid=primary_module_vid,
-    )