sigil-stitch 0.3.0

Type-safe, import-aware, width-aware code generation for multiple languages
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

use sigil_stitch::code_block::CodeBlock;
use sigil_stitch::lang::javascript::JavaScript;
use sigil_stitch::spec::field_spec::FieldSpec;
use sigil_stitch::spec::file_spec::FileSpec;
use sigil_stitch::spec::fun_spec::FunSpec;
use sigil_stitch::spec::modifiers::{TypeKind, Visibility};
use sigil_stitch::spec::parameter_spec::ParameterSpec;
use sigil_stitch::spec::type_spec::TypeSpec;
use sigil_stitch::type_name::TypeName;

use super::golden;

/// Shorthand for a JS parameter (no type annotation).
fn param(name: &str) -> ParameterSpec {
    ParameterSpec::new(name, TypeName::primitive("")).unwrap()
}

/// Shorthand for a JS field (no type annotation).
fn field(name: &str) -> FieldSpec {
    FieldSpec::builder(name, TypeName::primitive(""))
        .build()
        .unwrap()
}

#[test]
fn test_full_module() {
    let event_emitter = TypeName::importable("events", "EventEmitter");
    let uuid = TypeName::importable("uuid", "v4");

    // EventBus class extending EventEmitter.
    let ctor_body = CodeBlock::of("super();\nthis.#handlers = new Map();", ()).unwrap();
    let pub_body = CodeBlock::of(
        "const id = %T();\nthis.emit(event, data);\nreturn id;",
        (uuid,),
    )
    .unwrap();

    let ts = TypeSpec::builder("EventBus", TypeKind::Class)
        .visibility(Visibility::Public)
        .extends(TypeName::primitive("EventEmitter"))
        .doc("Application event bus.")
        .add_field(field("#handlers"))
        .add_method(
            FunSpec::builder("constructor")
                .body(ctor_body)
                .build()
                .unwrap(),
        )
        .add_method(
            FunSpec::builder("publish")
                .add_param(param("event"))
                .add_param(param("data"))
                .body(pub_body)
                .build()
                .unwrap(),
        )
        .build()
        .unwrap();

    // Trigger EventEmitter import.
    let import_trigger = CodeBlock::of("// extends %T", (event_emitter,)).unwrap();

    // Standalone exported function.
    let create_body = CodeBlock::of("return new EventBus();", ()).unwrap();
    let create = FunSpec::builder("createEventBus")
        .visibility(Visibility::Public)
        .body(create_body)
        .build()
        .unwrap();

    let file = FileSpec::builder_with("event-bus.js", JavaScript::new())
        .add_code(import_trigger)
        .add_type(ts)
        .add_function(create)
        .build()
        .unwrap();
    let output = file.render(80).unwrap();

    golden::assert_golden("javascript/full_module.js", &output);
}