jacekk/codeception-dataprovider-module

Easy data providers in your Codeception tests.

Codeception DataProvider Module

, _(*1)

This module helps to manage data (that you use inside tests) in an easy way. Especially, when you like Yaml/YML files format., _(*2)

• Installation
• Parameters
• Usage examples
• License

Installation

Add the package into your composer.json file:, _(*3)

{
    "require-dev": {
        "codeception/codeception": "2.*",
        "jacekk/codeception-dataprovider-module": "1.*"
    }
}

Tell Composer to download the package:, _(*4)

$ composer update

Then, enable it in your my-awesome.suite.yml configuration and adjust two required params as in this library suite config:, _(*5)

class_name: NoGuy
modules:
    enabled:
        - Asserts
        - DataProvider
    config:
        DataProvider:
            dataPathTpl: '{root}/tests/_data/{file}'
            files:
                - common-provider.yml
                - env-provider.dev.yml

You will need to rebuild your actor class:, _(*6)

$ php codecept.phar build

or, _(*7)

$ vendor/bin/codecept build

or whatever your tool set allowes :) At last, check out the examples section and use it daily :), _(*8)

Parameters

dataPathTpl

Template to build paths to files listed by appropriate setting. Allowes for the following tokens, where the first one is obviously required:, _(*9)

• {file} - one of elements listed in files setting,
• {root} - current working directory - PHP function: getcwd().

files

One or more files names, which can be found under path defined in dataPathTpl. If --env param is used heavily, then some files reuse is sort of built in., _(*10)

Usage examples

getValue($keyName, $default = null)

YML content:, _(*11)

headers:
    contentType: 'application/json'
    accept: 'text/html'

PHP code:, _(*12)

public function testSomeHeaders(NoGuy $I)
{
    $headerValue = $I->getValue('headers.accept');
    $I->assertEquals('text/html', $headerValue);
    // or with somethin not set in YML files
    $authType = $I->getValue('headers.authorizationType', 'Bearer');
    $I->assertEquals('Bearer', $authType);
}

iterateOver($keyName, callable $callback)

YML content:, _(*13)

users:
    admins:
        0:
            id: 123
            email: John(at)example.com
            fullName: John Example
        1:
            id: 321
            email: two(at)gmail.com
            fullName: Tom The Second

or (this will also work, even it is not an ordered list):, _(*14)

users:
    admins:
        -
            id: 111
            email: mark(at)gmail.com
            fullName: Mark Whaleberg

PHP code:, _(*15)

public function testAdminsDataInUsersResource(NoGuy $I)
{
    $I->iterateOver('users.admins', function ($user, $index) use ($I) {
        $userId = $user['id'];
        $I->sendGET("users/{$userId}");
        $I->seeResponseContainsJson([
            'id'        => $userId,
            'is_admin'  => true,
            'email'     => $user['email'],
            'full_name' => $user['fullName'],
        ]);
    });
}

See more examples in GetValueCest and IterateOverCest which verify this module quality., _(*16)

License

Released under the same licence as Codeception: MIT., _(*17)