read-url 0.0.10

Read from a wide variety of URL types
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

mod utils;

use {read_url::*, tokio::*};

// To use async make sure to enable the "async" crate feature in your Cargo.toml

#[main]
pub async fn main() -> Result<(), UrlError> {
    // We'll show some of the same stuff as in examples/start_here.rs,
    // but in async (via tokio)
    // All relevant APIs have _async equivalents

    let context = UrlContext::new();

    utils::heading("http", true);
    let url = context.url_async("http://localhost:8000/files/two.txt").await?;
    utils::dump_async(&url).await?;

    utils::heading("https", false);
    let url = context
        .url_async("https://raw.githubusercontent.com/tliron/rust-read-url/refs/heads/main/assets/files/two.txt")
        .await?;
    utils::dump_async(&url).await?;

    utils::heading("tar (no compression)", false);
    let url = context.url_async("tar:http://localhost:8000/archives/archive.tar!two.txt").await?;
    utils::dump_async(&url).await?;

    utils::heading("tar (gzip)", false);
    let url = context.url_async("tar:http://localhost:8000/archives/archive.tar.gz!two.txt").await?;
    utils::dump_async(&url).await?;

    utils::heading("tar (zstd)", false);
    let url = context.url_async("tar:http://localhost:8000/archives/archive.tar.zst!two.txt").await?;
    utils::dump_async(&url).await?;

    utils::heading("zip", false);
    let url = context.url_async("zip:http://localhost:8000/archives/archive.zip!two.txt").await?;
    utils::dump_async(&url).await?;

    utils::heading("git", false);
    let url = context.url_async("git:https://github.com/tliron/rust-read-url.git!assets/files/two.txt").await?;
    utils::dump_async(&url).await?;

    // Note that absolute does need an async version
    // But that conform_async() works a bit differently from conform(),
    // in that you need to use its returned value

    utils::heading("absolute", false);
    let mut url = context
        .absolute_url("https://raw.githubusercontent.com/tliron/rust-read-url/refs/heads/main/assets/files/two.txt")?;
    url = url.conform_async()?.await?;
    utils::dump_async(&url).await?;

    Ok(())
}