elif-openapi 0.2.1

OpenAPI 3.0 specification generation for elif.rs 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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

/*!
OpenAPI schema generation traits and utilities.

This module provides traits and utilities for OpenAPI schema generation from Rust types.
The derive macro implementation would be in a separate proc-macro crate.
*/

/// Trait for types that can generate OpenAPI schemas
pub trait OpenApiSchema {
    /// Generate OpenAPI schema for this type
    fn openapi_schema() -> crate::specification::Schema;

    /// Get the schema name/title
    fn schema_name() -> String;
}

// Implementation would go here for procedural macros
// This is simplified for the demo version

// Manual implementations for common types
impl OpenApiSchema for String {
    fn openapi_schema() -> crate::specification::Schema {
        crate::specification::Schema {
            schema_type: Some("string".to_string()),
            ..Default::default()
        }
    }

    fn schema_name() -> String {
        "String".to_string()
    }
}

impl OpenApiSchema for i32 {
    fn openapi_schema() -> crate::specification::Schema {
        crate::specification::Schema {
            schema_type: Some("integer".to_string()),
            format: Some("int32".to_string()),
            ..Default::default()
        }
    }

    fn schema_name() -> String {
        "i32".to_string()
    }
}

impl OpenApiSchema for i64 {
    fn openapi_schema() -> crate::specification::Schema {
        crate::specification::Schema {
            schema_type: Some("integer".to_string()),
            format: Some("int64".to_string()),
            ..Default::default()
        }
    }

    fn schema_name() -> String {
        "i64".to_string()
    }
}

impl OpenApiSchema for bool {
    fn openapi_schema() -> crate::specification::Schema {
        crate::specification::Schema {
            schema_type: Some("boolean".to_string()),
            ..Default::default()
        }
    }

    fn schema_name() -> String {
        "bool".to_string()
    }
}

impl<T: OpenApiSchema> OpenApiSchema for Option<T> {
    fn openapi_schema() -> crate::specification::Schema {
        let mut schema = T::openapi_schema();
        schema.nullable = Some(true);
        schema
    }

    fn schema_name() -> String {
        format!("Option<{}>", T::schema_name())
    }
}

impl<T: OpenApiSchema> OpenApiSchema for Vec<T> {
    fn openapi_schema() -> crate::specification::Schema {
        crate::specification::Schema {
            schema_type: Some("array".to_string()),
            items: Some(Box::new(T::openapi_schema())),
            ..Default::default()
        }
    }

    fn schema_name() -> String {
        format!("Vec<{}>", T::schema_name())
    }
}