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}