Skip to main content

armillae_tools_macros/
lib.rs

1//! Function-like Tool authoring macros for Armillae.
2
3extern crate proc_macro;
4
5use proc_macro::TokenStream;
6use syn::{ItemFn, parse_macro_input};
7
8mod args;
9mod expand;
10
11/// Converts a free function into an [`armillae_tools::Tool`] implementation.
12///
13/// The generated unit struct uses the function name converted to PascalCase.
14/// Function and parameter doc comments provide descriptions by default. The
15/// function-level `name`, `description`, and `params(...)` arguments or a
16/// parameter-level `#[tool(description = "...")]` can override them.
17///
18/// ```ignore
19/// use armillae_tools_macros::tool;
20///
21/// /// Add two integers.
22/// #[tool]
23/// async fn add(left: i64, right: i64) -> Result<i64, AddError> {
24///     Ok(left + right)
25/// }
26/// ```
27#[proc_macro_attribute]
28pub fn tool(args: TokenStream, input: TokenStream) -> TokenStream {
29    let args = parse_macro_input!(args as args::MacroArgs);
30    let input = parse_macro_input!(input as ItemFn);
31
32    expand::expand(args, input)
33        .unwrap_or_else(syn::Error::into_compile_error)
34        .into()
35}