fastapi-easylimiter 0.4.0

Async rate limiter for FastAPI with Redis or in-memory backend and advanced proxy-aware security

fastapi‑easylimiter

---

An ASGI async rate-limiting middleware for FastAPI with Redis or in-memory caching, designed to handle auto-generated routes (e.g., FastAPI-Users) without decorators, for simplicity and ease of use.

---

Features

• Path based rules (/api/*, /admin/*, exact matches)
• Fixed & sliding window strategies (Lua)
• RateLimit, RateLimit-Policy, Retry-After headers
• Bans with back-off per IP with configurable window
• BaseHTTPMiddleware for FastAPI/Starlette

---

TODO

• In-memory option

Installation

pip install fastapi-easylimiter

---

Usage

from fastapi import FastAPI
import redis.asyncio as redis
from middleware.rate import RateLimitMiddleware

app = FastAPI()

redis_client = redis.from_url("redis://localhost:6379/0")

app.add_middleware(
    RateLimitMiddleware,
    redis=redis,
    rules={
        "/*": (200, 60, "fixed"),           
        "/api/*": (5, 1000, "sliding"),
        "/api/auth/*": (3, 1, "sliding"),
        "/api/users/me": (2, 30, "fixed"),
    },
    exempt=[],
    enable_bans=True,
    ban_offenses=8,
    ban_window="10m",
    ban_length="5m",
    ban_max_length="1d",
    )

@app.get("/api/hello")
async def hello():
    return {"message": "ok"}

Example: /api/users/me matches /api/users and /api. If any rule is exceeded → 429 returned.

---

Redis Key Patterns

Key Pattern	Example	Type	Used For
rl:Fixe:{hash}:{limit}:{window}	rl:Fixe:a1b2c3d4e5f6a7b8:100:60	String	Fixed-window counter
rl:Slid:{hash}:{limit}:{window}	rl:Slid:a1b2c3d4e5f6a7b8:60:60	ZSET	Sliding window request log
offense:{identifier}	offense:203.0.113.5	ZSET	Offense tracking for ban escalation
ban:{identifier}	ban:203.0.113.5	String+TTL	Active ban flag

---

Middleware Parameters

Parameter	Type	Required	Description
redis	redis.asyncio.Redis	Yes	Redis async client
rules	Dict[str, Tuple[int, int, str]]	Yes	Path → (limit, period, strategy)
exempt	Optional[List[str]]	No	Paths that bypass rate limits
enable_bans	bool	No	Enable/disable ban system
ban_offenses	int	No	Offenses before ban triggers
ban_window	str	No	Time window for offense accumulation
ban_length	str	No	Initial ban length
ban_max_length	str	No	Maximum exponential ban ceiling

---

Screenshot

---

Contributing

Contributions and forks are always welcome! Adapt, improve, or extend for your own needs.

---

Support

---

Parts of this code were generated/assisted by AI (Claude, Grok).