clawspec_macro/lib.rs
1//! Procedural macros for clawspec API generation.
2//!
3//! This crate provides procedural macros to make it easier to generate
4//! OpenAPI specifications from annotated Rust code.
5//!
6//! # Future Plans
7//!
8//! This crate is intended to provide derive macros for generating API client
9//! implementations from annotated traits, similar to how other HTTP client
10//! libraries work.
11//!
12//! Example future usage:
13//! ```ignore
14//! use clawspec_macro::ApiClient;
15//!
16//! #[derive(ApiClient)]
17//! #[api(base_url = "https://api.example.com")]
18//! trait ExampleApi {
19//! #[get("/users/{id}")]
20//! async fn get_user(&self, id: u32) -> Result<User, Error>;
21//! }
22//! ```
23
24// For now, this is a placeholder that will be expanded with actual macros
25// when the API design is finalized.