fastapi-decorators

What it is and what it does

fastapi-decorators provides a @depends decorator that wraps FastAPI's Depends() mechanism, letting you build reusable decorators that inject dependencies into endpoints without repeating dependency resolution logic. Instead of manually threading FastAPI dependencies through custom decorators, you annotate a function with @depends and use it directly as a decorator on your route handlers.

The package supports three main patterns: simple decorators that run side effects (logging, auditing), decorator factories that accept parameters (rate limiting, authorization scopes), and wrapper decorators that intercept endpoint execution while still accessing injected dependencies (caching, error handling). It integrates directly with FastAPI's dependency system, so decorated endpoints appear correctly in auto-generated API documentation.

Use it for

• Build an authentication decorator that checks OAuth2 tokens and raises 401/403 errors without duplicating token resolution logic across routes.
• Create a rate-limiting decorator factory that accepts max_calls and period parameters and applies them to individual endpoints.
• Implement a caching decorator that wraps expensive operations and uses a Depends()-injected cache backend to store and retrieve results.
• Add request logging or audit trails by decorating endpoints to capture request metadata and write to a database via injected Session.
• Enforce custom response headers or modify responses by decorating endpoints with a decorator that receives the Response object via Depends().

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

fastapi-decorators on PyPI

Before you install

Low friction: pure Python wheel with a single runtime dependency on fastapi. Actively maintained with recent commits and a stable beta status.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

from fastapi import FastAPI, Depends, HTTPException
from fastapi_decorators import depends

@depends
def require_auth(token: str = Depends(lambda: "token")):
    if not token:
        raise HTTPException(status_code=401)

app = FastAPI()

@app.get("/items")
@require_auth
def get_items():
    return {"items": []}

Package facts

Evidence: fastapi_decorators-1.0.20-py3-none-any.whl

Tags

More Software Development packages

See also fast-depends · fastapi-injectable · fastapi-versioning · fastapi-cache2 · decorator · fastapi-limiter · uncalled-for · essentials · slowapi · fan-tools