db-schema

Python package for reading, editing, and writing DesignBuilder XML files using Pydantic and pydantic-xml.

Install

pip install dsbxml

Quick Start

from dsbxml import load_model, save_model

dsb = load_model("building.xml")
dsb.name = "Updated Building"
save_model(dsb, "building_updated.xml")

Features

• Type-safe XML handling via Pydantic v2
• XXE attack protection built-in
• Full DesignBuilder XML schema support including HVAC
• Load/save XML and JSON formats

Data Model

dsbXML
└── Site
    ├── Attributes / Tables / AssemblyLibrary
    └── Buildings
        └── Building
            ├── BuildingBlocks / Zones / Surfaces
            └── HVACNetwork
                └── HVACLoops / HVACZoneGroups

Development

git clone https://github.com/DesignBuilderSoftware/db-schema
cd db-schema
pip install -e ".[dev]"
pytest

License

MIT — Bartłomiej Tokarzewski