# Copyright (C) 2023-2026 Sebastien Rousseau.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""
This module contains the function `create_xml_v8`, which constructs an XML tree
following the ISO 20022 pain.001.001.08 schema.
The function takes in a root ElementTree element and a list of dictionaries
containing the required data. It then uses Jinja2 templating to dynamically
generate the XML content based on the given data. The function ultimately
returns the root element of the modified XML tree.
"""
# pylint: disable=duplicate-code
# Import ElementTree and Jinja2
import xml.etree.ElementTree as et # nosec B405
from pathlib import Path
from typing import Any
import defusedxml.ElementTree as defused_et
from jinja2 import Environment, FileSystemLoader
from pain001.security.path_validator import validate_path
[docs]
def create_xml_v8(root: et.Element, data: list[dict[str, Any]]) -> et.Element:
"""Create XML tree for pain.001.001.08 schema.
Args:
root (ElementTree.Element): Root element of XML tree.
data (list): List of dicts with data.
Returns:
ElementTree.Element: Root element of updated XML tree.
"""
# Create CstmrCdtTrfInitn element
# pylint: disable=E1101
cstmr_cdt_trf_initn_element = et.Element("CstmrCdtTrfInitn")
root.append(cstmr_cdt_trf_initn_element)
# Create a Jinja2 environment with package-relative path
template_dir = Path(__file__).parent.parent / "templates"
validate_path(template_dir, must_exist=True)
env = Environment(
loader=FileSystemLoader(str(template_dir)), autoescape=True
)
# Load pain.001.001.08 template
template = env.get_template("pain.001.001.08/template.xml")
# Prepare data for rendering
xml_data = {
"id": data[0]["id"],
"date": data[0]["date"],
"nb_of_txs": data[0]["nb_of_txs"],
"ctrl_sum": data[0]["ctrl_sum"],
"initiator_name": data[0]["initiator_name"],
"initiator_street_name": data[0]["initiator_street_name"],
"initiator_building_number": data[0]["initiator_building_number"],
"initiator_postal_code": data[0]["initiator_postal_code"],
"initiator_town": data[0]["initiator_town_name"],
"initiator_country": data[0]["initiator_country"],
"payment_information_id": data[0]["payment_information_id"],
"payment_method": data[0]["payment_method"],
"batch_booking": data[0]["batch_booking"],
"requested_execution_date": data[0]["requested_execution_date"],
"debtor_name": data[0]["debtor_name"],
"debtor_street": data[0]["debtor_street_name"],
"debtor_building_number": data[0]["debtor_building_number"],
"debtor_postal_code": data[0]["debtor_postal_code"],
"debtor_town": data[0]["debtor_town_name"],
"debtor_country": data[0]["debtor_country"],
"debtor_account_IBAN": data[0]["debtor_account_IBAN"],
"debtor_agent_BIC": data[0]["debtor_agent_BIC"],
"payment_instruction_id": data[0]["payment_instruction_id"],
"payment_end_to_end_id": data[0]["payment_end_to_end_id"],
"payment_currency": data[0]["payment_currency"],
"payment_amount": data[0]["payment_amount"],
"charge_bearer": data[0]["charge_bearer"],
"creditor_name": data[0]["creditor_name"],
"creditor_street": data[0]["creditor_street_name"],
"creditor_building_number": data[0]["creditor_building_number"],
"creditor_postal_code": data[0]["creditor_postal_code"],
"creditor_town": data[0]["creditor_town_name"],
"creditor_country": data[0]["creditor_country"],
"creditor_account_IBAN": data[0]["creditor_account_IBAN"],
"creditor_agent_BICFI": data[0]["creditor_agent_BICFI"],
"purpose_code": data[0]["purpose_code"],
"reference_number": data[0]["reference_number"],
"reference_date": data[0]["reference_date"],
}
# Render template
xml_content = template.render(**xml_data)
# Parse rendered content
rendered_xml = defused_et.fromstring(xml_content)
for child in rendered_xml:
cstmr_cdt_trf_initn_element.append(child)
return root