पायथन डेवलपर की आंखों के माध्यम से साफ वास्तुकला

लालित्य की खोज और भाषा की शक्तिशाली गतिशीलता ने कई पुस्तकालयों को वास्तव में रमणीय एपीआई बनाया है। 

बुरा कोड

साफ वास्तुकला

• आंतरिक परत के लिए प्राथमिकता नियम - यह आंतरिक परत है जो इंटरफ़ेस को निर्धारित करता है जिसके माध्यम से यह बाहरी दुनिया के साथ बातचीत करेगा;
• निर्भरता नियम - निर्भरता को आंतरिक परत से बाहरी तक निर्देशित किया जाना चाहिए।

• सीमा पार करने का नियम;
• निर्भरता का नियम;
• आंतरिक परत का प्राथमिकता नियम।

• परीक्षण में आसानी - परतों को क्रमशः अलग किया जाता है, उन्हें बंदर-पैचिंग के बिना परीक्षण किया जा सकता है, आप उनके महत्व की डिग्री के आधार पर, अलग-अलग परतों के लिए कोटिंग सेट कर सकते हैं;
• व्यापार नियमों को बदलने में आसानी , क्योंकि वे सभी एक ही स्थान पर एकत्र किए जाते हैं, परियोजना में फैले नहीं होते हैं और निम्न-स्तरीय कोड के साथ मिश्रित नहीं होते हैं;
• बाहरी एजेंटों से स्वतंत्रता : कुछ मामलों में व्यावसायिक तर्क और बाहरी दुनिया के बीच अमूर्त की उपस्थिति आपको आंतरिक परतों को प्रभावित किए बिना बाहरी स्रोतों को बदलने की अनुमति देती है। यह काम करता है यदि आपने बाहरी एजेंटों की विशिष्ट विशेषताओं के लिए व्यावसायिक तर्क को नहीं बांधा है, उदाहरण के लिए, डेटाबेस लेनदेन;
• , , , .

, . . , . « Clean Architecture».

Python

from rentomatic.response_objects import response_objects as res

class RoomListUseCase(object):
   def __init__(self, repo):
       self.repo = repo
   def execute(self, request_object):
       if not request_object:
           return res.ResponseFailure.build_from_invalid_request_object(
               request_object)
       try:
           rooms = self.repo.list(filters=request_object.filters)
           return res.ResponseSuccess(rooms)
       except Exception as exc:
           return res.ResponseFailure.build_system_error(
               "{}: {}".format(exc.__class__.__name__, "{}".format(exc)))

repo RoomListUseCase, execute — . - , , . - . , , , repo .

from typing import Optional, List
from pydantic import BaseModel

class Room(BaseModel):
   code: str
   size: int
   price: int
   latitude: float
   longitude: float

class RoomFilter(BaseModel):
   code: Optional[str] = None
   price_min: Optional[int] = None
   price_max: Optional[int] = None

class RoomStorage:
   def get_rooms(self, filters: RoomFilter) -> List[Room]: ...

class RoomListUseCase:
   def __init__(self, repo: RoomStorage):
       self.repo = repo
   def show_rooms(self, filters: RoomFilter) -> List[Room]:
       rooms = self.repo.get_rooms(filters=filters)
       return rooms

def rool_list_use_case(filters: RoomFilter, repo: RoomStorage) -> List[Room]:
   rooms = repo.get_rooms(filters=filters)
   return rooms

from typing import List
from fastapi import FastAPI, Depends
from rentomatic import services, adapters
app = FastAPI()

def get_use_case() -> services.RoomListUseCase:
   return services.RoomListUseCase(adapters.MemoryStorage())

@app.post("/rooms", response_model=List[services.Room])
def rooms(filters: services.RoomFilter, use_case=Depends(get_use_case)):
   return use_case.show_rooms(filters)

, , , RoomStorage. , 15 , , , .

• बॉर्डर क्रॉसिंग रूल : पाइडेटिक मॉडल, जो मूल रूप से डीटीओ, क्रॉस बॉर्डर ;
• निर्भरता नियम : व्यापार तर्क परत अन्य परतों से स्वतंत्र है;
• आंतरिक परत के लिए प्राथमिकता नियम : यह व्यापार तर्क परत है जो इंटरफ़ेस (रूमस्टोरीज) को परिभाषित करता है, जिसके माध्यम से व्यापार तर्क बाहरी दुनिया के साथ बातचीत करता है।