什么是tox
tox官方文檔的第一句話 standardize testing in Python,意思就是說標准化python中的測試,那是不是很適合測試人員來使用呢,我們來看看他究竟是什么?
根據官方文檔的解釋,tox是一個管理測試虛擬環境的命令行工具,可以支持穿件隔離的python環境,在里面可以安裝不同版本的python解釋器和項目的各種依賴庫,可以進行自動化測試、打包以及持續集成。
tox能做什么
- 創建測試虛擬環境
- 運行靜態代碼分析與測試工具
- 自動化構建包
- 針對 tox 構建的軟件包運行測試
- 檢查軟件包是否能在不同的 Python 版本/解釋器中順利安裝
- 統一持續集成(CI)和基於命令行的測試
怎么配置tox
安裝tox
使用pip install tox
安裝,在命令行執行tox -e envname運行指定的測試環境
tox配置
tox的行為既可以通過命令行來控制也可以通過配置文件進行控制,支持有以下三種形式的配置文件
-
pyproject.toml
-
tox.ini
-
setup.cfg
# tox (https://tox.readthedocs.io/) is a tool for running tests
# in multiple virtualenvs. This configuration file will run the
# tests suite on all supported python versions. To use it, "pip install tox"
# and then run "tox" from this directory.
[tox]
envlist = py36
skipsdist = True
# 設置pip源和依賴版本
indexserver =
default = http://mirrors.aliyun.com/pypi/simple/
[testenv]
deps =
pytest
records
pymysql
jinja2
requests
objectpath
arrow
pytest-html
redis
install_command = pip install --trusted-host mirrors.aliyun.com {opts} {packages}
[testenv:dev]
setenv = env = dev
; 告訴tox在每個測試環境里運行pytest
commands = pytest --junitxml=junit-{envname}.xml
;只運行廣告相關的測試用例
[testenv:t_a]
setenv = env = dev
commands = pytest -v tests/ad--junitxml=junit-{envname}.xml
;只運行測試環境APP相關測試用例
;只運行APP相關測試用例
[testenv:t_i]
setenv = env = dev
commands = pytest -v tests/ivwen --junitxml=junit-{envname}.xml
[testenv:t1_i]
setenv = env = t1
commands = pytest -v tests/ivwen --junitxml=junit-{envname}.xml
[testenv:pro]
setenv = env = pro
; 通過command line往環境變量里寫測試還是線上的標識,config根據標識從環境變量里去讀取指定文件
; 或者通過插件的形式,能夠配置各個環境的文件,根據命令行參數指定把那個文件放入指定讀取目錄
command = pytest
[testenv:smoke]
[pytest]
markers =
smoke
get
addopts = -rsxX -l --tb=short --strict
xfail_strict = true
minversion = 3.0
norecursedirs = .* venv src *.egg dist build
testpaths = tests
python_classes = *Test Test* *Suit
junit_family=xunit1
以上配置解釋如下:
- [tox]節點是對tox進行配置
envlist指定環境列表,多個環境用逗號隔開,比如py36,py37
skipsdist 指定tox在運行過程中跳過打包環節,因為當前這個項目沒有打包的需求,所以這里設置為true,這個和自動化測試框架的設計有關。
indexserver 指定pip的安裝源
- [testenv]節點是對測試環境進行配置,這個是根測試環境的配置,下面還可以對不同的測試環境進行配置,都可以繼承這個節點
deps 指定項目的python依賴的第三方包
install_command 定義pip安裝命令參數
- [testenv:dev]這個節點是定義測試環境,繼承根環境配置
setenv 設置環境變量,在項目中可以讀取環境變量,從而決定要運行哪個環境的配置,比如tox -e dev,意思就是說在測試環境運行測試用例,tox -e prod在生產環境運行測試用例
commands 指定pytest的運行方式,其他環境的節點配置與此相似。
- [pytest]節點可以對pytest進行配置
- addopts 指定pytest的命令行參數
- xfail_strict 設置預期失敗的case如果通過了,則標記為失敗
- minversion 指定tox的最小版本
- norecursedirs 指定哪些目錄不用遞歸查找測試用例
- testpaths 指定測試用例的搜索目錄
- python_classes 指定測試用例的搜索規則
當然以上的配置只是tox一部分,還有很多,關注官方文檔
tox項目實戰
下面我們以 tox、pytest打造一個自動化測試框架
項目搭建
-
新建一個api-auto-test文件夾,在文件夾里添加一個tox.ini文件,輸入上面的配置
-
再分別新建一個src和tests目錄,src用於存放封裝的一些共有的內容,tests用於存放測試用例
-
src目錄內容如下
ad和biz是對不同業務進行的封裝,里面包括接口調用以及數據庫相關操作
common是各個業務模塊公共的部分,包括請求發送、數據庫鏈接基礎操作封裝、配置等,主要來看一下config的里的內容:
class Config:
'''公共配置'''
class DevConfig(Config):
'''測試環境配置'''
class ProdConfig(Config):
'''生產環境配置'''
# 環境切換
_MAPPING = {
'dev': DevConfig,
't1': T1Config,
'pro': ProConfig,
}
# 這里根據tox設置的環境變量,來決定使用哪一個環境的配置,從而實現不同環境環境的切換
config = _MAPPING.get(os.getenv("env"), DevConfig)
-
運行測試用例
tox -e dev
以上是執行過程以及測試結果,會生成junit.xml格式的測試報告,當然也可以使用pytest-html或者其他測試報告,都很方便。
歡迎大家去 我的博客 瞅瞅,里面有更多關於測試實戰的內容哦!!