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

pub use ::axum::handler::Handler as AxumHandler;
pub use ::axum::http::Method;

/// A trait that represents a handler metadata.
/// 
/// They are used to store the metadata of a handler,
/// and are automatically implemented by the `#[get]`, `#[post]`, etc. macros.
/// 
/// This trait is used internally by Catalyzer, and should not be implemented manually.
/// 
/// With `#[get]`:
/// 
/// ```rust
/// # use catalyzer::*;
/// #[get("/")]
/// fn index() {
///     "Hello, world!"
/// }
/// ```
/// 
/// Manual implementation:
/// 
/// ```rust
/// # use catalyzer::*;
/// async fn index() -> impl ::catalyzer::res::IntoRawResponse {
///     "Hello, world!"
/// }
/// #[doc(hidden)]
/// #[repr(transparent)]
/// #[allow(non_camel_case_types)]
/// struct index_metadata;
/// impl ::catalyzer::internals::HandlerMetadata for index_metadata {
///     const PATH: &'static str = "/";
///     const METHOD: ::catalyzer::internals::Method = ::catalyzer::internals::Method::GET;
/// }
/// ```
pub trait HandlerMetadata {
    /// Path to mount the handler on.
    const PATH: &'static str;
    /// Method to handle.
    const METHOD: Method;
}