SyntaxilitY Response Manager

A unified response manager and decorators for FastAPI, Flask, Django, Machine Learning, Deep Learning, and AI inference outputs.

Installation

# FastAPI
pip install syntaxility-response-manager[fastapi]

# Flask
pip install syntaxility-response-manager[flask]

# Django / DRF
pip install syntaxility-response-manager[django]

# ML / NumPy extras
pip install syntaxility-response-manager[ml]

# Everything
pip install syntaxility-response-manager[all]

FastAPI Examples

HTTP 200 OK

from fastapi import FastAPI
from syntaxility_response_manager import SyntaxilitYResponseManager, SyntaxilitYPagination

app = FastAPI()

@app.get("/users", tags=["HTTP"])
def list_users():
    try:
        response = SyntaxilitYPagination.build_pagination_response(
            metadata=[],
            total=1,
            page=1,
            limit=10,
        )
        return SyntaxilitYResponseManager.HTTP_200_OK(
            data=response,
            message="Users fetched successfully",
        )
    except Exception as e:
        return SyntaxilitYResponseManager.HTTP_500_INTERNAL_SERVER_ERROR(
            message=str(e)
        )

HTTP 201 Created with @TryCatch

from syntaxility_response_manager import SyntaxilitYResponseManager, TryCatch

@app.post("/users", tags=["HTTP"])
@TryCatch
def create_user():
    return SyntaxilitYResponseManager.HTTP_201_CREATED(
        data={"id": 1, "name": "Alice"},
        message="User created successfully",
    )

Flask Examples

from flask import Flask
from syntaxility_response_manager import SyntaxilitYResponseManager, TryCatch

app = Flask(__name__)

@app.route("/users")
@TryCatch
def list_users():
    return SyntaxilitYResponseManager.HTTP_200_OK(
        data={"users": []},
        message="Users fetched",
    )

Django Examples

# views.py
from syntaxility_response_manager import SyntaxilitYResponseManager, TryCatch

@TryCatch
def list_users(request):
    return SyntaxilitYResponseManager.HTTP_200_OK(
        data={"users": []},
        message="Users fetched",
    )

ML / AI Examples

Paginated ML Inference

from fastapi import FastAPI, Query
from syntaxility_response_manager import SyntaxilitYResponseManager, SyntaxilitYPagination

app  = FastAPI()
data = [
    {"input": [1, 2],  "prediction": 0},
    {"input": [3, 4],  "prediction": 1},
    {"input": [5, 6],  "prediction": 1},
    {"input": [7, 8],  "prediction": 0},
    {"input": [9, 10], "prediction": 1},
]

@app.post("/predict", tags=["ML"])
def predict(page: int = Query(1, ge=1), limit: int = Query(2, ge=1)):
    params  = SyntaxilitYPagination.get_pagination_params(
        {"page": page, "limit": limit}
    )
    page, limit, skip = params["page"], params["limit"], params["skip"]
    batch  = data[skip: skip + limit]
    paging = SyntaxilitYPagination.build_pagination_response(
        metadata={}, total=len(data), page=page, limit=limit
    )
    return SyntaxilitYResponseManager.ML_INFERENCE_OK(
        predictions=batch,
        metadata={"model": "clf_v1", "version": "1.0", "pagination": paging["pagination"]},
        message="Paginated inference results",
    )

ML Error Responses

SyntaxilitYResponseManager.ML_INFERENCE_FAILED(message="GPU OOM")
SyntaxilitYResponseManager.ML_INFERENCE_PARTIAL(predictions=[0, None, 1])
SyntaxilitYResponseManager.ML_MODEL_NOT_FOUND(message="Model 'clf_v3' not found")
SyntaxilitYResponseManager.ML_INVALID_INPUT(message="Expected shape (N, 4), got (N, 3)")

Using Individual Services Directly

from syntaxility_response_manager.services import (
    FastAPIResponseService,
    FlaskResponseService,
    DjangoResponseService,
    MLResponseService,
)

# FastAPI
fastapi_svc = FastAPIResponseService()
fastapi_svc.HTTP_200_OK(data={...})

# Flask
flask_svc = FlaskResponseService()
flask_svc.HTTP_404_NOT_FOUND(message="Item not found")

# Django
django_svc = DjangoResponseService()
django_svc.HTTP_201_CREATED(data={...})

# ML
ml_svc = MLResponseService()
ml_svc.ML_INFERENCE_OK(predictions=[0, 1, 1])

License

MIT — Copyright © 2026 SyntaxilitY

Developer: Tariq Mehmood
GitHub: SyntaxilitY
LinkedIn: Tariq Mehmood