दस्तावेज़/मॉड्यूलर राउटर

गार्ड और मेटाडेटा

डेकोरेटर जो किसी मार्ग की सुरक्षा करते हैं और OpenAPI स्कीमा में उसका वर्णन करते हैं।

रक्षक

@UseGuard(*guards) एक नियंत्रक (प्रत्येक विधि) या एक विधि पर काम करता है। प्रत्येक गार्ड को FastAPI Depends के रूप में जोड़ा जाता है, इसलिए यह आवश्यक मापदंडों की घोषणा करता है और कॉल को अस्वीकार करने के लिए बढ़ाता है:

from fastapi import Header, HTTPExceptionfrom nexy.decorators import Controller, UseGuard  def require_token(x_token: str = Header(...)) -> None:    if x_token != "secret":        raise HTTPException(status_code=403, detail="Forbidden")  @Controller("/admin")@UseGuard(require_token)class AdminController:    async def get(self) -> dict:        return {"ok": True}

मिडलवेयर डेकोरेटर

@Middleware(*middlewares) उसी तरह व्यवहार करता है: ये FastAPI निर्भरताएं हैं, एएसजीआई मिडलवेयर नहीं। वास्तविक एएसजीआई मिडलवेयर के लिए कॉन्फिग या मिडिलवेयर और सुरक्षा में useMiddlewares का उपयोग करें।

रूट मेटाडेटा

@UseRoute(...) सेट OpenAPI मेटाडेटा। यह रास्ता नहीं बदलता.

प्रतिक्रियाएँ

@UseResponse(...) सेट status_code, response_class, response_model, responses और क्रमांकन विकल्प।

from nexy.decorators import Controller, UseResponse, UseRoute  @Controller("/users")class UserController:    @UseRoute(summary="List users", tags=["users"])    @UseResponse(status_code=200)    async def get(self) -> list[dict]:        return []

उत्पन्न एपीआई संदर्भ /docs पर परोसा जाता है जब तक कि useDocs = False न हो जाए।

अगले चरण

• निर्भरता इंजेक्शन
• एपीआई मार्ग: फ़ाइल-आधारित हैंडलर के लिए समान विकल्प

पृष्ठ को Markdown के रूप में कॉपी करें GitHub पर संपादित करें