xidl-parser 0.44.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

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 XCDR1")),
        Some(Pragma::XidlcVersion(SerializeVersion::Xcdr1))
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc XCDR2")),
        Some(Pragma::XidlcVersion(SerializeVersion::Xcdr2))
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc serialize(plain_cdr2)")),
        Some(Pragma::XidlcSerialize(SerializeKind::PlainCdr2))
    ));
    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 XCDR1".to_string())),
        })
        .is_none()
    );
    assert!(parse_xidlc_pragma(&pragma("other XCDR1")).is_none());
    assert!(parse_xidlc_pragma(&pragma("xidlc")).is_none());
    assert!(parse_xidlc_pragma(&pragma("xidlc package")).is_none());
    assert!(parse_xidlc_pragma(&pragma("xidlc openapi")).is_none());
    assert!(parse_xidlc_pragma(&pragma("xidlc service")).is_none());
    assert!(parse_xidlc_pragma(&pragma("xidlc serialize(unknown)")).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 parses_all_serialize_kinds_and_invalid_openapi_tokens() {
    for (name, kind) in [
        ("CDR", SerializeKind::Cdr),
        ("PLAIN_CDR", SerializeKind::PlainCdr),
        ("PL_CDR", SerializeKind::PlCdr),
        ("PLAIN_CDR2", SerializeKind::PlainCdr2),
        ("DELIMITED_CDR", SerializeKind::DelimitedCdr),
        ("PL_CDR2", SerializeKind::PlCdr2),
    ] {
        assert!(matches!(
            parse_xidlc_pragma(&pragma(&format!("xidlc serialize({name})"))),
            Some(Pragma::XidlcSerialize(value)) if std::mem::discriminant(&value) == std::mem::discriminant(&kind)
        ));
    }
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc serialize(XCDR1)")),
        Some(Pragma::XidlcVersion(SerializeVersion::Xcdr1))
    ));
    assert!(matches!(
        parse_xidlc_pragma(&pragma("xidlc serialize(XCDR2)")),
        Some(Pragma::XidlcVersion(SerializeVersion::Xcdr2))
    ));

    assert!(parse_xidlc_pragma(&pragma("xidlc openapi unknown value")).is_none());
}