jacekk/codeception-dataprovider-module

Easy data providers in your Codeception tests.

v1.1.1 2017-01-30 16:32 UTC

Requires

• php: >=5.4
• codeception/codeception: 2.*
• jasny/dotkey: ^1.0

MIT

• jacekk

README

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

• Installation
• Parameters
• Usage examples
• License

Installation

Add the package into your composer.json file:

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

Tell Composer to download the package:

$ composer update

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

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:

$ php codecept.phar build

or

$ vendor/bin/codecept build

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

Parameters

dataPathTpl

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

• {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.

Usage examples

getValue($keyName, $default = null)

YML content:

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

PHP code:

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:

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):

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

PHP code:

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.

License

Released under the same licence as Codeception: MIT.