kumo 0.5.0

An async web crawling framework for Rust - Scrapy for Rust
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
65
66
67
68
69
70
71

//! Demonstrates typed crawl lifecycle events.
//!
//! Run with:
//! cargo run --example crawl_events

use kumo::prelude::*;
use serde_json::json;

struct DemoSpider {
    url: String,
}

#[async_trait::async_trait]
impl Spider for DemoSpider {
    type Item = serde_json::Value;

    fn name(&self) -> &str {
        "crawl-events-demo"
    }

    fn start_urls(&self) -> Vec<String> {
        vec![self.url.clone()]
    }

    async fn parse(&self, res: &Response) -> Result<Output<Self::Item>, KumoError> {
        let title = res
            .css("h1")
            .first()
            .map(|node| node.text())
            .unwrap_or_default();
        Ok(Output::new().item(json!({
            "url": res.url(),
            "title": title,
        })))
    }
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let url = "https://example.com";
    let fetcher = MockFetcher::new().with_response(url, 200, "<h1>Hello from events</h1>");
    let (engine, mut events) = CrawlEngine::builder().fetcher(fetcher).event_channel(128);

    let listener = tokio::spawn(async move {
        while let Ok(event) = events.recv().await {
            match event {
                CrawlEvent::RequestCompleted {
                    url, status, items, ..
                } => {
                    println!("{url} status={status} items={items}");
                }
                CrawlEvent::CrawlFinished { report, .. } => {
                    println!(
                        "finished pages={} items={}",
                        report.pages_crawled, report.items_scraped
                    );
                    break;
                }
                _ => {}
            }
        }
    });

    engine
        .run(DemoSpider {
            url: url.to_string(),
        })
        .await?;
    listener.await?;
    Ok(())
}