Skip to main content

miniextendr_macros/
trait_self_ref.rs

1//! Shared pre-conversion alias checks and Self-reference lowering for trait shims.
2
3use proc_macro2::TokenStream;
4use quote::{format_ident, quote, quote_spanned};
5
6/// Check native arguments before conversion can create references. Arity
7/// must already be checked, and the caller must be inside the shim's R unwind
8/// boundary. `&Self` uses ExternalPtr handles and its separate address check.
9///
10/// An argument that [`argument`] converts through plain `TryFromSexp` can be
11/// prepared, so an `Either` is checked against the arm its conversion takes
12/// (#1504): the check declares its [`prepared_binding`], which [`argument`]
13/// converts from.
14pub(crate) fn native_borrow_checks<'a>(
15    args: impl IntoIterator<Item = (usize, String, &'a syn::Type)>,
16    argv: &syn::Ident,
17    targets: Option<&[syn::Ident]>,
18) -> TokenStream {
19    // The argument pairs inside the one-pass check's `unsafe` block, and
20    // outside it in the two-pass check.
21    let mut values = Vec::new();
22    let mut guarded_values = Vec::new();
23    let mut metadata = Vec::new();
24    let mut preparations = Vec::new();
25    for (index, name, ty) in args {
26        if crate::type_inspect::self_ref_mutability(ty).is_some() {
27            continue;
28        }
29        let input = {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "unsafe");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_star(&mut _s);
            ::quote::ToTokens::to_tokens(&argv, &mut _s);
            ::quote::__private::push_dot(&mut _s);
            ::quote::__private::push_ident(&mut _s, "add");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&index, &mut _s);
                    _s
                });
            _s
        });
    _s
}quote! { unsafe { *#argv.add(#index) } };
30        values.push({
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_star(&mut _s);
            ::quote::ToTokens::to_tokens(&argv, &mut _s);
            ::quote::__private::push_dot(&mut _s);
            ::quote::__private::push_ident(&mut _s, "add");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&index, &mut _s);
                    _s
                });
            ::quote::__private::push_comma(&mut _s);
            ::quote::ToTokens::to_tokens(&name, &mut _s);
            _s
        });
    _s
}quote! { (*#argv.add(#index), #name) });
31        guarded_values.push({
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            ::quote::__private::push_comma(&mut _s);
            ::quote::ToTokens::to_tokens(&name, &mut _s);
            _s
        });
    _s
}quote! { (#input, #name) });
32        let rooted =
33            crate::type_inspect::is_rooted_view(ty) || crate::type_inspect::is_rooted_reference(ty);
34        let target = targets.map(|targets| &targets[index]);
35        if !rooted {
36            let prepare = match target {
37                Some(target) => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&target, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "prepare");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            _s
        });
    _s
}quote! { #target.prepare(#input) },
38                None => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&ty, &mut _s);
    ::quote::__private::push_ident(&mut _s, "as");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "TryFromSexp");
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "__mx_prepare");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            _s
        });
    _s
}quote! {
39                    <#ty as ::miniextendr_api::TryFromSexp>::__mx_prepare(#input)
40                },
41            };
42            preparations.push((
43                metadata.len(),
44                crate::rust_conversion_builder::Preparation {
45                    binding: prepared_binding(index),
46                    prepare,
47                },
48            ));
49        }
50        metadata.push(match (target, rooted) {
51            (Some(target), true) => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&target, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "rooted_native_borrow");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    _s
}quote! { #target.rooted_native_borrow() },
52            (Some(target), false) => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&target, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "native_borrow");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    _s
}quote! { #target.native_borrow() },
53            (None, true) => {
54                let ty = crate::type_inspect::erase_lifetimes(ty);
55                {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&ty, &mut _s);
    ::quote::__private::push_ident(&mut _s, "as");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "TryFromRoot");
    ::quote::__private::push_lt(&mut _s);
    ::quote::__private::push_lifetime(&mut _s, "\'_");
    ::quote::__private::push_shr(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "NATIVE_BORROW");
    _s
}quote! { <#ty as ::miniextendr_api::TryFromRoot<'_>>::NATIVE_BORROW }
56            }
57            (None, false) => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&ty, &mut _s);
    ::quote::__private::push_ident(&mut _s, "as");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "TryFromSexp");
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "NATIVE_BORROW");
    _s
}quote! { <#ty as ::miniextendr_api::TryFromSexp>::NATIVE_BORROW },
58        });
59    }
60    if values.is_empty() {
61        return TokenStream::new();
62    }
63    if !preparations.is_empty() {
64        return crate::rust_conversion_builder::two_pass_alias_guard(
65            &metadata,
66            &guarded_values,
67            &preparations,
68        );
69    }
70    let borrows = syn::Ident::new(
71        "__miniextendr_native_borrows",
72        proc_macro2::Span::mixed_site(),
73    );
74    {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_ident(&mut _s, "let");
            ::quote::ToTokens::to_tokens(&borrows, &mut _s);
            ::quote::__private::push_eq(&mut _s);
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Bracket,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    {
                        use ::quote::__private::ext::*;
                        let mut _first = true;
                        let has_iter = ::quote::__private::HasIterator::<false>;
                        #[allow(unused_mut)]
                        let (mut metadata, i) = metadata.quote_into_iter();
                        let has_iter = has_iter | i;
                        <_ as
                                ::quote::__private::CheckHasIterator<true>>::check(has_iter);
                        while true {
                            let metadata =
                                match metadata.next() {
                                    Some(_x) => ::quote::__private::RepInterp(_x),
                                    None => break,
                                };
                            if !_first { ::quote::__private::push_comma(&mut _s); }
                            _first = false;
                            ::quote::ToTokens::to_tokens(&metadata, &mut _s);
                        }
                    }
                    _s
                });
            ::quote::__private::push_semi(&mut _s);
            ::quote::__private::push_ident(&mut _s, "if");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "miniextendr_api");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "from_r");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "borrow");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "needs_check");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::__private::push_and(&mut _s);
                    ::quote::ToTokens::to_tokens(&borrows, &mut _s);
                    _s
                });
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Brace,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::__private::push_ident(&mut _s, "unsafe");
                    ::quote::__private::push_group(&mut _s,
                        ::quote::__private::Delimiter::Brace,
                        {
                            let mut _s = ::quote::__private::TokenStream::new();
                            ::quote::__private::push_colon2(&mut _s);
                            ::quote::__private::push_ident(&mut _s, "miniextendr_api");
                            ::quote::__private::push_colon2(&mut _s);
                            ::quote::__private::push_ident(&mut _s, "from_r");
                            ::quote::__private::push_colon2(&mut _s);
                            ::quote::__private::push_ident(&mut _s, "borrow");
                            ::quote::__private::push_colon2(&mut _s);
                            ::quote::__private::push_ident(&mut _s,
                                "assert_no_aliases");
                            ::quote::__private::push_group(&mut _s,
                                ::quote::__private::Delimiter::Parenthesis,
                                {
                                    let mut _s = ::quote::__private::TokenStream::new();
                                    ::quote::__private::push_group(&mut _s,
                                        ::quote::__private::Delimiter::Bracket,
                                        {
                                            let mut _s = ::quote::__private::TokenStream::new();
                                            {
                                                use ::quote::__private::ext::*;
                                                let mut _first = true;
                                                let has_iter = ::quote::__private::HasIterator::<false>;
                                                #[allow(unused_mut)]
                                                let (mut values, i) = values.quote_into_iter();
                                                let has_iter = has_iter | i;
                                                <_ as
                                                        ::quote::__private::CheckHasIterator<true>>::check(has_iter);
                                                while true {
                                                    let values =
                                                        match values.next() {
                                                            Some(_x) => ::quote::__private::RepInterp(_x),
                                                            None => break,
                                                        };
                                                    if !_first { ::quote::__private::push_comma(&mut _s); }
                                                    _first = false;
                                                    ::quote::ToTokens::to_tokens(&values, &mut _s);
                                                }
                                            }
                                            _s
                                        });
                                    ::quote::__private::push_comma(&mut _s);
                                    ::quote::ToTokens::to_tokens(&borrows, &mut _s);
                                    ::quote::__private::push_comma(&mut _s);
                                    _s
                                });
                            ::quote::__private::push_semi(&mut _s);
                            _s
                        });
                    _s
                });
            _s
        });
    _s
}quote! {{
75        let #borrows = [#(#metadata),*];
76        if ::miniextendr_api::from_r::borrow::needs_check(&#borrows) {
77            // SAFETY: arity was checked before reading argv; its arguments
78            // remain rooted on R's thread inside the shim's unwind boundary.
79            unsafe {
80                ::miniextendr_api::from_r::borrow::assert_no_aliases(
81                    [#(#values),*], #borrows,
82                );
83            }
84        }
85    }}
86}
87
88/// The prepared state of the shim argument at `index` (#1504), declared by
89/// [`native_borrow_checks`] and read by [`argument`]. Keyed by position:
90/// both generators know it, and the shims name their parameters
91/// differently.
92fn prepared_binding(index: usize) -> syn::Ident {
93    match ::quote::__private::IdentFragmentAdapter(&index) {
    arg =>
        ::quote::__private::mk_ident(&::alloc::__export::must_use({
                        ::alloc::fmt::format(format_args!("__mx_prepared_{0}", arg))
                    }),
            ::quote::__private::Option::Some::<::quote::__private::Span>(proc_macro2::Span::mixed_site())),
}format_ident!(
94        "__mx_prepared_{}",
95        index,
96        span = proc_macro2::Span::mixed_site()
97    )
98}
99
100/// Convert one shim argument with the C wrapper's structured error arm.
101/// Arity and native alias checks must run first. Self handles are borrowed
102/// later, after their address checks; rooted views retain a local scope until
103/// the method's return has been converted.
104pub(crate) fn argument(
105    name: &syn::Ident,
106    diagnostic_name: &str,
107    ty: &syn::Type,
108    impl_ty: &impl quote::ToTokens,
109    index: usize,
110    argv: &syn::Ident,
111    target: Option<&syn::Ident>,
112) -> TokenStream {
113    let target = target.filter(|_| crate::type_inspect::self_ref_mutability(ty).is_none());
114    let input = {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "unsafe");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_star(&mut _s);
            ::quote::ToTokens::to_tokens(&argv, &mut _s);
            ::quote::__private::push_dot(&mut _s);
            ::quote::__private::push_ident(&mut _s, "add");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&index, &mut _s);
                    _s
                });
            _s
        });
    _s
}quote! { unsafe { *#argv.add(#index) } };
115    let r_name = crate::r_wrapper_builder::normalize_r_arg_string(diagnostic_name);
116    let (setup, binding, mut read_ty, mut conversion, rooted) = if let Some(mutable) =
117        crate::type_inspect::self_ref_mutability(ty)
118    {
119        let handle = handle_ident(name);
120        let mutability = mutable.then(|| {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "mut");
    _s
}quote!(mut));
121        let read_ty: syn::Type = ::syn::__private::parse_quote({
        let mut _s = ::quote::__private::TokenStream::new();
        ::quote::__private::push_colon2(&mut _s);
        ::quote::__private::push_ident(&mut _s, "miniextendr_api");
        ::quote::__private::push_colon2(&mut _s);
        ::quote::__private::push_ident(&mut _s, "ExternalPtr");
        ::quote::__private::push_lt(&mut _s);
        ::quote::ToTokens::to_tokens(&impl_ty, &mut _s);
        ::quote::__private::push_gt(&mut _s);
        _s
    })syn::parse_quote!(::miniextendr_api::ExternalPtr<#impl_ty>);
122        let conversion = {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&read_ty, &mut _s);
    ::quote::__private::push_ident(&mut _s, "as");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "TryFromSexp");
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "try_from_sexp");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            _s
        });
    _s
}quote! {
123            <#read_ty as ::miniextendr_api::TryFromSexp>::try_from_sexp(#input)
124        };
125        (
126            TokenStream::new(),
127            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&mutability, &mut _s);
    ::quote::ToTokens::to_tokens(&handle, &mut _s);
    _s
}quote!(#mutability #handle),
128            read_ty,
129            conversion,
130            false,
131        )
132    } else if crate::type_inspect::is_rooted_view(ty)
133        || crate::type_inspect::is_rooted_reference(ty)
134    {
135        if let Some(stmt) = crate::type_inspect::static_rooted_view_binding(name, ty) {
136            return stmt;
137        }
138        let slot = match ::quote::__private::IdentFragmentAdapter(&crate::naming::unraw(name)) {
    arg =>
        ::quote::__private::mk_ident(&::alloc::__export::must_use({
                        ::alloc::fmt::format(format_args!("__mx_root_{0}", arg))
                    }),
            ::quote::__private::Option::Some::<::quote::__private::Span>(proc_macro2::Span::mixed_site())),
}format_ident!(
139            "__mx_root_{}",
140            crate::naming::unraw(name),
141            span = proc_macro2::Span::mixed_site()
142        );
143        let read_ty = crate::type_inspect::erase_lifetimes(ty);
144        let conversion = {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&read_ty, &mut _s);
    ::quote::__private::push_ident(&mut _s, "as");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "TryFromRoot");
    ::quote::__private::push_lt(&mut _s);
    ::quote::__private::push_lifetime(&mut _s, "\'_");
    ::quote::__private::push_shr(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "try_from_root");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_ident(&mut _s, "unsafe");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Brace,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&slot, &mut _s);
                    ::quote::__private::push_dot(&mut _s);
                    ::quote::__private::push_ident(&mut _s, "rooted");
                    ::quote::__private::push_group(&mut _s,
                        ::quote::__private::Delimiter::Parenthesis,
                        {
                            let mut _s = ::quote::__private::TokenStream::new();
                            ::quote::__private::push_star(&mut _s);
                            ::quote::ToTokens::to_tokens(&argv, &mut _s);
                            ::quote::__private::push_dot(&mut _s);
                            ::quote::__private::push_ident(&mut _s, "add");
                            ::quote::__private::push_group(&mut _s,
                                ::quote::__private::Delimiter::Parenthesis,
                                {
                                    let mut _s = ::quote::__private::TokenStream::new();
                                    ::quote::ToTokens::to_tokens(&index, &mut _s);
                                    _s
                                });
                            _s
                        });
                    _s
                });
            _s
        });
    _s
}quote! {
145            <#read_ty as ::miniextendr_api::TryFromRoot<'_>>::try_from_root(unsafe {
146                #slot.rooted(*#argv.add(#index))
147            })
148        };
149        (
150            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&slot, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_ident(&mut _s, "unsafe");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "miniextendr_api");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "gc_protect");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "ProtectScope");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "new");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                ::quote::__private::TokenStream::new());
            _s
        });
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! { let #slot = unsafe { ::miniextendr_api::gc_protect::ProtectScope::new() }; },
151            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&name, &mut _s);
    _s
}quote!(#name),
152            read_ty,
153            conversion,
154            true,
155        )
156    } else {
157        // `native_borrow_checks` declared its prepared state.
158        let prepared = prepared_binding(index);
159        let erased = crate::type_inspect::erase_lifetimes(ty);
160        let conversion = {
    let mut _s = ::quote::__private::TokenStream::new();
    let _span: ::quote::__private::Span =
        ::quote::__private::get_span(syn::spanned::Spanned::span(ty)).__into_span();
    ::quote::__private::push_colon2_spanned(&mut _s, _span);
    ::quote::__private::push_ident_spanned(&mut _s, _span, "miniextendr_api");
    ::quote::__private::push_colon2_spanned(&mut _s, _span);
    ::quote::__private::push_ident_spanned(&mut _s, _span, "from_r");
    ::quote::__private::push_colon2_spanned(&mut _s, _span);
    ::quote::__private::push_ident_spanned(&mut _s, _span, "prepared");
    ::quote::__private::push_colon2_spanned(&mut _s, _span);
    ::quote::__private::push_ident_spanned(&mut _s, _span, "convert");
    ::quote::__private::push_colon2_spanned(&mut _s, _span);
    ::quote::__private::push_lt_spanned(&mut _s, _span);
    ::quote::ToTokens::to_tokens(&erased, &mut _s);
    ::quote::__private::push_gt_spanned(&mut _s, _span);
    ::quote::__private::push_group_spanned(&mut _s, _span,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            let _span: ::quote::__private::Span =
                ::quote::__private::get_span(_span).__into_span();
            ::quote::ToTokens::to_tokens(&prepared, &mut _s);
            ::quote::__private::push_comma_spanned(&mut _s, _span);
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            _s
        });
    _s
}quote_spanned! {syn::spanned::Spanned::span(ty)=>
161            ::miniextendr_api::from_r::prepared::convert::<#erased>(#prepared, #input)
162        };
163        (
164            TokenStream::new(),
165            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&name, &mut _s);
    _s
}quote!(#name),
166            ty.clone(),
167            conversion,
168            false,
169        )
170    };
171    if let Some(target) = target {
172        read_ty = ::syn::__private::parse_quote({
        let mut _s = ::quote::__private::TokenStream::new();
        ::quote::__private::push_underscore(&mut _s);
        _s
    })syn::parse_quote!(_);
173        conversion = if rooted {
174            let slot = match ::quote::__private::IdentFragmentAdapter(&crate::naming::unraw(name)) {
    arg =>
        ::quote::__private::mk_ident(&::alloc::__export::must_use({
                        ::alloc::fmt::format(format_args!("__mx_root_{0}", arg))
                    }),
            ::quote::__private::Option::Some::<::quote::__private::Span>(proc_macro2::Span::mixed_site())),
}format_ident!(
175                "__mx_root_{}",
176                crate::naming::unraw(name),
177                span = proc_macro2::Span::mixed_site()
178            );
179            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&target, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "rooted");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_ident(&mut _s, "unsafe");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Brace,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&slot, &mut _s);
                    ::quote::__private::push_dot(&mut _s);
                    ::quote::__private::push_ident(&mut _s, "rooted");
                    ::quote::__private::push_group(&mut _s,
                        ::quote::__private::Delimiter::Parenthesis,
                        {
                            let mut _s = ::quote::__private::TokenStream::new();
                            ::quote::__private::push_star(&mut _s);
                            ::quote::ToTokens::to_tokens(&argv, &mut _s);
                            ::quote::__private::push_dot(&mut _s);
                            ::quote::__private::push_ident(&mut _s, "add");
                            ::quote::__private::push_group(&mut _s,
                                ::quote::__private::Delimiter::Parenthesis,
                                {
                                    let mut _s = ::quote::__private::TokenStream::new();
                                    ::quote::ToTokens::to_tokens(&index, &mut _s);
                                    _s
                                });
                            _s
                        });
                    _s
                });
            _s
        });
    _s
}quote! { #target.rooted(unsafe { #slot.rooted(*#argv.add(#index)) }) }
180        } else {
181            let prepared = prepared_binding(index);
182            {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&target, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "convert_prepared");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&prepared, &mut _s);
            ::quote::__private::push_comma(&mut _s);
            ::quote::ToTokens::to_tokens(&input, &mut _s);
            _s
        });
    _s
}quote! { #target.convert_prepared(#prepared, #input) }
183        };
184    }
185    let err_arm = crate::rust_conversion_builder::shim_conversion_err_arm(
186        &r_name,
187        ty,
188        (!rooted).then_some(&read_ty),
189        target.filter(|_| !rooted),
190    );
191    {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&setup, &mut _s);
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&binding, &mut _s);
    ::quote::__private::push_colon(&mut _s);
    ::quote::ToTokens::to_tokens(&read_ty, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_ident(&mut _s, "match");
    ::quote::ToTokens::to_tokens(&conversion, &mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "core");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "result");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "Result");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "Ok");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::__private::push_ident(&mut _s, "value");
                    _s
                });
            ::quote::__private::push_fat_arrow(&mut _s);
            ::quote::__private::push_ident(&mut _s, "value");
            ::quote::__private::push_comma(&mut _s);
            ::quote::ToTokens::to_tokens(&err_arm, &mut _s);
            _s
        });
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
192        #setup
193        let #binding: #read_ty = match #conversion {
194            ::core::result::Result::Ok(value) => value,
195            #err_arm
196        };
197    }
198}
199
200/// A shim's receiver address for [`alias_checks`]: the value inside the
201/// receiver's `RefCell`, comparable with `ExternalPtr::as_ptr` of a `&Self`
202/// argument.
203pub(crate) fn cell_address(cell: &syn::Ident) -> TokenStream {
204    {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&cell, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "as_ptr");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "cast_const");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "cast");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_lt(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "core");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "ffi");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "c_void");
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    _s
}quote! { #cell.as_ptr().cast_const().cast::<::core::ffi::c_void>() }
205}
206
207/// Where a shim's receiver lives: the vtable shims reach trait-ABI storage
208/// (`abi::ErasedObject<T>`), the `.Call` wrapper of a trait impl method an
209/// ordinary `ExternalPtr` value.
210#[derive(#[automatically_derived]#[doc(hidden)]unsafe impl ::core::clone::TrivialClone
    for ReceiverStorage {
}
#[automatically_derived]impl ::core::clone::Clone for ReceiverStorage {
    #[inline]
    fn clone(&self) -> Self { *self }
}Clone, #[automatically_derived]impl ::core::marker::Copy for ReceiverStorage { }Copy, #[automatically_derived]impl ::core::marker::StructuralPartialEq for
    ReceiverStorage {
}
#[automatically_derived]impl ::core::cmp::PartialEq for ReceiverStorage {
    #[inline]
    fn eq(&self, other: &Self) -> bool {
        ::core::intrinsics::discriminant_value(self) ==
            ::core::intrinsics::discriminant_value(other)
    }
}PartialEq, #[automatically_derived]impl ::core::cmp::Eq for ReceiverStorage { }Eq)]
211pub(crate) enum ReceiverStorage {
212    /// Trait-ABI storage. The declaration's shims are generic over the
213    /// implementing type, so its exclusive borrow is the one without a
214    /// `TypedExternal` bound (`borrow_erased_value_mut`): no R field getter
215    /// reads that storage, so it has no cached field values to drop.
216    Erased,
217    /// An `ExternalPtr` value: its exclusive borrow drops the value's cached
218    /// field values (`#[r_data(cache)]`, #2271).
219    Ordinary,
220}
221
222/// Borrow a shim's receiver from its `RefCell` for the rest of the shim:
223/// shared for `&self`, exclusive for `&mut self`. A call still running on the
224/// same object makes this raise the `miniextendr_borrow_conflict` error.
225pub(crate) fn receiver_borrow(
226    cell: &syn::Ident,
227    guard: &syn::Ident,
228    self_ref: &syn::Ident,
229    mutable: bool,
230    storage: ReceiverStorage,
231) -> TokenStream {
232    if mutable {
233        let borrow = match storage {
234            ReceiverStorage::Erased => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "borrow_erased_value_mut");
    _s
}quote!(borrow_erased_value_mut),
235            ReceiverStorage::Ordinary => {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "borrow_value_mut");
    _s
}quote!(borrow_value_mut),
236        };
237        {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::__private::push_ident(&mut _s, "mut");
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "externalptr");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::ToTokens::to_tokens(&borrow, &mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&cell, &mut _s);
            _s
        });
    ::quote::__private::push_semi(&mut _s);
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&self_ref, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_and(&mut _s);
    ::quote::__private::push_ident(&mut _s, "mut");
    ::quote::__private::push_star(&mut _s);
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
238            let mut #guard = ::miniextendr_api::externalptr::#borrow(#cell);
239            let #self_ref = &mut *#guard;
240        }
241    } else {
242        {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "miniextendr_api");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "externalptr");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "borrow_value");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::ToTokens::to_tokens(&cell, &mut _s);
            _s
        });
    ::quote::__private::push_semi(&mut _s);
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&self_ref, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_and(&mut _s);
    ::quote::__private::push_star(&mut _s);
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
243            let #guard = ::miniextendr_api::externalptr::borrow_value(#cell);
244            let #self_ref = &*#guard;
245        }
246    }
247}
248
249pub(crate) fn handle_ident(name: &syn::Ident) -> syn::Ident {
250    match ::quote::__private::IdentFragmentAdapter(&crate::naming::unraw(name)) {
    arg =>
        ::quote::__private::mk_ident(&::alloc::__export::must_use({
                        ::alloc::fmt::format(format_args!("__extptr_{0}", arg))
                    }),
            ::quote::__private::Option::Some::<::quote::__private::Span>(proc_macro2::Span::mixed_site())),
}format_ident!(
251        "__extptr_{}",
252        crate::naming::unraw(name),
253        span = proc_macro2::Span::mixed_site()
254    )
255}
256
257/// Borrow a `&Self` argument's value for the rest of the shim, exclusively
258/// for `&mut Self`, as a C wrapper borrows a `&T` / `&mut T` argument
259/// (#2106): a call still running on the object makes the borrow raise the
260/// `miniextendr_borrow_conflict` error. The handle [`argument`] made roots the
261/// pointer of a class-wrapped argument. Runs after [`alias_checks`].
262pub(crate) fn borrow(name: &syn::Ident, mutable: bool) -> TokenStream {
263    let handle = handle_ident(name);
264    let guard = match ::quote::__private::IdentFragmentAdapter(&crate::naming::unraw(name)) {
    arg =>
        ::quote::__private::mk_ident(&::alloc::__export::must_use({
                        ::alloc::fmt::format(format_args!("__mx_guard_{0}", arg))
                    }),
            ::quote::__private::Option::Some::<::quote::__private::Span>(proc_macro2::Span::mixed_site())),
}format_ident!(
265        "__mx_guard_{}",
266        crate::naming::unraw(name),
267        span = proc_macro2::Span::mixed_site()
268    );
269    if mutable {
270        {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::__private::push_ident(&mut _s, "mut");
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::ToTokens::to_tokens(&handle, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "borrow_mut");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_semi(&mut _s);
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&name, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_and(&mut _s);
    ::quote::__private::push_ident(&mut _s, "mut");
    ::quote::__private::push_star(&mut _s);
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
271            let mut #guard = #handle.borrow_mut();
272            let #name = &mut *#guard;
273        }
274    } else {
275        {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::ToTokens::to_tokens(&handle, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "borrow");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_semi(&mut _s);
    ::quote::__private::push_ident(&mut _s, "let");
    ::quote::ToTokens::to_tokens(&name, &mut _s);
    ::quote::__private::push_eq(&mut _s);
    ::quote::__private::push_and(&mut _s);
    ::quote::__private::push_star(&mut _s);
    ::quote::ToTokens::to_tokens(&guard, &mut _s);
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
276            let #guard = #handle.borrow();
277            let #name = &*#guard;
278        }
279    }
280}
281
282/// Reject overlapping Self arguments before any of their references exist.
283/// Shared/shared pairs are allowed. Reentrant access remains a separate concern.
284pub(crate) fn alias_checks(
285    ty: &impl quote::ToTokens,
286    handles: &[(syn::Ident, bool, String)],
287    receiver: Option<(TokenStream, bool)>,
288) -> TokenStream {
289    let mut pointers: Vec<_> = handles
290        .iter()
291        .map(|(handle, mutable, name)| {
292            (
293                {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::ToTokens::to_tokens(&handle, &mut _s);
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "as_ptr");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_dot(&mut _s);
    ::quote::__private::push_ident(&mut _s, "cast");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_lt(&mut _s);
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "core");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "ffi");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "c_void");
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    _s
}quote!(#handle.as_ptr().cast::<::core::ffi::c_void>()),
294                *mutable,
295                name.clone(),
296            )
297        })
298        .collect();
299    if let Some((pointer, mutable)) = receiver {
300        pointers.insert(0, (pointer, mutable, "self".to_owned()));
301    }
302    let mut checks = Vec::new();
303    for (index, (left, left_mut, left_name)) in pointers.iter().enumerate() {
304        for (right, right_mut, right_name) in &pointers[index + 1..] {
305            if *left_mut || *right_mut {
306                let message = ::alloc::__export::must_use({
        ::alloc::fmt::format(format_args!("trait arguments \'{0}\' and \'{1}\' alias the same object while one is mutable",
                left_name, right_name))
    })format!(
307                    "trait arguments '{left_name}' and '{right_name}' alias the same object while one is mutable"
308                );
309                checks.push({
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "core");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "assert");
    ::quote::__private::push_bang(&mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            ::quote::__private::push_bang(&mut _s);
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "core");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "ptr");
            ::quote::__private::push_colon2(&mut _s);
            ::quote::__private::push_ident(&mut _s, "eq");
            ::quote::__private::push_group(&mut _s,
                ::quote::__private::Delimiter::Parenthesis,
                {
                    let mut _s = ::quote::__private::TokenStream::new();
                    ::quote::ToTokens::to_tokens(&left, &mut _s);
                    ::quote::__private::push_comma(&mut _s);
                    ::quote::ToTokens::to_tokens(&right, &mut _s);
                    _s
                });
            ::quote::__private::push_comma(&mut _s);
            ::quote::ToTokens::to_tokens(&message, &mut _s);
            _s
        });
    ::quote::__private::push_semi(&mut _s);
    _s
}quote! {
310                    ::core::assert!(!::core::ptr::eq(#left, #right), #message);
311                });
312            }
313        }
314    }
315    if checks.is_empty() {
316        TokenStream::new()
317    } else {
318        // Distinct zero-sized allocations can have identical data addresses.
319        {
    let mut _s = ::quote::__private::TokenStream::new();
    ::quote::__private::push_ident(&mut _s, "if");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "core");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "mem");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_ident(&mut _s, "size_of");
    ::quote::__private::push_colon2(&mut _s);
    ::quote::__private::push_lt(&mut _s);
    ::quote::ToTokens::to_tokens(&ty, &mut _s);
    ::quote::__private::push_gt(&mut _s);
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Parenthesis,
        ::quote::__private::TokenStream::new());
    ::quote::__private::push_ne(&mut _s);
    ::quote::__private::parse(&mut _s, "0");
    ::quote::__private::push_group(&mut _s,
        ::quote::__private::Delimiter::Brace,
        {
            let mut _s = ::quote::__private::TokenStream::new();
            {
                use ::quote::__private::ext::*;
                let has_iter = ::quote::__private::HasIterator::<false>;
                #[allow(unused_mut)]
                let (mut checks, i) = checks.quote_into_iter();
                let has_iter = has_iter | i;
                <_ as
                        ::quote::__private::CheckHasIterator<true>>::check(has_iter);
                while true {
                    let checks =
                        match checks.next() {
                            Some(_x) => ::quote::__private::RepInterp(_x),
                            None => break,
                        };
                    ::quote::ToTokens::to_tokens(&checks, &mut _s);
                }
            }
            _s
        });
    _s
}quote! { if ::core::mem::size_of::<#ty>() != 0 { #(#checks)* } }
320    }
321}
322
323#[cfg(test)]
324mod tests;