alef 0.25.37

Opinionated polyglot binding generator for Rust libraries
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
106
107
108
109
110
111
112
113
114
115
116

use crate::backends::rustler::template_env;
use crate::core::ir::TypeDef;
use ahash::AHashMap;

/// Resolve the fully-qualified core path for a named type.
///
/// When the TypeDef is found in `types_by_name` its `rust_path` is used (which
/// may be `sample_core::extraction::docx::drawing::DrawingType`). When not found
/// (e.g. a type that doesn't appear in the API surface but is referenced as a
/// param type) the short fallback `{core_import}::{name}` is used.
pub(super) fn resolve_core_type_path<'a>(
    name: &str,
    types_by_name: &AHashMap<&'a str, &'a TypeDef>,
    core_import: &str,
) -> String {
    if let Some(typ) = types_by_name.get(name) {
        crate::codegen::conversions::core_type_path(typ, core_import)
    } else {
        format!("{core_import}::{name}")
    }
}

pub(super) fn render_deser_line(template_name: &str, name: &str, core_type: &str) -> String {
    template_env::render(
        template_name,
        minijinja::context! {
            name => name,
            core_type => core_type,
        },
    )
    .trim_end()
    .to_string()
}

pub(super) fn render_named_deser_line(template_name: &str, name: &str) -> String {
    template_env::render(
        template_name,
        minijinja::context! {
            name => name,
        },
    )
    .trim_end()
    .to_string()
}

pub(super) fn render_preamble(lines: &[String]) -> String {
    if lines.is_empty() {
        String::new()
    } else {
        format!("{}\n    ", lines.join("\n    "))
    }
}

pub(super) fn render_result_body(preamble: &str, core_call: &str, wrap: &str) -> String {
    template_env::render(
        "nif_result_body.rs.jinja",
        minijinja::context! {
            preamble => preamble,
            core_call => core_call,
            wrap => wrap,
        },
    )
}

pub(super) fn render_wrapped_body(preamble: &str, wrap: &str) -> String {
    template_env::render(
        "nif_wrapped_body.rs.jinja",
        minijinja::context! {
            preamble => preamble,
            wrap => wrap,
        },
    )
}

pub(super) fn render_async_body(template_name: &str, preamble: &str, core_call: &str, result_wrap: &str) -> String {
    template_env::render(
        template_name,
        minijinja::context! {
            preamble => preamble,
            core_call => core_call,
            result_wrap => result_wrap,
        },
    )
}

pub(super) fn render_method_call(template_name: &str, core_path: &str, method_name: &str, call_args: &str) -> String {
    template_env::render(
        template_name,
        minijinja::context! {
            core_path => core_path,
            method_name => method_name,
            call_args => call_args,
        },
    )
    .trim_end()
    .to_string()
}

pub(super) fn render_method_call_with_preamble(
    preamble: &str,
    core_path: &str,
    method_name: &str,
    call_args: &str,
) -> String {
    template_env::render(
        "rust_method_static_call_with_preamble.rs.jinja",
        minijinja::context! {
            preamble => preamble,
            core_path => core_path,
            method_name => method_name,
            call_args => call_args,
        },
    )
    .trim_end()
    .to_string()
}