🤚🏻 🌂 🤹🏾 パイテスト ⌚️ 👩🏿‍🤝‍👩🏾 ✊🏻

まえがき

歴史的な職業によると、私はSQL-schikです。しかし、運命は私をBigDataに連れて行き、その後、苦労しました-Java、Python、および関数型プログラミングを習得しました（Scalaの学習がリストに載っています）。実際、プロジェクトの一部で、Pythonコードをテストする必要が生じました。 QAのスタッフはこれらの目的のためにPyTestに助言しましたが、この獣がなぜ良いのかを明確に答えることは難しいと感じました。残念ながら、ロシア語のセグメントでは、この問題に関する情報はそれほど多くありません。Yandexでどのように使用されているか、すべてが良い方法です。同時に、この記事で説明されているものは、この道に沿って旅を始める人にとってはかなり複雑に見えます。公式のドキュメントは言うまでもありませんが、モジュール自体を他のソースから見つけた後に初めて意味がありました。私は、興味深いことはそこに書かれているとは言いませんが、残念ながら、最初はまったくそうではありません。

Pythonユニットテスト

それが何であり、なぜ私が伝えるべきポイントが見えないのか-ウィキペディアはまだもっと知っています。 Pythonの既存のモジュールに関しては、 Habréで詳しく説明されています。

必要な知識の紹介

説明した時点で、Pythonの私の知識は非常に表面的でした-いくつかの簡単なモジュールを作成し、標準的なものを知っていました。しかし、PyTestとの衝突で、こことここ、そしてyield構造体で知識ベースをデコレーターで補充する必要がありました。

PyTestの長所と短所

1）APIからの独立（定型なし）。同じunittestでコードがどのように見えるか：

コード

import unittest class TestUtilDate(unittest.TestCase): def setUp(self): #init_something() pass def tearDown(self): #teardown_something() pass def test_upper(self): self.assertEqual('foo'.upper(), 'FOO') def test_isupper(self): self.assertTrue('FOO'.isupper()) def test_failed_upper(self): self.assertEqual('foo'.upper(), 'FOo') if __name__ == '__main__': suite = unittest.TestLoader().loadTestsFromTestCase(TestUtilDate) unittest.TextTestRunner(verbosity=2).run(suite)

PyTestでも同じこと：

コード

 import pytest def setup_module(module): #init_something() pass def teardown_module(module): #teardown_something() pass def test_upper(): assert 'foo'.upper() == 'FOO' def test_isupper(): assert 'FOO'.isupper() def test_failed_upper(): assert 'foo'.upper() == 'FOo'

2）詳細レポート。 JUnitXMLへのアップロードを含む（Jenkinsとの統合用）。レポート自体のタイプは、追加のモジュールによって変更できます（色を含む）（それらについては後で別途説明します）。まあ、一般的には、コンソールのカラーレポートの方が便利です。赤のFAILEDはすぐに表示されます。

3）便利なアサート（Pythonの標準）。異なるassert'ovの束全体を覚えておく必要はありません。

4）すべてのレベルの動的なフィクスチャ。これは、自動的に特定のテストのために呼び出すことができます。

5）フィクスチャの追加機能（戻り値、ファイナライザ、スコープ、リクエストオブジェクト、自動使用、ネストされたフィクスチャ）

6）テストのパラメーター化、つまり、異なるパラメーターセットを使用した同じテストの起動。一般的に、これはパラグラフ5「追加機能フィクスチャ」を指しますが、別のパラグラフに値するほど機会が多いのです。

7）マーク。テストをスキップしたり、テストを失敗としてマークしたり（これは開発中に便利な予想される動作です）、テストスイートに名前を付けて名前でのみ実行できるようにします。

8）プラグイン。このモジュールには、個別にインストールできる追加モジュールのかなり大きなリストがあります。

9）unittestおよびnoseで記述されたテストを実行する機能、つまり、それらとの完全な下位互換性。

欠点については、多くはありませんが、次のように言えます。

1）追加レベルのネストの欠如：テストのモジュール、クラス、メソッド、関数には、適切なレベルがあります。ただし、同じ関数が複数のテストケースを持つことができる場合（たとえば、戻り値とエラーのチェック）、ロジックには追加レベルのテストケースが必要です。これは、追加のモジュール（プラグイン）pytest-describeによって部分的に補われますが、適切なレベルのフィクスチャーがないという問題が発生します（scope =“ describe”）。もちろん、これで生きることはできますが、状況によっては、PyTestの主な原則「単純さと便利さのためのすべて」に違反する可能性があります。

