acton-htmx 1.0.0-beta.7

Opinionated Rust web framework for HTMX applications
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
58
59
60
61
62

//! Framework template system with XDG-compliant storage
//!
//! This module provides runtime-loadable templates for framework-generated HTML
//! (forms, flash messages, validation errors, error pages, etc.).
//!
//! Templates are resolved in order:
//! 1. User customizations in `$XDG_CONFIG_HOME/acton-htmx/templates/framework/`
//! 2. Cached defaults in `$XDG_CACHE_HOME/acton-htmx/templates/framework/`
//! 3. Embedded fallbacks compiled into the binary
//!
//! # Example
//!
//! ```rust,no_run
//! use acton_htmx::template::framework::FrameworkTemplates;
//!
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! let templates = FrameworkTemplates::new()?;
//!
//! // Render a form input
//! let html = templates.render("forms/input.html", minijinja::context! {
//!     input_type => "text",
//!     name => "email",
//!     id => "email",
//! })?;
//! # Ok(())
//! # }
//! ```

mod loader;

pub use loader::{FrameworkTemplateError, FrameworkTemplates};

/// Names of all framework templates
pub const TEMPLATE_NAMES: &[&str] = &[
    // Forms
    "forms/form.html",
    "forms/field-wrapper.html",
    "forms/input.html",
    "forms/textarea.html",
    "forms/select.html",
    "forms/checkbox.html",
    "forms/radio-group.html",
    "forms/submit-button.html",
    "forms/help-text.html",
    "forms/label.html",
    "forms/csrf-input.html",
    // Validation
    "validation/field-errors.html",
    "validation/validation-summary.html",
    // Flash messages
    "flash/container.html",
    "flash/message.html",
    // HTMX
    "htmx/oob-wrapper.html",
    // Error pages
    "errors/400.html",
    "errors/401.html",
    "errors/403.html",
    "errors/404.html",
    "errors/422.html",
    "errors/500.html",
];