gumbo-lib 0.1.7

Best of the best rust projects all mixed together into a website framework
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

use actix_web::HttpResponse;
use regex::Regex;
use std::fmt::Display;
use yew::html::BaseComponent;
use yew::ServerRenderer;

/// Returns the web facing path to a resource in your application
/// Will be prefixed with the app_root
pub fn app_path(src: impl Into<String>) -> String {
    let src: String = src.into();
    if let Some(tail) = src.strip_prefix("/") {
        let root = crate::app_root();
        return format!("{root}{tail}");
    }
    src
}

/// Returns the web facing path to a resource in your application
/// Will be prefixed with the app_root
/// takes two args useful when creating a path with an Id
/// output: `/app_root/src/tail`
pub fn app_path2(src: impl Into<String>, tail: impl Display) -> String {
    let src = app_path(src);
    format!("{src}/{tail}")
}

/// Render a Yew view to send out in an Actix Response
pub async fn render<V, VM, E>(args: VM) -> Result<HttpResponse, E>
where
    V: BaseComponent,
    V: BaseComponent<Properties = VM>,
    VM: Send + 'static,
{
    let renderer = ServerRenderer::<V>::with_props(|| args);
    let html = renderer.render().await;
    // add the doctype markup. Yew doesn't like to render this.
    let html = format!("<!DOCTYPE html>\n{html}");
    Ok(HttpResponse::Ok()
        .content_type("text/html; charset=utf-8")
        .body(html))
}

/// Render a Yew view to send out in an Actix Response
/// Strips out HTML comments
pub async fn render_min<V, VM, E>(args: VM) -> Result<HttpResponse, E>
where
    V: BaseComponent,
    V: BaseComponent<Properties = VM>,
    VM: Send + 'static,
{
    let renderer = ServerRenderer::<V>::with_props(|| args);
    let html = renderer.render().await;
    let html = strip_html_comments(&html);
    // add the doctype markup. Yew doesn't like to render this.
    let html = format!("<!DOCTYPE html>\n{html}");
    Ok(HttpResponse::Ok()
        .content_type("text/html; charset=utf-8")
        .body(html))
}

/// Render a Yew view to send out in an Actix Response for a Turbo Stream
pub async fn render_turbo_stream<V, VM, E>(args: VM) -> Result<HttpResponse, E>
where
    V: BaseComponent,
    V: BaseComponent<Properties = VM>,
    VM: Send + 'static,
{
    let renderer = ServerRenderer::<V>::with_props(|| args);
    let html = renderer.render().await;
    let html = strip_html_comments(&html);
    Ok(HttpResponse::Ok()
        .content_type("text/vnd.turbo-stream.html")
        .body(html))
}

/// Render a Yew view to send out in an Actix Response for a Turbo Stream
/// return the full contents from YEW without stripping comments
pub async fn render_turbo_stream_full<V, VM, E>(args: VM) -> Result<HttpResponse, E>
where
    V: BaseComponent,
    V: BaseComponent<Properties = VM>,
    VM: Send + 'static,
{
    let renderer = ServerRenderer::<V>::with_props(|| args);
    let html = renderer.render().await;
    Ok(HttpResponse::Ok()
        .content_type("text/vnd.turbo-stream.html")
        .body(html))
}

/// Render a Yew view to send out in an Actix Response
/// Used when a form is not valid
pub fn redirect<E>(path: impl Into<String>) -> Result<HttpResponse, E> {
    let path: String = app_path(path);
    Ok(HttpResponse::SeeOther()
        .insert_header(("Location", path))
        .finish())
}

/// Simple little function to remove HTML comments for the YEW render
fn strip_html_comments(input: &str) -> String {
    // (?s) enables "dot matches newline"
    let re = Regex::new(r"(?s)<!--.*?-->").unwrap();
    re.replace_all(input, "").into_owned()
}