निर्भरता इंजेक्शन

नेक्सी नियंत्रकों और सेवाओं के लिए कंस्ट्रक्टर निर्भरता का समाधान करता है। एक वर्ग @Injectable() को चुनता है।

एक सेवा इंजेक्ट करें

src/apps/users/user_service.py

from nexy.decorators import Injectable  @Injectable()class UserService:    def get_all(self) -> list[dict]:        return [{"id": 1, "name": "Ada"}]

src/apps/users/user_controller.py

from nexy.decorators import Controllerfrom .user_service import UserService  @Controller("/users")class UserController:    def __init__(self, svc: UserService) -> None:        self.svc = svc     def get(self) -> list[dict]:        return self.svc.get_all()

नियंत्रक को एक मॉड्यूल में पंजीकृत करें। providers में सेवा को सूचीबद्ध करने से स्टार्टअप पर इसका उत्सुकता से समाधान हो जाता है:

src/apps/users/users_module.py

from nexy.decorators import Modulefrom .user_controller import UserControllerfrom .user_service import UserService  @Module()class UsersModule:    controllers = [UserController]    providers = [UserService]

संकल्प कैसे काम करता है

प्रत्येक __init__ पैरामीटर को उसके प्रकार के एनोटेशन से हल किया जाता है। एनोटेशन एक @Injectable() वर्ग होना चाहिए, या पैरामीटर का एक डिफ़ॉल्ट मान होना चाहिए; अन्यथा संकल्प बढ़ जाता है ValueError।
स्टार्टअप पर नियंत्रकों को Container.resolve() से त्वरित किया जाता है।
एक निर्भरता चक्र वर्ग का नामकरण RecursionError करता है।
सेवाएँ अन्य सेवाओं को किसी भी गहराई तक इंजेक्ट कर सकती हैं।

दायरा

from nexy.decorators import Injectable, Scope  @Injectable(scope=Scope.REQUEST)class CurrentUser: ...

दायरा	जीवनकाल
`Scope.SINGLETON` (डिफ़ॉल्ट)	पूरी प्रक्रिया के लिए एक उदाहरण
`Scope.REQUEST`	प्रति अनुरोध संदर्भ में एक उदाहरण
`Scope.TRANSIENT`	प्रत्येक संकल्प पर एक नया उदाहरण

कंटेनर

from nexy.decorators import Container service = Container.resolve(UserService)

@Injectable() वर्ग का निर्माण स्वयं करने से TypeError बढ़ता है: कंटेनर का अपना जीवनचक्र होता है। Container.resolve(...) का उपयोग करें या किसी अन्य कंस्ट्रक्टर के माध्यम से क्लास प्राप्त करें।

Container.clear_request_scope() वर्तमान अनुरोध के उदाहरणों को हटा देता है।

मार्ग पैरामीटर

FastAPI Depends कंस्ट्रक्टर इंजेक्शन के बगल में हैंडलर पैरामीटर के लिए सामान्य रूप से काम करता है:

from fastapi import Depends  def get(self, limit: int = Depends(pagination)) -> list[dict]: ...

सीमाएँ

कंटेनर प्रक्रिया-व्यापी है. प्रदाताओं को प्रति मॉड्यूल अलग नहीं किया जाता है, exports केवल यह तय करता है कि आयात करने वाला मॉड्यूल किन प्रदाताओं को उत्सुकता से हल करता है, और परीक्षणों में प्रदाता को स्वैप करने के लिए कोई सार्वजनिक एपीआई नहीं है। पूरी तुलना के लिए नेक्सी और NestJS देखें।

अगले चरण

GitHub पर संपादित करें