eclexiaiser 0.1.0

Add energy, carbon, and resource-cost awareness to existing software via Eclexia economics-as-code
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

// SPDX-License-Identifier: PMPL-1.0-or-later
// Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
//
// eclexiaiser library — Add energy, carbon, and resource-cost awareness to
// existing software via Eclexia economics-as-code.
//
// This library provides:
// - ABI types for energy budgets, carbon intensity, and sustainability reports
// - Manifest parsing and validation for `eclexiaiser.toml`
// - Code generation for instrumentation wrappers and Eclexia constraints
// - Sustainability report generation (text, JSON, EU CSRD)

pub mod abi;
pub mod codegen;
pub mod manifest;

pub use manifest::{load_manifest, parse_manifest, validate, Manifest};

/// Generate all eclexiaiser artifacts from a manifest file.
///
/// This is the main library entry point. It loads the manifest, validates it,
/// and generates instrumentation code, Eclexia constraints, and a sustainability
/// report in the specified output directory.
///
/// # Arguments
/// - `manifest_path` — Path to `eclexiaiser.toml`
/// - `output_dir` — Directory for generated artifacts
///
/// # Errors
/// Returns an error if the manifest cannot be loaded, fails validation, or
/// if code generation encounters an I/O error.
pub fn generate(manifest_path: &str, output_dir: &str) -> anyhow::Result<()> {
    let m = load_manifest(manifest_path)?;
    validate(&m)?;
    codegen::generate_all(&m, output_dir)
}