rango-core 0.1.0

Core of the Rango web framework: models, routing, views, forms, and the request pipeline
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

//! Views: request handlers and response helpers.

use askama::Template;
use axum::{
    response::{Html, IntoResponse, Redirect},
    routing::{MethodRouter, get},
};
use serde::Serialize;

use crate::error::Error;

pub use axum::extract::Json;

/// Incoming axum request.
pub type Request = axum::extract::Request;
/// Outgoing axum response.
pub type Response = axum::response::Response;

/// HTML response with the given body.
pub fn html(body: impl Into<String>) -> Response {
    Html(body.into()).into_response()
}

/// JSON response from a serializable value.
pub fn json(data: impl Serialize) -> Response {
    Json(data).into_response()
}

/// HTML response from rendering an askama template.
pub fn render<T: Template>(template: T) -> Result<Response, Error> {
    Ok(Html(template.render()?).into_response())
}

/// Redirect response to the given location.
pub fn redirect(to: &str) -> Response {
    Redirect::to(to).into_response()
}

/// A request handler producing a response or an error.
pub trait View: Clone + Send + Sync + 'static {
    /// Run this view against the request.
    fn call(self, req: Request) -> Result<Response, Error>;
}

impl<F> View for F
where
    F: Fn(Request) -> Result<Response, Error> + Clone + Send + Sync + 'static,
{
    fn call(self, req: Request) -> Result<Response, Error> {
        self(req)
    }
}

/// Axum method router for a view closure.
pub fn get_view<V: View>(view: V) -> MethodRouter {
    get(move |req: Request| async move { view.call(req).into_response() })
}