15 releases (6 breaking)

Uses new Rust 2024

0.77.0 Mar 5, 2025
0.76.1 Jan 24, 2025
0.75.0 Dec 30, 2024
0.74.2 Nov 11, 2024

#393 in HTTP server

Download history 13863/week @ 2024-11-21 20333/week @ 2024-11-28 18371/week @ 2024-12-05 14973/week @ 2024-12-12 17561/week @ 2024-12-19 12692/week @ 2024-12-26 15096/week @ 2025-01-02 16718/week @ 2025-01-09 16821/week @ 2025-01-16 8952/week @ 2025-01-23 13160/week @ 2025-01-30 11049/week @ 2025-02-06 15691/week @ 2025-02-13 33910/week @ 2025-02-20 45869/week @ 2025-02-27 15944/week @ 2025-03-06

114,083 downloads per month
Used in 2 crates (via salvo)

MIT/Apache

9KB

Salvo is an extremely simple and powerful Rust web backend framework. Only basic Rust knowledge is required to develop backend services.

salvo-craft

Salvo Handler modular craft macros.

#[craft]

#[craft] is an attribute macro that converts methods in an impl block into Salvo's Handler implementations.

use salvo::oapi::extract::*;
use salvo::prelude::*;
use salvo_craft::craft;
use std::sync::Arc;

#[tokio::main]
async fn main() {
    let service = Arc::new(Service::new(1));
    let router = Router::new()
        .push(Router::with_path("add1").get(service.add1()))
        .push(Router::with_path("add2").get(service.add2()))
        .push(Router::with_path("add3").get(Service::add3()));
    let acceptor = TcpListener::new("127.0.0.1:5800").bind().await;
    Server::new(acceptor).serve(router).await;
}

#[derive(Clone)]
pub struct Service {
    state: i64,
}

#[craft]
impl Service {
    fn new(state: i64) -> Self {
        Self { state }
    }
    /// doc line 1
    /// doc line 2
    #[craft(handler)]
    fn add1(&self, left: QueryParam<i64>, right: QueryParam<i64>) -> String {
        (self.state + *left + *right).to_string()
    }
    /// doc line 3
    /// doc line 4
    #[craft(handler)]
    pub(crate) fn add2(
        self: ::std::sync::Arc<Self>,
        left: QueryParam<i64>,
        right: QueryParam<i64>,
    ) -> String {
        (self.state + *left + *right).to_string()
    }
    /// doc line 5
    /// doc line 6
    #[craft(handler)]
    pub fn add3(left: QueryParam<i64>, right: QueryParam<i64>) -> String {
        (*left + *right).to_string()
    }
}

Note: #[craft(handler)] can be replaced with #[craft(endpoint(...))] for more configuration options.

NOTE: When using &self as the method receiver, the containing type must implement the Clone trait.

Documentation & Resources

☕ Donate

Salvo is an open source project. If you want to support Salvo, you can ☕ buy me a coffee here.

⚠️ License

Salvo is licensed under either of

Dependencies

~4–6MB
~117K SLoC