mysql-handler-macros 0.2.0

Procedural macros for mysql-handler engine cdylibs
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

// Copyright (C) 2026 ren-yamanashi
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License, version 2.0,
// as published by the Free Software Foundation.
//
// This program is designed to work with certain software (including
// but not limited to OpenSSL) that is licensed under separate terms,
// as designated in a particular file or component or in included license
// documentation. The authors of this program hereby grant you an additional
// permission to link the program and your derivative works with the
// separately licensed software that they have either included with
// the program or referenced in the documentation.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, see <https://www.gnu.org/licenses/>.

//! Top-level orchestrator for `#[plugin(...)]` expansion. Each emitted
//! fragment lives in its own submodule so this file just composes them.

use std::ffi::CString;

use proc_macro2::TokenStream as TokenStream2;
use quote::quote;
use syn::{ItemStruct, LitCStr, LitStr};

use crate::args::PluginArgs;

mod manifest;
mod plugin_init;

pub(crate) fn plugin(args: &PluginArgs, target: &ItemStruct) -> syn::Result<TokenStream2> {
    let ty = &target.ident;
    let name_lit = cstr_lit(&args.name)?;
    let descr_lit = cstr_lit(&args.description)?;
    let author_lit = cstr_lit(&args.author)?;
    let manifest_module = manifest::manifest_module();
    let manifest_statics = manifest::manifest_statics(
        &name_lit,
        &descr_lit,
        &author_lit,
        &args.version,
        &args.license,
    );
    let plugin_init = plugin_init::plugin_init(ty, args.handlerton.as_ref());

    Ok(quote! {
        #target
        #manifest_module
        #manifest_statics
        #plugin_init
    })
}

fn cstr_lit(lit: &LitStr) -> syn::Result<LitCStr> {
    let value = lit.value();
    let cstring = CString::new(value).map_err(|_| {
        syn::Error::new(
            lit.span(),
            "#[plugin] string literal must not contain a NUL byte",
        )
    })?;
    Ok(LitCStr::new(&cstring, lit.span()))
}