alef 0.19.1

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

fn nodecontext_to_robj(
    ctx: &{{ core_crate }}::visitor::NodeContext,
) -> extendr_api::Robj {
    use extendr_api::prelude::*;
    let attrs_pairs: Vec<(&str, extendr_api::Robj)> = ctx.attributes.iter()
        .map(|(k, v)| (k.as_str(), extendr_api::Robj::from(v.as_str())))
        .collect();
    let attrs: extendr_api::Robj = List::from_pairs(attrs_pairs).into();
    list!(
        node_type = format!("{:?}", ctx.node_type),
        tag_name = ctx.tag_name.as_str(),
        depth = ctx.depth as i32,
        index_in_parent = ctx.index_in_parent as i32,
        is_inline = ctx.is_inline,
        parent_tag = ctx.parent_tag.as_deref().unwrap_or(""),
        attributes = attrs,
    ).into()
}

pub struct {{ struct_name }} {
    r_obj: extendr_api::Robj,
}

impl std::fmt::Debug for {{ struct_name }} {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{{ struct_name }}")
    }
}

impl {{ struct_name }} {
    pub fn new(r_obj: extendr_api::Robj) -> Self {
        Self { r_obj }
    }
}

// SAFETY: `extendr_api::Robj` wraps a raw `SEXP` (a GC-managed R object pointer).
// R is single-threaded; the bridge is only invoked synchronously from the R thread
// that constructed it. The `Arc<Mutex>` outer wrapper ensures exclusive access.
// Sending the bridge across threads would cause undefined behaviour in the R
// runtime — callers must not do so.
unsafe impl Send for {{ struct_name }} {}
// SAFETY: see Send impl above.
unsafe impl Sync for {{ struct_name }} {}

impl {{ trait_path }} for {{ struct_name }} {
{{ method_impls }}
}