完整的 pytest 文件¶

下載最新版本為 PDF

從這裡開始¶

開始使用

操作指南¶

如何調用 pytest
- 指定要運行的測試
- 獲取有關版本、選項名稱、環境變數的幫助
- 分析測試執行時間
- 管理插件的加載
- 調用 pytest 的其他方式
如何在測試中編寫和報告斷言
- 使用 assert 語句進行斷言
- 關於預期異常的斷言
- 關於預期警告的斷言
- 利用上下文相關的比較
- 為失敗的斷言定義您自己的解釋
- 斷言內省詳情
如何使用 fixtures
- “請求” fixtures
- Autouse fixtures (您不必請求的 fixtures)
- Scope：跨類別、模組、套件或 session 共享 fixtures
- Teardown/Cleanup (又名 Fixture 最終化)
- 安全 teardowns
- 安全地運行多個 assert 語句
- Fixtures 可以內省請求測試上下文
- 使用 markers 將數據傳遞給 fixtures
- Factories 作為 fixtures
- 參數化 fixtures
- 將 marks 與參數化 fixtures 一起使用
- 模組化：從 fixture 函數中使用 fixtures
- 按 fixture 實例自動分組測試
- 在類別和模組中使用帶有 usefixtures 的 fixtures
- 在不同層級覆蓋 fixtures
- 使用來自其他專案的 fixtures
如何使用屬性標記測試函數
- 註冊 marks
- 對未知的 marks 引發錯誤
如何參數化 fixtures 和測試函數
- @pytest.mark.parametrize：參數化測試函數
- 基本 pytest_generate_tests 範例
- 更多範例
如何在測試中使用臨時目錄和檔案
- tmp_path fixture
- tmp_path_factory fixture
- tmpdir 和 tmpdir_factory fixtures
- 臨時目錄位置和保留
如何 monkeypatch/mock 模組和環境
- Monkeypatching 函數
- Monkeypatching 返回的物件：構建 mock 類別
- 全局 patch 範例：防止 “requests” 進行遠程操作
- Monkeypatching 環境變數
- Monkeypatching 字典
- API 參考
如何執行 doctests
- 編碼
- 使用 ‘doctest’ 選項
- 在失敗時繼續
- 輸出格式
- pytest 特有的功能
- 替代方案
如何重新執行失敗的測試並在測試運行之間維護狀態
- 用法
- 僅重新運行失敗或首先運行失敗的測試
- 上次運行中沒有測試失敗時的行為
- 新的 config.cache 物件
- 檢查 Cache 內容
- 清除 Cache 內容
- 逐步
如何管理日誌記錄
- caplog fixture
- Live Logs
- 自訂顏色
- 發行說明
- pytest 3.4 中的不兼容變更
如何捕獲 stdout/stderr 輸出
- 預設 stdout/stderr/stdin 捕獲行為
- 設定捕獲方法或禁用捕獲
- 使用 print 語句進行調試
- 從測試函數訪問捕獲的輸出
如何捕獲警告
- 控制警告
- @pytest.mark.filterwarnings
- 禁用警告摘要
- 完全禁用警告捕獲
- DeprecationWarning 和 PendingDeprecationWarning
- 確保代碼觸發棄用警告
- 使用 warns 函數斷言警告
- 記錄警告
- 測試中警告的其他用例
- 自訂失敗消息
- 內部 pytest 警告
- Resource Warnings
如何使用 skip 和 xfail 來處理無法成功的測試
- 跳過測試函數
- XFail：將測試函數標記為預期失敗
- 使用 parametrize 進行 Skip/xfail
如何安裝和使用插件
- 在測試模組或 conftest 檔案中請求/加載插件
- 找出哪些插件處於活動狀態
- 通過名稱停用 / 取消註冊插件
編寫插件
- 工具啟動時的插件發現順序
- conftest.py：本地每個目錄的插件
- 編寫您自己的插件
- 使您的插件可供其他人安裝
- 斷言重寫
- 在測試模組或 conftest 檔案中請求/加載插件
- 通過名稱訪問另一個插件
- 註冊自訂 markers
- 測試插件
編寫 hook 函數
- hook 函數驗證和執行
- firstresult：在第一個非 None 結果處停止
- hook wrappers：在其他 hooks 周圍執行
- Hook 函數排序 / 調用範例
- 聲明新的 hooks
- 在 pytest_addoption 中使用 hooks
- 可選地使用來自第三方插件的 hooks
- 在跨 hook 函數的項目上存儲數據
如何將 pytest 與現有的測試套件一起使用
- 使用 pytest 運行現有的測試套件
如何將基於 unittest 的測試與 pytest 一起使用
- 開箱即用的好處
- unittest.TestCase 子類別中的 pytest 功能
- 使用 marks 將 pytest fixtures 混合到 unittest.TestCase 子類別中
- 使用 autouse fixtures 和訪問其他 fixtures
如何實作 xunit 風格的 set-up
- 模組級別 setup/teardown
- 類別級別 setup/teardown
- 方法和函數級別 setup/teardown
如何設定 bash 自動完成

更多主題¶

發行公告