Struct Episode 

pub struct Episode {

    pub title: String,
    pub link: String,
    pub enclosure_url: String,
    pub byte_len: u64,
    pub duration_secs: u64,
    pub published_at: i64,
    pub slug: Option<String>,
    pub order: Option<u32>,
    pub tracklist: Option<String>,
    pub body: Option<String>,
    pub links: Option<String>,
    pub bundle_title: Option<String>,
    pub special: bool,
}

One episode of musicforprogramming.net.

Fields

title: String

link: String

The episode’s page on the site.

enclosure_url: String

The audio enclosure URL, and the episode’s stable identity: enrichment records join to episodes by exact string equality against it.

byte_len: u64

The byte length the feed declares for the enclosure.

duration_secs: u64

The duration the feed declares in itunes:duration, in seconds.

An approximate total, never a measured audio length. Consumers must present it as approximate.

published_at: i64

Publication time as whole seconds since the Unix epoch.

slug: Option<String>

Site slug, when enrichment supplied one.

order: Option<u32>

The site’s own catalog ordering, when enrichment supplied one.

tracklist: Option<String>

Track listing as plain text, one track per line, when enrichment supplied one.

body: Option<String>

Descriptive body as plain text, when enrichment supplied one.

links: Option<String>

Related links as plain text, one per line, when enrichment supplied any.

bundle_title: Option<String>

The site’s own title for this episode, when enrichment supplied one.

The feed says Episode 79: Corticyte where the site says 79: Corticyte, and anything replicating the site’s presentation wants the latter, which Episode::site_title resolves.

special: bool

Whether the site flags this episode for distinct colouring.

Exactly one episode carries it today; absent enrichment every episode reports false, so an unknown flag is never mistaken for a set one. Presentation only: ordering, playback, and download all ignore it.

Implementations

impl Episode

pub fn id(&self) -> Cow<'_, str>

The episode’s stable filesystem-safe identifier, used to name its on-disk artifacts and as the slug clients pass over the wire.

The enrichment slug where one exists, a deterministic derivation from the enclosure URL otherwise, so the same episode resolves to the same name across runs whether or not enrichment succeeded. Borrowed from the slug in the enriched case, so scanning the catalog for one identifier allocates nothing.

impl Episode

pub fn site_title(&self) -> &str

The title as the site itself writes it, which every view replicating the site draws.

Enrichment’s title where there is one, otherwise the feed’s with its Episode prefix stripped, since the feed writes Episode 79: Corticyte where the site writes 79: Corticyte - so an un-enriched catalog degrades to the same shape rather than a visibly different one.

Trait Implementations

impl Clone for Episode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Episode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Episode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Episode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Episode

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 Episode