summer-web 0.5.0

Integration of rust application framework summer-rs and Axum web framework
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

use crate::Router;

pub use inventory::submit;

/// TypeHandler is used to configure the summer-macro marked route handler
pub trait TypedHandlerRegistrar: Send + Sync + 'static {
    /// install route
    fn install_route(&self, router: Router) -> Router;
}

/// Add typed routes marked with procedural macros
pub trait TypeRouter {
    /// Add typed routes marked with procedural macros
    fn typed_route<F: TypedHandlerRegistrar>(self, factory: F) -> Self;
}

impl TypeRouter for Router {
    fn typed_route<F: TypedHandlerRegistrar>(self, factory: F) -> Self {
        factory.install_route(self)
    }
}

inventory::collect!(&'static dyn TypedHandlerRegistrar);

/// auto_config
#[macro_export]
macro_rules! submit_typed_handler {
    ($ty:ident) => {
        ::summer_web::handler::submit! {
            &$ty as &dyn ::summer_web::handler::TypedHandlerRegistrar
        }
    };
}

#[cfg(feature = "socket_io")]
#[macro_export]
macro_rules! submit_socketio_handler {
    ($ty:ident) => {
        ::summer_web::handler::submit! {
            &$ty as &dyn ::summer_web::handler::SocketIOHandlerRegistrar
        }
    };
}

/// auto_config
pub fn auto_router() -> Router {
    #[cfg(feature = "openapi")]
    crate::enable_openapi();

    let mut router = Router::new();
    for handler in inventory::iter::<&dyn TypedHandlerRegistrar> {
        router = handler.install_route(router);
    }
    router
}

#[cfg(feature = "socket_io")]
pub trait SocketIOHandlerRegistrar: Send + Sync + 'static {
    fn install_socketio_handlers(&self, socket: &crate::socketioxide::extract::SocketRef);
}

#[cfg(feature = "socket_io")]
inventory::collect!(&'static dyn SocketIOHandlerRegistrar);

#[cfg(feature = "socket_io")]
pub fn auto_socketio_setup(socket: &crate::socketioxide::extract::SocketRef) {
    for handler in inventory::iter::<&dyn SocketIOHandlerRegistrar> {
        handler.install_socketio_handlers(socket);
    }
}