17 releases (7 breaking)

Uses new Rust 2024

new 0.78.0 Apr 12, 2025
0.77.1 Mar 21, 2025
0.76.2 Feb 4, 2025
0.75.0 Dec 30, 2024
0.74.2 Nov 11, 2024

#29 in #salvo

Download history 12667/week @ 2024-12-21 16775/week @ 2024-12-28 13277/week @ 2025-01-04 17880/week @ 2025-01-11 16208/week @ 2025-01-18 7452/week @ 2025-01-25 25168/week @ 2025-02-01 6049/week @ 2025-02-08 18676/week @ 2025-02-15 42839/week @ 2025-02-22 23448/week @ 2025-03-01 22884/week @ 2025-03-08 23256/week @ 2025-03-15 24348/week @ 2025-03-22 20401/week @ 2025-03-29 23935/week @ 2025-04-05

96,454 downloads per month
Used in 3 crates (via salvo-craft)

MIT/Apache

18KB
224 lines

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

salvo-craft-macros

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_macros::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.5–6MB
~118K SLoC