xidl-parser 0.72.0

A IDL codegen.
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
100
101
102
103
104
105

use super::*;
use crate::typed_ast::{PreprocArg, PreprocCall, PreprocDirective};

fn pragma(argument: &str) -> PreprocCall {
    PreprocCall {
        directive: PreprocDirective("#pragma".to_string()),
        argument: Some(PreprocArg(argument.to_string())),
    }
}

#[test]
fn parses_supported_xidlc_pragmas() {
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc package \"demo.pkg\"")),
        Some(Pragma::XidlcPackage(value)) if value == "demo.pkg"
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc version '3.1.0'")),
        Some(Pragma::XidlcOpenApiVersion(value)) if value == "3.1.0"
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc service \"https://demo.test\" \"Demo API\"")),
        Some(Pragma::XidlcOpenApiService { base_url, description })
            if base_url == "https://demo.test" && description.as_deref() == Some("Demo API")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc service https://demo.test Demo")),
        Some(Pragma::XidlcOpenApiService { base_url, description })
            if base_url == "https://demo.test" && description.as_deref() == Some("Demo")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc openapi version \"3.0.3\"")),
        Some(Pragma::XidlcOpenApiVersion(value)) if value == "3.0.3"
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc openapi service https://demo.test")),
        Some(Pragma::XidlcOpenApiService { base_url, description })
            if base_url == "https://demo.test" && description.is_none()
    ));
}

#[test]
fn rejects_non_xidlc_or_incomplete_pragmas() {
    assert!(
        parse_xidlc_pragma(&PreprocCall {
            directive: PreprocDirective("#define".to_string()),
            argument: Some(PreprocArg("xidlc package demo".to_string())),
        })
        .is_none()
    );
    assert!(matches!(
        parse_xidlc_pragma(&pragma("other package demo")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("other package demo")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc package")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc package")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc openapi")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc openapi")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc service")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc service")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc unknown(value)")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc unknown(value)")
    ));
    assert!(matches!(
        parse_xidlc_pragma(&PreprocCall {
            directive: PreprocDirective("#pragma".to_string()),
            argument: None,
        }),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.is_none()
    ));
}

#[test]
fn trims_quoted_and_unquoted_values() {
    assert_eq!(trim_pragma_value("\"demo\""), "demo");
    assert_eq!(trim_pragma_value("'demo'"), "demo");
    assert_eq!(trim_pragma_value(" demo "), "demo");
}

#[test]
fn rejects_invalid_openapi_tokens() {
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc openapi unknown value")),
        Some(Pragma::Custom(CustomPragma { directive, argument }))
            if directive == "#pragma" && argument.as_deref() == Some("xidlc openapi unknown value")
    ));
}