rustapi-core 0.1.450

The core engine of the RustAPI framework. Provides the hyper-based HTTP server, router, extraction logic, and foundational traits.
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

//! Auto-schema registration using linkme distributed slices
//!
//! This module enables zero-config OpenAPI schema registration.
//! Route macros can register schemas at link-time, and `RustApi::auto()`
//! will collect and apply them before serving docs.

use linkme::distributed_slice;

/// Distributed slice containing all auto-registered schema registration functions.
///
/// Each element is a function that takes a mutable reference to the current
/// [`rustapi_openapi::OpenApiSpec`] and registers one or more schemas.
#[distributed_slice]
pub static AUTO_SCHEMAS: [fn(&mut rustapi_openapi::OpenApiSpec)];

/// Apply all auto-registered schemas into the given OpenAPI spec.
pub fn apply_auto_schemas(spec: &mut rustapi_openapi::OpenApiSpec) {
    for f in AUTO_SCHEMAS.iter() {
        f(spec);
    }
}

/// Get the count of auto-registered schema registration functions.
#[allow(dead_code)]
pub fn auto_schema_count() -> usize {
    AUTO_SCHEMAS.len()
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_auto_schemas_slice_exists() {
        let _count = auto_schema_count();
    }

    #[test]
    fn test_apply_auto_schemas_does_not_panic() {
        let mut spec = rustapi_openapi::OpenApiSpec::new("Test", "0.0.0");
        apply_auto_schemas(&mut spec);
    }
}