2）生産を含む、モジュールの個別のインストールの必要性。それでも、unittestとdoctestは基本的なPythonツールキットの一部であり、追加のジェスチャーは必要ありません。

3）PyTestを使用するには、同じユニットテストよりもPythonの知識が少し必要です（「必要な知識の概要」を参照）。

カットの下のモジュールとその機能の詳細な説明。

テストを実行する

unittestの場合、メイン関数呼び出しが使用されます。したがって、起動は「python unittest_example.py」という形式になります。同時に、テストスイートを実行するには、TestSuitでそれらを個別に組み合わせて実行する必要があります。 PyTestは、フォルダ内のすべてのファイル（再帰的にサブフォルダをトラバースする）または指定されたファイルについて、独自の名前test_ *（クラス名のTest_ *）ですべてのテストを収集します。つまり、呼び出し例は「py.test -v pytest_example.py」のようになります

基本的な備品

この場合、フィクスチャは、テストに適切な環境を作成するために起動される関数とメソッドを呼び出します。 unittestと同様に、PyTestにはすべてのレベルのフィクスチャの名前があります。

 import pytest def setup(): print ("basic setup into module") def teardown(): print ("basic teardown into module") def setup_module(module): print ("module setup") def teardown_module(module): print ("module teardown") def setup_function(function): print ("function setup") def teardown_function(function): print ("function teardown") def test_numbers_3_4(): print "test 3*4" assert 3*4 == 12 def test_strings_a_3(): print "test a*3" assert 'a'*3 == 'aaa' class TestUM: def setup(self): print ("basic setup into class") def teardown(self): print ("basic teardown into class") def setup_class(cls): print ("class setup") def teardown_class(cls): print ("class teardown") def setup_method(self, method): print ("method setup") def teardown_method(self, method): print ("method teardown") def test_numbers_5_6(self): print "test 5*6" assert 5*6 == 30 def test_strings_b_2(self): print "test b*2" assert 'b'*2 == 'bb'

printコマンドによって生成されたすべての出力を表示するには、-sフラグを指定してテストを実行する必要があります。

 tmp>py.test -s basic_fixtures.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 rootdir: tmp/, inifile: collected 4 items basic_fixtures.py module setup function setup basic setup into module test 3*4 .basic teardown into module function teardown function setup basic setup into module test a*3 .basic teardown into module function teardown class setup method setup basic setup into class test 5*6 .basic teardown into class method teardown method setup basic setup into class test b*2 .basic teardown into class method teardown class teardown module teardown ========================== 4 passed in 0.03 seconds

この例は、各フィクスチャレベルの階層と再現性を完全に示しています（たとえば、setup_functionは各関数呼び出しの前に呼び出され、setup_moduleはモジュール全体に対して1回だけ呼び出されます）。デフォルトのフィクスチャレベルが関数/メソッド（フィクスチャのセットアップと分解）であることもわかります。

拡張フィクスチャ

問題は、一部のテストで特定の環境が必要であるが、他のテストでは必要ない場合はどうすればよいかということです。異なるモジュールまたはクラスに広がりますか？それは非常に快適で美しく見えません。拡張PyTestフィクスチャが役立ちます。

したがって、PyTestで拡張フィクスチャを作成するには、次のものが必要です。

1）pytestモジュールをインポートする

2）@ pytest.fixture（）デコレータを使用して、この関数がフィクスチャであることを示します

3）フィクスチャ（スコープ）のレベルを設定します。可能な値は、「関数」、「cls」、「モジュール」、「セッション」です。デフォルト値=「関数」。

4）このフィクスチャのティアダウンを呼び出す必要がある場合、ファイナライザを追加する必要があります（フィクスチャに渡されたリクエストオブジェクトのaddfinalizerメソッドまたはyield構成体を使用して）

5）このフィクスチャの名前を関数パラメーターのリストに追加します

 import pytest @pytest.fixture() def resource_setup(request): print("resource_setup") def resource_teardown(): print("resource_teardown") request.addfinalizer(resource_teardown) def test_1_that_needs_resource(resource_setup): print("test_1_that_needs_resource") def test_2_that_does_not(): print("test_2_that_does_not") def test_3_that_does_again(resource_setup): print("test_3_that_does_again")

