wifi-caddy 0.1.0

Platform-agnostic config storage traits, HTTP config portal, and form generation for WiFi configuration managers
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
72
73
74
75
76
77
78
79
80

//! HTTP response helpers for edge-http.

use alloc::string::String;

use edge_http::io::Error;
use edge_http::io::server::Connection;
use embedded_io_async::{ErrorType, Read, Write};

/// Send a 200 OK response with JSON content-type.
pub async fn send_json<T, const N: usize>(
    conn: &mut Connection<'_, T, N>,
    json: &str,
) -> Result<(), Error<<T as ErrorType>::Error>>
where
    T: Read + Write,
{
    conn.initiate_response(
        200,
        None,
        &[
            ("Content-Type", "application/json"),
            ("Connection", "close"),
        ],
    )
    .await?;
    conn.write_all(json.as_bytes()).await?;
    conn.complete().await
}

/// Send a response with plain-text content-type.
pub async fn send_text<T, const N: usize>(
    conn: &mut Connection<'_, T, N>,
    status: u16,
    body: &str,
) -> Result<(), Error<<T as ErrorType>::Error>>
where
    T: Read + Write,
{
    conn.initiate_response(
        status,
        None,
        &[("Content-Type", "text/plain"), ("Connection", "close")],
    )
    .await?;
    if !body.is_empty() {
        conn.write_all(body.as_bytes()).await?;
    }
    conn.complete().await
}

/// Send a response with plain-text content-type and an owned String body.
pub async fn send_text_string<T, const N: usize>(
    conn: &mut Connection<'_, T, N>,
    status: u16,
    body: String,
) -> Result<(), Error<<T as ErrorType>::Error>>
where
    T: Read + Write,
{
    send_text(conn, status, &body).await
}

/// Send a 307 redirect response.
#[cfg(feature = "captive")]
pub async fn send_redirect<T, const N: usize>(
    conn: &mut Connection<'_, T, N>,
    location: &str,
) -> Result<(), Error<<T as ErrorType>::Error>>
where
    T: Read + Write,
{
    conn.initiate_response(
        307,
        None,
        &[("Location", location), ("Connection", "close")],
    )
    .await?;
    conn.write_all(location.as_bytes()).await?;
    conn.complete().await
}