rejoice 0.10.0

A simple and delightful little web framework for Rust
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

mod app;
pub mod codegen;
#[cfg(feature = "sqlite")]
pub mod db;
pub mod env;
mod island;
mod request;
mod response;

// Re-export dotenvy for the env! macro
#[doc(hidden)]
pub use dotenvy_macro;

// Core types
pub use app::App;
pub use request::Req;
pub use response::Res;

// Axum extractors that are still useful
pub use axum::extract::Path;

// Re-export axum types needed by generated code
#[doc(hidden)]
pub use axum::extract::State;
#[doc(hidden)]
pub use axum::{Router, routing};

// Island support
pub use island::island_fn;

// HTML/Maud - flattened to root level
pub use maud::{html, Markup, DOCTYPE, PreEscaped};

// JSON
pub use serde_json::json;

// Type alias for layout children
pub type Children = Markup;

/// Read an environment variable at compile time from .env file.
/// Re-exports dotenvy_macro::dotenv.
#[macro_export]
macro_rules! env {
    ($key:expr) => {
        $crate::dotenvy_macro::dotenv!($key)
    };
}

/// Marker type for stateless apps.
/// This is distinct from `()` to avoid trait impl conflicts.
#[doc(hidden)]
#[derive(Clone, Copy)]
pub struct NoState;

/// Include the generated routes and create_router() function.
/// Call this at the top level of your main.rs.
///
/// Usage:
/// - `routes!()` - for apps without state
/// - `routes!(AppState)` - for apps with custom state type
#[macro_export]
macro_rules! routes {
    () => {
        #[allow(dead_code)]
        type __RejoiceState = rejoice::NoState;
        include!(concat!(env!("OUT_DIR"), "/routes_generated_stateless.rs"));
    };
    ($state:ty) => {
        #[allow(dead_code)]
        type __RejoiceState = $state;
        include!(concat!(env!("OUT_DIR"), "/routes_generated_stateful.rs"));
    };
}

/// Prelude module for convenient imports.
///
/// ```rust
/// use rejoice::prelude::*;
/// ```
pub mod prelude {
    pub use crate::{
        html, island, json, App, Children, Markup, Path, PreEscaped, Req, Res, DOCTYPE,
    };
}