RustAPI Examples

Production-ready examples demonstrating the full power of RustAPI — the Rust web framework with FastAPI-like developer experience.

📚 Official Resources:

• 🔗 RustAPI Framework — Main repository
• 📖 Cookbook Documentation — Comprehensive guides & recipes
• 💬 Discussions — Community support

🚀 Why RustAPI?

"Rust Speed. Python Simplicity. AI Efficiency."

Key Features

• 🎯 Zero Boilerplate — RustApi::auto() discovers all routes automatically
• 📝 Auto Documentation — OpenAPI/Swagger at /docs out of the box
• ✅ Built-in Validation — #[validate] with detailed error messages
• 🔐 JWT Authentication — First-class JwtLayer and AuthUser<T> extractor
• 🤖 AI-First Architecture — TOON format (50-58% token savings), MCP support
• ⚡ Middleware Stack — Rate limiting, CORS, logging, circuit breaker, and more
• 🌐 Real-time — WebSocket support with broadcast channels

📋 Prerequisites

Before running these examples, ensure you have:

# Rust 1.70 or later
rustc --version

# Clone the examples repository
git clone https://github.com/Tuntii/rustapi-rs-examples.git
cd rustapi-rs-examples

# Build all examples
cargo build --release

Optional dependencies (for specific examples):

• Docker — For sqlx-crud (PostgreSQL/SQLite)
• SQLite — For sqlx-crud local testing

📂 Examples Overview

This repository contains 18 production-ready examples organized by category:

🌟 Getting Started

🔐 Authentication & Security

🗄️ Database Integration

🤖 AI & LLM Integration

🌐 Real-time & Web

🏗️ Advanced Architecture

⚠️ Note: serverless-lambda uses AWS Lambda HTTP runtime instead of RustAPI for serverless deployment patterns.

🎯 Feature Coverage Matrix

📊 RustAPI Feature Flags

Each example uses specific Cargo feature flags. See FEATURES.md for detailed documentation.

🚀 Quick Start

Running an Example

# Navigate to repository
cd rustapi-rs-examples

# Run any example
cargo run -p hello-world

# Run with debug logging
RUST_LOG=debug cargo run -p crud-api

# Access Swagger documentation (when running)
# http://127.0.0.1:8080/docs

Testing API Endpoints

# Hello World
curl http://127.0.0.1:8080/
curl http://127.0.0.1:8080/hello/RustAPI

# CRUD API
curl http://127.0.0.1:8080/users
curl -X POST http://127.0.0.1:8080/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com"}'

# Auth API
curl -X POST http://127.0.0.1:8080/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "password"}'

📚 Learning Path

For a structured learning experience, follow our recommended progression in LEARNING_PATH.md:

1. hello-world     → Basic routing, responses
2. crud-api        → Validation, error handling, state management
3. auth-api        → JWT authentication, protected routes
4. middleware-chain → Custom middleware, composition
5. proof-of-concept → Full application architecture

🔗 Cookbook Cross-References

Each example maps to sections in the RustAPI Cookbook:

📝 Creating Your Own Example

1. Create directory: my-example/

2. Add Cargo.toml:

   [package]
   name = "my-example"
   version = "0.1.0"
   edition = "2021"
   
   [dependencies]
   rustapi-rs = { path = "../../crates/rustapi-rs", features = ["full"] }
   tokio = { version = "1", features = ["full"] }
   serde = { version = "1", features = ["derive"] }
   

3. Create src/main.rs:

   use rustapi_rs::prelude::*;
   
   #[rustapi_rs::get("/")]
   async fn index() -> &'static str {
       "Hello from my example!"
   }
   
   #[tokio::main]
   async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
       RustApi::auto().run("127.0.0.1:8080").await
   }
   

4. Run it:

   cargo run -p my-example
   

🎯 Roadmap

Coming Soon

• redis-cache — Redis caching layer
• sse-events — Server-Sent Events streaming
• grpc-integration — gRPC + REST hybrid API
• distributed-tracing — OpenTelemetry integration
• kubernetes-ready — Health checks, metrics, graceful shutdown

🤝 Contributing

Contributions are welcome! See our Contributing Guide for details.

1. Fork this repository
2. Create your example in a new directory
3. Add comprehensive documentation (README.md)
4. Submit a pull request

📄 License

This project is licensed under the MIT OR Apache-2.0 license, same as RustAPI.

Built with ❤️ using RustAPI

Framework · Cookbook · Examples · Discussions