rama-http-types 0.2.0

rama http type defintions and high level utilities
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

//! HTTP connection utilities.

use serde::{Deserialize, Serialize};

use crate::proto::h2::{
    PseudoHeaderOrder,
    frame::{SettingsConfig, StreamId},
};

#[derive(Debug, Clone, Default)]
/// Optional parameters that can be set in the [`Context`] of a (h1) request
/// to customise the connection of the h1 connection.
///
/// Can be used by Http connector services, especially in the context of proxies,
/// where there might not be one static config that is to be applied to all client connections.
pub struct Http1ClientContextParams {
    /// Set whether HTTP/1 connections will write header names as title case at
    /// the socket level.
    ///
    /// Default is false.
    pub title_header_case: bool,
}

#[derive(Debug, Clone, Default)]
/// Optional parameters that can be set in the [`Context`] of a (h2) request
/// to customise the connection of the h2 connection.
///
/// Can be used by Http connector services, especially in the context of proxies,
/// where there might not be one static config that is to be applied to all client connections.
pub struct H2ClientContextParams {
    /// Pseudo order of the headers stream
    pub headers_pseudo_order: Option<PseudoHeaderOrder>,

    /// Priority of the headers stream
    pub headers_priority: Option<StreamDependencyParams>,

    /// Priority stream list
    pub priority: Option<Vec<PriorityParams>>,

    /// Config for h2 settings
    pub setting_config: Option<SettingsConfig>,
}

#[derive(Debug, Clone, Eq, PartialEq, Serialize, Deserialize)]
pub struct StreamDependencyParams {
    /// The ID of the stream dependency target
    pub dependency_id: StreamId,

    /// The weight for the stream. The value exposed (and set) here is always in
    /// the range [0, 255], instead of [1, 256] (as defined in section 5.3.2.)
    /// so that the value fits into a `u8`.
    pub weight: u8,

    /// True if the stream dependency is exclusive.
    pub is_exclusive: bool,
}

#[derive(Debug, Clone)]
/// Injected into h2 requests for those who are interested in this.
pub struct LastPeerPriorityParams(pub PriorityParams);

#[derive(Debug, Clone, Eq, PartialEq, Serialize, Deserialize)]
pub struct PriorityParams {
    pub stream_id: StreamId,
    pub dependency: StreamDependencyParams,
}