data-provider
Installation
Run
composer require --dev ergebnis/data-provider
Usage
This package provides the following generic data providers:
Ergebnis\DataProvider\BoolProviderErgebnis\DataProvider\FloatProviderErgebnis\DataProvider\IntProviderErgebnis\DataProvider\NullProviderErgebnis\DataProvider\ObjectProviderErgebnis\DataProvider\ResourceProviderErgebnis\DataProvider\StringProvider
Since it is possible to use multiple @dataProvider annotations for test methods, these generic data providers allow for reuse and composition of data providers:
declare(strict_types=1);
namespace Example\Test;
use PHPUnit\Framework;
final class ExampleTest extends Framework\TestCase
{
/**
* @dataProvider \Ergebnis\DataProvider\StringProvider::blank()
* @dataProvider \Ergebnis\DataProvider\StringProvider::empty()
*/
public function testFromNameRejectsBlankOrEmptyStrings(string $value): void
{
$this->expectException(\InvalidArgumentException::class);
$this->expectExceptionMessage('Value can not be an empty or blank string.');
UserName::fromString($value);
}
}
DataProvider\BoolProvider
arbitrary()providestrue,falsefalse()providesfalsetrue()providestrue
For examples, see Ergebnis\DataProvider\Test\Unit\BoolProviderTest.
DataProvider\FloatProvider
arbitrary()provides arbitraryfloatsgreaterThanOne()providesints greater than1.0greaterThanZero()providesints greater than0.0lessThanOne()providesints less than1.0lessThanZero()providesints less than0.0one()provides1.0zero()provides0.0
For examples, see Ergebnis\DataProvider\Test\Unit\FloatProviderTest.
DataProvider\IntProvider
arbitrary()provides arbitraryintsgreaterThanOne()providesints greater than1greaterThanZero()providesints greater than0lessThanOne()providesints less than1lessThanZero()providesints less than0one()provides1zero()provides0
For examples, see Ergebnis\DataProvider\Test\Unit\IntProviderTest.
DataProvider\NullProvider
null()providesnull
For examples, see Ergebnis\DataProvider\Test\Unit\NullProviderTest.
DataProvider\ObjectProvider
object()provides an instance ofstdClass
For examples, see Ergebnis\DataProvider\Test\Unit\ObjectProviderTest.
DataProvider\ResourceProvider
resource()provides aresource
For examples, see Ergebnis\DataProvider\Test\Unit\ResourceProviderTest.
DataProvider\StringProvider
arbitrary()provides arbitrarystringsblank()providesstrings consisting of whitespace characters onlyempty()provides an emptystringtrimmed()provides non-empty, non-blankstringswithout leading and trailing whitespaceuntrimmed()provides non-empty, non-blankstrings with additional leading and trailing whitespacewithWhitespace()provides non-empty, non-blank, trimmedstrings containing whitespace
For examples, see Ergebnis\DataProvider\Test\Unit\StringProviderTest.
Changelog
Please have a look at CHANGELOG.md.
Contributing
Please have a look at CONTRIBUTING.md.
Code of Conduct
Please have a look at CODE_OF_CONDUCT.md.
License
This package is licensed using the MIT License.
Please have a look at LICENSE.md.
Curious what I am building?
10.3k Jan 1, 2023
777 Dec 12, 2022
2k Dec 31, 2022
1.4k Dec 23, 2022
34 Dec 27, 2022
16 Dec 3, 2022
9 Jul 11, 2020
19 Dec 11, 2022
10 Nov 21, 2022
6 Jan 14, 2022
219 Dec 17, 2022
224 Aug 20, 2022
1 Jan 13, 2022
303 Dec 18, 2022
2 Aug 4, 2022
359 Dec 28, 2022
1 Apr 12, 2022