PHPackages                             rawr/cross-data-providers - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. rawr/cross-data-providers

Abandoned → [rawr/phpunit-data-provider](/?search=rawr%2Fphpunit-data-provider)Library[Testing & Quality](/categories/testing)

rawr/cross-data-providers
=========================

Lightweight builder for PhpUnit data providers

3.0.0(2y ago)32431.3k↓43%5[2 issues](https://github.com/T-Regx/CrossDataProviders/issues)[1 PRs](https://github.com/T-Regx/CrossDataProviders/pulls)4MITPHPPHP >=7.1.0

Since Jun 7Pushed 1y ago2 watchersCompare

[ Source](https://github.com/T-Regx/CrossDataProviders)[ Packagist](https://packagist.org/packages/rawr/cross-data-providers)[ RSS](/packages/rawr-cross-data-providers/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (4)Dependencies (1)Versions (11)Used By (4)

[![](.github/assets/t.regx.png)](https://t-regx.com/)

Helper for PhpUnit @dataProvider
================================

[](#helper-for-phpunit-dataprovider)

Handy `require-dev` testing tool for [PhpUnit](https://github.com/sebastianbergmann/phpunit). It allows to manage data providers with `zip()`, `join()`, `cross()`, `pairs()`, `slice()`, `map()` and more.

[![Build Status](https://github.com/t-regx/CrossDataProviders/workflows/build/badge.svg?branch=master)](https://github.com/t-regx/CrossDataProviders/actions/)[![Coverage Status](https://camo.githubusercontent.com/f675d15c6f724fcbc71804a69735d9eb2ca65f0539dfb539eccd51f0b8f8d85e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f742d726567782f43726f73734461746150726f7669646572732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/t-regx/CrossDataProviders?branch=master)[![Dependencies](https://camo.githubusercontent.com/20f4b99a958aadb02ff273ac6428c17cf55c6b817657ed64b1c39c7f71955a0e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570656e64656e636965732d302d627269676874677265656e2e737667)](https://github.com/t-regx/CrossDataProviders)[![License](https://camo.githubusercontent.com/141b730b31604503c69a2460dc91192b3f1d4bed2c715496ed82cc00742cdc18/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f742d726567782f43726f73734461746150726f7669646572732e737667)](https://github.com/t-regx/CrossDataProviders/blob/master/LICENSE)[![Composer lock](https://camo.githubusercontent.com/0bd6507f0299009d2952dd4e127b86982adf10e3660294d160686b896b279974/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2e6c6f636b2d756e636f6d6d697465642d677265656e2e737667)](https://github.com/t-regx/CrossDataProviders)

[![PHP Version](https://camo.githubusercontent.com/d29ceb6206232af72a55b5ed3e6fab0a1f2d6cb6c728a088c9c18c4b035a0765/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e312d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/5180a354acf28fb748fbeddd95219b60e0145d1e0eac9f976ca9a1bc9bc0337b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e322d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/de6ad351fa59d9e301ffc48de85e4ca23954b4ba5746f324991a43aab522f893/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e332d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/8a0234efb25bffbee74e0444a52c7796dee73c2785c9908a8c05ecf6eb0f5ff3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e342d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/82887c22962d0022d20f61e17b76e949b7c813ca52cd0b00e794487a1a951169/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/55119e0553f52e25200843d20c0b7f94802872deee3c7737d4dcd41a851167c6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/731c0a72386365632f9a88847c496d04aa121df13cdcb8a3749ed01e8a7df8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/397fdb003e1ce45ddaa601a46346dd54e077dac402e967bc3d6ebd5b5f3b30b1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)[![PHP Version](https://camo.githubusercontent.com/8954266cf3bb41de3961bc203636a79d9ab4299cf0d15590042cf148ae556fc6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342d626c75652e737667)](https://github.com/t-regx/CrossDataProviders/runs/2375602376)

[![PRs Welcome](https://camo.githubusercontent.com/f521b8a3c3a0d013c2d37bfdc56de0a513e491926e02c6166a9dd36097d62145/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50522d77656c636f6d652d627269676874677265656e2e7376673f7374796c653d706f706f7574)](https://github.com/t-regx/CrossDataProviders/pulls)

1. [Installation](#installation)
    - [Composer](#installation)
2. [Overview](#overview)
    - [`DataProvider::list()`](#dataproviderlist)
    - [`DataProvider::join()`](#dataproviderjoin)
    - [`DataProvider::zip()`](#dataproviderzip)
    - [`DataProvider::cross()`](#dataprovidercross)
    - [`DataProvider::pairs()`](#dataproviderpairs)
    - [`DataProvider::of()`](#dataproviderof)
    - [`DataProvider::tuples()`](#dataprovidertuples)
    - [`DataProvider::dictionary()`](#dataproviderdictionary)
    - [`DataProvider.map()`](#dataprovidermap)
    - [`DataProvider.slice()`](#dataproviderslice)
    - [`DataProvider.entries()`](#dataproviderentries)
3. [Documentation](#documentation)
    - [Functionalities](#functionalities)
    - [Features](#features)
    - [Example](#example-usage)
    - [Advanced example](#advanced-usage)
4. [Migration](#migration-from-previous-version)

Installation
============

[](#installation)

Installation for PHP 7.1 and later:

```
composer require --dev rawr/phpunit-data-provider
```

Overview
========

[](#overview)

`DataProvider` can be used to build, compose and edit data providers to be used with [PhpUnit](https://github.com/sebastianbergmann/phpunit)by [@sebastianbergmann](https://github.com/sebastianbergmann).

### `DataProvider::list()`

[](#dataproviderlist)

`DataProvider::list()` provides a list of elements. Test is invoked each time with a single argument.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::list('blue', 'yellow', 'red');
}
```

[![list.png](.github/assets/example/list.png)](.github/assets/example/list.png)

Additionally, `DataProvider::list()` [names](#names) rows based on values.

### `DataProvider::join()`

[](#dataproviderjoin)

Vertically join data providers together.

💡 Useful when two data providers are used in other tests, and a new test should use both of them.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color, string $thing): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::join($this->blueColors(), $this->yellowColors(), $this->redColors());
}

public function blueColors(): DataProvider {
  return DataProvider::tuples(
    ['blue', 'sky'],
    ['deep blue', 'ocean']
  );
}

public function yellowColors(): iterable {
  yield 'sun' => ['yellow', 'sun'];
}

public function redColors(): array {
  return [
    'apple' => ['red', 'apple']
  ];
}
```

[![join.png](.github/assets/example/join.png)](.github/assets/example/join.png)

Note:

- Only data provider with equal amounts of arguments in rows can be joined. `DataProvider.drop()` can be used to trim overflowing columns, or [`DataProvider::zip()`](#dataproviderzip) to widen data provider with less rows.

### `DataProvider::zip()`

[](#dataproviderzip)

Horizontally join data providers together.

💡 Useful for keeping data providers clean and simple.

```
/**
 * @test
 * @dataProvider colors
 */
public function test($blueColor, $blueThing, $adjective, Factory $factory): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::zip($this->blueThings(), $this->adjectives(), $this->factories());
}

public function blueThings(): DataProvider {
  return DataProvider::tuples(
    ['blue', 'ink'],
    ['light blue', 'shirt'],
    ['deep blue', 'ocean']
  );
}

public function adjectives(): iterable {
  return DataProvider::list('liquid', 'comfortable', 'majestic');
}

public function factories(): iterable {
  yield [new InkFactory()];
  yield [new ShirtFactory()];
  yield [new OceanFactory()];
}
```

[![zip.png](.github/assets/example/zip.png)](.github/assets/example/zip.png)

Note:

- Only data provider with equal amounts of rows can be zipped. `DataProvider.slice()` can be used to trim overflowing rows, or [`DataProvider::join()`](#dataproviderjoin) to prolong a shorter data provider.

### `DataProvider::cross()`

[](#dataprovidercross)

Creates a square matrix of given data providers.

💡 Useful for testing all combinations of arguments.

```
/**
 * @test
 * @dataProvider colorsAndThings
 */
public function test(string $color, string $shade): void {
  // your test here
}

public function colorsAndThings(): DataProvider {
  return DataProvider::cross($this->colors(), $this->things());
}

public function colors(): array {
  return [
    ['blue'], ['yellow'], ['red']
  ];
}

public function things(): iterable {
  return DataProvider::list('sky', 'sun', 'apple');
}
```

[![cross.png](.github/assets/example/cross.png)](.github/assets/example/cross.png)

### `DataProvider::pairs()`

[](#dataproviderpairs)

Calls test with two arguments. Each argument is paired with all of the other arguments. All rows are [named](#names)according to the arguments.

Example shows a test paring image formats:

```
/**
 * @test
 * @dataProvider formats
 */
public function shouldConvertFile(string $from, string $to): void {
  // your test here
}

public function formats(): array {
  return DataProviders::distinctPairs('png', 'jpg', 'bmp');
}
```

[![pairs.png](.github/assets/example/pairs.png)](.github/assets/example/pairs.png)

### `DataProvider::of()`

[](#dataproviderof)

Instantiates a `DataProvider` from a raw-array accepted by [PhpUnit](https://github.com/sebastianbergmann/phpunit).

```
public function example(): DataProvider {
  return DataProvider::of($this->rawArray());
}

public function rawArrayDataProvider(): array {
  return [
    'key' => ['argument 1', 'argument 2']
  ];
}
```

[![of.png](.github/assets/example/of.png)](.github/assets/example/of.png)

Notes:

- Also accepts [`iterable`](https://www.php.net/manual/en/language.types.iterable.php), [`\Generator`](https://www.php.net/manual/en/class.generator.php) and other [types accepted](#accepted-types) by [PhpUnit](https://github.com/sebastianbergmann/phpunit).

### `DataProvider::tuples()`

[](#dataprovidertuples)

Provide multiple arguments for each a test. `DataProvider::tuples()` [names](#names) each row based on the values.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color, string $thing): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::tuples(
    ['blue', 'sky'],
    ['yellow', 'sun'],
    ['red', 'apple']
  );
}
```

[![tuples.png](.github/assets/example/tuples.png)](.github/assets/example/tuples.png)

### `DataProvider::dictionary()`

[](#dataproviderdictionary)

Specify a single argument for test. [`DataProvider::dictionary()`](#dataproviderdictionary) [names](#names) each row based on the provided array key.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::dictionary([
    'custom name 1' => 'blue',
    'custom name 2' => 'yellow',
    'custom name 3' => 'red'
  ]);
}
```

[![dictionary.png](.github/assets/example/dictionary.png)](.github/assets/example/dictionary.png)

In most cases, [`DataProvider::list()`](#dataproviderlist) or [`DataProvider::tuples()`](#dataprovidertuples) should be used to [name](#names)rows based on arguments. Method `DataProvider::dictionary()` is useful when the arguments are not self-explanatory:

```
public function ports(): DataProvider {
  return DataProvider::dictionary([
    'http'  => 80,
    'https' => 443,
    'ftp'   => 21
  ]);
}
```

### `DataProvider.map()`

[](#dataprovidermap)

Transform each row's values in `DataProvider` to any other set of values.

💡 Useful for separating providers content and their form.

```
/**
* @test
* @dataProvider folderIterators
*/
public function test(\Iterator $iterator, string $name): void {
  // your test here
}

public function folderIterators(): DataProvider {
  return $this->folders()->map(function (string $name, string $path): array {
      return [
          new \DirectoryIterator($path),
          $name
      ];
  });
}

public function folders(): DataProvider {
  return DataProvider::tuples(
      ['temporary', '/tmp'],
      ['user directory', '/home'],
      ['system resources', '/usr/bin']);
}
```

[![map.png](.github/assets/example/map.png)](.github/assets/example/map.png)

Notes:

- Names in `DataProvider` will be preserved.

### `DataProvider.slice()`

[](#dataproviderslice)

Remove leading or trailing rows from `DataProvider`.

💡 Useful for adapting `DataProvider` to be zipped or limit provided values.

```
/**
 * @test
 * @dataProvider limitedColors
 */
public function test(string $color, string $thing): void {
  // your test here
}

public function limitedColors(): DataProvider {
    return $this->colors()->slice(0, 2);
}

public function colors(): DataProvider {
  return DataProvider::tuples(
    ['blue', 'sky'],
    ['yellow', 'sun'],
    ['red', 'apple']
  );
}
```

### `DataProvider.entries()`

[](#dataproviderentries)

Provide two arguments for each a test, from key-value pairs. `DataProvider::entries()` [names](#names) each row based on the key-value pair.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color, string $thing): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::entries(
    'blue'   => 'sky',
    'yellow' => 'sun',
    'red'    => 'apple',
  );
}
```

[![entries.png](.github/assets/example/entries.png)](.github/assets/example/entries.png)

Documentation
=============

[](#documentation)

### Functionalities

[](#functionalities)

- Creating new data providers:

    - [`DataProvider::list()`](#dataproviderlist), [`DataProvider::tuples()`](#dataprovidertuples), [`DataProvider::dictionary()`](#dataproviderdictionary), [`DataProvider::pairs()`](#dataproviderpairs), [`DataProvider::distinctPairs()`](#dataproviderpairs)
- Composing existing providers:

    - [`DataProvider::zip()`](#dataproviderzip), [`DataProvider::join()`](#dataproviderjoin), [`DataProvider::cross()`](#dataprovidercross), [`DataProvider::of()`](#dataproviderof)
- Editing existing providers:

    - [`DataProvider.map()`](#dataprovidermap), [`DataProvider.slice()`](#dataproviderslice), `DataProvider.drop()`. These methods don't modify `DataProvider`instance, but return a new instance.

### Features

[](#features)

- Clear naming
    - Each `DataProvider` builder sets proper [names](#names) for rows, based on values.
- Duplicate keys:
    - Duplicate keys are properly handled and formatted in an informative manner. No rows are ever being "lost" when editing.
- Lazy evaluation:
    - Iterators are being evaluated only when called. Argument iterators are only called once, even if `DataProvider` is called multiple times.
- `DataProvider` accepts many [provider types](#accepted-types).

### Names

[](#names)

`DataProvider` sets proper names for each row based on values.

```
/**
 * @test
 * @dataProvider colors
 */
public function test(string $color, string $thing): void {
  // your test here
}

public function colors(): DataProvider {
  return DataProvider::tuples(
    ['blue', 'sky'],
    ['yellow', 'sun'],
    ['red', 'apple']
  );
}
```

[![names](.github/assets/screen/names.dark.png#gh-dark-mode-only)](.github/assets/screen/names.dark.png#gh-dark-mode-only)[![names](.github/assets/screen/names.light.png#gh-light-mode-only)](.github/assets/screen/names.light.png#gh-light-mode-only)

Example usage
-------------

[](#example-usage)

[`DataProvider::cross()`](#dataprovidercross) returns an instance of `DataProvider` which is a square matrix of input data providers.

```
/**
 * @test
 * @dataProvider services
 */
public function shouldLogin(string $service, string $method, int $port): void {
  // your test here
}

public function services(): DataProvider {
  return DataProvider::cross(
    [
      ['github.com'], ['bitbucket.com'], ['gitlab.com'], ['sourceforge.net']
    ],
    [
      ['http', 80],
      ['https', 443],
      ['ssh', 22]
    ]);
}
```

This is equivalent of having a regular data provider that is composed of 12 entries, similar to:

```
public function services(): array {
  return [
    ['github.com', 'http', 80],
    ['github.com', 'https', 443],
    ['github.com', 'ssh', 22],
    ['bitbucket.com', 'http', 80],
    ['bitbucket.com', 'https', 443],
    ['bitbucket.com', 'ssh', 22],
    ['gitlab.com', 'http', 80],
    ['gitlab.com', 'https', 443],
    ['gitlab.com', 'ssh', 22],
    ['sourceforge.net', 'http', 80],
    ['sourceforge.net', 'https', 443],
    ['sourceforge.net', 'ssh', 22],
  ];
}
```

`DataProvider::cross()` accepts data providers of different types: [`array`](https://www.php.net/manual/en/language.types.array.php), [`\Iterator`](https://www.php.net/manual/en/class.iterator.php), [`\IteratorAggregate`](https://www.php.net/manual/en/class.iteratoraggregate.php), [`\Traversable`](https://www.php.net/manual/en/class.traversable.php), [`\Generator`](https://www.php.net/manual/en/class.generator.php), [`iterable`](https://www.php.net/manual/en/language.types.iterable.php) and `DataProvider`.

That means `DataProvider` can be composed together.

```
public function services(): DataProvider {
  return DataProvider::cross(
    DataProvider::list('github.com', 'bitbucket.com', 'gitlab.com', 'sourceforge.net'),
    DataProvider::tuples(['http', 80], ['https', 443], ['ssh', 22]));
}
```

Advanced usage
--------------

[](#advanced-usage)

`DataProvider` can be combined with other `DataProvider`s as well as regular [PhpUnit](https://github.com/sebastianbergmann/phpunit) data providers.

```
/**
 * @test
 * @dataProvider urls
 */
public function test0(string $url): void {
  // your test here
}

/**
 * @test
 * @dataProvider services
 */
public function test1(string $url, string $name, string $method, int $port): void {
  // your test here
}

/**
 * @test
 * @dataProvider allServices
 */
public function test2(string $url, string $name, string $method, int $port): void {
  // your test here
}

public function urls(): DataProvider {
  return DataProvider::list('github.com', 'bitbucket.com', 'gitlab.com', 'sourceforge.net');
}

public function rawArrayProvider(): array {
  return [
    ['GitHub'],
    ['BitBucket'],
    ['GitLab'],
    ['SourceForge']
  ];
}

public function services(): DataProvider {
  return DataProvider::cross(
    DataProvider::zip($this->urls(), $this->rawArrayProvider()),
    DataProvider::tuples(
      ['http', 80],
      ['https', 443],
      ['ssh', 22]));
}

public function allServices(): DataProvider {
  return DataProvider::join(
    $this->services(),
    $this->localServices()
  );
}

public function localServices(): array {
   return [
     'my local service' => ['localhost', 'local', 'http', '80']
   ];
}
```

### Accepted types

[](#accepted-types)

`DataProvider` accepts any type of data provider:

- all types allowed by [PhpUnit](https://github.com/sebastianbergmann/phpunit): [`array`](https://www.php.net/manual/en/language.types.array.php), [`iterable`](https://www.php.net/manual/en/language.types.iterable.php), [`\Traversable`](https://www.php.net/manual/en/class.traversable.php), [`\Iterator`](https://www.php.net/manual/en/class.iterator.php), [`\IteratorAggregate`](https://www.php.net/manual/en/class.iteratoraggregate.php), [`\Generator`](https://www.php.net/manual/en/class.generator.php)
- `DataProvider` itself, allowing data providers to be composed together

### Notes

[](#notes)

Notes on [`DataProvider::join()`](#dataproviderjoin):

- [`DataProvider::join()`](#dataproviderjoin) preserves names of each data provider, and also joins the names vertically. Duplicates in titles are preserved and presented appropriately.
- [`DataProvider::join()`](#dataproviderjoin) accepts [any type](#accepted-types) of data-provider.
- [`DataProvider::join()`](#dataproviderjoin) is conceptually similar to calling [`\array_merge()`](https://www.php.net/manual/en/function.array-merge.php) on raw-array providers, but [`\array_merge()`](https://www.php.net/manual/en/function.array-merge.php) would override duplicate keys, while [`DataProvider::join()`](#dataproviderjoin) preserves duplicate keys, and titles them appropriately.
- [`DataProvider::join()`](#dataproviderjoin) variadic arguments `...iterable` and can be used to join many data providers
- [`DataProvider::join()`](#dataproviderjoin) can only join data providers with the same amount of arguments in each row, otherwise `IrregularDataProviderException` is thrown.
- [`DataProvider::join()`](#dataproviderjoin) accepts `DataProvider` or other [`iterable`](https://www.php.net/manual/en/language.types.iterable.php) accepted by [PhpUnit](https://github.com/sebastianbergmann/phpunit). If improper data-provider is passed, `MalformedDataProviderException`is thrown.

Notes on [`DataProvider::zip()`](#dataproviderzip):

- [`DataProvider::zip()`](#dataproviderzip) preserves names of each data provider, and also joins them horizontally.
- [`DataProvider::zip()`](#dataproviderzip) accepts [any type](#accepted-types) of data-provider.
- [`DataProvider::zip()`](#dataproviderzip) variadic arguments `...iterable` and can zip many data providers
- [`DataProvider::zip()`](#dataproviderzip) can only zip data providers with the same amount of rows, otherwise `IrregularDataProviderException` is thrown. Additionally, each particular data provider must have the same amount of arguments in each row.
- `DataProvider::zip()` accepts `DataProvider` or other `iterable` accepted by [PhpUnit](https://github.com/sebastianbergmann/phpunit). If improper data-provider is passed, `MalformedDataProviderException`is thrown.

Note on [`DataProvider::pairs()`](#dataproviderpairs):

- `DataProvider::pairs()` produces duplicate [pairs](#dataproviderpairs) (for example `'png', 'png'`), while `DataProvider::distinctPairs()`only makes pairs of different arguments.

Note on [`DataProvider::tuples()`](#dataprovidertuples):

- `DataProvider::tuples()` is similar to `DataProvider::of()`, but `::of()` accepts an explicit name, while `DataProvider::tuples()` titles the rows according to the values in the row.

Migration from previous version
===============================

[](#migration-from-previous-version)

To use version `3.0.0`, migrating from [`2.4.0`](https://github.com/t-regx/CrossDataProviders/releases/tag/2.1.0) or earlier:

- Library namespace changed from `\TRegx\DataProvider\ ` to `\TRegx\PhpUnit\DataProviders\ `.
- Change `\TRegx\DataProvider\DataProviders::cross()` to `\TRegx\PhpUnit\DataProviders\DataProvider::cross()`.
- Change `\TRegx\DataProvider\CrossDataProviders::cross()` to `\TRegx\PhpUnit\DataProviders\DataProvider::cross()`.
- Change your data providers return type from `array` to `iterable` or `\TRegx\PhpUnit\DataProviders\DataProvider`.
- Removed `\TRegx\DataProvider\CrossDataProviders::builder()`, use `\TRegx\PhpUnit\DataProviders\DataProvider::cross()`instead.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity47

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~217 days

Recently: every ~255 days

Total

8

Last Release

1038d ago

Major Versions

1.0.0 → 2.0.02019-10-19

2.4.0 → 3.0.0-alpha2023-08-06

PHP version history (6 changes)1.0.0PHP >=5.6

2.1.0PHP >=7.0

2.2.0PHP ^7.0

v2.3.0PHP ^8.0 || ^7.0

2.4.0PHP ^7.1 || ^8.0

3.0.0-alphaPHP >=7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/0f388dbecf863b7cf5131dbac972514dab843f609977315694b9f25e0e63332d?d=identicon)[danon](/maintainers/danon)

---

Top Contributors

[![danon](https://avatars.githubusercontent.com/u/13367735?v=4)](https://github.com/danon "danon (53 commits)")

---

Tags

data-providerdata-providersphpphpunit

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rawr-cross-data-providers/health.svg)

```
[![Health](https://phpackages.com/badges/rawr-cross-data-providers/health.svg)](https://phpackages.com/packages/rawr-cross-data-providers)
```

###  Alternatives

[szepeviktor/phpstan-wordpress

WordPress extensions for PHPStan

3309.4M1.2k](/packages/szepeviktor-phpstan-wordpress)[dms/phpunit-arraysubset-asserts

This package provides ArraySubset and related asserts once deprecated in PHPUnit 8

14228.7M340](/packages/dms-phpunit-arraysubset-asserts)[jasonmccreary/laravel-test-assertions

A set of helpful assertions when testing Laravel applications.

3524.1M38](/packages/jasonmccreary-laravel-test-assertions)[orchestra/workbench

Workbench Companion for Laravel Packages Development

8219.1M67](/packages/orchestra-workbench)[soyuka/contexts

Behatch contexts

282.2M21](/packages/soyuka-contexts)[roquie/laravel-dusk-select2

Select2.js support for the Laravel Dusk testing.

41356.2k5](/packages/roquie-laravel-dusk-select2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)