enhance: improve ParsingError to include file name, line number, and content for detailed error messages

Author: nerdoc

pydifact/exceptions.py

@@ -17,7 +17,17 @@ class ValidationError(Exception):
 
 
 class ParsingError(Exception):
-    pass
+    def __init__(
+        self, message: str, file_name: str = "", line_number: int = 0, line: str = ""
+    ):
+        self.line_number = line_number
+        self.line = line
+        self.file_name = file_name
+        if not line and not line_number:
+            super().__init__(f"Parsing Error: {message}")
+        super().__init__(
+            f"Parsing Error in {file_name}:{line_number}: {message}\n'{line}'"
+        )
 
 
 # ---------------- Warnings ----------------

scripts/generator/pydifact_generator.py

@@ -726,6 +726,10 @@ def save_current_segment():
         """Helper to save the current segment."""
         if not segment.tag:
             return
+
+        # Save any pending top-level element first
+        save_toplevel_element()
+
         if segment.tag not in segment_specs:
             logger.warning(f"Could not fill segment {segment.tag} schema")
         else:
@@ -736,6 +740,7 @@ def save_toplevel_element():
         """Helper to save the current top-level element."""
         if state.last_toplevel_element:
             segment.schema.append(state.last_toplevel_element)
+            state.last_toplevel_element = None
             state.sub_elements = []
 
     while True:
@@ -753,7 +758,8 @@ def save_toplevel_element():
                 tag, title = title_match
 
                 # Save previous segment
-                save_current_segment()
+                if state.in_segment:
+                    save_current_segment()
 
                 # Stop if we only want one segment and found another
                 if state.in_segment and only_segment_tag:
@@ -800,7 +806,6 @@ def save_toplevel_element():
             break
 
     # Save last segment
-    save_toplevel_element()
     save_current_segment()