Struct Sample 

pub struct Sample {
    pub position_rad: f64,
    pub velocity_radps: f32,
}

Per-encoder sample on a dynamic per-instance key.

Fields

position_rad: f64

velocity_radps: f32

Trait Implementations

impl Clone for Sample

fn clone(&self) -> Sample

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContractBody for Sample

const NAME: &'static str = "y2026_1::component::encoder::Sample"

The version-qualified type path this body’s own generation module places it at: the version module name, then the ::-joined node path (dynamic-node vars are topic params, never type-path segments), then the PascalCase type leaf, e.g. "y2026_1::drive::Target" or "y2026_1::component::motor::Command". This is the contract’s source identity (D1) - two contracts interoperate iff they share this exact name - as distinct from TOPIC, the resolved wire key derived from it. NAME is exactly the "::"-join of GENERATION and CONTRACT; it stays available for callers that want the whole identity as one string (e.g. display), while metadata recording splices the two split consts instead (coherence-gate design doc §2 - a joined name is not machine-parseable without assuming the generation naming scheme).

const GENERATION: &'static str = "y2026_1"

This body’s generation alone, e.g. "y2026_1" - equal to <Self::Api as ApiVersion>::ID, but exposed directly on the body so a metadata recorder (#[derive(phoxal::Api)]’s linker-section splicing) can const-splice it without routing through Self::Api. Split from CONTRACT so consumers (the coherence gate, catalog) record generation and contract as two separate fields rather than parsing a joined name.

const CONTRACT: &'static str = "component::encoder::Sample"

This body’s contract path within its own generation: the ::-joined node path (dynamic-node vars excluded, as with NAME) plus the PascalCase type leaf, e.g. "drive::Target". The logical contract - stable across a generation bump - is this value alone; pairing it with GENERATION recovers the full version-qualified identity (NAME).

const TOPIC: &'static str = "y2026_1/component/{instance}/encoder/{capability}/sample"

The generation-qualified wire key: the version module name, then the /-joined node path plus the topic leaf, with each dynamic node contributing a {var} placeholder, e.g. "y2026_1/drive/state" or "y2026_1/component/{instance}/motor/{capability}/command". The concrete key is produced by the api-local topic builder, which fills the placeholders.

type Api = Api

The single API version this body belongs to. Two bodies from different versions have different Api, so the type system keeps them apart.

impl Debug for Sample

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Sample

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Sample

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Sample

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Sample