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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Basic acton-htmx server example
//!
//! Demonstrates:
//! - Configuration loading
//! - Observability initialization
//! - Application state creation with agent runtime
//! - Session middleware integration
//! - Basic HTMX handler
//!
//! Run with: `cargo run --example basic_server`

use acton_htmx::{observability, prelude::*};
use acton_reactive::prelude::ActonApp;
use axum::{extract::State, routing::get, Router};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Initialize observability (logging, tracing)
    observability::init()?;

    tracing::info!("Starting acton-htmx basic server");

    // Launch the Acton runtime - keep ownership in main for shutdown orchestration
    let mut runtime = ActonApp::launch();

    // Create application state (spawns session manager agent)
    let state = ActonHtmxState::new(&mut runtime).await?;

    tracing::info!(
        timeout_ms = state.config().htmx.request_timeout_ms,
        csrf_enabled = state.config().security.csrf_enabled,
        "Configuration loaded"
    );

    // Build router with HTMX routes and session middleware
    let app = Router::new()
        .route("/", get(index))
        .route("/about", get(about))
        .layer(SessionLayer::new(&state))
        .with_state(state);

    // Start server
    let listener = tokio::net::TcpListener::bind("127.0.0.1:3000").await?;
    tracing::info!("Server listening on http://127.0.0.1:3000");

    axum::serve(listener, app).await?;

    // Shutdown the agent runtime after server stops
    runtime.shutdown_all().await?;

    Ok(())
}

/// Index handler - demonstrates HxRequest extractor
async fn index(State(state): State<ActonHtmxState>, HxRequest(is_htmx): HxRequest) -> &'static str {
    tracing::debug!(
        is_htmx,
        timeout_ms = state.config().htmx.request_timeout_ms,
        "Handling index request"
    );

    if is_htmx {
        // Return partial for HTMX requests
        "<div id=\"content\">
    <h1>Welcome to acton-htmx!</h1>
    <p>This is a partial response (HTMX request detected).</p>
    <a href=\"/about\" hx-get=\"/about\" hx-target=\"#content\">About</a>
</div>"
    } else {
        // Return full page for normal requests
        "<!DOCTYPE html>
<html>
<head>
    <title>acton-htmx Example</title>
    <script src=\"https://unpkg.com/htmx.org@1.9.10\"></script>
</head>
<body>
    <div id=\"content\">
        <h1>Welcome to acton-htmx!</h1>
        <p>This is a full page response.</p>
        <a href=\"/about\" hx-get=\"/about\" hx-target=\"#content\">About</a>
    </div>
</body>
</html>"
    }
}

/// About handler - demonstrates basic HTMX pattern
async fn about(HxRequest(is_htmx): HxRequest) -> &'static str {
    tracing::debug!(is_htmx, "Handling about request");

    if is_htmx {
        "<div id=\"content\">
    <h1>About acton-htmx</h1>
    <p>A production-grade Rust web framework for HTMX applications.</p>
    <a href=\"/\" hx-get=\"/\" hx-target=\"#content\">Home</a>
</div>"
    } else {
        "<!DOCTYPE html>
<html>
<head>
    <title>About - acton-htmx</title>
    <script src=\"https://unpkg.com/htmx.org@1.9.10\"></script>
</head>
<body>
    <div id=\"content\">
        <h1>About acton-htmx</h1>
        <p>A production-grade Rust web framework for HTMX applications.</p>
        <a href=\"/\" hx-get=\"/\" hx-target=\"#content\">Home</a>
    </div>
</body>
</html>"
    }
}