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
#![warn(
clippy::pedantic,
clippy::nursery,
clippy::str_to_string,
clippy::missing_inline_in_public_items
)]
// Pedantic config
#![allow(
clippy::missing_const_for_fn,
clippy::missing_panics_doc,
clippy::must_use_candidate,
clippy::cast_possible_truncation
)]
mod entry;
mod types;
use proc_macro::TokenStream;
macro_rules! match_variant {
($variant:path) => {
|x| {
if let $variant(value) = x {
Some(value)
} else {
None
}
}
};
}
pub(crate) use match_variant;
/// # Register exposed function names required for a UDF
///
/// This macro is applied to an `impl BasicUdf` block (and an `AggregateUdf`
/// block, if applicable) and exposed the C-callable functions that
/// `MariaDB`/`MySQL` expect.
///
/// Its process is as follows:
///
/// - Convert the implemented struct's name to snake case to create the function
/// name
/// - Obtain the return type from the `Returns` type in `BasicUdf`
/// - Create functions `fn_name`, `fn_name_init`, and `fn_name_deinit` with
/// correct signatures and interfaces
/// - If applied on an `impl AggregateUdf` block, create `fn_name_clear` and
/// `fn_name_add`. `fn_name_remove` is also included if it is redefined
///
// Arguments don't yet work
//
// # Arguments
//
// - `#[udf::register(name = "new_name")]` will specify a name for your SQL
// function. If this is not specified, your struct name will be converted to
// snake case and used (e.g. `AddAllNumbers` would become `add_all_numbers`
// by default).
#[proc_macro_attribute]
// #[cfg(not(test))] // Work around for rust-lang/rust#62127
pub fn register(args: TokenStream, item: TokenStream) -> TokenStream {
// Keep this file clean by keeping the dirty work in entry
entry::register(&args, item)
}