update-informer 1.3.0

Easily implement update checks for your application
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

use crate::Result;
use serde::de::DeserializeOwned;
use std::time::Duration;

#[cfg(feature = "ureq")]
mod ureq;
#[cfg(all(feature = "ureq", not(feature = "reqwest")))]
pub use crate::http_client::ureq::UreqHttpClient;
#[cfg(all(feature = "ureq", not(feature = "reqwest")))]
pub type DefaultHttpClient = UreqHttpClient;

#[cfg(feature = "reqwest")]
mod reqwest;
#[cfg(all(feature = "reqwest", not(feature = "ureq")))]
pub use crate::http_client::reqwest::ReqwestHttpClient;
#[cfg(all(feature = "reqwest", not(feature = "ureq")))]
pub type DefaultHttpClient = ReqwestHttpClient;

#[cfg(all(not(feature = "ureq"), not(feature = "reqwest")))]
mod undefined;
#[cfg(all(not(feature = "ureq"), not(feature = "reqwest")))]
pub use crate::http_client::undefined::UndefinedHttpClient;
#[cfg(all(not(feature = "ureq"), not(feature = "reqwest")))]
pub type DefaultHttpClient = UndefinedHttpClient;

mod headers;
pub use headers::HeaderMap;

/// An HTTP client to send requests to the registry.
pub struct GenericHttpClient<'a, T: HttpClient> {
    _inner: T,
    timeout: Duration,
    headers: HeaderMap<'a>,
}

pub(crate) fn new<'a, T: HttpClient>(client: T, timeout: Duration) -> GenericHttpClient<'a, T> {
    GenericHttpClient {
        _inner: client,
        timeout,
        headers: HeaderMap::new(),
    }
}

impl<'a, T: HttpClient> GenericHttpClient<'a, T> {
    pub fn add_header(mut self, key: &'a str, value: &'a str) -> Self {
        self.headers.add(key, value);
        self
    }

    pub fn get<D: DeserializeOwned>(self, url: &str) -> Result<D> {
        T::get(url, self.timeout, self.headers)
    }
}

pub trait HttpClient {
    fn get<T: DeserializeOwned>(url: &str, timeout: Duration, headers: HeaderMap) -> Result<T>;
}