Struct Control 

pub struct Control<T: Clone + Send + Sync + 'static> { /* private fields */ }

Implementations

impl<T: Clone + Send + Sync + 'static> Control<T>

pub fn name(&self) -> &str

Name of this control within its owning component’s registry.

pub fn get(&self) -> Versioned<T>

Borrow the current committed value.

pub fn value(&self) -> T

Convenience shortcut for self.get().value when the caller doesn’t need the metadata.

pub fn register_applier<A>(&self, applier: A) -> usize

where A: ControlApplier<T>,

Register an applier. Every subsequent Self::set call will include this applier in its fanout. There is no unregister — appliers live for the control’s lifetime. Returns the insertion index so callers can correlate later failure reports.

pub fn applier_count(&self) -> usize

Number of currently-registered appliers.

pub async fn set( &self, value: T, origin: ControlOrigin, ) -> Result<u64, SetError>

Atomic write. Returns Ok(rev) with the new revision only if every registered applier acknowledged the new value within the control’s apply timeout. On any failure the committed value is not advanced.

A control declared final via ControlBuilder::final_at_scope rejects every write whose origin is not ControlOrigin::Launch with SetError::FinalViolation. The Launch-seed write still goes through so the initial value can be installed; runtime writers (CLI, TUI, GK, API) are rejected against the pin.

pub fn gauge_f64(&self) -> Option<f64>

Current reified-gauge value, if the control opted in via ControlBuilder::reify_as_gauge and the conversion returns Some. The registry snapshots this into a MetricSet so control values flow through the normal metric sinks.

pub fn reified_gauge(&self) -> Option<Arc<ValueGauge>>

Raw handle to the reified ValueGauge for callers that want to sample the gauge directly without going through the control machinery (e.g. registering it on a crate::component::Component via register_instrument). None if the control wasn’t declared with gauge reification.

pub fn is_final(&self) -> bool

true if the control was declared final via ControlBuilder::final_at_scope. Final controls reject every non-Launch write.

pub fn final_scope(&self) -> Option<&str>

Name of the scope at which the control was declared final, if any. None for non-final controls.

pub fn branch_scope(&self) -> BranchScope

Declared branch scope of this control.

Trait Implementations

impl<T: Clone + Send + Sync + 'static> Clone for Control<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> ErasedControl for Control<T>

where T: Clone + Send + Sync + Debug + 'static,

fn name(&self) -> &str

fn rev(&self) -> u64

fn origin(&self) -> ControlOrigin

fn applier_count(&self) -> usize

fn value_string(&self) -> String

Human-readable rendering of the current value, for diagnostics / dryrun=controls output.

fn value_type_name(&self) -> &'static str

Static type name of T — stable enough to hint the caller what concrete type they’d need to downcast to.

fn gauge_f64(&self) -> Option<f64>

The reified gauge value (if the control opted in), for the registry’s MetricSet snapshot. None means either no reification or the current value has no numeric projection right now.

fn has_reified_gauge(&self) -> bool

True if the control was declared with gauge reification.

fn is_final(&self) -> bool

True if the control was declared final. Final controls reject every non-Launch write.

fn final_scope(&self) -> Option<String>

Scope name carried by a final declaration, if any.

fn branch_scope(&self) -> BranchScope

Declared branch scope of this control.

fn accepts_f64_writes(&self) -> bool

true if the control opts into f64-routed writes via ControlBuilder::from_f64.

fn set_f64( &self, value: f64, origin: ControlOrigin, ) -> Pin<Box<dyn Future<Output = Result<u64, SetError>> + Send>>

Type-erased write through the f64 converter. Returns the boxed async future so the caller can await from any runtime. If the control didn’t register a converter the future resolves to SetError::ValidationFailed with a “no f64 setter registered” message.