{"id":23100,"library":"fundamend","title":"Fundamend","description":"Python library for XML-based formats and data models for the German energy industry (Energiewirtschaft). Provides Pydantic models and tooling for MIGs, AHBs, and related standards. Latest version: 0.36.0. Actively developed with frequent releases.","status":"active","version":"0.36.0","language":"python","source_language":"en","source_url":"https://github.com/Hochfrequenz/xml-fundamend-python","tags":["energiewirtschaft","xml","mig","ahb","germany"],"install":[{"cmd":"pip install fundamend","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Top-level import is preferred; dot-path changed after 0.30.0.","wrong":"from fundamend.models import Mig","symbol":"Mig","correct":"from fundamend import Mig"},{"note":"Top-level import for Ahb; the old module path no longer works.","wrong":"from fundamend.ahb import Ahb","symbol":"Ahb","correct":"from fundamend import Ahb"}],"quickstart":{"code":"from fundamend import Mig\n\n# Load a MIG from a local XML file\nmig = Mig.from_xml(\"path/to/mig.xml\")\nprint(mig.title)\n\n# Load an AHB from XML\nfrom fundamend import Ahb\nahb = Ahb.from_xml(\"path/to/ahb.xml\")\nprint(ahb.name)","lang":"python","description":"Load MIG and AHB objects from XML files. The library provides Pydantic models with from_xml class methods."},"warnings":[{"fix":"Recompute any persisted ID paths; the new format is more stable across XML versions.","message":"Version 0.34.0 changed the `id_path` construction to use semantic qualifiers. If you rely on stable string ID paths, they may have changed.","severity":"breaking","affected_versions":">=0.34.0"},{"fix":"Change to `from fundamend import Mig` or the relevant class.","message":"Direct import from submodules (e.g., `from fundamend.models import ...`) is deprecated. Use top-level imports instead.","severity":"deprecated","affected_versions":">=0.30.0"},{"fix":"Ensure XML files are saved with UTF-8 encoding before loading.","message":"XML files must use UTF-8 encoding. Non-UTF-8 files may cause parsing errors, especially with German umlauts.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install --upgrade fundamend` and use `from fundamend import Mig`.","cause":"Using an outdated version (<0.30.0) or importing from wrong submodule.","error":"AttributeError: module 'fundamend' has no attribute 'Mig'"},{"fix":"Validate your XML against the official MIG/AHB schema. Check for missing tags or incorrect namespaces.","cause":"XML file does not conform to the expected schema (e.g., missing mandatory fields).","error":"pydantic.error_wrappers.ValidationError: 1 validation error for Mig"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}