Source code for energy_data_retrieval.bess_catalogue.adb_iati
"""Stage ADB IATI battery activities without treating financing as physical assets."""
from __future__ import annotations
import re
import xml.etree.ElementTree as ET
from typing import Any
[docs]
def stage_adb_battery_activities(content: bytes) -> list[dict[str, Any]]:
"""Return source-native observations, excluding contacts and country centroids.
Activity status and dates describe financing implementation, not plant COD.
Separate loan/guarantee activities need manual physical-project reconciliation.
"""
if b"<!DOCTYPE" in content.upper() or b"<!ENTITY" in content.upper():
raise ValueError("DTD/entity declarations are not supported")
root = ET.fromstring(content)
if root.tag != "iati-activities" or root.get("version") != "2.03":
raise ValueError("Expected IATI 2.03 activities")
rows = []
seen = set()
for activity in root.findall("iati-activity"):
identifier = activity.findtext("iati-identifier", "").strip()
if not identifier.startswith("XM-DAC-46004-"):
raise ValueError("Expected ADB activity identifier")
if identifier in seen:
raise ValueError("Duplicate activity identifier")
seen.add(identifier)
title = " ".join(activity.findtext("title/narrative", "").split())
descriptions = [
" ".join(element.itertext()).strip() for element in activity.findall("description")
]
if not re.search(r"\b(?:battery|batteries|BESS)\b", " ".join([title, *descriptions]), re.I):
continue
status = activity.find("activity-status")
rows.append(
{
"activity_id": identifier,
"title": title,
"descriptions": descriptions,
"generated_at": root.get("generated-datetime"),
"updated_at": activity.get("last-updated-datetime"),
"activity_status_code": status.get("code") if status is not None else None,
"activity_dates": [dict(e.attrib) for e in activity.findall("activity-date")],
"implementing_entities": [
" ".join(e.findtext("narrative", "").split())
for e in activity.findall("participating-org")
if e.get("role") == "4"
],
}
)
return rows