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.

Version Python Version License

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

Indices and tables