ergebnis/data-provider

Provides generic data providers for use with phpunit/phpunit.

3.2.0 2023-11-30 17:30 UTC

Requires

• php: ~7.4.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0
• fakerphp/faker: ^1.21.0

Requires (Dev)

• ergebnis/composer-normalize: ^2.28.3
• ergebnis/license: ^2.4.0
• ergebnis/php-cs-fixer-config: ^6.13.0
• infection/infection: ~0.26.6
• phpunit/phpunit: ^9.6.13
• psalm/plugin-phpunit: ~0.18.4
• rector/rector: ~0.18.11
• vimeo/psalm: ^5.16.0

MIT

• Andreas Möller

• phpunit
• data-provider

README

This package provides generic data providers for use with phpunit/phpunit.

Installation

Run

composer require ergebnis/data-provider

Usage

This package provides the following generic data providers:

• Ergebnis\DataProvider\BoolProvider
• Ergebnis\DataProvider\FloatProvider
• Ergebnis\DataProvider\IntProvider
• Ergebnis\DataProvider\NullProvider
• Ergebnis\DataProvider\ObjectProvider
• Ergebnis\DataProvider\ResourceProvider
• Ergebnis\DataProvider\StringProvider
• Ergebnis\DataProvider\UuidProvider

Since it is possible to use multiple @dataProvider annotations or PHPUnit\Framework\Attribute\DataProviderExternal attributes for test methods, these generic data providers allow for reuse and composition of data providers:

<?php

declare(strict_types=1);

namespace Example\Test;

use Ergebnis\DataProvider;
use PHPUnit\Framework;

final class ExampleTest extends Framework\TestCase
{
    /**
     * @dataProvider \Ergebnis\DataProvider\StringProvider::blank()
     * @dataProvider \Ergebnis\DataProvider\StringProvider::empty()
     */
    public function testFromNameRejectsInvalidValueWithAnnotation(string $value): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionMessage('Value can not be an empty or blank string.');

        UserName::fromString($value);
    }

    #[Framework\DataProviderExternal(DataProvider\StringProvider::class, 'blank')]
    #[Framework\DataProviderExternal(DataProvider\StringProvider::class, 'empty')]
    public function testFromNameRejectsInvalidValueWithAttribute(string $value): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionMessage('Value can not be an empty or blank string.');

        UserName::fromString($value);
    }
}

DataProvider\BoolProvider

• arbitrary() provides true, false
• false() provides false
• true() provides true

For examples, see Ergebnis\DataProvider\Test\Unit\BoolProviderTest.

DataProvider\FloatProvider

• arbitrary() provides arbitrary floats
• greaterThanOne() provides ints greater than 1.0
• greaterThanZero() provides ints greater than 0.0
• lessThanOne() provides ints less than 1.0
• lessThanZero() provides ints less than 0.0
• one() provides 1.0
• zero() provides 0.0

For examples, see Ergebnis\DataProvider\Test\Unit\FloatProviderTest.

DataProvider\IntProvider

• arbitrary() provides arbitrary ints
• greaterThanOne() provides ints greater than 1
• greaterThanZero() provides ints greater than 0
• lessThanOne() provides ints less than 1
• lessThanZero() provides ints less than 0
• one() provides 1
• zero() provides 0

For examples, see Ergebnis\DataProvider\Test\Unit\IntProviderTest.

DataProvider\NullProvider

• null() provides null

For examples, see Ergebnis\DataProvider\Test\Unit\NullProviderTest.

DataProvider\ObjectProvider

• object() provides an instance of stdClass

For examples, see Ergebnis\DataProvider\Test\Unit\ObjectProviderTest.

DataProvider\ResourceProvider

• resource() provides a resource

For examples, see Ergebnis\DataProvider\Test\Unit\ResourceProviderTest.

DataProvider\StringProvider

• arbitrary() provides arbitrary strings
• blank() provides strings consisting of whitespace characters only
• empty() provides an empty string
• trimmed() provides non-empty, non-blank strings without leading and trailing whitespace
• untrimmed() provides non-empty, non-blank strings with additional leading and trailing whitespace
• withWhitespace() provides non-empty, non-blank, trimmed strings containing whitespace

For examples, see Ergebnis\DataProvider\Test\Unit\StringProviderTest.

DataProvider\UuidProvider

• arbitrary() provides lower- and upper-case UUIDs
• caseLower() provides a lower-case UUIDs
• caseUpper() provides an upper-case UUIDs

For examples, see Ergebnis\DataProvider\Test\Unit\UuidProviderTest.

Changelog

The maintainers of this package record notable changes to this project in a changelog.

Contributing

The maintainers of this package suggest following the contribution guide.

Code of Conduct

The maintainers of this package ask contributors to follow the code of conduct.

General Support Policy

The maintainers of this package provide limited support.

You can support the maintenance of this package by sponsoring @localheinz or requesting an invoice for services related to this package.

PHP Version Support Policy

This package supports PHP versions with active support.

The maintainers of this package add support for a PHP version following its initial release and drop support for a PHP version when it has reached its end of active support.

Security Policy

This package has a security policy.

License

This package uses the MIT license.

Social

Follow @localheinz and @ergebnis on Twitter.