Support MIG+AHB Elements between `<Uebertragsgungsdatei>` and `<M_FORMAT>` (UNA, UNB)

[hf-kklein]

Beispiel MSCONS AHB:
Wir verlieren aktuuell die Infos zwischen dem geöffneten <Uebertragungsdatei>-Tag und dem <M_MSCONS>

<?xml version="1.0" encoding="UTF-8" ?>
<AHB Versionsnummer="3.1f" Veroeffentlichungsdatum="20.03.2025" Author="BDEW">
  <AWF
    Pruefidentifikator="13007"
    Beschreibung="Gasbeschaffenheit"
    Kommunikation_von=""
  >
    <Uebertragungsdatei>
      <S_UNB Name="Nutzdaten-Kopfsegment" Number="00002" AHB_Status="Muss">
        <C_S001 Name="Syntax-Bezeichner">
          <D_0001 Name="Syntax-Kennung">
            <Code
              Name="UN/ECE-Zeichensatz C"
              Description=""
              AHB_Status="X"
            >UNOC</Code>
          </D_0001>
          <D_0002 Name="Syntax-Versionsnummer">
            <Code Name="Version 3" Description="" AHB_Status="X">3</Code>
          </D_0002>
        </C_S001>
       <!-- ... --> 
      </S_UNB>
      <M_MSCONS> <!-- ab hier sind wir wieder ok -->
        <S_UNH Name="Nachrichtenkopfsegment" Number="00003" AHB_Status="Muss">
         <!-- ... --> 

[hf-kklein]

ws. ist das weniger pain zu bearbeiten, wenn man zuerst (natürlich in einem eigenen PR) #62 erledigt.

[hf-kklein]

Ansatzpunkte:

• Switch to snapshot tests (syrupi) instead of dumping the entire (pydantic) dataclass objects in .py files and comparing with them #62 fixen
• lies die offizielle doku: https://bdew-mako.de/Transferdokument_20241120.pdf
• Die Testdaten so adaptieren, dass sie an der relevanten Stelle etwas zu finden ist (orientier dich an unserem PRIVATEN repo, dort sind entsprechende Beispieldateien, die wir aber nicht öffentlich hier einchecken dürfen - das ist wichtig: Wir dürfen keine urheberrechtlich geschützten dateien hier in git adden! sondern adaptieren nur beispiel-dateien entsprechend, die schonmal öffentlich waren/sind):
  

  xml-fundamend-python/unittests/example_files/UTILTS_MIG_1.1d_Konsultationsfassung_2024_04_02_with_Uebertragungsdatei.xml

  Lines 8 to 11 in 7cb2adb

  	<!--
  	todo: there might be S_UNA and S_UNB around here
  	https://github.com/Hochfrequenz/xml-fundamend-python/issues/57
  	-->

