capy-mail 0.10.0

Conventional SMTP mail, typed templates, and mail notifications for Capy.
Documentation
//! Opt-in engineering measurements, not SMTP/provider throughput guarantees.
use crate::*;
use askama::Template;
use std::time::Instant;
#[path = "../tests/support/mod.rs"]
mod support;

#[derive(Template)]
#[template(source = "<p>Hello {{ name }}</p>", ext = "html", askama = crate::askama)]
struct Example {
    name: &'static str,
}
impl Mailable for Example {
    const NAME: &'static str = "benchmark_mail";
    fn render(&self) -> MailResult<Mail> {
        Ok(Mail::new("Benchmark")
            .text("Hello Alice")
            .html(Template::render(self)?))
    }
}
impl QueueableMail for Example {}
fn content() -> Example {
    Example { name: "Alice" }
}
fn stats(mut samples: Vec<u128>) -> serde_json::Value {
    samples.sort_unstable();
    serde_json::json!({"samples":samples.len(), "mean_us":samples.iter().sum::<u128>() as f64 / samples.len() as f64 / 1000.0, "p50_us":samples[samples.len()/2] as f64 / 1000.0, "p95_us":samples[samples.len()*95/100] as f64 / 1000.0})
}
#[tokio::test]
#[ignore = "release engineering baseline; requires local Mailpit and disposable CAPY_MAIL_BENCH_POSTGRES_URL"]
async fn benchmark() {
    use capy_jobs::{Jobs, QueueName, Worker};
    use sea_orm_migration::{MigrationTrait, SchemaManager};
    let mut config = support::smtp_config();
    config.database.url = std::env::var("CAPY_MAIL_BENCH_POSTGRES_URL")
        .expect("Explicit disposable benchmark database required");
    let db = capy_db::connect(&config.database).await.unwrap();
    capy_jobs::migration::JobsMigration
        .up(&SchemaManager::new(&db))
        .await
        .unwrap();
    let mailer = Mailer::from_config(&config).unwrap();
    let ctx = capy_core::AppContext {
        config: Arc::new(config),
        db,
    };
    let worker = Worker::new(ctx.clone(), register_jobs(Jobs::new(), mailer.clone()))
        .unwrap()
        .queues(vec![QueueName::new("mail").unwrap()])
        .unwrap();
    let n = 100;
    let mut renders = Vec::new();
    let mut builds = Vec::new();
    let mut smtp = Vec::new();
    let mut enqueues = Vec::new();
    let mut deliveries = Vec::new();
    for _ in 0..n {
        let start = Instant::now();
        let mail = Mailable::render(&content()).unwrap();
        renders.push(start.elapsed().as_nanos());
        let start = Instant::now();
        std::hint::black_box(
            mailer
                .prepare(
                    Example::NAME,
                    mail.to("benchmark@example.test".parse().unwrap()),
                    None,
                )
                .unwrap(),
        );
        builds.push(start.elapsed().as_nanos());
        let start = Instant::now();
        mailer
            .send(content().to("benchmark@example.test").unwrap())
            .await
            .unwrap();
        smtp.push(start.elapsed().as_nanos());
        let start = Instant::now();
        mailer
            .queue(&ctx, content().to("benchmark@example.test").unwrap())
            .await
            .unwrap();
        enqueues.push(start.elapsed().as_nanos());
        let start = Instant::now();
        assert!(worker.run_next().await.unwrap());
        deliveries.push(start.elapsed().as_nanos());
    }
    println!(
        "{}",
        serde_json::json!({"profile":"release", "backend":"PostgreSQL", "template_render":stats(renders), "message_build":stats(builds), "smtp_local_send":stats(smtp), "queued_mail_enqueue":stats(enqueues), "queued_delivery_including_smtp":stats(deliveries)})
    );
    capy_jobs::migration::JobsMigration
        .down(&SchemaManager::new(&ctx.db))
        .await
        .unwrap();
}