alef 0.22.26

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

fn nodecontext_to_rb_hash(
    ctx: &{{ core_crate }}::visitor::NodeContext,
) -> magnus::RHash {
    let ruby = unsafe { magnus::Ruby::get_unchecked() };
    let h = ruby.hash_new();
    h.aset(ruby.to_symbol("node_type"), format!("{:?}", ctx.node_type)).ok();
    h.aset(ruby.to_symbol("tag_name"), ctx.tag_name.as_str()).ok();
    h.aset(ruby.to_symbol("depth"), ctx.depth as i64).ok();
    h.aset(ruby.to_symbol("index_in_parent"), ctx.index_in_parent as i64).ok();
    h.aset(ruby.to_symbol("is_inline"), ctx.is_inline).ok();
    h.aset(ruby.to_symbol("parent_tag"), ctx.parent_tag.as_deref().map(|s| ruby.str_new(s).as_value())).ok();
    let attrs = ruby.hash_new();
    for (k, v) in &ctx.attributes {
        attrs.aset(ruby.str_new(k), ruby.str_new(v)).ok();
    }
    h.aset(ruby.to_symbol("attributes"), attrs).ok();
    h
}

pub struct {{ struct_name }} {
    rb_obj: magnus::Value,
}

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(rb_obj: magnus::Value) -> Self {
        Self { rb_obj }
    }
}

// SAFETY: `magnus::Value` wraps a `VALUE` (a GC-managed Ruby object pointer).
// Ruby is effectively single-threaded (GIL/GVL); the bridge is only invoked
// synchronously from the Ruby thread that constructed it. The `Arc<Mutex>`
// outer wrapper ensures exclusive access. Sending the bridge across threads
// would cause undefined behaviour in the Ruby 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 }} {
{%- for method in methods %}
{{ method }}
{%- endfor %}
}