Struct SourceRef 

pub struct SourceRef {
    pub source_type: SourceType,
    pub url: Option<String>,
    pub title: Option<String>,
    pub author: Option<String>,
    pub date: Option<Timestamp>,
    pub notes: Option<String>,
}

Reference to source material.

Sources track the provenance of event data, enabling verification and attribution.

Examples

use spatial_narrative::core::{SourceRef, SourceType};

let source = SourceRef::article("https://news.example.com/story");

let detailed = SourceRef::builder()
    .source_type(SourceType::Report)
    .url("https://gov.example.com/report.pdf")
    .title("Official Incident Report")
    .author("Department of Safety")
    .build();

Fields

source_type: SourceType

Type of source.

url: Option<String>

URL to the source (if available).

title: Option<String>

Title of the source.

author: Option<String>

Author or creator.

date: Option<Timestamp>

Publication or access date.

notes: Option<String>

Additional notes about the source.

Implementations

impl SourceRef

pub fn new(source_type: SourceType) -> Self

Creates a new source reference with the given type.

pub fn article(url: impl Into<String>) -> Self

Creates an article source with a URL.

pub fn report(url: impl Into<String>) -> Self

Creates a report source with a URL.

pub fn witness(notes: Option<String>) -> Self

Creates a witness source with optional notes.

pub fn sensor(url: impl Into<String>) -> Self

Creates a sensor source with a URL.

pub fn builder() -> SourceRefBuilder

Creates a builder for constructing a SourceRef.

pub fn with_url(self, url: impl Into<String>) -> Self

Sets the URL.

pub fn with_title(self, title: impl Into<String>) -> Self

Sets the title.

pub fn with_author(self, author: impl Into<String>) -> Self

Sets the author.

pub fn with_date(self, date: Timestamp) -> Self

Sets the date.

Trait Implementations

impl Clone for SourceRef

fn clone(&self) -> SourceRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceRef

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

Formats the value using the given formatter.

impl Default for SourceRef

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SourceRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SourceRef

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

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 SourceRef

impl StructuralPartialEq for SourceRef