http_data 0.11.0

Traits for retrieving http data
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

use std::time;

use bytes::Buf;

use crate::data_kinds::{DataKind, DataKindPreference, DataKinds};
use crate::{HeaderData, HttpVersion, MethodData, SocketPairData, Status, TlsVersion, UriData};

pub trait ResponseDataProvider {
    const HEADER_KINDS: DataKinds;

    fn status(&self) -> Option<Status>;
    fn time_sent(&self) -> Option<time::SystemTime>;
    fn body(&self) -> Option<impl http_body::Body<Data = impl Send + Buf> + Send>;

    fn provide_headers(&self, dk: DataKind) -> Option<HeaderData<'_>>;

    fn provide_preferred_headers(&self, prefs: &DataKindPreference) -> Option<HeaderData<'_>> {
        prefs
            .top(Self::HEADER_KINDS)
            .and_then(|dk| self.provide_headers(dk))
    }
}

pub trait ConnectionDataProvider {
    const SOCKET_KINDS: DataKinds;
    fn tls_version(&self) -> Option<TlsVersion>;

    fn provide_sockets(&self, dk: DataKind) -> Option<SocketPairData<'_>>;

    fn provide_preferred_socket(&self, prefs: &DataKindPreference) -> Option<SocketPairData<'_>> {
        prefs
            .top(Self::SOCKET_KINDS)
            .and_then(|dk| self.provide_sockets(dk))
    }
}

pub trait RequestDataProvider {
    const METHOD_KINDS: DataKinds;
    const URI_KINDS: DataKinds;
    const HEADER_KINDS: DataKinds;

    fn time_received(&self) -> Option<time::SystemTime>;
    fn http_version(&self) -> Option<HttpVersion>;
    fn body(&self) -> Option<impl http_body::Body<Data = impl Send + Buf> + Send>;

    // I think these should be possible to auto-implement
    fn provide_method(&self, dk: DataKind) -> Option<MethodData<'_>>;
    fn provide_uri(&self, dk: DataKind) -> Option<UriData<'_>>;
    fn provide_headers(&self, dk: DataKind) -> Option<HeaderData<'_>>;

    fn provide_preferred_method(&self, prefs: &DataKindPreference) -> Option<MethodData<'_>> {
        prefs
            .top(Self::METHOD_KINDS)
            .and_then(|dk| self.provide_method(dk))
    }
    fn provide_preferred_uri(&self, prefs: &DataKindPreference) -> Option<UriData<'_>> {
        prefs
            .top(Self::URI_KINDS)
            .and_then(|dk| self.provide_uri(dk))
    }
    fn provide_preferred_headers(&self, prefs: &DataKindPreference) -> Option<HeaderData<'_>> {
        prefs
            .top(Self::HEADER_KINDS)
            .and_then(|dk| self.provide_headers(dk))
    }
}