volga 0.9.1

Easy & Fast 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
87
88
89
90
91
92
93
94
95
96
97
98
99

//! # Volga
//!
//! > Fast, simple, and high-performance web framework for Rust, built on top of [Tokio](https://tokio.rs/) and [hyper](https://hyper.rs/).
//!
//! ## Features
//! * Supports HTTP/1 and HTTP/2
//! * Robust routing
//! * Custom middlewares
//! * Dependency Injection
//! * WebSockets and WebSocket-over-HTTP/2
//! * Full [Tokio](https://tokio.rs/) compatibility
//! * Runs on stable Rust 1.90+
//!
//! ## Example
//! ```no_run
//! use volga::*;
//!
//! #[tokio::main]
//! async fn main() -> std::io::Result<()> {
//!     // Start the server
//!     let mut app = App::new();
//!
//!     // Example of a request handler
//!     app.map_get("/hello/{name}", async |name: String| {
//!          ok!("Hello {name}!")
//!     });
//!     
//!     app.run().await
//! }
//! ```

mod server;

pub mod app;
#[cfg(any(feature = "basic-auth", feature = "jwt-auth"))]
pub mod auth;
#[cfg(feature = "config")]
pub mod config;

#[cfg(feature = "di")]
pub mod di;
pub mod error;
pub mod fs;
#[cfg(feature = "__fuzzing")]
#[doc(hidden)]
pub mod fuzzing;
pub mod headers;
pub mod http;
pub mod json;
pub mod limits;
#[cfg(feature = "middleware")]
pub mod middleware;
#[cfg(feature = "openapi")]
pub mod openapi;
#[cfg(feature = "rate-limiting")]
pub mod rate_limiting;
#[cfg(any(test, feature = "test"))]
pub mod test;
#[cfg(feature = "tls")]
pub mod tls;
#[cfg(feature = "tracing")]
pub mod tracing;
pub mod utils;
#[cfg(feature = "ws")]
pub mod ws;

pub use crate::app::App;
pub use crate::http::{
    BoxBody, HttpBody, HttpRequest, HttpResponse, HttpResult, UnsyncBoxBody,
    endpoints::args::{
        byte_stream::ByteStream,
        cancellation_token::CancellationToken,
        client_ip::ClientIp,
        file::File,
        form::Form,
        json::Json,
        path::{NamedPath, Path},
        query::Query,
    },
};

#[cfg(feature = "config")]
pub use config::{Config, ConfigBuilder};

#[cfg(feature = "middleware")]
pub use http::HttpRequestMut;

pub use limits::Limit;

#[cfg(feature = "multipart")]
pub use crate::http::endpoints::args::multipart::Multipart;

/// Route mapping helpers
pub mod routing {
    pub use crate::app::router::{Route, RouteGroup};
}

#[doc(hidden)]
pub use async_stream as __async_stream;