這個周末的娛樂,通用模塊,讓后端自檢,嚴格客戶端按照文檔的要求來,媽媽再也不擔心我加班了,對某些團隊來說,可能根本用不著,本是想到就嘗試一把而已。
哎,傻X的客戶端程序員,時間都去推辭扯淡打扮啦,好好的文檔還不足夠,三項而已:接口地址、請求類型、必填及選填參數,老接口調錯而錯誤不自知。
check-docking.
https://pypi.python.org/pypi/check-docking/
check-docking is a Python package that inspect request data from client for you.
介紹:
僅為總結前項目的經驗, 在后續項目上, 接口文檔的定義入庫, 結合入庫的數據生成配置文件.
根據生成的配置文件, 當客戶端與服務端對接時, 讓程序能夠自動檢查客戶端的傳入, 并將問題返回給客戶端.
該模塊的目的在于減少客戶端開發過程中, 在瑣屑問題上對服務端的干擾. 如請求類型錯誤, 多參, 少參, 重參, 數據類型錯誤, 是否必填項等等.
使用:
- 配置settings.py修改:
# check-docking配置項
IS_DATA_INSPECT = True # 僅 DEBUG 為 True 時有效
INSPECT_PROFILE = “project.check_config” # 檢測依賴配置文件模塊
- INSTALLED_APPS 增加:
‘check_docking’,
‘check_docking.stored.django’,
下面兩項非必須, 需要完成使用流程節點, 生成依賴的配置文件后啟用其一.
MIDDLEWARE_CLASSES 增加:
‘check_docking.middleware.InspectMiddleware’除了MiddleWare形式, 你也可以使用裝飾器形式:
from check_docking.inspect import debug_request
@debug_request
你還可以使用工具, 從源代碼中搜集數據并入庫, 具體可以參看project_demo/demo/demo.py中代碼.
流程:
python manage.py syncdb
python manage.py runserver
http://127.0.0.0:8000/admin 錄入數據.
python manage.py inspectprofile
文章列表