Gobstopper Web Framework Documentation¶
Gobstopper is a production-ready, high-performance async web framework built specifically for Granian’s RSGI interface. Gobstopper combines the developer experience of Flask/Quart with the performance benefits of RSGI and optional Rust-powered components.
Quick Start¶
Installation¶
# Basic installation (core framework only)
uv add gobstopper
# With all optional features
uv add "gobstopper[all]"
# For development
uv add "gobstopper[dev]"
Hello World¶
from gobstopper import Gobstopper, Request, jsonify
app = Gobstopper(__name__)
@app.get("/")
async def hello(request: Request):
return jsonify({"message": "Hello from Gobstopper!"})
# Run with: gobstopper run --reload
Key Features¶
- 🦀 Rust-Powered Components
High-performance routing, templates, and static file serving with seamless Python fallback
- ⚡ RSGI Native
Purpose-built for Granian’s high-performance RSGI interface
- 🔋 Batteries Included
Background tasks, WebSockets, sessions, and security out-of-the-box
- 🎨 Flask-like API
Familiar, ergonomic API design with modern async/await
- 📦 Lightweight Core
Install only what you need with optional dependencies
Table of Contents¶
User Guide
Core Components
API Reference