inject mocksダウンロード - inject mocksソースコードのダウンロード

inject mocks

パイソン

v3.0.0

ダウンロード

モックの注入

#InjectMocks および #Mock アノテーションを介してテスト対象にモックを自動的に挿入し、PHPUnit による単体テストを高速化します。

まとめ

言語 / イディオーマ
設置
要件
特徴
使用法

言語 / イディオーマ

レイアはポルトガル語で生きています。

設置

開発環境にインストールするには:

composer require --dev silasyudi/inject-mocks

要件

PHP 8.3+
作曲家2

特徴

テストクラスで #InjectMocks と #Mock アノテーションを使用すると、テスト対象にモックを自動的に挿入できます。

典型的なシナリオでは、次のように行います。

#InjectMocks/#Mock を使用しない例:

 class SomeTest extends  PHPUnit  Framework TestCase
{
    public void testSomething() 
    {
        $ someDependency = $ this -> createMock (Dependency::class);    
        $ anotherDependency = $ this -> createMock (AnotherDependency::class);
        . . .
        $ subject = new Service ( $ someDependency , $ anotherDependency , ...);
        . . .    
    }
    
    ...

このアプローチでは、メンテナンスが困難になります。依存関係を追加、削減、または置換することによってテストサブジェクトが変更された場合、テストごとに変更する必要があるからです。

#InjectMocks/#Mock アノテーションを使用して、これらのテストサブジェクトの変更を抽象化します。例：

#InjectMocks/#Mock を使用した例:

 use SilasYudi  InjectMocks  InjectMocks ;
use SilasYudi  InjectMocks  Mock ;
use SilasYudi  InjectMocks  MockInjector ;

class SomeTest extends  PHPUnit  Framework TestCase
{
    #[Mock]
    private Dependency $ someDependency ;
    #[Mock]
    private AnotherDependency $ anotherDependency ;
    
    . . .
    
    # [InjectMocks]
    
    public function setUp() : void 
    {
        MockInjector:: inject ( $ this );
    }
    
    public void testSomething ()
    {
        // $this->subject e as dependências já estão instanciadas.
    }
    
    ...

使用法

前のトピックの例と同様に、#InjectMocks 属性はテストするテスト対象のプロパティに配置する必要があり、#Mock 属性はモックする依存関係に対応するプロパティに配置する必要があります。注射する。

その後、 MockInjector::inject($this)文でインジェクターサービスを実行します。この実行は、各テストまたはsetUpで宣言できます。

インジェクターの実行後、#InjectMocks のアノテーションが付けられたservice 、テストクラスのスコープで使用できる実際のインスタンスになり、#Mock のアノテーションが付けられた各依存関係は MockObject のインスタンスとなり、コンストラクターを介してテストサブジェクトに挿入され、テストクラスのスコープでも使用できます。

詳細

1. 属性の範囲

#InjectMocks と #Mock の両方を TestCase クラスの TYPED プロパティ上に配置する必要があります。
#InjectMocks 属性と #Mock 属性を受け取るプロパティはオブジェクトでなければなりません。
TestCase ごとに #InjectMocks 属性を 1 つだけ使用する必要があります。同じスコープで複数のライブラリを使用する場合、このライブラリは最初のライブラリのみを使用し、その他は無視します。
モックするテストサブジェクトの依存関係ごとに #Mock 属性を使用する必要があります。
型なしプロパティまたはプリミティブ型で属性を使用すると、 MockInjectException例外が発生します。
同じテストクラス内の同じタイプの複数のオブジェクトに対して #Mock を使用する場合、このライブラリはプロパティ名を介してそれぞれのオブジェクトと一致します。プロパティ名はテスト対象クラスと同一である必要があります。