kit_rs/
lib.rs

1pub mod config;
2pub mod container;
3pub mod database;
4pub mod error;
5pub mod http;
6pub mod inertia;
7pub mod middleware;
8pub mod routing;
9pub mod server;
10
11pub use config::{
12    env, env_optional, env_required, AppConfig, Config, Environment, ServerConfig,
13};
14pub use container::{App, Container};
15pub use database::{DatabaseConfig, DatabaseType, DbConnection, Model, ModelMut, DB};
16pub use error::FrameworkError;
17pub use http::{json, text, HttpResponse, Redirect, Request, Response, ResponseExt};
18pub use inertia::{InertiaConfig, InertiaContext, InertiaResponse};
19pub use middleware::{
20    register_global_middleware, Middleware, MiddlewareFuture, MiddlewareRegistry, Next,
21};
22pub use routing::{delete, get, post, put, route, GroupBuilder, GroupRouter, RouteBuilder, RouteDefBuilder, Router};
23pub use server::Server;
24
25// Re-export async_trait for middleware implementations
26pub use async_trait::async_trait;
27
28// Re-export inventory for #[service(ConcreteType)] macro
29#[doc(hidden)]
30pub use inventory;
31
32// Re-export for macro usage
33#[doc(hidden)]
34pub use serde_json;
35
36// Re-export serde for InertiaProps derive macro
37pub use serde;
38
39// Re-export the proc-macros for compile-time component validation and type safety
40pub use kit_macros::inertia_response;
41pub use kit_macros::injectable;
42pub use kit_macros::InertiaProps;
43pub use kit_macros::redirect;
44pub use kit_macros::service;
45
46#[macro_export]
47macro_rules! json_response {
48    ($($json:tt)+) => {
49        Ok($crate::HttpResponse::json($crate::serde_json::json!($($json)+)))
50    };
51}
52
53#[macro_export]
54macro_rules! text_response {
55    ($text:expr) => {
56        Ok($crate::HttpResponse::text($text))
57    };
58}
59
60/// Register global middleware that runs on every request
61///
62/// Global middleware is registered in `bootstrap.rs` and runs in registration order,
63/// before any route-specific middleware.
64///
65/// # Example
66///
67/// ```rust,ignore
68/// // In bootstrap.rs
69/// use kit::global_middleware;
70/// use crate::middleware;
71///
72/// pub fn register() {
73///     global_middleware!(middleware::LoggingMiddleware);
74///     global_middleware!(middleware::CorsMiddleware);
75/// }
76/// ```
77#[macro_export]
78macro_rules! global_middleware {
79    ($middleware:expr) => {
80        $crate::register_global_middleware($middleware)
81    };
82}
83
84/// Testing utilities for the application container
85///
86/// Provides `TestContainer` for setting up isolated test environments with
87/// fake implementations.
88pub mod testing {
89    pub use crate::container::testing::{TestContainer, TestContainerGuard};
90}