zsh-module-macros 0.1.1

Macro portion of the zsh-module crate, a high-level framework for creating dynamically-loadable ZSH modules in Rust. This crate provides the procedural macros used by zsh-module, and is not intended to be used directly by end-users.
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

use proc_macro2::TokenStream;
use quote::quote;
use syn::ItemStruct;

use crate::utils::emit::{priv_mod, trampoline_name};

pub fn state_impl(input: ItemStruct) -> TokenStream {
    let struct_name = &input.ident;
    let priv_mod = priv_mod(struct_name);
    let tramoline_name = trampoline_name(struct_name);

    quote! {
        // Re-emit the user's struct unchanged.
        #input

        mod #priv_mod {
            use super::#struct_name;

            #[allow(deprecated)]
            use ::zsh_module::__ as zmod;
            use zmod::linkme;

            use zmod::module::{Container, ContainerHooks, TrampolineCallback};
            impl zmod::module::SizedModuleState for #struct_name {}

            static MODULE_CONTAINER: Container<#struct_name> = Container::new();

            #[linkme::distributed_slice(zmod::CONTAINERS)]
            #[linkme(crate = zmod::linkme)]
            static MODULE_VTABLE: &'static dyn ContainerHooks = &MODULE_CONTAINER;

            fn use_module<F>(applicator: F) -> i32
            where
                F: FnOnce(&mut #struct_name) -> ::zsh_module::types::result::Result<()> + std::panic::UnwindSafe,
            {
                MODULE_CONTAINER.with_state(applicator).unwrap_or(65)
            }

            #[unsafe(no_mangle)]
            extern "Rust" fn #tramoline_name(cb: TrampolineCallback<#struct_name>) -> i32 {
                use_module(cb)
            }
        }
    }
}