pydpm_xl 0.2.5rc2__py3-none-any.whl → 0.2.6__py3-none-any.whl

py_dpm/__init__.py

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

py_dpm/api/__init__.py

@@ -12,7 +12,6 @@ from py_dpm.api.dpm_xl import (
     ASTGeneratorAPI,
     OperationScopesAPI,
     generate_complete_ast,
-    generate_complete_batch,
     generate_enriched_ast,
     enrich_ast_with_metadata,
     parse_with_data_fields,
@@ -43,7 +42,6 @@ __all__ = [
     "OperationScopesAPI",
     # Complete AST functions (backwards compatibility)
     "generate_complete_ast",
-    "generate_complete_batch",
     "generate_enriched_ast",
     "enrich_ast_with_metadata",
     "parse_with_data_fields",

py_dpm/api/dpm/data_dictionary.py

@@ -461,6 +461,7 @@ class DataDictionaryAPI:
                 TableVersion.code.label("table_version_code"),
                 ItemCategory.code.label("property_code"),
                 DataType.name.label("data_type_name"),
+                DataType.code.label("data_type_code"),
             )
             .select_from(DataType)
             .join(Property, DataType.datatypeid == Property.datatypeid)
@@ -498,6 +499,7 @@ class DataDictionaryAPI:
                 "table_version_code": r.table_version_code,
                 "property_code": r.property_code,
                 "data_type_name": r.data_type_name,
+                "data_type_code": r.data_type_code,
             }
             for r in results
         ]

py_dpm/api/dpm/explorer.py

@@ -213,6 +213,7 @@ class ExplorerQueryAPI:
         row_code: Optional[str] = None,
         column_code: Optional[str] = None,
         sheet_code: Optional[str] = None,
+        module_code: Optional[str] = None,
         release_id: Optional[int] = None,
         release_code: Optional[str] = None,
         date: Optional[str] = None,
@@ -220,7 +221,7 @@ class ExplorerQueryAPI:
         """
         Resolve variable information from a cell address (table/row/column/sheet).
 
-        Row, column and sheet codes are optional and are only used when
+        Row, column, sheet and module codes are optional and are only used when
         provided. Release parameters follow the standard semantics; if none
         are given, only active module versions are considered.
         """
@@ -230,7 +231,80 @@ class ExplorerQueryAPI:
             row_code=row_code,
             column_code=column_code,
             sheet_code=sheet_code,
+            module_code=module_code,
             release_id=release_id,
             release_code=release_code,
             date=date,
         )
+
+    def get_variable_by_code(
+        self,
+        variable_code: str,
+        release_id: Optional[int] = None,
+        release_code: Optional[str] = None,
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Get variable_id and variable_vid for a given variable code.
+
+        This is useful for resolving precondition variable references like {v_C_01.00}
+        where the variable code corresponds to a table's filing indicator variable.
+
+        Args:
+            variable_code: The variable code to look up (e.g., "C_01.00")
+            release_id: Optional release ID to filter by (mutually exclusive with release_code)
+            release_code: Optional release code to filter by (mutually exclusive with release_id)
+
+        Returns:
+            Dict with variable_id, variable_vid, variable_code, variable_name if found,
+            None otherwise.
+
+        Example:
+            >>> api = ExplorerQueryAPI()
+            >>> result = api.get_variable_by_code("C_01.00", release_code="4.2")
+            >>> print(result)
+            {'variable_id': 2201, 'variable_vid': 2201, 'variable_code': 'C_01.00', 'variable_name': '...'}
+        """
+        return ExplorerQuery.get_variable_by_code(
+            self.api.session,
+            variable_code=variable_code,
+            release_id=release_id,
+            release_code=release_code,
+        )
+
+    def get_variables_by_codes(
+        self,
+        variable_codes: List[str],
+        release_id: Optional[int] = None,
+        release_code: Optional[str] = None,
+    ) -> Dict[str, Dict[str, Any]]:
+        """
+        Batch lookup of variable_id and variable_vid for multiple variable codes.
+
+        This is more efficient than calling get_variable_by_code multiple times
+        when resolving multiple precondition variables, as it performs a single
+        database query.
+
+        Args:
+            variable_codes: List of variable codes to look up
+            release_id: Optional release ID to filter by (mutually exclusive with release_code)
+            release_code: Optional release code to filter by (mutually exclusive with release_id)
+
+        Returns:
+            Dict mapping variable_code to {variable_id, variable_vid, variable_code, variable_name}.
+            Only includes codes that were found in the database.
+
+        Example:
+            >>> api = ExplorerQueryAPI()
+            >>> result = api.get_variables_by_codes(["C_01.00", "C_47.00"], release_code="4.2")
+            >>> print(result)
+            {
+                'C_01.00': {'variable_id': 2201, 'variable_vid': 2201, ...},
+                'C_47.00': {'variable_id': 1935, 'variable_vid': 1935, ...}
+            }
+        """
+        return ExplorerQuery.get_variables_by_codes(
+            self.api.session,
+            variable_codes=variable_codes,
+            release_id=release_id,
+            release_code=release_code,
+        )

py_dpm/api/dpm_xl/__init__.py

@@ -12,7 +12,6 @@ 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_complete_batch,
     generate_enriched_ast,
     enrich_ast_with_metadata,
     parse_with_data_fields,
@@ -26,7 +25,6 @@ __all__ = [
     "OperationScopesAPI",
     # Standalone functions (backwards compatibility)
     "generate_complete_ast",
-    "generate_complete_batch",
     "generate_enriched_ast",
     "enrich_ast_with_metadata",
     "parse_with_data_fields",