shell-download 0.22.1

Zero-dependency Rust library for downloading a remote URL to a file, string or bytes using commonly-available shell tools.
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

//! Minimal HTTP over TCP (`http`) and HTTPS via OpenSSL (`openssl s_client`).

use std::sync::{Arc, atomic::AtomicBool};
use std::thread::JoinHandle;

use crate::{
    DownloadResult, DownloadSink, ResponseError, StartError,
    drivers::{Driver, Request},
};

mod http11;
mod openssl;
mod tcp;

pub(crate) use openssl::OpenSslDriver;
pub(crate) use tcp::TcpDriver;

#[derive(Debug, Clone, Copy)]
/// Dispatches to [`TcpDriver`] for `http:` and OpenSSL ([`OpenSslDriver`]) for `https:`.
pub(crate) struct TunnelDriver;

impl Driver for TunnelDriver {
    fn start(
        &self,
        req: Request,
        sink: DownloadSink,
        cancel: Arc<AtomicBool>,
    ) -> Result<JoinHandle<Result<DownloadResult, ResponseError>>, StartError> {
        let url = req.url.clone();
        match url.scheme.as_str() {
            "http" => TcpDriver.start(req, sink, cancel),
            "https" => OpenSslDriver.start(req, sink, cancel),
            _ => Err(StartError::NoDriverFound),
        }
    }
}