rubo4e ⚡

A Rust implementation of the BO4E energy-market data standard — the canonical data model for the German energy industry.

⚠️ This is not an official BO4E implementation. The official reference implementation is BO4E-python. This crate aims for idiomatic Rust ergonomics, strong domain types, and ecosystem integration.

✨ Features

• 🏗️ Generated types from the official BO4E JSON Schema (v202501)
• 🔒 Strong domain identifiers — MaloId, MeloId, EicCode, ObisCode, … with embedded validation
• ✅ Three-layer validation — constructor checks, garde struct rules, cross-field business logic
• 🔧 Typed builders — compile-time required-field enforcement via typed-builder; optional-field setters accept both T and Option<T>
• 🌍 German / English / Canonical JSON — BO4E wire format out of the box
• 📐 JSON Schema via schemars, OpenAPI via utoipa, DB via sqlx
• 🧪 Golden corpus and fuzz harnesses included; proptest round-trip tests run as dev tests

📦 Installation

Add to your Cargo.toml:

[dependencies]
rubo4e = "0.2"

Enable optional features as needed:

rubo4e = { version = "0.2", features = ["json", "versioned", "validate", "builder"] }

🚀 Quick Start

use rubo4e::prelude::*;
use rubo4e::v202501::{Vertrag, Sparte};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Builder with compile-time required-field enforcement (requires `builder` feature)
    let vertrag = Vertrag::builder()
        .sparte(Sparte::Strom)
        .beschreibung("Jahresvertrag Strom".to_string())
        .vertragsnummer("VN-2025-001".to_string())
        .build();

    // Cross-field struct validation (requires `validate` feature)
    use garde::Validate as _;
    vertrag.validate()?;

    // German camelCase JSON — BO4E wire format (requires `json` feature)
    let json = vertrag.to_json_german()?;
    println!("{json}");

    Ok(())
}

🎛️ Feature Gates

🗂️ Schema Versions

Use the versioned module to pin a stable schema:

use rubo4e::v202501::Marktlokation;

🏷️ Identifiers

All domain identifiers validate their format on construction:

📚 Documentation

• docs/architecture.md — Workspace layout, module tree, Mermaid diagram
• docs/generator.md — Internal code generator
• docs/identifiers.md — All identifier types and validation rules
• docs/versioning.md — Schema versions and migration
• docs/validation.md — Three-layer validation
• docs/serialization.md — Serialization modes
• docs/ecosystem.md — schemars, sqlx, utoipa, strum integrations
• docs/testing.md — Test categories, golden corpus, fuzz harness

🔗 Related Projects

📜 License

Dual-licensed under MIT or Apache 2.0 — your choice.

The BO4E standard itself is maintained by the Interessengemeinschaft Geschäftsobjekte Energiewirtschaft e. V..