edno/codeception-dataprovider

Codeception extension for supporting data-driven tests

Codeception DataProvider

, _(*1)

The Codeception extension for supporting dynamic data driven tests (CEST) using @dataprovider annotation., _(*2)

:bangbang: This extension is deprecated from Codeception 2.2.7. The @dataprovider annotation is now a core feature of Codeception (see PR#3737), _(*3)

:bangbang: If you are running Codeception 2.2.7, then remove this extension by deleting the corresponding line in composer.json and your codeception.yml. No update required for existing tests using @dataprovider, _(*4)

Minimum Requirements

• Codeception 2.2
• PHP 5.4

Installation

The extension can be installed using Composer, _(*5)

$ composer require edno/codeception-dataprovider

Be sure to enable the extension in codeception.yml as shown in configuration below., _(*6)

Configuration

Enabling DataProvider annotation in your tests is done in codeception.yml., _(*7)

extensions:
    enabled:
        - Codeception\Extension\DataProvider

Usage

Once installed you will be to use the @dataprovider annotation for defining the method to be use for fetching the test data.
Your data source must be a public static function located within your test class. The method should return data compliant with the @example annotation., _(*8)

Example

<?php

class ExampleDataProviderCest
{
     /**
      * @dataprovider __myDataSource
      */
      public function testWithDataProvider(FunctionalTester $I, \Codeception\Example $example)
      {
            $expected = ["", "foo", "bar", "re"];
            $I->assertInternalType('integer', $example[0]);
            $I->assertEquals($expected[$example[0]], $example[1]);
      }

      public static function __myDataSource()
      {
          return [
              [1, "foo"],
              [2, "bar"],
              [3, "re"]
          ];
      }
}