vespera

Automate Rust API route creation and OpenAPI generation with compile-time macros.

Updated Jan 23, 2026

Search Tags:#openapi #schema #macros #rust #compile-time #axum

Ready to run

npx skills add https://github.com/sanghee01/no-fishing-zone --skill vespera

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: vespera
Source: https://github.com/sanghee01/no-fishing-zone/tree/main/.agent/skills/vespera
Command: npx skills add https://github.com/sanghee01/no-fishing-zone --skill vespera

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building Rust APIs often requires boilerplate for routing, data schemas, and OpenAPI documentation. Vespera automates these tasks to accelerate API development with zero-config OpenAPI generation.

Core Features & Use Cases

Zero-config OpenAPI 3.1 generation via compile-time macros.
Vespera macro-driven app setup (vespera!) and route annotations (#[vespera::route]).
Derive Schema on custom types to generate API schemas and docs automatically.

Quick Start

Create a Vespera app using the vespera! macro, annotate routes with #[vespera::route], derive Schema where needed, and build to generate openapi.json at compile time.

Frequently Asked Questions about vespera

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate OpenAPI documentation automatically in a Rust web service?▼

You can generate OpenAPI documentation automatically in Rust by using compile-time macros to derive schemas from data types and annotate route handlers, producing an openapi.json file during the build process without manual configuration.

What is the best way to reduce routing boilerplate when building Rust APIs?▼

The best way to reduce routing boilerplate when building Rust APIs is to use macro-driven app setup and route annotations, which automates route creation and eliminates repetitive manual handler registrations.

Does automatic OpenAPI generation in Rust work without runtime configuration?▼

Yes, zero-config OpenAPI generation works in Rust by leveraging compile-time macros to handle schema derivation and route mapping during the build step, entirely removing the need for runtime configuration.

How do I derive API schemas from custom data types in Rust?▼

You derive API schemas from custom data types in Rust by applying a Schema derive macro to your structs, which automatically generates the required API schemas and documentation at compile time.

Can I use compile-time macros to define routes in Rust web frameworks?▼

Yes, you can use compile-time macros to define routes in Rust web frameworks by annotating pub async route handlers with route attributes, automating endpoint registration and OpenAPI spec generation.

What are the limitations of using compile-time macros for OpenAPI generation in Rust?▼

Compile-time macros for OpenAPI generation in Rust require all schema derivations and route definitions to be statically known at build time, meaning dynamic route creation or runtime schema modifications are not supported.