lectito 0.3.0

Article extraction and readability parsing for Lectito.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

use serde::Serialize;

use crate::Article;

/// Format an article as Markdown with TOML frontmatter.
///
/// The frontmatter includes available metadata from [`Article`] plus the
/// optional source URL.
pub fn markdown_with_toml_frontmatter(article: &Article, source: Option<&str>) -> Result<String, toml::ser::Error> {
    let frontmatter = Frontmatter {
        title: non_empty(article.title.as_deref()),
        author: non_empty(article.byline.as_deref()),
        site: non_empty(article.site_name.as_deref()),
        published: non_empty(article.published_time.as_deref()),
        source: non_empty(source),
        domain: non_empty(article.domain.as_deref()),
        language: non_empty(article.lang.as_deref()),
        description: non_empty(article.excerpt.as_deref()),
        image: non_empty(article.image.as_deref()),
        favicon: non_empty(article.favicon.as_deref()),
        dir: non_empty(article.dir.as_deref()),
        length: article.length,
    };
    let metadata = toml::to_string(&frontmatter)?;
    Ok(format!("+++\n{}+++\n\n{}", metadata, article.markdown))
}

#[derive(Serialize)]
struct Frontmatter<'a> {
    #[serde(skip_serializing_if = "Option::is_none")]
    title: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    author: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    site: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    published: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    source: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    domain: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    language: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    description: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    image: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    favicon: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    dir: Option<&'a str>,
    length: usize,
}

fn non_empty(value: Option<&str>) -> Option<&str> {
    value.map(str::trim).filter(|value| !value.is_empty())
}