Struct ThingBuilder 

pub struct ThingBuilder { /* private fields */ }

Fluent builder for Thing.

All string setters accept impl Into<String> so call-sites may pass &str, String, or &String interchangeably without explicit conversion.

Example

use thing_matcher::{Thing, ThingBuilder};

let t: Thing = ThingBuilder::default()
    .name(String::from("Eiffel Tower"))
    .add_alternate_name("La Tour Eiffel")
    .url("https://www.toureiffel.paris/")
    .add_same_as("https://www.wikidata.org/wiki/Q243")
    .build();

assert_eq!(t.name.as_deref(), Some("Eiffel Tower"));
assert_eq!(t.same_as.len(), 1);

Implementations

impl ThingBuilder

pub fn name<S: Into<String>>(self, value: S) -> Self

Set the primary canonical name.

let t = Thing::builder().name("Eiffel Tower").build();
assert_eq!(t.name.as_deref(), Some("Eiffel Tower"));

pub fn alternate_names(self, value: Vec<String>) -> Self

Replace the entire list of alternate names.

let t = Thing::builder()
    .alternate_names(vec!["La Tour Eiffel".into(), "Tour Eiffel".into()])
    .build();
assert_eq!(t.alternate_names.len(), 2);

pub fn add_alternate_name<S: Into<String>>(self, value: S) -> Self

Append a single alternate name.

let t = Thing::builder()
    .add_alternate_name("La Tour Eiffel")
    .add_alternate_name("Tour Eiffel")
    .build();
assert_eq!(t.alternate_names.len(), 2);

pub fn description<S: Into<String>>(self, value: S) -> Self

Set the free-form description.

let t = Thing::builder().description("A landmark in Paris.").build();
assert_eq!(t.description.as_deref(), Some("A landmark in Paris."));

pub fn disambiguating_description<S: Into<String>>(self, value: S) -> Self

Set the disambiguating description.

let t = Thing::builder().disambiguating_description("The Paris one.").build();
assert_eq!(t.disambiguating_description.as_deref(), Some("The Paris one."));

pub fn identifiers(self, value: Vec<Identifier>) -> Self

Replace the entire list of identifiers.

let id = Identifier::new("wikidata", "Q243").unwrap();
let t = Thing::builder().identifiers(vec![id.clone()]).build();
assert_eq!(t.identifiers, vec![id]);

pub fn add_identifier(self, value: Identifier) -> Self

Append a single identifier.

let t = Thing::builder()
    .add_identifier(Identifier::new("wikidata", "Q243").unwrap())
    .build();
assert_eq!(t.identifiers.len(), 1);

pub fn url<S: Into<String>>(self, value: S) -> Self

Set the canonical URL.

let t = Thing::builder().url("https://www.toureiffel.paris/").build();
assert_eq!(t.url.as_deref(), Some("https://www.toureiffel.paris/"));

pub fn image<S: Into<String>>(self, value: S) -> Self

Set the representative image URL.

let t = Thing::builder().image("https://example.org/eiffel.jpg").build();
assert_eq!(t.image.as_deref(), Some("https://example.org/eiffel.jpg"));

pub fn same_as(self, value: Vec<String>) -> Self

Replace the entire sameAs list.

let t = Thing::builder()
    .same_as(vec![
        "https://www.wikidata.org/wiki/Q243".into(),
        "https://en.wikipedia.org/wiki/Eiffel_Tower".into(),
    ])
    .build();
assert_eq!(t.same_as.len(), 2);

pub fn add_same_as<S: Into<String>>(self, value: S) -> Self

Append a single sameAs URL.

let t = Thing::builder()
    .add_same_as("https://www.wikidata.org/wiki/Q243")
    .build();
assert_eq!(t.same_as.len(), 1);

pub fn main_entity_of_page<S: Into<String>>(self, value: S) -> Self

Set the mainEntityOfPage URL.

let t = Thing::builder()
    .main_entity_of_page("https://en.wikipedia.org/wiki/Eiffel_Tower")
    .build();
assert_eq!(
    t.main_entity_of_page.as_deref(),
    Some("https://en.wikipedia.org/wiki/Eiffel_Tower"),
);

pub fn additional_types(self, value: Vec<String>) -> Self

Replace the entire list of additionalType URIs.

let t = Thing::builder()
    .additional_types(vec!["https://schema.org/Landmark".into()])
    .build();
assert_eq!(t.additional_types.len(), 1);

pub fn add_additional_type<S: Into<String>>(self, value: S) -> Self

Append a single additionalType URI.

let t = Thing::builder()
    .add_additional_type("https://schema.org/Landmark")
    .build();
assert_eq!(t.additional_types.len(), 1);

pub fn subject_of(self, value: Vec<String>) -> Self

Replace the entire subjectOf list.

pub fn add_subject_of<S: Into<String>>(self, value: S) -> Self

Append a single subjectOf URL.

pub fn owner<S: Into<String>>(self, value: S) -> Self

Set the owner (person or organisation, as a string).

pub fn local_id<S: Into<String>>(self, value: S) -> Self

Set the local identifier.

let t = Thing::builder().local_id("REF-12345").build();
assert_eq!(t.local_id.as_deref(), Some("REF-12345"));

pub fn build(self) -> Thing

Consume the builder and produce the Thing.

let t = Thing::builder().name("Big Ben").build();
assert!(t.url.is_none());

Trait Implementations

impl Default for ThingBuilder

fn default() -> ThingBuilder

Returns the “default value” for a type.