gofer 0.2.0

Gofer.rs makes it easy to fetch data from any URL.
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

// This is free and unencumbered software released into the public domain.

use crate::{Error, Read, RequestConfig, Result, Url, UrlScheme};

pub fn open(url: impl AsRef<str>) -> Result<Box<dyn Read>> {
    let url = url.as_ref().parse::<Url>()?;

    // TODO: look up the scheme in a protocol handler registry

    match url.scheme() {
        #[cfg(feature = "data")]
        UrlScheme::Data => crate::schemes::data::open(&url),

        #[cfg(feature = "file")]
        UrlScheme::File => crate::schemes::file::open(&url),

        #[cfg(feature = "ftp")]
        UrlScheme::Ftp => crate::schemes::ftp::open(&url, false),

        #[cfg(feature = "ftps")]
        UrlScheme::Ftps => crate::schemes::ftp::open(&url, true),

        #[cfg(feature = "git")]
        UrlScheme::Git => crate::schemes::git::open(&url),

        #[cfg(feature = "http")]
        UrlScheme::Http => crate::schemes::http::open(&url, false),

        #[cfg(feature = "https")]
        UrlScheme::Https => crate::schemes::http::open(&url, true),

        #[cfg(feature = "ipfs")]
        UrlScheme::Ipfs => crate::schemes::ipfs::open(&url),

        #[cfg(feature = "scp")]
        UrlScheme::Scp => crate::schemes::scp::open(&url),

        #[cfg(feature = "stdin")]
        UrlScheme::Stdin => crate::schemes::stdin::open(&url),

        _ => Err(Error::UnknownScheme(url.scheme_str().to_string())),
    }
}

pub fn open_with_config(url: impl AsRef<str>, config: RequestConfig) -> Result<Box<dyn Read>> {
    let url = url.as_ref().parse::<Url>()?;

    match url.scheme() {
        #[cfg(feature = "git")]
        UrlScheme::Git => crate::schemes::git::open_with_config(&url, config),

        #[cfg(feature = "http")]
        UrlScheme::Http => crate::schemes::http::open_with_config(&url, false, config),

        #[cfg(feature = "https")]
        UrlScheme::Https => crate::schemes::http::open_with_config(&url, true, config),

        #[cfg(feature = "ipfs")]
        UrlScheme::Ipfs => crate::schemes::ipfs::open_with_config(&url, config),

        _ => Err(Error::UnknownScheme(url.scheme_str().to_string())),
    }
}

#[cfg(feature = "std")]
pub fn open_buffered(url: impl AsRef<str>) -> Result<std::io::BufReader<Box<dyn Read>>> {
    Ok(std::io::BufReader::new(open(url)?))
}