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

//!
//! `yarte`'s essence is the trait `Template`, with `fmt::Display` as a supertrait (you can have
//! access to `fmt::Display`). When rendering a template users can do it
//! using three different methods:
//! - `call` which will write template in the buffer of the `Template` object.
//!

use std::fmt::{self, Write};

pub use yarte_derive::Template;
pub use yarte_helpers::{helpers::MarkupAsStr, Error, Result};

pub mod rerun;

pub trait Template: fmt::Display {
    /// which will write template in the buffer of the `Template` object.
    fn call(&self) -> Result<String> {
        let mut buf = String::with_capacity(Self::size_hint());
        write!(buf, "{}", self).map(|_| buf)
    }

    /// https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types
    fn mime() -> &'static str
    where
        Self: Sized;

    /// Approximation of output size used in method `call`.
    /// Yarte implements an heuristic algorithm of allocation.
    fn size_hint() -> usize;
}

#[cfg(feature = "with-actix-web")]
pub mod actix_web {
    pub use actix_web::{
        error::ErrorInternalServerError, Error, HttpRequest, HttpResponse, Responder,
    };
}