Struct RecordProvenance 

pub struct RecordProvenance {
    pub version: u32,
    pub source_id: String,
    pub source_uri: Option<String>,
    pub stream_id: Option<String>,
    pub sequence: Option<u64>,
}

Generic source lineage for one crate::SpatialRecord.

The contract deliberately stays independent of ROS, MCAP, Arrow, and model runtimes. Adapters may identify their storage in source_uri and their logical channel in stream_id; chunk-producing adapters can attach a deterministic source sequence without changing the point schema.

Fields

version: u32

Contract version for this provenance envelope.

source_id: String

Stable logical source identity.

source_uri: Option<String>

Optional local path or URI from which the record was read.

stream_id: Option<String>

Optional logical stream, topic, or channel within the source.

sequence: Option<u64>

Optional deterministic source sequence for this record or chunk.

Implementations

impl RecordProvenance

pub fn unknown() -> Self

Creates an unknown-source envelope for synthetic or legacy records.

pub fn try_new(source_id: impl Into<String>) -> RecordsResult<Self>

Creates a validated envelope with a non-empty source identity.

pub fn validate(&self) -> RecordsResult<()>

Validates the version and required identity fields.

pub fn with_source_uri(self, source_uri: impl Into<String>) -> Self

Attaches a source path or URI.

pub fn with_stream_id(self, stream_id: impl Into<String>) -> Self

Attaches a logical stream, topic, or channel.

pub const fn with_sequence(self, sequence: Option<u64>) -> Self

Attaches a deterministic source sequence.

pub const fn without_sequence(self) -> Self

Removes a source sequence when an operation aggregates multiple inputs.

Trait Implementations

impl Clone for RecordProvenance

fn clone(&self) -> RecordProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordProvenance

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

Formats the value using the given formatter.

impl Default for RecordProvenance

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RecordProvenance

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RecordProvenance

fn eq(&self, other: &RecordProvenance) -> 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 Serialize for RecordProvenance

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RecordProvenance

impl StructuralPartialEq for RecordProvenance