Macros Rust

Runique fournit un ensemble de macros pour simplifier le développement.

Macros de contexte

Macro	Description	Exemple
`context!`	Créer un contexte Tera	`context!("title" => "Page", "count" => 3)`
`context_update!`	Ajouter au contexte d'une Request	`context_update!(request => { "key" => value })`

Macros flash messages

Macro	Description	Exemple
`success!`	Message de succès (session)	`success!(request.notices => "OK !")`
`error!`	Message d'erreur (session)	`error!(request.notices => "Erreur")`
`info!`	Message info (session)	`info!(request.notices => "Info")`
`warning!`	Avertissement (session)	`warning!(request.notices => "Attention")`
`flash_now!`	Message(s) immédiat(s), sans session	`flash_now!(error => "Erreur")`, ou plusieurs : `flash_now!(warning => "Un", "Deux")`

Macros de routage

Macro	Description	Exemple
`urlpatterns!`	Définir des routes avec noms	`urlpatterns!("/" => view!{...}, name = "index")`
`view!`	Handler pour toutes méthodes HTTP (GET, POST, PUT, DELETE, PATCH)	`view!{ handler }`

Pour une route qui ne doit accepter qu'une méthode, passez le routeur d'Axum à la place de view! : "/logout" => post(views::logout), name = "logout".

Macros ORM

Macro	Description	Exemple
`impl_objects!`	Manager Django-like (`Entity::objects.filter(...)`)	`impl_objects!(Entity)`

model!{} génère déjà ce manager : impl_objects! ne sert qu'à une entité SeaORM écrite à la main. Voir ORM.

Macros d'erreur

Macro	Description
`impl_from_error!`	Génère `From<Error>` pour `AppError`

En situation

Les macros se combinent dans un handler typique :

use runique::prelude::*;

pub async fn contact(mut request: Request) -> AppResult<Response> {
    let form: ContactForm = request.form("my_form");

    let form = match ValidationForm::try_form(form, &request).await {
        Ok(_validated) => {
            // Flash en session + redirection (pattern Post/Redirect/Get)
            success!(request.notices => "Message envoyé !");
            return Ok(Redirect::to("/contact").into_response());
        }
        Err(form) => form,
    };

    // Ajoute des variables au contexte de la requête
    context_update!(request => {
        "title" => "Contact",
        "contact_form" => &form,
    });
    request.render("contact.html")
}

success! / error! / info! / warning! écrivent en session (visibles après redirection). flash_now! produit un message immédiat sans session — utile quand on réaffiche la même page sans rediriger.