通过Python开发人员的眼光看清架构

对优雅的追求以及强大的语言活力创造了许多具有真正令人愉悦的API的库。 

错误的代码

干净的建筑

• 内层的优先级规则 -由内层决定与外界交互的接口；
• 依赖性规则 -依赖性应从内层指向外层。

• 过境规则；
• 依赖规则；
• 内层的优先级规则。

• 易于测试 -分别隔离各层，可以在不进行猴子修补的情况下对其进行测试，可以根据其重要性程度为不同的层设置涂层的粒度；
• 易于更改的业务规则，因为所有规则都收集在一个地方，不会散布在项目中，也不会与低级代码混合；
• 不受外部代理的影响：在某些情况下，业务逻辑与外界之间存在抽象，因此您可以更改外部源而不会影响内部层。如果您没有将业务逻辑绑定到外部代理程序的特定功能（例如数据库事务），则此方法有效。
• , , , .

, . . , . « 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 , , , .

• 越境规则：大体模型，本质上是DTO，跨越边界；
• 依赖规则：业务逻辑层独立于其他层；
• 内部层的优先级规则：业务逻辑层定义接口（RoomStorage），业务逻辑通过该接口与外界交互。