http-wasm-guest 0.3.0

a library providing a http-wasm guest handler
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
69
70
71

#[link(wasm_import_module = "http_handler")]
unsafe extern "C" {
    /// log adds a UTF-8 encoded message to the host's logs at the given $level.
    pub(crate) unsafe fn log(level: i32, message: *const u8, message_len: i32);
    /// log_enabled returns 1 if the $level is enabled. This value may be cached
    /// at request granularity.
    pub(crate) unsafe fn log_enabled(level: i32) -> i32;
    /// get_config writes configuration from the host to memory if it exists and
    /// isn't larger than the `buf_limit`. The result is its length in bytes.
    pub(crate) unsafe fn get_config(buf: *const u8, buf_limit: i32) -> i32;
    pub(crate) unsafe fn get_method(buf: *const u8, buf_limit: i32) -> i32;
    pub(crate) unsafe fn set_method(ptr: *const u8, message_len: i32);
    pub(crate) unsafe fn get_uri(ptr: *const u8, buf_limit: i32) -> i32;
    pub(crate) unsafe fn set_uri(ptr: *const u8, message_len: i32);
    pub(crate) unsafe fn get_protocol_version(ptr: *const u8, message_len: i32) -> i32;
    pub(crate) unsafe fn add_header_value(
        header_kind: i32,
        name_ptr: *const u8,
        name_len: i32,
        value_ptr: *const u8,
        value_len: i32,
    );
    pub(crate) unsafe fn set_header_value(
        header_kind: i32,
        name_ptr: *const u8,
        name_len: i32,
        value_ptr: *const u8,
        value_len: i32,
    );
    pub(crate) unsafe fn remove_header(header_kind: i32, name_ptr: *const u8, name_len: i32);
    pub(crate) unsafe fn get_header_names(header_kind: i32, buf: *const u8, buf_limit: i32) -> i64;
    pub(crate) unsafe fn get_header_values(
        header_kind: i32,
        name_ptr: *const u8,
        name_len: i32,
        buf: *const u8,
        buf_limit: i32,
    ) -> i64;
    pub(crate) unsafe fn read_body(body_kind: i32, ptr: *const u8, buf_limit: i32) -> i64;
    pub(crate) unsafe fn write_body(body_kind: i32, ptr: *const u8, message_len: i32);
    pub(crate) unsafe fn get_status_code() -> i32;
    pub(crate) unsafe fn set_status_code(code: i32);
    pub(crate) unsafe fn enable_features(feature: i32) -> i32;
    pub(crate) unsafe fn get_source_addr(buf: *const u8, buf_limit: i32) -> i32;
}

#[cfg(test)]
pub mod overrides {
    #[unsafe(no_mangle)]
    pub extern "C" fn get_status_code() -> i32 {
        200
    }

    #[unsafe(no_mangle)]
    pub extern "C" fn get_config(_buf: *const u8, buf_limit: i32) -> i32 {
        buf_limit
    }
    #[unsafe(no_mangle)]
    pub extern "C" fn get_protocol_version(_ptr: *const u8, message_len: i32) -> i32 {
        message_len
    }

    #[unsafe(no_mangle)]
    pub extern "C" fn read_body(_body_kind: i32, _ptr: *const u8, buf_limit: i32) -> i64 {
        1i64 << 32 | buf_limit as i64
    }
    #[unsafe(no_mangle)]
    pub extern "C" fn get_header_names(_header_kind: i32, _buf: *const u8, buf_limit: i32) -> i64 {
        1i64 << 32 | buf_limit as i64
    }
}