setup

クラス: matlab.unittest.fixtures.Fixture
名前空間: matlab.unittest.fixtures

フィクスチャのセットアップ

構文

setup(fixture)

説明

setup(fixture) は、テスト フレームワークでフィクスチャをセットアップするときに環境に変更を加えます。Fixture インターフェイスから派生したクラスは、setup メソッドを実装しなければなりません。

テスト フレームワークでフィクスチャを破棄するときに、フィクスチャで環境を元の状態に復元しなければなりません。環境を復元するには、setup メソッド内で addTeardown メソッドを呼び出すか、teardown メソッドを実装します。

入力引数

fixture — フィクスチャ

matlab.unittest.fixtures.Fixture オブジェクト

フィクスチャ。matlab.unittest.fixtures.Fixture オブジェクトとして指定します。

属性

Abstract

true

メソッドの属性の詳細については、メソッドの属性を参照してください。

例

フィクスチャのセットアップ コードの指定

数値の出力表示形式を小数点以下 2 桁の通貨形式に変更するカスタム フィクスチャを作成して使用します。

現在のフォルダー内の CurrencyFormatFixture.m という名前のファイルで、matlab.unittest.fixtures.Fixture インターフェイスをサブクラス化して CurrencyFormatFixture クラスを作成します。クラスで setup メソッドを実装して、フィクスチャによって数値の表示形式が通貨形式に変更されるようにします。テスト後に表示形式を元の状態に戻すために、setup メソッド内で addTeardown メソッドを呼び出します。

classdef CurrencyFormatFixture < matlab.unittest.fixtures.Fixture
    methods
        function setup(fixture)
            originalFormat = format;
            fixture.addTeardown(@format,originalFormat)
            format bank
        end
    end
end

現在のフォルダー内の ExampleTest.m という名前のファイルで、カスタム フィクスチャを適用し、数値が想定される形式で表示されることを検証する ExampleTest クラスを作成します。この例では、簡略化するために、関数 formattedDisplayText の呼び出しで実際の値を生成しています。実際には、ユーザー定義のコードをテストします。

classdef ExampleTest < matlab.unittest.TestCase
    methods (Test)
        function formatTest(testCase)
            testCase.applyFixture(CurrencyFormatFixture)
            actual = strtrim(formattedDisplayText(pi));
            expected = "3.14";
            testCase.verifyEqual(actual,expected)
        end
    end
end

ExampleTest クラスを実行します。テスト フレームワークでフィクスチャがセットアップされ、表示形式が通貨形式に変更されます。テストの実行が完了すると、フレームワークでフィクスチャが破棄され、元の表示形式に戻ります。この例では、テストはパスします。

runtests("ExampleTest");

Running ExampleTest
.
Done ExampleTest
__________

ヒント

• setup メソッドは、フィクスチャをセットアップするときにテスト フレームワークでのみ呼び出されます。このメソッドをコードで直接呼び出すことはできません。setup でセットアップ アクションを実行するには、applyFixture メソッドを呼び出してフィクスチャを使用します。

バージョン履歴

R2014a で導入

参考

teardown | addTeardown | format

トピック

• 基本的なカスタム フィクスチャの作成
• 高度なカスタム フィクスチャの作成