Struct SourceRef 

pub struct SourceRef {
    pub id: SourceId,
    pub locator: String,
    pub title: Option<String>,
    pub media_type: Option<String>,
    pub issuer: Option<String>,
    pub published_at: Option<Timestamp>,
    pub retrieved_at: Option<Timestamp>,
    pub content_hash: Option<ContentHash>,
    pub authority: SourceAuthority,
    pub derivation: Derivation,
    pub submitted_by: Option<Attribution>,
    pub visibility: Visibility,
}

A reference to a source artifact with provenance metadata.

Fields

id: SourceId

locator: String

URI of the artifact (https://..., urn:..., doi:...).

title: Option<String>

media_type: Option<String>

issuer: Option<String>

The institution or person that issued the artifact, if known.

published_at: Option<Timestamp>

Publication time claimed by or for the source, if known.

retrieved_at: Option<Timestamp>

When the artifact was retrieved/consulted (distinct from publication).

content_hash: Option<ContentHash>

Hash of the retrieved bytes, if they were fetched. See ContentHash.

authority: SourceAuthority

derivation: Derivation

submitted_by: Option<Attribution>

Who attached this reference.

visibility: Visibility

A source can be more restricted than the record that cites it (for example a private attachment on a public issue).

Implementations

impl SourceRef

pub fn new(locator: impl Into<String>) -> Self

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

pub fn issuer(self, i: impl Into<String>) -> Self

pub fn authority(self, a: SourceAuthority) -> Self

pub fn retrieved_at(self, t: Timestamp) -> Self

pub fn published_at(self, t: Timestamp) -> Self

pub fn submitted_by(self, a: Attribution) -> Self

pub fn visibility(self, v: Visibility) -> Self

pub fn derivation(self, d: Derivation) -> Self

pub fn scheme(&self) -> Option<String>

The URI scheme of the locator, lowercased.

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<'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

Equality operator ==.

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

Inequality operator !=.

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 StructuralPartialEq for SourceRef