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

//! htmx middleware for Actix Web.
//!
//! `actix-htmx` provides a method of easily working with htmx in actix web applications.
//! Wrap services with [`HtmxMiddleware`] to enable htmx support, and access the [`HtmxDetails`]
//! extractor in your handlers to get information about the current htmx state. Helper methods also
//! exist to enable you to set htmx response headers, allowing easy triggering of htmx events from
//! server side code.
//!
//! # Getting Started
//! Register [`HtmxMiddleware`] on your `App`:
//!
//! ```no_run
//! use actix_htmx::{HtmxDetails, HtmxMiddleware, TriggerType};
//! use actix_web::{web, App, HttpResponse, HttpServer, Responder};
//!
//! #[actix_web::main]
//! async fn main() -> std::io::Result<()> {
//!     HttpServer::new(|| {
//!         App::new()
//!             .wrap(HtmxMiddleware)
//!             .service(web::resource("/").to(index))
//!     })
//!     .bind("0.0.0.0:8080")?
//!     .run()
//!     .await
//! }
//!
//! async fn index(htmx_details: HtmxDetails) -> impl Responder {
//!     if htmx_details.is_htmx {
//!         // build a partial view
//!     } else {
//!         // build a full view
//!     }
//!     htmx_details.trigger_event(
//!         "my_event".to_string(),
//!         r#"{"level": "info", "message": "my event message!"}"#.to_string(),
//!         TriggerType::Standard
//!     );
//!
//!     HttpResponse::Ok().content_type("text/html").body(// render the view)
//!
//! }
//! ```

mod headers;
mod htmx;
mod middleware;

pub use self::{
    htmx::{HtmxDetails, TriggerType},
    middleware::HtmxMiddleware,
};