pytest檔案內建fixture的request詳情

2022-08-08 22:01:34

前言

request 是 pytest 的內建 fixture ， "為請求物件提供對請求測試上下文的存取權，並且在fixture被間接引數化的情況下具有可選的“param”屬性。"這是官方檔案對request的描述，可參考的檔案不多。

一、FixtureRequest

FixtureRequest 是來自 fixture 或者測試用例的請求，它有存取測試上下文的許可權, FixtureRequest_pytest.fixtures pytest documentation。

class FixtureRequest：請求物件提供對請求的測試上下文的存取，並且具有可選的 param 屬性，以防裝置被間接引數化。
fixturename：正在為其執行此請求的 fixture 名稱。
scope：作用域字串，“function”、“class”、“module”、“session”之一。
fixturenames：此請求中所有活動狀態的 fixture 的名稱。
node：基礎集合節點（取決於當前請求範圍）。
config：與此請求關聯的 pytest 設定物件。
function：如果請求具有每個函數範圍，則測試函數物件。
cls：類（可以是None），其中收集了測試函數。
instance：在其上收集測試函數的範例（可以是None）。
module：收集測試函數的Python模組物件。
fspath：收集此測試的測試模組的檔案系統路徑。
keywords：基礎節點的關鍵字/標記詞典。
session：Pytest對談物件。
addfinalizer(finalizer: 新增finalizer/teardown函數，以便在請求的測試上下文中的最後一個測試完成執行後呼叫。
applymarker(marker)：對單個測試函數呼叫應用標記。

如果不希望在所有函數呼叫上都有關鍵字/標記，則此方法非常有用。

引數：

marker -- A _pytest.mark.MarkDecorator 呼叫建立的物件 pytest.mark.NAME(...) .
raiseerror(msg: Optional[str]) ：使用給定的訊息引發FixtureLookupError。
getfixturevalue(argname: str) 動態執行命名的fixture函數。

如果可能，建議通過函數引數宣告fixtures。但是，如果您只能在測試設定時決定是否使用另一個fixture，那麼您可以使用此函數在fixture或測試函數體中檢索它。
引發：pytest.FixtureLookupError -- 如果找不到給定的固定裝置。
摺疊

二、request.param

前面講fixture引數化的時候，有接觸到 "request.param" 用於獲取測試的請求引數，以下範例

import pytest
# 測試資料
test_data = ["user1", "user2"]

@pytest.fixture(params=test_data)
def register_users(request):
     # 獲取當前的測試資料
     user = request.param
     print("n拿著這個賬號去註冊：%s"%user)
     result = "success"
     return user, result
def test_register(register_users):
    user, result = register_users
    print("在測試用例裡面裡面獲取到當前測試資料：%s"%user)
    print(result)
    assert result == "success"

此案例裡面我們可以在fixture引數化的時候，通過request.param獲取到測試的請求引數，但是在用例裡面用 request.param 卻不能獲取到測試的請求引數

def test_register_x(register_users, request):
    print(request.param)

這樣執行，會拋異常：'FixtureRequest' object has no attribute 'param'

#拿著這個賬號去註冊：user1
F
register_users = ('user1', 'success')
request = <FixtureRequest for <Function test_register_x[user1]>>
 
    def test_register_x(register_users, request):
>       print(request.param)
E       AttributeError: 'FixtureRequest' object has no attribute 'param'
 
D:test_x7.py:27: AttributeError

三、request.config

request.config 是獲取測試的組態檔引數，這個在前面講命令列引數的時候有用到過.

在 conftest.py 寫一個 hook函數， pytest_addoption 的作用是用於獲取命令列引數，request.config 用於讀取測試的設定資料

import pytest
def pytest_addoption(parser):
    parser.addoption(
        "--cmdopt", action="store", default="type1", help="my option: type1 or type2"
    )
@pytest.fixture
def cmdopt(request):
    return request.config.getoption("--cmdopt")

於是在測試用例裡面可以通過 request.config 來獲取到設定引數，也可以通過自己定義的 cmdopt 來獲取。

import pytest
def test_answer_1(request):
    type = request.config.getoption("--cmdopt")
    print("獲取到命令列引數：%s" % type)
def test_answer_2(cmdopt):
    print("獲取到命令列引數：%s" % cmdopt)

四、request.module

fixture 函數可以通過接受 request 物件來反向獲取請求中的測試函數、類或模組上下文，進一步擴充套件之前的 smtp fixture範例，讓我們從fixture的測試模組讀取可選的伺服器URL
這是官方檔案的一個範例

# conftest.py
@pytest.fixture(scope="module")
def smtp(request):
    server = getattr(request.module, "smtpserver", "smtp.qq.com")
    print("fixture 獲取到的server :%s" %server)
    smtp = smtplib.SMTP(server, 587, timeout=5)
    yield smtp
    print("完成 %s (%s)" % (smtp, server))
    smtp.close()

我們使用request.module屬性來從測試模組中選擇性地獲取smtpserver屬性
快速建立另一個測試模組，在其模組名稱空間中實際設定伺服器URL，新建一個test_anothersmtp.py檔案，輸入以下程式碼：

# test_anothersmtp.py
smtpserver = "mail.python.org"
 
def test_showhelo(smtp):
    print("case showhelo")

這時候執行用例，會獲取到 test_anothersmtp.py 裡面定義的 smtpserver

============================= test session starts =============================
platform win32 -- Python 3.6.6, pytest-4.5.0, py-1.9.0, pluggy-0.13.1
Test order randomisation NOT enabled. Enable with --random-order or --random-order-bucket=<bucket_type>
rootdir: D:
rerunfailures-9.1, xdist-2.1.0
collected 1 item
........module2test_anothersmtp.py 
fixture 獲取到的server :mail.python.org
case showhelo
.完成 <smtplib.SMTP object at 0x000001D00754CB00> (mail.python.org)
========================== 1 passed in 0.64 seconds ===========================

用例裡面沒定義 smtpserver 的話，會用預設屬性 "smtp.qq.com"

五、request的相關成員物件

在conftest.py 寫一個fixture 可以獲取到request的一些成員物件相關資訊

# conftest.py
 
@pytest.fixture(autouse=True)
def print_request(request):
    print("n=======================request start=================================")
    print(request.module)
    print(request.function)
    print(request.cls)
    print(request.fspath)
    print(request.fixturenames)
    print(request.fixturename)
    print(request.scope)
    print("n=======================request end=================================")

使用命令列"pytest -s text_x.py"執行用例,會看到列印的結果：

test_1.py
=======================request start=================================
<module 'web.cases.module2.test_1' from 'D:\web\cases\module2\test_1.py'>
<function test_answer_1 at 0x0000012D1C9FD9D8>
None
D:webcasesmodule2test_1.py
['_verify_url', 'base_url', '__pytest_repeat_step_number', 'show_request', 'request']
show_request
function
=======================request end=================================
獲取到命令列引數：type1
.
=======================request start=================================
<module 'web.cases.module2.test_1' from 'D:\web\cases\module2\test_1.py'>
<function test_answer_2 at 0x0000012D1C9FD730>
None
D:webcasesmodule2test_1.py
['_verify_url', 'base_url', '__pytest_repeat_step_number', 'show_request', 'cmdopt', 'request']
show_request
function
=======================request end=================================

在列印測試用例的詳細紀錄檔的時候，還是很有用的。

到此這篇關於pytest檔案內建fixture的request詳情的文章就介紹到這了,更多相關pytest fixture內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！