decruft 0.1.3

Extract clean, readable content from web pages
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
58
59
60
61
62
63
64

pub mod bbcode;
pub mod c2wiki;
pub mod comments;
pub mod conversations;
pub mod github;
pub mod hackernews;
pub mod lobsters;
pub mod reddit;
pub mod stackoverflow;
pub mod substack;
pub mod twitter;

use scraper::Html;

/// Result of a site-specific extractor.
pub struct ExtractorResult {
    pub content: String,
    pub title: Option<String>,
    pub author: Option<String>,
    pub site: Option<String>,
    pub published: Option<String>,
    pub image: Option<String>,
    pub description: Option<String>,
}

/// Try each site-specific extractor in order.
///
/// Returns the first successful extraction along with the extractor
/// type name, or `None` if no extractor matched the page.
#[must_use]
pub fn try_extract(
    html: &Html,
    url: Option<&str>,
    include_replies: bool,
) -> Option<(ExtractorResult, &'static str)> {
    // Note: BBCode and Substack are handled separately in decruft.rs
    // because they interact with the metadata pipeline differently.

    if let Some(result) = github::extract_github(html, url, include_replies) {
        return Some((result, "github"));
    }
    if let Some(result) = reddit::extract_reddit(html, url, include_replies) {
        return Some((result, "reddit"));
    }
    if let Some(result) = hackernews::extract_hackernews(html, url, include_replies) {
        return Some((result, "hackernews"));
    }
    if let Some(result) = stackoverflow::extract_stackoverflow(html, url, include_replies) {
        return Some((result, "stackoverflow"));
    }
    if let Some(result) = lobsters::extract_lobsters(html, url, include_replies) {
        return Some((result, "lobsters"));
    }
    if let Some(result) = twitter::extract_x_article(html, url) {
        return Some((result, "twitter"));
    }
    if let Some(result) = c2wiki::extract_c2wiki(html, url) {
        return Some((result, "c2wiki"));
    }
    if let Some(result) = conversations::extract_conversation(html, url) {
        return Some((result, "conversation"));
    }
    None
}