ohkami 0.24.9

A performant, declarative, and runtime-flexible web framework for Rust
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

use super::IntoContent;
use std::borrow::Cow;

#[cfg(feature = "openapi")]
use crate::openapi;

/// # HTML format
///
/// ## Request
///
/// not supported
///
/// ## Response
///
/// - content type: `text/html; charset=UTF-8`
/// - schema bound: `Into<Cow<'static, str>>`
///
/// note: This doesn't validate the content to be a valid HTML document,
/// it just sets the content type to `text/html` and returns the content as is.
///
/// ### example
///
/// ```
/// use ohkami::claw::content::Html;
///
/// async fn handler() -> Html<&'static str> {
///     Html(r#"
///         <html>
///             <head>
///                 <title>Sample Document</title>
///             </head>
///             <body>
///                 <h1>Sample Document</h1>
///             </body>
///         </html>
///     "#)
/// }
/// ```
pub struct Html<T = String>(pub T);

impl<T: Into<Cow<'static, str>>> IntoContent for Html<T> {
    const CONTENT_TYPE: &'static str = "text/html; charset=UTF-8";

    fn into_content(self) -> Result<Cow<'static, [u8]>, impl std::fmt::Display> {
        Result::<_, std::convert::Infallible>::Ok(match self.0.into() {
            Cow::Owned(s) => Cow::Owned(s.into_bytes()),
            Cow::Borrowed(s) => Cow::Borrowed(s.as_bytes()),
        })
    }

    #[cfg(feature = "openapi")]
    fn openapi_responsebody() -> impl Into<openapi::schema::SchemaRef> {
        openapi::string()
    }
}