pytest解讀fixture有效性及跨文件共享fixtures

Posted on by

fixture有效性及跨文件共享fixtures

一、fixture有效性

fixture有效性，說白瞭就是fixture函數隻有在它定義的使用范圍內，才可以被請求到。比如，在類裡面定義瞭一個fixture，那麼就隻能是這個類中的測試函數才可以請求。但是，如果一個fixture定義的范圍是整個模塊，那麼這個模塊下的每個測試函數都可以去請求。

這裡還有另一個影響fixture有效性的參數autouse=True，默認為False，等於True的話會在其他fixture之前先執行該fixture，後面有需要另起一篇，這裡簡短帶過。

另外，一個fixture函數還可以請求任何其他的fixture函數。不管被請求的那個fixture函數在哪裡定義，隻要測試函數請求瞭它們，fixture函數就可以。

看示例代碼(為瞭更直觀的看效果，在官方代碼基礎上我加瞭幾個fixture函數的print)：

#  content of test_module1.py 
import pytest
@pytest.fixture
def order():
    print("\n運行fixture函數-order")
    return []
@pytest.fixture
def outer(order, inner):
    print("運行fixture函數-outer")
    order.append("outer")
class TestOne:
    @pytest.fixture
    def inner(self, order):
        print("運行TestOne下的fixture-inner")
        order.append("one")
    def test_order(self, order, outer):
        assert order == ["one", "outer"]
class TestTwo:
    @pytest.fixture
    def inner(self, order):
        print("運行TestTwo下的fixture-inner")
        order.append("two")
    def test_order(self, order, outer):
        assert order == ["two", "outer"]

註意：

  • 這裡有一個fixture函數outer在測試類的外部
  • 另外還有2個名字都叫inner的fixture函數，分別在測試類TestOne和TestTwo中。
  • 在外部的fixture函數outer中，又請求瞭內部的fixture函數inner。

現在我隻運行類TestOne，看運行結果：

test_module1.py 
運行fixture函數-order
運行TestOne下的fixture-inner
運行fixture函數-outer
.                                                        [100%]
============================== 1 passed in 0.01s ==============================
Process finished with exit code 0

說明測試函數裡的斷言通過。測試函數執行的時候，外部outer請求的inner是TestOne下的。雖然TestOne類下的inner，隻能作用於TestOne下的測試函數。但是，由於測試函數請求瞭外部的outer，所以，外部的outer也就可以請到內部的inner。

官方還給出一個示意圖，可以結合著上述的思路，理解一下。

註意，fixture定義的范圍與它將被實例化的順序無關：實例化順序由調用邏輯強制執行

可以參考 https://www.jb51.net/article/250148.htm

二、跨文件共享fixtures

如果你把fixture函數放到conftest.py文件中，那麼在這個文件所在的整個目錄下，都可以直接請求裡面的fixture，不需要導入。

在實際場景中，我們的測試目錄或者包可能有多層的嵌套，這種情況下，每個目錄都可以有一個自己的conftest文件。比如，像這樣：

各層級裡的內容是這樣的：

tests/
    __init__.py
    conftest.py
        # content of tests/conftest.py
        import pytest
        @pytest.fixture
        def order():
            return []
        @pytest.fixture
        def top(order, innermost):
            order.append("top")
    test_top.py
        # content of tests/test_top.py
        import pytest
        @pytest.fixture
        def innermost(order):
            order.append("innermost top")
        def test_order(order, top):
            assert order == ["innermost top", "top"]
    subpackage/
        __init__.py
        conftest.py
            # content of tests/subpackage/conftest.py
            import pytest
            @pytest.fixture
            def mid(order):
                order.append("mid subpackage")
        test_subpackage.py
            # content of tests/subpackage/test_subpackage.py
            import pytest
            @pytest.fixture
            def innermost(order, mid):
                order.append("innermost subpackage")
            def test_order(order, top):
                assert order == ["mid subpackage", "innermost subpackage", "top"]

同樣的，這裡也有一張作用域邊界圖幫助理解。

知識點：

  • 頂層下的conftest裡的order和top對當前層和下層級的所有可用(一個圈就對應各自的作用域)。
  • 測試函數隻可以向上層級搜索可用的fixture函數(出圈)，但是出圈查找的過程中，不能再進到別的圈子向下查找。所以，tests/subpackage/test_subpackage.py::test_order可以找到定義在tests/subpackage/test_subpackage.py裡的innermost。但是，另一個定義在tests/test_top.py中，名字也叫innermost的fixture，對test_order來說就不可用瞭。

其實對於上述，按照我的白話來說，想用conftest裡的fixture函數，你隻能用同層級或者上層級的。但是上級裡的其他兄弟目錄或者包，以及他們的下層級的conftest，你是不能用的。

但是讀瞭官方文檔，我覺得官方的那個圈子描述挺不錯的，更嚴謹。

以上就是pytest解讀fixture有效性及跨文件共享fixtures的詳細內容，更多關於 pytest解讀fixture fixtures的資料請關註WalkonNet其它相關文章！

推薦閱讀：