pytest文檔12-skip跳過用例


前言

pytest.mark.skip可以標記無法在某些平台上運行的測試功能,或者您希望失敗的測試功能

skip意味着只有在滿足某些條件時才希望測試通過,否則pytest應該跳過運行測試。 常見示例是在非Windows平台上跳過僅限Windows的測試,或跳過測試依賴於當前不可用的外部資源(例如數據庫)。

xfail意味着您希望測試由於某種原因而失敗。 一個常見的例子是對功能的測試尚未實施,或尚未修復的錯誤。 當測試通過時盡管預計會失敗(標有pytest.mark.xfail),它是一個xpass,將在測試摘要中報告。

pytest計數並分別列出skip和xfail測試。 未顯示有關跳過/ xfailed測試的詳細信息默認情況下,以避免混亂輸出。 您可以使用-r選項查看與“short”字母對應的詳細信息顯示在測試進度中

pytest -rxXs # show extra info on xfailed, xpassed, and skipped tests

有關-r選項的更多詳細信息,請運行pytest -h

skip

跳過測試函數的最簡單方法是使用跳過裝飾器標記它,可以傳遞一個可選的原因

@pytest.mark.skip(reason="no way of currently testing this")
def test_the_unknown():
    ...

或者,也可以通過調用來在測試執行或設置期間強制跳過pytest.skip(reason)功能:

def test_function():
    if not valid_config():
        pytest.skip("unsupported configuration")

也可以使用pytest.skip(reason,allow_module_level = True)跳過整個模塊級別:

import pytest
if not pytest.config.getoption("--custom-flag"):
    pytest.skip("--custom-flag is missing, skipping tests", allow_module_level=True)

當在導入時間內無法評估跳過條件時,命令性方法很有用。

skipif

如果您希望有條件地跳過某些內容,則可以使用skipif代替。 這是標記測試的示例在Python3.6之前的解釋器上運行時要跳過的函數

import sys
@pytest.mark.skipif(sys.version_info < (3,6),
reason="requires python3.6 or higher")
def test_function():
    ...

如果條件在收集期間評估為True,則將跳過測試函數,具有指定的原因使用-rs時出現在摘要中。

您可以在模塊之間共享skipif標記。參考以下案例

# content of test_mymodule.py
import mymodule
minversion = pytest.mark.skipif(mymodule.__versioninfo__ < (1,1),
reason="at least mymodule-1.1 required")
@minversion
def test_function():
    ...

您可以導入標記並在另一個測試模塊中重復使用它:

# test_myothermodule.py
from test_mymodule import minversion
@minversion
def test_anotherfunction():
    ...

對於較大的測試套件,通常最好有一個文件來定義標記,然后一致適用於整個測試套件。

或者,您可以使用條件字符串而不是布爾值,但它們之間不能輕易共享它們支持它們主要是出於向后兼容的原因

skip類或模塊

您可以在類上使用skipif標記(與任何其他標記一樣):

@pytest.mark.skipif(sys.platform == 'win32',
reason="does not run on windows")
class TestPosixCalls(object):
    def test_function(self):
        "will not be setup or run under 'win32' platform"

如果條件為True,則此標記將為該類的每個測試方法生成跳過結果

警告:強烈建議不要在使用繼承的類上使用skipif。 pytest中的一個已知錯誤標記可能會導致超類中的意外行為。

如果要跳過模塊的所有測試功能,可以在全局級別使用pytestmark名稱

# test_module.py
pytestmark = pytest.mark.skipif(...)

如果將多個skipif裝飾器應用於測試函數,則如果任何跳過條件為真,則將跳過它

skip文件或目錄

有時您可能需要跳過整個文件或目錄,例如,如果測試依賴於特定於Python的版本功能或包含您不希望pytest運行的代碼。 在這種情況下,您必須排除文件和目錄來自收藏。 有關更多信息,請參閱自定義測試集合。

skip缺少導入依賴項

您可以在模塊級別或測試或測試設置功能中使用以下幫助程序

docutils = pytest.importorskip("docutils")

如果無法在此處導入docutils,則會導致測試跳過結果。 你也可以跳過庫的版本號

docutils = pytest.importorskip("docutils", minversion="0.3")

將從指定模塊的__version__屬性中讀取版本。

概要

這是一個快速指南,介紹如何在不同情況下跳過模塊中的測試

1.無條件地跳過模塊中的所有測試:

pytestmark = pytest.mark.skip("all tests still WIP")

2.根據某些條件跳過模塊中的所有測試

pytestmark = pytest.mark.skipif(sys.platform == "win32", "tests for linux
˓→ only"

3.如果缺少某些導入,則跳過模塊中的所有測試

pexpect = pytest.importorskip("pexpect")

---------------------------------pytest結合selenium自動化完整版-------------------------

全書購買地址 https://yuedu.baidu.com/ebook/902224ab27fff705cc1755270722192e4536582b

作者:上海-悠悠 QQ交流群:874033608

也可以關注下我的個人公眾號:yoyoketang


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM