soothfast-sdk 0.1.0

Soothfast SDK engine: native client emitters (Python/TypeScript) over the spec IR
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

//! Wire names → Python identifiers.

pub(crate) use crate::naming::snake;

/// snake_case plus keyword escaping, for attribute positions.
pub(crate) fn snake_attr(wire: &str) -> String {
    escape_keyword(&snake(wire))
}

/// Append an underscore to Python keywords so the name stays legal.
pub(crate) fn escape_keyword(name: &str) -> String {
    const KEYWORDS: &[&str] = &[
        "False", "None", "True", "and", "as", "assert", "async", "await", "break", "class",
        "continue", "def", "del", "elif", "else", "except", "finally", "for", "from", "global",
        "if", "import", "in", "is", "lambda", "nonlocal", "not", "or", "pass", "raise", "return",
        "try", "while", "with", "yield",
    ];
    if KEYWORDS.contains(&name) {
        format!("{name}_")
    } else {
        name.to_string()
    }
}

/// A wire name as a legal Python identifier, changed as little as possible.
pub(crate) fn sanitize_ident(wire: &str) -> String {
    escape_keyword(&crate::naming::sanitize(wire))
}

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

    #[test]
    fn keywords_gain_a_trailing_underscore() {
        assert_eq!(snake_attr("from"), "from_");
        assert_eq!(snake_attr("class"), "class_");
        assert_eq!(snake_attr("type"), "type");
    }

    #[test]
    fn sanitize_ident_keeps_the_wire_spelling_where_it_is_legal() {
        assert_eq!(sanitize_ident("logoUrl"), "logoUrl");
        assert_eq!(sanitize_ident("Retry-After"), "Retry_After");
        assert_eq!(sanitize_ident("lambda"), "lambda_");
    }
}