Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/milanowicz/php-testing
Library for PHPUnit testing
https://github.com/milanowicz/php-testing
php phpunit testing testing-tools unit-testing
Last synced: 2 months ago
JSON representation
Library for PHPUnit testing
- Host: GitHub
- URL: https://github.com/milanowicz/php-testing
- Owner: milanowicz
- License: gpl-3.0
- Created: 2022-03-01T18:54:09.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T13:04:30.000Z (almost 2 years ago)
- Last Synced: 2024-11-14T14:45:26.480Z (2 months ago)
- Topics: php, phpunit, testing, testing-tools, unit-testing
- Language: PHP
- Homepage:
- Size: 556 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE
Awesome Lists containing this project
README
# PHP Testing
[](https://dashboard.stryker-mutator.io/reports/github.com/milanowicz/php-testing/master)
[](https://codecov.io/gh/milanowicz/php-testing)
Library for PHPUnit testing.
## Usage
Install by Composer
```shell
> composer require --dev milanowicz/php-testing
```
### Methods
Example for using abstract class in your ClassTest:
```php
class UnitTest extends Milanowicz\Testing\TestCase
{
public function testMethod(): void
{
// All Traits in abstract Milanowicz\Testing\TestCase are extends!
// See below for further details from Trait methods
}
}
```
OR import Trait(s) for use them:
```php
class UnitTest extends What\Ever\TestCase
{
use Milanowicz\Testing\TestTrait;
public function testMethod(): void
{
// Access to private or protected Method
$this->accessMethod((object) Class, (string) Method);
// Run test(s) in it and when an assertion failed would throw, see message and data for the reason
$this->catchAssertionFailing((array) $data, function ($data) {
$this->assertEquals('whatEver', $data['whatEver']);
}, (string) $catchData = ExpectationFailedException::class);
// Create class without constructor
$this->createInstanceWithoutConstructor((string) Class);
// Call a private or protected Method with argument(s)
$this->invokeMethod((object) Class, (string) Method, (mixed) ArgumentsForMethod);
// Set a value to private or protected property
$this->setProperty((object) Class, (string) Property, (mixed) PropertyValue);
// Get a value from a private or protected property back
$this->getProperty((object) Class, (string) Property);
// Execute test of number tries to check, if it runs multiply times successfully
$this->testLoops((callable) Function, (int) NumberOfTries, (int) NumberOfErrors);
// Execute test and when it's throw an exception, then try it again
$this->tryTest((callable) Function, (int) NumberOfTries);
}
}
```
TestPerformanceTrait is to execute two functions and see which was faster of those:
```php
class UnitTest extends What\Ever\TestCase
{
use Milanowicz\Testing\TestPerformanceTrait;
public function testMethod(): void
{
// Example functions
$cb1 = static function () {
usleep(100);
};
$cb2 = static function () {
usleep(200);
};
// Call both methods after each other and save run times from them
$this->measureTime((callable) $cb1, (callable) $cb2, (int) $n = 20);
// Check AVG and Student-Test
$this->checkPerformance((bool) $function1 = true, (float) $pValue = 0.05);
// $cb1 should be faster
$this->checkMeanTime((bool) $function1 = true);
// $cb2 should be slower and throw an Exception
$this->checkMeanTime((bool) false);
// Check if $cb1 is significant faster
$this->checkStudentTest((float) $pValue = 0.05);
// Get all time measures
$this->getTimeMeasures();
// Get both in array with AVG, STD and Median
$this->getTimeStats();
// Get result from Student-T test
$this->getTimeSignificance();
// Clear all times and measures
$this->clearTimes();
}
}
```
### Exception
Usage for AssertionFailedException to get data in Exception message:
```php
$e = new AssertionFailedException(
(string) $message = 'Testing',
(array) $data = [1],
(int) $code = 1,
(null|Throwable) $previous = null,
);
$e->toArray(); // => [1]
$e->count(); // => 1
$e->toString(); // => Message and Data as String
// and all Exception methods are available:
$e->getMessage(); // => Message and Data as String
$e->getCode(); // => 1
$e->getPrevious(); // => null OR a Throwable object
```
## Development
Run all test suites
```shell
> composer tests
```
Run PHP Code Styling
```shell
> composer style
```
Run PHPStan to analyze code
```shell
> composer analyze
```
Run PHPUnit tests
```shell
> composer test
```
Run Mutation tests by Infection
```shell
> composer infection
```
## License
[GNU GPL Version 3](http://www.gnu.org/copyleft/gpl.html)