spikard-cli 0.15.3

Command-line interface for building and validating Spikard applications
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

use anyhow::Result;
use openapiv3::{OpenAPI, ReferenceOr};
use spikard_cli::codegen::{OpenApiGenerator, SchemaRegistry};

struct DummyGenerator {
    spec: OpenAPI,
    registry: SchemaRegistry,
}

impl DummyGenerator {
    fn new(spec: OpenAPI) -> Self {
        Self {
            registry: SchemaRegistry::from_spec(&spec),
            spec,
        }
    }
}

impl OpenApiGenerator for DummyGenerator {
    fn spec(&self) -> &OpenAPI {
        &self.spec
    }

    fn registry(&self) -> &SchemaRegistry {
        &self.registry
    }

    fn generate_header(&self) -> String {
        "HEADER\n".to_string()
    }

    fn generate_models(&self) -> Result<String> {
        let mut names = Vec::new();
        self.iter_schemas(|name, _schema| {
            names.push(name.to_string());
            Ok(())
        })?;
        Ok(format!("MODELS:{}\n", names.join(",")))
    }

    fn generate_routes(&self) -> Result<String> {
        let mut ops = Vec::new();
        self.iter_paths(|path, method, operation| {
            ops.push(format!(
                "{}:{}:{}",
                method,
                path,
                self.generate_operation_id(path, method, operation)
            ));
            Ok(())
        })?;
        Ok(format!("ROUTES:{}\n", ops.join(",")))
    }

    fn default_response_type(&self) -> String {
        "unknown".to_string()
    }
}

#[test]
fn openapi_generator_trait_iterates_schemas_and_paths() {
    let spec: OpenAPI = serde_json::from_value(serde_json::json!({
        "openapi": "3.0.3",
        "info": { "title": "Test", "version": "1.0.0" },
        "components": {
            "schemas": {
                "User": { "type": "object", "properties": { "id": { "type": "string" } } }
            }
        },
        "paths": {
            "/users": {
                "get": { "operationId": "listUsers", "responses": { "200": { "description": "ok" } } }
            }
        }
    }))
    .expect("spec");

    assert!(matches!(
        spec.components.as_ref().unwrap().schemas["User"],
        ReferenceOr::Item(_)
    ));

    let generator = DummyGenerator::new(spec);
    let output = generator.generate().expect("generate");
    assert!(output.contains("HEADER"));
    assert!(output.contains("MODELS:User"));
    assert!(output.contains("get:/users:list_users"));
}