Struct ExternalSource 

pub struct ExternalSource { /* private fields */ }

A normalized external source returned by search or another hosted tool.

Implementations

impl ExternalSource

pub fn new(url: impl Into<String>) -> Result<Self, ExternalContentError>

Creates a source with a bounded HTTP(S) URL.

Errors

Returns an error for non-HTTP(S), empty, oversized, or control-containing URLs.

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

Adds a bounded, control-free source title.

Errors

Returns an error when the title is empty, oversized, or contains controls.

pub fn with_snippet( self, snippet: impl Into<String>, ) -> Result<Self, ExternalContentError>

Adds a bounded source snippet.

Errors

Returns an error when the snippet is empty, oversized, or contains a null character.

pub fn url(&self) -> &str

Returns the source URL.

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

Returns the optional source title.

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

Returns the optional source snippet.

Trait Implementations

impl Clone for ExternalSource

fn clone(&self) -> ExternalSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExternalSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ExternalSource

impl PartialEq for ExternalSource

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ExternalSource

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 ExternalSource