以下を開始します。

 tmp>py.test -s extended_fixture.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 rootdir: tmp/, inifile: collected 3 items extended_fixture.py resource_setup test_1_that_needs_resource .resource_teardown test_2_that_does_not .resource_setup test_3_that_does_again .resource_teardown ========================== 3 passed in 0.01 seconds

高度なフィクスチャを呼び出す

高度なフィクスチャは、さらに2つの方法で呼び出すことができることに注意してください。

1）デコレータ@ pytest.mark.usefixtures（）でテストを装飾する

2）フィクスチャに自動使用フラグを使用します。ただし、予期しないテスト動作が発生する可能性があるため、この機能は注意して使用する必要があります。

3）テストパラメータを介した上記の方法

前の例を次に示します。

 import pytest @pytest.fixture() def resource_setup(request): print("resource_setup") def resource_teardown(): print("resource_teardown") request.addfinalizer(resource_teardown) @pytest.fixture(scope="function", autouse=True) def another_resource_setup_with_autouse(request): print("another_resource_setup_with_autouse") def resource_teardown(): print("another_resource_teardown_with_autouse") request.addfinalizer(resource_teardown) def test_1_that_needs_resource(resource_setup): print("test_1_that_needs_resource") def test_2_that_does_not(): print("test_2_that_does_not") @pytest.mark.usefixtures("resource_setup") def test_3_that_does_again(): print("test_3_that_does_again")

以下を開始します。

 tmp>py.test -s call_extended_fixtures.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 rootdir: tmp/, inifile: collected 3 items call_extended_fixtures.py another_resource_setup_with_autouse resource_setup test_1_that_needs_resource .resource_teardown another_resource_teardown_with_autouse another_resource_setup_with_autouse test_2_that_does_not .another_resource_teardown_with_autouse another_resource_setup_with_autouse resource_setup test_3_that_does_again .resource_teardown another_resource_teardown_with_autouse ========================== 3 passed in 0.01 seconds

分解拡張器具

上記のように、特定の拡張フィクスチャに対してティアダウンを呼び出す必要がある場合、2つの方法で実装できます。

1）ファイナライザをフィクスチャに追加します（フィクスチャに渡されたリクエストオブジェクトのaddfinalizerメソッドを介して）

2）yieldコンストラクトを使用して（PyTestバージョン2.4以降）

拡張フィクスチャを作成する例で検討した最初の方法。次に、yieldを使用して同じ機能を実証します。関数をフィクスチャとして装飾するときにyieldを使用するには、@ pytest.fixture（）ではなく@ pytest.yield_fixture（）デコレータを使用する必要があることに注意してください。

 import pytest @pytest.yield_fixture() def resource_setup(): print("resource_setup") yield print("resource_teardown") def test_1_that_needs_resource(resource_setup): print("test_1_that_needs_resource") def test_2_that_does_not(): print("test_2_that_does_not") def test_3_that_does_again(resource_setup): print("test_3_that_does_again")

ファイナライザオプションと一致するため、テキストに結論を追加しません。

フィクスチャの戻り値

オプションとして、PyTestのフィクスチャはreturnを介してテストに何かを返すことができます。何らかの状態値またはオブジェクト（ファイルなど）になります。

 import pytest @pytest.fixture(scope="module") def resource_setup(request): print("\nconnect to db") db = {"Red":1,"Blue":2,"Green":3} def resource_teardown(): print("\ndisconnect") request.addfinalizer(resource_teardown) return db def test_db(resource_setup): for k in resource_setup.keys(): print "color {0} has id {1}".format(k, resource_setup[k]) def test_red(resource_setup): assert resource_setup["Red"] == 1 def test_blue(resource_setup): assert resource_setup["Blue"] != 1

以下を開始します。

 tmp>py.test -v -s return_value.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 3 items return_value.py::test_db connect to db color Blue has id 2 color Green has id 3 color Red has id 1 PASSED return_value.py::test_red PASSED return_value.py::test_blue PASSED disconnect ========================== 3 passed in 0.02 seconds

フィクスチャレベル（スコープ）

フィクスチャレベルは、「関数」、「cls」、「モジュール」、「セッション」の値を取ります。デフォルト値=「関数」\

機能-各テストのフィクスチャ実行

cls-各クラスのフィクスチャ実行

モジュール-各モジュールに対してフィクスチャが起動されます

セッション-フィクスチャはセッションごとに起動されます（つまり、実際には1回）

たとえば、前の例では、スコープを機能に変更し、テストごとにデータベース接続を呼び出して切断できます。

 import pytest @pytest.fixture(scope="function") def resource_setup(request): print("\nconnect to db") db = {"Red":1,"Blue":2,"Green":3} def resource_teardown(): print("\ndisconnect") request.addfinalizer(resource_teardown) return db def test_db(resource_setup): for k in resource_setup.keys(): print "color {0} has id {1}".format(k, resource_setup[k]) def test_red(resource_setup): assert resource_setup["Red"] == 1 def test_blue(resource_setup): assert resource_setup["Blue"] != 1

 tmp>py.test -v -s scope.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 3 items scope.py::test_db connect to db color Blue has id 2 color Green has id 3 color Red has id 1 PASSED disconnect scope.py::test_red connect to db PASSED disconnect scope.py::test_blue connect to db PASSED disconnect ========================== 3 passed in 0.02 seconds

フィクスチャは、PyTestによって自動的にインポートされるconftest.pyファイルでも説明できます。この場合、フィクスチャには任意のレベルを設定できます（このファイルの説明を介してのみ、「セッション」レベルのフィクスチャを作成できます）。

たとえば、conftest.pyファイルと2つのテストファイルで個別のセッションスコープフォルダーを作成します（PyTestがモジュールを自動的にインポートするには、モジュールの名前がtest_で始まる必要があります。この動作は変更できますが）。

conftest.py：

 import pytest @pytest.fixture(scope="session", autouse=True) def auto_session_resource(request): """ Auto session resource fixture """ print("auto_session_resource_setup") def auto_session_resource_teardown(): print("auto_session_resource_teardown") request.addfinalizer(auto_session_resource_teardown) @pytest.fixture(scope="session") def manually_session_resource(request): """ Manual set session resource fixture """ print("manually_session_resource_setup") def manually_session_resource_teardown(): print("manually_session_resource_teardown") request.addfinalizer(manually_session_resource_teardown) @pytest.fixture(scope="function") def function_resource(request): """ Function resource fixture """ print("function_resource_setup") def function_resource_teardown(): print("function_resource_teardown") request.addfinalizer(function_resource_teardown)

test_session_scope1.py

 import pytest def test_1_that_does_not_need_session_resource(): print("test_1_that_does_not_need_session_resource") def test_2_that_does(manually_session_resource): print("test_2_that_does")

test_session_scope2.py

 import pytest def test_3_that_uses_all_fixtures(manually_session_resource, function_resource): print("test_2_that_does_not")

以下を開始します。

 tmp\session scope>py.test -s -v ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\pro ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp\session scope, inifile: collected 3 items test_session_scope1.py::test_1_that_does_not_need_session_resource auto_session resource_setup test_1_that_does_not_need_session_resource PASSED test_session_scope1.py::test_2_that_does manually_session_resource_setup test_2_that_does PASSED test_session_scope2.py::test_3_that_uses_all_fixtures function_resource_setup test_2_that_does_not PASSEDfunction_resource_teardown manually_session_resource_teardown auto_session_resource_teardown ========================== 3 passed in 0.02 seconds

また、PyTestが--fixtures入力パラメーターをサポートし、呼び出された場合、conftest.py（docstringがあった）で説明されているものを含む、使用可能なすべてのフィクスチャーを返します。

 tmp\session scope>py.test --fixtures ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 rootdir: tmp\session scope, inifile: collected 3 items cache Return a cache object that can persist state between testing sessions. …..... path object. ----------------------- fixtures defined from conftest ------------------------ manually_session_resource Manual set session resource fixture function_resource Function resource fixture auto_session_resource Auto session resource fixture ============================== in 0.07 seconds

リクエストオブジェクト

拡張フィクスチャを作成する例では、リクエストパラメータを渡しました。これは、addfinalizerメソッドを通じてファイナライザーを追加するために行われました。ただし、このオブジェクトには多くの属性と他のメソッド（公式APIの完全なリスト）もあります。

 import pytest @pytest.fixture(scope="function") def resource_setup(request): print request.fixturename print request.scope print request.function.__name__ print request.cls print request.module.__name__ print request.fspath def test_1(resource_setup): assert True class TestClass(): def test_2(self, resource_setup): assert True

以下を開始します。

 tmp>py.test -v -s request_object.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 2 items request_object.py::test_1 resource_setup function test_1 None 08 tmp\request_object.py PASSED request_object.py::TestClass::test_2 resource_setup function test_2 08.TestClass 08 tmp\request_object.py PASSED ========================== 2 passed in 0.04 seconds

パラメータ化

パラメータ化は、異なる一連の入力パラメータを使用して同じテストを実行する方法です。たとえば、文字列が5文字より長い場合は疑問符を、5文字より短い場合は感嘆符を、文字列に正確に5文字がある場合はドットを追加する関数があります。したがって、3つのテストを作成する代わりに、1つのテストを作成できますが、異なるパラメーターで呼び出します。

テストのパラメーターを設定するには、2つの方法があります。

1）値の配列を渡すフィクスチャのparamsパラメーターの値を介して。

つまり、この場合のフィクスチャは、パラメーターを渡すラッパーです。そして、それらは上記のリクエストオブジェクトのparam属性を介してテスト自体に渡されます。

2）デコレータ（ラベル）@ pytest.mark.parametrizeを介して、変数名のリストとその値の配列が渡されます。

だから最初の方法。

 import pytest def strange_string_func(str): if len(str) > 5: return str + "?" elif len(str) < 5: return str + "!" else: return str + "." @pytest.fixture(scope="function", params=[ ("abcdefg", "abcdefg?"), ("abc", "abc!"), ("abcde", "abcde.") ]) def param_test(request): return request.param def test_strange_string_func(param_test): (input, expected_output) = param_test result = strange_string_func(input) print "input: {0}, output: {1}, expected: {2}".format(input, result, expected_output) assert result == expected_output

以下を開始します。

 tmp>py.test -s -v parametrizing_base.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 3 items parametrizing_base.py::test_strange_string_func[param_test0] input: abcdefg, output: abcdefg?, e xpected: abcdefg? PASSED parametrizing_base.py::test_strange_string_func[param_test1] input: abc, output: abc!, expected: abc! PASSED parametrizing_base.py::test_strange_string_func[param_test2] input: abcde, output: abcde., expec ted: abcde. PASSED ========================== 3 passed in 0.03 seconds

1つの不快な詳細を除き、すべてが正常に機能します。テストの名前によって、どの種類のパラメーターがテストに渡されたかを理解することは不可能です。そして、この場合、フィクスチャパラメータIDが役立ちます。テスト名のリスト（長さはテストの数と一致する必要があります）、または最終名を生成する関数のいずれかを受け入れます。

 import pytest def strange_string_func(str): if len(str) > 5: return str + "?" elif len(str) < 5: return str + "!" else: return str + "." @pytest.fixture(scope="function", params=[ ("abcdefg", "abcdefg?"), ("abc", "abc!"), ("abcde", "abcde.")], ids=["len>5","len<5","len==5"] ) def param_test(request): return request.param def test_strange_string_func(param_test): (input, expected_output) = param_test result = strange_string_func(input) print "input: {0}, output: {1}, expected: {2}".format(input, result, expected_output) assert result == expected_output def idfn(val): return "params: {0}".format(str(val)) @pytest.fixture(scope="function", params=[ ("abcdefg", "abcdefg?"), ("abc", "abc!"), ("abcde", "abcde.")], ids=idfn ) def param_test_idfn(request): return request.param def test_strange_string_func_with_ifdn(param_test_idfn): (input, expected_output) = param_test result = strange_string_func(input) print "input: {0}, output: {1}, expected: {2}".format(input, result, expected_output) assert result == expected_output

以下を開始します。

 tmp>py.test -s -v parametrizing_named.py --collect-only ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 6 items <Module 'parametrizing_named.py'> <Function 'test_strange_string_func[len>5]'> <Function 'test_strange_string_func[len<5]'> <Function 'test_strange_string_func[len==5]'> <Function "test_strange_string_func_with_ifdn[params: ('abcdefg', 'abcdefg?')] "> <Function "test_strange_string_func_with_ifdn[params: ('abc', 'abc!')]"> <Function "test_strange_string_func_with_ifdn[params: ('abcde', 'abcde.')]"> ============================== in 0.03 seconds

この場合、追加パラメーター—collect-onlyを指定してPyTestを起動しました。これにより、パラメーター化によって生成されたすべてのテストを実行せずに収集できます。

2番目の方法には1つの利点があります：異なるパラメーターで複数のラベルを指定すると、すべての可能なパラメーターセット（つまり、パラメーターのデカルト積）でテストが開始されます。

 import pytest @pytest.mark.parametrize("x", [1,2]) @pytest.mark.parametrize("y", [10,11]) def test_cross_params(x, y): print "x: {0}, y: {1}".format(x, y) assert True

以下を開始します。

 tmp>py.test -s -v parametrizing_combinations.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 4 items parametrizing_combinations.py::test_cross_params[10-1] x: 1, y: 10 PASSED parametrizing_combinations.py::test_cross_params[10-2] x: 2, y: 10 PASSED parametrizing_combinations.py::test_cross_params[11-1] x: 1, y: 11 PASSED parametrizing_combinations.py::test_cross_params[11-2] x: 2, y: 11 PASSED ========================== 4 passed in 0.02 seconds

パラメーター化ラベルでは、パラメーターを設定する最初の方法と同様に、出力にパラメーターを表示するidsパラメーターを渡すこともできます。

 import pytest def idfn_x(val): return "x=({0})".format(str(val)) def idfn_y(val): return "y=({0})".format(str(val)) @pytest.mark.parametrize("x", [-1,2], ids=idfn_x) @pytest.mark.parametrize("y", [-10,11], ids=idfn_y) def test_cross_params(x, y): print "x: {0}, y: {1}".format(x, y) assert True @pytest.mark.parametrize("x", [-1,2], ids=["negative x","positive y"]) @pytest.mark.parametrize("y", [-10,11], ids=["negative y","positive y"]) def test_cross_params_2(x, y): print "x: {0}, y: {1}".format(x, y) assert True

以下を開始します。

 tmp>py.test -s -v parametrizing_combinations_named.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp/, inifile: collected 8 items parametrizing_combinations_named.py::test_cross_params[y=(-10)-x=(-1)] x: -1, y: -10 PASSED parametrizing_combinations_named.py::test_cross_params[y=(-10)-x=(2)] x: 2, y: -10 PASSED parametrizing_combinations_named.py::test_cross_params[y=(11)-x=(-1)] x: -1, y: 11 PASSED parametrizing_combinations_named.py::test_cross_params[y=(11)-x=(2)] x: 2, y: 11 PASSED parametrizing_combinations_named.py::test_cross_params_2[negative y-negative x] x: -1, y: -10 PASSED parametrizing_combinations_named.py::test_cross_params_2[negative y-positive y] x: 2, y: -10 PASSED parametrizing_combinations_named.py::test_cross_params_2[positive y-negative x] x: -1, y: 11 PASSED parametrizing_combinations_named.py::test_cross_params_2[positive y-positive y] x: 2, y: 11 PASSED ========================== 8 passed in 0.04 seconds

複数のフィクスチャとフィクスチャを使用してフィクスチャを呼び出します

PyTestは、テストのために呼び出されるフィクスチャのリストを制限しません。

 import pytest @pytest.fixture() def fixture1(request): print("fixture1") @pytest.fixture() def fixture2(request): print("fixture2") @pytest.fixture() def fixture3(request): print("fixture3") def test_1(fixture1, fixture2): print("test_1") def test_2(fixture1, fixture2, fixture3): print("test_2")

 tmp>py.test -s -v multiply_fixtures.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: collected 2 items multiply_fixtures.py::test_1 fixture1 fixture2 test_1 PASSED multiply_fixtures.py::test_2 fixture1 fixture2 fixture3 test_2 PASSED ========================== 2 passed in 0.01 seconds

また、どのフィクスチャーも、それ自体に対して任意の数のフィクスチャーの実行を呼び出すことができます。

 import pytest @pytest.fixture() def fixture1(request, fixture2): print("fixture1") @pytest.fixture() def fixture2(request, fixture3): print("fixture2") @pytest.fixture() def fixture3(request): print("fixture3") def test_1(fixture1): print("test_1") def test_2(fixture2): print("test_2")

 tmp>py.test -s -v fixtures_use_fixtures.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: collected 2 items fixtures_use_fixtures.py::test_1 fixture3 fixture2 fixture1 test_1 PASSED fixtures_use_fixtures.py::test_2 fixture3 fixture2 test_2 PASSED ========================== 2 passed in 0.01 seconds

PyTestは、「マーク」と呼ばれる@ pytest.markデコレータのクラスをサポートしています。基本リストには、次のラベルが含ま

れます。1）@ pytest.mark.parametrize-テストのパラメーター化（上記）

2）@ pytest.mark.xfail-テストに合格しないことをマークし、PyTestはこれを期待される動作として認識します（開発された機能のテストのタイムスタンプとして有用です）。また、このラベルは、テストがこのラベルでマークされる条件を受け入れる場合があります。

3）@ pytest.mark.skipif-テストをスキップするときの条件を設定できます;

4）@ pytest.mark.usefixtures-テストのために呼び出されたすべてのフィクスチャをリストできます。

一般的に、リストは広く、コマンド「py.test-マーカー」。

 import pytest import sys @pytest.mark.xfail() def test_failed(): assert False @pytest.mark.xfail(sys.platform != "win64", reason="requires windows 64bit") def test_failed_for_not_win32_systems(): assert False @pytest.mark.skipif(sys.platform != "win64", reason="requires windows 64bit") def test_skipped_for_not_win64_systems(): assert False

以下を開始します。

 tmp>py.test -s -v basic_marks.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: collected 3 items basic_marks.py::test_failed xfail basic_marks.py::test_failed_for_not_win32_systems xfail basic_marks.py::test_skipped_for_not_win64_systems SKIPPED ==================== 1 skipped, 2 xfailed in 0.02 seconds

重要な追加機能は、ユーザーがラベルを任意に設定できることです。これにより、ラベル名で個別に実行するテストスイートを選択し、-mスイッチで渡すことができます。

 import pytest def test_1(): print "test_1" @pytest.mark.critital_tests def test_2(): print "test_2" def test_3(): print "test_3"

 tmp>py.test -s -v -m "critital_tests" custom_marks.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: collected 3 items custom_marks.py::test_2 test_2 PASSED ================= 2 tests deselected by "-m 'critital_tests'" ================= =================== 1 passed, 2 deselected in 0.01 seconds ====================

ラベルは、pytest.iniモジュールの説明を使用して説明し、すべてのモジュールで使用可能にすることができます。同時に、「py.test --markers」で取得した利用可能なタグのリストに表示されます。

pytest.ini

 # content of pytest.ini [pytest] markers = critical_test: mark test as critical. These tests must to be checked first.

 tmp>py.test --markers @pytest.mark.critical_test: mark test as critical. These tests must to be checked first. …......

また、テストだけでなく、クラス、モジュール（インポートされたモジュールの属性を変更して設定）、またはパラメーター化によって取得されたその起動にもラベルを付けることができます（次の例を参照）。

 import pytest pytestmark = pytest.mark.level1 def test_1(): print "test_1" @pytest.mark.level2 class TestClass: def test_2(self): print "test_2" @pytest.mark.level3 def test_3(self): print "test_3"

 tmp>py.test -s -v -m "level3" custom_marks_others.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 3 items custom_marks_others.py::TestClass::test_3 test_3 PASSED ===================== 2 tests deselected by "-m 'level3'" ===================== =================== 1 passed, 2 deselected in 0.07 seconds ====================

 tmp>py.test -s -v -m "level2" custom_marks_others.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 3 items custom_marks_others.py::TestClass::test_2 test_2 PASSED custom_marks_others.py::TestClass::test_3 test_3 PASSED ===================== 1 tests deselected by "-m 'level2'" ===================== =================== 2 passed, 1 deselected in 0.03 seconds ====================

 tmp>py.test -s -v -m "level1" custom_marks_others.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 3 items custom_marks_others.py::test_1 test_1 PASSED custom_marks_others.py::TestClass::test_2 test_2 PASSED custom_marks_others.py::TestClass::test_3 test_3 PASSED ========================== 3 passed in 0.02 seconds ===========================

 import pytest @pytest.mark.parametrize(("x","expected"), [ (1,2), pytest.mark.critical((2,3)), (3,4) ]) def test_inc(x,expected): print x, "+ 1 = ", expected assert x + 1 == expected

 tmp>py.test -s -v -m "critical" custom_marks_params.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 3 items custom_marks_params.py::test_inc[2-3] 2 + 1 = 3 PASSED ==================== 2 tests deselected by "-m 'critical'" ==================== =================== 1 passed, 2 deselected in 0.02 seconds ====================

例外処理

もちろん、テスト用の本格的なモジュールとして、PyTestでは「with pytest.raises（）」を使用して、返された例外の正確さを確認することもできます。

 import pytest def f(): print 1/0 def test_exception(): with pytest.raises(ZeroDivisionError): f()

 tmp>py.test -s -v check_exception.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 1 items check_exception.py::test_exception PASSED ========================== 1 passed in 0.01 seconds

名前またはIDによるテストの実行

module.py::class::method orの形式でモジュールへのフルパスをリストすることにより、モジュールから個々のテストを実行できます。module.py::function。また、名前の一部を-kフラグで渡します。

 import pytest def test_one(): print "test_one" def test_one_negative(): print "test_one_negative" def test_two(): print "test_one_negative"

 tmp>py.test -s -v call_by_name_and_id.py::test_two ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 4 items call_by_name_and_id.py::test_two test_one_negative PASSED ========================== 1 passed in 0.04 seconds

 tmp>py.test -s -v -k "one" call_by_name_and_id.py ============================= test session starts ============================= platform win32 -- Python 2.7.8, pytest-2.8.2, py-1.4.30, pluggy-0.3.1 -- c:\prog ram files (x86)\python27\python.exe cachedir: .cache rootdir: tmp, inifile: pytest.ini collected 3 items call_by_name_and_id.py::test_one test_one PASSED call_by_name_and_id.py::test_one_negative test_one_negative PASSED ======================== 1 tests deselected by '-kone' ======================== =================== 2 passed, 1 deselected in 0.01 seconds ====================

EclipseでのPyDevとの統合

PyTestは、EclipseのPyDevモジュールのPyUnitコンポーネントに統合されていることに言及したいと思います。設定で、使用する必要があることを指定する必要があります。

追加モジュール

PyTestには多数のアドオンモジュールがあります。

興味のあるモジュールとその理由のみに言及することができます（モジュールの詳細については、上記のリンクを参照してください）：

pytest-describe-別のレベルの抽象化を追加します（同等のmodule-function-testcaseとしてmodule-description-function）。

pytest-instafail-モジュールの基本的な動作を変更して、セッション全体の終わりではなく、実行中にすべてのエラーとクラッシュが表示されるようにします。

pytest-marks-テストに複数のラベルを同時に設定できます：

 @pytest.mark.red @pytest.mark.green @pytest.mark.blue def some_test_method(self): .....

pytest-ordering -Runラベルでテストを実行する順序を手動で設定できます。

 import pytest @pytest.mark.run(order=2) def test_foo(): assert True @pytest.mark.run(order=1) def test_bar(): assert True

pytest-pep8 -pep-8規約に準拠しているかどうかテストコードを確認できます。

pytest-smartcov-完全または部分的なテストのコードのカバレッジを確認できます。

pytest-timeout-コマンドラインパラメーターまたは特別なラベルを使用して、タイムアウトでテストを完了できます。

pytest-sugar -PyTestの出力の外観を変更し、進行状況バーと完了率を追加できます。それは場所にかかわらず、美しく見え、あまり有益ではありません。

あとがき

PyTestの基本的なドキュメントには、その拡張された使用に関する多くの興味深い例が記載されています。しかし、次回はそれらについてお話したいと思います：基本的なPyTestの動作の管理（テストの収集に使用されるテンプレート、コマンドラインの高度なオプションの追加）、パラメーター化中のテストの収集プロセスの制御（metafuncオブジェクト）など。

パイテスト

まえがき

Pythonユニットテスト

必要な知識の紹介

PyTestの長所と短所

テストを実行する

基本的な備品

拡張フィクスチャ

高度なフィクスチャを呼び出す

分解拡張器具

フィクスチャの戻り値

フィクスチャレベル（スコープ）

リクエストオブジェクト

パラメータ化

複数のフィクスチャとフィクスチャを使用してフィクスチャを呼び出します

タグ

例外処理

名前またはIDによるテストの実行

EclipseでのPyDevとの統合

追加モジュール

あとがき

More articles: