共有フィクスチャを使用するテストの記述

スクリプトを開く

matlab.unittest.TestCaseクラスの SharedTestFixtures 属性を使用して、テストフィクスチャをテストクラス全体で共有することができます。一緒に実行されるテストクラスでフィクスチャを共有すると、テストフレームワークによってすべてのテストクラス用にフィクスチャが 1 回セットアップされ、すべてのテストクラスが実行されてからそのフィクスチャが破棄されます。代わりに、各クラスの TestClassSetup methods ブロックを使用してフィクスチャを指定すると、テストフレームワークによって各テストクラスの実行前にフィクスチャがセットアップされ、実行後に破棄されます。

この例では、テストの作成時に共有フィクスチャを使用する方法を示します。ソースコードが含まれているフォルダーをパスに追加するフィクスチャを 2 つのテストクラスで共有する方法について説明します。テストクラスはこのフィクスチャを使用して、テストに必要なソースコードにアクセスします。

例を開いて、ソースおよびテストコードを現在のフォルダーで使用できるようにします。

openExample("matlab/WriteTestsUsingSharedTestFixturesExample")

`DocPolynomTest` クラスの定義

このコードでは、DocPolynomTest クラス定義ファイルの内容を示します。このファイルは共有フィクスチャを使用して、DocPolynom クラスを定義しているフォルダーにアクセスします。DocPolynom クラスの詳細とクラスコードの表示方法については、クラスによる多項式の表現を参照してください。

classdef (SharedTestFixtures={ ...
        matlab.unittest.fixtures.PathFixture( ...
        fullfile("..","fixture_example_source"))}) ...
        DocPolynomTest < matlab.unittest.TestCase

    properties
        TextToDisplay = "Equation under test: "
    end

    methods (Test)
        function testConstructor(testCase)
            p = DocPolynom([1 0 1]);
            testCase.verifyClass(p,?DocPolynom)
        end

        function testAddition(testCase)
            p1 = DocPolynom([1 0 1]);
            p2 = DocPolynom([5 2]);
            actual = p1 + p2;
            expected = DocPolynom([1 5 3]);
            diagnostic = [testCase.TextToDisplay ...
                "(x^2 + 1) + (5*x + 2) = x^2 + 5*x + 3"];
            testCase.verifyEqual(actual,expected,diagnostic)
        end

        function testMultiplication(testCase)
            p1 = DocPolynom([1 0 3]);
            p2 = DocPolynom([5 2]);
            actual = p1 * p2;
            expected = DocPolynom([5 2 15 6]);
            diagnostic = [testCase.TextToDisplay ...
                "(x^2 + 3) * (5*x + 2) = 5*x^3 + 2*x^2 + 15*x + 6"];
            testCase.verifyEqual(actual,expected,diagnostic)
        end
    end
end

`BankAccountTest` クラスの定義

このコードでは、BankAccountTest クラス定義ファイルの内容を示します。このファイルは共有フィクスチャを使用して、BankAccount クラスを定義しているフォルダーにアクセスします。BankAccount クラスの詳細とクラスコードの表示方法については、連携するクラスの開発を参照してください。

classdef (SharedTestFixtures={ ...
        matlab.unittest.fixtures.PathFixture( ...
        fullfile("..","fixture_example_source"))}) ...
        BankAccountTest < matlab.unittest.TestCase

    methods (Test)
        function testConstructor(testCase)
            b = BankAccount(1234,100);
            testCase.verifyEqual(b.AccountNumber,1234, ...
                "Constructor must correctly set account number.")
            testCase.verifyEqual(b.AccountBalance,100, ...
                "Constructor must correctly set account balance.")
        end

        function testConstructorNotEnoughInputs(testCase)
            import matlab.unittest.constraints.Throws
            testCase.verifyThat(@()BankAccount,Throws("MATLAB:minrhs"))
        end

        function testDeposit(testCase)
            b = BankAccount(1234,100);
            b.deposit(25)
            testCase.verifyEqual(b.AccountBalance,125)
        end

        function testWithdraw(testCase)
            b = BankAccount(1234,100);
            b.withdraw(25)
            testCase.verifyEqual(b.AccountBalance,75)
        end

        function testNotifyInsufficientFunds(testCase)
            callbackExecuted = false;
            function testCallback(~,~)
                callbackExecuted = true;
            end

            b = BankAccount(1234, 100);
            b.addlistener("InsufficientFunds",@testCallback);

            b.withdraw(50)
            testCase.assertFalse(callbackExecuted, ...
                "The callback should not have executed yet.")
            b.withdraw(60)
            testCase.verifyTrue(callbackExecuted, ...
                "The listener callback should have fired.")
        end
    end
end

テストの実行

現在のフォルダーおよびそのサブフォルダーでテストを実行します。テストフレームワークによって共有テストフィクスチャがセットアップされ、BankAccountTest クラスおよび DocPolynomTest クラスでテストが実行されます。テストの実行後にフィクスチャが破棄されます。この例では、すべてのテストがパスします。

runtests("IncludeSubfolders",true);

Setting up PathFixture
Done setting up PathFixture: Added 'C:\work\WriteTestsUsingSharedTestFixturesExample\fixture_example_source' to the path.
__________

Running BankAccountTest
.....
Done BankAccountTest
__________

Running DocPolynomTest
...
Done DocPolynomTest
__________

Tearing down PathFixture
Done tearing down PathFixture: Restored the path to its original state.
__________

参考

matlab.unittest.TestCase | matlab.unittest.fixtures.Fixture | matlab.unittest.fixtures.PathFixture

共有フィクスチャを使用するテストの記述

DocPolynomTest クラスの定義

BankAccountTest クラスの定義

テストの実行

参考

関連するトピック

`DocPolynomTest` クラスの定義

`BankAccountTest` クラスの定義