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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

//! HTMX-specific assertion helpers for testing
//!
//! This module provides helper functions for asserting HTMX response headers
//! and behavior in integration tests.

use axum_test::TestResponse;

/// Assert that the response contains an HX-Redirect header with the expected path
///
/// # Panics
///
/// Panics if the header is missing or has a different value
///
/// # Example
///
/// ```rust,no_run
/// use acton_htmx::testing::{TestServer, assert_hx_redirect};
///
/// # async fn example() {
/// # let server = todo!();
/// let response = server.post("/login").await;
/// assert_hx_redirect(&response, "/dashboard");
/// # }
/// ```
pub fn assert_hx_redirect(response: &TestResponse, expected_path: &str) {
    let header = response
        .headers()
        .get("HX-Redirect")
        .expect("HX-Redirect header not found");
    let actual = header.to_str().expect("Invalid HX-Redirect header value");
    assert_eq!(
        actual, expected_path,
        "Expected HX-Redirect to {expected_path}, got {actual}"
    );
}

/// Assert that the response contains an HX-Trigger header with the expected event
///
/// # Panics
///
/// Panics if the header is missing or doesn't contain the event
///
/// # Example
///
/// ```rust,no_run
/// use acton_htmx::testing::{TestServer, assert_hx_trigger};
///
/// # async fn example() {
/// # let server = todo!();
/// let response = server.post("/create").await;
/// assert_hx_trigger(&response, "itemCreated");
/// # }
/// ```
pub fn assert_hx_trigger(response: &TestResponse, expected_event: &str) {
    let header = response
        .headers()
        .get("HX-Trigger")
        .expect("HX-Trigger header not found");
    let actual = header.to_str().expect("Invalid HX-Trigger header value");
    assert!(
        actual.contains(expected_event),
        "Expected HX-Trigger to contain '{expected_event}', got '{actual}'"
    );
}

/// Assert that the response contains an HX-Reswap header with the expected swap strategy
///
/// # Panics
///
/// Panics if the header is missing or has a different value
///
/// # Example
///
/// ```rust,no_run
/// use acton_htmx::testing::{TestServer, assert_hx_reswap};
///
/// # async fn example() {
/// # let server = todo!();
/// let response = server.get("/content").await;
/// assert_hx_reswap(&response, "outerHTML");
/// # }
/// ```
pub fn assert_hx_reswap(response: &TestResponse, expected_swap: &str) {
    let header = response
        .headers()
        .get("HX-Reswap")
        .expect("HX-Reswap header not found");
    let actual = header.to_str().expect("Invalid HX-Reswap header value");
    assert_eq!(
        actual, expected_swap,
        "Expected HX-Reswap to be {expected_swap}, got {actual}"
    );
}

/// Assert that the response contains an HX-Retarget header with the expected target
///
/// # Panics
///
/// Panics if the header is missing or has a different value
///
/// # Example
///
/// ```rust,no_run
/// use acton_htmx::testing::{TestServer, assert_hx_retarget};
///
/// # async fn example() {
/// # let server = todo!();
/// let response = server.get("/content").await;
/// assert_hx_retarget(&response, "#main");
/// # }
/// ```
pub fn assert_hx_retarget(response: &TestResponse, expected_target: &str) {
    let header = response
        .headers()
        .get("HX-Retarget")
        .expect("HX-Retarget header not found");
    let actual = header.to_str().expect("Invalid HX-Retarget header value");
    assert_eq!(
        actual, expected_target,
        "Expected HX-Retarget to be {expected_target}, got {actual}"
    );
}

/// Assert that the response contains an HX-Push-Url header
///
/// # Panics
///
/// Panics if the header is missing
///
/// # Example
///
/// ```rust,no_run
/// use acton_htmx::testing::{TestServer, assert_hx_push_url};
///
/// # async fn example() {
/// # let server = todo!();
/// let response = server.post("/create").await;
/// assert_hx_push_url(&response, Some("/items/123"));
/// # }
/// ```
pub fn assert_hx_push_url(response: &TestResponse, expected_url: Option<&str>) {
    let header = response
        .headers()
        .get("HX-Push-Url")
        .expect("HX-Push-Url header not found");
    let actual = header.to_str().expect("Invalid HX-Push-Url header value");

    if let Some(url) = expected_url {
        assert_eq!(
            actual, url,
            "Expected HX-Push-Url to be {url}, got {actual}"
        );
    } else {
        assert_eq!(
            actual, "false",
            "Expected HX-Push-Url to be false, got {actual}"
        );
    }
}

// Tests for assertion helpers require integration tests with actual TestServer
// See integration tests in tests/ directory for usage examples