• Python-Datenmodell anpassen, sodass die Ebene der Übertragunsdatei dort auch abgebildet ist
• Die relevanten Stellen anfassen (leicht zu finden, wenn man die Verwendungen der Funktion _is_uebertragungsdatei sucht, z.B.

xml-fundamend-python/src/fundamend/reader/migreader.py

Lines 185 to 189 in 72f4cc1

	if _is_uebertragungsdatei(root):
	for elem in root.iter():
	if elem.tag.startswith("M_"):
	root = elem
	break

• Analog zu den vorhandenen Funktionen
  

  xml-fundamend-python/src/fundamend/reader/migreader.py

  Lines 28 to 118 in 72f4cc1

  	def _to_code(element: ET.Element) -> Code:
  	assert _is_code(element)
  	return Code(name=element.attrib["Name"], description=element.attrib["Description"] or None, value=element.text)
  	def _to_data_element(element: ET.Element) -> DataElement:
  	assert _is_data_element(element)
  	codes = []
  	for child in element:
  	if _is_code(child):
  	codes.append(_to_code(child))
  	else:
  	raise ValueError(f"unexpected element: {child.tag}")
  	return DataElement(
  	id=element.tag,
  	name=element.attrib["Name"],
  	description=element.attrib["Description"] or None,
  	status_std=MigStatus(element.attrib["Status_Std"]),
  	status_specification=MigStatus(element.attrib["Status_Specification"]),
  	format_std=element.attrib["Format_Std"],
  	format_specification=element.attrib["Format_Specification"],
  	codes=codes,
  	)
  	def _to_data_element_group(element: ET.Element) -> DataElementGroup:
  	assert _is_data_element_group(element)
  	data_elements = []
  	for child in element:
  	if _is_data_element(child):
  	data_elements.append(_to_data_element(child))
  	else:
  	raise ValueError(f"unexpected element: {child.tag}")
  	return DataElementGroup(
  	id=element.tag,
  	name=element.attrib["Name"],
  	description=element.attrib["Description"] or None,
  	status_std=MigStatus(element.attrib["Status_Std"]),
  	status_specification=MigStatus(element.attrib["Status_Specification"]),
  	data_elements=data_elements,
  	)
  	def _to_segment(element: ET.Element) -> Segment:
  	assert _is_segment(element)
  	data_elements: list[DataElement | DataElementGroup] = []
  	for child in element:
  	if _is_data_element_group(child):
  	data_elements.append(_to_data_element_group(child))
  	elif _is_data_element(child):
  	data_elements.append(_to_data_element(child))
  	else:
  	raise ValueError(f"unexpected element: {child.tag}")
  	return Segment(
  	id=element.tag.lstrip("S_"),
  	name=element.attrib["Name"],
  	description=element.attrib["Description"] or None,
  	counter=element.attrib["Counter"],
  	level=int(element.attrib["Level"]),
  	max_rep_std=int(element.attrib["MaxRep_Std"]),
  	max_rep_specification=int(element.attrib["MaxRep_Specification"]),
  	status_std=MigStatus(element.attrib["Status_Std"]),
  	status_specification=MigStatus(element.attrib["Status_Specification"]),
  	example=element.attrib["Example"] or None,
  	number=element.attrib["Number"],
  	data_elements=data_elements,
  	)
  	def _to_segment_group(element: ET.Element) -> SegmentGroup:
  	assert _is_segment_group(element)
  	segments_and_groups: list[SegmentGroup | Segment] = []
  	for child in element:
  	if _is_segment_group(child):
  	segments_and_groups.append(_to_segment_group(child))
  	elif _is_segment(child):
  	segments_and_groups.append(_to_segment(child))
  	else:
  	raise ValueError(f"unexpected element: {child.tag}")
  	return SegmentGroup(
  	id=element.tag.lstrip("G_SG"),
  	name=element.attrib["Name"],
  	status_std=MigStatus(element.attrib["Status_Std"]),
  	status_specification=MigStatus(element.attrib["Status_Specification"]),
  	counter=element.attrib["Counter"],
  	level=int(element.attrib["Level"]),
  	max_rep_std=int(element.attrib["MaxRep_Std"]),
  	max_rep_specification=int(element.attrib["MaxRep_Specification"]),
  	segments=[s for s in segments_and_groups if isinstance(s, Segment)],
  	segment_groups=[sg for sg in segments_and_groups if isinstance(sg, SegmentGroup)],
  	)

eine Funktion bauen, die ein etree.Element in eine repräsentation der Übertragungsdatei in Python-Objekten transformiert.

[hf-kklein]

Idee von @lord-haffi pydantic-xml das wäre aber ein fundamentaler Umbau. Würd ich im ersten Schritt nicht machen.

edit: verworfen weil die art und weise, wie die tags in den offiziellen XMLs gebaut sind, nicht leicht mit pydantic-xml vereinbar ist.

[hf-kklein]

@DeltaDaniel @lord-haffi es gibt schon einen draft-pr: #72, vllt könnt ihr darauf aufsetzen, oder ihr löst es anders.

[hf-kklein]

Fürs MIG sieht die Struktur so aus:

aber nicht zwingend: