2 releases
0.1.1 | Sep 23, 2024 |
---|---|
0.1.0 | Sep 23, 2024 |
#1393 in HTTP server
33 downloads per month
53KB
961 lines
modi
An out-of-the-box modular dependency injection web application framework.
Install
Run the following Cargo command in your project directory:
cargo add modi
Or add the following line to your Cargo.toml:
modi = "0.1.0"
Example
#![allow(missing_docs)]
use modi::prelude::*;
use std::sync::Arc;
#[tokio::main]
async fn main() {
new_app![Calculate]
.with_component_parameters::<Calculate>(CalculateParameters { state: 1 })
.run()
.await;
}
pub trait Service: Interface {
fn add(&self, left: i64, right: i64) -> i64;
}
#[derive(Component)]
#[modi(interface = Service)]
#[derive(Clone)]
pub struct Calculate {
state: i64,
}
impl Interface for Calculate {
fn manifest(&self) -> Manifest {
Manifest::default()
.with_name("Calculate".to_owned())
.with_summary("Calculate. For example, addition.".to_owned())
}
fn route(self: Arc<Self>, blank_router: Router) -> Router {
blank_router
.path("calculate")
.push(Router::with_path("add1").get(self.add1()))
.push(Router::with_path("add2").get(self.add2()))
.push(Router::with_path("add3").get(Self::add3()))
}
}
impl Service for Calculate {
fn add(&self, left: i64, right: i64) -> i64 {
{ self.state + left + right }
.instrument(info_span!("add"))
.into_inner()
}
}
#[craft]
impl Calculate {
/// doc line 1
/// doc line 2
#[craft(handler)]
fn add1(&self, left: QueryParam<i64, true>, right: QueryParam<i64, true>) -> String {
self.add(*left, *right).to_string()
}
/// doc line 3
/// doc line 4
#[craft(endpoint)]
pub(crate) fn add2(
self: ::std::sync::Arc<Self>,
left: QueryParam<i64, true>,
right: QueryParam<i64, true>,
) -> String {
self.add(*left, *right).to_string()
}
/// doc line 5
/// doc line 6
#[craft(endpoint(responses((status_code = 400, description = "Wrong request parameters."))))]
pub fn add3(left: QueryParam<i64, true>, right: QueryParam<i64, true>) -> String {
(*left + *right).to_string()
}
}
Browse http://localhost:8888/swagger-ui
and open the OpenAPI online test.
Dependencies
~34–48MB
~778K SLoC