Struct EnergyBudget 

pub struct EnergyBudget {
    pub max_joules: Option<f64>,
    pub max_watts: Option<f64>,
    pub max_temp_delta: Option<f64>,
    pub span: Span,
}

Energy budget constraints for a function or block.

These constraints can be attached to functions via the #[energy_budget(...)] attribute to specify limits on energy consumption, power usage, and temperature impact.

Example

#[energy_budget(max_joules = 0.5)]
fn process(data: &[f32]) -> f32 {
    // Compiler can warn if estimated energy > 0.5J
}

#[energy_budget(max_joules = 1.0, max_temp_delta = 5.0)]
fn intensive_compute() {
    // Also track temperature increase
}

Fields

max_joules: Option<f64>

Maximum energy consumption in joules

max_watts: Option<f64>

Maximum power consumption in watts

max_temp_delta: Option<f64>

Maximum temperature delta in Celsius

span: Span

Source span for error reporting

Implementations

impl EnergyBudget

pub const fn new(span: Span) -> Self

Create a new empty energy budget

pub const fn with_max_joules(joules: f64, span: Span) -> Self

Create an energy budget with max_joules constraint

pub const fn has_constraints(&self) -> bool

Check if this energy budget has any constraints

pub const fn set_max_joules(&mut self, joules: f64)

Set max_joules constraint

pub const fn set_max_watts(&mut self, watts: f64)

Set max_watts constraint

pub const fn set_max_temp_delta(&mut self, delta: f64)

Set max_temp_delta constraint

Trait Implementations

impl Clone for EnergyBudget

fn clone(&self) -> EnergyBudget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EnergyBudget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EnergyBudget

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for EnergyBudget

fn eq(&self, other: &EnergyBudget) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EnergyBudget