/home/mip/mip/public/vendor/laravel-filemanager/files/folder-1/821668/phpunit.tar
php-file-iterator/LICENSE 0000644 00000002773 15243417753 0011130 0 ustar 00 BSD 3-Clause License
Copyright (c) 2009-2023, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
php-file-iterator/src/Factory.php 0000644 00000006020 15243417753 0013017 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-file-iterator.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\FileIterator;
use const GLOB_ONLYDIR;
use function array_filter;
use function array_map;
use function array_merge;
use function array_values;
use function glob;
use function is_dir;
use function is_string;
use function realpath;
use AppendIterator;
use FilesystemIterator;
use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-file-iterator
*/
final class Factory
{
/**
* @psalm-param list<non-empty-string>|non-empty-string $paths
* @psalm-param list<non-empty-string>|string $suffixes
* @psalm-param list<non-empty-string>|string $prefixes
* @psalm-param list<non-empty-string> $exclude
*/
public function getFileIterator(array|string $paths, array|string $suffixes = '', array|string $prefixes = '', array $exclude = []): AppendIterator
{
if (is_string($paths)) {
$paths = [$paths];
}
$paths = $this->resolveWildcards($paths);
$exclude = $this->resolveWildcards($exclude);
if (is_string($prefixes)) {
if ($prefixes !== '') {
$prefixes = [$prefixes];
} else {
$prefixes = [];
}
}
if (is_string($suffixes)) {
if ($suffixes !== '') {
$suffixes = [$suffixes];
} else {
$suffixes = [];
}
}
$iterator = new AppendIterator;
foreach ($paths as $path) {
if (is_dir($path)) {
$iterator->append(
new Iterator(
$path,
new RecursiveIteratorIterator(
new ExcludeIterator(
new RecursiveDirectoryIterator($path, FilesystemIterator::FOLLOW_SYMLINKS | FilesystemIterator::SKIP_DOTS),
$exclude,
),
),
$suffixes,
$prefixes,
)
);
}
}
return $iterator;
}
/**
* @psalm-param list<non-empty-string> $paths
*
* @psalm-return list<non-empty-string>
*/
private function resolveWildcards(array $paths): array
{
$_paths = [[]];
foreach ($paths as $path) {
if ($locals = glob($path, GLOB_ONLYDIR)) {
$_paths[] = array_map('\realpath', $locals);
} else {
// @codeCoverageIgnoreStart
$_paths[] = [realpath($path)];
// @codeCoverageIgnoreEnd
}
}
return array_values(array_filter(array_merge(...$_paths)));
}
}
php-file-iterator/src/ExcludeIterator.php 0000644 00000003514 15243417753 0014520 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-file-iterator.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\FileIterator;
use function assert;
use function str_starts_with;
use RecursiveDirectoryIterator;
use RecursiveFilterIterator;
use SplFileInfo;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-file-iterator
*/
final class ExcludeIterator extends RecursiveFilterIterator
{
/**
* @psalm-var list<string>
*/
private array $exclude;
/**
* @psalm-param list<string> $exclude
*/
public function __construct(RecursiveDirectoryIterator $iterator, array $exclude)
{
parent::__construct($iterator);
$this->exclude = $exclude;
}
public function accept(): bool
{
$current = $this->current();
assert($current instanceof SplFileInfo);
$path = $current->getRealPath();
if ($path === false) {
return false;
}
foreach ($this->exclude as $exclude) {
if (str_starts_with($path, $exclude)) {
return false;
}
}
return true;
}
public function hasChildren(): bool
{
return $this->getInnerIterator()->hasChildren();
}
public function getChildren(): self
{
return new self(
$this->getInnerIterator()->getChildren(),
$this->exclude
);
}
public function getInnerIterator(): RecursiveDirectoryIterator
{
$innerIterator = parent::getInnerIterator();
assert($innerIterator instanceof RecursiveDirectoryIterator);
return $innerIterator;
}
}
php-file-iterator/src/Facade.php 0000644 00000002606 15243417753 0012561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-file-iterator.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\FileIterator;
use function array_unique;
use function assert;
use function sort;
use SplFileInfo;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
/**
* @psalm-param list<non-empty-string>|non-empty-string $paths
* @psalm-param list<non-empty-string>|string $suffixes
* @psalm-param list<non-empty-string>|string $prefixes
* @psalm-param list<non-empty-string> $exclude
*
* @psalm-return list<non-empty-string>
*/
public function getFilesAsArray(array|string $paths, array|string $suffixes = '', array|string $prefixes = '', array $exclude = []): array
{
$iterator = (new Factory)->getFileIterator($paths, $suffixes, $prefixes, $exclude);
$files = [];
foreach ($iterator as $file) {
assert($file instanceof SplFileInfo);
$file = $file->getRealPath();
if ($file) {
$files[] = $file;
}
}
$files = array_unique($files);
sort($files);
return $files;
}
}
php-file-iterator/src/Iterator.php 0000644 00000005776 15243417753 0013222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-file-iterator.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\FileIterator;
use function assert;
use function preg_match;
use function realpath;
use function str_ends_with;
use function str_replace;
use function str_starts_with;
use AppendIterator;
use FilterIterator;
use SplFileInfo;
/**
* @template-extends FilterIterator<int, string, AppendIterator>
*
* @internal This class is not covered by the backward compatibility promise for phpunit/php-file-iterator
*/
final class Iterator extends FilterIterator
{
public const PREFIX = 0;
public const SUFFIX = 1;
private string|false $basePath;
/**
* @psalm-var list<string>
*/
private array $suffixes;
/**
* @psalm-var list<string>
*/
private array $prefixes;
/**
* @psalm-param list<string> $suffixes
* @psalm-param list<string> $prefixes
*/
public function __construct(string $basePath, \Iterator $iterator, array $suffixes = [], array $prefixes = [])
{
$this->basePath = realpath($basePath);
$this->prefixes = $prefixes;
$this->suffixes = $suffixes;
parent::__construct($iterator);
}
public function accept(): bool
{
$current = $this->getInnerIterator()->current();
assert($current instanceof SplFileInfo);
$filename = $current->getFilename();
$realPath = $current->getRealPath();
if ($realPath === false) {
// @codeCoverageIgnoreStart
return false;
// @codeCoverageIgnoreEnd
}
return $this->acceptPath($realPath) &&
$this->acceptPrefix($filename) &&
$this->acceptSuffix($filename);
}
private function acceptPath(string $path): bool
{
// Filter files in hidden directories by checking path that is relative to the base path.
if (preg_match('=/\.[^/]*/=', str_replace((string) $this->basePath, '', $path))) {
return false;
}
return true;
}
private function acceptPrefix(string $filename): bool
{
return $this->acceptSubString($filename, $this->prefixes, self::PREFIX);
}
private function acceptSuffix(string $filename): bool
{
return $this->acceptSubString($filename, $this->suffixes, self::SUFFIX);
}
/**
* @psalm-param list<string> $subStrings
*/
private function acceptSubString(string $filename, array $subStrings, int $type): bool
{
if (empty($subStrings)) {
return true;
}
foreach ($subStrings as $string) {
if (($type === self::PREFIX && str_starts_with($filename, $string)) ||
($type === self::SUFFIX && str_ends_with($filename, $string))) {
return true;
}
}
return false;
}
}
php-file-iterator/SECURITY.md 0000644 00000003565 15243417753 0011714 0 ustar 00 # Security Policy
If you believe you have found a security vulnerability in the library that is developed in this repository, please report it to us through coordinated disclosure.
**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**
Instead, please email `sebastian@phpunit.de`.
Please include as much of the information listed below as you can to help us better understand and resolve the issue:
* The type of issue
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
## Web Context
The library that is developed in this repository was either extracted from [PHPUnit](https://github.com/sebastianbergmann/phpunit) or developed specifically as a dependency for PHPUnit.
The library is developed with a focus on development environments and the command-line. No specific testing or hardening with regard to using the library in an HTTP or web context or with untrusted input data is performed. The library might also contain functionality that intentionally exposes internal application data for debugging purposes.
If the library is used in a web application, the application developer is responsible for filtering inputs or escaping outputs as necessary and for verifying that the used functionality is safe for use within the intended context.
Vulnerabilities specific to the use outside a development context will be fixed as applicable, provided that the fix does not have an averse effect on the primary use case for development purposes.
php-file-iterator/composer.json 0000644 00000002200 15243417753 0012626 0 ustar 00 {
"name": "phpunit/php-file-iterator",
"description": "FilterIterator implementation that filters files based on a list of suffixes.",
"type": "library",
"keywords": [
"iterator",
"filesystem"
],
"homepage": "https://github.com/sebastianbergmann/php-file-iterator/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-file-iterator/issues",
"security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"prefer-stable": true,
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"autoload": {
"classmap": [
"src/"
]
},
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
}
}
php-file-iterator/README.md 0000644 00000002024 15243417753 0011367 0 ustar 00 [](https://packagist.org/packages/phpunit/php-file-iterator)
[](https://github.com/sebastianbergmann/php-file-iterator/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-file-iterator)
[](https://codecov.io/gh/sebastianbergmann/php-file-iterator)
# php-file-iterator
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
composer require phpunit/php-file-iterator
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
composer require --dev phpunit/php-file-iterator
php-file-iterator/ChangeLog.md 0000644 00000013506 15243417753 0012270 0 ustar 00 # Change Log
All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/).
## [4.1.0] - 2023-08-31
### Added
* [#81](https://github.com/sebastianbergmann/php-file-iterator/issues/81): Accept `array|string $paths` in `Facade::getFilesAsArray()`
## [4.0.2] - 2023-05-07
### Fixed
* [#80](https://github.com/sebastianbergmann/php-file-iterator/pull/80): Ignore unresolvable symbolic link
## [4.0.1] - 2023-02-10
### Fixed
* [#67](https://github.com/sebastianbergmann/php-file-iterator/issues/61): Excluded directories are traversed unnecessarily
## [4.0.0] - 2023-02-03
### Removed
* The optional `$commonPath` parameter of `SebastianBergmann\FileIterator\Facade` as well as the functionality it controlled has been removed
* The `SebastianBergmann\FileIterator\Factory` and `SebastianBergmann\FileIterator\Iterator` classes are now marked `@internal`
* This component is no longer supported on PHP 7.3, PHP 7.4 and PHP 8.0
## [3.0.6] - 2021-12-02
### Changed
* [#73](https://github.com/sebastianbergmann/php-file-iterator/pull/73): Micro performance improvements on parsing paths
## [3.0.5] - 2020-09-28
### Changed
* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
## [3.0.4] - 2020-07-11
### Fixed
* [#67](https://github.com/sebastianbergmann/php-file-iterator/issues/67): `TypeError` in `SebastianBergmann\FileIterator\Iterator::accept()`
## [3.0.3] - 2020-06-26
### Added
* This component is now supported on PHP 8
## [3.0.2] - 2020-06-15
### Changed
* Tests etc. are now ignored for archive exports
## [3.0.1] - 2020-04-18
### Fixed
* [#64](https://github.com/sebastianbergmann/php-file-iterator/issues/64): Release tarball contains Composer PHAR
## [3.0.0] - 2020-02-07
### Removed
* This component is no longer supported on PHP 7.1 and PHP 7.2
## [2.0.5] - 2021-12-02
### Changed
* [#73](https://github.com/sebastianbergmann/php-file-iterator/pull/73): Micro performance improvements on parsing paths
### Fixed
* [#74](https://github.com/sebastianbergmann/php-file-iterator/pull/74): Document return type of `SebastianBergmann\FileIterator\Iterator::accept()` so that Symfony's `DebugClassLoader` does not trigger a deprecation warning
## [2.0.4] - 2021-07-19
### Changed
* Added `ReturnTypeWillChange` attribute to `SebastianBergmann\FileIterator\Iterator::accept()` because the return type of `\FilterIterator::accept()` will change in PHP 8.1
## [2.0.3] - 2020-11-30
### Changed
* Changed PHP version constraint in `composer.json` from `^7.1` to `>=7.1`
## [2.0.2] - 2018-09-13
### Fixed
* [#48](https://github.com/sebastianbergmann/php-file-iterator/issues/48): Excluding an array that contains false ends up excluding the current working directory
## [2.0.1] - 2018-06-11
### Fixed
* [#46](https://github.com/sebastianbergmann/php-file-iterator/issues/46): Regression with hidden parent directory
## [2.0.0] - 2018-05-28
### Fixed
* [#30](https://github.com/sebastianbergmann/php-file-iterator/issues/30): Exclude is not considered if it is a parent of the base path
### Changed
* This component now uses namespaces
### Removed
* This component is no longer supported on PHP 5.3, PHP 5.4, PHP 5.5, PHP 5.6, and PHP 7.0
## [1.4.5] - 2017-11-27
### Fixed
* [#37](https://github.com/sebastianbergmann/php-file-iterator/issues/37): Regression caused by fix for [#30](https://github.com/sebastianbergmann/php-file-iterator/issues/30)
## [1.4.4] - 2017-11-27
### Fixed
* [#30](https://github.com/sebastianbergmann/php-file-iterator/issues/30): Exclude is not considered if it is a parent of the base path
## [1.4.3] - 2017-11-25
### Fixed
* [#34](https://github.com/sebastianbergmann/php-file-iterator/issues/34): Factory should use canonical directory names
## [1.4.2] - 2016-11-26
No changes
## [1.4.1] - 2015-07-26
No changes
## 1.4.0 - 2015-04-02
### Added
* [#23](https://github.com/sebastianbergmann/php-file-iterator/pull/23): Added support for wildcards (glob) in exclude
[4.1.0]: https://github.com/sebastianbergmann/php-file-iterator/compare/4.0.2...4.1.0
[4.0.2]: https://github.com/sebastianbergmann/php-file-iterator/compare/4.0.1...4.0.2
[4.0.1]: https://github.com/sebastianbergmann/php-file-iterator/compare/4.0.0...4.0.1
[4.0.0]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.6...4.0.0
[3.0.6]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.5...3.0.6
[3.0.5]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.4...3.0.5
[3.0.4]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.3...3.0.4
[3.0.3]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.2...3.0.3
[3.0.2]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.1...3.0.2
[3.0.1]: https://github.com/sebastianbergmann/php-file-iterator/compare/3.0.0...3.0.1
[3.0.0]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.5...3.0.0
[2.0.5]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.4...2.0.5
[2.0.4]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.3...2.0.4
[2.0.3]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.2...2.0.3
[2.0.2]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.1...2.0.2
[2.0.1]: https://github.com/sebastianbergmann/php-file-iterator/compare/2.0.0...2.0.1
[2.0.0]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.5...2.0.0
[1.4.5]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.4...1.4.5
[1.4.4]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.3...1.4.4
[1.4.3]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.2...1.4.3
[1.4.2]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.1...1.4.2
[1.4.1]: https://github.com/sebastianbergmann/php-file-iterator/compare/1.4.0...1.4.1
php-code-coverage/LICENSE 0000644 00000002773 15243417753 0011065 0 ustar 00 BSD 3-Clause License
Copyright (c) 2009-2024, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
php-code-coverage/src/TestSize/Known.php 0000644 00000001114 15243417753 0014212 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
abstract class Known extends TestSize
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
abstract public function isGreaterThan(self $other): bool;
}
php-code-coverage/src/TestSize/Medium.php 0000644 00000001276 15243417753 0014347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
final class Medium extends Known
{
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return $other->isSmall();
}
public function asString(): string
{
return 'medium';
}
}
php-code-coverage/src/TestSize/Unknown.php 0000644 00000001135 15243417753 0014560 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
final class Unknown extends TestSize
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asString(): string
{
return 'unknown';
}
}
php-code-coverage/src/TestSize/TestSize.php 0000644 00000002575 15243417753 0014704 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
abstract class TestSize
{
public static function unknown(): self
{
return new Unknown;
}
public static function small(): self
{
return new Small;
}
public static function medium(): self
{
return new Medium;
}
public static function large(): self
{
return new Large;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return false;
}
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return false;
}
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return false;
}
abstract public function asString(): string;
}
php-code-coverage/src/TestSize/Small.php 0000644 00000001256 15243417753 0014175 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
final class Small extends Known
{
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return false;
}
public function asString(): string
{
return 'small';
}
}
php-code-coverage/src/TestSize/Large.php 0000644 00000001273 15243417753 0014156 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestSize;
/**
* @psalm-immutable
*/
final class Large extends Known
{
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return !$other->isLarge();
}
public function asString(): string
{
return 'large';
}
}
php-code-coverage/src/TestStatus/TestStatus.php 0000644 00000002275 15243417753 0015623 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestStatus;
/**
* @psalm-immutable
*/
abstract class TestStatus
{
public static function unknown(): self
{
return new Unknown;
}
public static function success(): self
{
return new Success;
}
public static function failure(): self
{
return new Failure;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return false;
}
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return false;
}
abstract public function asString(): string;
}
php-code-coverage/src/TestStatus/Success.php 0000644 00000001134 15243417753 0015101 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestStatus;
/**
* @psalm-immutable
*/
final class Success extends Known
{
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return true;
}
public function asString(): string
{
return 'success';
}
}
php-code-coverage/src/TestStatus/Known.php 0000644 00000001020 15243417753 0014557 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestStatus;
/**
* @psalm-immutable
*/
abstract class Known extends TestStatus
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
}
php-code-coverage/src/TestStatus/Unknown.php 0000644 00000001141 15243417753 0015126 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestStatus;
/**
* @psalm-immutable
*/
final class Unknown extends TestStatus
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asString(): string
{
return 'unknown';
}
}
php-code-coverage/src/TestStatus/Failure.php 0000644 00000001134 15243417753 0015060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Test\TestStatus;
/**
* @psalm-immutable
*/
final class Failure extends Known
{
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return true;
}
public function asString(): string
{
return 'failure';
}
}
php-code-coverage/src/Node/Builder.php 0000644 00000016127 15243417753 0013631 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use const DIRECTORY_SEPARATOR;
use function array_shift;
use function basename;
use function count;
use function dirname;
use function explode;
use function implode;
use function is_file;
use function str_ends_with;
use function str_replace;
use function str_starts_with;
use function substr;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Data\ProcessedCodeCoverageData;
use SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type TestType from \SebastianBergmann\CodeCoverage\CodeCoverage
*/
final class Builder
{
private readonly FileAnalyser $analyser;
public function __construct(FileAnalyser $analyser)
{
$this->analyser = $analyser;
}
public function build(CodeCoverage $coverage): Directory
{
$data = clone $coverage->getData(); // clone because path munging is destructive to the original data
$commonPath = $this->reducePaths($data);
$root = new Directory(
$commonPath,
null,
);
$this->addItems(
$root,
$this->buildDirectoryStructure($data),
$coverage->getTests(),
);
return $root;
}
/**
* @psalm-param array<string, TestType> $tests
*/
private function addItems(Directory $root, array $items, array $tests): void
{
foreach ($items as $key => $value) {
$key = (string) $key;
if (str_ends_with($key, '/f')) {
$key = substr($key, 0, -2);
$filename = $root->pathAsString() . DIRECTORY_SEPARATOR . $key;
if (is_file($filename)) {
$root->addFile(
new File(
$key,
$root,
$value['lineCoverage'],
$value['functionCoverage'],
$tests,
$this->analyser->classesIn($filename),
$this->analyser->traitsIn($filename),
$this->analyser->functionsIn($filename),
$this->analyser->linesOfCodeFor($filename),
),
);
}
} else {
$child = $root->addDirectory($key);
$this->addItems($child, $value, $tests);
}
}
}
/**
* Builds an array representation of the directory structure.
*
* For instance,
*
* <code>
* Array
* (
* [Money.php] => Array
* (
* ...
* )
*
* [MoneyBag.php] => Array
* (
* ...
* )
* )
* </code>
*
* is transformed into
*
* <code>
* Array
* (
* [.] => Array
* (
* [Money.php] => Array
* (
* ...
* )
*
* [MoneyBag.php] => Array
* (
* ...
* )
* )
* )
* </code>
*
* @psalm-return array<string, array<string, array{lineCoverage: array<int, int>, functionCoverage: array<string, array<int, int>>}>>
*/
private function buildDirectoryStructure(ProcessedCodeCoverageData $data): array
{
$result = [];
foreach ($data->coveredFiles() as $originalPath) {
$path = explode(DIRECTORY_SEPARATOR, $originalPath);
$pointer = &$result;
$max = count($path);
for ($i = 0; $i < $max; $i++) {
$type = '';
if ($i === ($max - 1)) {
$type = '/f';
}
$pointer = &$pointer[$path[$i] . $type];
}
$pointer = [
'lineCoverage' => $data->lineCoverage()[$originalPath] ?? [],
'functionCoverage' => $data->functionCoverage()[$originalPath] ?? [],
];
}
return $result;
}
/**
* Reduces the paths by cutting the longest common start path.
*
* For instance,
*
* <code>
* Array
* (
* [/home/sb/Money/Money.php] => Array
* (
* ...
* )
*
* [/home/sb/Money/MoneyBag.php] => Array
* (
* ...
* )
* )
* </code>
*
* is reduced to
*
* <code>
* Array
* (
* [Money.php] => Array
* (
* ...
* )
*
* [MoneyBag.php] => Array
* (
* ...
* )
* )
* </code>
*/
private function reducePaths(ProcessedCodeCoverageData $coverage): string
{
if (empty($coverage->coveredFiles())) {
return '.';
}
$commonPath = '';
$paths = $coverage->coveredFiles();
if (count($paths) === 1) {
$commonPath = dirname($paths[0]) . DIRECTORY_SEPARATOR;
$coverage->renameFile($paths[0], basename($paths[0]));
return $commonPath;
}
$max = count($paths);
for ($i = 0; $i < $max; $i++) {
// strip phar:// prefixes
if (str_starts_with($paths[$i], 'phar://')) {
$paths[$i] = substr($paths[$i], 7);
$paths[$i] = str_replace('/', DIRECTORY_SEPARATOR, $paths[$i]);
}
$paths[$i] = explode(DIRECTORY_SEPARATOR, $paths[$i]);
if (empty($paths[$i][0])) {
$paths[$i][0] = DIRECTORY_SEPARATOR;
}
}
$done = false;
$max = count($paths);
while (!$done) {
for ($i = 0; $i < $max - 1; $i++) {
if (!isset($paths[$i][0]) ||
!isset($paths[$i + 1][0]) ||
$paths[$i][0] !== $paths[$i + 1][0]) {
$done = true;
break;
}
}
if (!$done) {
$commonPath .= $paths[0][0];
if ($paths[0][0] !== DIRECTORY_SEPARATOR) {
$commonPath .= DIRECTORY_SEPARATOR;
}
for ($i = 0; $i < $max; $i++) {
array_shift($paths[$i]);
}
}
}
$original = $coverage->coveredFiles();
$max = count($original);
for ($i = 0; $i < $max; $i++) {
$coverage->renameFile($original[$i], implode(DIRECTORY_SEPARATOR, $paths[$i]));
}
return substr($commonPath, 0, -1);
}
}
php-code-coverage/src/Node/AbstractNode.php 0000644 00000015155 15243417753 0014614 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use const DIRECTORY_SEPARATOR;
use function array_merge;
use function str_ends_with;
use function str_replace;
use function substr;
use Countable;
use SebastianBergmann\CodeCoverage\Util\Percentage;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
* @psalm-import-type ProcessedFunctionType from \SebastianBergmann\CodeCoverage\Node\File
* @psalm-import-type ProcessedClassType from \SebastianBergmann\CodeCoverage\Node\File
* @psalm-import-type ProcessedTraitType from \SebastianBergmann\CodeCoverage\Node\File
*/
abstract class AbstractNode implements Countable
{
private readonly string $name;
private string $pathAsString;
private array $pathAsArray;
private readonly ?AbstractNode $parent;
private string $id;
public function __construct(string $name, ?self $parent = null)
{
if (str_ends_with($name, DIRECTORY_SEPARATOR)) {
$name = substr($name, 0, -1);
}
$this->name = $name;
$this->parent = $parent;
$this->processId();
$this->processPath();
}
public function name(): string
{
return $this->name;
}
public function id(): string
{
return $this->id;
}
public function pathAsString(): string
{
return $this->pathAsString;
}
public function pathAsArray(): array
{
return $this->pathAsArray;
}
public function parent(): ?self
{
return $this->parent;
}
public function percentageOfTestedClasses(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedClasses(),
$this->numberOfClasses(),
);
}
public function percentageOfTestedTraits(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedTraits(),
$this->numberOfTraits(),
);
}
public function percentageOfTestedClassesAndTraits(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedClassesAndTraits(),
$this->numberOfClassesAndTraits(),
);
}
public function percentageOfTestedFunctions(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedFunctions(),
$this->numberOfFunctions(),
);
}
public function percentageOfTestedMethods(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedMethods(),
$this->numberOfMethods(),
);
}
public function percentageOfTestedFunctionsAndMethods(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfTestedFunctionsAndMethods(),
$this->numberOfFunctionsAndMethods(),
);
}
public function percentageOfExecutedLines(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfExecutedLines(),
$this->numberOfExecutableLines(),
);
}
public function percentageOfExecutedBranches(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfExecutedBranches(),
$this->numberOfExecutableBranches(),
);
}
public function percentageOfExecutedPaths(): Percentage
{
return Percentage::fromFractionAndTotal(
$this->numberOfExecutedPaths(),
$this->numberOfExecutablePaths(),
);
}
public function numberOfClassesAndTraits(): int
{
return $this->numberOfClasses() + $this->numberOfTraits();
}
public function numberOfTestedClassesAndTraits(): int
{
return $this->numberOfTestedClasses() + $this->numberOfTestedTraits();
}
public function classesAndTraits(): array
{
return array_merge($this->classes(), $this->traits());
}
public function numberOfFunctionsAndMethods(): int
{
return $this->numberOfFunctions() + $this->numberOfMethods();
}
public function numberOfTestedFunctionsAndMethods(): int
{
return $this->numberOfTestedFunctions() + $this->numberOfTestedMethods();
}
/**
* @psalm-return array<string, ProcessedClassType>
*/
abstract public function classes(): array;
/**
* @psalm-return array<string, ProcessedTraitType>
*/
abstract public function traits(): array;
/**
* @psalm-return array<string, ProcessedFunctionType>
*/
abstract public function functions(): array;
/**
* @psalm-return LinesOfCodeType
*/
abstract public function linesOfCode(): array;
abstract public function numberOfExecutableLines(): int;
abstract public function numberOfExecutedLines(): int;
abstract public function numberOfExecutableBranches(): int;
abstract public function numberOfExecutedBranches(): int;
abstract public function numberOfExecutablePaths(): int;
abstract public function numberOfExecutedPaths(): int;
abstract public function numberOfClasses(): int;
abstract public function numberOfTestedClasses(): int;
abstract public function numberOfTraits(): int;
abstract public function numberOfTestedTraits(): int;
abstract public function numberOfMethods(): int;
abstract public function numberOfTestedMethods(): int;
abstract public function numberOfFunctions(): int;
abstract public function numberOfTestedFunctions(): int;
private function processId(): void
{
if ($this->parent === null) {
$this->id = 'index';
return;
}
$parentId = $this->parent->id();
if ($parentId === 'index') {
$this->id = str_replace(':', '_', $this->name);
} else {
$this->id = $parentId . '/' . $this->name;
}
}
private function processPath(): void
{
if ($this->parent === null) {
$this->pathAsArray = [$this];
$this->pathAsString = $this->name;
return;
}
$this->pathAsArray = $this->parent->pathAsArray();
$this->pathAsString = $this->parent->pathAsString() . DIRECTORY_SEPARATOR . $this->name;
$this->pathAsArray[] = $this;
}
}
php-code-coverage/src/Node/Directory.php 0000644 00000023015 15243417753 0014201 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use function array_merge;
use function count;
use IteratorAggregate;
use RecursiveIteratorIterator;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*/
final class Directory extends AbstractNode implements IteratorAggregate
{
/**
* @var list<AbstractNode>
*/
private array $children = [];
/**
* @var list<Directory>
*/
private array $directories = [];
/**
* @var list<File>
*/
private array $files = [];
private ?array $classes = null;
private ?array $traits = null;
private ?array $functions = null;
/**
* @psalm-var null|LinesOfCodeType
*/
private ?array $linesOfCode = null;
private int $numFiles = -1;
private int $numExecutableLines = -1;
private int $numExecutedLines = -1;
private int $numExecutableBranches = -1;
private int $numExecutedBranches = -1;
private int $numExecutablePaths = -1;
private int $numExecutedPaths = -1;
private int $numClasses = -1;
private int $numTestedClasses = -1;
private int $numTraits = -1;
private int $numTestedTraits = -1;
private int $numMethods = -1;
private int $numTestedMethods = -1;
private int $numFunctions = -1;
private int $numTestedFunctions = -1;
public function count(): int
{
if ($this->numFiles === -1) {
$this->numFiles = 0;
foreach ($this->children as $child) {
$this->numFiles += count($child);
}
}
return $this->numFiles;
}
public function getIterator(): RecursiveIteratorIterator
{
return new RecursiveIteratorIterator(
new Iterator($this),
RecursiveIteratorIterator::SELF_FIRST,
);
}
public function addDirectory(string $name): self
{
$directory = new self($name, $this);
$this->children[] = $directory;
$this->directories[] = &$this->children[count($this->children) - 1];
return $directory;
}
public function addFile(File $file): void
{
$this->children[] = $file;
$this->files[] = &$this->children[count($this->children) - 1];
$this->numExecutableLines = -1;
$this->numExecutedLines = -1;
}
public function directories(): array
{
return $this->directories;
}
public function files(): array
{
return $this->files;
}
public function children(): array
{
return $this->children;
}
public function classes(): array
{
if ($this->classes === null) {
$this->classes = [];
foreach ($this->children as $child) {
$this->classes = array_merge(
$this->classes,
$child->classes(),
);
}
}
return $this->classes;
}
public function traits(): array
{
if ($this->traits === null) {
$this->traits = [];
foreach ($this->children as $child) {
$this->traits = array_merge(
$this->traits,
$child->traits(),
);
}
}
return $this->traits;
}
public function functions(): array
{
if ($this->functions === null) {
$this->functions = [];
foreach ($this->children as $child) {
$this->functions = array_merge(
$this->functions,
$child->functions(),
);
}
}
return $this->functions;
}
/**
* @psalm-return LinesOfCodeType
*/
public function linesOfCode(): array
{
if ($this->linesOfCode === null) {
$this->linesOfCode = [
'linesOfCode' => 0,
'commentLinesOfCode' => 0,
'nonCommentLinesOfCode' => 0,
];
foreach ($this->children as $child) {
$childLinesOfCode = $child->linesOfCode();
$this->linesOfCode['linesOfCode'] += $childLinesOfCode['linesOfCode'];
$this->linesOfCode['commentLinesOfCode'] += $childLinesOfCode['commentLinesOfCode'];
$this->linesOfCode['nonCommentLinesOfCode'] += $childLinesOfCode['nonCommentLinesOfCode'];
}
}
return $this->linesOfCode;
}
public function numberOfExecutableLines(): int
{
if ($this->numExecutableLines === -1) {
$this->numExecutableLines = 0;
foreach ($this->children as $child) {
$this->numExecutableLines += $child->numberOfExecutableLines();
}
}
return $this->numExecutableLines;
}
public function numberOfExecutedLines(): int
{
if ($this->numExecutedLines === -1) {
$this->numExecutedLines = 0;
foreach ($this->children as $child) {
$this->numExecutedLines += $child->numberOfExecutedLines();
}
}
return $this->numExecutedLines;
}
public function numberOfExecutableBranches(): int
{
if ($this->numExecutableBranches === -1) {
$this->numExecutableBranches = 0;
foreach ($this->children as $child) {
$this->numExecutableBranches += $child->numberOfExecutableBranches();
}
}
return $this->numExecutableBranches;
}
public function numberOfExecutedBranches(): int
{
if ($this->numExecutedBranches === -1) {
$this->numExecutedBranches = 0;
foreach ($this->children as $child) {
$this->numExecutedBranches += $child->numberOfExecutedBranches();
}
}
return $this->numExecutedBranches;
}
public function numberOfExecutablePaths(): int
{
if ($this->numExecutablePaths === -1) {
$this->numExecutablePaths = 0;
foreach ($this->children as $child) {
$this->numExecutablePaths += $child->numberOfExecutablePaths();
}
}
return $this->numExecutablePaths;
}
public function numberOfExecutedPaths(): int
{
if ($this->numExecutedPaths === -1) {
$this->numExecutedPaths = 0;
foreach ($this->children as $child) {
$this->numExecutedPaths += $child->numberOfExecutedPaths();
}
}
return $this->numExecutedPaths;
}
public function numberOfClasses(): int
{
if ($this->numClasses === -1) {
$this->numClasses = 0;
foreach ($this->children as $child) {
$this->numClasses += $child->numberOfClasses();
}
}
return $this->numClasses;
}
public function numberOfTestedClasses(): int
{
if ($this->numTestedClasses === -1) {
$this->numTestedClasses = 0;
foreach ($this->children as $child) {
$this->numTestedClasses += $child->numberOfTestedClasses();
}
}
return $this->numTestedClasses;
}
public function numberOfTraits(): int
{
if ($this->numTraits === -1) {
$this->numTraits = 0;
foreach ($this->children as $child) {
$this->numTraits += $child->numberOfTraits();
}
}
return $this->numTraits;
}
public function numberOfTestedTraits(): int
{
if ($this->numTestedTraits === -1) {
$this->numTestedTraits = 0;
foreach ($this->children as $child) {
$this->numTestedTraits += $child->numberOfTestedTraits();
}
}
return $this->numTestedTraits;
}
public function numberOfMethods(): int
{
if ($this->numMethods === -1) {
$this->numMethods = 0;
foreach ($this->children as $child) {
$this->numMethods += $child->numberOfMethods();
}
}
return $this->numMethods;
}
public function numberOfTestedMethods(): int
{
if ($this->numTestedMethods === -1) {
$this->numTestedMethods = 0;
foreach ($this->children as $child) {
$this->numTestedMethods += $child->numberOfTestedMethods();
}
}
return $this->numTestedMethods;
}
public function numberOfFunctions(): int
{
if ($this->numFunctions === -1) {
$this->numFunctions = 0;
foreach ($this->children as $child) {
$this->numFunctions += $child->numberOfFunctions();
}
}
return $this->numFunctions;
}
public function numberOfTestedFunctions(): int
{
if ($this->numTestedFunctions === -1) {
$this->numTestedFunctions = 0;
foreach ($this->children as $child) {
$this->numTestedFunctions += $child->numberOfTestedFunctions();
}
}
return $this->numTestedFunctions;
}
}
php-code-coverage/src/Node/File.php 0000644 00000060616 15243417753 0013124 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use function array_filter;
use function count;
use function range;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type CodeUnitFunctionType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitMethodType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitClassType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitTraitType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
* @psalm-import-type LinesType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*
* @psalm-type ProcessedFunctionType = array{
* functionName: string,
* namespace: string,
* signature: string,
* startLine: int,
* endLine: int,
* executableLines: int,
* executedLines: int,
* executableBranches: int,
* executedBranches: int,
* executablePaths: int,
* executedPaths: int,
* ccn: int,
* coverage: int|float,
* crap: int|string,
* link: string
* }
* @psalm-type ProcessedMethodType = array{
* methodName: string,
* visibility: string,
* signature: string,
* startLine: int,
* endLine: int,
* executableLines: int,
* executedLines: int,
* executableBranches: int,
* executedBranches: int,
* executablePaths: int,
* executedPaths: int,
* ccn: int,
* coverage: float|int,
* crap: int|string,
* link: string
* }
* @psalm-type ProcessedClassType = array{
* className: string,
* namespace: string,
* methods: array<string, ProcessedMethodType>,
* startLine: int,
* executableLines: int,
* executedLines: int,
* executableBranches: int,
* executedBranches: int,
* executablePaths: int,
* executedPaths: int,
* ccn: int,
* coverage: int|float,
* crap: int|string,
* link: string
* }
* @psalm-type ProcessedTraitType = array{
* traitName: string,
* namespace: string,
* methods: array<string, ProcessedMethodType>,
* startLine: int,
* executableLines: int,
* executedLines: int,
* executableBranches: int,
* executedBranches: int,
* executablePaths: int,
* executedPaths: int,
* ccn: int,
* coverage: float|int,
* crap: int|string,
* link: string
* }
*/
final class File extends AbstractNode
{
/**
* @psalm-var array<int, ?list<non-empty-string>>
*/
private array $lineCoverageData;
private array $functionCoverageData;
private readonly array $testData;
private int $numExecutableLines = 0;
private int $numExecutedLines = 0;
private int $numExecutableBranches = 0;
private int $numExecutedBranches = 0;
private int $numExecutablePaths = 0;
private int $numExecutedPaths = 0;
/**
* @psalm-var array<string, ProcessedClassType>
*/
private array $classes = [];
/**
* @psalm-var array<string, ProcessedTraitType>
*/
private array $traits = [];
/**
* @psalm-var array<string, ProcessedFunctionType>
*/
private array $functions = [];
/**
* @psalm-var LinesOfCodeType
*/
private readonly array $linesOfCode;
private ?int $numClasses = null;
private int $numTestedClasses = 0;
private ?int $numTraits = null;
private int $numTestedTraits = 0;
private ?int $numMethods = null;
private ?int $numTestedMethods = null;
private ?int $numTestedFunctions = null;
/**
* @var array<int, array|array{0: CodeUnitClassType, 1: string}|array{0: CodeUnitFunctionType}|array{0: CodeUnitTraitType, 1: string}>
*/
private array $codeUnitsByLine = [];
/**
* @psalm-param array<int, ?list<non-empty-string>> $lineCoverageData
* @psalm-param LinesOfCodeType $linesOfCode
* @psalm-param array<string, CodeUnitClassType> $classes
* @psalm-param array<string, CodeUnitTraitType> $traits
* @psalm-param array<string, CodeUnitFunctionType> $functions
*/
public function __construct(string $name, AbstractNode $parent, array $lineCoverageData, array $functionCoverageData, array $testData, array $classes, array $traits, array $functions, array $linesOfCode)
{
parent::__construct($name, $parent);
$this->lineCoverageData = $lineCoverageData;
$this->functionCoverageData = $functionCoverageData;
$this->testData = $testData;
$this->linesOfCode = $linesOfCode;
$this->calculateStatistics($classes, $traits, $functions);
}
public function count(): int
{
return 1;
}
/**
* @psalm-return array<int, ?list<non-empty-string>>
*/
public function lineCoverageData(): array
{
return $this->lineCoverageData;
}
public function functionCoverageData(): array
{
return $this->functionCoverageData;
}
public function testData(): array
{
return $this->testData;
}
public function classes(): array
{
return $this->classes;
}
public function traits(): array
{
return $this->traits;
}
public function functions(): array
{
return $this->functions;
}
public function linesOfCode(): array
{
return $this->linesOfCode;
}
public function numberOfExecutableLines(): int
{
return $this->numExecutableLines;
}
public function numberOfExecutedLines(): int
{
return $this->numExecutedLines;
}
public function numberOfExecutableBranches(): int
{
return $this->numExecutableBranches;
}
public function numberOfExecutedBranches(): int
{
return $this->numExecutedBranches;
}
public function numberOfExecutablePaths(): int
{
return $this->numExecutablePaths;
}
public function numberOfExecutedPaths(): int
{
return $this->numExecutedPaths;
}
public function numberOfClasses(): int
{
if ($this->numClasses === null) {
$this->numClasses = 0;
foreach ($this->classes as $class) {
foreach ($class['methods'] as $method) {
if ($method['executableLines'] > 0) {
$this->numClasses++;
continue 2;
}
}
}
}
return $this->numClasses;
}
public function numberOfTestedClasses(): int
{
return $this->numTestedClasses;
}
public function numberOfTraits(): int
{
if ($this->numTraits === null) {
$this->numTraits = 0;
foreach ($this->traits as $trait) {
foreach ($trait['methods'] as $method) {
if ($method['executableLines'] > 0) {
$this->numTraits++;
continue 2;
}
}
}
}
return $this->numTraits;
}
public function numberOfTestedTraits(): int
{
return $this->numTestedTraits;
}
public function numberOfMethods(): int
{
if ($this->numMethods === null) {
$this->numMethods = 0;
foreach ($this->classes as $class) {
foreach ($class['methods'] as $method) {
if ($method['executableLines'] > 0) {
$this->numMethods++;
}
}
}
foreach ($this->traits as $trait) {
foreach ($trait['methods'] as $method) {
if ($method['executableLines'] > 0) {
$this->numMethods++;
}
}
}
}
return $this->numMethods;
}
public function numberOfTestedMethods(): int
{
if ($this->numTestedMethods === null) {
$this->numTestedMethods = 0;
foreach ($this->classes as $class) {
foreach ($class['methods'] as $method) {
if ($method['executableLines'] > 0 &&
$method['coverage'] === 100) {
$this->numTestedMethods++;
}
}
}
foreach ($this->traits as $trait) {
foreach ($trait['methods'] as $method) {
if ($method['executableLines'] > 0 &&
$method['coverage'] === 100) {
$this->numTestedMethods++;
}
}
}
}
return $this->numTestedMethods;
}
public function numberOfFunctions(): int
{
return count($this->functions);
}
public function numberOfTestedFunctions(): int
{
if ($this->numTestedFunctions === null) {
$this->numTestedFunctions = 0;
foreach ($this->functions as $function) {
if ($function['executableLines'] > 0 &&
$function['coverage'] === 100) {
$this->numTestedFunctions++;
}
}
}
return $this->numTestedFunctions;
}
/**
* @psalm-param array<string, CodeUnitClassType> $classes
* @psalm-param array<string, CodeUnitTraitType> $traits
* @psalm-param array<string, CodeUnitFunctionType> $functions
*/
private function calculateStatistics(array $classes, array $traits, array $functions): void
{
foreach (range(1, $this->linesOfCode['linesOfCode']) as $lineNumber) {
$this->codeUnitsByLine[$lineNumber] = [];
}
$this->processClasses($classes);
$this->processTraits($traits);
$this->processFunctions($functions);
foreach (range(1, $this->linesOfCode['linesOfCode']) as $lineNumber) {
if (isset($this->lineCoverageData[$lineNumber])) {
foreach ($this->codeUnitsByLine[$lineNumber] as &$codeUnit) {
$codeUnit['executableLines']++;
}
unset($codeUnit);
$this->numExecutableLines++;
if (count($this->lineCoverageData[$lineNumber]) > 0) {
foreach ($this->codeUnitsByLine[$lineNumber] as &$codeUnit) {
$codeUnit['executedLines']++;
}
unset($codeUnit);
$this->numExecutedLines++;
}
}
}
foreach ($this->traits as &$trait) {
foreach ($trait['methods'] as &$method) {
$methodLineCoverage = $method['executableLines'] ? ($method['executedLines'] / $method['executableLines']) * 100 : 100;
$methodBranchCoverage = $method['executableBranches'] ? ($method['executedBranches'] / $method['executableBranches']) * 100 : 0;
$methodPathCoverage = $method['executablePaths'] ? ($method['executedPaths'] / $method['executablePaths']) * 100 : 0;
$method['coverage'] = $methodBranchCoverage ?: $methodLineCoverage;
$method['crap'] = (new CrapIndex($method['ccn'], $methodPathCoverage ?: $methodLineCoverage))->asString();
$trait['ccn'] += $method['ccn'];
}
unset($method);
$traitLineCoverage = $trait['executableLines'] ? ($trait['executedLines'] / $trait['executableLines']) * 100 : 100;
$traitBranchCoverage = $trait['executableBranches'] ? ($trait['executedBranches'] / $trait['executableBranches']) * 100 : 0;
$traitPathCoverage = $trait['executablePaths'] ? ($trait['executedPaths'] / $trait['executablePaths']) * 100 : 0;
$trait['coverage'] = $traitBranchCoverage ?: $traitLineCoverage;
$trait['crap'] = (new CrapIndex($trait['ccn'], $traitPathCoverage ?: $traitLineCoverage))->asString();
if ($trait['executableLines'] > 0 && $trait['coverage'] === 100) {
$this->numTestedClasses++;
}
}
unset($trait);
foreach ($this->classes as &$class) {
foreach ($class['methods'] as &$method) {
$methodLineCoverage = $method['executableLines'] ? ($method['executedLines'] / $method['executableLines']) * 100 : 100;
$methodBranchCoverage = $method['executableBranches'] ? ($method['executedBranches'] / $method['executableBranches']) * 100 : 0;
$methodPathCoverage = $method['executablePaths'] ? ($method['executedPaths'] / $method['executablePaths']) * 100 : 0;
$method['coverage'] = $methodBranchCoverage ?: $methodLineCoverage;
$method['crap'] = (new CrapIndex($method['ccn'], $methodPathCoverage ?: $methodLineCoverage))->asString();
$class['ccn'] += $method['ccn'];
}
unset($method);
$classLineCoverage = $class['executableLines'] ? ($class['executedLines'] / $class['executableLines']) * 100 : 100;
$classBranchCoverage = $class['executableBranches'] ? ($class['executedBranches'] / $class['executableBranches']) * 100 : 0;
$classPathCoverage = $class['executablePaths'] ? ($class['executedPaths'] / $class['executablePaths']) * 100 : 0;
$class['coverage'] = $classBranchCoverage ?: $classLineCoverage;
$class['crap'] = (new CrapIndex($class['ccn'], $classPathCoverage ?: $classLineCoverage))->asString();
if ($class['executableLines'] > 0 && $class['coverage'] === 100) {
$this->numTestedClasses++;
}
}
unset($class);
foreach ($this->functions as &$function) {
$functionLineCoverage = $function['executableLines'] ? ($function['executedLines'] / $function['executableLines']) * 100 : 100;
$functionBranchCoverage = $function['executableBranches'] ? ($function['executedBranches'] / $function['executableBranches']) * 100 : 0;
$functionPathCoverage = $function['executablePaths'] ? ($function['executedPaths'] / $function['executablePaths']) * 100 : 0;
$function['coverage'] = $functionBranchCoverage ?: $functionLineCoverage;
$function['crap'] = (new CrapIndex($function['ccn'], $functionPathCoverage ?: $functionLineCoverage))->asString();
if ($function['coverage'] === 100) {
$this->numTestedFunctions++;
}
}
}
/**
* @psalm-param array<string, CodeUnitClassType> $classes
*/
private function processClasses(array $classes): void
{
$link = $this->id() . '.html#';
foreach ($classes as $className => $class) {
$this->classes[$className] = [
'className' => $className,
'namespace' => $class['namespace'],
'methods' => [],
'startLine' => $class['startLine'],
'executableLines' => 0,
'executedLines' => 0,
'executableBranches' => 0,
'executedBranches' => 0,
'executablePaths' => 0,
'executedPaths' => 0,
'ccn' => 0,
'coverage' => 0,
'crap' => 0,
'link' => $link . $class['startLine'],
];
foreach ($class['methods'] as $methodName => $method) {
$methodData = $this->newMethod($className, $methodName, $method, $link);
$this->classes[$className]['methods'][$methodName] = $methodData;
$this->classes[$className]['executableBranches'] += $methodData['executableBranches'];
$this->classes[$className]['executedBranches'] += $methodData['executedBranches'];
$this->classes[$className]['executablePaths'] += $methodData['executablePaths'];
$this->classes[$className]['executedPaths'] += $methodData['executedPaths'];
$this->numExecutableBranches += $methodData['executableBranches'];
$this->numExecutedBranches += $methodData['executedBranches'];
$this->numExecutablePaths += $methodData['executablePaths'];
$this->numExecutedPaths += $methodData['executedPaths'];
foreach (range($method['startLine'], $method['endLine']) as $lineNumber) {
$this->codeUnitsByLine[$lineNumber] = [
&$this->classes[$className],
&$this->classes[$className]['methods'][$methodName],
];
}
}
}
}
/**
* @psalm-param array<string, CodeUnitTraitType> $traits
*/
private function processTraits(array $traits): void
{
$link = $this->id() . '.html#';
foreach ($traits as $traitName => $trait) {
$this->traits[$traitName] = [
'traitName' => $traitName,
'namespace' => $trait['namespace'],
'methods' => [],
'startLine' => $trait['startLine'],
'executableLines' => 0,
'executedLines' => 0,
'executableBranches' => 0,
'executedBranches' => 0,
'executablePaths' => 0,
'executedPaths' => 0,
'ccn' => 0,
'coverage' => 0,
'crap' => 0,
'link' => $link . $trait['startLine'],
];
foreach ($trait['methods'] as $methodName => $method) {
$methodData = $this->newMethod($traitName, $methodName, $method, $link);
$this->traits[$traitName]['methods'][$methodName] = $methodData;
$this->traits[$traitName]['executableBranches'] += $methodData['executableBranches'];
$this->traits[$traitName]['executedBranches'] += $methodData['executedBranches'];
$this->traits[$traitName]['executablePaths'] += $methodData['executablePaths'];
$this->traits[$traitName]['executedPaths'] += $methodData['executedPaths'];
$this->numExecutableBranches += $methodData['executableBranches'];
$this->numExecutedBranches += $methodData['executedBranches'];
$this->numExecutablePaths += $methodData['executablePaths'];
$this->numExecutedPaths += $methodData['executedPaths'];
foreach (range($method['startLine'], $method['endLine']) as $lineNumber) {
$this->codeUnitsByLine[$lineNumber] = [
&$this->traits[$traitName],
&$this->traits[$traitName]['methods'][$methodName],
];
}
}
}
}
/**
* @psalm-param array<string, CodeUnitFunctionType> $functions
*/
private function processFunctions(array $functions): void
{
$link = $this->id() . '.html#';
foreach ($functions as $functionName => $function) {
$this->functions[$functionName] = [
'functionName' => $functionName,
'namespace' => $function['namespace'],
'signature' => $function['signature'],
'startLine' => $function['startLine'],
'endLine' => $function['endLine'],
'executableLines' => 0,
'executedLines' => 0,
'executableBranches' => 0,
'executedBranches' => 0,
'executablePaths' => 0,
'executedPaths' => 0,
'ccn' => $function['ccn'],
'coverage' => 0,
'crap' => 0,
'link' => $link . $function['startLine'],
];
foreach (range($function['startLine'], $function['endLine']) as $lineNumber) {
$this->codeUnitsByLine[$lineNumber] = [&$this->functions[$functionName]];
}
if (isset($this->functionCoverageData[$functionName]['branches'])) {
$this->functions[$functionName]['executableBranches'] = count(
$this->functionCoverageData[$functionName]['branches'],
);
$this->functions[$functionName]['executedBranches'] = count(
array_filter(
$this->functionCoverageData[$functionName]['branches'],
static function (array $branch)
{
return (bool) $branch['hit'];
},
),
);
}
if (isset($this->functionCoverageData[$functionName]['paths'])) {
$this->functions[$functionName]['executablePaths'] = count(
$this->functionCoverageData[$functionName]['paths'],
);
$this->functions[$functionName]['executedPaths'] = count(
array_filter(
$this->functionCoverageData[$functionName]['paths'],
static function (array $path)
{
return (bool) $path['hit'];
},
),
);
}
$this->numExecutableBranches += $this->functions[$functionName]['executableBranches'];
$this->numExecutedBranches += $this->functions[$functionName]['executedBranches'];
$this->numExecutablePaths += $this->functions[$functionName]['executablePaths'];
$this->numExecutedPaths += $this->functions[$functionName]['executedPaths'];
}
}
/**
* @psalm-param CodeUnitMethodType $method
*
* @psalm-return ProcessedMethodType
*/
private function newMethod(string $className, string $methodName, array $method, string $link): array
{
$methodData = [
'methodName' => $methodName,
'visibility' => $method['visibility'],
'signature' => $method['signature'],
'startLine' => $method['startLine'],
'endLine' => $method['endLine'],
'executableLines' => 0,
'executedLines' => 0,
'executableBranches' => 0,
'executedBranches' => 0,
'executablePaths' => 0,
'executedPaths' => 0,
'ccn' => $method['ccn'],
'coverage' => 0,
'crap' => 0,
'link' => $link . $method['startLine'],
];
$key = $className . '->' . $methodName;
if (isset($this->functionCoverageData[$key]['branches'])) {
$methodData['executableBranches'] = count(
$this->functionCoverageData[$key]['branches'],
);
$methodData['executedBranches'] = count(
array_filter(
$this->functionCoverageData[$key]['branches'],
static function (array $branch)
{
return (bool) $branch['hit'];
},
),
);
}
if (isset($this->functionCoverageData[$key]['paths'])) {
$methodData['executablePaths'] = count(
$this->functionCoverageData[$key]['paths'],
);
$methodData['executedPaths'] = count(
array_filter(
$this->functionCoverageData[$key]['paths'],
static function (array $path)
{
return (bool) $path['hit'];
},
),
);
}
return $methodData;
}
}
php-code-coverage/src/Node/Iterator.php 0000644 00000003561 15243417753 0014032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use function count;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Iterator implements RecursiveIterator
{
private int $position;
/**
* @var list<AbstractNode>
*/
private readonly array $nodes;
public function __construct(Directory $node)
{
$this->nodes = $node->children();
}
/**
* Rewinds the Iterator to the first element.
*/
public function rewind(): void
{
$this->position = 0;
}
/**
* Checks if there is a current element after calls to rewind() or next().
*/
public function valid(): bool
{
return $this->position < count($this->nodes);
}
/**
* Returns the key of the current element.
*/
public function key(): int
{
return $this->position;
}
/**
* Returns the current element.
*/
public function current(): ?AbstractNode
{
return $this->valid() ? $this->nodes[$this->position] : null;
}
/**
* Moves forward to next element.
*/
public function next(): void
{
$this->position++;
}
/**
* Returns the sub iterator for the current element.
*/
public function getChildren(): self
{
return new self($this->nodes[$this->position]);
}
/**
* Checks whether the current element has children.
*/
public function hasChildren(): bool
{
return $this->nodes[$this->position] instanceof Directory;
}
}
php-code-coverage/src/Node/CrapIndex.php 0000644 00000002355 15243417753 0014116 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Node;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class CrapIndex
{
private readonly int $cyclomaticComplexity;
private readonly float $codeCoverage;
public function __construct(int $cyclomaticComplexity, float $codeCoverage)
{
$this->cyclomaticComplexity = $cyclomaticComplexity;
$this->codeCoverage = $codeCoverage;
}
public function asString(): string
{
if ($this->codeCoverage === 0.0) {
return (string) ($this->cyclomaticComplexity ** 2 + $this->cyclomaticComplexity);
}
if ($this->codeCoverage >= 95) {
return (string) $this->cyclomaticComplexity;
}
return sprintf(
'%01.2F',
$this->cyclomaticComplexity ** 2 * (1 - $this->codeCoverage / 100) ** 3 + $this->cyclomaticComplexity,
);
}
}
php-code-coverage/src/Util/Percentage.php 0000644 00000002536 15243417753 0014347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Util;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Percentage
{
private readonly float $fraction;
private readonly float $total;
public static function fromFractionAndTotal(float $fraction, float $total): self
{
return new self($fraction, $total);
}
private function __construct(float $fraction, float $total)
{
$this->fraction = $fraction;
$this->total = $total;
}
public function asFloat(): float
{
if ($this->total > 0) {
return ($this->fraction / $this->total) * 100;
}
return 100.0;
}
public function asString(): string
{
if ($this->total > 0) {
return sprintf('%01.2F%%', $this->asFloat());
}
return '';
}
public function asFixedWidthString(): string
{
if ($this->total > 0) {
return sprintf('%6.2F%%', $this->asFloat());
}
return '';
}
}
php-code-coverage/src/Util/Filesystem.php 0000644 00000001773 15243417753 0014420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Util;
use function is_dir;
use function mkdir;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Filesystem
{
/**
* @throws DirectoryCouldNotBeCreatedException
*/
public static function createDirectory(string $directory): void
{
$success = !(!is_dir($directory) && !@mkdir($directory, 0o777, true) && !is_dir($directory));
if (!$success) {
throw new DirectoryCouldNotBeCreatedException(
sprintf(
'Directory "%s" could not be created',
$directory,
),
);
}
}
}
php-code-coverage/src/StaticAnalysis/ParsingFileAnalyser.php 0000644 00000017535 15243417753 0020217 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use function array_merge;
use function array_unique;
use function assert;
use function file_get_contents;
use function is_array;
use function max;
use function range;
use function sort;
use function sprintf;
use function substr_count;
use function token_get_all;
use function trim;
use PhpParser\Error;
use PhpParser\NodeTraverser;
use PhpParser\NodeVisitor\NameResolver;
use PhpParser\NodeVisitor\ParentConnectingVisitor;
use PhpParser\ParserFactory;
use SebastianBergmann\CodeCoverage\ParserException;
use SebastianBergmann\LinesOfCode\LineCountingVisitor;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type CodeUnitFunctionType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitMethodType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitClassType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitTraitType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
* @psalm-import-type LinesType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*/
final class ParsingFileAnalyser implements FileAnalyser
{
/**
* @psalm-var array<string, array<string, CodeUnitClassType>>
*/
private array $classes = [];
/**
* @psalm-var array<string, array<string, CodeUnitTraitType>>
*/
private array $traits = [];
/**
* @psalm-var array<string, array<string, CodeUnitFunctionType>>
*/
private array $functions = [];
/**
* @var array<string, LinesOfCodeType>
*/
private array $linesOfCode = [];
/**
* @var array<string, LinesType>
*/
private array $ignoredLines = [];
/**
* @var array<string, LinesType>
*/
private array $executableLines = [];
private readonly bool $useAnnotationsForIgnoringCode;
private readonly bool $ignoreDeprecatedCode;
public function __construct(bool $useAnnotationsForIgnoringCode, bool $ignoreDeprecatedCode)
{
$this->useAnnotationsForIgnoringCode = $useAnnotationsForIgnoringCode;
$this->ignoreDeprecatedCode = $ignoreDeprecatedCode;
}
public function classesIn(string $filename): array
{
$this->analyse($filename);
return $this->classes[$filename];
}
public function traitsIn(string $filename): array
{
$this->analyse($filename);
return $this->traits[$filename];
}
public function functionsIn(string $filename): array
{
$this->analyse($filename);
return $this->functions[$filename];
}
public function linesOfCodeFor(string $filename): array
{
$this->analyse($filename);
return $this->linesOfCode[$filename];
}
public function executableLinesIn(string $filename): array
{
$this->analyse($filename);
return $this->executableLines[$filename];
}
public function ignoredLinesFor(string $filename): array
{
$this->analyse($filename);
return $this->ignoredLines[$filename];
}
/**
* @throws ParserException
*/
private function analyse(string $filename): void
{
if (isset($this->classes[$filename])) {
return;
}
$source = file_get_contents($filename);
$linesOfCode = max(substr_count($source, "\n") + 1, substr_count($source, "\r") + 1);
if ($linesOfCode === 0 && !empty($source)) {
$linesOfCode = 1;
}
assert($linesOfCode > 0);
$parser = (new ParserFactory)->createForHostVersion();
try {
$nodes = $parser->parse($source);
assert($nodes !== null);
$traverser = new NodeTraverser;
$codeUnitFindingVisitor = new CodeUnitFindingVisitor;
$lineCountingVisitor = new LineCountingVisitor($linesOfCode);
$ignoredLinesFindingVisitor = new IgnoredLinesFindingVisitor($this->useAnnotationsForIgnoringCode, $this->ignoreDeprecatedCode);
$executableLinesFindingVisitor = new ExecutableLinesFindingVisitor($source);
$traverser->addVisitor(new NameResolver);
$traverser->addVisitor(new ParentConnectingVisitor);
$traverser->addVisitor($codeUnitFindingVisitor);
$traverser->addVisitor($lineCountingVisitor);
$traverser->addVisitor($ignoredLinesFindingVisitor);
$traverser->addVisitor($executableLinesFindingVisitor);
/* @noinspection UnusedFunctionResultInspection */
$traverser->traverse($nodes);
// @codeCoverageIgnoreStart
} catch (Error $error) {
throw new ParserException(
sprintf(
'Cannot parse %s: %s',
$filename,
$error->getMessage(),
),
$error->getCode(),
$error,
);
}
// @codeCoverageIgnoreEnd
$this->classes[$filename] = $codeUnitFindingVisitor->classes();
$this->traits[$filename] = $codeUnitFindingVisitor->traits();
$this->functions[$filename] = $codeUnitFindingVisitor->functions();
$this->executableLines[$filename] = $executableLinesFindingVisitor->executableLinesGroupedByBranch();
$this->ignoredLines[$filename] = [];
$this->findLinesIgnoredByLineBasedAnnotations($filename, $source, $this->useAnnotationsForIgnoringCode);
$this->ignoredLines[$filename] = array_unique(
array_merge(
$this->ignoredLines[$filename],
$ignoredLinesFindingVisitor->ignoredLines(),
),
);
sort($this->ignoredLines[$filename]);
$result = $lineCountingVisitor->result();
$this->linesOfCode[$filename] = [
'linesOfCode' => $result->linesOfCode(),
'commentLinesOfCode' => $result->commentLinesOfCode(),
'nonCommentLinesOfCode' => $result->nonCommentLinesOfCode(),
];
}
private function findLinesIgnoredByLineBasedAnnotations(string $filename, string $source, bool $useAnnotationsForIgnoringCode): void
{
if (!$useAnnotationsForIgnoringCode) {
return;
}
$start = false;
foreach (token_get_all($source) as $token) {
if (!is_array($token) ||
!(T_COMMENT === $token[0] || T_DOC_COMMENT === $token[0])) {
continue;
}
$comment = trim($token[1]);
if ($comment === '// @codeCoverageIgnore' ||
$comment === '//@codeCoverageIgnore') {
$this->ignoredLines[$filename][] = $token[2];
continue;
}
if ($comment === '// @codeCoverageIgnoreStart' ||
$comment === '//@codeCoverageIgnoreStart') {
$start = $token[2];
continue;
}
if ($comment === '// @codeCoverageIgnoreEnd' ||
$comment === '//@codeCoverageIgnoreEnd') {
if (false === $start) {
$start = $token[2];
}
$this->ignoredLines[$filename] = array_merge(
$this->ignoredLines[$filename],
range($start, $token[2]),
);
}
}
}
}
php-code-coverage/src/StaticAnalysis/ExecutableLinesFindingVisitor.php 0000644 00000030305 15243417753 0022236 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use function array_diff_key;
use function assert;
use function count;
use function current;
use function end;
use function explode;
use function max;
use function preg_match;
use function preg_quote;
use function range;
use function reset;
use function sprintf;
use PhpParser\Node;
use PhpParser\NodeVisitorAbstract;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type LinesType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*/
final class ExecutableLinesFindingVisitor extends NodeVisitorAbstract
{
private int $nextBranch = 0;
private readonly string $source;
/**
* @psalm-var LinesType
*/
private array $executableLinesGroupedByBranch = [];
/**
* @psalm-var array<int, bool>
*/
private array $unsets = [];
/**
* @psalm-var array<int, string>
*/
private array $commentsToCheckForUnset = [];
public function __construct(string $source)
{
$this->source = $source;
}
public function enterNode(Node $node): void
{
foreach ($node->getComments() as $comment) {
$commentLine = $comment->getStartLine();
if (!isset($this->executableLinesGroupedByBranch[$commentLine])) {
continue;
}
foreach (explode("\n", $comment->getText()) as $text) {
$this->commentsToCheckForUnset[$commentLine] = $text;
$commentLine++;
}
}
if ($node instanceof Node\Scalar\String_ ||
$node instanceof Node\Scalar\EncapsedStringPart) {
$startLine = $node->getStartLine() + 1;
$endLine = $node->getEndLine() - 1;
if ($startLine <= $endLine) {
foreach (range($startLine, $endLine) as $line) {
unset($this->executableLinesGroupedByBranch[$line]);
}
}
return;
}
if ($node instanceof Node\Stmt\Interface_) {
foreach (range($node->getStartLine(), $node->getEndLine()) as $line) {
$this->unsets[$line] = true;
}
return;
}
if ($node instanceof Node\Stmt\Declare_ ||
$node instanceof Node\Stmt\DeclareDeclare ||
$node instanceof Node\Stmt\Else_ ||
$node instanceof Node\Stmt\EnumCase ||
$node instanceof Node\Stmt\Finally_ ||
$node instanceof Node\Stmt\GroupUse ||
$node instanceof Node\Stmt\Label ||
$node instanceof Node\Stmt\Namespace_ ||
$node instanceof Node\Stmt\Nop ||
$node instanceof Node\Stmt\Switch_ ||
$node instanceof Node\Stmt\TryCatch ||
$node instanceof Node\Stmt\Use_ ||
$node instanceof Node\Stmt\UseUse ||
$node instanceof Node\Expr\ConstFetch ||
$node instanceof Node\Expr\Match_ ||
$node instanceof Node\Expr\Variable ||
$node instanceof Node\Expr\Throw_ ||
$node instanceof Node\ComplexType ||
$node instanceof Node\Const_ ||
$node instanceof Node\Identifier ||
$node instanceof Node\Name ||
$node instanceof Node\Param ||
$node instanceof Node\Scalar) {
return;
}
/*
* nikic/php-parser ^4.18 represents <code>throw</code> statements
* as <code>Stmt\Throw_</code> objects
*/
if ($node instanceof Node\Stmt\Throw_) {
$this->setLineBranch($node->expr->getEndLine(), $node->expr->getEndLine(), ++$this->nextBranch);
return;
}
/*
* nikic/php-parser ^5 represents <code>throw</code> statements
* as <code>Stmt\Expression</code> objects that contain an
* <code>Expr\Throw_</code> object
*/
if ($node instanceof Node\Stmt\Expression && $node->expr instanceof Node\Expr\Throw_) {
$this->setLineBranch($node->expr->expr->getEndLine(), $node->expr->expr->getEndLine(), ++$this->nextBranch);
return;
}
if ($node instanceof Node\Stmt\Enum_ ||
$node instanceof Node\Stmt\Function_ ||
$node instanceof Node\Stmt\Class_ ||
$node instanceof Node\Stmt\ClassMethod ||
$node instanceof Node\Expr\Closure ||
$node instanceof Node\Stmt\Trait_) {
if ($node instanceof Node\Stmt\Function_ || $node instanceof Node\Stmt\ClassMethod) {
$unsets = [];
foreach ($node->getParams() as $param) {
foreach (range($param->getStartLine(), $param->getEndLine()) as $line) {
$unsets[$line] = true;
}
}
unset($unsets[$node->getEndLine()]);
$this->unsets += $unsets;
}
$isConcreteClassLike = $node instanceof Node\Stmt\Enum_ || $node instanceof Node\Stmt\Class_ || $node instanceof Node\Stmt\Trait_;
if (null !== $node->stmts) {
foreach ($node->stmts as $stmt) {
if ($stmt instanceof Node\Stmt\Nop) {
continue;
}
foreach (range($stmt->getStartLine(), $stmt->getEndLine()) as $line) {
unset($this->executableLinesGroupedByBranch[$line]);
if (
$isConcreteClassLike &&
!$stmt instanceof Node\Stmt\ClassMethod
) {
$this->unsets[$line] = true;
}
}
}
}
if ($isConcreteClassLike) {
return;
}
$hasEmptyBody = [] === $node->stmts ||
null === $node->stmts ||
(
1 === count($node->stmts) &&
$node->stmts[0] instanceof Node\Stmt\Nop
);
if ($hasEmptyBody) {
if ($node->getEndLine() === $node->getStartLine() && isset($this->executableLinesGroupedByBranch[$node->getStartLine()])) {
return;
}
$this->setLineBranch($node->getEndLine(), $node->getEndLine(), ++$this->nextBranch);
return;
}
return;
}
if ($node instanceof Node\Expr\ArrowFunction) {
$startLine = max(
$node->getStartLine() + 1,
$node->expr->getStartLine(),
);
$endLine = $node->expr->getEndLine();
if ($endLine < $startLine) {
return;
}
$this->setLineBranch($startLine, $endLine, ++$this->nextBranch);
return;
}
if ($node instanceof Node\Expr\Ternary) {
if (null !== $node->if &&
$node->getStartLine() !== $node->if->getEndLine()) {
$this->setLineBranch($node->if->getStartLine(), $node->if->getEndLine(), ++$this->nextBranch);
}
if ($node->getStartLine() !== $node->else->getEndLine()) {
$this->setLineBranch($node->else->getStartLine(), $node->else->getEndLine(), ++$this->nextBranch);
}
return;
}
if ($node instanceof Node\Expr\BinaryOp\Coalesce) {
if ($node->getStartLine() !== $node->getEndLine()) {
$this->setLineBranch($node->getEndLine(), $node->getEndLine(), ++$this->nextBranch);
}
return;
}
if ($node instanceof Node\Stmt\If_ ||
$node instanceof Node\Stmt\ElseIf_ ||
$node instanceof Node\Stmt\Case_) {
if (null === $node->cond) {
return;
}
$this->setLineBranch(
$node->cond->getStartLine(),
$node->cond->getStartLine(),
++$this->nextBranch,
);
return;
}
if ($node instanceof Node\Stmt\For_) {
$startLine = null;
$endLine = null;
if ([] !== $node->init) {
$startLine = $node->init[0]->getStartLine();
end($node->init);
$endLine = current($node->init)->getEndLine();
reset($node->init);
}
if ([] !== $node->cond) {
if (null === $startLine) {
$startLine = $node->cond[0]->getStartLine();
}
end($node->cond);
$endLine = current($node->cond)->getEndLine();
reset($node->cond);
}
if ([] !== $node->loop) {
if (null === $startLine) {
$startLine = $node->loop[0]->getStartLine();
}
end($node->loop);
$endLine = current($node->loop)->getEndLine();
reset($node->loop);
}
if (null === $startLine || null === $endLine) {
return;
}
$this->setLineBranch(
$startLine,
$endLine,
++$this->nextBranch,
);
return;
}
if ($node instanceof Node\Stmt\Foreach_) {
$this->setLineBranch(
$node->expr->getStartLine(),
$node->valueVar->getEndLine(),
++$this->nextBranch,
);
return;
}
if ($node instanceof Node\Stmt\While_ ||
$node instanceof Node\Stmt\Do_) {
$this->setLineBranch(
$node->cond->getStartLine(),
$node->cond->getEndLine(),
++$this->nextBranch,
);
return;
}
if ($node instanceof Node\Stmt\Catch_) {
assert([] !== $node->types);
$startLine = $node->types[0]->getStartLine();
end($node->types);
$endLine = current($node->types)->getEndLine();
$this->setLineBranch(
$startLine,
$endLine,
++$this->nextBranch,
);
return;
}
if ($node instanceof Node\Expr\CallLike) {
if (isset($this->executableLinesGroupedByBranch[$node->getStartLine()])) {
$branch = $this->executableLinesGroupedByBranch[$node->getStartLine()];
} else {
$branch = ++$this->nextBranch;
}
$this->setLineBranch($node->getStartLine(), $node->getEndLine(), $branch);
return;
}
if (isset($this->executableLinesGroupedByBranch[$node->getStartLine()])) {
return;
}
$this->setLineBranch($node->getStartLine(), $node->getEndLine(), ++$this->nextBranch);
}
public function afterTraverse(array $nodes): void
{
$lines = explode("\n", $this->source);
foreach ($lines as $lineNumber => $line) {
$lineNumber++;
if (1 === preg_match('/^\s*$/', $line) ||
(
isset($this->commentsToCheckForUnset[$lineNumber]) &&
1 === preg_match(sprintf('/^\s*%s\s*$/', preg_quote($this->commentsToCheckForUnset[$lineNumber], '/')), $line)
)) {
unset($this->executableLinesGroupedByBranch[$lineNumber]);
}
}
$this->executableLinesGroupedByBranch = array_diff_key(
$this->executableLinesGroupedByBranch,
$this->unsets,
);
}
/**
* @psalm-return LinesType
*/
public function executableLinesGroupedByBranch(): array
{
return $this->executableLinesGroupedByBranch;
}
private function setLineBranch(int $start, int $end, int $branch): void
{
foreach (range($start, $end) as $line) {
$this->executableLinesGroupedByBranch[$line] = $branch;
}
}
}
php-code-coverage/src/StaticAnalysis/IgnoredLinesFindingVisitor.php 0000644 00000007126 15243417753 0021551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use function assert;
use function str_contains;
use PhpParser\Node;
use PhpParser\Node\Attribute;
use PhpParser\Node\Stmt\Class_;
use PhpParser\Node\Stmt\ClassMethod;
use PhpParser\Node\Stmt\Enum_;
use PhpParser\Node\Stmt\Function_;
use PhpParser\Node\Stmt\Interface_;
use PhpParser\Node\Stmt\Trait_;
use PhpParser\NodeVisitorAbstract;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class IgnoredLinesFindingVisitor extends NodeVisitorAbstract
{
/**
* @psalm-var array<int>
*/
private array $ignoredLines = [];
private readonly bool $useAnnotationsForIgnoringCode;
private readonly bool $ignoreDeprecated;
public function __construct(bool $useAnnotationsForIgnoringCode, bool $ignoreDeprecated)
{
$this->useAnnotationsForIgnoringCode = $useAnnotationsForIgnoringCode;
$this->ignoreDeprecated = $ignoreDeprecated;
}
public function enterNode(Node $node): void
{
if (!$node instanceof Class_ &&
!$node instanceof Trait_ &&
!$node instanceof Interface_ &&
!$node instanceof Enum_ &&
!$node instanceof ClassMethod &&
!$node instanceof Function_ &&
!$node instanceof Attribute) {
return;
}
if ($node instanceof Class_ && $node->isAnonymous()) {
return;
}
if ($node instanceof Class_ ||
$node instanceof Trait_ ||
$node instanceof Interface_ ||
$node instanceof Attribute) {
$this->ignoredLines[] = $node->getStartLine();
assert($node->name !== null);
// Workaround for https://github.com/nikic/PHP-Parser/issues/886
$this->ignoredLines[] = $node->name->getStartLine();
}
if (!$this->useAnnotationsForIgnoringCode) {
return;
}
if ($node instanceof Interface_) {
return;
}
if ($node instanceof Attribute &&
$node->name->toString() === 'PHPUnit\Framework\Attributes\CodeCoverageIgnore') {
$attributeGroup = $node->getAttribute('parent');
$attributedNode = $attributeGroup->getAttribute('parent');
for ($line = $attributedNode->getStartLine(); $line <= $attributedNode->getEndLine(); $line++) {
$this->ignoredLines[] = $line;
}
return;
}
$this->processDocComment($node);
}
/**
* @psalm-return array<int>
*/
public function ignoredLines(): array
{
return $this->ignoredLines;
}
private function processDocComment(Node $node): void
{
$docComment = $node->getDocComment();
if ($docComment === null) {
return;
}
if (str_contains($docComment->getText(), '@codeCoverageIgnore')) {
for ($line = $node->getStartLine(); $line <= $node->getEndLine(); $line++) {
$this->ignoredLines[] = $line;
}
}
if ($this->ignoreDeprecated && str_contains($docComment->getText(), '@deprecated')) {
for ($line = $node->getStartLine(); $line <= $node->getEndLine(); $line++) {
$this->ignoredLines[] = $line;
}
}
}
}
php-code-coverage/src/StaticAnalysis/FileAnalyser.php 0000644 00000003771 15243417753 0016670 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type CodeUnitFunctionType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitMethodType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitClassType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type CodeUnitTraitType from \SebastianBergmann\CodeCoverage\StaticAnalysis\CodeUnitFindingVisitor
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
* @psalm-import-type LinesType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*
* @psalm-type LinesOfCodeType = array{
* linesOfCode: int,
* commentLinesOfCode: int,
* nonCommentLinesOfCode: int
* }
* @psalm-type LinesType = array<int, int>
*/
interface FileAnalyser
{
/**
* @psalm-return array<string, CodeUnitClassType>
*/
public function classesIn(string $filename): array;
/**
* @psalm-return array<string, CodeUnitTraitType>
*/
public function traitsIn(string $filename): array;
/**
* @psalm-return array<string, CodeUnitFunctionType>
*/
public function functionsIn(string $filename): array;
/**
* @psalm-return LinesOfCodeType
*/
public function linesOfCodeFor(string $filename): array;
/**
* @psalm-return LinesType
*/
public function executableLinesIn(string $filename): array;
/**
* @psalm-return LinesType
*/
public function ignoredLinesFor(string $filename): array;
}
php-code-coverage/src/StaticAnalysis/CodeUnitFindingVisitor.php 0000644 00000023731 15243417753 0020701 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use function assert;
use function implode;
use function rtrim;
use function trim;
use PhpParser\Node;
use PhpParser\Node\ComplexType;
use PhpParser\Node\Identifier;
use PhpParser\Node\IntersectionType;
use PhpParser\Node\Name;
use PhpParser\Node\NullableType;
use PhpParser\Node\Stmt\Class_;
use PhpParser\Node\Stmt\ClassMethod;
use PhpParser\Node\Stmt\Enum_;
use PhpParser\Node\Stmt\Function_;
use PhpParser\Node\Stmt\Interface_;
use PhpParser\Node\Stmt\Trait_;
use PhpParser\Node\UnionType;
use PhpParser\NodeTraverser;
use PhpParser\NodeVisitorAbstract;
use SebastianBergmann\Complexity\CyclomaticComplexityCalculatingVisitor;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-type CodeUnitFunctionType = array{
* name: string,
* namespacedName: string,
* namespace: string,
* signature: string,
* startLine: int,
* endLine: int,
* ccn: int
* }
* @psalm-type CodeUnitMethodType = array{
* methodName: string,
* signature: string,
* visibility: string,
* startLine: int,
* endLine: int,
* ccn: int
* }
* @psalm-type CodeUnitClassType = array{
* name: string,
* namespacedName: string,
* namespace: string,
* startLine: int,
* endLine: int,
* methods: array<string, CodeUnitMethodType>
* }
* @psalm-type CodeUnitTraitType = array{
* name: string,
* namespacedName: string,
* namespace: string,
* startLine: int,
* endLine: int,
* methods: array<string, CodeUnitMethodType>
* }
*/
final class CodeUnitFindingVisitor extends NodeVisitorAbstract
{
/**
* @psalm-var array<string, CodeUnitClassType>
*/
private array $classes = [];
/**
* @psalm-var array<string, CodeUnitTraitType>
*/
private array $traits = [];
/**
* @psalm-var array<string, CodeUnitFunctionType>
*/
private array $functions = [];
public function enterNode(Node $node): void
{
if ($node instanceof Class_) {
if ($node->isAnonymous()) {
return;
}
$this->processClass($node);
}
if ($node instanceof Trait_) {
$this->processTrait($node);
}
if (!$node instanceof ClassMethod && !$node instanceof Function_) {
return;
}
if ($node instanceof ClassMethod) {
$parentNode = $node->getAttribute('parent');
if ($parentNode instanceof Class_ && $parentNode->isAnonymous()) {
return;
}
$this->processMethod($node);
return;
}
$this->processFunction($node);
}
/**
* @psalm-return array<string, CodeUnitClassType>
*/
public function classes(): array
{
return $this->classes;
}
/**
* @psalm-return array<string, CodeUnitTraitType>
*/
public function traits(): array
{
return $this->traits;
}
/**
* @psalm-return array<string, CodeUnitFunctionType>
*/
public function functions(): array
{
return $this->functions;
}
private function cyclomaticComplexity(ClassMethod|Function_ $node): int
{
$nodes = $node->getStmts();
if ($nodes === null) {
return 0;
}
$traverser = new NodeTraverser;
$cyclomaticComplexityCalculatingVisitor = new CyclomaticComplexityCalculatingVisitor;
$traverser->addVisitor($cyclomaticComplexityCalculatingVisitor);
/* @noinspection UnusedFunctionResultInspection */
$traverser->traverse($nodes);
return $cyclomaticComplexityCalculatingVisitor->cyclomaticComplexity();
}
private function signature(ClassMethod|Function_ $node): string
{
$signature = ($node->returnsByRef() ? '&' : '') . $node->name->toString() . '(';
$parameters = [];
foreach ($node->getParams() as $parameter) {
assert(isset($parameter->var->name));
$parameterAsString = '';
if ($parameter->type !== null) {
$parameterAsString = $this->type($parameter->type) . ' ';
}
$parameterAsString .= '$' . $parameter->var->name;
/* @todo Handle default values */
$parameters[] = $parameterAsString;
}
$signature .= implode(', ', $parameters) . ')';
$returnType = $node->getReturnType();
if ($returnType !== null) {
$signature .= ': ' . $this->type($returnType);
}
return $signature;
}
private function type(ComplexType|Identifier|Name $type): string
{
if ($type instanceof NullableType) {
return '?' . $type->type;
}
if ($type instanceof UnionType) {
return $this->unionTypeAsString($type);
}
if ($type instanceof IntersectionType) {
return $this->intersectionTypeAsString($type);
}
return $type->toString();
}
private function visibility(ClassMethod $node): string
{
if ($node->isPrivate()) {
return 'private';
}
if ($node->isProtected()) {
return 'protected';
}
return 'public';
}
private function processClass(Class_ $node): void
{
$name = $node->name->toString();
$namespacedName = $node->namespacedName->toString();
$this->classes[$namespacedName] = [
'name' => $name,
'namespacedName' => $namespacedName,
'namespace' => $this->namespace($namespacedName, $name),
'startLine' => $node->getStartLine(),
'endLine' => $node->getEndLine(),
'methods' => [],
];
}
private function processTrait(Trait_ $node): void
{
$name = $node->name->toString();
$namespacedName = $node->namespacedName->toString();
$this->traits[$namespacedName] = [
'name' => $name,
'namespacedName' => $namespacedName,
'namespace' => $this->namespace($namespacedName, $name),
'startLine' => $node->getStartLine(),
'endLine' => $node->getEndLine(),
'methods' => [],
];
}
private function processMethod(ClassMethod $node): void
{
$parentNode = $node->getAttribute('parent');
if ($parentNode instanceof Interface_) {
return;
}
assert($parentNode instanceof Class_ || $parentNode instanceof Trait_ || $parentNode instanceof Enum_);
assert(isset($parentNode->name));
assert(isset($parentNode->namespacedName));
assert($parentNode->namespacedName instanceof Name);
$parentName = $parentNode->name->toString();
$parentNamespacedName = $parentNode->namespacedName->toString();
if ($parentNode instanceof Class_) {
$storage = &$this->classes;
} else {
$storage = &$this->traits;
}
if (!isset($storage[$parentNamespacedName])) {
$storage[$parentNamespacedName] = [
'name' => $parentName,
'namespacedName' => $parentNamespacedName,
'namespace' => $this->namespace($parentNamespacedName, $parentName),
'startLine' => $parentNode->getStartLine(),
'endLine' => $parentNode->getEndLine(),
'methods' => [],
];
}
$storage[$parentNamespacedName]['methods'][$node->name->toString()] = [
'methodName' => $node->name->toString(),
'signature' => $this->signature($node),
'visibility' => $this->visibility($node),
'startLine' => $node->getStartLine(),
'endLine' => $node->getEndLine(),
'ccn' => $this->cyclomaticComplexity($node),
];
}
private function processFunction(Function_ $node): void
{
assert(isset($node->name));
assert(isset($node->namespacedName));
assert($node->namespacedName instanceof Name);
$name = $node->name->toString();
$namespacedName = $node->namespacedName->toString();
$this->functions[$namespacedName] = [
'name' => $name,
'namespacedName' => $namespacedName,
'namespace' => $this->namespace($namespacedName, $name),
'signature' => $this->signature($node),
'startLine' => $node->getStartLine(),
'endLine' => $node->getEndLine(),
'ccn' => $this->cyclomaticComplexity($node),
];
}
private function namespace(string $namespacedName, string $name): string
{
return trim(rtrim($namespacedName, $name), '\\');
}
private function unionTypeAsString(UnionType $node): string
{
$types = [];
foreach ($node->types as $type) {
if ($type instanceof IntersectionType) {
$types[] = '(' . $this->intersectionTypeAsString($type) . ')';
continue;
}
$types[] = $this->typeAsString($type);
}
return implode('|', $types);
}
private function intersectionTypeAsString(IntersectionType $node): string
{
$types = [];
foreach ($node->types as $type) {
$types[] = $this->typeAsString($type);
}
return implode('&', $types);
}
private function typeAsString(Identifier|Name $node): string
{
if ($node instanceof Name) {
return $node->toCodeString();
}
return $node->toString();
}
}
php-code-coverage/src/StaticAnalysis/CacheWarmer.php 0000644 00000001671 15243417753 0016470 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use SebastianBergmann\CodeCoverage\Filter;
final class CacheWarmer
{
public function warmCache(string $cacheDirectory, bool $useAnnotationsForIgnoringCode, bool $ignoreDeprecatedCode, Filter $filter): void
{
$analyser = new CachingFileAnalyser(
$cacheDirectory,
new ParsingFileAnalyser(
$useAnnotationsForIgnoringCode,
$ignoreDeprecatedCode,
),
$useAnnotationsForIgnoringCode,
$ignoreDeprecatedCode,
);
foreach ($filter->files() as $file) {
$analyser->process($file);
}
}
}
php-code-coverage/src/StaticAnalysis/CachingFileAnalyser.php 0000644 00000012256 15243417753 0020143 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\StaticAnalysis;
use function file_get_contents;
use function file_put_contents;
use function implode;
use function is_file;
use function md5;
use function serialize;
use function unserialize;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type LinesOfCodeType from \SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser
*/
final class CachingFileAnalyser implements FileAnalyser
{
private static ?string $cacheVersion = null;
private readonly string $directory;
private readonly FileAnalyser $analyser;
private readonly bool $useAnnotationsForIgnoringCode;
private readonly bool $ignoreDeprecatedCode;
private array $cache = [];
public function __construct(string $directory, FileAnalyser $analyser, bool $useAnnotationsForIgnoringCode, bool $ignoreDeprecatedCode)
{
Filesystem::createDirectory($directory);
$this->analyser = $analyser;
$this->directory = $directory;
$this->useAnnotationsForIgnoringCode = $useAnnotationsForIgnoringCode;
$this->ignoreDeprecatedCode = $ignoreDeprecatedCode;
}
public function classesIn(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['classesIn'];
}
public function traitsIn(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['traitsIn'];
}
public function functionsIn(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['functionsIn'];
}
/**
* @psalm-return LinesOfCodeType
*/
public function linesOfCodeFor(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['linesOfCodeFor'];
}
public function executableLinesIn(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['executableLinesIn'];
}
public function ignoredLinesFor(string $filename): array
{
if (!isset($this->cache[$filename])) {
$this->process($filename);
}
return $this->cache[$filename]['ignoredLinesFor'];
}
public function process(string $filename): void
{
$cache = $this->read($filename);
if ($cache !== false) {
$this->cache[$filename] = $cache;
return;
}
$this->cache[$filename] = [
'classesIn' => $this->analyser->classesIn($filename),
'traitsIn' => $this->analyser->traitsIn($filename),
'functionsIn' => $this->analyser->functionsIn($filename),
'linesOfCodeFor' => $this->analyser->linesOfCodeFor($filename),
'ignoredLinesFor' => $this->analyser->ignoredLinesFor($filename),
'executableLinesIn' => $this->analyser->executableLinesIn($filename),
];
$this->write($filename, $this->cache[$filename]);
}
private function read(string $filename): array|false
{
$cacheFile = $this->cacheFile($filename);
if (!is_file($cacheFile)) {
return false;
}
return unserialize(
file_get_contents($cacheFile),
['allowed_classes' => false],
);
}
private function write(string $filename, array $data): void
{
file_put_contents(
$this->cacheFile($filename),
serialize($data),
);
}
private function cacheFile(string $filename): string
{
$cacheKey = md5(
implode(
"\0",
[
$filename,
file_get_contents($filename),
self::cacheVersion(),
$this->useAnnotationsForIgnoringCode,
$this->ignoreDeprecatedCode,
],
),
);
return $this->directory . DIRECTORY_SEPARATOR . $cacheKey;
}
private static function cacheVersion(): string
{
if (self::$cacheVersion !== null) {
return self::$cacheVersion;
}
$buffer = [];
foreach ((new FileIteratorFacade)->getFilesAsArray(__DIR__, '.php') as $file) {
$buffer[] = $file;
$buffer[] = file_get_contents($file);
}
self::$cacheVersion = md5(implode("\0", $buffer));
return self::$cacheVersion;
}
}
php-code-coverage/src/Exception/FileCouldNotBeWrittenException.php 0000644 00000000656 15243417753 0021346 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class FileCouldNotBeWrittenException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/PcovNotAvailableException.php 0000644 00000001120 15243417753 0020347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class PcovNotAvailableException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('The PCOV extension is not available');
}
}
php-code-coverage/src/Exception/UnintentionallyCoveredCodeException.php 0000644 00000002260 15243417753 0022463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class UnintentionallyCoveredCodeException extends RuntimeException implements Exception
{
/**
* @var list<string>
*/
private readonly array $unintentionallyCoveredUnits;
/**
* @param list<string> $unintentionallyCoveredUnits
*/
public function __construct(array $unintentionallyCoveredUnits)
{
$this->unintentionallyCoveredUnits = $unintentionallyCoveredUnits;
parent::__construct($this->toString());
}
/**
* @return list<string>
*/
public function getUnintentionallyCoveredUnits(): array
{
return $this->unintentionallyCoveredUnits;
}
private function toString(): string
{
$message = '';
foreach ($this->unintentionallyCoveredUnits as $unit) {
$message .= '- ' . $unit . "\n";
}
return $message;
}
}
php-code-coverage/src/Exception/ReportAlreadyFinalizedException.php 0000644 00000001061 15243417753 0021565 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class ReportAlreadyFinalizedException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('The code coverage report has already been finalized');
}
}
php-code-coverage/src/Exception/DirectoryCouldNotBeCreatedException.php 0000644 00000000746 15243417753 0022346 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Util;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class DirectoryCouldNotBeCreatedException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/ParserException.php 0000644 00000000637 15243417753 0016426 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class ParserException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/InvalidArgumentException.php 0000644 00000000632 15243417753 0020256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
final class InvalidArgumentException extends \InvalidArgumentException implements Exception
{
}
php-code-coverage/src/Exception/XdebugNotAvailableException.php 0000644 00000001124 15243417753 0020662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class XdebugNotAvailableException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('The Xdebug extension is not available');
}
}
php-code-coverage/src/Exception/XmlException.php 0000644 00000000634 15243417753 0015727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class XmlException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/WriteOperationFailedException.php 0000644 00000001167 15243417753 0021251 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use function sprintf;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class WriteOperationFailedException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(sprintf('Cannot write to "%s"', $path));
}
}
php-code-coverage/src/Exception/XdebugNotEnabledException.php 0000644 00000001147 15243417753 0020341 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class XdebugNotEnabledException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('XDEBUG_MODE=coverage or xdebug.mode=coverage has to be set');
}
}
php-code-coverage/src/Exception/StaticAnalysisCacheNotConfiguredException.php 0000644 00000000671 15243417753 0023536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class StaticAnalysisCacheNotConfiguredException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/PathExistsButIsNotDirectoryException.php 0000644 00000001214 15243417753 0022573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use function sprintf;
use RuntimeException;
use SebastianBergmann\CodeCoverage\Exception;
final class PathExistsButIsNotDirectoryException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(sprintf('"%s" exists but is not a directory', $path));
}
}
php-code-coverage/src/Exception/TestIdMissingException.php 0000644 00000001007 15243417753 0017710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class TestIdMissingException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('Test ID is missing');
}
}
php-code-coverage/src/Exception/Exception.php 0000644 00000000564 15243417753 0015250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use Throwable;
interface Exception extends Throwable
{
}
php-code-coverage/src/Exception/ReflectionException.php 0000644 00000000643 15243417753 0017261 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class ReflectionException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/NoCodeCoverageDriverAvailableException.php 0000644 00000001046 15243417753 0022765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class NoCodeCoverageDriverAvailableException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('No code coverage driver available');
}
}
php-code-coverage/src/Exception/BranchAndPathCoverageNotSupportedException.php 0000644 00000000672 15243417753 0023671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class BranchAndPathCoverageNotSupportedException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Exception/NoCodeCoverageDriverWithPathCoverageSupportAvailableException.php 0000644 00000001130 15243417753 0027501 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class NoCodeCoverageDriverWithPathCoverageSupportAvailableException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('No code coverage driver with path coverage support available');
}
}
php-code-coverage/src/Exception/DeadCodeDetectionNotSupportedException.php 0000644 00000000666 15243417753 0023052 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use RuntimeException;
final class DeadCodeDetectionNotSupportedException extends RuntimeException implements Exception
{
}
php-code-coverage/src/Report/Thresholds.php 0000644 00000002544 15243417753 0014746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
/**
* @psalm-immutable
*/
final class Thresholds
{
private readonly int $lowUpperBound;
private readonly int $highLowerBound;
public static function default(): self
{
return new self(50, 90);
}
/**
* @throws InvalidArgumentException
*/
public static function from(int $lowUpperBound, int $highLowerBound): self
{
if ($lowUpperBound > $highLowerBound) {
throw new InvalidArgumentException(
'$lowUpperBound must not be larger than $highLowerBound',
);
}
return new self($lowUpperBound, $highLowerBound);
}
private function __construct(int $lowUpperBound, int $highLowerBound)
{
$this->lowUpperBound = $lowUpperBound;
$this->highLowerBound = $highLowerBound;
}
public function lowUpperBound(): int
{
return $this->lowUpperBound;
}
public function highLowerBound(): int
{
return $this->highLowerBound;
}
}
php-code-coverage/src/Report/PHP.php 0000644 00000002364 15243417753 0013256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use function dirname;
use function file_put_contents;
use function serialize;
use function str_contains;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\WriteOperationFailedException;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
final class PHP
{
public function process(CodeCoverage $coverage, ?string $target = null): string
{
$coverage->clearCache();
$buffer = "<?php
return \unserialize(<<<'END_OF_COVERAGE_SERIALIZATION'" . PHP_EOL . serialize($coverage) . PHP_EOL . 'END_OF_COVERAGE_SERIALIZATION' . PHP_EOL . ');';
if ($target !== null) {
if (!str_contains($target, '://')) {
Filesystem::createDirectory(dirname($target));
}
if (@file_put_contents($target, $buffer) === false) {
throw new WriteOperationFailedException($target);
}
}
return $buffer;
}
}
php-code-coverage/src/Report/Crap4j.php 0000644 00000013113 15243417753 0013744 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use function date;
use function dirname;
use function file_put_contents;
use function htmlspecialchars;
use function is_string;
use function round;
use function str_contains;
use DOMDocument;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\WriteOperationFailedException;
use SebastianBergmann\CodeCoverage\Node\File;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
final class Crap4j
{
private readonly int $threshold;
public function __construct(int $threshold = 30)
{
$this->threshold = $threshold;
}
/**
* @throws WriteOperationFailedException
*/
public function process(CodeCoverage $coverage, ?string $target = null, ?string $name = null): string
{
$document = new DOMDocument('1.0', 'UTF-8');
$document->formatOutput = true;
$root = $document->createElement('crap_result');
$document->appendChild($root);
$project = $document->createElement('project', is_string($name) ? $name : '');
$root->appendChild($project);
$root->appendChild($document->createElement('timestamp', date('Y-m-d H:i:s')));
$stats = $document->createElement('stats');
$methodsNode = $document->createElement('methods');
$report = $coverage->getReport();
unset($coverage);
$fullMethodCount = 0;
$fullCrapMethodCount = 0;
$fullCrapLoad = 0;
$fullCrap = 0;
foreach ($report as $item) {
$namespace = 'global';
if (!$item instanceof File) {
continue;
}
$file = $document->createElement('file');
$file->setAttribute('name', $item->pathAsString());
$classes = $item->classesAndTraits();
foreach ($classes as $className => $class) {
foreach ($class['methods'] as $methodName => $method) {
$crapLoad = $this->crapLoad((float) $method['crap'], $method['ccn'], $method['coverage']);
$fullCrap += $method['crap'];
$fullCrapLoad += $crapLoad;
$fullMethodCount++;
if ($method['crap'] >= $this->threshold) {
$fullCrapMethodCount++;
}
$methodNode = $document->createElement('method');
if (!empty($class['namespace'])) {
$namespace = $class['namespace'];
}
$methodNode->appendChild($document->createElement('package', $namespace));
$methodNode->appendChild($document->createElement('className', $className));
$methodNode->appendChild($document->createElement('methodName', $methodName));
$methodNode->appendChild($document->createElement('methodSignature', htmlspecialchars($method['signature'])));
$methodNode->appendChild($document->createElement('fullMethod', htmlspecialchars($method['signature'])));
$methodNode->appendChild($document->createElement('crap', (string) $this->roundValue((float) $method['crap'])));
$methodNode->appendChild($document->createElement('complexity', (string) $method['ccn']));
$methodNode->appendChild($document->createElement('coverage', (string) $this->roundValue($method['coverage'])));
$methodNode->appendChild($document->createElement('crapLoad', (string) round($crapLoad)));
$methodsNode->appendChild($methodNode);
}
}
}
$stats->appendChild($document->createElement('name', 'Method Crap Stats'));
$stats->appendChild($document->createElement('methodCount', (string) $fullMethodCount));
$stats->appendChild($document->createElement('crapMethodCount', (string) $fullCrapMethodCount));
$stats->appendChild($document->createElement('crapLoad', (string) round($fullCrapLoad)));
$stats->appendChild($document->createElement('totalCrap', (string) $fullCrap));
$crapMethodPercent = 0;
if ($fullMethodCount > 0) {
$crapMethodPercent = $this->roundValue((100 * $fullCrapMethodCount) / $fullMethodCount);
}
$stats->appendChild($document->createElement('crapMethodPercent', (string) $crapMethodPercent));
$root->appendChild($stats);
$root->appendChild($methodsNode);
$buffer = $document->saveXML();
if ($target !== null) {
if (!str_contains($target, '://')) {
Filesystem::createDirectory(dirname($target));
}
if (@file_put_contents($target, $buffer) === false) {
throw new WriteOperationFailedException($target);
}
}
return $buffer;
}
private function crapLoad(float $crapValue, int $cyclomaticComplexity, float $coveragePercent): float
{
$crapLoad = 0;
if ($crapValue >= $this->threshold) {
$crapLoad += $cyclomaticComplexity * (1.0 - $coveragePercent / 100);
$crapLoad += $cyclomaticComplexity / $this->threshold;
}
return $crapLoad;
}
private function roundValue(float $value): float
{
return round($value, 2);
}
}
php-code-coverage/src/Report/Text.php 0000644 00000026133 15243417753 0013553 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use const PHP_EOL;
use function array_map;
use function date;
use function ksort;
use function max;
use function sprintf;
use function str_pad;
use function strlen;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Node\File;
use SebastianBergmann\CodeCoverage\Util\Percentage;
final class Text
{
/**
* @var string
*/
private const COLOR_GREEN = "\x1b[30;42m";
/**
* @var string
*/
private const COLOR_YELLOW = "\x1b[30;43m";
/**
* @var string
*/
private const COLOR_RED = "\x1b[37;41m";
/**
* @var string
*/
private const COLOR_HEADER = "\x1b[1;37;40m";
/**
* @var string
*/
private const COLOR_RESET = "\x1b[0m";
private readonly Thresholds $thresholds;
private readonly bool $showUncoveredFiles;
private readonly bool $showOnlySummary;
public function __construct(Thresholds $thresholds, bool $showUncoveredFiles = false, bool $showOnlySummary = false)
{
$this->thresholds = $thresholds;
$this->showUncoveredFiles = $showUncoveredFiles;
$this->showOnlySummary = $showOnlySummary;
}
public function process(CodeCoverage $coverage, bool $showColors = false): string
{
$hasBranchCoverage = !empty($coverage->getData(true)->functionCoverage());
$output = PHP_EOL . PHP_EOL;
$report = $coverage->getReport();
$colors = [
'header' => '',
'classes' => '',
'methods' => '',
'lines' => '',
'branches' => '',
'paths' => '',
'reset' => '',
];
if ($showColors) {
$colors['classes'] = $this->coverageColor(
$report->numberOfTestedClassesAndTraits(),
$report->numberOfClassesAndTraits(),
);
$colors['methods'] = $this->coverageColor(
$report->numberOfTestedMethods(),
$report->numberOfMethods(),
);
$colors['lines'] = $this->coverageColor(
$report->numberOfExecutedLines(),
$report->numberOfExecutableLines(),
);
$colors['branches'] = $this->coverageColor(
$report->numberOfExecutedBranches(),
$report->numberOfExecutableBranches(),
);
$colors['paths'] = $this->coverageColor(
$report->numberOfExecutedPaths(),
$report->numberOfExecutablePaths(),
);
$colors['reset'] = self::COLOR_RESET;
$colors['header'] = self::COLOR_HEADER;
}
$classes = sprintf(
' Classes: %6s (%d/%d)',
Percentage::fromFractionAndTotal(
$report->numberOfTestedClassesAndTraits(),
$report->numberOfClassesAndTraits(),
)->asString(),
$report->numberOfTestedClassesAndTraits(),
$report->numberOfClassesAndTraits(),
);
$methods = sprintf(
' Methods: %6s (%d/%d)',
Percentage::fromFractionAndTotal(
$report->numberOfTestedMethods(),
$report->numberOfMethods(),
)->asString(),
$report->numberOfTestedMethods(),
$report->numberOfMethods(),
);
$paths = '';
$branches = '';
if ($hasBranchCoverage) {
$paths = sprintf(
' Paths: %6s (%d/%d)',
Percentage::fromFractionAndTotal(
$report->numberOfExecutedPaths(),
$report->numberOfExecutablePaths(),
)->asString(),
$report->numberOfExecutedPaths(),
$report->numberOfExecutablePaths(),
);
$branches = sprintf(
' Branches: %6s (%d/%d)',
Percentage::fromFractionAndTotal(
$report->numberOfExecutedBranches(),
$report->numberOfExecutableBranches(),
)->asString(),
$report->numberOfExecutedBranches(),
$report->numberOfExecutableBranches(),
);
}
$lines = sprintf(
' Lines: %6s (%d/%d)',
Percentage::fromFractionAndTotal(
$report->numberOfExecutedLines(),
$report->numberOfExecutableLines(),
)->asString(),
$report->numberOfExecutedLines(),
$report->numberOfExecutableLines(),
);
$padding = max(array_map('strlen', [$classes, $methods, $lines]));
if ($this->showOnlySummary) {
$title = 'Code Coverage Report Summary:';
$padding = max($padding, strlen($title));
$output .= $this->format($colors['header'], $padding, $title);
} else {
$date = date(' Y-m-d H:i:s');
$title = 'Code Coverage Report:';
$output .= $this->format($colors['header'], $padding, $title);
$output .= $this->format($colors['header'], $padding, $date);
$output .= $this->format($colors['header'], $padding, '');
$output .= $this->format($colors['header'], $padding, ' Summary:');
}
$output .= $this->format($colors['classes'], $padding, $classes);
$output .= $this->format($colors['methods'], $padding, $methods);
if ($hasBranchCoverage) {
$output .= $this->format($colors['paths'], $padding, $paths);
$output .= $this->format($colors['branches'], $padding, $branches);
}
$output .= $this->format($colors['lines'], $padding, $lines);
if ($this->showOnlySummary) {
return $output . PHP_EOL;
}
$classCoverage = [];
foreach ($report as $item) {
if (!$item instanceof File) {
continue;
}
$classes = $item->classesAndTraits();
foreach ($classes as $className => $class) {
$classExecutableLines = 0;
$classExecutedLines = 0;
$classExecutableBranches = 0;
$classExecutedBranches = 0;
$classExecutablePaths = 0;
$classExecutedPaths = 0;
$coveredMethods = 0;
$classMethods = 0;
foreach ($class['methods'] as $method) {
if ($method['executableLines'] == 0) {
continue;
}
$classMethods++;
$classExecutableLines += $method['executableLines'];
$classExecutedLines += $method['executedLines'];
$classExecutableBranches += $method['executableBranches'];
$classExecutedBranches += $method['executedBranches'];
$classExecutablePaths += $method['executablePaths'];
$classExecutedPaths += $method['executedPaths'];
if ($method['coverage'] == 100) {
$coveredMethods++;
}
}
$classCoverage[$className] = [
'namespace' => $class['namespace'],
'className' => $className,
'methodsCovered' => $coveredMethods,
'methodCount' => $classMethods,
'statementsCovered' => $classExecutedLines,
'statementCount' => $classExecutableLines,
'branchesCovered' => $classExecutedBranches,
'branchesCount' => $classExecutableBranches,
'pathsCovered' => $classExecutedPaths,
'pathsCount' => $classExecutablePaths,
];
}
}
ksort($classCoverage);
$methodColor = '';
$pathsColor = '';
$branchesColor = '';
$linesColor = '';
$resetColor = '';
foreach ($classCoverage as $fullQualifiedPath => $classInfo) {
if ($this->showUncoveredFiles || $classInfo['statementsCovered'] != 0) {
if ($showColors) {
$methodColor = $this->coverageColor($classInfo['methodsCovered'], $classInfo['methodCount']);
$pathsColor = $this->coverageColor($classInfo['pathsCovered'], $classInfo['pathsCount']);
$branchesColor = $this->coverageColor($classInfo['branchesCovered'], $classInfo['branchesCount']);
$linesColor = $this->coverageColor($classInfo['statementsCovered'], $classInfo['statementCount']);
$resetColor = $colors['reset'];
}
$output .= PHP_EOL . $fullQualifiedPath . PHP_EOL
. ' ' . $methodColor . 'Methods: ' . $this->printCoverageCounts($classInfo['methodsCovered'], $classInfo['methodCount'], 2) . $resetColor . ' ';
if ($hasBranchCoverage) {
$output .= ' ' . $pathsColor . 'Paths: ' . $this->printCoverageCounts($classInfo['pathsCovered'], $classInfo['pathsCount'], 3) . $resetColor . ' '
. ' ' . $branchesColor . 'Branches: ' . $this->printCoverageCounts($classInfo['branchesCovered'], $classInfo['branchesCount'], 3) . $resetColor . ' ';
}
$output .= ' ' . $linesColor . 'Lines: ' . $this->printCoverageCounts($classInfo['statementsCovered'], $classInfo['statementCount'], 3) . $resetColor;
}
}
return $output . PHP_EOL;
}
private function coverageColor(int $numberOfCoveredElements, int $totalNumberOfElements): string
{
$coverage = Percentage::fromFractionAndTotal(
$numberOfCoveredElements,
$totalNumberOfElements,
);
if ($coverage->asFloat() >= $this->thresholds->highLowerBound()) {
return self::COLOR_GREEN;
}
if ($coverage->asFloat() > $this->thresholds->lowUpperBound()) {
return self::COLOR_YELLOW;
}
return self::COLOR_RED;
}
private function printCoverageCounts(int $numberOfCoveredElements, int $totalNumberOfElements, int $precision): string
{
$format = '%' . $precision . 's';
return Percentage::fromFractionAndTotal(
$numberOfCoveredElements,
$totalNumberOfElements,
)->asFixedWidthString() .
' (' . sprintf($format, $numberOfCoveredElements) . '/' .
sprintf($format, $totalNumberOfElements) . ')';
}
private function format(string $color, int $padding, false|string $string): string
{
if ($color === '') {
return (string) $string . PHP_EOL;
}
return $color . str_pad((string) $string, $padding) . self::COLOR_RESET . PHP_EOL;
}
}
php-code-coverage/src/Report/Cobertura.php 0000644 00000031052 15243417753 0014551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use function basename;
use function count;
use function dirname;
use function file_put_contents;
use function preg_match;
use function range;
use function str_contains;
use function str_replace;
use function time;
use DOMImplementation;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\WriteOperationFailedException;
use SebastianBergmann\CodeCoverage\Node\File;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
final class Cobertura
{
/**
* @throws WriteOperationFailedException
*/
public function process(CodeCoverage $coverage, ?string $target = null): string
{
$time = (string) time();
$report = $coverage->getReport();
$implementation = new DOMImplementation;
$documentType = $implementation->createDocumentType(
'coverage',
'',
'http://cobertura.sourceforge.net/xml/coverage-04.dtd',
);
$document = $implementation->createDocument('', '', $documentType);
$document->xmlVersion = '1.0';
$document->encoding = 'UTF-8';
$document->formatOutput = true;
$coverageElement = $document->createElement('coverage');
$linesValid = $report->numberOfExecutableLines();
$linesCovered = $report->numberOfExecutedLines();
$lineRate = $linesValid === 0 ? 0 : ($linesCovered / $linesValid);
$coverageElement->setAttribute('line-rate', (string) $lineRate);
$branchesValid = $report->numberOfExecutableBranches();
$branchesCovered = $report->numberOfExecutedBranches();
$branchRate = $branchesValid === 0 ? 0 : ($branchesCovered / $branchesValid);
$coverageElement->setAttribute('branch-rate', (string) $branchRate);
$coverageElement->setAttribute('lines-covered', (string) $report->numberOfExecutedLines());
$coverageElement->setAttribute('lines-valid', (string) $report->numberOfExecutableLines());
$coverageElement->setAttribute('branches-covered', (string) $report->numberOfExecutedBranches());
$coverageElement->setAttribute('branches-valid', (string) $report->numberOfExecutableBranches());
$coverageElement->setAttribute('complexity', '');
$coverageElement->setAttribute('version', '0.4');
$coverageElement->setAttribute('timestamp', $time);
$document->appendChild($coverageElement);
$sourcesElement = $document->createElement('sources');
$coverageElement->appendChild($sourcesElement);
$sourceElement = $document->createElement('source', $report->pathAsString());
$sourcesElement->appendChild($sourceElement);
$packagesElement = $document->createElement('packages');
$coverageElement->appendChild($packagesElement);
$complexity = 0;
foreach ($report as $item) {
if (!$item instanceof File) {
continue;
}
$packageElement = $document->createElement('package');
$packageComplexity = 0;
$packageElement->setAttribute('name', str_replace($report->pathAsString() . DIRECTORY_SEPARATOR, '', $item->pathAsString()));
$linesValid = $item->numberOfExecutableLines();
$linesCovered = $item->numberOfExecutedLines();
$lineRate = $linesValid === 0 ? 0 : ($linesCovered / $linesValid);
$packageElement->setAttribute('line-rate', (string) $lineRate);
$branchesValid = $item->numberOfExecutableBranches();
$branchesCovered = $item->numberOfExecutedBranches();
$branchRate = $branchesValid === 0 ? 0 : ($branchesCovered / $branchesValid);
$packageElement->setAttribute('branch-rate', (string) $branchRate);
$packageElement->setAttribute('complexity', '');
$packagesElement->appendChild($packageElement);
$classesElement = $document->createElement('classes');
$packageElement->appendChild($classesElement);
$classes = $item->classesAndTraits();
$coverageData = $item->lineCoverageData();
foreach ($classes as $className => $class) {
$complexity += $class['ccn'];
$packageComplexity += $class['ccn'];
if (!empty($class['package']['namespace'])) {
$className = $class['package']['namespace'] . '\\' . $className;
}
$linesValid = $class['executableLines'];
$linesCovered = $class['executedLines'];
$lineRate = $linesValid === 0 ? 0 : ($linesCovered / $linesValid);
$branchesValid = $class['executableBranches'];
$branchesCovered = $class['executedBranches'];
$branchRate = $branchesValid === 0 ? 0 : ($branchesCovered / $branchesValid);
$classElement = $document->createElement('class');
$classElement->setAttribute('name', $className);
$classElement->setAttribute('filename', str_replace($report->pathAsString() . DIRECTORY_SEPARATOR, '', $item->pathAsString()));
$classElement->setAttribute('line-rate', (string) $lineRate);
$classElement->setAttribute('branch-rate', (string) $branchRate);
$classElement->setAttribute('complexity', (string) $class['ccn']);
$classesElement->appendChild($classElement);
$methodsElement = $document->createElement('methods');
$classElement->appendChild($methodsElement);
$classLinesElement = $document->createElement('lines');
$classElement->appendChild($classLinesElement);
foreach ($class['methods'] as $methodName => $method) {
if ($method['executableLines'] === 0) {
continue;
}
preg_match("/\((.*?)\)/", $method['signature'], $signature);
$linesValid = $method['executableLines'];
$linesCovered = $method['executedLines'];
$lineRate = $linesValid === 0 ? 0 : ($linesCovered / $linesValid);
$branchesValid = $method['executableBranches'];
$branchesCovered = $method['executedBranches'];
$branchRate = $branchesValid === 0 ? 0 : ($branchesCovered / $branchesValid);
$methodElement = $document->createElement('method');
$methodElement->setAttribute('name', $methodName);
$methodElement->setAttribute('signature', $signature[1]);
$methodElement->setAttribute('line-rate', (string) $lineRate);
$methodElement->setAttribute('branch-rate', (string) $branchRate);
$methodElement->setAttribute('complexity', (string) $method['ccn']);
$methodLinesElement = $document->createElement('lines');
$methodElement->appendChild($methodLinesElement);
foreach (range($method['startLine'], $method['endLine']) as $line) {
if (!isset($coverageData[$line])) {
continue;
}
$methodLineElement = $document->createElement('line');
$methodLineElement->setAttribute('number', (string) $line);
$methodLineElement->setAttribute('hits', (string) count($coverageData[$line]));
$methodLinesElement->appendChild($methodLineElement);
$classLineElement = $methodLineElement->cloneNode();
$classLinesElement->appendChild($classLineElement);
}
$methodsElement->appendChild($methodElement);
}
}
if ($item->numberOfFunctions() === 0) {
$packageElement->setAttribute('complexity', (string) $packageComplexity);
continue;
}
$functionsComplexity = 0;
$functionsLinesValid = 0;
$functionsLinesCovered = 0;
$functionsBranchesValid = 0;
$functionsBranchesCovered = 0;
$classElement = $document->createElement('class');
$classElement->setAttribute('name', basename($item->pathAsString()));
$classElement->setAttribute('filename', str_replace($report->pathAsString() . DIRECTORY_SEPARATOR, '', $item->pathAsString()));
$methodsElement = $document->createElement('methods');
$classElement->appendChild($methodsElement);
$classLinesElement = $document->createElement('lines');
$classElement->appendChild($classLinesElement);
$functions = $item->functions();
foreach ($functions as $functionName => $function) {
if ($function['executableLines'] === 0) {
continue;
}
$complexity += $function['ccn'];
$packageComplexity += $function['ccn'];
$functionsComplexity += $function['ccn'];
$linesValid = $function['executableLines'];
$linesCovered = $function['executedLines'];
$lineRate = $linesValid === 0 ? 0 : ($linesCovered / $linesValid);
$functionsLinesValid += $linesValid;
$functionsLinesCovered += $linesCovered;
$branchesValid = $function['executableBranches'];
$branchesCovered = $function['executedBranches'];
$branchRate = $branchesValid === 0 ? 0 : ($branchesCovered / $branchesValid);
$functionsBranchesValid += $branchesValid;
$functionsBranchesCovered += $branchesValid;
$methodElement = $document->createElement('method');
$methodElement->setAttribute('name', $functionName);
$methodElement->setAttribute('signature', $function['signature']);
$methodElement->setAttribute('line-rate', (string) $lineRate);
$methodElement->setAttribute('branch-rate', (string) $branchRate);
$methodElement->setAttribute('complexity', (string) $function['ccn']);
$methodLinesElement = $document->createElement('lines');
$methodElement->appendChild($methodLinesElement);
foreach (range($function['startLine'], $function['endLine']) as $line) {
if (!isset($coverageData[$line])) {
continue;
}
$methodLineElement = $document->createElement('line');
$methodLineElement->setAttribute('number', (string) $line);
$methodLineElement->setAttribute('hits', (string) count($coverageData[$line]));
$methodLinesElement->appendChild($methodLineElement);
$classLineElement = $methodLineElement->cloneNode();
$classLinesElement->appendChild($classLineElement);
}
$methodsElement->appendChild($methodElement);
}
$packageElement->setAttribute('complexity', (string) $packageComplexity);
if ($functionsLinesValid === 0) {
continue;
}
$lineRate = $functionsLinesCovered / $functionsLinesValid;
$branchRate = $functionsBranchesValid === 0 ? 0 : ($functionsBranchesCovered / $functionsBranchesValid);
$classElement->setAttribute('line-rate', (string) $lineRate);
$classElement->setAttribute('branch-rate', (string) $branchRate);
$classElement->setAttribute('complexity', (string) $functionsComplexity);
$classesElement->appendChild($classElement);
}
$coverageElement->setAttribute('complexity', (string) $complexity);
$buffer = $document->saveXML();
if ($target !== null) {
if (!str_contains($target, '://')) {
Filesystem::createDirectory(dirname($target));
}
if (@file_put_contents($target, $buffer) === false) {
throw new WriteOperationFailedException($target);
}
}
return $buffer;
}
}
php-code-coverage/src/Report/Clover.php 0000644 00000025256 15243417753 0014066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report;
use function count;
use function dirname;
use function file_put_contents;
use function is_string;
use function ksort;
use function max;
use function range;
use function str_contains;
use function time;
use DOMDocument;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\WriteOperationFailedException;
use SebastianBergmann\CodeCoverage\Node\File;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
final class Clover
{
/**
* @throws WriteOperationFailedException
*/
public function process(CodeCoverage $coverage, ?string $target = null, ?string $name = null): string
{
$time = (string) time();
$xmlDocument = new DOMDocument('1.0', 'UTF-8');
$xmlDocument->formatOutput = true;
$xmlCoverage = $xmlDocument->createElement('coverage');
$xmlCoverage->setAttribute('generated', $time);
$xmlDocument->appendChild($xmlCoverage);
$xmlProject = $xmlDocument->createElement('project');
$xmlProject->setAttribute('timestamp', $time);
if (is_string($name)) {
$xmlProject->setAttribute('name', $name);
}
$xmlCoverage->appendChild($xmlProject);
$packages = [];
$report = $coverage->getReport();
foreach ($report as $item) {
if (!$item instanceof File) {
continue;
}
/* @var File $item */
$xmlFile = $xmlDocument->createElement('file');
$xmlFile->setAttribute('name', $item->pathAsString());
$classes = $item->classesAndTraits();
$coverageData = $item->lineCoverageData();
$lines = [];
$namespace = 'global';
foreach ($classes as $className => $class) {
$classStatements = 0;
$coveredClassStatements = 0;
$coveredMethods = 0;
$classMethods = 0;
foreach ($class['methods'] as $methodName => $method) {
if ($method['executableLines'] == 0) {
continue;
}
$classMethods++;
$classStatements += $method['executableLines'];
$coveredClassStatements += $method['executedLines'];
if ($method['coverage'] == 100) {
$coveredMethods++;
}
$methodCount = 0;
foreach (range($method['startLine'], $method['endLine']) as $line) {
if (isset($coverageData[$line])) {
$methodCount = max($methodCount, count($coverageData[$line]));
}
}
$lines[$method['startLine']] = [
'ccn' => $method['ccn'],
'count' => $methodCount,
'crap' => $method['crap'],
'type' => 'method',
'visibility' => $method['visibility'],
'name' => $methodName,
];
}
if (!empty($class['package']['namespace'])) {
$namespace = $class['package']['namespace'];
}
$xmlClass = $xmlDocument->createElement('class');
$xmlClass->setAttribute('name', $className);
$xmlClass->setAttribute('namespace', $namespace);
if (!empty($class['package']['fullPackage'])) {
$xmlClass->setAttribute(
'fullPackage',
$class['package']['fullPackage'],
);
}
if (!empty($class['package']['category'])) {
$xmlClass->setAttribute(
'category',
$class['package']['category'],
);
}
if (!empty($class['package']['package'])) {
$xmlClass->setAttribute(
'package',
$class['package']['package'],
);
}
if (!empty($class['package']['subpackage'])) {
$xmlClass->setAttribute(
'subpackage',
$class['package']['subpackage'],
);
}
$xmlFile->appendChild($xmlClass);
$xmlMetrics = $xmlDocument->createElement('metrics');
$xmlMetrics->setAttribute('complexity', (string) $class['ccn']);
$xmlMetrics->setAttribute('methods', (string) $classMethods);
$xmlMetrics->setAttribute('coveredmethods', (string) $coveredMethods);
$xmlMetrics->setAttribute('conditionals', (string) $class['executableBranches']);
$xmlMetrics->setAttribute('coveredconditionals', (string) $class['executedBranches']);
$xmlMetrics->setAttribute('statements', (string) $classStatements);
$xmlMetrics->setAttribute('coveredstatements', (string) $coveredClassStatements);
$xmlMetrics->setAttribute('elements', (string) ($classMethods + $classStatements + $class['executableBranches']));
$xmlMetrics->setAttribute('coveredelements', (string) ($coveredMethods + $coveredClassStatements + $class['executedBranches']));
$xmlClass->appendChild($xmlMetrics);
}
foreach ($coverageData as $line => $data) {
if ($data === null || isset($lines[$line])) {
continue;
}
$lines[$line] = [
'count' => count($data), 'type' => 'stmt',
];
}
ksort($lines);
foreach ($lines as $line => $data) {
$xmlLine = $xmlDocument->createElement('line');
$xmlLine->setAttribute('num', (string) $line);
$xmlLine->setAttribute('type', $data['type']);
if (isset($data['name'])) {
$xmlLine->setAttribute('name', $data['name']);
}
if (isset($data['visibility'])) {
$xmlLine->setAttribute('visibility', $data['visibility']);
}
if (isset($data['ccn'])) {
$xmlLine->setAttribute('complexity', (string) $data['ccn']);
}
if (isset($data['crap'])) {
$xmlLine->setAttribute('crap', (string) $data['crap']);
}
$xmlLine->setAttribute('count', (string) $data['count']);
$xmlFile->appendChild($xmlLine);
}
$linesOfCode = $item->linesOfCode();
$xmlMetrics = $xmlDocument->createElement('metrics');
$xmlMetrics->setAttribute('loc', (string) $linesOfCode['linesOfCode']);
$xmlMetrics->setAttribute('ncloc', (string) $linesOfCode['nonCommentLinesOfCode']);
$xmlMetrics->setAttribute('classes', (string) $item->numberOfClassesAndTraits());
$xmlMetrics->setAttribute('methods', (string) $item->numberOfMethods());
$xmlMetrics->setAttribute('coveredmethods', (string) $item->numberOfTestedMethods());
$xmlMetrics->setAttribute('conditionals', (string) $item->numberOfExecutableBranches());
$xmlMetrics->setAttribute('coveredconditionals', (string) $item->numberOfExecutedBranches());
$xmlMetrics->setAttribute('statements', (string) $item->numberOfExecutableLines());
$xmlMetrics->setAttribute('coveredstatements', (string) $item->numberOfExecutedLines());
$xmlMetrics->setAttribute('elements', (string) ($item->numberOfMethods() + $item->numberOfExecutableLines() + $item->numberOfExecutableBranches()));
$xmlMetrics->setAttribute('coveredelements', (string) ($item->numberOfTestedMethods() + $item->numberOfExecutedLines() + $item->numberOfExecutedBranches()));
$xmlFile->appendChild($xmlMetrics);
if ($namespace === 'global') {
$xmlProject->appendChild($xmlFile);
} else {
if (!isset($packages[$namespace])) {
$packages[$namespace] = $xmlDocument->createElement(
'package',
);
$packages[$namespace]->setAttribute('name', $namespace);
$xmlProject->appendChild($packages[$namespace]);
}
$packages[$namespace]->appendChild($xmlFile);
}
}
$linesOfCode = $report->linesOfCode();
$xmlMetrics = $xmlDocument->createElement('metrics');
$xmlMetrics->setAttribute('files', (string) count($report));
$xmlMetrics->setAttribute('loc', (string) $linesOfCode['linesOfCode']);
$xmlMetrics->setAttribute('ncloc', (string) $linesOfCode['nonCommentLinesOfCode']);
$xmlMetrics->setAttribute('classes', (string) $report->numberOfClassesAndTraits());
$xmlMetrics->setAttribute('methods', (string) $report->numberOfMethods());
$xmlMetrics->setAttribute('coveredmethods', (string) $report->numberOfTestedMethods());
$xmlMetrics->setAttribute('conditionals', (string) $report->numberOfExecutableBranches());
$xmlMetrics->setAttribute('coveredconditionals', (string) $report->numberOfExecutedBranches());
$xmlMetrics->setAttribute('statements', (string) $report->numberOfExecutableLines());
$xmlMetrics->setAttribute('coveredstatements', (string) $report->numberOfExecutedLines());
$xmlMetrics->setAttribute('elements', (string) ($report->numberOfMethods() + $report->numberOfExecutableLines() + $report->numberOfExecutableBranches()));
$xmlMetrics->setAttribute('coveredelements', (string) ($report->numberOfTestedMethods() + $report->numberOfExecutedLines() + $report->numberOfExecutedBranches()));
$xmlProject->appendChild($xmlMetrics);
$buffer = $xmlDocument->saveXML();
if ($target !== null) {
if (!str_contains($target, '://')) {
Filesystem::createDirectory(dirname($target));
}
if (@file_put_contents($target, $buffer) === false) {
throw new WriteOperationFailedException($target);
}
}
return $buffer;
}
}
php-code-coverage/src/Report/Html/Colors.php 0000644 00000003320 15243417753 0014765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
/**
* @psalm-immutable
*/
final class Colors
{
private readonly string $successLow;
private readonly string $successMedium;
private readonly string $successHigh;
private readonly string $warning;
private readonly string $danger;
public static function default(): self
{
return new self('#dff0d8', '#c3e3b5', '#99cb84', '#fcf8e3', '#f2dede');
}
public static function from(string $successLow, string $successMedium, string $successHigh, string $warning, string $danger): self
{
return new self($successLow, $successMedium, $successHigh, $warning, $danger);
}
private function __construct(string $successLow, string $successMedium, string $successHigh, string $warning, string $danger)
{
$this->successLow = $successLow;
$this->successMedium = $successMedium;
$this->successHigh = $successHigh;
$this->warning = $warning;
$this->danger = $danger;
}
public function successLow(): string
{
return $this->successLow;
}
public function successMedium(): string
{
return $this->successMedium;
}
public function successHigh(): string
{
return $this->successHigh;
}
public function warning(): string
{
return $this->warning;
}
public function danger(): string
{
return $this->danger;
}
}
php-code-coverage/src/Report/Html/Facade.php 0000644 00000012432 15243417753 0014673 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use const DIRECTORY_SEPARATOR;
use function copy;
use function date;
use function dirname;
use function str_ends_with;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\FileCouldNotBeWrittenException;
use SebastianBergmann\CodeCoverage\Node\Directory as DirectoryNode;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\CodeCoverage\Util\Filesystem;
use SebastianBergmann\Template\Exception;
use SebastianBergmann\Template\Template;
final class Facade
{
private readonly string $templatePath;
private readonly string $generator;
private readonly Colors $colors;
private readonly Thresholds $thresholds;
private readonly CustomCssFile $customCssFile;
public function __construct(string $generator = '', ?Colors $colors = null, ?Thresholds $thresholds = null, ?CustomCssFile $customCssFile = null)
{
$this->generator = $generator;
$this->colors = $colors ?? Colors::default();
$this->thresholds = $thresholds ?? Thresholds::default();
$this->customCssFile = $customCssFile ?? CustomCssFile::default();
$this->templatePath = __DIR__ . '/Renderer/Template/';
}
public function process(CodeCoverage $coverage, string $target): void
{
$target = $this->directory($target);
$report = $coverage->getReport();
$date = date('D M j G:i:s T Y');
$dashboard = new Dashboard(
$this->templatePath,
$this->generator,
$date,
$this->thresholds,
$coverage->collectsBranchAndPathCoverage(),
);
$directory = new Directory(
$this->templatePath,
$this->generator,
$date,
$this->thresholds,
$coverage->collectsBranchAndPathCoverage(),
);
$file = new File(
$this->templatePath,
$this->generator,
$date,
$this->thresholds,
$coverage->collectsBranchAndPathCoverage(),
);
$directory->render($report, $target . 'index.html');
$dashboard->render($report, $target . 'dashboard.html');
foreach ($report as $node) {
$id = $node->id();
if ($node instanceof DirectoryNode) {
Filesystem::createDirectory($target . $id);
$directory->render($node, $target . $id . '/index.html');
$dashboard->render($node, $target . $id . '/dashboard.html');
} else {
$dir = dirname($target . $id);
Filesystem::createDirectory($dir);
$file->render($node, $target . $id);
}
}
$this->copyFiles($target);
$this->renderCss($target);
}
private function copyFiles(string $target): void
{
$dir = $this->directory($target . '_css');
copy($this->templatePath . 'css/bootstrap.min.css', $dir . 'bootstrap.min.css');
copy($this->templatePath . 'css/nv.d3.min.css', $dir . 'nv.d3.min.css');
copy($this->customCssFile->path(), $dir . 'custom.css');
copy($this->templatePath . 'css/octicons.css', $dir . 'octicons.css');
$dir = $this->directory($target . '_icons');
copy($this->templatePath . 'icons/file-code.svg', $dir . 'file-code.svg');
copy($this->templatePath . 'icons/file-directory.svg', $dir . 'file-directory.svg');
$dir = $this->directory($target . '_js');
copy($this->templatePath . 'js/bootstrap.min.js', $dir . 'bootstrap.min.js');
copy($this->templatePath . 'js/popper.min.js', $dir . 'popper.min.js');
copy($this->templatePath . 'js/d3.min.js', $dir . 'd3.min.js');
copy($this->templatePath . 'js/jquery.min.js', $dir . 'jquery.min.js');
copy($this->templatePath . 'js/nv.d3.min.js', $dir . 'nv.d3.min.js');
copy($this->templatePath . 'js/file.js', $dir . 'file.js');
}
private function renderCss(string $target): void
{
$template = new Template($this->templatePath . 'css/style.css', '{{', '}}');
$template->setVar(
[
'success-low' => $this->colors->successLow(),
'success-medium' => $this->colors->successMedium(),
'success-high' => $this->colors->successHigh(),
'warning' => $this->colors->warning(),
'danger' => $this->colors->danger(),
],
);
try {
$template->renderTo($this->directory($target . '_css') . 'style.css');
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
private function directory(string $directory): string
{
if (!str_ends_with($directory, DIRECTORY_SEPARATOR)) {
$directory .= DIRECTORY_SEPARATOR;
}
Filesystem::createDirectory($directory);
return $directory;
}
}
php-code-coverage/src/Report/Html/CustomCssFile.php 0000644 00000002106 15243417753 0016250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use function is_file;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
/**
* @psalm-immutable
*/
final class CustomCssFile
{
private readonly string $path;
public static function default(): self
{
return new self(__DIR__ . '/Renderer/Template/css/custom.css');
}
/**
* @throws InvalidArgumentException
*/
public static function from(string $path): self
{
if (!is_file($path)) {
throw new InvalidArgumentException(
'$path does not exist',
);
}
return new self($path);
}
private function __construct(string $path)
{
$this->path = $path;
}
public function path(): string
{
return $this->path;
}
}
php-code-coverage/src/Report/Html/Renderer/Directory.php 0000644 00000012252 15243417753 0017242 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use function count;
use function sprintf;
use function str_repeat;
use SebastianBergmann\CodeCoverage\FileCouldNotBeWrittenException;
use SebastianBergmann\CodeCoverage\Node\AbstractNode as Node;
use SebastianBergmann\CodeCoverage\Node\Directory as DirectoryNode;
use SebastianBergmann\Template\Exception;
use SebastianBergmann\Template\Template;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Directory extends Renderer
{
public function render(DirectoryNode $node, string $file): void
{
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'directory_branch.html' : 'directory.html');
$template = new Template($templateName, '{{', '}}');
$this->setCommonTemplateVariables($template, $node);
$items = $this->renderItem($node, true);
foreach ($node->directories() as $item) {
$items .= $this->renderItem($item);
}
foreach ($node->files() as $item) {
$items .= $this->renderItem($item);
}
$template->setVar(
[
'id' => $node->id(),
'items' => $items,
],
);
try {
$template->renderTo($file);
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
private function renderItem(Node $node, bool $total = false): string
{
$data = [
'numClasses' => $node->numberOfClassesAndTraits(),
'numTestedClasses' => $node->numberOfTestedClassesAndTraits(),
'numMethods' => $node->numberOfFunctionsAndMethods(),
'numTestedMethods' => $node->numberOfTestedFunctionsAndMethods(),
'linesExecutedPercent' => $node->percentageOfExecutedLines()->asFloat(),
'linesExecutedPercentAsString' => $node->percentageOfExecutedLines()->asString(),
'numExecutedLines' => $node->numberOfExecutedLines(),
'numExecutableLines' => $node->numberOfExecutableLines(),
'branchesExecutedPercent' => $node->percentageOfExecutedBranches()->asFloat(),
'branchesExecutedPercentAsString' => $node->percentageOfExecutedBranches()->asString(),
'numExecutedBranches' => $node->numberOfExecutedBranches(),
'numExecutableBranches' => $node->numberOfExecutableBranches(),
'pathsExecutedPercent' => $node->percentageOfExecutedPaths()->asFloat(),
'pathsExecutedPercentAsString' => $node->percentageOfExecutedPaths()->asString(),
'numExecutedPaths' => $node->numberOfExecutedPaths(),
'numExecutablePaths' => $node->numberOfExecutablePaths(),
'testedMethodsPercent' => $node->percentageOfTestedFunctionsAndMethods()->asFloat(),
'testedMethodsPercentAsString' => $node->percentageOfTestedFunctionsAndMethods()->asString(),
'testedClassesPercent' => $node->percentageOfTestedClassesAndTraits()->asFloat(),
'testedClassesPercentAsString' => $node->percentageOfTestedClassesAndTraits()->asString(),
];
if ($total) {
$data['name'] = 'Total';
} else {
$up = str_repeat('../', count($node->pathAsArray()) - 2);
$data['icon'] = sprintf('<img src="%s_icons/file-code.svg" class="octicon" />', $up);
if ($node instanceof DirectoryNode) {
$data['name'] = sprintf(
'<a href="%s/index.html">%s</a>',
$node->name(),
$node->name(),
);
$data['icon'] = sprintf('<img src="%s_icons/file-directory.svg" class="octicon" />', $up);
} elseif ($this->hasBranchCoverage) {
$data['name'] = sprintf(
'%s <a class="small" href="%s.html">[line]</a> <a class="small" href="%s_branch.html">[branch]</a> <a class="small" href="%s_path.html">[path]</a>',
$node->name(),
$node->name(),
$node->name(),
$node->name(),
);
} else {
$data['name'] = sprintf(
'<a href="%s.html">%s</a>',
$node->name(),
$node->name(),
);
}
}
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'directory_item_branch.html' : 'directory_item.html');
return $this->renderItemTemplate(
new Template($templateName, '{{', '}}'),
$data,
);
}
}
php-code-coverage/src/Report/Html/Renderer/Template/branches.html.dist 0000644 00000000764 15243417753 0021762 0 ustar 00 <hr/>
<h4>Branches</h4>
<p>
Below are the source code lines that represent each code branch as identified by Xdebug. Please note a branch is not
necessarily coterminous with a line, a line may contain multiple branches and therefore show up more than once.
Please also be aware that some branches may be implicit rather than explicit, e.g. an <code>if</code> statement
<i>always</i> has an <code>else</code> as part of its logical flow even if you didn't write one.
</p>
{{branches}}
php-code-coverage/src/Report/Html/Renderer/Template/directory_item_branch.html.dist 0000644 00000002473 15243417753 0024533 0 ustar 00 <tr>
<td class="{{lines_level}}">{{icon}}{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{branches_level}} big">{{branches_bar}}</td>
<td class="{{branches_level}} small"><div align="right">{{branches_executed_percent}}</div></td>
<td class="{{branches_level}} small"><div align="right">{{branches_number}}</div></td>
<td class="{{paths_level}} big">{{paths_bar}}</td>
<td class="{{paths_level}} small"><div align="right">{{paths_executed_percent}}</div></td>
<td class="{{paths_level}} small"><div align="right">{{paths_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{classes_level}} big">{{classes_bar}}</td>
<td class="{{classes_level}} small"><div align="right">{{classes_tested_percent}}</div></td>
<td class="{{classes_level}} small"><div align="right">{{classes_number}}</div></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/directory_item.html.dist 0000644 00000001501 15243417753 0023205 0 ustar 00 <tr>
<td class="{{lines_level}}">{{icon}}{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{classes_level}} big">{{classes_bar}}</td>
<td class="{{classes_level}} small"><div align="right">{{classes_tested_percent}}</div></td>
<td class="{{classes_level}} small"><div align="right">{{classes_number}}</div></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/file_item.html.dist 0000644 00000001562 15243417753 0022127 0 ustar 00 <tr>
<td class="{{lines_level}}">{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{methods_level}} small">{{crap}}</td>
<td class="{{classes_level}} big">{{classes_bar}}</td>
<td class="{{classes_level}} small"><div align="right">{{classes_tested_percent}}</div></td>
<td class="{{classes_level}} small"><div align="right">{{classes_number}}</div></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/coverage_bar.html.dist 0000644 00000000447 15243417753 0022612 0 ustar 00 <div class="progress">
<div class="progress-bar bg-{{level}}" role="progressbar" aria-valuenow="{{percent}}" aria-valuemin="0" aria-valuemax="100" style="width: {{percent}}%">
<span class="sr-only">{{percent}}% covered ({{level}})</span>
</div>
</div>
php-code-coverage/src/Report/Html/Renderer/Template/method_item.html.dist 0000644 00000001253 15243417753 0022465 0 ustar 00 <tr>
<td class="{{lines_level}}">{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{methods_level}} small">{{crap}}</td>
<td class="{{methods_level}}" colspan="3"></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/icons/file-code.svg 0000644 00000000460 15243417753 0022021 0 ustar 00 <svg xmlns="http://www.w3.org/2000/svg" width="12" height="16" viewBox="0 0 12 16"><path fill-rule="evenodd" d="M8.5 1H1c-.55 0-1 .45-1 1v12c0 .55.45 1 1 1h10c.55 0 1-.45 1-1V4.5L8.5 1zM11 14H1V2h7l3 3v9zM5 6.98L3.5 8.5 5 10l-.5 1L2 8.5 4.5 6l.5.98zM7.5 6L10 8.5 7.5 11l-.5-.98L8.5 8.5 7 7l.5-1z"/></svg> php-code-coverage/src/Report/Html/Renderer/Template/icons/file-directory.svg 0000644 00000000352 15243417753 0023113 0 ustar 00 <svg xmlns="http://www.w3.org/2000/svg" width="14" height="16" viewBox="0 0 14 16"><path fill-rule="evenodd" d="M13 4H7V3c0-.66-.31-1-1-1H1c-.55 0-1 .45-1 1v10c0 .55.45 1 1 1h12c.55 0 1-.45 1-1V5c0-.55-.45-1-1-1zM6 4H1V3h5v1z"/></svg> php-code-coverage/src/Report/Html/Renderer/Template/directory_branch.html.dist 0000644 00000004224 15243417753 0023511 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Code Coverage for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/octicons.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="table-responsive">
<table class="table table-bordered">
<thead>
<tr>
<td> </td>
<td colspan="15"><div align="center"><strong>Code Coverage</strong></div></td>
</tr>
<tr>
<td> </td>
<td colspan="3"><div align="center"><strong>Lines</strong></div></td>
<td colspan="3"><div align="center"><strong>Branches</strong></div></td>
<td colspan="3"><div align="center"><strong>Paths</strong></div></td>
<td colspan="3"><div align="center"><strong>Functions and Methods</strong></div></td>
<td colspan="3"><div align="center"><strong>Classes and Traits</strong></div></td>
</tr>
</thead>
<tbody>
{{items}}
</tbody>
</table>
</div>
<footer>
<hr/>
<h4>Legend</h4>
<p>
<span class="danger"><strong>Low</strong>: 0% to {{low_upper_bound}}%</span>
<span class="warning"><strong>Medium</strong>: {{low_upper_bound}}% to {{high_lower_bound}}%</span>
<span class="success"><strong>High</strong>: {{high_lower_bound}}% to 100%</span>
</p>
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
</footer>
</div>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Template/coverage_bar_branch.html.dist 0000644 00000000447 15243417753 0024127 0 ustar 00 <div class="progress">
<div class="progress-bar bg-{{level}}" role="progressbar" aria-valuenow="{{percent}}" aria-valuemin="0" aria-valuemax="100" style="width: {{percent}}%">
<span class="sr-only">{{percent}}% covered ({{level}})</span>
</div>
</div>
php-code-coverage/src/Report/Html/Renderer/Template/css/bootstrap.min.css 0000644 00000474730 15243417753 0022456 0 ustar 00 /*!
* Bootstrap v4.6.2 (https://getbootstrap.com/)
* Copyright 2011-2022 The Bootstrap Authors
* Copyright 2011-2022 Twitter, Inc.
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
*/:root{--blue:#007bff;--indigo:#6610f2;--purple:#6f42c1;--pink:#e83e8c;--red:#dc3545;--orange:#fd7e14;--yellow:#ffc107;--green:#28a745;--teal:#20c997;--cyan:#17a2b8;--white:#fff;--gray:#6c757d;--gray-dark:#343a40;--primary:#007bff;--secondary:#6c757d;--success:#28a745;--info:#17a2b8;--warning:#ffc107;--danger:#dc3545;--light:#f8f9fa;--dark:#343a40;--breakpoint-xs:0;--breakpoint-sm:576px;--breakpoint-md:768px;--breakpoint-lg:992px;--breakpoint-xl:1200px;--font-family-sans-serif:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-family-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace}*,::after,::before{box-sizing:border-box}html{font-family:sans-serif;line-height:1.15;-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}article,aside,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}body{margin:0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-size:1rem;font-weight:400;line-height:1.5;color:#212529;text-align:left;background-color:#fff}[tabindex="-1"]:focus:not(:focus-visible){outline:0!important}hr{box-sizing:content-box;height:0;overflow:visible}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem}p{margin-top:0;margin-bottom:1rem}abbr[data-original-title],abbr[title]{text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;border-bottom:0;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:80%}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#007bff;text-decoration:none;background-color:transparent}a:hover{color:#0056b3;text-decoration:underline}a:not([href]):not([class]){color:inherit;text-decoration:none}a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:1em}pre{margin-top:0;margin-bottom:1rem;overflow:auto;-ms-overflow-style:scrollbar}figure{margin:0 0 1rem}img{vertical-align:middle;border-style:none}svg{overflow:hidden;vertical-align:middle}table{border-collapse:collapse}caption{padding-top:.75rem;padding-bottom:.75rem;color:#6c757d;text-align:left;caption-side:bottom}th{text-align:inherit;text-align:-webkit-match-parent}label{display:inline-block;margin-bottom:.5rem}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,input{overflow:visible}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{padding:0;border-style:none}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}textarea{overflow:auto;resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{display:block;width:100%;max-width:100%;padding:0;margin-bottom:.5rem;font-size:1.5rem;line-height:inherit;color:inherit;white-space:normal}progress{vertical-align:baseline}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:none}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}template{display:none}[hidden]{display:none!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{margin-bottom:.5rem;font-weight:500;line-height:1.2}.h1,h1{font-size:2.5rem}.h2,h2{font-size:2rem}.h3,h3{font-size:1.75rem}.h4,h4{font-size:1.5rem}.h5,h5{font-size:1.25rem}.h6,h6{font-size:1rem}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:6rem;font-weight:300;line-height:1.2}.display-2{font-size:5.5rem;font-weight:300;line-height:1.2}.display-3{font-size:4.5rem;font-weight:300;line-height:1.2}.display-4{font-size:3.5rem;font-weight:300;line-height:1.2}hr{margin-top:1rem;margin-bottom:1rem;border:0;border-top:1px solid rgba(0,0,0,.1)}.small,small{font-size:.875em;font-weight:400}.mark,mark{padding:.2em;background-color:#fcf8e3}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.initialism{font-size:90%;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote-footer{display:block;font-size:.875em;color:#6c757d}.blockquote-footer::before{content:"\2014\00A0"}.img-fluid{max-width:100%;height:auto}.img-thumbnail{padding:.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:.25rem;max-width:100%;height:auto}.figure{display:inline-block}.figure-img{margin-bottom:.5rem;line-height:1}.figure-caption{font-size:90%;color:#6c757d}code{font-size:87.5%;color:#e83e8c;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:87.5%;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:100%;font-weight:700}pre{display:block;font-size:87.5%;color:#212529}pre code{font-size:inherit;color:inherit;word-break:normal}.pre-scrollable{max-height:340px;overflow-y:scroll}.container,.container-fluid,.container-lg,.container-md,.container-sm,.container-xl{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}@media (min-width:576px){.container,.container-sm{max-width:540px}}@media (min-width:768px){.container,.container-md,.container-sm{max-width:720px}}@media (min-width:992px){.container,.container-lg,.container-md,.container-sm{max-width:960px}}@media (min-width:1200px){.container,.container-lg,.container-md,.container-sm,.container-xl{max-width:1140px}}.row{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-15px;margin-left:-15px}.no-gutters{margin-right:0;margin-left:0}.no-gutters>.col,.no-gutters>[class*=col-]{padding-right:0;padding-left:0}.col,.col-1,.col-10,.col-11,.col-12,.col-2,.col-3,.col-4,.col-5,.col-6,.col-7,.col-8,.col-9,.col-auto,.col-lg,.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-auto,.col-md,.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-auto,.col-sm,.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-auto,.col-xl,.col-xl-1,.col-xl-10,.col-xl-11,.col-xl-12,.col-xl-2,.col-xl-3,.col-xl-4,.col-xl-5,.col-xl-6,.col-xl-7,.col-xl-8,.col-xl-9,.col-xl-auto{position:relative;width:100%;padding-right:15px;padding-left:15px}.col{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.row-cols-1>*{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.row-cols-2>*{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.row-cols-3>*{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.row-cols-4>*{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.row-cols-5>*{-ms-flex:0 0 20%;flex:0 0 20%;max-width:20%}.row-cols-6>*{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-first{-ms-flex-order:-1;order:-1}.order-last{-ms-flex-order:13;order:13}.order-0{-ms-flex-order:0;order:0}.order-1{-ms-flex-order:1;order:1}.order-2{-ms-flex-order:2;order:2}.order-3{-ms-flex-order:3;order:3}.order-4{-ms-flex-order:4;order:4}.order-5{-ms-flex-order:5;order:5}.order-6{-ms-flex-order:6;order:6}.order-7{-ms-flex-order:7;order:7}.order-8{-ms-flex-order:8;order:8}.order-9{-ms-flex-order:9;order:9}.order-10{-ms-flex-order:10;order:10}.order-11{-ms-flex-order:11;order:11}.order-12{-ms-flex-order:12;order:12}.offset-1{margin-left:8.333333%}.offset-2{margin-left:16.666667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.333333%}.offset-5{margin-left:41.666667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.333333%}.offset-8{margin-left:66.666667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.333333%}.offset-11{margin-left:91.666667%}@media (min-width:576px){.col-sm{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.row-cols-sm-1>*{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.row-cols-sm-2>*{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.row-cols-sm-3>*{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.row-cols-sm-4>*{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.row-cols-sm-5>*{-ms-flex:0 0 20%;flex:0 0 20%;max-width:20%}.row-cols-sm-6>*{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-sm-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-sm-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-sm-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-sm-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-sm-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-sm-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-sm-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-sm-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-sm-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-sm-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-sm-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-sm-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-sm-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-sm-first{-ms-flex-order:-1;order:-1}.order-sm-last{-ms-flex-order:13;order:13}.order-sm-0{-ms-flex-order:0;order:0}.order-sm-1{-ms-flex-order:1;order:1}.order-sm-2{-ms-flex-order:2;order:2}.order-sm-3{-ms-flex-order:3;order:3}.order-sm-4{-ms-flex-order:4;order:4}.order-sm-5{-ms-flex-order:5;order:5}.order-sm-6{-ms-flex-order:6;order:6}.order-sm-7{-ms-flex-order:7;order:7}.order-sm-8{-ms-flex-order:8;order:8}.order-sm-9{-ms-flex-order:9;order:9}.order-sm-10{-ms-flex-order:10;order:10}.order-sm-11{-ms-flex-order:11;order:11}.order-sm-12{-ms-flex-order:12;order:12}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.333333%}.offset-sm-2{margin-left:16.666667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.333333%}.offset-sm-5{margin-left:41.666667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.333333%}.offset-sm-8{margin-left:66.666667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.333333%}.offset-sm-11{margin-left:91.666667%}}@media (min-width:768px){.col-md{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.row-cols-md-1>*{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.row-cols-md-2>*{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.row-cols-md-3>*{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.row-cols-md-4>*{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.row-cols-md-5>*{-ms-flex:0 0 20%;flex:0 0 20%;max-width:20%}.row-cols-md-6>*{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-md-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-md-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-md-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-md-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-md-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-md-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-md-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-md-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-md-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-md-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-md-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-md-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-md-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-md-first{-ms-flex-order:-1;order:-1}.order-md-last{-ms-flex-order:13;order:13}.order-md-0{-ms-flex-order:0;order:0}.order-md-1{-ms-flex-order:1;order:1}.order-md-2{-ms-flex-order:2;order:2}.order-md-3{-ms-flex-order:3;order:3}.order-md-4{-ms-flex-order:4;order:4}.order-md-5{-ms-flex-order:5;order:5}.order-md-6{-ms-flex-order:6;order:6}.order-md-7{-ms-flex-order:7;order:7}.order-md-8{-ms-flex-order:8;order:8}.order-md-9{-ms-flex-order:9;order:9}.order-md-10{-ms-flex-order:10;order:10}.order-md-11{-ms-flex-order:11;order:11}.order-md-12{-ms-flex-order:12;order:12}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.333333%}.offset-md-2{margin-left:16.666667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.333333%}.offset-md-5{margin-left:41.666667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.333333%}.offset-md-8{margin-left:66.666667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.333333%}.offset-md-11{margin-left:91.666667%}}@media (min-width:992px){.col-lg{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.row-cols-lg-1>*{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.row-cols-lg-2>*{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.row-cols-lg-3>*{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.row-cols-lg-4>*{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.row-cols-lg-5>*{-ms-flex:0 0 20%;flex:0 0 20%;max-width:20%}.row-cols-lg-6>*{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-lg-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-lg-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-lg-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-lg-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-lg-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-lg-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-lg-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-lg-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-lg-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-lg-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-lg-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-lg-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-lg-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-lg-first{-ms-flex-order:-1;order:-1}.order-lg-last{-ms-flex-order:13;order:13}.order-lg-0{-ms-flex-order:0;order:0}.order-lg-1{-ms-flex-order:1;order:1}.order-lg-2{-ms-flex-order:2;order:2}.order-lg-3{-ms-flex-order:3;order:3}.order-lg-4{-ms-flex-order:4;order:4}.order-lg-5{-ms-flex-order:5;order:5}.order-lg-6{-ms-flex-order:6;order:6}.order-lg-7{-ms-flex-order:7;order:7}.order-lg-8{-ms-flex-order:8;order:8}.order-lg-9{-ms-flex-order:9;order:9}.order-lg-10{-ms-flex-order:10;order:10}.order-lg-11{-ms-flex-order:11;order:11}.order-lg-12{-ms-flex-order:12;order:12}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.333333%}.offset-lg-2{margin-left:16.666667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.333333%}.offset-lg-5{margin-left:41.666667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.333333%}.offset-lg-8{margin-left:66.666667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.333333%}.offset-lg-11{margin-left:91.666667%}}@media (min-width:1200px){.col-xl{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.row-cols-xl-1>*{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.row-cols-xl-2>*{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.row-cols-xl-3>*{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.row-cols-xl-4>*{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.row-cols-xl-5>*{-ms-flex:0 0 20%;flex:0 0 20%;max-width:20%}.row-cols-xl-6>*{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-xl-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-xl-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-xl-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-xl-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-xl-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-xl-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-xl-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-xl-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-xl-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-xl-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-xl-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-xl-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-xl-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-xl-first{-ms-flex-order:-1;order:-1}.order-xl-last{-ms-flex-order:13;order:13}.order-xl-0{-ms-flex-order:0;order:0}.order-xl-1{-ms-flex-order:1;order:1}.order-xl-2{-ms-flex-order:2;order:2}.order-xl-3{-ms-flex-order:3;order:3}.order-xl-4{-ms-flex-order:4;order:4}.order-xl-5{-ms-flex-order:5;order:5}.order-xl-6{-ms-flex-order:6;order:6}.order-xl-7{-ms-flex-order:7;order:7}.order-xl-8{-ms-flex-order:8;order:8}.order-xl-9{-ms-flex-order:9;order:9}.order-xl-10{-ms-flex-order:10;order:10}.order-xl-11{-ms-flex-order:11;order:11}.order-xl-12{-ms-flex-order:12;order:12}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.333333%}.offset-xl-2{margin-left:16.666667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.333333%}.offset-xl-5{margin-left:41.666667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.333333%}.offset-xl-8{margin-left:66.666667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.333333%}.offset-xl-11{margin-left:91.666667%}}.table{width:100%;margin-bottom:1rem;color:#212529}.table td,.table th{padding:.75rem;vertical-align:top;border-top:1px solid #dee2e6}.table thead th{vertical-align:bottom;border-bottom:2px solid #dee2e6}.table tbody+tbody{border-top:2px solid #dee2e6}.table-sm td,.table-sm th{padding:.3rem}.table-bordered{border:1px solid #dee2e6}.table-bordered td,.table-bordered th{border:1px solid #dee2e6}.table-bordered thead td,.table-bordered thead th{border-bottom-width:2px}.table-borderless tbody+tbody,.table-borderless td,.table-borderless th,.table-borderless thead th{border:0}.table-striped tbody tr:nth-of-type(odd){background-color:rgba(0,0,0,.05)}.table-hover tbody tr:hover{color:#212529;background-color:rgba(0,0,0,.075)}.table-primary,.table-primary>td,.table-primary>th{background-color:#b8daff}.table-primary tbody+tbody,.table-primary td,.table-primary th,.table-primary thead th{border-color:#7abaff}.table-hover .table-primary:hover{background-color:#9fcdff}.table-hover .table-primary:hover>td,.table-hover .table-primary:hover>th{background-color:#9fcdff}.table-secondary,.table-secondary>td,.table-secondary>th{background-color:#d6d8db}.table-secondary tbody+tbody,.table-secondary td,.table-secondary th,.table-secondary thead th{border-color:#b3b7bb}.table-hover .table-secondary:hover{background-color:#c8cbcf}.table-hover .table-secondary:hover>td,.table-hover .table-secondary:hover>th{background-color:#c8cbcf}.table-success,.table-success>td,.table-success>th{background-color:#c3e6cb}.table-success tbody+tbody,.table-success td,.table-success th,.table-success thead th{border-color:#8fd19e}.table-hover .table-success:hover{background-color:#b1dfbb}.table-hover .table-success:hover>td,.table-hover .table-success:hover>th{background-color:#b1dfbb}.table-info,.table-info>td,.table-info>th{background-color:#bee5eb}.table-info tbody+tbody,.table-info td,.table-info th,.table-info thead th{border-color:#86cfda}.table-hover .table-info:hover{background-color:#abdde5}.table-hover .table-info:hover>td,.table-hover .table-info:hover>th{background-color:#abdde5}.table-warning,.table-warning>td,.table-warning>th{background-color:#ffeeba}.table-warning tbody+tbody,.table-warning td,.table-warning th,.table-warning thead th{border-color:#ffdf7e}.table-hover .table-warning:hover{background-color:#ffe8a1}.table-hover .table-warning:hover>td,.table-hover .table-warning:hover>th{background-color:#ffe8a1}.table-danger,.table-danger>td,.table-danger>th{background-color:#f5c6cb}.table-danger tbody+tbody,.table-danger td,.table-danger th,.table-danger thead th{border-color:#ed969e}.table-hover .table-danger:hover{background-color:#f1b0b7}.table-hover .table-danger:hover>td,.table-hover .table-danger:hover>th{background-color:#f1b0b7}.table-light,.table-light>td,.table-light>th{background-color:#fdfdfe}.table-light tbody+tbody,.table-light td,.table-light th,.table-light thead th{border-color:#fbfcfc}.table-hover .table-light:hover{background-color:#ececf6}.table-hover .table-light:hover>td,.table-hover .table-light:hover>th{background-color:#ececf6}.table-dark,.table-dark>td,.table-dark>th{background-color:#c6c8ca}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#95999c}.table-hover .table-dark:hover{background-color:#b9bbbe}.table-hover .table-dark:hover>td,.table-hover .table-dark:hover>th{background-color:#b9bbbe}.table-active,.table-active>td,.table-active>th{background-color:rgba(0,0,0,.075)}.table-hover .table-active:hover{background-color:rgba(0,0,0,.075)}.table-hover .table-active:hover>td,.table-hover .table-active:hover>th{background-color:rgba(0,0,0,.075)}.table .thead-dark th{color:#fff;background-color:#343a40;border-color:#454d55}.table .thead-light th{color:#495057;background-color:#e9ecef;border-color:#dee2e6}.table-dark{color:#fff;background-color:#343a40}.table-dark td,.table-dark th,.table-dark thead th{border-color:#454d55}.table-dark.table-bordered{border:0}.table-dark.table-striped tbody tr:nth-of-type(odd){background-color:rgba(255,255,255,.05)}.table-dark.table-hover tbody tr:hover{color:#fff;background-color:rgba(255,255,255,.075)}@media (max-width:575.98px){.table-responsive-sm{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-sm>.table-bordered{border:0}}@media (max-width:767.98px){.table-responsive-md{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-md>.table-bordered{border:0}}@media (max-width:991.98px){.table-responsive-lg{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-lg>.table-bordered{border:0}}@media (max-width:1199.98px){.table-responsive-xl{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-xl>.table-bordered{border:0}}.table-responsive{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive>.table-bordered{border:0}.form-control{display:block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control{transition:none}}.form-control::-ms-expand{background-color:transparent;border:0}.form-control:focus{color:#495057;background-color:#fff;border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.form-control::-webkit-input-placeholder{color:#6c757d;opacity:1}.form-control::-moz-placeholder{color:#6c757d;opacity:1}.form-control:-ms-input-placeholder{color:#6c757d;opacity:1}.form-control::-ms-input-placeholder{color:#6c757d;opacity:1}.form-control::placeholder{color:#6c757d;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}input[type=date].form-control,input[type=datetime-local].form-control,input[type=month].form-control,input[type=time].form-control{-webkit-appearance:none;-moz-appearance:none;appearance:none}select.form-control:-moz-focusring{color:transparent;text-shadow:0 0 0 #495057}select.form-control:focus::-ms-value{color:#495057;background-color:#fff}.form-control-file,.form-control-range{display:block;width:100%}.col-form-label{padding-top:calc(.375rem + 1px);padding-bottom:calc(.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(.5rem + 1px);padding-bottom:calc(.5rem + 1px);font-size:1.25rem;line-height:1.5}.col-form-label-sm{padding-top:calc(.25rem + 1px);padding-bottom:calc(.25rem + 1px);font-size:.875rem;line-height:1.5}.form-control-plaintext{display:block;width:100%;padding:.375rem 0;margin-bottom:0;font-size:1rem;line-height:1.5;color:#212529;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-lg,.form-control-plaintext.form-control-sm{padding-right:0;padding-left:0}.form-control-sm{height:calc(1.5em + .5rem + 2px);padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.form-control-lg{height:calc(1.5em + 1rem + 2px);padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}select.form-control[multiple],select.form-control[size]{height:auto}textarea.form-control{height:auto}.form-group{margin-bottom:1rem}.form-text{display:block;margin-top:.25rem}.form-row{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-5px;margin-left:-5px}.form-row>.col,.form-row>[class*=col-]{padding-right:5px;padding-left:5px}.form-check{position:relative;display:block;padding-left:1.25rem}.form-check-input{position:absolute;margin-top:.3rem;margin-left:-1.25rem}.form-check-input:disabled~.form-check-label,.form-check-input[disabled]~.form-check-label{color:#6c757d}.form-check-label{margin-bottom:0}.form-check-inline{display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;padding-left:0;margin-right:.75rem}.form-check-inline .form-check-input{position:static;margin-top:0;margin-right:.3125rem;margin-left:0}.valid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#28a745}.valid-tooltip{position:absolute;top:100%;left:0;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(40,167,69,.9);border-radius:.25rem}.form-row>.col>.valid-tooltip,.form-row>[class*=col-]>.valid-tooltip{left:5px}.is-valid~.valid-feedback,.is-valid~.valid-tooltip,.was-validated :valid~.valid-feedback,.was-validated :valid~.valid-tooltip{display:block}.form-control.is-valid,.was-validated .form-control:valid{border-color:#28a745;padding-right:calc(1.5em + .75rem)!important;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-valid:focus,.was-validated .form-control:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.was-validated select.form-control:valid,select.form-control.is-valid{padding-right:3rem!important;background-position:right 1.5rem center}.was-validated textarea.form-control:valid,textarea.form-control.is-valid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-valid,.was-validated .custom-select:valid{border-color:#28a745;padding-right:calc(.75em + 2.3125rem)!important;background:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") right .75rem center/8px 10px no-repeat,#fff url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e") center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem) no-repeat}.custom-select.is-valid:focus,.was-validated .custom-select:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.form-check-input.is-valid~.form-check-label,.was-validated .form-check-input:valid~.form-check-label{color:#28a745}.form-check-input.is-valid~.valid-feedback,.form-check-input.is-valid~.valid-tooltip,.was-validated .form-check-input:valid~.valid-feedback,.was-validated .form-check-input:valid~.valid-tooltip{display:block}.custom-control-input.is-valid~.custom-control-label,.was-validated .custom-control-input:valid~.custom-control-label{color:#28a745}.custom-control-input.is-valid~.custom-control-label::before,.was-validated .custom-control-input:valid~.custom-control-label::before{border-color:#28a745}.custom-control-input.is-valid:checked~.custom-control-label::before,.was-validated .custom-control-input:valid:checked~.custom-control-label::before{border-color:#34ce57;background-color:#34ce57}.custom-control-input.is-valid:focus~.custom-control-label::before,.was-validated .custom-control-input:valid:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.custom-control-input.is-valid:focus:not(:checked)~.custom-control-label::before,.was-validated .custom-control-input:valid:focus:not(:checked)~.custom-control-label::before{border-color:#28a745}.custom-file-input.is-valid~.custom-file-label,.was-validated .custom-file-input:valid~.custom-file-label{border-color:#28a745}.custom-file-input.is-valid:focus~.custom-file-label,.was-validated .custom-file-input:valid:focus~.custom-file-label{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.invalid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#dc3545}.invalid-tooltip{position:absolute;top:100%;left:0;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(220,53,69,.9);border-radius:.25rem}.form-row>.col>.invalid-tooltip,.form-row>[class*=col-]>.invalid-tooltip{left:5px}.is-invalid~.invalid-feedback,.is-invalid~.invalid-tooltip,.was-validated :invalid~.invalid-feedback,.was-validated :invalid~.invalid-tooltip{display:block}.form-control.is-invalid,.was-validated .form-control:invalid{border-color:#dc3545;padding-right:calc(1.5em + .75rem)!important;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' fill='none' stroke='%23dc3545' viewBox='0 0 12 12'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-invalid:focus,.was-validated .form-control:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.was-validated select.form-control:invalid,select.form-control.is-invalid{padding-right:3rem!important;background-position:right 1.5rem center}.was-validated textarea.form-control:invalid,textarea.form-control.is-invalid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-invalid,.was-validated .custom-select:invalid{border-color:#dc3545;padding-right:calc(.75em + 2.3125rem)!important;background:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") right .75rem center/8px 10px no-repeat,#fff url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' fill='none' stroke='%23dc3545' viewBox='0 0 12 12'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e") center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem) no-repeat}.custom-select.is-invalid:focus,.was-validated .custom-select:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-check-input.is-invalid~.form-check-label,.was-validated .form-check-input:invalid~.form-check-label{color:#dc3545}.form-check-input.is-invalid~.invalid-feedback,.form-check-input.is-invalid~.invalid-tooltip,.was-validated .form-check-input:invalid~.invalid-feedback,.was-validated .form-check-input:invalid~.invalid-tooltip{display:block}.custom-control-input.is-invalid~.custom-control-label,.was-validated .custom-control-input:invalid~.custom-control-label{color:#dc3545}.custom-control-input.is-invalid~.custom-control-label::before,.was-validated .custom-control-input:invalid~.custom-control-label::before{border-color:#dc3545}.custom-control-input.is-invalid:checked~.custom-control-label::before,.was-validated .custom-control-input:invalid:checked~.custom-control-label::before{border-color:#e4606d;background-color:#e4606d}.custom-control-input.is-invalid:focus~.custom-control-label::before,.was-validated .custom-control-input:invalid:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.custom-control-input.is-invalid:focus:not(:checked)~.custom-control-label::before,.was-validated .custom-control-input:invalid:focus:not(:checked)~.custom-control-label::before{border-color:#dc3545}.custom-file-input.is-invalid~.custom-file-label,.was-validated .custom-file-input:invalid~.custom-file-label{border-color:#dc3545}.custom-file-input.is-invalid:focus~.custom-file-label,.was-validated .custom-file-input:invalid:focus~.custom-file-label{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-inline{display:-ms-flexbox;display:flex;-ms-flex-flow:row wrap;flex-flow:row wrap;-ms-flex-align:center;align-items:center}.form-inline .form-check{width:100%}@media (min-width:576px){.form-inline label{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;margin-bottom:0}.form-inline .form-group{display:-ms-flexbox;display:flex;-ms-flex:0 0 auto;flex:0 0 auto;-ms-flex-flow:row wrap;flex-flow:row wrap;-ms-flex-align:center;align-items:center;margin-bottom:0}.form-inline .form-control{display:inline-block;width:auto;vertical-align:middle}.form-inline .form-control-plaintext{display:inline-block}.form-inline .custom-select,.form-inline .input-group{width:auto}.form-inline .form-check{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;width:auto;padding-left:0}.form-inline .form-check-input{position:relative;-ms-flex-negative:0;flex-shrink:0;margin-top:0;margin-right:.25rem;margin-left:0}.form-inline .custom-control{-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center}.form-inline .custom-control-label{margin-bottom:0}}.btn{display:inline-block;font-weight:400;color:#212529;text-align:center;vertical-align:middle;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;background-color:transparent;border:1px solid transparent;padding:.375rem .75rem;font-size:1rem;line-height:1.5;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.btn{transition:none}}.btn:hover{color:#212529;text-decoration:none}.btn.focus,.btn:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.btn.disabled,.btn:disabled{opacity:.65}.btn:not(:disabled):not(.disabled){cursor:pointer}a.btn.disabled,fieldset:disabled a.btn{pointer-events:none}.btn-primary{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary:hover{color:#fff;background-color:#0069d9;border-color:#0062cc}.btn-primary.focus,.btn-primary:focus{color:#fff;background-color:#0069d9;border-color:#0062cc;box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary:not(:disabled):not(.disabled).active,.btn-primary:not(:disabled):not(.disabled):active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#0062cc;border-color:#005cbf}.btn-primary:not(:disabled):not(.disabled).active:focus,.btn-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-secondary{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:hover{color:#fff;background-color:#5a6268;border-color:#545b62}.btn-secondary.focus,.btn-secondary:focus{color:#fff;background-color:#5a6268;border-color:#545b62;box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:not(:disabled):not(.disabled).active,.btn-secondary:not(:disabled):not(.disabled):active,.show>.btn-secondary.dropdown-toggle{color:#fff;background-color:#545b62;border-color:#4e555b}.btn-secondary:not(:disabled):not(.disabled).active:focus,.btn-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-success{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success:hover{color:#fff;background-color:#218838;border-color:#1e7e34}.btn-success.focus,.btn-success:focus{color:#fff;background-color:#218838;border-color:#1e7e34;box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success:not(:disabled):not(.disabled).active,.btn-success:not(:disabled):not(.disabled):active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#1e7e34;border-color:#1c7430}.btn-success:not(:disabled):not(.disabled).active:focus,.btn-success:not(:disabled):not(.disabled):active:focus,.show>.btn-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-info{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info:hover{color:#fff;background-color:#138496;border-color:#117a8b}.btn-info.focus,.btn-info:focus{color:#fff;background-color:#138496;border-color:#117a8b;box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-info.disabled,.btn-info:disabled{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info:not(:disabled):not(.disabled).active,.btn-info:not(:disabled):not(.disabled):active,.show>.btn-info.dropdown-toggle{color:#fff;background-color:#117a8b;border-color:#10707f}.btn-info:not(:disabled):not(.disabled).active:focus,.btn-info:not(:disabled):not(.disabled):active:focus,.show>.btn-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-warning{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning:hover{color:#212529;background-color:#e0a800;border-color:#d39e00}.btn-warning.focus,.btn-warning:focus{color:#212529;background-color:#e0a800;border-color:#d39e00;box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-warning.disabled,.btn-warning:disabled{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning:not(:disabled):not(.disabled).active,.btn-warning:not(:disabled):not(.disabled):active,.show>.btn-warning.dropdown-toggle{color:#212529;background-color:#d39e00;border-color:#c69500}.btn-warning:not(:disabled):not(.disabled).active:focus,.btn-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-danger{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:hover{color:#fff;background-color:#c82333;border-color:#bd2130}.btn-danger.focus,.btn-danger:focus{color:#fff;background-color:#c82333;border-color:#bd2130;box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:not(:disabled):not(.disabled).active,.btn-danger:not(:disabled):not(.disabled):active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#bd2130;border-color:#b21f2d}.btn-danger:not(:disabled):not(.disabled).active:focus,.btn-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-light{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:hover{color:#212529;background-color:#e2e6ea;border-color:#dae0e5}.btn-light.focus,.btn-light:focus{color:#212529;background-color:#e2e6ea;border-color:#dae0e5;box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-light.disabled,.btn-light:disabled{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:not(:disabled):not(.disabled).active,.btn-light:not(:disabled):not(.disabled):active,.show>.btn-light.dropdown-toggle{color:#212529;background-color:#dae0e5;border-color:#d3d9df}.btn-light:not(:disabled):not(.disabled).active:focus,.btn-light:not(:disabled):not(.disabled):active:focus,.show>.btn-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-dark{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:hover{color:#fff;background-color:#23272b;border-color:#1d2124}.btn-dark.focus,.btn-dark:focus{color:#fff;background-color:#23272b;border-color:#1d2124;box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:not(:disabled):not(.disabled).active,.btn-dark:not(:disabled):not(.disabled):active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1d2124;border-color:#171a1d}.btn-dark:not(:disabled):not(.disabled).active:focus,.btn-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-outline-primary{color:#007bff;border-color:#007bff}.btn-outline-primary:hover{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary.focus,.btn-outline-primary:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#007bff;background-color:transparent}.btn-outline-primary:not(:disabled):not(.disabled).active,.btn-outline-primary:not(:disabled):not(.disabled):active,.show>.btn-outline-primary.dropdown-toggle{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary:not(:disabled):not(.disabled).active:focus,.btn-outline-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-secondary{color:#6c757d;border-color:#6c757d}.btn-outline-secondary:hover{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary.focus,.btn-outline-secondary:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#6c757d;background-color:transparent}.btn-outline-secondary:not(:disabled):not(.disabled).active,.btn-outline-secondary:not(:disabled):not(.disabled):active,.show>.btn-outline-secondary.dropdown-toggle{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary:not(:disabled):not(.disabled).active:focus,.btn-outline-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-success{color:#28a745;border-color:#28a745}.btn-outline-success:hover{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success.focus,.btn-outline-success:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#28a745;background-color:transparent}.btn-outline-success:not(:disabled):not(.disabled).active,.btn-outline-success:not(:disabled):not(.disabled):active,.show>.btn-outline-success.dropdown-toggle{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success:not(:disabled):not(.disabled).active:focus,.btn-outline-success:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-info{color:#17a2b8;border-color:#17a2b8}.btn-outline-info:hover{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info.focus,.btn-outline-info:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#17a2b8;background-color:transparent}.btn-outline-info:not(:disabled):not(.disabled).active,.btn-outline-info:not(:disabled):not(.disabled):active,.show>.btn-outline-info.dropdown-toggle{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info:not(:disabled):not(.disabled).active:focus,.btn-outline-info:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-warning{color:#ffc107;border-color:#ffc107}.btn-outline-warning:hover{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning.focus,.btn-outline-warning:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#ffc107;background-color:transparent}.btn-outline-warning:not(:disabled):not(.disabled).active,.btn-outline-warning:not(:disabled):not(.disabled):active,.show>.btn-outline-warning.dropdown-toggle{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning:not(:disabled):not(.disabled).active:focus,.btn-outline-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-danger{color:#dc3545;border-color:#dc3545}.btn-outline-danger:hover{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger.focus,.btn-outline-danger:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#dc3545;background-color:transparent}.btn-outline-danger:not(:disabled):not(.disabled).active,.btn-outline-danger:not(:disabled):not(.disabled):active,.show>.btn-outline-danger.dropdown-toggle{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger:not(:disabled):not(.disabled).active:focus,.btn-outline-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-light{color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:hover{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light.focus,.btn-outline-light:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-light:not(:disabled):not(.disabled).active,.btn-outline-light:not(:disabled):not(.disabled):active,.show>.btn-outline-light.dropdown-toggle{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:not(:disabled):not(.disabled).active:focus,.btn-outline-light:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-dark{color:#343a40;border-color:#343a40}.btn-outline-dark:hover{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark.focus,.btn-outline-dark:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#343a40;background-color:transparent}.btn-outline-dark:not(:disabled):not(.disabled).active,.btn-outline-dark:not(:disabled):not(.disabled):active,.show>.btn-outline-dark.dropdown-toggle{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark:not(:disabled):not(.disabled).active:focus,.btn-outline-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-link{font-weight:400;color:#007bff;text-decoration:none}.btn-link:hover{color:#0056b3;text-decoration:underline}.btn-link.focus,.btn-link:focus{text-decoration:underline}.btn-link.disabled,.btn-link:disabled{color:#6c757d;pointer-events:none}.btn-group-lg>.btn,.btn-lg{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.btn-group-sm>.btn,.btn-sm{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.btn-block{display:block;width:100%}.btn-block+.btn-block{margin-top:.5rem}input[type=button].btn-block,input[type=reset].btn-block,input[type=submit].btn-block{width:100%}.fade{transition:opacity .15s linear}@media (prefers-reduced-motion:reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{position:relative;height:0;overflow:hidden;transition:height .35s ease}@media (prefers-reduced-motion:reduce){.collapsing{transition:none}}.collapsing.width{width:0;height:auto;transition:width .35s ease}@media (prefers-reduced-motion:reduce){.collapsing.width{transition:none}}.dropdown,.dropleft,.dropright,.dropup{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:10rem;padding:.5rem 0;margin:.125rem 0 0;font-size:1rem;color:#212529;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.15);border-radius:.25rem}.dropdown-menu-left{right:auto;left:0}.dropdown-menu-right{right:0;left:auto}@media (min-width:576px){.dropdown-menu-sm-left{right:auto;left:0}.dropdown-menu-sm-right{right:0;left:auto}}@media (min-width:768px){.dropdown-menu-md-left{right:auto;left:0}.dropdown-menu-md-right{right:0;left:auto}}@media (min-width:992px){.dropdown-menu-lg-left{right:auto;left:0}.dropdown-menu-lg-right{right:0;left:auto}}@media (min-width:1200px){.dropdown-menu-xl-left{right:auto;left:0}.dropdown-menu-xl-right{right:0;left:auto}}.dropup .dropdown-menu{top:auto;bottom:100%;margin-top:0;margin-bottom:.125rem}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-menu{top:0;right:auto;left:100%;margin-top:0;margin-left:.125rem}.dropright .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropright .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-toggle::after{vertical-align:0}.dropleft .dropdown-menu{top:0;right:100%;left:auto;margin-top:0;margin-right:.125rem}.dropleft .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropleft .dropdown-toggle::after{display:none}.dropleft .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropleft .dropdown-toggle:empty::after{margin-left:0}.dropleft .dropdown-toggle::before{vertical-align:0}.dropdown-menu[x-placement^=bottom],.dropdown-menu[x-placement^=left],.dropdown-menu[x-placement^=right],.dropdown-menu[x-placement^=top]{right:auto;bottom:auto}.dropdown-divider{height:0;margin:.5rem 0;overflow:hidden;border-top:1px solid #e9ecef}.dropdown-item{display:block;width:100%;padding:.25rem 1.5rem;clear:both;font-weight:400;color:#212529;text-align:inherit;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:focus,.dropdown-item:hover{color:#16181b;text-decoration:none;background-color:#e9ecef}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#007bff}.dropdown-item.disabled,.dropdown-item:disabled{color:#adb5bd;pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:.5rem 1.5rem;margin-bottom:0;font-size:.875rem;color:#6c757d;white-space:nowrap}.dropdown-item-text{display:block;padding:.25rem 1.5rem;color:#212529}.btn-group,.btn-group-vertical{position:relative;display:-ms-inline-flexbox;display:inline-flex;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;-ms-flex:1 1 auto;flex:1 1 auto}.btn-group-vertical>.btn:hover,.btn-group>.btn:hover{z-index:1}.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus{z-index:1}.btn-toolbar{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-pack:start;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn-group:not(:first-child),.btn-group>.btn:not(:first-child){margin-left:-1px}.btn-group>.btn-group:not(:last-child)>.btn,.btn-group>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:not(:first-child)>.btn,.btn-group>.btn:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:.5625rem;padding-left:.5625rem}.dropdown-toggle-split::after,.dropright .dropdown-toggle-split::after,.dropup .dropdown-toggle-split::after{margin-left:0}.dropleft .dropdown-toggle-split::before{margin-right:0}.btn-group-sm>.btn+.dropdown-toggle-split,.btn-sm+.dropdown-toggle-split{padding-right:.375rem;padding-left:.375rem}.btn-group-lg>.btn+.dropdown-toggle-split,.btn-lg+.dropdown-toggle-split{padding-right:.75rem;padding-left:.75rem}.btn-group-vertical{-ms-flex-direction:column;flex-direction:column;-ms-flex-align:start;align-items:flex-start;-ms-flex-pack:center;justify-content:center}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{width:100%}.btn-group-vertical>.btn-group:not(:first-child),.btn-group-vertical>.btn:not(:first-child){margin-top:-1px}.btn-group-vertical>.btn-group:not(:last-child)>.btn,.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child)>.btn,.btn-group-vertical>.btn:not(:first-child){border-top-left-radius:0;border-top-right-radius:0}.btn-group-toggle>.btn,.btn-group-toggle>.btn-group>.btn{margin-bottom:0}.btn-group-toggle>.btn input[type=checkbox],.btn-group-toggle>.btn input[type=radio],.btn-group-toggle>.btn-group>.btn input[type=checkbox],.btn-group-toggle>.btn-group>.btn input[type=radio]{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.input-group{position:relative;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:stretch;align-items:stretch;width:100%}.input-group>.custom-file,.input-group>.custom-select,.input-group>.form-control,.input-group>.form-control-plaintext{position:relative;-ms-flex:1 1 auto;flex:1 1 auto;width:1%;min-width:0;margin-bottom:0}.input-group>.custom-file+.custom-file,.input-group>.custom-file+.custom-select,.input-group>.custom-file+.form-control,.input-group>.custom-select+.custom-file,.input-group>.custom-select+.custom-select,.input-group>.custom-select+.form-control,.input-group>.form-control+.custom-file,.input-group>.form-control+.custom-select,.input-group>.form-control+.form-control,.input-group>.form-control-plaintext+.custom-file,.input-group>.form-control-plaintext+.custom-select,.input-group>.form-control-plaintext+.form-control{margin-left:-1px}.input-group>.custom-file .custom-file-input:focus~.custom-file-label,.input-group>.custom-select:focus,.input-group>.form-control:focus{z-index:3}.input-group>.custom-file .custom-file-input:focus{z-index:4}.input-group>.custom-select:not(:first-child),.input-group>.form-control:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.input-group>.custom-file{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center}.input-group>.custom-file:not(:last-child) .custom-file-label,.input-group>.custom-file:not(:last-child) .custom-file-label::after{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-file:not(:first-child) .custom-file-label{border-top-left-radius:0;border-bottom-left-radius:0}.input-group:not(.has-validation)>.custom-file:not(:last-child) .custom-file-label,.input-group:not(.has-validation)>.custom-file:not(:last-child) .custom-file-label::after,.input-group:not(.has-validation)>.custom-select:not(:last-child),.input-group:not(.has-validation)>.form-control:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.input-group.has-validation>.custom-file:nth-last-child(n+3) .custom-file-label,.input-group.has-validation>.custom-file:nth-last-child(n+3) .custom-file-label::after,.input-group.has-validation>.custom-select:nth-last-child(n+3),.input-group.has-validation>.form-control:nth-last-child(n+3){border-top-right-radius:0;border-bottom-right-radius:0}.input-group-append,.input-group-prepend{display:-ms-flexbox;display:flex}.input-group-append .btn,.input-group-prepend .btn{position:relative;z-index:2}.input-group-append .btn:focus,.input-group-prepend .btn:focus{z-index:3}.input-group-append .btn+.btn,.input-group-append .btn+.input-group-text,.input-group-append .input-group-text+.btn,.input-group-append .input-group-text+.input-group-text,.input-group-prepend .btn+.btn,.input-group-prepend .btn+.input-group-text,.input-group-prepend .input-group-text+.btn,.input-group-prepend .input-group-text+.input-group-text{margin-left:-1px}.input-group-prepend{margin-right:-1px}.input-group-append{margin-left:-1px}.input-group-text{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;padding:.375rem .75rem;margin-bottom:0;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:.25rem}.input-group-text input[type=checkbox],.input-group-text input[type=radio]{margin-top:0}.input-group-lg>.custom-select,.input-group-lg>.form-control:not(textarea){height:calc(1.5em + 1rem + 2px)}.input-group-lg>.custom-select,.input-group-lg>.form-control,.input-group-lg>.input-group-append>.btn,.input-group-lg>.input-group-append>.input-group-text,.input-group-lg>.input-group-prepend>.btn,.input-group-lg>.input-group-prepend>.input-group-text{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.input-group-sm>.custom-select,.input-group-sm>.form-control:not(textarea){height:calc(1.5em + .5rem + 2px)}.input-group-sm>.custom-select,.input-group-sm>.form-control,.input-group-sm>.input-group-append>.btn,.input-group-sm>.input-group-append>.input-group-text,.input-group-sm>.input-group-prepend>.btn,.input-group-sm>.input-group-prepend>.input-group-text{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.input-group-lg>.custom-select,.input-group-sm>.custom-select{padding-right:1.75rem}.input-group.has-validation>.input-group-append:nth-last-child(n+3)>.btn,.input-group.has-validation>.input-group-append:nth-last-child(n+3)>.input-group-text,.input-group:not(.has-validation)>.input-group-append:not(:last-child)>.btn,.input-group:not(.has-validation)>.input-group-append:not(:last-child)>.input-group-text,.input-group>.input-group-append:last-child>.btn:not(:last-child):not(.dropdown-toggle),.input-group>.input-group-append:last-child>.input-group-text:not(:last-child),.input-group>.input-group-prepend>.btn,.input-group>.input-group-prepend>.input-group-text{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.input-group-append>.btn,.input-group>.input-group-append>.input-group-text,.input-group>.input-group-prepend:first-child>.btn:not(:first-child),.input-group>.input-group-prepend:first-child>.input-group-text:not(:first-child),.input-group>.input-group-prepend:not(:first-child)>.btn,.input-group>.input-group-prepend:not(:first-child)>.input-group-text{border-top-left-radius:0;border-bottom-left-radius:0}.custom-control{position:relative;z-index:1;display:block;min-height:1.5rem;padding-left:1.5rem;-webkit-print-color-adjust:exact;color-adjust:exact;print-color-adjust:exact}.custom-control-inline{display:-ms-inline-flexbox;display:inline-flex;margin-right:1rem}.custom-control-input{position:absolute;left:0;z-index:-1;width:1rem;height:1.25rem;opacity:0}.custom-control-input:checked~.custom-control-label::before{color:#fff;border-color:#007bff;background-color:#007bff}.custom-control-input:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-control-input:focus:not(:checked)~.custom-control-label::before{border-color:#80bdff}.custom-control-input:not(:disabled):active~.custom-control-label::before{color:#fff;background-color:#b3d7ff;border-color:#b3d7ff}.custom-control-input:disabled~.custom-control-label,.custom-control-input[disabled]~.custom-control-label{color:#6c757d}.custom-control-input:disabled~.custom-control-label::before,.custom-control-input[disabled]~.custom-control-label::before{background-color:#e9ecef}.custom-control-label{position:relative;margin-bottom:0;vertical-align:top}.custom-control-label::before{position:absolute;top:.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;pointer-events:none;content:"";background-color:#fff;border:1px solid #adb5bd}.custom-control-label::after{position:absolute;top:.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;content:"";background:50%/50% 50% no-repeat}.custom-checkbox .custom-control-label::before{border-radius:.25rem}.custom-checkbox .custom-control-input:checked~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8' viewBox='0 0 8 8'%3e%3cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26l2.974 2.99L8 2.193z'/%3e%3c/svg%3e")}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label::before{border-color:#007bff;background-color:#007bff}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='4' height='4' viewBox='0 0 4 4'%3e%3cpath stroke='%23fff' d='M0 2h4'/%3e%3c/svg%3e")}.custom-checkbox .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-checkbox .custom-control-input:disabled:indeterminate~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-radio .custom-control-label::before{border-radius:50%}.custom-radio .custom-control-input:checked~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e")}.custom-radio .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-switch{padding-left:2.25rem}.custom-switch .custom-control-label::before{left:-2.25rem;width:1.75rem;pointer-events:all;border-radius:.5rem}.custom-switch .custom-control-label::after{top:calc(.25rem + 2px);left:calc(-2.25rem + 2px);width:calc(1rem - 4px);height:calc(1rem - 4px);background-color:#adb5bd;border-radius:.5rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,-webkit-transform .15s ease-in-out;transition:transform .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:transform .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,-webkit-transform .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-switch .custom-control-label::after{transition:none}}.custom-switch .custom-control-input:checked~.custom-control-label::after{background-color:#fff;-webkit-transform:translateX(.75rem);transform:translateX(.75rem)}.custom-switch .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-select{display:inline-block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem 1.75rem .375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;vertical-align:middle;background:#fff url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") right .75rem center/8px 10px no-repeat;border:1px solid #ced4da;border-radius:.25rem;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-select:focus{border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-select:focus::-ms-value{color:#495057;background-color:#fff}.custom-select[multiple],.custom-select[size]:not([size="1"]){height:auto;padding-right:.75rem;background-image:none}.custom-select:disabled{color:#6c757d;background-color:#e9ecef}.custom-select::-ms-expand{display:none}.custom-select:-moz-focusring{color:transparent;text-shadow:0 0 0 #495057}.custom-select-sm{height:calc(1.5em + .5rem + 2px);padding-top:.25rem;padding-bottom:.25rem;padding-left:.5rem;font-size:.875rem}.custom-select-lg{height:calc(1.5em + 1rem + 2px);padding-top:.5rem;padding-bottom:.5rem;padding-left:1rem;font-size:1.25rem}.custom-file{position:relative;display:inline-block;width:100%;height:calc(1.5em + .75rem + 2px);margin-bottom:0}.custom-file-input{position:relative;z-index:2;width:100%;height:calc(1.5em + .75rem + 2px);margin:0;overflow:hidden;opacity:0}.custom-file-input:focus~.custom-file-label{border-color:#80bdff;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-file-input:disabled~.custom-file-label,.custom-file-input[disabled]~.custom-file-label{background-color:#e9ecef}.custom-file-input:lang(en)~.custom-file-label::after{content:"Browse"}.custom-file-input~.custom-file-label[data-browse]::after{content:attr(data-browse)}.custom-file-label{position:absolute;top:0;right:0;left:0;z-index:1;height:calc(1.5em + .75rem + 2px);padding:.375rem .75rem;overflow:hidden;font-weight:400;line-height:1.5;color:#495057;background-color:#fff;border:1px solid #ced4da;border-radius:.25rem}.custom-file-label::after{position:absolute;top:0;right:0;bottom:0;z-index:3;display:block;height:calc(1.5em + .75rem);padding:.375rem .75rem;line-height:1.5;color:#495057;content:"Browse";background-color:#e9ecef;border-left:inherit;border-radius:0 .25rem .25rem 0}.custom-range{width:100%;height:1.4rem;padding:0;background-color:transparent;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-range:focus{outline:0}.custom-range:focus::-webkit-slider-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-ms-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range::-moz-focus-outer{border:0}.custom-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-.25rem;background-color:#007bff;border:0;border-radius:1rem;-webkit-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-webkit-slider-thumb{-webkit-transition:none;transition:none}}.custom-range::-webkit-slider-thumb:active{background-color:#b3d7ff}.custom-range::-webkit-slider-runnable-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#007bff;border:0;border-radius:1rem;-moz-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-moz-range-thumb{-moz-transition:none;transition:none}}.custom-range::-moz-range-thumb:active{background-color:#b3d7ff}.custom-range::-moz-range-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-ms-thumb{width:1rem;height:1rem;margin-top:0;margin-right:.2rem;margin-left:.2rem;background-color:#007bff;border:0;border-radius:1rem;-ms-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-ms-thumb{-ms-transition:none;transition:none}}.custom-range::-ms-thumb:active{background-color:#b3d7ff}.custom-range::-ms-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:transparent;border-color:transparent;border-width:.5rem}.custom-range::-ms-fill-lower{background-color:#dee2e6;border-radius:1rem}.custom-range::-ms-fill-upper{margin-right:15px;background-color:#dee2e6;border-radius:1rem}.custom-range:disabled::-webkit-slider-thumb{background-color:#adb5bd}.custom-range:disabled::-webkit-slider-runnable-track{cursor:default}.custom-range:disabled::-moz-range-thumb{background-color:#adb5bd}.custom-range:disabled::-moz-range-track{cursor:default}.custom-range:disabled::-ms-thumb{background-color:#adb5bd}.custom-control-label::before,.custom-file-label,.custom-select{transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-control-label::before,.custom-file-label,.custom-select{transition:none}}.nav{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:.5rem 1rem}.nav-link:focus,.nav-link:hover{text-decoration:none}.nav-link.disabled{color:#6c757d;pointer-events:none;cursor:default}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-link{margin-bottom:-1px;background-color:transparent;border:1px solid transparent;border-top-left-radius:.25rem;border-top-right-radius:.25rem}.nav-tabs .nav-link:focus,.nav-tabs .nav-link:hover{isolation:isolate;border-color:#e9ecef #e9ecef #dee2e6}.nav-tabs .nav-link.disabled{color:#6c757d;background-color:transparent;border-color:transparent}.nav-tabs .nav-item.show .nav-link,.nav-tabs .nav-link.active{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{background:0 0;border:0;border-radius:.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#007bff}.nav-fill .nav-item,.nav-fill>.nav-link{-ms-flex:1 1 auto;flex:1 1 auto;text-align:center}.nav-justified .nav-item,.nav-justified>.nav-link{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;text-align:center}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between;padding:.5rem 1rem}.navbar .container,.navbar .container-fluid,.navbar .container-lg,.navbar .container-md,.navbar .container-sm,.navbar .container-xl{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between}.navbar-brand{display:inline-block;padding-top:.3125rem;padding-bottom:.3125rem;margin-right:1rem;font-size:1.25rem;line-height:inherit;white-space:nowrap}.navbar-brand:focus,.navbar-brand:hover{text-decoration:none}.navbar-nav{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static;float:none}.navbar-text{display:inline-block;padding-top:.5rem;padding-bottom:.5rem}.navbar-collapse{-ms-flex-preferred-size:100%;flex-basis:100%;-ms-flex-positive:1;flex-grow:1;-ms-flex-align:center;align-items:center}.navbar-toggler{padding:.25rem .75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:.25rem}.navbar-toggler:focus,.navbar-toggler:hover{text-decoration:none}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;content:"";background:50%/100% 100% no-repeat}.navbar-nav-scroll{max-height:75vh;overflow-y:auto}@media (max-width:575.98px){.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid,.navbar-expand-sm>.container-lg,.navbar-expand-sm>.container-md,.navbar-expand-sm>.container-sm,.navbar-expand-sm>.container-xl{padding-right:0;padding-left:0}}@media (min-width:576px){.navbar-expand-sm{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-sm .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid,.navbar-expand-sm>.container-lg,.navbar-expand-sm>.container-md,.navbar-expand-sm>.container-sm,.navbar-expand-sm>.container-xl{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-sm .navbar-nav-scroll{overflow:visible}.navbar-expand-sm .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}}@media (max-width:767.98px){.navbar-expand-md>.container,.navbar-expand-md>.container-fluid,.navbar-expand-md>.container-lg,.navbar-expand-md>.container-md,.navbar-expand-md>.container-sm,.navbar-expand-md>.container-xl{padding-right:0;padding-left:0}}@media (min-width:768px){.navbar-expand-md{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-md .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-md>.container,.navbar-expand-md>.container-fluid,.navbar-expand-md>.container-lg,.navbar-expand-md>.container-md,.navbar-expand-md>.container-sm,.navbar-expand-md>.container-xl{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-md .navbar-nav-scroll{overflow:visible}.navbar-expand-md .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}}@media (max-width:991.98px){.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid,.navbar-expand-lg>.container-lg,.navbar-expand-lg>.container-md,.navbar-expand-lg>.container-sm,.navbar-expand-lg>.container-xl{padding-right:0;padding-left:0}}@media (min-width:992px){.navbar-expand-lg{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-lg .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid,.navbar-expand-lg>.container-lg,.navbar-expand-lg>.container-md,.navbar-expand-lg>.container-sm,.navbar-expand-lg>.container-xl{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-lg .navbar-nav-scroll{overflow:visible}.navbar-expand-lg .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}}@media (max-width:1199.98px){.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid,.navbar-expand-xl>.container-lg,.navbar-expand-xl>.container-md,.navbar-expand-xl>.container-sm,.navbar-expand-xl>.container-xl{padding-right:0;padding-left:0}}@media (min-width:1200px){.navbar-expand-xl{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-xl .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid,.navbar-expand-xl>.container-lg,.navbar-expand-xl>.container-md,.navbar-expand-xl>.container-sm,.navbar-expand-xl>.container-xl{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-xl .navbar-nav-scroll{overflow:visible}.navbar-expand-xl .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}}.navbar-expand{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand>.container,.navbar-expand>.container-fluid,.navbar-expand>.container-lg,.navbar-expand>.container-md,.navbar-expand>.container-sm,.navbar-expand>.container-xl{padding-right:0;padding-left:0}.navbar-expand .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand>.container,.navbar-expand>.container-fluid,.navbar-expand>.container-lg,.navbar-expand>.container-md,.navbar-expand>.container-sm,.navbar-expand>.container-xl{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand .navbar-nav-scroll{overflow:visible}.navbar-expand .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-light .navbar-brand{color:rgba(0,0,0,.9)}.navbar-light .navbar-brand:focus,.navbar-light .navbar-brand:hover{color:rgba(0,0,0,.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,.5)}.navbar-light .navbar-nav .nav-link:focus,.navbar-light .navbar-nav .nav-link:hover{color:rgba(0,0,0,.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,.3)}.navbar-light .navbar-nav .active>.nav-link,.navbar-light .navbar-nav .nav-link.active,.navbar-light .navbar-nav .nav-link.show,.navbar-light .navbar-nav .show>.nav-link{color:rgba(0,0,0,.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,.5);border-color:rgba(0,0,0,.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='30' height='30' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%280, 0, 0, 0.5%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-light .navbar-text{color:rgba(0,0,0,.5)}.navbar-light .navbar-text a{color:rgba(0,0,0,.9)}.navbar-light .navbar-text a:focus,.navbar-light .navbar-text a:hover{color:rgba(0,0,0,.9)}.navbar-dark .navbar-brand{color:#fff}.navbar-dark .navbar-brand:focus,.navbar-dark .navbar-brand:hover{color:#fff}.navbar-dark .navbar-nav .nav-link{color:rgba(255,255,255,.5)}.navbar-dark .navbar-nav .nav-link:focus,.navbar-dark .navbar-nav .nav-link:hover{color:rgba(255,255,255,.75)}.navbar-dark .navbar-nav .nav-link.disabled{color:rgba(255,255,255,.25)}.navbar-dark .navbar-nav .active>.nav-link,.navbar-dark .navbar-nav .nav-link.active,.navbar-dark .navbar-nav .nav-link.show,.navbar-dark .navbar-nav .show>.nav-link{color:#fff}.navbar-dark .navbar-toggler{color:rgba(255,255,255,.5);border-color:rgba(255,255,255,.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='30' height='30' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255, 255, 255, 0.5%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-dark .navbar-text{color:rgba(255,255,255,.5)}.navbar-dark .navbar-text a{color:#fff}.navbar-dark .navbar-text a:focus,.navbar-dark .navbar-text a:hover{color:#fff}.card{position:relative;display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,.125);border-radius:.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card>.card-header+.list-group,.card>.list-group+.card-footer{border-top:0}.card-body{-ms-flex:1 1 auto;flex:1 1 auto;min-height:1px;padding:1.25rem}.card-title{margin-bottom:.75rem}.card-subtitle{margin-top:-.375rem;margin-bottom:0}.card-text:last-child{margin-bottom:0}.card-link:hover{text-decoration:none}.card-link+.card-link{margin-left:1.25rem}.card-header{padding:.75rem 1.25rem;margin-bottom:0;background-color:rgba(0,0,0,.03);border-bottom:1px solid rgba(0,0,0,.125)}.card-header:first-child{border-radius:calc(.25rem - 1px) calc(.25rem - 1px) 0 0}.card-footer{padding:.75rem 1.25rem;background-color:rgba(0,0,0,.03);border-top:1px solid rgba(0,0,0,.125)}.card-footer:last-child{border-radius:0 0 calc(.25rem - 1px) calc(.25rem - 1px)}.card-header-tabs{margin-right:-.625rem;margin-bottom:-.75rem;margin-left:-.625rem;border-bottom:0}.card-header-pills{margin-right:-.625rem;margin-left:-.625rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1.25rem;border-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom,.card-img-top{-ms-flex-negative:0;flex-shrink:0;width:100%}.card-img,.card-img-top{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-deck .card{margin-bottom:15px}@media (min-width:576px){.card-deck{display:-ms-flexbox;display:flex;-ms-flex-flow:row wrap;flex-flow:row wrap;margin-right:-15px;margin-left:-15px}.card-deck .card{-ms-flex:1 0 0%;flex:1 0 0%;margin-right:15px;margin-bottom:0;margin-left:15px}}.card-group>.card{margin-bottom:15px}@media (min-width:576px){.card-group{display:-ms-flexbox;display:flex;-ms-flex-flow:row wrap;flex-flow:row wrap}.card-group>.card{-ms-flex:1 0 0%;flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:not(:last-child) .card-header,.card-group>.card:not(:last-child) .card-img-top{border-top-right-radius:0}.card-group>.card:not(:last-child) .card-footer,.card-group>.card:not(:last-child) .card-img-bottom{border-bottom-right-radius:0}.card-group>.card:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:not(:first-child) .card-header,.card-group>.card:not(:first-child) .card-img-top{border-top-left-radius:0}.card-group>.card:not(:first-child) .card-footer,.card-group>.card:not(:first-child) .card-img-bottom{border-bottom-left-radius:0}}.card-columns .card{margin-bottom:.75rem}@media (min-width:576px){.card-columns{-webkit-column-count:3;-moz-column-count:3;column-count:3;-webkit-column-gap:1.25rem;-moz-column-gap:1.25rem;column-gap:1.25rem;orphans:1;widows:1}.card-columns .card{display:inline-block;width:100%}}.accordion{overflow-anchor:none}.accordion>.card{overflow:hidden}.accordion>.card:not(:last-of-type){border-bottom:0;border-bottom-right-radius:0;border-bottom-left-radius:0}.accordion>.card:not(:first-of-type){border-top-left-radius:0;border-top-right-radius:0}.accordion>.card>.card-header{border-radius:0;margin-bottom:-1px}.breadcrumb{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding:.75rem 1rem;margin-bottom:1rem;list-style:none;background-color:#e9ecef;border-radius:.25rem}.breadcrumb-item+.breadcrumb-item{padding-left:.5rem}.breadcrumb-item+.breadcrumb-item::before{float:left;padding-right:.5rem;color:#6c757d;content:"/"}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:underline}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:none}.breadcrumb-item.active{color:#6c757d}.pagination{display:-ms-flexbox;display:flex;padding-left:0;list-style:none;border-radius:.25rem}.page-link{position:relative;display:block;padding:.5rem .75rem;margin-left:-1px;line-height:1.25;color:#007bff;background-color:#fff;border:1px solid #dee2e6}.page-link:hover{z-index:2;color:#0056b3;text-decoration:none;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:3;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.page-item:first-child .page-link{margin-left:0;border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.page-item:last-child .page-link{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.page-item.active .page-link{z-index:3;color:#fff;background-color:#007bff;border-color:#007bff}.page-item.disabled .page-link{color:#6c757d;pointer-events:none;cursor:auto;background-color:#fff;border-color:#dee2e6}.pagination-lg .page-link{padding:.75rem 1.5rem;font-size:1.25rem;line-height:1.5}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.pagination-sm .page-link{padding:.25rem .5rem;font-size:.875rem;line-height:1.5}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:.2rem;border-bottom-left-radius:.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:.2rem;border-bottom-right-radius:.2rem}.badge{display:inline-block;padding:.25em .4em;font-size:75%;font-weight:700;line-height:1;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.badge{transition:none}}a.badge:focus,a.badge:hover{text-decoration:none}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.badge-pill{padding-right:.6em;padding-left:.6em;border-radius:10rem}.badge-primary{color:#fff;background-color:#007bff}a.badge-primary:focus,a.badge-primary:hover{color:#fff;background-color:#0062cc}a.badge-primary.focus,a.badge-primary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.badge-secondary{color:#fff;background-color:#6c757d}a.badge-secondary:focus,a.badge-secondary:hover{color:#fff;background-color:#545b62}a.badge-secondary.focus,a.badge-secondary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.badge-success{color:#fff;background-color:#28a745}a.badge-success:focus,a.badge-success:hover{color:#fff;background-color:#1e7e34}a.badge-success.focus,a.badge-success:focus{outline:0;box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.badge-info{color:#fff;background-color:#17a2b8}a.badge-info:focus,a.badge-info:hover{color:#fff;background-color:#117a8b}a.badge-info.focus,a.badge-info:focus{outline:0;box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.badge-warning{color:#212529;background-color:#ffc107}a.badge-warning:focus,a.badge-warning:hover{color:#212529;background-color:#d39e00}a.badge-warning.focus,a.badge-warning:focus{outline:0;box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.badge-danger{color:#fff;background-color:#dc3545}a.badge-danger:focus,a.badge-danger:hover{color:#fff;background-color:#bd2130}a.badge-danger.focus,a.badge-danger:focus{outline:0;box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.badge-light{color:#212529;background-color:#f8f9fa}a.badge-light:focus,a.badge-light:hover{color:#212529;background-color:#dae0e5}a.badge-light.focus,a.badge-light:focus{outline:0;box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.badge-dark{color:#fff;background-color:#343a40}a.badge-dark:focus,a.badge-dark:hover{color:#fff;background-color:#1d2124}a.badge-dark.focus,a.badge-dark:focus{outline:0;box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.jumbotron{padding:2rem 1rem;margin-bottom:2rem;background-color:#e9ecef;border-radius:.3rem}@media (min-width:576px){.jumbotron{padding:4rem 2rem}}.jumbotron-fluid{padding-right:0;padding-left:0;border-radius:0}.alert{position:relative;padding:.75rem 1.25rem;margin-bottom:1rem;border:1px solid transparent;border-radius:.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:4rem}.alert-dismissible .close{position:absolute;top:0;right:0;z-index:2;padding:.75rem 1.25rem;color:inherit}.alert-primary{color:#004085;background-color:#cce5ff;border-color:#b8daff}.alert-primary hr{border-top-color:#9fcdff}.alert-primary .alert-link{color:#002752}.alert-secondary{color:#383d41;background-color:#e2e3e5;border-color:#d6d8db}.alert-secondary hr{border-top-color:#c8cbcf}.alert-secondary .alert-link{color:#202326}.alert-success{color:#155724;background-color:#d4edda;border-color:#c3e6cb}.alert-success hr{border-top-color:#b1dfbb}.alert-success .alert-link{color:#0b2e13}.alert-info{color:#0c5460;background-color:#d1ecf1;border-color:#bee5eb}.alert-info hr{border-top-color:#abdde5}.alert-info .alert-link{color:#062c33}.alert-warning{color:#856404;background-color:#fff3cd;border-color:#ffeeba}.alert-warning hr{border-top-color:#ffe8a1}.alert-warning .alert-link{color:#533f03}.alert-danger{color:#721c24;background-color:#f8d7da;border-color:#f5c6cb}.alert-danger hr{border-top-color:#f1b0b7}.alert-danger .alert-link{color:#491217}.alert-light{color:#818182;background-color:#fefefe;border-color:#fdfdfe}.alert-light hr{border-top-color:#ececf6}.alert-light .alert-link{color:#686868}.alert-dark{color:#1b1e21;background-color:#d6d8d9;border-color:#c6c8ca}.alert-dark hr{border-top-color:#b9bbbe}.alert-dark .alert-link{color:#040505}@-webkit-keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}@keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}.progress{display:-ms-flexbox;display:flex;height:1rem;overflow:hidden;line-height:0;font-size:.75rem;background-color:#e9ecef;border-radius:.25rem}.progress-bar{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;-ms-flex-pack:center;justify-content:center;overflow:hidden;color:#fff;text-align:center;white-space:nowrap;background-color:#007bff;transition:width .6s ease}@media (prefers-reduced-motion:reduce){.progress-bar{transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-size:1rem 1rem}.progress-bar-animated{-webkit-animation:1s linear infinite progress-bar-stripes;animation:1s linear infinite progress-bar-stripes}@media (prefers-reduced-motion:reduce){.progress-bar-animated{-webkit-animation:none;animation:none}}.media{display:-ms-flexbox;display:flex;-ms-flex-align:start;align-items:flex-start}.media-body{-ms-flex:1;flex:1}.list-group{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:.25rem}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:focus,.list-group-item-action:hover{z-index:1;color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#212529;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:.75rem 1.25rem;background-color:#fff;border:1px solid rgba(0,0,0,.125)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:#6c757d;pointer-events:none;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#007bff;border-color:#007bff}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:-1px;border-top-width:1px}.list-group-horizontal{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal>.list-group-item.active{margin-top:0}.list-group-horizontal>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}@media (min-width:576px){.list-group-horizontal-sm{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-sm>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-sm>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-sm>.list-group-item.active{margin-top:0}.list-group-horizontal-sm>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-sm>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:768px){.list-group-horizontal-md{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-md>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-md>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-md>.list-group-item.active{margin-top:0}.list-group-horizontal-md>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-md>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:992px){.list-group-horizontal-lg{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-lg>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-lg>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-lg>.list-group-item.active{margin-top:0}.list-group-horizontal-lg>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-lg>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1200px){.list-group-horizontal-xl{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-xl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xl>.list-group-item.active{margin-top:0}.list-group-horizontal-xl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}.list-group-flush{border-radius:0}.list-group-flush>.list-group-item{border-width:0 0 1px}.list-group-flush>.list-group-item:last-child{border-bottom-width:0}.list-group-item-primary{color:#004085;background-color:#b8daff}.list-group-item-primary.list-group-item-action:focus,.list-group-item-primary.list-group-item-action:hover{color:#004085;background-color:#9fcdff}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#004085;border-color:#004085}.list-group-item-secondary{color:#383d41;background-color:#d6d8db}.list-group-item-secondary.list-group-item-action:focus,.list-group-item-secondary.list-group-item-action:hover{color:#383d41;background-color:#c8cbcf}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#383d41;border-color:#383d41}.list-group-item-success{color:#155724;background-color:#c3e6cb}.list-group-item-success.list-group-item-action:focus,.list-group-item-success.list-group-item-action:hover{color:#155724;background-color:#b1dfbb}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#155724;border-color:#155724}.list-group-item-info{color:#0c5460;background-color:#bee5eb}.list-group-item-info.list-group-item-action:focus,.list-group-item-info.list-group-item-action:hover{color:#0c5460;background-color:#abdde5}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#0c5460;border-color:#0c5460}.list-group-item-warning{color:#856404;background-color:#ffeeba}.list-group-item-warning.list-group-item-action:focus,.list-group-item-warning.list-group-item-action:hover{color:#856404;background-color:#ffe8a1}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#856404;border-color:#856404}.list-group-item-danger{color:#721c24;background-color:#f5c6cb}.list-group-item-danger.list-group-item-action:focus,.list-group-item-danger.list-group-item-action:hover{color:#721c24;background-color:#f1b0b7}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#721c24;border-color:#721c24}.list-group-item-light{color:#818182;background-color:#fdfdfe}.list-group-item-light.list-group-item-action:focus,.list-group-item-light.list-group-item-action:hover{color:#818182;background-color:#ececf6}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#818182;border-color:#818182}.list-group-item-dark{color:#1b1e21;background-color:#c6c8ca}.list-group-item-dark.list-group-item-action:focus,.list-group-item-dark.list-group-item-action:hover{color:#1b1e21;background-color:#b9bbbe}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#1b1e21;border-color:#1b1e21}.close{float:right;font-size:1.5rem;font-weight:700;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.5}.close:hover{color:#000;text-decoration:none}.close:not(:disabled):not(.disabled):focus,.close:not(:disabled):not(.disabled):hover{opacity:.75}button.close{padding:0;background-color:transparent;border:0}a.close.disabled{pointer-events:none}.toast{-ms-flex-preferred-size:350px;flex-basis:350px;max-width:350px;font-size:.875rem;background-color:rgba(255,255,255,.85);background-clip:padding-box;border:1px solid rgba(0,0,0,.1);box-shadow:0 .25rem .75rem rgba(0,0,0,.1);opacity:0;border-radius:.25rem}.toast:not(:last-child){margin-bottom:.75rem}.toast.showing{opacity:1}.toast.show{display:block;opacity:1}.toast.hide{display:none}.toast-header{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;padding:.25rem .75rem;color:#6c757d;background-color:rgba(255,255,255,.85);background-clip:padding-box;border-bottom:1px solid rgba(0,0,0,.05);border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.toast-body{padding:.75rem}.modal-open{overflow:hidden}.modal-open .modal{overflow-x:hidden;overflow-y:auto}.modal{position:fixed;top:0;left:0;z-index:1050;display:none;width:100%;height:100%;overflow:hidden;outline:0}.modal-dialog{position:relative;width:auto;margin:.5rem;pointer-events:none}.modal.fade .modal-dialog{transition:-webkit-transform .3s ease-out;transition:transform .3s ease-out;transition:transform .3s ease-out,-webkit-transform .3s ease-out;-webkit-transform:translate(0,-50px);transform:translate(0,-50px)}@media (prefers-reduced-motion:reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{-webkit-transform:none;transform:none}.modal.modal-static .modal-dialog{-webkit-transform:scale(1.02);transform:scale(1.02)}.modal-dialog-scrollable{display:-ms-flexbox;display:flex;max-height:calc(100% - 1rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 1rem);overflow:hidden}.modal-dialog-scrollable .modal-footer,.modal-dialog-scrollable .modal-header{-ms-flex-negative:0;flex-shrink:0}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-dialog-centered{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;min-height:calc(100% - 1rem)}.modal-dialog-centered::before{display:block;height:calc(100vh - 1rem);height:-webkit-min-content;height:-moz-min-content;height:min-content;content:""}.modal-dialog-centered.modal-dialog-scrollable{-ms-flex-direction:column;flex-direction:column;-ms-flex-pack:center;justify-content:center;height:100%}.modal-dialog-centered.modal-dialog-scrollable .modal-content{max-height:none}.modal-dialog-centered.modal-dialog-scrollable::before{content:none}.modal-content{position:relative;display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem;outline:0}.modal-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:.5}.modal-header{display:-ms-flexbox;display:flex;-ms-flex-align:start;align-items:flex-start;-ms-flex-pack:justify;justify-content:space-between;padding:1rem 1rem;border-bottom:1px solid #dee2e6;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.modal-header .close{padding:1rem 1rem;margin:-1rem -1rem -1rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;-ms-flex:1 1 auto;flex:1 1 auto;padding:1rem}.modal-footer{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:center;align-items:center;-ms-flex-pack:end;justify-content:flex-end;padding:.75rem;border-top:1px solid #dee2e6;border-bottom-right-radius:calc(.3rem - 1px);border-bottom-left-radius:calc(.3rem - 1px)}.modal-footer>*{margin:.25rem}.modal-scrollbar-measure{position:absolute;top:-9999px;width:50px;height:50px;overflow:scroll}@media (min-width:576px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-scrollable{max-height:calc(100% - 3.5rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 3.5rem)}.modal-dialog-centered{min-height:calc(100% - 3.5rem)}.modal-dialog-centered::before{height:calc(100vh - 3.5rem);height:-webkit-min-content;height:-moz-min-content;height:min-content}.modal-sm{max-width:300px}}@media (min-width:992px){.modal-lg,.modal-xl{max-width:800px}}@media (min-width:1200px){.modal-xl{max-width:1140px}}.tooltip{position:absolute;z-index:1070;display:block;margin:0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;white-space:normal;word-spacing:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:.9}.tooltip .arrow{position:absolute;display:block;width:.8rem;height:.4rem}.tooltip .arrow::before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-auto[x-placement^=top],.bs-tooltip-top{padding:.4rem 0}.bs-tooltip-auto[x-placement^=top] .arrow,.bs-tooltip-top .arrow{bottom:0}.bs-tooltip-auto[x-placement^=top] .arrow::before,.bs-tooltip-top .arrow::before{top:0;border-width:.4rem .4rem 0;border-top-color:#000}.bs-tooltip-auto[x-placement^=right],.bs-tooltip-right{padding:0 .4rem}.bs-tooltip-auto[x-placement^=right] .arrow,.bs-tooltip-right .arrow{left:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=right] .arrow::before,.bs-tooltip-right .arrow::before{right:0;border-width:.4rem .4rem .4rem 0;border-right-color:#000}.bs-tooltip-auto[x-placement^=bottom],.bs-tooltip-bottom{padding:.4rem 0}.bs-tooltip-auto[x-placement^=bottom] .arrow,.bs-tooltip-bottom .arrow{top:0}.bs-tooltip-auto[x-placement^=bottom] .arrow::before,.bs-tooltip-bottom .arrow::before{bottom:0;border-width:0 .4rem .4rem;border-bottom-color:#000}.bs-tooltip-auto[x-placement^=left],.bs-tooltip-left{padding:0 .4rem}.bs-tooltip-auto[x-placement^=left] .arrow,.bs-tooltip-left .arrow{right:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=left] .arrow::before,.bs-tooltip-left .arrow::before{left:0;border-width:.4rem 0 .4rem .4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:.25rem .5rem;color:#fff;text-align:center;background-color:#000;border-radius:.25rem}.popover{position:absolute;top:0;left:0;z-index:1060;display:block;max-width:276px;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;white-space:normal;word-spacing:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem}.popover .arrow{position:absolute;display:block;width:1rem;height:.5rem;margin:0 .3rem}.popover .arrow::after,.popover .arrow::before{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-auto[x-placement^=top],.bs-popover-top{margin-bottom:.5rem}.bs-popover-auto[x-placement^=top]>.arrow,.bs-popover-top>.arrow{bottom:calc(-.5rem - 1px)}.bs-popover-auto[x-placement^=top]>.arrow::before,.bs-popover-top>.arrow::before{bottom:0;border-width:.5rem .5rem 0;border-top-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=top]>.arrow::after,.bs-popover-top>.arrow::after{bottom:1px;border-width:.5rem .5rem 0;border-top-color:#fff}.bs-popover-auto[x-placement^=right],.bs-popover-right{margin-left:.5rem}.bs-popover-auto[x-placement^=right]>.arrow,.bs-popover-right>.arrow{left:calc(-.5rem - 1px);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=right]>.arrow::before,.bs-popover-right>.arrow::before{left:0;border-width:.5rem .5rem .5rem 0;border-right-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=right]>.arrow::after,.bs-popover-right>.arrow::after{left:1px;border-width:.5rem .5rem .5rem 0;border-right-color:#fff}.bs-popover-auto[x-placement^=bottom],.bs-popover-bottom{margin-top:.5rem}.bs-popover-auto[x-placement^=bottom]>.arrow,.bs-popover-bottom>.arrow{top:calc(-.5rem - 1px)}.bs-popover-auto[x-placement^=bottom]>.arrow::before,.bs-popover-bottom>.arrow::before{top:0;border-width:0 .5rem .5rem .5rem;border-bottom-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=bottom]>.arrow::after,.bs-popover-bottom>.arrow::after{top:1px;border-width:0 .5rem .5rem .5rem;border-bottom-color:#fff}.bs-popover-auto[x-placement^=bottom] .popover-header::before,.bs-popover-bottom .popover-header::before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-.5rem;content:"";border-bottom:1px solid #f7f7f7}.bs-popover-auto[x-placement^=left],.bs-popover-left{margin-right:.5rem}.bs-popover-auto[x-placement^=left]>.arrow,.bs-popover-left>.arrow{right:calc(-.5rem - 1px);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=left]>.arrow::before,.bs-popover-left>.arrow::before{right:0;border-width:.5rem 0 .5rem .5rem;border-left-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=left]>.arrow::after,.bs-popover-left>.arrow::after{right:1px;border-width:.5rem 0 .5rem .5rem;border-left-color:#fff}.popover-header{padding:.5rem .75rem;margin-bottom:0;font-size:1rem;background-color:#f7f7f7;border-bottom:1px solid #ebebeb;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:.5rem .75rem;color:#212529}.carousel{position:relative}.carousel.pointer-event{-ms-touch-action:pan-y;touch-action:pan-y}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner::after{display:block;clear:both;content:""}.carousel-item{position:relative;display:none;float:left;width:100%;margin-right:-100%;-webkit-backface-visibility:hidden;backface-visibility:hidden;transition:-webkit-transform .6s ease-in-out;transition:transform .6s ease-in-out;transition:transform .6s ease-in-out,-webkit-transform .6s ease-in-out}@media (prefers-reduced-motion:reduce){.carousel-item{transition:none}}.carousel-item-next,.carousel-item-prev,.carousel-item.active{display:block}.active.carousel-item-right,.carousel-item-next:not(.carousel-item-left){-webkit-transform:translateX(100%);transform:translateX(100%)}.active.carousel-item-left,.carousel-item-prev:not(.carousel-item-right){-webkit-transform:translateX(-100%);transform:translateX(-100%)}.carousel-fade .carousel-item{opacity:0;transition-property:opacity;-webkit-transform:none;transform:none}.carousel-fade .carousel-item-next.carousel-item-left,.carousel-fade .carousel-item-prev.carousel-item-right,.carousel-fade .carousel-item.active{z-index:1;opacity:1}.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{z-index:0;opacity:0;transition:opacity 0s .6s}@media (prefers-reduced-motion:reduce){.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{transition:none}}.carousel-control-next,.carousel-control-prev{position:absolute;top:0;bottom:0;z-index:1;display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;width:15%;padding:0;color:#fff;text-align:center;background:0 0;border:0;opacity:.5;transition:opacity .15s ease}@media (prefers-reduced-motion:reduce){.carousel-control-next,.carousel-control-prev{transition:none}}.carousel-control-next:focus,.carousel-control-next:hover,.carousel-control-prev:focus,.carousel-control-prev:hover{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-next-icon,.carousel-control-prev-icon{display:inline-block;width:20px;height:20px;background:50%/100% 100% no-repeat}.carousel-control-prev-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' width='8' height='8' viewBox='0 0 8 8'%3e%3cpath d='M5.25 0l-4 4 4 4 1.5-1.5L4.25 4l2.5-2.5L5.25 0z'/%3e%3c/svg%3e")}.carousel-control-next-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' width='8' height='8' viewBox='0 0 8 8'%3e%3cpath d='M2.75 0l-1.5 1.5L3.75 4l-2.5 2.5L2.75 8l4-4-4-4z'/%3e%3c/svg%3e")}.carousel-indicators{position:absolute;right:0;bottom:0;left:0;z-index:15;display:-ms-flexbox;display:flex;-ms-flex-pack:center;justify-content:center;padding-left:0;margin-right:15%;margin-left:15%;list-style:none}.carousel-indicators li{box-sizing:content-box;-ms-flex:0 1 auto;flex:0 1 auto;width:30px;height:3px;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:#fff;background-clip:padding-box;border-top:10px solid transparent;border-bottom:10px solid transparent;opacity:.5;transition:opacity .6s ease}@media (prefers-reduced-motion:reduce){.carousel-indicators li{transition:none}}.carousel-indicators .active{opacity:1}.carousel-caption{position:absolute;right:15%;bottom:20px;left:15%;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}@-webkit-keyframes spinner-border{to{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}@keyframes spinner-border{to{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}.spinner-border{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;border:.25em solid currentcolor;border-right-color:transparent;border-radius:50%;-webkit-animation:.75s linear infinite spinner-border;animation:.75s linear infinite spinner-border}.spinner-border-sm{width:1rem;height:1rem;border-width:.2em}@-webkit-keyframes spinner-grow{0%{-webkit-transform:scale(0);transform:scale(0)}50%{opacity:1;-webkit-transform:none;transform:none}}@keyframes spinner-grow{0%{-webkit-transform:scale(0);transform:scale(0)}50%{opacity:1;-webkit-transform:none;transform:none}}.spinner-grow{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;background-color:currentcolor;border-radius:50%;opacity:0;-webkit-animation:.75s linear infinite spinner-grow;animation:.75s linear infinite spinner-grow}.spinner-grow-sm{width:1rem;height:1rem}@media (prefers-reduced-motion:reduce){.spinner-border,.spinner-grow{-webkit-animation-duration:1.5s;animation-duration:1.5s}}.align-baseline{vertical-align:baseline!important}.align-top{vertical-align:top!important}.align-middle{vertical-align:middle!important}.align-bottom{vertical-align:bottom!important}.align-text-bottom{vertical-align:text-bottom!important}.align-text-top{vertical-align:text-top!important}.bg-primary{background-color:#007bff!important}a.bg-primary:focus,a.bg-primary:hover,button.bg-primary:focus,button.bg-primary:hover{background-color:#0062cc!important}.bg-secondary{background-color:#6c757d!important}a.bg-secondary:focus,a.bg-secondary:hover,button.bg-secondary:focus,button.bg-secondary:hover{background-color:#545b62!important}.bg-success{background-color:#28a745!important}a.bg-success:focus,a.bg-success:hover,button.bg-success:focus,button.bg-success:hover{background-color:#1e7e34!important}.bg-info{background-color:#17a2b8!important}a.bg-info:focus,a.bg-info:hover,button.bg-info:focus,button.bg-info:hover{background-color:#117a8b!important}.bg-warning{background-color:#ffc107!important}a.bg-warning:focus,a.bg-warning:hover,button.bg-warning:focus,button.bg-warning:hover{background-color:#d39e00!important}.bg-danger{background-color:#dc3545!important}a.bg-danger:focus,a.bg-danger:hover,button.bg-danger:focus,button.bg-danger:hover{background-color:#bd2130!important}.bg-light{background-color:#f8f9fa!important}a.bg-light:focus,a.bg-light:hover,button.bg-light:focus,button.bg-light:hover{background-color:#dae0e5!important}.bg-dark{background-color:#343a40!important}a.bg-dark:focus,a.bg-dark:hover,button.bg-dark:focus,button.bg-dark:hover{background-color:#1d2124!important}.bg-white{background-color:#fff!important}.bg-transparent{background-color:transparent!important}.border{border:1px solid #dee2e6!important}.border-top{border-top:1px solid #dee2e6!important}.border-right{border-right:1px solid #dee2e6!important}.border-bottom{border-bottom:1px solid #dee2e6!important}.border-left{border-left:1px solid #dee2e6!important}.border-0{border:0!important}.border-top-0{border-top:0!important}.border-right-0{border-right:0!important}.border-bottom-0{border-bottom:0!important}.border-left-0{border-left:0!important}.border-primary{border-color:#007bff!important}.border-secondary{border-color:#6c757d!important}.border-success{border-color:#28a745!important}.border-info{border-color:#17a2b8!important}.border-warning{border-color:#ffc107!important}.border-danger{border-color:#dc3545!important}.border-light{border-color:#f8f9fa!important}.border-dark{border-color:#343a40!important}.border-white{border-color:#fff!important}.rounded-sm{border-radius:.2rem!important}.rounded{border-radius:.25rem!important}.rounded-top{border-top-left-radius:.25rem!important;border-top-right-radius:.25rem!important}.rounded-right{border-top-right-radius:.25rem!important;border-bottom-right-radius:.25rem!important}.rounded-bottom{border-bottom-right-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-left{border-top-left-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-lg{border-radius:.3rem!important}.rounded-circle{border-radius:50%!important}.rounded-pill{border-radius:50rem!important}.rounded-0{border-radius:0!important}.clearfix::after{display:block;clear:both;content:""}.d-none{display:none!important}.d-inline{display:inline!important}.d-inline-block{display:inline-block!important}.d-block{display:block!important}.d-table{display:table!important}.d-table-row{display:table-row!important}.d-table-cell{display:table-cell!important}.d-flex{display:-ms-flexbox!important;display:flex!important}.d-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}@media (min-width:576px){.d-sm-none{display:none!important}.d-sm-inline{display:inline!important}.d-sm-inline-block{display:inline-block!important}.d-sm-block{display:block!important}.d-sm-table{display:table!important}.d-sm-table-row{display:table-row!important}.d-sm-table-cell{display:table-cell!important}.d-sm-flex{display:-ms-flexbox!important;display:flex!important}.d-sm-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:768px){.d-md-none{display:none!important}.d-md-inline{display:inline!important}.d-md-inline-block{display:inline-block!important}.d-md-block{display:block!important}.d-md-table{display:table!important}.d-md-table-row{display:table-row!important}.d-md-table-cell{display:table-cell!important}.d-md-flex{display:-ms-flexbox!important;display:flex!important}.d-md-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:992px){.d-lg-none{display:none!important}.d-lg-inline{display:inline!important}.d-lg-inline-block{display:inline-block!important}.d-lg-block{display:block!important}.d-lg-table{display:table!important}.d-lg-table-row{display:table-row!important}.d-lg-table-cell{display:table-cell!important}.d-lg-flex{display:-ms-flexbox!important;display:flex!important}.d-lg-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:1200px){.d-xl-none{display:none!important}.d-xl-inline{display:inline!important}.d-xl-inline-block{display:inline-block!important}.d-xl-block{display:block!important}.d-xl-table{display:table!important}.d-xl-table-row{display:table-row!important}.d-xl-table-cell{display:table-cell!important}.d-xl-flex{display:-ms-flexbox!important;display:flex!important}.d-xl-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media print{.d-print-none{display:none!important}.d-print-inline{display:inline!important}.d-print-inline-block{display:inline-block!important}.d-print-block{display:block!important}.d-print-table{display:table!important}.d-print-table-row{display:table-row!important}.d-print-table-cell{display:table-cell!important}.d-print-flex{display:-ms-flexbox!important;display:flex!important}.d-print-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}.embed-responsive{position:relative;display:block;width:100%;padding:0;overflow:hidden}.embed-responsive::before{display:block;content:""}.embed-responsive .embed-responsive-item,.embed-responsive embed,.embed-responsive iframe,.embed-responsive object,.embed-responsive video{position:absolute;top:0;bottom:0;left:0;width:100%;height:100%;border:0}.embed-responsive-21by9::before{padding-top:42.857143%}.embed-responsive-16by9::before{padding-top:56.25%}.embed-responsive-4by3::before{padding-top:75%}.embed-responsive-1by1::before{padding-top:100%}.flex-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-center{-ms-flex-align:center!important;align-items:center!important}.align-items-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}@media (min-width:576px){.flex-sm-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-sm-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-sm-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-sm-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-sm-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-sm-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-sm-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-sm-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-sm-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-sm-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-sm-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-sm-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-sm-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-sm-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-sm-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-sm-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-sm-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-sm-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-sm-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-sm-center{-ms-flex-align:center!important;align-items:center!important}.align-items-sm-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-sm-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-sm-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-sm-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-sm-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-sm-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-sm-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-sm-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-sm-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-sm-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-sm-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-sm-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-sm-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-sm-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:768px){.flex-md-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-md-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-md-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-md-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-md-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-md-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-md-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-md-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-md-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-md-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-md-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-md-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-md-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-md-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-md-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-md-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-md-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-md-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-md-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-md-center{-ms-flex-align:center!important;align-items:center!important}.align-items-md-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-md-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-md-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-md-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-md-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-md-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-md-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-md-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-md-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-md-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-md-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-md-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-md-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-md-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:992px){.flex-lg-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-lg-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-lg-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-lg-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-lg-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-lg-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-lg-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-lg-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-lg-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-lg-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-lg-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-lg-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-lg-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-lg-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-lg-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-lg-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-lg-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-lg-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-lg-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-lg-center{-ms-flex-align:center!important;align-items:center!important}.align-items-lg-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-lg-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-lg-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-lg-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-lg-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-lg-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-lg-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-lg-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-lg-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-lg-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-lg-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-lg-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-lg-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-lg-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:1200px){.flex-xl-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-xl-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-xl-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-xl-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-xl-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-xl-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-xl-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-xl-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-xl-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-xl-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-xl-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-xl-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-xl-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-xl-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-xl-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-xl-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-xl-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-xl-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-xl-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-xl-center{-ms-flex-align:center!important;align-items:center!important}.align-items-xl-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-xl-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-xl-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-xl-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-xl-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-xl-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-xl-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-xl-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-xl-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-xl-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-xl-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-xl-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-xl-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-xl-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}.float-left{float:left!important}.float-right{float:right!important}.float-none{float:none!important}@media (min-width:576px){.float-sm-left{float:left!important}.float-sm-right{float:right!important}.float-sm-none{float:none!important}}@media (min-width:768px){.float-md-left{float:left!important}.float-md-right{float:right!important}.float-md-none{float:none!important}}@media (min-width:992px){.float-lg-left{float:left!important}.float-lg-right{float:right!important}.float-lg-none{float:none!important}}@media (min-width:1200px){.float-xl-left{float:left!important}.float-xl-right{float:right!important}.float-xl-none{float:none!important}}.user-select-all{-webkit-user-select:all!important;-moz-user-select:all!important;user-select:all!important}.user-select-auto{-webkit-user-select:auto!important;-moz-user-select:auto!important;-ms-user-select:auto!important;user-select:auto!important}.user-select-none{-webkit-user-select:none!important;-moz-user-select:none!important;-ms-user-select:none!important;user-select:none!important}.overflow-auto{overflow:auto!important}.overflow-hidden{overflow:hidden!important}.position-static{position:static!important}.position-relative{position:relative!important}.position-absolute{position:absolute!important}.position-fixed{position:fixed!important}.position-sticky{position:-webkit-sticky!important;position:sticky!important}.fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.fixed-bottom{position:fixed;right:0;bottom:0;left:0;z-index:1030}@supports ((position:-webkit-sticky) or (position:sticky)){.sticky-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;overflow:visible;clip:auto;white-space:normal}.shadow-sm{box-shadow:0 .125rem .25rem rgba(0,0,0,.075)!important}.shadow{box-shadow:0 .5rem 1rem rgba(0,0,0,.15)!important}.shadow-lg{box-shadow:0 1rem 3rem rgba(0,0,0,.175)!important}.shadow-none{box-shadow:none!important}.w-25{width:25%!important}.w-50{width:50%!important}.w-75{width:75%!important}.w-100{width:100%!important}.w-auto{width:auto!important}.h-25{height:25%!important}.h-50{height:50%!important}.h-75{height:75%!important}.h-100{height:100%!important}.h-auto{height:auto!important}.mw-100{max-width:100%!important}.mh-100{max-height:100%!important}.min-vw-100{min-width:100vw!important}.min-vh-100{min-height:100vh!important}.vw-100{width:100vw!important}.vh-100{height:100vh!important}.m-0{margin:0!important}.mt-0,.my-0{margin-top:0!important}.mr-0,.mx-0{margin-right:0!important}.mb-0,.my-0{margin-bottom:0!important}.ml-0,.mx-0{margin-left:0!important}.m-1{margin:.25rem!important}.mt-1,.my-1{margin-top:.25rem!important}.mr-1,.mx-1{margin-right:.25rem!important}.mb-1,.my-1{margin-bottom:.25rem!important}.ml-1,.mx-1{margin-left:.25rem!important}.m-2{margin:.5rem!important}.mt-2,.my-2{margin-top:.5rem!important}.mr-2,.mx-2{margin-right:.5rem!important}.mb-2,.my-2{margin-bottom:.5rem!important}.ml-2,.mx-2{margin-left:.5rem!important}.m-3{margin:1rem!important}.mt-3,.my-3{margin-top:1rem!important}.mr-3,.mx-3{margin-right:1rem!important}.mb-3,.my-3{margin-bottom:1rem!important}.ml-3,.mx-3{margin-left:1rem!important}.m-4{margin:1.5rem!important}.mt-4,.my-4{margin-top:1.5rem!important}.mr-4,.mx-4{margin-right:1.5rem!important}.mb-4,.my-4{margin-bottom:1.5rem!important}.ml-4,.mx-4{margin-left:1.5rem!important}.m-5{margin:3rem!important}.mt-5,.my-5{margin-top:3rem!important}.mr-5,.mx-5{margin-right:3rem!important}.mb-5,.my-5{margin-bottom:3rem!important}.ml-5,.mx-5{margin-left:3rem!important}.p-0{padding:0!important}.pt-0,.py-0{padding-top:0!important}.pr-0,.px-0{padding-right:0!important}.pb-0,.py-0{padding-bottom:0!important}.pl-0,.px-0{padding-left:0!important}.p-1{padding:.25rem!important}.pt-1,.py-1{padding-top:.25rem!important}.pr-1,.px-1{padding-right:.25rem!important}.pb-1,.py-1{padding-bottom:.25rem!important}.pl-1,.px-1{padding-left:.25rem!important}.p-2{padding:.5rem!important}.pt-2,.py-2{padding-top:.5rem!important}.pr-2,.px-2{padding-right:.5rem!important}.pb-2,.py-2{padding-bottom:.5rem!important}.pl-2,.px-2{padding-left:.5rem!important}.p-3{padding:1rem!important}.pt-3,.py-3{padding-top:1rem!important}.pr-3,.px-3{padding-right:1rem!important}.pb-3,.py-3{padding-bottom:1rem!important}.pl-3,.px-3{padding-left:1rem!important}.p-4{padding:1.5rem!important}.pt-4,.py-4{padding-top:1.5rem!important}.pr-4,.px-4{padding-right:1.5rem!important}.pb-4,.py-4{padding-bottom:1.5rem!important}.pl-4,.px-4{padding-left:1.5rem!important}.p-5{padding:3rem!important}.pt-5,.py-5{padding-top:3rem!important}.pr-5,.px-5{padding-right:3rem!important}.pb-5,.py-5{padding-bottom:3rem!important}.pl-5,.px-5{padding-left:3rem!important}.m-n1{margin:-.25rem!important}.mt-n1,.my-n1{margin-top:-.25rem!important}.mr-n1,.mx-n1{margin-right:-.25rem!important}.mb-n1,.my-n1{margin-bottom:-.25rem!important}.ml-n1,.mx-n1{margin-left:-.25rem!important}.m-n2{margin:-.5rem!important}.mt-n2,.my-n2{margin-top:-.5rem!important}.mr-n2,.mx-n2{margin-right:-.5rem!important}.mb-n2,.my-n2{margin-bottom:-.5rem!important}.ml-n2,.mx-n2{margin-left:-.5rem!important}.m-n3{margin:-1rem!important}.mt-n3,.my-n3{margin-top:-1rem!important}.mr-n3,.mx-n3{margin-right:-1rem!important}.mb-n3,.my-n3{margin-bottom:-1rem!important}.ml-n3,.mx-n3{margin-left:-1rem!important}.m-n4{margin:-1.5rem!important}.mt-n4,.my-n4{margin-top:-1.5rem!important}.mr-n4,.mx-n4{margin-right:-1.5rem!important}.mb-n4,.my-n4{margin-bottom:-1.5rem!important}.ml-n4,.mx-n4{margin-left:-1.5rem!important}.m-n5{margin:-3rem!important}.mt-n5,.my-n5{margin-top:-3rem!important}.mr-n5,.mx-n5{margin-right:-3rem!important}.mb-n5,.my-n5{margin-bottom:-3rem!important}.ml-n5,.mx-n5{margin-left:-3rem!important}.m-auto{margin:auto!important}.mt-auto,.my-auto{margin-top:auto!important}.mr-auto,.mx-auto{margin-right:auto!important}.mb-auto,.my-auto{margin-bottom:auto!important}.ml-auto,.mx-auto{margin-left:auto!important}@media (min-width:576px){.m-sm-0{margin:0!important}.mt-sm-0,.my-sm-0{margin-top:0!important}.mr-sm-0,.mx-sm-0{margin-right:0!important}.mb-sm-0,.my-sm-0{margin-bottom:0!important}.ml-sm-0,.mx-sm-0{margin-left:0!important}.m-sm-1{margin:.25rem!important}.mt-sm-1,.my-sm-1{margin-top:.25rem!important}.mr-sm-1,.mx-sm-1{margin-right:.25rem!important}.mb-sm-1,.my-sm-1{margin-bottom:.25rem!important}.ml-sm-1,.mx-sm-1{margin-left:.25rem!important}.m-sm-2{margin:.5rem!important}.mt-sm-2,.my-sm-2{margin-top:.5rem!important}.mr-sm-2,.mx-sm-2{margin-right:.5rem!important}.mb-sm-2,.my-sm-2{margin-bottom:.5rem!important}.ml-sm-2,.mx-sm-2{margin-left:.5rem!important}.m-sm-3{margin:1rem!important}.mt-sm-3,.my-sm-3{margin-top:1rem!important}.mr-sm-3,.mx-sm-3{margin-right:1rem!important}.mb-sm-3,.my-sm-3{margin-bottom:1rem!important}.ml-sm-3,.mx-sm-3{margin-left:1rem!important}.m-sm-4{margin:1.5rem!important}.mt-sm-4,.my-sm-4{margin-top:1.5rem!important}.mr-sm-4,.mx-sm-4{margin-right:1.5rem!important}.mb-sm-4,.my-sm-4{margin-bottom:1.5rem!important}.ml-sm-4,.mx-sm-4{margin-left:1.5rem!important}.m-sm-5{margin:3rem!important}.mt-sm-5,.my-sm-5{margin-top:3rem!important}.mr-sm-5,.mx-sm-5{margin-right:3rem!important}.mb-sm-5,.my-sm-5{margin-bottom:3rem!important}.ml-sm-5,.mx-sm-5{margin-left:3rem!important}.p-sm-0{padding:0!important}.pt-sm-0,.py-sm-0{padding-top:0!important}.pr-sm-0,.px-sm-0{padding-right:0!important}.pb-sm-0,.py-sm-0{padding-bottom:0!important}.pl-sm-0,.px-sm-0{padding-left:0!important}.p-sm-1{padding:.25rem!important}.pt-sm-1,.py-sm-1{padding-top:.25rem!important}.pr-sm-1,.px-sm-1{padding-right:.25rem!important}.pb-sm-1,.py-sm-1{padding-bottom:.25rem!important}.pl-sm-1,.px-sm-1{padding-left:.25rem!important}.p-sm-2{padding:.5rem!important}.pt-sm-2,.py-sm-2{padding-top:.5rem!important}.pr-sm-2,.px-sm-2{padding-right:.5rem!important}.pb-sm-2,.py-sm-2{padding-bottom:.5rem!important}.pl-sm-2,.px-sm-2{padding-left:.5rem!important}.p-sm-3{padding:1rem!important}.pt-sm-3,.py-sm-3{padding-top:1rem!important}.pr-sm-3,.px-sm-3{padding-right:1rem!important}.pb-sm-3,.py-sm-3{padding-bottom:1rem!important}.pl-sm-3,.px-sm-3{padding-left:1rem!important}.p-sm-4{padding:1.5rem!important}.pt-sm-4,.py-sm-4{padding-top:1.5rem!important}.pr-sm-4,.px-sm-4{padding-right:1.5rem!important}.pb-sm-4,.py-sm-4{padding-bottom:1.5rem!important}.pl-sm-4,.px-sm-4{padding-left:1.5rem!important}.p-sm-5{padding:3rem!important}.pt-sm-5,.py-sm-5{padding-top:3rem!important}.pr-sm-5,.px-sm-5{padding-right:3rem!important}.pb-sm-5,.py-sm-5{padding-bottom:3rem!important}.pl-sm-5,.px-sm-5{padding-left:3rem!important}.m-sm-n1{margin:-.25rem!important}.mt-sm-n1,.my-sm-n1{margin-top:-.25rem!important}.mr-sm-n1,.mx-sm-n1{margin-right:-.25rem!important}.mb-sm-n1,.my-sm-n1{margin-bottom:-.25rem!important}.ml-sm-n1,.mx-sm-n1{margin-left:-.25rem!important}.m-sm-n2{margin:-.5rem!important}.mt-sm-n2,.my-sm-n2{margin-top:-.5rem!important}.mr-sm-n2,.mx-sm-n2{margin-right:-.5rem!important}.mb-sm-n2,.my-sm-n2{margin-bottom:-.5rem!important}.ml-sm-n2,.mx-sm-n2{margin-left:-.5rem!important}.m-sm-n3{margin:-1rem!important}.mt-sm-n3,.my-sm-n3{margin-top:-1rem!important}.mr-sm-n3,.mx-sm-n3{margin-right:-1rem!important}.mb-sm-n3,.my-sm-n3{margin-bottom:-1rem!important}.ml-sm-n3,.mx-sm-n3{margin-left:-1rem!important}.m-sm-n4{margin:-1.5rem!important}.mt-sm-n4,.my-sm-n4{margin-top:-1.5rem!important}.mr-sm-n4,.mx-sm-n4{margin-right:-1.5rem!important}.mb-sm-n4,.my-sm-n4{margin-bottom:-1.5rem!important}.ml-sm-n4,.mx-sm-n4{margin-left:-1.5rem!important}.m-sm-n5{margin:-3rem!important}.mt-sm-n5,.my-sm-n5{margin-top:-3rem!important}.mr-sm-n5,.mx-sm-n5{margin-right:-3rem!important}.mb-sm-n5,.my-sm-n5{margin-bottom:-3rem!important}.ml-sm-n5,.mx-sm-n5{margin-left:-3rem!important}.m-sm-auto{margin:auto!important}.mt-sm-auto,.my-sm-auto{margin-top:auto!important}.mr-sm-auto,.mx-sm-auto{margin-right:auto!important}.mb-sm-auto,.my-sm-auto{margin-bottom:auto!important}.ml-sm-auto,.mx-sm-auto{margin-left:auto!important}}@media (min-width:768px){.m-md-0{margin:0!important}.mt-md-0,.my-md-0{margin-top:0!important}.mr-md-0,.mx-md-0{margin-right:0!important}.mb-md-0,.my-md-0{margin-bottom:0!important}.ml-md-0,.mx-md-0{margin-left:0!important}.m-md-1{margin:.25rem!important}.mt-md-1,.my-md-1{margin-top:.25rem!important}.mr-md-1,.mx-md-1{margin-right:.25rem!important}.mb-md-1,.my-md-1{margin-bottom:.25rem!important}.ml-md-1,.mx-md-1{margin-left:.25rem!important}.m-md-2{margin:.5rem!important}.mt-md-2,.my-md-2{margin-top:.5rem!important}.mr-md-2,.mx-md-2{margin-right:.5rem!important}.mb-md-2,.my-md-2{margin-bottom:.5rem!important}.ml-md-2,.mx-md-2{margin-left:.5rem!important}.m-md-3{margin:1rem!important}.mt-md-3,.my-md-3{margin-top:1rem!important}.mr-md-3,.mx-md-3{margin-right:1rem!important}.mb-md-3,.my-md-3{margin-bottom:1rem!important}.ml-md-3,.mx-md-3{margin-left:1rem!important}.m-md-4{margin:1.5rem!important}.mt-md-4,.my-md-4{margin-top:1.5rem!important}.mr-md-4,.mx-md-4{margin-right:1.5rem!important}.mb-md-4,.my-md-4{margin-bottom:1.5rem!important}.ml-md-4,.mx-md-4{margin-left:1.5rem!important}.m-md-5{margin:3rem!important}.mt-md-5,.my-md-5{margin-top:3rem!important}.mr-md-5,.mx-md-5{margin-right:3rem!important}.mb-md-5,.my-md-5{margin-bottom:3rem!important}.ml-md-5,.mx-md-5{margin-left:3rem!important}.p-md-0{padding:0!important}.pt-md-0,.py-md-0{padding-top:0!important}.pr-md-0,.px-md-0{padding-right:0!important}.pb-md-0,.py-md-0{padding-bottom:0!important}.pl-md-0,.px-md-0{padding-left:0!important}.p-md-1{padding:.25rem!important}.pt-md-1,.py-md-1{padding-top:.25rem!important}.pr-md-1,.px-md-1{padding-right:.25rem!important}.pb-md-1,.py-md-1{padding-bottom:.25rem!important}.pl-md-1,.px-md-1{padding-left:.25rem!important}.p-md-2{padding:.5rem!important}.pt-md-2,.py-md-2{padding-top:.5rem!important}.pr-md-2,.px-md-2{padding-right:.5rem!important}.pb-md-2,.py-md-2{padding-bottom:.5rem!important}.pl-md-2,.px-md-2{padding-left:.5rem!important}.p-md-3{padding:1rem!important}.pt-md-3,.py-md-3{padding-top:1rem!important}.pr-md-3,.px-md-3{padding-right:1rem!important}.pb-md-3,.py-md-3{padding-bottom:1rem!important}.pl-md-3,.px-md-3{padding-left:1rem!important}.p-md-4{padding:1.5rem!important}.pt-md-4,.py-md-4{padding-top:1.5rem!important}.pr-md-4,.px-md-4{padding-right:1.5rem!important}.pb-md-4,.py-md-4{padding-bottom:1.5rem!important}.pl-md-4,.px-md-4{padding-left:1.5rem!important}.p-md-5{padding:3rem!important}.pt-md-5,.py-md-5{padding-top:3rem!important}.pr-md-5,.px-md-5{padding-right:3rem!important}.pb-md-5,.py-md-5{padding-bottom:3rem!important}.pl-md-5,.px-md-5{padding-left:3rem!important}.m-md-n1{margin:-.25rem!important}.mt-md-n1,.my-md-n1{margin-top:-.25rem!important}.mr-md-n1,.mx-md-n1{margin-right:-.25rem!important}.mb-md-n1,.my-md-n1{margin-bottom:-.25rem!important}.ml-md-n1,.mx-md-n1{margin-left:-.25rem!important}.m-md-n2{margin:-.5rem!important}.mt-md-n2,.my-md-n2{margin-top:-.5rem!important}.mr-md-n2,.mx-md-n2{margin-right:-.5rem!important}.mb-md-n2,.my-md-n2{margin-bottom:-.5rem!important}.ml-md-n2,.mx-md-n2{margin-left:-.5rem!important}.m-md-n3{margin:-1rem!important}.mt-md-n3,.my-md-n3{margin-top:-1rem!important}.mr-md-n3,.mx-md-n3{margin-right:-1rem!important}.mb-md-n3,.my-md-n3{margin-bottom:-1rem!important}.ml-md-n3,.mx-md-n3{margin-left:-1rem!important}.m-md-n4{margin:-1.5rem!important}.mt-md-n4,.my-md-n4{margin-top:-1.5rem!important}.mr-md-n4,.mx-md-n4{margin-right:-1.5rem!important}.mb-md-n4,.my-md-n4{margin-bottom:-1.5rem!important}.ml-md-n4,.mx-md-n4{margin-left:-1.5rem!important}.m-md-n5{margin:-3rem!important}.mt-md-n5,.my-md-n5{margin-top:-3rem!important}.mr-md-n5,.mx-md-n5{margin-right:-3rem!important}.mb-md-n5,.my-md-n5{margin-bottom:-3rem!important}.ml-md-n5,.mx-md-n5{margin-left:-3rem!important}.m-md-auto{margin:auto!important}.mt-md-auto,.my-md-auto{margin-top:auto!important}.mr-md-auto,.mx-md-auto{margin-right:auto!important}.mb-md-auto,.my-md-auto{margin-bottom:auto!important}.ml-md-auto,.mx-md-auto{margin-left:auto!important}}@media (min-width:992px){.m-lg-0{margin:0!important}.mt-lg-0,.my-lg-0{margin-top:0!important}.mr-lg-0,.mx-lg-0{margin-right:0!important}.mb-lg-0,.my-lg-0{margin-bottom:0!important}.ml-lg-0,.mx-lg-0{margin-left:0!important}.m-lg-1{margin:.25rem!important}.mt-lg-1,.my-lg-1{margin-top:.25rem!important}.mr-lg-1,.mx-lg-1{margin-right:.25rem!important}.mb-lg-1,.my-lg-1{margin-bottom:.25rem!important}.ml-lg-1,.mx-lg-1{margin-left:.25rem!important}.m-lg-2{margin:.5rem!important}.mt-lg-2,.my-lg-2{margin-top:.5rem!important}.mr-lg-2,.mx-lg-2{margin-right:.5rem!important}.mb-lg-2,.my-lg-2{margin-bottom:.5rem!important}.ml-lg-2,.mx-lg-2{margin-left:.5rem!important}.m-lg-3{margin:1rem!important}.mt-lg-3,.my-lg-3{margin-top:1rem!important}.mr-lg-3,.mx-lg-3{margin-right:1rem!important}.mb-lg-3,.my-lg-3{margin-bottom:1rem!important}.ml-lg-3,.mx-lg-3{margin-left:1rem!important}.m-lg-4{margin:1.5rem!important}.mt-lg-4,.my-lg-4{margin-top:1.5rem!important}.mr-lg-4,.mx-lg-4{margin-right:1.5rem!important}.mb-lg-4,.my-lg-4{margin-bottom:1.5rem!important}.ml-lg-4,.mx-lg-4{margin-left:1.5rem!important}.m-lg-5{margin:3rem!important}.mt-lg-5,.my-lg-5{margin-top:3rem!important}.mr-lg-5,.mx-lg-5{margin-right:3rem!important}.mb-lg-5,.my-lg-5{margin-bottom:3rem!important}.ml-lg-5,.mx-lg-5{margin-left:3rem!important}.p-lg-0{padding:0!important}.pt-lg-0,.py-lg-0{padding-top:0!important}.pr-lg-0,.px-lg-0{padding-right:0!important}.pb-lg-0,.py-lg-0{padding-bottom:0!important}.pl-lg-0,.px-lg-0{padding-left:0!important}.p-lg-1{padding:.25rem!important}.pt-lg-1,.py-lg-1{padding-top:.25rem!important}.pr-lg-1,.px-lg-1{padding-right:.25rem!important}.pb-lg-1,.py-lg-1{padding-bottom:.25rem!important}.pl-lg-1,.px-lg-1{padding-left:.25rem!important}.p-lg-2{padding:.5rem!important}.pt-lg-2,.py-lg-2{padding-top:.5rem!important}.pr-lg-2,.px-lg-2{padding-right:.5rem!important}.pb-lg-2,.py-lg-2{padding-bottom:.5rem!important}.pl-lg-2,.px-lg-2{padding-left:.5rem!important}.p-lg-3{padding:1rem!important}.pt-lg-3,.py-lg-3{padding-top:1rem!important}.pr-lg-3,.px-lg-3{padding-right:1rem!important}.pb-lg-3,.py-lg-3{padding-bottom:1rem!important}.pl-lg-3,.px-lg-3{padding-left:1rem!important}.p-lg-4{padding:1.5rem!important}.pt-lg-4,.py-lg-4{padding-top:1.5rem!important}.pr-lg-4,.px-lg-4{padding-right:1.5rem!important}.pb-lg-4,.py-lg-4{padding-bottom:1.5rem!important}.pl-lg-4,.px-lg-4{padding-left:1.5rem!important}.p-lg-5{padding:3rem!important}.pt-lg-5,.py-lg-5{padding-top:3rem!important}.pr-lg-5,.px-lg-5{padding-right:3rem!important}.pb-lg-5,.py-lg-5{padding-bottom:3rem!important}.pl-lg-5,.px-lg-5{padding-left:3rem!important}.m-lg-n1{margin:-.25rem!important}.mt-lg-n1,.my-lg-n1{margin-top:-.25rem!important}.mr-lg-n1,.mx-lg-n1{margin-right:-.25rem!important}.mb-lg-n1,.my-lg-n1{margin-bottom:-.25rem!important}.ml-lg-n1,.mx-lg-n1{margin-left:-.25rem!important}.m-lg-n2{margin:-.5rem!important}.mt-lg-n2,.my-lg-n2{margin-top:-.5rem!important}.mr-lg-n2,.mx-lg-n2{margin-right:-.5rem!important}.mb-lg-n2,.my-lg-n2{margin-bottom:-.5rem!important}.ml-lg-n2,.mx-lg-n2{margin-left:-.5rem!important}.m-lg-n3{margin:-1rem!important}.mt-lg-n3,.my-lg-n3{margin-top:-1rem!important}.mr-lg-n3,.mx-lg-n3{margin-right:-1rem!important}.mb-lg-n3,.my-lg-n3{margin-bottom:-1rem!important}.ml-lg-n3,.mx-lg-n3{margin-left:-1rem!important}.m-lg-n4{margin:-1.5rem!important}.mt-lg-n4,.my-lg-n4{margin-top:-1.5rem!important}.mr-lg-n4,.mx-lg-n4{margin-right:-1.5rem!important}.mb-lg-n4,.my-lg-n4{margin-bottom:-1.5rem!important}.ml-lg-n4,.mx-lg-n4{margin-left:-1.5rem!important}.m-lg-n5{margin:-3rem!important}.mt-lg-n5,.my-lg-n5{margin-top:-3rem!important}.mr-lg-n5,.mx-lg-n5{margin-right:-3rem!important}.mb-lg-n5,.my-lg-n5{margin-bottom:-3rem!important}.ml-lg-n5,.mx-lg-n5{margin-left:-3rem!important}.m-lg-auto{margin:auto!important}.mt-lg-auto,.my-lg-auto{margin-top:auto!important}.mr-lg-auto,.mx-lg-auto{margin-right:auto!important}.mb-lg-auto,.my-lg-auto{margin-bottom:auto!important}.ml-lg-auto,.mx-lg-auto{margin-left:auto!important}}@media (min-width:1200px){.m-xl-0{margin:0!important}.mt-xl-0,.my-xl-0{margin-top:0!important}.mr-xl-0,.mx-xl-0{margin-right:0!important}.mb-xl-0,.my-xl-0{margin-bottom:0!important}.ml-xl-0,.mx-xl-0{margin-left:0!important}.m-xl-1{margin:.25rem!important}.mt-xl-1,.my-xl-1{margin-top:.25rem!important}.mr-xl-1,.mx-xl-1{margin-right:.25rem!important}.mb-xl-1,.my-xl-1{margin-bottom:.25rem!important}.ml-xl-1,.mx-xl-1{margin-left:.25rem!important}.m-xl-2{margin:.5rem!important}.mt-xl-2,.my-xl-2{margin-top:.5rem!important}.mr-xl-2,.mx-xl-2{margin-right:.5rem!important}.mb-xl-2,.my-xl-2{margin-bottom:.5rem!important}.ml-xl-2,.mx-xl-2{margin-left:.5rem!important}.m-xl-3{margin:1rem!important}.mt-xl-3,.my-xl-3{margin-top:1rem!important}.mr-xl-3,.mx-xl-3{margin-right:1rem!important}.mb-xl-3,.my-xl-3{margin-bottom:1rem!important}.ml-xl-3,.mx-xl-3{margin-left:1rem!important}.m-xl-4{margin:1.5rem!important}.mt-xl-4,.my-xl-4{margin-top:1.5rem!important}.mr-xl-4,.mx-xl-4{margin-right:1.5rem!important}.mb-xl-4,.my-xl-4{margin-bottom:1.5rem!important}.ml-xl-4,.mx-xl-4{margin-left:1.5rem!important}.m-xl-5{margin:3rem!important}.mt-xl-5,.my-xl-5{margin-top:3rem!important}.mr-xl-5,.mx-xl-5{margin-right:3rem!important}.mb-xl-5,.my-xl-5{margin-bottom:3rem!important}.ml-xl-5,.mx-xl-5{margin-left:3rem!important}.p-xl-0{padding:0!important}.pt-xl-0,.py-xl-0{padding-top:0!important}.pr-xl-0,.px-xl-0{padding-right:0!important}.pb-xl-0,.py-xl-0{padding-bottom:0!important}.pl-xl-0,.px-xl-0{padding-left:0!important}.p-xl-1{padding:.25rem!important}.pt-xl-1,.py-xl-1{padding-top:.25rem!important}.pr-xl-1,.px-xl-1{padding-right:.25rem!important}.pb-xl-1,.py-xl-1{padding-bottom:.25rem!important}.pl-xl-1,.px-xl-1{padding-left:.25rem!important}.p-xl-2{padding:.5rem!important}.pt-xl-2,.py-xl-2{padding-top:.5rem!important}.pr-xl-2,.px-xl-2{padding-right:.5rem!important}.pb-xl-2,.py-xl-2{padding-bottom:.5rem!important}.pl-xl-2,.px-xl-2{padding-left:.5rem!important}.p-xl-3{padding:1rem!important}.pt-xl-3,.py-xl-3{padding-top:1rem!important}.pr-xl-3,.px-xl-3{padding-right:1rem!important}.pb-xl-3,.py-xl-3{padding-bottom:1rem!important}.pl-xl-3,.px-xl-3{padding-left:1rem!important}.p-xl-4{padding:1.5rem!important}.pt-xl-4,.py-xl-4{padding-top:1.5rem!important}.pr-xl-4,.px-xl-4{padding-right:1.5rem!important}.pb-xl-4,.py-xl-4{padding-bottom:1.5rem!important}.pl-xl-4,.px-xl-4{padding-left:1.5rem!important}.p-xl-5{padding:3rem!important}.pt-xl-5,.py-xl-5{padding-top:3rem!important}.pr-xl-5,.px-xl-5{padding-right:3rem!important}.pb-xl-5,.py-xl-5{padding-bottom:3rem!important}.pl-xl-5,.px-xl-5{padding-left:3rem!important}.m-xl-n1{margin:-.25rem!important}.mt-xl-n1,.my-xl-n1{margin-top:-.25rem!important}.mr-xl-n1,.mx-xl-n1{margin-right:-.25rem!important}.mb-xl-n1,.my-xl-n1{margin-bottom:-.25rem!important}.ml-xl-n1,.mx-xl-n1{margin-left:-.25rem!important}.m-xl-n2{margin:-.5rem!important}.mt-xl-n2,.my-xl-n2{margin-top:-.5rem!important}.mr-xl-n2,.mx-xl-n2{margin-right:-.5rem!important}.mb-xl-n2,.my-xl-n2{margin-bottom:-.5rem!important}.ml-xl-n2,.mx-xl-n2{margin-left:-.5rem!important}.m-xl-n3{margin:-1rem!important}.mt-xl-n3,.my-xl-n3{margin-top:-1rem!important}.mr-xl-n3,.mx-xl-n3{margin-right:-1rem!important}.mb-xl-n3,.my-xl-n3{margin-bottom:-1rem!important}.ml-xl-n3,.mx-xl-n3{margin-left:-1rem!important}.m-xl-n4{margin:-1.5rem!important}.mt-xl-n4,.my-xl-n4{margin-top:-1.5rem!important}.mr-xl-n4,.mx-xl-n4{margin-right:-1.5rem!important}.mb-xl-n4,.my-xl-n4{margin-bottom:-1.5rem!important}.ml-xl-n4,.mx-xl-n4{margin-left:-1.5rem!important}.m-xl-n5{margin:-3rem!important}.mt-xl-n5,.my-xl-n5{margin-top:-3rem!important}.mr-xl-n5,.mx-xl-n5{margin-right:-3rem!important}.mb-xl-n5,.my-xl-n5{margin-bottom:-3rem!important}.ml-xl-n5,.mx-xl-n5{margin-left:-3rem!important}.m-xl-auto{margin:auto!important}.mt-xl-auto,.my-xl-auto{margin-top:auto!important}.mr-xl-auto,.mx-xl-auto{margin-right:auto!important}.mb-xl-auto,.my-xl-auto{margin-bottom:auto!important}.ml-xl-auto,.mx-xl-auto{margin-left:auto!important}}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;pointer-events:auto;content:"";background-color:rgba(0,0,0,0)}.text-monospace{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace!important}.text-justify{text-align:justify!important}.text-wrap{white-space:normal!important}.text-nowrap{white-space:nowrap!important}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text-left{text-align:left!important}.text-right{text-align:right!important}.text-center{text-align:center!important}@media (min-width:576px){.text-sm-left{text-align:left!important}.text-sm-right{text-align:right!important}.text-sm-center{text-align:center!important}}@media (min-width:768px){.text-md-left{text-align:left!important}.text-md-right{text-align:right!important}.text-md-center{text-align:center!important}}@media (min-width:992px){.text-lg-left{text-align:left!important}.text-lg-right{text-align:right!important}.text-lg-center{text-align:center!important}}@media (min-width:1200px){.text-xl-left{text-align:left!important}.text-xl-right{text-align:right!important}.text-xl-center{text-align:center!important}}.text-lowercase{text-transform:lowercase!important}.text-uppercase{text-transform:uppercase!important}.text-capitalize{text-transform:capitalize!important}.font-weight-light{font-weight:300!important}.font-weight-lighter{font-weight:lighter!important}.font-weight-normal{font-weight:400!important}.font-weight-bold{font-weight:700!important}.font-weight-bolder{font-weight:bolder!important}.font-italic{font-style:italic!important}.text-white{color:#fff!important}.text-primary{color:#007bff!important}a.text-primary:focus,a.text-primary:hover{color:#0056b3!important}.text-secondary{color:#6c757d!important}a.text-secondary:focus,a.text-secondary:hover{color:#494f54!important}.text-success{color:#28a745!important}a.text-success:focus,a.text-success:hover{color:#19692c!important}.text-info{color:#17a2b8!important}a.text-info:focus,a.text-info:hover{color:#0f6674!important}.text-warning{color:#ffc107!important}a.text-warning:focus,a.text-warning:hover{color:#ba8b00!important}.text-danger{color:#dc3545!important}a.text-danger:focus,a.text-danger:hover{color:#a71d2a!important}.text-light{color:#f8f9fa!important}a.text-light:focus,a.text-light:hover{color:#cbd3da!important}.text-dark{color:#343a40!important}a.text-dark:focus,a.text-dark:hover{color:#121416!important}.text-body{color:#212529!important}.text-muted{color:#6c757d!important}.text-black-50{color:rgba(0,0,0,.5)!important}.text-white-50{color:rgba(255,255,255,.5)!important}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.text-decoration-none{text-decoration:none!important}.text-break{word-break:break-word!important;word-wrap:break-word!important}.text-reset{color:inherit!important}.visible{visibility:visible!important}.invisible{visibility:hidden!important}@media print{*,::after,::before{text-shadow:none!important;box-shadow:none!important}a:not(.btn){text-decoration:underline}abbr[title]::after{content:" (" attr(title) ")"}pre{white-space:pre-wrap!important}blockquote,pre{border:1px solid #adb5bd;page-break-inside:avoid}img,tr{page-break-inside:avoid}h2,h3,p{orphans:3;widows:3}h2,h3{page-break-after:avoid}@page{size:a3}body{min-width:992px!important}.container{min-width:992px!important}.navbar{display:none}.badge{border:1px solid #000}.table{border-collapse:collapse!important}.table td,.table th{background-color:#fff!important}.table-bordered td,.table-bordered th{border:1px solid #dee2e6!important}.table-dark{color:inherit}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#dee2e6}.table .thead-dark th{color:inherit;border-color:#dee2e6}}
/*# sourceMappingURL=bootstrap.min.css.map */ php-code-coverage/src/Report/Html/Renderer/Template/css/nv.d3.min.css 0000644 00000022530 15243417753 0021354 0 ustar 00 .nvd3 .nv-axis{pointer-events:none;opacity:1}.nvd3 .nv-axis path{fill:none;stroke:#000;stroke-opacity:.75;shape-rendering:crispEdges}.nvd3 .nv-axis path.domain{stroke-opacity:.75}.nvd3 .nv-axis.nv-x path.domain{stroke-opacity:0}.nvd3 .nv-axis line{fill:none;stroke:#e5e5e5;shape-rendering:crispEdges}.nvd3 .nv-axis .zero line,.nvd3 .nv-axis line.zero{stroke-opacity:.75}.nvd3 .nv-axis .nv-axisMaxMin text{font-weight:700}.nvd3 .x .nv-axis .nv-axisMaxMin text,.nvd3 .x2 .nv-axis .nv-axisMaxMin text,.nvd3 .x3 .nv-axis .nv-axisMaxMin text{text-anchor:middle}.nvd3 .nv-axis.nv-disabled{opacity:0}.nvd3 .nv-bars rect{fill-opacity:.75;transition:fill-opacity 250ms linear;-moz-transition:fill-opacity 250ms linear;-webkit-transition:fill-opacity 250ms linear}.nvd3 .nv-bars rect.hover{fill-opacity:1}.nvd3 .nv-bars .hover rect{fill:#add8e6}.nvd3 .nv-bars text{fill:rgba(0,0,0,0)}.nvd3 .nv-bars .hover text{fill:rgba(0,0,0,1)}.nvd3 .nv-multibar .nv-groups rect,.nvd3 .nv-multibarHorizontal .nv-groups rect,.nvd3 .nv-discretebar .nv-groups rect{stroke-opacity:0;transition:fill-opacity 250ms linear;-moz-transition:fill-opacity 250ms linear;-webkit-transition:fill-opacity 250ms linear}.nvd3 .nv-multibar .nv-groups rect:hover,.nvd3 .nv-multibarHorizontal .nv-groups rect:hover,.nvd3 .nv-candlestickBar .nv-ticks rect:hover,.nvd3 .nv-discretebar .nv-groups rect:hover{fill-opacity:1}.nvd3 .nv-discretebar .nv-groups text,.nvd3 .nv-multibarHorizontal .nv-groups text{font-weight:700;fill:rgba(0,0,0,1);stroke:rgba(0,0,0,0)}.nvd3 .nv-boxplot circle{fill-opacity:.5}.nvd3 .nv-boxplot circle:hover{fill-opacity:1}.nvd3 .nv-boxplot rect:hover{fill-opacity:1}.nvd3 line.nv-boxplot-median{stroke:#000}.nv-boxplot-tick:hover{stroke-width:2.5px}.nvd3.nv-bullet{font:10px sans-serif}.nvd3.nv-bullet .nv-measure{fill-opacity:.8}.nvd3.nv-bullet .nv-measure:hover{fill-opacity:1}.nvd3.nv-bullet .nv-marker{stroke:#000;stroke-width:2px}.nvd3.nv-bullet .nv-markerTriangle{stroke:#000;fill:#fff;stroke-width:1.5px}.nvd3.nv-bullet .nv-tick line{stroke:#666;stroke-width:.5px}.nvd3.nv-bullet .nv-range.nv-s0{fill:#eee}.nvd3.nv-bullet .nv-range.nv-s1{fill:#ddd}.nvd3.nv-bullet .nv-range.nv-s2{fill:#ccc}.nvd3.nv-bullet .nv-title{font-size:14px;font-weight:700}.nvd3.nv-bullet .nv-subtitle{fill:#999}.nvd3.nv-bullet .nv-range{fill:#bababa;fill-opacity:.4}.nvd3.nv-bullet .nv-range:hover{fill-opacity:.7}.nvd3.nv-candlestickBar .nv-ticks .nv-tick{stroke-width:1px}.nvd3.nv-candlestickBar .nv-ticks .nv-tick.hover{stroke-width:2px}.nvd3.nv-candlestickBar .nv-ticks .nv-tick.positive rect{stroke:#2ca02c;fill:#2ca02c}.nvd3.nv-candlestickBar .nv-ticks .nv-tick.negative rect{stroke:#d62728;fill:#d62728}.with-transitions .nv-candlestickBar .nv-ticks .nv-tick{transition:stroke-width 250ms linear,stroke-opacity 250ms linear;-moz-transition:stroke-width 250ms linear,stroke-opacity 250ms linear;-webkit-transition:stroke-width 250ms linear,stroke-opacity 250ms linear}.nvd3.nv-candlestickBar .nv-ticks line{stroke:#333}.nvd3 .nv-legend .nv-disabled rect{}.nvd3 .nv-check-box .nv-box{fill-opacity:0;stroke-width:2}.nvd3 .nv-check-box .nv-check{fill-opacity:0;stroke-width:4}.nvd3 .nv-series.nv-disabled .nv-check-box .nv-check{fill-opacity:0;stroke-opacity:0}.nvd3 .nv-controlsWrap .nv-legend .nv-check-box .nv-check{opacity:0}.nvd3.nv-linePlusBar .nv-bar rect{fill-opacity:.75}.nvd3.nv-linePlusBar .nv-bar rect:hover{fill-opacity:1}.nvd3 .nv-groups path.nv-line{fill:none}.nvd3 .nv-groups path.nv-area{stroke:none}.nvd3.nv-line .nvd3.nv-scatter .nv-groups .nv-point{fill-opacity:0;stroke-opacity:0}.nvd3.nv-scatter.nv-single-point .nv-groups .nv-point{fill-opacity:.5!important;stroke-opacity:.5!important}.with-transitions .nvd3 .nv-groups .nv-point{transition:stroke-width 250ms linear,stroke-opacity 250ms linear;-moz-transition:stroke-width 250ms linear,stroke-opacity 250ms linear;-webkit-transition:stroke-width 250ms linear,stroke-opacity 250ms linear}.nvd3.nv-scatter .nv-groups .nv-point.hover,.nvd3 .nv-groups .nv-point.hover{stroke-width:7px;fill-opacity:.95!important;stroke-opacity:.95!important}.nvd3 .nv-point-paths path{stroke:#aaa;stroke-opacity:0;fill:#eee;fill-opacity:0}.nvd3 .nv-indexLine{cursor:ew-resize}svg.nvd3-svg{-webkit-touch-callout:none;-webkit-user-select:none;-khtml-user-select:none;-ms-user-select:none;-moz-user-select:none;user-select:none;display:block;width:100%;height:100%}.nvtooltip.with-3d-shadow,.with-3d-shadow .nvtooltip{-moz-box-shadow:0 5px 10px rgba(0,0,0,.2);-webkit-box-shadow:0 5px 10px rgba(0,0,0,.2);box-shadow:0 5px 10px rgba(0,0,0,.2);-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.nvd3 text{font:400 12px Arial}.nvd3 .title{font:700 14px Arial}.nvd3 .nv-background{fill:#fff;fill-opacity:0}.nvd3.nv-noData{font-size:18px;font-weight:700}.nv-brush .extent{fill-opacity:.125;shape-rendering:crispEdges}.nv-brush .resize path{fill:#eee;stroke:#666}.nvd3 .nv-legend .nv-series{cursor:pointer}.nvd3 .nv-legend .nv-disabled circle{fill-opacity:0}.nvd3 .nv-brush .extent{fill-opacity:0!important}.nvd3 .nv-brushBackground rect{stroke:#000;stroke-width:.4;fill:#fff;fill-opacity:.7}.nvd3.nv-ohlcBar .nv-ticks .nv-tick{stroke-width:1px}.nvd3.nv-ohlcBar .nv-ticks .nv-tick.hover{stroke-width:2px}.nvd3.nv-ohlcBar .nv-ticks .nv-tick.positive{stroke:#2ca02c}.nvd3.nv-ohlcBar .nv-ticks .nv-tick.negative{stroke:#d62728}.nvd3 .background path{fill:none;stroke:#EEE;stroke-opacity:.4;shape-rendering:crispEdges}.nvd3 .foreground path{fill:none;stroke-opacity:.7}.nvd3 .nv-parallelCoordinates-brush .extent{fill:#fff;fill-opacity:.6;stroke:gray;shape-rendering:crispEdges}.nvd3 .nv-parallelCoordinates .hover{fill-opacity:1;stroke-width:3px}.nvd3 .missingValuesline line{fill:none;stroke:#000;stroke-width:1;stroke-opacity:1;stroke-dasharray:5,5}.nvd3.nv-pie path{stroke-opacity:0;transition:fill-opacity 250ms linear,stroke-width 250ms linear,stroke-opacity 250ms linear;-moz-transition:fill-opacity 250ms linear,stroke-width 250ms linear,stroke-opacity 250ms linear;-webkit-transition:fill-opacity 250ms linear,stroke-width 250ms linear,stroke-opacity 250ms linear}.nvd3.nv-pie .nv-pie-title{font-size:24px;fill:rgba(19,196,249,.59)}.nvd3.nv-pie .nv-slice text{stroke:#000;stroke-width:0}.nvd3.nv-pie path{stroke:#fff;stroke-width:1px;stroke-opacity:1}.nvd3.nv-pie .hover path{fill-opacity:.7}.nvd3.nv-pie .nv-label{pointer-events:none}.nvd3.nv-pie .nv-label rect{fill-opacity:0;stroke-opacity:0}.nvd3 .nv-groups .nv-point.hover{stroke-width:20px;stroke-opacity:.5}.nvd3 .nv-scatter .nv-point.hover{fill-opacity:1}.nv-noninteractive{pointer-events:none}.nv-distx,.nv-disty{pointer-events:none}.nvd3.nv-sparkline path{fill:none}.nvd3.nv-sparklineplus g.nv-hoverValue{pointer-events:none}.nvd3.nv-sparklineplus .nv-hoverValue line{stroke:#333;stroke-width:1.5px}.nvd3.nv-sparklineplus,.nvd3.nv-sparklineplus g{pointer-events:all}.nvd3 .nv-hoverArea{fill-opacity:0;stroke-opacity:0}.nvd3.nv-sparklineplus .nv-xValue,.nvd3.nv-sparklineplus .nv-yValue{stroke-width:0;font-size:.9em;font-weight:400}.nvd3.nv-sparklineplus .nv-yValue{stroke:#f66}.nvd3.nv-sparklineplus .nv-maxValue{stroke:#2ca02c;fill:#2ca02c}.nvd3.nv-sparklineplus .nv-minValue{stroke:#d62728;fill:#d62728}.nvd3.nv-sparklineplus .nv-currentValue{font-weight:700;font-size:1.1em}.nvd3.nv-stackedarea path.nv-area{fill-opacity:.7;stroke-opacity:0;transition:fill-opacity 250ms linear,stroke-opacity 250ms linear;-moz-transition:fill-opacity 250ms linear,stroke-opacity 250ms linear;-webkit-transition:fill-opacity 250ms linear,stroke-opacity 250ms linear}.nvd3.nv-stackedarea path.nv-area.hover{fill-opacity:.9}.nvd3.nv-stackedarea .nv-groups .nv-point{stroke-opacity:0;fill-opacity:0}.nvtooltip{position:absolute;background-color:rgba(255,255,255,1);color:rgba(0,0,0,1);padding:1px;border:1px solid rgba(0,0,0,.2);z-index:10000;display:block;font-family:Arial;font-size:13px;text-align:left;pointer-events:none;white-space:nowrap;-webkit-touch-callout:none;-webkit-user-select:none;-khtml-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.nvtooltip{background:rgba(255,255,255,.8);border:1px solid rgba(0,0,0,.5);border-radius:4px}.nvtooltip.with-transitions,.with-transitions .nvtooltip{transition:opacity 50ms linear;-moz-transition:opacity 50ms linear;-webkit-transition:opacity 50ms linear;transition-delay:200ms;-moz-transition-delay:200ms;-webkit-transition-delay:200ms}.nvtooltip.x-nvtooltip,.nvtooltip.y-nvtooltip{padding:8px}.nvtooltip h3{margin:0;padding:4px 14px;line-height:18px;font-weight:400;background-color:rgba(247,247,247,.75);color:rgba(0,0,0,1);text-align:center;border-bottom:1px solid #ebebeb;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0}.nvtooltip p{margin:0;padding:5px 14px;text-align:center}.nvtooltip span{display:inline-block;margin:2px 0}.nvtooltip table{margin:6px;border-spacing:0}.nvtooltip table td{padding:2px 9px 2px 0;vertical-align:middle}.nvtooltip table td.key{font-weight:400}.nvtooltip table td.value{text-align:right;font-weight:700}.nvtooltip table tr.highlight td{padding:1px 9px 1px 0;border-bottom-style:solid;border-bottom-width:1px;border-top-style:solid;border-top-width:1px}.nvtooltip table td.legend-color-guide div{width:8px;height:8px;vertical-align:middle}.nvtooltip table td.legend-color-guide div{width:12px;height:12px;border:1px solid #999}.nvtooltip .footer{padding:3px;text-align:center}.nvtooltip-pending-removal{pointer-events:none;display:none}.nvd3 .nv-interactiveGuideLine{pointer-events:none}.nvd3 line.nv-guideline{stroke:#ccc} php-code-coverage/src/Report/Html/Renderer/Template/css/octicons.css 0000644 00000000130 15243417753 0021453 0 ustar 00 .octicon {
display: inline-block;
vertical-align: text-top;
fill: currentColor;
}
php-code-coverage/src/Report/Html/Renderer/Template/css/style.css 0000644 00000005110 15243417753 0020775 0 ustar 00 body {
font-family: sans-serif;
font-size: 1em;
font-kerning: normal;
font-variant-ligatures: common-ligatures;
text-rendering: optimizeLegibility;
padding-top: 10px;
}
.popover {
max-width: none;
}
.octicon {
margin-right:.25em;
vertical-align: baseline;
width: 0.75em;
}
.table-bordered>thead>tr>td {
border-bottom-width: 1px;
}
.table tbody>tr>td, .table thead>tr>td {
padding-top: 3px;
padding-bottom: 3px;
}
.table-condensed tbody>tr>td {
padding-top: 0;
padding-bottom: 0;
}
.table .progress {
margin-bottom: inherit;
}
.table-borderless th, .table-borderless td {
border: 0 !important;
}
.table tbody tr.covered-by-large-tests, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
background-color: {{success-low}};
}
.table tbody tr.covered-by-medium-tests, li.covered-by-medium-tests {
background-color: {{success-medium}};
}
.table tbody tr.covered-by-small-tests, li.covered-by-small-tests {
background-color: {{success-high}};
}
.table tbody tr.warning, .table tbody td.warning, li.warning, span.warning {
background-color: {{warning}};
}
.table tbody tr.danger, .table tbody td.danger, li.danger, span.danger {
background-color: {{danger}};
}
.table tbody td.info {
background-color: #d9edf7;
}
td.big {
vertical-align: middle;
width: 117px;
}
td.small {
}
td.codeLine {
font-family: "Source Code Pro", "SFMono-Regular", Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
white-space: pre-wrap;
}
td span.comment {
color: #888a85;
}
td span.default {
color: #2e3436;
}
td span.html {
color: #888a85;
}
td span.keyword {
color: #2e3436;
font-weight: bold;
}
pre span.string {
color: #2e3436;
}
span.success, span.warning, span.danger {
margin-right: 2px;
padding-left: 10px;
padding-right: 10px;
text-align: center;
}
#toplink {
position: fixed;
left: 5px;
bottom: 5px;
outline: 0;
}
svg text {
font-family: "Lucida Grande", "Lucida Sans Unicode", Verdana, Arial, Helvetica, sans-serif;
font-size: 11px;
color: #666;
fill: #666;
}
.scrollbox {
height:245px;
overflow-x:scroll;
overflow-y:scroll;
}
table + .structure-heading {
border-top: 1px solid lightgrey;
padding-top: 0.5em;
}
.legend {
font-weight: bold;
margin-right: 2px;
padding-left: 10px;
padding-right: 10px;
text-align: center;
}
.covered-by-small-tests {
background-color: {{success-high}};
}
.covered-by-medium-tests {
background-color: {{success-medium}};
}
.covered-by-large-tests {
background-color: {{success-low}};
}
.not-covered {
background-color: {{danger}};
}
.not-coverable {
background-color: {{warning}};
}
php-code-coverage/src/Report/Html/Renderer/Template/css/custom.css 0000644 00000000000 15243417753 0021140 0 ustar 00 php-code-coverage/src/Report/Html/Renderer/Template/method_item_branch.html.dist 0000644 00000002245 15243417753 0024004 0 ustar 00 <tr>
<td class="{{lines_level}}">{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{branches_level}} big">{{branches_bar}}</td>
<td class="{{branches_level}} small"><div align="right">{{branches_executed_percent}}</div></td>
<td class="{{branches_level}} small"><div align="right">{{branches_number}}</div></td>
<td class="{{paths_level}} big">{{paths_bar}}</td>
<td class="{{paths_level}} small"><div align="right">{{paths_executed_percent}}</div></td>
<td class="{{paths_level}} small"><div align="right">{{paths_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{methods_level}} small">{{crap}}</td>
<td class="{{methods_level}}" colspan="3"></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/file.html.dist 0000644 00000004520 15243417753 0021106 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Code Coverage for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/octicons.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="table-responsive">
<table class="table table-bordered">
<thead>
<tr>
<td> </td>
<td colspan="10"><div align="center"><strong>Code Coverage</strong></div></td>
</tr>
<tr>
<td> </td>
<td colspan="3"><div align="center"><strong>Lines</strong></div></td>
<td colspan="4"><div align="center"><strong>Functions and Methods</strong></div></td>
<td colspan="3"><div align="center"><strong>Classes and Traits</strong></div></td>
</tr>
</thead>
<tbody>
{{items}}
</tbody>
</table>
</div>
{{lines}}
{{structure}}
<footer>
<hr/>
<h4>Legend</h4>
{{legend}}
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
<a title="Back to the top" id="toplink" href="#">
<svg xmlns="http://www.w3.org/2000/svg" width="12" height="16" viewBox="0 0 12 16"><path fill-rule="evenodd" d="M12 11L6 5l-6 6h12z"/></svg>
</a>
</footer>
</div>
<script src="{{path_to_root}}_js/jquery.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/popper.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/bootstrap.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/file.js?v={{version}}" type="text/javascript"></script>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Template/file_item_branch.html.dist 0000644 00000002554 15243417753 0023446 0 ustar 00 <tr>
<td class="{{lines_level}}">{{name}}</td>
<td class="{{lines_level}} big">{{lines_bar}}</td>
<td class="{{lines_level}} small"><div align="right">{{lines_executed_percent}}</div></td>
<td class="{{lines_level}} small"><div align="right">{{lines_number}}</div></td>
<td class="{{branches_level}} big">{{branches_bar}}</td>
<td class="{{branches_level}} small"><div align="right">{{branches_executed_percent}}</div></td>
<td class="{{branches_level}} small"><div align="right">{{branches_number}}</div></td>
<td class="{{paths_level}} big">{{paths_bar}}</td>
<td class="{{paths_level}} small"><div align="right">{{paths_executed_percent}}</div></td>
<td class="{{paths_level}} small"><div align="right">{{paths_number}}</div></td>
<td class="{{methods_level}} big">{{methods_bar}}</td>
<td class="{{methods_level}} small"><div align="right">{{methods_tested_percent}}</div></td>
<td class="{{methods_level}} small"><div align="right">{{methods_number}}</div></td>
<td class="{{methods_level}} small">{{crap}}</td>
<td class="{{classes_level}} big">{{classes_bar}}</td>
<td class="{{classes_level}} small"><div align="right">{{classes_tested_percent}}</div></td>
<td class="{{classes_level}} small"><div align="right">{{classes_number}}</div></td>
</tr>
php-code-coverage/src/Report/Html/Renderer/Template/line.html.dist 0000644 00000000305 15243417753 0021113 0 ustar 00 <tr class="{{class}} d-flex"><td {{popover}} class="col-1 text-right"><a id="{{lineNumber}}" href="#{{lineNumber}}">{{lineNumber}}</a></td><td class="col-11 codeLine">{{lineContent}}</td></tr>
php-code-coverage/src/Report/Html/Renderer/Template/file_branch.html.dist 0000644 00000004755 15243417753 0022435 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Code Coverage for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/octicons.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="table-responsive">
<table class="table table-bordered">
<thead>
<tr>
<td> </td>
<td colspan="16"><div align="center"><strong>Code Coverage</strong></div></td>
</tr>
<tr>
<td> </td>
<td colspan="3"><div align="center"><strong>Lines</strong></div></td>
<td colspan="3"><div align="center"><strong>Branches</strong></div></td>
<td colspan="3"><div align="center"><strong>Paths</strong></div></td>
<td colspan="4"><div align="center"><strong>Functions and Methods</strong></div></td>
<td colspan="3"><div align="center"><strong>Classes and Traits</strong></div></td>
</tr>
</thead>
<tbody>
{{items}}
</tbody>
</table>
</div>
{{lines}}
{{structure}}
<footer>
<hr/>
<h4>Legend</h4>
{{legend}}
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
<a title="Back to the top" id="toplink" href="#">
<svg xmlns="http://www.w3.org/2000/svg" width="12" height="16" viewBox="0 0 12 16"><path fill-rule="evenodd" d="M12 11L6 5l-6 6h12z"/></svg>
</a>
</footer>
</div>
<script src="{{path_to_root}}_js/jquery.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/popper.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/bootstrap.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/file.js?v={{version}}" type="text/javascript"></script>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Template/directory.html.dist 0000644 00000003766 15243417753 0022206 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Code Coverage for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/octicons.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="table-responsive">
<table class="table table-bordered">
<thead>
<tr>
<td> </td>
<td colspan="9"><div align="center"><strong>Code Coverage</strong></div></td>
</tr>
<tr>
<td> </td>
<td colspan="3"><div align="center"><strong>Lines</strong></div></td>
<td colspan="3"><div align="center"><strong>Functions and Methods</strong></div></td>
<td colspan="3"><div align="center"><strong>Classes and Traits</strong></div></td>
</tr>
</thead>
<tbody>
{{items}}
</tbody>
</table>
</div>
<footer>
<hr/>
<h4>Legend</h4>
<p>
<span class="danger"><strong>Low</strong>: 0% to {{low_upper_bound}}%</span>
<span class="warning"><strong>Medium</strong>: {{low_upper_bound}}% to {{high_lower_bound}}%</span>
<span class="success"><strong>High</strong>: {{high_lower_bound}}% to 100%</span>
</p>
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
</footer>
</div>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Template/lines.html.dist 0000644 00000000145 15243417753 0021300 0 ustar 00 <table id="code" class="table table-borderless table-condensed">
<tbody>
{{lines}}
</tbody>
</table>
php-code-coverage/src/Report/Html/Renderer/Template/paths.html.dist 0000644 00000000762 15243417753 0021312 0 ustar 00 <hr/>
<h4>Paths</h4>
<p>
Below are the source code lines that represent each code path as identified by Xdebug. Please note a path is not
necessarily coterminous with a line, a line may contain multiple paths and therefore show up more than once.
Please also be aware that some paths may include implicit rather than explicit branches, e.g. an <code>if</code> statement
<i>always</i> has an <code>else</code> as part of its logical flow even if you didn't write one.
</p>
{{paths}}
php-code-coverage/src/Report/Html/Renderer/Template/dashboard_branch.html.dist 0000644 00000015633 15243417753 0023442 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Dashboard for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/nv.d3.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<h2>Classes</h2>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Coverage Distribution</h3>
<div id="classCoverageDistribution" style="height: 300px;">
<svg></svg>
</div>
</div>
<div class="col-md-6">
<h3>Complexity</h3>
<div id="classComplexity" style="height: 300px;">
<svg></svg>
</div>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Insufficient Coverage</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Class</th>
<th class="text-right">Coverage</th>
</tr>
</thead>
<tbody>
{{insufficient_coverage_classes}}
</tbody>
</table>
</div>
</div>
<div class="col-md-6">
<h3>Project Risks</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Class</th>
<th class="text-right"><abbr title="Change Risk Anti-Patterns (CRAP) Index">CRAP</abbr></th>
</tr>
</thead>
<tbody>
{{project_risks_classes}}
</tbody>
</table>
</div>
</div>
</div>
<div class="row">
<div class="col-md-12">
<h2>Methods</h2>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Coverage Distribution</h3>
<div id="methodCoverageDistribution" style="height: 300px;">
<svg></svg>
</div>
</div>
<div class="col-md-6">
<h3>Complexity</h3>
<div id="methodComplexity" style="height: 300px;">
<svg></svg>
</div>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Insufficient Coverage</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Method</th>
<th class="text-right">Coverage</th>
</tr>
</thead>
<tbody>
{{insufficient_coverage_methods}}
</tbody>
</table>
</div>
</div>
<div class="col-md-6">
<h3>Project Risks</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Method</th>
<th class="text-right"><abbr title="Change Risk Anti-Patterns (CRAP) Index">CRAP</abbr></th>
</tr>
</thead>
<tbody>
{{project_risks_methods}}
</tbody>
</table>
</div>
</div>
</div>
<footer>
<hr/>
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
</footer>
</div>
<script src="{{path_to_root}}_js/jquery.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/d3.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/nv.d3.min.js?v={{version}}" type="text/javascript"></script>
<script type="text/javascript">
$(document).ready(function() {
nv.addGraph(function() {
var chart = nv.models.multiBarChart();
chart.tooltips(false)
.showControls(false)
.showLegend(false)
.reduceXTicks(false)
.staggerLabels(true)
.yAxis.tickFormat(d3.format('d'));
d3.select('#classCoverageDistribution svg')
.datum(getCoverageDistributionData({{class_coverage_distribution}}, "Class Coverage"))
.transition().duration(500).call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
nv.addGraph(function() {
var chart = nv.models.multiBarChart();
chart.tooltips(false)
.showControls(false)
.showLegend(false)
.reduceXTicks(false)
.staggerLabels(true)
.yAxis.tickFormat(d3.format('d'));
d3.select('#methodCoverageDistribution svg')
.datum(getCoverageDistributionData({{method_coverage_distribution}}, "Method Coverage"))
.transition().duration(500).call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
function getCoverageDistributionData(data, label) {
var labels = [
'0%',
'0-10%',
'10-20%',
'20-30%',
'30-40%',
'40-50%',
'50-60%',
'60-70%',
'70-80%',
'80-90%',
'90-100%',
'100%'
];
var values = [];
$.each(labels, function(key) {
values.push({x: labels[key], y: data[key]});
});
return [
{
key: label,
values: values,
color: "#4572A7"
}
];
}
nv.addGraph(function() {
var chart = nv.models.scatterChart()
.showDistX(true)
.showDistY(true)
.showLegend(false)
.forceX([0, 100]);
chart.tooltipContent(function(graph) {
return '<p>' + graph.point.class + '</p>';
});
chart.xAxis.axisLabel('Code Coverage (in percent)');
chart.yAxis.axisLabel('Cyclomatic Complexity');
d3.select('#classComplexity svg')
.datum(getComplexityData({{complexity_class}}, 'Class Complexity'))
.transition()
.duration(500)
.call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
nv.addGraph(function() {
var chart = nv.models.scatterChart()
.showDistX(true)
.showDistY(true)
.showLegend(false)
.forceX([0, 100]);
chart.tooltipContent(function(graph) {
return '<p>' + graph.point.class + '</p>';
});
chart.xAxis.axisLabel('Code Coverage (in percent)');
chart.yAxis.axisLabel('Method Complexity');
d3.select('#methodComplexity svg')
.datum(getComplexityData({{complexity_method}}, 'Method Complexity'))
.transition()
.duration(500)
.call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
function getComplexityData(data, label) {
var values = [];
$.each(data, function(key) {
var value = Math.round(data[key][0]*100) / 100;
values.push({
x: value,
y: data[key][1],
class: data[key][2],
size: 0.05,
shape: 'diamond'
});
});
return [
{
key: label,
values: values,
color: "#4572A7"
}
];
}
});
</script>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Template/js/bootstrap.min.js 0000644 00000172143 15243417753 0022117 0 ustar 00 /*!
* Bootstrap v4.6.2 (https://getbootstrap.com/)
* Copyright 2011-2022 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
*/
!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("jquery"),require("popper.js")):"function"==typeof define&&define.amd?define(["exports","jquery","popper.js"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).bootstrap={},t.jQuery,t.Popper)}(this,(function(t,e,n){"use strict";function i(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var o=i(e),a=i(n);function s(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}function l(t,e,n){return e&&s(t.prototype,e),n&&s(t,n),Object.defineProperty(t,"prototype",{writable:!1}),t}function r(){return r=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(t[i]=n[i])}return t},r.apply(this,arguments)}function u(t,e){return u=Object.setPrototypeOf?Object.setPrototypeOf.bind():function(t,e){return t.__proto__=e,t},u(t,e)}var f="transitionend";var d={TRANSITION_END:"bsTransitionEnd",getUID:function(t){do{t+=~~(1e6*Math.random())}while(document.getElementById(t));return t},getSelectorFromElement:function(t){var e=t.getAttribute("data-target");if(!e||"#"===e){var n=t.getAttribute("href");e=n&&"#"!==n?n.trim():""}try{return document.querySelector(e)?e:null}catch(t){return null}},getTransitionDurationFromElement:function(t){if(!t)return 0;var e=o.default(t).css("transition-duration"),n=o.default(t).css("transition-delay"),i=parseFloat(e),a=parseFloat(n);return i||a?(e=e.split(",")[0],n=n.split(",")[0],1e3*(parseFloat(e)+parseFloat(n))):0},reflow:function(t){return t.offsetHeight},triggerTransitionEnd:function(t){o.default(t).trigger(f)},supportsTransitionEnd:function(){return Boolean(f)},isElement:function(t){return(t[0]||t).nodeType},typeCheckConfig:function(t,e,n){for(var i in n)if(Object.prototype.hasOwnProperty.call(n,i)){var o=n[i],a=e[i],s=a&&d.isElement(a)?"element":null===(l=a)||"undefined"==typeof l?""+l:{}.toString.call(l).match(/\s([a-z]+)/i)[1].toLowerCase();if(!new RegExp(o).test(s))throw new Error(t.toUpperCase()+': Option "'+i+'" provided type "'+s+'" but expected type "'+o+'".')}var l},findShadowRoot:function(t){if(!document.documentElement.attachShadow)return null;if("function"==typeof t.getRootNode){var e=t.getRootNode();return e instanceof ShadowRoot?e:null}return t instanceof ShadowRoot?t:t.parentNode?d.findShadowRoot(t.parentNode):null},jQueryDetection:function(){if("undefined"==typeof o.default)throw new TypeError("Bootstrap's JavaScript requires jQuery. jQuery must be included before Bootstrap's JavaScript.");var t=o.default.fn.jquery.split(" ")[0].split(".");if(t[0]<2&&t[1]<9||1===t[0]&&9===t[1]&&t[2]<1||t[0]>=4)throw new Error("Bootstrap's JavaScript requires at least jQuery v1.9.1 but less than v4.0.0")}};d.jQueryDetection(),o.default.fn.emulateTransitionEnd=function(t){var e=this,n=!1;return o.default(this).one(d.TRANSITION_END,(function(){n=!0})),setTimeout((function(){n||d.triggerTransitionEnd(e)}),t),this},o.default.event.special[d.TRANSITION_END]={bindType:f,delegateType:f,handle:function(t){if(o.default(t.target).is(this))return t.handleObj.handler.apply(this,arguments)}};var c="bs.alert",h=o.default.fn.alert,g=function(){function t(t){this._element=t}var e=t.prototype;return e.close=function(t){var e=this._element;t&&(e=this._getRootElement(t)),this._triggerCloseEvent(e).isDefaultPrevented()||this._removeElement(e)},e.dispose=function(){o.default.removeData(this._element,c),this._element=null},e._getRootElement=function(t){var e=d.getSelectorFromElement(t),n=!1;return e&&(n=document.querySelector(e)),n||(n=o.default(t).closest(".alert")[0]),n},e._triggerCloseEvent=function(t){var e=o.default.Event("close.bs.alert");return o.default(t).trigger(e),e},e._removeElement=function(t){var e=this;if(o.default(t).removeClass("show"),o.default(t).hasClass("fade")){var n=d.getTransitionDurationFromElement(t);o.default(t).one(d.TRANSITION_END,(function(n){return e._destroyElement(t,n)})).emulateTransitionEnd(n)}else this._destroyElement(t)},e._destroyElement=function(t){o.default(t).detach().trigger("closed.bs.alert").remove()},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this),i=n.data(c);i||(i=new t(this),n.data(c,i)),"close"===e&&i[e](this)}))},t._handleDismiss=function(t){return function(e){e&&e.preventDefault(),t.close(this)}},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}}]),t}();o.default(document).on("click.bs.alert.data-api",'[data-dismiss="alert"]',g._handleDismiss(new g)),o.default.fn.alert=g._jQueryInterface,o.default.fn.alert.Constructor=g,o.default.fn.alert.noConflict=function(){return o.default.fn.alert=h,g._jQueryInterface};var m="bs.button",p=o.default.fn.button,_="active",v='[data-toggle^="button"]',y='input:not([type="hidden"])',b=".btn",E=function(){function t(t){this._element=t,this.shouldAvoidTriggerChange=!1}var e=t.prototype;return e.toggle=function(){var t=!0,e=!0,n=o.default(this._element).closest('[data-toggle="buttons"]')[0];if(n){var i=this._element.querySelector(y);if(i){if("radio"===i.type)if(i.checked&&this._element.classList.contains(_))t=!1;else{var a=n.querySelector(".active");a&&o.default(a).removeClass(_)}t&&("checkbox"!==i.type&&"radio"!==i.type||(i.checked=!this._element.classList.contains(_)),this.shouldAvoidTriggerChange||o.default(i).trigger("change")),i.focus(),e=!1}}this._element.hasAttribute("disabled")||this._element.classList.contains("disabled")||(e&&this._element.setAttribute("aria-pressed",!this._element.classList.contains(_)),t&&o.default(this._element).toggleClass(_))},e.dispose=function(){o.default.removeData(this._element,m),this._element=null},t._jQueryInterface=function(e,n){return this.each((function(){var i=o.default(this),a=i.data(m);a||(a=new t(this),i.data(m,a)),a.shouldAvoidTriggerChange=n,"toggle"===e&&a[e]()}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}}]),t}();o.default(document).on("click.bs.button.data-api",v,(function(t){var e=t.target,n=e;if(o.default(e).hasClass("btn")||(e=o.default(e).closest(b)[0]),!e||e.hasAttribute("disabled")||e.classList.contains("disabled"))t.preventDefault();else{var i=e.querySelector(y);if(i&&(i.hasAttribute("disabled")||i.classList.contains("disabled")))return void t.preventDefault();"INPUT"!==n.tagName&&"LABEL"===e.tagName||E._jQueryInterface.call(o.default(e),"toggle","INPUT"===n.tagName)}})).on("focus.bs.button.data-api blur.bs.button.data-api",v,(function(t){var e=o.default(t.target).closest(b)[0];o.default(e).toggleClass("focus",/^focus(in)?$/.test(t.type))})),o.default(window).on("load.bs.button.data-api",(function(){for(var t=[].slice.call(document.querySelectorAll('[data-toggle="buttons"] .btn')),e=0,n=t.length;e<n;e++){var i=t[e],o=i.querySelector(y);o.checked||o.hasAttribute("checked")?i.classList.add(_):i.classList.remove(_)}for(var a=0,s=(t=[].slice.call(document.querySelectorAll('[data-toggle="button"]'))).length;a<s;a++){var l=t[a];"true"===l.getAttribute("aria-pressed")?l.classList.add(_):l.classList.remove(_)}})),o.default.fn.button=E._jQueryInterface,o.default.fn.button.Constructor=E,o.default.fn.button.noConflict=function(){return o.default.fn.button=p,E._jQueryInterface};var T="carousel",w="bs.carousel",C=o.default.fn[T],S="active",N="next",D="prev",A="slid.bs.carousel",I=".active.carousel-item",k={interval:5e3,keyboard:!0,slide:!1,pause:"hover",wrap:!0,touch:!0},O={interval:"(number|boolean)",keyboard:"boolean",slide:"(boolean|string)",pause:"(string|boolean)",wrap:"boolean",touch:"boolean"},j={TOUCH:"touch",PEN:"pen"},P=function(){function t(t,e){this._items=null,this._interval=null,this._activeElement=null,this._isPaused=!1,this._isSliding=!1,this.touchTimeout=null,this.touchStartX=0,this.touchDeltaX=0,this._config=this._getConfig(e),this._element=t,this._indicatorsElement=this._element.querySelector(".carousel-indicators"),this._touchSupported="ontouchstart"in document.documentElement||navigator.maxTouchPoints>0,this._pointerEvent=Boolean(window.PointerEvent||window.MSPointerEvent),this._addEventListeners()}var e=t.prototype;return e.next=function(){this._isSliding||this._slide(N)},e.nextWhenVisible=function(){var t=o.default(this._element);!document.hidden&&t.is(":visible")&&"hidden"!==t.css("visibility")&&this.next()},e.prev=function(){this._isSliding||this._slide(D)},e.pause=function(t){t||(this._isPaused=!0),this._element.querySelector(".carousel-item-next, .carousel-item-prev")&&(d.triggerTransitionEnd(this._element),this.cycle(!0)),clearInterval(this._interval),this._interval=null},e.cycle=function(t){t||(this._isPaused=!1),this._interval&&(clearInterval(this._interval),this._interval=null),this._config.interval&&!this._isPaused&&(this._updateInterval(),this._interval=setInterval((document.visibilityState?this.nextWhenVisible:this.next).bind(this),this._config.interval))},e.to=function(t){var e=this;this._activeElement=this._element.querySelector(I);var n=this._getItemIndex(this._activeElement);if(!(t>this._items.length-1||t<0))if(this._isSliding)o.default(this._element).one(A,(function(){return e.to(t)}));else{if(n===t)return this.pause(),void this.cycle();var i=t>n?N:D;this._slide(i,this._items[t])}},e.dispose=function(){o.default(this._element).off(".bs.carousel"),o.default.removeData(this._element,w),this._items=null,this._config=null,this._element=null,this._interval=null,this._isPaused=null,this._isSliding=null,this._activeElement=null,this._indicatorsElement=null},e._getConfig=function(t){return t=r({},k,t),d.typeCheckConfig(T,t,O),t},e._handleSwipe=function(){var t=Math.abs(this.touchDeltaX);if(!(t<=40)){var e=t/this.touchDeltaX;this.touchDeltaX=0,e>0&&this.prev(),e<0&&this.next()}},e._addEventListeners=function(){var t=this;this._config.keyboard&&o.default(this._element).on("keydown.bs.carousel",(function(e){return t._keydown(e)})),"hover"===this._config.pause&&o.default(this._element).on("mouseenter.bs.carousel",(function(e){return t.pause(e)})).on("mouseleave.bs.carousel",(function(e){return t.cycle(e)})),this._config.touch&&this._addTouchEventListeners()},e._addTouchEventListeners=function(){var t=this;if(this._touchSupported){var e=function(e){t._pointerEvent&&j[e.originalEvent.pointerType.toUpperCase()]?t.touchStartX=e.originalEvent.clientX:t._pointerEvent||(t.touchStartX=e.originalEvent.touches[0].clientX)},n=function(e){t._pointerEvent&&j[e.originalEvent.pointerType.toUpperCase()]&&(t.touchDeltaX=e.originalEvent.clientX-t.touchStartX),t._handleSwipe(),"hover"===t._config.pause&&(t.pause(),t.touchTimeout&&clearTimeout(t.touchTimeout),t.touchTimeout=setTimeout((function(e){return t.cycle(e)}),500+t._config.interval))};o.default(this._element.querySelectorAll(".carousel-item img")).on("dragstart.bs.carousel",(function(t){return t.preventDefault()})),this._pointerEvent?(o.default(this._element).on("pointerdown.bs.carousel",(function(t){return e(t)})),o.default(this._element).on("pointerup.bs.carousel",(function(t){return n(t)})),this._element.classList.add("pointer-event")):(o.default(this._element).on("touchstart.bs.carousel",(function(t){return e(t)})),o.default(this._element).on("touchmove.bs.carousel",(function(e){return function(e){t.touchDeltaX=e.originalEvent.touches&&e.originalEvent.touches.length>1?0:e.originalEvent.touches[0].clientX-t.touchStartX}(e)})),o.default(this._element).on("touchend.bs.carousel",(function(t){return n(t)})))}},e._keydown=function(t){if(!/input|textarea/i.test(t.target.tagName))switch(t.which){case 37:t.preventDefault(),this.prev();break;case 39:t.preventDefault(),this.next()}},e._getItemIndex=function(t){return this._items=t&&t.parentNode?[].slice.call(t.parentNode.querySelectorAll(".carousel-item")):[],this._items.indexOf(t)},e._getItemByDirection=function(t,e){var n=t===N,i=t===D,o=this._getItemIndex(e),a=this._items.length-1;if((i&&0===o||n&&o===a)&&!this._config.wrap)return e;var s=(o+(t===D?-1:1))%this._items.length;return-1===s?this._items[this._items.length-1]:this._items[s]},e._triggerSlideEvent=function(t,e){var n=this._getItemIndex(t),i=this._getItemIndex(this._element.querySelector(I)),a=o.default.Event("slide.bs.carousel",{relatedTarget:t,direction:e,from:i,to:n});return o.default(this._element).trigger(a),a},e._setActiveIndicatorElement=function(t){if(this._indicatorsElement){var e=[].slice.call(this._indicatorsElement.querySelectorAll(".active"));o.default(e).removeClass(S);var n=this._indicatorsElement.children[this._getItemIndex(t)];n&&o.default(n).addClass(S)}},e._updateInterval=function(){var t=this._activeElement||this._element.querySelector(I);if(t){var e=parseInt(t.getAttribute("data-interval"),10);e?(this._config.defaultInterval=this._config.defaultInterval||this._config.interval,this._config.interval=e):this._config.interval=this._config.defaultInterval||this._config.interval}},e._slide=function(t,e){var n,i,a,s=this,l=this._element.querySelector(I),r=this._getItemIndex(l),u=e||l&&this._getItemByDirection(t,l),f=this._getItemIndex(u),c=Boolean(this._interval);if(t===N?(n="carousel-item-left",i="carousel-item-next",a="left"):(n="carousel-item-right",i="carousel-item-prev",a="right"),u&&o.default(u).hasClass(S))this._isSliding=!1;else if(!this._triggerSlideEvent(u,a).isDefaultPrevented()&&l&&u){this._isSliding=!0,c&&this.pause(),this._setActiveIndicatorElement(u),this._activeElement=u;var h=o.default.Event(A,{relatedTarget:u,direction:a,from:r,to:f});if(o.default(this._element).hasClass("slide")){o.default(u).addClass(i),d.reflow(u),o.default(l).addClass(n),o.default(u).addClass(n);var g=d.getTransitionDurationFromElement(l);o.default(l).one(d.TRANSITION_END,(function(){o.default(u).removeClass(n+" "+i).addClass(S),o.default(l).removeClass("active "+i+" "+n),s._isSliding=!1,setTimeout((function(){return o.default(s._element).trigger(h)}),0)})).emulateTransitionEnd(g)}else o.default(l).removeClass(S),o.default(u).addClass(S),this._isSliding=!1,o.default(this._element).trigger(h);c&&this.cycle()}},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this).data(w),i=r({},k,o.default(this).data());"object"==typeof e&&(i=r({},i,e));var a="string"==typeof e?e:i.slide;if(n||(n=new t(this,i),o.default(this).data(w,n)),"number"==typeof e)n.to(e);else if("string"==typeof a){if("undefined"==typeof n[a])throw new TypeError('No method named "'+a+'"');n[a]()}else i.interval&&i.ride&&(n.pause(),n.cycle())}))},t._dataApiClickHandler=function(e){var n=d.getSelectorFromElement(this);if(n){var i=o.default(n)[0];if(i&&o.default(i).hasClass("carousel")){var a=r({},o.default(i).data(),o.default(this).data()),s=this.getAttribute("data-slide-to");s&&(a.interval=!1),t._jQueryInterface.call(o.default(i),a),s&&o.default(i).data(w).to(s),e.preventDefault()}}},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return k}}]),t}();o.default(document).on("click.bs.carousel.data-api","[data-slide], [data-slide-to]",P._dataApiClickHandler),o.default(window).on("load.bs.carousel.data-api",(function(){for(var t=[].slice.call(document.querySelectorAll('[data-ride="carousel"]')),e=0,n=t.length;e<n;e++){var i=o.default(t[e]);P._jQueryInterface.call(i,i.data())}})),o.default.fn[T]=P._jQueryInterface,o.default.fn[T].Constructor=P,o.default.fn[T].noConflict=function(){return o.default.fn[T]=C,P._jQueryInterface};var L="collapse",R="bs.collapse",x=o.default.fn[L],q="show",F="collapse",Q="collapsing",B="collapsed",H="width",U='[data-toggle="collapse"]',M={toggle:!0,parent:""},W={toggle:"boolean",parent:"(string|element)"},V=function(){function t(t,e){this._isTransitioning=!1,this._element=t,this._config=this._getConfig(e),this._triggerArray=[].slice.call(document.querySelectorAll('[data-toggle="collapse"][href="#'+t.id+'"],[data-toggle="collapse"][data-target="#'+t.id+'"]'));for(var n=[].slice.call(document.querySelectorAll(U)),i=0,o=n.length;i<o;i++){var a=n[i],s=d.getSelectorFromElement(a),l=[].slice.call(document.querySelectorAll(s)).filter((function(e){return e===t}));null!==s&&l.length>0&&(this._selector=s,this._triggerArray.push(a))}this._parent=this._config.parent?this._getParent():null,this._config.parent||this._addAriaAndCollapsedClass(this._element,this._triggerArray),this._config.toggle&&this.toggle()}var e=t.prototype;return e.toggle=function(){o.default(this._element).hasClass(q)?this.hide():this.show()},e.show=function(){var e,n,i=this;if(!(this._isTransitioning||o.default(this._element).hasClass(q)||(this._parent&&0===(e=[].slice.call(this._parent.querySelectorAll(".show, .collapsing")).filter((function(t){return"string"==typeof i._config.parent?t.getAttribute("data-parent")===i._config.parent:t.classList.contains(F)}))).length&&(e=null),e&&(n=o.default(e).not(this._selector).data(R))&&n._isTransitioning))){var a=o.default.Event("show.bs.collapse");if(o.default(this._element).trigger(a),!a.isDefaultPrevented()){e&&(t._jQueryInterface.call(o.default(e).not(this._selector),"hide"),n||o.default(e).data(R,null));var s=this._getDimension();o.default(this._element).removeClass(F).addClass(Q),this._element.style[s]=0,this._triggerArray.length&&o.default(this._triggerArray).removeClass(B).attr("aria-expanded",!0),this.setTransitioning(!0);var l="scroll"+(s[0].toUpperCase()+s.slice(1)),r=d.getTransitionDurationFromElement(this._element);o.default(this._element).one(d.TRANSITION_END,(function(){o.default(i._element).removeClass(Q).addClass("collapse show"),i._element.style[s]="",i.setTransitioning(!1),o.default(i._element).trigger("shown.bs.collapse")})).emulateTransitionEnd(r),this._element.style[s]=this._element[l]+"px"}}},e.hide=function(){var t=this;if(!this._isTransitioning&&o.default(this._element).hasClass(q)){var e=o.default.Event("hide.bs.collapse");if(o.default(this._element).trigger(e),!e.isDefaultPrevented()){var n=this._getDimension();this._element.style[n]=this._element.getBoundingClientRect()[n]+"px",d.reflow(this._element),o.default(this._element).addClass(Q).removeClass("collapse show");var i=this._triggerArray.length;if(i>0)for(var a=0;a<i;a++){var s=this._triggerArray[a],l=d.getSelectorFromElement(s);null!==l&&(o.default([].slice.call(document.querySelectorAll(l))).hasClass(q)||o.default(s).addClass(B).attr("aria-expanded",!1))}this.setTransitioning(!0),this._element.style[n]="";var r=d.getTransitionDurationFromElement(this._element);o.default(this._element).one(d.TRANSITION_END,(function(){t.setTransitioning(!1),o.default(t._element).removeClass(Q).addClass(F).trigger("hidden.bs.collapse")})).emulateTransitionEnd(r)}}},e.setTransitioning=function(t){this._isTransitioning=t},e.dispose=function(){o.default.removeData(this._element,R),this._config=null,this._parent=null,this._element=null,this._triggerArray=null,this._isTransitioning=null},e._getConfig=function(t){return(t=r({},M,t)).toggle=Boolean(t.toggle),d.typeCheckConfig(L,t,W),t},e._getDimension=function(){return o.default(this._element).hasClass(H)?H:"height"},e._getParent=function(){var e,n=this;d.isElement(this._config.parent)?(e=this._config.parent,"undefined"!=typeof this._config.parent.jquery&&(e=this._config.parent[0])):e=document.querySelector(this._config.parent);var i='[data-toggle="collapse"][data-parent="'+this._config.parent+'"]',a=[].slice.call(e.querySelectorAll(i));return o.default(a).each((function(e,i){n._addAriaAndCollapsedClass(t._getTargetFromElement(i),[i])})),e},e._addAriaAndCollapsedClass=function(t,e){var n=o.default(t).hasClass(q);e.length&&o.default(e).toggleClass(B,!n).attr("aria-expanded",n)},t._getTargetFromElement=function(t){var e=d.getSelectorFromElement(t);return e?document.querySelector(e):null},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this),i=n.data(R),a=r({},M,n.data(),"object"==typeof e&&e?e:{});if(!i&&a.toggle&&"string"==typeof e&&/show|hide/.test(e)&&(a.toggle=!1),i||(i=new t(this,a),n.data(R,i)),"string"==typeof e){if("undefined"==typeof i[e])throw new TypeError('No method named "'+e+'"');i[e]()}}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return M}}]),t}();o.default(document).on("click.bs.collapse.data-api",U,(function(t){"A"===t.currentTarget.tagName&&t.preventDefault();var e=o.default(this),n=d.getSelectorFromElement(this),i=[].slice.call(document.querySelectorAll(n));o.default(i).each((function(){var t=o.default(this),n=t.data(R)?"toggle":e.data();V._jQueryInterface.call(t,n)}))})),o.default.fn[L]=V._jQueryInterface,o.default.fn[L].Constructor=V,o.default.fn[L].noConflict=function(){return o.default.fn[L]=x,V._jQueryInterface};var z="dropdown",K="bs.dropdown",X=o.default.fn[z],Y=new RegExp("38|40|27"),$="disabled",J="show",G="dropdown-menu-right",Z="hide.bs.dropdown",tt="hidden.bs.dropdown",et="click.bs.dropdown.data-api",nt="keydown.bs.dropdown.data-api",it='[data-toggle="dropdown"]',ot=".dropdown-menu",at={offset:0,flip:!0,boundary:"scrollParent",reference:"toggle",display:"dynamic",popperConfig:null},st={offset:"(number|string|function)",flip:"boolean",boundary:"(string|element)",reference:"(string|element)",display:"string",popperConfig:"(null|object)"},lt=function(){function t(t,e){this._element=t,this._popper=null,this._config=this._getConfig(e),this._menu=this._getMenuElement(),this._inNavbar=this._detectNavbar(),this._addEventListeners()}var e=t.prototype;return e.toggle=function(){if(!this._element.disabled&&!o.default(this._element).hasClass($)){var e=o.default(this._menu).hasClass(J);t._clearMenus(),e||this.show(!0)}},e.show=function(e){if(void 0===e&&(e=!1),!(this._element.disabled||o.default(this._element).hasClass($)||o.default(this._menu).hasClass(J))){var n={relatedTarget:this._element},i=o.default.Event("show.bs.dropdown",n),s=t._getParentFromElement(this._element);if(o.default(s).trigger(i),!i.isDefaultPrevented()){if(!this._inNavbar&&e){if("undefined"==typeof a.default)throw new TypeError("Bootstrap's dropdowns require Popper (https://popper.js.org)");var l=this._element;"parent"===this._config.reference?l=s:d.isElement(this._config.reference)&&(l=this._config.reference,"undefined"!=typeof this._config.reference.jquery&&(l=this._config.reference[0])),"scrollParent"!==this._config.boundary&&o.default(s).addClass("position-static"),this._popper=new a.default(l,this._menu,this._getPopperConfig())}"ontouchstart"in document.documentElement&&0===o.default(s).closest(".navbar-nav").length&&o.default(document.body).children().on("mouseover",null,o.default.noop),this._element.focus(),this._element.setAttribute("aria-expanded",!0),o.default(this._menu).toggleClass(J),o.default(s).toggleClass(J).trigger(o.default.Event("shown.bs.dropdown",n))}}},e.hide=function(){if(!this._element.disabled&&!o.default(this._element).hasClass($)&&o.default(this._menu).hasClass(J)){var e={relatedTarget:this._element},n=o.default.Event(Z,e),i=t._getParentFromElement(this._element);o.default(i).trigger(n),n.isDefaultPrevented()||(this._popper&&this._popper.destroy(),o.default(this._menu).toggleClass(J),o.default(i).toggleClass(J).trigger(o.default.Event(tt,e)))}},e.dispose=function(){o.default.removeData(this._element,K),o.default(this._element).off(".bs.dropdown"),this._element=null,this._menu=null,null!==this._popper&&(this._popper.destroy(),this._popper=null)},e.update=function(){this._inNavbar=this._detectNavbar(),null!==this._popper&&this._popper.scheduleUpdate()},e._addEventListeners=function(){var t=this;o.default(this._element).on("click.bs.dropdown",(function(e){e.preventDefault(),e.stopPropagation(),t.toggle()}))},e._getConfig=function(t){return t=r({},this.constructor.Default,o.default(this._element).data(),t),d.typeCheckConfig(z,t,this.constructor.DefaultType),t},e._getMenuElement=function(){if(!this._menu){var e=t._getParentFromElement(this._element);e&&(this._menu=e.querySelector(ot))}return this._menu},e._getPlacement=function(){var t=o.default(this._element.parentNode),e="bottom-start";return t.hasClass("dropup")?e=o.default(this._menu).hasClass(G)?"top-end":"top-start":t.hasClass("dropright")?e="right-start":t.hasClass("dropleft")?e="left-start":o.default(this._menu).hasClass(G)&&(e="bottom-end"),e},e._detectNavbar=function(){return o.default(this._element).closest(".navbar").length>0},e._getOffset=function(){var t=this,e={};return"function"==typeof this._config.offset?e.fn=function(e){return e.offsets=r({},e.offsets,t._config.offset(e.offsets,t._element)),e}:e.offset=this._config.offset,e},e._getPopperConfig=function(){var t={placement:this._getPlacement(),modifiers:{offset:this._getOffset(),flip:{enabled:this._config.flip},preventOverflow:{boundariesElement:this._config.boundary}}};return"static"===this._config.display&&(t.modifiers.applyStyle={enabled:!1}),r({},t,this._config.popperConfig)},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this).data(K);if(n||(n=new t(this,"object"==typeof e?e:null),o.default(this).data(K,n)),"string"==typeof e){if("undefined"==typeof n[e])throw new TypeError('No method named "'+e+'"');n[e]()}}))},t._clearMenus=function(e){if(!e||3!==e.which&&("keyup"!==e.type||9===e.which))for(var n=[].slice.call(document.querySelectorAll(it)),i=0,a=n.length;i<a;i++){var s=t._getParentFromElement(n[i]),l=o.default(n[i]).data(K),r={relatedTarget:n[i]};if(e&&"click"===e.type&&(r.clickEvent=e),l){var u=l._menu;if(o.default(s).hasClass(J)&&!(e&&("click"===e.type&&/input|textarea/i.test(e.target.tagName)||"keyup"===e.type&&9===e.which)&&o.default.contains(s,e.target))){var f=o.default.Event(Z,r);o.default(s).trigger(f),f.isDefaultPrevented()||("ontouchstart"in document.documentElement&&o.default(document.body).children().off("mouseover",null,o.default.noop),n[i].setAttribute("aria-expanded","false"),l._popper&&l._popper.destroy(),o.default(u).removeClass(J),o.default(s).removeClass(J).trigger(o.default.Event(tt,r)))}}}},t._getParentFromElement=function(t){var e,n=d.getSelectorFromElement(t);return n&&(e=document.querySelector(n)),e||t.parentNode},t._dataApiKeydownHandler=function(e){if(!(/input|textarea/i.test(e.target.tagName)?32===e.which||27!==e.which&&(40!==e.which&&38!==e.which||o.default(e.target).closest(ot).length):!Y.test(e.which))&&!this.disabled&&!o.default(this).hasClass($)){var n=t._getParentFromElement(this),i=o.default(n).hasClass(J);if(i||27!==e.which){if(e.preventDefault(),e.stopPropagation(),!i||27===e.which||32===e.which)return 27===e.which&&o.default(n.querySelector(it)).trigger("focus"),void o.default(this).trigger("click");var a=[].slice.call(n.querySelectorAll(".dropdown-menu .dropdown-item:not(.disabled):not(:disabled)")).filter((function(t){return o.default(t).is(":visible")}));if(0!==a.length){var s=a.indexOf(e.target);38===e.which&&s>0&&s--,40===e.which&&s<a.length-1&&s++,s<0&&(s=0),a[s].focus()}}}},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return at}},{key:"DefaultType",get:function(){return st}}]),t}();o.default(document).on(nt,it,lt._dataApiKeydownHandler).on(nt,ot,lt._dataApiKeydownHandler).on(et+" keyup.bs.dropdown.data-api",lt._clearMenus).on(et,it,(function(t){t.preventDefault(),t.stopPropagation(),lt._jQueryInterface.call(o.default(this),"toggle")})).on(et,".dropdown form",(function(t){t.stopPropagation()})),o.default.fn[z]=lt._jQueryInterface,o.default.fn[z].Constructor=lt,o.default.fn[z].noConflict=function(){return o.default.fn[z]=X,lt._jQueryInterface};var rt="bs.modal",ut=o.default.fn.modal,ft="modal-open",dt="fade",ct="show",ht="modal-static",gt="hidden.bs.modal",mt="show.bs.modal",pt="focusin.bs.modal",_t="resize.bs.modal",vt="click.dismiss.bs.modal",yt="keydown.dismiss.bs.modal",bt="mousedown.dismiss.bs.modal",Et=".fixed-top, .fixed-bottom, .is-fixed, .sticky-top",Tt={backdrop:!0,keyboard:!0,focus:!0,show:!0},wt={backdrop:"(boolean|string)",keyboard:"boolean",focus:"boolean",show:"boolean"},Ct=function(){function t(t,e){this._config=this._getConfig(e),this._element=t,this._dialog=t.querySelector(".modal-dialog"),this._backdrop=null,this._isShown=!1,this._isBodyOverflowing=!1,this._ignoreBackdropClick=!1,this._isTransitioning=!1,this._scrollbarWidth=0}var e=t.prototype;return e.toggle=function(t){return this._isShown?this.hide():this.show(t)},e.show=function(t){var e=this;if(!this._isShown&&!this._isTransitioning){var n=o.default.Event(mt,{relatedTarget:t});o.default(this._element).trigger(n),n.isDefaultPrevented()||(this._isShown=!0,o.default(this._element).hasClass(dt)&&(this._isTransitioning=!0),this._checkScrollbar(),this._setScrollbar(),this._adjustDialog(),this._setEscapeEvent(),this._setResizeEvent(),o.default(this._element).on(vt,'[data-dismiss="modal"]',(function(t){return e.hide(t)})),o.default(this._dialog).on(bt,(function(){o.default(e._element).one("mouseup.dismiss.bs.modal",(function(t){o.default(t.target).is(e._element)&&(e._ignoreBackdropClick=!0)}))})),this._showBackdrop((function(){return e._showElement(t)})))}},e.hide=function(t){var e=this;if(t&&t.preventDefault(),this._isShown&&!this._isTransitioning){var n=o.default.Event("hide.bs.modal");if(o.default(this._element).trigger(n),this._isShown&&!n.isDefaultPrevented()){this._isShown=!1;var i=o.default(this._element).hasClass(dt);if(i&&(this._isTransitioning=!0),this._setEscapeEvent(),this._setResizeEvent(),o.default(document).off(pt),o.default(this._element).removeClass(ct),o.default(this._element).off(vt),o.default(this._dialog).off(bt),i){var a=d.getTransitionDurationFromElement(this._element);o.default(this._element).one(d.TRANSITION_END,(function(t){return e._hideModal(t)})).emulateTransitionEnd(a)}else this._hideModal()}}},e.dispose=function(){[window,this._element,this._dialog].forEach((function(t){return o.default(t).off(".bs.modal")})),o.default(document).off(pt),o.default.removeData(this._element,rt),this._config=null,this._element=null,this._dialog=null,this._backdrop=null,this._isShown=null,this._isBodyOverflowing=null,this._ignoreBackdropClick=null,this._isTransitioning=null,this._scrollbarWidth=null},e.handleUpdate=function(){this._adjustDialog()},e._getConfig=function(t){return t=r({},Tt,t),d.typeCheckConfig("modal",t,wt),t},e._triggerBackdropTransition=function(){var t=this,e=o.default.Event("hidePrevented.bs.modal");if(o.default(this._element).trigger(e),!e.isDefaultPrevented()){var n=this._element.scrollHeight>document.documentElement.clientHeight;n||(this._element.style.overflowY="hidden"),this._element.classList.add(ht);var i=d.getTransitionDurationFromElement(this._dialog);o.default(this._element).off(d.TRANSITION_END),o.default(this._element).one(d.TRANSITION_END,(function(){t._element.classList.remove(ht),n||o.default(t._element).one(d.TRANSITION_END,(function(){t._element.style.overflowY=""})).emulateTransitionEnd(t._element,i)})).emulateTransitionEnd(i),this._element.focus()}},e._showElement=function(t){var e=this,n=o.default(this._element).hasClass(dt),i=this._dialog?this._dialog.querySelector(".modal-body"):null;this._element.parentNode&&this._element.parentNode.nodeType===Node.ELEMENT_NODE||document.body.appendChild(this._element),this._element.style.display="block",this._element.removeAttribute("aria-hidden"),this._element.setAttribute("aria-modal",!0),this._element.setAttribute("role","dialog"),o.default(this._dialog).hasClass("modal-dialog-scrollable")&&i?i.scrollTop=0:this._element.scrollTop=0,n&&d.reflow(this._element),o.default(this._element).addClass(ct),this._config.focus&&this._enforceFocus();var a=o.default.Event("shown.bs.modal",{relatedTarget:t}),s=function(){e._config.focus&&e._element.focus(),e._isTransitioning=!1,o.default(e._element).trigger(a)};if(n){var l=d.getTransitionDurationFromElement(this._dialog);o.default(this._dialog).one(d.TRANSITION_END,s).emulateTransitionEnd(l)}else s()},e._enforceFocus=function(){var t=this;o.default(document).off(pt).on(pt,(function(e){document!==e.target&&t._element!==e.target&&0===o.default(t._element).has(e.target).length&&t._element.focus()}))},e._setEscapeEvent=function(){var t=this;this._isShown?o.default(this._element).on(yt,(function(e){t._config.keyboard&&27===e.which?(e.preventDefault(),t.hide()):t._config.keyboard||27!==e.which||t._triggerBackdropTransition()})):this._isShown||o.default(this._element).off(yt)},e._setResizeEvent=function(){var t=this;this._isShown?o.default(window).on(_t,(function(e){return t.handleUpdate(e)})):o.default(window).off(_t)},e._hideModal=function(){var t=this;this._element.style.display="none",this._element.setAttribute("aria-hidden",!0),this._element.removeAttribute("aria-modal"),this._element.removeAttribute("role"),this._isTransitioning=!1,this._showBackdrop((function(){o.default(document.body).removeClass(ft),t._resetAdjustments(),t._resetScrollbar(),o.default(t._element).trigger(gt)}))},e._removeBackdrop=function(){this._backdrop&&(o.default(this._backdrop).remove(),this._backdrop=null)},e._showBackdrop=function(t){var e=this,n=o.default(this._element).hasClass(dt)?dt:"";if(this._isShown&&this._config.backdrop){if(this._backdrop=document.createElement("div"),this._backdrop.className="modal-backdrop",n&&this._backdrop.classList.add(n),o.default(this._backdrop).appendTo(document.body),o.default(this._element).on(vt,(function(t){e._ignoreBackdropClick?e._ignoreBackdropClick=!1:t.target===t.currentTarget&&("static"===e._config.backdrop?e._triggerBackdropTransition():e.hide())})),n&&d.reflow(this._backdrop),o.default(this._backdrop).addClass(ct),!t)return;if(!n)return void t();var i=d.getTransitionDurationFromElement(this._backdrop);o.default(this._backdrop).one(d.TRANSITION_END,t).emulateTransitionEnd(i)}else if(!this._isShown&&this._backdrop){o.default(this._backdrop).removeClass(ct);var a=function(){e._removeBackdrop(),t&&t()};if(o.default(this._element).hasClass(dt)){var s=d.getTransitionDurationFromElement(this._backdrop);o.default(this._backdrop).one(d.TRANSITION_END,a).emulateTransitionEnd(s)}else a()}else t&&t()},e._adjustDialog=function(){var t=this._element.scrollHeight>document.documentElement.clientHeight;!this._isBodyOverflowing&&t&&(this._element.style.paddingLeft=this._scrollbarWidth+"px"),this._isBodyOverflowing&&!t&&(this._element.style.paddingRight=this._scrollbarWidth+"px")},e._resetAdjustments=function(){this._element.style.paddingLeft="",this._element.style.paddingRight=""},e._checkScrollbar=function(){var t=document.body.getBoundingClientRect();this._isBodyOverflowing=Math.round(t.left+t.right)<window.innerWidth,this._scrollbarWidth=this._getScrollbarWidth()},e._setScrollbar=function(){var t=this;if(this._isBodyOverflowing){var e=[].slice.call(document.querySelectorAll(Et)),n=[].slice.call(document.querySelectorAll(".sticky-top"));o.default(e).each((function(e,n){var i=n.style.paddingRight,a=o.default(n).css("padding-right");o.default(n).data("padding-right",i).css("padding-right",parseFloat(a)+t._scrollbarWidth+"px")})),o.default(n).each((function(e,n){var i=n.style.marginRight,a=o.default(n).css("margin-right");o.default(n).data("margin-right",i).css("margin-right",parseFloat(a)-t._scrollbarWidth+"px")}));var i=document.body.style.paddingRight,a=o.default(document.body).css("padding-right");o.default(document.body).data("padding-right",i).css("padding-right",parseFloat(a)+this._scrollbarWidth+"px")}o.default(document.body).addClass(ft)},e._resetScrollbar=function(){var t=[].slice.call(document.querySelectorAll(Et));o.default(t).each((function(t,e){var n=o.default(e).data("padding-right");o.default(e).removeData("padding-right"),e.style.paddingRight=n||""}));var e=[].slice.call(document.querySelectorAll(".sticky-top"));o.default(e).each((function(t,e){var n=o.default(e).data("margin-right");"undefined"!=typeof n&&o.default(e).css("margin-right",n).removeData("margin-right")}));var n=o.default(document.body).data("padding-right");o.default(document.body).removeData("padding-right"),document.body.style.paddingRight=n||""},e._getScrollbarWidth=function(){var t=document.createElement("div");t.className="modal-scrollbar-measure",document.body.appendChild(t);var e=t.getBoundingClientRect().width-t.clientWidth;return document.body.removeChild(t),e},t._jQueryInterface=function(e,n){return this.each((function(){var i=o.default(this).data(rt),a=r({},Tt,o.default(this).data(),"object"==typeof e&&e?e:{});if(i||(i=new t(this,a),o.default(this).data(rt,i)),"string"==typeof e){if("undefined"==typeof i[e])throw new TypeError('No method named "'+e+'"');i[e](n)}else a.show&&i.show(n)}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return Tt}}]),t}();o.default(document).on("click.bs.modal.data-api",'[data-toggle="modal"]',(function(t){var e,n=this,i=d.getSelectorFromElement(this);i&&(e=document.querySelector(i));var a=o.default(e).data(rt)?"toggle":r({},o.default(e).data(),o.default(this).data());"A"!==this.tagName&&"AREA"!==this.tagName||t.preventDefault();var s=o.default(e).one(mt,(function(t){t.isDefaultPrevented()||s.one(gt,(function(){o.default(n).is(":visible")&&n.focus()}))}));Ct._jQueryInterface.call(o.default(e),a,this)})),o.default.fn.modal=Ct._jQueryInterface,o.default.fn.modal.Constructor=Ct,o.default.fn.modal.noConflict=function(){return o.default.fn.modal=ut,Ct._jQueryInterface};var St=["background","cite","href","itemtype","longdesc","poster","src","xlink:href"],Nt=/^(?:(?:https?|mailto|ftp|tel|file|sms):|[^#&/:?]*(?:[#/?]|$))/i,Dt=/^data:(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm)|audio\/(?:mp3|oga|ogg|opus));base64,[\d+/a-z]+=*$/i;function At(t,e,n){if(0===t.length)return t;if(n&&"function"==typeof n)return n(t);for(var i=(new window.DOMParser).parseFromString(t,"text/html"),o=Object.keys(e),a=[].slice.call(i.body.querySelectorAll("*")),s=function(t,n){var i=a[t],s=i.nodeName.toLowerCase();if(-1===o.indexOf(i.nodeName.toLowerCase()))return i.parentNode.removeChild(i),"continue";var l=[].slice.call(i.attributes),r=[].concat(e["*"]||[],e[s]||[]);l.forEach((function(t){(function(t,e){var n=t.nodeName.toLowerCase();if(-1!==e.indexOf(n))return-1===St.indexOf(n)||Boolean(Nt.test(t.nodeValue)||Dt.test(t.nodeValue));for(var i=e.filter((function(t){return t instanceof RegExp})),o=0,a=i.length;o<a;o++)if(i[o].test(n))return!0;return!1})(t,r)||i.removeAttribute(t.nodeName)}))},l=0,r=a.length;l<r;l++)s(l);return i.body.innerHTML}var It="tooltip",kt="bs.tooltip",Ot=o.default.fn.tooltip,jt=new RegExp("(^|\\s)bs-tooltip\\S+","g"),Pt=["sanitize","whiteList","sanitizeFn"],Lt="fade",Rt="show",xt="show",qt="out",Ft="hover",Qt="focus",Bt={AUTO:"auto",TOP:"top",RIGHT:"right",BOTTOM:"bottom",LEFT:"left"},Ht={animation:!0,template:'<div class="tooltip" role="tooltip"><div class="arrow"></div><div class="tooltip-inner"></div></div>',trigger:"hover focus",title:"",delay:0,html:!1,selector:!1,placement:"top",offset:0,container:!1,fallbackPlacement:"flip",boundary:"scrollParent",customClass:"",sanitize:!0,sanitizeFn:null,whiteList:{"*":["class","dir","id","lang","role",/^aria-[\w-]*$/i],a:["target","href","title","rel"],area:[],b:[],br:[],col:[],code:[],div:[],em:[],hr:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],i:[],img:["src","srcset","alt","title","width","height"],li:[],ol:[],p:[],pre:[],s:[],small:[],span:[],sub:[],sup:[],strong:[],u:[],ul:[]},popperConfig:null},Ut={animation:"boolean",template:"string",title:"(string|element|function)",trigger:"string",delay:"(number|object)",html:"boolean",selector:"(string|boolean)",placement:"(string|function)",offset:"(number|string|function)",container:"(string|element|boolean)",fallbackPlacement:"(string|array)",boundary:"(string|element)",customClass:"(string|function)",sanitize:"boolean",sanitizeFn:"(null|function)",whiteList:"object",popperConfig:"(null|object)"},Mt={HIDE:"hide.bs.tooltip",HIDDEN:"hidden.bs.tooltip",SHOW:"show.bs.tooltip",SHOWN:"shown.bs.tooltip",INSERTED:"inserted.bs.tooltip",CLICK:"click.bs.tooltip",FOCUSIN:"focusin.bs.tooltip",FOCUSOUT:"focusout.bs.tooltip",MOUSEENTER:"mouseenter.bs.tooltip",MOUSELEAVE:"mouseleave.bs.tooltip"},Wt=function(){function t(t,e){if("undefined"==typeof a.default)throw new TypeError("Bootstrap's tooltips require Popper (https://popper.js.org)");this._isEnabled=!0,this._timeout=0,this._hoverState="",this._activeTrigger={},this._popper=null,this.element=t,this.config=this._getConfig(e),this.tip=null,this._setListeners()}var e=t.prototype;return e.enable=function(){this._isEnabled=!0},e.disable=function(){this._isEnabled=!1},e.toggleEnabled=function(){this._isEnabled=!this._isEnabled},e.toggle=function(t){if(this._isEnabled)if(t){var e=this.constructor.DATA_KEY,n=o.default(t.currentTarget).data(e);n||(n=new this.constructor(t.currentTarget,this._getDelegateConfig()),o.default(t.currentTarget).data(e,n)),n._activeTrigger.click=!n._activeTrigger.click,n._isWithActiveTrigger()?n._enter(null,n):n._leave(null,n)}else{if(o.default(this.getTipElement()).hasClass(Rt))return void this._leave(null,this);this._enter(null,this)}},e.dispose=function(){clearTimeout(this._timeout),o.default.removeData(this.element,this.constructor.DATA_KEY),o.default(this.element).off(this.constructor.EVENT_KEY),o.default(this.element).closest(".modal").off("hide.bs.modal",this._hideModalHandler),this.tip&&o.default(this.tip).remove(),this._isEnabled=null,this._timeout=null,this._hoverState=null,this._activeTrigger=null,this._popper&&this._popper.destroy(),this._popper=null,this.element=null,this.config=null,this.tip=null},e.show=function(){var t=this;if("none"===o.default(this.element).css("display"))throw new Error("Please use show on visible elements");var e=o.default.Event(this.constructor.Event.SHOW);if(this.isWithContent()&&this._isEnabled){o.default(this.element).trigger(e);var n=d.findShadowRoot(this.element),i=o.default.contains(null!==n?n:this.element.ownerDocument.documentElement,this.element);if(e.isDefaultPrevented()||!i)return;var s=this.getTipElement(),l=d.getUID(this.constructor.NAME);s.setAttribute("id",l),this.element.setAttribute("aria-describedby",l),this.setContent(),this.config.animation&&o.default(s).addClass(Lt);var r="function"==typeof this.config.placement?this.config.placement.call(this,s,this.element):this.config.placement,u=this._getAttachment(r);this.addAttachmentClass(u);var f=this._getContainer();o.default(s).data(this.constructor.DATA_KEY,this),o.default.contains(this.element.ownerDocument.documentElement,this.tip)||o.default(s).appendTo(f),o.default(this.element).trigger(this.constructor.Event.INSERTED),this._popper=new a.default(this.element,s,this._getPopperConfig(u)),o.default(s).addClass(Rt),o.default(s).addClass(this.config.customClass),"ontouchstart"in document.documentElement&&o.default(document.body).children().on("mouseover",null,o.default.noop);var c=function(){t.config.animation&&t._fixTransition();var e=t._hoverState;t._hoverState=null,o.default(t.element).trigger(t.constructor.Event.SHOWN),e===qt&&t._leave(null,t)};if(o.default(this.tip).hasClass(Lt)){var h=d.getTransitionDurationFromElement(this.tip);o.default(this.tip).one(d.TRANSITION_END,c).emulateTransitionEnd(h)}else c()}},e.hide=function(t){var e=this,n=this.getTipElement(),i=o.default.Event(this.constructor.Event.HIDE),a=function(){e._hoverState!==xt&&n.parentNode&&n.parentNode.removeChild(n),e._cleanTipClass(),e.element.removeAttribute("aria-describedby"),o.default(e.element).trigger(e.constructor.Event.HIDDEN),null!==e._popper&&e._popper.destroy(),t&&t()};if(o.default(this.element).trigger(i),!i.isDefaultPrevented()){if(o.default(n).removeClass(Rt),"ontouchstart"in document.documentElement&&o.default(document.body).children().off("mouseover",null,o.default.noop),this._activeTrigger.click=!1,this._activeTrigger.focus=!1,this._activeTrigger.hover=!1,o.default(this.tip).hasClass(Lt)){var s=d.getTransitionDurationFromElement(n);o.default(n).one(d.TRANSITION_END,a).emulateTransitionEnd(s)}else a();this._hoverState=""}},e.update=function(){null!==this._popper&&this._popper.scheduleUpdate()},e.isWithContent=function(){return Boolean(this.getTitle())},e.addAttachmentClass=function(t){o.default(this.getTipElement()).addClass("bs-tooltip-"+t)},e.getTipElement=function(){return this.tip=this.tip||o.default(this.config.template)[0],this.tip},e.setContent=function(){var t=this.getTipElement();this.setElementContent(o.default(t.querySelectorAll(".tooltip-inner")),this.getTitle()),o.default(t).removeClass("fade show")},e.setElementContent=function(t,e){"object"!=typeof e||!e.nodeType&&!e.jquery?this.config.html?(this.config.sanitize&&(e=At(e,this.config.whiteList,this.config.sanitizeFn)),t.html(e)):t.text(e):this.config.html?o.default(e).parent().is(t)||t.empty().append(e):t.text(o.default(e).text())},e.getTitle=function(){var t=this.element.getAttribute("data-original-title");return t||(t="function"==typeof this.config.title?this.config.title.call(this.element):this.config.title),t},e._getPopperConfig=function(t){var e=this;return r({},{placement:t,modifiers:{offset:this._getOffset(),flip:{behavior:this.config.fallbackPlacement},arrow:{element:".arrow"},preventOverflow:{boundariesElement:this.config.boundary}},onCreate:function(t){t.originalPlacement!==t.placement&&e._handlePopperPlacementChange(t)},onUpdate:function(t){return e._handlePopperPlacementChange(t)}},this.config.popperConfig)},e._getOffset=function(){var t=this,e={};return"function"==typeof this.config.offset?e.fn=function(e){return e.offsets=r({},e.offsets,t.config.offset(e.offsets,t.element)),e}:e.offset=this.config.offset,e},e._getContainer=function(){return!1===this.config.container?document.body:d.isElement(this.config.container)?o.default(this.config.container):o.default(document).find(this.config.container)},e._getAttachment=function(t){return Bt[t.toUpperCase()]},e._setListeners=function(){var t=this;this.config.trigger.split(" ").forEach((function(e){if("click"===e)o.default(t.element).on(t.constructor.Event.CLICK,t.config.selector,(function(e){return t.toggle(e)}));else if("manual"!==e){var n=e===Ft?t.constructor.Event.MOUSEENTER:t.constructor.Event.FOCUSIN,i=e===Ft?t.constructor.Event.MOUSELEAVE:t.constructor.Event.FOCUSOUT;o.default(t.element).on(n,t.config.selector,(function(e){return t._enter(e)})).on(i,t.config.selector,(function(e){return t._leave(e)}))}})),this._hideModalHandler=function(){t.element&&t.hide()},o.default(this.element).closest(".modal").on("hide.bs.modal",this._hideModalHandler),this.config.selector?this.config=r({},this.config,{trigger:"manual",selector:""}):this._fixTitle()},e._fixTitle=function(){var t=typeof this.element.getAttribute("data-original-title");(this.element.getAttribute("title")||"string"!==t)&&(this.element.setAttribute("data-original-title",this.element.getAttribute("title")||""),this.element.setAttribute("title",""))},e._enter=function(t,e){var n=this.constructor.DATA_KEY;(e=e||o.default(t.currentTarget).data(n))||(e=new this.constructor(t.currentTarget,this._getDelegateConfig()),o.default(t.currentTarget).data(n,e)),t&&(e._activeTrigger["focusin"===t.type?Qt:Ft]=!0),o.default(e.getTipElement()).hasClass(Rt)||e._hoverState===xt?e._hoverState=xt:(clearTimeout(e._timeout),e._hoverState=xt,e.config.delay&&e.config.delay.show?e._timeout=setTimeout((function(){e._hoverState===xt&&e.show()}),e.config.delay.show):e.show())},e._leave=function(t,e){var n=this.constructor.DATA_KEY;(e=e||o.default(t.currentTarget).data(n))||(e=new this.constructor(t.currentTarget,this._getDelegateConfig()),o.default(t.currentTarget).data(n,e)),t&&(e._activeTrigger["focusout"===t.type?Qt:Ft]=!1),e._isWithActiveTrigger()||(clearTimeout(e._timeout),e._hoverState=qt,e.config.delay&&e.config.delay.hide?e._timeout=setTimeout((function(){e._hoverState===qt&&e.hide()}),e.config.delay.hide):e.hide())},e._isWithActiveTrigger=function(){for(var t in this._activeTrigger)if(this._activeTrigger[t])return!0;return!1},e._getConfig=function(t){var e=o.default(this.element).data();return Object.keys(e).forEach((function(t){-1!==Pt.indexOf(t)&&delete e[t]})),"number"==typeof(t=r({},this.constructor.Default,e,"object"==typeof t&&t?t:{})).delay&&(t.delay={show:t.delay,hide:t.delay}),"number"==typeof t.title&&(t.title=t.title.toString()),"number"==typeof t.content&&(t.content=t.content.toString()),d.typeCheckConfig(It,t,this.constructor.DefaultType),t.sanitize&&(t.template=At(t.template,t.whiteList,t.sanitizeFn)),t},e._getDelegateConfig=function(){var t={};if(this.config)for(var e in this.config)this.constructor.Default[e]!==this.config[e]&&(t[e]=this.config[e]);return t},e._cleanTipClass=function(){var t=o.default(this.getTipElement()),e=t.attr("class").match(jt);null!==e&&e.length&&t.removeClass(e.join(""))},e._handlePopperPlacementChange=function(t){this.tip=t.instance.popper,this._cleanTipClass(),this.addAttachmentClass(this._getAttachment(t.placement))},e._fixTransition=function(){var t=this.getTipElement(),e=this.config.animation;null===t.getAttribute("x-placement")&&(o.default(t).removeClass(Lt),this.config.animation=!1,this.hide(),this.show(),this.config.animation=e)},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this),i=n.data(kt),a="object"==typeof e&&e;if((i||!/dispose|hide/.test(e))&&(i||(i=new t(this,a),n.data(kt,i)),"string"==typeof e)){if("undefined"==typeof i[e])throw new TypeError('No method named "'+e+'"');i[e]()}}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return Ht}},{key:"NAME",get:function(){return It}},{key:"DATA_KEY",get:function(){return kt}},{key:"Event",get:function(){return Mt}},{key:"EVENT_KEY",get:function(){return".bs.tooltip"}},{key:"DefaultType",get:function(){return Ut}}]),t}();o.default.fn.tooltip=Wt._jQueryInterface,o.default.fn.tooltip.Constructor=Wt,o.default.fn.tooltip.noConflict=function(){return o.default.fn.tooltip=Ot,Wt._jQueryInterface};var Vt="bs.popover",zt=o.default.fn.popover,Kt=new RegExp("(^|\\s)bs-popover\\S+","g"),Xt=r({},Wt.Default,{placement:"right",trigger:"click",content:"",template:'<div class="popover" role="tooltip"><div class="arrow"></div><h3 class="popover-header"></h3><div class="popover-body"></div></div>'}),Yt=r({},Wt.DefaultType,{content:"(string|element|function)"}),$t={HIDE:"hide.bs.popover",HIDDEN:"hidden.bs.popover",SHOW:"show.bs.popover",SHOWN:"shown.bs.popover",INSERTED:"inserted.bs.popover",CLICK:"click.bs.popover",FOCUSIN:"focusin.bs.popover",FOCUSOUT:"focusout.bs.popover",MOUSEENTER:"mouseenter.bs.popover",MOUSELEAVE:"mouseleave.bs.popover"},Jt=function(t){var e,n;function i(){return t.apply(this,arguments)||this}n=t,(e=i).prototype=Object.create(n.prototype),e.prototype.constructor=e,u(e,n);var a=i.prototype;return a.isWithContent=function(){return this.getTitle()||this._getContent()},a.addAttachmentClass=function(t){o.default(this.getTipElement()).addClass("bs-popover-"+t)},a.getTipElement=function(){return this.tip=this.tip||o.default(this.config.template)[0],this.tip},a.setContent=function(){var t=o.default(this.getTipElement());this.setElementContent(t.find(".popover-header"),this.getTitle());var e=this._getContent();"function"==typeof e&&(e=e.call(this.element)),this.setElementContent(t.find(".popover-body"),e),t.removeClass("fade show")},a._getContent=function(){return this.element.getAttribute("data-content")||this.config.content},a._cleanTipClass=function(){var t=o.default(this.getTipElement()),e=t.attr("class").match(Kt);null!==e&&e.length>0&&t.removeClass(e.join(""))},i._jQueryInterface=function(t){return this.each((function(){var e=o.default(this).data(Vt),n="object"==typeof t?t:null;if((e||!/dispose|hide/.test(t))&&(e||(e=new i(this,n),o.default(this).data(Vt,e)),"string"==typeof t)){if("undefined"==typeof e[t])throw new TypeError('No method named "'+t+'"');e[t]()}}))},l(i,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return Xt}},{key:"NAME",get:function(){return"popover"}},{key:"DATA_KEY",get:function(){return Vt}},{key:"Event",get:function(){return $t}},{key:"EVENT_KEY",get:function(){return".bs.popover"}},{key:"DefaultType",get:function(){return Yt}}]),i}(Wt);o.default.fn.popover=Jt._jQueryInterface,o.default.fn.popover.Constructor=Jt,o.default.fn.popover.noConflict=function(){return o.default.fn.popover=zt,Jt._jQueryInterface};var Gt="scrollspy",Zt="bs.scrollspy",te=o.default.fn[Gt],ee="active",ne="position",ie=".nav, .list-group",oe={offset:10,method:"auto",target:""},ae={offset:"number",method:"string",target:"(string|element)"},se=function(){function t(t,e){var n=this;this._element=t,this._scrollElement="BODY"===t.tagName?window:t,this._config=this._getConfig(e),this._selector=this._config.target+" .nav-link,"+this._config.target+" .list-group-item,"+this._config.target+" .dropdown-item",this._offsets=[],this._targets=[],this._activeTarget=null,this._scrollHeight=0,o.default(this._scrollElement).on("scroll.bs.scrollspy",(function(t){return n._process(t)})),this.refresh(),this._process()}var e=t.prototype;return e.refresh=function(){var t=this,e=this._scrollElement===this._scrollElement.window?"offset":ne,n="auto"===this._config.method?e:this._config.method,i=n===ne?this._getScrollTop():0;this._offsets=[],this._targets=[],this._scrollHeight=this._getScrollHeight(),[].slice.call(document.querySelectorAll(this._selector)).map((function(t){var e,a=d.getSelectorFromElement(t);if(a&&(e=document.querySelector(a)),e){var s=e.getBoundingClientRect();if(s.width||s.height)return[o.default(e)[n]().top+i,a]}return null})).filter(Boolean).sort((function(t,e){return t[0]-e[0]})).forEach((function(e){t._offsets.push(e[0]),t._targets.push(e[1])}))},e.dispose=function(){o.default.removeData(this._element,Zt),o.default(this._scrollElement).off(".bs.scrollspy"),this._element=null,this._scrollElement=null,this._config=null,this._selector=null,this._offsets=null,this._targets=null,this._activeTarget=null,this._scrollHeight=null},e._getConfig=function(t){if("string"!=typeof(t=r({},oe,"object"==typeof t&&t?t:{})).target&&d.isElement(t.target)){var e=o.default(t.target).attr("id");e||(e=d.getUID(Gt),o.default(t.target).attr("id",e)),t.target="#"+e}return d.typeCheckConfig(Gt,t,ae),t},e._getScrollTop=function(){return this._scrollElement===window?this._scrollElement.pageYOffset:this._scrollElement.scrollTop},e._getScrollHeight=function(){return this._scrollElement.scrollHeight||Math.max(document.body.scrollHeight,document.documentElement.scrollHeight)},e._getOffsetHeight=function(){return this._scrollElement===window?window.innerHeight:this._scrollElement.getBoundingClientRect().height},e._process=function(){var t=this._getScrollTop()+this._config.offset,e=this._getScrollHeight(),n=this._config.offset+e-this._getOffsetHeight();if(this._scrollHeight!==e&&this.refresh(),t>=n){var i=this._targets[this._targets.length-1];this._activeTarget!==i&&this._activate(i)}else{if(this._activeTarget&&t<this._offsets[0]&&this._offsets[0]>0)return this._activeTarget=null,void this._clear();for(var o=this._offsets.length;o--;)this._activeTarget!==this._targets[o]&&t>=this._offsets[o]&&("undefined"==typeof this._offsets[o+1]||t<this._offsets[o+1])&&this._activate(this._targets[o])}},e._activate=function(t){this._activeTarget=t,this._clear();var e=this._selector.split(",").map((function(e){return e+'[data-target="'+t+'"],'+e+'[href="'+t+'"]'})),n=o.default([].slice.call(document.querySelectorAll(e.join(","))));n.hasClass("dropdown-item")?(n.closest(".dropdown").find(".dropdown-toggle").addClass(ee),n.addClass(ee)):(n.addClass(ee),n.parents(ie).prev(".nav-link, .list-group-item").addClass(ee),n.parents(ie).prev(".nav-item").children(".nav-link").addClass(ee)),o.default(this._scrollElement).trigger("activate.bs.scrollspy",{relatedTarget:t})},e._clear=function(){[].slice.call(document.querySelectorAll(this._selector)).filter((function(t){return t.classList.contains(ee)})).forEach((function(t){return t.classList.remove(ee)}))},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this).data(Zt);if(n||(n=new t(this,"object"==typeof e&&e),o.default(this).data(Zt,n)),"string"==typeof e){if("undefined"==typeof n[e])throw new TypeError('No method named "'+e+'"');n[e]()}}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"Default",get:function(){return oe}}]),t}();o.default(window).on("load.bs.scrollspy.data-api",(function(){for(var t=[].slice.call(document.querySelectorAll('[data-spy="scroll"]')),e=t.length;e--;){var n=o.default(t[e]);se._jQueryInterface.call(n,n.data())}})),o.default.fn[Gt]=se._jQueryInterface,o.default.fn[Gt].Constructor=se,o.default.fn[Gt].noConflict=function(){return o.default.fn[Gt]=te,se._jQueryInterface};var le="bs.tab",re=o.default.fn.tab,ue="active",fe="fade",de="show",ce=".active",he="> li > .active",ge=function(){function t(t){this._element=t}var e=t.prototype;return e.show=function(){var t=this;if(!(this._element.parentNode&&this._element.parentNode.nodeType===Node.ELEMENT_NODE&&o.default(this._element).hasClass(ue)||o.default(this._element).hasClass("disabled")||this._element.hasAttribute("disabled"))){var e,n,i=o.default(this._element).closest(".nav, .list-group")[0],a=d.getSelectorFromElement(this._element);if(i){var s="UL"===i.nodeName||"OL"===i.nodeName?he:ce;n=(n=o.default.makeArray(o.default(i).find(s)))[n.length-1]}var l=o.default.Event("hide.bs.tab",{relatedTarget:this._element}),r=o.default.Event("show.bs.tab",{relatedTarget:n});if(n&&o.default(n).trigger(l),o.default(this._element).trigger(r),!r.isDefaultPrevented()&&!l.isDefaultPrevented()){a&&(e=document.querySelector(a)),this._activate(this._element,i);var u=function(){var e=o.default.Event("hidden.bs.tab",{relatedTarget:t._element}),i=o.default.Event("shown.bs.tab",{relatedTarget:n});o.default(n).trigger(e),o.default(t._element).trigger(i)};e?this._activate(e,e.parentNode,u):u()}}},e.dispose=function(){o.default.removeData(this._element,le),this._element=null},e._activate=function(t,e,n){var i=this,a=(!e||"UL"!==e.nodeName&&"OL"!==e.nodeName?o.default(e).children(ce):o.default(e).find(he))[0],s=n&&a&&o.default(a).hasClass(fe),l=function(){return i._transitionComplete(t,a,n)};if(a&&s){var r=d.getTransitionDurationFromElement(a);o.default(a).removeClass(de).one(d.TRANSITION_END,l).emulateTransitionEnd(r)}else l()},e._transitionComplete=function(t,e,n){if(e){o.default(e).removeClass(ue);var i=o.default(e.parentNode).find("> .dropdown-menu .active")[0];i&&o.default(i).removeClass(ue),"tab"===e.getAttribute("role")&&e.setAttribute("aria-selected",!1)}o.default(t).addClass(ue),"tab"===t.getAttribute("role")&&t.setAttribute("aria-selected",!0),d.reflow(t),t.classList.contains(fe)&&t.classList.add(de);var a=t.parentNode;if(a&&"LI"===a.nodeName&&(a=a.parentNode),a&&o.default(a).hasClass("dropdown-menu")){var s=o.default(t).closest(".dropdown")[0];if(s){var l=[].slice.call(s.querySelectorAll(".dropdown-toggle"));o.default(l).addClass(ue)}t.setAttribute("aria-expanded",!0)}n&&n()},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this),i=n.data(le);if(i||(i=new t(this),n.data(le,i)),"string"==typeof e){if("undefined"==typeof i[e])throw new TypeError('No method named "'+e+'"');i[e]()}}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}}]),t}();o.default(document).on("click.bs.tab.data-api",'[data-toggle="tab"], [data-toggle="pill"], [data-toggle="list"]',(function(t){t.preventDefault(),ge._jQueryInterface.call(o.default(this),"show")})),o.default.fn.tab=ge._jQueryInterface,o.default.fn.tab.Constructor=ge,o.default.fn.tab.noConflict=function(){return o.default.fn.tab=re,ge._jQueryInterface};var me="bs.toast",pe=o.default.fn.toast,_e="hide",ve="show",ye="showing",be="click.dismiss.bs.toast",Ee={animation:!0,autohide:!0,delay:500},Te={animation:"boolean",autohide:"boolean",delay:"number"},we=function(){function t(t,e){this._element=t,this._config=this._getConfig(e),this._timeout=null,this._setListeners()}var e=t.prototype;return e.show=function(){var t=this,e=o.default.Event("show.bs.toast");if(o.default(this._element).trigger(e),!e.isDefaultPrevented()){this._clearTimeout(),this._config.animation&&this._element.classList.add("fade");var n=function(){t._element.classList.remove(ye),t._element.classList.add(ve),o.default(t._element).trigger("shown.bs.toast"),t._config.autohide&&(t._timeout=setTimeout((function(){t.hide()}),t._config.delay))};if(this._element.classList.remove(_e),d.reflow(this._element),this._element.classList.add(ye),this._config.animation){var i=d.getTransitionDurationFromElement(this._element);o.default(this._element).one(d.TRANSITION_END,n).emulateTransitionEnd(i)}else n()}},e.hide=function(){if(this._element.classList.contains(ve)){var t=o.default.Event("hide.bs.toast");o.default(this._element).trigger(t),t.isDefaultPrevented()||this._close()}},e.dispose=function(){this._clearTimeout(),this._element.classList.contains(ve)&&this._element.classList.remove(ve),o.default(this._element).off(be),o.default.removeData(this._element,me),this._element=null,this._config=null},e._getConfig=function(t){return t=r({},Ee,o.default(this._element).data(),"object"==typeof t&&t?t:{}),d.typeCheckConfig("toast",t,this.constructor.DefaultType),t},e._setListeners=function(){var t=this;o.default(this._element).on(be,'[data-dismiss="toast"]',(function(){return t.hide()}))},e._close=function(){var t=this,e=function(){t._element.classList.add(_e),o.default(t._element).trigger("hidden.bs.toast")};if(this._element.classList.remove(ve),this._config.animation){var n=d.getTransitionDurationFromElement(this._element);o.default(this._element).one(d.TRANSITION_END,e).emulateTransitionEnd(n)}else e()},e._clearTimeout=function(){clearTimeout(this._timeout),this._timeout=null},t._jQueryInterface=function(e){return this.each((function(){var n=o.default(this),i=n.data(me);if(i||(i=new t(this,"object"==typeof e&&e),n.data(me,i)),"string"==typeof e){if("undefined"==typeof i[e])throw new TypeError('No method named "'+e+'"');i[e](this)}}))},l(t,null,[{key:"VERSION",get:function(){return"4.6.2"}},{key:"DefaultType",get:function(){return Te}},{key:"Default",get:function(){return Ee}}]),t}();o.default.fn.toast=we._jQueryInterface,o.default.fn.toast.Constructor=we,o.default.fn.toast.noConflict=function(){return o.default.fn.toast=pe,we._jQueryInterface},t.Alert=g,t.Button=E,t.Carousel=P,t.Collapse=V,t.Dropdown=lt,t.Modal=Ct,t.Popover=Jt,t.Scrollspy=se,t.Tab=ge,t.Toast=we,t.Tooltip=Wt,t.Util=d,Object.defineProperty(t,"__esModule",{value:!0})}));
//# sourceMappingURL=bootstrap.min.js.map php-code-coverage/src/Report/Html/Renderer/Template/js/nv.d3.min.js 0000644 00000651332 15243417753 0021034 0 ustar 00 /* nvd3 version 1.8.1 (https://github.com/novus/nvd3) 2015-06-15 */
!function(){var a={};a.dev=!1,a.tooltip=a.tooltip||{},a.utils=a.utils||{},a.models=a.models||{},a.charts={},a.logs={},a.dom={},a.dispatch=d3.dispatch("render_start","render_end"),Function.prototype.bind||(Function.prototype.bind=function(a){if("function"!=typeof this)throw new TypeError("Function.prototype.bind - what is trying to be bound is not callable");var b=Array.prototype.slice.call(arguments,1),c=this,d=function(){},e=function(){return c.apply(this instanceof d&&a?this:a,b.concat(Array.prototype.slice.call(arguments)))};return d.prototype=this.prototype,e.prototype=new d,e}),a.dev&&(a.dispatch.on("render_start",function(){a.logs.startTime=+new Date}),a.dispatch.on("render_end",function(){a.logs.endTime=+new Date,a.logs.totalTime=a.logs.endTime-a.logs.startTime,a.log("total",a.logs.totalTime)})),a.log=function(){if(a.dev&&window.console&&console.log&&console.log.apply)console.log.apply(console,arguments);else if(a.dev&&window.console&&"function"==typeof console.log&&Function.prototype.bind){var b=Function.prototype.bind.call(console.log,console);b.apply(console,arguments)}return arguments[arguments.length-1]},a.deprecated=function(a,b){console&&console.warn&&console.warn("nvd3 warning: `"+a+"` has been deprecated. ",b||"")},a.render=function(b){b=b||1,a.render.active=!0,a.dispatch.render_start();var c=function(){for(var d,e,f=0;b>f&&(e=a.render.queue[f]);f++)d=e.generate(),typeof e.callback==typeof Function&&e.callback(d);a.render.queue.splice(0,f),a.render.queue.length?setTimeout(c):(a.dispatch.render_end(),a.render.active=!1)};setTimeout(c)},a.render.active=!1,a.render.queue=[],a.addGraph=function(b){typeof arguments[0]==typeof Function&&(b={generate:arguments[0],callback:arguments[1]}),a.render.queue.push(b),a.render.active||a.render()},"undefined"!=typeof module&&"undefined"!=typeof exports&&(module.exports=a),"undefined"!=typeof window&&(window.nv=a),a.dom.write=function(a){return void 0!==window.fastdom?fastdom.write(a):a()},a.dom.read=function(a){return void 0!==window.fastdom?fastdom.read(a):a()},a.interactiveGuideline=function(){"use strict";function b(l){l.each(function(l){function m(){var a=d3.mouse(this),d=a[0],e=a[1],i=!0,j=!1;if(k&&(d=d3.event.offsetX,e=d3.event.offsetY,"svg"!==d3.event.target.tagName&&(i=!1),d3.event.target.className.baseVal.match("nv-legend")&&(j=!0)),i&&(d-=f.left,e-=f.top),0>d||0>e||d>o||e>p||d3.event.relatedTarget&&void 0===d3.event.relatedTarget.ownerSVGElement||j){if(k&&d3.event.relatedTarget&&void 0===d3.event.relatedTarget.ownerSVGElement&&(void 0===d3.event.relatedTarget.className||d3.event.relatedTarget.className.match(c.nvPointerEventsClass)))return;return h.elementMouseout({mouseX:d,mouseY:e}),b.renderGuideLine(null),void c.hidden(!0)}c.hidden(!1);var l=g.invert(d);h.elementMousemove({mouseX:d,mouseY:e,pointXValue:l}),"dblclick"===d3.event.type&&h.elementDblclick({mouseX:d,mouseY:e,pointXValue:l}),"click"===d3.event.type&&h.elementClick({mouseX:d,mouseY:e,pointXValue:l})}var n=d3.select(this),o=d||960,p=e||400,q=n.selectAll("g.nv-wrap.nv-interactiveLineLayer").data([l]),r=q.enter().append("g").attr("class"," nv-wrap nv-interactiveLineLayer");r.append("g").attr("class","nv-interactiveGuideLine"),j&&(j.on("touchmove",m).on("mousemove",m,!0).on("mouseout",m,!0).on("dblclick",m).on("click",m),b.guideLine=null,b.renderGuideLine=function(c){i&&(b.guideLine&&b.guideLine.attr("x1")===c||a.dom.write(function(){var b=q.select(".nv-interactiveGuideLine").selectAll("line").data(null!=c?[a.utils.NaNtoZero(c)]:[],String);b.enter().append("line").attr("class","nv-guideline").attr("x1",function(a){return a}).attr("x2",function(a){return a}).attr("y1",p).attr("y2",0),b.exit().remove()}))})})}var c=a.models.tooltip();c.duration(0).hideDelay(0)._isInteractiveLayer(!0).hidden(!1);var d=null,e=null,f={left:0,top:0},g=d3.scale.linear(),h=d3.dispatch("elementMousemove","elementMouseout","elementClick","elementDblclick"),i=!0,j=null,k="ActiveXObject"in window;return b.dispatch=h,b.tooltip=c,b.margin=function(a){return arguments.length?(f.top="undefined"!=typeof a.top?a.top:f.top,f.left="undefined"!=typeof a.left?a.left:f.left,b):f},b.width=function(a){return arguments.length?(d=a,b):d},b.height=function(a){return arguments.length?(e=a,b):e},b.xScale=function(a){return arguments.length?(g=a,b):g},b.showGuideLine=function(a){return arguments.length?(i=a,b):i},b.svgContainer=function(a){return arguments.length?(j=a,b):j},b},a.interactiveBisect=function(a,b,c){"use strict";if(!(a instanceof Array))return null;var d;d="function"!=typeof c?function(a){return a.x}:c;var e=function(a,b){return d(a)-b},f=d3.bisector(e).left,g=d3.max([0,f(a,b)-1]),h=d(a[g]);if("undefined"==typeof h&&(h=g),h===b)return g;var i=d3.min([g+1,a.length-1]),j=d(a[i]);return"undefined"==typeof j&&(j=i),Math.abs(j-b)>=Math.abs(h-b)?g:i},a.nearestValueIndex=function(a,b,c){"use strict";var d=1/0,e=null;return a.forEach(function(a,f){var g=Math.abs(b-a);null!=a&&d>=g&&c>g&&(d=g,e=f)}),e},function(){"use strict";a.models.tooltip=function(){function b(){if(k){var a=d3.select(k);"svg"!==a.node().tagName&&(a=a.select("svg"));var b=a.node()?a.attr("viewBox"):null;if(b){b=b.split(" ");var c=parseInt(a.style("width"),10)/b[2];p.left=p.left*c,p.top=p.top*c}}}function c(){if(!n){var a;a=k?k:document.body,n=d3.select(a).append("div").attr("class","nvtooltip "+(j?j:"xy-tooltip")).attr("id",v),n.style("top",0).style("left",0),n.style("opacity",0),n.selectAll("div, table, td, tr").classed(w,!0),n.classed(w,!0),o=n.node()}}function d(){if(r&&B(e)){b();var f=p.left,g=null!==i?i:p.top;return a.dom.write(function(){c();var b=A(e);b&&(o.innerHTML=b),k&&u?a.dom.read(function(){var a=k.getElementsByTagName("svg")[0],b={left:0,top:0};if(a){var c=a.getBoundingClientRect(),d=k.getBoundingClientRect(),e=c.top;if(0>e){var i=k.getBoundingClientRect();e=Math.abs(e)>i.height?0:e}b.top=Math.abs(e-d.top),b.left=Math.abs(c.left-d.left)}f+=k.offsetLeft+b.left-2*k.scrollLeft,g+=k.offsetTop+b.top-2*k.scrollTop,h&&h>0&&(g=Math.floor(g/h)*h),C([f,g])}):C([f,g])}),d}}var e=null,f="w",g=25,h=0,i=null,j=null,k=null,l=!0,m=400,n=null,o=null,p={left:null,top:null},q={left:0,top:0},r=!0,s=100,t=!0,u=!1,v="nvtooltip-"+Math.floor(1e5*Math.random()),w="nv-pointer-events-none",x=function(a){return a},y=function(a){return a},z=function(a){return a},A=function(a){if(null===a)return"";var b=d3.select(document.createElement("table"));if(t){var c=b.selectAll("thead").data([a]).enter().append("thead");c.append("tr").append("td").attr("colspan",3).append("strong").classed("x-value",!0).html(y(a.value))}var d=b.selectAll("tbody").data([a]).enter().append("tbody"),e=d.selectAll("tr").data(function(a){return a.series}).enter().append("tr").classed("highlight",function(a){return a.highlight});e.append("td").classed("legend-color-guide",!0).append("div").style("background-color",function(a){return a.color}),e.append("td").classed("key",!0).html(function(a,b){return z(a.key,b)}),e.append("td").classed("value",!0).html(function(a,b){return x(a.value,b)}),e.selectAll("td").each(function(a){if(a.highlight){var b=d3.scale.linear().domain([0,1]).range(["#fff",a.color]),c=.6;d3.select(this).style("border-bottom-color",b(c)).style("border-top-color",b(c))}});var f=b.node().outerHTML;return void 0!==a.footer&&(f+="<div class='footer'>"+a.footer+"</div>"),f},B=function(a){if(a&&a.series){if(a.series instanceof Array)return!!a.series.length;if(a.series instanceof Object)return a.series=[a.series],!0}return!1},C=function(b){o&&a.dom.read(function(){var c,d,e=parseInt(o.offsetHeight,10),h=parseInt(o.offsetWidth,10),i=a.utils.windowSize().width,j=a.utils.windowSize().height,k=window.pageYOffset,p=window.pageXOffset;j=window.innerWidth>=document.body.scrollWidth?j:j-16,i=window.innerHeight>=document.body.scrollHeight?i:i-16;var r,t,u=function(a){var b=d;do isNaN(a.offsetTop)||(b+=a.offsetTop),a=a.offsetParent;while(a);return b},v=function(a){var b=c;do isNaN(a.offsetLeft)||(b+=a.offsetLeft),a=a.offsetParent;while(a);return b};switch(f){case"e":c=b[0]-h-g,d=b[1]-e/2,r=v(o),t=u(o),p>r&&(c=b[0]+g>p?b[0]+g:p-r+c),k>t&&(d=k-t+d),t+e>k+j&&(d=k+j-t+d-e);break;case"w":c=b[0]+g,d=b[1]-e/2,r=v(o),t=u(o),r+h>i&&(c=b[0]-h-g),k>t&&(d=k+5),t+e>k+j&&(d=k+j-t+d-e);break;case"n":c=b[0]-h/2-5,d=b[1]+g,r=v(o),t=u(o),p>r&&(c=p+5),r+h>i&&(c=c-h/2+5),t+e>k+j&&(d=k+j-t+d-e);break;case"s":c=b[0]-h/2,d=b[1]-e-g,r=v(o),t=u(o),p>r&&(c=p+5),r+h>i&&(c=c-h/2+5),k>t&&(d=k);break;case"none":c=b[0],d=b[1]-g,r=v(o),t=u(o)}c-=q.left,d-=q.top;var w=o.getBoundingClientRect(),k=window.pageYOffset||document.documentElement.scrollTop,p=window.pageXOffset||document.documentElement.scrollLeft,x="translate("+(w.left+p)+"px, "+(w.top+k)+"px)",y="translate("+c+"px, "+d+"px)",z=d3.interpolateString(x,y),A=n.style("opacity")<.1;l?n.transition().delay(m).duration(0).style("opacity",0):n.interrupt().transition().duration(A?0:s).styleTween("transform",function(){return z},"important").style("-webkit-transform",y).style("opacity",1)})};return d.nvPointerEventsClass=w,d.options=a.utils.optionsFunc.bind(d),d._options=Object.create({},{duration:{get:function(){return s},set:function(a){s=a}},gravity:{get:function(){return f},set:function(a){f=a}},distance:{get:function(){return g},set:function(a){g=a}},snapDistance:{get:function(){return h},set:function(a){h=a}},classes:{get:function(){return j},set:function(a){j=a}},chartContainer:{get:function(){return k},set:function(a){k=a}},fixedTop:{get:function(){return i},set:function(a){i=a}},enabled:{get:function(){return r},set:function(a){r=a}},hideDelay:{get:function(){return m},set:function(a){m=a}},contentGenerator:{get:function(){return A},set:function(a){A=a}},valueFormatter:{get:function(){return x},set:function(a){x=a}},headerFormatter:{get:function(){return y},set:function(a){y=a}},keyFormatter:{get:function(){return z},set:function(a){z=a}},headerEnabled:{get:function(){return t},set:function(a){t=a}},_isInteractiveLayer:{get:function(){return u},set:function(a){u=!!a}},position:{get:function(){return p},set:function(a){p.left=void 0!==a.left?a.left:p.left,p.top=void 0!==a.top?a.top:p.top}},offset:{get:function(){return q},set:function(a){q.left=void 0!==a.left?a.left:q.left,q.top=void 0!==a.top?a.top:q.top}},hidden:{get:function(){return l},set:function(a){l!=a&&(l=!!a,d())}},data:{get:function(){return e},set:function(a){a.point&&(a.value=a.point.x,a.series=a.series||{},a.series.value=a.point.y,a.series.color=a.point.color||a.series.color),e=a}},tooltipElem:{get:function(){return o},set:function(){}},id:{get:function(){return v},set:function(){}}}),a.utils.initOptions(d),d}}(),a.utils.windowSize=function(){var a={width:640,height:480};return window.innerWidth&&window.innerHeight?(a.width=window.innerWidth,a.height=window.innerHeight,a):"CSS1Compat"==document.compatMode&&document.documentElement&&document.documentElement.offsetWidth?(a.width=document.documentElement.offsetWidth,a.height=document.documentElement.offsetHeight,a):document.body&&document.body.offsetWidth?(a.width=document.body.offsetWidth,a.height=document.body.offsetHeight,a):a},a.utils.windowResize=function(b){return window.addEventListener?window.addEventListener("resize",b):a.log("ERROR: Failed to bind to window.resize with: ",b),{callback:b,clear:function(){window.removeEventListener("resize",b)}}},a.utils.getColor=function(b){if(void 0===b)return a.utils.defaultColor();if(Array.isArray(b)){var c=d3.scale.ordinal().range(b);return function(a,b){var d=void 0===b?a:b;return a.color||c(d)}}return b},a.utils.defaultColor=function(){return a.utils.getColor(d3.scale.category20().range())},a.utils.customTheme=function(a,b,c){b=b||function(a){return a.key},c=c||d3.scale.category20().range();var d=c.length;return function(e){var f=b(e);return"function"==typeof a[f]?a[f]():void 0!==a[f]?a[f]:(d||(d=c.length),d-=1,c[d])}},a.utils.pjax=function(b,c){var d=function(d){d3.html(d,function(d){var e=d3.select(c).node();e.parentNode.replaceChild(d3.select(d).select(c).node(),e),a.utils.pjax(b,c)})};d3.selectAll(b).on("click",function(){history.pushState(this.href,this.textContent,this.href),d(this.href),d3.event.preventDefault()}),d3.select(window).on("popstate",function(){d3.event.state&&d(d3.event.state)})},a.utils.calcApproxTextWidth=function(a){if("function"==typeof a.style&&"function"==typeof a.text){var b=parseInt(a.style("font-size").replace("px",""),10),c=a.text().length;return c*b*.5}return 0},a.utils.NaNtoZero=function(a){return"number"!=typeof a||isNaN(a)||null===a||1/0===a||a===-1/0?0:a},d3.selection.prototype.watchTransition=function(a){var b=[this].concat([].slice.call(arguments,1));return a.transition.apply(a,b)},a.utils.renderWatch=function(b,c){if(!(this instanceof a.utils.renderWatch))return new a.utils.renderWatch(b,c);var d=void 0!==c?c:250,e=[],f=this;this.models=function(a){return a=[].slice.call(arguments,0),a.forEach(function(a){a.__rendered=!1,function(a){a.dispatch.on("renderEnd",function(){a.__rendered=!0,f.renderEnd("model")})}(a),e.indexOf(a)<0&&e.push(a)}),this},this.reset=function(a){void 0!==a&&(d=a),e=[]},this.transition=function(a,b,c){if(b=arguments.length>1?[].slice.call(arguments,1):[],c=b.length>1?b.pop():void 0!==d?d:250,a.__rendered=!1,e.indexOf(a)<0&&e.push(a),0===c)return a.__rendered=!0,a.delay=function(){return this},a.duration=function(){return this},a;a.__rendered=0===a.length?!0:a.every(function(a){return!a.length})?!0:!1;var g=0;return a.transition().duration(c).each(function(){++g}).each("end",function(){0===--g&&(a.__rendered=!0,f.renderEnd.apply(this,b))})},this.renderEnd=function(){e.every(function(a){return a.__rendered})&&(e.forEach(function(a){a.__rendered=!1}),b.renderEnd.apply(this,arguments))}},a.utils.deepExtend=function(b){var c=arguments.length>1?[].slice.call(arguments,1):[];c.forEach(function(c){for(var d in c){var e=b[d]instanceof Array,f="object"==typeof b[d],g="object"==typeof c[d];f&&!e&&g?a.utils.deepExtend(b[d],c[d]):b[d]=c[d]}})},a.utils.state=function(){if(!(this instanceof a.utils.state))return new a.utils.state;var b={},c=function(){},d=function(){return{}},e=null,f=null;this.dispatch=d3.dispatch("change","set"),this.dispatch.on("set",function(a){c(a,!0)}),this.getter=function(a){return d=a,this},this.setter=function(a,b){return b||(b=function(){}),c=function(c,d){a(c),d&&b()},this},this.init=function(b){e=e||{},a.utils.deepExtend(e,b)};var g=function(){var a=d();if(JSON.stringify(a)===JSON.stringify(b))return!1;for(var c in a)void 0===b[c]&&(b[c]={}),b[c]=a[c],f=!0;return!0};this.update=function(){e&&(c(e,!1),e=null),g.call(this)&&this.dispatch.change(b)}},a.utils.optionsFunc=function(a){return a&&d3.map(a).forEach(function(a,b){"function"==typeof this[a]&&this[a](b)}.bind(this)),this},a.utils.calcTicksX=function(b,c){var d=1,e=0;for(e;e<c.length;e+=1){var f=c[e]&&c[e].values?c[e].values.length:0;d=f>d?f:d}return a.log("Requested number of ticks: ",b),a.log("Calculated max values to be: ",d),b=b>d?b=d-1:b,b=1>b?1:b,b=Math.floor(b),a.log("Calculating tick count as: ",b),b},a.utils.calcTicksY=function(b,c){return a.utils.calcTicksX(b,c)},a.utils.initOption=function(a,b){a._calls&&a._calls[b]?a[b]=a._calls[b]:(a[b]=function(c){return arguments.length?(a._overrides[b]=!0,a._options[b]=c,a):a._options[b]},a["_"+b]=function(c){return arguments.length?(a._overrides[b]||(a._options[b]=c),a):a._options[b]})},a.utils.initOptions=function(b){b._overrides=b._overrides||{};var c=Object.getOwnPropertyNames(b._options||{}),d=Object.getOwnPropertyNames(b._calls||{});c=c.concat(d);for(var e in c)a.utils.initOption(b,c[e])},a.utils.inheritOptionsD3=function(a,b,c){a._d3options=c.concat(a._d3options||[]),c.unshift(b),c.unshift(a),d3.rebind.apply(this,c)},a.utils.arrayUnique=function(a){return a.sort().filter(function(b,c){return!c||b!=a[c-1]})},a.utils.symbolMap=d3.map(),a.utils.symbol=function(){function b(b,e){var f=c.call(this,b,e),g=d.call(this,b,e);return-1!==d3.svg.symbolTypes.indexOf(f)?d3.svg.symbol().type(f).size(g)():a.utils.symbolMap.get(f)(g)}var c,d=64;return b.type=function(a){return arguments.length?(c=d3.functor(a),b):c},b.size=function(a){return arguments.length?(d=d3.functor(a),b):d},b},a.utils.inheritOptions=function(b,c){var d=Object.getOwnPropertyNames(c._options||{}),e=Object.getOwnPropertyNames(c._calls||{}),f=c._inherited||[],g=c._d3options||[],h=d.concat(e).concat(f).concat(g);h.unshift(c),h.unshift(b),d3.rebind.apply(this,h),b._inherited=a.utils.arrayUnique(d.concat(e).concat(f).concat(d).concat(b._inherited||[])),b._d3options=a.utils.arrayUnique(g.concat(b._d3options||[]))},a.utils.initSVG=function(a){a.classed({"nvd3-svg":!0})},a.utils.sanitizeHeight=function(a,b){return a||parseInt(b.style("height"),10)||400},a.utils.sanitizeWidth=function(a,b){return a||parseInt(b.style("width"),10)||960},a.utils.availableHeight=function(b,c,d){return a.utils.sanitizeHeight(b,c)-d.top-d.bottom},a.utils.availableWidth=function(b,c,d){return a.utils.sanitizeWidth(b,c)-d.left-d.right},a.utils.noData=function(b,c){var d=b.options(),e=d.margin(),f=d.noData(),g=null==f?["No Data Available."]:[f],h=a.utils.availableHeight(d.height(),c,e),i=a.utils.availableWidth(d.width(),c,e),j=e.left+i/2,k=e.top+h/2;c.selectAll("g").remove();var l=c.selectAll(".nv-noData").data(g);l.enter().append("text").attr("class","nvd3 nv-noData").attr("dy","-.7em").style("text-anchor","middle"),l.attr("x",j).attr("y",k).text(function(a){return a})},a.models.axis=function(){"use strict";function b(g){return s.reset(),g.each(function(b){var g=d3.select(this);a.utils.initSVG(g);var p=g.selectAll("g.nv-wrap.nv-axis").data([b]),q=p.enter().append("g").attr("class","nvd3 nv-wrap nv-axis"),t=(q.append("g"),p.select("g"));null!==n?c.ticks(n):("top"==c.orient()||"bottom"==c.orient())&&c.ticks(Math.abs(d.range()[1]-d.range()[0])/100),t.watchTransition(s,"axis").call(c),r=r||c.scale();var u=c.tickFormat();null==u&&(u=r.tickFormat());var v=t.selectAll("text.nv-axislabel").data([h||null]);v.exit().remove();var w,x,y;switch(c.orient()){case"top":v.enter().append("text").attr("class","nv-axislabel"),y=d.range().length<2?0:2===d.range().length?d.range()[1]:d.range()[d.range().length-1]+(d.range()[1]-d.range()[0]),v.attr("text-anchor","middle").attr("y",0).attr("x",y/2),i&&(x=p.selectAll("g.nv-axisMaxMin").data(d.domain()),x.enter().append("g").attr("class",function(a,b){return["nv-axisMaxMin","nv-axisMaxMin-x",0==b?"nv-axisMin-x":"nv-axisMax-x"].join(" ")}).append("text"),x.exit().remove(),x.attr("transform",function(b){return"translate("+a.utils.NaNtoZero(d(b))+",0)"}).select("text").attr("dy","-0.5em").attr("y",-c.tickPadding()).attr("text-anchor","middle").text(function(a){var b=u(a);return(""+b).match("NaN")?"":b}),x.watchTransition(s,"min-max top").attr("transform",function(b,c){return"translate("+a.utils.NaNtoZero(d.range()[c])+",0)"}));break;case"bottom":w=o+36;var z=30,A=0,B=t.selectAll("g").select("text"),C="";if(j%360){B.each(function(){var a=this.getBoundingClientRect(),b=a.width;A=a.height,b>z&&(z=b)}),C="rotate("+j+" 0,"+(A/2+c.tickPadding())+")";var D=Math.abs(Math.sin(j*Math.PI/180));w=(D?D*z:z)+30,B.attr("transform",C).style("text-anchor",j%360>0?"start":"end")}v.enter().append("text").attr("class","nv-axislabel"),y=d.range().length<2?0:2===d.range().length?d.range()[1]:d.range()[d.range().length-1]+(d.range()[1]-d.range()[0]),v.attr("text-anchor","middle").attr("y",w).attr("x",y/2),i&&(x=p.selectAll("g.nv-axisMaxMin").data([d.domain()[0],d.domain()[d.domain().length-1]]),x.enter().append("g").attr("class",function(a,b){return["nv-axisMaxMin","nv-axisMaxMin-x",0==b?"nv-axisMin-x":"nv-axisMax-x"].join(" ")}).append("text"),x.exit().remove(),x.attr("transform",function(b){return"translate("+a.utils.NaNtoZero(d(b)+(m?d.rangeBand()/2:0))+",0)"}).select("text").attr("dy",".71em").attr("y",c.tickPadding()).attr("transform",C).style("text-anchor",j?j%360>0?"start":"end":"middle").text(function(a){var b=u(a);return(""+b).match("NaN")?"":b}),x.watchTransition(s,"min-max bottom").attr("transform",function(b){return"translate("+a.utils.NaNtoZero(d(b)+(m?d.rangeBand()/2:0))+",0)"})),l&&B.attr("transform",function(a,b){return"translate(0,"+(b%2==0?"0":"12")+")"});break;case"right":v.enter().append("text").attr("class","nv-axislabel"),v.style("text-anchor",k?"middle":"begin").attr("transform",k?"rotate(90)":"").attr("y",k?-Math.max(e.right,f)+12:-10).attr("x",k?d3.max(d.range())/2:c.tickPadding()),i&&(x=p.selectAll("g.nv-axisMaxMin").data(d.domain()),x.enter().append("g").attr("class",function(a,b){return["nv-axisMaxMin","nv-axisMaxMin-y",0==b?"nv-axisMin-y":"nv-axisMax-y"].join(" ")}).append("text").style("opacity",0),x.exit().remove(),x.attr("transform",function(b){return"translate(0,"+a.utils.NaNtoZero(d(b))+")"}).select("text").attr("dy",".32em").attr("y",0).attr("x",c.tickPadding()).style("text-anchor","start").text(function(a){var b=u(a);return(""+b).match("NaN")?"":b}),x.watchTransition(s,"min-max right").attr("transform",function(b,c){return"translate(0,"+a.utils.NaNtoZero(d.range()[c])+")"}).select("text").style("opacity",1));break;case"left":v.enter().append("text").attr("class","nv-axislabel"),v.style("text-anchor",k?"middle":"end").attr("transform",k?"rotate(-90)":"").attr("y",k?-Math.max(e.left,f)+25-(o||0):-10).attr("x",k?-d3.max(d.range())/2:-c.tickPadding()),i&&(x=p.selectAll("g.nv-axisMaxMin").data(d.domain()),x.enter().append("g").attr("class",function(a,b){return["nv-axisMaxMin","nv-axisMaxMin-y",0==b?"nv-axisMin-y":"nv-axisMax-y"].join(" ")}).append("text").style("opacity",0),x.exit().remove(),x.attr("transform",function(b){return"translate(0,"+a.utils.NaNtoZero(r(b))+")"}).select("text").attr("dy",".32em").attr("y",0).attr("x",-c.tickPadding()).attr("text-anchor","end").text(function(a){var b=u(a);return(""+b).match("NaN")?"":b}),x.watchTransition(s,"min-max right").attr("transform",function(b,c){return"translate(0,"+a.utils.NaNtoZero(d.range()[c])+")"}).select("text").style("opacity",1))}if(v.text(function(a){return a}),!i||"left"!==c.orient()&&"right"!==c.orient()||(t.selectAll("g").each(function(a){d3.select(this).select("text").attr("opacity",1),(d(a)<d.range()[1]+10||d(a)>d.range()[0]-10)&&((a>1e-10||-1e-10>a)&&d3.select(this).attr("opacity",0),d3.select(this).select("text").attr("opacity",0))}),d.domain()[0]==d.domain()[1]&&0==d.domain()[0]&&p.selectAll("g.nv-axisMaxMin").style("opacity",function(a,b){return b?0:1})),i&&("top"===c.orient()||"bottom"===c.orient())){var E=[];p.selectAll("g.nv-axisMaxMin").each(function(a,b){try{E.push(b?d(a)-this.getBoundingClientRect().width-4:d(a)+this.getBoundingClientRect().width+4)}catch(c){E.push(b?d(a)-4:d(a)+4)}}),t.selectAll("g").each(function(a){(d(a)<E[0]||d(a)>E[1])&&(a>1e-10||-1e-10>a?d3.select(this).remove():d3.select(this).select("text").remove())})}t.selectAll(".tick").filter(function(a){return!parseFloat(Math.round(1e5*a)/1e6)&&void 0!==a}).classed("zero",!0),r=d.copy()}),s.renderEnd("axis immediate"),b}var c=d3.svg.axis(),d=d3.scale.linear(),e={top:0,right:0,bottom:0,left:0},f=75,g=60,h=null,i=!0,j=0,k=!0,l=!1,m=!1,n=null,o=0,p=250,q=d3.dispatch("renderEnd");c.scale(d).orient("bottom").tickFormat(function(a){return a});var r,s=a.utils.renderWatch(q,p);return b.axis=c,b.dispatch=q,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{axisLabelDistance:{get:function(){return o},set:function(a){o=a}},staggerLabels:{get:function(){return l},set:function(a){l=a}},rotateLabels:{get:function(){return j},set:function(a){j=a}},rotateYLabel:{get:function(){return k},set:function(a){k=a}},showMaxMin:{get:function(){return i},set:function(a){i=a}},axisLabel:{get:function(){return h},set:function(a){h=a}},height:{get:function(){return g},set:function(a){g=a}},ticks:{get:function(){return n},set:function(a){n=a}},width:{get:function(){return f},set:function(a){f=a}},margin:{get:function(){return e},set:function(a){e.top=void 0!==a.top?a.top:e.top,e.right=void 0!==a.right?a.right:e.right,e.bottom=void 0!==a.bottom?a.bottom:e.bottom,e.left=void 0!==a.left?a.left:e.left}},duration:{get:function(){return p},set:function(a){p=a,s.reset(p)}},scale:{get:function(){return d},set:function(e){d=e,c.scale(d),m="function"==typeof d.rangeBands,a.utils.inheritOptionsD3(b,d,["domain","range","rangeBand","rangeBands"])}}}),a.utils.initOptions(b),a.utils.inheritOptionsD3(b,c,["orient","tickValues","tickSubdivide","tickSize","tickPadding","tickFormat"]),a.utils.inheritOptionsD3(b,d,["domain","range","rangeBand","rangeBands"]),b},a.models.boxPlot=function(){"use strict";function b(l){return v.reset(),l.each(function(b){var l=j-i.left-i.right,p=k-i.top-i.bottom;r=d3.select(this),a.utils.initSVG(r),m.domain(c||b.map(function(a,b){return o(a,b)})).rangeBands(e||[0,l],.1);var w=[];if(!d){var x=d3.min(b.map(function(a){var b=[];return b.push(a.values.Q1),a.values.hasOwnProperty("whisker_low")&&null!==a.values.whisker_low&&b.push(a.values.whisker_low),a.values.hasOwnProperty("outliers")&&null!==a.values.outliers&&(b=b.concat(a.values.outliers)),d3.min(b)})),y=d3.max(b.map(function(a){var b=[];return b.push(a.values.Q3),a.values.hasOwnProperty("whisker_high")&&null!==a.values.whisker_high&&b.push(a.values.whisker_high),a.values.hasOwnProperty("outliers")&&null!==a.values.outliers&&(b=b.concat(a.values.outliers)),d3.max(b)}));w=[x,y]}n.domain(d||w),n.range(f||[p,0]),g=g||m,h=h||n.copy().range([n(0),n(0)]);{var z=r.selectAll("g.nv-wrap").data([b]);z.enter().append("g").attr("class","nvd3 nv-wrap")}z.attr("transform","translate("+i.left+","+i.top+")");var A=z.selectAll(".nv-boxplot").data(function(a){return a}),B=A.enter().append("g").style("stroke-opacity",1e-6).style("fill-opacity",1e-6);A.attr("class","nv-boxplot").attr("transform",function(a,b){return"translate("+(m(o(a,b))+.05*m.rangeBand())+", 0)"}).classed("hover",function(a){return a.hover}),A.watchTransition(v,"nv-boxplot: boxplots").style("stroke-opacity",1).style("fill-opacity",.75).delay(function(a,c){return c*t/b.length}).attr("transform",function(a,b){return"translate("+(m(o(a,b))+.05*m.rangeBand())+", 0)"}),A.exit().remove(),B.each(function(a,b){var c=d3.select(this);["low","high"].forEach(function(d){a.values.hasOwnProperty("whisker_"+d)&&null!==a.values["whisker_"+d]&&(c.append("line").style("stroke",a.color?a.color:q(a,b)).attr("class","nv-boxplot-whisker nv-boxplot-"+d),c.append("line").style("stroke",a.color?a.color:q(a,b)).attr("class","nv-boxplot-tick nv-boxplot-"+d))})});var C=A.selectAll(".nv-boxplot-outlier").data(function(a){return a.values.hasOwnProperty("outliers")&&null!==a.values.outliers?a.values.outliers:[]});C.enter().append("circle").style("fill",function(a,b,c){return q(a,c)}).style("stroke",function(a,b,c){return q(a,c)}).on("mouseover",function(a,b,c){d3.select(this).classed("hover",!0),s.elementMouseover({series:{key:a,color:q(a,c)},e:d3.event})}).on("mouseout",function(a,b,c){d3.select(this).classed("hover",!1),s.elementMouseout({series:{key:a,color:q(a,c)},e:d3.event})}).on("mousemove",function(){s.elementMousemove({e:d3.event})}),C.attr("class","nv-boxplot-outlier"),C.watchTransition(v,"nv-boxplot: nv-boxplot-outlier").attr("cx",.45*m.rangeBand()).attr("cy",function(a){return n(a)}).attr("r","3"),C.exit().remove();var D=function(){return null===u?.9*m.rangeBand():Math.min(75,.9*m.rangeBand())},E=function(){return.45*m.rangeBand()-D()/2},F=function(){return.45*m.rangeBand()+D()/2};["low","high"].forEach(function(a){var b="low"===a?"Q1":"Q3";A.select("line.nv-boxplot-whisker.nv-boxplot-"+a).watchTransition(v,"nv-boxplot: boxplots").attr("x1",.45*m.rangeBand()).attr("y1",function(b){return n(b.values["whisker_"+a])}).attr("x2",.45*m.rangeBand()).attr("y2",function(a){return n(a.values[b])}),A.select("line.nv-boxplot-tick.nv-boxplot-"+a).watchTransition(v,"nv-boxplot: boxplots").attr("x1",E).attr("y1",function(b){return n(b.values["whisker_"+a])}).attr("x2",F).attr("y2",function(b){return n(b.values["whisker_"+a])})}),["low","high"].forEach(function(a){B.selectAll(".nv-boxplot-"+a).on("mouseover",function(b,c,d){d3.select(this).classed("hover",!0),s.elementMouseover({series:{key:b.values["whisker_"+a],color:q(b,d)},e:d3.event})}).on("mouseout",function(b,c,d){d3.select(this).classed("hover",!1),s.elementMouseout({series:{key:b.values["whisker_"+a],color:q(b,d)},e:d3.event})}).on("mousemove",function(){s.elementMousemove({e:d3.event})})}),B.append("rect").attr("class","nv-boxplot-box").on("mouseover",function(a,b){d3.select(this).classed("hover",!0),s.elementMouseover({key:a.label,value:a.label,series:[{key:"Q3",value:a.values.Q3,color:a.color||q(a,b)},{key:"Q2",value:a.values.Q2,color:a.color||q(a,b)},{key:"Q1",value:a.values.Q1,color:a.color||q(a,b)}],data:a,index:b,e:d3.event})}).on("mouseout",function(a,b){d3.select(this).classed("hover",!1),s.elementMouseout({key:a.label,value:a.label,series:[{key:"Q3",value:a.values.Q3,color:a.color||q(a,b)},{key:"Q2",value:a.values.Q2,color:a.color||q(a,b)},{key:"Q1",value:a.values.Q1,color:a.color||q(a,b)}],data:a,index:b,e:d3.event})}).on("mousemove",function(){s.elementMousemove({e:d3.event})}),A.select("rect.nv-boxplot-box").watchTransition(v,"nv-boxplot: boxes").attr("y",function(a){return n(a.values.Q3)}).attr("width",D).attr("x",E).attr("height",function(a){return Math.abs(n(a.values.Q3)-n(a.values.Q1))||1}).style("fill",function(a,b){return a.color||q(a,b)}).style("stroke",function(a,b){return a.color||q(a,b)}),B.append("line").attr("class","nv-boxplot-median"),A.select("line.nv-boxplot-median").watchTransition(v,"nv-boxplot: boxplots line").attr("x1",E).attr("y1",function(a){return n(a.values.Q2)}).attr("x2",F).attr("y2",function(a){return n(a.values.Q2)}),g=m.copy(),h=n.copy()}),v.renderEnd("nv-boxplot immediate"),b}var c,d,e,f,g,h,i={top:0,right:0,bottom:0,left:0},j=960,k=500,l=Math.floor(1e4*Math.random()),m=d3.scale.ordinal(),n=d3.scale.linear(),o=function(a){return a.x},p=function(a){return a.y},q=a.utils.defaultColor(),r=null,s=d3.dispatch("elementMouseover","elementMouseout","elementMousemove","renderEnd"),t=250,u=null,v=a.utils.renderWatch(s,t);return b.dispatch=s,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return j},set:function(a){j=a}},height:{get:function(){return k},set:function(a){k=a}},maxBoxWidth:{get:function(){return u},set:function(a){u=a}},x:{get:function(){return o},set:function(a){o=a}},y:{get:function(){return p},set:function(a){p=a}},xScale:{get:function(){return m},set:function(a){m=a}},yScale:{get:function(){return n},set:function(a){n=a}},xDomain:{get:function(){return c},set:function(a){c=a}},yDomain:{get:function(){return d},set:function(a){d=a}},xRange:{get:function(){return e},set:function(a){e=a}},yRange:{get:function(){return f},set:function(a){f=a}},id:{get:function(){return l},set:function(a){l=a}},margin:{get:function(){return i},set:function(a){i.top=void 0!==a.top?a.top:i.top,i.right=void 0!==a.right?a.right:i.right,i.bottom=void 0!==a.bottom?a.bottom:i.bottom,i.left=void 0!==a.left?a.left:i.left}},color:{get:function(){return q},set:function(b){q=a.utils.getColor(b)}},duration:{get:function(){return t},set:function(a){t=a,v.reset(t)}}}),a.utils.initOptions(b),b},a.models.boxPlotChart=function(){"use strict";function b(k){return t.reset(),t.models(e),l&&t.models(f),m&&t.models(g),k.each(function(k){var p=d3.select(this);a.utils.initSVG(p);var t=(i||parseInt(p.style("width"))||960)-h.left-h.right,u=(j||parseInt(p.style("height"))||400)-h.top-h.bottom;if(b.update=function(){r.beforeUpdate(),p.transition().duration(s).call(b)},b.container=this,!(k&&k.length&&k.filter(function(a){return a.values.hasOwnProperty("Q1")&&a.values.hasOwnProperty("Q2")&&a.values.hasOwnProperty("Q3")}).length)){var v=p.selectAll(".nv-noData").data([q]);return v.enter().append("text").attr("class","nvd3 nv-noData").attr("dy","-.7em").style("text-anchor","middle"),v.attr("x",h.left+t/2).attr("y",h.top+u/2).text(function(a){return a}),b}p.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale().clamp(!0);var w=p.selectAll("g.nv-wrap.nv-boxPlotWithAxes").data([k]),x=w.enter().append("g").attr("class","nvd3 nv-wrap nv-boxPlotWithAxes").append("g"),y=x.append("defs"),z=w.select("g");
x.append("g").attr("class","nv-x nv-axis"),x.append("g").attr("class","nv-y nv-axis").append("g").attr("class","nv-zeroLine").append("line"),x.append("g").attr("class","nv-barsWrap"),z.attr("transform","translate("+h.left+","+h.top+")"),n&&z.select(".nv-y.nv-axis").attr("transform","translate("+t+",0)"),e.width(t).height(u);var A=z.select(".nv-barsWrap").datum(k.filter(function(a){return!a.disabled}));if(A.transition().call(e),y.append("clipPath").attr("id","nv-x-label-clip-"+e.id()).append("rect"),z.select("#nv-x-label-clip-"+e.id()+" rect").attr("width",c.rangeBand()*(o?2:1)).attr("height",16).attr("x",-c.rangeBand()/(o?1:2)),l){f.scale(c).ticks(a.utils.calcTicksX(t/100,k)).tickSize(-u,0),z.select(".nv-x.nv-axis").attr("transform","translate(0,"+d.range()[0]+")"),z.select(".nv-x.nv-axis").call(f);var B=z.select(".nv-x.nv-axis").selectAll("g");o&&B.selectAll("text").attr("transform",function(a,b,c){return"translate(0,"+(c%2==0?"5":"17")+")"})}m&&(g.scale(d).ticks(Math.floor(u/36)).tickSize(-t,0),z.select(".nv-y.nv-axis").call(g)),z.select(".nv-zeroLine line").attr("x1",0).attr("x2",t).attr("y1",d(0)).attr("y2",d(0))}),t.renderEnd("nv-boxplot chart immediate"),b}var c,d,e=a.models.boxPlot(),f=a.models.axis(),g=a.models.axis(),h={top:15,right:10,bottom:50,left:60},i=null,j=null,k=a.utils.getColor(),l=!0,m=!0,n=!1,o=!1,p=a.models.tooltip(),q="No Data Available.",r=d3.dispatch("tooltipShow","tooltipHide","beforeUpdate","renderEnd"),s=250;f.orient("bottom").showMaxMin(!1).tickFormat(function(a){return a}),g.orient(n?"right":"left").tickFormat(d3.format(",.1f")),p.duration(0);var t=a.utils.renderWatch(r,s);return e.dispatch.on("elementMouseover.tooltip",function(a){p.data(a).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(a){p.data(a).hidden(!0)}),e.dispatch.on("elementMousemove.tooltip",function(){p.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=r,b.boxplot=e,b.xAxis=f,b.yAxis=g,b.tooltip=p,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return i},set:function(a){i=a}},height:{get:function(){return j},set:function(a){j=a}},staggerLabels:{get:function(){return o},set:function(a){o=a}},showXAxis:{get:function(){return l},set:function(a){l=a}},showYAxis:{get:function(){return m},set:function(a){m=a}},tooltips:{get:function(){return tooltips},set:function(a){tooltips=a}},tooltipContent:{get:function(){return p},set:function(a){p=a}},noData:{get:function(){return q},set:function(a){q=a}},margin:{get:function(){return h},set:function(a){h.top=void 0!==a.top?a.top:h.top,h.right=void 0!==a.right?a.right:h.right,h.bottom=void 0!==a.bottom?a.bottom:h.bottom,h.left=void 0!==a.left?a.left:h.left}},duration:{get:function(){return s},set:function(a){s=a,t.reset(s),e.duration(s),f.duration(s),g.duration(s)}},color:{get:function(){return k},set:function(b){k=a.utils.getColor(b),e.color(k)}},rightAlignYAxis:{get:function(){return n},set:function(a){n=a,g.orient(a?"right":"left")}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.bullet=function(){"use strict";function b(d){return d.each(function(b,d){var p=m-c.left-c.right,s=n-c.top-c.bottom;o=d3.select(this),a.utils.initSVG(o);{var t=f.call(this,b,d).slice().sort(d3.descending),u=g.call(this,b,d).slice().sort(d3.descending),v=h.call(this,b,d).slice().sort(d3.descending),w=i.call(this,b,d).slice(),x=j.call(this,b,d).slice(),y=k.call(this,b,d).slice(),z=d3.scale.linear().domain(d3.extent(d3.merge([l,t]))).range(e?[p,0]:[0,p]);this.__chart__||d3.scale.linear().domain([0,1/0]).range(z.range())}this.__chart__=z;var A=d3.min(t),B=d3.max(t),C=t[1],D=o.selectAll("g.nv-wrap.nv-bullet").data([b]),E=D.enter().append("g").attr("class","nvd3 nv-wrap nv-bullet"),F=E.append("g"),G=D.select("g");F.append("rect").attr("class","nv-range nv-rangeMax"),F.append("rect").attr("class","nv-range nv-rangeAvg"),F.append("rect").attr("class","nv-range nv-rangeMin"),F.append("rect").attr("class","nv-measure"),D.attr("transform","translate("+c.left+","+c.top+")");var H=function(a){return Math.abs(z(a)-z(0))},I=function(a){return z(0>a?a:0)};G.select("rect.nv-rangeMax").attr("height",s).attr("width",H(B>0?B:A)).attr("x",I(B>0?B:A)).datum(B>0?B:A),G.select("rect.nv-rangeAvg").attr("height",s).attr("width",H(C)).attr("x",I(C)).datum(C),G.select("rect.nv-rangeMin").attr("height",s).attr("width",H(B)).attr("x",I(B)).attr("width",H(B>0?A:B)).attr("x",I(B>0?A:B)).datum(B>0?A:B),G.select("rect.nv-measure").style("fill",q).attr("height",s/3).attr("y",s/3).attr("width",0>v?z(0)-z(v[0]):z(v[0])-z(0)).attr("x",I(v)).on("mouseover",function(){r.elementMouseover({value:v[0],label:y[0]||"Current",color:d3.select(this).style("fill")})}).on("mousemove",function(){r.elementMousemove({value:v[0],label:y[0]||"Current",color:d3.select(this).style("fill")})}).on("mouseout",function(){r.elementMouseout({value:v[0],label:y[0]||"Current",color:d3.select(this).style("fill")})});var J=s/6,K=u.map(function(a,b){return{value:a,label:x[b]}});F.selectAll("path.nv-markerTriangle").data(K).enter().append("path").attr("class","nv-markerTriangle").attr("transform",function(a){return"translate("+z(a.value)+","+s/2+")"}).attr("d","M0,"+J+"L"+J+","+-J+" "+-J+","+-J+"Z").on("mouseover",function(a){r.elementMouseover({value:a.value,label:a.label||"Previous",color:d3.select(this).style("fill"),pos:[z(a.value),s/2]})}).on("mousemove",function(a){r.elementMousemove({value:a.value,label:a.label||"Previous",color:d3.select(this).style("fill")})}).on("mouseout",function(a){r.elementMouseout({value:a.value,label:a.label||"Previous",color:d3.select(this).style("fill")})}),D.selectAll(".nv-range").on("mouseover",function(a,b){var c=w[b]||(b?1==b?"Mean":"Minimum":"Maximum");r.elementMouseover({value:a,label:c,color:d3.select(this).style("fill")})}).on("mousemove",function(){r.elementMousemove({value:v[0],label:y[0]||"Previous",color:d3.select(this).style("fill")})}).on("mouseout",function(a,b){var c=w[b]||(b?1==b?"Mean":"Minimum":"Maximum");r.elementMouseout({value:a,label:c,color:d3.select(this).style("fill")})})}),b}var c={top:0,right:0,bottom:0,left:0},d="left",e=!1,f=function(a){return a.ranges},g=function(a){return a.markers?a.markers:[0]},h=function(a){return a.measures},i=function(a){return a.rangeLabels?a.rangeLabels:[]},j=function(a){return a.markerLabels?a.markerLabels:[]},k=function(a){return a.measureLabels?a.measureLabels:[]},l=[0],m=380,n=30,o=null,p=null,q=a.utils.getColor(["#1f77b4"]),r=d3.dispatch("elementMouseover","elementMouseout","elementMousemove");return b.dispatch=r,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{ranges:{get:function(){return f},set:function(a){f=a}},markers:{get:function(){return g},set:function(a){g=a}},measures:{get:function(){return h},set:function(a){h=a}},forceX:{get:function(){return l},set:function(a){l=a}},width:{get:function(){return m},set:function(a){m=a}},height:{get:function(){return n},set:function(a){n=a}},tickFormat:{get:function(){return p},set:function(a){p=a}},margin:{get:function(){return c},set:function(a){c.top=void 0!==a.top?a.top:c.top,c.right=void 0!==a.right?a.right:c.right,c.bottom=void 0!==a.bottom?a.bottom:c.bottom,c.left=void 0!==a.left?a.left:c.left}},orient:{get:function(){return d},set:function(a){d=a,e="right"==d||"bottom"==d}},color:{get:function(){return q},set:function(b){q=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.bulletChart=function(){"use strict";function b(d){return d.each(function(e,o){var p=d3.select(this);a.utils.initSVG(p);var q=a.utils.availableWidth(k,p,g),r=l-g.top-g.bottom;if(b.update=function(){b(d)},b.container=this,!e||!h.call(this,e,o))return a.utils.noData(b,p),b;p.selectAll(".nv-noData").remove();var s=h.call(this,e,o).slice().sort(d3.descending),t=i.call(this,e,o).slice().sort(d3.descending),u=j.call(this,e,o).slice().sort(d3.descending),v=p.selectAll("g.nv-wrap.nv-bulletChart").data([e]),w=v.enter().append("g").attr("class","nvd3 nv-wrap nv-bulletChart"),x=w.append("g"),y=v.select("g");x.append("g").attr("class","nv-bulletWrap"),x.append("g").attr("class","nv-titles"),v.attr("transform","translate("+g.left+","+g.top+")");var z=d3.scale.linear().domain([0,Math.max(s[0],t[0],u[0])]).range(f?[q,0]:[0,q]),A=this.__chart__||d3.scale.linear().domain([0,1/0]).range(z.range());this.__chart__=z;var B=x.select(".nv-titles").append("g").attr("text-anchor","end").attr("transform","translate(-6,"+(l-g.top-g.bottom)/2+")");B.append("text").attr("class","nv-title").text(function(a){return a.title}),B.append("text").attr("class","nv-subtitle").attr("dy","1em").text(function(a){return a.subtitle}),c.width(q).height(r);var C=y.select(".nv-bulletWrap");d3.transition(C).call(c);var D=m||z.tickFormat(q/100),E=y.selectAll("g.nv-tick").data(z.ticks(n?n:q/50),function(a){return this.textContent||D(a)}),F=E.enter().append("g").attr("class","nv-tick").attr("transform",function(a){return"translate("+A(a)+",0)"}).style("opacity",1e-6);F.append("line").attr("y1",r).attr("y2",7*r/6),F.append("text").attr("text-anchor","middle").attr("dy","1em").attr("y",7*r/6).text(D);var G=d3.transition(E).attr("transform",function(a){return"translate("+z(a)+",0)"}).style("opacity",1);G.select("line").attr("y1",r).attr("y2",7*r/6),G.select("text").attr("y",7*r/6),d3.transition(E.exit()).attr("transform",function(a){return"translate("+z(a)+",0)"}).style("opacity",1e-6).remove()}),d3.timer.flush(),b}var c=a.models.bullet(),d=a.models.tooltip(),e="left",f=!1,g={top:5,right:40,bottom:20,left:120},h=function(a){return a.ranges},i=function(a){return a.markers?a.markers:[0]},j=function(a){return a.measures},k=null,l=55,m=null,n=null,o=null,p=d3.dispatch("tooltipShow","tooltipHide");return d.duration(0).headerEnabled(!1),c.dispatch.on("elementMouseover.tooltip",function(a){a.series={key:a.label,value:a.value,color:a.color},d.data(a).hidden(!1)}),c.dispatch.on("elementMouseout.tooltip",function(){d.hidden(!0)}),c.dispatch.on("elementMousemove.tooltip",function(){d.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.bullet=c,b.dispatch=p,b.tooltip=d,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{ranges:{get:function(){return h},set:function(a){h=a}},markers:{get:function(){return i},set:function(a){i=a}},measures:{get:function(){return j},set:function(a){j=a}},width:{get:function(){return k},set:function(a){k=a}},height:{get:function(){return l},set:function(a){l=a}},tickFormat:{get:function(){return m},set:function(a){m=a}},ticks:{get:function(){return n},set:function(a){n=a}},noData:{get:function(){return o},set:function(a){o=a}},tooltips:{get:function(){return d.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),d.enabled(!!b)}},tooltipContent:{get:function(){return d.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),d.contentGenerator(b)}},margin:{get:function(){return g},set:function(a){g.top=void 0!==a.top?a.top:g.top,g.right=void 0!==a.right?a.right:g.right,g.bottom=void 0!==a.bottom?a.bottom:g.bottom,g.left=void 0!==a.left?a.left:g.left}},orient:{get:function(){return e},set:function(a){e=a,f="right"==e||"bottom"==e}}}),a.utils.inheritOptions(b,c),a.utils.initOptions(b),b},a.models.candlestickBar=function(){"use strict";function b(x){return x.each(function(b){c=d3.select(this);var x=a.utils.availableWidth(i,c,h),y=a.utils.availableHeight(j,c,h);a.utils.initSVG(c);var A=x/b[0].values.length*.45;l.domain(d||d3.extent(b[0].values.map(n).concat(t))),l.range(v?f||[.5*x/b[0].values.length,x*(b[0].values.length-.5)/b[0].values.length]:f||[5+A/2,x-A/2-5]),m.domain(e||[d3.min(b[0].values.map(s).concat(u)),d3.max(b[0].values.map(r).concat(u))]).range(g||[y,0]),l.domain()[0]===l.domain()[1]&&l.domain(l.domain()[0]?[l.domain()[0]-.01*l.domain()[0],l.domain()[1]+.01*l.domain()[1]]:[-1,1]),m.domain()[0]===m.domain()[1]&&m.domain(m.domain()[0]?[m.domain()[0]+.01*m.domain()[0],m.domain()[1]-.01*m.domain()[1]]:[-1,1]);var B=d3.select(this).selectAll("g.nv-wrap.nv-candlestickBar").data([b[0].values]),C=B.enter().append("g").attr("class","nvd3 nv-wrap nv-candlestickBar"),D=C.append("defs"),E=C.append("g"),F=B.select("g");E.append("g").attr("class","nv-ticks"),B.attr("transform","translate("+h.left+","+h.top+")"),c.on("click",function(a,b){z.chartClick({data:a,index:b,pos:d3.event,id:k})}),D.append("clipPath").attr("id","nv-chart-clip-path-"+k).append("rect"),B.select("#nv-chart-clip-path-"+k+" rect").attr("width",x).attr("height",y),F.attr("clip-path",w?"url(#nv-chart-clip-path-"+k+")":"");var G=B.select(".nv-ticks").selectAll(".nv-tick").data(function(a){return a});G.exit().remove();{var H=G.enter().append("g").attr("class",function(a,b,c){return(p(a,b)>q(a,b)?"nv-tick negative":"nv-tick positive")+" nv-tick-"+c+"-"+b});H.append("line").attr("class","nv-candlestick-lines").attr("transform",function(a,b){return"translate("+l(n(a,b))+",0)"}).attr("x1",0).attr("y1",function(a,b){return m(r(a,b))}).attr("x2",0).attr("y2",function(a,b){return m(s(a,b))}),H.append("rect").attr("class","nv-candlestick-rects nv-bars").attr("transform",function(a,b){return"translate("+(l(n(a,b))-A/2)+","+(m(o(a,b))-(p(a,b)>q(a,b)?m(q(a,b))-m(p(a,b)):0))+")"}).attr("x",0).attr("y",0).attr("width",A).attr("height",function(a,b){var c=p(a,b),d=q(a,b);return c>d?m(d)-m(c):m(c)-m(d)})}c.selectAll(".nv-candlestick-lines").transition().attr("transform",function(a,b){return"translate("+l(n(a,b))+",0)"}).attr("x1",0).attr("y1",function(a,b){return m(r(a,b))}).attr("x2",0).attr("y2",function(a,b){return m(s(a,b))}),c.selectAll(".nv-candlestick-rects").transition().attr("transform",function(a,b){return"translate("+(l(n(a,b))-A/2)+","+(m(o(a,b))-(p(a,b)>q(a,b)?m(q(a,b))-m(p(a,b)):0))+")"}).attr("x",0).attr("y",0).attr("width",A).attr("height",function(a,b){var c=p(a,b),d=q(a,b);return c>d?m(d)-m(c):m(c)-m(d)})}),b}var c,d,e,f,g,h={top:0,right:0,bottom:0,left:0},i=null,j=null,k=Math.floor(1e4*Math.random()),l=d3.scale.linear(),m=d3.scale.linear(),n=function(a){return a.x},o=function(a){return a.y},p=function(a){return a.open},q=function(a){return a.close},r=function(a){return a.high},s=function(a){return a.low},t=[],u=[],v=!1,w=!0,x=a.utils.defaultColor(),y=!1,z=d3.dispatch("tooltipShow","tooltipHide","stateChange","changeState","renderEnd","chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove");return b.highlightPoint=function(a,d){b.clearHighlights(),c.select(".nv-candlestickBar .nv-tick-0-"+a).classed("hover",d)},b.clearHighlights=function(){c.select(".nv-candlestickBar .nv-tick.hover").classed("hover",!1)},b.dispatch=z,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return i},set:function(a){i=a}},height:{get:function(){return j},set:function(a){j=a}},xScale:{get:function(){return l},set:function(a){l=a}},yScale:{get:function(){return m},set:function(a){m=a}},xDomain:{get:function(){return d},set:function(a){d=a}},yDomain:{get:function(){return e},set:function(a){e=a}},xRange:{get:function(){return f},set:function(a){f=a}},yRange:{get:function(){return g},set:function(a){g=a}},forceX:{get:function(){return t},set:function(a){t=a}},forceY:{get:function(){return u},set:function(a){u=a}},padData:{get:function(){return v},set:function(a){v=a}},clipEdge:{get:function(){return w},set:function(a){w=a}},id:{get:function(){return k},set:function(a){k=a}},interactive:{get:function(){return y},set:function(a){y=a}},x:{get:function(){return n},set:function(a){n=a}},y:{get:function(){return o},set:function(a){o=a}},open:{get:function(){return p()},set:function(a){p=a}},close:{get:function(){return q()},set:function(a){q=a}},high:{get:function(){return r},set:function(a){r=a}},low:{get:function(){return s},set:function(a){s=a}},margin:{get:function(){return h},set:function(a){h.top=void 0!=a.top?a.top:h.top,h.right=void 0!=a.right?a.right:h.right,h.bottom=void 0!=a.bottom?a.bottom:h.bottom,h.left=void 0!=a.left?a.left:h.left}},color:{get:function(){return x},set:function(b){x=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.cumulativeLineChart=function(){"use strict";function b(l){return H.reset(),H.models(f),r&&H.models(g),s&&H.models(h),l.each(function(l){function A(){d3.select(b.container).style("cursor","ew-resize")}function E(){G.x=d3.event.x,G.i=Math.round(F.invert(G.x)),K()}function H(){d3.select(b.container).style("cursor","auto"),y.index=G.i,C.stateChange(y)}function K(){bb.data([G]);var a=b.duration();b.duration(0),b.update(),b.duration(a)}var L=d3.select(this);a.utils.initSVG(L),L.classed("nv-chart-"+x,!0);var M=this,N=a.utils.availableWidth(o,L,m),O=a.utils.availableHeight(p,L,m);if(b.update=function(){0===D?L.call(b):L.transition().duration(D).call(b)},b.container=this,y.setter(J(l),b.update).getter(I(l)).update(),y.disabled=l.map(function(a){return!!a.disabled}),!z){var P;z={};for(P in y)z[P]=y[P]instanceof Array?y[P].slice(0):y[P]}var Q=d3.behavior.drag().on("dragstart",A).on("drag",E).on("dragend",H);if(!(l&&l.length&&l.filter(function(a){return a.values.length}).length))return a.utils.noData(b,L),b;if(L.selectAll(".nv-noData").remove(),d=f.xScale(),e=f.yScale(),w)f.yDomain(null);else{var R=l.filter(function(a){return!a.disabled}).map(function(a){var b=d3.extent(a.values,f.y());return b[0]<-.95&&(b[0]=-.95),[(b[0]-b[1])/(1+b[1]),(b[1]-b[0])/(1+b[0])]}),S=[d3.min(R,function(a){return a[0]}),d3.max(R,function(a){return a[1]})];f.yDomain(S)}F.domain([0,l[0].values.length-1]).range([0,N]).clamp(!0);var l=c(G.i,l),T=v?"none":"all",U=L.selectAll("g.nv-wrap.nv-cumulativeLine").data([l]),V=U.enter().append("g").attr("class","nvd3 nv-wrap nv-cumulativeLine").append("g"),W=U.select("g");if(V.append("g").attr("class","nv-interactive"),V.append("g").attr("class","nv-x nv-axis").style("pointer-events","none"),V.append("g").attr("class","nv-y nv-axis"),V.append("g").attr("class","nv-background"),V.append("g").attr("class","nv-linesWrap").style("pointer-events",T),V.append("g").attr("class","nv-avgLinesWrap").style("pointer-events","none"),V.append("g").attr("class","nv-legendWrap"),V.append("g").attr("class","nv-controlsWrap"),q&&(i.width(N),W.select(".nv-legendWrap").datum(l).call(i),m.top!=i.height()&&(m.top=i.height(),O=a.utils.availableHeight(p,L,m)),W.select(".nv-legendWrap").attr("transform","translate(0,"+-m.top+")")),u){var X=[{key:"Re-scale y-axis",disabled:!w}];j.width(140).color(["#444","#444","#444"]).rightAlign(!1).margin({top:5,right:0,bottom:5,left:20}),W.select(".nv-controlsWrap").datum(X).attr("transform","translate(0,"+-m.top+")").call(j)}U.attr("transform","translate("+m.left+","+m.top+")"),t&&W.select(".nv-y.nv-axis").attr("transform","translate("+N+",0)");var Y=l.filter(function(a){return a.tempDisabled});U.select(".tempDisabled").remove(),Y.length&&U.append("text").attr("class","tempDisabled").attr("x",N/2).attr("y","-.71em").style("text-anchor","end").text(Y.map(function(a){return a.key}).join(", ")+" values cannot be calculated for this time period."),v&&(k.width(N).height(O).margin({left:m.left,top:m.top}).svgContainer(L).xScale(d),U.select(".nv-interactive").call(k)),V.select(".nv-background").append("rect"),W.select(".nv-background rect").attr("width",N).attr("height",O),f.y(function(a){return a.display.y}).width(N).height(O).color(l.map(function(a,b){return a.color||n(a,b)}).filter(function(a,b){return!l[b].disabled&&!l[b].tempDisabled}));var Z=W.select(".nv-linesWrap").datum(l.filter(function(a){return!a.disabled&&!a.tempDisabled}));Z.call(f),l.forEach(function(a,b){a.seriesIndex=b});var $=l.filter(function(a){return!a.disabled&&!!B(a)}),_=W.select(".nv-avgLinesWrap").selectAll("line").data($,function(a){return a.key}),ab=function(a){var b=e(B(a));return 0>b?0:b>O?O:b};_.enter().append("line").style("stroke-width",2).style("stroke-dasharray","10,10").style("stroke",function(a){return f.color()(a,a.seriesIndex)}).attr("x1",0).attr("x2",N).attr("y1",ab).attr("y2",ab),_.style("stroke-opacity",function(a){var b=e(B(a));return 0>b||b>O?0:1}).attr("x1",0).attr("x2",N).attr("y1",ab).attr("y2",ab),_.exit().remove();var bb=Z.selectAll(".nv-indexLine").data([G]);bb.enter().append("rect").attr("class","nv-indexLine").attr("width",3).attr("x",-2).attr("fill","red").attr("fill-opacity",.5).style("pointer-events","all").call(Q),bb.attr("transform",function(a){return"translate("+F(a.i)+",0)"}).attr("height",O),r&&(g.scale(d)._ticks(a.utils.calcTicksX(N/70,l)).tickSize(-O,0),W.select(".nv-x.nv-axis").attr("transform","translate(0,"+e.range()[0]+")"),W.select(".nv-x.nv-axis").call(g)),s&&(h.scale(e)._ticks(a.utils.calcTicksY(O/36,l)).tickSize(-N,0),W.select(".nv-y.nv-axis").call(h)),W.select(".nv-background rect").on("click",function(){G.x=d3.mouse(this)[0],G.i=Math.round(F.invert(G.x)),y.index=G.i,C.stateChange(y),K()}),f.dispatch.on("elementClick",function(a){G.i=a.pointIndex,G.x=F(G.i),y.index=G.i,C.stateChange(y),K()}),j.dispatch.on("legendClick",function(a){a.disabled=!a.disabled,w=!a.disabled,y.rescaleY=w,C.stateChange(y),b.update()}),i.dispatch.on("stateChange",function(a){for(var c in a)y[c]=a[c];C.stateChange(y),b.update()}),k.dispatch.on("elementMousemove",function(c){f.clearHighlights();var d,e,i,j=[];if(l.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(g,h){e=a.interactiveBisect(g.values,c.pointXValue,b.x()),f.highlightPoint(h,e,!0);var k=g.values[e];"undefined"!=typeof k&&("undefined"==typeof d&&(d=k),"undefined"==typeof i&&(i=b.xScale()(b.x()(k,e))),j.push({key:g.key,value:b.y()(k,e),color:n(g,g.seriesIndex)}))}),j.length>2){var o=b.yScale().invert(c.mouseY),p=Math.abs(b.yScale().domain()[0]-b.yScale().domain()[1]),q=.03*p,r=a.nearestValueIndex(j.map(function(a){return a.value}),o,q);null!==r&&(j[r].highlight=!0)}var s=g.tickFormat()(b.x()(d,e),e);k.tooltip.position({left:i+m.left,top:c.mouseY+m.top}).chartContainer(M.parentNode).valueFormatter(function(a){return h.tickFormat()(a)}).data({value:s,series:j})(),k.renderGuideLine(i)}),k.dispatch.on("elementMouseout",function(){f.clearHighlights()}),C.on("changeState",function(a){"undefined"!=typeof a.disabled&&(l.forEach(function(b,c){b.disabled=a.disabled[c]}),y.disabled=a.disabled),"undefined"!=typeof a.index&&(G.i=a.index,G.x=F(G.i),y.index=a.index,bb.data([G])),"undefined"!=typeof a.rescaleY&&(w=a.rescaleY),b.update()})}),H.renderEnd("cumulativeLineChart immediate"),b}function c(a,b){return K||(K=f.y()),b.map(function(b){if(!b.values)return b;var c=b.values[a];if(null==c)return b;var d=K(c,a);return-.95>d&&!E?(b.tempDisabled=!0,b):(b.tempDisabled=!1,b.values=b.values.map(function(a,b){return a.display={y:(K(a,b)-d)/(1+d)},a}),b)})}var d,e,f=a.models.line(),g=a.models.axis(),h=a.models.axis(),i=a.models.legend(),j=a.models.legend(),k=a.interactiveGuideline(),l=a.models.tooltip(),m={top:30,right:30,bottom:50,left:60},n=a.utils.defaultColor(),o=null,p=null,q=!0,r=!0,s=!0,t=!1,u=!0,v=!1,w=!0,x=f.id(),y=a.utils.state(),z=null,A=null,B=function(a){return a.average},C=d3.dispatch("stateChange","changeState","renderEnd"),D=250,E=!1;y.index=0,y.rescaleY=w,g.orient("bottom").tickPadding(7),h.orient(t?"right":"left"),l.valueFormatter(function(a,b){return h.tickFormat()(a,b)}).headerFormatter(function(a,b){return g.tickFormat()(a,b)}),j.updateState(!1);var F=d3.scale.linear(),G={i:0,x:0},H=a.utils.renderWatch(C,D),I=function(a){return function(){return{active:a.map(function(a){return!a.disabled}),index:G.i,rescaleY:w}}},J=function(a){return function(b){void 0!==b.index&&(G.i=b.index),void 0!==b.rescaleY&&(w=b.rescaleY),void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};f.dispatch.on("elementMouseover.tooltip",function(a){var c={x:b.x()(a.point),y:b.y()(a.point),color:a.point.color};a.point=c,l.data(a).position(a.pos).hidden(!1)}),f.dispatch.on("elementMouseout.tooltip",function(){l.hidden(!0)});var K=null;return b.dispatch=C,b.lines=f,b.legend=i,b.controls=j,b.xAxis=g,b.yAxis=h,b.interactiveLayer=k,b.state=y,b.tooltip=l,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return o},set:function(a){o=a}},height:{get:function(){return p},set:function(a){p=a}},rescaleY:{get:function(){return w},set:function(a){w=a}},showControls:{get:function(){return u},set:function(a){u=a}},showLegend:{get:function(){return q},set:function(a){q=a}},average:{get:function(){return B},set:function(a){B=a}},defaultState:{get:function(){return z},set:function(a){z=a}},noData:{get:function(){return A},set:function(a){A=a}},showXAxis:{get:function(){return r},set:function(a){r=a}},showYAxis:{get:function(){return s},set:function(a){s=a}},noErrorCheck:{get:function(){return E},set:function(a){E=a}},tooltips:{get:function(){return l.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),l.enabled(!!b)}},tooltipContent:{get:function(){return l.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),l.contentGenerator(b)}},margin:{get:function(){return m},set:function(a){m.top=void 0!==a.top?a.top:m.top,m.right=void 0!==a.right?a.right:m.right,m.bottom=void 0!==a.bottom?a.bottom:m.bottom,m.left=void 0!==a.left?a.left:m.left}},color:{get:function(){return n},set:function(b){n=a.utils.getColor(b),i.color(n)}},useInteractiveGuideline:{get:function(){return v},set:function(a){v=a,a===!0&&(b.interactive(!1),b.useVoronoi(!1))}},rightAlignYAxis:{get:function(){return t},set:function(a){t=a,h.orient(a?"right":"left")}},duration:{get:function(){return D},set:function(a){D=a,f.duration(D),g.duration(D),h.duration(D),H.reset(D)}}}),a.utils.inheritOptions(b,f),a.utils.initOptions(b),b},a.models.discreteBar=function(){"use strict";function b(m){return y.reset(),m.each(function(b){var m=k-j.left-j.right,x=l-j.top-j.bottom;c=d3.select(this),a.utils.initSVG(c),b.forEach(function(a,b){a.values.forEach(function(a){a.series=b})});var z=d&&e?[]:b.map(function(a){return a.values.map(function(a,b){return{x:p(a,b),y:q(a,b),y0:a.y0}})});n.domain(d||d3.merge(z).map(function(a){return a.x})).rangeBands(f||[0,m],.1),o.domain(e||d3.extent(d3.merge(z).map(function(a){return a.y}).concat(r))),o.range(t?g||[x-(o.domain()[0]<0?12:0),o.domain()[1]>0?12:0]:g||[x,0]),h=h||n,i=i||o.copy().range([o(0),o(0)]);{var A=c.selectAll("g.nv-wrap.nv-discretebar").data([b]),B=A.enter().append("g").attr("class","nvd3 nv-wrap nv-discretebar"),C=B.append("g");A.select("g")}C.append("g").attr("class","nv-groups"),A.attr("transform","translate("+j.left+","+j.top+")");var D=A.select(".nv-groups").selectAll(".nv-group").data(function(a){return a},function(a){return a.key});D.enter().append("g").style("stroke-opacity",1e-6).style("fill-opacity",1e-6),D.exit().watchTransition(y,"discreteBar: exit groups").style("stroke-opacity",1e-6).style("fill-opacity",1e-6).remove(),D.attr("class",function(a,b){return"nv-group nv-series-"+b}).classed("hover",function(a){return a.hover}),D.watchTransition(y,"discreteBar: groups").style("stroke-opacity",1).style("fill-opacity",.75);var E=D.selectAll("g.nv-bar").data(function(a){return a.values});E.exit().remove();var F=E.enter().append("g").attr("transform",function(a,b){return"translate("+(n(p(a,b))+.05*n.rangeBand())+", "+o(0)+")"}).on("mouseover",function(a,b){d3.select(this).classed("hover",!0),v.elementMouseover({data:a,index:b,color:d3.select(this).style("fill")})}).on("mouseout",function(a,b){d3.select(this).classed("hover",!1),v.elementMouseout({data:a,index:b,color:d3.select(this).style("fill")})}).on("mousemove",function(a,b){v.elementMousemove({data:a,index:b,color:d3.select(this).style("fill")})}).on("click",function(a,b){v.elementClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()}).on("dblclick",function(a,b){v.elementDblClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()});F.append("rect").attr("height",0).attr("width",.9*n.rangeBand()/b.length),t?(F.append("text").attr("text-anchor","middle"),E.select("text").text(function(a,b){return u(q(a,b))}).watchTransition(y,"discreteBar: bars text").attr("x",.9*n.rangeBand()/2).attr("y",function(a,b){return q(a,b)<0?o(q(a,b))-o(0)+12:-4})):E.selectAll("text").remove(),E.attr("class",function(a,b){return q(a,b)<0?"nv-bar negative":"nv-bar positive"}).style("fill",function(a,b){return a.color||s(a,b)}).style("stroke",function(a,b){return a.color||s(a,b)}).select("rect").attr("class",w).watchTransition(y,"discreteBar: bars rect").attr("width",.9*n.rangeBand()/b.length),E.watchTransition(y,"discreteBar: bars").attr("transform",function(a,b){var c=n(p(a,b))+.05*n.rangeBand(),d=q(a,b)<0?o(0):o(0)-o(q(a,b))<1?o(0)-1:o(q(a,b));return"translate("+c+", "+d+")"}).select("rect").attr("height",function(a,b){return Math.max(Math.abs(o(q(a,b))-o(e&&e[0]||0))||1)}),h=n.copy(),i=o.copy()}),y.renderEnd("discreteBar immediate"),b}var c,d,e,f,g,h,i,j={top:0,right:0,bottom:0,left:0},k=960,l=500,m=Math.floor(1e4*Math.random()),n=d3.scale.ordinal(),o=d3.scale.linear(),p=function(a){return a.x},q=function(a){return a.y},r=[0],s=a.utils.defaultColor(),t=!1,u=d3.format(",.2f"),v=d3.dispatch("chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove","renderEnd"),w="discreteBar",x=250,y=a.utils.renderWatch(v,x);return b.dispatch=v,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return k},set:function(a){k=a}},height:{get:function(){return l},set:function(a){l=a}},forceY:{get:function(){return r},set:function(a){r=a}},showValues:{get:function(){return t},set:function(a){t=a}},x:{get:function(){return p},set:function(a){p=a}},y:{get:function(){return q},set:function(a){q=a}},xScale:{get:function(){return n},set:function(a){n=a}},yScale:{get:function(){return o},set:function(a){o=a}},xDomain:{get:function(){return d},set:function(a){d=a}},yDomain:{get:function(){return e},set:function(a){e=a}},xRange:{get:function(){return f},set:function(a){f=a}},yRange:{get:function(){return g},set:function(a){g=a}},valueFormat:{get:function(){return u},set:function(a){u=a}},id:{get:function(){return m},set:function(a){m=a}},rectClass:{get:function(){return w},set:function(a){w=a}},margin:{get:function(){return j},set:function(a){j.top=void 0!==a.top?a.top:j.top,j.right=void 0!==a.right?a.right:j.right,j.bottom=void 0!==a.bottom?a.bottom:j.bottom,j.left=void 0!==a.left?a.left:j.left}},color:{get:function(){return s},set:function(b){s=a.utils.getColor(b)}},duration:{get:function(){return x},set:function(a){x=a,y.reset(x)}}}),a.utils.initOptions(b),b},a.models.discreteBarChart=function(){"use strict";function b(h){return t.reset(),t.models(e),m&&t.models(f),n&&t.models(g),h.each(function(h){var l=d3.select(this);a.utils.initSVG(l);var q=a.utils.availableWidth(j,l,i),t=a.utils.availableHeight(k,l,i);if(b.update=function(){r.beforeUpdate(),l.transition().duration(s).call(b)},b.container=this,!(h&&h.length&&h.filter(function(a){return a.values.length}).length))return a.utils.noData(b,l),b;l.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale().clamp(!0);var u=l.selectAll("g.nv-wrap.nv-discreteBarWithAxes").data([h]),v=u.enter().append("g").attr("class","nvd3 nv-wrap nv-discreteBarWithAxes").append("g"),w=v.append("defs"),x=u.select("g");v.append("g").attr("class","nv-x nv-axis"),v.append("g").attr("class","nv-y nv-axis").append("g").attr("class","nv-zeroLine").append("line"),v.append("g").attr("class","nv-barsWrap"),x.attr("transform","translate("+i.left+","+i.top+")"),o&&x.select(".nv-y.nv-axis").attr("transform","translate("+q+",0)"),e.width(q).height(t);var y=x.select(".nv-barsWrap").datum(h.filter(function(a){return!a.disabled}));if(y.transition().call(e),w.append("clipPath").attr("id","nv-x-label-clip-"+e.id()).append("rect"),x.select("#nv-x-label-clip-"+e.id()+" rect").attr("width",c.rangeBand()*(p?2:1)).attr("height",16).attr("x",-c.rangeBand()/(p?1:2)),m){f.scale(c)._ticks(a.utils.calcTicksX(q/100,h)).tickSize(-t,0),x.select(".nv-x.nv-axis").attr("transform","translate(0,"+(d.range()[0]+(e.showValues()&&d.domain()[0]<0?16:0))+")"),x.select(".nv-x.nv-axis").call(f);
var z=x.select(".nv-x.nv-axis").selectAll("g");p&&z.selectAll("text").attr("transform",function(a,b,c){return"translate(0,"+(c%2==0?"5":"17")+")"})}n&&(g.scale(d)._ticks(a.utils.calcTicksY(t/36,h)).tickSize(-q,0),x.select(".nv-y.nv-axis").call(g)),x.select(".nv-zeroLine line").attr("x1",0).attr("x2",q).attr("y1",d(0)).attr("y2",d(0))}),t.renderEnd("discreteBar chart immediate"),b}var c,d,e=a.models.discreteBar(),f=a.models.axis(),g=a.models.axis(),h=a.models.tooltip(),i={top:15,right:10,bottom:50,left:60},j=null,k=null,l=a.utils.getColor(),m=!0,n=!0,o=!1,p=!1,q=null,r=d3.dispatch("beforeUpdate","renderEnd"),s=250;f.orient("bottom").showMaxMin(!1).tickFormat(function(a){return a}),g.orient(o?"right":"left").tickFormat(d3.format(",.1f")),h.duration(0).headerEnabled(!1).valueFormatter(function(a,b){return g.tickFormat()(a,b)}).keyFormatter(function(a,b){return f.tickFormat()(a,b)});var t=a.utils.renderWatch(r,s);return e.dispatch.on("elementMouseover.tooltip",function(a){a.series={key:b.x()(a.data),value:b.y()(a.data),color:a.color},h.data(a).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(){h.hidden(!0)}),e.dispatch.on("elementMousemove.tooltip",function(){h.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=r,b.discretebar=e,b.xAxis=f,b.yAxis=g,b.tooltip=h,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return j},set:function(a){j=a}},height:{get:function(){return k},set:function(a){k=a}},staggerLabels:{get:function(){return p},set:function(a){p=a}},showXAxis:{get:function(){return m},set:function(a){m=a}},showYAxis:{get:function(){return n},set:function(a){n=a}},noData:{get:function(){return q},set:function(a){q=a}},tooltips:{get:function(){return h.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),h.enabled(!!b)}},tooltipContent:{get:function(){return h.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),h.contentGenerator(b)}},margin:{get:function(){return i},set:function(a){i.top=void 0!==a.top?a.top:i.top,i.right=void 0!==a.right?a.right:i.right,i.bottom=void 0!==a.bottom?a.bottom:i.bottom,i.left=void 0!==a.left?a.left:i.left}},duration:{get:function(){return s},set:function(a){s=a,t.reset(s),e.duration(s),f.duration(s),g.duration(s)}},color:{get:function(){return l},set:function(b){l=a.utils.getColor(b),e.color(l)}},rightAlignYAxis:{get:function(){return o},set:function(a){o=a,g.orient(a?"right":"left")}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.distribution=function(){"use strict";function b(k){return m.reset(),k.each(function(b){var k=(e-("x"===g?d.left+d.right:d.top+d.bottom),"x"==g?"y":"x"),l=d3.select(this);a.utils.initSVG(l),c=c||j;var n=l.selectAll("g.nv-distribution").data([b]),o=n.enter().append("g").attr("class","nvd3 nv-distribution"),p=(o.append("g"),n.select("g"));n.attr("transform","translate("+d.left+","+d.top+")");var q=p.selectAll("g.nv-dist").data(function(a){return a},function(a){return a.key});q.enter().append("g"),q.attr("class",function(a,b){return"nv-dist nv-series-"+b}).style("stroke",function(a,b){return i(a,b)});var r=q.selectAll("line.nv-dist"+g).data(function(a){return a.values});r.enter().append("line").attr(g+"1",function(a,b){return c(h(a,b))}).attr(g+"2",function(a,b){return c(h(a,b))}),m.transition(q.exit().selectAll("line.nv-dist"+g),"dist exit").attr(g+"1",function(a,b){return j(h(a,b))}).attr(g+"2",function(a,b){return j(h(a,b))}).style("stroke-opacity",0).remove(),r.attr("class",function(a,b){return"nv-dist"+g+" nv-dist"+g+"-"+b}).attr(k+"1",0).attr(k+"2",f),m.transition(r,"dist").attr(g+"1",function(a,b){return j(h(a,b))}).attr(g+"2",function(a,b){return j(h(a,b))}),c=j.copy()}),m.renderEnd("distribution immediate"),b}var c,d={top:0,right:0,bottom:0,left:0},e=400,f=8,g="x",h=function(a){return a[g]},i=a.utils.defaultColor(),j=d3.scale.linear(),k=250,l=d3.dispatch("renderEnd"),m=a.utils.renderWatch(l,k);return b.options=a.utils.optionsFunc.bind(b),b.dispatch=l,b.margin=function(a){return arguments.length?(d.top="undefined"!=typeof a.top?a.top:d.top,d.right="undefined"!=typeof a.right?a.right:d.right,d.bottom="undefined"!=typeof a.bottom?a.bottom:d.bottom,d.left="undefined"!=typeof a.left?a.left:d.left,b):d},b.width=function(a){return arguments.length?(e=a,b):e},b.axis=function(a){return arguments.length?(g=a,b):g},b.size=function(a){return arguments.length?(f=a,b):f},b.getData=function(a){return arguments.length?(h=d3.functor(a),b):h},b.scale=function(a){return arguments.length?(j=a,b):j},b.color=function(c){return arguments.length?(i=a.utils.getColor(c),b):i},b.duration=function(a){return arguments.length?(k=a,m.reset(k),b):k},b},a.models.furiousLegend=function(){"use strict";function b(p){function q(a,b){return"furious"!=o?"#000":m?a.disengaged?g(a,b):"#fff":m?void 0:a.disabled?g(a,b):"#fff"}function r(a,b){return m&&"furious"==o?a.disengaged?"#fff":g(a,b):a.disabled?"#fff":g(a,b)}return p.each(function(b){var p=d-c.left-c.right,s=d3.select(this);a.utils.initSVG(s);var t=s.selectAll("g.nv-legend").data([b]),u=(t.enter().append("g").attr("class","nvd3 nv-legend").append("g"),t.select("g"));t.attr("transform","translate("+c.left+","+c.top+")");var v,w=u.selectAll(".nv-series").data(function(a){return"furious"!=o?a:a.filter(function(a){return m?!0:!a.disengaged})}),x=w.enter().append("g").attr("class","nv-series");if("classic"==o)x.append("circle").style("stroke-width",2).attr("class","nv-legend-symbol").attr("r",5),v=w.select("circle");else if("furious"==o){x.append("rect").style("stroke-width",2).attr("class","nv-legend-symbol").attr("rx",3).attr("ry",3),v=w.select("rect"),x.append("g").attr("class","nv-check-box").property("innerHTML",'<path d="M0.5,5 L22.5,5 L22.5,26.5 L0.5,26.5 L0.5,5 Z" class="nv-box"></path><path d="M5.5,12.8618467 L11.9185089,19.2803556 L31,0.198864511" class="nv-check"></path>').attr("transform","translate(-10,-8)scale(0.5)");var y=w.select(".nv-check-box");y.each(function(a,b){d3.select(this).selectAll("path").attr("stroke",q(a,b))})}x.append("text").attr("text-anchor","start").attr("class","nv-legend-text").attr("dy",".32em").attr("dx","8");var z=w.select("text.nv-legend-text");w.on("mouseover",function(a,b){n.legendMouseover(a,b)}).on("mouseout",function(a,b){n.legendMouseout(a,b)}).on("click",function(a,b){n.legendClick(a,b);var c=w.data();if(k){if("classic"==o)l?(c.forEach(function(a){a.disabled=!0}),a.disabled=!1):(a.disabled=!a.disabled,c.every(function(a){return a.disabled})&&c.forEach(function(a){a.disabled=!1}));else if("furious"==o)if(m)a.disengaged=!a.disengaged,a.userDisabled=void 0==a.userDisabled?!!a.disabled:a.userDisabled,a.disabled=a.disengaged||a.userDisabled;else if(!m){a.disabled=!a.disabled,a.userDisabled=a.disabled;var d=c.filter(function(a){return!a.disengaged});d.every(function(a){return a.userDisabled})&&c.forEach(function(a){a.disabled=a.userDisabled=!1})}n.stateChange({disabled:c.map(function(a){return!!a.disabled}),disengaged:c.map(function(a){return!!a.disengaged})})}}).on("dblclick",function(a,b){if(("furious"!=o||!m)&&(n.legendDblclick(a,b),k)){var c=w.data();c.forEach(function(a){a.disabled=!0,"furious"==o&&(a.userDisabled=a.disabled)}),a.disabled=!1,"furious"==o&&(a.userDisabled=a.disabled),n.stateChange({disabled:c.map(function(a){return!!a.disabled})})}}),w.classed("nv-disabled",function(a){return a.userDisabled}),w.exit().remove(),z.attr("fill",q).text(f);var A;switch(o){case"furious":A=23;break;case"classic":A=20}if(h){var B=[];w.each(function(){var b,c=d3.select(this).select("text");try{if(b=c.node().getComputedTextLength(),0>=b)throw Error()}catch(d){b=a.utils.calcApproxTextWidth(c)}B.push(b+i)});for(var C=0,D=0,E=[];p>D&&C<B.length;)E[C]=B[C],D+=B[C++];for(0===C&&(C=1);D>p&&C>1;){E=[],C--;for(var F=0;F<B.length;F++)B[F]>(E[F%C]||0)&&(E[F%C]=B[F]);D=E.reduce(function(a,b){return a+b})}for(var G=[],H=0,I=0;C>H;H++)G[H]=I,I+=E[H];w.attr("transform",function(a,b){return"translate("+G[b%C]+","+(5+Math.floor(b/C)*A)+")"}),j?u.attr("transform","translate("+(d-c.right-D)+","+c.top+")"):u.attr("transform","translate(0,"+c.top+")"),e=c.top+c.bottom+Math.ceil(B.length/C)*A}else{var J,K=5,L=5,M=0;w.attr("transform",function(){var a=d3.select(this).select("text").node().getComputedTextLength()+i;return J=L,d<c.left+c.right+J+a&&(L=J=5,K+=A),L+=a,L>M&&(M=L),"translate("+J+","+K+")"}),u.attr("transform","translate("+(d-c.right-M)+","+c.top+")"),e=c.top+c.bottom+K+15}"furious"==o&&v.attr("width",function(a,b){return z[0][b].getComputedTextLength()+27}).attr("height",18).attr("y",-9).attr("x",-15),v.style("fill",r).style("stroke",function(a,b){return a.color||g(a,b)})}),b}var c={top:5,right:0,bottom:5,left:0},d=400,e=20,f=function(a){return a.key},g=a.utils.getColor(),h=!0,i=28,j=!0,k=!0,l=!1,m=!1,n=d3.dispatch("legendClick","legendDblclick","legendMouseover","legendMouseout","stateChange"),o="classic";return b.dispatch=n,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return d},set:function(a){d=a}},height:{get:function(){return e},set:function(a){e=a}},key:{get:function(){return f},set:function(a){f=a}},align:{get:function(){return h},set:function(a){h=a}},rightAlign:{get:function(){return j},set:function(a){j=a}},padding:{get:function(){return i},set:function(a){i=a}},updateState:{get:function(){return k},set:function(a){k=a}},radioButtonMode:{get:function(){return l},set:function(a){l=a}},expanded:{get:function(){return m},set:function(a){m=a}},vers:{get:function(){return o},set:function(a){o=a}},margin:{get:function(){return c},set:function(a){c.top=void 0!==a.top?a.top:c.top,c.right=void 0!==a.right?a.right:c.right,c.bottom=void 0!==a.bottom?a.bottom:c.bottom,c.left=void 0!==a.left?a.left:c.left}},color:{get:function(){return g},set:function(b){g=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.historicalBar=function(){"use strict";function b(x){return x.each(function(b){w.reset(),k=d3.select(this);var x=a.utils.availableWidth(h,k,g),y=a.utils.availableHeight(i,k,g);a.utils.initSVG(k),l.domain(c||d3.extent(b[0].values.map(n).concat(p))),l.range(r?e||[.5*x/b[0].values.length,x*(b[0].values.length-.5)/b[0].values.length]:e||[0,x]),m.domain(d||d3.extent(b[0].values.map(o).concat(q))).range(f||[y,0]),l.domain()[0]===l.domain()[1]&&l.domain(l.domain()[0]?[l.domain()[0]-.01*l.domain()[0],l.domain()[1]+.01*l.domain()[1]]:[-1,1]),m.domain()[0]===m.domain()[1]&&m.domain(m.domain()[0]?[m.domain()[0]+.01*m.domain()[0],m.domain()[1]-.01*m.domain()[1]]:[-1,1]);var z=k.selectAll("g.nv-wrap.nv-historicalBar-"+j).data([b[0].values]),A=z.enter().append("g").attr("class","nvd3 nv-wrap nv-historicalBar-"+j),B=A.append("defs"),C=A.append("g"),D=z.select("g");C.append("g").attr("class","nv-bars"),z.attr("transform","translate("+g.left+","+g.top+")"),k.on("click",function(a,b){u.chartClick({data:a,index:b,pos:d3.event,id:j})}),B.append("clipPath").attr("id","nv-chart-clip-path-"+j).append("rect"),z.select("#nv-chart-clip-path-"+j+" rect").attr("width",x).attr("height",y),D.attr("clip-path",s?"url(#nv-chart-clip-path-"+j+")":"");var E=z.select(".nv-bars").selectAll(".nv-bar").data(function(a){return a},function(a,b){return n(a,b)});E.exit().remove(),E.enter().append("rect").attr("x",0).attr("y",function(b,c){return a.utils.NaNtoZero(m(Math.max(0,o(b,c))))}).attr("height",function(b,c){return a.utils.NaNtoZero(Math.abs(m(o(b,c))-m(0)))}).attr("transform",function(a,c){return"translate("+(l(n(a,c))-x/b[0].values.length*.45)+",0)"}).on("mouseover",function(a,b){v&&(d3.select(this).classed("hover",!0),u.elementMouseover({data:a,index:b,color:d3.select(this).style("fill")}))}).on("mouseout",function(a,b){v&&(d3.select(this).classed("hover",!1),u.elementMouseout({data:a,index:b,color:d3.select(this).style("fill")}))}).on("mousemove",function(a,b){v&&u.elementMousemove({data:a,index:b,color:d3.select(this).style("fill")})}).on("click",function(a,b){v&&(u.elementClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation())}).on("dblclick",function(a,b){v&&(u.elementDblClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation())}),E.attr("fill",function(a,b){return t(a,b)}).attr("class",function(a,b,c){return(o(a,b)<0?"nv-bar negative":"nv-bar positive")+" nv-bar-"+c+"-"+b}).watchTransition(w,"bars").attr("transform",function(a,c){return"translate("+(l(n(a,c))-x/b[0].values.length*.45)+",0)"}).attr("width",x/b[0].values.length*.9),E.watchTransition(w,"bars").attr("y",function(b,c){var d=o(b,c)<0?m(0):m(0)-m(o(b,c))<1?m(0)-1:m(o(b,c));return a.utils.NaNtoZero(d)}).attr("height",function(b,c){return a.utils.NaNtoZero(Math.max(Math.abs(m(o(b,c))-m(0)),1))})}),w.renderEnd("historicalBar immediate"),b}var c,d,e,f,g={top:0,right:0,bottom:0,left:0},h=null,i=null,j=Math.floor(1e4*Math.random()),k=null,l=d3.scale.linear(),m=d3.scale.linear(),n=function(a){return a.x},o=function(a){return a.y},p=[],q=[0],r=!1,s=!0,t=a.utils.defaultColor(),u=d3.dispatch("chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove","renderEnd"),v=!0,w=a.utils.renderWatch(u,0);return b.highlightPoint=function(a,b){k.select(".nv-bars .nv-bar-0-"+a).classed("hover",b)},b.clearHighlights=function(){k.select(".nv-bars .nv-bar.hover").classed("hover",!1)},b.dispatch=u,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return h},set:function(a){h=a}},height:{get:function(){return i},set:function(a){i=a}},forceX:{get:function(){return p},set:function(a){p=a}},forceY:{get:function(){return q},set:function(a){q=a}},padData:{get:function(){return r},set:function(a){r=a}},x:{get:function(){return n},set:function(a){n=a}},y:{get:function(){return o},set:function(a){o=a}},xScale:{get:function(){return l},set:function(a){l=a}},yScale:{get:function(){return m},set:function(a){m=a}},xDomain:{get:function(){return c},set:function(a){c=a}},yDomain:{get:function(){return d},set:function(a){d=a}},xRange:{get:function(){return e},set:function(a){e=a}},yRange:{get:function(){return f},set:function(a){f=a}},clipEdge:{get:function(){return s},set:function(a){s=a}},id:{get:function(){return j},set:function(a){j=a}},interactive:{get:function(){return v},set:function(a){v=a}},margin:{get:function(){return g},set:function(a){g.top=void 0!==a.top?a.top:g.top,g.right=void 0!==a.right?a.right:g.right,g.bottom=void 0!==a.bottom?a.bottom:g.bottom,g.left=void 0!==a.left?a.left:g.left}},color:{get:function(){return t},set:function(b){t=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.historicalBarChart=function(b){"use strict";function c(b){return b.each(function(k){z.reset(),z.models(f),q&&z.models(g),r&&z.models(h);var w=d3.select(this),A=this;a.utils.initSVG(w);var B=a.utils.availableWidth(n,w,l),C=a.utils.availableHeight(o,w,l);if(c.update=function(){w.transition().duration(y).call(c)},c.container=this,u.disabled=k.map(function(a){return!!a.disabled}),!v){var D;v={};for(D in u)v[D]=u[D]instanceof Array?u[D].slice(0):u[D]}if(!(k&&k.length&&k.filter(function(a){return a.values.length}).length))return a.utils.noData(c,w),c;w.selectAll(".nv-noData").remove(),d=f.xScale(),e=f.yScale();var E=w.selectAll("g.nv-wrap.nv-historicalBarChart").data([k]),F=E.enter().append("g").attr("class","nvd3 nv-wrap nv-historicalBarChart").append("g"),G=E.select("g");F.append("g").attr("class","nv-x nv-axis"),F.append("g").attr("class","nv-y nv-axis"),F.append("g").attr("class","nv-barsWrap"),F.append("g").attr("class","nv-legendWrap"),F.append("g").attr("class","nv-interactive"),p&&(i.width(B),G.select(".nv-legendWrap").datum(k).call(i),l.top!=i.height()&&(l.top=i.height(),C=a.utils.availableHeight(o,w,l)),E.select(".nv-legendWrap").attr("transform","translate(0,"+-l.top+")")),E.attr("transform","translate("+l.left+","+l.top+")"),s&&G.select(".nv-y.nv-axis").attr("transform","translate("+B+",0)"),t&&(j.width(B).height(C).margin({left:l.left,top:l.top}).svgContainer(w).xScale(d),E.select(".nv-interactive").call(j)),f.width(B).height(C).color(k.map(function(a,b){return a.color||m(a,b)}).filter(function(a,b){return!k[b].disabled}));var H=G.select(".nv-barsWrap").datum(k.filter(function(a){return!a.disabled}));H.transition().call(f),q&&(g.scale(d)._ticks(a.utils.calcTicksX(B/100,k)).tickSize(-C,0),G.select(".nv-x.nv-axis").attr("transform","translate(0,"+e.range()[0]+")"),G.select(".nv-x.nv-axis").transition().call(g)),r&&(h.scale(e)._ticks(a.utils.calcTicksY(C/36,k)).tickSize(-B,0),G.select(".nv-y.nv-axis").transition().call(h)),j.dispatch.on("elementMousemove",function(b){f.clearHighlights();var d,e,i,n=[];k.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(g){e=a.interactiveBisect(g.values,b.pointXValue,c.x()),f.highlightPoint(e,!0);var h=g.values[e];void 0!==h&&(void 0===d&&(d=h),void 0===i&&(i=c.xScale()(c.x()(h,e))),n.push({key:g.key,value:c.y()(h,e),color:m(g,g.seriesIndex),data:g.values[e]}))});var o=g.tickFormat()(c.x()(d,e));j.tooltip.position({left:i+l.left,top:b.mouseY+l.top}).chartContainer(A.parentNode).valueFormatter(function(a){return h.tickFormat()(a)}).data({value:o,index:e,series:n})(),j.renderGuideLine(i)}),j.dispatch.on("elementMouseout",function(){x.tooltipHide(),f.clearHighlights()}),i.dispatch.on("legendClick",function(a){a.disabled=!a.disabled,k.filter(function(a){return!a.disabled}).length||k.map(function(a){return a.disabled=!1,E.selectAll(".nv-series").classed("disabled",!1),a}),u.disabled=k.map(function(a){return!!a.disabled}),x.stateChange(u),b.transition().call(c)}),i.dispatch.on("legendDblclick",function(a){k.forEach(function(a){a.disabled=!0}),a.disabled=!1,u.disabled=k.map(function(a){return!!a.disabled}),x.stateChange(u),c.update()}),x.on("changeState",function(a){"undefined"!=typeof a.disabled&&(k.forEach(function(b,c){b.disabled=a.disabled[c]}),u.disabled=a.disabled),c.update()})}),z.renderEnd("historicalBarChart immediate"),c}var d,e,f=b||a.models.historicalBar(),g=a.models.axis(),h=a.models.axis(),i=a.models.legend(),j=a.interactiveGuideline(),k=a.models.tooltip(),l={top:30,right:90,bottom:50,left:90},m=a.utils.defaultColor(),n=null,o=null,p=!1,q=!0,r=!0,s=!1,t=!1,u={},v=null,w=null,x=d3.dispatch("tooltipHide","stateChange","changeState","renderEnd"),y=250;g.orient("bottom").tickPadding(7),h.orient(s?"right":"left"),k.duration(0).headerEnabled(!1).valueFormatter(function(a,b){return h.tickFormat()(a,b)}).headerFormatter(function(a,b){return g.tickFormat()(a,b)});var z=a.utils.renderWatch(x,0);return f.dispatch.on("elementMouseover.tooltip",function(a){a.series={key:c.x()(a.data),value:c.y()(a.data),color:a.color},k.data(a).hidden(!1)}),f.dispatch.on("elementMouseout.tooltip",function(){k.hidden(!0)}),f.dispatch.on("elementMousemove.tooltip",function(){k.position({top:d3.event.pageY,left:d3.event.pageX})()}),c.dispatch=x,c.bars=f,c.legend=i,c.xAxis=g,c.yAxis=h,c.interactiveLayer=j,c.tooltip=k,c.options=a.utils.optionsFunc.bind(c),c._options=Object.create({},{width:{get:function(){return n},set:function(a){n=a}},height:{get:function(){return o},set:function(a){o=a}},showLegend:{get:function(){return p},set:function(a){p=a}},showXAxis:{get:function(){return q},set:function(a){q=a}},showYAxis:{get:function(){return r},set:function(a){r=a}},defaultState:{get:function(){return v},set:function(a){v=a}},noData:{get:function(){return w},set:function(a){w=a}},tooltips:{get:function(){return k.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),k.enabled(!!b)}},tooltipContent:{get:function(){return k.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),k.contentGenerator(b)}},margin:{get:function(){return l},set:function(a){l.top=void 0!==a.top?a.top:l.top,l.right=void 0!==a.right?a.right:l.right,l.bottom=void 0!==a.bottom?a.bottom:l.bottom,l.left=void 0!==a.left?a.left:l.left}},color:{get:function(){return m},set:function(b){m=a.utils.getColor(b),i.color(m),f.color(m)}},duration:{get:function(){return y},set:function(a){y=a,z.reset(y),h.duration(y),g.duration(y)}},rightAlignYAxis:{get:function(){return s},set:function(a){s=a,h.orient(a?"right":"left")}},useInteractiveGuideline:{get:function(){return t},set:function(a){t=a,a===!0&&c.interactive(!1)}}}),a.utils.inheritOptions(c,f),a.utils.initOptions(c),c},a.models.ohlcBarChart=function(){var b=a.models.historicalBarChart(a.models.ohlcBar());return b.useInteractiveGuideline(!0),b.interactiveLayer.tooltip.contentGenerator(function(a){var c=a.series[0].data,d=c.open<c.close?"2ca02c":"d62728";return'<h3 style="color: #'+d+'">'+a.value+"</h3><table><tr><td>open:</td><td>"+b.yAxis.tickFormat()(c.open)+"</td></tr><tr><td>close:</td><td>"+b.yAxis.tickFormat()(c.close)+"</td></tr><tr><td>high</td><td>"+b.yAxis.tickFormat()(c.high)+"</td></tr><tr><td>low:</td><td>"+b.yAxis.tickFormat()(c.low)+"</td></tr></table>"}),b},a.models.candlestickBarChart=function(){var b=a.models.historicalBarChart(a.models.candlestickBar());return b.useInteractiveGuideline(!0),b.interactiveLayer.tooltip.contentGenerator(function(a){var c=a.series[0].data,d=c.open<c.close?"2ca02c":"d62728";return'<h3 style="color: #'+d+'">'+a.value+"</h3><table><tr><td>open:</td><td>"+b.yAxis.tickFormat()(c.open)+"</td></tr><tr><td>close:</td><td>"+b.yAxis.tickFormat()(c.close)+"</td></tr><tr><td>high</td><td>"+b.yAxis.tickFormat()(c.high)+"</td></tr><tr><td>low:</td><td>"+b.yAxis.tickFormat()(c.low)+"</td></tr></table>"}),b},a.models.legend=function(){"use strict";function b(p){function q(a,b){return"furious"!=o?"#000":m?a.disengaged?"#000":"#fff":m?void 0:(a.color||(a.color=g(a,b)),a.disabled?a.color:"#fff")}function r(a,b){return m&&"furious"==o&&a.disengaged?"#eee":a.color||g(a,b)}function s(a){return m&&"furious"==o?1:a.disabled?0:1}return p.each(function(b){var g=d-c.left-c.right,p=d3.select(this);a.utils.initSVG(p);var t=p.selectAll("g.nv-legend").data([b]),u=t.enter().append("g").attr("class","nvd3 nv-legend").append("g"),v=t.select("g");t.attr("transform","translate("+c.left+","+c.top+")");var w,x,y=v.selectAll(".nv-series").data(function(a){return"furious"!=o?a:a.filter(function(a){return m?!0:!a.disengaged})}),z=y.enter().append("g").attr("class","nv-series");switch(o){case"furious":x=23;break;case"classic":x=20}if("classic"==o)z.append("circle").style("stroke-width",2).attr("class","nv-legend-symbol").attr("r",5),w=y.select("circle");else if("furious"==o){z.append("rect").style("stroke-width",2).attr("class","nv-legend-symbol").attr("rx",3).attr("ry",3),w=y.select(".nv-legend-symbol"),z.append("g").attr("class","nv-check-box").property("innerHTML",'<path d="M0.5,5 L22.5,5 L22.5,26.5 L0.5,26.5 L0.5,5 Z" class="nv-box"></path><path d="M5.5,12.8618467 L11.9185089,19.2803556 L31,0.198864511" class="nv-check"></path>').attr("transform","translate(-10,-8)scale(0.5)");var A=y.select(".nv-check-box");A.each(function(a,b){d3.select(this).selectAll("path").attr("stroke",q(a,b))})}z.append("text").attr("text-anchor","start").attr("class","nv-legend-text").attr("dy",".32em").attr("dx","8");var B=y.select("text.nv-legend-text");y.on("mouseover",function(a,b){n.legendMouseover(a,b)}).on("mouseout",function(a,b){n.legendMouseout(a,b)}).on("click",function(a,b){n.legendClick(a,b);var c=y.data();if(k){if("classic"==o)l?(c.forEach(function(a){a.disabled=!0}),a.disabled=!1):(a.disabled=!a.disabled,c.every(function(a){return a.disabled})&&c.forEach(function(a){a.disabled=!1}));else if("furious"==o)if(m)a.disengaged=!a.disengaged,a.userDisabled=void 0==a.userDisabled?!!a.disabled:a.userDisabled,a.disabled=a.disengaged||a.userDisabled;else if(!m){a.disabled=!a.disabled,a.userDisabled=a.disabled;var d=c.filter(function(a){return!a.disengaged});d.every(function(a){return a.userDisabled})&&c.forEach(function(a){a.disabled=a.userDisabled=!1})}n.stateChange({disabled:c.map(function(a){return!!a.disabled}),disengaged:c.map(function(a){return!!a.disengaged})})}}).on("dblclick",function(a,b){if(("furious"!=o||!m)&&(n.legendDblclick(a,b),k)){var c=y.data();c.forEach(function(a){a.disabled=!0,"furious"==o&&(a.userDisabled=a.disabled)}),a.disabled=!1,"furious"==o&&(a.userDisabled=a.disabled),n.stateChange({disabled:c.map(function(a){return!!a.disabled})})}}),y.classed("nv-disabled",function(a){return a.userDisabled}),y.exit().remove(),B.attr("fill",q).text(f);var C=0;if(h){var D=[];y.each(function(){var b,c=d3.select(this).select("text");try{if(b=c.node().getComputedTextLength(),0>=b)throw Error()}catch(d){b=a.utils.calcApproxTextWidth(c)}D.push(b+i)});var E=0,F=[];for(C=0;g>C&&E<D.length;)F[E]=D[E],C+=D[E++];for(0===E&&(E=1);C>g&&E>1;){F=[],E--;for(var G=0;G<D.length;G++)D[G]>(F[G%E]||0)&&(F[G%E]=D[G]);C=F.reduce(function(a,b){return a+b})}for(var H=[],I=0,J=0;E>I;I++)H[I]=J,J+=F[I];y.attr("transform",function(a,b){return"translate("+H[b%E]+","+(5+Math.floor(b/E)*x)+")"}),j?v.attr("transform","translate("+(d-c.right-C)+","+c.top+")"):v.attr("transform","translate(0,"+c.top+")"),e=c.top+c.bottom+Math.ceil(D.length/E)*x}else{var K,L=5,M=5,N=0;y.attr("transform",function(){var a=d3.select(this).select("text").node().getComputedTextLength()+i;return K=M,d<c.left+c.right+K+a&&(M=K=5,L+=x),M+=a,M>N&&(N=M),K+N>C&&(C=K+N),"translate("+K+","+L+")"}),v.attr("transform","translate("+(d-c.right-N)+","+c.top+")"),e=c.top+c.bottom+L+15}if("furious"==o){w.attr("width",function(a,b){return B[0][b].getComputedTextLength()+27}).attr("height",18).attr("y",-9).attr("x",-15),u.insert("rect",":first-child").attr("class","nv-legend-bg").attr("fill","#eee").attr("opacity",0);var O=v.select(".nv-legend-bg");O.transition().duration(300).attr("x",-x).attr("width",C+x-12).attr("height",e+10).attr("y",-c.top-10).attr("opacity",m?1:0)}w.style("fill",r).style("fill-opacity",s).style("stroke",r)}),b}var c={top:5,right:0,bottom:5,left:0},d=400,e=20,f=function(a){return a.key},g=a.utils.getColor(),h=!0,i=32,j=!0,k=!0,l=!1,m=!1,n=d3.dispatch("legendClick","legendDblclick","legendMouseover","legendMouseout","stateChange"),o="classic";return b.dispatch=n,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return d},set:function(a){d=a}},height:{get:function(){return e},set:function(a){e=a}},key:{get:function(){return f},set:function(a){f=a}},align:{get:function(){return h},set:function(a){h=a}},rightAlign:{get:function(){return j},set:function(a){j=a}},padding:{get:function(){return i},set:function(a){i=a}},updateState:{get:function(){return k},set:function(a){k=a}},radioButtonMode:{get:function(){return l},set:function(a){l=a}},expanded:{get:function(){return m},set:function(a){m=a}},vers:{get:function(){return o},set:function(a){o=a}},margin:{get:function(){return c},set:function(a){c.top=void 0!==a.top?a.top:c.top,c.right=void 0!==a.right?a.right:c.right,c.bottom=void 0!==a.bottom?a.bottom:c.bottom,c.left=void 0!==a.left?a.left:c.left}},color:{get:function(){return g},set:function(b){g=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.line=function(){"use strict";function b(r){return v.reset(),v.models(e),r.each(function(b){i=d3.select(this);var r=a.utils.availableWidth(g,i,f),s=a.utils.availableHeight(h,i,f);a.utils.initSVG(i),c=e.xScale(),d=e.yScale(),t=t||c,u=u||d;var w=i.selectAll("g.nv-wrap.nv-line").data([b]),x=w.enter().append("g").attr("class","nvd3 nv-wrap nv-line"),y=x.append("defs"),z=x.append("g"),A=w.select("g");z.append("g").attr("class","nv-groups"),z.append("g").attr("class","nv-scatterWrap"),w.attr("transform","translate("+f.left+","+f.top+")"),e.width(r).height(s);var B=w.select(".nv-scatterWrap");B.call(e),y.append("clipPath").attr("id","nv-edge-clip-"+e.id()).append("rect"),w.select("#nv-edge-clip-"+e.id()+" rect").attr("width",r).attr("height",s>0?s:0),A.attr("clip-path",p?"url(#nv-edge-clip-"+e.id()+")":""),B.attr("clip-path",p?"url(#nv-edge-clip-"+e.id()+")":"");var C=w.select(".nv-groups").selectAll(".nv-group").data(function(a){return a},function(a){return a.key});C.enter().append("g").style("stroke-opacity",1e-6).style("stroke-width",function(a){return a.strokeWidth||j}).style("fill-opacity",1e-6),C.exit().remove(),C.attr("class",function(a,b){return(a.classed||"")+" nv-group nv-series-"+b}).classed("hover",function(a){return a.hover}).style("fill",function(a,b){return k(a,b)}).style("stroke",function(a,b){return k(a,b)}),C.watchTransition(v,"line: groups").style("stroke-opacity",1).style("fill-opacity",function(a){return a.fillOpacity||.5});var D=C.selectAll("path.nv-area").data(function(a){return o(a)?[a]:[]});D.enter().append("path").attr("class","nv-area").attr("d",function(b){return d3.svg.area().interpolate(q).defined(n).x(function(b,c){return a.utils.NaNtoZero(t(l(b,c)))}).y0(function(b,c){return a.utils.NaNtoZero(u(m(b,c)))}).y1(function(){return u(d.domain()[0]<=0?d.domain()[1]>=0?0:d.domain()[1]:d.domain()[0])}).apply(this,[b.values])}),C.exit().selectAll("path.nv-area").remove(),D.watchTransition(v,"line: areaPaths").attr("d",function(b){return d3.svg.area().interpolate(q).defined(n).x(function(b,d){return a.utils.NaNtoZero(c(l(b,d)))}).y0(function(b,c){return a.utils.NaNtoZero(d(m(b,c)))}).y1(function(){return d(d.domain()[0]<=0?d.domain()[1]>=0?0:d.domain()[1]:d.domain()[0])}).apply(this,[b.values])});var E=C.selectAll("path.nv-line").data(function(a){return[a.values]});E.enter().append("path").attr("class","nv-line").attr("d",d3.svg.line().interpolate(q).defined(n).x(function(b,c){return a.utils.NaNtoZero(t(l(b,c)))}).y(function(b,c){return a.utils.NaNtoZero(u(m(b,c)))})),E.watchTransition(v,"line: linePaths").attr("d",d3.svg.line().interpolate(q).defined(n).x(function(b,d){return a.utils.NaNtoZero(c(l(b,d)))}).y(function(b,c){return a.utils.NaNtoZero(d(m(b,c)))})),t=c.copy(),u=d.copy()}),v.renderEnd("line immediate"),b}var c,d,e=a.models.scatter(),f={top:0,right:0,bottom:0,left:0},g=960,h=500,i=null,j=1.5,k=a.utils.defaultColor(),l=function(a){return a.x},m=function(a){return a.y},n=function(a,b){return!isNaN(m(a,b))&&null!==m(a,b)},o=function(a){return a.area},p=!1,q="linear",r=250,s=d3.dispatch("elementClick","elementMouseover","elementMouseout","renderEnd");e.pointSize(16).pointDomain([16,256]);var t,u,v=a.utils.renderWatch(s,r);return b.dispatch=s,b.scatter=e,e.dispatch.on("elementClick",function(){s.elementClick.apply(this,arguments)}),e.dispatch.on("elementMouseover",function(){s.elementMouseover.apply(this,arguments)}),e.dispatch.on("elementMouseout",function(){s.elementMouseout.apply(this,arguments)}),b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return g},set:function(a){g=a}},height:{get:function(){return h},set:function(a){h=a}},defined:{get:function(){return n},set:function(a){n=a}},interpolate:{get:function(){return q},set:function(a){q=a}},clipEdge:{get:function(){return p},set:function(a){p=a}},margin:{get:function(){return f},set:function(a){f.top=void 0!==a.top?a.top:f.top,f.right=void 0!==a.right?a.right:f.right,f.bottom=void 0!==a.bottom?a.bottom:f.bottom,f.left=void 0!==a.left?a.left:f.left}},duration:{get:function(){return r},set:function(a){r=a,v.reset(r),e.duration(r)}},isArea:{get:function(){return o},set:function(a){o=d3.functor(a)}},x:{get:function(){return l},set:function(a){l=a,e.x(a)}},y:{get:function(){return m},set:function(a){m=a,e.y(a)}},color:{get:function(){return k},set:function(b){k=a.utils.getColor(b),e.color(k)}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.lineChart=function(){"use strict";function b(j){return y.reset(),y.models(e),p&&y.models(f),q&&y.models(g),j.each(function(j){var v=d3.select(this),y=this;a.utils.initSVG(v);var B=a.utils.availableWidth(m,v,k),C=a.utils.availableHeight(n,v,k);if(b.update=function(){0===x?v.call(b):v.transition().duration(x).call(b)},b.container=this,t.setter(A(j),b.update).getter(z(j)).update(),t.disabled=j.map(function(a){return!!a.disabled}),!u){var D;u={};for(D in t)u[D]=t[D]instanceof Array?t[D].slice(0):t[D]
}if(!(j&&j.length&&j.filter(function(a){return a.values.length}).length))return a.utils.noData(b,v),b;v.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale();var E=v.selectAll("g.nv-wrap.nv-lineChart").data([j]),F=E.enter().append("g").attr("class","nvd3 nv-wrap nv-lineChart").append("g"),G=E.select("g");F.append("rect").style("opacity",0),F.append("g").attr("class","nv-x nv-axis"),F.append("g").attr("class","nv-y nv-axis"),F.append("g").attr("class","nv-linesWrap"),F.append("g").attr("class","nv-legendWrap"),F.append("g").attr("class","nv-interactive"),G.select("rect").attr("width",B).attr("height",C>0?C:0),o&&(h.width(B),G.select(".nv-legendWrap").datum(j).call(h),k.top!=h.height()&&(k.top=h.height(),C=a.utils.availableHeight(n,v,k)),E.select(".nv-legendWrap").attr("transform","translate(0,"+-k.top+")")),E.attr("transform","translate("+k.left+","+k.top+")"),r&&G.select(".nv-y.nv-axis").attr("transform","translate("+B+",0)"),s&&(i.width(B).height(C).margin({left:k.left,top:k.top}).svgContainer(v).xScale(c),E.select(".nv-interactive").call(i)),e.width(B).height(C).color(j.map(function(a,b){return a.color||l(a,b)}).filter(function(a,b){return!j[b].disabled}));var H=G.select(".nv-linesWrap").datum(j.filter(function(a){return!a.disabled}));H.call(e),p&&(f.scale(c)._ticks(a.utils.calcTicksX(B/100,j)).tickSize(-C,0),G.select(".nv-x.nv-axis").attr("transform","translate(0,"+d.range()[0]+")"),G.select(".nv-x.nv-axis").call(f)),q&&(g.scale(d)._ticks(a.utils.calcTicksY(C/36,j)).tickSize(-B,0),G.select(".nv-y.nv-axis").call(g)),h.dispatch.on("stateChange",function(a){for(var c in a)t[c]=a[c];w.stateChange(t),b.update()}),i.dispatch.on("elementMousemove",function(c){e.clearHighlights();var d,h,m,n=[];if(j.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(f,g){h=a.interactiveBisect(f.values,c.pointXValue,b.x());var i=f.values[h],j=b.y()(i,h);null!=j&&e.highlightPoint(g,h,!0),void 0!==i&&(void 0===d&&(d=i),void 0===m&&(m=b.xScale()(b.x()(i,h))),n.push({key:f.key,value:j,color:l(f,f.seriesIndex)}))}),n.length>2){var o=b.yScale().invert(c.mouseY),p=Math.abs(b.yScale().domain()[0]-b.yScale().domain()[1]),q=.03*p,r=a.nearestValueIndex(n.map(function(a){return a.value}),o,q);null!==r&&(n[r].highlight=!0)}var s=f.tickFormat()(b.x()(d,h));i.tooltip.position({left:c.mouseX+k.left,top:c.mouseY+k.top}).chartContainer(y.parentNode).valueFormatter(function(a){return null==a?"N/A":g.tickFormat()(a)}).data({value:s,index:h,series:n})(),i.renderGuideLine(m)}),i.dispatch.on("elementClick",function(c){var d,f=[];j.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(e){var g=a.interactiveBisect(e.values,c.pointXValue,b.x()),h=e.values[g];if("undefined"!=typeof h){"undefined"==typeof d&&(d=b.xScale()(b.x()(h,g)));var i=b.yScale()(b.y()(h,g));f.push({point:h,pointIndex:g,pos:[d,i],seriesIndex:e.seriesIndex,series:e})}}),e.dispatch.elementClick(f)}),i.dispatch.on("elementMouseout",function(){e.clearHighlights()}),w.on("changeState",function(a){"undefined"!=typeof a.disabled&&j.length===a.disabled.length&&(j.forEach(function(b,c){b.disabled=a.disabled[c]}),t.disabled=a.disabled),b.update()})}),y.renderEnd("lineChart immediate"),b}var c,d,e=a.models.line(),f=a.models.axis(),g=a.models.axis(),h=a.models.legend(),i=a.interactiveGuideline(),j=a.models.tooltip(),k={top:30,right:20,bottom:50,left:60},l=a.utils.defaultColor(),m=null,n=null,o=!0,p=!0,q=!0,r=!1,s=!1,t=a.utils.state(),u=null,v=null,w=d3.dispatch("tooltipShow","tooltipHide","stateChange","changeState","renderEnd"),x=250;f.orient("bottom").tickPadding(7),g.orient(r?"right":"left"),j.valueFormatter(function(a,b){return g.tickFormat()(a,b)}).headerFormatter(function(a,b){return f.tickFormat()(a,b)});var y=a.utils.renderWatch(w,x),z=function(a){return function(){return{active:a.map(function(a){return!a.disabled})}}},A=function(a){return function(b){void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return e.dispatch.on("elementMouseover.tooltip",function(a){j.data(a).position(a.pos).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(){j.hidden(!0)}),b.dispatch=w,b.lines=e,b.legend=h,b.xAxis=f,b.yAxis=g,b.interactiveLayer=i,b.tooltip=j,b.dispatch=w,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return m},set:function(a){m=a}},height:{get:function(){return n},set:function(a){n=a}},showLegend:{get:function(){return o},set:function(a){o=a}},showXAxis:{get:function(){return p},set:function(a){p=a}},showYAxis:{get:function(){return q},set:function(a){q=a}},defaultState:{get:function(){return u},set:function(a){u=a}},noData:{get:function(){return v},set:function(a){v=a}},tooltips:{get:function(){return j.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),j.enabled(!!b)}},tooltipContent:{get:function(){return j.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),j.contentGenerator(b)}},margin:{get:function(){return k},set:function(a){k.top=void 0!==a.top?a.top:k.top,k.right=void 0!==a.right?a.right:k.right,k.bottom=void 0!==a.bottom?a.bottom:k.bottom,k.left=void 0!==a.left?a.left:k.left}},duration:{get:function(){return x},set:function(a){x=a,y.reset(x),e.duration(x),f.duration(x),g.duration(x)}},color:{get:function(){return l},set:function(b){l=a.utils.getColor(b),h.color(l),e.color(l)}},rightAlignYAxis:{get:function(){return r},set:function(a){r=a,g.orient(r?"right":"left")}},useInteractiveGuideline:{get:function(){return s},set:function(a){s=a,s&&(e.interactive(!1),e.useVoronoi(!1))}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.linePlusBarChart=function(){"use strict";function b(v){return v.each(function(v){function J(a){var b=+("e"==a),c=b?1:-1,d=X/3;return"M"+.5*c+","+d+"A6,6 0 0 "+b+" "+6.5*c+","+(d+6)+"V"+(2*d-6)+"A6,6 0 0 "+b+" "+.5*c+","+2*d+"ZM"+2.5*c+","+(d+8)+"V"+(2*d-8)+"M"+4.5*c+","+(d+8)+"V"+(2*d-8)}function S(){u.empty()||u.extent(I),kb.data([u.empty()?e.domain():I]).each(function(a){var b=e(a[0])-e.range()[0],c=e.range()[1]-e(a[1]);d3.select(this).select(".left").attr("width",0>b?0:b),d3.select(this).select(".right").attr("x",e(a[1])).attr("width",0>c?0:c)})}function T(){I=u.empty()?null:u.extent(),c=u.empty()?e.domain():u.extent(),K.brush({extent:c,brush:u}),S(),l.width(V).height(W).color(v.map(function(a,b){return a.color||C(a,b)}).filter(function(a,b){return!v[b].disabled&&v[b].bar})),j.width(V).height(W).color(v.map(function(a,b){return a.color||C(a,b)}).filter(function(a,b){return!v[b].disabled&&!v[b].bar}));var b=db.select(".nv-focus .nv-barsWrap").datum(Z.length?Z.map(function(a){return{key:a.key,values:a.values.filter(function(a,b){return l.x()(a,b)>=c[0]&&l.x()(a,b)<=c[1]})}}):[{values:[]}]),h=db.select(".nv-focus .nv-linesWrap").datum($[0].disabled?[{values:[]}]:$.map(function(a){return{area:a.area,fillOpacity:a.fillOpacity,key:a.key,values:a.values.filter(function(a,b){return j.x()(a,b)>=c[0]&&j.x()(a,b)<=c[1]})}}));d=Z.length?l.xScale():j.xScale(),n.scale(d)._ticks(a.utils.calcTicksX(V/100,v)).tickSize(-W,0),n.domain([Math.ceil(c[0]),Math.floor(c[1])]),db.select(".nv-x.nv-axis").transition().duration(L).call(n),b.transition().duration(L).call(l),h.transition().duration(L).call(j),db.select(".nv-focus .nv-x.nv-axis").attr("transform","translate(0,"+f.range()[0]+")"),p.scale(f)._ticks(a.utils.calcTicksY(W/36,v)).tickSize(-V,0),q.scale(g)._ticks(a.utils.calcTicksY(W/36,v)).tickSize(Z.length?0:-V,0),db.select(".nv-focus .nv-y1.nv-axis").style("opacity",Z.length?1:0),db.select(".nv-focus .nv-y2.nv-axis").style("opacity",$.length&&!$[0].disabled?1:0).attr("transform","translate("+d.range()[1]+",0)"),db.select(".nv-focus .nv-y1.nv-axis").transition().duration(L).call(p),db.select(".nv-focus .nv-y2.nv-axis").transition().duration(L).call(q)}var U=d3.select(this);a.utils.initSVG(U);var V=a.utils.availableWidth(y,U,w),W=a.utils.availableHeight(z,U,w)-(E?H:0),X=H-x.top-x.bottom;if(b.update=function(){U.transition().duration(L).call(b)},b.container=this,M.setter(R(v),b.update).getter(Q(v)).update(),M.disabled=v.map(function(a){return!!a.disabled}),!N){var Y;N={};for(Y in M)N[Y]=M[Y]instanceof Array?M[Y].slice(0):M[Y]}if(!(v&&v.length&&v.filter(function(a){return a.values.length}).length))return a.utils.noData(b,U),b;U.selectAll(".nv-noData").remove();var Z=v.filter(function(a){return!a.disabled&&a.bar}),$=v.filter(function(a){return!a.bar});d=l.xScale(),e=o.scale(),f=l.yScale(),g=j.yScale(),h=m.yScale(),i=k.yScale();var _=v.filter(function(a){return!a.disabled&&a.bar}).map(function(a){return a.values.map(function(a,b){return{x:A(a,b),y:B(a,b)}})}),ab=v.filter(function(a){return!a.disabled&&!a.bar}).map(function(a){return a.values.map(function(a,b){return{x:A(a,b),y:B(a,b)}})});d.range([0,V]),e.domain(d3.extent(d3.merge(_.concat(ab)),function(a){return a.x})).range([0,V]);var bb=U.selectAll("g.nv-wrap.nv-linePlusBar").data([v]),cb=bb.enter().append("g").attr("class","nvd3 nv-wrap nv-linePlusBar").append("g"),db=bb.select("g");cb.append("g").attr("class","nv-legendWrap");var eb=cb.append("g").attr("class","nv-focus");eb.append("g").attr("class","nv-x nv-axis"),eb.append("g").attr("class","nv-y1 nv-axis"),eb.append("g").attr("class","nv-y2 nv-axis"),eb.append("g").attr("class","nv-barsWrap"),eb.append("g").attr("class","nv-linesWrap");var fb=cb.append("g").attr("class","nv-context");if(fb.append("g").attr("class","nv-x nv-axis"),fb.append("g").attr("class","nv-y1 nv-axis"),fb.append("g").attr("class","nv-y2 nv-axis"),fb.append("g").attr("class","nv-barsWrap"),fb.append("g").attr("class","nv-linesWrap"),fb.append("g").attr("class","nv-brushBackground"),fb.append("g").attr("class","nv-x nv-brush"),D){var gb=t.align()?V/2:V,hb=t.align()?gb:0;t.width(gb),db.select(".nv-legendWrap").datum(v.map(function(a){return a.originalKey=void 0===a.originalKey?a.key:a.originalKey,a.key=a.originalKey+(a.bar?O:P),a})).call(t),w.top!=t.height()&&(w.top=t.height(),W=a.utils.availableHeight(z,U,w)-H),db.select(".nv-legendWrap").attr("transform","translate("+hb+","+-w.top+")")}bb.attr("transform","translate("+w.left+","+w.top+")"),db.select(".nv-context").style("display",E?"initial":"none"),m.width(V).height(X).color(v.map(function(a,b){return a.color||C(a,b)}).filter(function(a,b){return!v[b].disabled&&v[b].bar})),k.width(V).height(X).color(v.map(function(a,b){return a.color||C(a,b)}).filter(function(a,b){return!v[b].disabled&&!v[b].bar}));var ib=db.select(".nv-context .nv-barsWrap").datum(Z.length?Z:[{values:[]}]),jb=db.select(".nv-context .nv-linesWrap").datum($[0].disabled?[{values:[]}]:$);db.select(".nv-context").attr("transform","translate(0,"+(W+w.bottom+x.top)+")"),ib.transition().call(m),jb.transition().call(k),G&&(o._ticks(a.utils.calcTicksX(V/100,v)).tickSize(-X,0),db.select(".nv-context .nv-x.nv-axis").attr("transform","translate(0,"+h.range()[0]+")"),db.select(".nv-context .nv-x.nv-axis").transition().call(o)),F&&(r.scale(h)._ticks(X/36).tickSize(-V,0),s.scale(i)._ticks(X/36).tickSize(Z.length?0:-V,0),db.select(".nv-context .nv-y3.nv-axis").style("opacity",Z.length?1:0).attr("transform","translate(0,"+e.range()[0]+")"),db.select(".nv-context .nv-y2.nv-axis").style("opacity",$.length?1:0).attr("transform","translate("+e.range()[1]+",0)"),db.select(".nv-context .nv-y1.nv-axis").transition().call(r),db.select(".nv-context .nv-y2.nv-axis").transition().call(s)),u.x(e).on("brush",T),I&&u.extent(I);var kb=db.select(".nv-brushBackground").selectAll("g").data([I||u.extent()]),lb=kb.enter().append("g");lb.append("rect").attr("class","left").attr("x",0).attr("y",0).attr("height",X),lb.append("rect").attr("class","right").attr("x",0).attr("y",0).attr("height",X);var mb=db.select(".nv-x.nv-brush").call(u);mb.selectAll("rect").attr("height",X),mb.selectAll(".resize").append("path").attr("d",J),t.dispatch.on("stateChange",function(a){for(var c in a)M[c]=a[c];K.stateChange(M),b.update()}),K.on("changeState",function(a){"undefined"!=typeof a.disabled&&(v.forEach(function(b,c){b.disabled=a.disabled[c]}),M.disabled=a.disabled),b.update()}),T()}),b}var c,d,e,f,g,h,i,j=a.models.line(),k=a.models.line(),l=a.models.historicalBar(),m=a.models.historicalBar(),n=a.models.axis(),o=a.models.axis(),p=a.models.axis(),q=a.models.axis(),r=a.models.axis(),s=a.models.axis(),t=a.models.legend(),u=d3.svg.brush(),v=a.models.tooltip(),w={top:30,right:30,bottom:30,left:60},x={top:0,right:30,bottom:20,left:60},y=null,z=null,A=function(a){return a.x},B=function(a){return a.y},C=a.utils.defaultColor(),D=!0,E=!0,F=!1,G=!0,H=50,I=null,J=null,K=d3.dispatch("brush","stateChange","changeState"),L=0,M=a.utils.state(),N=null,O=" (left axis)",P=" (right axis)";j.clipEdge(!0),k.interactive(!1),n.orient("bottom").tickPadding(5),p.orient("left"),q.orient("right"),o.orient("bottom").tickPadding(5),r.orient("left"),s.orient("right"),v.headerEnabled(!0).headerFormatter(function(a,b){return n.tickFormat()(a,b)});var Q=function(a){return function(){return{active:a.map(function(a){return!a.disabled})}}},R=function(a){return function(b){void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return j.dispatch.on("elementMouseover.tooltip",function(a){v.duration(100).valueFormatter(function(a,b){return q.tickFormat()(a,b)}).data(a).position(a.pos).hidden(!1)}),j.dispatch.on("elementMouseout.tooltip",function(){v.hidden(!0)}),l.dispatch.on("elementMouseover.tooltip",function(a){a.value=b.x()(a.data),a.series={value:b.y()(a.data),color:a.color},v.duration(0).valueFormatter(function(a,b){return p.tickFormat()(a,b)}).data(a).hidden(!1)}),l.dispatch.on("elementMouseout.tooltip",function(){v.hidden(!0)}),l.dispatch.on("elementMousemove.tooltip",function(){v.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=K,b.legend=t,b.lines=j,b.lines2=k,b.bars=l,b.bars2=m,b.xAxis=n,b.x2Axis=o,b.y1Axis=p,b.y2Axis=q,b.y3Axis=r,b.y4Axis=s,b.tooltip=v,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return y},set:function(a){y=a}},height:{get:function(){return z},set:function(a){z=a}},showLegend:{get:function(){return D},set:function(a){D=a}},brushExtent:{get:function(){return I},set:function(a){I=a}},noData:{get:function(){return J},set:function(a){J=a}},focusEnable:{get:function(){return E},set:function(a){E=a}},focusHeight:{get:function(){return H},set:function(a){H=a}},focusShowAxisX:{get:function(){return G},set:function(a){G=a}},focusShowAxisY:{get:function(){return F},set:function(a){F=a}},legendLeftAxisHint:{get:function(){return O},set:function(a){O=a}},legendRightAxisHint:{get:function(){return P},set:function(a){P=a}},tooltips:{get:function(){return v.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),v.enabled(!!b)}},tooltipContent:{get:function(){return v.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),v.contentGenerator(b)}},margin:{get:function(){return w},set:function(a){w.top=void 0!==a.top?a.top:w.top,w.right=void 0!==a.right?a.right:w.right,w.bottom=void 0!==a.bottom?a.bottom:w.bottom,w.left=void 0!==a.left?a.left:w.left}},duration:{get:function(){return L},set:function(a){L=a}},color:{get:function(){return C},set:function(b){C=a.utils.getColor(b),t.color(C)}},x:{get:function(){return A},set:function(a){A=a,j.x(a),k.x(a),l.x(a),m.x(a)}},y:{get:function(){return B},set:function(a){B=a,j.y(a),k.y(a),l.y(a),m.y(a)}}}),a.utils.inheritOptions(b,j),a.utils.initOptions(b),b},a.models.lineWithFocusChart=function(){"use strict";function b(o){return o.each(function(o){function z(a){var b=+("e"==a),c=b?1:-1,d=M/3;return"M"+.5*c+","+d+"A6,6 0 0 "+b+" "+6.5*c+","+(d+6)+"V"+(2*d-6)+"A6,6 0 0 "+b+" "+.5*c+","+2*d+"ZM"+2.5*c+","+(d+8)+"V"+(2*d-8)+"M"+4.5*c+","+(d+8)+"V"+(2*d-8)}function G(){n.empty()||n.extent(y),U.data([n.empty()?e.domain():y]).each(function(a){var b=e(a[0])-c.range()[0],d=K-e(a[1]);d3.select(this).select(".left").attr("width",0>b?0:b),d3.select(this).select(".right").attr("x",e(a[1])).attr("width",0>d?0:d)})}function H(){y=n.empty()?null:n.extent();var a=n.empty()?e.domain():n.extent();if(!(Math.abs(a[0]-a[1])<=1)){A.brush({extent:a,brush:n}),G();var b=Q.select(".nv-focus .nv-linesWrap").datum(o.filter(function(a){return!a.disabled}).map(function(b){return{key:b.key,area:b.area,values:b.values.filter(function(b,c){return g.x()(b,c)>=a[0]&&g.x()(b,c)<=a[1]})}}));b.transition().duration(B).call(g),Q.select(".nv-focus .nv-x.nv-axis").transition().duration(B).call(i),Q.select(".nv-focus .nv-y.nv-axis").transition().duration(B).call(j)}}var I=d3.select(this),J=this;a.utils.initSVG(I);var K=a.utils.availableWidth(t,I,q),L=a.utils.availableHeight(u,I,q)-v,M=v-r.top-r.bottom;if(b.update=function(){I.transition().duration(B).call(b)},b.container=this,C.setter(F(o),b.update).getter(E(o)).update(),C.disabled=o.map(function(a){return!!a.disabled}),!D){var N;D={};for(N in C)D[N]=C[N]instanceof Array?C[N].slice(0):C[N]}if(!(o&&o.length&&o.filter(function(a){return a.values.length}).length))return a.utils.noData(b,I),b;I.selectAll(".nv-noData").remove(),c=g.xScale(),d=g.yScale(),e=h.xScale(),f=h.yScale();var O=I.selectAll("g.nv-wrap.nv-lineWithFocusChart").data([o]),P=O.enter().append("g").attr("class","nvd3 nv-wrap nv-lineWithFocusChart").append("g"),Q=O.select("g");P.append("g").attr("class","nv-legendWrap");var R=P.append("g").attr("class","nv-focus");R.append("g").attr("class","nv-x nv-axis"),R.append("g").attr("class","nv-y nv-axis"),R.append("g").attr("class","nv-linesWrap"),R.append("g").attr("class","nv-interactive");var S=P.append("g").attr("class","nv-context");S.append("g").attr("class","nv-x nv-axis"),S.append("g").attr("class","nv-y nv-axis"),S.append("g").attr("class","nv-linesWrap"),S.append("g").attr("class","nv-brushBackground"),S.append("g").attr("class","nv-x nv-brush"),x&&(m.width(K),Q.select(".nv-legendWrap").datum(o).call(m),q.top!=m.height()&&(q.top=m.height(),L=a.utils.availableHeight(u,I,q)-v),Q.select(".nv-legendWrap").attr("transform","translate(0,"+-q.top+")")),O.attr("transform","translate("+q.left+","+q.top+")"),w&&(p.width(K).height(L).margin({left:q.left,top:q.top}).svgContainer(I).xScale(c),O.select(".nv-interactive").call(p)),g.width(K).height(L).color(o.map(function(a,b){return a.color||s(a,b)}).filter(function(a,b){return!o[b].disabled})),h.defined(g.defined()).width(K).height(M).color(o.map(function(a,b){return a.color||s(a,b)}).filter(function(a,b){return!o[b].disabled})),Q.select(".nv-context").attr("transform","translate(0,"+(L+q.bottom+r.top)+")");var T=Q.select(".nv-context .nv-linesWrap").datum(o.filter(function(a){return!a.disabled}));d3.transition(T).call(h),i.scale(c)._ticks(a.utils.calcTicksX(K/100,o)).tickSize(-L,0),j.scale(d)._ticks(a.utils.calcTicksY(L/36,o)).tickSize(-K,0),Q.select(".nv-focus .nv-x.nv-axis").attr("transform","translate(0,"+L+")"),n.x(e).on("brush",function(){H()}),y&&n.extent(y);var U=Q.select(".nv-brushBackground").selectAll("g").data([y||n.extent()]),V=U.enter().append("g");V.append("rect").attr("class","left").attr("x",0).attr("y",0).attr("height",M),V.append("rect").attr("class","right").attr("x",0).attr("y",0).attr("height",M);var W=Q.select(".nv-x.nv-brush").call(n);W.selectAll("rect").attr("height",M),W.selectAll(".resize").append("path").attr("d",z),H(),k.scale(e)._ticks(a.utils.calcTicksX(K/100,o)).tickSize(-M,0),Q.select(".nv-context .nv-x.nv-axis").attr("transform","translate(0,"+f.range()[0]+")"),d3.transition(Q.select(".nv-context .nv-x.nv-axis")).call(k),l.scale(f)._ticks(a.utils.calcTicksY(M/36,o)).tickSize(-K,0),d3.transition(Q.select(".nv-context .nv-y.nv-axis")).call(l),Q.select(".nv-context .nv-x.nv-axis").attr("transform","translate(0,"+f.range()[0]+")"),m.dispatch.on("stateChange",function(a){for(var c in a)C[c]=a[c];A.stateChange(C),b.update()}),p.dispatch.on("elementMousemove",function(c){g.clearHighlights();var d,f,h,k=[];if(o.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(i,j){var l=n.empty()?e.domain():n.extent(),m=i.values.filter(function(a,b){return g.x()(a,b)>=l[0]&&g.x()(a,b)<=l[1]});f=a.interactiveBisect(m,c.pointXValue,g.x());var o=m[f],p=b.y()(o,f);null!=p&&g.highlightPoint(j,f,!0),void 0!==o&&(void 0===d&&(d=o),void 0===h&&(h=b.xScale()(b.x()(o,f))),k.push({key:i.key,value:b.y()(o,f),color:s(i,i.seriesIndex)}))}),k.length>2){var l=b.yScale().invert(c.mouseY),m=Math.abs(b.yScale().domain()[0]-b.yScale().domain()[1]),r=.03*m,t=a.nearestValueIndex(k.map(function(a){return a.value}),l,r);null!==t&&(k[t].highlight=!0)}var u=i.tickFormat()(b.x()(d,f));p.tooltip.position({left:c.mouseX+q.left,top:c.mouseY+q.top}).chartContainer(J.parentNode).valueFormatter(function(a){return null==a?"N/A":j.tickFormat()(a)}).data({value:u,index:f,series:k})(),p.renderGuideLine(h)}),p.dispatch.on("elementMouseout",function(){g.clearHighlights()}),A.on("changeState",function(a){"undefined"!=typeof a.disabled&&o.forEach(function(b,c){b.disabled=a.disabled[c]}),b.update()})}),b}var c,d,e,f,g=a.models.line(),h=a.models.line(),i=a.models.axis(),j=a.models.axis(),k=a.models.axis(),l=a.models.axis(),m=a.models.legend(),n=d3.svg.brush(),o=a.models.tooltip(),p=a.interactiveGuideline(),q={top:30,right:30,bottom:30,left:60},r={top:0,right:30,bottom:20,left:60},s=a.utils.defaultColor(),t=null,u=null,v=50,w=!1,x=!0,y=null,z=null,A=d3.dispatch("brush","stateChange","changeState"),B=250,C=a.utils.state(),D=null;g.clipEdge(!0).duration(0),h.interactive(!1),i.orient("bottom").tickPadding(5),j.orient("left"),k.orient("bottom").tickPadding(5),l.orient("left"),o.valueFormatter(function(a,b){return j.tickFormat()(a,b)}).headerFormatter(function(a,b){return i.tickFormat()(a,b)});var E=function(a){return function(){return{active:a.map(function(a){return!a.disabled})}}},F=function(a){return function(b){void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return g.dispatch.on("elementMouseover.tooltip",function(a){o.data(a).position(a.pos).hidden(!1)}),g.dispatch.on("elementMouseout.tooltip",function(){o.hidden(!0)}),b.dispatch=A,b.legend=m,b.lines=g,b.lines2=h,b.xAxis=i,b.yAxis=j,b.x2Axis=k,b.y2Axis=l,b.interactiveLayer=p,b.tooltip=o,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return t},set:function(a){t=a}},height:{get:function(){return u},set:function(a){u=a}},focusHeight:{get:function(){return v},set:function(a){v=a}},showLegend:{get:function(){return x},set:function(a){x=a}},brushExtent:{get:function(){return y},set:function(a){y=a}},defaultState:{get:function(){return D},set:function(a){D=a}},noData:{get:function(){return z},set:function(a){z=a}},tooltips:{get:function(){return o.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),o.enabled(!!b)}},tooltipContent:{get:function(){return o.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),o.contentGenerator(b)}},margin:{get:function(){return q},set:function(a){q.top=void 0!==a.top?a.top:q.top,q.right=void 0!==a.right?a.right:q.right,q.bottom=void 0!==a.bottom?a.bottom:q.bottom,q.left=void 0!==a.left?a.left:q.left}},color:{get:function(){return s},set:function(b){s=a.utils.getColor(b),m.color(s)}},interpolate:{get:function(){return g.interpolate()},set:function(a){g.interpolate(a),h.interpolate(a)}},xTickFormat:{get:function(){return i.tickFormat()},set:function(a){i.tickFormat(a),k.tickFormat(a)}},yTickFormat:{get:function(){return j.tickFormat()},set:function(a){j.tickFormat(a),l.tickFormat(a)}},duration:{get:function(){return B},set:function(a){B=a,j.duration(B),l.duration(B),i.duration(B),k.duration(B)}},x:{get:function(){return g.x()},set:function(a){g.x(a),h.x(a)}},y:{get:function(){return g.y()},set:function(a){g.y(a),h.y(a)}},useInteractiveGuideline:{get:function(){return w},set:function(a){w=a,w&&(g.interactive(!1),g.useVoronoi(!1))}}}),a.utils.inheritOptions(b,g),a.utils.initOptions(b),b},a.models.multiBar=function(){"use strict";function b(E){return C.reset(),E.each(function(b){var E=k-j.left-j.right,F=l-j.top-j.bottom;p=d3.select(this),a.utils.initSVG(p);var G=0;if(x&&b.length&&(x=[{values:b[0].values.map(function(a){return{x:a.x,y:0,series:a.series,size:.01}})}]),u){var H=d3.layout.stack().offset(v).values(function(a){return a.values}).y(r)(!b.length&&x?x:b);H.forEach(function(a,c){a.nonStackable?(b[c].nonStackableSeries=G++,H[c]=b[c]):c>0&&H[c-1].nonStackable&&H[c].values.map(function(a,b){a.y0-=H[c-1].values[b].y,a.y1=a.y0+a.y})}),b=H}b.forEach(function(a,b){a.values.forEach(function(c){c.series=b,c.key=a.key})}),u&&b[0].values.map(function(a,c){var d=0,e=0;b.map(function(a,f){if(!b[f].nonStackable){var g=a.values[c];g.size=Math.abs(g.y),g.y<0?(g.y1=e,e-=g.size):(g.y1=g.size+d,d+=g.size)}})});var I=d&&e?[]:b.map(function(a,b){return a.values.map(function(a,c){return{x:q(a,c),y:r(a,c),y0:a.y0,y1:a.y1,idx:b}})});m.domain(d||d3.merge(I).map(function(a){return a.x})).rangeBands(f||[0,E],A),n.domain(e||d3.extent(d3.merge(I).map(function(a){var c=a.y;return u&&!b[a.idx].nonStackable&&(c=a.y>0?a.y1:a.y1+a.y),c}).concat(s))).range(g||[F,0]),m.domain()[0]===m.domain()[1]&&m.domain(m.domain()[0]?[m.domain()[0]-.01*m.domain()[0],m.domain()[1]+.01*m.domain()[1]]:[-1,1]),n.domain()[0]===n.domain()[1]&&n.domain(n.domain()[0]?[n.domain()[0]+.01*n.domain()[0],n.domain()[1]-.01*n.domain()[1]]:[-1,1]),h=h||m,i=i||n;var J=p.selectAll("g.nv-wrap.nv-multibar").data([b]),K=J.enter().append("g").attr("class","nvd3 nv-wrap nv-multibar"),L=K.append("defs"),M=K.append("g"),N=J.select("g");M.append("g").attr("class","nv-groups"),J.attr("transform","translate("+j.left+","+j.top+")"),L.append("clipPath").attr("id","nv-edge-clip-"+o).append("rect"),J.select("#nv-edge-clip-"+o+" rect").attr("width",E).attr("height",F),N.attr("clip-path",t?"url(#nv-edge-clip-"+o+")":"");var O=J.select(".nv-groups").selectAll(".nv-group").data(function(a){return a},function(a,b){return b});O.enter().append("g").style("stroke-opacity",1e-6).style("fill-opacity",1e-6);var P=C.transition(O.exit().selectAll("rect.nv-bar"),"multibarExit",Math.min(100,z)).attr("y",function(a){var c=i(0)||0;return u&&b[a.series]&&!b[a.series].nonStackable&&(c=i(a.y0)),c}).attr("height",0).remove();P.delay&&P.delay(function(a,b){var c=b*(z/(D+1))-b;return c}),O.attr("class",function(a,b){return"nv-group nv-series-"+b}).classed("hover",function(a){return a.hover}).style("fill",function(a,b){return w(a,b)}).style("stroke",function(a,b){return w(a,b)}),O.style("stroke-opacity",1).style("fill-opacity",.75);var Q=O.selectAll("rect.nv-bar").data(function(a){return x&&!b.length?x.values:a.values});Q.exit().remove();Q.enter().append("rect").attr("class",function(a,b){return r(a,b)<0?"nv-bar negative":"nv-bar positive"}).attr("x",function(a,c,d){return u&&!b[d].nonStackable?0:d*m.rangeBand()/b.length}).attr("y",function(a,c,d){return i(u&&!b[d].nonStackable?a.y0:0)||0}).attr("height",0).attr("width",function(a,c,d){return m.rangeBand()/(u&&!b[d].nonStackable?1:b.length)}).attr("transform",function(a,b){return"translate("+m(q(a,b))+",0)"});Q.style("fill",function(a,b,c){return w(a,c,b)}).style("stroke",function(a,b,c){return w(a,c,b)}).on("mouseover",function(a,b){d3.select(this).classed("hover",!0),B.elementMouseover({data:a,index:b,color:d3.select(this).style("fill")})}).on("mouseout",function(a,b){d3.select(this).classed("hover",!1),B.elementMouseout({data:a,index:b,color:d3.select(this).style("fill")})}).on("mousemove",function(a,b){B.elementMousemove({data:a,index:b,color:d3.select(this).style("fill")})}).on("click",function(a,b){B.elementClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()}).on("dblclick",function(a,b){B.elementDblClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()}),Q.attr("class",function(a,b){return r(a,b)<0?"nv-bar negative":"nv-bar positive"}).attr("transform",function(a,b){return"translate("+m(q(a,b))+",0)"}),y&&(c||(c=b.map(function(){return!0})),Q.style("fill",function(a,b,d){return d3.rgb(y(a,b)).darker(c.map(function(a,b){return b}).filter(function(a,b){return!c[b]})[d]).toString()}).style("stroke",function(a,b,d){return d3.rgb(y(a,b)).darker(c.map(function(a,b){return b}).filter(function(a,b){return!c[b]})[d]).toString()}));var R=Q.watchTransition(C,"multibar",Math.min(250,z)).delay(function(a,c){return c*z/b[0].values.length});u?R.attr("y",function(a,c,d){var e=0;return e=b[d].nonStackable?r(a,c)<0?n(0):n(0)-n(r(a,c))<-1?n(0)-1:n(r(a,c))||0:n(a.y1)}).attr("height",function(a,c,d){return b[d].nonStackable?Math.max(Math.abs(n(r(a,c))-n(0)),1)||0:Math.max(Math.abs(n(a.y+a.y0)-n(a.y0)),1)}).attr("x",function(a,c,d){var e=0;return b[d].nonStackable&&(e=a.series*m.rangeBand()/b.length,b.length!==G&&(e=b[d].nonStackableSeries*m.rangeBand()/(2*G))),e}).attr("width",function(a,c,d){if(b[d].nonStackable){var e=m.rangeBand()/G;return b.length!==G&&(e=m.rangeBand()/(2*G)),e}return m.rangeBand()}):R.attr("x",function(a){return a.series*m.rangeBand()/b.length}).attr("width",m.rangeBand()/b.length).attr("y",function(a,b){return r(a,b)<0?n(0):n(0)-n(r(a,b))<1?n(0)-1:n(r(a,b))||0}).attr("height",function(a,b){return Math.max(Math.abs(n(r(a,b))-n(0)),1)||0}),h=m.copy(),i=n.copy(),b[0]&&b[0].values&&(D=b[0].values.length)}),C.renderEnd("multibar immediate"),b}var c,d,e,f,g,h,i,j={top:0,right:0,bottom:0,left:0},k=960,l=500,m=d3.scale.ordinal(),n=d3.scale.linear(),o=Math.floor(1e4*Math.random()),p=null,q=function(a){return a.x},r=function(a){return a.y},s=[0],t=!0,u=!1,v="zero",w=a.utils.defaultColor(),x=!1,y=null,z=500,A=.1,B=d3.dispatch("chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove","renderEnd"),C=a.utils.renderWatch(B,z),D=0;return b.dispatch=B,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return k},set:function(a){k=a}},height:{get:function(){return l},set:function(a){l=a}},x:{get:function(){return q},set:function(a){q=a}},y:{get:function(){return r},set:function(a){r=a}},xScale:{get:function(){return m},set:function(a){m=a}},yScale:{get:function(){return n},set:function(a){n=a}},xDomain:{get:function(){return d},set:function(a){d=a}},yDomain:{get:function(){return e},set:function(a){e=a}},xRange:{get:function(){return f},set:function(a){f=a}},yRange:{get:function(){return g},set:function(a){g=a}},forceY:{get:function(){return s},set:function(a){s=a}},stacked:{get:function(){return u},set:function(a){u=a}},stackOffset:{get:function(){return v},set:function(a){v=a}},clipEdge:{get:function(){return t},set:function(a){t=a}},disabled:{get:function(){return c},set:function(a){c=a}},id:{get:function(){return o},set:function(a){o=a}},hideable:{get:function(){return x},set:function(a){x=a}},groupSpacing:{get:function(){return A},set:function(a){A=a}},margin:{get:function(){return j},set:function(a){j.top=void 0!==a.top?a.top:j.top,j.right=void 0!==a.right?a.right:j.right,j.bottom=void 0!==a.bottom?a.bottom:j.bottom,j.left=void 0!==a.left?a.left:j.left}},duration:{get:function(){return z},set:function(a){z=a,C.reset(z)}},color:{get:function(){return w},set:function(b){w=a.utils.getColor(b)}},barColor:{get:function(){return y},set:function(b){y=b?a.utils.getColor(b):null}}}),a.utils.initOptions(b),b},a.models.multiBarChart=function(){"use strict";function b(j){return D.reset(),D.models(e),r&&D.models(f),s&&D.models(g),j.each(function(j){var z=d3.select(this);a.utils.initSVG(z);var D=a.utils.availableWidth(l,z,k),H=a.utils.availableHeight(m,z,k);if(b.update=function(){0===C?z.call(b):z.transition().duration(C).call(b)},b.container=this,x.setter(G(j),b.update).getter(F(j)).update(),x.disabled=j.map(function(a){return!!a.disabled}),!y){var I;y={};for(I in x)y[I]=x[I]instanceof Array?x[I].slice(0):x[I]}if(!(j&&j.length&&j.filter(function(a){return a.values.length}).length))return a.utils.noData(b,z),b;z.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale();
var J=z.selectAll("g.nv-wrap.nv-multiBarWithLegend").data([j]),K=J.enter().append("g").attr("class","nvd3 nv-wrap nv-multiBarWithLegend").append("g"),L=J.select("g");if(K.append("g").attr("class","nv-x nv-axis"),K.append("g").attr("class","nv-y nv-axis"),K.append("g").attr("class","nv-barsWrap"),K.append("g").attr("class","nv-legendWrap"),K.append("g").attr("class","nv-controlsWrap"),q&&(h.width(D-B()),L.select(".nv-legendWrap").datum(j).call(h),k.top!=h.height()&&(k.top=h.height(),H=a.utils.availableHeight(m,z,k)),L.select(".nv-legendWrap").attr("transform","translate("+B()+","+-k.top+")")),o){var M=[{key:p.grouped||"Grouped",disabled:e.stacked()},{key:p.stacked||"Stacked",disabled:!e.stacked()}];i.width(B()).color(["#444","#444","#444"]),L.select(".nv-controlsWrap").datum(M).attr("transform","translate(0,"+-k.top+")").call(i)}J.attr("transform","translate("+k.left+","+k.top+")"),t&&L.select(".nv-y.nv-axis").attr("transform","translate("+D+",0)"),e.disabled(j.map(function(a){return a.disabled})).width(D).height(H).color(j.map(function(a,b){return a.color||n(a,b)}).filter(function(a,b){return!j[b].disabled}));var N=L.select(".nv-barsWrap").datum(j.filter(function(a){return!a.disabled}));if(N.call(e),r){f.scale(c)._ticks(a.utils.calcTicksX(D/100,j)).tickSize(-H,0),L.select(".nv-x.nv-axis").attr("transform","translate(0,"+d.range()[0]+")"),L.select(".nv-x.nv-axis").call(f);var O=L.select(".nv-x.nv-axis > g").selectAll("g");if(O.selectAll("line, text").style("opacity",1),v){var P=function(a,b){return"translate("+a+","+b+")"},Q=5,R=17;O.selectAll("text").attr("transform",function(a,b,c){return P(0,c%2==0?Q:R)});var S=d3.selectAll(".nv-x.nv-axis .nv-wrap g g text")[0].length;L.selectAll(".nv-x.nv-axis .nv-axisMaxMin text").attr("transform",function(a,b){return P(0,0===b||S%2!==0?R:Q)})}u&&O.filter(function(a,b){return b%Math.ceil(j[0].values.length/(D/100))!==0}).selectAll("text, line").style("opacity",0),w&&O.selectAll(".tick text").attr("transform","rotate("+w+" 0,0)").style("text-anchor",w>0?"start":"end"),L.select(".nv-x.nv-axis").selectAll("g.nv-axisMaxMin text").style("opacity",1)}s&&(g.scale(d)._ticks(a.utils.calcTicksY(H/36,j)).tickSize(-D,0),L.select(".nv-y.nv-axis").call(g)),h.dispatch.on("stateChange",function(a){for(var c in a)x[c]=a[c];A.stateChange(x),b.update()}),i.dispatch.on("legendClick",function(a){if(a.disabled){switch(M=M.map(function(a){return a.disabled=!0,a}),a.disabled=!1,a.key){case"Grouped":case p.grouped:e.stacked(!1);break;case"Stacked":case p.stacked:e.stacked(!0)}x.stacked=e.stacked(),A.stateChange(x),b.update()}}),A.on("changeState",function(a){"undefined"!=typeof a.disabled&&(j.forEach(function(b,c){b.disabled=a.disabled[c]}),x.disabled=a.disabled),"undefined"!=typeof a.stacked&&(e.stacked(a.stacked),x.stacked=a.stacked,E=a.stacked),b.update()})}),D.renderEnd("multibarchart immediate"),b}var c,d,e=a.models.multiBar(),f=a.models.axis(),g=a.models.axis(),h=a.models.legend(),i=a.models.legend(),j=a.models.tooltip(),k={top:30,right:20,bottom:50,left:60},l=null,m=null,n=a.utils.defaultColor(),o=!0,p={},q=!0,r=!0,s=!0,t=!1,u=!0,v=!1,w=0,x=a.utils.state(),y=null,z=null,A=d3.dispatch("stateChange","changeState","renderEnd"),B=function(){return o?180:0},C=250;x.stacked=!1,e.stacked(!1),f.orient("bottom").tickPadding(7).showMaxMin(!1).tickFormat(function(a){return a}),g.orient(t?"right":"left").tickFormat(d3.format(",.1f")),j.duration(0).valueFormatter(function(a,b){return g.tickFormat()(a,b)}).headerFormatter(function(a,b){return f.tickFormat()(a,b)}),i.updateState(!1);var D=a.utils.renderWatch(A),E=!1,F=function(a){return function(){return{active:a.map(function(a){return!a.disabled}),stacked:E}}},G=function(a){return function(b){void 0!==b.stacked&&(E=b.stacked),void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return e.dispatch.on("elementMouseover.tooltip",function(a){a.value=b.x()(a.data),a.series={key:a.data.key,value:b.y()(a.data),color:a.color},j.data(a).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(){j.hidden(!0)}),e.dispatch.on("elementMousemove.tooltip",function(){j.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=A,b.multibar=e,b.legend=h,b.controls=i,b.xAxis=f,b.yAxis=g,b.state=x,b.tooltip=j,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return l},set:function(a){l=a}},height:{get:function(){return m},set:function(a){m=a}},showLegend:{get:function(){return q},set:function(a){q=a}},showControls:{get:function(){return o},set:function(a){o=a}},controlLabels:{get:function(){return p},set:function(a){p=a}},showXAxis:{get:function(){return r},set:function(a){r=a}},showYAxis:{get:function(){return s},set:function(a){s=a}},defaultState:{get:function(){return y},set:function(a){y=a}},noData:{get:function(){return z},set:function(a){z=a}},reduceXTicks:{get:function(){return u},set:function(a){u=a}},rotateLabels:{get:function(){return w},set:function(a){w=a}},staggerLabels:{get:function(){return v},set:function(a){v=a}},tooltips:{get:function(){return j.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),j.enabled(!!b)}},tooltipContent:{get:function(){return j.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),j.contentGenerator(b)}},margin:{get:function(){return k},set:function(a){k.top=void 0!==a.top?a.top:k.top,k.right=void 0!==a.right?a.right:k.right,k.bottom=void 0!==a.bottom?a.bottom:k.bottom,k.left=void 0!==a.left?a.left:k.left}},duration:{get:function(){return C},set:function(a){C=a,e.duration(C),f.duration(C),g.duration(C),D.reset(C)}},color:{get:function(){return n},set:function(b){n=a.utils.getColor(b),h.color(n)}},rightAlignYAxis:{get:function(){return t},set:function(a){t=a,g.orient(t?"right":"left")}},barColor:{get:function(){return e.barColor},set:function(a){e.barColor(a),h.color(function(a,b){return d3.rgb("#ccc").darker(1.5*b).toString()})}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.multiBarHorizontal=function(){"use strict";function b(m){return E.reset(),m.each(function(b){var m=k-j.left-j.right,C=l-j.top-j.bottom;n=d3.select(this),a.utils.initSVG(n),w&&(b=d3.layout.stack().offset("zero").values(function(a){return a.values}).y(r)(b)),b.forEach(function(a,b){a.values.forEach(function(c){c.series=b,c.key=a.key})}),w&&b[0].values.map(function(a,c){var d=0,e=0;b.map(function(a){var b=a.values[c];b.size=Math.abs(b.y),b.y<0?(b.y1=e-b.size,e-=b.size):(b.y1=d,d+=b.size)})});var F=d&&e?[]:b.map(function(a){return a.values.map(function(a,b){return{x:q(a,b),y:r(a,b),y0:a.y0,y1:a.y1}})});o.domain(d||d3.merge(F).map(function(a){return a.x})).rangeBands(f||[0,C],A),p.domain(e||d3.extent(d3.merge(F).map(function(a){return w?a.y>0?a.y1+a.y:a.y1:a.y}).concat(t))),p.range(x&&!w?g||[p.domain()[0]<0?z:0,m-(p.domain()[1]>0?z:0)]:g||[0,m]),h=h||o,i=i||d3.scale.linear().domain(p.domain()).range([p(0),p(0)]);{var G=d3.select(this).selectAll("g.nv-wrap.nv-multibarHorizontal").data([b]),H=G.enter().append("g").attr("class","nvd3 nv-wrap nv-multibarHorizontal"),I=(H.append("defs"),H.append("g"));G.select("g")}I.append("g").attr("class","nv-groups"),G.attr("transform","translate("+j.left+","+j.top+")");var J=G.select(".nv-groups").selectAll(".nv-group").data(function(a){return a},function(a,b){return b});J.enter().append("g").style("stroke-opacity",1e-6).style("fill-opacity",1e-6),J.exit().watchTransition(E,"multibarhorizontal: exit groups").style("stroke-opacity",1e-6).style("fill-opacity",1e-6).remove(),J.attr("class",function(a,b){return"nv-group nv-series-"+b}).classed("hover",function(a){return a.hover}).style("fill",function(a,b){return u(a,b)}).style("stroke",function(a,b){return u(a,b)}),J.watchTransition(E,"multibarhorizontal: groups").style("stroke-opacity",1).style("fill-opacity",.75);var K=J.selectAll("g.nv-bar").data(function(a){return a.values});K.exit().remove();var L=K.enter().append("g").attr("transform",function(a,c,d){return"translate("+i(w?a.y0:0)+","+(w?0:d*o.rangeBand()/b.length+o(q(a,c)))+")"});L.append("rect").attr("width",0).attr("height",o.rangeBand()/(w?1:b.length)),K.on("mouseover",function(a,b){d3.select(this).classed("hover",!0),D.elementMouseover({data:a,index:b,color:d3.select(this).style("fill")})}).on("mouseout",function(a,b){d3.select(this).classed("hover",!1),D.elementMouseout({data:a,index:b,color:d3.select(this).style("fill")})}).on("mouseout",function(a,b){D.elementMouseout({data:a,index:b,color:d3.select(this).style("fill")})}).on("mousemove",function(a,b){D.elementMousemove({data:a,index:b,color:d3.select(this).style("fill")})}).on("click",function(a,b){D.elementClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()}).on("dblclick",function(a,b){D.elementDblClick({data:a,index:b,color:d3.select(this).style("fill")}),d3.event.stopPropagation()}),s(b[0],0)&&(L.append("polyline"),K.select("polyline").attr("fill","none").attr("points",function(a,c){var d=s(a,c),e=.8*o.rangeBand()/(2*(w?1:b.length));d=d.length?d:[-Math.abs(d),Math.abs(d)],d=d.map(function(a){return p(a)-p(0)});var f=[[d[0],-e],[d[0],e],[d[0],0],[d[1],0],[d[1],-e],[d[1],e]];return f.map(function(a){return a.join(",")}).join(" ")}).attr("transform",function(a,c){var d=o.rangeBand()/(2*(w?1:b.length));return"translate("+(r(a,c)<0?0:p(r(a,c))-p(0))+", "+d+")"})),L.append("text"),x&&!w?(K.select("text").attr("text-anchor",function(a,b){return r(a,b)<0?"end":"start"}).attr("y",o.rangeBand()/(2*b.length)).attr("dy",".32em").text(function(a,b){var c=B(r(a,b)),d=s(a,b);return void 0===d?c:d.length?c+"+"+B(Math.abs(d[1]))+"-"+B(Math.abs(d[0])):c+"±"+B(Math.abs(d))}),K.watchTransition(E,"multibarhorizontal: bars").select("text").attr("x",function(a,b){return r(a,b)<0?-4:p(r(a,b))-p(0)+4})):K.selectAll("text").text(""),y&&!w?(L.append("text").classed("nv-bar-label",!0),K.select("text.nv-bar-label").attr("text-anchor",function(a,b){return r(a,b)<0?"start":"end"}).attr("y",o.rangeBand()/(2*b.length)).attr("dy",".32em").text(function(a,b){return q(a,b)}),K.watchTransition(E,"multibarhorizontal: bars").select("text.nv-bar-label").attr("x",function(a,b){return r(a,b)<0?p(0)-p(r(a,b))+4:-4})):K.selectAll("text.nv-bar-label").text(""),K.attr("class",function(a,b){return r(a,b)<0?"nv-bar negative":"nv-bar positive"}),v&&(c||(c=b.map(function(){return!0})),K.style("fill",function(a,b,d){return d3.rgb(v(a,b)).darker(c.map(function(a,b){return b}).filter(function(a,b){return!c[b]})[d]).toString()}).style("stroke",function(a,b,d){return d3.rgb(v(a,b)).darker(c.map(function(a,b){return b}).filter(function(a,b){return!c[b]})[d]).toString()})),w?K.watchTransition(E,"multibarhorizontal: bars").attr("transform",function(a,b){return"translate("+p(a.y1)+","+o(q(a,b))+")"}).select("rect").attr("width",function(a,b){return Math.abs(p(r(a,b)+a.y0)-p(a.y0))}).attr("height",o.rangeBand()):K.watchTransition(E,"multibarhorizontal: bars").attr("transform",function(a,c){return"translate("+p(r(a,c)<0?r(a,c):0)+","+(a.series*o.rangeBand()/b.length+o(q(a,c)))+")"}).select("rect").attr("height",o.rangeBand()/b.length).attr("width",function(a,b){return Math.max(Math.abs(p(r(a,b))-p(0)),1)}),h=o.copy(),i=p.copy()}),E.renderEnd("multibarHorizontal immediate"),b}var c,d,e,f,g,h,i,j={top:0,right:0,bottom:0,left:0},k=960,l=500,m=Math.floor(1e4*Math.random()),n=null,o=d3.scale.ordinal(),p=d3.scale.linear(),q=function(a){return a.x},r=function(a){return a.y},s=function(a){return a.yErr},t=[0],u=a.utils.defaultColor(),v=null,w=!1,x=!1,y=!1,z=60,A=.1,B=d3.format(",.2f"),C=250,D=d3.dispatch("chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove","renderEnd"),E=a.utils.renderWatch(D,C);return b.dispatch=D,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return k},set:function(a){k=a}},height:{get:function(){return l},set:function(a){l=a}},x:{get:function(){return q},set:function(a){q=a}},y:{get:function(){return r},set:function(a){r=a}},yErr:{get:function(){return s},set:function(a){s=a}},xScale:{get:function(){return o},set:function(a){o=a}},yScale:{get:function(){return p},set:function(a){p=a}},xDomain:{get:function(){return d},set:function(a){d=a}},yDomain:{get:function(){return e},set:function(a){e=a}},xRange:{get:function(){return f},set:function(a){f=a}},yRange:{get:function(){return g},set:function(a){g=a}},forceY:{get:function(){return t},set:function(a){t=a}},stacked:{get:function(){return w},set:function(a){w=a}},showValues:{get:function(){return x},set:function(a){x=a}},disabled:{get:function(){return c},set:function(a){c=a}},id:{get:function(){return m},set:function(a){m=a}},valueFormat:{get:function(){return B},set:function(a){B=a}},valuePadding:{get:function(){return z},set:function(a){z=a}},groupSpacing:{get:function(){return A},set:function(a){A=a}},margin:{get:function(){return j},set:function(a){j.top=void 0!==a.top?a.top:j.top,j.right=void 0!==a.right?a.right:j.right,j.bottom=void 0!==a.bottom?a.bottom:j.bottom,j.left=void 0!==a.left?a.left:j.left}},duration:{get:function(){return C},set:function(a){C=a,E.reset(C)}},color:{get:function(){return u},set:function(b){u=a.utils.getColor(b)}},barColor:{get:function(){return v},set:function(b){v=b?a.utils.getColor(b):null}}}),a.utils.initOptions(b),b},a.models.multiBarHorizontalChart=function(){"use strict";function b(j){return C.reset(),C.models(e),r&&C.models(f),s&&C.models(g),j.each(function(j){var w=d3.select(this);a.utils.initSVG(w);var C=a.utils.availableWidth(l,w,k),D=a.utils.availableHeight(m,w,k);if(b.update=function(){w.transition().duration(z).call(b)},b.container=this,t=e.stacked(),u.setter(B(j),b.update).getter(A(j)).update(),u.disabled=j.map(function(a){return!!a.disabled}),!v){var E;v={};for(E in u)v[E]=u[E]instanceof Array?u[E].slice(0):u[E]}if(!(j&&j.length&&j.filter(function(a){return a.values.length}).length))return a.utils.noData(b,w),b;w.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale();var F=w.selectAll("g.nv-wrap.nv-multiBarHorizontalChart").data([j]),G=F.enter().append("g").attr("class","nvd3 nv-wrap nv-multiBarHorizontalChart").append("g"),H=F.select("g");if(G.append("g").attr("class","nv-x nv-axis"),G.append("g").attr("class","nv-y nv-axis").append("g").attr("class","nv-zeroLine").append("line"),G.append("g").attr("class","nv-barsWrap"),G.append("g").attr("class","nv-legendWrap"),G.append("g").attr("class","nv-controlsWrap"),q&&(h.width(C-y()),H.select(".nv-legendWrap").datum(j).call(h),k.top!=h.height()&&(k.top=h.height(),D=a.utils.availableHeight(m,w,k)),H.select(".nv-legendWrap").attr("transform","translate("+y()+","+-k.top+")")),o){var I=[{key:p.grouped||"Grouped",disabled:e.stacked()},{key:p.stacked||"Stacked",disabled:!e.stacked()}];i.width(y()).color(["#444","#444","#444"]),H.select(".nv-controlsWrap").datum(I).attr("transform","translate(0,"+-k.top+")").call(i)}F.attr("transform","translate("+k.left+","+k.top+")"),e.disabled(j.map(function(a){return a.disabled})).width(C).height(D).color(j.map(function(a,b){return a.color||n(a,b)}).filter(function(a,b){return!j[b].disabled}));var J=H.select(".nv-barsWrap").datum(j.filter(function(a){return!a.disabled}));if(J.transition().call(e),r){f.scale(c)._ticks(a.utils.calcTicksY(D/24,j)).tickSize(-C,0),H.select(".nv-x.nv-axis").call(f);var K=H.select(".nv-x.nv-axis").selectAll("g");K.selectAll("line, text")}s&&(g.scale(d)._ticks(a.utils.calcTicksX(C/100,j)).tickSize(-D,0),H.select(".nv-y.nv-axis").attr("transform","translate(0,"+D+")"),H.select(".nv-y.nv-axis").call(g)),H.select(".nv-zeroLine line").attr("x1",d(0)).attr("x2",d(0)).attr("y1",0).attr("y2",-D),h.dispatch.on("stateChange",function(a){for(var c in a)u[c]=a[c];x.stateChange(u),b.update()}),i.dispatch.on("legendClick",function(a){if(a.disabled){switch(I=I.map(function(a){return a.disabled=!0,a}),a.disabled=!1,a.key){case"Grouped":e.stacked(!1);break;case"Stacked":e.stacked(!0)}u.stacked=e.stacked(),x.stateChange(u),t=e.stacked(),b.update()}}),x.on("changeState",function(a){"undefined"!=typeof a.disabled&&(j.forEach(function(b,c){b.disabled=a.disabled[c]}),u.disabled=a.disabled),"undefined"!=typeof a.stacked&&(e.stacked(a.stacked),u.stacked=a.stacked,t=a.stacked),b.update()})}),C.renderEnd("multibar horizontal chart immediate"),b}var c,d,e=a.models.multiBarHorizontal(),f=a.models.axis(),g=a.models.axis(),h=a.models.legend().height(30),i=a.models.legend().height(30),j=a.models.tooltip(),k={top:30,right:20,bottom:50,left:60},l=null,m=null,n=a.utils.defaultColor(),o=!0,p={},q=!0,r=!0,s=!0,t=!1,u=a.utils.state(),v=null,w=null,x=d3.dispatch("stateChange","changeState","renderEnd"),y=function(){return o?180:0},z=250;u.stacked=!1,e.stacked(t),f.orient("left").tickPadding(5).showMaxMin(!1).tickFormat(function(a){return a}),g.orient("bottom").tickFormat(d3.format(",.1f")),j.duration(0).valueFormatter(function(a,b){return g.tickFormat()(a,b)}).headerFormatter(function(a,b){return f.tickFormat()(a,b)}),i.updateState(!1);var A=function(a){return function(){return{active:a.map(function(a){return!a.disabled}),stacked:t}}},B=function(a){return function(b){void 0!==b.stacked&&(t=b.stacked),void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}},C=a.utils.renderWatch(x,z);return e.dispatch.on("elementMouseover.tooltip",function(a){a.value=b.x()(a.data),a.series={key:a.data.key,value:b.y()(a.data),color:a.color},j.data(a).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(){j.hidden(!0)}),e.dispatch.on("elementMousemove.tooltip",function(){j.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=x,b.multibar=e,b.legend=h,b.controls=i,b.xAxis=f,b.yAxis=g,b.state=u,b.tooltip=j,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return l},set:function(a){l=a}},height:{get:function(){return m},set:function(a){m=a}},showLegend:{get:function(){return q},set:function(a){q=a}},showControls:{get:function(){return o},set:function(a){o=a}},controlLabels:{get:function(){return p},set:function(a){p=a}},showXAxis:{get:function(){return r},set:function(a){r=a}},showYAxis:{get:function(){return s},set:function(a){s=a}},defaultState:{get:function(){return v},set:function(a){v=a}},noData:{get:function(){return w},set:function(a){w=a}},tooltips:{get:function(){return j.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),j.enabled(!!b)}},tooltipContent:{get:function(){return j.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),j.contentGenerator(b)}},margin:{get:function(){return k},set:function(a){k.top=void 0!==a.top?a.top:k.top,k.right=void 0!==a.right?a.right:k.right,k.bottom=void 0!==a.bottom?a.bottom:k.bottom,k.left=void 0!==a.left?a.left:k.left}},duration:{get:function(){return z},set:function(a){z=a,C.reset(z),e.duration(z),f.duration(z),g.duration(z)}},color:{get:function(){return n},set:function(b){n=a.utils.getColor(b),h.color(n)}},barColor:{get:function(){return e.barColor},set:function(a){e.barColor(a),h.color(function(a,b){return d3.rgb("#ccc").darker(1.5*b).toString()})}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.multiChart=function(){"use strict";function b(j){return j.each(function(j){function k(a){var b=2===j[a.seriesIndex].yAxis?z:y;a.value=a.point.x,a.series={value:a.point.y,color:a.point.color},B.duration(100).valueFormatter(function(a,c){return b.tickFormat()(a,c)}).data(a).position(a.pos).hidden(!1)}function l(a){var b=2===j[a.seriesIndex].yAxis?z:y;a.point.x=v.x()(a.point),a.point.y=v.y()(a.point),B.duration(100).valueFormatter(function(a,c){return b.tickFormat()(a,c)}).data(a).position(a.pos).hidden(!1)}function n(a){var b=2===j[a.data.series].yAxis?z:y;a.value=t.x()(a.data),a.series={value:t.y()(a.data),color:a.color},B.duration(0).valueFormatter(function(a,c){return b.tickFormat()(a,c)}).data(a).hidden(!1)}var C=d3.select(this);a.utils.initSVG(C),b.update=function(){C.transition().call(b)},b.container=this;var D=a.utils.availableWidth(g,C,e),E=a.utils.availableHeight(h,C,e),F=j.filter(function(a){return"line"==a.type&&1==a.yAxis}),G=j.filter(function(a){return"line"==a.type&&2==a.yAxis}),H=j.filter(function(a){return"bar"==a.type&&1==a.yAxis}),I=j.filter(function(a){return"bar"==a.type&&2==a.yAxis}),J=j.filter(function(a){return"area"==a.type&&1==a.yAxis}),K=j.filter(function(a){return"area"==a.type&&2==a.yAxis});if(!(j&&j.length&&j.filter(function(a){return a.values.length}).length))return a.utils.noData(b,C),b;C.selectAll(".nv-noData").remove();var L=j.filter(function(a){return!a.disabled&&1==a.yAxis}).map(function(a){return a.values.map(function(a){return{x:a.x,y:a.y}})}),M=j.filter(function(a){return!a.disabled&&2==a.yAxis}).map(function(a){return a.values.map(function(a){return{x:a.x,y:a.y}})});o.domain(d3.extent(d3.merge(L.concat(M)),function(a){return a.x})).range([0,D]);var N=C.selectAll("g.wrap.multiChart").data([j]),O=N.enter().append("g").attr("class","wrap nvd3 multiChart").append("g");O.append("g").attr("class","nv-x nv-axis"),O.append("g").attr("class","nv-y1 nv-axis"),O.append("g").attr("class","nv-y2 nv-axis"),O.append("g").attr("class","lines1Wrap"),O.append("g").attr("class","lines2Wrap"),O.append("g").attr("class","bars1Wrap"),O.append("g").attr("class","bars2Wrap"),O.append("g").attr("class","stack1Wrap"),O.append("g").attr("class","stack2Wrap"),O.append("g").attr("class","legendWrap");var P=N.select("g"),Q=j.map(function(a,b){return j[b].color||f(a,b)});if(i){var R=A.align()?D/2:D,S=A.align()?R:0;A.width(R),A.color(Q),P.select(".legendWrap").datum(j.map(function(a){return a.originalKey=void 0===a.originalKey?a.key:a.originalKey,a.key=a.originalKey+(1==a.yAxis?"":" (right axis)"),a})).call(A),e.top!=A.height()&&(e.top=A.height(),E=a.utils.availableHeight(h,C,e)),P.select(".legendWrap").attr("transform","translate("+S+","+-e.top+")")}r.width(D).height(E).interpolate(m).color(Q.filter(function(a,b){return!j[b].disabled&&1==j[b].yAxis&&"line"==j[b].type})),s.width(D).height(E).interpolate(m).color(Q.filter(function(a,b){return!j[b].disabled&&2==j[b].yAxis&&"line"==j[b].type})),t.width(D).height(E).color(Q.filter(function(a,b){return!j[b].disabled&&1==j[b].yAxis&&"bar"==j[b].type})),u.width(D).height(E).color(Q.filter(function(a,b){return!j[b].disabled&&2==j[b].yAxis&&"bar"==j[b].type})),v.width(D).height(E).color(Q.filter(function(a,b){return!j[b].disabled&&1==j[b].yAxis&&"area"==j[b].type})),w.width(D).height(E).color(Q.filter(function(a,b){return!j[b].disabled&&2==j[b].yAxis&&"area"==j[b].type})),P.attr("transform","translate("+e.left+","+e.top+")");var T=P.select(".lines1Wrap").datum(F.filter(function(a){return!a.disabled})),U=P.select(".bars1Wrap").datum(H.filter(function(a){return!a.disabled})),V=P.select(".stack1Wrap").datum(J.filter(function(a){return!a.disabled})),W=P.select(".lines2Wrap").datum(G.filter(function(a){return!a.disabled})),X=P.select(".bars2Wrap").datum(I.filter(function(a){return!a.disabled})),Y=P.select(".stack2Wrap").datum(K.filter(function(a){return!a.disabled})),Z=J.length?J.map(function(a){return a.values}).reduce(function(a,b){return a.map(function(a,c){return{x:a.x,y:a.y+b[c].y}})}).concat([{x:0,y:0}]):[],$=K.length?K.map(function(a){return a.values}).reduce(function(a,b){return a.map(function(a,c){return{x:a.x,y:a.y+b[c].y}})}).concat([{x:0,y:0}]):[];p.domain(c||d3.extent(d3.merge(L).concat(Z),function(a){return a.y})).range([0,E]),q.domain(d||d3.extent(d3.merge(M).concat($),function(a){return a.y})).range([0,E]),r.yDomain(p.domain()),t.yDomain(p.domain()),v.yDomain(p.domain()),s.yDomain(q.domain()),u.yDomain(q.domain()),w.yDomain(q.domain()),J.length&&d3.transition(V).call(v),K.length&&d3.transition(Y).call(w),H.length&&d3.transition(U).call(t),I.length&&d3.transition(X).call(u),F.length&&d3.transition(T).call(r),G.length&&d3.transition(W).call(s),x._ticks(a.utils.calcTicksX(D/100,j)).tickSize(-E,0),P.select(".nv-x.nv-axis").attr("transform","translate(0,"+E+")"),d3.transition(P.select(".nv-x.nv-axis")).call(x),y._ticks(a.utils.calcTicksY(E/36,j)).tickSize(-D,0),d3.transition(P.select(".nv-y1.nv-axis")).call(y),z._ticks(a.utils.calcTicksY(E/36,j)).tickSize(-D,0),d3.transition(P.select(".nv-y2.nv-axis")).call(z),P.select(".nv-y1.nv-axis").classed("nv-disabled",L.length?!1:!0).attr("transform","translate("+o.range()[0]+",0)"),P.select(".nv-y2.nv-axis").classed("nv-disabled",M.length?!1:!0).attr("transform","translate("+o.range()[1]+",0)"),A.dispatch.on("stateChange",function(){b.update()}),r.dispatch.on("elementMouseover.tooltip",k),s.dispatch.on("elementMouseover.tooltip",k),r.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),s.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),v.dispatch.on("elementMouseover.tooltip",l),w.dispatch.on("elementMouseover.tooltip",l),v.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),w.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),t.dispatch.on("elementMouseover.tooltip",n),u.dispatch.on("elementMouseover.tooltip",n),t.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),u.dispatch.on("elementMouseout.tooltip",function(){B.hidden(!0)}),t.dispatch.on("elementMousemove.tooltip",function(){B.position({top:d3.event.pageY,left:d3.event.pageX})()}),u.dispatch.on("elementMousemove.tooltip",function(){B.position({top:d3.event.pageY,left:d3.event.pageX})()})}),b}var c,d,e={top:30,right:20,bottom:50,left:60},f=a.utils.defaultColor(),g=null,h=null,i=!0,j=null,k=function(a){return a.x},l=function(a){return a.y},m="monotone",n=!0,o=d3.scale.linear(),p=d3.scale.linear(),q=d3.scale.linear(),r=a.models.line().yScale(p),s=a.models.line().yScale(q),t=a.models.multiBar().stacked(!1).yScale(p),u=a.models.multiBar().stacked(!1).yScale(q),v=a.models.stackedArea().yScale(p),w=a.models.stackedArea().yScale(q),x=a.models.axis().scale(o).orient("bottom").tickPadding(5),y=a.models.axis().scale(p).orient("left"),z=a.models.axis().scale(q).orient("right"),A=a.models.legend().height(30),B=a.models.tooltip(),C=d3.dispatch();return b.dispatch=C,b.lines1=r,b.lines2=s,b.bars1=t,b.bars2=u,b.stack1=v,b.stack2=w,b.xAxis=x,b.yAxis1=y,b.yAxis2=z,b.tooltip=B,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return g},set:function(a){g=a}},height:{get:function(){return h},set:function(a){h=a}},showLegend:{get:function(){return i},set:function(a){i=a}},yDomain1:{get:function(){return c},set:function(a){c=a}},yDomain2:{get:function(){return d},set:function(a){d=a}},noData:{get:function(){return j},set:function(a){j=a}},interpolate:{get:function(){return m},set:function(a){m=a}},tooltips:{get:function(){return B.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),B.enabled(!!b)}},tooltipContent:{get:function(){return B.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),B.contentGenerator(b)}},margin:{get:function(){return e},set:function(a){e.top=void 0!==a.top?a.top:e.top,e.right=void 0!==a.right?a.right:e.right,e.bottom=void 0!==a.bottom?a.bottom:e.bottom,e.left=void 0!==a.left?a.left:e.left}},color:{get:function(){return f},set:function(b){f=a.utils.getColor(b)}},x:{get:function(){return k},set:function(a){k=a,r.x(a),s.x(a),t.x(a),u.x(a),v.x(a),w.x(a)}},y:{get:function(){return l},set:function(a){l=a,r.y(a),s.y(a),v.y(a),w.y(a),t.y(a),u.y(a)}},useVoronoi:{get:function(){return n},set:function(a){n=a,r.useVoronoi(a),s.useVoronoi(a),v.useVoronoi(a),w.useVoronoi(a)}}}),a.utils.initOptions(b),b},a.models.ohlcBar=function(){"use strict";function b(y){return y.each(function(b){k=d3.select(this);var y=a.utils.availableWidth(h,k,g),A=a.utils.availableHeight(i,k,g);a.utils.initSVG(k);var B=y/b[0].values.length*.9;l.domain(c||d3.extent(b[0].values.map(n).concat(t))),l.range(v?e||[.5*y/b[0].values.length,y*(b[0].values.length-.5)/b[0].values.length]:e||[5+B/2,y-B/2-5]),m.domain(d||[d3.min(b[0].values.map(s).concat(u)),d3.max(b[0].values.map(r).concat(u))]).range(f||[A,0]),l.domain()[0]===l.domain()[1]&&l.domain(l.domain()[0]?[l.domain()[0]-.01*l.domain()[0],l.domain()[1]+.01*l.domain()[1]]:[-1,1]),m.domain()[0]===m.domain()[1]&&m.domain(m.domain()[0]?[m.domain()[0]+.01*m.domain()[0],m.domain()[1]-.01*m.domain()[1]]:[-1,1]);var C=d3.select(this).selectAll("g.nv-wrap.nv-ohlcBar").data([b[0].values]),D=C.enter().append("g").attr("class","nvd3 nv-wrap nv-ohlcBar"),E=D.append("defs"),F=D.append("g"),G=C.select("g");F.append("g").attr("class","nv-ticks"),C.attr("transform","translate("+g.left+","+g.top+")"),k.on("click",function(a,b){z.chartClick({data:a,index:b,pos:d3.event,id:j})}),E.append("clipPath").attr("id","nv-chart-clip-path-"+j).append("rect"),C.select("#nv-chart-clip-path-"+j+" rect").attr("width",y).attr("height",A),G.attr("clip-path",w?"url(#nv-chart-clip-path-"+j+")":"");var H=C.select(".nv-ticks").selectAll(".nv-tick").data(function(a){return a});H.exit().remove(),H.enter().append("path").attr("class",function(a,b,c){return(p(a,b)>q(a,b)?"nv-tick negative":"nv-tick positive")+" nv-tick-"+c+"-"+b}).attr("d",function(a,b){return"m0,0l0,"+(m(p(a,b))-m(r(a,b)))+"l"+-B/2+",0l"+B/2+",0l0,"+(m(s(a,b))-m(p(a,b)))+"l0,"+(m(q(a,b))-m(s(a,b)))+"l"+B/2+",0l"+-B/2+",0z"}).attr("transform",function(a,b){return"translate("+l(n(a,b))+","+m(r(a,b))+")"}).attr("fill",function(){return x[0]}).attr("stroke",function(){return x[0]}).attr("x",0).attr("y",function(a,b){return m(Math.max(0,o(a,b)))}).attr("height",function(a,b){return Math.abs(m(o(a,b))-m(0))}),H.attr("class",function(a,b,c){return(p(a,b)>q(a,b)?"nv-tick negative":"nv-tick positive")+" nv-tick-"+c+"-"+b}),d3.transition(H).attr("transform",function(a,b){return"translate("+l(n(a,b))+","+m(r(a,b))+")"}).attr("d",function(a,c){var d=y/b[0].values.length*.9;return"m0,0l0,"+(m(p(a,c))-m(r(a,c)))+"l"+-d/2+",0l"+d/2+",0l0,"+(m(s(a,c))-m(p(a,c)))+"l0,"+(m(q(a,c))-m(s(a,c)))+"l"+d/2+",0l"+-d/2+",0z"})}),b}var c,d,e,f,g={top:0,right:0,bottom:0,left:0},h=null,i=null,j=Math.floor(1e4*Math.random()),k=null,l=d3.scale.linear(),m=d3.scale.linear(),n=function(a){return a.x},o=function(a){return a.y},p=function(a){return a.open},q=function(a){return a.close},r=function(a){return a.high},s=function(a){return a.low},t=[],u=[],v=!1,w=!0,x=a.utils.defaultColor(),y=!1,z=d3.dispatch("tooltipShow","tooltipHide","stateChange","changeState","renderEnd","chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove");return b.highlightPoint=function(a,c){b.clearHighlights(),k.select(".nv-ohlcBar .nv-tick-0-"+a).classed("hover",c)},b.clearHighlights=function(){k.select(".nv-ohlcBar .nv-tick.hover").classed("hover",!1)},b.dispatch=z,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return h},set:function(a){h=a}},height:{get:function(){return i},set:function(a){i=a}},xScale:{get:function(){return l},set:function(a){l=a}},yScale:{get:function(){return m},set:function(a){m=a}},xDomain:{get:function(){return c},set:function(a){c=a}},yDomain:{get:function(){return d},set:function(a){d=a}},xRange:{get:function(){return e},set:function(a){e=a}},yRange:{get:function(){return f},set:function(a){f=a}},forceX:{get:function(){return t},set:function(a){t=a}},forceY:{get:function(){return u},set:function(a){u=a}},padData:{get:function(){return v},set:function(a){v=a}},clipEdge:{get:function(){return w},set:function(a){w=a}},id:{get:function(){return j},set:function(a){j=a}},interactive:{get:function(){return y},set:function(a){y=a}},x:{get:function(){return n},set:function(a){n=a}},y:{get:function(){return o},set:function(a){o=a}},open:{get:function(){return p()},set:function(a){p=a}},close:{get:function(){return q()},set:function(a){q=a}},high:{get:function(){return r},set:function(a){r=a}},low:{get:function(){return s},set:function(a){s=a}},margin:{get:function(){return g},set:function(a){g.top=void 0!=a.top?a.top:g.top,g.right=void 0!=a.right?a.right:g.right,g.bottom=void 0!=a.bottom?a.bottom:g.bottom,g.left=void 0!=a.left?a.left:g.left
}},color:{get:function(){return x},set:function(b){x=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.parallelCoordinates=function(){"use strict";function b(p){return p.each(function(b){function p(a){return F(h.map(function(b){if(isNaN(a[b])||isNaN(parseFloat(a[b]))){var c=g[b].domain(),d=g[b].range(),e=c[0]-(c[1]-c[0])/9;if(J.indexOf(b)<0){var h=d3.scale.linear().domain([e,c[1]]).range([x-12,d[1]]);g[b].brush.y(h),J.push(b)}return[f(b),g[b](e)]}return J.length>0?(D.style("display","inline"),E.style("display","inline")):(D.style("display","none"),E.style("display","none")),[f(b),g[b](a[b])]}))}function q(){var a=h.filter(function(a){return!g[a].brush.empty()}),b=a.map(function(a){return g[a].brush.extent()});k=[],a.forEach(function(a,c){k[c]={dimension:a,extent:b[c]}}),l=[],M.style("display",function(c){var d=a.every(function(a,d){return isNaN(c[a])&&b[d][0]==g[a].brush.y().domain()[0]?!0:b[d][0]<=c[a]&&c[a]<=b[d][1]});return d&&l.push(c),d?null:"none"}),o.brush({filters:k,active:l})}function r(a){m[a]=this.parentNode.__origin__=f(a),L.attr("visibility","hidden")}function s(a){m[a]=Math.min(w,Math.max(0,this.parentNode.__origin__+=d3.event.x)),M.attr("d",p),h.sort(function(a,b){return u(a)-u(b)}),f.domain(h),N.attr("transform",function(a){return"translate("+u(a)+")"})}function t(a){delete this.parentNode.__origin__,delete m[a],d3.select(this.parentNode).attr("transform","translate("+f(a)+")"),M.attr("d",p),L.attr("d",p).attr("visibility",null)}function u(a){var b=m[a];return null==b?f(a):b}var v=d3.select(this),w=a.utils.availableWidth(d,v,c),x=a.utils.availableHeight(e,v,c);a.utils.initSVG(v),l=b,f.rangePoints([0,w],1).domain(h);var y={};h.forEach(function(a){var c=d3.extent(b,function(b){return+b[a]});return y[a]=!1,void 0===c[0]&&(y[a]=!0,c[0]=0,c[1]=0),c[0]===c[1]&&(c[0]=c[0]-1,c[1]=c[1]+1),g[a]=d3.scale.linear().domain(c).range([.9*(x-12),0]),g[a].brush=d3.svg.brush().y(g[a]).on("brush",q),"name"!=a});var z=v.selectAll("g.nv-wrap.nv-parallelCoordinates").data([b]),A=z.enter().append("g").attr("class","nvd3 nv-wrap nv-parallelCoordinates"),B=A.append("g"),C=z.select("g");B.append("g").attr("class","nv-parallelCoordinates background"),B.append("g").attr("class","nv-parallelCoordinates foreground"),B.append("g").attr("class","nv-parallelCoordinates missingValuesline"),z.attr("transform","translate("+c.left+","+c.top+")");var D,E,F=d3.svg.line().interpolate("cardinal").tension(n),G=d3.svg.axis().orient("left"),H=d3.behavior.drag().on("dragstart",r).on("drag",s).on("dragend",t),I=f.range()[1]-f.range()[0],J=[],K=[0+I/2,x-12,w-I/2,x-12];D=z.select(".missingValuesline").selectAll("line").data([K]),D.enter().append("line"),D.exit().remove(),D.attr("x1",function(a){return a[0]}).attr("y1",function(a){return a[1]}).attr("x2",function(a){return a[2]}).attr("y2",function(a){return a[3]}),E=z.select(".missingValuesline").selectAll("text").data(["undefined values"]),E.append("text").data(["undefined values"]),E.enter().append("text"),E.exit().remove(),E.attr("y",x).attr("x",w-92-I/2).text(function(a){return a});var L=z.select(".background").selectAll("path").data(b);L.enter().append("path"),L.exit().remove(),L.attr("d",p);var M=z.select(".foreground").selectAll("path").data(b);M.enter().append("path"),M.exit().remove(),M.attr("d",p).attr("stroke",j),M.on("mouseover",function(a,b){d3.select(this).classed("hover",!0),o.elementMouseover({label:a.name,data:a.data,index:b,pos:[d3.mouse(this.parentNode)[0],d3.mouse(this.parentNode)[1]]})}),M.on("mouseout",function(a,b){d3.select(this).classed("hover",!1),o.elementMouseout({label:a.name,data:a.data,index:b})});var N=C.selectAll(".dimension").data(h),O=N.enter().append("g").attr("class","nv-parallelCoordinates dimension");O.append("g").attr("class","nv-parallelCoordinates nv-axis"),O.append("g").attr("class","nv-parallelCoordinates-brush"),O.append("text").attr("class","nv-parallelCoordinates nv-label"),N.attr("transform",function(a){return"translate("+f(a)+",0)"}),N.exit().remove(),N.select(".nv-label").style("cursor","move").attr("dy","-1em").attr("text-anchor","middle").text(String).on("mouseover",function(a){o.elementMouseover({dim:a,pos:[d3.mouse(this.parentNode.parentNode)[0],d3.mouse(this.parentNode.parentNode)[1]]})}).on("mouseout",function(a){o.elementMouseout({dim:a})}).call(H),N.select(".nv-axis").each(function(a,b){d3.select(this).call(G.scale(g[a]).tickFormat(d3.format(i[b])))}),N.select(".nv-parallelCoordinates-brush").each(function(a){d3.select(this).call(g[a].brush)}).selectAll("rect").attr("x",-8).attr("width",16)}),b}var c={top:30,right:0,bottom:10,left:0},d=null,e=null,f=d3.scale.ordinal(),g={},h=[],i=[],j=a.utils.defaultColor(),k=[],l=[],m=[],n=1,o=d3.dispatch("brush","elementMouseover","elementMouseout");return b.dispatch=o,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return d},set:function(a){d=a}},height:{get:function(){return e},set:function(a){e=a}},dimensionNames:{get:function(){return h},set:function(a){h=a}},dimensionFormats:{get:function(){return i},set:function(a){i=a}},lineTension:{get:function(){return n},set:function(a){n=a}},dimensions:{get:function(){return h},set:function(b){a.deprecated("dimensions","use dimensionNames instead"),h=b}},margin:{get:function(){return c},set:function(a){c.top=void 0!==a.top?a.top:c.top,c.right=void 0!==a.right?a.right:c.right,c.bottom=void 0!==a.bottom?a.bottom:c.bottom,c.left=void 0!==a.left?a.left:c.left}},color:{get:function(){return j},set:function(b){j=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.pie=function(){"use strict";function b(E){return D.reset(),E.each(function(b){function E(a,b){a.endAngle=isNaN(a.endAngle)?0:a.endAngle,a.startAngle=isNaN(a.startAngle)?0:a.startAngle,p||(a.innerRadius=0);var c=d3.interpolate(this._current,a);return this._current=c(0),function(a){return B[b](c(a))}}var F=d-c.left-c.right,G=e-c.top-c.bottom,H=Math.min(F,G)/2,I=[],J=[];if(i=d3.select(this),0===z.length)for(var K=H-H/5,L=y*H,M=0;M<b[0].length;M++)I.push(K),J.push(L);else I=z.map(function(a){return(a.outer-a.outer/5)*H}),J=z.map(function(a){return(a.inner-a.inner/5)*H}),y=d3.min(z.map(function(a){return a.inner-a.inner/5}));a.utils.initSVG(i);var N=i.selectAll(".nv-wrap.nv-pie").data(b),O=N.enter().append("g").attr("class","nvd3 nv-wrap nv-pie nv-chart-"+h),P=O.append("g"),Q=N.select("g"),R=P.append("g").attr("class","nv-pie");P.append("g").attr("class","nv-pieLabels"),N.attr("transform","translate("+c.left+","+c.top+")"),Q.select(".nv-pie").attr("transform","translate("+F/2+","+G/2+")"),Q.select(".nv-pieLabels").attr("transform","translate("+F/2+","+G/2+")"),i.on("click",function(a,b){A.chartClick({data:a,index:b,pos:d3.event,id:h})}),B=[],C=[];for(var M=0;M<b[0].length;M++){var S=d3.svg.arc().outerRadius(I[M]),T=d3.svg.arc().outerRadius(I[M]+5);u!==!1&&(S.startAngle(u),T.startAngle(u)),w!==!1&&(S.endAngle(w),T.endAngle(w)),p&&(S.innerRadius(J[M]),T.innerRadius(J[M])),S.cornerRadius&&x&&(S.cornerRadius(x),T.cornerRadius(x)),B.push(S),C.push(T)}var U=d3.layout.pie().sort(null).value(function(a){return a.disabled?0:g(a)});U.padAngle&&v&&U.padAngle(v),p&&q&&(R.append("text").attr("class","nv-pie-title"),N.select(".nv-pie-title").style("text-anchor","middle").text(function(){return q}).style("font-size",Math.min(F,G)*y*2/(q.length+2)+"px").attr("dy","0.35em").attr("transform",function(){return"translate(0, "+s+")"}));var V=N.select(".nv-pie").selectAll(".nv-slice").data(U),W=N.select(".nv-pieLabels").selectAll(".nv-label").data(U);V.exit().remove(),W.exit().remove();var X=V.enter().append("g");X.attr("class","nv-slice"),X.on("mouseover",function(a,b){d3.select(this).classed("hover",!0),r&&d3.select(this).select("path").transition().duration(70).attr("d",C[b]),A.elementMouseover({data:a.data,index:b,color:d3.select(this).style("fill")})}),X.on("mouseout",function(a,b){d3.select(this).classed("hover",!1),r&&d3.select(this).select("path").transition().duration(50).attr("d",B[b]),A.elementMouseout({data:a.data,index:b})}),X.on("mousemove",function(a,b){A.elementMousemove({data:a.data,index:b})}),X.on("click",function(a,b){A.elementClick({data:a.data,index:b,color:d3.select(this).style("fill")})}),X.on("dblclick",function(a,b){A.elementDblClick({data:a.data,index:b,color:d3.select(this).style("fill")})}),V.attr("fill",function(a,b){return j(a.data,b)}),V.attr("stroke",function(a,b){return j(a.data,b)});X.append("path").each(function(a){this._current=a});if(V.select("path").transition().attr("d",function(a,b){return B[b](a)}).attrTween("d",E),l){for(var Y=[],M=0;M<b[0].length;M++)Y.push(B[M]),m?p&&(Y[M]=d3.svg.arc().outerRadius(B[M].outerRadius()),u!==!1&&Y[M].startAngle(u),w!==!1&&Y[M].endAngle(w)):p||Y[M].innerRadius(0);W.enter().append("g").classed("nv-label",!0).each(function(a){var b=d3.select(this);b.attr("transform",function(a,b){if(t){a.outerRadius=I[b]+10,a.innerRadius=I[b]+15;var c=(a.startAngle+a.endAngle)/2*(180/Math.PI);return(a.startAngle+a.endAngle)/2<Math.PI?c-=90:c+=90,"translate("+Y[b].centroid(a)+") rotate("+c+")"}return a.outerRadius=H+10,a.innerRadius=H+15,"translate("+Y[b].centroid(a)+")"}),b.append("rect").style("stroke","#fff").style("fill","#fff").attr("rx",3).attr("ry",3),b.append("text").style("text-anchor",t?(a.startAngle+a.endAngle)/2<Math.PI?"start":"end":"middle").style("fill","#000")});var Z={},$=14,_=140,ab=function(a){return Math.floor(a[0]/_)*_+","+Math.floor(a[1]/$)*$};W.watchTransition(D,"pie labels").attr("transform",function(a,b){if(t){a.outerRadius=I[b]+10,a.innerRadius=I[b]+15;var c=(a.startAngle+a.endAngle)/2*(180/Math.PI);return(a.startAngle+a.endAngle)/2<Math.PI?c-=90:c+=90,"translate("+Y[b].centroid(a)+") rotate("+c+")"}a.outerRadius=H+10,a.innerRadius=H+15;var d=Y[b].centroid(a);if(a.value){var e=ab(d);Z[e]&&(d[1]-=$),Z[ab(d)]=!0}return"translate("+d+")"}),W.select(".nv-label text").style("text-anchor",function(a){return t?(a.startAngle+a.endAngle)/2<Math.PI?"start":"end":"middle"}).text(function(a,b){var c=(a.endAngle-a.startAngle)/(2*Math.PI),d="";if(!a.value||o>c)return"";if("function"==typeof n)d=n(a,b,{key:f(a.data),value:g(a.data),percent:k(c)});else switch(n){case"key":d=f(a.data);break;case"value":d=k(g(a.data));break;case"percent":d=d3.format("%")(c)}return d})}}),D.renderEnd("pie immediate"),b}var c={top:0,right:0,bottom:0,left:0},d=500,e=500,f=function(a){return a.x},g=function(a){return a.y},h=Math.floor(1e4*Math.random()),i=null,j=a.utils.defaultColor(),k=d3.format(",.2f"),l=!0,m=!1,n="key",o=.02,p=!1,q=!1,r=!0,s=0,t=!1,u=!1,v=!1,w=!1,x=0,y=.5,z=[],A=d3.dispatch("chartClick","elementClick","elementDblClick","elementMouseover","elementMouseout","elementMousemove","renderEnd"),B=[],C=[],D=a.utils.renderWatch(A);return b.dispatch=A,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{arcsRadius:{get:function(){return z},set:function(a){z=a}},width:{get:function(){return d},set:function(a){d=a}},height:{get:function(){return e},set:function(a){e=a}},showLabels:{get:function(){return l},set:function(a){l=a}},title:{get:function(){return q},set:function(a){q=a}},titleOffset:{get:function(){return s},set:function(a){s=a}},labelThreshold:{get:function(){return o},set:function(a){o=a}},valueFormat:{get:function(){return k},set:function(a){k=a}},x:{get:function(){return f},set:function(a){f=a}},id:{get:function(){return h},set:function(a){h=a}},endAngle:{get:function(){return w},set:function(a){w=a}},startAngle:{get:function(){return u},set:function(a){u=a}},padAngle:{get:function(){return v},set:function(a){v=a}},cornerRadius:{get:function(){return x},set:function(a){x=a}},donutRatio:{get:function(){return y},set:function(a){y=a}},labelsOutside:{get:function(){return m},set:function(a){m=a}},labelSunbeamLayout:{get:function(){return t},set:function(a){t=a}},donut:{get:function(){return p},set:function(a){p=a}},growOnHover:{get:function(){return r},set:function(a){r=a}},pieLabelsOutside:{get:function(){return m},set:function(b){m=b,a.deprecated("pieLabelsOutside","use labelsOutside instead")}},donutLabelsOutside:{get:function(){return m},set:function(b){m=b,a.deprecated("donutLabelsOutside","use labelsOutside instead")}},labelFormat:{get:function(){return k},set:function(b){k=b,a.deprecated("labelFormat","use valueFormat instead")}},margin:{get:function(){return c},set:function(a){c.top="undefined"!=typeof a.top?a.top:c.top,c.right="undefined"!=typeof a.right?a.right:c.right,c.bottom="undefined"!=typeof a.bottom?a.bottom:c.bottom,c.left="undefined"!=typeof a.left?a.left:c.left}},y:{get:function(){return g},set:function(a){g=d3.functor(a)}},color:{get:function(){return j},set:function(b){j=a.utils.getColor(b)}},labelType:{get:function(){return n},set:function(a){n=a||"key"}}}),a.utils.initOptions(b),b},a.models.pieChart=function(){"use strict";function b(e){return q.reset(),q.models(c),e.each(function(e){var k=d3.select(this);a.utils.initSVG(k);var n=a.utils.availableWidth(g,k,f),o=a.utils.availableHeight(h,k,f);if(b.update=function(){k.transition().call(b)},b.container=this,l.setter(s(e),b.update).getter(r(e)).update(),l.disabled=e.map(function(a){return!!a.disabled}),!m){var q;m={};for(q in l)m[q]=l[q]instanceof Array?l[q].slice(0):l[q]}if(!e||!e.length)return a.utils.noData(b,k),b;k.selectAll(".nv-noData").remove();var t=k.selectAll("g.nv-wrap.nv-pieChart").data([e]),u=t.enter().append("g").attr("class","nvd3 nv-wrap nv-pieChart").append("g"),v=t.select("g");if(u.append("g").attr("class","nv-pieWrap"),u.append("g").attr("class","nv-legendWrap"),i)if("top"===j)d.width(n).key(c.x()),t.select(".nv-legendWrap").datum(e).call(d),f.top!=d.height()&&(f.top=d.height(),o=a.utils.availableHeight(h,k,f)),t.select(".nv-legendWrap").attr("transform","translate(0,"+-f.top+")");else if("right"===j){var w=a.models.legend().width();w>n/2&&(w=n/2),d.height(o).key(c.x()),d.width(w),n-=d.width(),t.select(".nv-legendWrap").datum(e).call(d).attr("transform","translate("+n+",0)")}t.attr("transform","translate("+f.left+","+f.top+")"),c.width(n).height(o);var x=v.select(".nv-pieWrap").datum([e]);d3.transition(x).call(c),d.dispatch.on("stateChange",function(a){for(var c in a)l[c]=a[c];p.stateChange(l),b.update()}),p.on("changeState",function(a){"undefined"!=typeof a.disabled&&(e.forEach(function(b,c){b.disabled=a.disabled[c]}),l.disabled=a.disabled),b.update()})}),q.renderEnd("pieChart immediate"),b}var c=a.models.pie(),d=a.models.legend(),e=a.models.tooltip(),f={top:30,right:20,bottom:20,left:20},g=null,h=null,i=!0,j="top",k=a.utils.defaultColor(),l=a.utils.state(),m=null,n=null,o=250,p=d3.dispatch("tooltipShow","tooltipHide","stateChange","changeState","renderEnd");e.headerEnabled(!1).duration(0).valueFormatter(function(a,b){return c.valueFormat()(a,b)});var q=a.utils.renderWatch(p),r=function(a){return function(){return{active:a.map(function(a){return!a.disabled})}}},s=function(a){return function(b){void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return c.dispatch.on("elementMouseover.tooltip",function(a){a.series={key:b.x()(a.data),value:b.y()(a.data),color:a.color},e.data(a).hidden(!1)}),c.dispatch.on("elementMouseout.tooltip",function(){e.hidden(!0)}),c.dispatch.on("elementMousemove.tooltip",function(){e.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.legend=d,b.dispatch=p,b.pie=c,b.tooltip=e,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{noData:{get:function(){return n},set:function(a){n=a}},showLegend:{get:function(){return i},set:function(a){i=a}},legendPosition:{get:function(){return j},set:function(a){j=a}},defaultState:{get:function(){return m},set:function(a){m=a}},tooltips:{get:function(){return e.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),e.enabled(!!b)}},tooltipContent:{get:function(){return e.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),e.contentGenerator(b)}},color:{get:function(){return k},set:function(a){k=a,d.color(k),c.color(k)}},duration:{get:function(){return o},set:function(a){o=a,q.reset(o)}},margin:{get:function(){return f},set:function(a){f.top=void 0!==a.top?a.top:f.top,f.right=void 0!==a.right?a.right:f.right,f.bottom=void 0!==a.bottom?a.bottom:f.bottom,f.left=void 0!==a.left?a.left:f.left}}}),a.utils.inheritOptions(b,c),a.utils.initOptions(b),b},a.models.scatter=function(){"use strict";function b(N){return P.reset(),N.each(function(b){function N(){if(O=!1,!w)return!1;if(M===!0){var a=d3.merge(b.map(function(a,b){return a.values.map(function(a,c){var d=p(a,c),e=q(a,c);return[m(d)+1e-4*Math.random(),n(e)+1e-4*Math.random(),b,c,a]}).filter(function(a,b){return x(a[4],b)})}));if(0==a.length)return!1;a.length<3&&(a.push([m.range()[0]-20,n.range()[0]-20,null,null]),a.push([m.range()[1]+20,n.range()[1]+20,null,null]),a.push([m.range()[0]-20,n.range()[0]+20,null,null]),a.push([m.range()[1]+20,n.range()[1]-20,null,null]));var c=d3.geom.polygon([[-10,-10],[-10,i+10],[h+10,i+10],[h+10,-10]]),d=d3.geom.voronoi(a).map(function(b,d){return{data:c.clip(b),series:a[d][2],point:a[d][3]}});U.select(".nv-point-paths").selectAll("path").remove();var e=U.select(".nv-point-paths").selectAll("path").data(d),f=e.enter().append("svg:path").attr("d",function(a){return a&&a.data&&0!==a.data.length?"M"+a.data.join(",")+"Z":"M 0 0"}).attr("id",function(a,b){return"nv-path-"+b}).attr("clip-path",function(a,b){return"url(#nv-clip-"+b+")"});C&&f.style("fill",d3.rgb(230,230,230)).style("fill-opacity",.4).style("stroke-opacity",1).style("stroke",d3.rgb(200,200,200)),B&&(U.select(".nv-point-clips").selectAll("clipPath").remove(),U.select(".nv-point-clips").selectAll("clipPath").data(a).enter().append("svg:clipPath").attr("id",function(a,b){return"nv-clip-"+b}).append("svg:circle").attr("cx",function(a){return a[0]}).attr("cy",function(a){return a[1]}).attr("r",D));var k=function(a,c){if(O)return 0;var d=b[a.series];if(void 0!==d){var e=d.values[a.point];e.color=j(d,a.series),e.x=p(e),e.y=q(e);var f=l.node().getBoundingClientRect(),h=window.pageYOffset||document.documentElement.scrollTop,i=window.pageXOffset||document.documentElement.scrollLeft,k={left:m(p(e,a.point))+f.left+i+g.left+10,top:n(q(e,a.point))+f.top+h+g.top+10};c({point:e,series:d,pos:k,seriesIndex:a.series,pointIndex:a.point})}};e.on("click",function(a){k(a,L.elementClick)}).on("dblclick",function(a){k(a,L.elementDblClick)}).on("mouseover",function(a){k(a,L.elementMouseover)}).on("mouseout",function(a){k(a,L.elementMouseout)})}else U.select(".nv-groups").selectAll(".nv-group").selectAll(".nv-point").on("click",function(a,c){if(O||!b[a.series])return 0;var d=b[a.series],e=d.values[c];L.elementClick({point:e,series:d,pos:[m(p(e,c))+g.left,n(q(e,c))+g.top],seriesIndex:a.series,pointIndex:c})}).on("dblclick",function(a,c){if(O||!b[a.series])return 0;var d=b[a.series],e=d.values[c];L.elementDblClick({point:e,series:d,pos:[m(p(e,c))+g.left,n(q(e,c))+g.top],seriesIndex:a.series,pointIndex:c})}).on("mouseover",function(a,c){if(O||!b[a.series])return 0;var d=b[a.series],e=d.values[c];L.elementMouseover({point:e,series:d,pos:[m(p(e,c))+g.left,n(q(e,c))+g.top],seriesIndex:a.series,pointIndex:c,color:j(a,c)})}).on("mouseout",function(a,c){if(O||!b[a.series])return 0;var d=b[a.series],e=d.values[c];L.elementMouseout({point:e,series:d,seriesIndex:a.series,pointIndex:c,color:j(a,c)})})}l=d3.select(this);var R=a.utils.availableWidth(h,l,g),S=a.utils.availableHeight(i,l,g);a.utils.initSVG(l),b.forEach(function(a,b){a.values.forEach(function(a){a.series=b})});var T=E&&F&&I?[]:d3.merge(b.map(function(a){return a.values.map(function(a,b){return{x:p(a,b),y:q(a,b),size:r(a,b)}})}));m.domain(E||d3.extent(T.map(function(a){return a.x}).concat(t))),m.range(y&&b[0]?G||[(R*z+R)/(2*b[0].values.length),R-R*(1+z)/(2*b[0].values.length)]:G||[0,R]),n.domain(F||d3.extent(T.map(function(a){return a.y}).concat(u))).range(H||[S,0]),o.domain(I||d3.extent(T.map(function(a){return a.size}).concat(v))).range(J||Q),K=m.domain()[0]===m.domain()[1]||n.domain()[0]===n.domain()[1],m.domain()[0]===m.domain()[1]&&m.domain(m.domain()[0]?[m.domain()[0]-.01*m.domain()[0],m.domain()[1]+.01*m.domain()[1]]:[-1,1]),n.domain()[0]===n.domain()[1]&&n.domain(n.domain()[0]?[n.domain()[0]-.01*n.domain()[0],n.domain()[1]+.01*n.domain()[1]]:[-1,1]),isNaN(m.domain()[0])&&m.domain([-1,1]),isNaN(n.domain()[0])&&n.domain([-1,1]),c=c||m,d=d||n,e=e||o;var U=l.selectAll("g.nv-wrap.nv-scatter").data([b]),V=U.enter().append("g").attr("class","nvd3 nv-wrap nv-scatter nv-chart-"+k),W=V.append("defs"),X=V.append("g"),Y=U.select("g");U.classed("nv-single-point",K),X.append("g").attr("class","nv-groups"),X.append("g").attr("class","nv-point-paths"),V.append("g").attr("class","nv-point-clips"),U.attr("transform","translate("+g.left+","+g.top+")"),W.append("clipPath").attr("id","nv-edge-clip-"+k).append("rect"),U.select("#nv-edge-clip-"+k+" rect").attr("width",R).attr("height",S>0?S:0),Y.attr("clip-path",A?"url(#nv-edge-clip-"+k+")":""),O=!0;var Z=U.select(".nv-groups").selectAll(".nv-group").data(function(a){return a},function(a){return a.key});Z.enter().append("g").style("stroke-opacity",1e-6).style("fill-opacity",1e-6),Z.exit().remove(),Z.attr("class",function(a,b){return"nv-group nv-series-"+b}).classed("hover",function(a){return a.hover}),Z.watchTransition(P,"scatter: groups").style("fill",function(a,b){return j(a,b)}).style("stroke",function(a,b){return j(a,b)}).style("stroke-opacity",1).style("fill-opacity",.5);var $=Z.selectAll("path.nv-point").data(function(a){return a.values.map(function(a,b){return[a,b]}).filter(function(a,b){return x(a[0],b)})});$.enter().append("path").style("fill",function(a){return a.color}).style("stroke",function(a){return a.color}).attr("transform",function(a){return"translate("+c(p(a[0],a[1]))+","+d(q(a[0],a[1]))+")"}).attr("d",a.utils.symbol().type(function(a){return s(a[0])}).size(function(a){return o(r(a[0],a[1]))})),$.exit().remove(),Z.exit().selectAll("path.nv-point").watchTransition(P,"scatter exit").attr("transform",function(a){return"translate("+m(p(a[0],a[1]))+","+n(q(a[0],a[1]))+")"}).remove(),$.each(function(a){d3.select(this).classed("nv-point",!0).classed("nv-point-"+a[1],!0).classed("nv-noninteractive",!w).classed("hover",!1)}),$.watchTransition(P,"scatter points").attr("transform",function(a){return"translate("+m(p(a[0],a[1]))+","+n(q(a[0],a[1]))+")"}).attr("d",a.utils.symbol().type(function(a){return s(a[0])}).size(function(a){return o(r(a[0],a[1]))})),clearTimeout(f),f=setTimeout(N,300),c=m.copy(),d=n.copy(),e=o.copy()}),P.renderEnd("scatter immediate"),b}var c,d,e,f,g={top:0,right:0,bottom:0,left:0},h=null,i=null,j=a.utils.defaultColor(),k=Math.floor(1e5*Math.random()),l=null,m=d3.scale.linear(),n=d3.scale.linear(),o=d3.scale.linear(),p=function(a){return a.x},q=function(a){return a.y},r=function(a){return a.size||1},s=function(a){return a.shape||"circle"},t=[],u=[],v=[],w=!0,x=function(a){return!a.notActive},y=!1,z=.1,A=!1,B=!0,C=!1,D=function(){return 25},E=null,F=null,G=null,H=null,I=null,J=null,K=!1,L=d3.dispatch("elementClick","elementDblClick","elementMouseover","elementMouseout","renderEnd"),M=!0,N=250,O=!1,P=a.utils.renderWatch(L,N),Q=[16,256];return b.dispatch=L,b.options=a.utils.optionsFunc.bind(b),b._calls=new function(){this.clearHighlights=function(){return a.dom.write(function(){l.selectAll(".nv-point.hover").classed("hover",!1)}),null},this.highlightPoint=function(b,c,d){a.dom.write(function(){l.select(" .nv-series-"+b+" .nv-point-"+c).classed("hover",d)})}},L.on("elementMouseover.point",function(a){w&&b._calls.highlightPoint(a.seriesIndex,a.pointIndex,!0)}),L.on("elementMouseout.point",function(a){w&&b._calls.highlightPoint(a.seriesIndex,a.pointIndex,!1)}),b._options=Object.create({},{width:{get:function(){return h},set:function(a){h=a}},height:{get:function(){return i},set:function(a){i=a}},xScale:{get:function(){return m},set:function(a){m=a}},yScale:{get:function(){return n},set:function(a){n=a}},pointScale:{get:function(){return o},set:function(a){o=a}},xDomain:{get:function(){return E},set:function(a){E=a}},yDomain:{get:function(){return F},set:function(a){F=a}},pointDomain:{get:function(){return I},set:function(a){I=a}},xRange:{get:function(){return G},set:function(a){G=a}},yRange:{get:function(){return H},set:function(a){H=a}},pointRange:{get:function(){return J},set:function(a){J=a}},forceX:{get:function(){return t},set:function(a){t=a}},forceY:{get:function(){return u},set:function(a){u=a}},forcePoint:{get:function(){return v},set:function(a){v=a}},interactive:{get:function(){return w},set:function(a){w=a}},pointActive:{get:function(){return x},set:function(a){x=a}},padDataOuter:{get:function(){return z},set:function(a){z=a}},padData:{get:function(){return y},set:function(a){y=a}},clipEdge:{get:function(){return A},set:function(a){A=a}},clipVoronoi:{get:function(){return B},set:function(a){B=a}},clipRadius:{get:function(){return D},set:function(a){D=a}},showVoronoi:{get:function(){return C},set:function(a){C=a}},id:{get:function(){return k},set:function(a){k=a}},x:{get:function(){return p},set:function(a){p=d3.functor(a)}},y:{get:function(){return q},set:function(a){q=d3.functor(a)}},pointSize:{get:function(){return r},set:function(a){r=d3.functor(a)}},pointShape:{get:function(){return s},set:function(a){s=d3.functor(a)}},margin:{get:function(){return g},set:function(a){g.top=void 0!==a.top?a.top:g.top,g.right=void 0!==a.right?a.right:g.right,g.bottom=void 0!==a.bottom?a.bottom:g.bottom,g.left=void 0!==a.left?a.left:g.left}},duration:{get:function(){return N},set:function(a){N=a,P.reset(N)}},color:{get:function(){return j},set:function(b){j=a.utils.getColor(b)}},useVoronoi:{get:function(){return M},set:function(a){M=a,M===!1&&(B=!1)}}}),a.utils.initOptions(b),b},a.models.scatterChart=function(){"use strict";function b(z){return D.reset(),D.models(c),t&&D.models(d),u&&D.models(e),q&&D.models(g),r&&D.models(h),z.each(function(z){m=d3.select(this),a.utils.initSVG(m);var G=a.utils.availableWidth(k,m,j),H=a.utils.availableHeight(l,m,j);if(b.update=function(){0===A?m.call(b):m.transition().duration(A).call(b)},b.container=this,w.setter(F(z),b.update).getter(E(z)).update(),w.disabled=z.map(function(a){return!!a.disabled}),!x){var I;x={};for(I in w)x[I]=w[I]instanceof Array?w[I].slice(0):w[I]}if(!(z&&z.length&&z.filter(function(a){return a.values.length}).length))return a.utils.noData(b,m),D.renderEnd("scatter immediate"),b;m.selectAll(".nv-noData").remove(),o=c.xScale(),p=c.yScale();var J=m.selectAll("g.nv-wrap.nv-scatterChart").data([z]),K=J.enter().append("g").attr("class","nvd3 nv-wrap nv-scatterChart nv-chart-"+c.id()),L=K.append("g"),M=J.select("g");if(L.append("rect").attr("class","nvd3 nv-background").style("pointer-events","none"),L.append("g").attr("class","nv-x nv-axis"),L.append("g").attr("class","nv-y nv-axis"),L.append("g").attr("class","nv-scatterWrap"),L.append("g").attr("class","nv-regressionLinesWrap"),L.append("g").attr("class","nv-distWrap"),L.append("g").attr("class","nv-legendWrap"),v&&M.select(".nv-y.nv-axis").attr("transform","translate("+G+",0)"),s){var N=G;f.width(N),J.select(".nv-legendWrap").datum(z).call(f),j.top!=f.height()&&(j.top=f.height(),H=a.utils.availableHeight(l,m,j)),J.select(".nv-legendWrap").attr("transform","translate(0,"+-j.top+")")}J.attr("transform","translate("+j.left+","+j.top+")"),c.width(G).height(H).color(z.map(function(a,b){return a.color=a.color||n(a,b),a.color}).filter(function(a,b){return!z[b].disabled})),J.select(".nv-scatterWrap").datum(z.filter(function(a){return!a.disabled})).call(c),J.select(".nv-regressionLinesWrap").attr("clip-path","url(#nv-edge-clip-"+c.id()+")");var O=J.select(".nv-regressionLinesWrap").selectAll(".nv-regLines").data(function(a){return a});O.enter().append("g").attr("class","nv-regLines");var P=O.selectAll(".nv-regLine").data(function(a){return[a]});P.enter().append("line").attr("class","nv-regLine").style("stroke-opacity",0),P.filter(function(a){return a.intercept&&a.slope}).watchTransition(D,"scatterPlusLineChart: regline").attr("x1",o.range()[0]).attr("x2",o.range()[1]).attr("y1",function(a){return p(o.domain()[0]*a.slope+a.intercept)}).attr("y2",function(a){return p(o.domain()[1]*a.slope+a.intercept)}).style("stroke",function(a,b,c){return n(a,c)}).style("stroke-opacity",function(a){return a.disabled||"undefined"==typeof a.slope||"undefined"==typeof a.intercept?0:1}),t&&(d.scale(o)._ticks(a.utils.calcTicksX(G/100,z)).tickSize(-H,0),M.select(".nv-x.nv-axis").attr("transform","translate(0,"+p.range()[0]+")").call(d)),u&&(e.scale(p)._ticks(a.utils.calcTicksY(H/36,z)).tickSize(-G,0),M.select(".nv-y.nv-axis").call(e)),q&&(g.getData(c.x()).scale(o).width(G).color(z.map(function(a,b){return a.color||n(a,b)}).filter(function(a,b){return!z[b].disabled})),L.select(".nv-distWrap").append("g").attr("class","nv-distributionX"),M.select(".nv-distributionX").attr("transform","translate(0,"+p.range()[0]+")").datum(z.filter(function(a){return!a.disabled})).call(g)),r&&(h.getData(c.y()).scale(p).width(H).color(z.map(function(a,b){return a.color||n(a,b)}).filter(function(a,b){return!z[b].disabled})),L.select(".nv-distWrap").append("g").attr("class","nv-distributionY"),M.select(".nv-distributionY").attr("transform","translate("+(v?G:-h.size())+",0)").datum(z.filter(function(a){return!a.disabled})).call(h)),f.dispatch.on("stateChange",function(a){for(var c in a)w[c]=a[c];y.stateChange(w),b.update()}),y.on("changeState",function(a){"undefined"!=typeof a.disabled&&(z.forEach(function(b,c){b.disabled=a.disabled[c]}),w.disabled=a.disabled),b.update()}),c.dispatch.on("elementMouseout.tooltip",function(a){i.hidden(!0),m.select(".nv-chart-"+c.id()+" .nv-series-"+a.seriesIndex+" .nv-distx-"+a.pointIndex).attr("y1",0),m.select(".nv-chart-"+c.id()+" .nv-series-"+a.seriesIndex+" .nv-disty-"+a.pointIndex).attr("x2",h.size())}),c.dispatch.on("elementMouseover.tooltip",function(a){m.select(".nv-series-"+a.seriesIndex+" .nv-distx-"+a.pointIndex).attr("y1",a.pos.top-H-j.top),m.select(".nv-series-"+a.seriesIndex+" .nv-disty-"+a.pointIndex).attr("x2",a.pos.left+g.size()-j.left),i.position(a.pos).data(a).hidden(!1)}),B=o.copy(),C=p.copy()}),D.renderEnd("scatter with line immediate"),b}var c=a.models.scatter(),d=a.models.axis(),e=a.models.axis(),f=a.models.legend(),g=a.models.distribution(),h=a.models.distribution(),i=a.models.tooltip(),j={top:30,right:20,bottom:50,left:75},k=null,l=null,m=null,n=a.utils.defaultColor(),o=c.xScale(),p=c.yScale(),q=!1,r=!1,s=!0,t=!0,u=!0,v=!1,w=a.utils.state(),x=null,y=d3.dispatch("stateChange","changeState","renderEnd"),z=null,A=250;c.xScale(o).yScale(p),d.orient("bottom").tickPadding(10),e.orient(v?"right":"left").tickPadding(10),g.axis("x"),h.axis("y"),i.headerFormatter(function(a,b){return d.tickFormat()(a,b)}).valueFormatter(function(a,b){return e.tickFormat()(a,b)});var B,C,D=a.utils.renderWatch(y,A),E=function(a){return function(){return{active:a.map(function(a){return!a.disabled})}}},F=function(a){return function(b){void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}};return b.dispatch=y,b.scatter=c,b.legend=f,b.xAxis=d,b.yAxis=e,b.distX=g,b.distY=h,b.tooltip=i,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return k},set:function(a){k=a}},height:{get:function(){return l},set:function(a){l=a}},container:{get:function(){return m},set:function(a){m=a}},showDistX:{get:function(){return q},set:function(a){q=a}},showDistY:{get:function(){return r},set:function(a){r=a}},showLegend:{get:function(){return s},set:function(a){s=a}},showXAxis:{get:function(){return t},set:function(a){t=a}},showYAxis:{get:function(){return u},set:function(a){u=a}},defaultState:{get:function(){return x},set:function(a){x=a}},noData:{get:function(){return z},set:function(a){z=a}},duration:{get:function(){return A},set:function(a){A=a}},tooltips:{get:function(){return i.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),i.enabled(!!b)
}},tooltipContent:{get:function(){return i.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),i.contentGenerator(b)}},tooltipXContent:{get:function(){return i.contentGenerator()},set:function(){a.deprecated("tooltipContent","This option is removed, put values into main tooltip.")}},tooltipYContent:{get:function(){return i.contentGenerator()},set:function(){a.deprecated("tooltipContent","This option is removed, put values into main tooltip.")}},margin:{get:function(){return j},set:function(a){j.top=void 0!==a.top?a.top:j.top,j.right=void 0!==a.right?a.right:j.right,j.bottom=void 0!==a.bottom?a.bottom:j.bottom,j.left=void 0!==a.left?a.left:j.left}},rightAlignYAxis:{get:function(){return v},set:function(a){v=a,e.orient(a?"right":"left")}},color:{get:function(){return n},set:function(b){n=a.utils.getColor(b),f.color(n),g.color(n),h.color(n)}}}),a.utils.inheritOptions(b,c),a.utils.initOptions(b),b},a.models.sparkline=function(){"use strict";function b(k){return k.each(function(b){var k=h-g.left-g.right,q=i-g.top-g.bottom;j=d3.select(this),a.utils.initSVG(j),l.domain(c||d3.extent(b,n)).range(e||[0,k]),m.domain(d||d3.extent(b,o)).range(f||[q,0]);{var r=j.selectAll("g.nv-wrap.nv-sparkline").data([b]),s=r.enter().append("g").attr("class","nvd3 nv-wrap nv-sparkline");s.append("g"),r.select("g")}r.attr("transform","translate("+g.left+","+g.top+")");var t=r.selectAll("path").data(function(a){return[a]});t.enter().append("path"),t.exit().remove(),t.style("stroke",function(a,b){return a.color||p(a,b)}).attr("d",d3.svg.line().x(function(a,b){return l(n(a,b))}).y(function(a,b){return m(o(a,b))}));var u=r.selectAll("circle.nv-point").data(function(a){function b(b){if(-1!=b){var c=a[b];return c.pointIndex=b,c}return null}var c=a.map(function(a,b){return o(a,b)}),d=b(c.lastIndexOf(m.domain()[1])),e=b(c.indexOf(m.domain()[0])),f=b(c.length-1);return[e,d,f].filter(function(a){return null!=a})});u.enter().append("circle"),u.exit().remove(),u.attr("cx",function(a){return l(n(a,a.pointIndex))}).attr("cy",function(a){return m(o(a,a.pointIndex))}).attr("r",2).attr("class",function(a){return n(a,a.pointIndex)==l.domain()[1]?"nv-point nv-currentValue":o(a,a.pointIndex)==m.domain()[0]?"nv-point nv-minValue":"nv-point nv-maxValue"})}),b}var c,d,e,f,g={top:2,right:0,bottom:2,left:0},h=400,i=32,j=null,k=!0,l=d3.scale.linear(),m=d3.scale.linear(),n=function(a){return a.x},o=function(a){return a.y},p=a.utils.getColor(["#000"]);return b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return h},set:function(a){h=a}},height:{get:function(){return i},set:function(a){i=a}},xDomain:{get:function(){return c},set:function(a){c=a}},yDomain:{get:function(){return d},set:function(a){d=a}},xRange:{get:function(){return e},set:function(a){e=a}},yRange:{get:function(){return f},set:function(a){f=a}},xScale:{get:function(){return l},set:function(a){l=a}},yScale:{get:function(){return m},set:function(a){m=a}},animate:{get:function(){return k},set:function(a){k=a}},x:{get:function(){return n},set:function(a){n=d3.functor(a)}},y:{get:function(){return o},set:function(a){o=d3.functor(a)}},margin:{get:function(){return g},set:function(a){g.top=void 0!==a.top?a.top:g.top,g.right=void 0!==a.right?a.right:g.right,g.bottom=void 0!==a.bottom?a.bottom:g.bottom,g.left=void 0!==a.left?a.left:g.left}},color:{get:function(){return p},set:function(b){p=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.sparklinePlus=function(){"use strict";function b(p){return p.each(function(p){function q(){if(!j){var a=z.selectAll(".nv-hoverValue").data(i),b=a.enter().append("g").attr("class","nv-hoverValue").style("stroke-opacity",0).style("fill-opacity",0);a.exit().transition().duration(250).style("stroke-opacity",0).style("fill-opacity",0).remove(),a.attr("transform",function(a){return"translate("+c(e.x()(p[a],a))+",0)"}).transition().duration(250).style("stroke-opacity",1).style("fill-opacity",1),i.length&&(b.append("line").attr("x1",0).attr("y1",-f.top).attr("x2",0).attr("y2",u),b.append("text").attr("class","nv-xValue").attr("x",-6).attr("y",-f.top).attr("text-anchor","end").attr("dy",".9em"),z.select(".nv-hoverValue .nv-xValue").text(k(e.x()(p[i[0]],i[0]))),b.append("text").attr("class","nv-yValue").attr("x",6).attr("y",-f.top).attr("text-anchor","start").attr("dy",".9em"),z.select(".nv-hoverValue .nv-yValue").text(l(e.y()(p[i[0]],i[0]))))}}function r(){function a(a,b){for(var c=Math.abs(e.x()(a[0],0)-b),d=0,f=0;f<a.length;f++)Math.abs(e.x()(a[f],f)-b)<c&&(c=Math.abs(e.x()(a[f],f)-b),d=f);return d}if(!j){var b=d3.mouse(this)[0]-f.left;i=[a(p,Math.round(c.invert(b)))],q()}}var s=d3.select(this);a.utils.initSVG(s);var t=a.utils.availableWidth(g,s,f),u=a.utils.availableHeight(h,s,f);if(b.update=function(){s.call(b)},b.container=this,!p||!p.length)return a.utils.noData(b,s),b;s.selectAll(".nv-noData").remove();var v=e.y()(p[p.length-1],p.length-1);c=e.xScale(),d=e.yScale();var w=s.selectAll("g.nv-wrap.nv-sparklineplus").data([p]),x=w.enter().append("g").attr("class","nvd3 nv-wrap nv-sparklineplus"),y=x.append("g"),z=w.select("g");y.append("g").attr("class","nv-sparklineWrap"),y.append("g").attr("class","nv-valueWrap"),y.append("g").attr("class","nv-hoverArea"),w.attr("transform","translate("+f.left+","+f.top+")");var A=z.select(".nv-sparklineWrap");if(e.width(t).height(u),A.call(e),m){var B=z.select(".nv-valueWrap"),C=B.selectAll(".nv-currentValue").data([v]);C.enter().append("text").attr("class","nv-currentValue").attr("dx",o?-8:8).attr("dy",".9em").style("text-anchor",o?"end":"start"),C.attr("x",t+(o?f.right:0)).attr("y",n?function(a){return d(a)}:0).style("fill",e.color()(p[p.length-1],p.length-1)).text(l(v))}y.select(".nv-hoverArea").append("rect").on("mousemove",r).on("click",function(){j=!j}).on("mouseout",function(){i=[],q()}),z.select(".nv-hoverArea rect").attr("transform",function(){return"translate("+-f.left+","+-f.top+")"}).attr("width",t+f.left+f.right).attr("height",u+f.top)}),b}var c,d,e=a.models.sparkline(),f={top:15,right:100,bottom:10,left:50},g=null,h=null,i=[],j=!1,k=d3.format(",r"),l=d3.format(",.2f"),m=!0,n=!0,o=!1,p=null;return b.sparkline=e,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return g},set:function(a){g=a}},height:{get:function(){return h},set:function(a){h=a}},xTickFormat:{get:function(){return k},set:function(a){k=a}},yTickFormat:{get:function(){return l},set:function(a){l=a}},showLastValue:{get:function(){return m},set:function(a){m=a}},alignValue:{get:function(){return n},set:function(a){n=a}},rightAlignValue:{get:function(){return o},set:function(a){o=a}},noData:{get:function(){return p},set:function(a){p=a}},margin:{get:function(){return f},set:function(a){f.top=void 0!==a.top?a.top:f.top,f.right=void 0!==a.right?a.right:f.right,f.bottom=void 0!==a.bottom?a.bottom:f.bottom,f.left=void 0!==a.left?a.left:f.left}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.stackedArea=function(){"use strict";function b(m){return u.reset(),u.models(r),m.each(function(m){var s=f-e.left-e.right,v=g-e.top-e.bottom;j=d3.select(this),a.utils.initSVG(j),c=r.xScale(),d=r.yScale();var w=m;m.forEach(function(a,b){a.seriesIndex=b,a.values=a.values.map(function(a,c){return a.index=c,a.seriesIndex=b,a})});var x=m.filter(function(a){return!a.disabled});m=d3.layout.stack().order(o).offset(n).values(function(a){return a.values}).x(k).y(l).out(function(a,b,c){a.display={y:c,y0:b}})(x);var y=j.selectAll("g.nv-wrap.nv-stackedarea").data([m]),z=y.enter().append("g").attr("class","nvd3 nv-wrap nv-stackedarea"),A=z.append("defs"),B=z.append("g"),C=y.select("g");B.append("g").attr("class","nv-areaWrap"),B.append("g").attr("class","nv-scatterWrap"),y.attr("transform","translate("+e.left+","+e.top+")"),0==r.forceY().length&&r.forceY().push(0),r.width(s).height(v).x(k).y(function(a){return a.display.y+a.display.y0}).forceY([0]).color(m.map(function(a){return a.color||h(a,a.seriesIndex)}));var D=C.select(".nv-scatterWrap").datum(m);D.call(r),A.append("clipPath").attr("id","nv-edge-clip-"+i).append("rect"),y.select("#nv-edge-clip-"+i+" rect").attr("width",s).attr("height",v),C.attr("clip-path",q?"url(#nv-edge-clip-"+i+")":"");var E=d3.svg.area().x(function(a,b){return c(k(a,b))}).y0(function(a){return d(a.display.y0)}).y1(function(a){return d(a.display.y+a.display.y0)}).interpolate(p),F=d3.svg.area().x(function(a,b){return c(k(a,b))}).y0(function(a){return d(a.display.y0)}).y1(function(a){return d(a.display.y0)}),G=C.select(".nv-areaWrap").selectAll("path.nv-area").data(function(a){return a});G.enter().append("path").attr("class",function(a,b){return"nv-area nv-area-"+b}).attr("d",function(a){return F(a.values,a.seriesIndex)}).on("mouseover",function(a){d3.select(this).classed("hover",!0),t.areaMouseover({point:a,series:a.key,pos:[d3.event.pageX,d3.event.pageY],seriesIndex:a.seriesIndex})}).on("mouseout",function(a){d3.select(this).classed("hover",!1),t.areaMouseout({point:a,series:a.key,pos:[d3.event.pageX,d3.event.pageY],seriesIndex:a.seriesIndex})}).on("click",function(a){d3.select(this).classed("hover",!1),t.areaClick({point:a,series:a.key,pos:[d3.event.pageX,d3.event.pageY],seriesIndex:a.seriesIndex})}),G.exit().remove(),G.style("fill",function(a){return a.color||h(a,a.seriesIndex)}).style("stroke",function(a){return a.color||h(a,a.seriesIndex)}),G.watchTransition(u,"stackedArea path").attr("d",function(a,b){return E(a.values,b)}),r.dispatch.on("elementMouseover.area",function(a){C.select(".nv-chart-"+i+" .nv-area-"+a.seriesIndex).classed("hover",!0)}),r.dispatch.on("elementMouseout.area",function(a){C.select(".nv-chart-"+i+" .nv-area-"+a.seriesIndex).classed("hover",!1)}),b.d3_stackedOffset_stackPercent=function(a){var b,c,d,e=a.length,f=a[0].length,g=[];for(c=0;f>c;++c){for(b=0,d=0;b<w.length;b++)d+=l(w[b].values[c]);if(d)for(b=0;e>b;b++)a[b][c][1]/=d;else for(b=0;e>b;b++)a[b][c][1]=0}for(c=0;f>c;++c)g[c]=0;return g}}),u.renderEnd("stackedArea immediate"),b}var c,d,e={top:0,right:0,bottom:0,left:0},f=960,g=500,h=a.utils.defaultColor(),i=Math.floor(1e5*Math.random()),j=null,k=function(a){return a.x},l=function(a){return a.y},m="stack",n="zero",o="default",p="linear",q=!1,r=a.models.scatter(),s=250,t=d3.dispatch("areaClick","areaMouseover","areaMouseout","renderEnd","elementClick","elementMouseover","elementMouseout");r.pointSize(2.2).pointDomain([2.2,2.2]);var u=a.utils.renderWatch(t,s);return b.dispatch=t,b.scatter=r,r.dispatch.on("elementClick",function(){t.elementClick.apply(this,arguments)}),r.dispatch.on("elementMouseover",function(){t.elementMouseover.apply(this,arguments)}),r.dispatch.on("elementMouseout",function(){t.elementMouseout.apply(this,arguments)}),b.interpolate=function(a){return arguments.length?(p=a,b):p},b.duration=function(a){return arguments.length?(s=a,u.reset(s),r.duration(s),b):s},b.dispatch=t,b.scatter=r,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return f},set:function(a){f=a}},height:{get:function(){return g},set:function(a){g=a}},clipEdge:{get:function(){return q},set:function(a){q=a}},offset:{get:function(){return n},set:function(a){n=a}},order:{get:function(){return o},set:function(a){o=a}},interpolate:{get:function(){return p},set:function(a){p=a}},x:{get:function(){return k},set:function(a){k=d3.functor(a)}},y:{get:function(){return l},set:function(a){l=d3.functor(a)}},margin:{get:function(){return e},set:function(a){e.top=void 0!==a.top?a.top:e.top,e.right=void 0!==a.right?a.right:e.right,e.bottom=void 0!==a.bottom?a.bottom:e.bottom,e.left=void 0!==a.left?a.left:e.left}},color:{get:function(){return h},set:function(b){h=a.utils.getColor(b)}},style:{get:function(){return m},set:function(a){switch(m=a){case"stack":b.offset("zero"),b.order("default");break;case"stream":b.offset("wiggle"),b.order("inside-out");break;case"stream-center":b.offset("silhouette"),b.order("inside-out");break;case"expand":b.offset("expand"),b.order("default");break;case"stack_percent":b.offset(b.d3_stackedOffset_stackPercent),b.order("default")}}},duration:{get:function(){return s},set:function(a){s=a,u.reset(s),r.duration(s)}}}),a.utils.inheritOptions(b,r),a.utils.initOptions(b),b},a.models.stackedAreaChart=function(){"use strict";function b(k){return F.reset(),F.models(e),r&&F.models(f),s&&F.models(g),k.each(function(k){var x=d3.select(this),F=this;a.utils.initSVG(x);var K=a.utils.availableWidth(m,x,l),L=a.utils.availableHeight(n,x,l);if(b.update=function(){x.transition().duration(C).call(b)},b.container=this,v.setter(I(k),b.update).getter(H(k)).update(),v.disabled=k.map(function(a){return!!a.disabled}),!w){var M;w={};for(M in v)w[M]=v[M]instanceof Array?v[M].slice(0):v[M]}if(!(k&&k.length&&k.filter(function(a){return a.values.length}).length))return a.utils.noData(b,x),b;x.selectAll(".nv-noData").remove(),c=e.xScale(),d=e.yScale();var N=x.selectAll("g.nv-wrap.nv-stackedAreaChart").data([k]),O=N.enter().append("g").attr("class","nvd3 nv-wrap nv-stackedAreaChart").append("g"),P=N.select("g");if(O.append("rect").style("opacity",0),O.append("g").attr("class","nv-x nv-axis"),O.append("g").attr("class","nv-y nv-axis"),O.append("g").attr("class","nv-stackedWrap"),O.append("g").attr("class","nv-legendWrap"),O.append("g").attr("class","nv-controlsWrap"),O.append("g").attr("class","nv-interactive"),P.select("rect").attr("width",K).attr("height",L),q){var Q=p?K-z:K;h.width(Q),P.select(".nv-legendWrap").datum(k).call(h),l.top!=h.height()&&(l.top=h.height(),L=a.utils.availableHeight(n,x,l)),P.select(".nv-legendWrap").attr("transform","translate("+(K-Q)+","+-l.top+")")}if(p){var R=[{key:B.stacked||"Stacked",metaKey:"Stacked",disabled:"stack"!=e.style(),style:"stack"},{key:B.stream||"Stream",metaKey:"Stream",disabled:"stream"!=e.style(),style:"stream"},{key:B.expanded||"Expanded",metaKey:"Expanded",disabled:"expand"!=e.style(),style:"expand"},{key:B.stack_percent||"Stack %",metaKey:"Stack_Percent",disabled:"stack_percent"!=e.style(),style:"stack_percent"}];z=A.length/3*260,R=R.filter(function(a){return-1!==A.indexOf(a.metaKey)}),i.width(z).color(["#444","#444","#444"]),P.select(".nv-controlsWrap").datum(R).call(i),l.top!=Math.max(i.height(),h.height())&&(l.top=Math.max(i.height(),h.height()),L=a.utils.availableHeight(n,x,l)),P.select(".nv-controlsWrap").attr("transform","translate(0,"+-l.top+")")}N.attr("transform","translate("+l.left+","+l.top+")"),t&&P.select(".nv-y.nv-axis").attr("transform","translate("+K+",0)"),u&&(j.width(K).height(L).margin({left:l.left,top:l.top}).svgContainer(x).xScale(c),N.select(".nv-interactive").call(j)),e.width(K).height(L);var S=P.select(".nv-stackedWrap").datum(k);if(S.transition().call(e),r&&(f.scale(c)._ticks(a.utils.calcTicksX(K/100,k)).tickSize(-L,0),P.select(".nv-x.nv-axis").attr("transform","translate(0,"+L+")"),P.select(".nv-x.nv-axis").transition().duration(0).call(f)),s){var T;if(T="wiggle"===e.offset()?0:a.utils.calcTicksY(L/36,k),g.scale(d)._ticks(T).tickSize(-K,0),"expand"===e.style()||"stack_percent"===e.style()){var U=g.tickFormat();D&&U===J||(D=U),g.tickFormat(J)}else D&&(g.tickFormat(D),D=null);P.select(".nv-y.nv-axis").transition().duration(0).call(g)}e.dispatch.on("areaClick.toggle",function(a){k.forEach(1===k.filter(function(a){return!a.disabled}).length?function(a){a.disabled=!1}:function(b,c){b.disabled=c!=a.seriesIndex}),v.disabled=k.map(function(a){return!!a.disabled}),y.stateChange(v),b.update()}),h.dispatch.on("stateChange",function(a){for(var c in a)v[c]=a[c];y.stateChange(v),b.update()}),i.dispatch.on("legendClick",function(a){a.disabled&&(R=R.map(function(a){return a.disabled=!0,a}),a.disabled=!1,e.style(a.style),v.style=e.style(),y.stateChange(v),b.update())}),j.dispatch.on("elementMousemove",function(c){e.clearHighlights();var d,g,h,i=[];if(k.filter(function(a,b){return a.seriesIndex=b,!a.disabled}).forEach(function(f,j){g=a.interactiveBisect(f.values,c.pointXValue,b.x());var k=f.values[g],l=b.y()(k,g);if(null!=l&&e.highlightPoint(j,g,!0),"undefined"!=typeof k){"undefined"==typeof d&&(d=k),"undefined"==typeof h&&(h=b.xScale()(b.x()(k,g)));var m="expand"==e.style()?k.display.y:b.y()(k,g);i.push({key:f.key,value:m,color:o(f,f.seriesIndex),stackedValue:k.display})}}),i.reverse(),i.length>2){var m=b.yScale().invert(c.mouseY),n=null;i.forEach(function(a,b){m=Math.abs(m);var c=Math.abs(a.stackedValue.y0),d=Math.abs(a.stackedValue.y);return m>=c&&d+c>=m?void(n=b):void 0}),null!=n&&(i[n].highlight=!0)}var p=f.tickFormat()(b.x()(d,g)),q=j.tooltip.valueFormatter();"expand"===e.style()||"stack_percent"===e.style()?(E||(E=q),q=d3.format(".1%")):E&&(q=E,E=null),j.tooltip.position({left:h+l.left,top:c.mouseY+l.top}).chartContainer(F.parentNode).valueFormatter(q).data({value:p,series:i})(),j.renderGuideLine(h)}),j.dispatch.on("elementMouseout",function(){e.clearHighlights()}),y.on("changeState",function(a){"undefined"!=typeof a.disabled&&k.length===a.disabled.length&&(k.forEach(function(b,c){b.disabled=a.disabled[c]}),v.disabled=a.disabled),"undefined"!=typeof a.style&&(e.style(a.style),G=a.style),b.update()})}),F.renderEnd("stacked Area chart immediate"),b}var c,d,e=a.models.stackedArea(),f=a.models.axis(),g=a.models.axis(),h=a.models.legend(),i=a.models.legend(),j=a.interactiveGuideline(),k=a.models.tooltip(),l={top:30,right:25,bottom:50,left:60},m=null,n=null,o=a.utils.defaultColor(),p=!0,q=!0,r=!0,s=!0,t=!1,u=!1,v=a.utils.state(),w=null,x=null,y=d3.dispatch("stateChange","changeState","renderEnd"),z=250,A=["Stacked","Stream","Expanded"],B={},C=250;v.style=e.style(),f.orient("bottom").tickPadding(7),g.orient(t?"right":"left"),k.headerFormatter(function(a,b){return f.tickFormat()(a,b)}).valueFormatter(function(a,b){return g.tickFormat()(a,b)}),j.tooltip.headerFormatter(function(a,b){return f.tickFormat()(a,b)}).valueFormatter(function(a,b){return g.tickFormat()(a,b)});var D=null,E=null;i.updateState(!1);var F=a.utils.renderWatch(y),G=e.style(),H=function(a){return function(){return{active:a.map(function(a){return!a.disabled}),style:e.style()}}},I=function(a){return function(b){void 0!==b.style&&(G=b.style),void 0!==b.active&&a.forEach(function(a,c){a.disabled=!b.active[c]})}},J=d3.format("%");return e.dispatch.on("elementMouseover.tooltip",function(a){a.point.x=e.x()(a.point),a.point.y=e.y()(a.point),k.data(a).position(a.pos).hidden(!1)}),e.dispatch.on("elementMouseout.tooltip",function(){k.hidden(!0)}),b.dispatch=y,b.stacked=e,b.legend=h,b.controls=i,b.xAxis=f,b.yAxis=g,b.interactiveLayer=j,b.tooltip=k,b.dispatch=y,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return m},set:function(a){m=a}},height:{get:function(){return n},set:function(a){n=a}},showLegend:{get:function(){return q},set:function(a){q=a}},showXAxis:{get:function(){return r},set:function(a){r=a}},showYAxis:{get:function(){return s},set:function(a){s=a}},defaultState:{get:function(){return w},set:function(a){w=a}},noData:{get:function(){return x},set:function(a){x=a}},showControls:{get:function(){return p},set:function(a){p=a}},controlLabels:{get:function(){return B},set:function(a){B=a}},controlOptions:{get:function(){return A},set:function(a){A=a}},tooltips:{get:function(){return k.enabled()},set:function(b){a.deprecated("tooltips","use chart.tooltip.enabled() instead"),k.enabled(!!b)}},tooltipContent:{get:function(){return k.contentGenerator()},set:function(b){a.deprecated("tooltipContent","use chart.tooltip.contentGenerator() instead"),k.contentGenerator(b)}},margin:{get:function(){return l},set:function(a){l.top=void 0!==a.top?a.top:l.top,l.right=void 0!==a.right?a.right:l.right,l.bottom=void 0!==a.bottom?a.bottom:l.bottom,l.left=void 0!==a.left?a.left:l.left}},duration:{get:function(){return C},set:function(a){C=a,F.reset(C),e.duration(C),f.duration(C),g.duration(C)}},color:{get:function(){return o},set:function(b){o=a.utils.getColor(b),h.color(o),e.color(o)}},rightAlignYAxis:{get:function(){return t},set:function(a){t=a,g.orient(t?"right":"left")}},useInteractiveGuideline:{get:function(){return u},set:function(a){u=!!a,b.interactive(!a),b.useVoronoi(!a),e.scatter.interactive(!a)}}}),a.utils.inheritOptions(b,e),a.utils.initOptions(b),b},a.models.sunburst=function(){"use strict";function b(u){return t.reset(),u.each(function(b){function t(a){a.x0=a.x,a.dx0=a.dx}function u(a){var b=d3.interpolate(p.domain(),[a.x,a.x+a.dx]),c=d3.interpolate(q.domain(),[a.y,1]),d=d3.interpolate(q.range(),[a.y?20:0,y]);return function(a,e){return e?function(){return s(a)}:function(e){return p.domain(b(e)),q.domain(c(e)).range(d(e)),s(a)}}}l=d3.select(this);var v,w=a.utils.availableWidth(g,l,f),x=a.utils.availableHeight(h,l,f),y=Math.min(w,x)/2;a.utils.initSVG(l);var z=l.selectAll(".nv-wrap.nv-sunburst").data(b),A=z.enter().append("g").attr("class","nvd3 nv-wrap nv-sunburst nv-chart-"+k),B=A.selectAll("nv-sunburst");z.attr("transform","translate("+w/2+","+x/2+")"),l.on("click",function(a,b){o.chartClick({data:a,index:b,pos:d3.event,id:k})}),q.range([0,y]),c=c||b,e=b[0],r.value(j[i]||j.count),v=B.data(r.nodes).enter().append("path").attr("d",s).style("fill",function(a){return m((a.children?a:a.parent).name)}).style("stroke","#FFF").on("click",function(a){d!==c&&c!==a&&(d=c),c=a,v.transition().duration(n).attrTween("d",u(a))}).each(t).on("dblclick",function(a){d.parent==a&&v.transition().duration(n).attrTween("d",u(e))}).each(t).on("mouseover",function(a){d3.select(this).classed("hover",!0).style("opacity",.8),o.elementMouseover({data:a,color:d3.select(this).style("fill")})}).on("mouseout",function(a){d3.select(this).classed("hover",!1).style("opacity",1),o.elementMouseout({data:a})}).on("mousemove",function(a){o.elementMousemove({data:a})})}),t.renderEnd("sunburst immediate"),b}var c,d,e,f={top:0,right:0,bottom:0,left:0},g=null,h=null,i="count",j={count:function(){return 1},size:function(a){return a.size}},k=Math.floor(1e4*Math.random()),l=null,m=a.utils.defaultColor(),n=500,o=d3.dispatch("chartClick","elementClick","elementDblClick","elementMousemove","elementMouseover","elementMouseout","renderEnd"),p=d3.scale.linear().range([0,2*Math.PI]),q=d3.scale.sqrt(),r=d3.layout.partition().sort(null).value(function(){return 1}),s=d3.svg.arc().startAngle(function(a){return Math.max(0,Math.min(2*Math.PI,p(a.x)))}).endAngle(function(a){return Math.max(0,Math.min(2*Math.PI,p(a.x+a.dx)))}).innerRadius(function(a){return Math.max(0,q(a.y))}).outerRadius(function(a){return Math.max(0,q(a.y+a.dy))}),t=a.utils.renderWatch(o);return b.dispatch=o,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{width:{get:function(){return g},set:function(a){g=a}},height:{get:function(){return h},set:function(a){h=a}},mode:{get:function(){return i},set:function(a){i=a}},id:{get:function(){return k},set:function(a){k=a}},duration:{get:function(){return n},set:function(a){n=a}},margin:{get:function(){return f},set:function(a){f.top=void 0!=a.top?a.top:f.top,f.right=void 0!=a.right?a.right:f.right,f.bottom=void 0!=a.bottom?a.bottom:f.bottom,f.left=void 0!=a.left?a.left:f.left}},color:{get:function(){return m},set:function(b){m=a.utils.getColor(b)}}}),a.utils.initOptions(b),b},a.models.sunburstChart=function(){"use strict";function b(d){return m.reset(),m.models(c),d.each(function(d){var h=d3.select(this);a.utils.initSVG(h);var i=a.utils.availableWidth(f,h,e),j=a.utils.availableHeight(g,h,e);if(b.update=function(){0===k?h.call(b):h.transition().duration(k).call(b)},b.container=this,!d||!d.length)return a.utils.noData(b,h),b;h.selectAll(".nv-noData").remove();var l=h.selectAll("g.nv-wrap.nv-sunburstChart").data(d),m=l.enter().append("g").attr("class","nvd3 nv-wrap nv-sunburstChart").append("g"),n=l.select("g");m.append("g").attr("class","nv-sunburstWrap"),l.attr("transform","translate("+e.left+","+e.top+")"),c.width(i).height(j);var o=n.select(".nv-sunburstWrap").datum(d);d3.transition(o).call(c)}),m.renderEnd("sunburstChart immediate"),b}var c=a.models.sunburst(),d=a.models.tooltip(),e={top:30,right:20,bottom:20,left:20},f=null,g=null,h=a.utils.defaultColor(),i=(Math.round(1e5*Math.random()),null),j=null,k=250,l=d3.dispatch("tooltipShow","tooltipHide","stateChange","changeState","renderEnd"),m=a.utils.renderWatch(l);return d.headerEnabled(!1).duration(0).valueFormatter(function(a){return a}),c.dispatch.on("elementMouseover.tooltip",function(a){a.series={key:a.data.name,value:a.data.size,color:a.color},d.data(a).hidden(!1)}),c.dispatch.on("elementMouseout.tooltip",function(){d.hidden(!0)}),c.dispatch.on("elementMousemove.tooltip",function(){d.position({top:d3.event.pageY,left:d3.event.pageX})()}),b.dispatch=l,b.sunburst=c,b.tooltip=d,b.options=a.utils.optionsFunc.bind(b),b._options=Object.create({},{noData:{get:function(){return j},set:function(a){j=a}},defaultState:{get:function(){return i},set:function(a){i=a}},color:{get:function(){return h},set:function(a){h=a,c.color(h)}},duration:{get:function(){return k},set:function(a){k=a,m.reset(k),c.duration(k)}},margin:{get:function(){return e},set:function(a){e.top=void 0!==a.top?a.top:e.top,e.right=void 0!==a.right?a.right:e.right,e.bottom=void 0!==a.bottom?a.bottom:e.bottom,e.left=void 0!==a.left?a.left:e.left}}}),a.utils.inheritOptions(b,c),a.utils.initOptions(b),b},a.version="1.8.1"}(); php-code-coverage/src/Report/Html/Renderer/Template/js/popper.min.js 0000644 00000051361 15243417753 0021405 0 ustar 00 /*
Copyright (C) Federico Zivolo 2020
Distributed under the MIT License (license terms are at http://opensource.org/licenses/MIT).
*/(function(e,t){'object'==typeof exports&&'undefined'!=typeof module?module.exports=t():'function'==typeof define&&define.amd?define(t):e.Popper=t()})(this,function(){'use strict';function e(e){return e&&'[object Function]'==={}.toString.call(e)}function t(e,t){if(1!==e.nodeType)return[];var o=e.ownerDocument.defaultView,n=o.getComputedStyle(e,null);return t?n[t]:n}function o(e){return'HTML'===e.nodeName?e:e.parentNode||e.host}function n(e){if(!e)return document.body;switch(e.nodeName){case'HTML':case'BODY':return e.ownerDocument.body;case'#document':return e.body;}var i=t(e),r=i.overflow,p=i.overflowX,s=i.overflowY;return /(auto|scroll|overlay)/.test(r+s+p)?e:n(o(e))}function i(e){return e&&e.referenceNode?e.referenceNode:e}function r(e){return 11===e?re:10===e?pe:re||pe}function p(e){if(!e)return document.documentElement;for(var o=r(10)?document.body:null,n=e.offsetParent||null;n===o&&e.nextElementSibling;)n=(e=e.nextElementSibling).offsetParent;var i=n&&n.nodeName;return i&&'BODY'!==i&&'HTML'!==i?-1!==['TH','TD','TABLE'].indexOf(n.nodeName)&&'static'===t(n,'position')?p(n):n:e?e.ownerDocument.documentElement:document.documentElement}function s(e){var t=e.nodeName;return'BODY'!==t&&('HTML'===t||p(e.firstElementChild)===e)}function d(e){return null===e.parentNode?e:d(e.parentNode)}function a(e,t){if(!e||!e.nodeType||!t||!t.nodeType)return document.documentElement;var o=e.compareDocumentPosition(t)&Node.DOCUMENT_POSITION_FOLLOWING,n=o?e:t,i=o?t:e,r=document.createRange();r.setStart(n,0),r.setEnd(i,0);var l=r.commonAncestorContainer;if(e!==l&&t!==l||n.contains(i))return s(l)?l:p(l);var f=d(e);return f.host?a(f.host,t):a(e,d(t).host)}function l(e){var t=1<arguments.length&&void 0!==arguments[1]?arguments[1]:'top',o='top'===t?'scrollTop':'scrollLeft',n=e.nodeName;if('BODY'===n||'HTML'===n){var i=e.ownerDocument.documentElement,r=e.ownerDocument.scrollingElement||i;return r[o]}return e[o]}function f(e,t){var o=2<arguments.length&&void 0!==arguments[2]&&arguments[2],n=l(t,'top'),i=l(t,'left'),r=o?-1:1;return e.top+=n*r,e.bottom+=n*r,e.left+=i*r,e.right+=i*r,e}function m(e,t){var o='x'===t?'Left':'Top',n='Left'==o?'Right':'Bottom';return parseFloat(e['border'+o+'Width'])+parseFloat(e['border'+n+'Width'])}function h(e,t,o,n){return ee(t['offset'+e],t['scroll'+e],o['client'+e],o['offset'+e],o['scroll'+e],r(10)?parseInt(o['offset'+e])+parseInt(n['margin'+('Height'===e?'Top':'Left')])+parseInt(n['margin'+('Height'===e?'Bottom':'Right')]):0)}function c(e){var t=e.body,o=e.documentElement,n=r(10)&&getComputedStyle(o);return{height:h('Height',t,o,n),width:h('Width',t,o,n)}}function g(e){return le({},e,{right:e.left+e.width,bottom:e.top+e.height})}function u(e){var o={};try{if(r(10)){o=e.getBoundingClientRect();var n=l(e,'top'),i=l(e,'left');o.top+=n,o.left+=i,o.bottom+=n,o.right+=i}else o=e.getBoundingClientRect()}catch(t){}var p={left:o.left,top:o.top,width:o.right-o.left,height:o.bottom-o.top},s='HTML'===e.nodeName?c(e.ownerDocument):{},d=s.width||e.clientWidth||p.width,a=s.height||e.clientHeight||p.height,f=e.offsetWidth-d,h=e.offsetHeight-a;if(f||h){var u=t(e);f-=m(u,'x'),h-=m(u,'y'),p.width-=f,p.height-=h}return g(p)}function b(e,o){var i=2<arguments.length&&void 0!==arguments[2]&&arguments[2],p=r(10),s='HTML'===o.nodeName,d=u(e),a=u(o),l=n(e),m=t(o),h=parseFloat(m.borderTopWidth),c=parseFloat(m.borderLeftWidth);i&&s&&(a.top=ee(a.top,0),a.left=ee(a.left,0));var b=g({top:d.top-a.top-h,left:d.left-a.left-c,width:d.width,height:d.height});if(b.marginTop=0,b.marginLeft=0,!p&&s){var w=parseFloat(m.marginTop),y=parseFloat(m.marginLeft);b.top-=h-w,b.bottom-=h-w,b.left-=c-y,b.right-=c-y,b.marginTop=w,b.marginLeft=y}return(p&&!i?o.contains(l):o===l&&'BODY'!==l.nodeName)&&(b=f(b,o)),b}function w(e){var t=1<arguments.length&&void 0!==arguments[1]&&arguments[1],o=e.ownerDocument.documentElement,n=b(e,o),i=ee(o.clientWidth,window.innerWidth||0),r=ee(o.clientHeight,window.innerHeight||0),p=t?0:l(o),s=t?0:l(o,'left'),d={top:p-n.top+n.marginTop,left:s-n.left+n.marginLeft,width:i,height:r};return g(d)}function y(e){var n=e.nodeName;if('BODY'===n||'HTML'===n)return!1;if('fixed'===t(e,'position'))return!0;var i=o(e);return!!i&&y(i)}function E(e){if(!e||!e.parentElement||r())return document.documentElement;for(var o=e.parentElement;o&&'none'===t(o,'transform');)o=o.parentElement;return o||document.documentElement}function v(e,t,r,p){var s=4<arguments.length&&void 0!==arguments[4]&&arguments[4],d={top:0,left:0},l=s?E(e):a(e,i(t));if('viewport'===p)d=w(l,s);else{var f;'scrollParent'===p?(f=n(o(t)),'BODY'===f.nodeName&&(f=e.ownerDocument.documentElement)):'window'===p?f=e.ownerDocument.documentElement:f=p;var m=b(f,l,s);if('HTML'===f.nodeName&&!y(l)){var h=c(e.ownerDocument),g=h.height,u=h.width;d.top+=m.top-m.marginTop,d.bottom=g+m.top,d.left+=m.left-m.marginLeft,d.right=u+m.left}else d=m}r=r||0;var v='number'==typeof r;return d.left+=v?r:r.left||0,d.top+=v?r:r.top||0,d.right-=v?r:r.right||0,d.bottom-=v?r:r.bottom||0,d}function x(e){var t=e.width,o=e.height;return t*o}function O(e,t,o,n,i){var r=5<arguments.length&&void 0!==arguments[5]?arguments[5]:0;if(-1===e.indexOf('auto'))return e;var p=v(o,n,r,i),s={top:{width:p.width,height:t.top-p.top},right:{width:p.right-t.right,height:p.height},bottom:{width:p.width,height:p.bottom-t.bottom},left:{width:t.left-p.left,height:p.height}},d=Object.keys(s).map(function(e){return le({key:e},s[e],{area:x(s[e])})}).sort(function(e,t){return t.area-e.area}),a=d.filter(function(e){var t=e.width,n=e.height;return t>=o.clientWidth&&n>=o.clientHeight}),l=0<a.length?a[0].key:d[0].key,f=e.split('-')[1];return l+(f?'-'+f:'')}function L(e,t,o){var n=3<arguments.length&&void 0!==arguments[3]?arguments[3]:null,r=n?E(t):a(t,i(o));return b(o,r,n)}function S(e){var t=e.ownerDocument.defaultView,o=t.getComputedStyle(e),n=parseFloat(o.marginTop||0)+parseFloat(o.marginBottom||0),i=parseFloat(o.marginLeft||0)+parseFloat(o.marginRight||0),r={width:e.offsetWidth+i,height:e.offsetHeight+n};return r}function T(e){var t={left:'right',right:'left',bottom:'top',top:'bottom'};return e.replace(/left|right|bottom|top/g,function(e){return t[e]})}function C(e,t,o){o=o.split('-')[0];var n=S(e),i={width:n.width,height:n.height},r=-1!==['right','left'].indexOf(o),p=r?'top':'left',s=r?'left':'top',d=r?'height':'width',a=r?'width':'height';return i[p]=t[p]+t[d]/2-n[d]/2,i[s]=o===s?t[s]-n[a]:t[T(s)],i}function D(e,t){return Array.prototype.find?e.find(t):e.filter(t)[0]}function N(e,t,o){if(Array.prototype.findIndex)return e.findIndex(function(e){return e[t]===o});var n=D(e,function(e){return e[t]===o});return e.indexOf(n)}function P(t,o,n){var i=void 0===n?t:t.slice(0,N(t,'name',n));return i.forEach(function(t){t['function']&&console.warn('`modifier.function` is deprecated, use `modifier.fn`!');var n=t['function']||t.fn;t.enabled&&e(n)&&(o.offsets.popper=g(o.offsets.popper),o.offsets.reference=g(o.offsets.reference),o=n(o,t))}),o}function k(){if(!this.state.isDestroyed){var e={instance:this,styles:{},arrowStyles:{},attributes:{},flipped:!1,offsets:{}};e.offsets.reference=L(this.state,this.popper,this.reference,this.options.positionFixed),e.placement=O(this.options.placement,e.offsets.reference,this.popper,this.reference,this.options.modifiers.flip.boundariesElement,this.options.modifiers.flip.padding),e.originalPlacement=e.placement,e.positionFixed=this.options.positionFixed,e.offsets.popper=C(this.popper,e.offsets.reference,e.placement),e.offsets.popper.position=this.options.positionFixed?'fixed':'absolute',e=P(this.modifiers,e),this.state.isCreated?this.options.onUpdate(e):(this.state.isCreated=!0,this.options.onCreate(e))}}function W(e,t){return e.some(function(e){var o=e.name,n=e.enabled;return n&&o===t})}function B(e){for(var t=[!1,'ms','Webkit','Moz','O'],o=e.charAt(0).toUpperCase()+e.slice(1),n=0;n<t.length;n++){var i=t[n],r=i?''+i+o:e;if('undefined'!=typeof document.body.style[r])return r}return null}function H(){return this.state.isDestroyed=!0,W(this.modifiers,'applyStyle')&&(this.popper.removeAttribute('x-placement'),this.popper.style.position='',this.popper.style.top='',this.popper.style.left='',this.popper.style.right='',this.popper.style.bottom='',this.popper.style.willChange='',this.popper.style[B('transform')]=''),this.disableEventListeners(),this.options.removeOnDestroy&&this.popper.parentNode.removeChild(this.popper),this}function A(e){var t=e.ownerDocument;return t?t.defaultView:window}function M(e,t,o,i){var r='BODY'===e.nodeName,p=r?e.ownerDocument.defaultView:e;p.addEventListener(t,o,{passive:!0}),r||M(n(p.parentNode),t,o,i),i.push(p)}function F(e,t,o,i){o.updateBound=i,A(e).addEventListener('resize',o.updateBound,{passive:!0});var r=n(e);return M(r,'scroll',o.updateBound,o.scrollParents),o.scrollElement=r,o.eventsEnabled=!0,o}function I(){this.state.eventsEnabled||(this.state=F(this.reference,this.options,this.state,this.scheduleUpdate))}function R(e,t){return A(e).removeEventListener('resize',t.updateBound),t.scrollParents.forEach(function(e){e.removeEventListener('scroll',t.updateBound)}),t.updateBound=null,t.scrollParents=[],t.scrollElement=null,t.eventsEnabled=!1,t}function U(){this.state.eventsEnabled&&(cancelAnimationFrame(this.scheduleUpdate),this.state=R(this.reference,this.state))}function Y(e){return''!==e&&!isNaN(parseFloat(e))&&isFinite(e)}function V(e,t){Object.keys(t).forEach(function(o){var n='';-1!==['width','height','top','right','bottom','left'].indexOf(o)&&Y(t[o])&&(n='px'),e.style[o]=t[o]+n})}function j(e,t){Object.keys(t).forEach(function(o){var n=t[o];!1===n?e.removeAttribute(o):e.setAttribute(o,t[o])})}function q(e,t){var o=e.offsets,n=o.popper,i=o.reference,r=$,p=function(e){return e},s=r(i.width),d=r(n.width),a=-1!==['left','right'].indexOf(e.placement),l=-1!==e.placement.indexOf('-'),f=t?a||l||s%2==d%2?r:Z:p,m=t?r:p;return{left:f(1==s%2&&1==d%2&&!l&&t?n.left-1:n.left),top:m(n.top),bottom:m(n.bottom),right:f(n.right)}}function K(e,t,o){var n=D(e,function(e){var o=e.name;return o===t}),i=!!n&&e.some(function(e){return e.name===o&&e.enabled&&e.order<n.order});if(!i){var r='`'+t+'`';console.warn('`'+o+'`'+' modifier is required by '+r+' modifier in order to work, be sure to include it before '+r+'!')}return i}function z(e){return'end'===e?'start':'start'===e?'end':e}function G(e){var t=1<arguments.length&&void 0!==arguments[1]&&arguments[1],o=he.indexOf(e),n=he.slice(o+1).concat(he.slice(0,o));return t?n.reverse():n}function _(e,t,o,n){var i=e.match(/((?:\-|\+)?\d*\.?\d*)(.*)/),r=+i[1],p=i[2];if(!r)return e;if(0===p.indexOf('%')){var s;switch(p){case'%p':s=o;break;case'%':case'%r':default:s=n;}var d=g(s);return d[t]/100*r}if('vh'===p||'vw'===p){var a;return a='vh'===p?ee(document.documentElement.clientHeight,window.innerHeight||0):ee(document.documentElement.clientWidth,window.innerWidth||0),a/100*r}return r}function X(e,t,o,n){var i=[0,0],r=-1!==['right','left'].indexOf(n),p=e.split(/(\+|\-)/).map(function(e){return e.trim()}),s=p.indexOf(D(p,function(e){return-1!==e.search(/,|\s/)}));p[s]&&-1===p[s].indexOf(',')&&console.warn('Offsets separated by white space(s) are deprecated, use a comma (,) instead.');var d=/\s*,\s*|\s+/,a=-1===s?[p]:[p.slice(0,s).concat([p[s].split(d)[0]]),[p[s].split(d)[1]].concat(p.slice(s+1))];return a=a.map(function(e,n){var i=(1===n?!r:r)?'height':'width',p=!1;return e.reduce(function(e,t){return''===e[e.length-1]&&-1!==['+','-'].indexOf(t)?(e[e.length-1]=t,p=!0,e):p?(e[e.length-1]+=t,p=!1,e):e.concat(t)},[]).map(function(e){return _(e,i,t,o)})}),a.forEach(function(e,t){e.forEach(function(o,n){Y(o)&&(i[t]+=o*('-'===e[n-1]?-1:1))})}),i}function J(e,t){var o,n=t.offset,i=e.placement,r=e.offsets,p=r.popper,s=r.reference,d=i.split('-')[0];return o=Y(+n)?[+n,0]:X(n,p,s,d),'left'===d?(p.top+=o[0],p.left-=o[1]):'right'===d?(p.top+=o[0],p.left+=o[1]):'top'===d?(p.left+=o[0],p.top-=o[1]):'bottom'===d&&(p.left+=o[0],p.top+=o[1]),e.popper=p,e}var Q=Math.min,Z=Math.floor,$=Math.round,ee=Math.max,te='undefined'!=typeof window&&'undefined'!=typeof document&&'undefined'!=typeof navigator,oe=function(){for(var e=['Edge','Trident','Firefox'],t=0;t<e.length;t+=1)if(te&&0<=navigator.userAgent.indexOf(e[t]))return 1;return 0}(),ne=te&&window.Promise,ie=ne?function(e){var t=!1;return function(){t||(t=!0,window.Promise.resolve().then(function(){t=!1,e()}))}}:function(e){var t=!1;return function(){t||(t=!0,setTimeout(function(){t=!1,e()},oe))}},re=te&&!!(window.MSInputMethodContext&&document.documentMode),pe=te&&/MSIE 10/.test(navigator.userAgent),se=function(e,t){if(!(e instanceof t))throw new TypeError('Cannot call a class as a function')},de=function(){function e(e,t){for(var o,n=0;n<t.length;n++)o=t[n],o.enumerable=o.enumerable||!1,o.configurable=!0,'value'in o&&(o.writable=!0),Object.defineProperty(e,o.key,o)}return function(t,o,n){return o&&e(t.prototype,o),n&&e(t,n),t}}(),ae=function(e,t,o){return t in e?Object.defineProperty(e,t,{value:o,enumerable:!0,configurable:!0,writable:!0}):e[t]=o,e},le=Object.assign||function(e){for(var t,o=1;o<arguments.length;o++)for(var n in t=arguments[o],t)Object.prototype.hasOwnProperty.call(t,n)&&(e[n]=t[n]);return e},fe=te&&/Firefox/i.test(navigator.userAgent),me=['auto-start','auto','auto-end','top-start','top','top-end','right-start','right','right-end','bottom-end','bottom','bottom-start','left-end','left','left-start'],he=me.slice(3),ce={FLIP:'flip',CLOCKWISE:'clockwise',COUNTERCLOCKWISE:'counterclockwise'},ge=function(){function t(o,n){var i=this,r=2<arguments.length&&void 0!==arguments[2]?arguments[2]:{};se(this,t),this.scheduleUpdate=function(){return requestAnimationFrame(i.update)},this.update=ie(this.update.bind(this)),this.options=le({},t.Defaults,r),this.state={isDestroyed:!1,isCreated:!1,scrollParents:[]},this.reference=o&&o.jquery?o[0]:o,this.popper=n&&n.jquery?n[0]:n,this.options.modifiers={},Object.keys(le({},t.Defaults.modifiers,r.modifiers)).forEach(function(e){i.options.modifiers[e]=le({},t.Defaults.modifiers[e]||{},r.modifiers?r.modifiers[e]:{})}),this.modifiers=Object.keys(this.options.modifiers).map(function(e){return le({name:e},i.options.modifiers[e])}).sort(function(e,t){return e.order-t.order}),this.modifiers.forEach(function(t){t.enabled&&e(t.onLoad)&&t.onLoad(i.reference,i.popper,i.options,t,i.state)}),this.update();var p=this.options.eventsEnabled;p&&this.enableEventListeners(),this.state.eventsEnabled=p}return de(t,[{key:'update',value:function(){return k.call(this)}},{key:'destroy',value:function(){return H.call(this)}},{key:'enableEventListeners',value:function(){return I.call(this)}},{key:'disableEventListeners',value:function(){return U.call(this)}}]),t}();return ge.Utils=('undefined'==typeof window?global:window).PopperUtils,ge.placements=me,ge.Defaults={placement:'bottom',positionFixed:!1,eventsEnabled:!0,removeOnDestroy:!1,onCreate:function(){},onUpdate:function(){},modifiers:{shift:{order:100,enabled:!0,fn:function(e){var t=e.placement,o=t.split('-')[0],n=t.split('-')[1];if(n){var i=e.offsets,r=i.reference,p=i.popper,s=-1!==['bottom','top'].indexOf(o),d=s?'left':'top',a=s?'width':'height',l={start:ae({},d,r[d]),end:ae({},d,r[d]+r[a]-p[a])};e.offsets.popper=le({},p,l[n])}return e}},offset:{order:200,enabled:!0,fn:J,offset:0},preventOverflow:{order:300,enabled:!0,fn:function(e,t){var o=t.boundariesElement||p(e.instance.popper);e.instance.reference===o&&(o=p(o));var n=B('transform'),i=e.instance.popper.style,r=i.top,s=i.left,d=i[n];i.top='',i.left='',i[n]='';var a=v(e.instance.popper,e.instance.reference,t.padding,o,e.positionFixed);i.top=r,i.left=s,i[n]=d,t.boundaries=a;var l=t.priority,f=e.offsets.popper,m={primary:function(e){var o=f[e];return f[e]<a[e]&&!t.escapeWithReference&&(o=ee(f[e],a[e])),ae({},e,o)},secondary:function(e){var o='right'===e?'left':'top',n=f[o];return f[e]>a[e]&&!t.escapeWithReference&&(n=Q(f[o],a[e]-('right'===e?f.width:f.height))),ae({},o,n)}};return l.forEach(function(e){var t=-1===['left','top'].indexOf(e)?'secondary':'primary';f=le({},f,m[t](e))}),e.offsets.popper=f,e},priority:['left','right','top','bottom'],padding:5,boundariesElement:'scrollParent'},keepTogether:{order:400,enabled:!0,fn:function(e){var t=e.offsets,o=t.popper,n=t.reference,i=e.placement.split('-')[0],r=Z,p=-1!==['top','bottom'].indexOf(i),s=p?'right':'bottom',d=p?'left':'top',a=p?'width':'height';return o[s]<r(n[d])&&(e.offsets.popper[d]=r(n[d])-o[a]),o[d]>r(n[s])&&(e.offsets.popper[d]=r(n[s])),e}},arrow:{order:500,enabled:!0,fn:function(e,o){var n;if(!K(e.instance.modifiers,'arrow','keepTogether'))return e;var i=o.element;if('string'==typeof i){if(i=e.instance.popper.querySelector(i),!i)return e;}else if(!e.instance.popper.contains(i))return console.warn('WARNING: `arrow.element` must be child of its popper element!'),e;var r=e.placement.split('-')[0],p=e.offsets,s=p.popper,d=p.reference,a=-1!==['left','right'].indexOf(r),l=a?'height':'width',f=a?'Top':'Left',m=f.toLowerCase(),h=a?'left':'top',c=a?'bottom':'right',u=S(i)[l];d[c]-u<s[m]&&(e.offsets.popper[m]-=s[m]-(d[c]-u)),d[m]+u>s[c]&&(e.offsets.popper[m]+=d[m]+u-s[c]),e.offsets.popper=g(e.offsets.popper);var b=d[m]+d[l]/2-u/2,w=t(e.instance.popper),y=parseFloat(w['margin'+f]),E=parseFloat(w['border'+f+'Width']),v=b-e.offsets.popper[m]-y-E;return v=ee(Q(s[l]-u,v),0),e.arrowElement=i,e.offsets.arrow=(n={},ae(n,m,$(v)),ae(n,h,''),n),e},element:'[x-arrow]'},flip:{order:600,enabled:!0,fn:function(e,t){if(W(e.instance.modifiers,'inner'))return e;if(e.flipped&&e.placement===e.originalPlacement)return e;var o=v(e.instance.popper,e.instance.reference,t.padding,t.boundariesElement,e.positionFixed),n=e.placement.split('-')[0],i=T(n),r=e.placement.split('-')[1]||'',p=[];switch(t.behavior){case ce.FLIP:p=[n,i];break;case ce.CLOCKWISE:p=G(n);break;case ce.COUNTERCLOCKWISE:p=G(n,!0);break;default:p=t.behavior;}return p.forEach(function(s,d){if(n!==s||p.length===d+1)return e;n=e.placement.split('-')[0],i=T(n);var a=e.offsets.popper,l=e.offsets.reference,f=Z,m='left'===n&&f(a.right)>f(l.left)||'right'===n&&f(a.left)<f(l.right)||'top'===n&&f(a.bottom)>f(l.top)||'bottom'===n&&f(a.top)<f(l.bottom),h=f(a.left)<f(o.left),c=f(a.right)>f(o.right),g=f(a.top)<f(o.top),u=f(a.bottom)>f(o.bottom),b='left'===n&&h||'right'===n&&c||'top'===n&&g||'bottom'===n&&u,w=-1!==['top','bottom'].indexOf(n),y=!!t.flipVariations&&(w&&'start'===r&&h||w&&'end'===r&&c||!w&&'start'===r&&g||!w&&'end'===r&&u),E=!!t.flipVariationsByContent&&(w&&'start'===r&&c||w&&'end'===r&&h||!w&&'start'===r&&u||!w&&'end'===r&&g),v=y||E;(m||b||v)&&(e.flipped=!0,(m||b)&&(n=p[d+1]),v&&(r=z(r)),e.placement=n+(r?'-'+r:''),e.offsets.popper=le({},e.offsets.popper,C(e.instance.popper,e.offsets.reference,e.placement)),e=P(e.instance.modifiers,e,'flip'))}),e},behavior:'flip',padding:5,boundariesElement:'viewport',flipVariations:!1,flipVariationsByContent:!1},inner:{order:700,enabled:!1,fn:function(e){var t=e.placement,o=t.split('-')[0],n=e.offsets,i=n.popper,r=n.reference,p=-1!==['left','right'].indexOf(o),s=-1===['top','left'].indexOf(o);return i[p?'left':'top']=r[o]-(s?i[p?'width':'height']:0),e.placement=T(t),e.offsets.popper=g(i),e}},hide:{order:800,enabled:!0,fn:function(e){if(!K(e.instance.modifiers,'hide','preventOverflow'))return e;var t=e.offsets.reference,o=D(e.instance.modifiers,function(e){return'preventOverflow'===e.name}).boundaries;if(t.bottom<o.top||t.left>o.right||t.top>o.bottom||t.right<o.left){if(!0===e.hide)return e;e.hide=!0,e.attributes['x-out-of-boundaries']=''}else{if(!1===e.hide)return e;e.hide=!1,e.attributes['x-out-of-boundaries']=!1}return e}},computeStyle:{order:850,enabled:!0,fn:function(e,t){var o=t.x,n=t.y,i=e.offsets.popper,r=D(e.instance.modifiers,function(e){return'applyStyle'===e.name}).gpuAcceleration;void 0!==r&&console.warn('WARNING: `gpuAcceleration` option moved to `computeStyle` modifier and will not be supported in future versions of Popper.js!');var s,d,a=void 0===r?t.gpuAcceleration:r,l=p(e.instance.popper),f=u(l),m={position:i.position},h=q(e,2>window.devicePixelRatio||!fe),c='bottom'===o?'top':'bottom',g='right'===n?'left':'right',b=B('transform');if(d='bottom'==c?'HTML'===l.nodeName?-l.clientHeight+h.bottom:-f.height+h.bottom:h.top,s='right'==g?'HTML'===l.nodeName?-l.clientWidth+h.right:-f.width+h.right:h.left,a&&b)m[b]='translate3d('+s+'px, '+d+'px, 0)',m[c]=0,m[g]=0,m.willChange='transform';else{var w='bottom'==c?-1:1,y='right'==g?-1:1;m[c]=d*w,m[g]=s*y,m.willChange=c+', '+g}var E={"x-placement":e.placement};return e.attributes=le({},E,e.attributes),e.styles=le({},m,e.styles),e.arrowStyles=le({},e.offsets.arrow,e.arrowStyles),e},gpuAcceleration:!0,x:'bottom',y:'right'},applyStyle:{order:900,enabled:!0,fn:function(e){return V(e.instance.popper,e.styles),j(e.instance.popper,e.attributes),e.arrowElement&&Object.keys(e.arrowStyles).length&&V(e.arrowElement,e.arrowStyles),e},onLoad:function(e,t,o,n,i){var r=L(i,t,e,o.positionFixed),p=O(o.placement,r,t,e,o.modifiers.flip.boundariesElement,o.modifiers.flip.padding);return t.setAttribute('x-placement',p),V(t,{position:o.positionFixed?'fixed':'absolute'}),o},gpuAcceleration:void 0}}},ge});
//# sourceMappingURL=popper.min.js.map
php-code-coverage/src/Report/Html/Renderer/Template/js/jquery.min.js 0000644 00000257100 15243417753 0021416 0 ustar 00 /*! jQuery v3.6.1 | (c) OpenJS Foundation and other contributors | jquery.org/license */
!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,y=n.hasOwnProperty,a=y.toString,l=a.call(Object),v={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.1",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments[0]||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=arguments[s]||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=arguments[s]))for(t in e)r=e[t],"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=a[t],o=i&&!Array.isArray(n)?[]:i||S.isPlainObject(n)?n:{},i=!1,a[t]=S.extend(l,o,r)):void 0!==r&&(a[t]=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=y.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(e[r],r,e[r]))break}else for(r in e)if(!1===t.call(e[r],r,e[r]))break;return e},makeArray:function(e,t){var n=t||[];return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?[e]:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)e[i++]=t[r];return e.length=i,e},grep:function(e,t,n){for(var r=[],i=0,o=e.length,a=!n;i<o;i++)!t(e[i],i)!==a&&r.push(e[i]);return r},map:function(e,t,n){var r,i,o=0,a=[];if(p(e))for(r=e.length;o<r;o++)null!=(i=t(e[o],o,n))&&a.push(i);else for(o in e)null!=(i=t(e[o],o,n))&&a.push(i);return g(a)},guid:1,support:v}),"function"==typeof Symbol&&(S.fn[Symbol.iterator]=t[Symbol.iterator]),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n["[object "+t+"]"]=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,y,s,c,v,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),j=function(e,t){return e===t&&(l=!0),0},D={}.hasOwnProperty,t=[],q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",I="(?:\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",W="\\["+M+"*("+I+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+I+"))|)"+M+"*\\]",F=":("+I+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+W+")*)|.*)\\)|)",$=new RegExp(M+"+","g"),B=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&v(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!y||!y.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ve(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace(B,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ye(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ve(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],y=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&y.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||y.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||y.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||y.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||y.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||y.push(".#.+[+~]"),e.querySelectorAll("\\\f"),y.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&y.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&y.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&y.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),y.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),y=y.length&&new RegExp(y.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),v=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&v(p,e)?-1:t==C||t.ownerDocument==p&&v(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!y||!y.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,[e]).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),v(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandle[t.toLowerCase()],r=n&&D.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=[],r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(j),l){while(t=e[i++])t===e[i]&&(r=n.push(i));while(r--)e.splice(n[r],1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=e[r++])n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace($," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,y){var v="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===y?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=v!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(v){while(l){a=e;while(a=a[l])if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=[m?c.firstChild:c.lastChild],m&&p){d=(s=(r=(i=(o=(a=c)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1])&&r[2],a=s&&c.childNodes[s];while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){i[h]=[k,s,d];break}}else if(p&&(d=s=(r=(i=(o=(a=e)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1]),!1===d)while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=a[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]=[k,d]),a===e))break;return(d-=y)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudos[e]||b.setFilters[e.toLowerCase()]||se.error("unsupported pseudo: "+e);return a[S]?a(o):1<a.length?(t=[e,e,"",o],b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)e[n=P(e,r[i])]=!(t[n]=r[i])}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=[],i=[],s=f(e.replace(B,"$1"));return s[S]?le(function(e,t,n,r){var i,o=s(e,null,r,[]),a=e.length;while(a--)(i=o[a])&&(e[a]=!(t[a]=i))}):function(e,t,n){return r[0]=e,s(r,null,n,i),r[0]=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ye(function(){return[0]}),last:ye(function(e,t){return[t-1]}),eq:ye(function(e,t,n){return[n<0?n+t:n]}),even:ye(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ye(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ye(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ye(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudos[e]=de(e);for(e in{submit:!0,reset:!0})b.pseudos[e]=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=e[u])if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=[k,p];if(n){while(e=e[u])if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=e[u])if(1===e.nodeType||f)if(i=(o=e[S]||(e[S]={}))[e.uniqueID]||(o[e.uniqueID]={}),l&&l===e.nodeName.toLowerCase())e=e[u]||e;else{if((r=i[c])&&r[0]===k&&r[1]===p)return a[2]=r[2];if((i[c]=a)[2]=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!i[r](e,t,n))return!1;return!0}:i[0]}function Te(e,t,n,r,i){for(var o,a=[],s=0,u=e.length,l=null!=t;s<u;s++)(o=e[s])&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,y,v,e){return y&&!y[S]&&(y=Ce(y)),v&&!v[S]&&(v=Ce(v,e)),le(function(e,t,n,r){var i,o,a,s=[],u=[],l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,t[r],n);return n}(h||"*",n.nodeType?[n]:n,[]),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?v||(e?d:l||y)?[]:t:f;if(g&&g(f,p,n,r),y){i=Te(p,u),y(i,[],n,r),o=i.length;while(o--)(a=i[o])&&(p[u[o]]=!(f[u[o]]=a))}if(e){if(v||d){if(v){i=[],o=p.length;while(o--)(a=p[o])&&i.push(f[o]=a);v(null,p=[],i,r)}o=p.length;while(o--)(a=p[o])&&-1<(i=v?P(e,a):s[o])&&(e[i]=!(t[i]=a))}}else p=Te(p===t?p.splice(l,p.length):p),v?v(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relative[e[0].type],a=o||b.relative[" "],s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=[function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r}];s<r;s++)if(t=b.relative[e[s].type])c=[be(we(c),t)];else{if((t=b.filter[e[s].type].apply(null,e[s].matches))[S]){for(n=++s;n<r;n++)if(b.relative[e[n].type])break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===e[s-2].type?"*":""})).replace(B,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=x[e+" "];if(l)return t?0:l.slice(0);a=e,s=[],u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r[0].length)||a),s.push(i=[])),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r[0].replace(B," ")}),a=a.slice(n.length)),b.filter)!(r=G[o].exec(a))||u[o]&&!(r=u[o](r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,y,v,m,x,r,i=[],o=[],a=A[e+" "];if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(t[n]))[S]?i.push(a):o.push(a);(a=A(e,(y=o,m=0<(v=i).length,x=0<y.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&[],f=[],p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=d[l]);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=y[a++])if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=v[a++])s(c,f,t,n);if(e){if(0<u)while(l--)c[l]||f[l]||(f[l]=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+v.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||[],1===c.length){if(2<(o=c[0]=c[0].slice(0)).length&&"ID"===(a=o[0]).type&&9===t.nodeType&&E&&b.relative[o[1].type]){if(!(t=(b.find.ID(a.matches[0].replace(te,ne),t)||[])[0]))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=o[i],b.relative[s=a.type])break;if((u=b.find[s])&&(r=u(a.matches[0].replace(te,ne),ee.test(o[0].type)&&ve(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ve(t.parentNode)||t),n},d.sortStable=S.split("").sort(j).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr[":"]=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=[],i=void 0!==n;while((e=e[t])&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?[r]:[]:S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(i[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)S.find(e,i[t],n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&k.test(e)?S(e):e||[],!1).length}});var D,q=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=[],a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this[0]):i.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge([],e.childNodes))}},function(r,i){S.fn[r]=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(H[r]||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/[^\x20\t\r\n\f]+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||[],function(e,t){n[t]=!0}),n):S.extend({},r);var i,t,o,a,s=[],u=[],l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===s[l].apply(t[0],t[1])&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?[]:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=[]),this},disable:function(){return a=u=[],s=t="",this},disabled:function(){return!s},lock:function(){return a=u=[],t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o=[["notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2],["resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved"],["reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected"]],i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(i[t[4]])&&i[t[4]];s[t[1]](function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):r[t[0]+"With"](this,n?[e]:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=[e]),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=[e]),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o[0][3].add(l(0,e,m(r)?r:R,e.notifyWith)),o[1][3].add(l(0,e,m(t)?t:R)),o[2][3].add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t[2],r=t[5];a[t[1]]=n.add,r&&n.add(function(){i=r},o[3-e][2].disable,o[3-e][3].disable,o[0][2].lock,o[0][3].lock),n.add(t[3].fire),s[t[0]]=function(){return s[t[0]+"With"](this===s?void 0:this,arguments),this},s[t[0]+"With"]=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){r[t]=this,i[t]=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(i[t]&&i[t].then)))return o.then();while(t--)I(i[t],a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function $(){E.removeEventListener("DOMContentLoaded",$),C.removeEventListener("load",$),S.ready()}S.fn.ready=function(e){return F.then(e)["catch"](function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,[S])}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",$),C.addEventListener("load",$));var B=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)B(e,t,s,n[s],!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(e[s],n,a?r:r.call(e[s],s,t(e[s],n)));return i?e:l?t.call(e):u?t(e[0],n):o},_=/^-ms-/,z=/-([a-z])/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=e[this.expando];return t||(t={},V(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)i[X(t)]=n;else for(r in t)i[X(r)]=t[r];return i},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][X(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?[t]:t.match(P)||[]).length;while(n--)delete r[t[n]]}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,K=/[A-Z]/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this[0],a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)a[t]&&0===(r=a[t].name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,i[r]));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):B(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this[0],t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e[0]&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,[o])};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(o[a],e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,te=new RegExp("^(?:([+-])=|)("+ee+")([a-z%]*)$","i"),ne=["Top","Right","Bottom","Left"],re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n[3]||(S.cssNumber[t]?"":"px"),c=e.nodeType&&(S.cssNumber[t]||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c[3]!==l){u/=2,l=l||c[3],c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||[]}return n&&(c=+c||+u||0,i=n[1]?c+(n[1]+1)*n[2]:+n[2],r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=[],c=0,f=e.length;c<f;c++)(r=e[c]).style&&(n=r.style.display,t?("none"===n&&(l[c]=Y.get(r,"display")||null,l[c]||(r.style.display="")),""===r.style.display&&ae(r)&&(l[c]=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ue[s])||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ue[s]=u)))):"none"!==n&&(l[c]="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=l[c]&&(e[c].style.display=l[c]);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),v.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",v.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",v.option=!!ce.lastChild;var ge={thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};function ye(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ve(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(e[n],"globalEval",!t||Y.get(t[n],"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,v.option||(ge.optgroup=ge.option=[1,"<select multiple='multiple'>","</select>"]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d<h;d++)if((o=e[d])||0===o)if("object"===w(o))S.merge(p,o.nodeType?[o]:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||["",""])[1].toLowerCase(),u=ge[s]||ge._default,a.innerHTML=u[1]+S.htmlPrefilter(o)+u[2],c=u[0];while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=p[d++])if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ye(f.appendChild(o),"script"),l&&ve(a),n){c=0;while(o=a[c++])he.test(o.type||"")&&n.push(o)}return f}var be=/^([^.]*)(?:\.(.+)|)/;function we(){return!0}function Te(){return!1}function Ce(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function Ee(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)Ee(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Te;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Se(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&this[i]){if(r.length)(S.event.special[i]||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),this[i](),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n&&n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r[0],S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,we)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,y=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=y.events)||(u=y.events=Object.create(null)),(a=y.handle)||(a=y.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||[""]).length;while(l--)d=g=(s=be.exec(e[l])||[])[1],h=(s[2]||"").split(".").sort(),d&&(f=S.event.special[d]||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.special[d]||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=u[d])||((p=u[d]=[]).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.global[d]=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,y=Y.hasData(e)&&Y.get(e);if(y&&(u=y.events)){l=(t=(t||"").match(P)||[""]).length;while(l--)if(d=g=(s=be.exec(t[l])||[])[1],h=(s[2]||"").split(".").sort(),d){f=S.event.special[d]||{},p=u[d=(r?f.delegateType:f.bindType)||d]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=p[o],!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,y.handle)||S.removeEvent(e,d,y.handle),delete u[d])}else for(d in u)S.event.remove(e,d+t[l],n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))[u.type]||[],c=S.event.special[u.type]||{};for(s[0]=u,t=1;t<arguments.length;t++)s[t]=arguments[t];if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=a[t++])&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlers[n++])&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=[],u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=[],a={},n=0;n<u;n++)void 0===a[i=(r=t[n]).selector+" "]&&(a[i]=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,[l]).length),a[i]&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[t]},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return e[S.expando]?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click",we),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?we:Te,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),this[S.expando]=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Te,isPropagationStopped:Te,isImmediatePropagationStopped:Te,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=we,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=we,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=we,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:!0},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(t,e){S.event.special[t]={setup:function(){return Se(this,t,Ce),!1},trigger:function(){return Se(this,t),!0},_default:function(e){return Y.get(e.target,t)},delegateType:e}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.special[e]={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return Ee(this,e,t,n,r)},one:function(e,t,n,r){return Ee(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Te),this.each(function(){S.event.remove(this,e,n,t)})}});var ke=/<script|<style|<link/i,Ae=/checked\s*(?:[^=]|=\s*.checked.)/i,Ne=/^\s*<!\[CDATA\[|\]\]>\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n<r;n++)S.event.add(t,i,s[i][n]);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function He(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r[0],h=m(d);if(h||1<f&&"string"==typeof d&&!v.checkClone&&Ae.test(d))return n.each(function(e){var t=n.eq(e);h&&(r[0]=d.call(this,e,t.html())),He(t,r,i,o)});if(f&&(t=(e=xe(r,n[0].ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ye(e,"script"),De)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ye(u,"script"))),i.call(n[c],u,c);if(s)for(l=a[a.length-1].ownerDocument,S.map(a,qe),c=0;c<s;c++)u=a[c],he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(Ne,""),u,l))}return n}function Oe(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=i[o]);o++)n||1!==r.nodeType||S.cleanData(ye(r)),r.parentNode&&(n&&ie(r)&&ve(ye(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(v.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ye(c),r=0,i=(o=ye(e)).length;r<i;r++)s=o[r],u=a[r],void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ye(e),a=a||ye(c),r=0,i=o.length;r<i;r++)Le(o[r],a[r]);else Le(e,c);return 0<(a=ye(c,"script")).length&&ve(a,!f&&ye(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=e[o]);o++)if(V(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?S.event.remove(n,r):S.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),S.fn.extend({detach:function(e){return Oe(this,e,!0)},remove:function(e){return Oe(this,e)},text:function(e){return B(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return He(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return He(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(S.cleanData(ye(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return B(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!ke.test(e)&&!ge[(de.exec(e)||["",""])[1].toLowerCase()]){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=this[n]||{}).nodeType&&(S.cleanData(ye(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=[];return He(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ye(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fn[e]=function(e){for(var t,n=[],r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(r[o])[a](t),u.apply(n,t.get());return this.pushStack(n)}});var Pe=new RegExp("^("+ee+")(?!px)[a-z%]+$","i"),Re=/^--/,Me=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},Ie=function(e,t,n){var r,i,o={};for(i in t)o[i]=e.style[i],e.style[i]=t[i];for(i in r=n.call(e),t)e.style[i]=o[i];return r},We=new RegExp(ne.join("|"),"i"),Fe="[\\x20\\t\\r\\n\\f]",$e=new RegExp("^"+Fe+"+|((?:^|[^\\\\])(?:\\\\.)*)"+Fe+"+$","g");function Be(e,t,n){var r,i,o,a,s=Re.test(t),u=e.style;return(n=n||Me(e))&&(a=n.getPropertyValue(t)||n[t],s&&(a=a.replace($e,"$1")),""!==a||ie(e)||(a=S.style(e,t)),!v.pixelBoxStyles()&&Pe.test(a)&&We.test(t)&&(r=u.width,i=u.minWidth,o=u.maxWidth,u.minWidth=u.maxWidth=u.width=a,a=n.width,u.width=r,u.minWidth=i,u.maxWidth=o)),void 0!==a?a+"":a}function _e(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",v.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(v,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px;border-collapse:separate",t.style.cssText="border:1px solid",t.style.height="1px",n.style.height="9px",n.style.display="block",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=parseInt(r.height,10)+parseInt(r.borderTopWidth,10)+parseInt(r.borderBottomWidth,10)===t.offsetHeight,re.removeChild(e)),a}}))}();var ze=["Webkit","Moz","ms"],Ue=E.createElement("div").style,Xe={};function Ve(e){var t=S.cssProps[e]||Xe[e];return t||(e in Ue?e:Xe[e]=function(e){var t=e[0].toUpperCase()+e.slice(1),n=ze.length;while(n--)if((e=ze[n]+t)in Ue)return e}(e)||e)}var Ge=/^(none|table(?!-c[ea]).+)/,Ye={position:"absolute",visibility:"hidden",display:"block"},Qe={letterSpacing:"0",fontWeight:"400"};function Je(e,t,n){var r=te.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function Ke(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+ne[a],!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+ne[a],!0,i)),"margin"!==n&&(u-=S.css(e,"border"+ne[a]+"Width",!0,i))):(u+=S.css(e,"padding"+ne[a],!0,i),"padding"!==n?u+=S.css(e,"border"+ne[a]+"Width",!0,i):s+=S.css(e,"border"+ne[a]+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-u-s-.5))||0),u}function Ze(e,t,n){var r=Me(e),i=(!v.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=Be(e,t,r),s="offset"+t[0].toUpperCase()+t.slice(1);if(Pe.test(a)){if(!n)return a;a="auto"}return(!v.boxSizingReliable()&&i||!v.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=e[s])),(a=parseFloat(a)||0)+Ke(e,t,n||(i?"border":"content"),o,r,a)+"px"}function et(e,t,n,r,i){return new et.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Be(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Re.test(t),l=e.style;if(u||(t=Ve(s)),a=S.cssHooks[t]||S.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:l[t];"string"===(o=typeof n)&&(i=te.exec(n))&&i[1]&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i[3]||(S.cssNumber[s]?"":"px")),v.clearCloneStyle||""!==n||0!==t.indexOf("background")||(l[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):l[t]=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Re.test(t)||(t=Ve(s)),(a=S.cssHooks[t]||S.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=Be(e,t,r)),"normal"===i&&t in Qe&&(i=Qe[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each(["height","width"],function(e,u){S.cssHooks[u]={get:function(e,t,n){if(t)return!Ge.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Ze(e,u,n):Ie(e,Ye,function(){return Ze(e,u,n)})},set:function(e,t,n){var r,i=Me(e),o=!v.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Ke(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e["offset"+u[0].toUpperCase()+u.slice(1)]-parseFloat(i[u])-Ke(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r[3]||"px")&&(e.style[u]=t,t=S.css(e,u)),Je(0,t,s)}}}),S.cssHooks.marginLeft=_e(v.reliableMarginLeft,function(e,t){if(t)return(parseFloat(Be(e,"marginLeft"))||e.getBoundingClientRect().left-Ie(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooks[i+o]={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):[e];t<4;t++)n[i+ne[t]+o]=r[t]||r[t-2]||r[0];return n}},"margin"!==i&&(S.cssHooks[i+o].set=Je)}),S.fn.extend({css:function(e,t){return B(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Me(e),i=t.length;a<i;a++)o[t[a]]=S.css(e,t[a],!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=et).prototype={constructor:et,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumber[n]?"":"px")},cur:function(){var e=et.propHooks[this.prop];return e&&e.get?e.get(this):et.propHooks._default.get(this)},run:function(e){var t,n=et.propHooks[this.prop];return this.options.duration?this.pos=t=S.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):et.propHooks._default.set(this),this}}).init.prototype=et.prototype,(et.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.step[e.prop]?S.fx.step[e.prop](e):1!==e.elem.nodeType||!S.cssHooks[e.prop]&&null==e.elem.style[Ve(e.prop)]?e.elem[e.prop]=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=et.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=et.prototype.init,S.fx.step={};var tt,nt,rt,it,ot=/^(?:toggle|show|hide)$/,at=/queueHooks$/;function st(){nt&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(st):C.setTimeout(st,S.fx.interval),S.fx.tick())}function ut(){return C.setTimeout(function(){tt=void 0}),tt=Date.now()}function lt(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i["margin"+(n=ne[r])]=i["padding"+n]=e;return t&&(i.opacity=i.width=e),i}function ct(e,t,n){for(var r,i=(ft.tweeners[t]||[]).concat(ft.tweeners["*"]),o=0,a=i.length;o<a;o++)if(r=i[o].call(n,t,e))return r}function ft(o,e,t){var n,a,r=0,i=ft.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=tt||ut(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweens[r].run(n);return s.notifyWith(o,[l,n,t]),n<1&&i?t:(i||s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l]),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:tt||ut(),duration:t.duration,tweens:[],createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasing[e]||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweens[t].run(1);return e?(s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l,e])):s.rejectWith(o,[l,e]),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=t[r=X(n)],o=e[n],Array.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),(a=S.cssHooks[r])&&"expand"in a)for(n in o=a.expand(o),delete e[r],o)n in e||(e[n]=o[n],t[n]=i);else t[r]=i}(c,l.opts.specialEasing);r<i;r++)if(n=ft.prefilters[r].call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ct,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(ft,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}]},tweener:function(e,t){m(e)?(t=e,e=["*"]):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=e[r],ft.tweeners[n]=ft.tweeners[n]||[],ft.tweeners[n].unshift(t)},prefilters:[function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),y=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=t[r],ot.test(i)){if(delete t[r],o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!y||void 0===y[r])continue;g=!0}d[r]=y&&y[r]||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=[h.overflow,h.overflowX,h.overflowY],null==(l=y&&y.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le([e],!0),l=e.style.display||l,c=S.css(e,"display"),le([e]))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow[0],h.overflowX=n.overflow[1],h.overflowY=n.overflow[2]})),u=!1,d)u||(y?"hidden"in y&&(g=y.hidden):y=Y.access(e,"fxshow",{display:l}),o&&(y.hidden=!g),g&&le([e],!0),p.done(function(){for(r in g||le([e]),Y.remove(e,"fxshow"),d)S.style(e,r,d[r])})),u=ct(g?y[r]:0,r,p),r in y||(y[r]=u.start,g&&(u.end=u.start,u.start=0))}],prefilter:function(e,t){t?ft.prefilters.unshift(e):ft.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speeds[r.duration]:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=ft(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",[]),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)r[t]&&r[t].stop&&a(r[t]);else for(t in r)r[t]&&r[t].stop&&at.test(t)&&a(r[t]);for(t=n.length;t--;)n[t].elem!==this||null!=i&&n[t].queue!==i||(n[t].anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=t[a+"queue"],r=t[a+"queueHooks"],i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,[]),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)i[e].elem===this&&i[e].queue===a&&(i[e].anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)n[e]&&n[e].finish&&n[e].finish.call(this);delete t.finish})}}),S.each(["toggle","show","hide"],function(e,r){var i=S.fn[r];S.fn[r]=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(lt(r,!0),e,t,n)}}),S.each({slideDown:lt("show"),slideUp:lt("hide"),slideToggle:lt("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fn[e]=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=[],S.fx.tick=function(){var e,t=0,n=S.timers;for(tt=Date.now();t<n.length;t++)(e=n[t])()||n[t]!==e||n.splice(t--,1);n.length||S.fx.stop(),tt=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){nt||(nt=!0,st())},S.fx.stop=function(){nt=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speeds[r]||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},rt=E.createElement("input"),it=E.createElement("select").appendChild(E.createElement("option")),rt.type="checkbox",v.checkOn=""!==rt.value,v.optSelected=it.selected,(rt=E.createElement("input")).value="t",rt.type="radio",v.radioValue="t"===rt.value;var pt,dt=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return B(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHooks[t.toLowerCase()]||(S.expr.match.bool.test(t)?pt:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!v.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=i[r++])e.removeAttribute(n)}}),pt={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=dt[t]||S.find.attr;dt[t]=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=dt[o],dt[o]=r,r=null!=a(e,t,n)?o:null,dt[o]=i),r}});var ht=/^(?:input|select|textarea|button)$/i,gt=/^(?:a|area)$/i;function yt(e){return(e.match(P)||[]).join(" ")}function vt(e){return e.getAttribute&&e.getAttribute("class")||""}function mt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||[]}S.fn.extend({prop:function(e,t){return B(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete this[S.propFix[e]||e]})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFix[t]||t,i=S.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):ht.test(e.nodeName)||gt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),v.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){S.propFix[this.toLowerCase()]=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a;return m(t)?this.each(function(e){S(this).addClass(t.call(this,e,vt(this)))}):(e=mt(t)).length?this.each(function(){if(r=vt(this),n=1===this.nodeType&&" "+yt(r)+" "){for(o=0;o<e.length;o++)i=e[o],n.indexOf(" "+i+" ")<0&&(n+=i+" ");a=yt(n),r!==a&&this.setAttribute("class",a)}}):this},removeClass:function(t){var e,n,r,i,o,a;return m(t)?this.each(function(e){S(this).removeClass(t.call(this,e,vt(this)))}):arguments.length?(e=mt(t)).length?this.each(function(){if(r=vt(this),n=1===this.nodeType&&" "+yt(r)+" "){for(o=0;o<e.length;o++){i=e[o];while(-1<n.indexOf(" "+i+" "))n=n.replace(" "+i+" "," ")}a=yt(n),r!==a&&this.setAttribute("class",a)}}):this:this.attr("class","")},toggleClass:function(t,n){var e,r,i,o,a=typeof t,s="string"===a||Array.isArray(t);return m(t)?this.each(function(e){S(this).toggleClass(t.call(this,e,vt(this),n),n)}):"boolean"==typeof n&&s?n?this.addClass(t):this.removeClass(t):(e=mt(t),this.each(function(){if(s)for(o=S(this),i=0;i<e.length;i++)r=e[i],o.hasClass(r)?o.removeClass(r):o.addClass(r);else void 0!==t&&"boolean"!==a||((r=vt(this))&&Y.set(this,"__className__",r),this.setAttribute&&this.setAttribute("class",r||!1===t?"":Y.get(this,"__className__")||""))}))},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=this[r++])if(1===n.nodeType&&-1<(" "+yt(vt(n))+" ").indexOf(t))return!0;return!1}});var xt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this[0];return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooks[this.type]||S.valHooks[this.nodeName.toLowerCase()])&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHooks[t.type]||S.valHooks[t.nodeName.toLowerCase()])&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(xt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:yt(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=i[r]).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=i[a]).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each(["radio","checkbox"],function(){S.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},v.checkOn||(S.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),v.focusin="onfocusin"in C;var bt=/^(?:focusinfocus|focusoutblur)$/,wt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=[n||E],d=y.call(e,"type")?e.type:e,h=y.call(e,"namespace")?e.namespace.split("."):[];if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!bt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=e[S.expando]?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?[e]:S.makeArray(t,[e]),c=S.event.special[d]||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,bt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=p[i++])&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))[e.type]&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&o[u])&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(n[d])&&!x(n)&&((a=n[u])&&(n[u]=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,wt),n[d](),e.isPropagationStopped()&&f.removeEventListener(d,wt),S.event.triggered=void 0,a&&(n[u]=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return S.event.trigger(e,t,n,!0)}}),v.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.special[r]={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var Tt=C.location,Ct={guid:Date.now()},Et=/\?/;S.parseXML=function(e){var t,n;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){}return n=t&&t.getElementsByTagName("parsererror")[0],t&&!n||S.error("Invalid XML: "+(n?S.map(n.childNodes,function(e){return e.textContent}).join("\n"):e)),t};var St=/\[\]$/,kt=/\r?\n/g,At=/^(?:submit|button|image|reset|file)$/i,Nt=/^(?:input|select|textarea|keygen)/i;function jt(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||St.test(n)?i(n,t):jt(n+"["+("object"==typeof t&&null!=t?e:"")+"]",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)jt(n+"["+t+"]",e[t],r,i)}S.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)jt(n,e[n],t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&Nt.test(this.nodeName)&&!At.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(kt,"\r\n")}}):{name:t.name,value:n.replace(kt,"\r\n")}}).get()}});var Dt=/%20/g,qt=/#.*$/,Lt=/([?&])_=[^&]*/,Ht=/^(.*?):[ \t]*([^\r\n]*)$/gm,Ot=/^(?:GET|HEAD)$/,Pt=/^\/\//,Rt={},Mt={},It="*/".concat("*"),Wt=E.createElement("a");function Ft(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||[];if(m(t))while(n=i[r++])"+"===n[0]?(n=n.slice(1)||"*",(o[n]=o[n]||[]).unshift(t)):(o[n]=o[n]||[]).push(t)}}function $t(t,i,o,a){var s={},u=t===Mt;function l(e){var r;return s[e]=!0,S.each(t[e]||[],function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||s[n]?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes[0])||!s["*"]&&l("*")}function Bt(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((i[n]?e:r||(r={}))[n]=t[n]);return r&&S.extend(!0,e,r),e}Wt.href=Tt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Tt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(Tt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":It,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Bt(Bt(e,S.ajaxSettings),t):Bt(S.ajaxSettings,e)},ajaxPrefilter:Ft(Rt),ajaxTransport:Ft(Mt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,y=S.ajaxSetup({},t),v=y.context||y,m=y.context&&(v.nodeType||v.jquery)?S(v):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=y.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=Ht.exec(p))n[t[1].toLowerCase()+" "]=(n[t[1].toLowerCase()+" "]||[]).concat(t[2])}t=n[e.toLowerCase()+" "]}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=s[e.toLowerCase()]=s[e.toLowerCase()]||e,a[e]=t),this},overrideMimeType:function(e){return null==h&&(y.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(e[T.status]);else for(t in e)w[t]=[w[t],e[t]];return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),y.url=((e||y.url||Tt.href)+"").replace(Pt,Tt.protocol+"//"),y.type=t.method||t.type||y.method||y.type,y.dataTypes=(y.dataType||"*").toLowerCase().match(P)||[""],null==y.crossDomain){r=E.createElement("a");try{r.href=y.url,r.href=r.href,y.crossDomain=Wt.protocol+"//"+Wt.host!=r.protocol+"//"+r.host}catch(e){y.crossDomain=!0}}if(y.data&&y.processData&&"string"!=typeof y.data&&(y.data=S.param(y.data,y.traditional)),$t(Rt,y,t,T),h)return T;for(i in(g=S.event&&y.global)&&0==S.active++&&S.event.trigger("ajaxStart"),y.type=y.type.toUpperCase(),y.hasContent=!Ot.test(y.type),f=y.url.replace(qt,""),y.hasContent?y.data&&y.processData&&0===(y.contentType||"").indexOf("application/x-www-form-urlencoded")&&(y.data=y.data.replace(Dt,"+")):(o=y.url.slice(f.length),y.data&&(y.processData||"string"==typeof y.data)&&(f+=(Et.test(f)?"&":"?")+y.data,delete y.data),!1===y.cache&&(f=f.replace(Lt,"$1"),o=(Et.test(f)?"&":"?")+"_="+Ct.guid+++o),y.url=f+o),y.ifModified&&(S.lastModified[f]&&T.setRequestHeader("If-Modified-Since",S.lastModified[f]),S.etag[f]&&T.setRequestHeader("If-None-Match",S.etag[f])),(y.data&&y.hasContent&&!1!==y.contentType||t.contentType)&&T.setRequestHeader("Content-Type",y.contentType),T.setRequestHeader("Accept",y.dataTypes[0]&&y.accepts[y.dataTypes[0]]?y.accepts[y.dataTypes[0]]+("*"!==y.dataTypes[0]?", "+It+"; q=0.01":""):y.accepts["*"]),y.headers)T.setRequestHeader(i,y.headers[i]);if(y.beforeSend&&(!1===y.beforeSend.call(v,T,y)||h))return T.abort();if(u="abort",b.add(y.complete),T.done(y.success),T.fail(y.error),c=$t(Mt,y,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",[T,y]),h)return T;y.async&&0<y.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},y.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(s[i]&&s[i].test(r)){u.unshift(i);break}if(u[0]in n)o=u[0];else{for(i in n){if(!u[0]||e.converters[i+" "+u[0]]){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u[0]&&u.unshift(o),n[o]}(y,T,n)),!i&&-1<S.inArray("script",y.dataTypes)&&S.inArray("json",y.dataTypes)<0&&(y.converters["text script"]=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)l[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=l[u+" "+o]||l["* "+o]))for(i in l)if((s=i.split(" "))[1]===o&&(a=l[u+" "+s[0]]||l["* "+s[0]])){!0===a?a=l[i]:!0!==l[i]&&(o=s[0],c.unshift(s[1]));break}if(!0!==a)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(y,s,T,i),i?(y.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModified[f]=u),(u=T.getResponseHeader("etag"))&&(S.etag[f]=u)),204===e||"HEAD"===y.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(v,[o,l,T]):x.rejectWith(v,[T,l,a]),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",[T,y,i?o:a]),b.fireWith(v,[T,l]),g&&(m.trigger("ajaxComplete",[T,y]),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each(["get","post"],function(e,i){S[i]=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headers[t]||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=S(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var _t={0:200,1223:204},zt=S.ajaxSettings.xhr();v.cors=!!zt&&"withCredentials"in zt,v.ajax=zt=!!zt,S.ajaxTransport(function(i){var o,a;if(v.cors||zt&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)r[n]=i.xhrFields[n];for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e["X-Requested-With"]||(e["X-Requested-With"]="XMLHttpRequest"),e)r.setRequestHeader(n,e[n]);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(_t[r.status]||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var Ut,Xt=[],Vt=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Xt.pop()||S.expando+"_"+Ct.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Vt.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Vt.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Vt,"$1"+r):!1!==e.jsonp&&(e.url+=(Et.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,Xt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),v.createHTMLDocument=((Ut=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===Ut.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(v.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=yt(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return B(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=_e(v.pixelPosition,function(e,t){if(t)return t=Be(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return B(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Gt=/^[\s\uFEFF\xA0]+|([^\s\uFEFF\xA0])[\s\uFEFF\xA0]+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Gt,"$1")},"function"==typeof define&&define.amd&&define("jquery",[],function(){return S});var Yt=C.jQuery,Qt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Qt),e&&C.jQuery===S&&(C.jQuery=Yt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});
php-code-coverage/src/Report/Html/Renderer/Template/js/file.js 0000644 00000002771 15243417753 0020236 0 ustar 00 $(function() {
var $window = $(window)
, $top_link = $('#toplink')
, $body = $('body, html')
, offset = $('#code').offset().top
, hidePopover = function ($target) {
$target.data('popover-hover', false);
setTimeout(function () {
if (!$target.data('popover-hover')) {
$target.popover('hide');
}
}, 300);
};
$top_link.hide().click(function(event) {
event.preventDefault();
$body.animate({scrollTop:0}, 800);
});
$window.scroll(function() {
if($window.scrollTop() > offset) {
$top_link.fadeIn();
} else {
$top_link.fadeOut();
}
}).scroll();
$('.popin')
.popover({trigger: 'manual'})
.on({
'mouseenter.popover': function () {
var $target = $(this);
var $container = $target.children().first();
$target.data('popover-hover', true);
// popover already displayed
if ($target.next('.popover').length) {
return;
}
// show the popover
$container.popover('show');
// register mouse events on the popover
$target.next('.popover:not(.popover-initialized)')
.on({
'mouseenter': function () {
$target.data('popover-hover', true);
},
'mouseleave': function () {
hidePopover($container);
}
})
.addClass('popover-initialized');
},
'mouseleave.popover': function () {
hidePopover($(this).children().first());
}
});
});
php-code-coverage/src/Report/Html/Renderer/Template/js/d3.min.js 0000644 00000450255 15243417753 0020413 0 ustar 00 !function(){function n(n){return n&&(n.ownerDocument||n.document||n).documentElement}function t(n){return n&&(n.ownerDocument&&n.ownerDocument.defaultView||n.document&&n||n.defaultView)}function e(n,t){return t>n?-1:n>t?1:n>=t?0:NaN}function r(n){return null===n?NaN:+n}function i(n){return!isNaN(n)}function u(n){return{left:function(t,e,r,i){for(arguments.length<3&&(r=0),arguments.length<4&&(i=t.length);i>r;){var u=r+i>>>1;n(t[u],e)<0?r=u+1:i=u}return r},right:function(t,e,r,i){for(arguments.length<3&&(r=0),arguments.length<4&&(i=t.length);i>r;){var u=r+i>>>1;n(t[u],e)>0?i=u:r=u+1}return r}}}function o(n){return n.length}function a(n){for(var t=1;n*t%1;)t*=10;return t}function l(n,t){for(var e in t)Object.defineProperty(n.prototype,e,{value:t[e],enumerable:!1})}function c(){this._=Object.create(null)}function f(n){return(n+="")===bo||n[0]===_o?_o+n:n}function s(n){return(n+="")[0]===_o?n.slice(1):n}function h(n){return f(n)in this._}function p(n){return(n=f(n))in this._&&delete this._[n]}function g(){var n=[];for(var t in this._)n.push(s(t));return n}function v(){var n=0;for(var t in this._)++n;return n}function d(){for(var n in this._)return!1;return!0}function y(){this._=Object.create(null)}function m(n){return n}function M(n,t,e){return function(){var r=e.apply(t,arguments);return r===t?n:r}}function x(n,t){if(t in n)return t;t=t.charAt(0).toUpperCase()+t.slice(1);for(var e=0,r=wo.length;r>e;++e){var i=wo[e]+t;if(i in n)return i}}function b(){}function _(){}function w(n){function t(){for(var t,r=e,i=-1,u=r.length;++i<u;)(t=r[i].on)&&t.apply(this,arguments);return n}var e=[],r=new c;return t.on=function(t,i){var u,o=r.get(t);return arguments.length<2?o&&o.on:(o&&(o.on=null,e=e.slice(0,u=e.indexOf(o)).concat(e.slice(u+1)),r.remove(t)),i&&e.push(r.set(t,{on:i})),n)},t}function S(){ao.event.preventDefault()}function k(){for(var n,t=ao.event;n=t.sourceEvent;)t=n;return t}function N(n){for(var t=new _,e=0,r=arguments.length;++e<r;)t[arguments[e]]=w(t);return t.of=function(e,r){return function(i){try{var u=i.sourceEvent=ao.event;i.target=n,ao.event=i,t[i.type].apply(e,r)}finally{ao.event=u}}},t}function E(n){return ko(n,Co),n}function A(n){return"function"==typeof n?n:function(){return No(n,this)}}function C(n){return"function"==typeof n?n:function(){return Eo(n,this)}}function z(n,t){function e(){this.removeAttribute(n)}function r(){this.removeAttributeNS(n.space,n.local)}function i(){this.setAttribute(n,t)}function u(){this.setAttributeNS(n.space,n.local,t)}function o(){var e=t.apply(this,arguments);null==e?this.removeAttribute(n):this.setAttribute(n,e)}function a(){var e=t.apply(this,arguments);null==e?this.removeAttributeNS(n.space,n.local):this.setAttributeNS(n.space,n.local,e)}return n=ao.ns.qualify(n),null==t?n.local?r:e:"function"==typeof t?n.local?a:o:n.local?u:i}function L(n){return n.trim().replace(/\s+/g," ")}function q(n){return new RegExp("(?:^|\\s+)"+ao.requote(n)+"(?:\\s+|$)","g")}function T(n){return(n+"").trim().split(/^|\s+/)}function R(n,t){function e(){for(var e=-1;++e<i;)n[e](this,t)}function r(){for(var e=-1,r=t.apply(this,arguments);++e<i;)n[e](this,r)}n=T(n).map(D);var i=n.length;return"function"==typeof t?r:e}function D(n){var t=q(n);return function(e,r){if(i=e.classList)return r?i.add(n):i.remove(n);var i=e.getAttribute("class")||"";r?(t.lastIndex=0,t.test(i)||e.setAttribute("class",L(i+" "+n))):e.setAttribute("class",L(i.replace(t," ")))}}function P(n,t,e){function r(){this.style.removeProperty(n)}function i(){this.style.setProperty(n,t,e)}function u(){var r=t.apply(this,arguments);null==r?this.style.removeProperty(n):this.style.setProperty(n,r,e)}return null==t?r:"function"==typeof t?u:i}function U(n,t){function e(){delete this[n]}function r(){this[n]=t}function i(){var e=t.apply(this,arguments);null==e?delete this[n]:this[n]=e}return null==t?e:"function"==typeof t?i:r}function j(n){function t(){var t=this.ownerDocument,e=this.namespaceURI;return e===zo&&t.documentElement.namespaceURI===zo?t.createElement(n):t.createElementNS(e,n)}function e(){return this.ownerDocument.createElementNS(n.space,n.local)}return"function"==typeof n?n:(n=ao.ns.qualify(n)).local?e:t}function F(){var n=this.parentNode;n&&n.removeChild(this)}function H(n){return{__data__:n}}function O(n){return function(){return Ao(this,n)}}function I(n){return arguments.length||(n=e),function(t,e){return t&&e?n(t.__data__,e.__data__):!t-!e}}function Y(n,t){for(var e=0,r=n.length;r>e;e++)for(var i,u=n[e],o=0,a=u.length;a>o;o++)(i=u[o])&&t(i,o,e);return n}function Z(n){return ko(n,qo),n}function V(n){var t,e;return function(r,i,u){var o,a=n[u].update,l=a.length;for(u!=e&&(e=u,t=0),i>=t&&(t=i+1);!(o=a[t])&&++t<l;);return o}}function X(n,t,e){function r(){var t=this[o];t&&(this.removeEventListener(n,t,t.$),delete this[o])}function i(){var i=l(t,co(arguments));r.call(this),this.addEventListener(n,this[o]=i,i.$=e),i._=t}function u(){var t,e=new RegExp("^__on([^.]+)"+ao.requote(n)+"$");for(var r in this)if(t=r.match(e)){var i=this[r];this.removeEventListener(t[1],i,i.$),delete this[r]}}var o="__on"+n,a=n.indexOf("."),l=$;a>0&&(n=n.slice(0,a));var c=To.get(n);return c&&(n=c,l=B),a?t?i:r:t?b:u}function $(n,t){return function(e){var r=ao.event;ao.event=e,t[0]=this.__data__;try{n.apply(this,t)}finally{ao.event=r}}}function B(n,t){var e=$(n,t);return function(n){var t=this,r=n.relatedTarget;r&&(r===t||8&r.compareDocumentPosition(t))||e.call(t,n)}}function W(e){var r=".dragsuppress-"+ ++Do,i="click"+r,u=ao.select(t(e)).on("touchmove"+r,S).on("dragstart"+r,S).on("selectstart"+r,S);if(null==Ro&&(Ro="onselectstart"in e?!1:x(e.style,"userSelect")),Ro){var o=n(e).style,a=o[Ro];o[Ro]="none"}return function(n){if(u.on(r,null),Ro&&(o[Ro]=a),n){var t=function(){u.on(i,null)};u.on(i,function(){S(),t()},!0),setTimeout(t,0)}}}function J(n,e){e.changedTouches&&(e=e.changedTouches[0]);var r=n.ownerSVGElement||n;if(r.createSVGPoint){var i=r.createSVGPoint();if(0>Po){var u=t(n);if(u.scrollX||u.scrollY){r=ao.select("body").append("svg").style({position:"absolute",top:0,left:0,margin:0,padding:0,border:"none"},"important");var o=r[0][0].getScreenCTM();Po=!(o.f||o.e),r.remove()}}return Po?(i.x=e.pageX,i.y=e.pageY):(i.x=e.clientX,i.y=e.clientY),i=i.matrixTransform(n.getScreenCTM().inverse()),[i.x,i.y]}var a=n.getBoundingClientRect();return[e.clientX-a.left-n.clientLeft,e.clientY-a.top-n.clientTop]}function G(){return ao.event.changedTouches[0].identifier}function K(n){return n>0?1:0>n?-1:0}function Q(n,t,e){return(t[0]-n[0])*(e[1]-n[1])-(t[1]-n[1])*(e[0]-n[0])}function nn(n){return n>1?0:-1>n?Fo:Math.acos(n)}function tn(n){return n>1?Io:-1>n?-Io:Math.asin(n)}function en(n){return((n=Math.exp(n))-1/n)/2}function rn(n){return((n=Math.exp(n))+1/n)/2}function un(n){return((n=Math.exp(2*n))-1)/(n+1)}function on(n){return(n=Math.sin(n/2))*n}function an(){}function ln(n,t,e){return this instanceof ln?(this.h=+n,this.s=+t,void(this.l=+e)):arguments.length<2?n instanceof ln?new ln(n.h,n.s,n.l):_n(""+n,wn,ln):new ln(n,t,e)}function cn(n,t,e){function r(n){return n>360?n-=360:0>n&&(n+=360),60>n?u+(o-u)*n/60:180>n?o:240>n?u+(o-u)*(240-n)/60:u}function i(n){return Math.round(255*r(n))}var u,o;return n=isNaN(n)?0:(n%=360)<0?n+360:n,t=isNaN(t)?0:0>t?0:t>1?1:t,e=0>e?0:e>1?1:e,o=.5>=e?e*(1+t):e+t-e*t,u=2*e-o,new mn(i(n+120),i(n),i(n-120))}function fn(n,t,e){return this instanceof fn?(this.h=+n,this.c=+t,void(this.l=+e)):arguments.length<2?n instanceof fn?new fn(n.h,n.c,n.l):n instanceof hn?gn(n.l,n.a,n.b):gn((n=Sn((n=ao.rgb(n)).r,n.g,n.b)).l,n.a,n.b):new fn(n,t,e)}function sn(n,t,e){return isNaN(n)&&(n=0),isNaN(t)&&(t=0),new hn(e,Math.cos(n*=Yo)*t,Math.sin(n)*t)}function hn(n,t,e){return this instanceof hn?(this.l=+n,this.a=+t,void(this.b=+e)):arguments.length<2?n instanceof hn?new hn(n.l,n.a,n.b):n instanceof fn?sn(n.h,n.c,n.l):Sn((n=mn(n)).r,n.g,n.b):new hn(n,t,e)}function pn(n,t,e){var r=(n+16)/116,i=r+t/500,u=r-e/200;return i=vn(i)*na,r=vn(r)*ta,u=vn(u)*ea,new mn(yn(3.2404542*i-1.5371385*r-.4985314*u),yn(-.969266*i+1.8760108*r+.041556*u),yn(.0556434*i-.2040259*r+1.0572252*u))}function gn(n,t,e){return n>0?new fn(Math.atan2(e,t)*Zo,Math.sqrt(t*t+e*e),n):new fn(NaN,NaN,n)}function vn(n){return n>.206893034?n*n*n:(n-4/29)/7.787037}function dn(n){return n>.008856?Math.pow(n,1/3):7.787037*n+4/29}function yn(n){return Math.round(255*(.00304>=n?12.92*n:1.055*Math.pow(n,1/2.4)-.055))}function mn(n,t,e){return this instanceof mn?(this.r=~~n,this.g=~~t,void(this.b=~~e)):arguments.length<2?n instanceof mn?new mn(n.r,n.g,n.b):_n(""+n,mn,cn):new mn(n,t,e)}function Mn(n){return new mn(n>>16,n>>8&255,255&n)}function xn(n){return Mn(n)+""}function bn(n){return 16>n?"0"+Math.max(0,n).toString(16):Math.min(255,n).toString(16)}function _n(n,t,e){var r,i,u,o=0,a=0,l=0;if(r=/([a-z]+)\((.*)\)/.exec(n=n.toLowerCase()))switch(i=r[2].split(","),r[1]){case"hsl":return e(parseFloat(i[0]),parseFloat(i[1])/100,parseFloat(i[2])/100);case"rgb":return t(Nn(i[0]),Nn(i[1]),Nn(i[2]))}return(u=ua.get(n))?t(u.r,u.g,u.b):(null==n||"#"!==n.charAt(0)||isNaN(u=parseInt(n.slice(1),16))||(4===n.length?(o=(3840&u)>>4,o=o>>4|o,a=240&u,a=a>>4|a,l=15&u,l=l<<4|l):7===n.length&&(o=(16711680&u)>>16,a=(65280&u)>>8,l=255&u)),t(o,a,l))}function wn(n,t,e){var r,i,u=Math.min(n/=255,t/=255,e/=255),o=Math.max(n,t,e),a=o-u,l=(o+u)/2;return a?(i=.5>l?a/(o+u):a/(2-o-u),r=n==o?(t-e)/a+(e>t?6:0):t==o?(e-n)/a+2:(n-t)/a+4,r*=60):(r=NaN,i=l>0&&1>l?0:r),new ln(r,i,l)}function Sn(n,t,e){n=kn(n),t=kn(t),e=kn(e);var r=dn((.4124564*n+.3575761*t+.1804375*e)/na),i=dn((.2126729*n+.7151522*t+.072175*e)/ta),u=dn((.0193339*n+.119192*t+.9503041*e)/ea);return hn(116*i-16,500*(r-i),200*(i-u))}function kn(n){return(n/=255)<=.04045?n/12.92:Math.pow((n+.055)/1.055,2.4)}function Nn(n){var t=parseFloat(n);return"%"===n.charAt(n.length-1)?Math.round(2.55*t):t}function En(n){return"function"==typeof n?n:function(){return n}}function An(n){return function(t,e,r){return 2===arguments.length&&"function"==typeof e&&(r=e,e=null),Cn(t,e,n,r)}}function Cn(n,t,e,r){function i(){var n,t=l.status;if(!t&&Ln(l)||t>=200&&300>t||304===t){try{n=e.call(u,l)}catch(r){return void o.error.call(u,r)}o.load.call(u,n)}else o.error.call(u,l)}var u={},o=ao.dispatch("beforesend","progress","load","error"),a={},l=new XMLHttpRequest,c=null;return!this.XDomainRequest||"withCredentials"in l||!/^(http(s)?:)?\/\//.test(n)||(l=new XDomainRequest),"onload"in l?l.onload=l.onerror=i:l.onreadystatechange=function(){l.readyState>3&&i()},l.onprogress=function(n){var t=ao.event;ao.event=n;try{o.progress.call(u,l)}finally{ao.event=t}},u.header=function(n,t){return n=(n+"").toLowerCase(),arguments.length<2?a[n]:(null==t?delete a[n]:a[n]=t+"",u)},u.mimeType=function(n){return arguments.length?(t=null==n?null:n+"",u):t},u.responseType=function(n){return arguments.length?(c=n,u):c},u.response=function(n){return e=n,u},["get","post"].forEach(function(n){u[n]=function(){return u.send.apply(u,[n].concat(co(arguments)))}}),u.send=function(e,r,i){if(2===arguments.length&&"function"==typeof r&&(i=r,r=null),l.open(e,n,!0),null==t||"accept"in a||(a.accept=t+",*/*"),l.setRequestHeader)for(var f in a)l.setRequestHeader(f,a[f]);return null!=t&&l.overrideMimeType&&l.overrideMimeType(t),null!=c&&(l.responseType=c),null!=i&&u.on("error",i).on("load",function(n){i(null,n)}),o.beforesend.call(u,l),l.send(null==r?null:r),u},u.abort=function(){return l.abort(),u},ao.rebind(u,o,"on"),null==r?u:u.get(zn(r))}function zn(n){return 1===n.length?function(t,e){n(null==t?e:null)}:n}function Ln(n){var t=n.responseType;return t&&"text"!==t?n.response:n.responseText}function qn(n,t,e){var r=arguments.length;2>r&&(t=0),3>r&&(e=Date.now());var i=e+t,u={c:n,t:i,n:null};return aa?aa.n=u:oa=u,aa=u,la||(ca=clearTimeout(ca),la=1,fa(Tn)),u}function Tn(){var n=Rn(),t=Dn()-n;t>24?(isFinite(t)&&(clearTimeout(ca),ca=setTimeout(Tn,t)),la=0):(la=1,fa(Tn))}function Rn(){for(var n=Date.now(),t=oa;t;)n>=t.t&&t.c(n-t.t)&&(t.c=null),t=t.n;return n}function Dn(){for(var n,t=oa,e=1/0;t;)t.c?(t.t<e&&(e=t.t),t=(n=t).n):t=n?n.n=t.n:oa=t.n;return aa=n,e}function Pn(n,t){return t-(n?Math.ceil(Math.log(n)/Math.LN10):1)}function Un(n,t){var e=Math.pow(10,3*xo(8-t));return{scale:t>8?function(n){return n/e}:function(n){return n*e},symbol:n}}function jn(n){var t=n.decimal,e=n.thousands,r=n.grouping,i=n.currency,u=r&&e?function(n,t){for(var i=n.length,u=[],o=0,a=r[0],l=0;i>0&&a>0&&(l+a+1>t&&(a=Math.max(1,t-l)),u.push(n.substring(i-=a,i+a)),!((l+=a+1)>t));)a=r[o=(o+1)%r.length];return u.reverse().join(e)}:m;return function(n){var e=ha.exec(n),r=e[1]||" ",o=e[2]||">",a=e[3]||"-",l=e[4]||"",c=e[5],f=+e[6],s=e[7],h=e[8],p=e[9],g=1,v="",d="",y=!1,m=!0;switch(h&&(h=+h.substring(1)),(c||"0"===r&&"="===o)&&(c=r="0",o="="),p){case"n":s=!0,p="g";break;case"%":g=100,d="%",p="f";break;case"p":g=100,d="%",p="r";break;case"b":case"o":case"x":case"X":"#"===l&&(v="0"+p.toLowerCase());case"c":m=!1;case"d":y=!0,h=0;break;case"s":g=-1,p="r"}"$"===l&&(v=i[0],d=i[1]),"r"!=p||h||(p="g"),null!=h&&("g"==p?h=Math.max(1,Math.min(21,h)):"e"!=p&&"f"!=p||(h=Math.max(0,Math.min(20,h)))),p=pa.get(p)||Fn;var M=c&&s;return function(n){var e=d;if(y&&n%1)return"";var i=0>n||0===n&&0>1/n?(n=-n,"-"):"-"===a?"":a;if(0>g){var l=ao.formatPrefix(n,h);n=l.scale(n),e=l.symbol+d}else n*=g;n=p(n,h);var x,b,_=n.lastIndexOf(".");if(0>_){var w=m?n.lastIndexOf("e"):-1;0>w?(x=n,b=""):(x=n.substring(0,w),b=n.substring(w))}else x=n.substring(0,_),b=t+n.substring(_+1);!c&&s&&(x=u(x,1/0));var S=v.length+x.length+b.length+(M?0:i.length),k=f>S?new Array(S=f-S+1).join(r):"";return M&&(x=u(k+x,k.length?f-b.length:1/0)),i+=v,n=x+b,("<"===o?i+n+k:">"===o?k+i+n:"^"===o?k.substring(0,S>>=1)+i+n+k.substring(S):i+(M?n:k+n))+e}}}function Fn(n){return n+""}function Hn(){this._=new Date(arguments.length>1?Date.UTC.apply(this,arguments):arguments[0])}function On(n,t,e){function r(t){var e=n(t),r=u(e,1);return r-t>t-e?e:r}function i(e){return t(e=n(new va(e-1)),1),e}function u(n,e){return t(n=new va(+n),e),n}function o(n,r,u){var o=i(n),a=[];if(u>1)for(;r>o;)e(o)%u||a.push(new Date(+o)),t(o,1);else for(;r>o;)a.push(new Date(+o)),t(o,1);return a}function a(n,t,e){try{va=Hn;var r=new Hn;return r._=n,o(r,t,e)}finally{va=Date}}n.floor=n,n.round=r,n.ceil=i,n.offset=u,n.range=o;var l=n.utc=In(n);return l.floor=l,l.round=In(r),l.ceil=In(i),l.offset=In(u),l.range=a,n}function In(n){return function(t,e){try{va=Hn;var r=new Hn;return r._=t,n(r,e)._}finally{va=Date}}}function Yn(n){function t(n){function t(t){for(var e,i,u,o=[],a=-1,l=0;++a<r;)37===n.charCodeAt(a)&&(o.push(n.slice(l,a)),null!=(i=ya[e=n.charAt(++a)])&&(e=n.charAt(++a)),(u=A[e])&&(e=u(t,null==i?"e"===e?" ":"0":i)),o.push(e),l=a+1);return o.push(n.slice(l,a)),o.join("")}var r=n.length;return t.parse=function(t){var r={y:1900,m:0,d:1,H:0,M:0,S:0,L:0,Z:null},i=e(r,n,t,0);if(i!=t.length)return null;"p"in r&&(r.H=r.H%12+12*r.p);var u=null!=r.Z&&va!==Hn,o=new(u?Hn:va);return"j"in r?o.setFullYear(r.y,0,r.j):"W"in r||"U"in r?("w"in r||(r.w="W"in r?1:0),o.setFullYear(r.y,0,1),o.setFullYear(r.y,0,"W"in r?(r.w+6)%7+7*r.W-(o.getDay()+5)%7:r.w+7*r.U-(o.getDay()+6)%7)):o.setFullYear(r.y,r.m,r.d),o.setHours(r.H+(r.Z/100|0),r.M+r.Z%100,r.S,r.L),u?o._:o},t.toString=function(){return n},t}function e(n,t,e,r){for(var i,u,o,a=0,l=t.length,c=e.length;l>a;){if(r>=c)return-1;if(i=t.charCodeAt(a++),37===i){if(o=t.charAt(a++),u=C[o in ya?t.charAt(a++):o],!u||(r=u(n,e,r))<0)return-1}else if(i!=e.charCodeAt(r++))return-1}return r}function r(n,t,e){_.lastIndex=0;var r=_.exec(t.slice(e));return r?(n.w=w.get(r[0].toLowerCase()),e+r[0].length):-1}function i(n,t,e){x.lastIndex=0;var r=x.exec(t.slice(e));return r?(n.w=b.get(r[0].toLowerCase()),e+r[0].length):-1}function u(n,t,e){N.lastIndex=0;var r=N.exec(t.slice(e));return r?(n.m=E.get(r[0].toLowerCase()),e+r[0].length):-1}function o(n,t,e){S.lastIndex=0;var r=S.exec(t.slice(e));return r?(n.m=k.get(r[0].toLowerCase()),e+r[0].length):-1}function a(n,t,r){return e(n,A.c.toString(),t,r)}function l(n,t,r){return e(n,A.x.toString(),t,r)}function c(n,t,r){return e(n,A.X.toString(),t,r)}function f(n,t,e){var r=M.get(t.slice(e,e+=2).toLowerCase());return null==r?-1:(n.p=r,e)}var s=n.dateTime,h=n.date,p=n.time,g=n.periods,v=n.days,d=n.shortDays,y=n.months,m=n.shortMonths;t.utc=function(n){function e(n){try{va=Hn;var t=new va;return t._=n,r(t)}finally{va=Date}}var r=t(n);return e.parse=function(n){try{va=Hn;var t=r.parse(n);return t&&t._}finally{va=Date}},e.toString=r.toString,e},t.multi=t.utc.multi=ct;var M=ao.map(),x=Vn(v),b=Xn(v),_=Vn(d),w=Xn(d),S=Vn(y),k=Xn(y),N=Vn(m),E=Xn(m);g.forEach(function(n,t){M.set(n.toLowerCase(),t)});var A={a:function(n){return d[n.getDay()]},A:function(n){return v[n.getDay()]},b:function(n){return m[n.getMonth()]},B:function(n){return y[n.getMonth()]},c:t(s),d:function(n,t){return Zn(n.getDate(),t,2)},e:function(n,t){return Zn(n.getDate(),t,2)},H:function(n,t){return Zn(n.getHours(),t,2)},I:function(n,t){return Zn(n.getHours()%12||12,t,2)},j:function(n,t){return Zn(1+ga.dayOfYear(n),t,3)},L:function(n,t){return Zn(n.getMilliseconds(),t,3)},m:function(n,t){return Zn(n.getMonth()+1,t,2)},M:function(n,t){return Zn(n.getMinutes(),t,2)},p:function(n){return g[+(n.getHours()>=12)]},S:function(n,t){return Zn(n.getSeconds(),t,2)},U:function(n,t){return Zn(ga.sundayOfYear(n),t,2)},w:function(n){return n.getDay()},W:function(n,t){return Zn(ga.mondayOfYear(n),t,2)},x:t(h),X:t(p),y:function(n,t){return Zn(n.getFullYear()%100,t,2)},Y:function(n,t){return Zn(n.getFullYear()%1e4,t,4)},Z:at,"%":function(){return"%"}},C={a:r,A:i,b:u,B:o,c:a,d:tt,e:tt,H:rt,I:rt,j:et,L:ot,m:nt,M:it,p:f,S:ut,U:Bn,w:$n,W:Wn,x:l,X:c,y:Gn,Y:Jn,Z:Kn,"%":lt};return t}function Zn(n,t,e){var r=0>n?"-":"",i=(r?-n:n)+"",u=i.length;return r+(e>u?new Array(e-u+1).join(t)+i:i)}function Vn(n){return new RegExp("^(?:"+n.map(ao.requote).join("|")+")","i")}function Xn(n){for(var t=new c,e=-1,r=n.length;++e<r;)t.set(n[e].toLowerCase(),e);return t}function $n(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+1));return r?(n.w=+r[0],e+r[0].length):-1}function Bn(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e));return r?(n.U=+r[0],e+r[0].length):-1}function Wn(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e));return r?(n.W=+r[0],e+r[0].length):-1}function Jn(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+4));return r?(n.y=+r[0],e+r[0].length):-1}function Gn(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.y=Qn(+r[0]),e+r[0].length):-1}function Kn(n,t,e){return/^[+-]\d{4}$/.test(t=t.slice(e,e+5))?(n.Z=-t,e+5):-1}function Qn(n){return n+(n>68?1900:2e3)}function nt(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.m=r[0]-1,e+r[0].length):-1}function tt(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.d=+r[0],e+r[0].length):-1}function et(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+3));return r?(n.j=+r[0],e+r[0].length):-1}function rt(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.H=+r[0],e+r[0].length):-1}function it(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.M=+r[0],e+r[0].length):-1}function ut(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+2));return r?(n.S=+r[0],e+r[0].length):-1}function ot(n,t,e){ma.lastIndex=0;var r=ma.exec(t.slice(e,e+3));return r?(n.L=+r[0],e+r[0].length):-1}function at(n){var t=n.getTimezoneOffset(),e=t>0?"-":"+",r=xo(t)/60|0,i=xo(t)%60;return e+Zn(r,"0",2)+Zn(i,"0",2)}function lt(n,t,e){Ma.lastIndex=0;var r=Ma.exec(t.slice(e,e+1));return r?e+r[0].length:-1}function ct(n){for(var t=n.length,e=-1;++e<t;)n[e][0]=this(n[e][0]);return function(t){for(var e=0,r=n[e];!r[1](t);)r=n[++e];return r[0](t)}}function ft(){}function st(n,t,e){var r=e.s=n+t,i=r-n,u=r-i;e.t=n-u+(t-i)}function ht(n,t){n&&wa.hasOwnProperty(n.type)&&wa[n.type](n,t)}function pt(n,t,e){var r,i=-1,u=n.length-e;for(t.lineStart();++i<u;)r=n[i],t.point(r[0],r[1],r[2]);t.lineEnd()}function gt(n,t){var e=-1,r=n.length;for(t.polygonStart();++e<r;)pt(n[e],t,1);t.polygonEnd()}function vt(){function n(n,t){n*=Yo,t=t*Yo/2+Fo/4;var e=n-r,o=e>=0?1:-1,a=o*e,l=Math.cos(t),c=Math.sin(t),f=u*c,s=i*l+f*Math.cos(a),h=f*o*Math.sin(a);ka.add(Math.atan2(h,s)),r=n,i=l,u=c}var t,e,r,i,u;Na.point=function(o,a){Na.point=n,r=(t=o)*Yo,i=Math.cos(a=(e=a)*Yo/2+Fo/4),u=Math.sin(a)},Na.lineEnd=function(){n(t,e)}}function dt(n){var t=n[0],e=n[1],r=Math.cos(e);return[r*Math.cos(t),r*Math.sin(t),Math.sin(e)]}function yt(n,t){return n[0]*t[0]+n[1]*t[1]+n[2]*t[2]}function mt(n,t){return[n[1]*t[2]-n[2]*t[1],n[2]*t[0]-n[0]*t[2],n[0]*t[1]-n[1]*t[0]]}function Mt(n,t){n[0]+=t[0],n[1]+=t[1],n[2]+=t[2]}function xt(n,t){return[n[0]*t,n[1]*t,n[2]*t]}function bt(n){var t=Math.sqrt(n[0]*n[0]+n[1]*n[1]+n[2]*n[2]);n[0]/=t,n[1]/=t,n[2]/=t}function _t(n){return[Math.atan2(n[1],n[0]),tn(n[2])]}function wt(n,t){return xo(n[0]-t[0])<Uo&&xo(n[1]-t[1])<Uo}function St(n,t){n*=Yo;var e=Math.cos(t*=Yo);kt(e*Math.cos(n),e*Math.sin(n),Math.sin(t))}function kt(n,t,e){++Ea,Ca+=(n-Ca)/Ea,za+=(t-za)/Ea,La+=(e-La)/Ea}function Nt(){function n(n,i){n*=Yo;var u=Math.cos(i*=Yo),o=u*Math.cos(n),a=u*Math.sin(n),l=Math.sin(i),c=Math.atan2(Math.sqrt((c=e*l-r*a)*c+(c=r*o-t*l)*c+(c=t*a-e*o)*c),t*o+e*a+r*l);Aa+=c,qa+=c*(t+(t=o)),Ta+=c*(e+(e=a)),Ra+=c*(r+(r=l)),kt(t,e,r)}var t,e,r;ja.point=function(i,u){i*=Yo;var o=Math.cos(u*=Yo);t=o*Math.cos(i),e=o*Math.sin(i),r=Math.sin(u),ja.point=n,kt(t,e,r)}}function Et(){ja.point=St}function At(){function n(n,t){n*=Yo;var e=Math.cos(t*=Yo),o=e*Math.cos(n),a=e*Math.sin(n),l=Math.sin(t),c=i*l-u*a,f=u*o-r*l,s=r*a-i*o,h=Math.sqrt(c*c+f*f+s*s),p=r*o+i*a+u*l,g=h&&-nn(p)/h,v=Math.atan2(h,p);Da+=g*c,Pa+=g*f,Ua+=g*s,Aa+=v,qa+=v*(r+(r=o)),Ta+=v*(i+(i=a)),Ra+=v*(u+(u=l)),kt(r,i,u)}var t,e,r,i,u;ja.point=function(o,a){t=o,e=a,ja.point=n,o*=Yo;var l=Math.cos(a*=Yo);r=l*Math.cos(o),i=l*Math.sin(o),u=Math.sin(a),kt(r,i,u)},ja.lineEnd=function(){n(t,e),ja.lineEnd=Et,ja.point=St}}function Ct(n,t){function e(e,r){return e=n(e,r),t(e[0],e[1])}return n.invert&&t.invert&&(e.invert=function(e,r){return e=t.invert(e,r),e&&n.invert(e[0],e[1])}),e}function zt(){return!0}function Lt(n,t,e,r,i){var u=[],o=[];if(n.forEach(function(n){if(!((t=n.length-1)<=0)){var t,e=n[0],r=n[t];if(wt(e,r)){i.lineStart();for(var a=0;t>a;++a)i.point((e=n[a])[0],e[1]);return void i.lineEnd()}var l=new Tt(e,n,null,!0),c=new Tt(e,null,l,!1);l.o=c,u.push(l),o.push(c),l=new Tt(r,n,null,!1),c=new Tt(r,null,l,!0),l.o=c,u.push(l),o.push(c)}}),o.sort(t),qt(u),qt(o),u.length){for(var a=0,l=e,c=o.length;c>a;++a)o[a].e=l=!l;for(var f,s,h=u[0];;){for(var p=h,g=!0;p.v;)if((p=p.n)===h)return;f=p.z,i.lineStart();do{if(p.v=p.o.v=!0,p.e){if(g)for(var a=0,c=f.length;c>a;++a)i.point((s=f[a])[0],s[1]);else r(p.x,p.n.x,1,i);p=p.n}else{if(g){f=p.p.z;for(var a=f.length-1;a>=0;--a)i.point((s=f[a])[0],s[1])}else r(p.x,p.p.x,-1,i);p=p.p}p=p.o,f=p.z,g=!g}while(!p.v);i.lineEnd()}}}function qt(n){if(t=n.length){for(var t,e,r=0,i=n[0];++r<t;)i.n=e=n[r],e.p=i,i=e;i.n=e=n[0],e.p=i}}function Tt(n,t,e,r){this.x=n,this.z=t,this.o=e,this.e=r,this.v=!1,this.n=this.p=null}function Rt(n,t,e,r){return function(i,u){function o(t,e){var r=i(t,e);n(t=r[0],e=r[1])&&u.point(t,e)}function a(n,t){var e=i(n,t);d.point(e[0],e[1])}function l(){m.point=a,d.lineStart()}function c(){m.point=o,d.lineEnd()}function f(n,t){v.push([n,t]);var e=i(n,t);x.point(e[0],e[1])}function s(){x.lineStart(),v=[]}function h(){f(v[0][0],v[0][1]),x.lineEnd();var n,t=x.clean(),e=M.buffer(),r=e.length;if(v.pop(),g.push(v),v=null,r)if(1&t){n=e[0];var i,r=n.length-1,o=-1;if(r>0){for(b||(u.polygonStart(),b=!0),u.lineStart();++o<r;)u.point((i=n[o])[0],i[1]);u.lineEnd()}}else r>1&&2&t&&e.push(e.pop().concat(e.shift())),p.push(e.filter(Dt))}var p,g,v,d=t(u),y=i.invert(r[0],r[1]),m={point:o,lineStart:l,lineEnd:c,polygonStart:function(){m.point=f,m.lineStart=s,m.lineEnd=h,p=[],g=[]},polygonEnd:function(){m.point=o,m.lineStart=l,m.lineEnd=c,p=ao.merge(p);var n=Ot(y,g);p.length?(b||(u.polygonStart(),b=!0),Lt(p,Ut,n,e,u)):n&&(b||(u.polygonStart(),b=!0),u.lineStart(),e(null,null,1,u),u.lineEnd()),b&&(u.polygonEnd(),b=!1),p=g=null},sphere:function(){u.polygonStart(),u.lineStart(),e(null,null,1,u),u.lineEnd(),u.polygonEnd()}},M=Pt(),x=t(M),b=!1;return m}}function Dt(n){return n.length>1}function Pt(){var n,t=[];return{lineStart:function(){t.push(n=[])},point:function(t,e){n.push([t,e])},lineEnd:b,buffer:function(){var e=t;return t=[],n=null,e},rejoin:function(){t.length>1&&t.push(t.pop().concat(t.shift()))}}}function Ut(n,t){return((n=n.x)[0]<0?n[1]-Io-Uo:Io-n[1])-((t=t.x)[0]<0?t[1]-Io-Uo:Io-t[1])}function jt(n){var t,e=NaN,r=NaN,i=NaN;return{lineStart:function(){n.lineStart(),t=1},point:function(u,o){var a=u>0?Fo:-Fo,l=xo(u-e);xo(l-Fo)<Uo?(n.point(e,r=(r+o)/2>0?Io:-Io),n.point(i,r),n.lineEnd(),n.lineStart(),n.point(a,r),n.point(u,r),t=0):i!==a&&l>=Fo&&(xo(e-i)<Uo&&(e-=i*Uo),xo(u-a)<Uo&&(u-=a*Uo),r=Ft(e,r,u,o),n.point(i,r),n.lineEnd(),n.lineStart(),n.point(a,r),t=0),n.point(e=u,r=o),i=a},lineEnd:function(){n.lineEnd(),e=r=NaN},clean:function(){return 2-t}}}function Ft(n,t,e,r){var i,u,o=Math.sin(n-e);return xo(o)>Uo?Math.atan((Math.sin(t)*(u=Math.cos(r))*Math.sin(e)-Math.sin(r)*(i=Math.cos(t))*Math.sin(n))/(i*u*o)):(t+r)/2}function Ht(n,t,e,r){var i;if(null==n)i=e*Io,r.point(-Fo,i),r.point(0,i),r.point(Fo,i),r.point(Fo,0),r.point(Fo,-i),r.point(0,-i),r.point(-Fo,-i),r.point(-Fo,0),r.point(-Fo,i);else if(xo(n[0]-t[0])>Uo){var u=n[0]<t[0]?Fo:-Fo;i=e*u/2,r.point(-u,i),r.point(0,i),r.point(u,i)}else r.point(t[0],t[1])}function Ot(n,t){var e=n[0],r=n[1],i=[Math.sin(e),-Math.cos(e),0],u=0,o=0;ka.reset();for(var a=0,l=t.length;l>a;++a){var c=t[a],f=c.length;if(f)for(var s=c[0],h=s[0],p=s[1]/2+Fo/4,g=Math.sin(p),v=Math.cos(p),d=1;;){d===f&&(d=0),n=c[d];var y=n[0],m=n[1]/2+Fo/4,M=Math.sin(m),x=Math.cos(m),b=y-h,_=b>=0?1:-1,w=_*b,S=w>Fo,k=g*M;if(ka.add(Math.atan2(k*_*Math.sin(w),v*x+k*Math.cos(w))),u+=S?b+_*Ho:b,S^h>=e^y>=e){var N=mt(dt(s),dt(n));bt(N);var E=mt(i,N);bt(E);var A=(S^b>=0?-1:1)*tn(E[2]);(r>A||r===A&&(N[0]||N[1]))&&(o+=S^b>=0?1:-1)}if(!d++)break;h=y,g=M,v=x,s=n}}return(-Uo>u||Uo>u&&-Uo>ka)^1&o}function It(n){function t(n,t){return Math.cos(n)*Math.cos(t)>u}function e(n){var e,u,l,c,f;return{lineStart:function(){c=l=!1,f=1},point:function(s,h){var p,g=[s,h],v=t(s,h),d=o?v?0:i(s,h):v?i(s+(0>s?Fo:-Fo),h):0;if(!e&&(c=l=v)&&n.lineStart(),v!==l&&(p=r(e,g),(wt(e,p)||wt(g,p))&&(g[0]+=Uo,g[1]+=Uo,v=t(g[0],g[1]))),v!==l)f=0,v?(n.lineStart(),p=r(g,e),n.point(p[0],p[1])):(p=r(e,g),n.point(p[0],p[1]),n.lineEnd()),e=p;else if(a&&e&&o^v){var y;d&u||!(y=r(g,e,!0))||(f=0,o?(n.lineStart(),n.point(y[0][0],y[0][1]),n.point(y[1][0],y[1][1]),n.lineEnd()):(n.point(y[1][0],y[1][1]),n.lineEnd(),n.lineStart(),n.point(y[0][0],y[0][1])))}!v||e&&wt(e,g)||n.point(g[0],g[1]),e=g,l=v,u=d},lineEnd:function(){l&&n.lineEnd(),e=null},clean:function(){return f|(c&&l)<<1}}}function r(n,t,e){var r=dt(n),i=dt(t),o=[1,0,0],a=mt(r,i),l=yt(a,a),c=a[0],f=l-c*c;if(!f)return!e&&n;var s=u*l/f,h=-u*c/f,p=mt(o,a),g=xt(o,s),v=xt(a,h);Mt(g,v);var d=p,y=yt(g,d),m=yt(d,d),M=y*y-m*(yt(g,g)-1);if(!(0>M)){var x=Math.sqrt(M),b=xt(d,(-y-x)/m);if(Mt(b,g),b=_t(b),!e)return b;var _,w=n[0],S=t[0],k=n[1],N=t[1];w>S&&(_=w,w=S,S=_);var E=S-w,A=xo(E-Fo)<Uo,C=A||Uo>E;if(!A&&k>N&&(_=k,k=N,N=_),C?A?k+N>0^b[1]<(xo(b[0]-w)<Uo?k:N):k<=b[1]&&b[1]<=N:E>Fo^(w<=b[0]&&b[0]<=S)){var z=xt(d,(-y+x)/m);return Mt(z,g),[b,_t(z)]}}}function i(t,e){var r=o?n:Fo-n,i=0;return-r>t?i|=1:t>r&&(i|=2),-r>e?i|=4:e>r&&(i|=8),i}var u=Math.cos(n),o=u>0,a=xo(u)>Uo,l=ve(n,6*Yo);return Rt(t,e,l,o?[0,-n]:[-Fo,n-Fo])}function Yt(n,t,e,r){return function(i){var u,o=i.a,a=i.b,l=o.x,c=o.y,f=a.x,s=a.y,h=0,p=1,g=f-l,v=s-c;if(u=n-l,g||!(u>0)){if(u/=g,0>g){if(h>u)return;p>u&&(p=u)}else if(g>0){if(u>p)return;u>h&&(h=u)}if(u=e-l,g||!(0>u)){if(u/=g,0>g){if(u>p)return;u>h&&(h=u)}else if(g>0){if(h>u)return;p>u&&(p=u)}if(u=t-c,v||!(u>0)){if(u/=v,0>v){if(h>u)return;p>u&&(p=u)}else if(v>0){if(u>p)return;u>h&&(h=u)}if(u=r-c,v||!(0>u)){if(u/=v,0>v){if(u>p)return;u>h&&(h=u)}else if(v>0){if(h>u)return;p>u&&(p=u)}return h>0&&(i.a={x:l+h*g,y:c+h*v}),1>p&&(i.b={x:l+p*g,y:c+p*v}),i}}}}}}function Zt(n,t,e,r){function i(r,i){return xo(r[0]-n)<Uo?i>0?0:3:xo(r[0]-e)<Uo?i>0?2:1:xo(r[1]-t)<Uo?i>0?1:0:i>0?3:2}function u(n,t){return o(n.x,t.x)}function o(n,t){var e=i(n,1),r=i(t,1);return e!==r?e-r:0===e?t[1]-n[1]:1===e?n[0]-t[0]:2===e?n[1]-t[1]:t[0]-n[0]}return function(a){function l(n){for(var t=0,e=d.length,r=n[1],i=0;e>i;++i)for(var u,o=1,a=d[i],l=a.length,c=a[0];l>o;++o)u=a[o],c[1]<=r?u[1]>r&&Q(c,u,n)>0&&++t:u[1]<=r&&Q(c,u,n)<0&&--t,c=u;return 0!==t}function c(u,a,l,c){var f=0,s=0;if(null==u||(f=i(u,l))!==(s=i(a,l))||o(u,a)<0^l>0){do c.point(0===f||3===f?n:e,f>1?r:t);while((f=(f+l+4)%4)!==s)}else c.point(a[0],a[1])}function f(i,u){return i>=n&&e>=i&&u>=t&&r>=u}function s(n,t){f(n,t)&&a.point(n,t)}function h(){C.point=g,d&&d.push(y=[]),S=!0,w=!1,b=_=NaN}function p(){v&&(g(m,M),x&&w&&E.rejoin(),v.push(E.buffer())),C.point=s,w&&a.lineEnd()}function g(n,t){n=Math.max(-Ha,Math.min(Ha,n)),t=Math.max(-Ha,Math.min(Ha,t));var e=f(n,t);if(d&&y.push([n,t]),S)m=n,M=t,x=e,S=!1,e&&(a.lineStart(),a.point(n,t));else if(e&&w)a.point(n,t);else{var r={a:{x:b,y:_},b:{x:n,y:t}};A(r)?(w||(a.lineStart(),a.point(r.a.x,r.a.y)),a.point(r.b.x,r.b.y),e||a.lineEnd(),k=!1):e&&(a.lineStart(),a.point(n,t),k=!1)}b=n,_=t,w=e}var v,d,y,m,M,x,b,_,w,S,k,N=a,E=Pt(),A=Yt(n,t,e,r),C={point:s,lineStart:h,lineEnd:p,polygonStart:function(){a=E,v=[],d=[],k=!0},polygonEnd:function(){a=N,v=ao.merge(v);var t=l([n,r]),e=k&&t,i=v.length;(e||i)&&(a.polygonStart(),e&&(a.lineStart(),c(null,null,1,a),a.lineEnd()),i&&Lt(v,u,t,c,a),a.polygonEnd()),v=d=y=null}};return C}}function Vt(n){var t=0,e=Fo/3,r=ae(n),i=r(t,e);return i.parallels=function(n){return arguments.length?r(t=n[0]*Fo/180,e=n[1]*Fo/180):[t/Fo*180,e/Fo*180]},i}function Xt(n,t){function e(n,t){var e=Math.sqrt(u-2*i*Math.sin(t))/i;return[e*Math.sin(n*=i),o-e*Math.cos(n)]}var r=Math.sin(n),i=(r+Math.sin(t))/2,u=1+r*(2*i-r),o=Math.sqrt(u)/i;return e.invert=function(n,t){var e=o-t;return[Math.atan2(n,e)/i,tn((u-(n*n+e*e)*i*i)/(2*i))]},e}function $t(){function n(n,t){Ia+=i*n-r*t,r=n,i=t}var t,e,r,i;$a.point=function(u,o){$a.point=n,t=r=u,e=i=o},$a.lineEnd=function(){n(t,e)}}function Bt(n,t){Ya>n&&(Ya=n),n>Va&&(Va=n),Za>t&&(Za=t),t>Xa&&(Xa=t)}function Wt(){function n(n,t){o.push("M",n,",",t,u)}function t(n,t){o.push("M",n,",",t),a.point=e}function e(n,t){o.push("L",n,",",t)}function r(){a.point=n}function i(){o.push("Z")}var u=Jt(4.5),o=[],a={point:n,lineStart:function(){a.point=t},lineEnd:r,polygonStart:function(){a.lineEnd=i},polygonEnd:function(){a.lineEnd=r,a.point=n},pointRadius:function(n){return u=Jt(n),a},result:function(){if(o.length){var n=o.join("");return o=[],n}}};return a}function Jt(n){return"m0,"+n+"a"+n+","+n+" 0 1,1 0,"+-2*n+"a"+n+","+n+" 0 1,1 0,"+2*n+"z"}function Gt(n,t){Ca+=n,za+=t,++La}function Kt(){function n(n,r){var i=n-t,u=r-e,o=Math.sqrt(i*i+u*u);qa+=o*(t+n)/2,Ta+=o*(e+r)/2,Ra+=o,Gt(t=n,e=r)}var t,e;Wa.point=function(r,i){Wa.point=n,Gt(t=r,e=i)}}function Qt(){Wa.point=Gt}function ne(){function n(n,t){var e=n-r,u=t-i,o=Math.sqrt(e*e+u*u);qa+=o*(r+n)/2,Ta+=o*(i+t)/2,Ra+=o,o=i*n-r*t,Da+=o*(r+n),Pa+=o*(i+t),Ua+=3*o,Gt(r=n,i=t)}var t,e,r,i;Wa.point=function(u,o){Wa.point=n,Gt(t=r=u,e=i=o)},Wa.lineEnd=function(){n(t,e)}}function te(n){function t(t,e){n.moveTo(t+o,e),n.arc(t,e,o,0,Ho)}function e(t,e){n.moveTo(t,e),a.point=r}function r(t,e){n.lineTo(t,e)}function i(){a.point=t}function u(){n.closePath()}var o=4.5,a={point:t,lineStart:function(){a.point=e},lineEnd:i,polygonStart:function(){a.lineEnd=u},polygonEnd:function(){a.lineEnd=i,a.point=t},pointRadius:function(n){return o=n,a},result:b};return a}function ee(n){function t(n){return(a?r:e)(n)}function e(t){return ue(t,function(e,r){e=n(e,r),t.point(e[0],e[1])})}function r(t){function e(e,r){e=n(e,r),t.point(e[0],e[1])}function r(){M=NaN,S.point=u,t.lineStart()}function u(e,r){var u=dt([e,r]),o=n(e,r);i(M,x,m,b,_,w,M=o[0],x=o[1],m=e,b=u[0],_=u[1],w=u[2],a,t),t.point(M,x)}function o(){S.point=e,t.lineEnd()}function l(){
r(),S.point=c,S.lineEnd=f}function c(n,t){u(s=n,h=t),p=M,g=x,v=b,d=_,y=w,S.point=u}function f(){i(M,x,m,b,_,w,p,g,s,v,d,y,a,t),S.lineEnd=o,o()}var s,h,p,g,v,d,y,m,M,x,b,_,w,S={point:e,lineStart:r,lineEnd:o,polygonStart:function(){t.polygonStart(),S.lineStart=l},polygonEnd:function(){t.polygonEnd(),S.lineStart=r}};return S}function i(t,e,r,a,l,c,f,s,h,p,g,v,d,y){var m=f-t,M=s-e,x=m*m+M*M;if(x>4*u&&d--){var b=a+p,_=l+g,w=c+v,S=Math.sqrt(b*b+_*_+w*w),k=Math.asin(w/=S),N=xo(xo(w)-1)<Uo||xo(r-h)<Uo?(r+h)/2:Math.atan2(_,b),E=n(N,k),A=E[0],C=E[1],z=A-t,L=C-e,q=M*z-m*L;(q*q/x>u||xo((m*z+M*L)/x-.5)>.3||o>a*p+l*g+c*v)&&(i(t,e,r,a,l,c,A,C,N,b/=S,_/=S,w,d,y),y.point(A,C),i(A,C,N,b,_,w,f,s,h,p,g,v,d,y))}}var u=.5,o=Math.cos(30*Yo),a=16;return t.precision=function(n){return arguments.length?(a=(u=n*n)>0&&16,t):Math.sqrt(u)},t}function re(n){var t=ee(function(t,e){return n([t*Zo,e*Zo])});return function(n){return le(t(n))}}function ie(n){this.stream=n}function ue(n,t){return{point:t,sphere:function(){n.sphere()},lineStart:function(){n.lineStart()},lineEnd:function(){n.lineEnd()},polygonStart:function(){n.polygonStart()},polygonEnd:function(){n.polygonEnd()}}}function oe(n){return ae(function(){return n})()}function ae(n){function t(n){return n=a(n[0]*Yo,n[1]*Yo),[n[0]*h+l,c-n[1]*h]}function e(n){return n=a.invert((n[0]-l)/h,(c-n[1])/h),n&&[n[0]*Zo,n[1]*Zo]}function r(){a=Ct(o=se(y,M,x),u);var n=u(v,d);return l=p-n[0]*h,c=g+n[1]*h,i()}function i(){return f&&(f.valid=!1,f=null),t}var u,o,a,l,c,f,s=ee(function(n,t){return n=u(n,t),[n[0]*h+l,c-n[1]*h]}),h=150,p=480,g=250,v=0,d=0,y=0,M=0,x=0,b=Fa,_=m,w=null,S=null;return t.stream=function(n){return f&&(f.valid=!1),f=le(b(o,s(_(n)))),f.valid=!0,f},t.clipAngle=function(n){return arguments.length?(b=null==n?(w=n,Fa):It((w=+n)*Yo),i()):w},t.clipExtent=function(n){return arguments.length?(S=n,_=n?Zt(n[0][0],n[0][1],n[1][0],n[1][1]):m,i()):S},t.scale=function(n){return arguments.length?(h=+n,r()):h},t.translate=function(n){return arguments.length?(p=+n[0],g=+n[1],r()):[p,g]},t.center=function(n){return arguments.length?(v=n[0]%360*Yo,d=n[1]%360*Yo,r()):[v*Zo,d*Zo]},t.rotate=function(n){return arguments.length?(y=n[0]%360*Yo,M=n[1]%360*Yo,x=n.length>2?n[2]%360*Yo:0,r()):[y*Zo,M*Zo,x*Zo]},ao.rebind(t,s,"precision"),function(){return u=n.apply(this,arguments),t.invert=u.invert&&e,r()}}function le(n){return ue(n,function(t,e){n.point(t*Yo,e*Yo)})}function ce(n,t){return[n,t]}function fe(n,t){return[n>Fo?n-Ho:-Fo>n?n+Ho:n,t]}function se(n,t,e){return n?t||e?Ct(pe(n),ge(t,e)):pe(n):t||e?ge(t,e):fe}function he(n){return function(t,e){return t+=n,[t>Fo?t-Ho:-Fo>t?t+Ho:t,e]}}function pe(n){var t=he(n);return t.invert=he(-n),t}function ge(n,t){function e(n,t){var e=Math.cos(t),a=Math.cos(n)*e,l=Math.sin(n)*e,c=Math.sin(t),f=c*r+a*i;return[Math.atan2(l*u-f*o,a*r-c*i),tn(f*u+l*o)]}var r=Math.cos(n),i=Math.sin(n),u=Math.cos(t),o=Math.sin(t);return e.invert=function(n,t){var e=Math.cos(t),a=Math.cos(n)*e,l=Math.sin(n)*e,c=Math.sin(t),f=c*u-l*o;return[Math.atan2(l*u+c*o,a*r+f*i),tn(f*r-a*i)]},e}function ve(n,t){var e=Math.cos(n),r=Math.sin(n);return function(i,u,o,a){var l=o*t;null!=i?(i=de(e,i),u=de(e,u),(o>0?u>i:i>u)&&(i+=o*Ho)):(i=n+o*Ho,u=n-.5*l);for(var c,f=i;o>0?f>u:u>f;f-=l)a.point((c=_t([e,-r*Math.cos(f),-r*Math.sin(f)]))[0],c[1])}}function de(n,t){var e=dt(t);e[0]-=n,bt(e);var r=nn(-e[1]);return((-e[2]<0?-r:r)+2*Math.PI-Uo)%(2*Math.PI)}function ye(n,t,e){var r=ao.range(n,t-Uo,e).concat(t);return function(n){return r.map(function(t){return[n,t]})}}function me(n,t,e){var r=ao.range(n,t-Uo,e).concat(t);return function(n){return r.map(function(t){return[t,n]})}}function Me(n){return n.source}function xe(n){return n.target}function be(n,t,e,r){var i=Math.cos(t),u=Math.sin(t),o=Math.cos(r),a=Math.sin(r),l=i*Math.cos(n),c=i*Math.sin(n),f=o*Math.cos(e),s=o*Math.sin(e),h=2*Math.asin(Math.sqrt(on(r-t)+i*o*on(e-n))),p=1/Math.sin(h),g=h?function(n){var t=Math.sin(n*=h)*p,e=Math.sin(h-n)*p,r=e*l+t*f,i=e*c+t*s,o=e*u+t*a;return[Math.atan2(i,r)*Zo,Math.atan2(o,Math.sqrt(r*r+i*i))*Zo]}:function(){return[n*Zo,t*Zo]};return g.distance=h,g}function _e(){function n(n,i){var u=Math.sin(i*=Yo),o=Math.cos(i),a=xo((n*=Yo)-t),l=Math.cos(a);Ja+=Math.atan2(Math.sqrt((a=o*Math.sin(a))*a+(a=r*u-e*o*l)*a),e*u+r*o*l),t=n,e=u,r=o}var t,e,r;Ga.point=function(i,u){t=i*Yo,e=Math.sin(u*=Yo),r=Math.cos(u),Ga.point=n},Ga.lineEnd=function(){Ga.point=Ga.lineEnd=b}}function we(n,t){function e(t,e){var r=Math.cos(t),i=Math.cos(e),u=n(r*i);return[u*i*Math.sin(t),u*Math.sin(e)]}return e.invert=function(n,e){var r=Math.sqrt(n*n+e*e),i=t(r),u=Math.sin(i),o=Math.cos(i);return[Math.atan2(n*u,r*o),Math.asin(r&&e*u/r)]},e}function Se(n,t){function e(n,t){o>0?-Io+Uo>t&&(t=-Io+Uo):t>Io-Uo&&(t=Io-Uo);var e=o/Math.pow(i(t),u);return[e*Math.sin(u*n),o-e*Math.cos(u*n)]}var r=Math.cos(n),i=function(n){return Math.tan(Fo/4+n/2)},u=n===t?Math.sin(n):Math.log(r/Math.cos(t))/Math.log(i(t)/i(n)),o=r*Math.pow(i(n),u)/u;return u?(e.invert=function(n,t){var e=o-t,r=K(u)*Math.sqrt(n*n+e*e);return[Math.atan2(n,e)/u,2*Math.atan(Math.pow(o/r,1/u))-Io]},e):Ne}function ke(n,t){function e(n,t){var e=u-t;return[e*Math.sin(i*n),u-e*Math.cos(i*n)]}var r=Math.cos(n),i=n===t?Math.sin(n):(r-Math.cos(t))/(t-n),u=r/i+n;return xo(i)<Uo?ce:(e.invert=function(n,t){var e=u-t;return[Math.atan2(n,e)/i,u-K(i)*Math.sqrt(n*n+e*e)]},e)}function Ne(n,t){return[n,Math.log(Math.tan(Fo/4+t/2))]}function Ee(n){var t,e=oe(n),r=e.scale,i=e.translate,u=e.clipExtent;return e.scale=function(){var n=r.apply(e,arguments);return n===e?t?e.clipExtent(null):e:n},e.translate=function(){var n=i.apply(e,arguments);return n===e?t?e.clipExtent(null):e:n},e.clipExtent=function(n){var o=u.apply(e,arguments);if(o===e){if(t=null==n){var a=Fo*r(),l=i();u([[l[0]-a,l[1]-a],[l[0]+a,l[1]+a]])}}else t&&(o=null);return o},e.clipExtent(null)}function Ae(n,t){return[Math.log(Math.tan(Fo/4+t/2)),-n]}function Ce(n){return n[0]}function ze(n){return n[1]}function Le(n){for(var t=n.length,e=[0,1],r=2,i=2;t>i;i++){for(;r>1&&Q(n[e[r-2]],n[e[r-1]],n[i])<=0;)--r;e[r++]=i}return e.slice(0,r)}function qe(n,t){return n[0]-t[0]||n[1]-t[1]}function Te(n,t,e){return(e[0]-t[0])*(n[1]-t[1])<(e[1]-t[1])*(n[0]-t[0])}function Re(n,t,e,r){var i=n[0],u=e[0],o=t[0]-i,a=r[0]-u,l=n[1],c=e[1],f=t[1]-l,s=r[1]-c,h=(a*(l-c)-s*(i-u))/(s*o-a*f);return[i+h*o,l+h*f]}function De(n){var t=n[0],e=n[n.length-1];return!(t[0]-e[0]||t[1]-e[1])}function Pe(){rr(this),this.edge=this.site=this.circle=null}function Ue(n){var t=cl.pop()||new Pe;return t.site=n,t}function je(n){Be(n),ol.remove(n),cl.push(n),rr(n)}function Fe(n){var t=n.circle,e=t.x,r=t.cy,i={x:e,y:r},u=n.P,o=n.N,a=[n];je(n);for(var l=u;l.circle&&xo(e-l.circle.x)<Uo&&xo(r-l.circle.cy)<Uo;)u=l.P,a.unshift(l),je(l),l=u;a.unshift(l),Be(l);for(var c=o;c.circle&&xo(e-c.circle.x)<Uo&&xo(r-c.circle.cy)<Uo;)o=c.N,a.push(c),je(c),c=o;a.push(c),Be(c);var f,s=a.length;for(f=1;s>f;++f)c=a[f],l=a[f-1],nr(c.edge,l.site,c.site,i);l=a[0],c=a[s-1],c.edge=Ke(l.site,c.site,null,i),$e(l),$e(c)}function He(n){for(var t,e,r,i,u=n.x,o=n.y,a=ol._;a;)if(r=Oe(a,o)-u,r>Uo)a=a.L;else{if(i=u-Ie(a,o),!(i>Uo)){r>-Uo?(t=a.P,e=a):i>-Uo?(t=a,e=a.N):t=e=a;break}if(!a.R){t=a;break}a=a.R}var l=Ue(n);if(ol.insert(t,l),t||e){if(t===e)return Be(t),e=Ue(t.site),ol.insert(l,e),l.edge=e.edge=Ke(t.site,l.site),$e(t),void $e(e);if(!e)return void(l.edge=Ke(t.site,l.site));Be(t),Be(e);var c=t.site,f=c.x,s=c.y,h=n.x-f,p=n.y-s,g=e.site,v=g.x-f,d=g.y-s,y=2*(h*d-p*v),m=h*h+p*p,M=v*v+d*d,x={x:(d*m-p*M)/y+f,y:(h*M-v*m)/y+s};nr(e.edge,c,g,x),l.edge=Ke(c,n,null,x),e.edge=Ke(n,g,null,x),$e(t),$e(e)}}function Oe(n,t){var e=n.site,r=e.x,i=e.y,u=i-t;if(!u)return r;var o=n.P;if(!o)return-(1/0);e=o.site;var a=e.x,l=e.y,c=l-t;if(!c)return a;var f=a-r,s=1/u-1/c,h=f/c;return s?(-h+Math.sqrt(h*h-2*s*(f*f/(-2*c)-l+c/2+i-u/2)))/s+r:(r+a)/2}function Ie(n,t){var e=n.N;if(e)return Oe(e,t);var r=n.site;return r.y===t?r.x:1/0}function Ye(n){this.site=n,this.edges=[]}function Ze(n){for(var t,e,r,i,u,o,a,l,c,f,s=n[0][0],h=n[1][0],p=n[0][1],g=n[1][1],v=ul,d=v.length;d--;)if(u=v[d],u&&u.prepare())for(a=u.edges,l=a.length,o=0;l>o;)f=a[o].end(),r=f.x,i=f.y,c=a[++o%l].start(),t=c.x,e=c.y,(xo(r-t)>Uo||xo(i-e)>Uo)&&(a.splice(o,0,new tr(Qe(u.site,f,xo(r-s)<Uo&&g-i>Uo?{x:s,y:xo(t-s)<Uo?e:g}:xo(i-g)<Uo&&h-r>Uo?{x:xo(e-g)<Uo?t:h,y:g}:xo(r-h)<Uo&&i-p>Uo?{x:h,y:xo(t-h)<Uo?e:p}:xo(i-p)<Uo&&r-s>Uo?{x:xo(e-p)<Uo?t:s,y:p}:null),u.site,null)),++l)}function Ve(n,t){return t.angle-n.angle}function Xe(){rr(this),this.x=this.y=this.arc=this.site=this.cy=null}function $e(n){var t=n.P,e=n.N;if(t&&e){var r=t.site,i=n.site,u=e.site;if(r!==u){var o=i.x,a=i.y,l=r.x-o,c=r.y-a,f=u.x-o,s=u.y-a,h=2*(l*s-c*f);if(!(h>=-jo)){var p=l*l+c*c,g=f*f+s*s,v=(s*p-c*g)/h,d=(l*g-f*p)/h,s=d+a,y=fl.pop()||new Xe;y.arc=n,y.site=i,y.x=v+o,y.y=s+Math.sqrt(v*v+d*d),y.cy=s,n.circle=y;for(var m=null,M=ll._;M;)if(y.y<M.y||y.y===M.y&&y.x<=M.x){if(!M.L){m=M.P;break}M=M.L}else{if(!M.R){m=M;break}M=M.R}ll.insert(m,y),m||(al=y)}}}}function Be(n){var t=n.circle;t&&(t.P||(al=t.N),ll.remove(t),fl.push(t),rr(t),n.circle=null)}function We(n){for(var t,e=il,r=Yt(n[0][0],n[0][1],n[1][0],n[1][1]),i=e.length;i--;)t=e[i],(!Je(t,n)||!r(t)||xo(t.a.x-t.b.x)<Uo&&xo(t.a.y-t.b.y)<Uo)&&(t.a=t.b=null,e.splice(i,1))}function Je(n,t){var e=n.b;if(e)return!0;var r,i,u=n.a,o=t[0][0],a=t[1][0],l=t[0][1],c=t[1][1],f=n.l,s=n.r,h=f.x,p=f.y,g=s.x,v=s.y,d=(h+g)/2,y=(p+v)/2;if(v===p){if(o>d||d>=a)return;if(h>g){if(u){if(u.y>=c)return}else u={x:d,y:l};e={x:d,y:c}}else{if(u){if(u.y<l)return}else u={x:d,y:c};e={x:d,y:l}}}else if(r=(h-g)/(v-p),i=y-r*d,-1>r||r>1)if(h>g){if(u){if(u.y>=c)return}else u={x:(l-i)/r,y:l};e={x:(c-i)/r,y:c}}else{if(u){if(u.y<l)return}else u={x:(c-i)/r,y:c};e={x:(l-i)/r,y:l}}else if(v>p){if(u){if(u.x>=a)return}else u={x:o,y:r*o+i};e={x:a,y:r*a+i}}else{if(u){if(u.x<o)return}else u={x:a,y:r*a+i};e={x:o,y:r*o+i}}return n.a=u,n.b=e,!0}function Ge(n,t){this.l=n,this.r=t,this.a=this.b=null}function Ke(n,t,e,r){var i=new Ge(n,t);return il.push(i),e&&nr(i,n,t,e),r&&nr(i,t,n,r),ul[n.i].edges.push(new tr(i,n,t)),ul[t.i].edges.push(new tr(i,t,n)),i}function Qe(n,t,e){var r=new Ge(n,null);return r.a=t,r.b=e,il.push(r),r}function nr(n,t,e,r){n.a||n.b?n.l===e?n.b=r:n.a=r:(n.a=r,n.l=t,n.r=e)}function tr(n,t,e){var r=n.a,i=n.b;this.edge=n,this.site=t,this.angle=e?Math.atan2(e.y-t.y,e.x-t.x):n.l===t?Math.atan2(i.x-r.x,r.y-i.y):Math.atan2(r.x-i.x,i.y-r.y)}function er(){this._=null}function rr(n){n.U=n.C=n.L=n.R=n.P=n.N=null}function ir(n,t){var e=t,r=t.R,i=e.U;i?i.L===e?i.L=r:i.R=r:n._=r,r.U=i,e.U=r,e.R=r.L,e.R&&(e.R.U=e),r.L=e}function ur(n,t){var e=t,r=t.L,i=e.U;i?i.L===e?i.L=r:i.R=r:n._=r,r.U=i,e.U=r,e.L=r.R,e.L&&(e.L.U=e),r.R=e}function or(n){for(;n.L;)n=n.L;return n}function ar(n,t){var e,r,i,u=n.sort(lr).pop();for(il=[],ul=new Array(n.length),ol=new er,ll=new er;;)if(i=al,u&&(!i||u.y<i.y||u.y===i.y&&u.x<i.x))u.x===e&&u.y===r||(ul[u.i]=new Ye(u),He(u),e=u.x,r=u.y),u=n.pop();else{if(!i)break;Fe(i.arc)}t&&(We(t),Ze(t));var o={cells:ul,edges:il};return ol=ll=il=ul=null,o}function lr(n,t){return t.y-n.y||t.x-n.x}function cr(n,t,e){return(n.x-e.x)*(t.y-n.y)-(n.x-t.x)*(e.y-n.y)}function fr(n){return n.x}function sr(n){return n.y}function hr(){return{leaf:!0,nodes:[],point:null,x:null,y:null}}function pr(n,t,e,r,i,u){if(!n(t,e,r,i,u)){var o=.5*(e+i),a=.5*(r+u),l=t.nodes;l[0]&&pr(n,l[0],e,r,o,a),l[1]&&pr(n,l[1],o,r,i,a),l[2]&&pr(n,l[2],e,a,o,u),l[3]&&pr(n,l[3],o,a,i,u)}}function gr(n,t,e,r,i,u,o){var a,l=1/0;return function c(n,f,s,h,p){if(!(f>u||s>o||r>h||i>p)){if(g=n.point){var g,v=t-n.x,d=e-n.y,y=v*v+d*d;if(l>y){var m=Math.sqrt(l=y);r=t-m,i=e-m,u=t+m,o=e+m,a=g}}for(var M=n.nodes,x=.5*(f+h),b=.5*(s+p),_=t>=x,w=e>=b,S=w<<1|_,k=S+4;k>S;++S)if(n=M[3&S])switch(3&S){case 0:c(n,f,s,x,b);break;case 1:c(n,x,s,h,b);break;case 2:c(n,f,b,x,p);break;case 3:c(n,x,b,h,p)}}}(n,r,i,u,o),a}function vr(n,t){n=ao.rgb(n),t=ao.rgb(t);var e=n.r,r=n.g,i=n.b,u=t.r-e,o=t.g-r,a=t.b-i;return function(n){return"#"+bn(Math.round(e+u*n))+bn(Math.round(r+o*n))+bn(Math.round(i+a*n))}}function dr(n,t){var e,r={},i={};for(e in n)e in t?r[e]=Mr(n[e],t[e]):i[e]=n[e];for(e in t)e in n||(i[e]=t[e]);return function(n){for(e in r)i[e]=r[e](n);return i}}function yr(n,t){return n=+n,t=+t,function(e){return n*(1-e)+t*e}}function mr(n,t){var e,r,i,u=hl.lastIndex=pl.lastIndex=0,o=-1,a=[],l=[];for(n+="",t+="";(e=hl.exec(n))&&(r=pl.exec(t));)(i=r.index)>u&&(i=t.slice(u,i),a[o]?a[o]+=i:a[++o]=i),(e=e[0])===(r=r[0])?a[o]?a[o]+=r:a[++o]=r:(a[++o]=null,l.push({i:o,x:yr(e,r)})),u=pl.lastIndex;return u<t.length&&(i=t.slice(u),a[o]?a[o]+=i:a[++o]=i),a.length<2?l[0]?(t=l[0].x,function(n){return t(n)+""}):function(){return t}:(t=l.length,function(n){for(var e,r=0;t>r;++r)a[(e=l[r]).i]=e.x(n);return a.join("")})}function Mr(n,t){for(var e,r=ao.interpolators.length;--r>=0&&!(e=ao.interpolators[r](n,t)););return e}function xr(n,t){var e,r=[],i=[],u=n.length,o=t.length,a=Math.min(n.length,t.length);for(e=0;a>e;++e)r.push(Mr(n[e],t[e]));for(;u>e;++e)i[e]=n[e];for(;o>e;++e)i[e]=t[e];return function(n){for(e=0;a>e;++e)i[e]=r[e](n);return i}}function br(n){return function(t){return 0>=t?0:t>=1?1:n(t)}}function _r(n){return function(t){return 1-n(1-t)}}function wr(n){return function(t){return.5*(.5>t?n(2*t):2-n(2-2*t))}}function Sr(n){return n*n}function kr(n){return n*n*n}function Nr(n){if(0>=n)return 0;if(n>=1)return 1;var t=n*n,e=t*n;return 4*(.5>n?e:3*(n-t)+e-.75)}function Er(n){return function(t){return Math.pow(t,n)}}function Ar(n){return 1-Math.cos(n*Io)}function Cr(n){return Math.pow(2,10*(n-1))}function zr(n){return 1-Math.sqrt(1-n*n)}function Lr(n,t){var e;return arguments.length<2&&(t=.45),arguments.length?e=t/Ho*Math.asin(1/n):(n=1,e=t/4),function(r){return 1+n*Math.pow(2,-10*r)*Math.sin((r-e)*Ho/t)}}function qr(n){return n||(n=1.70158),function(t){return t*t*((n+1)*t-n)}}function Tr(n){return 1/2.75>n?7.5625*n*n:2/2.75>n?7.5625*(n-=1.5/2.75)*n+.75:2.5/2.75>n?7.5625*(n-=2.25/2.75)*n+.9375:7.5625*(n-=2.625/2.75)*n+.984375}function Rr(n,t){n=ao.hcl(n),t=ao.hcl(t);var e=n.h,r=n.c,i=n.l,u=t.h-e,o=t.c-r,a=t.l-i;return isNaN(o)&&(o=0,r=isNaN(r)?t.c:r),isNaN(u)?(u=0,e=isNaN(e)?t.h:e):u>180?u-=360:-180>u&&(u+=360),function(n){return sn(e+u*n,r+o*n,i+a*n)+""}}function Dr(n,t){n=ao.hsl(n),t=ao.hsl(t);var e=n.h,r=n.s,i=n.l,u=t.h-e,o=t.s-r,a=t.l-i;return isNaN(o)&&(o=0,r=isNaN(r)?t.s:r),isNaN(u)?(u=0,e=isNaN(e)?t.h:e):u>180?u-=360:-180>u&&(u+=360),function(n){return cn(e+u*n,r+o*n,i+a*n)+""}}function Pr(n,t){n=ao.lab(n),t=ao.lab(t);var e=n.l,r=n.a,i=n.b,u=t.l-e,o=t.a-r,a=t.b-i;return function(n){return pn(e+u*n,r+o*n,i+a*n)+""}}function Ur(n,t){return t-=n,function(e){return Math.round(n+t*e)}}function jr(n){var t=[n.a,n.b],e=[n.c,n.d],r=Hr(t),i=Fr(t,e),u=Hr(Or(e,t,-i))||0;t[0]*e[1]<e[0]*t[1]&&(t[0]*=-1,t[1]*=-1,r*=-1,i*=-1),this.rotate=(r?Math.atan2(t[1],t[0]):Math.atan2(-e[0],e[1]))*Zo,this.translate=[n.e,n.f],this.scale=[r,u],this.skew=u?Math.atan2(i,u)*Zo:0}function Fr(n,t){return n[0]*t[0]+n[1]*t[1]}function Hr(n){var t=Math.sqrt(Fr(n,n));return t&&(n[0]/=t,n[1]/=t),t}function Or(n,t,e){return n[0]+=e*t[0],n[1]+=e*t[1],n}function Ir(n){return n.length?n.pop()+",":""}function Yr(n,t,e,r){if(n[0]!==t[0]||n[1]!==t[1]){var i=e.push("translate(",null,",",null,")");r.push({i:i-4,x:yr(n[0],t[0])},{i:i-2,x:yr(n[1],t[1])})}else(t[0]||t[1])&&e.push("translate("+t+")")}function Zr(n,t,e,r){n!==t?(n-t>180?t+=360:t-n>180&&(n+=360),r.push({i:e.push(Ir(e)+"rotate(",null,")")-2,x:yr(n,t)})):t&&e.push(Ir(e)+"rotate("+t+")")}function Vr(n,t,e,r){n!==t?r.push({i:e.push(Ir(e)+"skewX(",null,")")-2,x:yr(n,t)}):t&&e.push(Ir(e)+"skewX("+t+")")}function Xr(n,t,e,r){if(n[0]!==t[0]||n[1]!==t[1]){var i=e.push(Ir(e)+"scale(",null,",",null,")");r.push({i:i-4,x:yr(n[0],t[0])},{i:i-2,x:yr(n[1],t[1])})}else 1===t[0]&&1===t[1]||e.push(Ir(e)+"scale("+t+")")}function $r(n,t){var e=[],r=[];return n=ao.transform(n),t=ao.transform(t),Yr(n.translate,t.translate,e,r),Zr(n.rotate,t.rotate,e,r),Vr(n.skew,t.skew,e,r),Xr(n.scale,t.scale,e,r),n=t=null,function(n){for(var t,i=-1,u=r.length;++i<u;)e[(t=r[i]).i]=t.x(n);return e.join("")}}function Br(n,t){return t=(t-=n=+n)||1/t,function(e){return(e-n)/t}}function Wr(n,t){return t=(t-=n=+n)||1/t,function(e){return Math.max(0,Math.min(1,(e-n)/t))}}function Jr(n){for(var t=n.source,e=n.target,r=Kr(t,e),i=[t];t!==r;)t=t.parent,i.push(t);for(var u=i.length;e!==r;)i.splice(u,0,e),e=e.parent;return i}function Gr(n){for(var t=[],e=n.parent;null!=e;)t.push(n),n=e,e=e.parent;return t.push(n),t}function Kr(n,t){if(n===t)return n;for(var e=Gr(n),r=Gr(t),i=e.pop(),u=r.pop(),o=null;i===u;)o=i,i=e.pop(),u=r.pop();return o}function Qr(n){n.fixed|=2}function ni(n){n.fixed&=-7}function ti(n){n.fixed|=4,n.px=n.x,n.py=n.y}function ei(n){n.fixed&=-5}function ri(n,t,e){var r=0,i=0;if(n.charge=0,!n.leaf)for(var u,o=n.nodes,a=o.length,l=-1;++l<a;)u=o[l],null!=u&&(ri(u,t,e),n.charge+=u.charge,r+=u.charge*u.cx,i+=u.charge*u.cy);if(n.point){n.leaf||(n.point.x+=Math.random()-.5,n.point.y+=Math.random()-.5);var c=t*e[n.point.index];n.charge+=n.pointCharge=c,r+=c*n.point.x,i+=c*n.point.y}n.cx=r/n.charge,n.cy=i/n.charge}function ii(n,t){return ao.rebind(n,t,"sort","children","value"),n.nodes=n,n.links=fi,n}function ui(n,t){for(var e=[n];null!=(n=e.pop());)if(t(n),(i=n.children)&&(r=i.length))for(var r,i;--r>=0;)e.push(i[r])}function oi(n,t){for(var e=[n],r=[];null!=(n=e.pop());)if(r.push(n),(u=n.children)&&(i=u.length))for(var i,u,o=-1;++o<i;)e.push(u[o]);for(;null!=(n=r.pop());)t(n)}function ai(n){return n.children}function li(n){return n.value}function ci(n,t){return t.value-n.value}function fi(n){return ao.merge(n.map(function(n){return(n.children||[]).map(function(t){return{source:n,target:t}})}))}function si(n){return n.x}function hi(n){return n.y}function pi(n,t,e){n.y0=t,n.y=e}function gi(n){return ao.range(n.length)}function vi(n){for(var t=-1,e=n[0].length,r=[];++t<e;)r[t]=0;return r}function di(n){for(var t,e=1,r=0,i=n[0][1],u=n.length;u>e;++e)(t=n[e][1])>i&&(r=e,i=t);return r}function yi(n){return n.reduce(mi,0)}function mi(n,t){return n+t[1]}function Mi(n,t){return xi(n,Math.ceil(Math.log(t.length)/Math.LN2+1))}function xi(n,t){for(var e=-1,r=+n[0],i=(n[1]-r)/t,u=[];++e<=t;)u[e]=i*e+r;return u}function bi(n){return[ao.min(n),ao.max(n)]}function _i(n,t){return n.value-t.value}function wi(n,t){var e=n._pack_next;n._pack_next=t,t._pack_prev=n,t._pack_next=e,e._pack_prev=t}function Si(n,t){n._pack_next=t,t._pack_prev=n}function ki(n,t){var e=t.x-n.x,r=t.y-n.y,i=n.r+t.r;return.999*i*i>e*e+r*r}function Ni(n){function t(n){f=Math.min(n.x-n.r,f),s=Math.max(n.x+n.r,s),h=Math.min(n.y-n.r,h),p=Math.max(n.y+n.r,p)}if((e=n.children)&&(c=e.length)){var e,r,i,u,o,a,l,c,f=1/0,s=-(1/0),h=1/0,p=-(1/0);if(e.forEach(Ei),r=e[0],r.x=-r.r,r.y=0,t(r),c>1&&(i=e[1],i.x=i.r,i.y=0,t(i),c>2))for(u=e[2],zi(r,i,u),t(u),wi(r,u),r._pack_prev=u,wi(u,i),i=r._pack_next,o=3;c>o;o++){zi(r,i,u=e[o]);var g=0,v=1,d=1;for(a=i._pack_next;a!==i;a=a._pack_next,v++)if(ki(a,u)){g=1;break}if(1==g)for(l=r._pack_prev;l!==a._pack_prev&&!ki(l,u);l=l._pack_prev,d++);g?(d>v||v==d&&i.r<r.r?Si(r,i=a):Si(r=l,i),o--):(wi(r,u),i=u,t(u))}var y=(f+s)/2,m=(h+p)/2,M=0;for(o=0;c>o;o++)u=e[o],u.x-=y,u.y-=m,M=Math.max(M,u.r+Math.sqrt(u.x*u.x+u.y*u.y));n.r=M,e.forEach(Ai)}}function Ei(n){n._pack_next=n._pack_prev=n}function Ai(n){delete n._pack_next,delete n._pack_prev}function Ci(n,t,e,r){var i=n.children;if(n.x=t+=r*n.x,n.y=e+=r*n.y,n.r*=r,i)for(var u=-1,o=i.length;++u<o;)Ci(i[u],t,e,r)}function zi(n,t,e){var r=n.r+e.r,i=t.x-n.x,u=t.y-n.y;if(r&&(i||u)){var o=t.r+e.r,a=i*i+u*u;o*=o,r*=r;var l=.5+(r-o)/(2*a),c=Math.sqrt(Math.max(0,2*o*(r+a)-(r-=a)*r-o*o))/(2*a);e.x=n.x+l*i+c*u,e.y=n.y+l*u-c*i}else e.x=n.x+r,e.y=n.y}function Li(n,t){return n.parent==t.parent?1:2}function qi(n){var t=n.children;return t.length?t[0]:n.t}function Ti(n){var t,e=n.children;return(t=e.length)?e[t-1]:n.t}function Ri(n,t,e){var r=e/(t.i-n.i);t.c-=r,t.s+=e,n.c+=r,t.z+=e,t.m+=e}function Di(n){for(var t,e=0,r=0,i=n.children,u=i.length;--u>=0;)t=i[u],t.z+=e,t.m+=e,e+=t.s+(r+=t.c)}function Pi(n,t,e){return n.a.parent===t.parent?n.a:e}function Ui(n){return 1+ao.max(n,function(n){return n.y})}function ji(n){return n.reduce(function(n,t){return n+t.x},0)/n.length}function Fi(n){var t=n.children;return t&&t.length?Fi(t[0]):n}function Hi(n){var t,e=n.children;return e&&(t=e.length)?Hi(e[t-1]):n}function Oi(n){return{x:n.x,y:n.y,dx:n.dx,dy:n.dy}}function Ii(n,t){var e=n.x+t[3],r=n.y+t[0],i=n.dx-t[1]-t[3],u=n.dy-t[0]-t[2];return 0>i&&(e+=i/2,i=0),0>u&&(r+=u/2,u=0),{x:e,y:r,dx:i,dy:u}}function Yi(n){var t=n[0],e=n[n.length-1];return e>t?[t,e]:[e,t]}function Zi(n){return n.rangeExtent?n.rangeExtent():Yi(n.range())}function Vi(n,t,e,r){var i=e(n[0],n[1]),u=r(t[0],t[1]);return function(n){return u(i(n))}}function Xi(n,t){var e,r=0,i=n.length-1,u=n[r],o=n[i];return u>o&&(e=r,r=i,i=e,e=u,u=o,o=e),n[r]=t.floor(u),n[i]=t.ceil(o),n}function $i(n){return n?{floor:function(t){return Math.floor(t/n)*n},ceil:function(t){return Math.ceil(t/n)*n}}:Sl}function Bi(n,t,e,r){var i=[],u=[],o=0,a=Math.min(n.length,t.length)-1;for(n[a]<n[0]&&(n=n.slice().reverse(),t=t.slice().reverse());++o<=a;)i.push(e(n[o-1],n[o])),u.push(r(t[o-1],t[o]));return function(t){var e=ao.bisect(n,t,1,a)-1;return u[e](i[e](t))}}function Wi(n,t,e,r){function i(){var i=Math.min(n.length,t.length)>2?Bi:Vi,l=r?Wr:Br;return o=i(n,t,l,e),a=i(t,n,l,Mr),u}function u(n){return o(n)}var o,a;return u.invert=function(n){return a(n)},u.domain=function(t){return arguments.length?(n=t.map(Number),i()):n},u.range=function(n){return arguments.length?(t=n,i()):t},u.rangeRound=function(n){return u.range(n).interpolate(Ur)},u.clamp=function(n){return arguments.length?(r=n,i()):r},u.interpolate=function(n){return arguments.length?(e=n,i()):e},u.ticks=function(t){return Qi(n,t)},u.tickFormat=function(t,e){return nu(n,t,e)},u.nice=function(t){return Gi(n,t),i()},u.copy=function(){return Wi(n,t,e,r)},i()}function Ji(n,t){return ao.rebind(n,t,"range","rangeRound","interpolate","clamp")}function Gi(n,t){return Xi(n,$i(Ki(n,t)[2])),Xi(n,$i(Ki(n,t)[2])),n}function Ki(n,t){null==t&&(t=10);var e=Yi(n),r=e[1]-e[0],i=Math.pow(10,Math.floor(Math.log(r/t)/Math.LN10)),u=t/r*i;return.15>=u?i*=10:.35>=u?i*=5:.75>=u&&(i*=2),e[0]=Math.ceil(e[0]/i)*i,e[1]=Math.floor(e[1]/i)*i+.5*i,e[2]=i,e}function Qi(n,t){return ao.range.apply(ao,Ki(n,t))}function nu(n,t,e){var r=Ki(n,t);if(e){var i=ha.exec(e);if(i.shift(),"s"===i[8]){var u=ao.formatPrefix(Math.max(xo(r[0]),xo(r[1])));return i[7]||(i[7]="."+tu(u.scale(r[2]))),i[8]="f",e=ao.format(i.join("")),function(n){return e(u.scale(n))+u.symbol}}i[7]||(i[7]="."+eu(i[8],r)),e=i.join("")}else e=",."+tu(r[2])+"f";return ao.format(e)}function tu(n){return-Math.floor(Math.log(n)/Math.LN10+.01)}function eu(n,t){var e=tu(t[2]);return n in kl?Math.abs(e-tu(Math.max(xo(t[0]),xo(t[1]))))+ +("e"!==n):e-2*("%"===n)}function ru(n,t,e,r){function i(n){return(e?Math.log(0>n?0:n):-Math.log(n>0?0:-n))/Math.log(t)}function u(n){return e?Math.pow(t,n):-Math.pow(t,-n)}function o(t){return n(i(t))}return o.invert=function(t){return u(n.invert(t))},o.domain=function(t){return arguments.length?(e=t[0]>=0,n.domain((r=t.map(Number)).map(i)),o):r},o.base=function(e){return arguments.length?(t=+e,n.domain(r.map(i)),o):t},o.nice=function(){var t=Xi(r.map(i),e?Math:El);return n.domain(t),r=t.map(u),o},o.ticks=function(){var n=Yi(r),o=[],a=n[0],l=n[1],c=Math.floor(i(a)),f=Math.ceil(i(l)),s=t%1?2:t;if(isFinite(f-c)){if(e){for(;f>c;c++)for(var h=1;s>h;h++)o.push(u(c)*h);o.push(u(c))}else for(o.push(u(c));c++<f;)for(var h=s-1;h>0;h--)o.push(u(c)*h);for(c=0;o[c]<a;c++);for(f=o.length;o[f-1]>l;f--);o=o.slice(c,f)}return o},o.tickFormat=function(n,e){if(!arguments.length)return Nl;arguments.length<2?e=Nl:"function"!=typeof e&&(e=ao.format(e));var r=Math.max(1,t*n/o.ticks().length);return function(n){var o=n/u(Math.round(i(n)));return t-.5>o*t&&(o*=t),r>=o?e(n):""}},o.copy=function(){return ru(n.copy(),t,e,r)},Ji(o,n)}function iu(n,t,e){function r(t){return n(i(t))}var i=uu(t),u=uu(1/t);return r.invert=function(t){return u(n.invert(t))},r.domain=function(t){return arguments.length?(n.domain((e=t.map(Number)).map(i)),r):e},r.ticks=function(n){return Qi(e,n)},r.tickFormat=function(n,t){return nu(e,n,t)},r.nice=function(n){return r.domain(Gi(e,n))},r.exponent=function(o){return arguments.length?(i=uu(t=o),u=uu(1/t),n.domain(e.map(i)),r):t},r.copy=function(){return iu(n.copy(),t,e)},Ji(r,n)}function uu(n){return function(t){return 0>t?-Math.pow(-t,n):Math.pow(t,n)}}function ou(n,t){function e(e){return u[((i.get(e)||("range"===t.t?i.set(e,n.push(e)):NaN))-1)%u.length]}function r(t,e){return ao.range(n.length).map(function(n){return t+e*n})}var i,u,o;return e.domain=function(r){if(!arguments.length)return n;n=[],i=new c;for(var u,o=-1,a=r.length;++o<a;)i.has(u=r[o])||i.set(u,n.push(u));return e[t.t].apply(e,t.a)},e.range=function(n){return arguments.length?(u=n,o=0,t={t:"range",a:arguments},e):u},e.rangePoints=function(i,a){arguments.length<2&&(a=0);var l=i[0],c=i[1],f=n.length<2?(l=(l+c)/2,0):(c-l)/(n.length-1+a);return u=r(l+f*a/2,f),o=0,t={t:"rangePoints",a:arguments},e},e.rangeRoundPoints=function(i,a){arguments.length<2&&(a=0);var l=i[0],c=i[1],f=n.length<2?(l=c=Math.round((l+c)/2),0):(c-l)/(n.length-1+a)|0;return u=r(l+Math.round(f*a/2+(c-l-(n.length-1+a)*f)/2),f),o=0,t={t:"rangeRoundPoints",a:arguments},e},e.rangeBands=function(i,a,l){arguments.length<2&&(a=0),arguments.length<3&&(l=a);var c=i[1]<i[0],f=i[c-0],s=i[1-c],h=(s-f)/(n.length-a+2*l);return u=r(f+h*l,h),c&&u.reverse(),o=h*(1-a),t={t:"rangeBands",a:arguments},e},e.rangeRoundBands=function(i,a,l){arguments.length<2&&(a=0),arguments.length<3&&(l=a);var c=i[1]<i[0],f=i[c-0],s=i[1-c],h=Math.floor((s-f)/(n.length-a+2*l));return u=r(f+Math.round((s-f-(n.length-a)*h)/2),h),c&&u.reverse(),o=Math.round(h*(1-a)),t={t:"rangeRoundBands",a:arguments},e},e.rangeBand=function(){return o},e.rangeExtent=function(){return Yi(t.a[0])},e.copy=function(){return ou(n,t)},e.domain(n)}function au(n,t){function u(){var e=0,r=t.length;for(a=[];++e<r;)a[e-1]=ao.quantile(n,e/r);return o}function o(n){return isNaN(n=+n)?void 0:t[ao.bisect(a,n)]}var a;return o.domain=function(t){return arguments.length?(n=t.map(r).filter(i).sort(e),u()):n},o.range=function(n){return arguments.length?(t=n,u()):t},o.quantiles=function(){return a},o.invertExtent=function(e){return e=t.indexOf(e),0>e?[NaN,NaN]:[e>0?a[e-1]:n[0],e<a.length?a[e]:n[n.length-1]]},o.copy=function(){return au(n,t)},u()}function lu(n,t,e){function r(t){return e[Math.max(0,Math.min(o,Math.floor(u*(t-n))))]}function i(){return u=e.length/(t-n),o=e.length-1,r}var u,o;return r.domain=function(e){return arguments.length?(n=+e[0],t=+e[e.length-1],i()):[n,t]},r.range=function(n){return arguments.length?(e=n,i()):e},r.invertExtent=function(t){return t=e.indexOf(t),t=0>t?NaN:t/u+n,[t,t+1/u]},r.copy=function(){return lu(n,t,e)},i()}function cu(n,t){function e(e){return e>=e?t[ao.bisect(n,e)]:void 0}return e.domain=function(t){return arguments.length?(n=t,e):n},e.range=function(n){return arguments.length?(t=n,e):t},e.invertExtent=function(e){return e=t.indexOf(e),[n[e-1],n[e]]},e.copy=function(){return cu(n,t)},e}function fu(n){function t(n){return+n}return t.invert=t,t.domain=t.range=function(e){return arguments.length?(n=e.map(t),t):n},t.ticks=function(t){return Qi(n,t)},t.tickFormat=function(t,e){return nu(n,t,e)},t.copy=function(){return fu(n)},t}function su(){return 0}function hu(n){return n.innerRadius}function pu(n){return n.outerRadius}function gu(n){return n.startAngle}function vu(n){return n.endAngle}function du(n){return n&&n.padAngle}function yu(n,t,e,r){return(n-e)*t-(t-r)*n>0?0:1}function mu(n,t,e,r,i){var u=n[0]-t[0],o=n[1]-t[1],a=(i?r:-r)/Math.sqrt(u*u+o*o),l=a*o,c=-a*u,f=n[0]+l,s=n[1]+c,h=t[0]+l,p=t[1]+c,g=(f+h)/2,v=(s+p)/2,d=h-f,y=p-s,m=d*d+y*y,M=e-r,x=f*p-h*s,b=(0>y?-1:1)*Math.sqrt(Math.max(0,M*M*m-x*x)),_=(x*y-d*b)/m,w=(-x*d-y*b)/m,S=(x*y+d*b)/m,k=(-x*d+y*b)/m,N=_-g,E=w-v,A=S-g,C=k-v;return N*N+E*E>A*A+C*C&&(_=S,w=k),[[_-l,w-c],[_*e/M,w*e/M]]}function Mu(n){function t(t){function o(){c.push("M",u(n(f),a))}for(var l,c=[],f=[],s=-1,h=t.length,p=En(e),g=En(r);++s<h;)i.call(this,l=t[s],s)?f.push([+p.call(this,l,s),+g.call(this,l,s)]):f.length&&(o(),f=[]);return f.length&&o(),c.length?c.join(""):null}var e=Ce,r=ze,i=zt,u=xu,o=u.key,a=.7;return t.x=function(n){return arguments.length?(e=n,t):e},t.y=function(n){return arguments.length?(r=n,t):r},t.defined=function(n){return arguments.length?(i=n,t):i},t.interpolate=function(n){return arguments.length?(o="function"==typeof n?u=n:(u=Tl.get(n)||xu).key,t):o},t.tension=function(n){return arguments.length?(a=n,t):a},t}function xu(n){return n.length>1?n.join("L"):n+"Z"}function bu(n){return n.join("L")+"Z"}function _u(n){for(var t=0,e=n.length,r=n[0],i=[r[0],",",r[1]];++t<e;)i.push("H",(r[0]+(r=n[t])[0])/2,"V",r[1]);return e>1&&i.push("H",r[0]),i.join("")}function wu(n){for(var t=0,e=n.length,r=n[0],i=[r[0],",",r[1]];++t<e;)i.push("V",(r=n[t])[1],"H",r[0]);return i.join("")}function Su(n){for(var t=0,e=n.length,r=n[0],i=[r[0],",",r[1]];++t<e;)i.push("H",(r=n[t])[0],"V",r[1]);return i.join("")}function ku(n,t){return n.length<4?xu(n):n[1]+Au(n.slice(1,-1),Cu(n,t))}function Nu(n,t){return n.length<3?bu(n):n[0]+Au((n.push(n[0]),n),Cu([n[n.length-2]].concat(n,[n[1]]),t))}function Eu(n,t){return n.length<3?xu(n):n[0]+Au(n,Cu(n,t))}function Au(n,t){if(t.length<1||n.length!=t.length&&n.length!=t.length+2)return xu(n);var e=n.length!=t.length,r="",i=n[0],u=n[1],o=t[0],a=o,l=1;if(e&&(r+="Q"+(u[0]-2*o[0]/3)+","+(u[1]-2*o[1]/3)+","+u[0]+","+u[1],i=n[1],l=2),t.length>1){a=t[1],u=n[l],l++,r+="C"+(i[0]+o[0])+","+(i[1]+o[1])+","+(u[0]-a[0])+","+(u[1]-a[1])+","+u[0]+","+u[1];for(var c=2;c<t.length;c++,l++)u=n[l],a=t[c],r+="S"+(u[0]-a[0])+","+(u[1]-a[1])+","+u[0]+","+u[1]}if(e){var f=n[l];r+="Q"+(u[0]+2*a[0]/3)+","+(u[1]+2*a[1]/3)+","+f[0]+","+f[1]}return r}function Cu(n,t){for(var e,r=[],i=(1-t)/2,u=n[0],o=n[1],a=1,l=n.length;++a<l;)e=u,u=o,o=n[a],r.push([i*(o[0]-e[0]),i*(o[1]-e[1])]);return r}function zu(n){if(n.length<3)return xu(n);var t=1,e=n.length,r=n[0],i=r[0],u=r[1],o=[i,i,i,(r=n[1])[0]],a=[u,u,u,r[1]],l=[i,",",u,"L",Ru(Pl,o),",",Ru(Pl,a)];for(n.push(n[e-1]);++t<=e;)r=n[t],o.shift(),o.push(r[0]),a.shift(),a.push(r[1]),Du(l,o,a);return n.pop(),l.push("L",r),l.join("")}function Lu(n){if(n.length<4)return xu(n);for(var t,e=[],r=-1,i=n.length,u=[0],o=[0];++r<3;)t=n[r],u.push(t[0]),o.push(t[1]);for(e.push(Ru(Pl,u)+","+Ru(Pl,o)),--r;++r<i;)t=n[r],u.shift(),u.push(t[0]),o.shift(),o.push(t[1]),Du(e,u,o);return e.join("")}function qu(n){for(var t,e,r=-1,i=n.length,u=i+4,o=[],a=[];++r<4;)e=n[r%i],o.push(e[0]),a.push(e[1]);for(t=[Ru(Pl,o),",",Ru(Pl,a)],--r;++r<u;)e=n[r%i],o.shift(),o.push(e[0]),a.shift(),a.push(e[1]),Du(t,o,a);return t.join("")}function Tu(n,t){var e=n.length-1;if(e)for(var r,i,u=n[0][0],o=n[0][1],a=n[e][0]-u,l=n[e][1]-o,c=-1;++c<=e;)r=n[c],i=c/e,r[0]=t*r[0]+(1-t)*(u+i*a),r[1]=t*r[1]+(1-t)*(o+i*l);return zu(n)}function Ru(n,t){return n[0]*t[0]+n[1]*t[1]+n[2]*t[2]+n[3]*t[3]}function Du(n,t,e){n.push("C",Ru(Rl,t),",",Ru(Rl,e),",",Ru(Dl,t),",",Ru(Dl,e),",",Ru(Pl,t),",",Ru(Pl,e))}function Pu(n,t){return(t[1]-n[1])/(t[0]-n[0])}function Uu(n){for(var t=0,e=n.length-1,r=[],i=n[0],u=n[1],o=r[0]=Pu(i,u);++t<e;)r[t]=(o+(o=Pu(i=u,u=n[t+1])))/2;return r[t]=o,r}function ju(n){for(var t,e,r,i,u=[],o=Uu(n),a=-1,l=n.length-1;++a<l;)t=Pu(n[a],n[a+1]),xo(t)<Uo?o[a]=o[a+1]=0:(e=o[a]/t,r=o[a+1]/t,i=e*e+r*r,i>9&&(i=3*t/Math.sqrt(i),o[a]=i*e,o[a+1]=i*r));for(a=-1;++a<=l;)i=(n[Math.min(l,a+1)][0]-n[Math.max(0,a-1)][0])/(6*(1+o[a]*o[a])),u.push([i||0,o[a]*i||0]);return u}function Fu(n){return n.length<3?xu(n):n[0]+Au(n,ju(n))}function Hu(n){for(var t,e,r,i=-1,u=n.length;++i<u;)t=n[i],e=t[0],r=t[1]-Io,t[0]=e*Math.cos(r),t[1]=e*Math.sin(r);return n}function Ou(n){function t(t){function l(){v.push("M",a(n(y),s),f,c(n(d.reverse()),s),"Z")}for(var h,p,g,v=[],d=[],y=[],m=-1,M=t.length,x=En(e),b=En(i),_=e===r?function(){
return p}:En(r),w=i===u?function(){return g}:En(u);++m<M;)o.call(this,h=t[m],m)?(d.push([p=+x.call(this,h,m),g=+b.call(this,h,m)]),y.push([+_.call(this,h,m),+w.call(this,h,m)])):d.length&&(l(),d=[],y=[]);return d.length&&l(),v.length?v.join(""):null}var e=Ce,r=Ce,i=0,u=ze,o=zt,a=xu,l=a.key,c=a,f="L",s=.7;return t.x=function(n){return arguments.length?(e=r=n,t):r},t.x0=function(n){return arguments.length?(e=n,t):e},t.x1=function(n){return arguments.length?(r=n,t):r},t.y=function(n){return arguments.length?(i=u=n,t):u},t.y0=function(n){return arguments.length?(i=n,t):i},t.y1=function(n){return arguments.length?(u=n,t):u},t.defined=function(n){return arguments.length?(o=n,t):o},t.interpolate=function(n){return arguments.length?(l="function"==typeof n?a=n:(a=Tl.get(n)||xu).key,c=a.reverse||a,f=a.closed?"M":"L",t):l},t.tension=function(n){return arguments.length?(s=n,t):s},t}function Iu(n){return n.radius}function Yu(n){return[n.x,n.y]}function Zu(n){return function(){var t=n.apply(this,arguments),e=t[0],r=t[1]-Io;return[e*Math.cos(r),e*Math.sin(r)]}}function Vu(){return 64}function Xu(){return"circle"}function $u(n){var t=Math.sqrt(n/Fo);return"M0,"+t+"A"+t+","+t+" 0 1,1 0,"+-t+"A"+t+","+t+" 0 1,1 0,"+t+"Z"}function Bu(n){return function(){var t,e,r;(t=this[n])&&(r=t[e=t.active])&&(r.timer.c=null,r.timer.t=NaN,--t.count?delete t[e]:delete this[n],t.active+=.5,r.event&&r.event.interrupt.call(this,this.__data__,r.index))}}function Wu(n,t,e){return ko(n,Yl),n.namespace=t,n.id=e,n}function Ju(n,t,e,r){var i=n.id,u=n.namespace;return Y(n,"function"==typeof e?function(n,o,a){n[u][i].tween.set(t,r(e.call(n,n.__data__,o,a)))}:(e=r(e),function(n){n[u][i].tween.set(t,e)}))}function Gu(n){return null==n&&(n=""),function(){this.textContent=n}}function Ku(n){return null==n?"__transition__":"__transition_"+n+"__"}function Qu(n,t,e,r,i){function u(n){var t=v.delay;return f.t=t+l,n>=t?o(n-t):void(f.c=o)}function o(e){var i=g.active,u=g[i];u&&(u.timer.c=null,u.timer.t=NaN,--g.count,delete g[i],u.event&&u.event.interrupt.call(n,n.__data__,u.index));for(var o in g)if(r>+o){var c=g[o];c.timer.c=null,c.timer.t=NaN,--g.count,delete g[o]}f.c=a,qn(function(){return f.c&&a(e||1)&&(f.c=null,f.t=NaN),1},0,l),g.active=r,v.event&&v.event.start.call(n,n.__data__,t),p=[],v.tween.forEach(function(e,r){(r=r.call(n,n.__data__,t))&&p.push(r)}),h=v.ease,s=v.duration}function a(i){for(var u=i/s,o=h(u),a=p.length;a>0;)p[--a].call(n,o);return u>=1?(v.event&&v.event.end.call(n,n.__data__,t),--g.count?delete g[r]:delete n[e],1):void 0}var l,f,s,h,p,g=n[e]||(n[e]={active:0,count:0}),v=g[r];v||(l=i.time,f=qn(u,0,l),v=g[r]={tween:new c,time:l,timer:f,delay:i.delay,duration:i.duration,ease:i.ease,index:t},i=null,++g.count)}function no(n,t,e){n.attr("transform",function(n){var r=t(n);return"translate("+(isFinite(r)?r:e(n))+",0)"})}function to(n,t,e){n.attr("transform",function(n){var r=t(n);return"translate(0,"+(isFinite(r)?r:e(n))+")"})}function eo(n){return n.toISOString()}function ro(n,t,e){function r(t){return n(t)}function i(n,e){var r=n[1]-n[0],i=r/e,u=ao.bisect(Kl,i);return u==Kl.length?[t.year,Ki(n.map(function(n){return n/31536e6}),e)[2]]:u?t[i/Kl[u-1]<Kl[u]/i?u-1:u]:[tc,Ki(n,e)[2]]}return r.invert=function(t){return io(n.invert(t))},r.domain=function(t){return arguments.length?(n.domain(t),r):n.domain().map(io)},r.nice=function(n,t){function e(e){return!isNaN(e)&&!n.range(e,io(+e+1),t).length}var u=r.domain(),o=Yi(u),a=null==n?i(o,10):"number"==typeof n&&i(o,n);return a&&(n=a[0],t=a[1]),r.domain(Xi(u,t>1?{floor:function(t){for(;e(t=n.floor(t));)t=io(t-1);return t},ceil:function(t){for(;e(t=n.ceil(t));)t=io(+t+1);return t}}:n))},r.ticks=function(n,t){var e=Yi(r.domain()),u=null==n?i(e,10):"number"==typeof n?i(e,n):!n.range&&[{range:n},t];return u&&(n=u[0],t=u[1]),n.range(e[0],io(+e[1]+1),1>t?1:t)},r.tickFormat=function(){return e},r.copy=function(){return ro(n.copy(),t,e)},Ji(r,n)}function io(n){return new Date(n)}function uo(n){return JSON.parse(n.responseText)}function oo(n){var t=fo.createRange();return t.selectNode(fo.body),t.createContextualFragment(n.responseText)}var ao={version:"3.5.17"},lo=[].slice,co=function(n){return lo.call(n)},fo=this.document;if(fo)try{co(fo.documentElement.childNodes)[0].nodeType}catch(so){co=function(n){for(var t=n.length,e=new Array(t);t--;)e[t]=n[t];return e}}if(Date.now||(Date.now=function(){return+new Date}),fo)try{fo.createElement("DIV").style.setProperty("opacity",0,"")}catch(ho){var po=this.Element.prototype,go=po.setAttribute,vo=po.setAttributeNS,yo=this.CSSStyleDeclaration.prototype,mo=yo.setProperty;po.setAttribute=function(n,t){go.call(this,n,t+"")},po.setAttributeNS=function(n,t,e){vo.call(this,n,t,e+"")},yo.setProperty=function(n,t,e){mo.call(this,n,t+"",e)}}ao.ascending=e,ao.descending=function(n,t){return n>t?-1:t>n?1:t>=n?0:NaN},ao.min=function(n,t){var e,r,i=-1,u=n.length;if(1===arguments.length){for(;++i<u;)if(null!=(r=n[i])&&r>=r){e=r;break}for(;++i<u;)null!=(r=n[i])&&e>r&&(e=r)}else{for(;++i<u;)if(null!=(r=t.call(n,n[i],i))&&r>=r){e=r;break}for(;++i<u;)null!=(r=t.call(n,n[i],i))&&e>r&&(e=r)}return e},ao.max=function(n,t){var e,r,i=-1,u=n.length;if(1===arguments.length){for(;++i<u;)if(null!=(r=n[i])&&r>=r){e=r;break}for(;++i<u;)null!=(r=n[i])&&r>e&&(e=r)}else{for(;++i<u;)if(null!=(r=t.call(n,n[i],i))&&r>=r){e=r;break}for(;++i<u;)null!=(r=t.call(n,n[i],i))&&r>e&&(e=r)}return e},ao.extent=function(n,t){var e,r,i,u=-1,o=n.length;if(1===arguments.length){for(;++u<o;)if(null!=(r=n[u])&&r>=r){e=i=r;break}for(;++u<o;)null!=(r=n[u])&&(e>r&&(e=r),r>i&&(i=r))}else{for(;++u<o;)if(null!=(r=t.call(n,n[u],u))&&r>=r){e=i=r;break}for(;++u<o;)null!=(r=t.call(n,n[u],u))&&(e>r&&(e=r),r>i&&(i=r))}return[e,i]},ao.sum=function(n,t){var e,r=0,u=n.length,o=-1;if(1===arguments.length)for(;++o<u;)i(e=+n[o])&&(r+=e);else for(;++o<u;)i(e=+t.call(n,n[o],o))&&(r+=e);return r},ao.mean=function(n,t){var e,u=0,o=n.length,a=-1,l=o;if(1===arguments.length)for(;++a<o;)i(e=r(n[a]))?u+=e:--l;else for(;++a<o;)i(e=r(t.call(n,n[a],a)))?u+=e:--l;return l?u/l:void 0},ao.quantile=function(n,t){var e=(n.length-1)*t+1,r=Math.floor(e),i=+n[r-1],u=e-r;return u?i+u*(n[r]-i):i},ao.median=function(n,t){var u,o=[],a=n.length,l=-1;if(1===arguments.length)for(;++l<a;)i(u=r(n[l]))&&o.push(u);else for(;++l<a;)i(u=r(t.call(n,n[l],l)))&&o.push(u);return o.length?ao.quantile(o.sort(e),.5):void 0},ao.variance=function(n,t){var e,u,o=n.length,a=0,l=0,c=-1,f=0;if(1===arguments.length)for(;++c<o;)i(e=r(n[c]))&&(u=e-a,a+=u/++f,l+=u*(e-a));else for(;++c<o;)i(e=r(t.call(n,n[c],c)))&&(u=e-a,a+=u/++f,l+=u*(e-a));return f>1?l/(f-1):void 0},ao.deviation=function(){var n=ao.variance.apply(this,arguments);return n?Math.sqrt(n):n};var Mo=u(e);ao.bisectLeft=Mo.left,ao.bisect=ao.bisectRight=Mo.right,ao.bisector=function(n){return u(1===n.length?function(t,r){return e(n(t),r)}:n)},ao.shuffle=function(n,t,e){(u=arguments.length)<3&&(e=n.length,2>u&&(t=0));for(var r,i,u=e-t;u;)i=Math.random()*u--|0,r=n[u+t],n[u+t]=n[i+t],n[i+t]=r;return n},ao.permute=function(n,t){for(var e=t.length,r=new Array(e);e--;)r[e]=n[t[e]];return r},ao.pairs=function(n){for(var t,e=0,r=n.length-1,i=n[0],u=new Array(0>r?0:r);r>e;)u[e]=[t=i,i=n[++e]];return u},ao.transpose=function(n){if(!(i=n.length))return[];for(var t=-1,e=ao.min(n,o),r=new Array(e);++t<e;)for(var i,u=-1,a=r[t]=new Array(i);++u<i;)a[u]=n[u][t];return r},ao.zip=function(){return ao.transpose(arguments)},ao.keys=function(n){var t=[];for(var e in n)t.push(e);return t},ao.values=function(n){var t=[];for(var e in n)t.push(n[e]);return t},ao.entries=function(n){var t=[];for(var e in n)t.push({key:e,value:n[e]});return t},ao.merge=function(n){for(var t,e,r,i=n.length,u=-1,o=0;++u<i;)o+=n[u].length;for(e=new Array(o);--i>=0;)for(r=n[i],t=r.length;--t>=0;)e[--o]=r[t];return e};var xo=Math.abs;ao.range=function(n,t,e){if(arguments.length<3&&(e=1,arguments.length<2&&(t=n,n=0)),(t-n)/e===1/0)throw new Error("infinite range");var r,i=[],u=a(xo(e)),o=-1;if(n*=u,t*=u,e*=u,0>e)for(;(r=n+e*++o)>t;)i.push(r/u);else for(;(r=n+e*++o)<t;)i.push(r/u);return i},ao.map=function(n,t){var e=new c;if(n instanceof c)n.forEach(function(n,t){e.set(n,t)});else if(Array.isArray(n)){var r,i=-1,u=n.length;if(1===arguments.length)for(;++i<u;)e.set(i,n[i]);else for(;++i<u;)e.set(t.call(n,r=n[i],i),r)}else for(var o in n)e.set(o,n[o]);return e};var bo="__proto__",_o="\x00";l(c,{has:h,get:function(n){return this._[f(n)]},set:function(n,t){return this._[f(n)]=t},remove:p,keys:g,values:function(){var n=[];for(var t in this._)n.push(this._[t]);return n},entries:function(){var n=[];for(var t in this._)n.push({key:s(t),value:this._[t]});return n},size:v,empty:d,forEach:function(n){for(var t in this._)n.call(this,s(t),this._[t])}}),ao.nest=function(){function n(t,o,a){if(a>=u.length)return r?r.call(i,o):e?o.sort(e):o;for(var l,f,s,h,p=-1,g=o.length,v=u[a++],d=new c;++p<g;)(h=d.get(l=v(f=o[p])))?h.push(f):d.set(l,[f]);return t?(f=t(),s=function(e,r){f.set(e,n(t,r,a))}):(f={},s=function(e,r){f[e]=n(t,r,a)}),d.forEach(s),f}function t(n,e){if(e>=u.length)return n;var r=[],i=o[e++];return n.forEach(function(n,i){r.push({key:n,values:t(i,e)})}),i?r.sort(function(n,t){return i(n.key,t.key)}):r}var e,r,i={},u=[],o=[];return i.map=function(t,e){return n(e,t,0)},i.entries=function(e){return t(n(ao.map,e,0),0)},i.key=function(n){return u.push(n),i},i.sortKeys=function(n){return o[u.length-1]=n,i},i.sortValues=function(n){return e=n,i},i.rollup=function(n){return r=n,i},i},ao.set=function(n){var t=new y;if(n)for(var e=0,r=n.length;r>e;++e)t.add(n[e]);return t},l(y,{has:h,add:function(n){return this._[f(n+="")]=!0,n},remove:p,values:g,size:v,empty:d,forEach:function(n){for(var t in this._)n.call(this,s(t))}}),ao.behavior={},ao.rebind=function(n,t){for(var e,r=1,i=arguments.length;++r<i;)n[e=arguments[r]]=M(n,t,t[e]);return n};var wo=["webkit","ms","moz","Moz","o","O"];ao.dispatch=function(){for(var n=new _,t=-1,e=arguments.length;++t<e;)n[arguments[t]]=w(n);return n},_.prototype.on=function(n,t){var e=n.indexOf("."),r="";if(e>=0&&(r=n.slice(e+1),n=n.slice(0,e)),n)return arguments.length<2?this[n].on(r):this[n].on(r,t);if(2===arguments.length){if(null==t)for(n in this)this.hasOwnProperty(n)&&this[n].on(r,null);return this}},ao.event=null,ao.requote=function(n){return n.replace(So,"\\$&")};var So=/[\\\^\$\*\+\?\|\[\]\(\)\.\{\}]/g,ko={}.__proto__?function(n,t){n.__proto__=t}:function(n,t){for(var e in t)n[e]=t[e]},No=function(n,t){return t.querySelector(n)},Eo=function(n,t){return t.querySelectorAll(n)},Ao=function(n,t){var e=n.matches||n[x(n,"matchesSelector")];return(Ao=function(n,t){return e.call(n,t)})(n,t)};"function"==typeof Sizzle&&(No=function(n,t){return Sizzle(n,t)[0]||null},Eo=Sizzle,Ao=Sizzle.matchesSelector),ao.selection=function(){return ao.select(fo.documentElement)};var Co=ao.selection.prototype=[];Co.select=function(n){var t,e,r,i,u=[];n=A(n);for(var o=-1,a=this.length;++o<a;){u.push(t=[]),t.parentNode=(r=this[o]).parentNode;for(var l=-1,c=r.length;++l<c;)(i=r[l])?(t.push(e=n.call(i,i.__data__,l,o)),e&&"__data__"in i&&(e.__data__=i.__data__)):t.push(null)}return E(u)},Co.selectAll=function(n){var t,e,r=[];n=C(n);for(var i=-1,u=this.length;++i<u;)for(var o=this[i],a=-1,l=o.length;++a<l;)(e=o[a])&&(r.push(t=co(n.call(e,e.__data__,a,i))),t.parentNode=e);return E(r)};var zo="http://www.w3.org/1999/xhtml",Lo={svg:"http://www.w3.org/2000/svg",xhtml:zo,xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"};ao.ns={prefix:Lo,qualify:function(n){var t=n.indexOf(":"),e=n;return t>=0&&"xmlns"!==(e=n.slice(0,t))&&(n=n.slice(t+1)),Lo.hasOwnProperty(e)?{space:Lo[e],local:n}:n}},Co.attr=function(n,t){if(arguments.length<2){if("string"==typeof n){var e=this.node();return n=ao.ns.qualify(n),n.local?e.getAttributeNS(n.space,n.local):e.getAttribute(n)}for(t in n)this.each(z(t,n[t]));return this}return this.each(z(n,t))},Co.classed=function(n,t){if(arguments.length<2){if("string"==typeof n){var e=this.node(),r=(n=T(n)).length,i=-1;if(t=e.classList){for(;++i<r;)if(!t.contains(n[i]))return!1}else for(t=e.getAttribute("class");++i<r;)if(!q(n[i]).test(t))return!1;return!0}for(t in n)this.each(R(t,n[t]));return this}return this.each(R(n,t))},Co.style=function(n,e,r){var i=arguments.length;if(3>i){if("string"!=typeof n){2>i&&(e="");for(r in n)this.each(P(r,n[r],e));return this}if(2>i){var u=this.node();return t(u).getComputedStyle(u,null).getPropertyValue(n)}r=""}return this.each(P(n,e,r))},Co.property=function(n,t){if(arguments.length<2){if("string"==typeof n)return this.node()[n];for(t in n)this.each(U(t,n[t]));return this}return this.each(U(n,t))},Co.text=function(n){return arguments.length?this.each("function"==typeof n?function(){var t=n.apply(this,arguments);this.textContent=null==t?"":t}:null==n?function(){this.textContent=""}:function(){this.textContent=n}):this.node().textContent},Co.html=function(n){return arguments.length?this.each("function"==typeof n?function(){var t=n.apply(this,arguments);this.innerHTML=null==t?"":t}:null==n?function(){this.innerHTML=""}:function(){this.innerHTML=n}):this.node().innerHTML},Co.append=function(n){return n=j(n),this.select(function(){return this.appendChild(n.apply(this,arguments))})},Co.insert=function(n,t){return n=j(n),t=A(t),this.select(function(){return this.insertBefore(n.apply(this,arguments),t.apply(this,arguments)||null)})},Co.remove=function(){return this.each(F)},Co.data=function(n,t){function e(n,e){var r,i,u,o=n.length,s=e.length,h=Math.min(o,s),p=new Array(s),g=new Array(s),v=new Array(o);if(t){var d,y=new c,m=new Array(o);for(r=-1;++r<o;)(i=n[r])&&(y.has(d=t.call(i,i.__data__,r))?v[r]=i:y.set(d,i),m[r]=d);for(r=-1;++r<s;)(i=y.get(d=t.call(e,u=e[r],r)))?i!==!0&&(p[r]=i,i.__data__=u):g[r]=H(u),y.set(d,!0);for(r=-1;++r<o;)r in m&&y.get(m[r])!==!0&&(v[r]=n[r])}else{for(r=-1;++r<h;)i=n[r],u=e[r],i?(i.__data__=u,p[r]=i):g[r]=H(u);for(;s>r;++r)g[r]=H(e[r]);for(;o>r;++r)v[r]=n[r]}g.update=p,g.parentNode=p.parentNode=v.parentNode=n.parentNode,a.push(g),l.push(p),f.push(v)}var r,i,u=-1,o=this.length;if(!arguments.length){for(n=new Array(o=(r=this[0]).length);++u<o;)(i=r[u])&&(n[u]=i.__data__);return n}var a=Z([]),l=E([]),f=E([]);if("function"==typeof n)for(;++u<o;)e(r=this[u],n.call(r,r.parentNode.__data__,u));else for(;++u<o;)e(r=this[u],n);return l.enter=function(){return a},l.exit=function(){return f},l},Co.datum=function(n){return arguments.length?this.property("__data__",n):this.property("__data__")},Co.filter=function(n){var t,e,r,i=[];"function"!=typeof n&&(n=O(n));for(var u=0,o=this.length;o>u;u++){i.push(t=[]),t.parentNode=(e=this[u]).parentNode;for(var a=0,l=e.length;l>a;a++)(r=e[a])&&n.call(r,r.__data__,a,u)&&t.push(r)}return E(i)},Co.order=function(){for(var n=-1,t=this.length;++n<t;)for(var e,r=this[n],i=r.length-1,u=r[i];--i>=0;)(e=r[i])&&(u&&u!==e.nextSibling&&u.parentNode.insertBefore(e,u),u=e);return this},Co.sort=function(n){n=I.apply(this,arguments);for(var t=-1,e=this.length;++t<e;)this[t].sort(n);return this.order()},Co.each=function(n){return Y(this,function(t,e,r){n.call(t,t.__data__,e,r)})},Co.call=function(n){var t=co(arguments);return n.apply(t[0]=this,t),this},Co.empty=function(){return!this.node()},Co.node=function(){for(var n=0,t=this.length;t>n;n++)for(var e=this[n],r=0,i=e.length;i>r;r++){var u=e[r];if(u)return u}return null},Co.size=function(){var n=0;return Y(this,function(){++n}),n};var qo=[];ao.selection.enter=Z,ao.selection.enter.prototype=qo,qo.append=Co.append,qo.empty=Co.empty,qo.node=Co.node,qo.call=Co.call,qo.size=Co.size,qo.select=function(n){for(var t,e,r,i,u,o=[],a=-1,l=this.length;++a<l;){r=(i=this[a]).update,o.push(t=[]),t.parentNode=i.parentNode;for(var c=-1,f=i.length;++c<f;)(u=i[c])?(t.push(r[c]=e=n.call(i.parentNode,u.__data__,c,a)),e.__data__=u.__data__):t.push(null)}return E(o)},qo.insert=function(n,t){return arguments.length<2&&(t=V(this)),Co.insert.call(this,n,t)},ao.select=function(t){var e;return"string"==typeof t?(e=[No(t,fo)],e.parentNode=fo.documentElement):(e=[t],e.parentNode=n(t)),E([e])},ao.selectAll=function(n){var t;return"string"==typeof n?(t=co(Eo(n,fo)),t.parentNode=fo.documentElement):(t=co(n),t.parentNode=null),E([t])},Co.on=function(n,t,e){var r=arguments.length;if(3>r){if("string"!=typeof n){2>r&&(t=!1);for(e in n)this.each(X(e,n[e],t));return this}if(2>r)return(r=this.node()["__on"+n])&&r._;e=!1}return this.each(X(n,t,e))};var To=ao.map({mouseenter:"mouseover",mouseleave:"mouseout"});fo&&To.forEach(function(n){"on"+n in fo&&To.remove(n)});var Ro,Do=0;ao.mouse=function(n){return J(n,k())};var Po=this.navigator&&/WebKit/.test(this.navigator.userAgent)?-1:0;ao.touch=function(n,t,e){if(arguments.length<3&&(e=t,t=k().changedTouches),t)for(var r,i=0,u=t.length;u>i;++i)if((r=t[i]).identifier===e)return J(n,r)},ao.behavior.drag=function(){function n(){this.on("mousedown.drag",u).on("touchstart.drag",o)}function e(n,t,e,u,o){return function(){function a(){var n,e,r=t(h,v);r&&(n=r[0]-M[0],e=r[1]-M[1],g|=n|e,M=r,p({type:"drag",x:r[0]+c[0],y:r[1]+c[1],dx:n,dy:e}))}function l(){t(h,v)&&(y.on(u+d,null).on(o+d,null),m(g),p({type:"dragend"}))}var c,f=this,s=ao.event.target.correspondingElement||ao.event.target,h=f.parentNode,p=r.of(f,arguments),g=0,v=n(),d=".drag"+(null==v?"":"-"+v),y=ao.select(e(s)).on(u+d,a).on(o+d,l),m=W(s),M=t(h,v);i?(c=i.apply(f,arguments),c=[c.x-M[0],c.y-M[1]]):c=[0,0],p({type:"dragstart"})}}var r=N(n,"drag","dragstart","dragend"),i=null,u=e(b,ao.mouse,t,"mousemove","mouseup"),o=e(G,ao.touch,m,"touchmove","touchend");return n.origin=function(t){return arguments.length?(i=t,n):i},ao.rebind(n,r,"on")},ao.touches=function(n,t){return arguments.length<2&&(t=k().touches),t?co(t).map(function(t){var e=J(n,t);return e.identifier=t.identifier,e}):[]};var Uo=1e-6,jo=Uo*Uo,Fo=Math.PI,Ho=2*Fo,Oo=Ho-Uo,Io=Fo/2,Yo=Fo/180,Zo=180/Fo,Vo=Math.SQRT2,Xo=2,$o=4;ao.interpolateZoom=function(n,t){var e,r,i=n[0],u=n[1],o=n[2],a=t[0],l=t[1],c=t[2],f=a-i,s=l-u,h=f*f+s*s;if(jo>h)r=Math.log(c/o)/Vo,e=function(n){return[i+n*f,u+n*s,o*Math.exp(Vo*n*r)]};else{var p=Math.sqrt(h),g=(c*c-o*o+$o*h)/(2*o*Xo*p),v=(c*c-o*o-$o*h)/(2*c*Xo*p),d=Math.log(Math.sqrt(g*g+1)-g),y=Math.log(Math.sqrt(v*v+1)-v);r=(y-d)/Vo,e=function(n){var t=n*r,e=rn(d),a=o/(Xo*p)*(e*un(Vo*t+d)-en(d));return[i+a*f,u+a*s,o*e/rn(Vo*t+d)]}}return e.duration=1e3*r,e},ao.behavior.zoom=function(){function n(n){n.on(L,s).on(Wo+".zoom",p).on("dblclick.zoom",g).on(R,h)}function e(n){return[(n[0]-k.x)/k.k,(n[1]-k.y)/k.k]}function r(n){return[n[0]*k.k+k.x,n[1]*k.k+k.y]}function i(n){k.k=Math.max(A[0],Math.min(A[1],n))}function u(n,t){t=r(t),k.x+=n[0]-t[0],k.y+=n[1]-t[1]}function o(t,e,r,o){t.__chart__={x:k.x,y:k.y,k:k.k},i(Math.pow(2,o)),u(d=e,r),t=ao.select(t),C>0&&(t=t.transition().duration(C)),t.call(n.event)}function a(){b&&b.domain(x.range().map(function(n){return(n-k.x)/k.k}).map(x.invert)),w&&w.domain(_.range().map(function(n){return(n-k.y)/k.k}).map(_.invert))}function l(n){z++||n({type:"zoomstart"})}function c(n){a(),n({type:"zoom",scale:k.k,translate:[k.x,k.y]})}function f(n){--z||(n({type:"zoomend"}),d=null)}function s(){function n(){a=1,u(ao.mouse(i),h),c(o)}function r(){s.on(q,null).on(T,null),p(a),f(o)}var i=this,o=D.of(i,arguments),a=0,s=ao.select(t(i)).on(q,n).on(T,r),h=e(ao.mouse(i)),p=W(i);Il.call(i),l(o)}function h(){function n(){var n=ao.touches(g);return p=k.k,n.forEach(function(n){n.identifier in d&&(d[n.identifier]=e(n))}),n}function t(){var t=ao.event.target;ao.select(t).on(x,r).on(b,a),_.push(t);for(var e=ao.event.changedTouches,i=0,u=e.length;u>i;++i)d[e[i].identifier]=null;var l=n(),c=Date.now();if(1===l.length){if(500>c-M){var f=l[0];o(g,f,d[f.identifier],Math.floor(Math.log(k.k)/Math.LN2)+1),S()}M=c}else if(l.length>1){var f=l[0],s=l[1],h=f[0]-s[0],p=f[1]-s[1];y=h*h+p*p}}function r(){var n,t,e,r,o=ao.touches(g);Il.call(g);for(var a=0,l=o.length;l>a;++a,r=null)if(e=o[a],r=d[e.identifier]){if(t)break;n=e,t=r}if(r){var f=(f=e[0]-n[0])*f+(f=e[1]-n[1])*f,s=y&&Math.sqrt(f/y);n=[(n[0]+e[0])/2,(n[1]+e[1])/2],t=[(t[0]+r[0])/2,(t[1]+r[1])/2],i(s*p)}M=null,u(n,t),c(v)}function a(){if(ao.event.touches.length){for(var t=ao.event.changedTouches,e=0,r=t.length;r>e;++e)delete d[t[e].identifier];for(var i in d)return void n()}ao.selectAll(_).on(m,null),w.on(L,s).on(R,h),N(),f(v)}var p,g=this,v=D.of(g,arguments),d={},y=0,m=".zoom-"+ao.event.changedTouches[0].identifier,x="touchmove"+m,b="touchend"+m,_=[],w=ao.select(g),N=W(g);t(),l(v),w.on(L,null).on(R,t)}function p(){var n=D.of(this,arguments);m?clearTimeout(m):(Il.call(this),v=e(d=y||ao.mouse(this)),l(n)),m=setTimeout(function(){m=null,f(n)},50),S(),i(Math.pow(2,.002*Bo())*k.k),u(d,v),c(n)}function g(){var n=ao.mouse(this),t=Math.log(k.k)/Math.LN2;o(this,n,e(n),ao.event.shiftKey?Math.ceil(t)-1:Math.floor(t)+1)}var v,d,y,m,M,x,b,_,w,k={x:0,y:0,k:1},E=[960,500],A=Jo,C=250,z=0,L="mousedown.zoom",q="mousemove.zoom",T="mouseup.zoom",R="touchstart.zoom",D=N(n,"zoomstart","zoom","zoomend");return Wo||(Wo="onwheel"in fo?(Bo=function(){return-ao.event.deltaY*(ao.event.deltaMode?120:1)},"wheel"):"onmousewheel"in fo?(Bo=function(){return ao.event.wheelDelta},"mousewheel"):(Bo=function(){return-ao.event.detail},"MozMousePixelScroll")),n.event=function(n){n.each(function(){var n=D.of(this,arguments),t=k;Hl?ao.select(this).transition().each("start.zoom",function(){k=this.__chart__||{x:0,y:0,k:1},l(n)}).tween("zoom:zoom",function(){var e=E[0],r=E[1],i=d?d[0]:e/2,u=d?d[1]:r/2,o=ao.interpolateZoom([(i-k.x)/k.k,(u-k.y)/k.k,e/k.k],[(i-t.x)/t.k,(u-t.y)/t.k,e/t.k]);return function(t){var r=o(t),a=e/r[2];this.__chart__=k={x:i-r[0]*a,y:u-r[1]*a,k:a},c(n)}}).each("interrupt.zoom",function(){f(n)}).each("end.zoom",function(){f(n)}):(this.__chart__=k,l(n),c(n),f(n))})},n.translate=function(t){return arguments.length?(k={x:+t[0],y:+t[1],k:k.k},a(),n):[k.x,k.y]},n.scale=function(t){return arguments.length?(k={x:k.x,y:k.y,k:null},i(+t),a(),n):k.k},n.scaleExtent=function(t){return arguments.length?(A=null==t?Jo:[+t[0],+t[1]],n):A},n.center=function(t){return arguments.length?(y=t&&[+t[0],+t[1]],n):y},n.size=function(t){return arguments.length?(E=t&&[+t[0],+t[1]],n):E},n.duration=function(t){return arguments.length?(C=+t,n):C},n.x=function(t){return arguments.length?(b=t,x=t.copy(),k={x:0,y:0,k:1},n):b},n.y=function(t){return arguments.length?(w=t,_=t.copy(),k={x:0,y:0,k:1},n):w},ao.rebind(n,D,"on")};var Bo,Wo,Jo=[0,1/0];ao.color=an,an.prototype.toString=function(){return this.rgb()+""},ao.hsl=ln;var Go=ln.prototype=new an;Go.brighter=function(n){return n=Math.pow(.7,arguments.length?n:1),new ln(this.h,this.s,this.l/n)},Go.darker=function(n){return n=Math.pow(.7,arguments.length?n:1),new ln(this.h,this.s,n*this.l)},Go.rgb=function(){return cn(this.h,this.s,this.l)},ao.hcl=fn;var Ko=fn.prototype=new an;Ko.brighter=function(n){return new fn(this.h,this.c,Math.min(100,this.l+Qo*(arguments.length?n:1)))},Ko.darker=function(n){return new fn(this.h,this.c,Math.max(0,this.l-Qo*(arguments.length?n:1)))},Ko.rgb=function(){return sn(this.h,this.c,this.l).rgb()},ao.lab=hn;var Qo=18,na=.95047,ta=1,ea=1.08883,ra=hn.prototype=new an;ra.brighter=function(n){return new hn(Math.min(100,this.l+Qo*(arguments.length?n:1)),this.a,this.b)},ra.darker=function(n){return new hn(Math.max(0,this.l-Qo*(arguments.length?n:1)),this.a,this.b)},ra.rgb=function(){return pn(this.l,this.a,this.b)},ao.rgb=mn;var ia=mn.prototype=new an;ia.brighter=function(n){n=Math.pow(.7,arguments.length?n:1);var t=this.r,e=this.g,r=this.b,i=30;return t||e||r?(t&&i>t&&(t=i),e&&i>e&&(e=i),r&&i>r&&(r=i),new mn(Math.min(255,t/n),Math.min(255,e/n),Math.min(255,r/n))):new mn(i,i,i)},ia.darker=function(n){return n=Math.pow(.7,arguments.length?n:1),new mn(n*this.r,n*this.g,n*this.b)},ia.hsl=function(){return wn(this.r,this.g,this.b)},ia.toString=function(){return"#"+bn(this.r)+bn(this.g)+bn(this.b)};var ua=ao.map({aliceblue:15792383,antiquewhite:16444375,aqua:65535,aquamarine:8388564,azure:15794175,beige:16119260,bisque:16770244,black:0,blanchedalmond:16772045,blue:255,blueviolet:9055202,brown:10824234,burlywood:14596231,cadetblue:6266528,chartreuse:8388352,chocolate:13789470,coral:16744272,cornflowerblue:6591981,cornsilk:16775388,crimson:14423100,cyan:65535,darkblue:139,darkcyan:35723,darkgoldenrod:12092939,darkgray:11119017,darkgreen:25600,darkgrey:11119017,darkkhaki:12433259,darkmagenta:9109643,darkolivegreen:5597999,darkorange:16747520,darkorchid:10040012,darkred:9109504,darksalmon:15308410,darkseagreen:9419919,darkslateblue:4734347,darkslategray:3100495,darkslategrey:3100495,darkturquoise:52945,darkviolet:9699539,deeppink:16716947,deepskyblue:49151,dimgray:6908265,dimgrey:6908265,dodgerblue:2003199,firebrick:11674146,floralwhite:16775920,forestgreen:2263842,fuchsia:16711935,gainsboro:14474460,ghostwhite:16316671,gold:16766720,goldenrod:14329120,gray:8421504,green:32768,greenyellow:11403055,grey:8421504,honeydew:15794160,hotpink:16738740,indianred:13458524,indigo:4915330,ivory:16777200,khaki:15787660,lavender:15132410,lavenderblush:16773365,lawngreen:8190976,lemonchiffon:16775885,lightblue:11393254,lightcoral:15761536,lightcyan:14745599,lightgoldenrodyellow:16448210,lightgray:13882323,lightgreen:9498256,lightgrey:13882323,lightpink:16758465,lightsalmon:16752762,lightseagreen:2142890,lightskyblue:8900346,lightslategray:7833753,lightslategrey:7833753,lightsteelblue:11584734,lightyellow:16777184,lime:65280,limegreen:3329330,linen:16445670,magenta:16711935,maroon:8388608,mediumaquamarine:6737322,mediumblue:205,mediumorchid:12211667,mediumpurple:9662683,mediumseagreen:3978097,mediumslateblue:8087790,mediumspringgreen:64154,mediumturquoise:4772300,mediumvioletred:13047173,midnightblue:1644912,mintcream:16121850,mistyrose:16770273,moccasin:16770229,navajowhite:16768685,navy:128,oldlace:16643558,olive:8421376,olivedrab:7048739,orange:16753920,orangered:16729344,orchid:14315734,palegoldenrod:15657130,palegreen:10025880,paleturquoise:11529966,palevioletred:14381203,papayawhip:16773077,peachpuff:16767673,peru:13468991,pink:16761035,plum:14524637,powderblue:11591910,purple:8388736,rebeccapurple:6697881,red:16711680,rosybrown:12357519,royalblue:4286945,saddlebrown:9127187,salmon:16416882,sandybrown:16032864,seagreen:3050327,seashell:16774638,sienna:10506797,silver:12632256,skyblue:8900331,slateblue:6970061,slategray:7372944,slategrey:7372944,snow:16775930,springgreen:65407,steelblue:4620980,tan:13808780,teal:32896,thistle:14204888,tomato:16737095,turquoise:4251856,violet:15631086,wheat:16113331,white:16777215,whitesmoke:16119285,yellow:16776960,yellowgreen:10145074});ua.forEach(function(n,t){ua.set(n,Mn(t))}),ao.functor=En,ao.xhr=An(m),ao.dsv=function(n,t){function e(n,e,u){arguments.length<3&&(u=e,e=null);var o=Cn(n,t,null==e?r:i(e),u);return o.row=function(n){return arguments.length?o.response(null==(e=n)?r:i(n)):e},o}function r(n){return e.parse(n.responseText)}function i(n){return function(t){return e.parse(t.responseText,n)}}function u(t){return t.map(o).join(n)}function o(n){return a.test(n)?'"'+n.replace(/\"/g,'""')+'"':n}var a=new RegExp('["'+n+"\n]"),l=n.charCodeAt(0);return e.parse=function(n,t){var r;return e.parseRows(n,function(n,e){if(r)return r(n,e-1);var i=new Function("d","return {"+n.map(function(n,t){return JSON.stringify(n)+": d["+t+"]"}).join(",")+"}");r=t?function(n,e){return t(i(n),e)}:i})},e.parseRows=function(n,t){function e(){if(f>=c)return o;if(i)return i=!1,u;var t=f;if(34===n.charCodeAt(t)){for(var e=t;e++<c;)if(34===n.charCodeAt(e)){if(34!==n.charCodeAt(e+1))break;++e}f=e+2;var r=n.charCodeAt(e+1);return 13===r?(i=!0,10===n.charCodeAt(e+2)&&++f):10===r&&(i=!0),n.slice(t+1,e).replace(/""/g,'"')}for(;c>f;){var r=n.charCodeAt(f++),a=1;if(10===r)i=!0;else if(13===r)i=!0,10===n.charCodeAt(f)&&(++f,++a);else if(r!==l)continue;return n.slice(t,f-a)}return n.slice(t)}for(var r,i,u={},o={},a=[],c=n.length,f=0,s=0;(r=e())!==o;){for(var h=[];r!==u&&r!==o;)h.push(r),r=e();t&&null==(h=t(h,s++))||a.push(h)}return a},e.format=function(t){if(Array.isArray(t[0]))return e.formatRows(t);var r=new y,i=[];return t.forEach(function(n){for(var t in n)r.has(t)||i.push(r.add(t))}),[i.map(o).join(n)].concat(t.map(function(t){return i.map(function(n){return o(t[n])}).join(n)})).join("\n")},e.formatRows=function(n){return n.map(u).join("\n")},e},ao.csv=ao.dsv(",","text/csv"),ao.tsv=ao.dsv(" ","text/tab-separated-values");var oa,aa,la,ca,fa=this[x(this,"requestAnimationFrame")]||function(n){setTimeout(n,17)};ao.timer=function(){qn.apply(this,arguments)},ao.timer.flush=function(){Rn(),Dn()},ao.round=function(n,t){return t?Math.round(n*(t=Math.pow(10,t)))/t:Math.round(n)};var sa=["y","z","a","f","p","n","\xb5","m","","k","M","G","T","P","E","Z","Y"].map(Un);ao.formatPrefix=function(n,t){var e=0;return(n=+n)&&(0>n&&(n*=-1),t&&(n=ao.round(n,Pn(n,t))),e=1+Math.floor(1e-12+Math.log(n)/Math.LN10),e=Math.max(-24,Math.min(24,3*Math.floor((e-1)/3)))),sa[8+e/3]};var ha=/(?:([^{])?([<>=^]))?([+\- ])?([$#])?(0)?(\d+)?(,)?(\.-?\d+)?([a-z%])?/i,pa=ao.map({b:function(n){return n.toString(2)},c:function(n){return String.fromCharCode(n)},o:function(n){return n.toString(8)},x:function(n){return n.toString(16)},X:function(n){return n.toString(16).toUpperCase()},g:function(n,t){return n.toPrecision(t)},e:function(n,t){return n.toExponential(t)},f:function(n,t){return n.toFixed(t)},r:function(n,t){return(n=ao.round(n,Pn(n,t))).toFixed(Math.max(0,Math.min(20,Pn(n*(1+1e-15),t))))}}),ga=ao.time={},va=Date;Hn.prototype={getDate:function(){return this._.getUTCDate()},getDay:function(){return this._.getUTCDay()},getFullYear:function(){return this._.getUTCFullYear()},getHours:function(){return this._.getUTCHours()},getMilliseconds:function(){return this._.getUTCMilliseconds()},getMinutes:function(){return this._.getUTCMinutes()},getMonth:function(){return this._.getUTCMonth()},getSeconds:function(){return this._.getUTCSeconds()},getTime:function(){return this._.getTime()},getTimezoneOffset:function(){return 0},valueOf:function(){return this._.valueOf()},setDate:function(){da.setUTCDate.apply(this._,arguments)},setDay:function(){da.setUTCDay.apply(this._,arguments)},setFullYear:function(){da.setUTCFullYear.apply(this._,arguments)},setHours:function(){da.setUTCHours.apply(this._,arguments)},setMilliseconds:function(){da.setUTCMilliseconds.apply(this._,arguments)},setMinutes:function(){da.setUTCMinutes.apply(this._,arguments)},setMonth:function(){da.setUTCMonth.apply(this._,arguments)},setSeconds:function(){da.setUTCSeconds.apply(this._,arguments)},setTime:function(){da.setTime.apply(this._,arguments)}};var da=Date.prototype;ga.year=On(function(n){return n=ga.day(n),n.setMonth(0,1),n},function(n,t){n.setFullYear(n.getFullYear()+t)},function(n){return n.getFullYear()}),ga.years=ga.year.range,ga.years.utc=ga.year.utc.range,ga.day=On(function(n){var t=new va(2e3,0);return t.setFullYear(n.getFullYear(),n.getMonth(),n.getDate()),t},function(n,t){n.setDate(n.getDate()+t)},function(n){return n.getDate()-1}),ga.days=ga.day.range,ga.days.utc=ga.day.utc.range,ga.dayOfYear=function(n){var t=ga.year(n);return Math.floor((n-t-6e4*(n.getTimezoneOffset()-t.getTimezoneOffset()))/864e5)},["sunday","monday","tuesday","wednesday","thursday","friday","saturday"].forEach(function(n,t){t=7-t;var e=ga[n]=On(function(n){return(n=ga.day(n)).setDate(n.getDate()-(n.getDay()+t)%7),n},function(n,t){n.setDate(n.getDate()+7*Math.floor(t))},function(n){var e=ga.year(n).getDay();return Math.floor((ga.dayOfYear(n)+(e+t)%7)/7)-(e!==t)});ga[n+"s"]=e.range,ga[n+"s"].utc=e.utc.range,ga[n+"OfYear"]=function(n){var e=ga.year(n).getDay();return Math.floor((ga.dayOfYear(n)+(e+t)%7)/7)}}),ga.week=ga.sunday,ga.weeks=ga.sunday.range,ga.weeks.utc=ga.sunday.utc.range,ga.weekOfYear=ga.sundayOfYear;var ya={"-":"",_:" ",0:"0"},ma=/^\s*\d+/,Ma=/^%/;ao.locale=function(n){return{numberFormat:jn(n),timeFormat:Yn(n)}};var xa=ao.locale({decimal:".",thousands:",",grouping:[3],currency:["$",""],dateTime:"%a %b %e %X %Y",date:"%m/%d/%Y",time:"%H:%M:%S",periods:["AM","PM"],days:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],
shortDays:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],months:["January","February","March","April","May","June","July","August","September","October","November","December"],shortMonths:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"]});ao.format=xa.numberFormat,ao.geo={},ft.prototype={s:0,t:0,add:function(n){st(n,this.t,ba),st(ba.s,this.s,this),this.s?this.t+=ba.t:this.s=ba.t},reset:function(){this.s=this.t=0},valueOf:function(){return this.s}};var ba=new ft;ao.geo.stream=function(n,t){n&&_a.hasOwnProperty(n.type)?_a[n.type](n,t):ht(n,t)};var _a={Feature:function(n,t){ht(n.geometry,t)},FeatureCollection:function(n,t){for(var e=n.features,r=-1,i=e.length;++r<i;)ht(e[r].geometry,t)}},wa={Sphere:function(n,t){t.sphere()},Point:function(n,t){n=n.coordinates,t.point(n[0],n[1],n[2])},MultiPoint:function(n,t){for(var e=n.coordinates,r=-1,i=e.length;++r<i;)n=e[r],t.point(n[0],n[1],n[2])},LineString:function(n,t){pt(n.coordinates,t,0)},MultiLineString:function(n,t){for(var e=n.coordinates,r=-1,i=e.length;++r<i;)pt(e[r],t,0)},Polygon:function(n,t){gt(n.coordinates,t)},MultiPolygon:function(n,t){for(var e=n.coordinates,r=-1,i=e.length;++r<i;)gt(e[r],t)},GeometryCollection:function(n,t){for(var e=n.geometries,r=-1,i=e.length;++r<i;)ht(e[r],t)}};ao.geo.area=function(n){return Sa=0,ao.geo.stream(n,Na),Sa};var Sa,ka=new ft,Na={sphere:function(){Sa+=4*Fo},point:b,lineStart:b,lineEnd:b,polygonStart:function(){ka.reset(),Na.lineStart=vt},polygonEnd:function(){var n=2*ka;Sa+=0>n?4*Fo+n:n,Na.lineStart=Na.lineEnd=Na.point=b}};ao.geo.bounds=function(){function n(n,t){M.push(x=[f=n,h=n]),s>t&&(s=t),t>p&&(p=t)}function t(t,e){var r=dt([t*Yo,e*Yo]);if(y){var i=mt(y,r),u=[i[1],-i[0],0],o=mt(u,i);bt(o),o=_t(o);var l=t-g,c=l>0?1:-1,v=o[0]*Zo*c,d=xo(l)>180;if(d^(v>c*g&&c*t>v)){var m=o[1]*Zo;m>p&&(p=m)}else if(v=(v+360)%360-180,d^(v>c*g&&c*t>v)){var m=-o[1]*Zo;s>m&&(s=m)}else s>e&&(s=e),e>p&&(p=e);d?g>t?a(f,t)>a(f,h)&&(h=t):a(t,h)>a(f,h)&&(f=t):h>=f?(f>t&&(f=t),t>h&&(h=t)):t>g?a(f,t)>a(f,h)&&(h=t):a(t,h)>a(f,h)&&(f=t)}else n(t,e);y=r,g=t}function e(){b.point=t}function r(){x[0]=f,x[1]=h,b.point=n,y=null}function i(n,e){if(y){var r=n-g;m+=xo(r)>180?r+(r>0?360:-360):r}else v=n,d=e;Na.point(n,e),t(n,e)}function u(){Na.lineStart()}function o(){i(v,d),Na.lineEnd(),xo(m)>Uo&&(f=-(h=180)),x[0]=f,x[1]=h,y=null}function a(n,t){return(t-=n)<0?t+360:t}function l(n,t){return n[0]-t[0]}function c(n,t){return t[0]<=t[1]?t[0]<=n&&n<=t[1]:n<t[0]||t[1]<n}var f,s,h,p,g,v,d,y,m,M,x,b={point:n,lineStart:e,lineEnd:r,polygonStart:function(){b.point=i,b.lineStart=u,b.lineEnd=o,m=0,Na.polygonStart()},polygonEnd:function(){Na.polygonEnd(),b.point=n,b.lineStart=e,b.lineEnd=r,0>ka?(f=-(h=180),s=-(p=90)):m>Uo?p=90:-Uo>m&&(s=-90),x[0]=f,x[1]=h}};return function(n){p=h=-(f=s=1/0),M=[],ao.geo.stream(n,b);var t=M.length;if(t){M.sort(l);for(var e,r=1,i=M[0],u=[i];t>r;++r)e=M[r],c(e[0],i)||c(e[1],i)?(a(i[0],e[1])>a(i[0],i[1])&&(i[1]=e[1]),a(e[0],i[1])>a(i[0],i[1])&&(i[0]=e[0])):u.push(i=e);for(var o,e,g=-(1/0),t=u.length-1,r=0,i=u[t];t>=r;i=e,++r)e=u[r],(o=a(i[1],e[0]))>g&&(g=o,f=e[0],h=i[1])}return M=x=null,f===1/0||s===1/0?[[NaN,NaN],[NaN,NaN]]:[[f,s],[h,p]]}}(),ao.geo.centroid=function(n){Ea=Aa=Ca=za=La=qa=Ta=Ra=Da=Pa=Ua=0,ao.geo.stream(n,ja);var t=Da,e=Pa,r=Ua,i=t*t+e*e+r*r;return jo>i&&(t=qa,e=Ta,r=Ra,Uo>Aa&&(t=Ca,e=za,r=La),i=t*t+e*e+r*r,jo>i)?[NaN,NaN]:[Math.atan2(e,t)*Zo,tn(r/Math.sqrt(i))*Zo]};var Ea,Aa,Ca,za,La,qa,Ta,Ra,Da,Pa,Ua,ja={sphere:b,point:St,lineStart:Nt,lineEnd:Et,polygonStart:function(){ja.lineStart=At},polygonEnd:function(){ja.lineStart=Nt}},Fa=Rt(zt,jt,Ht,[-Fo,-Fo/2]),Ha=1e9;ao.geo.clipExtent=function(){var n,t,e,r,i,u,o={stream:function(n){return i&&(i.valid=!1),i=u(n),i.valid=!0,i},extent:function(a){return arguments.length?(u=Zt(n=+a[0][0],t=+a[0][1],e=+a[1][0],r=+a[1][1]),i&&(i.valid=!1,i=null),o):[[n,t],[e,r]]}};return o.extent([[0,0],[960,500]])},(ao.geo.conicEqualArea=function(){return Vt(Xt)}).raw=Xt,ao.geo.albers=function(){return ao.geo.conicEqualArea().rotate([96,0]).center([-.6,38.7]).parallels([29.5,45.5]).scale(1070)},ao.geo.albersUsa=function(){function n(n){var u=n[0],o=n[1];return t=null,e(u,o),t||(r(u,o),t)||i(u,o),t}var t,e,r,i,u=ao.geo.albers(),o=ao.geo.conicEqualArea().rotate([154,0]).center([-2,58.5]).parallels([55,65]),a=ao.geo.conicEqualArea().rotate([157,0]).center([-3,19.9]).parallels([8,18]),l={point:function(n,e){t=[n,e]}};return n.invert=function(n){var t=u.scale(),e=u.translate(),r=(n[0]-e[0])/t,i=(n[1]-e[1])/t;return(i>=.12&&.234>i&&r>=-.425&&-.214>r?o:i>=.166&&.234>i&&r>=-.214&&-.115>r?a:u).invert(n)},n.stream=function(n){var t=u.stream(n),e=o.stream(n),r=a.stream(n);return{point:function(n,i){t.point(n,i),e.point(n,i),r.point(n,i)},sphere:function(){t.sphere(),e.sphere(),r.sphere()},lineStart:function(){t.lineStart(),e.lineStart(),r.lineStart()},lineEnd:function(){t.lineEnd(),e.lineEnd(),r.lineEnd()},polygonStart:function(){t.polygonStart(),e.polygonStart(),r.polygonStart()},polygonEnd:function(){t.polygonEnd(),e.polygonEnd(),r.polygonEnd()}}},n.precision=function(t){return arguments.length?(u.precision(t),o.precision(t),a.precision(t),n):u.precision()},n.scale=function(t){return arguments.length?(u.scale(t),o.scale(.35*t),a.scale(t),n.translate(u.translate())):u.scale()},n.translate=function(t){if(!arguments.length)return u.translate();var c=u.scale(),f=+t[0],s=+t[1];return e=u.translate(t).clipExtent([[f-.455*c,s-.238*c],[f+.455*c,s+.238*c]]).stream(l).point,r=o.translate([f-.307*c,s+.201*c]).clipExtent([[f-.425*c+Uo,s+.12*c+Uo],[f-.214*c-Uo,s+.234*c-Uo]]).stream(l).point,i=a.translate([f-.205*c,s+.212*c]).clipExtent([[f-.214*c+Uo,s+.166*c+Uo],[f-.115*c-Uo,s+.234*c-Uo]]).stream(l).point,n},n.scale(1070)};var Oa,Ia,Ya,Za,Va,Xa,$a={point:b,lineStart:b,lineEnd:b,polygonStart:function(){Ia=0,$a.lineStart=$t},polygonEnd:function(){$a.lineStart=$a.lineEnd=$a.point=b,Oa+=xo(Ia/2)}},Ba={point:Bt,lineStart:b,lineEnd:b,polygonStart:b,polygonEnd:b},Wa={point:Gt,lineStart:Kt,lineEnd:Qt,polygonStart:function(){Wa.lineStart=ne},polygonEnd:function(){Wa.point=Gt,Wa.lineStart=Kt,Wa.lineEnd=Qt}};ao.geo.path=function(){function n(n){return n&&("function"==typeof a&&u.pointRadius(+a.apply(this,arguments)),o&&o.valid||(o=i(u)),ao.geo.stream(n,o)),u.result()}function t(){return o=null,n}var e,r,i,u,o,a=4.5;return n.area=function(n){return Oa=0,ao.geo.stream(n,i($a)),Oa},n.centroid=function(n){return Ca=za=La=qa=Ta=Ra=Da=Pa=Ua=0,ao.geo.stream(n,i(Wa)),Ua?[Da/Ua,Pa/Ua]:Ra?[qa/Ra,Ta/Ra]:La?[Ca/La,za/La]:[NaN,NaN]},n.bounds=function(n){return Va=Xa=-(Ya=Za=1/0),ao.geo.stream(n,i(Ba)),[[Ya,Za],[Va,Xa]]},n.projection=function(n){return arguments.length?(i=(e=n)?n.stream||re(n):m,t()):e},n.context=function(n){return arguments.length?(u=null==(r=n)?new Wt:new te(n),"function"!=typeof a&&u.pointRadius(a),t()):r},n.pointRadius=function(t){return arguments.length?(a="function"==typeof t?t:(u.pointRadius(+t),+t),n):a},n.projection(ao.geo.albersUsa()).context(null)},ao.geo.transform=function(n){return{stream:function(t){var e=new ie(t);for(var r in n)e[r]=n[r];return e}}},ie.prototype={point:function(n,t){this.stream.point(n,t)},sphere:function(){this.stream.sphere()},lineStart:function(){this.stream.lineStart()},lineEnd:function(){this.stream.lineEnd()},polygonStart:function(){this.stream.polygonStart()},polygonEnd:function(){this.stream.polygonEnd()}},ao.geo.projection=oe,ao.geo.projectionMutator=ae,(ao.geo.equirectangular=function(){return oe(ce)}).raw=ce.invert=ce,ao.geo.rotation=function(n){function t(t){return t=n(t[0]*Yo,t[1]*Yo),t[0]*=Zo,t[1]*=Zo,t}return n=se(n[0]%360*Yo,n[1]*Yo,n.length>2?n[2]*Yo:0),t.invert=function(t){return t=n.invert(t[0]*Yo,t[1]*Yo),t[0]*=Zo,t[1]*=Zo,t},t},fe.invert=ce,ao.geo.circle=function(){function n(){var n="function"==typeof r?r.apply(this,arguments):r,t=se(-n[0]*Yo,-n[1]*Yo,0).invert,i=[];return e(null,null,1,{point:function(n,e){i.push(n=t(n,e)),n[0]*=Zo,n[1]*=Zo}}),{type:"Polygon",coordinates:[i]}}var t,e,r=[0,0],i=6;return n.origin=function(t){return arguments.length?(r=t,n):r},n.angle=function(r){return arguments.length?(e=ve((t=+r)*Yo,i*Yo),n):t},n.precision=function(r){return arguments.length?(e=ve(t*Yo,(i=+r)*Yo),n):i},n.angle(90)},ao.geo.distance=function(n,t){var e,r=(t[0]-n[0])*Yo,i=n[1]*Yo,u=t[1]*Yo,o=Math.sin(r),a=Math.cos(r),l=Math.sin(i),c=Math.cos(i),f=Math.sin(u),s=Math.cos(u);return Math.atan2(Math.sqrt((e=s*o)*e+(e=c*f-l*s*a)*e),l*f+c*s*a)},ao.geo.graticule=function(){function n(){return{type:"MultiLineString",coordinates:t()}}function t(){return ao.range(Math.ceil(u/d)*d,i,d).map(h).concat(ao.range(Math.ceil(c/y)*y,l,y).map(p)).concat(ao.range(Math.ceil(r/g)*g,e,g).filter(function(n){return xo(n%d)>Uo}).map(f)).concat(ao.range(Math.ceil(a/v)*v,o,v).filter(function(n){return xo(n%y)>Uo}).map(s))}var e,r,i,u,o,a,l,c,f,s,h,p,g=10,v=g,d=90,y=360,m=2.5;return n.lines=function(){return t().map(function(n){return{type:"LineString",coordinates:n}})},n.outline=function(){return{type:"Polygon",coordinates:[h(u).concat(p(l).slice(1),h(i).reverse().slice(1),p(c).reverse().slice(1))]}},n.extent=function(t){return arguments.length?n.majorExtent(t).minorExtent(t):n.minorExtent()},n.majorExtent=function(t){return arguments.length?(u=+t[0][0],i=+t[1][0],c=+t[0][1],l=+t[1][1],u>i&&(t=u,u=i,i=t),c>l&&(t=c,c=l,l=t),n.precision(m)):[[u,c],[i,l]]},n.minorExtent=function(t){return arguments.length?(r=+t[0][0],e=+t[1][0],a=+t[0][1],o=+t[1][1],r>e&&(t=r,r=e,e=t),a>o&&(t=a,a=o,o=t),n.precision(m)):[[r,a],[e,o]]},n.step=function(t){return arguments.length?n.majorStep(t).minorStep(t):n.minorStep()},n.majorStep=function(t){return arguments.length?(d=+t[0],y=+t[1],n):[d,y]},n.minorStep=function(t){return arguments.length?(g=+t[0],v=+t[1],n):[g,v]},n.precision=function(t){return arguments.length?(m=+t,f=ye(a,o,90),s=me(r,e,m),h=ye(c,l,90),p=me(u,i,m),n):m},n.majorExtent([[-180,-90+Uo],[180,90-Uo]]).minorExtent([[-180,-80-Uo],[180,80+Uo]])},ao.geo.greatArc=function(){function n(){return{type:"LineString",coordinates:[t||r.apply(this,arguments),e||i.apply(this,arguments)]}}var t,e,r=Me,i=xe;return n.distance=function(){return ao.geo.distance(t||r.apply(this,arguments),e||i.apply(this,arguments))},n.source=function(e){return arguments.length?(r=e,t="function"==typeof e?null:e,n):r},n.target=function(t){return arguments.length?(i=t,e="function"==typeof t?null:t,n):i},n.precision=function(){return arguments.length?n:0},n},ao.geo.interpolate=function(n,t){return be(n[0]*Yo,n[1]*Yo,t[0]*Yo,t[1]*Yo)},ao.geo.length=function(n){return Ja=0,ao.geo.stream(n,Ga),Ja};var Ja,Ga={sphere:b,point:b,lineStart:_e,lineEnd:b,polygonStart:b,polygonEnd:b},Ka=we(function(n){return Math.sqrt(2/(1+n))},function(n){return 2*Math.asin(n/2)});(ao.geo.azimuthalEqualArea=function(){return oe(Ka)}).raw=Ka;var Qa=we(function(n){var t=Math.acos(n);return t&&t/Math.sin(t)},m);(ao.geo.azimuthalEquidistant=function(){return oe(Qa)}).raw=Qa,(ao.geo.conicConformal=function(){return Vt(Se)}).raw=Se,(ao.geo.conicEquidistant=function(){return Vt(ke)}).raw=ke;var nl=we(function(n){return 1/n},Math.atan);(ao.geo.gnomonic=function(){return oe(nl)}).raw=nl,Ne.invert=function(n,t){return[n,2*Math.atan(Math.exp(t))-Io]},(ao.geo.mercator=function(){return Ee(Ne)}).raw=Ne;var tl=we(function(){return 1},Math.asin);(ao.geo.orthographic=function(){return oe(tl)}).raw=tl;var el=we(function(n){return 1/(1+n)},function(n){return 2*Math.atan(n)});(ao.geo.stereographic=function(){return oe(el)}).raw=el,Ae.invert=function(n,t){return[-t,2*Math.atan(Math.exp(n))-Io]},(ao.geo.transverseMercator=function(){var n=Ee(Ae),t=n.center,e=n.rotate;return n.center=function(n){return n?t([-n[1],n[0]]):(n=t(),[n[1],-n[0]])},n.rotate=function(n){return n?e([n[0],n[1],n.length>2?n[2]+90:90]):(n=e(),[n[0],n[1],n[2]-90])},e([0,0,90])}).raw=Ae,ao.geom={},ao.geom.hull=function(n){function t(n){if(n.length<3)return[];var t,i=En(e),u=En(r),o=n.length,a=[],l=[];for(t=0;o>t;t++)a.push([+i.call(this,n[t],t),+u.call(this,n[t],t),t]);for(a.sort(qe),t=0;o>t;t++)l.push([a[t][0],-a[t][1]]);var c=Le(a),f=Le(l),s=f[0]===c[0],h=f[f.length-1]===c[c.length-1],p=[];for(t=c.length-1;t>=0;--t)p.push(n[a[c[t]][2]]);for(t=+s;t<f.length-h;++t)p.push(n[a[f[t]][2]]);return p}var e=Ce,r=ze;return arguments.length?t(n):(t.x=function(n){return arguments.length?(e=n,t):e},t.y=function(n){return arguments.length?(r=n,t):r},t)},ao.geom.polygon=function(n){return ko(n,rl),n};var rl=ao.geom.polygon.prototype=[];rl.area=function(){for(var n,t=-1,e=this.length,r=this[e-1],i=0;++t<e;)n=r,r=this[t],i+=n[1]*r[0]-n[0]*r[1];return.5*i},rl.centroid=function(n){var t,e,r=-1,i=this.length,u=0,o=0,a=this[i-1];for(arguments.length||(n=-1/(6*this.area()));++r<i;)t=a,a=this[r],e=t[0]*a[1]-a[0]*t[1],u+=(t[0]+a[0])*e,o+=(t[1]+a[1])*e;return[u*n,o*n]},rl.clip=function(n){for(var t,e,r,i,u,o,a=De(n),l=-1,c=this.length-De(this),f=this[c-1];++l<c;){for(t=n.slice(),n.length=0,i=this[l],u=t[(r=t.length-a)-1],e=-1;++e<r;)o=t[e],Te(o,f,i)?(Te(u,f,i)||n.push(Re(u,o,f,i)),n.push(o)):Te(u,f,i)&&n.push(Re(u,o,f,i)),u=o;a&&n.push(n[0]),f=i}return n};var il,ul,ol,al,ll,cl=[],fl=[];Ye.prototype.prepare=function(){for(var n,t=this.edges,e=t.length;e--;)n=t[e].edge,n.b&&n.a||t.splice(e,1);return t.sort(Ve),t.length},tr.prototype={start:function(){return this.edge.l===this.site?this.edge.a:this.edge.b},end:function(){return this.edge.l===this.site?this.edge.b:this.edge.a}},er.prototype={insert:function(n,t){var e,r,i;if(n){if(t.P=n,t.N=n.N,n.N&&(n.N.P=t),n.N=t,n.R){for(n=n.R;n.L;)n=n.L;n.L=t}else n.R=t;e=n}else this._?(n=or(this._),t.P=null,t.N=n,n.P=n.L=t,e=n):(t.P=t.N=null,this._=t,e=null);for(t.L=t.R=null,t.U=e,t.C=!0,n=t;e&&e.C;)r=e.U,e===r.L?(i=r.R,i&&i.C?(e.C=i.C=!1,r.C=!0,n=r):(n===e.R&&(ir(this,e),n=e,e=n.U),e.C=!1,r.C=!0,ur(this,r))):(i=r.L,i&&i.C?(e.C=i.C=!1,r.C=!0,n=r):(n===e.L&&(ur(this,e),n=e,e=n.U),e.C=!1,r.C=!0,ir(this,r))),e=n.U;this._.C=!1},remove:function(n){n.N&&(n.N.P=n.P),n.P&&(n.P.N=n.N),n.N=n.P=null;var t,e,r,i=n.U,u=n.L,o=n.R;if(e=u?o?or(o):u:o,i?i.L===n?i.L=e:i.R=e:this._=e,u&&o?(r=e.C,e.C=n.C,e.L=u,u.U=e,e!==o?(i=e.U,e.U=n.U,n=e.R,i.L=n,e.R=o,o.U=e):(e.U=i,i=e,n=e.R)):(r=n.C,n=e),n&&(n.U=i),!r){if(n&&n.C)return void(n.C=!1);do{if(n===this._)break;if(n===i.L){if(t=i.R,t.C&&(t.C=!1,i.C=!0,ir(this,i),t=i.R),t.L&&t.L.C||t.R&&t.R.C){t.R&&t.R.C||(t.L.C=!1,t.C=!0,ur(this,t),t=i.R),t.C=i.C,i.C=t.R.C=!1,ir(this,i),n=this._;break}}else if(t=i.L,t.C&&(t.C=!1,i.C=!0,ur(this,i),t=i.L),t.L&&t.L.C||t.R&&t.R.C){t.L&&t.L.C||(t.R.C=!1,t.C=!0,ir(this,t),t=i.L),t.C=i.C,i.C=t.L.C=!1,ur(this,i),n=this._;break}t.C=!0,n=i,i=i.U}while(!n.C);n&&(n.C=!1)}}},ao.geom.voronoi=function(n){function t(n){var t=new Array(n.length),r=a[0][0],i=a[0][1],u=a[1][0],o=a[1][1];return ar(e(n),a).cells.forEach(function(e,a){var l=e.edges,c=e.site,f=t[a]=l.length?l.map(function(n){var t=n.start();return[t.x,t.y]}):c.x>=r&&c.x<=u&&c.y>=i&&c.y<=o?[[r,o],[u,o],[u,i],[r,i]]:[];f.point=n[a]}),t}function e(n){return n.map(function(n,t){return{x:Math.round(u(n,t)/Uo)*Uo,y:Math.round(o(n,t)/Uo)*Uo,i:t}})}var r=Ce,i=ze,u=r,o=i,a=sl;return n?t(n):(t.links=function(n){return ar(e(n)).edges.filter(function(n){return n.l&&n.r}).map(function(t){return{source:n[t.l.i],target:n[t.r.i]}})},t.triangles=function(n){var t=[];return ar(e(n)).cells.forEach(function(e,r){for(var i,u,o=e.site,a=e.edges.sort(Ve),l=-1,c=a.length,f=a[c-1].edge,s=f.l===o?f.r:f.l;++l<c;)i=f,u=s,f=a[l].edge,s=f.l===o?f.r:f.l,r<u.i&&r<s.i&&cr(o,u,s)<0&&t.push([n[r],n[u.i],n[s.i]])}),t},t.x=function(n){return arguments.length?(u=En(r=n),t):r},t.y=function(n){return arguments.length?(o=En(i=n),t):i},t.clipExtent=function(n){return arguments.length?(a=null==n?sl:n,t):a===sl?null:a},t.size=function(n){return arguments.length?t.clipExtent(n&&[[0,0],n]):a===sl?null:a&&a[1]},t)};var sl=[[-1e6,-1e6],[1e6,1e6]];ao.geom.delaunay=function(n){return ao.geom.voronoi().triangles(n)},ao.geom.quadtree=function(n,t,e,r,i){function u(n){function u(n,t,e,r,i,u,o,a){if(!isNaN(e)&&!isNaN(r))if(n.leaf){var l=n.x,f=n.y;if(null!=l)if(xo(l-e)+xo(f-r)<.01)c(n,t,e,r,i,u,o,a);else{var s=n.point;n.x=n.y=n.point=null,c(n,s,l,f,i,u,o,a),c(n,t,e,r,i,u,o,a)}else n.x=e,n.y=r,n.point=t}else c(n,t,e,r,i,u,o,a)}function c(n,t,e,r,i,o,a,l){var c=.5*(i+a),f=.5*(o+l),s=e>=c,h=r>=f,p=h<<1|s;n.leaf=!1,n=n.nodes[p]||(n.nodes[p]=hr()),s?i=c:a=c,h?o=f:l=f,u(n,t,e,r,i,o,a,l)}var f,s,h,p,g,v,d,y,m,M=En(a),x=En(l);if(null!=t)v=t,d=e,y=r,m=i;else if(y=m=-(v=d=1/0),s=[],h=[],g=n.length,o)for(p=0;g>p;++p)f=n[p],f.x<v&&(v=f.x),f.y<d&&(d=f.y),f.x>y&&(y=f.x),f.y>m&&(m=f.y),s.push(f.x),h.push(f.y);else for(p=0;g>p;++p){var b=+M(f=n[p],p),_=+x(f,p);v>b&&(v=b),d>_&&(d=_),b>y&&(y=b),_>m&&(m=_),s.push(b),h.push(_)}var w=y-v,S=m-d;w>S?m=d+w:y=v+S;var k=hr();if(k.add=function(n){u(k,n,+M(n,++p),+x(n,p),v,d,y,m)},k.visit=function(n){pr(n,k,v,d,y,m)},k.find=function(n){return gr(k,n[0],n[1],v,d,y,m)},p=-1,null==t){for(;++p<g;)u(k,n[p],s[p],h[p],v,d,y,m);--p}else n.forEach(k.add);return s=h=n=f=null,k}var o,a=Ce,l=ze;return(o=arguments.length)?(a=fr,l=sr,3===o&&(i=e,r=t,e=t=0),u(n)):(u.x=function(n){return arguments.length?(a=n,u):a},u.y=function(n){return arguments.length?(l=n,u):l},u.extent=function(n){return arguments.length?(null==n?t=e=r=i=null:(t=+n[0][0],e=+n[0][1],r=+n[1][0],i=+n[1][1]),u):null==t?null:[[t,e],[r,i]]},u.size=function(n){return arguments.length?(null==n?t=e=r=i=null:(t=e=0,r=+n[0],i=+n[1]),u):null==t?null:[r-t,i-e]},u)},ao.interpolateRgb=vr,ao.interpolateObject=dr,ao.interpolateNumber=yr,ao.interpolateString=mr;var hl=/[-+]?(?:\d+\.?\d*|\.?\d+)(?:[eE][-+]?\d+)?/g,pl=new RegExp(hl.source,"g");ao.interpolate=Mr,ao.interpolators=[function(n,t){var e=typeof t;return("string"===e?ua.has(t.toLowerCase())||/^(#|rgb\(|hsl\()/i.test(t)?vr:mr:t instanceof an?vr:Array.isArray(t)?xr:"object"===e&&isNaN(t)?dr:yr)(n,t)}],ao.interpolateArray=xr;var gl=function(){return m},vl=ao.map({linear:gl,poly:Er,quad:function(){return Sr},cubic:function(){return kr},sin:function(){return Ar},exp:function(){return Cr},circle:function(){return zr},elastic:Lr,back:qr,bounce:function(){return Tr}}),dl=ao.map({"in":m,out:_r,"in-out":wr,"out-in":function(n){return wr(_r(n))}});ao.ease=function(n){var t=n.indexOf("-"),e=t>=0?n.slice(0,t):n,r=t>=0?n.slice(t+1):"in";return e=vl.get(e)||gl,r=dl.get(r)||m,br(r(e.apply(null,lo.call(arguments,1))))},ao.interpolateHcl=Rr,ao.interpolateHsl=Dr,ao.interpolateLab=Pr,ao.interpolateRound=Ur,ao.transform=function(n){var t=fo.createElementNS(ao.ns.prefix.svg,"g");return(ao.transform=function(n){if(null!=n){t.setAttribute("transform",n);var e=t.transform.baseVal.consolidate()}return new jr(e?e.matrix:yl)})(n)},jr.prototype.toString=function(){return"translate("+this.translate+")rotate("+this.rotate+")skewX("+this.skew+")scale("+this.scale+")"};var yl={a:1,b:0,c:0,d:1,e:0,f:0};ao.interpolateTransform=$r,ao.layout={},ao.layout.bundle=function(){return function(n){for(var t=[],e=-1,r=n.length;++e<r;)t.push(Jr(n[e]));return t}},ao.layout.chord=function(){function n(){var n,c,s,h,p,g={},v=[],d=ao.range(u),y=[];for(e=[],r=[],n=0,h=-1;++h<u;){for(c=0,p=-1;++p<u;)c+=i[h][p];v.push(c),y.push(ao.range(u)),n+=c}for(o&&d.sort(function(n,t){return o(v[n],v[t])}),a&&y.forEach(function(n,t){n.sort(function(n,e){return a(i[t][n],i[t][e])})}),n=(Ho-f*u)/n,c=0,h=-1;++h<u;){for(s=c,p=-1;++p<u;){var m=d[h],M=y[m][p],x=i[m][M],b=c,_=c+=x*n;g[m+"-"+M]={index:m,subindex:M,startAngle:b,endAngle:_,value:x}}r[m]={index:m,startAngle:s,endAngle:c,value:v[m]},c+=f}for(h=-1;++h<u;)for(p=h-1;++p<u;){var w=g[h+"-"+p],S=g[p+"-"+h];(w.value||S.value)&&e.push(w.value<S.value?{source:S,target:w}:{source:w,target:S})}l&&t()}function t(){e.sort(function(n,t){return l((n.source.value+n.target.value)/2,(t.source.value+t.target.value)/2)})}var e,r,i,u,o,a,l,c={},f=0;return c.matrix=function(n){return arguments.length?(u=(i=n)&&i.length,e=r=null,c):i},c.padding=function(n){return arguments.length?(f=n,e=r=null,c):f},c.sortGroups=function(n){return arguments.length?(o=n,e=r=null,c):o},c.sortSubgroups=function(n){return arguments.length?(a=n,e=null,c):a},c.sortChords=function(n){return arguments.length?(l=n,e&&t(),c):l},c.chords=function(){return e||n(),e},c.groups=function(){return r||n(),r},c},ao.layout.force=function(){function n(n){return function(t,e,r,i){if(t.point!==n){var u=t.cx-n.x,o=t.cy-n.y,a=i-e,l=u*u+o*o;if(l>a*a/y){if(v>l){var c=t.charge/l;n.px-=u*c,n.py-=o*c}return!0}if(t.point&&l&&v>l){var c=t.pointCharge/l;n.px-=u*c,n.py-=o*c}}return!t.charge}}function t(n){n.px=ao.event.x,n.py=ao.event.y,l.resume()}var e,r,i,u,o,a,l={},c=ao.dispatch("start","tick","end"),f=[1,1],s=.9,h=ml,p=Ml,g=-30,v=xl,d=.1,y=.64,M=[],x=[];return l.tick=function(){if((i*=.99)<.005)return e=null,c.end({type:"end",alpha:i=0}),!0;var t,r,l,h,p,v,y,m,b,_=M.length,w=x.length;for(r=0;w>r;++r)l=x[r],h=l.source,p=l.target,m=p.x-h.x,b=p.y-h.y,(v=m*m+b*b)&&(v=i*o[r]*((v=Math.sqrt(v))-u[r])/v,m*=v,b*=v,p.x-=m*(y=h.weight+p.weight?h.weight/(h.weight+p.weight):.5),p.y-=b*y,h.x+=m*(y=1-y),h.y+=b*y);if((y=i*d)&&(m=f[0]/2,b=f[1]/2,r=-1,y))for(;++r<_;)l=M[r],l.x+=(m-l.x)*y,l.y+=(b-l.y)*y;if(g)for(ri(t=ao.geom.quadtree(M),i,a),r=-1;++r<_;)(l=M[r]).fixed||t.visit(n(l));for(r=-1;++r<_;)l=M[r],l.fixed?(l.x=l.px,l.y=l.py):(l.x-=(l.px-(l.px=l.x))*s,l.y-=(l.py-(l.py=l.y))*s);c.tick({type:"tick",alpha:i})},l.nodes=function(n){return arguments.length?(M=n,l):M},l.links=function(n){return arguments.length?(x=n,l):x},l.size=function(n){return arguments.length?(f=n,l):f},l.linkDistance=function(n){return arguments.length?(h="function"==typeof n?n:+n,l):h},l.distance=l.linkDistance,l.linkStrength=function(n){return arguments.length?(p="function"==typeof n?n:+n,l):p},l.friction=function(n){return arguments.length?(s=+n,l):s},l.charge=function(n){return arguments.length?(g="function"==typeof n?n:+n,l):g},l.chargeDistance=function(n){return arguments.length?(v=n*n,l):Math.sqrt(v)},l.gravity=function(n){return arguments.length?(d=+n,l):d},l.theta=function(n){return arguments.length?(y=n*n,l):Math.sqrt(y)},l.alpha=function(n){return arguments.length?(n=+n,i?n>0?i=n:(e.c=null,e.t=NaN,e=null,c.end({type:"end",alpha:i=0})):n>0&&(c.start({type:"start",alpha:i=n}),e=qn(l.tick)),l):i},l.start=function(){function n(n,r){if(!e){for(e=new Array(i),l=0;i>l;++l)e[l]=[];for(l=0;c>l;++l){var u=x[l];e[u.source.index].push(u.target),e[u.target.index].push(u.source)}}for(var o,a=e[t],l=-1,f=a.length;++l<f;)if(!isNaN(o=a[l][n]))return o;return Math.random()*r}var t,e,r,i=M.length,c=x.length,s=f[0],v=f[1];for(t=0;i>t;++t)(r=M[t]).index=t,r.weight=0;for(t=0;c>t;++t)r=x[t],"number"==typeof r.source&&(r.source=M[r.source]),"number"==typeof r.target&&(r.target=M[r.target]),++r.source.weight,++r.target.weight;for(t=0;i>t;++t)r=M[t],isNaN(r.x)&&(r.x=n("x",s)),isNaN(r.y)&&(r.y=n("y",v)),isNaN(r.px)&&(r.px=r.x),isNaN(r.py)&&(r.py=r.y);if(u=[],"function"==typeof h)for(t=0;c>t;++t)u[t]=+h.call(this,x[t],t);else for(t=0;c>t;++t)u[t]=h;if(o=[],"function"==typeof p)for(t=0;c>t;++t)o[t]=+p.call(this,x[t],t);else for(t=0;c>t;++t)o[t]=p;if(a=[],"function"==typeof g)for(t=0;i>t;++t)a[t]=+g.call(this,M[t],t);else for(t=0;i>t;++t)a[t]=g;return l.resume()},l.resume=function(){return l.alpha(.1)},l.stop=function(){return l.alpha(0)},l.drag=function(){return r||(r=ao.behavior.drag().origin(m).on("dragstart.force",Qr).on("drag.force",t).on("dragend.force",ni)),arguments.length?void this.on("mouseover.force",ti).on("mouseout.force",ei).call(r):r},ao.rebind(l,c,"on")};var ml=20,Ml=1,xl=1/0;ao.layout.hierarchy=function(){function n(i){var u,o=[i],a=[];for(i.depth=0;null!=(u=o.pop());)if(a.push(u),(c=e.call(n,u,u.depth))&&(l=c.length)){for(var l,c,f;--l>=0;)o.push(f=c[l]),f.parent=u,f.depth=u.depth+1;r&&(u.value=0),u.children=c}else r&&(u.value=+r.call(n,u,u.depth)||0),delete u.children;return oi(i,function(n){var e,i;t&&(e=n.children)&&e.sort(t),r&&(i=n.parent)&&(i.value+=n.value)}),a}var t=ci,e=ai,r=li;return n.sort=function(e){return arguments.length?(t=e,n):t},n.children=function(t){return arguments.length?(e=t,n):e},n.value=function(t){return arguments.length?(r=t,n):r},n.revalue=function(t){return r&&(ui(t,function(n){n.children&&(n.value=0)}),oi(t,function(t){var e;t.children||(t.value=+r.call(n,t,t.depth)||0),(e=t.parent)&&(e.value+=t.value)})),t},n},ao.layout.partition=function(){function n(t,e,r,i){var u=t.children;if(t.x=e,t.y=t.depth*i,t.dx=r,t.dy=i,u&&(o=u.length)){var o,a,l,c=-1;for(r=t.value?r/t.value:0;++c<o;)n(a=u[c],e,l=a.value*r,i),e+=l}}function t(n){var e=n.children,r=0;if(e&&(i=e.length))for(var i,u=-1;++u<i;)r=Math.max(r,t(e[u]));return 1+r}function e(e,u){var o=r.call(this,e,u);return n(o[0],0,i[0],i[1]/t(o[0])),o}var r=ao.layout.hierarchy(),i=[1,1];return e.size=function(n){return arguments.length?(i=n,e):i},ii(e,r)},ao.layout.pie=function(){function n(o){var a,l=o.length,c=o.map(function(e,r){return+t.call(n,e,r)}),f=+("function"==typeof r?r.apply(this,arguments):r),s=("function"==typeof i?i.apply(this,arguments):i)-f,h=Math.min(Math.abs(s)/l,+("function"==typeof u?u.apply(this,arguments):u)),p=h*(0>s?-1:1),g=ao.sum(c),v=g?(s-l*p)/g:0,d=ao.range(l),y=[];return null!=e&&d.sort(e===bl?function(n,t){return c[t]-c[n]}:function(n,t){return e(o[n],o[t])}),d.forEach(function(n){y[n]={data:o[n],value:a=c[n],startAngle:f,endAngle:f+=a*v+p,padAngle:h}}),y}var t=Number,e=bl,r=0,i=Ho,u=0;return n.value=function(e){return arguments.length?(t=e,n):t},n.sort=function(t){return arguments.length?(e=t,n):e},n.startAngle=function(t){return arguments.length?(r=t,n):r},n.endAngle=function(t){return arguments.length?(i=t,n):i},n.padAngle=function(t){return arguments.length?(u=t,n):u},n};var bl={};ao.layout.stack=function(){function n(a,l){if(!(h=a.length))return a;var c=a.map(function(e,r){return t.call(n,e,r)}),f=c.map(function(t){return t.map(function(t,e){return[u.call(n,t,e),o.call(n,t,e)]})}),s=e.call(n,f,l);c=ao.permute(c,s),f=ao.permute(f,s);var h,p,g,v,d=r.call(n,f,l),y=c[0].length;for(g=0;y>g;++g)for(i.call(n,c[0][g],v=d[g],f[0][g][1]),p=1;h>p;++p)i.call(n,c[p][g],v+=f[p-1][g][1],f[p][g][1]);return a}var t=m,e=gi,r=vi,i=pi,u=si,o=hi;return n.values=function(e){return arguments.length?(t=e,n):t},n.order=function(t){return arguments.length?(e="function"==typeof t?t:_l.get(t)||gi,n):e},n.offset=function(t){return arguments.length?(r="function"==typeof t?t:wl.get(t)||vi,n):r},n.x=function(t){return arguments.length?(u=t,n):u},n.y=function(t){return arguments.length?(o=t,n):o},n.out=function(t){return arguments.length?(i=t,n):i},n};var _l=ao.map({"inside-out":function(n){var t,e,r=n.length,i=n.map(di),u=n.map(yi),o=ao.range(r).sort(function(n,t){return i[n]-i[t]}),a=0,l=0,c=[],f=[];for(t=0;r>t;++t)e=o[t],l>a?(a+=u[e],c.push(e)):(l+=u[e],f.push(e));return f.reverse().concat(c)},reverse:function(n){return ao.range(n.length).reverse()},"default":gi}),wl=ao.map({silhouette:function(n){var t,e,r,i=n.length,u=n[0].length,o=[],a=0,l=[];for(e=0;u>e;++e){for(t=0,r=0;i>t;t++)r+=n[t][e][1];r>a&&(a=r),o.push(r)}for(e=0;u>e;++e)l[e]=(a-o[e])/2;return l},wiggle:function(n){var t,e,r,i,u,o,a,l,c,f=n.length,s=n[0],h=s.length,p=[];for(p[0]=l=c=0,e=1;h>e;++e){for(t=0,i=0;f>t;++t)i+=n[t][e][1];for(t=0,u=0,a=s[e][0]-s[e-1][0];f>t;++t){for(r=0,o=(n[t][e][1]-n[t][e-1][1])/(2*a);t>r;++r)o+=(n[r][e][1]-n[r][e-1][1])/a;u+=o*n[t][e][1]}p[e]=l-=i?u/i*a:0,c>l&&(c=l)}for(e=0;h>e;++e)p[e]-=c;return p},expand:function(n){var t,e,r,i=n.length,u=n[0].length,o=1/i,a=[];for(e=0;u>e;++e){for(t=0,r=0;i>t;t++)r+=n[t][e][1];if(r)for(t=0;i>t;t++)n[t][e][1]/=r;else for(t=0;i>t;t++)n[t][e][1]=o}for(e=0;u>e;++e)a[e]=0;return a},zero:vi});ao.layout.histogram=function(){function n(n,u){for(var o,a,l=[],c=n.map(e,this),f=r.call(this,c,u),s=i.call(this,f,c,u),u=-1,h=c.length,p=s.length-1,g=t?1:1/h;++u<p;)o=l[u]=[],o.dx=s[u+1]-(o.x=s[u]),o.y=0;if(p>0)for(u=-1;++u<h;)a=c[u],a>=f[0]&&a<=f[1]&&(o=l[ao.bisect(s,a,1,p)-1],o.y+=g,o.push(n[u]));return l}var t=!0,e=Number,r=bi,i=Mi;return n.value=function(t){return arguments.length?(e=t,n):e},n.range=function(t){return arguments.length?(r=En(t),n):r},n.bins=function(t){return arguments.length?(i="number"==typeof t?function(n){return xi(n,t)}:En(t),n):i},n.frequency=function(e){return arguments.length?(t=!!e,n):t},n},ao.layout.pack=function(){function n(n,u){var o=e.call(this,n,u),a=o[0],l=i[0],c=i[1],f=null==t?Math.sqrt:"function"==typeof t?t:function(){return t};if(a.x=a.y=0,oi(a,function(n){n.r=+f(n.value)}),oi(a,Ni),r){var s=r*(t?1:Math.max(2*a.r/l,2*a.r/c))/2;oi(a,function(n){n.r+=s}),oi(a,Ni),oi(a,function(n){n.r-=s})}return Ci(a,l/2,c/2,t?1:1/Math.max(2*a.r/l,2*a.r/c)),o}var t,e=ao.layout.hierarchy().sort(_i),r=0,i=[1,1];return n.size=function(t){return arguments.length?(i=t,n):i},n.radius=function(e){return arguments.length?(t=null==e||"function"==typeof e?e:+e,n):t},n.padding=function(t){return arguments.length?(r=+t,n):r},ii(n,e)},ao.layout.tree=function(){function n(n,i){var f=o.call(this,n,i),s=f[0],h=t(s);if(oi(h,e),h.parent.m=-h.z,ui(h,r),c)ui(s,u);else{var p=s,g=s,v=s;ui(s,function(n){n.x<p.x&&(p=n),n.x>g.x&&(g=n),n.depth>v.depth&&(v=n)});var d=a(p,g)/2-p.x,y=l[0]/(g.x+a(g,p)/2+d),m=l[1]/(v.depth||1);ui(s,function(n){n.x=(n.x+d)*y,n.y=n.depth*m})}return f}function t(n){for(var t,e={A:null,children:[n]},r=[e];null!=(t=r.pop());)for(var i,u=t.children,o=0,a=u.length;a>o;++o)r.push((u[o]=i={_:u[o],parent:t,children:(i=u[o].children)&&i.slice()||[],A:null,a:null,z:0,m:0,c:0,s:0,t:null,i:o}).a=i);return e.children[0]}function e(n){var t=n.children,e=n.parent.children,r=n.i?e[n.i-1]:null;if(t.length){Di(n);var u=(t[0].z+t[t.length-1].z)/2;r?(n.z=r.z+a(n._,r._),n.m=n.z-u):n.z=u}else r&&(n.z=r.z+a(n._,r._));n.parent.A=i(n,r,n.parent.A||e[0])}function r(n){n._.x=n.z+n.parent.m,n.m+=n.parent.m}function i(n,t,e){if(t){for(var r,i=n,u=n,o=t,l=i.parent.children[0],c=i.m,f=u.m,s=o.m,h=l.m;o=Ti(o),i=qi(i),o&&i;)l=qi(l),u=Ti(u),u.a=n,r=o.z+s-i.z-c+a(o._,i._),r>0&&(Ri(Pi(o,n,e),n,r),c+=r,f+=r),s+=o.m,c+=i.m,h+=l.m,f+=u.m;o&&!Ti(u)&&(u.t=o,u.m+=s-f),i&&!qi(l)&&(l.t=i,l.m+=c-h,e=n)}return e}function u(n){n.x*=l[0],n.y=n.depth*l[1]}var o=ao.layout.hierarchy().sort(null).value(null),a=Li,l=[1,1],c=null;return n.separation=function(t){return arguments.length?(a=t,n):a},n.size=function(t){return arguments.length?(c=null==(l=t)?u:null,n):c?null:l},n.nodeSize=function(t){return arguments.length?(c=null==(l=t)?null:u,n):c?l:null},ii(n,o)},ao.layout.cluster=function(){function n(n,u){var o,a=t.call(this,n,u),l=a[0],c=0;oi(l,function(n){var t=n.children;t&&t.length?(n.x=ji(t),n.y=Ui(t)):(n.x=o?c+=e(n,o):0,n.y=0,o=n)});var f=Fi(l),s=Hi(l),h=f.x-e(f,s)/2,p=s.x+e(s,f)/2;return oi(l,i?function(n){n.x=(n.x-l.x)*r[0],n.y=(l.y-n.y)*r[1]}:function(n){n.x=(n.x-h)/(p-h)*r[0],n.y=(1-(l.y?n.y/l.y:1))*r[1]}),a}var t=ao.layout.hierarchy().sort(null).value(null),e=Li,r=[1,1],i=!1;return n.separation=function(t){return arguments.length?(e=t,n):e},n.size=function(t){return arguments.length?(i=null==(r=t),n):i?null:r},n.nodeSize=function(t){return arguments.length?(i=null!=(r=t),n):i?r:null},ii(n,t)},ao.layout.treemap=function(){function n(n,t){for(var e,r,i=-1,u=n.length;++i<u;)r=(e=n[i]).value*(0>t?0:t),e.area=isNaN(r)||0>=r?0:r}function t(e){var u=e.children;if(u&&u.length){var o,a,l,c=s(e),f=[],h=u.slice(),g=1/0,v="slice"===p?c.dx:"dice"===p?c.dy:"slice-dice"===p?1&e.depth?c.dy:c.dx:Math.min(c.dx,c.dy);for(n(h,c.dx*c.dy/e.value),f.area=0;(l=h.length)>0;)f.push(o=h[l-1]),f.area+=o.area,"squarify"!==p||(a=r(f,v))<=g?(h.pop(),g=a):(f.area-=f.pop().area,i(f,v,c,!1),v=Math.min(c.dx,c.dy),f.length=f.area=0,g=1/0);f.length&&(i(f,v,c,!0),f.length=f.area=0),u.forEach(t)}}function e(t){var r=t.children;if(r&&r.length){var u,o=s(t),a=r.slice(),l=[];for(n(a,o.dx*o.dy/t.value),l.area=0;u=a.pop();)l.push(u),l.area+=u.area,null!=u.z&&(i(l,u.z?o.dx:o.dy,o,!a.length),l.length=l.area=0);r.forEach(e)}}function r(n,t){for(var e,r=n.area,i=0,u=1/0,o=-1,a=n.length;++o<a;)(e=n[o].area)&&(u>e&&(u=e),e>i&&(i=e));return r*=r,t*=t,r?Math.max(t*i*g/r,r/(t*u*g)):1/0}function i(n,t,e,r){var i,u=-1,o=n.length,a=e.x,c=e.y,f=t?l(n.area/t):0;
if(t==e.dx){for((r||f>e.dy)&&(f=e.dy);++u<o;)i=n[u],i.x=a,i.y=c,i.dy=f,a+=i.dx=Math.min(e.x+e.dx-a,f?l(i.area/f):0);i.z=!0,i.dx+=e.x+e.dx-a,e.y+=f,e.dy-=f}else{for((r||f>e.dx)&&(f=e.dx);++u<o;)i=n[u],i.x=a,i.y=c,i.dx=f,c+=i.dy=Math.min(e.y+e.dy-c,f?l(i.area/f):0);i.z=!1,i.dy+=e.y+e.dy-c,e.x+=f,e.dx-=f}}function u(r){var i=o||a(r),u=i[0];return u.x=u.y=0,u.value?(u.dx=c[0],u.dy=c[1]):u.dx=u.dy=0,o&&a.revalue(u),n([u],u.dx*u.dy/u.value),(o?e:t)(u),h&&(o=i),i}var o,a=ao.layout.hierarchy(),l=Math.round,c=[1,1],f=null,s=Oi,h=!1,p="squarify",g=.5*(1+Math.sqrt(5));return u.size=function(n){return arguments.length?(c=n,u):c},u.padding=function(n){function t(t){var e=n.call(u,t,t.depth);return null==e?Oi(t):Ii(t,"number"==typeof e?[e,e,e,e]:e)}function e(t){return Ii(t,n)}if(!arguments.length)return f;var r;return s=null==(f=n)?Oi:"function"==(r=typeof n)?t:"number"===r?(n=[n,n,n,n],e):e,u},u.round=function(n){return arguments.length?(l=n?Math.round:Number,u):l!=Number},u.sticky=function(n){return arguments.length?(h=n,o=null,u):h},u.ratio=function(n){return arguments.length?(g=n,u):g},u.mode=function(n){return arguments.length?(p=n+"",u):p},ii(u,a)},ao.random={normal:function(n,t){var e=arguments.length;return 2>e&&(t=1),1>e&&(n=0),function(){var e,r,i;do e=2*Math.random()-1,r=2*Math.random()-1,i=e*e+r*r;while(!i||i>1);return n+t*e*Math.sqrt(-2*Math.log(i)/i)}},logNormal:function(){var n=ao.random.normal.apply(ao,arguments);return function(){return Math.exp(n())}},bates:function(n){var t=ao.random.irwinHall(n);return function(){return t()/n}},irwinHall:function(n){return function(){for(var t=0,e=0;n>e;e++)t+=Math.random();return t}}},ao.scale={};var Sl={floor:m,ceil:m};ao.scale.linear=function(){return Wi([0,1],[0,1],Mr,!1)};var kl={s:1,g:1,p:1,r:1,e:1};ao.scale.log=function(){return ru(ao.scale.linear().domain([0,1]),10,!0,[1,10])};var Nl=ao.format(".0e"),El={floor:function(n){return-Math.ceil(-n)},ceil:function(n){return-Math.floor(-n)}};ao.scale.pow=function(){return iu(ao.scale.linear(),1,[0,1])},ao.scale.sqrt=function(){return ao.scale.pow().exponent(.5)},ao.scale.ordinal=function(){return ou([],{t:"range",a:[[]]})},ao.scale.category10=function(){return ao.scale.ordinal().range(Al)},ao.scale.category20=function(){return ao.scale.ordinal().range(Cl)},ao.scale.category20b=function(){return ao.scale.ordinal().range(zl)},ao.scale.category20c=function(){return ao.scale.ordinal().range(Ll)};var Al=[2062260,16744206,2924588,14034728,9725885,9197131,14907330,8355711,12369186,1556175].map(xn),Cl=[2062260,11454440,16744206,16759672,2924588,10018698,14034728,16750742,9725885,12955861,9197131,12885140,14907330,16234194,8355711,13092807,12369186,14408589,1556175,10410725].map(xn),zl=[3750777,5395619,7040719,10264286,6519097,9216594,11915115,13556636,9202993,12426809,15186514,15190932,8666169,11356490,14049643,15177372,8077683,10834324,13528509,14589654].map(xn),Ll=[3244733,7057110,10406625,13032431,15095053,16616764,16625259,16634018,3253076,7652470,10607003,13101504,7695281,10394312,12369372,14342891,6513507,9868950,12434877,14277081].map(xn);ao.scale.quantile=function(){return au([],[])},ao.scale.quantize=function(){return lu(0,1,[0,1])},ao.scale.threshold=function(){return cu([.5],[0,1])},ao.scale.identity=function(){return fu([0,1])},ao.svg={},ao.svg.arc=function(){function n(){var n=Math.max(0,+e.apply(this,arguments)),c=Math.max(0,+r.apply(this,arguments)),f=o.apply(this,arguments)-Io,s=a.apply(this,arguments)-Io,h=Math.abs(s-f),p=f>s?0:1;if(n>c&&(g=c,c=n,n=g),h>=Oo)return t(c,p)+(n?t(n,1-p):"")+"Z";var g,v,d,y,m,M,x,b,_,w,S,k,N=0,E=0,A=[];if((y=(+l.apply(this,arguments)||0)/2)&&(d=u===ql?Math.sqrt(n*n+c*c):+u.apply(this,arguments),p||(E*=-1),c&&(E=tn(d/c*Math.sin(y))),n&&(N=tn(d/n*Math.sin(y)))),c){m=c*Math.cos(f+E),M=c*Math.sin(f+E),x=c*Math.cos(s-E),b=c*Math.sin(s-E);var C=Math.abs(s-f-2*E)<=Fo?0:1;if(E&&yu(m,M,x,b)===p^C){var z=(f+s)/2;m=c*Math.cos(z),M=c*Math.sin(z),x=b=null}}else m=M=0;if(n){_=n*Math.cos(s-N),w=n*Math.sin(s-N),S=n*Math.cos(f+N),k=n*Math.sin(f+N);var L=Math.abs(f-s+2*N)<=Fo?0:1;if(N&&yu(_,w,S,k)===1-p^L){var q=(f+s)/2;_=n*Math.cos(q),w=n*Math.sin(q),S=k=null}}else _=w=0;if(h>Uo&&(g=Math.min(Math.abs(c-n)/2,+i.apply(this,arguments)))>.001){v=c>n^p?0:1;var T=g,R=g;if(Fo>h){var D=null==S?[_,w]:null==x?[m,M]:Re([m,M],[S,k],[x,b],[_,w]),P=m-D[0],U=M-D[1],j=x-D[0],F=b-D[1],H=1/Math.sin(Math.acos((P*j+U*F)/(Math.sqrt(P*P+U*U)*Math.sqrt(j*j+F*F)))/2),O=Math.sqrt(D[0]*D[0]+D[1]*D[1]);R=Math.min(g,(n-O)/(H-1)),T=Math.min(g,(c-O)/(H+1))}if(null!=x){var I=mu(null==S?[_,w]:[S,k],[m,M],c,T,p),Y=mu([x,b],[_,w],c,T,p);g===T?A.push("M",I[0],"A",T,",",T," 0 0,",v," ",I[1],"A",c,",",c," 0 ",1-p^yu(I[1][0],I[1][1],Y[1][0],Y[1][1]),",",p," ",Y[1],"A",T,",",T," 0 0,",v," ",Y[0]):A.push("M",I[0],"A",T,",",T," 0 1,",v," ",Y[0])}else A.push("M",m,",",M);if(null!=S){var Z=mu([m,M],[S,k],n,-R,p),V=mu([_,w],null==x?[m,M]:[x,b],n,-R,p);g===R?A.push("L",V[0],"A",R,",",R," 0 0,",v," ",V[1],"A",n,",",n," 0 ",p^yu(V[1][0],V[1][1],Z[1][0],Z[1][1]),",",1-p," ",Z[1],"A",R,",",R," 0 0,",v," ",Z[0]):A.push("L",V[0],"A",R,",",R," 0 0,",v," ",Z[0])}else A.push("L",_,",",w)}else A.push("M",m,",",M),null!=x&&A.push("A",c,",",c," 0 ",C,",",p," ",x,",",b),A.push("L",_,",",w),null!=S&&A.push("A",n,",",n," 0 ",L,",",1-p," ",S,",",k);return A.push("Z"),A.join("")}function t(n,t){return"M0,"+n+"A"+n+","+n+" 0 1,"+t+" 0,"+-n+"A"+n+","+n+" 0 1,"+t+" 0,"+n}var e=hu,r=pu,i=su,u=ql,o=gu,a=vu,l=du;return n.innerRadius=function(t){return arguments.length?(e=En(t),n):e},n.outerRadius=function(t){return arguments.length?(r=En(t),n):r},n.cornerRadius=function(t){return arguments.length?(i=En(t),n):i},n.padRadius=function(t){return arguments.length?(u=t==ql?ql:En(t),n):u},n.startAngle=function(t){return arguments.length?(o=En(t),n):o},n.endAngle=function(t){return arguments.length?(a=En(t),n):a},n.padAngle=function(t){return arguments.length?(l=En(t),n):l},n.centroid=function(){var n=(+e.apply(this,arguments)+ +r.apply(this,arguments))/2,t=(+o.apply(this,arguments)+ +a.apply(this,arguments))/2-Io;return[Math.cos(t)*n,Math.sin(t)*n]},n};var ql="auto";ao.svg.line=function(){return Mu(m)};var Tl=ao.map({linear:xu,"linear-closed":bu,step:_u,"step-before":wu,"step-after":Su,basis:zu,"basis-open":Lu,"basis-closed":qu,bundle:Tu,cardinal:Eu,"cardinal-open":ku,"cardinal-closed":Nu,monotone:Fu});Tl.forEach(function(n,t){t.key=n,t.closed=/-closed$/.test(n)});var Rl=[0,2/3,1/3,0],Dl=[0,1/3,2/3,0],Pl=[0,1/6,2/3,1/6];ao.svg.line.radial=function(){var n=Mu(Hu);return n.radius=n.x,delete n.x,n.angle=n.y,delete n.y,n},wu.reverse=Su,Su.reverse=wu,ao.svg.area=function(){return Ou(m)},ao.svg.area.radial=function(){var n=Ou(Hu);return n.radius=n.x,delete n.x,n.innerRadius=n.x0,delete n.x0,n.outerRadius=n.x1,delete n.x1,n.angle=n.y,delete n.y,n.startAngle=n.y0,delete n.y0,n.endAngle=n.y1,delete n.y1,n},ao.svg.chord=function(){function n(n,a){var l=t(this,u,n,a),c=t(this,o,n,a);return"M"+l.p0+r(l.r,l.p1,l.a1-l.a0)+(e(l,c)?i(l.r,l.p1,l.r,l.p0):i(l.r,l.p1,c.r,c.p0)+r(c.r,c.p1,c.a1-c.a0)+i(c.r,c.p1,l.r,l.p0))+"Z"}function t(n,t,e,r){var i=t.call(n,e,r),u=a.call(n,i,r),o=l.call(n,i,r)-Io,f=c.call(n,i,r)-Io;return{r:u,a0:o,a1:f,p0:[u*Math.cos(o),u*Math.sin(o)],p1:[u*Math.cos(f),u*Math.sin(f)]}}function e(n,t){return n.a0==t.a0&&n.a1==t.a1}function r(n,t,e){return"A"+n+","+n+" 0 "+ +(e>Fo)+",1 "+t}function i(n,t,e,r){return"Q 0,0 "+r}var u=Me,o=xe,a=Iu,l=gu,c=vu;return n.radius=function(t){return arguments.length?(a=En(t),n):a},n.source=function(t){return arguments.length?(u=En(t),n):u},n.target=function(t){return arguments.length?(o=En(t),n):o},n.startAngle=function(t){return arguments.length?(l=En(t),n):l},n.endAngle=function(t){return arguments.length?(c=En(t),n):c},n},ao.svg.diagonal=function(){function n(n,i){var u=t.call(this,n,i),o=e.call(this,n,i),a=(u.y+o.y)/2,l=[u,{x:u.x,y:a},{x:o.x,y:a},o];return l=l.map(r),"M"+l[0]+"C"+l[1]+" "+l[2]+" "+l[3]}var t=Me,e=xe,r=Yu;return n.source=function(e){return arguments.length?(t=En(e),n):t},n.target=function(t){return arguments.length?(e=En(t),n):e},n.projection=function(t){return arguments.length?(r=t,n):r},n},ao.svg.diagonal.radial=function(){var n=ao.svg.diagonal(),t=Yu,e=n.projection;return n.projection=function(n){return arguments.length?e(Zu(t=n)):t},n},ao.svg.symbol=function(){function n(n,r){return(Ul.get(t.call(this,n,r))||$u)(e.call(this,n,r))}var t=Xu,e=Vu;return n.type=function(e){return arguments.length?(t=En(e),n):t},n.size=function(t){return arguments.length?(e=En(t),n):e},n};var Ul=ao.map({circle:$u,cross:function(n){var t=Math.sqrt(n/5)/2;return"M"+-3*t+","+-t+"H"+-t+"V"+-3*t+"H"+t+"V"+-t+"H"+3*t+"V"+t+"H"+t+"V"+3*t+"H"+-t+"V"+t+"H"+-3*t+"Z"},diamond:function(n){var t=Math.sqrt(n/(2*Fl)),e=t*Fl;return"M0,"+-t+"L"+e+",0 0,"+t+" "+-e+",0Z"},square:function(n){var t=Math.sqrt(n)/2;return"M"+-t+","+-t+"L"+t+","+-t+" "+t+","+t+" "+-t+","+t+"Z"},"triangle-down":function(n){var t=Math.sqrt(n/jl),e=t*jl/2;return"M0,"+e+"L"+t+","+-e+" "+-t+","+-e+"Z"},"triangle-up":function(n){var t=Math.sqrt(n/jl),e=t*jl/2;return"M0,"+-e+"L"+t+","+e+" "+-t+","+e+"Z"}});ao.svg.symbolTypes=Ul.keys();var jl=Math.sqrt(3),Fl=Math.tan(30*Yo);Co.transition=function(n){for(var t,e,r=Hl||++Zl,i=Ku(n),u=[],o=Ol||{time:Date.now(),ease:Nr,delay:0,duration:250},a=-1,l=this.length;++a<l;){u.push(t=[]);for(var c=this[a],f=-1,s=c.length;++f<s;)(e=c[f])&&Qu(e,f,i,r,o),t.push(e)}return Wu(u,i,r)},Co.interrupt=function(n){return this.each(null==n?Il:Bu(Ku(n)))};var Hl,Ol,Il=Bu(Ku()),Yl=[],Zl=0;Yl.call=Co.call,Yl.empty=Co.empty,Yl.node=Co.node,Yl.size=Co.size,ao.transition=function(n,t){return n&&n.transition?Hl?n.transition(t):n:ao.selection().transition(n)},ao.transition.prototype=Yl,Yl.select=function(n){var t,e,r,i=this.id,u=this.namespace,o=[];n=A(n);for(var a=-1,l=this.length;++a<l;){o.push(t=[]);for(var c=this[a],f=-1,s=c.length;++f<s;)(r=c[f])&&(e=n.call(r,r.__data__,f,a))?("__data__"in r&&(e.__data__=r.__data__),Qu(e,f,u,i,r[u][i]),t.push(e)):t.push(null)}return Wu(o,u,i)},Yl.selectAll=function(n){var t,e,r,i,u,o=this.id,a=this.namespace,l=[];n=C(n);for(var c=-1,f=this.length;++c<f;)for(var s=this[c],h=-1,p=s.length;++h<p;)if(r=s[h]){u=r[a][o],e=n.call(r,r.__data__,h,c),l.push(t=[]);for(var g=-1,v=e.length;++g<v;)(i=e[g])&&Qu(i,g,a,o,u),t.push(i)}return Wu(l,a,o)},Yl.filter=function(n){var t,e,r,i=[];"function"!=typeof n&&(n=O(n));for(var u=0,o=this.length;o>u;u++){i.push(t=[]);for(var e=this[u],a=0,l=e.length;l>a;a++)(r=e[a])&&n.call(r,r.__data__,a,u)&&t.push(r)}return Wu(i,this.namespace,this.id)},Yl.tween=function(n,t){var e=this.id,r=this.namespace;return arguments.length<2?this.node()[r][e].tween.get(n):Y(this,null==t?function(t){t[r][e].tween.remove(n)}:function(i){i[r][e].tween.set(n,t)})},Yl.attr=function(n,t){function e(){this.removeAttribute(a)}function r(){this.removeAttributeNS(a.space,a.local)}function i(n){return null==n?e:(n+="",function(){var t,e=this.getAttribute(a);return e!==n&&(t=o(e,n),function(n){this.setAttribute(a,t(n))})})}function u(n){return null==n?r:(n+="",function(){var t,e=this.getAttributeNS(a.space,a.local);return e!==n&&(t=o(e,n),function(n){this.setAttributeNS(a.space,a.local,t(n))})})}if(arguments.length<2){for(t in n)this.attr(t,n[t]);return this}var o="transform"==n?$r:Mr,a=ao.ns.qualify(n);return Ju(this,"attr."+n,t,a.local?u:i)},Yl.attrTween=function(n,t){function e(n,e){var r=t.call(this,n,e,this.getAttribute(i));return r&&function(n){this.setAttribute(i,r(n))}}function r(n,e){var r=t.call(this,n,e,this.getAttributeNS(i.space,i.local));return r&&function(n){this.setAttributeNS(i.space,i.local,r(n))}}var i=ao.ns.qualify(n);return this.tween("attr."+n,i.local?r:e)},Yl.style=function(n,e,r){function i(){this.style.removeProperty(n)}function u(e){return null==e?i:(e+="",function(){var i,u=t(this).getComputedStyle(this,null).getPropertyValue(n);return u!==e&&(i=Mr(u,e),function(t){this.style.setProperty(n,i(t),r)})})}var o=arguments.length;if(3>o){if("string"!=typeof n){2>o&&(e="");for(r in n)this.style(r,n[r],e);return this}r=""}return Ju(this,"style."+n,e,u)},Yl.styleTween=function(n,e,r){function i(i,u){var o=e.call(this,i,u,t(this).getComputedStyle(this,null).getPropertyValue(n));return o&&function(t){this.style.setProperty(n,o(t),r)}}return arguments.length<3&&(r=""),this.tween("style."+n,i)},Yl.text=function(n){return Ju(this,"text",n,Gu)},Yl.remove=function(){var n=this.namespace;return this.each("end.transition",function(){var t;this[n].count<2&&(t=this.parentNode)&&t.removeChild(this)})},Yl.ease=function(n){var t=this.id,e=this.namespace;return arguments.length<1?this.node()[e][t].ease:("function"!=typeof n&&(n=ao.ease.apply(ao,arguments)),Y(this,function(r){r[e][t].ease=n}))},Yl.delay=function(n){var t=this.id,e=this.namespace;return arguments.length<1?this.node()[e][t].delay:Y(this,"function"==typeof n?function(r,i,u){r[e][t].delay=+n.call(r,r.__data__,i,u)}:(n=+n,function(r){r[e][t].delay=n}))},Yl.duration=function(n){var t=this.id,e=this.namespace;return arguments.length<1?this.node()[e][t].duration:Y(this,"function"==typeof n?function(r,i,u){r[e][t].duration=Math.max(1,n.call(r,r.__data__,i,u))}:(n=Math.max(1,n),function(r){r[e][t].duration=n}))},Yl.each=function(n,t){var e=this.id,r=this.namespace;if(arguments.length<2){var i=Ol,u=Hl;try{Hl=e,Y(this,function(t,i,u){Ol=t[r][e],n.call(t,t.__data__,i,u)})}finally{Ol=i,Hl=u}}else Y(this,function(i){var u=i[r][e];(u.event||(u.event=ao.dispatch("start","end","interrupt"))).on(n,t)});return this},Yl.transition=function(){for(var n,t,e,r,i=this.id,u=++Zl,o=this.namespace,a=[],l=0,c=this.length;c>l;l++){a.push(n=[]);for(var t=this[l],f=0,s=t.length;s>f;f++)(e=t[f])&&(r=e[o][i],Qu(e,f,o,u,{time:r.time,ease:r.ease,delay:r.delay+r.duration,duration:r.duration})),n.push(e)}return Wu(a,o,u)},ao.svg.axis=function(){function n(n){n.each(function(){var n,c=ao.select(this),f=this.__chart__||e,s=this.__chart__=e.copy(),h=null==l?s.ticks?s.ticks.apply(s,a):s.domain():l,p=null==t?s.tickFormat?s.tickFormat.apply(s,a):m:t,g=c.selectAll(".tick").data(h,s),v=g.enter().insert("g",".domain").attr("class","tick").style("opacity",Uo),d=ao.transition(g.exit()).style("opacity",Uo).remove(),y=ao.transition(g.order()).style("opacity",1),M=Math.max(i,0)+o,x=Zi(s),b=c.selectAll(".domain").data([0]),_=(b.enter().append("path").attr("class","domain"),ao.transition(b));v.append("line"),v.append("text");var w,S,k,N,E=v.select("line"),A=y.select("line"),C=g.select("text").text(p),z=v.select("text"),L=y.select("text"),q="top"===r||"left"===r?-1:1;if("bottom"===r||"top"===r?(n=no,w="x",k="y",S="x2",N="y2",C.attr("dy",0>q?"0em":".71em").style("text-anchor","middle"),_.attr("d","M"+x[0]+","+q*u+"V0H"+x[1]+"V"+q*u)):(n=to,w="y",k="x",S="y2",N="x2",C.attr("dy",".32em").style("text-anchor",0>q?"end":"start"),_.attr("d","M"+q*u+","+x[0]+"H0V"+x[1]+"H"+q*u)),E.attr(N,q*i),z.attr(k,q*M),A.attr(S,0).attr(N,q*i),L.attr(w,0).attr(k,q*M),s.rangeBand){var T=s,R=T.rangeBand()/2;f=s=function(n){return T(n)+R}}else f.rangeBand?f=s:d.call(n,s,f);v.call(n,f,s),y.call(n,s,s)})}var t,e=ao.scale.linear(),r=Vl,i=6,u=6,o=3,a=[10],l=null;return n.scale=function(t){return arguments.length?(e=t,n):e},n.orient=function(t){return arguments.length?(r=t in Xl?t+"":Vl,n):r},n.ticks=function(){return arguments.length?(a=co(arguments),n):a},n.tickValues=function(t){return arguments.length?(l=t,n):l},n.tickFormat=function(e){return arguments.length?(t=e,n):t},n.tickSize=function(t){var e=arguments.length;return e?(i=+t,u=+arguments[e-1],n):i},n.innerTickSize=function(t){return arguments.length?(i=+t,n):i},n.outerTickSize=function(t){return arguments.length?(u=+t,n):u},n.tickPadding=function(t){return arguments.length?(o=+t,n):o},n.tickSubdivide=function(){return arguments.length&&n},n};var Vl="bottom",Xl={top:1,right:1,bottom:1,left:1};ao.svg.brush=function(){function n(t){t.each(function(){var t=ao.select(this).style("pointer-events","all").style("-webkit-tap-highlight-color","rgba(0,0,0,0)").on("mousedown.brush",u).on("touchstart.brush",u),o=t.selectAll(".background").data([0]);o.enter().append("rect").attr("class","background").style("visibility","hidden").style("cursor","crosshair"),t.selectAll(".extent").data([0]).enter().append("rect").attr("class","extent").style("cursor","move");var a=t.selectAll(".resize").data(v,m);a.exit().remove(),a.enter().append("g").attr("class",function(n){return"resize "+n}).style("cursor",function(n){return $l[n]}).append("rect").attr("x",function(n){return/[ew]$/.test(n)?-3:null}).attr("y",function(n){return/^[ns]/.test(n)?-3:null}).attr("width",6).attr("height",6).style("visibility","hidden"),a.style("display",n.empty()?"none":null);var l,s=ao.transition(t),h=ao.transition(o);c&&(l=Zi(c),h.attr("x",l[0]).attr("width",l[1]-l[0]),r(s)),f&&(l=Zi(f),h.attr("y",l[0]).attr("height",l[1]-l[0]),i(s)),e(s)})}function e(n){n.selectAll(".resize").attr("transform",function(n){return"translate("+s[+/e$/.test(n)]+","+h[+/^s/.test(n)]+")"})}function r(n){n.select(".extent").attr("x",s[0]),n.selectAll(".extent,.n>rect,.s>rect").attr("width",s[1]-s[0])}function i(n){n.select(".extent").attr("y",h[0]),n.selectAll(".extent,.e>rect,.w>rect").attr("height",h[1]-h[0])}function u(){function u(){32==ao.event.keyCode&&(C||(M=null,L[0]-=s[1],L[1]-=h[1],C=2),S())}function v(){32==ao.event.keyCode&&2==C&&(L[0]+=s[1],L[1]+=h[1],C=0,S())}function d(){var n=ao.mouse(b),t=!1;x&&(n[0]+=x[0],n[1]+=x[1]),C||(ao.event.altKey?(M||(M=[(s[0]+s[1])/2,(h[0]+h[1])/2]),L[0]=s[+(n[0]<M[0])],L[1]=h[+(n[1]<M[1])]):M=null),E&&y(n,c,0)&&(r(k),t=!0),A&&y(n,f,1)&&(i(k),t=!0),t&&(e(k),w({type:"brush",mode:C?"move":"resize"}))}function y(n,t,e){var r,i,u=Zi(t),l=u[0],c=u[1],f=L[e],v=e?h:s,d=v[1]-v[0];return C&&(l-=f,c-=d+f),r=(e?g:p)?Math.max(l,Math.min(c,n[e])):n[e],C?i=(r+=f)+d:(M&&(f=Math.max(l,Math.min(c,2*M[e]-r))),r>f?(i=r,r=f):i=f),v[0]!=r||v[1]!=i?(e?a=null:o=null,v[0]=r,v[1]=i,!0):void 0}function m(){d(),k.style("pointer-events","all").selectAll(".resize").style("display",n.empty()?"none":null),ao.select("body").style("cursor",null),q.on("mousemove.brush",null).on("mouseup.brush",null).on("touchmove.brush",null).on("touchend.brush",null).on("keydown.brush",null).on("keyup.brush",null),z(),w({type:"brushend"})}var M,x,b=this,_=ao.select(ao.event.target),w=l.of(b,arguments),k=ao.select(b),N=_.datum(),E=!/^(n|s)$/.test(N)&&c,A=!/^(e|w)$/.test(N)&&f,C=_.classed("extent"),z=W(b),L=ao.mouse(b),q=ao.select(t(b)).on("keydown.brush",u).on("keyup.brush",v);if(ao.event.changedTouches?q.on("touchmove.brush",d).on("touchend.brush",m):q.on("mousemove.brush",d).on("mouseup.brush",m),k.interrupt().selectAll("*").interrupt(),C)L[0]=s[0]-L[0],L[1]=h[0]-L[1];else if(N){var T=+/w$/.test(N),R=+/^n/.test(N);x=[s[1-T]-L[0],h[1-R]-L[1]],L[0]=s[T],L[1]=h[R]}else ao.event.altKey&&(M=L.slice());k.style("pointer-events","none").selectAll(".resize").style("display",null),ao.select("body").style("cursor",_.style("cursor")),w({type:"brushstart"}),d()}var o,a,l=N(n,"brushstart","brush","brushend"),c=null,f=null,s=[0,0],h=[0,0],p=!0,g=!0,v=Bl[0];return n.event=function(n){n.each(function(){var n=l.of(this,arguments),t={x:s,y:h,i:o,j:a},e=this.__chart__||t;this.__chart__=t,Hl?ao.select(this).transition().each("start.brush",function(){o=e.i,a=e.j,s=e.x,h=e.y,n({type:"brushstart"})}).tween("brush:brush",function(){var e=xr(s,t.x),r=xr(h,t.y);return o=a=null,function(i){s=t.x=e(i),h=t.y=r(i),n({type:"brush",mode:"resize"})}}).each("end.brush",function(){o=t.i,a=t.j,n({type:"brush",mode:"resize"}),n({type:"brushend"})}):(n({type:"brushstart"}),n({type:"brush",mode:"resize"}),n({type:"brushend"}))})},n.x=function(t){return arguments.length?(c=t,v=Bl[!c<<1|!f],n):c},n.y=function(t){return arguments.length?(f=t,v=Bl[!c<<1|!f],n):f},n.clamp=function(t){return arguments.length?(c&&f?(p=!!t[0],g=!!t[1]):c?p=!!t:f&&(g=!!t),n):c&&f?[p,g]:c?p:f?g:null},n.extent=function(t){var e,r,i,u,l;return arguments.length?(c&&(e=t[0],r=t[1],f&&(e=e[0],r=r[0]),o=[e,r],c.invert&&(e=c(e),r=c(r)),e>r&&(l=e,e=r,r=l),e==s[0]&&r==s[1]||(s=[e,r])),f&&(i=t[0],u=t[1],c&&(i=i[1],u=u[1]),a=[i,u],f.invert&&(i=f(i),u=f(u)),i>u&&(l=i,i=u,u=l),i==h[0]&&u==h[1]||(h=[i,u])),n):(c&&(o?(e=o[0],r=o[1]):(e=s[0],r=s[1],c.invert&&(e=c.invert(e),r=c.invert(r)),e>r&&(l=e,e=r,r=l))),f&&(a?(i=a[0],u=a[1]):(i=h[0],u=h[1],f.invert&&(i=f.invert(i),u=f.invert(u)),i>u&&(l=i,i=u,u=l))),c&&f?[[e,i],[r,u]]:c?[e,r]:f&&[i,u])},n.clear=function(){return n.empty()||(s=[0,0],h=[0,0],o=a=null),n},n.empty=function(){return!!c&&s[0]==s[1]||!!f&&h[0]==h[1]},ao.rebind(n,l,"on")};var $l={n:"ns-resize",e:"ew-resize",s:"ns-resize",w:"ew-resize",nw:"nwse-resize",ne:"nesw-resize",se:"nwse-resize",sw:"nesw-resize"},Bl=[["n","e","s","w","nw","ne","se","sw"],["e","w"],["n","s"],[]],Wl=ga.format=xa.timeFormat,Jl=Wl.utc,Gl=Jl("%Y-%m-%dT%H:%M:%S.%LZ");Wl.iso=Date.prototype.toISOString&&+new Date("2000-01-01T00:00:00.000Z")?eo:Gl,eo.parse=function(n){var t=new Date(n);return isNaN(t)?null:t},eo.toString=Gl.toString,ga.second=On(function(n){return new va(1e3*Math.floor(n/1e3))},function(n,t){n.setTime(n.getTime()+1e3*Math.floor(t))},function(n){return n.getSeconds()}),ga.seconds=ga.second.range,ga.seconds.utc=ga.second.utc.range,ga.minute=On(function(n){return new va(6e4*Math.floor(n/6e4))},function(n,t){n.setTime(n.getTime()+6e4*Math.floor(t))},function(n){return n.getMinutes()}),ga.minutes=ga.minute.range,ga.minutes.utc=ga.minute.utc.range,ga.hour=On(function(n){var t=n.getTimezoneOffset()/60;return new va(36e5*(Math.floor(n/36e5-t)+t))},function(n,t){n.setTime(n.getTime()+36e5*Math.floor(t))},function(n){return n.getHours()}),ga.hours=ga.hour.range,ga.hours.utc=ga.hour.utc.range,ga.month=On(function(n){return n=ga.day(n),n.setDate(1),n},function(n,t){n.setMonth(n.getMonth()+t)},function(n){return n.getMonth()}),ga.months=ga.month.range,ga.months.utc=ga.month.utc.range;var Kl=[1e3,5e3,15e3,3e4,6e4,3e5,9e5,18e5,36e5,108e5,216e5,432e5,864e5,1728e5,6048e5,2592e6,7776e6,31536e6],Ql=[[ga.second,1],[ga.second,5],[ga.second,15],[ga.second,30],[ga.minute,1],[ga.minute,5],[ga.minute,15],[ga.minute,30],[ga.hour,1],[ga.hour,3],[ga.hour,6],[ga.hour,12],[ga.day,1],[ga.day,2],[ga.week,1],[ga.month,1],[ga.month,3],[ga.year,1]],nc=Wl.multi([[".%L",function(n){return n.getMilliseconds()}],[":%S",function(n){return n.getSeconds()}],["%I:%M",function(n){return n.getMinutes()}],["%I %p",function(n){return n.getHours()}],["%a %d",function(n){return n.getDay()&&1!=n.getDate()}],["%b %d",function(n){return 1!=n.getDate()}],["%B",function(n){return n.getMonth()}],["%Y",zt]]),tc={range:function(n,t,e){return ao.range(Math.ceil(n/e)*e,+t,e).map(io)},floor:m,ceil:m};Ql.year=ga.year,ga.scale=function(){return ro(ao.scale.linear(),Ql,nc)};var ec=Ql.map(function(n){return[n[0].utc,n[1]]}),rc=Jl.multi([[".%L",function(n){return n.getUTCMilliseconds()}],[":%S",function(n){return n.getUTCSeconds()}],["%I:%M",function(n){return n.getUTCMinutes()}],["%I %p",function(n){return n.getUTCHours()}],["%a %d",function(n){return n.getUTCDay()&&1!=n.getUTCDate()}],["%b %d",function(n){return 1!=n.getUTCDate()}],["%B",function(n){return n.getUTCMonth()}],["%Y",zt]]);ec.year=ga.year.utc,ga.scale.utc=function(){return ro(ao.scale.linear(),ec,rc)},ao.text=An(function(n){return n.responseText}),ao.json=function(n,t){return Cn(n,"application/json",uo,t)},ao.html=function(n,t){return Cn(n,"text/html",oo,t)},ao.xml=An(function(n){return n.responseXML}),"function"==typeof define&&define.amd?(this.d3=ao,define(ao)):"object"==typeof module&&module.exports?module.exports=ao:this.d3=ao}(); php-code-coverage/src/Report/Html/Renderer/Template/dashboard.html.dist 0000644 00000015633 15243417753 0022125 0 ustar 00 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Dashboard for {{full_path}}</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="{{path_to_root}}_css/bootstrap.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/nv.d3.min.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/style.css?v={{version}}" rel="stylesheet" type="text/css">
<link href="{{path_to_root}}_css/custom.css" rel="stylesheet" type="text/css">
</head>
<body>
<header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
{{breadcrumbs}}
</ol>
</nav>
</div>
</div>
</div>
</header>
<div class="container-fluid">
<div class="row">
<div class="col-md-12">
<h2>Classes</h2>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Coverage Distribution</h3>
<div id="classCoverageDistribution" style="height: 300px;">
<svg></svg>
</div>
</div>
<div class="col-md-6">
<h3>Complexity</h3>
<div id="classComplexity" style="height: 300px;">
<svg></svg>
</div>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Insufficient Coverage</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Class</th>
<th class="text-right">Coverage</th>
</tr>
</thead>
<tbody>
{{insufficient_coverage_classes}}
</tbody>
</table>
</div>
</div>
<div class="col-md-6">
<h3>Project Risks</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Class</th>
<th class="text-right"><abbr title="Change Risk Anti-Patterns (CRAP) Index">CRAP</abbr></th>
</tr>
</thead>
<tbody>
{{project_risks_classes}}
</tbody>
</table>
</div>
</div>
</div>
<div class="row">
<div class="col-md-12">
<h2>Methods</h2>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Coverage Distribution</h3>
<div id="methodCoverageDistribution" style="height: 300px;">
<svg></svg>
</div>
</div>
<div class="col-md-6">
<h3>Complexity</h3>
<div id="methodComplexity" style="height: 300px;">
<svg></svg>
</div>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>Insufficient Coverage</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Method</th>
<th class="text-right">Coverage</th>
</tr>
</thead>
<tbody>
{{insufficient_coverage_methods}}
</tbody>
</table>
</div>
</div>
<div class="col-md-6">
<h3>Project Risks</h3>
<div class="scrollbox">
<table class="table">
<thead>
<tr>
<th>Method</th>
<th class="text-right"><abbr title="Change Risk Anti-Patterns (CRAP) Index">CRAP</abbr></th>
</tr>
</thead>
<tbody>
{{project_risks_methods}}
</tbody>
</table>
</div>
</div>
</div>
<footer>
<hr/>
<p>
<small>Generated by <a href="https://github.com/sebastianbergmann/php-code-coverage" target="_top">php-code-coverage {{version}}</a> using {{runtime}}{{generator}} at {{date}}.</small>
</p>
</footer>
</div>
<script src="{{path_to_root}}_js/jquery.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/d3.min.js?v={{version}}" type="text/javascript"></script>
<script src="{{path_to_root}}_js/nv.d3.min.js?v={{version}}" type="text/javascript"></script>
<script type="text/javascript">
$(document).ready(function() {
nv.addGraph(function() {
var chart = nv.models.multiBarChart();
chart.tooltips(false)
.showControls(false)
.showLegend(false)
.reduceXTicks(false)
.staggerLabels(true)
.yAxis.tickFormat(d3.format('d'));
d3.select('#classCoverageDistribution svg')
.datum(getCoverageDistributionData({{class_coverage_distribution}}, "Class Coverage"))
.transition().duration(500).call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
nv.addGraph(function() {
var chart = nv.models.multiBarChart();
chart.tooltips(false)
.showControls(false)
.showLegend(false)
.reduceXTicks(false)
.staggerLabels(true)
.yAxis.tickFormat(d3.format('d'));
d3.select('#methodCoverageDistribution svg')
.datum(getCoverageDistributionData({{method_coverage_distribution}}, "Method Coverage"))
.transition().duration(500).call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
function getCoverageDistributionData(data, label) {
var labels = [
'0%',
'0-10%',
'10-20%',
'20-30%',
'30-40%',
'40-50%',
'50-60%',
'60-70%',
'70-80%',
'80-90%',
'90-100%',
'100%'
];
var values = [];
$.each(labels, function(key) {
values.push({x: labels[key], y: data[key]});
});
return [
{
key: label,
values: values,
color: "#4572A7"
}
];
}
nv.addGraph(function() {
var chart = nv.models.scatterChart()
.showDistX(true)
.showDistY(true)
.showLegend(false)
.forceX([0, 100]);
chart.tooltipContent(function(graph) {
return '<p>' + graph.point.class + '</p>';
});
chart.xAxis.axisLabel('Code Coverage (in percent)');
chart.yAxis.axisLabel('Cyclomatic Complexity');
d3.select('#classComplexity svg')
.datum(getComplexityData({{complexity_class}}, 'Class Complexity'))
.transition()
.duration(500)
.call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
nv.addGraph(function() {
var chart = nv.models.scatterChart()
.showDistX(true)
.showDistY(true)
.showLegend(false)
.forceX([0, 100]);
chart.tooltipContent(function(graph) {
return '<p>' + graph.point.class + '</p>';
});
chart.xAxis.axisLabel('Code Coverage (in percent)');
chart.yAxis.axisLabel('Method Complexity');
d3.select('#methodComplexity svg')
.datum(getComplexityData({{complexity_method}}, 'Method Complexity'))
.transition()
.duration(500)
.call(chart);
nv.utils.windowResize(chart.update);
return chart;
});
function getComplexityData(data, label) {
var values = [];
$.each(data, function(key) {
var value = Math.round(data[key][0]*100) / 100;
values.push({
x: value,
y: data[key][1],
class: data[key][2],
size: 0.05,
shape: 'diamond'
});
});
return [
{
key: label,
values: values,
color: "#4572A7"
}
];
}
});
</script>
</body>
</html>
php-code-coverage/src/Report/Html/Renderer/Dashboard.php 0000644 00000023770 15243417753 0017174 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use function array_values;
use function arsort;
use function asort;
use function count;
use function explode;
use function floor;
use function json_encode;
use function sprintf;
use function str_replace;
use SebastianBergmann\CodeCoverage\FileCouldNotBeWrittenException;
use SebastianBergmann\CodeCoverage\Node\AbstractNode;
use SebastianBergmann\CodeCoverage\Node\Directory as DirectoryNode;
use SebastianBergmann\Template\Exception;
use SebastianBergmann\Template\Template;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Dashboard extends Renderer
{
public function render(DirectoryNode $node, string $file): void
{
$classes = $node->classesAndTraits();
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'dashboard_branch.html' : 'dashboard.html');
$template = new Template(
$templateName,
'{{',
'}}',
);
$this->setCommonTemplateVariables($template, $node);
$baseLink = $node->id() . '/';
$complexity = $this->complexity($classes, $baseLink);
$coverageDistribution = $this->coverageDistribution($classes);
$insufficientCoverage = $this->insufficientCoverage($classes, $baseLink);
$projectRisks = $this->projectRisks($classes, $baseLink);
$template->setVar(
[
'insufficient_coverage_classes' => $insufficientCoverage['class'],
'insufficient_coverage_methods' => $insufficientCoverage['method'],
'project_risks_classes' => $projectRisks['class'],
'project_risks_methods' => $projectRisks['method'],
'complexity_class' => $complexity['class'],
'complexity_method' => $complexity['method'],
'class_coverage_distribution' => $coverageDistribution['class'],
'method_coverage_distribution' => $coverageDistribution['method'],
],
);
try {
$template->renderTo($file);
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
protected function activeBreadcrumb(AbstractNode $node): string
{
return sprintf(
' <li class="breadcrumb-item"><a href="index.html">%s</a></li>' . "\n" .
' <li class="breadcrumb-item active">(Dashboard)</li>' . "\n",
$node->name(),
);
}
/**
* Returns the data for the Class/Method Complexity charts.
*/
private function complexity(array $classes, string $baseLink): array
{
$result = ['class' => [], 'method' => []];
foreach ($classes as $className => $class) {
foreach ($class['methods'] as $methodName => $method) {
if ($className !== '*') {
$methodName = $className . '::' . $methodName;
}
$result['method'][] = [
$method['coverage'],
$method['ccn'],
sprintf(
'<a href="%s">%s</a>',
str_replace($baseLink, '', $method['link']),
$methodName,
),
];
}
$result['class'][] = [
$class['coverage'],
$class['ccn'],
sprintf(
'<a href="%s">%s</a>',
str_replace($baseLink, '', $class['link']),
$className,
),
];
}
return [
'class' => json_encode($result['class']),
'method' => json_encode($result['method']),
];
}
/**
* Returns the data for the Class / Method Coverage Distribution chart.
*/
private function coverageDistribution(array $classes): array
{
$result = [
'class' => [
'0%' => 0,
'0-10%' => 0,
'10-20%' => 0,
'20-30%' => 0,
'30-40%' => 0,
'40-50%' => 0,
'50-60%' => 0,
'60-70%' => 0,
'70-80%' => 0,
'80-90%' => 0,
'90-100%' => 0,
'100%' => 0,
],
'method' => [
'0%' => 0,
'0-10%' => 0,
'10-20%' => 0,
'20-30%' => 0,
'30-40%' => 0,
'40-50%' => 0,
'50-60%' => 0,
'60-70%' => 0,
'70-80%' => 0,
'80-90%' => 0,
'90-100%' => 0,
'100%' => 0,
],
];
foreach ($classes as $class) {
foreach ($class['methods'] as $methodName => $method) {
if ($method['coverage'] === 0) {
$result['method']['0%']++;
} elseif ($method['coverage'] === 100) {
$result['method']['100%']++;
} else {
$key = floor($method['coverage'] / 10) * 10;
$key = $key . '-' . ($key + 10) . '%';
$result['method'][$key]++;
}
}
if ($class['coverage'] === 0) {
$result['class']['0%']++;
} elseif ($class['coverage'] === 100) {
$result['class']['100%']++;
} else {
$key = floor($class['coverage'] / 10) * 10;
$key = $key . '-' . ($key + 10) . '%';
$result['class'][$key]++;
}
}
return [
'class' => json_encode(array_values($result['class'])),
'method' => json_encode(array_values($result['method'])),
];
}
/**
* Returns the classes / methods with insufficient coverage.
*/
private function insufficientCoverage(array $classes, string $baseLink): array
{
$leastTestedClasses = [];
$leastTestedMethods = [];
$result = ['class' => '', 'method' => ''];
foreach ($classes as $className => $class) {
foreach ($class['methods'] as $methodName => $method) {
if ($method['coverage'] < $this->thresholds->highLowerBound()) {
$key = $methodName;
if ($className !== '*') {
$key = $className . '::' . $methodName;
}
$leastTestedMethods[$key] = $method['coverage'];
}
}
if ($class['coverage'] < $this->thresholds->highLowerBound()) {
$leastTestedClasses[$className] = $class['coverage'];
}
}
asort($leastTestedClasses);
asort($leastTestedMethods);
foreach ($leastTestedClasses as $className => $coverage) {
$result['class'] .= sprintf(
' <tr><td><a href="%s">%s</a></td><td class="text-right">%d%%</td></tr>' . "\n",
str_replace($baseLink, '', $classes[$className]['link']),
$className,
$coverage,
);
}
foreach ($leastTestedMethods as $methodName => $coverage) {
[$class, $method] = explode('::', $methodName);
$result['method'] .= sprintf(
' <tr><td><a href="%s"><abbr title="%s">%s</abbr></a></td><td class="text-right">%d%%</td></tr>' . "\n",
str_replace($baseLink, '', $classes[$class]['methods'][$method]['link']),
$methodName,
$method,
$coverage,
);
}
return $result;
}
/**
* Returns the project risks according to the CRAP index.
*/
private function projectRisks(array $classes, string $baseLink): array
{
$classRisks = [];
$methodRisks = [];
$result = ['class' => '', 'method' => ''];
foreach ($classes as $className => $class) {
foreach ($class['methods'] as $methodName => $method) {
if ($method['coverage'] < $this->thresholds->highLowerBound() && $method['ccn'] > 1) {
$key = $methodName;
if ($className !== '*') {
$key = $className . '::' . $methodName;
}
$methodRisks[$key] = $method['crap'];
}
}
if ($class['coverage'] < $this->thresholds->highLowerBound() &&
$class['ccn'] > count($class['methods'])) {
$classRisks[$className] = $class['crap'];
}
}
arsort($classRisks);
arsort($methodRisks);
foreach ($classRisks as $className => $crap) {
$result['class'] .= sprintf(
' <tr><td><a href="%s">%s</a></td><td class="text-right">%d</td></tr>' . "\n",
str_replace($baseLink, '', $classes[$className]['link']),
$className,
$crap,
);
}
foreach ($methodRisks as $methodName => $crap) {
[$class, $method] = explode('::', $methodName);
$result['method'] .= sprintf(
' <tr><td><a href="%s"><abbr title="%s">%s</abbr></a></td><td class="text-right">%d</td></tr>' . "\n",
str_replace($baseLink, '', $classes[$class]['methods'][$method]['link']),
$methodName,
$method,
$crap,
);
}
return $result;
}
}
php-code-coverage/src/Report/Html/Renderer/File.php 0000644 00000121071 15243417753 0016155 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use const ENT_COMPAT;
use const ENT_HTML401;
use const ENT_SUBSTITUTE;
use const T_ABSTRACT;
use const T_ARRAY;
use const T_AS;
use const T_BREAK;
use const T_CALLABLE;
use const T_CASE;
use const T_CATCH;
use const T_CLASS;
use const T_CLONE;
use const T_COMMENT;
use const T_CONST;
use const T_CONTINUE;
use const T_DECLARE;
use const T_DEFAULT;
use const T_DO;
use const T_DOC_COMMENT;
use const T_ECHO;
use const T_ELSE;
use const T_ELSEIF;
use const T_EMPTY;
use const T_ENDDECLARE;
use const T_ENDFOR;
use const T_ENDFOREACH;
use const T_ENDIF;
use const T_ENDSWITCH;
use const T_ENDWHILE;
use const T_EVAL;
use const T_EXIT;
use const T_EXTENDS;
use const T_FINAL;
use const T_FINALLY;
use const T_FOR;
use const T_FOREACH;
use const T_FUNCTION;
use const T_GLOBAL;
use const T_GOTO;
use const T_HALT_COMPILER;
use const T_IF;
use const T_IMPLEMENTS;
use const T_INCLUDE;
use const T_INCLUDE_ONCE;
use const T_INLINE_HTML;
use const T_INSTANCEOF;
use const T_INSTEADOF;
use const T_INTERFACE;
use const T_ISSET;
use const T_LIST;
use const T_NAMESPACE;
use const T_NEW;
use const T_PRINT;
use const T_PRIVATE;
use const T_PROTECTED;
use const T_PUBLIC;
use const T_REQUIRE;
use const T_REQUIRE_ONCE;
use const T_RETURN;
use const T_STATIC;
use const T_SWITCH;
use const T_THROW;
use const T_TRAIT;
use const T_TRY;
use const T_UNSET;
use const T_USE;
use const T_VAR;
use const T_WHILE;
use const T_YIELD;
use const T_YIELD_FROM;
use function array_key_exists;
use function array_keys;
use function array_merge;
use function array_pop;
use function array_unique;
use function count;
use function explode;
use function file_get_contents;
use function htmlspecialchars;
use function is_string;
use function ksort;
use function range;
use function sort;
use function sprintf;
use function str_ends_with;
use function str_replace;
use function token_get_all;
use function trim;
use SebastianBergmann\CodeCoverage\FileCouldNotBeWrittenException;
use SebastianBergmann\CodeCoverage\Node\File as FileNode;
use SebastianBergmann\CodeCoverage\Util\Percentage;
use SebastianBergmann\Template\Exception;
use SebastianBergmann\Template\Template;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class File extends Renderer
{
/**
* @psalm-var array<int,true>
*/
private const KEYWORD_TOKENS = [
T_ABSTRACT => true,
T_ARRAY => true,
T_AS => true,
T_BREAK => true,
T_CALLABLE => true,
T_CASE => true,
T_CATCH => true,
T_CLASS => true,
T_CLONE => true,
T_CONST => true,
T_CONTINUE => true,
T_DECLARE => true,
T_DEFAULT => true,
T_DO => true,
T_ECHO => true,
T_ELSE => true,
T_ELSEIF => true,
T_EMPTY => true,
T_ENDDECLARE => true,
T_ENDFOR => true,
T_ENDFOREACH => true,
T_ENDIF => true,
T_ENDSWITCH => true,
T_ENDWHILE => true,
T_ENUM => true,
T_EVAL => true,
T_EXIT => true,
T_EXTENDS => true,
T_FINAL => true,
T_FINALLY => true,
T_FN => true,
T_FOR => true,
T_FOREACH => true,
T_FUNCTION => true,
T_GLOBAL => true,
T_GOTO => true,
T_HALT_COMPILER => true,
T_IF => true,
T_IMPLEMENTS => true,
T_INCLUDE => true,
T_INCLUDE_ONCE => true,
T_INSTANCEOF => true,
T_INSTEADOF => true,
T_INTERFACE => true,
T_ISSET => true,
T_LIST => true,
T_MATCH => true,
T_NAMESPACE => true,
T_NEW => true,
T_PRINT => true,
T_PRIVATE => true,
T_PROTECTED => true,
T_PUBLIC => true,
T_READONLY => true,
T_REQUIRE => true,
T_REQUIRE_ONCE => true,
T_RETURN => true,
T_STATIC => true,
T_SWITCH => true,
T_THROW => true,
T_TRAIT => true,
T_TRY => true,
T_UNSET => true,
T_USE => true,
T_VAR => true,
T_WHILE => true,
T_YIELD => true,
T_YIELD_FROM => true,
];
private static array $formattedSourceCache = [];
private int $htmlSpecialCharsFlags = ENT_COMPAT | ENT_HTML401 | ENT_SUBSTITUTE;
public function render(FileNode $node, string $file): void
{
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'file_branch.html' : 'file.html');
$template = new Template($templateName, '{{', '}}');
$this->setCommonTemplateVariables($template, $node);
$template->setVar(
[
'items' => $this->renderItems($node),
'lines' => $this->renderSourceWithLineCoverage($node),
'legend' => '<p><span class="legend covered-by-small-tests">Covered by small (and larger) tests</span><span class="legend covered-by-medium-tests">Covered by medium (and large) tests</span><span class="legend covered-by-large-tests">Covered by large tests (and tests of unknown size)</span><span class="legend not-covered">Not covered</span><span class="legend not-coverable">Not coverable</span></p>',
'structure' => '',
],
);
try {
$template->renderTo($file . '.html');
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
if ($this->hasBranchCoverage) {
$template->setVar(
[
'items' => $this->renderItems($node),
'lines' => $this->renderSourceWithBranchCoverage($node),
'legend' => '<p><span class="success"><strong>Fully covered</strong></span><span class="warning"><strong>Partially covered</strong></span><span class="danger"><strong>Not covered</strong></span></p>',
'structure' => $this->renderBranchStructure($node),
],
);
try {
$template->renderTo($file . '_branch.html');
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$template->setVar(
[
'items' => $this->renderItems($node),
'lines' => $this->renderSourceWithPathCoverage($node),
'legend' => '<p><span class="success"><strong>Fully covered</strong></span><span class="warning"><strong>Partially covered</strong></span><span class="danger"><strong>Not covered</strong></span></p>',
'structure' => $this->renderPathStructure($node),
],
);
try {
$template->renderTo($file . '_path.html');
} catch (Exception $e) {
throw new FileCouldNotBeWrittenException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
}
private function renderItems(FileNode $node): string
{
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'file_item_branch.html' : 'file_item.html');
$template = new Template($templateName, '{{', '}}');
$methodTemplateName = $this->templatePath . ($this->hasBranchCoverage ? 'method_item_branch.html' : 'method_item.html');
$methodItemTemplate = new Template(
$methodTemplateName,
'{{',
'}}',
);
$items = $this->renderItemTemplate(
$template,
[
'name' => 'Total',
'numClasses' => $node->numberOfClassesAndTraits(),
'numTestedClasses' => $node->numberOfTestedClassesAndTraits(),
'numMethods' => $node->numberOfFunctionsAndMethods(),
'numTestedMethods' => $node->numberOfTestedFunctionsAndMethods(),
'linesExecutedPercent' => $node->percentageOfExecutedLines()->asFloat(),
'linesExecutedPercentAsString' => $node->percentageOfExecutedLines()->asString(),
'numExecutedLines' => $node->numberOfExecutedLines(),
'numExecutableLines' => $node->numberOfExecutableLines(),
'branchesExecutedPercent' => $node->percentageOfExecutedBranches()->asFloat(),
'branchesExecutedPercentAsString' => $node->percentageOfExecutedBranches()->asString(),
'numExecutedBranches' => $node->numberOfExecutedBranches(),
'numExecutableBranches' => $node->numberOfExecutableBranches(),
'pathsExecutedPercent' => $node->percentageOfExecutedPaths()->asFloat(),
'pathsExecutedPercentAsString' => $node->percentageOfExecutedPaths()->asString(),
'numExecutedPaths' => $node->numberOfExecutedPaths(),
'numExecutablePaths' => $node->numberOfExecutablePaths(),
'testedMethodsPercent' => $node->percentageOfTestedFunctionsAndMethods()->asFloat(),
'testedMethodsPercentAsString' => $node->percentageOfTestedFunctionsAndMethods()->asString(),
'testedClassesPercent' => $node->percentageOfTestedClassesAndTraits()->asFloat(),
'testedClassesPercentAsString' => $node->percentageOfTestedClassesAndTraits()->asString(),
'crap' => '<abbr title="Change Risk Anti-Patterns (CRAP) Index">CRAP</abbr>',
],
);
$items .= $this->renderFunctionItems(
$node->functions(),
$methodItemTemplate,
);
$items .= $this->renderTraitOrClassItems(
$node->traits(),
$template,
$methodItemTemplate,
);
$items .= $this->renderTraitOrClassItems(
$node->classes(),
$template,
$methodItemTemplate,
);
return $items;
}
private function renderTraitOrClassItems(array $items, Template $template, Template $methodItemTemplate): string
{
$buffer = '';
if (empty($items)) {
return $buffer;
}
foreach ($items as $name => $item) {
$numMethods = 0;
$numTestedMethods = 0;
foreach ($item['methods'] as $method) {
if ($method['executableLines'] > 0) {
$numMethods++;
if ($method['executedLines'] === $method['executableLines']) {
$numTestedMethods++;
}
}
}
if ($item['executableLines'] > 0) {
$numClasses = 1;
$numTestedClasses = $numTestedMethods === $numMethods ? 1 : 0;
$linesExecutedPercentAsString = Percentage::fromFractionAndTotal(
$item['executedLines'],
$item['executableLines'],
)->asString();
$branchesExecutedPercentAsString = Percentage::fromFractionAndTotal(
$item['executedBranches'],
$item['executableBranches'],
)->asString();
$pathsExecutedPercentAsString = Percentage::fromFractionAndTotal(
$item['executedPaths'],
$item['executablePaths'],
)->asString();
} else {
$numClasses = 0;
$numTestedClasses = 0;
$linesExecutedPercentAsString = 'n/a';
$branchesExecutedPercentAsString = 'n/a';
$pathsExecutedPercentAsString = 'n/a';
}
$testedMethodsPercentage = Percentage::fromFractionAndTotal(
$numTestedMethods,
$numMethods,
);
$testedClassesPercentage = Percentage::fromFractionAndTotal(
$numTestedMethods === $numMethods ? 1 : 0,
1,
);
$buffer .= $this->renderItemTemplate(
$template,
[
'name' => $this->abbreviateClassName($name),
'numClasses' => $numClasses,
'numTestedClasses' => $numTestedClasses,
'numMethods' => $numMethods,
'numTestedMethods' => $numTestedMethods,
'linesExecutedPercent' => Percentage::fromFractionAndTotal(
$item['executedLines'],
$item['executableLines'],
)->asFloat(),
'linesExecutedPercentAsString' => $linesExecutedPercentAsString,
'numExecutedLines' => $item['executedLines'],
'numExecutableLines' => $item['executableLines'],
'branchesExecutedPercent' => Percentage::fromFractionAndTotal(
$item['executedBranches'],
$item['executableBranches'],
)->asFloat(),
'branchesExecutedPercentAsString' => $branchesExecutedPercentAsString,
'numExecutedBranches' => $item['executedBranches'],
'numExecutableBranches' => $item['executableBranches'],
'pathsExecutedPercent' => Percentage::fromFractionAndTotal(
$item['executedPaths'],
$item['executablePaths'],
)->asFloat(),
'pathsExecutedPercentAsString' => $pathsExecutedPercentAsString,
'numExecutedPaths' => $item['executedPaths'],
'numExecutablePaths' => $item['executablePaths'],
'testedMethodsPercent' => $testedMethodsPercentage->asFloat(),
'testedMethodsPercentAsString' => $testedMethodsPercentage->asString(),
'testedClassesPercent' => $testedClassesPercentage->asFloat(),
'testedClassesPercentAsString' => $testedClassesPercentage->asString(),
'crap' => $item['crap'],
],
);
foreach ($item['methods'] as $method) {
$buffer .= $this->renderFunctionOrMethodItem(
$methodItemTemplate,
$method,
' ',
);
}
}
return $buffer;
}
private function renderFunctionItems(array $functions, Template $template): string
{
if (empty($functions)) {
return '';
}
$buffer = '';
foreach ($functions as $function) {
$buffer .= $this->renderFunctionOrMethodItem(
$template,
$function,
);
}
return $buffer;
}
private function renderFunctionOrMethodItem(Template $template, array $item, string $indent = ''): string
{
$numMethods = 0;
$numTestedMethods = 0;
if ($item['executableLines'] > 0) {
$numMethods = 1;
if ($item['executedLines'] === $item['executableLines']) {
$numTestedMethods = 1;
}
}
$executedLinesPercentage = Percentage::fromFractionAndTotal(
$item['executedLines'],
$item['executableLines'],
);
$executedBranchesPercentage = Percentage::fromFractionAndTotal(
$item['executedBranches'],
$item['executableBranches'],
);
$executedPathsPercentage = Percentage::fromFractionAndTotal(
$item['executedPaths'],
$item['executablePaths'],
);
$testedMethodsPercentage = Percentage::fromFractionAndTotal(
$numTestedMethods,
1,
);
return $this->renderItemTemplate(
$template,
[
'name' => sprintf(
'%s<a href="#%d"><abbr title="%s">%s</abbr></a>',
$indent,
$item['startLine'],
htmlspecialchars($item['signature'], $this->htmlSpecialCharsFlags),
$item['functionName'] ?? $item['methodName'],
),
'numMethods' => $numMethods,
'numTestedMethods' => $numTestedMethods,
'linesExecutedPercent' => $executedLinesPercentage->asFloat(),
'linesExecutedPercentAsString' => $executedLinesPercentage->asString(),
'numExecutedLines' => $item['executedLines'],
'numExecutableLines' => $item['executableLines'],
'branchesExecutedPercent' => $executedBranchesPercentage->asFloat(),
'branchesExecutedPercentAsString' => $executedBranchesPercentage->asString(),
'numExecutedBranches' => $item['executedBranches'],
'numExecutableBranches' => $item['executableBranches'],
'pathsExecutedPercent' => $executedPathsPercentage->asFloat(),
'pathsExecutedPercentAsString' => $executedPathsPercentage->asString(),
'numExecutedPaths' => $item['executedPaths'],
'numExecutablePaths' => $item['executablePaths'],
'testedMethodsPercent' => $testedMethodsPercentage->asFloat(),
'testedMethodsPercentAsString' => $testedMethodsPercentage->asString(),
'crap' => $item['crap'],
],
);
}
private function renderSourceWithLineCoverage(FileNode $node): string
{
$linesTemplate = new Template($this->templatePath . 'lines.html.dist', '{{', '}}');
$singleLineTemplate = new Template($this->templatePath . 'line.html.dist', '{{', '}}');
$coverageData = $node->lineCoverageData();
$testData = $node->testData();
$codeLines = $this->loadFile($node->pathAsString());
$lines = '';
$i = 1;
foreach ($codeLines as $line) {
$trClass = '';
$popoverContent = '';
$popoverTitle = '';
if (array_key_exists($i, $coverageData)) {
$numTests = ($coverageData[$i] ? count($coverageData[$i]) : 0);
if ($coverageData[$i] === null) {
$trClass = 'warning';
} elseif ($numTests === 0) {
$trClass = 'danger';
} else {
if ($numTests > 1) {
$popoverTitle = $numTests . ' tests cover line ' . $i;
} else {
$popoverTitle = '1 test covers line ' . $i;
}
$lineCss = 'covered-by-large-tests';
$popoverContent = '<ul>';
foreach ($coverageData[$i] as $test) {
if ($lineCss === 'covered-by-large-tests' && $testData[$test]['size'] === 'medium') {
$lineCss = 'covered-by-medium-tests';
} elseif ($testData[$test]['size'] === 'small') {
$lineCss = 'covered-by-small-tests';
}
$popoverContent .= $this->createPopoverContentForTest($test, $testData[$test]);
}
$popoverContent .= '</ul>';
$trClass = $lineCss . ' popin';
}
}
$popover = '';
if (!empty($popoverTitle)) {
$popover = sprintf(
' data-title="%s" data-content="%s" data-placement="top" data-html="true"',
$popoverTitle,
htmlspecialchars($popoverContent, $this->htmlSpecialCharsFlags),
);
}
$lines .= $this->renderLine($singleLineTemplate, $i, $line, $trClass, $popover);
$i++;
}
$linesTemplate->setVar(['lines' => $lines]);
return $linesTemplate->render();
}
private function renderSourceWithBranchCoverage(FileNode $node): string
{
$linesTemplate = new Template($this->templatePath . 'lines.html.dist', '{{', '}}');
$singleLineTemplate = new Template($this->templatePath . 'line.html.dist', '{{', '}}');
$functionCoverageData = $node->functionCoverageData();
$testData = $node->testData();
$codeLines = $this->loadFile($node->pathAsString());
$lineData = [];
/** @var int $line */
foreach (array_keys($codeLines) as $line) {
$lineData[$line + 1] = [
'includedInBranches' => 0,
'includedInHitBranches' => 0,
'tests' => [],
];
}
foreach ($functionCoverageData as $method) {
foreach ($method['branches'] as $branch) {
foreach (range($branch['line_start'], $branch['line_end']) as $line) {
if (!isset($lineData[$line])) { // blank line at end of file is sometimes included here
continue;
}
$lineData[$line]['includedInBranches']++;
if ($branch['hit']) {
$lineData[$line]['includedInHitBranches']++;
$lineData[$line]['tests'] = array_unique(array_merge($lineData[$line]['tests'], $branch['hit']));
}
}
}
}
$lines = '';
$i = 1;
/** @var string $line */
foreach ($codeLines as $line) {
$trClass = '';
$popover = '';
if ($lineData[$i]['includedInBranches'] > 0) {
$lineCss = 'success';
if ($lineData[$i]['includedInHitBranches'] === 0) {
$lineCss = 'danger';
} elseif ($lineData[$i]['includedInHitBranches'] !== $lineData[$i]['includedInBranches']) {
$lineCss = 'warning';
}
$popoverContent = '<ul>';
if (count($lineData[$i]['tests']) === 1) {
$popoverTitle = '1 test covers line ' . $i;
} else {
$popoverTitle = count($lineData[$i]['tests']) . ' tests cover line ' . $i;
}
$popoverTitle .= '. These are covering ' . $lineData[$i]['includedInHitBranches'] . ' out of the ' . $lineData[$i]['includedInBranches'] . ' code branches.';
foreach ($lineData[$i]['tests'] as $test) {
$popoverContent .= $this->createPopoverContentForTest($test, $testData[$test]);
}
$popoverContent .= '</ul>';
$trClass = $lineCss . ' popin';
$popover = sprintf(
' data-title="%s" data-content="%s" data-placement="top" data-html="true"',
$popoverTitle,
htmlspecialchars($popoverContent, $this->htmlSpecialCharsFlags),
);
}
$lines .= $this->renderLine($singleLineTemplate, $i, $line, $trClass, $popover);
$i++;
}
$linesTemplate->setVar(['lines' => $lines]);
return $linesTemplate->render();
}
private function renderSourceWithPathCoverage(FileNode $node): string
{
$linesTemplate = new Template($this->templatePath . 'lines.html.dist', '{{', '}}');
$singleLineTemplate = new Template($this->templatePath . 'line.html.dist', '{{', '}}');
$functionCoverageData = $node->functionCoverageData();
$testData = $node->testData();
$codeLines = $this->loadFile($node->pathAsString());
$lineData = [];
/** @var int $line */
foreach (array_keys($codeLines) as $line) {
$lineData[$line + 1] = [
'includedInPaths' => [],
'includedInHitPaths' => [],
'tests' => [],
];
}
foreach ($functionCoverageData as $method) {
foreach ($method['paths'] as $pathId => $path) {
foreach ($path['path'] as $branchTaken) {
foreach (range($method['branches'][$branchTaken]['line_start'], $method['branches'][$branchTaken]['line_end']) as $line) {
if (!isset($lineData[$line])) {
continue;
}
$lineData[$line]['includedInPaths'][] = $pathId;
if ($path['hit']) {
$lineData[$line]['includedInHitPaths'][] = $pathId;
$lineData[$line]['tests'] = array_unique(array_merge($lineData[$line]['tests'], $path['hit']));
}
}
}
}
}
$lines = '';
$i = 1;
/** @var string $line */
foreach ($codeLines as $line) {
$trClass = '';
$popover = '';
$includedInPathsCount = count(array_unique($lineData[$i]['includedInPaths']));
$includedInHitPathsCount = count(array_unique($lineData[$i]['includedInHitPaths']));
if ($includedInPathsCount > 0) {
$lineCss = 'success';
if ($includedInHitPathsCount === 0) {
$lineCss = 'danger';
} elseif ($includedInHitPathsCount !== $includedInPathsCount) {
$lineCss = 'warning';
}
$popoverContent = '<ul>';
if (count($lineData[$i]['tests']) === 1) {
$popoverTitle = '1 test covers line ' . $i;
} else {
$popoverTitle = count($lineData[$i]['tests']) . ' tests cover line ' . $i;
}
$popoverTitle .= '. These are covering ' . $includedInHitPathsCount . ' out of the ' . $includedInPathsCount . ' code paths.';
foreach ($lineData[$i]['tests'] as $test) {
$popoverContent .= $this->createPopoverContentForTest($test, $testData[$test]);
}
$popoverContent .= '</ul>';
$trClass = $lineCss . ' popin';
$popover = sprintf(
' data-title="%s" data-content="%s" data-placement="top" data-html="true"',
$popoverTitle,
htmlspecialchars($popoverContent, $this->htmlSpecialCharsFlags),
);
}
$lines .= $this->renderLine($singleLineTemplate, $i, $line, $trClass, $popover);
$i++;
}
$linesTemplate->setVar(['lines' => $lines]);
return $linesTemplate->render();
}
private function renderBranchStructure(FileNode $node): string
{
$branchesTemplate = new Template($this->templatePath . 'branches.html.dist', '{{', '}}');
$coverageData = $node->functionCoverageData();
$testData = $node->testData();
$codeLines = $this->loadFile($node->pathAsString());
$branches = '';
ksort($coverageData);
foreach ($coverageData as $methodName => $methodData) {
if (!$methodData['branches']) {
continue;
}
$branchStructure = '';
foreach ($methodData['branches'] as $branch) {
$branchStructure .= $this->renderBranchLines($branch, $codeLines, $testData);
}
if ($branchStructure !== '') { // don't show empty branches
$branches .= '<h5 class="structure-heading"><a name="' . htmlspecialchars($methodName, $this->htmlSpecialCharsFlags) . '">' . $this->abbreviateMethodName($methodName) . '</a></h5>' . "\n";
$branches .= $branchStructure;
}
}
$branchesTemplate->setVar(['branches' => $branches]);
return $branchesTemplate->render();
}
private function renderBranchLines(array $branch, array $codeLines, array $testData): string
{
$linesTemplate = new Template($this->templatePath . 'lines.html.dist', '{{', '}}');
$singleLineTemplate = new Template($this->templatePath . 'line.html.dist', '{{', '}}');
$lines = '';
$branchLines = range($branch['line_start'], $branch['line_end']);
sort($branchLines); // sometimes end_line < start_line
/** @var int $line */
foreach ($branchLines as $line) {
if (!isset($codeLines[$line])) { // blank line at end of file is sometimes included here
continue;
}
$popoverContent = '';
$popoverTitle = '';
$numTests = count($branch['hit']);
if ($numTests === 0) {
$trClass = 'danger';
} else {
$lineCss = 'covered-by-large-tests';
$popoverContent = '<ul>';
if ($numTests > 1) {
$popoverTitle = $numTests . ' tests cover this branch';
} else {
$popoverTitle = '1 test covers this branch';
}
foreach ($branch['hit'] as $test) {
if ($lineCss === 'covered-by-large-tests' && $testData[$test]['size'] === 'medium') {
$lineCss = 'covered-by-medium-tests';
} elseif ($testData[$test]['size'] === 'small') {
$lineCss = 'covered-by-small-tests';
}
$popoverContent .= $this->createPopoverContentForTest($test, $testData[$test]);
}
$trClass = $lineCss . ' popin';
}
$popover = '';
if (!empty($popoverTitle)) {
$popover = sprintf(
' data-title="%s" data-content="%s" data-placement="top" data-html="true"',
$popoverTitle,
htmlspecialchars($popoverContent, $this->htmlSpecialCharsFlags),
);
}
$lines .= $this->renderLine($singleLineTemplate, $line, $codeLines[$line - 1], $trClass, $popover);
}
if ($lines === '') {
return '';
}
$linesTemplate->setVar(['lines' => $lines]);
return $linesTemplate->render();
}
private function renderPathStructure(FileNode $node): string
{
$pathsTemplate = new Template($this->templatePath . 'paths.html.dist', '{{', '}}');
$coverageData = $node->functionCoverageData();
$testData = $node->testData();
$codeLines = $this->loadFile($node->pathAsString());
$paths = '';
ksort($coverageData);
foreach ($coverageData as $methodName => $methodData) {
if (!$methodData['paths']) {
continue;
}
$pathStructure = '';
if (count($methodData['paths']) > 100) {
$pathStructure .= '<p>' . count($methodData['paths']) . ' is too many paths to sensibly render, consider refactoring your code to bring this number down.</p>';
continue;
}
foreach ($methodData['paths'] as $path) {
$pathStructure .= $this->renderPathLines($path, $methodData['branches'], $codeLines, $testData);
}
if ($pathStructure !== '') {
$paths .= '<h5 class="structure-heading"><a name="' . htmlspecialchars($methodName, $this->htmlSpecialCharsFlags) . '">' . $this->abbreviateMethodName($methodName) . '</a></h5>' . "\n";
$paths .= $pathStructure;
}
}
$pathsTemplate->setVar(['paths' => $paths]);
return $pathsTemplate->render();
}
private function renderPathLines(array $path, array $branches, array $codeLines, array $testData): string
{
$linesTemplate = new Template($this->templatePath . 'lines.html.dist', '{{', '}}');
$singleLineTemplate = new Template($this->templatePath . 'line.html.dist', '{{', '}}');
$lines = '';
$first = true;
foreach ($path['path'] as $branchId) {
if ($first) {
$first = false;
} else {
$lines .= ' <tr><td colspan="2"> </td></tr>' . "\n";
}
$branchLines = range($branches[$branchId]['line_start'], $branches[$branchId]['line_end']);
sort($branchLines); // sometimes end_line < start_line
/** @var int $line */
foreach ($branchLines as $line) {
if (!isset($codeLines[$line])) { // blank line at end of file is sometimes included here
continue;
}
$popoverContent = '';
$popoverTitle = '';
$numTests = count($path['hit']);
if ($numTests === 0) {
$trClass = 'danger';
} else {
$lineCss = 'covered-by-large-tests';
$popoverContent = '<ul>';
if ($numTests > 1) {
$popoverTitle = $numTests . ' tests cover this path';
} else {
$popoverTitle = '1 test covers this path';
}
foreach ($path['hit'] as $test) {
if ($lineCss === 'covered-by-large-tests' && $testData[$test]['size'] === 'medium') {
$lineCss = 'covered-by-medium-tests';
} elseif ($testData[$test]['size'] === 'small') {
$lineCss = 'covered-by-small-tests';
}
$popoverContent .= $this->createPopoverContentForTest($test, $testData[$test]);
}
$trClass = $lineCss . ' popin';
}
$popover = '';
if (!empty($popoverTitle)) {
$popover = sprintf(
' data-title="%s" data-content="%s" data-placement="top" data-html="true"',
$popoverTitle,
htmlspecialchars($popoverContent, $this->htmlSpecialCharsFlags),
);
}
$lines .= $this->renderLine($singleLineTemplate, $line, $codeLines[$line - 1], $trClass, $popover);
}
}
if ($lines === '') {
return '';
}
$linesTemplate->setVar(['lines' => $lines]);
return $linesTemplate->render();
}
private function renderLine(Template $template, int $lineNumber, string $lineContent, string $class, string $popover): string
{
$template->setVar(
[
'lineNumber' => $lineNumber,
'lineContent' => $lineContent,
'class' => $class,
'popover' => $popover,
],
);
return $template->render();
}
private function loadFile(string $file): array
{
if (isset(self::$formattedSourceCache[$file])) {
return self::$formattedSourceCache[$file];
}
$buffer = file_get_contents($file);
$tokens = token_get_all($buffer);
$result = [''];
$i = 0;
$stringFlag = false;
$fileEndsWithNewLine = str_ends_with($buffer, "\n");
unset($buffer);
foreach ($tokens as $j => $token) {
if (is_string($token)) {
if ($token === '"' && $tokens[$j - 1] !== '\\') {
$result[$i] .= sprintf(
'<span class="string">%s</span>',
htmlspecialchars($token, $this->htmlSpecialCharsFlags),
);
$stringFlag = !$stringFlag;
} else {
$result[$i] .= sprintf(
'<span class="keyword">%s</span>',
htmlspecialchars($token, $this->htmlSpecialCharsFlags),
);
}
continue;
}
[$token, $value] = $token;
$value = str_replace(
["\t", ' '],
[' ', ' '],
htmlspecialchars($value, $this->htmlSpecialCharsFlags),
);
if ($value === "\n") {
$result[++$i] = '';
} else {
$lines = explode("\n", $value);
foreach ($lines as $jj => $line) {
$line = trim($line);
if ($line !== '') {
if ($stringFlag) {
$colour = 'string';
} else {
$colour = 'default';
if ($this->isInlineHtml($token)) {
$colour = 'html';
} elseif ($this->isComment($token)) {
$colour = 'comment';
} elseif ($this->isKeyword($token)) {
$colour = 'keyword';
}
}
$result[$i] .= sprintf(
'<span class="%s">%s</span>',
$colour,
$line,
);
}
if (isset($lines[$jj + 1])) {
$result[++$i] = '';
}
}
}
}
if ($fileEndsWithNewLine) {
unset($result[count($result) - 1]);
}
self::$formattedSourceCache[$file] = $result;
return $result;
}
private function abbreviateClassName(string $className): string
{
$tmp = explode('\\', $className);
if (count($tmp) > 1) {
$className = sprintf(
'<abbr title="%s">%s</abbr>',
$className,
array_pop($tmp),
);
}
return $className;
}
private function abbreviateMethodName(string $methodName): string
{
$parts = explode('->', $methodName);
if (count($parts) === 2) {
return $this->abbreviateClassName($parts[0]) . '->' . $parts[1];
}
return $methodName;
}
private function createPopoverContentForTest(string $test, array $testData): string
{
$testCSS = '';
switch ($testData['status']) {
case 'success':
$testCSS = match ($testData['size']) {
'small' => ' class="covered-by-small-tests"',
'medium' => ' class="covered-by-medium-tests"',
// no break
default => ' class="covered-by-large-tests"',
};
break;
case 'failure':
$testCSS = ' class="danger"';
break;
}
return sprintf(
'<li%s>%s</li>',
$testCSS,
htmlspecialchars($test, $this->htmlSpecialCharsFlags),
);
}
private function isComment(int $token): bool
{
return $token === T_COMMENT || $token === T_DOC_COMMENT;
}
private function isInlineHtml(int $token): bool
{
return $token === T_INLINE_HTML;
}
private function isKeyword(int $token): bool
{
return isset(self::KEYWORD_TOKENS[$token]);
}
}
php-code-coverage/src/Report/Html/Renderer.php 0000644 00000023763 15243417753 0015307 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Html;
use function array_pop;
use function count;
use function sprintf;
use function str_repeat;
use function substr_count;
use SebastianBergmann\CodeCoverage\Node\AbstractNode;
use SebastianBergmann\CodeCoverage\Node\Directory as DirectoryNode;
use SebastianBergmann\CodeCoverage\Node\File as FileNode;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\CodeCoverage\Version;
use SebastianBergmann\Environment\Runtime;
use SebastianBergmann\Template\Template;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
abstract class Renderer
{
protected string $templatePath;
protected string $generator;
protected string $date;
protected Thresholds $thresholds;
protected bool $hasBranchCoverage;
protected string $version;
public function __construct(string $templatePath, string $generator, string $date, Thresholds $thresholds, bool $hasBranchCoverage)
{
$this->templatePath = $templatePath;
$this->generator = $generator;
$this->date = $date;
$this->thresholds = $thresholds;
$this->version = Version::id();
$this->hasBranchCoverage = $hasBranchCoverage;
}
protected function renderItemTemplate(Template $template, array $data): string
{
$numSeparator = ' / ';
if (isset($data['numClasses']) && $data['numClasses'] > 0) {
$classesLevel = $this->colorLevel($data['testedClassesPercent']);
$classesNumber = $data['numTestedClasses'] . $numSeparator .
$data['numClasses'];
$classesBar = $this->coverageBar(
$data['testedClassesPercent'],
);
} else {
$classesLevel = '';
$classesNumber = '0' . $numSeparator . '0';
$classesBar = '';
$data['testedClassesPercentAsString'] = 'n/a';
}
if ($data['numMethods'] > 0) {
$methodsLevel = $this->colorLevel($data['testedMethodsPercent']);
$methodsNumber = $data['numTestedMethods'] . $numSeparator .
$data['numMethods'];
$methodsBar = $this->coverageBar(
$data['testedMethodsPercent'],
);
} else {
$methodsLevel = '';
$methodsNumber = '0' . $numSeparator . '0';
$methodsBar = '';
$data['testedMethodsPercentAsString'] = 'n/a';
}
if ($data['numExecutableLines'] > 0) {
$linesLevel = $this->colorLevel($data['linesExecutedPercent']);
$linesNumber = $data['numExecutedLines'] . $numSeparator .
$data['numExecutableLines'];
$linesBar = $this->coverageBar(
$data['linesExecutedPercent'],
);
} else {
$linesLevel = '';
$linesNumber = '0' . $numSeparator . '0';
$linesBar = '';
$data['linesExecutedPercentAsString'] = 'n/a';
}
if ($data['numExecutablePaths'] > 0) {
$pathsLevel = $this->colorLevel($data['pathsExecutedPercent']);
$pathsNumber = $data['numExecutedPaths'] . $numSeparator .
$data['numExecutablePaths'];
$pathsBar = $this->coverageBar(
$data['pathsExecutedPercent'],
);
} else {
$pathsLevel = '';
$pathsNumber = '0' . $numSeparator . '0';
$pathsBar = '';
$data['pathsExecutedPercentAsString'] = 'n/a';
}
if ($data['numExecutableBranches'] > 0) {
$branchesLevel = $this->colorLevel($data['branchesExecutedPercent']);
$branchesNumber = $data['numExecutedBranches'] . $numSeparator .
$data['numExecutableBranches'];
$branchesBar = $this->coverageBar(
$data['branchesExecutedPercent'],
);
} else {
$branchesLevel = '';
$branchesNumber = '0' . $numSeparator . '0';
$branchesBar = '';
$data['branchesExecutedPercentAsString'] = 'n/a';
}
$template->setVar(
[
'icon' => $data['icon'] ?? '',
'crap' => $data['crap'] ?? '',
'name' => $data['name'],
'lines_bar' => $linesBar,
'lines_executed_percent' => $data['linesExecutedPercentAsString'],
'lines_level' => $linesLevel,
'lines_number' => $linesNumber,
'paths_bar' => $pathsBar,
'paths_executed_percent' => $data['pathsExecutedPercentAsString'],
'paths_level' => $pathsLevel,
'paths_number' => $pathsNumber,
'branches_bar' => $branchesBar,
'branches_executed_percent' => $data['branchesExecutedPercentAsString'],
'branches_level' => $branchesLevel,
'branches_number' => $branchesNumber,
'methods_bar' => $methodsBar,
'methods_tested_percent' => $data['testedMethodsPercentAsString'],
'methods_level' => $methodsLevel,
'methods_number' => $methodsNumber,
'classes_bar' => $classesBar,
'classes_tested_percent' => $data['testedClassesPercentAsString'] ?? '',
'classes_level' => $classesLevel,
'classes_number' => $classesNumber,
],
);
return $template->render();
}
protected function setCommonTemplateVariables(Template $template, AbstractNode $node): void
{
$template->setVar(
[
'id' => $node->id(),
'full_path' => $node->pathAsString(),
'path_to_root' => $this->pathToRoot($node),
'breadcrumbs' => $this->breadcrumbs($node),
'date' => $this->date,
'version' => $this->version,
'runtime' => $this->runtimeString(),
'generator' => $this->generator,
'low_upper_bound' => $this->thresholds->lowUpperBound(),
'high_lower_bound' => $this->thresholds->highLowerBound(),
],
);
}
protected function breadcrumbs(AbstractNode $node): string
{
$breadcrumbs = '';
$path = $node->pathAsArray();
$pathToRoot = [];
$max = count($path);
if ($node instanceof FileNode) {
$max--;
}
for ($i = 0; $i < $max; $i++) {
$pathToRoot[] = str_repeat('../', $i);
}
foreach ($path as $step) {
if ($step !== $node) {
$breadcrumbs .= $this->inactiveBreadcrumb(
$step,
array_pop($pathToRoot),
);
} else {
$breadcrumbs .= $this->activeBreadcrumb($step);
}
}
return $breadcrumbs;
}
protected function activeBreadcrumb(AbstractNode $node): string
{
$buffer = sprintf(
' <li class="breadcrumb-item active">%s</li>' . "\n",
$node->name(),
);
if ($node instanceof DirectoryNode) {
$buffer .= ' <li class="breadcrumb-item">(<a href="dashboard.html">Dashboard</a>)</li>' . "\n";
}
return $buffer;
}
protected function inactiveBreadcrumb(AbstractNode $node, string $pathToRoot): string
{
return sprintf(
' <li class="breadcrumb-item"><a href="%sindex.html">%s</a></li>' . "\n",
$pathToRoot,
$node->name(),
);
}
protected function pathToRoot(AbstractNode $node): string
{
$id = $node->id();
$depth = substr_count($id, '/');
if ($id !== 'index' &&
$node instanceof DirectoryNode) {
$depth++;
}
return str_repeat('../', $depth);
}
protected function coverageBar(float $percent): string
{
$level = $this->colorLevel($percent);
$templateName = $this->templatePath . ($this->hasBranchCoverage ? 'coverage_bar_branch.html' : 'coverage_bar.html');
$template = new Template(
$templateName,
'{{',
'}}',
);
$template->setVar(['level' => $level, 'percent' => sprintf('%.2F', $percent)]);
return $template->render();
}
protected function colorLevel(float $percent): string
{
if ($percent <= $this->thresholds->lowUpperBound()) {
return 'danger';
}
if ($percent > $this->thresholds->lowUpperBound() &&
$percent < $this->thresholds->highLowerBound()) {
return 'warning';
}
return 'success';
}
private function runtimeString(): string
{
$runtime = new Runtime;
return sprintf(
'<a href="%s" target="_top">%s %s</a>',
$runtime->getVendorUrl(),
$runtime->getName(),
$runtime->getVersion(),
);
}
}
php-code-coverage/src/Report/Xml/Coverage.php 0000644 00000003373 15243417753 0015123 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMElement;
use SebastianBergmann\CodeCoverage\ReportAlreadyFinalizedException;
use XMLWriter;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Coverage
{
private readonly XMLWriter $writer;
private readonly DOMElement $contextNode;
private bool $finalized = false;
public function __construct(DOMElement $context, string $line)
{
$this->contextNode = $context;
$this->writer = new XMLWriter;
$this->writer->openMemory();
$this->writer->startElementNS(null, $context->nodeName, 'https://schema.phpunit.de/coverage/1.0');
$this->writer->writeAttribute('nr', $line);
}
/**
* @throws ReportAlreadyFinalizedException
*/
public function addTest(string $test): void
{
if ($this->finalized) {
throw new ReportAlreadyFinalizedException;
}
$this->writer->startElement('covered');
$this->writer->writeAttribute('by', $test);
$this->writer->endElement();
}
public function finalize(): void
{
$this->writer->endElement();
$fragment = $this->contextNode->ownerDocument->createDocumentFragment();
$fragment->appendXML($this->writer->outputMemory());
$this->contextNode->parentNode->replaceChild(
$fragment,
$this->contextNode,
);
$this->finalized = true;
}
}
php-code-coverage/src/Report/Xml/BuildInformation.php 0000644 00000004556 15243417753 0016641 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use function phpversion;
use DateTimeImmutable;
use DOMElement;
use SebastianBergmann\Environment\Runtime;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class BuildInformation
{
private readonly DOMElement $contextNode;
public function __construct(DOMElement $contextNode)
{
$this->contextNode = $contextNode;
}
public function setRuntimeInformation(Runtime $runtime): void
{
$runtimeNode = $this->nodeByName('runtime');
$runtimeNode->setAttribute('name', $runtime->getName());
$runtimeNode->setAttribute('version', $runtime->getVersion());
$runtimeNode->setAttribute('url', $runtime->getVendorUrl());
$driverNode = $this->nodeByName('driver');
if ($runtime->hasXdebug()) {
$driverNode->setAttribute('name', 'xdebug');
$driverNode->setAttribute('version', phpversion('xdebug'));
}
if ($runtime->hasPCOV()) {
$driverNode->setAttribute('name', 'pcov');
$driverNode->setAttribute('version', phpversion('pcov'));
}
}
public function setBuildTime(DateTimeImmutable $date): void
{
$this->contextNode->setAttribute('time', $date->format('D M j G:i:s T Y'));
}
public function setGeneratorVersions(string $phpUnitVersion, string $coverageVersion): void
{
$this->contextNode->setAttribute('phpunit', $phpUnitVersion);
$this->contextNode->setAttribute('coverage', $coverageVersion);
}
private function nodeByName(string $name): DOMElement
{
$node = $this->contextNode->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
$name,
)->item(0);
if (!$node) {
$node = $this->contextNode->appendChild(
$this->contextNode->ownerDocument->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
$name,
),
);
}
return $node;
}
}
php-code-coverage/src/Report/Xml/Unit.php 0000644 00000004115 15243417753 0014302 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Unit
{
private readonly DOMElement $contextNode;
public function __construct(DOMElement $context, string $name)
{
$this->contextNode = $context;
$this->setName($name);
}
public function setLines(int $start, int $executable, int $executed): void
{
$this->contextNode->setAttribute('start', (string) $start);
$this->contextNode->setAttribute('executable', (string) $executable);
$this->contextNode->setAttribute('executed', (string) $executed);
}
public function setCrap(float $crap): void
{
$this->contextNode->setAttribute('crap', (string) $crap);
}
public function setNamespace(string $namespace): void
{
$node = $this->contextNode->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'namespace',
)->item(0);
if (!$node) {
$node = $this->contextNode->appendChild(
$this->contextNode->ownerDocument->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'namespace',
),
);
}
$node->setAttribute('name', $namespace);
}
public function addMethod(string $name): Method
{
$node = $this->contextNode->appendChild(
$this->contextNode->ownerDocument->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'method',
),
);
return new Method($node, $name);
}
private function setName(string $name): void
{
$this->contextNode->setAttribute('name', $name);
}
}
php-code-coverage/src/Report/Xml/Directory.php 0000644 00000000737 15243417753 0015335 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Directory extends Node
{
}
php-code-coverage/src/Report/Xml/Node.php 0000644 00000004241 15243417753 0014250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
abstract class Node
{
private DOMDocument $dom;
private DOMElement $contextNode;
public function __construct(DOMElement $context)
{
$this->setContextNode($context);
}
public function dom(): DOMDocument
{
return $this->dom;
}
public function totals(): Totals
{
$totalsContainer = $this->contextNode()->firstChild;
if (!$totalsContainer) {
$totalsContainer = $this->contextNode()->appendChild(
$this->dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'totals',
),
);
}
return new Totals($totalsContainer);
}
public function addDirectory(string $name): Directory
{
$dirNode = $this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'directory',
);
$dirNode->setAttribute('name', $name);
$this->contextNode()->appendChild($dirNode);
return new Directory($dirNode);
}
public function addFile(string $name, string $href): File
{
$fileNode = $this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'file',
);
$fileNode->setAttribute('name', $name);
$fileNode->setAttribute('href', $href);
$this->contextNode()->appendChild($fileNode);
return new File($fileNode);
}
protected function setContextNode(DOMElement $context): void
{
$this->dom = $context->ownerDocument;
$this->contextNode = $context;
}
protected function contextNode(): DOMElement
{
return $this->contextNode;
}
}
php-code-coverage/src/Report/Xml/Source.php 0000644 00000002165 15243417753 0014626 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMElement;
use TheSeer\Tokenizer\NamespaceUri;
use TheSeer\Tokenizer\Tokenizer;
use TheSeer\Tokenizer\XMLSerializer;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Source
{
private readonly DOMElement $context;
public function __construct(DOMElement $context)
{
$this->context = $context;
}
public function setSourceCode(string $source): void
{
$context = $this->context;
$tokens = (new Tokenizer)->parse($source);
$srcDom = (new XMLSerializer(new NamespaceUri($context->namespaceURI)))->toDom($tokens);
$context->parentNode->replaceChild(
$context->ownerDocument->importNode($srcDom->documentElement, true),
$context,
);
}
}
php-code-coverage/src/Report/Xml/Facade.php 0000644 00000021516 15243417753 0014532 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use const DIRECTORY_SEPARATOR;
use const PHP_EOL;
use function count;
use function dirname;
use function file_get_contents;
use function file_put_contents;
use function is_array;
use function is_dir;
use function is_file;
use function is_writable;
use function libxml_clear_errors;
use function libxml_get_errors;
use function libxml_use_internal_errors;
use function sprintf;
use function strlen;
use function substr;
use DateTimeImmutable;
use DOMDocument;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\PathExistsButIsNotDirectoryException;
use SebastianBergmann\CodeCoverage\Driver\WriteOperationFailedException;
use SebastianBergmann\CodeCoverage\Node\AbstractNode;
use SebastianBergmann\CodeCoverage\Node\Directory as DirectoryNode;
use SebastianBergmann\CodeCoverage\Node\File as FileNode;
use SebastianBergmann\CodeCoverage\Util\Filesystem as DirectoryUtil;
use SebastianBergmann\CodeCoverage\Version;
use SebastianBergmann\CodeCoverage\XmlException;
use SebastianBergmann\Environment\Runtime;
final class Facade
{
private string $target;
private Project $project;
private readonly string $phpUnitVersion;
public function __construct(string $version)
{
$this->phpUnitVersion = $version;
}
/**
* @throws XmlException
*/
public function process(CodeCoverage $coverage, string $target): void
{
if (substr($target, -1, 1) !== DIRECTORY_SEPARATOR) {
$target .= DIRECTORY_SEPARATOR;
}
$this->target = $target;
$this->initTargetDirectory($target);
$report = $coverage->getReport();
$this->project = new Project(
$coverage->getReport()->name(),
);
$this->setBuildInformation();
$this->processTests($coverage->getTests());
$this->processDirectory($report, $this->project);
$this->saveDocument($this->project->asDom(), 'index');
}
private function setBuildInformation(): void
{
$buildNode = $this->project->buildInformation();
$buildNode->setRuntimeInformation(new Runtime);
$buildNode->setBuildTime(new DateTimeImmutable);
$buildNode->setGeneratorVersions($this->phpUnitVersion, Version::id());
}
/**
* @throws PathExistsButIsNotDirectoryException
* @throws WriteOperationFailedException
*/
private function initTargetDirectory(string $directory): void
{
if (is_file($directory)) {
if (!is_dir($directory)) {
throw new PathExistsButIsNotDirectoryException($directory);
}
if (!is_writable($directory)) {
throw new WriteOperationFailedException($directory);
}
}
DirectoryUtil::createDirectory($directory);
}
/**
* @throws XmlException
*/
private function processDirectory(DirectoryNode $directory, Node $context): void
{
$directoryName = $directory->name();
if ($this->project->projectSourceDirectory() === $directoryName) {
$directoryName = '/';
}
$directoryObject = $context->addDirectory($directoryName);
$this->setTotals($directory, $directoryObject->totals());
foreach ($directory->directories() as $node) {
$this->processDirectory($node, $directoryObject);
}
foreach ($directory->files() as $node) {
$this->processFile($node, $directoryObject);
}
}
/**
* @throws XmlException
*/
private function processFile(FileNode $file, Directory $context): void
{
$fileObject = $context->addFile(
$file->name(),
$file->id() . '.xml',
);
$this->setTotals($file, $fileObject->totals());
$path = substr(
$file->pathAsString(),
strlen($this->project->projectSourceDirectory()),
);
$fileReport = new Report($path);
$this->setTotals($file, $fileReport->totals());
foreach ($file->classesAndTraits() as $unit) {
$this->processUnit($unit, $fileReport);
}
foreach ($file->functions() as $function) {
$this->processFunction($function, $fileReport);
}
foreach ($file->lineCoverageData() as $line => $tests) {
if (!is_array($tests) || count($tests) === 0) {
continue;
}
$coverage = $fileReport->lineCoverage((string) $line);
foreach ($tests as $test) {
$coverage->addTest($test);
}
$coverage->finalize();
}
$fileReport->source()->setSourceCode(
file_get_contents($file->pathAsString()),
);
$this->saveDocument($fileReport->asDom(), $file->id());
}
private function processUnit(array $unit, Report $report): void
{
if (isset($unit['className'])) {
$unitObject = $report->classObject($unit['className']);
} else {
$unitObject = $report->traitObject($unit['traitName']);
}
$unitObject->setLines(
$unit['startLine'],
$unit['executableLines'],
$unit['executedLines'],
);
$unitObject->setCrap((float) $unit['crap']);
$unitObject->setNamespace($unit['namespace']);
foreach ($unit['methods'] as $method) {
$methodObject = $unitObject->addMethod($method['methodName']);
$methodObject->setSignature($method['signature']);
$methodObject->setLines((string) $method['startLine'], (string) $method['endLine']);
$methodObject->setCrap($method['crap']);
$methodObject->setTotals(
(string) $method['executableLines'],
(string) $method['executedLines'],
(string) $method['coverage'],
);
}
}
private function processFunction(array $function, Report $report): void
{
$functionObject = $report->functionObject($function['functionName']);
$functionObject->setSignature($function['signature']);
$functionObject->setLines((string) $function['startLine']);
$functionObject->setCrap($function['crap']);
$functionObject->setTotals((string) $function['executableLines'], (string) $function['executedLines'], (string) $function['coverage']);
}
private function processTests(array $tests): void
{
$testsObject = $this->project->tests();
foreach ($tests as $test => $result) {
$testsObject->addTest($test, $result);
}
}
private function setTotals(AbstractNode $node, Totals $totals): void
{
$loc = $node->linesOfCode();
$totals->setNumLines(
$loc['linesOfCode'],
$loc['commentLinesOfCode'],
$loc['nonCommentLinesOfCode'],
$node->numberOfExecutableLines(),
$node->numberOfExecutedLines(),
);
$totals->setNumClasses(
$node->numberOfClasses(),
$node->numberOfTestedClasses(),
);
$totals->setNumTraits(
$node->numberOfTraits(),
$node->numberOfTestedTraits(),
);
$totals->setNumMethods(
$node->numberOfMethods(),
$node->numberOfTestedMethods(),
);
$totals->setNumFunctions(
$node->numberOfFunctions(),
$node->numberOfTestedFunctions(),
);
}
private function targetDirectory(): string
{
return $this->target;
}
/**
* @throws XmlException
*/
private function saveDocument(DOMDocument $document, string $name): void
{
$filename = sprintf('%s/%s.xml', $this->targetDirectory(), $name);
$document->formatOutput = true;
$document->preserveWhiteSpace = false;
$this->initTargetDirectory(dirname($filename));
file_put_contents($filename, $this->documentAsString($document));
}
/**
* @throws XmlException
*
* @see https://bugs.php.net/bug.php?id=79191
*/
private function documentAsString(DOMDocument $document): string
{
$xmlErrorHandling = libxml_use_internal_errors(true);
$xml = $document->saveXML();
if ($xml === false) {
$message = 'Unable to generate the XML';
foreach (libxml_get_errors() as $error) {
$message .= PHP_EOL . $error->message;
}
throw new XmlException($message);
}
libxml_clear_errors();
libxml_use_internal_errors($xmlErrorHandling);
return $xml;
}
}
php-code-coverage/src/Report/Xml/Report.php 0000644 00000005070 15243417753 0014637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use function basename;
use function dirname;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Report extends File
{
public function __construct(string $name)
{
$dom = new DOMDocument;
$dom->loadXML('<?xml version="1.0" ?><phpunit xmlns="https://schema.phpunit.de/coverage/1.0"><file /></phpunit>');
$contextNode = $dom->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'file',
)->item(0);
parent::__construct($contextNode);
$this->setName($name);
}
public function asDom(): DOMDocument
{
return $this->dom();
}
public function functionObject($name): Method
{
$node = $this->contextNode()->appendChild(
$this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'function',
),
);
return new Method($node, $name);
}
public function classObject($name): Unit
{
return $this->unitObject('class', $name);
}
public function traitObject($name): Unit
{
return $this->unitObject('trait', $name);
}
public function source(): Source
{
$source = $this->contextNode()->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'source',
)->item(0);
if (!$source) {
$source = $this->contextNode()->appendChild(
$this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'source',
),
);
}
return new Source($source);
}
private function setName(string $name): void
{
$this->contextNode()->setAttribute('name', basename($name));
$this->contextNode()->setAttribute('path', dirname($name));
}
private function unitObject(string $tagName, $name): Unit
{
$node = $this->contextNode()->appendChild(
$this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
$tagName,
),
);
return new Unit($node, $name);
}
}
php-code-coverage/src/Report/Xml/Project.php 0000644 00000004640 15243417753 0014774 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Project extends Node
{
public function __construct(string $directory)
{
$this->init();
$this->setProjectSourceDirectory($directory);
}
public function projectSourceDirectory(): string
{
return $this->contextNode()->getAttribute('source');
}
public function buildInformation(): BuildInformation
{
$buildNode = $this->dom()->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'build',
)->item(0);
if (!$buildNode) {
$buildNode = $this->dom()->documentElement->appendChild(
$this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'build',
),
);
}
return new BuildInformation($buildNode);
}
public function tests(): Tests
{
$testsNode = $this->contextNode()->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'tests',
)->item(0);
if (!$testsNode) {
$testsNode = $this->contextNode()->appendChild(
$this->dom()->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'tests',
),
);
}
return new Tests($testsNode);
}
public function asDom(): DOMDocument
{
return $this->dom();
}
private function init(): void
{
$dom = new DOMDocument;
$dom->loadXML('<?xml version="1.0" ?><phpunit xmlns="https://schema.phpunit.de/coverage/1.0"><build/><project/></phpunit>');
$this->setContextNode(
$dom->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'project',
)->item(0),
);
}
private function setProjectSourceDirectory(string $name): void
{
$this->contextNode()->setAttribute('source', $name);
}
}
php-code-coverage/src/Report/Xml/File.php 0000644 00000004047 15243417753 0014246 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
class File
{
private readonly DOMDocument $dom;
private readonly DOMElement $contextNode;
public function __construct(DOMElement $context)
{
$this->dom = $context->ownerDocument;
$this->contextNode = $context;
}
public function totals(): Totals
{
$totalsContainer = $this->contextNode->firstChild;
if (!$totalsContainer) {
$totalsContainer = $this->contextNode->appendChild(
$this->dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'totals',
),
);
}
return new Totals($totalsContainer);
}
public function lineCoverage(string $line): Coverage
{
$coverage = $this->contextNode->getElementsByTagNameNS(
'https://schema.phpunit.de/coverage/1.0',
'coverage',
)->item(0);
if (!$coverage) {
$coverage = $this->contextNode->appendChild(
$this->dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'coverage',
),
);
}
$lineNode = $coverage->appendChild(
$this->dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'line',
),
);
return new Coverage($lineNode, $line);
}
protected function contextNode(): DOMElement
{
return $this->contextNode;
}
protected function dom(): DOMDocument
{
return $this->dom;
}
}
php-code-coverage/src/Report/Xml/Tests.php 0000644 00000002277 15243417753 0014474 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type TestType from \SebastianBergmann\CodeCoverage\CodeCoverage
*/
final class Tests
{
private readonly DOMElement $contextNode;
public function __construct(DOMElement $context)
{
$this->contextNode = $context;
}
/**
* @param TestType $result
*/
public function addTest(string $test, array $result): void
{
$node = $this->contextNode->appendChild(
$this->contextNode->ownerDocument->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'test',
),
);
$node->setAttribute('name', $test);
$node->setAttribute('size', $result['size']);
$node->setAttribute('status', $result['status']);
}
}
php-code-coverage/src/Report/Xml/Totals.php 0000644 00000010366 15243417753 0014636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use function sprintf;
use DOMElement;
use DOMNode;
use SebastianBergmann\CodeCoverage\Util\Percentage;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Totals
{
private readonly DOMNode $container;
private readonly DOMElement $linesNode;
private readonly DOMElement $methodsNode;
private readonly DOMElement $functionsNode;
private readonly DOMElement $classesNode;
private readonly DOMElement $traitsNode;
public function __construct(DOMElement $container)
{
$this->container = $container;
$dom = $container->ownerDocument;
$this->linesNode = $dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'lines',
);
$this->methodsNode = $dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'methods',
);
$this->functionsNode = $dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'functions',
);
$this->classesNode = $dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'classes',
);
$this->traitsNode = $dom->createElementNS(
'https://schema.phpunit.de/coverage/1.0',
'traits',
);
$container->appendChild($this->linesNode);
$container->appendChild($this->methodsNode);
$container->appendChild($this->functionsNode);
$container->appendChild($this->classesNode);
$container->appendChild($this->traitsNode);
}
public function container(): DOMNode
{
return $this->container;
}
public function setNumLines(int $loc, int $cloc, int $ncloc, int $executable, int $executed): void
{
$this->linesNode->setAttribute('total', (string) $loc);
$this->linesNode->setAttribute('comments', (string) $cloc);
$this->linesNode->setAttribute('code', (string) $ncloc);
$this->linesNode->setAttribute('executable', (string) $executable);
$this->linesNode->setAttribute('executed', (string) $executed);
$this->linesNode->setAttribute(
'percent',
$executable === 0 ? '0' : sprintf('%01.2F', Percentage::fromFractionAndTotal($executed, $executable)->asFloat()),
);
}
public function setNumClasses(int $count, int $tested): void
{
$this->classesNode->setAttribute('count', (string) $count);
$this->classesNode->setAttribute('tested', (string) $tested);
$this->classesNode->setAttribute(
'percent',
$count === 0 ? '0' : sprintf('%01.2F', Percentage::fromFractionAndTotal($tested, $count)->asFloat()),
);
}
public function setNumTraits(int $count, int $tested): void
{
$this->traitsNode->setAttribute('count', (string) $count);
$this->traitsNode->setAttribute('tested', (string) $tested);
$this->traitsNode->setAttribute(
'percent',
$count === 0 ? '0' : sprintf('%01.2F', Percentage::fromFractionAndTotal($tested, $count)->asFloat()),
);
}
public function setNumMethods(int $count, int $tested): void
{
$this->methodsNode->setAttribute('count', (string) $count);
$this->methodsNode->setAttribute('tested', (string) $tested);
$this->methodsNode->setAttribute(
'percent',
$count === 0 ? '0' : sprintf('%01.2F', Percentage::fromFractionAndTotal($tested, $count)->asFloat()),
);
}
public function setNumFunctions(int $count, int $tested): void
{
$this->functionsNode->setAttribute('count', (string) $count);
$this->functionsNode->setAttribute('tested', (string) $tested);
$this->functionsNode->setAttribute(
'percent',
$count === 0 ? '0' : sprintf('%01.2F', Percentage::fromFractionAndTotal($tested, $count)->asFloat()),
);
}
}
php-code-coverage/src/Report/Xml/Method.php 0000644 00000003076 15243417753 0014610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Report\Xml;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class Method
{
private readonly DOMElement $contextNode;
public function __construct(DOMElement $context, string $name)
{
$this->contextNode = $context;
$this->setName($name);
}
public function setSignature(string $signature): void
{
$this->contextNode->setAttribute('signature', $signature);
}
public function setLines(string $start, ?string $end = null): void
{
$this->contextNode->setAttribute('start', $start);
if ($end !== null) {
$this->contextNode->setAttribute('end', $end);
}
}
public function setTotals(string $executable, string $executed, string $coverage): void
{
$this->contextNode->setAttribute('executable', $executable);
$this->contextNode->setAttribute('executed', $executed);
$this->contextNode->setAttribute('coverage', $coverage);
}
public function setCrap(string $crap): void
{
$this->contextNode->setAttribute('crap', $crap);
}
private function setName(string $name): void
{
$this->contextNode->setAttribute('name', $name);
}
}
php-code-coverage/src/Version.php 0000644 00000001231 15243417753 0012771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use function dirname;
use SebastianBergmann\Version as VersionId;
final class Version
{
private static string $version = '';
public static function id(): string
{
if (self::$version === '') {
self::$version = (new VersionId('10.1.14', dirname(__DIR__)))->asString();
}
return self::$version;
}
}
php-code-coverage/src/Filter.php 0000644 00000006264 15243417753 0012604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use function array_keys;
use function is_file;
use function realpath;
use function str_contains;
use function str_starts_with;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
final class Filter
{
/**
* @psalm-var array<string,true>
*/
private array $files = [];
/**
* @psalm-var array<string,bool>
*/
private array $isFileCache = [];
/**
* @deprecated
*/
public function includeDirectory(string $directory, string $suffix = '.php', string $prefix = ''): void
{
foreach ((new FileIteratorFacade)->getFilesAsArray($directory, $suffix, $prefix) as $file) {
$this->includeFile($file);
}
}
/**
* @psalm-param list<string> $files
*/
public function includeFiles(array $filenames): void
{
foreach ($filenames as $filename) {
$this->includeFile($filename);
}
}
public function includeFile(string $filename): void
{
$filename = realpath($filename);
if (!$filename) {
return;
}
$this->files[$filename] = true;
}
/**
* @deprecated
*/
public function excludeDirectory(string $directory, string $suffix = '.php', string $prefix = ''): void
{
foreach ((new FileIteratorFacade)->getFilesAsArray($directory, $suffix, $prefix) as $file) {
$this->excludeFile($file);
}
}
/**
* @deprecated
*/
public function excludeFile(string $filename): void
{
$filename = realpath($filename);
if (!$filename || !isset($this->files[$filename])) {
return;
}
unset($this->files[$filename]);
}
public function isFile(string $filename): bool
{
if (isset($this->isFileCache[$filename])) {
return $this->isFileCache[$filename];
}
if ($filename === '-' ||
str_starts_with($filename, 'vfs://') ||
str_contains($filename, 'xdebug://debug-eval') ||
str_contains($filename, 'eval()\'d code') ||
str_contains($filename, 'runtime-created function') ||
str_contains($filename, 'runkit created function') ||
str_contains($filename, 'assert code') ||
str_contains($filename, 'regexp code') ||
str_contains($filename, 'Standard input code')) {
$isFile = false;
} else {
$isFile = is_file($filename);
}
$this->isFileCache[$filename] = $isFile;
return $isFile;
}
public function isExcluded(string $filename): bool
{
return !isset($this->files[$filename]) || !$this->isFile($filename);
}
/**
* @psalm-return list<string>
*/
public function files(): array
{
return array_keys($this->files);
}
public function isEmpty(): bool
{
return empty($this->files);
}
}
php-code-coverage/src/CodeCoverage.php 0000644 00000042615 15243417753 0013705 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage;
use function array_diff;
use function array_diff_key;
use function array_flip;
use function array_keys;
use function array_merge;
use function array_merge_recursive;
use function array_unique;
use function count;
use function explode;
use function is_array;
use function is_file;
use function sort;
use ReflectionClass;
use SebastianBergmann\CodeCoverage\Data\ProcessedCodeCoverageData;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\Driver\Driver;
use SebastianBergmann\CodeCoverage\Node\Builder;
use SebastianBergmann\CodeCoverage\Node\Directory;
use SebastianBergmann\CodeCoverage\StaticAnalysis\CachingFileAnalyser;
use SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser;
use SebastianBergmann\CodeCoverage\StaticAnalysis\ParsingFileAnalyser;
use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
use SebastianBergmann\CodeCoverage\Test\TestStatus\TestStatus;
use SebastianBergmann\CodeUnitReverseLookup\Wizard;
/**
* Provides collection functionality for PHP code coverage information.
*
* @psalm-type TestType = array{
* size: string,
* status: string,
* }
*/
final class CodeCoverage
{
private const UNCOVERED_FILES = 'UNCOVERED_FILES';
private readonly Driver $driver;
private readonly Filter $filter;
private readonly Wizard $wizard;
private bool $checkForUnintentionallyCoveredCode = false;
private bool $includeUncoveredFiles = true;
private bool $ignoreDeprecatedCode = false;
private ?string $currentId = null;
private ?TestSize $currentSize = null;
private ProcessedCodeCoverageData $data;
private bool $useAnnotationsForIgnoringCode = true;
/**
* @psalm-var array<string,list<int>>
*/
private array $linesToBeIgnored = [];
/**
* @psalm-var array<string, TestType>
*/
private array $tests = [];
/**
* @psalm-var list<class-string>
*/
private array $parentClassesExcludedFromUnintentionallyCoveredCodeCheck = [];
private ?FileAnalyser $analyser = null;
private ?string $cacheDirectory = null;
private ?Directory $cachedReport = null;
public function __construct(Driver $driver, Filter $filter)
{
$this->driver = $driver;
$this->filter = $filter;
$this->data = new ProcessedCodeCoverageData;
$this->wizard = new Wizard;
}
/**
* Returns the code coverage information as a graph of node objects.
*/
public function getReport(): Directory
{
if ($this->cachedReport === null) {
$this->cachedReport = (new Builder($this->analyser()))->build($this);
}
return $this->cachedReport;
}
/**
* Clears collected code coverage data.
*/
public function clear(): void
{
$this->currentId = null;
$this->currentSize = null;
$this->data = new ProcessedCodeCoverageData;
$this->tests = [];
$this->cachedReport = null;
}
/**
* @internal
*/
public function clearCache(): void
{
$this->cachedReport = null;
}
/**
* Returns the filter object used.
*/
public function filter(): Filter
{
return $this->filter;
}
/**
* Returns the collected code coverage data.
*/
public function getData(bool $raw = false): ProcessedCodeCoverageData
{
if (!$raw) {
if ($this->includeUncoveredFiles) {
$this->addUncoveredFilesFromFilter();
}
}
return $this->data;
}
/**
* Sets the coverage data.
*/
public function setData(ProcessedCodeCoverageData $data): void
{
$this->data = $data;
}
/**
* @psalm-return array<string, TestType>
*/
public function getTests(): array
{
return $this->tests;
}
/**
* @psalm-param array<string, TestType> $tests
*/
public function setTests(array $tests): void
{
$this->tests = $tests;
}
public function start(string $id, ?TestSize $size = null, bool $clear = false): void
{
if ($clear) {
$this->clear();
}
$this->currentId = $id;
$this->currentSize = $size;
$this->driver->start();
$this->cachedReport = null;
}
/**
* @psalm-param array<string,list<int>> $linesToBeIgnored
*/
public function stop(bool $append = true, ?TestStatus $status = null, array|false $linesToBeCovered = [], array $linesToBeUsed = [], array $linesToBeIgnored = []): RawCodeCoverageData
{
$data = $this->driver->stop();
$this->linesToBeIgnored = array_merge_recursive(
$this->linesToBeIgnored,
$linesToBeIgnored,
);
$this->append($data, null, $append, $status, $linesToBeCovered, $linesToBeUsed, $linesToBeIgnored);
$this->currentId = null;
$this->currentSize = null;
$this->cachedReport = null;
return $data;
}
/**
* @psalm-param array<string,list<int>> $linesToBeIgnored
*
* @throws ReflectionException
* @throws TestIdMissingException
* @throws UnintentionallyCoveredCodeException
*/
public function append(RawCodeCoverageData $rawData, ?string $id = null, bool $append = true, ?TestStatus $status = null, array|false $linesToBeCovered = [], array $linesToBeUsed = [], array $linesToBeIgnored = []): void
{
if ($id === null) {
$id = $this->currentId;
}
if ($id === null) {
throw new TestIdMissingException;
}
$this->cachedReport = null;
if ($status === null) {
$status = TestStatus::unknown();
}
$size = $this->currentSize;
if ($size === null) {
$size = TestSize::unknown();
}
$this->applyFilter($rawData);
$this->applyExecutableLinesFilter($rawData);
if ($this->useAnnotationsForIgnoringCode) {
$this->applyIgnoredLinesFilter($rawData, $linesToBeIgnored);
}
$this->data->initializeUnseenData($rawData);
if (!$append) {
return;
}
if ($id === self::UNCOVERED_FILES) {
return;
}
$this->applyCoversAndUsesFilter(
$rawData,
$linesToBeCovered,
$linesToBeUsed,
$size,
);
if (empty($rawData->lineCoverage())) {
return;
}
$this->tests[$id] = [
'size' => $size->asString(),
'status' => $status->asString(),
];
$this->data->markCodeAsExecutedByTestCase($id, $rawData);
}
/**
* Merges the data from another instance.
*/
public function merge(self $that): void
{
$this->filter->includeFiles(
$that->filter()->files(),
);
$this->data->merge($that->data);
$this->tests = array_merge($this->tests, $that->getTests());
$this->cachedReport = null;
}
public function enableCheckForUnintentionallyCoveredCode(): void
{
$this->checkForUnintentionallyCoveredCode = true;
}
public function disableCheckForUnintentionallyCoveredCode(): void
{
$this->checkForUnintentionallyCoveredCode = false;
}
public function includeUncoveredFiles(): void
{
$this->includeUncoveredFiles = true;
}
public function excludeUncoveredFiles(): void
{
$this->includeUncoveredFiles = false;
}
public function enableAnnotationsForIgnoringCode(): void
{
$this->useAnnotationsForIgnoringCode = true;
}
public function disableAnnotationsForIgnoringCode(): void
{
$this->useAnnotationsForIgnoringCode = false;
}
public function ignoreDeprecatedCode(): void
{
$this->ignoreDeprecatedCode = true;
}
public function doNotIgnoreDeprecatedCode(): void
{
$this->ignoreDeprecatedCode = false;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function cachesStaticAnalysis(): bool
{
return $this->cacheDirectory !== null;
}
public function cacheStaticAnalysis(string $directory): void
{
$this->cacheDirectory = $directory;
}
public function doNotCacheStaticAnalysis(): void
{
$this->cacheDirectory = null;
}
/**
* @throws StaticAnalysisCacheNotConfiguredException
*/
public function cacheDirectory(): string
{
if (!$this->cachesStaticAnalysis()) {
throw new StaticAnalysisCacheNotConfiguredException(
'The static analysis cache is not configured',
);
}
return $this->cacheDirectory;
}
/**
* @psalm-param class-string $className
*/
public function excludeSubclassesOfThisClassFromUnintentionallyCoveredCodeCheck(string $className): void
{
$this->parentClassesExcludedFromUnintentionallyCoveredCodeCheck[] = $className;
}
public function enableBranchAndPathCoverage(): void
{
$this->driver->enableBranchAndPathCoverage();
}
public function disableBranchAndPathCoverage(): void
{
$this->driver->disableBranchAndPathCoverage();
}
public function collectsBranchAndPathCoverage(): bool
{
return $this->driver->collectsBranchAndPathCoverage();
}
public function detectsDeadCode(): bool
{
return $this->driver->detectsDeadCode();
}
/**
* @throws ReflectionException
* @throws UnintentionallyCoveredCodeException
*/
private function applyCoversAndUsesFilter(RawCodeCoverageData $rawData, array|false $linesToBeCovered, array $linesToBeUsed, TestSize $size): void
{
if ($linesToBeCovered === false) {
$rawData->clear();
return;
}
if (empty($linesToBeCovered)) {
return;
}
if ($this->checkForUnintentionallyCoveredCode && !$size->isMedium() && !$size->isLarge()) {
$this->performUnintentionallyCoveredCodeCheck($rawData, $linesToBeCovered, $linesToBeUsed);
}
$rawLineData = $rawData->lineCoverage();
$filesWithNoCoverage = array_diff_key($rawLineData, $linesToBeCovered);
foreach (array_keys($filesWithNoCoverage) as $fileWithNoCoverage) {
$rawData->removeCoverageDataForFile($fileWithNoCoverage);
}
if (is_array($linesToBeCovered)) {
foreach ($linesToBeCovered as $fileToBeCovered => $includedLines) {
$rawData->keepLineCoverageDataOnlyForLines($fileToBeCovered, $includedLines);
$rawData->keepFunctionCoverageDataOnlyForLines($fileToBeCovered, $includedLines);
}
}
}
private function applyFilter(RawCodeCoverageData $data): void
{
if ($this->filter->isEmpty()) {
return;
}
foreach (array_keys($data->lineCoverage()) as $filename) {
if ($this->filter->isExcluded($filename)) {
$data->removeCoverageDataForFile($filename);
}
}
}
private function applyExecutableLinesFilter(RawCodeCoverageData $data): void
{
foreach (array_keys($data->lineCoverage()) as $filename) {
if (!$this->filter->isFile($filename)) {
continue;
}
$linesToBranchMap = $this->analyser()->executableLinesIn($filename);
$data->keepLineCoverageDataOnlyForLines(
$filename,
array_keys($linesToBranchMap),
);
$data->markExecutableLineByBranch(
$filename,
$linesToBranchMap,
);
}
}
/**
* @psalm-param array<string,list<int>> $linesToBeIgnored
*/
private function applyIgnoredLinesFilter(RawCodeCoverageData $data, array $linesToBeIgnored): void
{
foreach (array_keys($data->lineCoverage()) as $filename) {
if (!$this->filter->isFile($filename)) {
continue;
}
if (isset($linesToBeIgnored[$filename])) {
$data->removeCoverageDataForLines(
$filename,
$linesToBeIgnored[$filename],
);
}
$data->removeCoverageDataForLines(
$filename,
$this->analyser()->ignoredLinesFor($filename),
);
}
}
/**
* @throws UnintentionallyCoveredCodeException
*/
private function addUncoveredFilesFromFilter(): void
{
$uncoveredFiles = array_diff(
$this->filter->files(),
$this->data->coveredFiles(),
);
foreach ($uncoveredFiles as $uncoveredFile) {
if (is_file($uncoveredFile)) {
$this->append(
RawCodeCoverageData::fromUncoveredFile(
$uncoveredFile,
$this->analyser(),
),
self::UNCOVERED_FILES,
linesToBeIgnored: $this->linesToBeIgnored,
);
}
}
}
/**
* @throws ReflectionException
* @throws UnintentionallyCoveredCodeException
*/
private function performUnintentionallyCoveredCodeCheck(RawCodeCoverageData $data, array $linesToBeCovered, array $linesToBeUsed): void
{
$allowedLines = $this->getAllowedLines(
$linesToBeCovered,
$linesToBeUsed,
);
$unintentionallyCoveredUnits = [];
foreach ($data->lineCoverage() as $file => $_data) {
foreach ($_data as $line => $flag) {
if ($flag === 1 && !isset($allowedLines[$file][$line])) {
$unintentionallyCoveredUnits[] = $this->wizard->lookup($file, $line);
}
}
}
$unintentionallyCoveredUnits = $this->processUnintentionallyCoveredUnits($unintentionallyCoveredUnits);
if (!empty($unintentionallyCoveredUnits)) {
throw new UnintentionallyCoveredCodeException(
$unintentionallyCoveredUnits,
);
}
}
private function getAllowedLines(array $linesToBeCovered, array $linesToBeUsed): array
{
$allowedLines = [];
foreach (array_keys($linesToBeCovered) as $file) {
if (!isset($allowedLines[$file])) {
$allowedLines[$file] = [];
}
$allowedLines[$file] = array_merge(
$allowedLines[$file],
$linesToBeCovered[$file],
);
}
foreach (array_keys($linesToBeUsed) as $file) {
if (!isset($allowedLines[$file])) {
$allowedLines[$file] = [];
}
$allowedLines[$file] = array_merge(
$allowedLines[$file],
$linesToBeUsed[$file],
);
}
foreach (array_keys($allowedLines) as $file) {
$allowedLines[$file] = array_flip(
array_unique($allowedLines[$file]),
);
}
return $allowedLines;
}
/**
* @param list<string> $unintentionallyCoveredUnits
*
* @throws ReflectionException
*
* @return list<string>
*/
private function processUnintentionallyCoveredUnits(array $unintentionallyCoveredUnits): array
{
$unintentionallyCoveredUnits = array_unique($unintentionallyCoveredUnits);
$processed = [];
foreach ($unintentionallyCoveredUnits as $unintentionallyCoveredUnit) {
$tmp = explode('::', $unintentionallyCoveredUnit);
if (count($tmp) !== 2) {
$processed[] = $unintentionallyCoveredUnit;
continue;
}
try {
$class = new ReflectionClass($tmp[0]);
foreach ($this->parentClassesExcludedFromUnintentionallyCoveredCodeCheck as $parentClass) {
if ($class->isSubclassOf($parentClass)) {
continue 2;
}
}
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$processed[] = $tmp[0];
}
$processed = array_unique($processed);
sort($processed);
return $processed;
}
private function analyser(): FileAnalyser
{
if ($this->analyser !== null) {
return $this->analyser;
}
$this->analyser = new ParsingFileAnalyser(
$this->useAnnotationsForIgnoringCode,
$this->ignoreDeprecatedCode,
);
if ($this->cachesStaticAnalysis()) {
$this->analyser = new CachingFileAnalyser(
$this->cacheDirectory,
$this->analyser,
$this->useAnnotationsForIgnoringCode,
$this->ignoreDeprecatedCode,
);
}
return $this->analyser;
}
}
php-code-coverage/src/Driver/Selector.php 0000644 00000003407 15243417753 0014366 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use SebastianBergmann\CodeCoverage\Filter;
use SebastianBergmann\CodeCoverage\NoCodeCoverageDriverAvailableException;
use SebastianBergmann\CodeCoverage\NoCodeCoverageDriverWithPathCoverageSupportAvailableException;
use SebastianBergmann\Environment\Runtime;
final class Selector
{
/**
* @throws NoCodeCoverageDriverAvailableException
* @throws PcovNotAvailableException
* @throws XdebugNotAvailableException
* @throws XdebugNotEnabledException
*/
public function forLineCoverage(Filter $filter): Driver
{
$runtime = new Runtime;
if ($runtime->hasPCOV()) {
return new PcovDriver($filter);
}
if ($runtime->hasXdebug()) {
$driver = new XdebugDriver($filter);
$driver->enableDeadCodeDetection();
return $driver;
}
throw new NoCodeCoverageDriverAvailableException;
}
/**
* @throws NoCodeCoverageDriverWithPathCoverageSupportAvailableException
* @throws XdebugNotAvailableException
* @throws XdebugNotEnabledException
*/
public function forLineAndPathCoverage(Filter $filter): Driver
{
if ((new Runtime)->hasXdebug()) {
$driver = new XdebugDriver($filter);
$driver->enableDeadCodeDetection();
$driver->enableBranchAndPathCoverage();
return $driver;
}
throw new NoCodeCoverageDriverWithPathCoverageSupportAvailableException;
}
}
php-code-coverage/src/Driver/Driver.php 0000644 00000006204 15243417753 0014037 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use function sprintf;
use SebastianBergmann\CodeCoverage\BranchAndPathCoverageNotSupportedException;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\DeadCodeDetectionNotSupportedException;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
abstract class Driver
{
/**
* @var int
*
* @see http://xdebug.org/docs/code_coverage
*/
public const LINE_NOT_EXECUTABLE = -2;
/**
* @var int
*
* @see http://xdebug.org/docs/code_coverage
*/
public const LINE_NOT_EXECUTED = -1;
/**
* @var int
*
* @see http://xdebug.org/docs/code_coverage
*/
public const LINE_EXECUTED = 1;
/**
* @var int
*
* @see http://xdebug.org/docs/code_coverage
*/
public const BRANCH_NOT_HIT = 0;
/**
* @var int
*
* @see http://xdebug.org/docs/code_coverage
*/
public const BRANCH_HIT = 1;
private bool $collectBranchAndPathCoverage = false;
private bool $detectDeadCode = false;
public function canCollectBranchAndPathCoverage(): bool
{
return false;
}
public function collectsBranchAndPathCoverage(): bool
{
return $this->collectBranchAndPathCoverage;
}
/**
* @throws BranchAndPathCoverageNotSupportedException
*/
public function enableBranchAndPathCoverage(): void
{
if (!$this->canCollectBranchAndPathCoverage()) {
throw new BranchAndPathCoverageNotSupportedException(
sprintf(
'%s does not support branch and path coverage',
$this->nameAndVersion(),
),
);
}
$this->collectBranchAndPathCoverage = true;
}
public function disableBranchAndPathCoverage(): void
{
$this->collectBranchAndPathCoverage = false;
}
public function canDetectDeadCode(): bool
{
return false;
}
public function detectsDeadCode(): bool
{
return $this->detectDeadCode;
}
/**
* @throws DeadCodeDetectionNotSupportedException
*/
public function enableDeadCodeDetection(): void
{
if (!$this->canDetectDeadCode()) {
throw new DeadCodeDetectionNotSupportedException(
sprintf(
'%s does not support dead code detection',
$this->nameAndVersion(),
),
);
}
$this->detectDeadCode = true;
}
public function disableDeadCodeDetection(): void
{
$this->detectDeadCode = false;
}
abstract public function nameAndVersion(): string;
abstract public function start(): void;
abstract public function stop(): RawCodeCoverageData;
}
php-code-coverage/src/Driver/PcovDriver.php 0000644 00000003731 15243417753 0014671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use const pcov\inclusive;
use function array_intersect;
use function extension_loaded;
use function pcov\clear;
use function pcov\collect;
use function pcov\start;
use function pcov\stop;
use function pcov\waiting;
use function phpversion;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\Filter;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*/
final class PcovDriver extends Driver
{
private readonly Filter $filter;
/**
* @throws PcovNotAvailableException
*/
public function __construct(Filter $filter)
{
$this->ensurePcovIsAvailable();
$this->filter = $filter;
}
public function start(): void
{
start();
}
public function stop(): RawCodeCoverageData
{
stop();
$filesToCollectCoverageFor = waiting();
$collected = [];
if ($filesToCollectCoverageFor) {
if (!$this->filter->isEmpty()) {
$filesToCollectCoverageFor = array_intersect($filesToCollectCoverageFor, $this->filter->files());
}
$collected = collect(inclusive, $filesToCollectCoverageFor);
clear();
}
return RawCodeCoverageData::fromXdebugWithoutPathCoverage($collected);
}
public function nameAndVersion(): string
{
return 'PCOV ' . phpversion('pcov');
}
/**
* @throws PcovNotAvailableException
*/
private function ensurePcovIsAvailable(): void
{
if (!extension_loaded('pcov')) {
throw new PcovNotAvailableException;
}
}
}
php-code-coverage/src/Driver/XdebugDriver.php 0000644 00000011075 15243417753 0015200 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Driver;
use const XDEBUG_CC_BRANCH_CHECK;
use const XDEBUG_CC_DEAD_CODE;
use const XDEBUG_CC_UNUSED;
use const XDEBUG_FILTER_CODE_COVERAGE;
use const XDEBUG_PATH_INCLUDE;
use function explode;
use function extension_loaded;
use function getenv;
use function in_array;
use function ini_get;
use function phpversion;
use function version_compare;
use function xdebug_get_code_coverage;
use function xdebug_info;
use function xdebug_set_filter;
use function xdebug_start_code_coverage;
use function xdebug_stop_code_coverage;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\Filter;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @see https://xdebug.org/docs/code_coverage#xdebug_get_code_coverage
*
* @psalm-type XdebugLinesCoverageType = array<int, int>
* @psalm-type XdebugBranchCoverageType = array{
* op_start: int,
* op_end: int,
* line_start: int,
* line_end: int,
* hit: int,
* out: array<int, int>,
* out_hit: array<int, int>,
* }
* @psalm-type XdebugPathCoverageType = array{
* path: array<int, int>,
* hit: int,
* }
* @psalm-type XdebugFunctionCoverageType = array{
* branches: array<int, XdebugBranchCoverageType>,
* paths: array<int, XdebugPathCoverageType>,
* }
* @psalm-type XdebugFunctionsCoverageType = array<string, XdebugFunctionCoverageType>
* @psalm-type XdebugPathAndBranchesCoverageType = array{
* lines: XdebugLinesCoverageType,
* functions: XdebugFunctionsCoverageType,
* }
* @psalm-type XdebugCodeCoverageWithoutPathCoverageType = array<string, XdebugLinesCoverageType>
* @psalm-type XdebugCodeCoverageWithPathCoverageType = array<string, XdebugPathAndBranchesCoverageType>
*/
final class XdebugDriver extends Driver
{
/**
* @throws XdebugNotAvailableException
* @throws XdebugNotEnabledException
*/
public function __construct(Filter $filter)
{
$this->ensureXdebugIsAvailable();
$this->ensureXdebugCodeCoverageFeatureIsEnabled();
if (!$filter->isEmpty()) {
xdebug_set_filter(
XDEBUG_FILTER_CODE_COVERAGE,
XDEBUG_PATH_INCLUDE,
$filter->files(),
);
}
}
public function canCollectBranchAndPathCoverage(): bool
{
return true;
}
public function canDetectDeadCode(): bool
{
return true;
}
public function start(): void
{
$flags = XDEBUG_CC_UNUSED;
if ($this->detectsDeadCode() || $this->collectsBranchAndPathCoverage()) {
$flags |= XDEBUG_CC_DEAD_CODE;
}
if ($this->collectsBranchAndPathCoverage()) {
$flags |= XDEBUG_CC_BRANCH_CHECK;
}
xdebug_start_code_coverage($flags);
}
public function stop(): RawCodeCoverageData
{
$data = xdebug_get_code_coverage();
xdebug_stop_code_coverage();
if ($this->collectsBranchAndPathCoverage()) {
/* @var XdebugCodeCoverageWithPathCoverageType $data */
return RawCodeCoverageData::fromXdebugWithPathCoverage($data);
}
/* @var XdebugCodeCoverageWithoutPathCoverageType $data */
return RawCodeCoverageData::fromXdebugWithoutPathCoverage($data);
}
public function nameAndVersion(): string
{
return 'Xdebug ' . phpversion('xdebug');
}
/**
* @throws XdebugNotAvailableException
*/
private function ensureXdebugIsAvailable(): void
{
if (!extension_loaded('xdebug')) {
throw new XdebugNotAvailableException;
}
}
/**
* @throws XdebugNotEnabledException
*/
private function ensureXdebugCodeCoverageFeatureIsEnabled(): void
{
if (version_compare(phpversion('xdebug'), '3.1', '>=')) {
if (!in_array('coverage', xdebug_info('mode'), true)) {
throw new XdebugNotEnabledException;
}
return;
}
$mode = getenv('XDEBUG_MODE');
if ($mode === false || $mode === '') {
$mode = ini_get('xdebug.mode');
}
if ($mode === false ||
!in_array('coverage', explode(',', $mode), true)) {
throw new XdebugNotEnabledException;
}
}
}
php-code-coverage/src/Data/RawCodeCoverageData.php 0000644 00000022123 15243417753 0016012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Data;
use function array_diff;
use function array_diff_key;
use function array_flip;
use function array_intersect;
use function array_intersect_key;
use function count;
use function explode;
use function file_get_contents;
use function in_array;
use function is_file;
use function preg_replace;
use function range;
use function str_ends_with;
use function str_starts_with;
use function trim;
use SebastianBergmann\CodeCoverage\Driver\Driver;
use SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type XdebugFunctionsCoverageType from \SebastianBergmann\CodeCoverage\Driver\XdebugDriver
* @psalm-import-type XdebugCodeCoverageWithoutPathCoverageType from \SebastianBergmann\CodeCoverage\Driver\XdebugDriver
* @psalm-import-type XdebugCodeCoverageWithPathCoverageType from \SebastianBergmann\CodeCoverage\Driver\XdebugDriver
*/
final class RawCodeCoverageData
{
/**
* @var array<string, array<int>>
*/
private static array $emptyLineCache = [];
/**
* @psalm-var XdebugCodeCoverageWithoutPathCoverageType
*/
private array $lineCoverage;
/**
* @psalm-var array<string, XdebugFunctionsCoverageType>
*/
private array $functionCoverage;
/**
* @psalm-param XdebugCodeCoverageWithoutPathCoverageType $rawCoverage
*/
public static function fromXdebugWithoutPathCoverage(array $rawCoverage): self
{
return new self($rawCoverage, []);
}
/**
* @psalm-param XdebugCodeCoverageWithPathCoverageType $rawCoverage
*/
public static function fromXdebugWithPathCoverage(array $rawCoverage): self
{
$lineCoverage = [];
$functionCoverage = [];
foreach ($rawCoverage as $file => $fileCoverageData) {
// Xdebug annotates the function name of traits, strip that off
foreach ($fileCoverageData['functions'] as $existingKey => $data) {
if (str_ends_with($existingKey, '}') && !str_starts_with($existingKey, '{')) { // don't want to catch {main}
$newKey = preg_replace('/\{.*}$/', '', $existingKey);
$fileCoverageData['functions'][$newKey] = $data;
unset($fileCoverageData['functions'][$existingKey]);
}
}
$lineCoverage[$file] = $fileCoverageData['lines'];
$functionCoverage[$file] = $fileCoverageData['functions'];
}
return new self($lineCoverage, $functionCoverage);
}
public static function fromUncoveredFile(string $filename, FileAnalyser $analyser): self
{
$lineCoverage = [];
foreach ($analyser->executableLinesIn($filename) as $line => $branch) {
$lineCoverage[$line] = Driver::LINE_NOT_EXECUTED;
}
return new self([$filename => $lineCoverage], []);
}
/**
* @psalm-param XdebugCodeCoverageWithoutPathCoverageType $lineCoverage
* @psalm-param array<string, XdebugFunctionsCoverageType> $functionCoverage
*/
private function __construct(array $lineCoverage, array $functionCoverage)
{
$this->lineCoverage = $lineCoverage;
$this->functionCoverage = $functionCoverage;
$this->skipEmptyLines();
}
public function clear(): void
{
$this->lineCoverage = $this->functionCoverage = [];
}
/**
* @psalm-return XdebugCodeCoverageWithoutPathCoverageType
*/
public function lineCoverage(): array
{
return $this->lineCoverage;
}
/**
* @psalm-return array<string, XdebugFunctionsCoverageType>
*/
public function functionCoverage(): array
{
return $this->functionCoverage;
}
public function removeCoverageDataForFile(string $filename): void
{
unset($this->lineCoverage[$filename], $this->functionCoverage[$filename]);
}
/**
* @param int[] $lines
*/
public function keepLineCoverageDataOnlyForLines(string $filename, array $lines): void
{
if (!isset($this->lineCoverage[$filename])) {
return;
}
$this->lineCoverage[$filename] = array_intersect_key(
$this->lineCoverage[$filename],
array_flip($lines),
);
}
/**
* @param int[] $linesToBranchMap
*/
public function markExecutableLineByBranch(string $filename, array $linesToBranchMap): void
{
if (!isset($this->lineCoverage[$filename])) {
return;
}
$linesByBranch = [];
foreach ($linesToBranchMap as $line => $branch) {
$linesByBranch[$branch][] = $line;
}
foreach ($this->lineCoverage[$filename] as $line => $lineStatus) {
if (!isset($linesToBranchMap[$line])) {
continue;
}
$branch = $linesToBranchMap[$line];
if (!isset($linesByBranch[$branch])) {
continue;
}
foreach ($linesByBranch[$branch] as $lineInBranch) {
$this->lineCoverage[$filename][$lineInBranch] = $lineStatus;
}
if (Driver::LINE_EXECUTED === $lineStatus) {
unset($linesByBranch[$branch]);
}
}
}
/**
* @param int[] $lines
*/
public function keepFunctionCoverageDataOnlyForLines(string $filename, array $lines): void
{
if (!isset($this->functionCoverage[$filename])) {
return;
}
foreach ($this->functionCoverage[$filename] as $functionName => $functionData) {
foreach ($functionData['branches'] as $branchId => $branch) {
if (count(array_diff(range($branch['line_start'], $branch['line_end']), $lines)) > 0) {
unset($this->functionCoverage[$filename][$functionName]['branches'][$branchId]);
foreach ($functionData['paths'] as $pathId => $path) {
if (in_array($branchId, $path['path'], true)) {
unset($this->functionCoverage[$filename][$functionName]['paths'][$pathId]);
}
}
}
}
}
}
/**
* @param int[] $lines
*/
public function removeCoverageDataForLines(string $filename, array $lines): void
{
if (empty($lines)) {
return;
}
if (!isset($this->lineCoverage[$filename])) {
return;
}
$this->lineCoverage[$filename] = array_diff_key(
$this->lineCoverage[$filename],
array_flip($lines),
);
if (isset($this->functionCoverage[$filename])) {
foreach ($this->functionCoverage[$filename] as $functionName => $functionData) {
foreach ($functionData['branches'] as $branchId => $branch) {
if (count(array_intersect($lines, range($branch['line_start'], $branch['line_end']))) > 0) {
unset($this->functionCoverage[$filename][$functionName]['branches'][$branchId]);
foreach ($functionData['paths'] as $pathId => $path) {
if (in_array($branchId, $path['path'], true)) {
unset($this->functionCoverage[$filename][$functionName]['paths'][$pathId]);
}
}
}
}
}
}
}
/**
* At the end of a file, the PHP interpreter always sees an implicit return. Where this occurs in a file that has
* e.g. a class definition, that line cannot be invoked from a test and results in confusing coverage. This engine
* implementation detail therefore needs to be masked which is done here by simply ensuring that all empty lines
* are skipped over for coverage purposes.
*
* @see https://github.com/sebastianbergmann/php-code-coverage/issues/799
*/
private function skipEmptyLines(): void
{
foreach ($this->lineCoverage as $filename => $coverage) {
foreach ($this->getEmptyLinesForFile($filename) as $emptyLine) {
unset($this->lineCoverage[$filename][$emptyLine]);
}
}
}
private function getEmptyLinesForFile(string $filename): array
{
if (!isset(self::$emptyLineCache[$filename])) {
self::$emptyLineCache[$filename] = [];
if (is_file($filename)) {
$sourceLines = explode("\n", file_get_contents($filename));
foreach ($sourceLines as $line => $source) {
if (trim($source) === '') {
self::$emptyLineCache[$filename][] = ($line + 1);
}
}
}
}
return self::$emptyLineCache[$filename];
}
}
php-code-coverage/src/Data/ProcessedCodeCoverageData.php 0000644 00000023773 15243417753 0017224 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-code-coverage.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\CodeCoverage\Data;
use function array_key_exists;
use function array_keys;
use function array_merge;
use function array_unique;
use function count;
use function is_array;
use function ksort;
use SebastianBergmann\CodeCoverage\Driver\Driver;
/**
* @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage
*
* @psalm-import-type XdebugFunctionCoverageType from \SebastianBergmann\CodeCoverage\Driver\XdebugDriver
*
* @psalm-type TestIdType = string
*/
final class ProcessedCodeCoverageData
{
/**
* Line coverage data.
* An array of filenames, each having an array of linenumbers, each executable line having an array of testcase ids.
*
* @psalm-var array<string, array<int, null|list<TestIdType>>>
*/
private array $lineCoverage = [];
/**
* Function coverage data.
* Maintains base format of raw data (@see https://xdebug.org/docs/code_coverage), but each 'hit' entry is an array
* of testcase ids.
*
* @psalm-var array<string, array<string, array{
* branches: array<int, array{
* op_start: int,
* op_end: int,
* line_start: int,
* line_end: int,
* hit: list<TestIdType>,
* out: array<int, int>,
* out_hit: array<int, int>,
* }>,
* paths: array<int, array{
* path: array<int, int>,
* hit: list<TestIdType>,
* }>,
* hit: list<TestIdType>
* }>>
*/
private array $functionCoverage = [];
public function initializeUnseenData(RawCodeCoverageData $rawData): void
{
foreach ($rawData->lineCoverage() as $file => $lines) {
if (!isset($this->lineCoverage[$file])) {
$this->lineCoverage[$file] = [];
foreach ($lines as $k => $v) {
$this->lineCoverage[$file][$k] = $v === Driver::LINE_NOT_EXECUTABLE ? null : [];
}
}
}
foreach ($rawData->functionCoverage() as $file => $functions) {
foreach ($functions as $functionName => $functionData) {
if (isset($this->functionCoverage[$file][$functionName])) {
$this->initPreviouslySeenFunction($file, $functionName, $functionData);
} else {
$this->initPreviouslyUnseenFunction($file, $functionName, $functionData);
}
}
}
}
public function markCodeAsExecutedByTestCase(string $testCaseId, RawCodeCoverageData $executedCode): void
{
foreach ($executedCode->lineCoverage() as $file => $lines) {
foreach ($lines as $k => $v) {
if ($v === Driver::LINE_EXECUTED) {
$this->lineCoverage[$file][$k][] = $testCaseId;
}
}
}
foreach ($executedCode->functionCoverage() as $file => $functions) {
foreach ($functions as $functionName => $functionData) {
foreach ($functionData['branches'] as $branchId => $branchData) {
if ($branchData['hit'] === Driver::BRANCH_HIT) {
$this->functionCoverage[$file][$functionName]['branches'][$branchId]['hit'][] = $testCaseId;
}
}
foreach ($functionData['paths'] as $pathId => $pathData) {
if ($pathData['hit'] === Driver::BRANCH_HIT) {
$this->functionCoverage[$file][$functionName]['paths'][$pathId]['hit'][] = $testCaseId;
}
}
}
}
}
public function setLineCoverage(array $lineCoverage): void
{
$this->lineCoverage = $lineCoverage;
}
public function lineCoverage(): array
{
ksort($this->lineCoverage);
return $this->lineCoverage;
}
public function setFunctionCoverage(array $functionCoverage): void
{
$this->functionCoverage = $functionCoverage;
}
public function functionCoverage(): array
{
ksort($this->functionCoverage);
return $this->functionCoverage;
}
public function coveredFiles(): array
{
ksort($this->lineCoverage);
return array_keys($this->lineCoverage);
}
public function renameFile(string $oldFile, string $newFile): void
{
$this->lineCoverage[$newFile] = $this->lineCoverage[$oldFile];
if (isset($this->functionCoverage[$oldFile])) {
$this->functionCoverage[$newFile] = $this->functionCoverage[$oldFile];
}
unset($this->lineCoverage[$oldFile], $this->functionCoverage[$oldFile]);
}
public function merge(self $newData): void
{
foreach ($newData->lineCoverage as $file => $lines) {
if (!isset($this->lineCoverage[$file])) {
$this->lineCoverage[$file] = $lines;
continue;
}
// we should compare the lines if any of two contains data
$compareLineNumbers = array_unique(
array_merge(
array_keys($this->lineCoverage[$file]),
array_keys($newData->lineCoverage[$file]),
),
);
foreach ($compareLineNumbers as $line) {
$thatPriority = $this->priorityForLine($newData->lineCoverage[$file], $line);
$thisPriority = $this->priorityForLine($this->lineCoverage[$file], $line);
if ($thatPriority > $thisPriority) {
$this->lineCoverage[$file][$line] = $newData->lineCoverage[$file][$line];
} elseif ($thatPriority === $thisPriority && is_array($this->lineCoverage[$file][$line])) {
$this->lineCoverage[$file][$line] = array_unique(
array_merge($this->lineCoverage[$file][$line], $newData->lineCoverage[$file][$line]),
);
}
}
}
foreach ($newData->functionCoverage as $file => $functions) {
if (!isset($this->functionCoverage[$file])) {
$this->functionCoverage[$file] = $functions;
continue;
}
foreach ($functions as $functionName => $functionData) {
if (isset($this->functionCoverage[$file][$functionName])) {
$this->initPreviouslySeenFunction($file, $functionName, $functionData);
} else {
$this->initPreviouslyUnseenFunction($file, $functionName, $functionData);
}
foreach ($functionData['branches'] as $branchId => $branchData) {
$this->functionCoverage[$file][$functionName]['branches'][$branchId]['hit'] = array_unique(array_merge($this->functionCoverage[$file][$functionName]['branches'][$branchId]['hit'], $branchData['hit']));
}
foreach ($functionData['paths'] as $pathId => $pathData) {
$this->functionCoverage[$file][$functionName]['paths'][$pathId]['hit'] = array_unique(array_merge($this->functionCoverage[$file][$functionName]['paths'][$pathId]['hit'], $pathData['hit']));
}
}
}
}
/**
* Determine the priority for a line.
*
* 1 = the line is not set
* 2 = the line has not been tested
* 3 = the line is dead code
* 4 = the line has been tested
*
* During a merge, a higher number is better.
*/
private function priorityForLine(array $data, int $line): int
{
if (!array_key_exists($line, $data)) {
return 1;
}
if (is_array($data[$line]) && count($data[$line]) === 0) {
return 2;
}
if ($data[$line] === null) {
return 3;
}
return 4;
}
/**
* For a function we have never seen before, copy all data over and simply init the 'hit' array.
*
* @psalm-param XdebugFunctionCoverageType $functionData
*/
private function initPreviouslyUnseenFunction(string $file, string $functionName, array $functionData): void
{
$this->functionCoverage[$file][$functionName] = $functionData;
foreach (array_keys($functionData['branches']) as $branchId) {
$this->functionCoverage[$file][$functionName]['branches'][$branchId]['hit'] = [];
}
foreach (array_keys($functionData['paths']) as $pathId) {
$this->functionCoverage[$file][$functionName]['paths'][$pathId]['hit'] = [];
}
}
/**
* For a function we have seen before, only copy over and init the 'hit' array for any unseen branches and paths.
* Techniques such as mocking and where the contents of a file are different vary during tests (e.g. compiling
* containers) mean that the functions inside a file cannot be relied upon to be static.
*
* @psalm-param XdebugFunctionCoverageType $functionData
*/
private function initPreviouslySeenFunction(string $file, string $functionName, array $functionData): void
{
foreach ($functionData['branches'] as $branchId => $branchData) {
if (!isset($this->functionCoverage[$file][$functionName]['branches'][$branchId])) {
$this->functionCoverage[$file][$functionName]['branches'][$branchId] = $branchData;
$this->functionCoverage[$file][$functionName]['branches'][$branchId]['hit'] = [];
}
}
foreach ($functionData['paths'] as $pathId => $pathData) {
if (!isset($this->functionCoverage[$file][$functionName]['paths'][$pathId])) {
$this->functionCoverage[$file][$functionName]['paths'][$pathId] = $pathData;
$this->functionCoverage[$file][$functionName]['paths'][$pathId]['hit'] = [];
}
}
}
}
php-code-coverage/SECURITY.md 0000644 00000003565 15243417753 0011651 0 ustar 00 # Security Policy
If you believe you have found a security vulnerability in the library that is developed in this repository, please report it to us through coordinated disclosure.
**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**
Instead, please email `sebastian@phpunit.de`.
Please include as much of the information listed below as you can to help us better understand and resolve the issue:
* The type of issue
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
## Web Context
The library that is developed in this repository was either extracted from [PHPUnit](https://github.com/sebastianbergmann/phpunit) or developed specifically as a dependency for PHPUnit.
The library is developed with a focus on development environments and the command-line. No specific testing or hardening with regard to using the library in an HTTP or web context or with untrusted input data is performed. The library might also contain functionality that intentionally exposes internal application data for debugging purposes.
If the library is used in a web application, the application developer is responsible for filtering inputs or escaping outputs as necessary and for verifying that the used functionality is safe for use within the intended context.
Vulnerabilities specific to the use outside a development context will be fixed as applicable, provided that the fix does not have an averse effect on the primary use case for development purposes.
php-code-coverage/build/scripts/extract-release-notes.php 0000755 00000001570 15243417753 0017572 0 ustar 00 #!/usr/bin/env php
<?php declare(strict_types=1);
if ($argc !== 2) {
print $argv[0] . ' <tag>' . PHP_EOL;
exit(1);
}
$version = $argv[1];
$versionSeries = explode('.', $version)[0] . '.' . explode('.', $version)[1];
$file = __DIR__ . '/../../ChangeLog-' . $versionSeries . '.md';
if (!is_file($file) || !is_readable($file)) {
print $file . ' cannot be read' . PHP_EOL;
exit(1);
}
$buffer = '';
$append = false;
foreach (file($file) as $line) {
if (str_starts_with($line, '## [' . $version . ']')) {
$append = true;
continue;
}
if ($append && (str_starts_with($line, '## ') || str_starts_with($line, '['))) {
break;
}
if ($append) {
$buffer .= $line;
}
}
$buffer = trim($buffer);
if ($buffer === '') {
print 'Unable to extract release notes' . PHP_EOL;
exit(1);
}
print $buffer . PHP_EOL;
php-code-coverage/ChangeLog-10.1.md 0000644 00000010426 15243417753 0012600 0 ustar 00 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
## [10.1.14] - 2024-03-12
### Fixed
* [#1033](https://github.com/sebastianbergmann/php-code-coverage/issues/1033): `@codeCoverageIgnore` annotation does not work on `enum`
## [10.1.13] - 2024-03-09
### Changed
* [#1032](https://github.com/sebastianbergmann/php-code-coverage/pull/1032): Pad lines in code coverage report only when colors are shown
## [10.1.12] - 2024-03-02
### Changed
* Do not use implicitly nullable parameters
## [10.1.11] - 2023-12-21
### Changed
* This component is now compatible with `nikic/php-parser` 5.0
## [10.1.10] - 2023-12-11
### Fixed
* [#1023](https://github.com/sebastianbergmann/php-code-coverage/issues/1023): Branch Coverage and Path Coverage are not correctly reported for traits
## [10.1.9] - 2023-11-23
### Fixed
* [#1020](https://github.com/sebastianbergmann/php-code-coverage/issues/1020): Single line method is ignored
## [10.1.8] - 2023-11-15
### Fixed
* [#1018](https://github.com/sebastianbergmann/php-code-coverage/issues/1018): Interface methods are not ignored when their signature is split over multiple lines
## [10.1.7] - 2023-10-04
### Fixed
* [#1014](https://github.com/sebastianbergmann/php-code-coverage/issues/1014): Incorrect statement count in coverage report for constructor property promotion
## [10.1.6] - 2023-09-19
### Fixed
* [#1012](https://github.com/sebastianbergmann/php-code-coverage/issues/1012): Cobertura report pulls functions from report scope, not the individual element
## [10.1.5] - 2023-09-12
### Changed
* [#1011](https://github.com/sebastianbergmann/php-code-coverage/pull/1011): Avoid serialization of cache data in PHP report
## [10.1.4] - 2023-08-31
### Fixed
* Exceptions of type `SebastianBergmann\Template\Exception` are now properly handled
## [10.1.3] - 2023-07-26
### Changed
* The result of `CodeCoverage::getReport()` is now cached
### Fixed
* Static analysis cache keys do not include configuration settings that affect source code parsing
* The Clover, Cobertura, Crap4j, and PHP report writers no longer create a `php:` directory when they should write to `php://stdout`, for instance
## [10.1.2] - 2023-05-22
### Fixed
* [#998](https://github.com/sebastianbergmann/php-code-coverage/pull/998): Group Use Declarations are not handled properly
## [10.1.1] - 2023-04-17
### Fixed
* [#994](https://github.com/sebastianbergmann/php-code-coverage/issues/994): Argument `$linesToBeIgnored` of `CodeCoverage::stop()` has no effect for files that are not executed at all
## [10.1.0] - 2023-04-13
### Added
* [#982](https://github.com/sebastianbergmann/php-code-coverage/issues/982): Add option to ignore lines from code coverage
### Deprecated
* The `SebastianBergmann\CodeCoverage\Filter::includeDirectory()`, `SebastianBergmann\CodeCoverage\Filter::excludeDirectory()`, and `SebastianBergmann\CodeCoverage\Filter::excludeFile()` methods are now deprecated
[10.1.14]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.13...10.1.14
[10.1.13]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.12...10.1.13
[10.1.12]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.11...10.1.12
[10.1.11]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.10...10.1.11
[10.1.10]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.9...10.1.10
[10.1.9]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.8...10.1.9
[10.1.8]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.7...10.1.8
[10.1.7]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.6...10.1.7
[10.1.6]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.5...10.1.6
[10.1.5]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.4...10.1.5
[10.1.4]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.3...10.1.4
[10.1.3]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.2...10.1.3
[10.1.2]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.1...10.1.2
[10.1.1]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.1.0...10.1.1
[10.1.0]: https://github.com/sebastianbergmann/php-code-coverage/compare/10.0.2...10.1.0
php-code-coverage/composer.json 0000644 00000003715 15243417753 0012577 0 ustar 00 {
"name": "phpunit/php-code-coverage",
"description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.",
"type": "library",
"keywords": [
"coverage",
"testing",
"xunit"
],
"homepage": "https://github.com/sebastianbergmann/php-code-coverage",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-code-coverage/issues",
"security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"prefer-stable": true,
"require": {
"php": ">=8.1",
"ext-dom": "*",
"ext-libxml": "*",
"ext-xmlwriter": "*",
"nikic/php-parser": "^4.18 || ^5.0",
"phpunit/php-file-iterator": "^4.0",
"phpunit/php-text-template": "^3.0",
"sebastian/code-unit-reverse-lookup": "^3.0",
"sebastian/complexity": "^3.0",
"sebastian/environment": "^6.0",
"sebastian/lines-of-code": "^2.0",
"sebastian/version": "^4.0",
"theseer/tokenizer": "^1.2.0"
},
"require-dev": {
"phpunit/phpunit": "^10.1"
},
"suggest": {
"ext-pcov": "PHP extension that provides line coverage",
"ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage"
},
"autoload": {
"classmap": [
"src/"
]
},
"autoload-dev": {
"files": [
"tests/TestCase.php",
"tests/_files/BankAccountTest.php"
]
},
"extra": {
"branch-alias": {
"dev-main": "10.1-dev"
}
}
}
php-code-coverage/README.md 0000644 00000003360 15243417753 0011330 0 ustar 00 # phpunit/php-code-coverage
[](https://packagist.org/packages/phpunit/php-code-coverage)
[](https://github.com/sebastianbergmann/php-code-coverage/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-code-coverage)
[](https://codecov.io/gh/sebastianbergmann/php-code-coverage)
Provides collection, processing, and rendering functionality for PHP code coverage information.
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
```
composer require phpunit/php-code-coverage
```
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
```
composer require --dev phpunit/php-code-coverage
```
## Usage
```php
<?php declare(strict_types=1);
use SebastianBergmann\CodeCoverage\Filter;
use SebastianBergmann\CodeCoverage\Driver\Selector;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Report\Html\Facade as HtmlReport;
$filter = new Filter;
$filter->includeFiles(
[
'/path/to/file.php',
'/path/to/another_file.php',
]
);
$coverage = new CodeCoverage(
(new Selector)->forLineCoverage($filter),
$filter
);
$coverage->start('<name of test>');
// ...
$coverage->stop();
(new HtmlReport)->process($coverage, '/tmp/code-coverage-report');
```
php-timer/LICENSE 0000644 00000002773 15243417753 0007502 0 ustar 00 BSD 3-Clause License
Copyright (c) 2010-2023, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
php-timer/src/exceptions/NoActiveTimerException.php 0000644 00000000623 15243417753 0016536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use LogicException;
final class NoActiveTimerException extends LogicException implements Exception
{
}
php-timer/src/exceptions/TimeSinceStartOfRequestNotAvailableException.php 0000644 00000000655 15243417753 0023050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use RuntimeException;
final class TimeSinceStartOfRequestNotAvailableException extends RuntimeException implements Exception
{
}
php-timer/src/exceptions/Exception.php 0000644 00000000545 15243417753 0014107 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use Throwable;
interface Exception extends Throwable
{
}
php-timer/src/Timer.php 0000644 00000001642 15243417753 0011047 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function array_pop;
use function hrtime;
final class Timer
{
/**
* @psalm-var list<float>
*/
private array $startTimes = [];
public function start(): void
{
$this->startTimes[] = (float) hrtime(true);
}
/**
* @throws NoActiveTimerException
*/
public function stop(): Duration
{
if (empty($this->startTimes)) {
throw new NoActiveTimerException(
'Timer::start() has to be called before Timer::stop()'
);
}
return Duration::fromNanoseconds((float) hrtime(true) - array_pop($this->startTimes));
}
}
php-timer/src/ResourceUsageFormatter.php 0000644 00000004105 15243417753 0014424 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function is_float;
use function memory_get_peak_usage;
use function microtime;
use function sprintf;
final class ResourceUsageFormatter
{
/**
* @psalm-var array<string,int>
*/
private const SIZES = [
'GB' => 1073741824,
'MB' => 1048576,
'KB' => 1024,
];
public function resourceUsage(Duration $duration): string
{
return sprintf(
'Time: %s, Memory: %s',
$duration->asString(),
$this->bytesToString(memory_get_peak_usage(true))
);
}
/**
* @throws TimeSinceStartOfRequestNotAvailableException
*/
public function resourceUsageSinceStartOfRequest(): string
{
if (!isset($_SERVER['REQUEST_TIME_FLOAT'])) {
throw new TimeSinceStartOfRequestNotAvailableException(
'Cannot determine time at which the request started because $_SERVER[\'REQUEST_TIME_FLOAT\'] is not available'
);
}
if (!is_float($_SERVER['REQUEST_TIME_FLOAT'])) {
throw new TimeSinceStartOfRequestNotAvailableException(
'Cannot determine time at which the request started because $_SERVER[\'REQUEST_TIME_FLOAT\'] is not of type float'
);
}
return $this->resourceUsage(
Duration::fromMicroseconds(
(1000000 * (microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']))
)
);
}
private function bytesToString(int $bytes): string
{
foreach (self::SIZES as $unit => $value) {
if ($bytes >= $value) {
return sprintf('%.2f %s', $bytes / $value, $unit);
}
}
// @codeCoverageIgnoreStart
return $bytes . ' byte' . ($bytes !== 1 ? 's' : '');
// @codeCoverageIgnoreEnd
}
}
php-timer/src/Duration.php 0000644 00000005023 15243417753 0011551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-timer.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Timer;
use function floor;
use function sprintf;
/**
* @psalm-immutable
*/
final class Duration
{
private readonly float $nanoseconds;
private readonly int $hours;
private readonly int $minutes;
private readonly int $seconds;
private readonly int $milliseconds;
public static function fromMicroseconds(float $microseconds): self
{
return new self($microseconds * 1000);
}
public static function fromNanoseconds(float $nanoseconds): self
{
return new self($nanoseconds);
}
private function __construct(float $nanoseconds)
{
$this->nanoseconds = $nanoseconds;
$timeInMilliseconds = $nanoseconds / 1000000;
$hours = floor($timeInMilliseconds / 60 / 60 / 1000);
$hoursInMilliseconds = $hours * 60 * 60 * 1000;
$minutes = floor($timeInMilliseconds / 60 / 1000) % 60;
$minutesInMilliseconds = $minutes * 60 * 1000;
$seconds = floor(($timeInMilliseconds - $hoursInMilliseconds - $minutesInMilliseconds) / 1000);
$secondsInMilliseconds = $seconds * 1000;
$milliseconds = $timeInMilliseconds - $hoursInMilliseconds - $minutesInMilliseconds - $secondsInMilliseconds;
$this->hours = (int) $hours;
$this->minutes = $minutes;
$this->seconds = (int) $seconds;
$this->milliseconds = (int) $milliseconds;
}
public function asNanoseconds(): float
{
return $this->nanoseconds;
}
public function asMicroseconds(): float
{
return $this->nanoseconds / 1000;
}
public function asMilliseconds(): float
{
return $this->nanoseconds / 1000000;
}
public function asSeconds(): float
{
return $this->nanoseconds / 1000000000;
}
public function asString(): string
{
$result = '';
if ($this->hours > 0) {
$result = sprintf('%02d', $this->hours) . ':';
}
$result .= sprintf('%02d', $this->minutes) . ':';
$result .= sprintf('%02d', $this->seconds);
if ($this->milliseconds > 0) {
$result .= '.' . sprintf('%03d', $this->milliseconds);
}
return $result;
}
}
php-timer/SECURITY.md 0000644 00000001120 15243417753 0010247 0 ustar 00 # Security Policy
This library is intended to be used in development environments only. For instance, it is used by the testing framework PHPUnit. There is no reason why this library should be installed on a webserver.
**If you upload this library to a webserver then your deployment process is broken. On a more general note, if your `vendor` directory is publicly accessible on your webserver then your deployment process is also broken.**
## Security Contact Information
After the above, if you still would like to report a security vulnerability, please email `sebastian@phpunit.de`.
php-timer/composer.json 0000644 00000001675 15243417753 0011217 0 ustar 00 {
"name": "phpunit/php-timer",
"description": "Utility class for timing",
"type": "library",
"keywords": [
"timer"
],
"homepage": "https://github.com/sebastianbergmann/php-timer/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-timer/issues"
},
"prefer-stable": true,
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"autoload": {
"classmap": [
"src/"
]
},
"extra": {
"branch-alias": {
"dev-main": "6.0-dev"
}
}
}
php-timer/README.md 0000644 00000004732 15243417753 0007751 0 ustar 00 # phpunit/php-timer
[](https://packagist.org/packages/phpunit/php-timer)
[](https://github.com/sebastianbergmann/php-timer/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-timer)
[](https://codecov.io/gh/sebastianbergmann/php-timer)
Utility class for timing things, factored out of PHPUnit into a stand-alone component.
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
```
composer require phpunit/php-timer
```
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
```
composer require --dev phpunit/php-timer
```
## Usage
### Basic Timing
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\Timer;
$timer = new Timer;
$timer->start();
foreach (\range(0, 100000) as $i) {
// ...
}
$duration = $timer->stop();
var_dump(get_class($duration));
var_dump($duration->asString());
var_dump($duration->asSeconds());
var_dump($duration->asMilliseconds());
var_dump($duration->asMicroseconds());
var_dump($duration->asNanoseconds());
```
The code above yields the output below:
```
string(32) "SebastianBergmann\Timer\Duration"
string(9) "00:00.002"
float(0.002851062)
float(2.851062)
float(2851.062)
int(2851062)
```
### Resource Consumption
#### Explicit duration
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\ResourceUsageFormatter;
use SebastianBergmann\Timer\Timer;
$timer = new Timer;
$timer->start();
foreach (\range(0, 100000) as $i) {
// ...
}
print (new ResourceUsageFormatter)->resourceUsage($timer->stop());
```
The code above yields the output below:
```
Time: 00:00.002, Memory: 6.00 MB
```
#### Duration since PHP Startup (using unreliable `$_SERVER['REQUEST_TIME_FLOAT']`)
```php
require __DIR__ . '/vendor/autoload.php';
use SebastianBergmann\Timer\ResourceUsageFormatter;
foreach (\range(0, 100000) as $i) {
// ...
}
print (new ResourceUsageFormatter)->resourceUsageSinceStartOfRequest();
```
The code above yields the output below:
```
Time: 00:00.002, Memory: 6.00 MB
```
php-timer/ChangeLog.md 0000644 00000011553 15243417753 0010642 0 ustar 00 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
## [6.0.0] - 2023-02-03
### Removed
* This component is no longer supported on PHP 7.3, PHP 7.4 and PHP 8.0
## [5.0.3] - 2020-10-26
### Fixed
* `SebastianBergmann\Timer\Exception` now correctly extends `\Throwable`
## [5.0.2] - 2020-09-28
### Changed
* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
## [5.0.1] - 2020-06-26
### Added
* This component is now supported on PHP 8
## [5.0.0] - 2020-06-07
### Changed
* Parameter type for `SebastianBergmann\Timer\Duration::fromMicroseconds()` was changed from `int` to `float`
* Parameter type for `SebastianBergmann\Timer\Duration::fromNanoseconds()` was changed from `int` to `float`
* Return type for `SebastianBergmann\Timer\Duration::asNanoseconds()` was changed from `int` to `float`
### Fixed
* [#31](https://github.com/sebastianbergmann/php-timer/issues/31): Type Error on 32-bit systems (where `hrtime()` returns `float` instead of `int`)
## [4.0.0] - 2020-06-01
### Added
* Introduced `Duration` value object for encapsulating a duration with nanosecond granularity
* Introduced `ResourceUsageFormatter` object for formatting resource usage with option to explicitly pass a duration (instead of looking at the unreliable `$_SERVER['REQUEST_TIME_FLOAT']` variable)
### Changed
* The methods of `Timer` are no longer static
* `Timer::stop()` now returns a `Duration` value object
### Removed
* Functionality that is now implemented in `Duration` and `ResourceUsageFormatter` has been removed from `Timer`
## [3.1.4] - 2020-04-20
### Changed
* `Timer::timeSinceStartOfRequest()` no longer tries `$_SERVER['REQUEST_TIME']` when `$_SERVER['REQUEST_TIME_FLOAT']` is not available (`$_SERVER['REQUEST_TIME_FLOAT']` was added in PHP 5.4 and this library requires PHP 7.3)
* Improved exception messages when `$_SERVER['REQUEST_TIME_FLOAT']` is not set or is not of type `float`
### Changed
## [3.1.3] - 2020-04-20
### Changed
* `Timer::timeSinceStartOfRequest()` now raises an exception if `$_SERVER['REQUEST_TIME_FLOAT']` does not contain a `float` (or `$_SERVER['REQUEST_TIME']` does not contain an `int`)
## [3.1.2] - 2020-04-17
### Changed
* Improved the fix for [#30](https://github.com/sebastianbergmann/php-timer/issues/30) and restored usage of `hrtime()`
## [3.1.1] - 2020-04-17
### Fixed
* [#30](https://github.com/sebastianbergmann/php-timer/issues/30): Resolution of time returned by `Timer::stop()` is different than before (this reverts using `hrtime()` instead of `microtime()`)
## [3.1.0] - 2020-04-17
### Added
* `Timer::secondsToShortTimeString()` as alternative to `Timer::secondsToTimeString()`
### Changed
* `Timer::start()` and `Timer::stop()` now use `hrtime()` (high resolution monotonic timer) instead of `microtime()`
* `Timer::timeSinceStartOfRequest()` now uses `Timer::secondsToShortTimeString()` for time formatting
* Improved formatting of `Timer::secondsToTimeString()` result
## [3.0.0] - 2020-02-07
### Removed
* This component is no longer supported on PHP 7.1 and PHP 7.2
## [2.1.2] - 2019-06-07
### Fixed
* [#21](https://github.com/sebastianbergmann/php-timer/pull/21): Formatting of memory consumption does not work on 32bit systems
## [2.1.1] - 2019-02-20
### Changed
* Improved formatting of memory consumption for `resourceUsage()`
## [2.1.0] - 2019-02-20
### Changed
* Improved formatting of memory consumption for `resourceUsage()`
## [2.0.0] - 2018-02-01
### Changed
* This component now uses namespaces
### Removed
* This component is no longer supported on PHP 5.3, PHP 5.4, PHP 5.5, PHP 5.6, and PHP 7.0
[6.0.0]: https://github.com/sebastianbergmann/php-timer/compare/5.0.3...6.0.0
[5.0.3]: https://github.com/sebastianbergmann/php-timer/compare/5.0.2...5.0.3
[5.0.2]: https://github.com/sebastianbergmann/php-timer/compare/5.0.1...5.0.2
[5.0.1]: https://github.com/sebastianbergmann/php-timer/compare/5.0.0...5.0.1
[5.0.0]: https://github.com/sebastianbergmann/php-timer/compare/4.0.0...5.0.0
[4.0.0]: https://github.com/sebastianbergmann/php-timer/compare/3.1.4...4.0.0
[3.1.4]: https://github.com/sebastianbergmann/php-timer/compare/3.1.3...3.1.4
[3.1.3]: https://github.com/sebastianbergmann/php-timer/compare/3.1.2...3.1.3
[3.1.2]: https://github.com/sebastianbergmann/php-timer/compare/3.1.1...3.1.2
[3.1.1]: https://github.com/sebastianbergmann/php-timer/compare/3.1.0...3.1.1
[3.1.0]: https://github.com/sebastianbergmann/php-timer/compare/3.0.0...3.1.0
[3.0.0]: https://github.com/sebastianbergmann/php-timer/compare/2.1.2...3.0.0
[2.1.2]: https://github.com/sebastianbergmann/php-timer/compare/2.1.1...2.1.2
[2.1.1]: https://github.com/sebastianbergmann/php-timer/compare/2.1.0...2.1.1
[2.1.0]: https://github.com/sebastianbergmann/php-timer/compare/2.0.0...2.1.0
[2.0.0]: https://github.com/sebastianbergmann/php-timer/compare/1.0.9...2.0.0
php-text-template/LICENSE 0000644 00000002773 15243417753 0011157 0 ustar 00 BSD 3-Clause License
Copyright (c) 2009-2023, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
php-text-template/src/exceptions/InvalidArgumentException.php 0000644 00000000626 15243417753 0020576 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-text-template.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Template;
final class InvalidArgumentException extends \InvalidArgumentException implements Exception
{
}
php-text-template/src/exceptions/Exception.php 0000644 00000000560 15243417753 0015561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-text-template.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Template;
use Throwable;
interface Exception extends Throwable
{
}
php-text-template/src/exceptions/RuntimeException.php 0000644 00000000654 15243417753 0017131 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-text-template.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Template;
use InvalidArgumentException;
final class RuntimeException extends InvalidArgumentException implements Exception
{
}
php-text-template/src/Template.php 0000644 00000004765 15243417753 0013230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-text-template.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Template;
use function array_keys;
use function array_merge;
use function file_get_contents;
use function file_put_contents;
use function is_file;
use function sprintf;
use function str_replace;
final class Template
{
private string $template = '';
private string $openDelimiter;
private string $closeDelimiter;
/**
* @psalm-var array<string,string>
*/
private array $values = [];
/**
* @throws InvalidArgumentException
*/
public function __construct(string $file = '', string $openDelimiter = '{', string $closeDelimiter = '}')
{
$this->setFile($file);
$this->openDelimiter = $openDelimiter;
$this->closeDelimiter = $closeDelimiter;
}
/**
* @throws InvalidArgumentException
*/
public function setFile(string $file): void
{
if (is_file($file)) {
$this->template = file_get_contents($file);
return;
}
$distFile = $file . '.dist';
if (is_file($distFile)) {
$this->template = file_get_contents($distFile);
return;
}
throw new InvalidArgumentException(
sprintf(
'Failed to load template "%s"',
$file
)
);
}
/**
* @psalm-param array<string,string> $values
*/
public function setVar(array $values, bool $merge = true): void
{
if (!$merge || empty($this->values)) {
$this->values = $values;
return;
}
$this->values = array_merge($this->values, $values);
}
public function render(): string
{
$keys = [];
foreach (array_keys($this->values) as $key) {
$keys[] = $this->openDelimiter . $key . $this->closeDelimiter;
}
return str_replace($keys, $this->values, $this->template);
}
/**
* @codeCoverageIgnore
*/
public function renderTo(string $target): void
{
if (!@file_put_contents($target, $this->render())) {
throw new RuntimeException(
sprintf(
'Writing rendered result to "%s" failed',
$target
)
);
}
}
}
php-text-template/SECURITY.md 0000644 00000003565 15243417753 0011743 0 ustar 00 # Security Policy
If you believe you have found a security vulnerability in the library that is developed in this repository, please report it to us through coordinated disclosure.
**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**
Instead, please email `sebastian@phpunit.de`.
Please include as much of the information listed below as you can to help us better understand and resolve the issue:
* The type of issue
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
## Web Context
The library that is developed in this repository was either extracted from [PHPUnit](https://github.com/sebastianbergmann/phpunit) or developed specifically as a dependency for PHPUnit.
The library is developed with a focus on development environments and the command-line. No specific testing or hardening with regard to using the library in an HTTP or web context or with untrusted input data is performed. The library might also contain functionality that intentionally exposes internal application data for debugging purposes.
If the library is used in a web application, the application developer is responsible for filtering inputs or escaping outputs as necessary and for verifying that the used functionality is safe for use within the intended context.
Vulnerabilities specific to the use outside a development context will be fixed as applicable, provided that the fix does not have an averse effect on the primary use case for development purposes.
php-text-template/composer.json 0000644 00000002064 15243417753 0012665 0 ustar 00 {
"name": "phpunit/php-text-template",
"description": "Simple template engine.",
"type": "library",
"keywords": [
"template"
],
"homepage": "https://github.com/sebastianbergmann/php-text-template/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-text-template/issues",
"security": "https://github.com/sebastianbergmann/php-text-template/security/policy"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"prefer-stable": true,
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"autoload": {
"classmap": [
"src/"
]
},
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
}
}
php-text-template/README.md 0000644 00000002024 15243417753 0011416 0 ustar 00 [](https://packagist.org/packages/phpunit/php-text-template)
[](https://github.com/sebastianbergmann/php-text-template/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-text-template)
[](https://codecov.io/gh/sebastianbergmann/php-text-template)
# php-text-template
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
composer require phpunit/php-text-template
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
composer require --dev phpunit/php-text-template
php-text-template/ChangeLog.md 0000644 00000003036 15243417753 0012314 0 ustar 00 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
## [3.0.1] - 2023-08-31
### Changed
* Warnings from `file_put_contents()` are now suppressed
## [3.0.0] - 2023-02-03
### Removed
* This component is no longer supported on PHP 7.3, PHP 7.4 and PHP 8.0
## [2.0.4] - 2020-10-26
### Fixed
* `SebastianBergmann\Template\Exception` now correctly extends `\Throwable`
## [2.0.3] - 2020-09-28
### Changed
* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
## [2.0.2] - 2020-06-26
### Added
* This component is now supported on PHP 8
## [2.0.1] - 2020-06-15
### Changed
* Tests etc. are now ignored for archive exports
## [2.0.0] - 2020-02-07
### Changed
* The `Text_Template` class was renamed to `SebastianBergmann\Template\Template`
### Removed
* Removed support for PHP 5.3, PHP 5.4, PHP 5.5, PHP 5.6, PHP 7.0, PHP 7.1, and PHP 7.2
[3.0.1]: https://github.com/sebastianbergmann/php-text-template/compare/3.0.0...3.0.1
[3.0.0]: https://github.com/sebastianbergmann/php-text-template/compare/2.0.4...3.0.0
[2.0.4]: https://github.com/sebastianbergmann/php-text-template/compare/2.0.3...2.0.4
[2.0.3]: https://github.com/sebastianbergmann/php-text-template/compare/2.0.2...2.0.3
[2.0.2]: https://github.com/sebastianbergmann/php-text-template/compare/2.0.1...2.0.2
[2.0.1]: https://github.com/sebastianbergmann/php-text-template/compare/2.0.0...2.0.1
[2.0.0]: https://github.com/sebastianbergmann/php-text-template/compare/1.2.1...2.0.0
phpunit/composer.lock 0000644 00000155230 15243417753 0010755 0 ustar 00 {
"_readme": [
"This file locks the dependencies of your project to a known state",
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
"content-hash": "e06728e5442edec84af96f94a889b4a7",
"packages": [
{
"name": "myclabs/deep-copy",
"version": "1.11.1",
"source": {
"type": "git",
"url": "https://github.com/myclabs/DeepCopy.git",
"reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/7284c22080590fb39f2ffa3e9057f10a4ddd0e0c",
"reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c",
"shasum": ""
},
"require": {
"php": "^7.1 || ^8.0"
},
"conflict": {
"doctrine/collections": "<1.6.8",
"doctrine/common": "<2.13.3 || >=3,<3.2.2"
},
"require-dev": {
"doctrine/collections": "^1.6.8",
"doctrine/common": "^2.13.3 || ^3.2.2",
"phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13"
},
"type": "library",
"autoload": {
"files": [
"src/DeepCopy/deep_copy.php"
],
"psr-4": {
"DeepCopy\\": "src/DeepCopy/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"description": "Create deep copies (clones) of your objects",
"keywords": [
"clone",
"copy",
"duplicate",
"object",
"object graph"
],
"support": {
"issues": "https://github.com/myclabs/DeepCopy/issues",
"source": "https://github.com/myclabs/DeepCopy/tree/1.11.1"
},
"funding": [
{
"url": "https://tidelift.com/funding/github/packagist/myclabs/deep-copy",
"type": "tidelift"
}
],
"time": "2023-03-08T13:26:56+00:00"
},
{
"name": "nikic/php-parser",
"version": "v5.0.2",
"source": {
"type": "git",
"url": "https://github.com/nikic/PHP-Parser.git",
"reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/139676794dc1e9231bf7bcd123cfc0c99182cb13",
"reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13",
"shasum": ""
},
"require": {
"ext-ctype": "*",
"ext-json": "*",
"ext-tokenizer": "*",
"php": ">=7.4"
},
"require-dev": {
"ircmaxell/php-yacc": "^0.0.7",
"phpunit/phpunit": "^7.0 || ^8.0 || ^9.0"
},
"bin": [
"bin/php-parse"
],
"type": "library",
"extra": {
"branch-alias": {
"dev-master": "5.0-dev"
}
},
"autoload": {
"psr-4": {
"PhpParser\\": "lib/PhpParser"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Nikita Popov"
}
],
"description": "A PHP parser written in PHP",
"keywords": [
"parser",
"php"
],
"support": {
"issues": "https://github.com/nikic/PHP-Parser/issues",
"source": "https://github.com/nikic/PHP-Parser/tree/v5.0.2"
},
"time": "2024-03-05T20:51:40+00:00"
},
{
"name": "phar-io/manifest",
"version": "2.0.4",
"source": {
"type": "git",
"url": "https://github.com/phar-io/manifest.git",
"reference": "54750ef60c58e43759730615a392c31c80e23176"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/phar-io/manifest/zipball/54750ef60c58e43759730615a392c31c80e23176",
"reference": "54750ef60c58e43759730615a392c31c80e23176",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-libxml": "*",
"ext-phar": "*",
"ext-xmlwriter": "*",
"phar-io/version": "^3.0.1",
"php": "^7.2 || ^8.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-master": "2.0.x-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
},
{
"name": "Sebastian Heuer",
"email": "sebastian@phpeople.de",
"role": "Developer"
},
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "Developer"
}
],
"description": "Component for reading phar.io manifest information from a PHP Archive (PHAR)",
"support": {
"issues": "https://github.com/phar-io/manifest/issues",
"source": "https://github.com/phar-io/manifest/tree/2.0.4"
},
"funding": [
{
"url": "https://github.com/theseer",
"type": "github"
}
],
"time": "2024-03-03T12:33:53+00:00"
},
{
"name": "phar-io/version",
"version": "3.2.1",
"source": {
"type": "git",
"url": "https://github.com/phar-io/version.git",
"reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/phar-io/version/zipball/4f7fd7836c6f332bb2933569e566a0d6c4cbed74",
"reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74",
"shasum": ""
},
"require": {
"php": "^7.2 || ^8.0"
},
"type": "library",
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
},
{
"name": "Sebastian Heuer",
"email": "sebastian@phpeople.de",
"role": "Developer"
},
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "Developer"
}
],
"description": "Library for handling version information and constraints",
"support": {
"issues": "https://github.com/phar-io/version/issues",
"source": "https://github.com/phar-io/version/tree/3.2.1"
},
"time": "2022-02-21T01:04:05+00:00"
},
{
"name": "phpunit/php-code-coverage",
"version": "10.1.14",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-code-coverage.git",
"reference": "e3f51450ebffe8e0efdf7346ae966a656f7d5e5b"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/e3f51450ebffe8e0efdf7346ae966a656f7d5e5b",
"reference": "e3f51450ebffe8e0efdf7346ae966a656f7d5e5b",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-libxml": "*",
"ext-xmlwriter": "*",
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1",
"phpunit/php-file-iterator": "^4.0",
"phpunit/php-text-template": "^3.0",
"sebastian/code-unit-reverse-lookup": "^3.0",
"sebastian/complexity": "^3.0",
"sebastian/environment": "^6.0",
"sebastian/lines-of-code": "^2.0",
"sebastian/version": "^4.0",
"theseer/tokenizer": "^1.2.0"
},
"require-dev": {
"phpunit/phpunit": "^10.1"
},
"suggest": {
"ext-pcov": "PHP extension that provides line coverage",
"ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "10.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.",
"homepage": "https://github.com/sebastianbergmann/php-code-coverage",
"keywords": [
"coverage",
"testing",
"xunit"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-code-coverage/issues",
"security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy",
"source": "https://github.com/sebastianbergmann/php-code-coverage/tree/10.1.14"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-12T15:33:41+00:00"
},
{
"name": "phpunit/php-file-iterator",
"version": "4.1.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-file-iterator.git",
"reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/a95037b6d9e608ba092da1b23931e537cadc3c3c",
"reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "FilterIterator implementation that filters files based on a list of suffixes.",
"homepage": "https://github.com/sebastianbergmann/php-file-iterator/",
"keywords": [
"filesystem",
"iterator"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-file-iterator/issues",
"security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy",
"source": "https://github.com/sebastianbergmann/php-file-iterator/tree/4.1.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-31T06:24:48+00:00"
},
{
"name": "phpunit/php-invoker",
"version": "4.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-invoker.git",
"reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7",
"reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"ext-pcntl": "*",
"phpunit/phpunit": "^10.0"
},
"suggest": {
"ext-pcntl": "*"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Invoke callables with a timeout",
"homepage": "https://github.com/sebastianbergmann/php-invoker/",
"keywords": [
"process"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-invoker/issues",
"source": "https://github.com/sebastianbergmann/php-invoker/tree/4.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:56:09+00:00"
},
{
"name": "phpunit/php-text-template",
"version": "3.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-text-template.git",
"reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/0c7b06ff49e3d5072f057eb1fa59258bf287a748",
"reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Simple template engine.",
"homepage": "https://github.com/sebastianbergmann/php-text-template/",
"keywords": [
"template"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-text-template/issues",
"security": "https://github.com/sebastianbergmann/php-text-template/security/policy",
"source": "https://github.com/sebastianbergmann/php-text-template/tree/3.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-31T14:07:24+00:00"
},
{
"name": "phpunit/php-timer",
"version": "6.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-timer.git",
"reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/e2a2d67966e740530f4a3343fe2e030ffdc1161d",
"reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Utility class for timing",
"homepage": "https://github.com/sebastianbergmann/php-timer/",
"keywords": [
"timer"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-timer/issues",
"source": "https://github.com/sebastianbergmann/php-timer/tree/6.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:57:52+00:00"
},
{
"name": "sebastian/cli-parser",
"version": "2.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/cli-parser.git",
"reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/c34583b87e7b7a8055bf6c450c2c77ce32a24084",
"reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for parsing CLI options",
"homepage": "https://github.com/sebastianbergmann/cli-parser",
"support": {
"issues": "https://github.com/sebastianbergmann/cli-parser/issues",
"security": "https://github.com/sebastianbergmann/cli-parser/security/policy",
"source": "https://github.com/sebastianbergmann/cli-parser/tree/2.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:12:49+00:00"
},
{
"name": "sebastian/code-unit",
"version": "2.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/code-unit.git",
"reference": "a81fee9eef0b7a76af11d121767abc44c104e503"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/code-unit/zipball/a81fee9eef0b7a76af11d121767abc44c104e503",
"reference": "a81fee9eef0b7a76af11d121767abc44c104e503",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Collection of value objects that represent the PHP code units",
"homepage": "https://github.com/sebastianbergmann/code-unit",
"support": {
"issues": "https://github.com/sebastianbergmann/code-unit/issues",
"source": "https://github.com/sebastianbergmann/code-unit/tree/2.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:58:43+00:00"
},
{
"name": "sebastian/code-unit-reverse-lookup",
"version": "3.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/code-unit-reverse-lookup.git",
"reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/code-unit-reverse-lookup/zipball/5e3a687f7d8ae33fb362c5c0743794bbb2420a1d",
"reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Looks up which function or method a line of code belongs to",
"homepage": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/",
"support": {
"issues": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/issues",
"source": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/tree/3.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:59:15+00:00"
},
{
"name": "sebastian/comparator",
"version": "5.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/comparator.git",
"reference": "2db5010a484d53ebf536087a70b4a5423c102372"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/2db5010a484d53ebf536087a70b4a5423c102372",
"reference": "2db5010a484d53ebf536087a70b4a5423c102372",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-mbstring": "*",
"php": ">=8.1",
"sebastian/diff": "^5.0",
"sebastian/exporter": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.3"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Volker Dusch",
"email": "github@wallbash.com"
},
{
"name": "Bernhard Schussek",
"email": "bschussek@2bepublished.at"
}
],
"description": "Provides the functionality to compare PHP values for equality",
"homepage": "https://github.com/sebastianbergmann/comparator",
"keywords": [
"comparator",
"compare",
"equality"
],
"support": {
"issues": "https://github.com/sebastianbergmann/comparator/issues",
"security": "https://github.com/sebastianbergmann/comparator/security/policy",
"source": "https://github.com/sebastianbergmann/comparator/tree/5.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-14T13:18:12+00:00"
},
{
"name": "sebastian/complexity",
"version": "3.2.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/complexity.git",
"reference": "68ff824baeae169ec9f2137158ee529584553799"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/68ff824baeae169ec9f2137158ee529584553799",
"reference": "68ff824baeae169ec9f2137158ee529584553799",
"shasum": ""
},
"require": {
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.2-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for calculating the complexity of PHP code units",
"homepage": "https://github.com/sebastianbergmann/complexity",
"support": {
"issues": "https://github.com/sebastianbergmann/complexity/issues",
"security": "https://github.com/sebastianbergmann/complexity/security/policy",
"source": "https://github.com/sebastianbergmann/complexity/tree/3.2.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-12-21T08:37:17+00:00"
},
{
"name": "sebastian/diff",
"version": "5.1.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/diff.git",
"reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/c41e007b4b62af48218231d6c2275e4c9b975b2e",
"reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0",
"symfony/process": "^6.4"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Kore Nordmann",
"email": "mail@kore-nordmann.de"
}
],
"description": "Diff implementation",
"homepage": "https://github.com/sebastianbergmann/diff",
"keywords": [
"diff",
"udiff",
"unidiff",
"unified diff"
],
"support": {
"issues": "https://github.com/sebastianbergmann/diff/issues",
"security": "https://github.com/sebastianbergmann/diff/security/policy",
"source": "https://github.com/sebastianbergmann/diff/tree/5.1.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:15:17+00:00"
},
{
"name": "sebastian/environment",
"version": "6.1.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/environment.git",
"reference": "8074dbcd93529b357029f5cc5058fd3e43666984"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/8074dbcd93529b357029f5cc5058fd3e43666984",
"reference": "8074dbcd93529b357029f5cc5058fd3e43666984",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"suggest": {
"ext-posix": "*"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Provides functionality to handle HHVM/PHP environments",
"homepage": "https://github.com/sebastianbergmann/environment",
"keywords": [
"Xdebug",
"environment",
"hhvm"
],
"support": {
"issues": "https://github.com/sebastianbergmann/environment/issues",
"security": "https://github.com/sebastianbergmann/environment/security/policy",
"source": "https://github.com/sebastianbergmann/environment/tree/6.1.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-23T08:47:14+00:00"
},
{
"name": "sebastian/exporter",
"version": "5.1.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/exporter.git",
"reference": "955288482d97c19a372d3f31006ab3f37da47adf"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/955288482d97c19a372d3f31006ab3f37da47adf",
"reference": "955288482d97c19a372d3f31006ab3f37da47adf",
"shasum": ""
},
"require": {
"ext-mbstring": "*",
"php": ">=8.1",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Volker Dusch",
"email": "github@wallbash.com"
},
{
"name": "Adam Harvey",
"email": "aharvey@php.net"
},
{
"name": "Bernhard Schussek",
"email": "bschussek@gmail.com"
}
],
"description": "Provides the functionality to export PHP variables for visualization",
"homepage": "https://www.github.com/sebastianbergmann/exporter",
"keywords": [
"export",
"exporter"
],
"support": {
"issues": "https://github.com/sebastianbergmann/exporter/issues",
"security": "https://github.com/sebastianbergmann/exporter/security/policy",
"source": "https://github.com/sebastianbergmann/exporter/tree/5.1.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:17:12+00:00"
},
{
"name": "sebastian/global-state",
"version": "6.0.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/global-state.git",
"reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/987bafff24ecc4c9ac418cab1145b96dd6e9cbd9",
"reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9",
"shasum": ""
},
"require": {
"php": ">=8.1",
"sebastian/object-reflector": "^3.0",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"ext-dom": "*",
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Snapshotting of global state",
"homepage": "https://www.github.com/sebastianbergmann/global-state",
"keywords": [
"global state"
],
"support": {
"issues": "https://github.com/sebastianbergmann/global-state/issues",
"security": "https://github.com/sebastianbergmann/global-state/security/policy",
"source": "https://github.com/sebastianbergmann/global-state/tree/6.0.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:19:19+00:00"
},
{
"name": "sebastian/lines-of-code",
"version": "2.0.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/lines-of-code.git",
"reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/856e7f6a75a84e339195d48c556f23be2ebf75d0",
"reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0",
"shasum": ""
},
"require": {
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for counting the lines of code in PHP source code",
"homepage": "https://github.com/sebastianbergmann/lines-of-code",
"support": {
"issues": "https://github.com/sebastianbergmann/lines-of-code/issues",
"security": "https://github.com/sebastianbergmann/lines-of-code/security/policy",
"source": "https://github.com/sebastianbergmann/lines-of-code/tree/2.0.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-12-21T08:38:20+00:00"
},
{
"name": "sebastian/object-enumerator",
"version": "5.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/object-enumerator.git",
"reference": "202d0e344a580d7f7d04b3fafce6933e59dae906"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/202d0e344a580d7f7d04b3fafce6933e59dae906",
"reference": "202d0e344a580d7f7d04b3fafce6933e59dae906",
"shasum": ""
},
"require": {
"php": ">=8.1",
"sebastian/object-reflector": "^3.0",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Traverses array structures and object graphs to enumerate all referenced objects",
"homepage": "https://github.com/sebastianbergmann/object-enumerator/",
"support": {
"issues": "https://github.com/sebastianbergmann/object-enumerator/issues",
"source": "https://github.com/sebastianbergmann/object-enumerator/tree/5.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:08:32+00:00"
},
{
"name": "sebastian/object-reflector",
"version": "3.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/object-reflector.git",
"reference": "24ed13d98130f0e7122df55d06c5c4942a577957"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/24ed13d98130f0e7122df55d06c5c4942a577957",
"reference": "24ed13d98130f0e7122df55d06c5c4942a577957",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Allows reflection of object attributes, including inherited and non-public ones",
"homepage": "https://github.com/sebastianbergmann/object-reflector/",
"support": {
"issues": "https://github.com/sebastianbergmann/object-reflector/issues",
"source": "https://github.com/sebastianbergmann/object-reflector/tree/3.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:06:18+00:00"
},
{
"name": "sebastian/recursion-context",
"version": "5.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/recursion-context.git",
"reference": "05909fb5bc7df4c52992396d0116aed689f93712"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/05909fb5bc7df4c52992396d0116aed689f93712",
"reference": "05909fb5bc7df4c52992396d0116aed689f93712",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Adam Harvey",
"email": "aharvey@php.net"
}
],
"description": "Provides functionality to recursively process PHP variables",
"homepage": "https://github.com/sebastianbergmann/recursion-context",
"support": {
"issues": "https://github.com/sebastianbergmann/recursion-context/issues",
"source": "https://github.com/sebastianbergmann/recursion-context/tree/5.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:05:40+00:00"
},
{
"name": "sebastian/type",
"version": "4.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/type.git",
"reference": "462699a16464c3944eefc02ebdd77882bd3925bf"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/type/zipball/462699a16464c3944eefc02ebdd77882bd3925bf",
"reference": "462699a16464c3944eefc02ebdd77882bd3925bf",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Collection of value objects that represent the types of the PHP type system",
"homepage": "https://github.com/sebastianbergmann/type",
"support": {
"issues": "https://github.com/sebastianbergmann/type/issues",
"source": "https://github.com/sebastianbergmann/type/tree/4.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:10:45+00:00"
},
{
"name": "sebastian/version",
"version": "4.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/version.git",
"reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/version/zipball/c51fa83a5d8f43f1402e3f32a005e6262244ef17",
"reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library that helps with managing the version number of Git-hosted PHP projects",
"homepage": "https://github.com/sebastianbergmann/version",
"support": {
"issues": "https://github.com/sebastianbergmann/version/issues",
"source": "https://github.com/sebastianbergmann/version/tree/4.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-07T11:34:05+00:00"
},
{
"name": "theseer/tokenizer",
"version": "1.2.3",
"source": {
"type": "git",
"url": "https://github.com/theseer/tokenizer.git",
"reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/theseer/tokenizer/zipball/737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
"reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-tokenizer": "*",
"ext-xmlwriter": "*",
"php": "^7.2 || ^8.0"
},
"type": "library",
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
}
],
"description": "A small library for converting tokenized PHP source code into XML and potentially other formats",
"support": {
"issues": "https://github.com/theseer/tokenizer/issues",
"source": "https://github.com/theseer/tokenizer/tree/1.2.3"
},
"funding": [
{
"url": "https://github.com/theseer",
"type": "github"
}
],
"time": "2024-03-03T12:36:25+00:00"
}
],
"packages-dev": [],
"aliases": [],
"minimum-stability": "stable",
"stability-flags": [],
"prefer-stable": true,
"prefer-lowest": false,
"platform": {
"php": ">=8.1",
"ext-dom": "*",
"ext-json": "*",
"ext-libxml": "*",
"ext-mbstring": "*",
"ext-xml": "*",
"ext-xmlwriter": "*"
},
"platform-dev": [],
"platform-overrides": {
"php": "8.1.0"
},
"plugin-api-version": "2.6.0"
}
phpunit/LICENSE 0000644 00000002773 15243417753 0007264 0 ustar 00 BSD 3-Clause License
Copyright (c) 2001-2024, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
phpunit/src/Util/Test.php 0000644 00000001651 15243417753 0011405 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function str_starts_with;
use PHPUnit\Metadata\Parser\Registry;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Test
{
public static function isTestMethod(ReflectionMethod $method): bool
{
if (!$method->isPublic()) {
return false;
}
if (str_starts_with($method->getName(), 'test')) {
return true;
}
$metadata = Registry::parser()->forMethod(
$method->getDeclaringClass()->getName(),
$method->getName(),
);
return $metadata->isTest()->isNotEmpty();
}
}
phpunit/src/Util/Json.php 0000644 00000005344 15243417753 0011402 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const JSON_PRETTY_PRINT;
use const JSON_UNESCAPED_SLASHES;
use const JSON_UNESCAPED_UNICODE;
use function count;
use function is_array;
use function is_object;
use function json_decode;
use function json_encode;
use function json_last_error;
use function ksort;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Json
{
/**
* @throws InvalidJsonException
*/
public static function prettify(string $json): string
{
$decodedJson = json_decode($json, false);
if (json_last_error()) {
throw new InvalidJsonException;
}
return json_encode($decodedJson, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
}
/**
* To allow comparison of JSON strings, first process them into a consistent
* format so that they can be compared as strings.
*
* @return array ($error, $canonicalized_json) The $error parameter is used
* to indicate an error decoding the json. This is used to avoid ambiguity
* with JSON strings consisting entirely of 'null' or 'false'.
*/
public static function canonicalize(string $json): array
{
$decodedJson = json_decode($json);
if (json_last_error()) {
return [true, null];
}
self::recursiveSort($decodedJson);
$reencodedJson = json_encode($decodedJson);
return [false, $reencodedJson];
}
/**
* JSON object keys are unordered while PHP array keys are ordered.
*
* Sort all array keys to ensure both the expected and actual values have
* their keys in the same order.
*/
private static function recursiveSort(mixed &$json): void
{
if (!is_array($json)) {
// If the object is not empty, change it to an associative array
// so we can sort the keys (and we will still re-encode it
// correctly, since PHP encodes associative arrays as JSON objects.)
// But EMPTY objects MUST remain empty objects. (Otherwise we will
// re-encode it as a JSON array rather than a JSON object.)
// See #2919.
if (is_object($json) && count((array) $json) > 0) {
$json = (array) $json;
} else {
return;
}
}
ksort($json);
foreach ($json as &$value) {
self::recursiveSort($value);
}
}
}
phpunit/src/Util/ThrowableToStringMapper.php 0000644 00000002474 15243417753 0015260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\PhptAssertionFailedError;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Runner\ErrorException;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ThrowableToStringMapper
{
public static function map(Throwable $t): string
{
if ($t instanceof ErrorException) {
return $t->getMessage();
}
if ($t instanceof SelfDescribing) {
$buffer = $t->toString();
if ($t instanceof ExpectationFailedException && $t->getComparisonFailure()) {
$buffer .= $t->getComparisonFailure()->getDiff();
}
if ($t instanceof PhptAssertionFailedError) {
$buffer .= $t->diff();
}
if (!empty($buffer)) {
$buffer = trim($buffer) . "\n";
}
return $buffer;
}
return $t::class . ': ' . $t->getMessage() . "\n";
}
}
phpunit/src/Util/VersionComparisonOperator.php 0000644 00000003045 15243417753 0015661 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function in_array;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class VersionComparisonOperator
{
/**
* @psalm-var '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne'
*/
private readonly string $operator;
/**
* @psalm-param '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne' $operator
*
* @throws InvalidVersionOperatorException
*/
public function __construct(string $operator)
{
$this->ensureOperatorIsValid($operator);
$this->operator = $operator;
}
/**
* @psalm-return '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne'
*/
public function asString(): string
{
return $this->operator;
}
/**
* @psalm-param '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne' $operator
*
* @throws InvalidVersionOperatorException
*/
private function ensureOperatorIsValid(string $operator): void
{
if (!in_array($operator, ['<', 'lt', '<=', 'le', '>', 'gt', '>=', 'ge', '==', '=', 'eq', '!=', '<>', 'ne'], true)) {
throw new InvalidVersionOperatorException($operator);
}
}
}
phpunit/src/Util/Reflection.php 0000644 00000005426 15243417753 0012564 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function array_keys;
use function array_merge;
use function array_reverse;
use PHPUnit\Framework\Assert;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Reflection
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array{file: non-empty-string, line: non-negative-int}
*/
public static function sourceLocationFor(string $className, string $methodName): array
{
try {
$reflector = new ReflectionMethod($className, $methodName);
$file = $reflector->getFileName();
$line = $reflector->getStartLine();
} catch (ReflectionException) {
$file = 'unknown';
$line = 0;
}
return [
'file' => $file,
'line' => $line,
];
}
/**
* @psalm-return list<ReflectionMethod>
*/
public static function publicMethodsInTestClass(ReflectionClass $class): array
{
return self::filterAndSortMethods($class, ReflectionMethod::IS_PUBLIC, true);
}
/**
* @psalm-return list<ReflectionMethod>
*/
public static function methodsInTestClass(ReflectionClass $class): array
{
return self::filterAndSortMethods($class, null, false);
}
/**
* @psalm-return list<ReflectionMethod>
*/
private static function filterAndSortMethods(ReflectionClass $class, ?int $filter, bool $sortHighestToLowest): array
{
$methodsByClass = [];
foreach ($class->getMethods($filter) as $method) {
$declaringClassName = $method->getDeclaringClass()->getName();
if ($declaringClassName === TestCase::class) {
continue;
}
if ($declaringClassName === Assert::class) {
continue;
}
if (!isset($methodsByClass[$declaringClassName])) {
$methodsByClass[$declaringClassName] = [];
}
$methodsByClass[$declaringClassName][] = $method;
}
$classNames = array_keys($methodsByClass);
if ($sortHighestToLowest) {
$classNames = array_reverse($classNames);
}
$methods = [];
foreach ($classNames as $className) {
$methods = array_merge($methods, $methodsByClass[$className]);
}
return $methods;
}
}
phpunit/src/Util/Cloner.php 0000644 00000001366 15243417753 0011713 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Cloner
{
/**
* @psalm-template OriginalType of object
*
* @psalm-param OriginalType $original
*
* @psalm-return OriginalType
*/
public static function clone(object $original): object
{
try {
return clone $original;
} catch (Throwable) {
return $original;
}
}
}
phpunit/src/Util/PHP/AbstractPhpProcess.php 0000644 00000020501 15243417753 0014662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use const PHP_BINARY;
use const PHP_SAPI;
use function array_keys;
use function array_merge;
use function assert;
use function explode;
use function file_exists;
use function file_get_contents;
use function ini_get_all;
use function restore_error_handler;
use function set_error_handler;
use function trim;
use function unlink;
use function unserialize;
use ErrorException;
use PHPUnit\Event\Code\TestMethodBuilder;
use PHPUnit\Event\Code\ThrowableBuilder;
use PHPUnit\Event\Facade;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\AssertionFailedError;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TestRunner\TestResult\PassedTests;
use SebastianBergmann\Environment\Runtime;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class AbstractPhpProcess
{
protected bool $stderrRedirection = false;
protected string $stdin = '';
protected string $arguments = '';
/**
* @psalm-var array<string, string>
*/
protected array $env = [];
public static function factory(): self
{
return new DefaultPhpProcess;
}
/**
* Defines if should use STDERR redirection or not.
*
* Then $stderrRedirection is TRUE, STDERR is redirected to STDOUT.
*/
public function setUseStderrRedirection(bool $stderrRedirection): void
{
$this->stderrRedirection = $stderrRedirection;
}
/**
* Returns TRUE if uses STDERR redirection or FALSE if not.
*/
public function useStderrRedirection(): bool
{
return $this->stderrRedirection;
}
/**
* Sets the input string to be sent via STDIN.
*/
public function setStdin(string $stdin): void
{
$this->stdin = $stdin;
}
/**
* Returns the input string to be sent via STDIN.
*/
public function getStdin(): string
{
return $this->stdin;
}
/**
* Sets the string of arguments to pass to the php job.
*/
public function setArgs(string $arguments): void
{
$this->arguments = $arguments;
}
/**
* Returns the string of arguments to pass to the php job.
*/
public function getArgs(): string
{
return $this->arguments;
}
/**
* Sets the array of environment variables to start the child process with.
*
* @psalm-param array<string, string> $env
*/
public function setEnv(array $env): void
{
$this->env = $env;
}
/**
* Returns the array of environment variables to start the child process with.
*/
public function getEnv(): array
{
return $this->env;
}
/**
* Runs a single test in a separate PHP process.
*
* @throws \PHPUnit\Runner\Exception
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
public function runTestJob(string $job, Test $test, string $processResultFile): void
{
$_result = $this->runJob($job);
$processResult = '';
if (file_exists($processResultFile)) {
$processResult = file_get_contents($processResultFile);
@unlink($processResultFile);
}
$this->processChildResult(
$test,
$processResult,
$_result['stderr'],
);
}
/**
* Returns the command based into the configurations.
*
* @return string[]
*/
public function getCommand(array $settings, ?string $file = null): array
{
$runtime = new Runtime;
$command = [];
$command[] = PHP_BINARY;
if ($runtime->hasPCOV()) {
$settings = array_merge(
$settings,
$runtime->getCurrentSettings(
array_keys(ini_get_all('pcov')),
),
);
} elseif ($runtime->hasXdebug()) {
$settings = array_merge(
$settings,
$runtime->getCurrentSettings(
array_keys(ini_get_all('xdebug')),
),
);
}
$command = array_merge($command, $this->settingsToParameters($settings));
if (PHP_SAPI === 'phpdbg') {
$command[] = '-qrr';
if (!$file) {
$command[] = 's=';
}
}
if ($file) {
$command[] = '-f';
$command[] = $file;
}
if ($this->arguments) {
if (!$file) {
$command[] = '--';
}
foreach (explode(' ', $this->arguments) as $arg) {
$command[] = trim($arg);
}
}
return $command;
}
/**
* Runs a single job (PHP code) using a separate PHP process.
*/
abstract public function runJob(string $job, array $settings = []): array;
/**
* @return list<string>
*/
protected function settingsToParameters(array $settings): array
{
$buffer = [];
foreach ($settings as $setting) {
$buffer[] = '-d';
$buffer[] = $setting;
}
return $buffer;
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function processChildResult(Test $test, string $stdout, string $stderr): void
{
if (!empty($stderr)) {
$exception = new Exception(trim($stderr));
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
return;
}
set_error_handler(
/**
* @throws ErrorException
*/
static function (int $errno, string $errstr, string $errfile, int $errline): never
{
throw new ErrorException($errstr, $errno, $errno, $errfile, $errline);
},
);
try {
$childResult = unserialize($stdout);
restore_error_handler();
if ($childResult === false) {
$exception = new AssertionFailedError('Test was run in child process and ended unexpectedly');
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
Facade::emitter()->testFinished(
TestMethodBuilder::fromTestCase($test),
0,
);
}
} catch (ErrorException $e) {
restore_error_handler();
$childResult = false;
$exception = new Exception(trim($stdout), 0, $e);
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
}
if ($childResult !== false) {
if (!empty($childResult['output'])) {
$output = $childResult['output'];
}
Facade::instance()->forward($childResult['events']);
PassedTests::instance()->import($childResult['passedTests']);
assert($test instanceof TestCase);
$test->setResult($childResult['testResult']);
$test->addToAssertionCount($childResult['numAssertions']);
if (CodeCoverage::instance()->isActive() && $childResult['codeCoverage'] instanceof \SebastianBergmann\CodeCoverage\CodeCoverage) {
CodeCoverage::instance()->codeCoverage()->merge(
$childResult['codeCoverage'],
);
}
}
if (!empty($output)) {
print $output;
}
}
}
phpunit/src/Util/PHP/Template/TestCaseMethod.tpl 0000644 00000006226 15243417753 0015557 0 ustar 00 <?php declare(strict_types=1);
use PHPUnit\Event\Facade;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TestRunner\TestResult\PassedTests;
// php://stdout does not obey output buffering. Any output would break
// unserialization of child process results in the parent process.
if (!defined('STDOUT')) {
define('STDOUT', fopen('php://temp', 'w+b'));
define('STDERR', fopen('php://stderr', 'wb'));
}
{iniSettings}
ini_set('display_errors', 'stderr');
set_include_path('{include_path}');
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
function __phpunit_run_isolated_test()
{
$dispatcher = Facade::instance()->initForIsolation(
PHPUnit\Event\Telemetry\HRTime::fromSecondsAndNanoseconds(
{offsetSeconds},
{offsetNanoseconds}
),
{exportObjects},
);
require_once '{filename}';
if ({collectCodeCoverageInformation}) {
CodeCoverage::instance()->init(ConfigurationRegistry::get(), CodeCoverageFilterRegistry::instance(), true);
CodeCoverage::instance()->ignoreLines({linesToBeIgnored});
}
$test = new {className}('{methodName}');
$test->setData('{dataName}', unserialize('{data}'));
$test->setDependencyInput(unserialize('{dependencyInput}'));
$test->setInIsolation(true);
ob_end_clean();
$test->run();
$output = '';
if (!$test->expectsOutput()) {
$output = $test->output();
}
ini_set('xdebug.scream', '0');
// Not every STDOUT target stream is rewindable
@rewind(STDOUT);
if ($stdout = @stream_get_contents(STDOUT)) {
$output = $stdout . $output;
$streamMetaData = stream_get_meta_data(STDOUT);
if (!empty($streamMetaData['stream_type']) && 'STDIO' === $streamMetaData['stream_type']) {
@ftruncate(STDOUT, 0);
@rewind(STDOUT);
}
}
file_put_contents(
'{processResultFile}',
serialize(
[
'testResult' => $test->result(),
'codeCoverage' => {collectCodeCoverageInformation} ? CodeCoverage::instance()->codeCoverage() : null,
'numAssertions' => $test->numberOfAssertionsPerformed(),
'output' => $output,
'events' => $dispatcher->flush(),
'passedTests' => PassedTests::instance()
]
)
);
}
function __phpunit_error_handler($errno, $errstr, $errfile, $errline)
{
return true;
}
set_error_handler('__phpunit_error_handler');
{constants}
{included_files}
{globals}
restore_error_handler();
ConfigurationRegistry::loadFrom('{serializedConfiguration}');
(new PhpHandler)->handle(ConfigurationRegistry::get()->php());
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
__phpunit_run_isolated_test();
phpunit/src/Util/PHP/Template/PhptTestCase.tpl 0000644 00000002243 15243417753 0015245 0 ustar 00 <?php declare(strict_types=1);
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\Selector;
use SebastianBergmann\CodeCoverage\Filter;
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
$GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'][] = '{job}';
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
$coverage = null;
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
if (class_exists('SebastianBergmann\CodeCoverage\CodeCoverage')) {
$filter = new Filter;
$coverage = new CodeCoverage(
(new Selector)->{driverMethod}($filter),
$filter
);
if ({codeCoverageCacheDirectory}) {
$coverage->cacheStaticAnalysis({codeCoverageCacheDirectory});
}
$coverage->start(__FILE__);
}
register_shutdown_function(
function() use ($coverage) {
$output = null;
if ($coverage) {
$output = $coverage->stop();
}
file_put_contents('{coverageFile}', serialize($output));
}
);
ob_end_clean();
require '{job}';
phpunit/src/Util/PHP/Template/TestCaseClass.tpl 0000644 00000006220 15243417753 0015376 0 ustar 00 <?php declare(strict_types=1);
use PHPUnit\Event\Facade;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TestRunner\TestResult\PassedTests;
// php://stdout does not obey output buffering. Any output would break
// unserialization of child process results in the parent process.
if (!defined('STDOUT')) {
define('STDOUT', fopen('php://temp', 'w+b'));
define('STDERR', fopen('php://stderr', 'wb'));
}
{iniSettings}
ini_set('display_errors', 'stderr');
set_include_path('{include_path}');
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
function __phpunit_run_isolated_test()
{
$dispatcher = Facade::instance()->initForIsolation(
PHPUnit\Event\Telemetry\HRTime::fromSecondsAndNanoseconds(
{offsetSeconds},
{offsetNanoseconds}
),
{exportObjects},
);
require_once '{filename}';
if ({collectCodeCoverageInformation}) {
CodeCoverage::instance()->init(ConfigurationRegistry::get(), CodeCoverageFilterRegistry::instance(), true);
CodeCoverage::instance()->ignoreLines({linesToBeIgnored});
}
$test = new {className}('{name}');
$test->setData('{dataName}', unserialize('{data}'));
$test->setDependencyInput(unserialize('{dependencyInput}'));
$test->setInIsolation(true);
ob_end_clean();
$test->run();
$output = '';
if (!$test->expectsOutput()) {
$output = $test->output();
}
ini_set('xdebug.scream', '0');
// Not every STDOUT target stream is rewindable
@rewind(STDOUT);
if ($stdout = @stream_get_contents(STDOUT)) {
$output = $stdout . $output;
$streamMetaData = stream_get_meta_data(STDOUT);
if (!empty($streamMetaData['stream_type']) && 'STDIO' === $streamMetaData['stream_type']) {
@ftruncate(STDOUT, 0);
@rewind(STDOUT);
}
}
file_put_contents(
'{processResultFile}',
serialize(
[
'testResult' => $test->result(),
'codeCoverage' => {collectCodeCoverageInformation} ? CodeCoverage::instance()->codeCoverage() : null,
'numAssertions' => $test->numberOfAssertionsPerformed(),
'output' => $output,
'events' => $dispatcher->flush(),
'passedTests' => PassedTests::instance()
]
)
);
}
function __phpunit_error_handler($errno, $errstr, $errfile, $errline)
{
return true;
}
set_error_handler('__phpunit_error_handler');
{constants}
{included_files}
{globals}
restore_error_handler();
ConfigurationRegistry::loadFrom('{serializedConfiguration}');
(new PhpHandler)->handle(ConfigurationRegistry::get()->php());
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
__phpunit_run_isolated_test();
phpunit/src/Util/PHP/DefaultPhpProcess.php 0000644 00000006717 15243417753 0014520 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use function array_merge;
use function fclose;
use function file_put_contents;
use function fwrite;
use function is_array;
use function is_resource;
use function proc_close;
use function proc_open;
use function stream_get_contents;
use function sys_get_temp_dir;
use function tempnam;
use function unlink;
use PHPUnit\Framework\Exception;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class DefaultPhpProcess extends AbstractPhpProcess
{
private ?string $tempFile = null;
/**
* Runs a single job (PHP code) using a separate PHP process.
*
* @psalm-return array{stdout: string, stderr: string}
*
* @throws Exception
* @throws PhpProcessException
*/
public function runJob(string $job, array $settings = []): array
{
if ($this->stdin) {
if (!($this->tempFile = tempnam(sys_get_temp_dir(), 'phpunit_')) ||
file_put_contents($this->tempFile, $job) === false) {
throw new PhpProcessException(
'Unable to write temporary file',
);
}
$job = $this->stdin;
}
return $this->runProcess($job, $settings);
}
/**
* Handles creating the child process and returning the STDOUT and STDERR.
*
* @psalm-return array{stdout: string, stderr: string}
*
* @throws Exception
* @throws PhpProcessException
*/
protected function runProcess(string $job, array $settings): array
{
$env = null;
if ($this->env) {
$env = $_SERVER ?? [];
unset($env['argv'], $env['argc']);
$env = array_merge($env, $this->env);
foreach ($env as $envKey => $envVar) {
if (is_array($envVar)) {
unset($env[$envKey]);
}
}
}
$pipeSpec = [
0 => ['pipe', 'r'],
1 => ['pipe', 'w'],
2 => ['pipe', 'w'],
];
if ($this->stderrRedirection) {
$pipeSpec[2] = ['redirect', 1];
}
$process = proc_open(
$this->getCommand($settings, $this->tempFile),
$pipeSpec,
$pipes,
null,
$env,
);
if (!is_resource($process)) {
throw new PhpProcessException(
'Unable to spawn worker process',
);
}
if ($job) {
$this->process($pipes[0], $job);
}
fclose($pipes[0]);
$stderr = $stdout = '';
if (isset($pipes[1])) {
$stdout = stream_get_contents($pipes[1]);
fclose($pipes[1]);
}
if (isset($pipes[2])) {
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[2]);
}
proc_close($process);
$this->cleanup();
return ['stdout' => $stdout, 'stderr' => $stderr];
}
/**
* @param resource $pipe
*/
protected function process($pipe, string $job): void
{
fwrite($pipe, $job);
}
protected function cleanup(): void
{
if ($this->tempFile) {
unlink($this->tempFile);
}
}
}
phpunit/src/Util/Exporter.php 0000644 00000002701 15243417753 0012273 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function is_array;
use function is_scalar;
use SebastianBergmann\RecursionContext\Context;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class Exporter
{
public static function export(mixed $value, bool $exportObjects = false): string
{
if (self::isExportable($value) || $exportObjects) {
return (new \SebastianBergmann\Exporter\Exporter)->export($value);
}
return '{enable export of objects to see this value}';
}
private static function isExportable(mixed &$value, ?Context $context = null): bool
{
if (is_scalar($value) || $value === null) {
return true;
}
if (!is_array($value)) {
return false;
}
if (!$context) {
$context = new Context;
}
if ($context->contains($value) !== false) {
return true;
}
$array = $value;
$context->add($value);
foreach ($array as &$_value) {
if (!self::isExportable($_value, $context)) {
return false;
}
}
return true;
}
}
phpunit/src/Util/Exception/PhpProcessException.php 0000644 00000001000 15243417753 0016355 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use PHPUnit\Util\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhpProcessException extends RuntimeException implements Exception
{
}
phpunit/src/Util/Exception/XmlException.php 0000644 00000000771 15243417753 0015045 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\Xml;
use PHPUnit\Util\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class XmlException extends RuntimeException implements Exception
{
}
phpunit/src/Util/Exception/InvalidJsonException.php 0000644 00000000741 15243417753 0016522 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidJsonException extends RuntimeException implements Exception
{
}
phpunit/src/Util/Exception/InvalidDirectoryException.php 0000644 00000001316 15243417753 0017554 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDirectoryException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'"%s" is not a directory',
$directory,
),
);
}
}
phpunit/src/Util/Exception/InvalidVersionOperatorException.php 0000644 00000001351 15243417753 0020750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidVersionOperatorException extends RuntimeException implements Exception
{
public function __construct(string $operator)
{
parent::__construct(
sprintf(
'"%s" is not a valid version_compare() operator',
$operator,
),
);
}
}
phpunit/src/Util/Exception/Exception.php 0000644 00000000665 15243417753 0014366 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use Throwable;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
phpunit/src/Util/Filter.php 0000644 00000006646 15243417753 0011724 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function array_unshift;
use function defined;
use function in_array;
use function is_file;
use function realpath;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\PhptAssertionFailedError;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Filter
{
/**
* @throws Exception
*/
public static function getFilteredStacktrace(Throwable $t, bool $unwrap = true): string
{
$filteredStacktrace = '';
if ($t instanceof PhptAssertionFailedError) {
$eTrace = $t->syntheticTrace();
$eFile = $t->syntheticFile();
$eLine = $t->syntheticLine();
} elseif ($t instanceof Exception) {
$eTrace = $t->getSerializableTrace();
$eFile = $t->getFile();
$eLine = $t->getLine();
} else {
if ($unwrap && $t->getPrevious()) {
$t = $t->getPrevious();
}
$eTrace = $t->getTrace();
$eFile = $t->getFile();
$eLine = $t->getLine();
}
if (!self::frameExists($eTrace, $eFile, $eLine)) {
array_unshift(
$eTrace,
['file' => $eFile, 'line' => $eLine],
);
}
$prefix = defined('__PHPUNIT_PHAR_ROOT__') ? __PHPUNIT_PHAR_ROOT__ : false;
$excludeList = new ExcludeList;
foreach ($eTrace as $frame) {
if (self::shouldPrintFrame($frame, $prefix, $excludeList)) {
$filteredStacktrace .= sprintf(
"%s:%s\n",
$frame['file'],
$frame['line'] ?? '?',
);
}
}
return $filteredStacktrace;
}
private static function shouldPrintFrame(array $frame, false|string $prefix, ExcludeList $excludeList): bool
{
if (!isset($frame['file'])) {
return false;
}
$file = $frame['file'];
$fileIsNotPrefixed = $prefix === false || !str_starts_with($file, $prefix);
// @see https://github.com/sebastianbergmann/phpunit/issues/4033
if (isset($GLOBALS['_SERVER']['SCRIPT_NAME'])) {
$script = realpath($GLOBALS['_SERVER']['SCRIPT_NAME']);
} else {
$script = '';
}
return $fileIsNotPrefixed &&
$file !== $script &&
self::fileIsExcluded($file, $excludeList) &&
is_file($file);
}
private static function fileIsExcluded(string $file, ExcludeList $excludeList): bool
{
return (empty($GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST']) ||
!in_array($file, $GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'], true)) &&
!$excludeList->isExcluded($file);
}
private static function frameExists(array $trace, string $file, int $line): bool
{
foreach ($trace as $frame) {
if (isset($frame['file'], $frame['line']) && $frame['file'] === $file && $frame['line'] === $line) {
return true;
}
}
return false;
}
}
phpunit/src/Util/Color.php 0000644 00000011207 15243417753 0011542 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const DIRECTORY_SEPARATOR;
use const PHP_EOL;
use function array_map;
use function count;
use function explode;
use function implode;
use function max;
use function min;
use function preg_replace;
use function preg_replace_callback;
use function preg_split;
use function sprintf;
use function str_pad;
use function strtr;
use function trim;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Color
{
/**
* @psalm-var array<string,string>
*/
private const WHITESPACE_MAP = [
' ' => '·',
"\t" => '⇥',
];
/**
* @psalm-var array<string,string>
*/
private const WHITESPACE_EOL_MAP = [
' ' => '·',
"\t" => '⇥',
"\n" => '↵',
"\r" => '⟵',
];
/**
* @psalm-var array<string,string>
*/
private static array $ansiCodes = [
'reset' => '0',
'bold' => '1',
'dim' => '2',
'dim-reset' => '22',
'underlined' => '4',
'fg-default' => '39',
'fg-black' => '30',
'fg-red' => '31',
'fg-green' => '32',
'fg-yellow' => '33',
'fg-blue' => '34',
'fg-magenta' => '35',
'fg-cyan' => '36',
'fg-white' => '37',
'bg-default' => '49',
'bg-black' => '40',
'bg-red' => '41',
'bg-green' => '42',
'bg-yellow' => '43',
'bg-blue' => '44',
'bg-magenta' => '45',
'bg-cyan' => '46',
'bg-white' => '47',
];
public static function colorize(string $color, string $buffer): string
{
if (trim($buffer) === '') {
return $buffer;
}
$codes = array_map('\trim', explode(',', $color));
$styles = [];
foreach ($codes as $code) {
if (isset(self::$ansiCodes[$code])) {
$styles[] = self::$ansiCodes[$code] ?? '';
}
}
if (empty($styles)) {
return $buffer;
}
return self::optimizeColor(sprintf("\x1b[%sm", implode(';', $styles)) . $buffer . "\x1b[0m");
}
public static function colorizeTextBox(string $color, string $buffer): string
{
$lines = preg_split('/\r\n|\r|\n/', $buffer);
$padding = max(array_map('\strlen', $lines));
$styledLines = [];
foreach ($lines as $line) {
$styledLines[] = self::colorize($color, str_pad($line, $padding));
}
return implode(PHP_EOL, $styledLines);
}
public static function colorizePath(string $path, ?string $previousPath = null, bool $colorizeFilename = false): string
{
if ($previousPath === null) {
$previousPath = '';
}
$path = explode(DIRECTORY_SEPARATOR, $path);
$previousPath = explode(DIRECTORY_SEPARATOR, $previousPath);
for ($i = 0; $i < min(count($path), count($previousPath)); $i++) {
if ($path[$i] === $previousPath[$i]) {
$path[$i] = self::dim($path[$i]);
}
}
if ($colorizeFilename) {
$last = count($path) - 1;
$path[$last] = preg_replace_callback(
'/([\-_.]+|phpt$)/',
static fn ($matches) => self::dim($matches[0]),
$path[$last],
);
}
return self::optimizeColor(implode(self::dim(DIRECTORY_SEPARATOR), $path));
}
public static function dim(string $buffer): string
{
if (trim($buffer) === '') {
return $buffer;
}
return "\e[2m{$buffer}\e[22m";
}
public static function visualizeWhitespace(string $buffer, bool $visualizeEOL = false): string
{
$replaceMap = $visualizeEOL ? self::WHITESPACE_EOL_MAP : self::WHITESPACE_MAP;
return preg_replace_callback(
'/\s+/',
static fn ($matches) => self::dim(strtr($matches[0], $replaceMap)),
$buffer,
);
}
private static function optimizeColor(string $buffer): string
{
return preg_replace(
[
"/\e\\[22m\e\\[2m/",
"/\e\\[([^m]*)m\e\\[([1-9][0-9;]*)m/",
"/(\e\\[[^m]*m)+(\e\\[0m)/",
],
[
'',
"\e[$1;$2m",
'$2',
],
$buffer,
);
}
}
phpunit/src/Util/Filesystem.php 0000644 00000002306 15243417753 0012610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function basename;
use function dirname;
use function is_dir;
use function mkdir;
use function realpath;
use function str_starts_with;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Filesystem
{
public static function createDirectory(string $directory): bool
{
return !(!is_dir($directory) && !@mkdir($directory, 0o777, true) && !is_dir($directory));
}
/**
* @psalm-param non-empty-string $path
*
* @return false|non-empty-string
*/
public static function resolveStreamOrFile(string $path): false|string
{
if (str_starts_with($path, 'php://') || str_starts_with($path, 'socket://')) {
return $path;
}
$directory = dirname($path);
if (is_dir($directory)) {
return realpath($directory) . DIRECTORY_SEPARATOR . basename($path);
}
return false;
}
}
phpunit/src/Util/ExcludeList.php 0000644 00000013216 15243417753 0012713 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function class_exists;
use function defined;
use function dirname;
use function is_dir;
use function realpath;
use function str_starts_with;
use function sys_get_temp_dir;
use Composer\Autoload\ClassLoader;
use DeepCopy\DeepCopy;
use PharIo\Manifest\Manifest;
use PharIo\Version\Version as PharIoVersion;
use PhpParser\Parser;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
use SebastianBergmann\CliParser\Parser as CliParser;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeUnit\CodeUnit;
use SebastianBergmann\CodeUnitReverseLookup\Wizard;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Complexity\Calculator;
use SebastianBergmann\Diff\Diff;
use SebastianBergmann\Environment\Runtime;
use SebastianBergmann\Exporter\Exporter;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use SebastianBergmann\GlobalState\Snapshot;
use SebastianBergmann\Invoker\Invoker;
use SebastianBergmann\LinesOfCode\Counter;
use SebastianBergmann\ObjectEnumerator\Enumerator;
use SebastianBergmann\ObjectReflector\ObjectReflector;
use SebastianBergmann\RecursionContext\Context;
use SebastianBergmann\Template\Template;
use SebastianBergmann\Timer\Timer;
use SebastianBergmann\Type\TypeName;
use SebastianBergmann\Version;
use TheSeer\Tokenizer\Tokenizer;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeList
{
/**
* @psalm-var array<string,int>
*/
private const EXCLUDED_CLASS_NAMES = [
// composer
ClassLoader::class => 1,
// myclabs/deepcopy
DeepCopy::class => 1,
// nikic/php-parser
Parser::class => 1,
// phar-io/manifest
Manifest::class => 1,
// phar-io/version
PharIoVersion::class => 1,
// phpunit/phpunit
TestCase::class => 2,
// phpunit/php-code-coverage
CodeCoverage::class => 1,
// phpunit/php-file-iterator
FileIteratorFacade::class => 1,
// phpunit/php-invoker
Invoker::class => 1,
// phpunit/php-text-template
Template::class => 1,
// phpunit/php-timer
Timer::class => 1,
// sebastian/cli-parser
CliParser::class => 1,
// sebastian/code-unit
CodeUnit::class => 1,
// sebastian/code-unit-reverse-lookup
Wizard::class => 1,
// sebastian/comparator
Comparator::class => 1,
// sebastian/complexity
Calculator::class => 1,
// sebastian/diff
Diff::class => 1,
// sebastian/environment
Runtime::class => 1,
// sebastian/exporter
Exporter::class => 1,
// sebastian/global-state
Snapshot::class => 1,
// sebastian/lines-of-code
Counter::class => 1,
// sebastian/object-enumerator
Enumerator::class => 1,
// sebastian/object-reflector
ObjectReflector::class => 1,
// sebastian/recursion-context
Context::class => 1,
// sebastian/type
TypeName::class => 1,
// sebastian/version
Version::class => 1,
// theseer/tokenizer
Tokenizer::class => 1,
];
/**
* @psalm-var list<string>
*/
private static array $directories = [];
private static bool $initialized = false;
private readonly bool $enabled;
/**
* @psalm-param non-empty-string $directory
*
* @throws InvalidDirectoryException
*/
public static function addDirectory(string $directory): void
{
if (!is_dir($directory)) {
throw new InvalidDirectoryException($directory);
}
self::$directories[] = realpath($directory);
}
public function __construct(?bool $enabled = null)
{
if ($enabled === null) {
$enabled = !defined('PHPUNIT_TESTSUITE');
}
$this->enabled = $enabled;
}
/**
* @psalm-return list<string>
*/
public function getExcludedDirectories(): array
{
self::initialize();
return self::$directories;
}
public function isExcluded(string $file): bool
{
if (!$this->enabled) {
return false;
}
self::initialize();
foreach (self::$directories as $directory) {
if (str_starts_with($file, $directory)) {
return true;
}
}
return false;
}
private static function initialize(): void
{
if (self::$initialized) {
return;
}
foreach (self::EXCLUDED_CLASS_NAMES as $className => $parent) {
if (!class_exists($className)) {
continue;
}
$directory = (new ReflectionClass($className))->getFileName();
for ($i = 0; $i < $parent; $i++) {
$directory = dirname($directory);
}
self::$directories[] = $directory;
}
/**
* Hide process isolation workaround on Windows:
* tempnam() prefix is limited to first 3 characters.
*
* @see https://php.net/manual/en/function.tempnam.php
*/
if (PHP_OS_FAMILY === 'Windows') {
// @codeCoverageIgnoreStart
self::$directories[] = sys_get_temp_dir() . '\\PHP';
// @codeCoverageIgnoreEnd
}
self::$initialized = true;
}
}
phpunit/src/Util/Xml/Loader.php 0000644 00000006130 15243417753 0012431 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\Xml;
use function chdir;
use function dirname;
use function error_reporting;
use function file_get_contents;
use function getcwd;
use function libxml_get_errors;
use function libxml_use_internal_errors;
use function sprintf;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Loader
{
/**
* @throws XmlException
*/
public function loadFile(string $filename): DOMDocument
{
$reporting = error_reporting(0);
$contents = file_get_contents($filename);
error_reporting($reporting);
if ($contents === false) {
throw new XmlException(
sprintf(
'Could not read XML from file "%s"',
$filename,
),
);
}
return $this->load($contents, $filename);
}
/**
* @throws XmlException
*/
public function load(string $actual, ?string $filename = null): DOMDocument
{
if ($actual === '') {
if ($filename === null) {
throw new XmlException('Could not parse XML from empty string');
}
throw new XmlException(
sprintf(
'Could not parse XML from empty file "%s"',
$filename,
),
);
}
$document = new DOMDocument;
$document->preserveWhiteSpace = false;
$internal = libxml_use_internal_errors(true);
$message = '';
$reporting = error_reporting(0);
// Required for XInclude
if ($filename !== null) {
// Required for XInclude on Windows
if (PHP_OS_FAMILY === 'Windows') {
$cwd = getcwd();
@chdir(dirname($filename));
}
$document->documentURI = $filename;
}
$loaded = $document->loadXML($actual);
if ($filename !== null) {
$document->xinclude();
}
foreach (libxml_get_errors() as $error) {
$message .= "\n" . $error->message;
}
libxml_use_internal_errors($internal);
error_reporting($reporting);
if (isset($cwd)) {
@chdir($cwd);
}
if ($loaded === false || $message !== '') {
if ($filename !== null) {
throw new XmlException(
sprintf(
'Could not load "%s"%s',
$filename,
$message !== '' ? ":\n" . $message : '',
),
);
}
if ($message === '') {
$message = 'Could not load XML for unknown reason';
}
throw new XmlException($message);
}
return $document;
}
}
phpunit/src/Util/Xml/Xml.php 0000644 00000004051 15243417753 0011763 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const ENT_QUOTES;
use function htmlspecialchars;
use function mb_convert_encoding;
use function ord;
use function preg_replace;
use function strlen;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Xml
{
/**
* Escapes a string for the use in XML documents.
*
* Any Unicode character is allowed, excluding the surrogate blocks, FFFE,
* and FFFF (not even as character reference).
*
* @see https://www.w3.org/TR/xml/#charsets
*/
public static function prepareString(string $string): string
{
return preg_replace(
'/[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f]/',
'',
htmlspecialchars(
self::convertToUtf8($string),
ENT_QUOTES,
),
);
}
private static function convertToUtf8(string $string): string
{
if (!self::isUtf8($string)) {
$string = mb_convert_encoding($string, 'UTF-8');
}
return $string;
}
private static function isUtf8(string $string): bool
{
$length = strlen($string);
for ($i = 0; $i < $length; $i++) {
if (ord($string[$i]) < 0x80) {
$n = 0;
} elseif ((ord($string[$i]) & 0xE0) === 0xC0) {
$n = 1;
} elseif ((ord($string[$i]) & 0xF0) === 0xE0) {
$n = 2;
} elseif ((ord($string[$i]) & 0xF0) === 0xF0) {
$n = 3;
} else {
return false;
}
for ($j = 0; $j < $n; $j++) {
if ((++$i === $length) || ((ord($string[$i]) & 0xC0) !== 0x80)) {
return false;
}
}
}
return true;
}
}
phpunit/src/Util/GlobalState.php 0000644 00000021307 15243417753 0012667 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const PHP_MAJOR_VERSION;
use const PHP_MINOR_VERSION;
use function array_keys;
use function array_reverse;
use function array_shift;
use function defined;
use function get_defined_constants;
use function get_included_files;
use function in_array;
use function ini_get_all;
use function is_array;
use function is_file;
use function is_scalar;
use function preg_match;
use function serialize;
use function sprintf;
use function str_ends_with;
use function str_starts_with;
use function strtr;
use function var_export;
use Closure;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GlobalState
{
/**
* @psalm-var list<string>
*/
private const SUPER_GLOBAL_ARRAYS = [
'_ENV',
'_POST',
'_GET',
'_COOKIE',
'_SERVER',
'_FILES',
'_REQUEST',
];
/**
* @psalm-var array<string, array<string, true>>
*/
private const DEPRECATED_INI_SETTINGS = [
'7.3' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.func_overload' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'string.strip_tags' => true,
],
'7.4' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.func_overload' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'pdo_odbc.db2_instance_name' => true,
'string.strip_tags' => true,
],
'8.0' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
],
'8.1' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
'8.2' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
'8.3' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
];
/**
* @throws Exception
*/
public static function getIncludedFilesAsString(): string
{
return self::processIncludedFilesAsString(get_included_files());
}
/**
* @psalm-param list<string> $files
*
* @throws Exception
*/
public static function processIncludedFilesAsString(array $files): string
{
$excludeList = new ExcludeList;
$prefix = false;
$result = '';
if (defined('__PHPUNIT_PHAR__')) {
$prefix = 'phar://' . __PHPUNIT_PHAR__ . '/';
}
// Do not process bootstrap script
array_shift($files);
// If bootstrap script was a Composer bin proxy, skip the second entry as well
if (str_ends_with(strtr($files[0], '\\', '/'), '/phpunit/phpunit/phpunit')) {
array_shift($files);
}
foreach (array_reverse($files) as $file) {
if (!empty($GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST']) &&
in_array($file, $GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'], true)) {
continue;
}
if ($prefix !== false && str_starts_with($file, $prefix)) {
continue;
}
// Skip virtual file system protocols
if (preg_match('/^(vfs|phpvfs[a-z0-9]+):/', $file)) {
continue;
}
if (!$excludeList->isExcluded($file) && is_file($file)) {
$result = 'require_once \'' . $file . "';\n" . $result;
}
}
return $result;
}
public static function getIniSettingsAsString(): string
{
$result = '';
foreach (ini_get_all(null, false) as $key => $value) {
if (self::isIniSettingDeprecated($key)) {
continue;
}
$result .= sprintf(
'@ini_set(%s, %s);' . "\n",
self::exportVariable($key),
self::exportVariable((string) $value),
);
}
return $result;
}
public static function getConstantsAsString(): string
{
$constants = get_defined_constants(true);
$result = '';
if (isset($constants['user'])) {
foreach ($constants['user'] as $name => $value) {
$result .= sprintf(
'if (!defined(\'%s\')) define(\'%s\', %s);' . "\n",
$name,
$name,
self::exportVariable($value),
);
}
}
return $result;
}
public static function getGlobalsAsString(): string
{
$result = '';
foreach (self::SUPER_GLOBAL_ARRAYS as $superGlobalArray) {
if (isset($GLOBALS[$superGlobalArray]) && is_array($GLOBALS[$superGlobalArray])) {
foreach (array_keys($GLOBALS[$superGlobalArray]) as $key) {
if ($GLOBALS[$superGlobalArray][$key] instanceof Closure) {
continue;
}
$result .= sprintf(
'$GLOBALS[\'%s\'][\'%s\'] = %s;' . "\n",
$superGlobalArray,
$key,
self::exportVariable($GLOBALS[$superGlobalArray][$key]),
);
}
}
}
$excludeList = self::SUPER_GLOBAL_ARRAYS;
$excludeList[] = 'GLOBALS';
foreach (array_keys($GLOBALS) as $key) {
if (!$GLOBALS[$key] instanceof Closure && !in_array($key, $excludeList, true)) {
$result .= sprintf(
'$GLOBALS[\'%s\'] = %s;' . "\n",
$key,
self::exportVariable($GLOBALS[$key]),
);
}
}
return $result;
}
private static function exportVariable(mixed $variable): string
{
if (is_scalar($variable) || $variable === null ||
(is_array($variable) && self::arrayOnlyContainsScalars($variable))) {
return var_export($variable, true);
}
return 'unserialize(' . var_export(serialize($variable), true) . ')';
}
private static function arrayOnlyContainsScalars(array $array): bool
{
$result = true;
foreach ($array as $element) {
if (is_array($element)) {
$result = self::arrayOnlyContainsScalars($element);
} elseif (!is_scalar($element) && $element !== null) {
$result = false;
}
if (!$result) {
break;
}
}
return $result;
}
private static function isIniSettingDeprecated(string $iniSetting): bool
{
return isset(self::DEPRECATED_INI_SETTINGS[PHP_MAJOR_VERSION . '.' . PHP_MINOR_VERSION][$iniSetting]);
}
}
phpunit/src/Event/Tracer.php 0000644 00000000755 15243417753 0012056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Tracer;
use PHPUnit\Event\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Tracer
{
public function trace(Event $event): void;
}
phpunit/src/Event/Emitter/DispatchingEmitter.php 0000644 00000102264 15243417753 0016034 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Test\DataProviderMethodCalled;
use PHPUnit\Event\Test\DataProviderMethodFinished;
use PHPUnit\Event\TestSuite\Filtered as TestSuiteFiltered;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Loaded as TestSuiteLoaded;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\Event\TestSuite\Sorted as TestSuiteSorted;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuite;
use PHPUnit\Framework\Constraint;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DispatchingEmitter implements Emitter
{
private readonly Dispatcher $dispatcher;
private readonly Telemetry\System $system;
private readonly Telemetry\Snapshot $startSnapshot;
private Telemetry\Snapshot $previousSnapshot;
private bool $exportObjects = false;
public function __construct(Dispatcher $dispatcher, Telemetry\System $system)
{
$this->dispatcher = $dispatcher;
$this->system = $system;
$this->startSnapshot = $system->snapshot();
$this->previousSnapshot = $this->startSnapshot;
}
/**
* @deprecated
*/
public function exportObjects(): void
{
$this->exportObjects = true;
}
/**
* @deprecated
*/
public function exportsObjects(): bool
{
return $this->exportObjects;
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function applicationStarted(): void
{
$this->dispatcher->dispatch(
new Application\Started(
$this->telemetryInfo(),
new Runtime\Runtime,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerStarted(): void
{
$this->dispatcher->dispatch(
new TestRunner\Started(
$this->telemetryInfo(),
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerConfigured(Configuration $configuration): void
{
$this->dispatcher->dispatch(
new TestRunner\Configured(
$this->telemetryInfo(),
$configuration,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerBootstrapFinished(string $filename): void
{
$this->dispatcher->dispatch(
new TestRunner\BootstrapFinished(
$this->telemetryInfo(),
$filename,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerLoadedExtensionFromPhar(string $filename, string $name, string $version): void
{
$this->dispatcher->dispatch(
new TestRunner\ExtensionLoadedFromPhar(
$this->telemetryInfo(),
$filename,
$name,
$version,
),
);
}
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerBootstrappedExtension(string $className, array $parameters): void
{
$this->dispatcher->dispatch(
new TestRunner\ExtensionBootstrapped(
$this->telemetryInfo(),
$className,
$parameters,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function dataProviderMethodCalled(ClassMethod $testMethod, ClassMethod $dataProviderMethod): void
{
$this->dispatcher->dispatch(
new DataProviderMethodCalled(
$this->telemetryInfo(),
$testMethod,
$dataProviderMethod,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function dataProviderMethodFinished(ClassMethod $testMethod, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new DataProviderMethodFinished(
$this->telemetryInfo(),
$testMethod,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteLoaded(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteLoaded(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteFiltered(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteFiltered(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteSorted(int $executionOrder, int $executionOrderDefects, bool $resolveDependencies): void
{
$this->dispatcher->dispatch(
new TestSuiteSorted(
$this->telemetryInfo(),
$executionOrder,
$executionOrderDefects,
$resolveDependencies,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerEventFacadeSealed(): void
{
$this->dispatcher->dispatch(
new TestRunner\EventFacadeSealed(
$this->telemetryInfo(),
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionStarted(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionStarted(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerDisabledGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionDisabled($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionTriggered($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteSkipped(TestSuite $testSuite, string $message): void
{
$this->dispatcher->dispatch(
new TestSuiteSkipped(
$this->telemetryInfo(),
$testSuite,
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteStarted(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteStarted(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreparationStarted(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\PreparationStarted(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreparationFailed(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\PreparationFailed(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodErrored(string $testClassName, ClassMethod $calledMethod, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodErrored(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
$throwable,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\BeforeTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\BeforeTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreConditionCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\PreConditionCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\PreConditionFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPrepared(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\Prepared(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRegisteredComparator(string $className): void
{
$this->dispatcher->dispatch(
new Test\ComparatorRegistered(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*
* @deprecated
*/
public function testAssertionSucceeded(mixed $value, Constraint\Constraint $constraint, string $message): void
{
$this->dispatcher->dispatch(
new Test\AssertionSucceeded(
$this->telemetryInfo(),
Exporter::export($value, $this->exportObjects),
$constraint->toString($this->exportObjects),
$constraint->count(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*
* @deprecated
*/
public function testAssertionFailed(mixed $value, Constraint\Constraint $constraint, string $message): void
{
$this->dispatcher->dispatch(
new Test\AssertionFailed(
$this->telemetryInfo(),
Exporter::export($value, $this->exportObjects),
$constraint->toString($this->exportObjects),
$constraint->count(),
$message,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObject(string $className): void
{
$this->dispatcher->dispatch(
new Test\MockObjectCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForIntersectionOfInterfaces(array $interfaces): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForIntersectionOfInterfacesCreated(
$this->telemetryInfo(),
$interfaces,
),
);
}
/**
* @psalm-param trait-string $traitName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForTrait(string $traitName): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForTraitCreated(
$this->telemetryInfo(),
$traitName,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForAbstractClass(string $className): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForAbstractClassCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectFromWsdl(string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options): void
{
$this->dispatcher->dispatch(
new Test\MockObjectFromWsdlCreated(
$this->telemetryInfo(),
$wsdlFile,
$originalClassName,
$mockClassName,
$methods,
$callOriginalConstructor,
$options,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedPartialMockObject(string $className, string ...$methodNames): void
{
$this->dispatcher->dispatch(
new Test\PartialMockObjectCreated(
$this->telemetryInfo(),
$className,
...$methodNames,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedTestProxy(string $className, array $constructorArguments): void
{
$this->dispatcher->dispatch(
new Test\TestProxyCreated(
$this->telemetryInfo(),
$className,
Exporter::export($constructorArguments, $this->exportObjects),
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedStub(string $className): void
{
$this->dispatcher->dispatch(
new Test\TestStubCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedStubForIntersectionOfInterfaces(array $interfaces): void
{
$this->dispatcher->dispatch(
new Test\TestStubForIntersectionOfInterfacesCreated(
$this->telemetryInfo(),
$interfaces,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testErrored(Code\Test $test, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\Errored(
$this->telemetryInfo(),
$test,
$throwable,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testFailed(Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure): void
{
$this->dispatcher->dispatch(
new Test\Failed(
$this->telemetryInfo(),
$test,
$throwable,
$comparisonFailure,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPassed(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\Passed(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testConsideredRisky(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\ConsideredRisky(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testMarkedAsIncomplete(Code\Test $test, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\MarkedIncomplete(
$this->telemetryInfo(),
$test,
$throwable,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSkipped(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\Skipped(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitDeprecation(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitDeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void
{
$this->dispatcher->dispatch(
new Test\PhpDeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void
{
$this->dispatcher->dispatch(
new Test\DeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredError(Code\Test $test, string $message, string $file, int $line, bool $suppressed): void
{
$this->dispatcher->dispatch(
new Test\ErrorTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\NoticeTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\PhpNoticeTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\WarningTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\PhpWarningTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitError(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitErrorTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitWarning(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitWarningTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $output
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPrintedUnexpectedOutput(string $output): void
{
$this->dispatcher->dispatch(
new Test\PrintedUnexpectedOutput(
$this->telemetryInfo(),
$output,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testFinished(Code\Test $test, int $numberOfAssertionsPerformed): void
{
$this->dispatcher->dispatch(
new Test\Finished(
$this->telemetryInfo(),
$test,
$numberOfAssertionsPerformed,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPostConditionCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\PostConditionCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPostConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\PostConditionFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\AfterTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\AfterTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterLastTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\AfterLastTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterLastTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\AfterLastTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteFinished(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteFinished(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredDeprecation(string $message): void
{
$this->dispatcher->dispatch(
new TestRunner\DeprecationTriggered(
$this->telemetryInfo(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredWarning(string $message): void
{
$this->dispatcher->dispatch(
new TestRunner\WarningTriggered(
$this->telemetryInfo(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerEnabledGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionEnabled($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionAborted(): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionAborted($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionFinished(): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionFinished($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerFinished(): void
{
$this->dispatcher->dispatch(
new TestRunner\Finished($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function applicationFinished(int $shellExitCode): void
{
$this->dispatcher->dispatch(
new Application\Finished(
$this->telemetryInfo(),
$shellExitCode,
),
);
}
/**
* @throws InvalidArgumentException
*/
private function telemetryInfo(): Telemetry\Info
{
$current = $this->system->snapshot();
$info = new Telemetry\Info(
$current,
$current->time()->duration($this->startSnapshot->time()),
$current->memoryUsage()->diff($this->startSnapshot->memoryUsage()),
$current->time()->duration($this->previousSnapshot->time()),
$current->memoryUsage()->diff($this->previousSnapshot->memoryUsage()),
);
$this->previousSnapshot = $current;
return $info;
}
}
phpunit/src/Event/Emitter/Emitter.php 0000644 00000024446 15243417753 0013663 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\TestSuite\TestSuite;
use PHPUnit\Framework\Constraint;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Emitter
{
/**
* @deprecated
*/
public function exportObjects(): void;
/**
* @deprecated
*/
public function exportsObjects(): bool;
public function applicationStarted(): void;
public function testRunnerStarted(): void;
public function testRunnerConfigured(Configuration $configuration): void;
public function testRunnerBootstrapFinished(string $filename): void;
public function testRunnerLoadedExtensionFromPhar(string $filename, string $name, string $version): void;
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function testRunnerBootstrappedExtension(string $className, array $parameters): void;
public function dataProviderMethodCalled(ClassMethod $testMethod, ClassMethod $dataProviderMethod): void;
public function dataProviderMethodFinished(ClassMethod $testMethod, ClassMethod ...$calledMethods): void;
public function testSuiteLoaded(TestSuite $testSuite): void;
public function testSuiteFiltered(TestSuite $testSuite): void;
public function testSuiteSorted(int $executionOrder, int $executionOrderDefects, bool $resolveDependencies): void;
public function testRunnerEventFacadeSealed(): void;
public function testRunnerExecutionStarted(TestSuite $testSuite): void;
public function testRunnerDisabledGarbageCollection(): void;
public function testRunnerTriggeredGarbageCollection(): void;
public function testSuiteSkipped(TestSuite $testSuite, string $message): void;
public function testSuiteStarted(TestSuite $testSuite): void;
public function testPreparationStarted(Code\Test $test): void;
public function testPreparationFailed(Code\Test $test): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodErrored(string $testClassName, ClassMethod $calledMethod, Throwable $throwable): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPreConditionCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPreConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void;
public function testPrepared(Code\Test $test): void;
/**
* @psalm-param class-string $className
*/
public function testRegisteredComparator(string $className): void;
/**
* @deprecated
*/
public function testAssertionSucceeded(mixed $value, Constraint\Constraint $constraint, string $message): void;
/**
* @deprecated
*/
public function testAssertionFailed(mixed $value, Constraint\Constraint $constraint, string $message): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedMockObject(string $className): void;
/**
* @psalm-param list<class-string> $interfaces
*/
public function testCreatedMockObjectForIntersectionOfInterfaces(array $interfaces): void;
/**
* @psalm-param trait-string $traitName
*/
public function testCreatedMockObjectForTrait(string $traitName): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedMockObjectForAbstractClass(string $className): void;
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*/
public function testCreatedMockObjectFromWsdl(string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedPartialMockObject(string $className, string ...$methodNames): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedTestProxy(string $className, array $constructorArguments): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedStub(string $className): void;
/**
* @psalm-param list<class-string> $interfaces
*/
public function testCreatedStubForIntersectionOfInterfaces(array $interfaces): void;
public function testErrored(Code\Test $test, Throwable $throwable): void;
public function testFailed(Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure): void;
public function testPassed(Code\Test $test): void;
/**
* @psalm-param non-empty-string $message
*/
public function testConsideredRisky(Code\Test $test, string $message): void;
public function testMarkedAsIncomplete(Code\Test $test, Throwable $throwable): void;
/**
* @psalm-param non-empty-string $message
*/
public function testSkipped(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitDeprecation(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredError(Code\Test $test, string $message, string $file, int $line, bool $suppressed): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitError(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitWarning(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $output
*/
public function testPrintedUnexpectedOutput(string $output): void;
public function testFinished(Code\Test $test, int $numberOfAssertionsPerformed): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPostConditionCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPostConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterLastTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterLastTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
public function testSuiteFinished(TestSuite $testSuite): void;
public function testRunnerTriggeredDeprecation(string $message): void;
public function testRunnerTriggeredWarning(string $message): void;
public function testRunnerEnabledGarbageCollection(): void;
public function testRunnerExecutionAborted(): void;
public function testRunnerExecutionFinished(): void;
public function testRunnerFinished(): void;
public function applicationFinished(int $shellExitCode): void;
}
phpunit/src/Event/Dispatcher/DirectDispatcher.php 0000644 00000007022 15243417753 0016137 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function array_key_exists;
use function dirname;
use function sprintf;
use function str_starts_with;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectDispatcher implements SubscribableDispatcher
{
private readonly TypeMap $typeMap;
/**
* @psalm-var array<class-string, list<Subscriber>>
*/
private array $subscribers = [];
/**
* @psalm-var list<Tracer\Tracer>
*/
private array $tracers = [];
public function __construct(TypeMap $map)
{
$this->typeMap = $map;
}
public function registerTracer(Tracer\Tracer $tracer): void
{
$this->tracers[] = $tracer;
}
/**
* @throws MapError
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
if (!$this->typeMap->isKnownSubscriberType($subscriber)) {
throw new UnknownSubscriberTypeException(
sprintf(
'Subscriber "%s" does not implement any known interface - did you forget to register it?',
$subscriber::class,
),
);
}
$eventClassName = $this->typeMap->map($subscriber);
if (!array_key_exists($eventClassName, $this->subscribers)) {
$this->subscribers[$eventClassName] = [];
}
$this->subscribers[$eventClassName][] = $subscriber;
}
/**
* @throws Throwable
* @throws UnknownEventTypeException
*/
public function dispatch(Event $event): void
{
$eventClassName = $event::class;
if (!$this->typeMap->isKnownEventType($event)) {
throw new UnknownEventTypeException(
sprintf(
'Unknown event type "%s"',
$eventClassName,
),
);
}
foreach ($this->tracers as $tracer) {
try {
$tracer->trace($event);
// @codeCoverageIgnoreStart
} catch (Throwable $t) {
$this->handleThrowable($t);
}
// @codeCoverageIgnoreEnd
}
if (!array_key_exists($eventClassName, $this->subscribers)) {
return;
}
foreach ($this->subscribers[$eventClassName] as $subscriber) {
try {
$subscriber->notify($event);
} catch (Throwable $t) {
$this->handleThrowable($t);
}
}
}
/**
* @throws Throwable
*/
public function handleThrowable(Throwable $t): void
{
if ($this->isThrowableFromThirdPartySubscriber($t)) {
Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Exception in third-party event subscriber: %s%s%s',
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
),
);
return;
}
// @codeCoverageIgnoreStart
throw $t;
// @codeCoverageIgnoreEnd
}
private function isThrowableFromThirdPartySubscriber(Throwable $t): bool
{
return !str_starts_with($t->getFile(), dirname(__DIR__, 2));
}
}
phpunit/src/Event/Dispatcher/SubscribableDispatcher.php 0000644 00000001172 15243417753 0017325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface SubscribableDispatcher extends Dispatcher
{
/**
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void;
public function registerTracer(Tracer\Tracer $tracer): void;
}
phpunit/src/Event/Dispatcher/Dispatcher.php 0000644 00000001000 15243417753 0014772 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Dispatcher
{
/**
* @throws UnknownEventTypeException
*/
public function dispatch(Event $event): void;
}
phpunit/src/Event/Dispatcher/CollectingDispatcher.php 0000644 00000001470 15243417753 0017011 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CollectingDispatcher implements Dispatcher
{
private EventCollection $events;
public function __construct()
{
$this->events = new EventCollection;
}
public function dispatch(Event $event): void
{
$this->events->add($event);
}
public function flush(): EventCollection
{
$events = $this->events;
$this->events = new EventCollection;
return $events;
}
}
phpunit/src/Event/Dispatcher/DeferringDispatcher.php 0000644 00000002664 15243417753 0016641 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DeferringDispatcher implements SubscribableDispatcher
{
private readonly SubscribableDispatcher $dispatcher;
private EventCollection $events;
private bool $recording = true;
public function __construct(SubscribableDispatcher $dispatcher)
{
$this->dispatcher = $dispatcher;
$this->events = new EventCollection;
}
public function registerTracer(Tracer\Tracer $tracer): void
{
$this->dispatcher->registerTracer($tracer);
}
public function registerSubscriber(Subscriber $subscriber): void
{
$this->dispatcher->registerSubscriber($subscriber);
}
public function dispatch(Event $event): void
{
if ($this->recording) {
$this->events->add($event);
return;
}
$this->dispatcher->dispatch($event);
}
public function flush(): void
{
$this->recording = false;
foreach ($this->events as $event) {
$this->dispatcher->dispatch($event);
}
$this->events = new EventCollection;
}
}
phpunit/src/Event/Facade.php 0000644 00000020113 15243417753 0011767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function gc_status;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Telemetry\Php81GarbageCollectorStatusProvider;
use PHPUnit\Event\Telemetry\Php83GarbageCollectorStatusProvider;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?self $instance = null;
private Emitter $emitter;
private ?TypeMap $typeMap = null;
private ?DeferringDispatcher $deferringDispatcher = null;
private bool $sealed = false;
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public static function emitter(): Emitter
{
return self::instance()->emitter;
}
public function __construct()
{
$this->emitter = $this->createDispatchingEmitter();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscribers(Subscriber ...$subscribers): void
{
foreach ($subscribers as $subscriber) {
$this->registerSubscriber($subscriber);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
if ($this->sealed) {
throw new EventFacadeIsSealedException;
}
$this->deferredDispatcher()->registerSubscriber($subscriber);
}
/**
* @throws EventFacadeIsSealedException
*/
public function registerTracer(Tracer\Tracer $tracer): void
{
if ($this->sealed) {
throw new EventFacadeIsSealedException;
}
$this->deferredDispatcher()->registerTracer($tracer);
}
/**
* @codeCoverageIgnore
*
* @noinspection PhpUnused
*/
public function initForIsolation(HRTime $offset, bool $exportObjects): CollectingDispatcher
{
$dispatcher = new CollectingDispatcher;
$this->emitter = new DispatchingEmitter(
$dispatcher,
new Telemetry\System(
new Telemetry\SystemStopWatchWithOffset($offset),
new Telemetry\SystemMemoryMeter,
$this->garbageCollectorStatusProvider(),
),
);
if ($exportObjects) {
$this->emitter->exportObjects();
}
$this->sealed = true;
return $dispatcher;
}
public function forward(EventCollection $events): void
{
$dispatcher = $this->deferredDispatcher();
foreach ($events as $event) {
$dispatcher->dispatch($event);
}
}
public function seal(): void
{
$this->deferredDispatcher()->flush();
$this->sealed = true;
$this->emitter->testRunnerEventFacadeSealed();
}
private function createDispatchingEmitter(): DispatchingEmitter
{
return new DispatchingEmitter(
$this->deferredDispatcher(),
$this->createTelemetrySystem(),
);
}
private function createTelemetrySystem(): Telemetry\System
{
return new Telemetry\System(
new Telemetry\SystemStopWatch,
new Telemetry\SystemMemoryMeter,
$this->garbageCollectorStatusProvider(),
);
}
private function deferredDispatcher(): DeferringDispatcher
{
if ($this->deferringDispatcher === null) {
$this->deferringDispatcher = new DeferringDispatcher(
new DirectDispatcher($this->typeMap()),
);
}
return $this->deferringDispatcher;
}
private function typeMap(): TypeMap
{
if ($this->typeMap === null) {
$typeMap = new TypeMap;
$this->registerDefaultTypes($typeMap);
$this->typeMap = $typeMap;
}
return $this->typeMap;
}
private function registerDefaultTypes(TypeMap $typeMap): void
{
$defaultEvents = [
Application\Started::class,
Application\Finished::class,
Test\DataProviderMethodCalled::class,
Test\DataProviderMethodFinished::class,
Test\MarkedIncomplete::class,
Test\AfterLastTestMethodCalled::class,
Test\AfterLastTestMethodFinished::class,
Test\AfterTestMethodCalled::class,
Test\AfterTestMethodFinished::class,
Test\AssertionSucceeded::class,
Test\AssertionFailed::class,
Test\BeforeFirstTestMethodCalled::class,
Test\BeforeFirstTestMethodErrored::class,
Test\BeforeFirstTestMethodFinished::class,
Test\BeforeTestMethodCalled::class,
Test\BeforeTestMethodFinished::class,
Test\ComparatorRegistered::class,
Test\ConsideredRisky::class,
Test\DeprecationTriggered::class,
Test\Errored::class,
Test\ErrorTriggered::class,
Test\Failed::class,
Test\Finished::class,
Test\NoticeTriggered::class,
Test\Passed::class,
Test\PhpDeprecationTriggered::class,
Test\PhpNoticeTriggered::class,
Test\PhpunitDeprecationTriggered::class,
Test\PhpunitErrorTriggered::class,
Test\PhpunitWarningTriggered::class,
Test\PhpWarningTriggered::class,
Test\PostConditionCalled::class,
Test\PostConditionFinished::class,
Test\PreConditionCalled::class,
Test\PreConditionFinished::class,
Test\PreparationStarted::class,
Test\Prepared::class,
Test\PreparationFailed::class,
Test\PrintedUnexpectedOutput::class,
Test\Skipped::class,
Test\WarningTriggered::class,
Test\MockObjectCreated::class,
Test\MockObjectForAbstractClassCreated::class,
Test\MockObjectForIntersectionOfInterfacesCreated::class,
Test\MockObjectForTraitCreated::class,
Test\MockObjectFromWsdlCreated::class,
Test\PartialMockObjectCreated::class,
Test\TestProxyCreated::class,
Test\TestStubCreated::class,
Test\TestStubForIntersectionOfInterfacesCreated::class,
TestRunner\BootstrapFinished::class,
TestRunner\Configured::class,
TestRunner\EventFacadeSealed::class,
TestRunner\ExecutionAborted::class,
TestRunner\ExecutionFinished::class,
TestRunner\ExecutionStarted::class,
TestRunner\ExtensionLoadedFromPhar::class,
TestRunner\ExtensionBootstrapped::class,
TestRunner\Finished::class,
TestRunner\Started::class,
TestRunner\DeprecationTriggered::class,
TestRunner\WarningTriggered::class,
TestRunner\GarbageCollectionDisabled::class,
TestRunner\GarbageCollectionTriggered::class,
TestRunner\GarbageCollectionEnabled::class,
TestSuite\Filtered::class,
TestSuite\Finished::class,
TestSuite\Loaded::class,
TestSuite\Skipped::class,
TestSuite\Sorted::class,
TestSuite\Started::class,
];
foreach ($defaultEvents as $eventClass) {
$typeMap->addMapping(
$eventClass . 'Subscriber',
$eventClass,
);
}
}
private function garbageCollectorStatusProvider(): Telemetry\GarbageCollectorStatusProvider
{
if (!isset(gc_status()['running'])) {
// @codeCoverageIgnoreStart
return new Php81GarbageCollectorStatusProvider;
// @codeCoverageIgnoreEnd
}
return new Php83GarbageCollectorStatusProvider;
}
}
phpunit/src/Event/Subscriber.php 0000644 00000000641 15243417753 0012733 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Subscriber
{
}
phpunit/src/Event/Exception/UnknownSubscriberTypeException.php 0000644 00000000774 15243417753 0021001 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownSubscriberTypeException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/NoTestCaseObjectOnCallStackException.php 0000644 00000001214 15243417753 0021660 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoTestCaseObjectOnCallStackException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('Cannot find TestCase object on call stack');
}
}
phpunit/src/Event/Exception/UnknownSubscriberException.php 0000644 00000000770 15243417753 0020133 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownSubscriberException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/MapError.php 0000644 00000000746 15243417753 0014323 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MapError extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/NoPreviousThrowableException.php 0000644 00000000772 15243417753 0020433 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoPreviousThrowableException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/InvalidSubscriberException.php 0000644 00000000770 15243417753 0020062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidSubscriberException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/NoDataSetFromDataProviderException.php 0000644 00000001046 15243417753 0021420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoDataSetFromDataProviderException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/InvalidArgumentException.php 0000644 00000000750 15243417753 0017537 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidArgumentException extends \InvalidArgumentException implements Exception
{
}
phpunit/src/Event/Exception/MoreThanOneDataSetFromDataProviderException.php 0000644 00000001057 15243417753 0023225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MoreThanOneDataSetFromDataProviderException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/UnknownEventException.php 0000644 00000000763 15243417753 0017113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownEventException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/NoComparisonFailureException.php 0000644 00000001034 15243417753 0020361 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoComparisonFailureException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/InvalidEventException.php 0000644 00000000763 15243417753 0017042 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidEventException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/EventAlreadyAssignedException.php 0000644 00000000773 15243417753 0020514 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventAlreadyAssignedException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/EventFacadeIsSealedException.php 0000644 00000000772 15243417753 0020231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventFacadeIsSealedException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/UnknownEventTypeException.php 0000644 00000000767 15243417753 0017761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownEventTypeException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/SubscriberTypeAlreadyRegisteredException.php 0000644 00000001006 15243417753 0022726 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class SubscriberTypeAlreadyRegisteredException extends RuntimeException implements Exception
{
}
phpunit/src/Event/Exception/Exception.php 0000644 00000000512 15243417753 0014521 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
interface Exception extends \PHPUnit\Exception
{
}
phpunit/src/Event/Exception/RuntimeException.php 0000644 00000000730 15243417753 0016067 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
phpunit/src/Event/TypeMap.php 0000644 00000012737 15243417753 0012220 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function array_key_exists;
use function class_exists;
use function class_implements;
use function in_array;
use function interface_exists;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TypeMap
{
/**
* @psalm-var array<class-string, class-string>
*/
private array $mapping = [];
/**
* @psalm-param class-string $subscriberInterface
* @psalm-param class-string $eventClass
*
* @throws EventAlreadyAssignedException
* @throws InvalidEventException
* @throws InvalidSubscriberException
* @throws SubscriberTypeAlreadyRegisteredException
* @throws UnknownEventException
* @throws UnknownSubscriberException
*/
public function addMapping(string $subscriberInterface, string $eventClass): void
{
$this->ensureSubscriberInterfaceExists($subscriberInterface);
$this->ensureSubscriberInterfaceExtendsInterface($subscriberInterface);
$this->ensureEventClassExists($eventClass);
$this->ensureEventClassImplementsEventInterface($eventClass);
$this->ensureSubscriberWasNotAlreadyRegistered($subscriberInterface);
$this->ensureEventWasNotAlreadyAssigned($eventClass);
$this->mapping[$subscriberInterface] = $eventClass;
}
public function isKnownSubscriberType(Subscriber $subscriber): bool
{
foreach (class_implements($subscriber) as $interface) {
if (array_key_exists($interface, $this->mapping)) {
return true;
}
}
return false;
}
public function isKnownEventType(Event $event): bool
{
return in_array($event::class, $this->mapping, true);
}
/**
* @psalm-return class-string
*
* @throws MapError
*/
public function map(Subscriber $subscriber): string
{
foreach (class_implements($subscriber) as $interface) {
if (array_key_exists($interface, $this->mapping)) {
return $this->mapping[$interface];
}
}
throw new MapError(
sprintf(
'Subscriber "%s" does not implement a known interface',
$subscriber::class,
),
);
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws UnknownSubscriberException
*/
private function ensureSubscriberInterfaceExists(string $subscriberInterface): void
{
if (!interface_exists($subscriberInterface)) {
throw new UnknownSubscriberException(
sprintf(
'Subscriber "%s" does not exist or is not an interface',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws UnknownEventException
*/
private function ensureEventClassExists(string $eventClass): void
{
if (!class_exists($eventClass)) {
throw new UnknownEventException(
sprintf(
'Event class "%s" does not exist',
$eventClass,
),
);
}
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws InvalidSubscriberException
*/
private function ensureSubscriberInterfaceExtendsInterface(string $subscriberInterface): void
{
if (!in_array(Subscriber::class, class_implements($subscriberInterface), true)) {
throw new InvalidSubscriberException(
sprintf(
'Subscriber "%s" does not extend Subscriber interface',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws InvalidEventException
*/
private function ensureEventClassImplementsEventInterface(string $eventClass): void
{
if (!in_array(Event::class, class_implements($eventClass), true)) {
throw new InvalidEventException(
sprintf(
'Event "%s" does not implement Event interface',
$eventClass,
),
);
}
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws SubscriberTypeAlreadyRegisteredException
*/
private function ensureSubscriberWasNotAlreadyRegistered(string $subscriberInterface): void
{
if (array_key_exists($subscriberInterface, $this->mapping)) {
throw new SubscriberTypeAlreadyRegisteredException(
sprintf(
'Subscriber type "%s" already registered',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws EventAlreadyAssignedException
*/
private function ensureEventWasNotAlreadyAssigned(string $eventClass): void
{
if (in_array($eventClass, $this->mapping, true)) {
throw new EventAlreadyAssignedException(
sprintf(
'Event "%s" already assigned',
$eventClass,
),
);
}
}
}
phpunit/src/Event/Events/EventCollectionIterator.php 0000644 00000002243 15243417753 0016703 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Event>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventCollectionIterator implements Iterator
{
/**
* @psalm-var list<Event>
*/
private readonly array $events;
private int $position = 0;
public function __construct(EventCollection $events)
{
$this->events = $events->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->events);
}
public function key(): int
{
return $this->position;
}
public function current(): Event
{
return $this->events[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/Event/Events/Event.php 0000644 00000000772 15243417753 0013162 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Event
{
public function telemetryInfo(): Telemetry\Info;
public function asString(): string;
}
phpunit/src/Event/Events/TestSuite/Finished.php 0000644 00000002411 15243417753 0015553 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Finished (%s, %d test%s)',
$this->testSuite->name(),
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
phpunit/src/Event/Events/TestSuite/FinishedSubscriber.php 0000644 00000001030 15243417753 0017573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
phpunit/src/Event/Events/TestSuite/SkippedSubscriber.php 0000644 00000001026 15243417753 0017446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedSubscriber extends Subscriber
{
public function notify(Skipped $event): void;
}
phpunit/src/Event/Events/TestSuite/Sorted.php 0000644 00000003070 15243417753 0015264 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Sorted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly int $executionOrder;
private readonly int $executionOrderDefects;
private readonly bool $resolveDependencies;
public function __construct(Telemetry\Info $telemetryInfo, int $executionOrder, int $executionOrderDefects, bool $resolveDependencies)
{
$this->telemetryInfo = $telemetryInfo;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->resolveDependencies = $resolveDependencies;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function executionOrderDefects(): int
{
return $this->executionOrderDefects;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
public function asString(): string
{
return 'Test Suite Sorted';
}
}
phpunit/src/Event/Events/TestSuite/LoadedSubscriber.php 0000644 00000001024 15243417753 0017235 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface LoadedSubscriber extends Subscriber
{
public function notify(Loaded $event): void;
}
phpunit/src/Event/Events/TestSuite/StartedSubscriber.php 0000644 00000001026 15243417753 0017455 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
phpunit/src/Event/Events/TestSuite/SortedSubscriber.php 0000644 00000001024 15243417753 0017305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SortedSubscriber extends Subscriber
{
public function notify(Sorted $event): void;
}
phpunit/src/Event/Events/TestSuite/FilteredSubscriber.php 0000644 00000001030 15243417753 0017600 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FilteredSubscriber extends Subscriber
{
public function notify(Filtered $event): void;
}
phpunit/src/Event/Events/TestSuite/Started.php 0000644 00000002407 15243417753 0015435 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Started (%s, %d test%s)',
$this->testSuite->name(),
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
phpunit/src/Event/Events/TestSuite/Skipped.php 0000644 00000002557 15243417753 0015434 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Suite Skipped (%s, %s)',
$this->testSuite->name(),
$this->message,
);
}
}
phpunit/src/Event/Events/TestSuite/Loaded.php 0000644 00000002333 15243417753 0015215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Loaded implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Loaded (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
phpunit/src/Event/Events/TestSuite/Filtered.php 0000644 00000002337 15243417753 0015567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Filtered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Filtered (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
phpunit/src/Event/Events/Test/PrintedUnexpectedOutput.php 0000644 00000002514 15243417753 0017667 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PrintedUnexpectedOutput implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var non-empty-string
*/
private readonly string $output;
/**
* @psalm-param non-empty-string $output
*/
public function __construct(Telemetry\Info $telemetryInfo, string $output)
{
$this->telemetryInfo = $telemetryInfo;
$this->output = $output;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return non-empty-string
*/
public function output(): string
{
return $this->output;
}
public function asString(): string
{
return sprintf(
'Test Printed Unexpected Output%s%s',
PHP_EOL,
$this->output,
);
}
}
phpunit/src/Event/Events/Test/HookMethod/PostConditionCalledSubscriber.php 0000644 00000001051 15243417753 0022775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PostConditionCalledSubscriber extends Subscriber
{
public function notify(PostConditionCalled $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodErroredSubscriber.php 0000644 00000001073 15243417753 0024636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodErroredSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/PreConditionFinishedSubscriber.php 0000644 00000001053 15243417753 0023145 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreConditionFinishedSubscriber extends Subscriber
{
public function notify(PreConditionFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodErrored.php 0000644 00000004052 15243417753 0022612 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodErrored implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
private readonly Throwable $throwable;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = $this->throwable->message();
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Before First Test Method Errored (%s::%s)%s',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
$message,
);
}
}
phpunit/src/Event/Events/Test/HookMethod/PostConditionFinishedSubscriber.php 0000644 00000001055 15243417753 0023346 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PostConditionFinishedSubscriber extends Subscriber
{
public function notify(PostConditionFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/BeforeTestMethodCalledSubscriber.php 0000644 00000001057 15243417753 0023412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeTestMethodCalledSubscriber extends Subscriber
{
public function notify(BeforeTestMethodCalled $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodCalled.php 0000644 00000003242 15243417753 0022374 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Before First Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/AfterLastTestMethodFinishedSubscriber.php 0000644 00000001071 15243417753 0024436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterLastTestMethodFinishedSubscriber extends Subscriber
{
public function notify(AfterLastTestMethodFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/AfterTestMethodFinished.php 0000644 00000003636 15243417753 0021577 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'After Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/BeforeTestMethodFinished.php 0000644 00000003640 15243417753 0021733 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Before Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/PreConditionCalled.php 0000644 00000003224 15243417753 0020556 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreConditionCalled implements Event
{
private readonly Telemetry\Info$telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Pre Condition Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodFinished.php 0000644 00000003652 15243417753 0022746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodFinished implements Event
{
private readonly Telemetry\Info$telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Before First Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/BeforeTestMethodFinishedSubscriber.php 0000644 00000001063 15243417753 0023754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeTestMethodFinishedSubscriber extends Subscriber
{
public function notify(BeforeTestMethodFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/AfterTestMethodFinishedSubscriber.php 0000644 00000001061 15243417753 0023611 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterTestMethodFinishedSubscriber extends Subscriber
{
public function notify(AfterTestMethodFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/PostConditionFinished.php 0000644 00000003640 15243417753 0021324 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostConditionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Post Condition Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/AfterLastTestMethodCalled.php 0000644 00000003236 15243417753 0022052 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterLastTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'After Last Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/BeforeTestMethodCalled.php 0000644 00000003227 15243417753 0021367 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Before Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodCalledSubscriber.php 0000644 00000001071 15243417753 0024416 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodCalledSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodCalled $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/PreConditionCalledSubscriber.php 0000644 00000001047 15243417753 0022603 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreConditionCalledSubscriber extends Subscriber
{
public function notify(PreConditionCalled $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/AfterLastTestMethodFinished.php 0000644 00000003647 15243417753 0022425 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterLastTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'After Last Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/PostConditionCalled.php 0000644 00000003227 15243417753 0020760 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostConditionCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Post Condition Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/PreConditionFinished.php 0000644 00000003636 15243417753 0021132 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreConditionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Pre Condition Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/HookMethod/AfterTestMethodCalled.php 0000644 00000003225 15243417753 0021224 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'After Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/HookMethod/AfterTestMethodCalledSubscriber.php 0000644 00000001055 15243417753 0023247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterTestMethodCalledSubscriber extends Subscriber
{
public function notify(AfterTestMethodCalled $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/BeforeFirstTestMethodFinishedSubscriber.php 0000644 00000001075 15243417753 0024767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodFinishedSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodFinished $event): void;
}
phpunit/src/Event/Events/Test/HookMethod/AfterLastTestMethodCalledSubscriber.php 0000644 00000001065 15243417753 0024074 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterLastTestMethodCalledSubscriber extends Subscriber
{
public function notify(AfterLastTestMethodCalled $event): void;
}
phpunit/src/Event/Events/Test/PrintedUnexpectedOutputSubscriber.php 0000644 00000001061 15243417753 0021707 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PrintedUnexpectedOutputSubscriber extends Subscriber
{
public function notify(PrintedUnexpectedOutput $event): void;
}
phpunit/src/Event/Events/Test/Outcome/ErroredSubscriber.php 0000644 00000001021 15243417753 0020045 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ErroredSubscriber extends Subscriber
{
public function notify(Errored $event): void;
}
phpunit/src/Event/Events/Test/Outcome/SkippedSubscriber.php 0000644 00000001021 15243417753 0020042 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedSubscriber extends Subscriber
{
public function notify(Skipped $event): void;
}
phpunit/src/Event/Events/Test/Outcome/Errored.php 0000644 00000003074 15243417753 0016033 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Errored implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Errored (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Outcome/MarkedIncompleteSubscriber.php 0000644 00000001043 15243417753 0021672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MarkedIncompleteSubscriber extends Subscriber
{
public function notify(MarkedIncomplete $event): void;
}
phpunit/src/Event/Events/Test/Outcome/PassedSubscriber.php 0000644 00000001017 15243417753 0017667 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PassedSubscriber extends Subscriber
{
public function notify(Passed $event): void;
}
phpunit/src/Event/Events/Test/Outcome/Failed.php 0000644 00000004343 15243417753 0015615 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Failed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
private readonly ?ComparisonFailure $comparisonFailure;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
$this->comparisonFailure = $comparisonFailure;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
/**
* @psalm-assert-if-true !null $this->comparisonFailure
*/
public function hasComparisonFailure(): bool
{
return $this->comparisonFailure !== null;
}
/**
* @throws NoComparisonFailureException
*/
public function comparisonFailure(): ComparisonFailure
{
if ($this->comparisonFailure === null) {
throw new NoComparisonFailureException;
}
return $this->comparisonFailure;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Failed (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Outcome/MarkedIncomplete.php 0000644 00000003117 15243417753 0017652 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MarkedIncomplete implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Marked Incomplete (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Outcome/Skipped.php 0000644 00000002741 15243417753 0016030 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Skipped (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Outcome/Passed.php 0000644 00000002210 15243417753 0015637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Passed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Passed (%s)',
$this->test->id(),
);
}
}
phpunit/src/Event/Events/Test/Outcome/FailedSubscriber.php 0000644 00000001017 15243417753 0017634 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FailedSubscriber extends Subscriber
{
public function notify(Failed $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/Finished.php 0000644 00000002703 15243417753 0016444 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly int $numberOfAssertionsPerformed;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, int $numberOfAssertionsPerformed)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->numberOfAssertionsPerformed = $numberOfAssertionsPerformed;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function numberOfAssertionsPerformed(): int
{
return $this->numberOfAssertionsPerformed;
}
public function asString(): string
{
return sprintf(
'Test Finished (%s)',
$this->test->id(),
);
}
}
phpunit/src/Event/Events/Test/Lifecycle/FinishedSubscriber.php 0000644 00000001023 15243417753 0020462 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/DataProviderMethodFinished.php 0000644 00000003640 15243417753 0022113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly ClassMethod $testMethod;
/**
* @psalm-var list<ClassMethod>
*/
private readonly array $calledMethods;
public function __construct(Telemetry\Info $telemetryInfo, ClassMethod $testMethod, ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testMethod = $testMethod;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testMethod(): ClassMethod
{
return $this->testMethod;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = sprintf(
'Data Provider Method Finished for %s::%s:',
$this->testMethod->className(),
$this->testMethod->methodName(),
);
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
phpunit/src/Event/Events/Test/Lifecycle/DataProviderMethodFinishedSubscriber.php 0000644 00000001067 15243417753 0024140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DataProviderMethodFinishedSubscriber extends Subscriber
{
public function notify(DataProviderMethodFinished $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/DataProviderMethodCalledSubscriber.php 0000644 00000001063 15243417753 0023567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DataProviderMethodCalledSubscriber extends Subscriber
{
public function notify(DataProviderMethodCalled $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/Prepared.php 0000644 00000002214 15243417753 0016452 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Prepared implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Prepared (%s)',
$this->test->id(),
);
}
}
phpunit/src/Event/Events/Test/Lifecycle/PreparationStarted.php 0000644 00000002241 15243417753 0020523 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreparationStarted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Preparation Started (%s)',
$this->test->id(),
);
}
}
phpunit/src/Event/Events/Test/Lifecycle/PreparedSubscriber.php 0000644 00000001023 15243417753 0020473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparedSubscriber extends Subscriber
{
public function notify(Prepared $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/DataProviderMethodCalled.php 0000644 00000003206 15243417753 0021544 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry\Info;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderMethodCalled implements Event
{
private readonly Info $telemetryInfo;
private readonly ClassMethod $testMethod;
private readonly ClassMethod $dataProviderMethod;
public function __construct(Info $telemetryInfo, ClassMethod $testMethod, ClassMethod $dataProviderMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testMethod = $testMethod;
$this->dataProviderMethod = $dataProviderMethod;
}
public function telemetryInfo(): Info
{
return $this->telemetryInfo;
}
public function testMethod(): ClassMethod
{
return $this->testMethod;
}
public function dataProviderMethod(): ClassMethod
{
return $this->dataProviderMethod;
}
public function asString(): string
{
return sprintf(
'Data Provider Method Called (%s::%s for test method %s::%s)',
$this->dataProviderMethod->className(),
$this->dataProviderMethod->methodName(),
$this->testMethod->className(),
$this->testMethod->methodName(),
);
}
}
phpunit/src/Event/Events/Test/Lifecycle/PreparationFailedSubscriber.php 0000644 00000001045 15243417753 0022326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparationFailedSubscriber extends Subscriber
{
public function notify(PreparationFailed $event): void;
}
phpunit/src/Event/Events/Test/Lifecycle/PreparationFailed.php 0000644 00000002237 15243417753 0020306 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreparationFailed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Preparation Failed (%s)',
$this->test->id(),
);
}
}
phpunit/src/Event/Events/Test/Lifecycle/PreparationStartedSubscriber.php 0000644 00000001047 15243417753 0022552 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparationStartedSubscriber extends Subscriber
{
public function notify(PreparationStarted $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/TestProxyCreated.php 0000644 00000003066 15243417753 0020342 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestProxyCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $constructorArguments;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, string $constructorArguments)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->constructorArguments = $constructorArguments;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function constructorArguments(): string
{
return $this->constructorArguments;
}
public function asString(): string
{
return sprintf(
'Test Proxy Created (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/TestProxyCreatedSubscriber.php 0000644 00000001043 15243417753 0022357 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestProxyCreatedSubscriber extends Subscriber
{
public function notify(TestProxyCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectFromWsdlCreatedSubscriber.php 0000644 00000001065 15243417753 0024100 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectFromWsdlCreatedSubscriber extends Subscriber
{
public function notify(MockObjectFromWsdlCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/PartialMockObjectCreated.php 0000644 00000003150 15243417753 0021710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PartialMockObjectCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var list<string>
*/
private readonly array $methodNames;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, string ...$methodNames)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->methodNames = $methodNames;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return list<string>
*/
public function methodNames(): array
{
return $this->methodNames;
}
public function asString(): string
{
return sprintf(
'Partial Mock Object Created (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/PartialMockObjectCreatedSubscriber.php 0000644 00000001063 15243417753 0023735 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PartialMockObjectCreatedSubscriber extends Subscriber
{
public function notify(PartialMockObjectCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForIntersectionOfInterfacesCreatedSubscriber.php 0000644 00000001133 15243417753 0027745 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForIntersectionOfInterfacesCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForIntersectionOfInterfacesCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/TestStubCreated.php 0000644 00000002440 15243417753 0020131 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestStubCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Test Stub Created (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/TestStubForIntersectionOfInterfacesCreated.php 0000644 00000002573 15243417753 0025467 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function implode;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestStubForIntersectionOfInterfacesCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var list<class-string>
*/
private readonly array $interfaces;
/**
* @psalm-param list<class-string> $interfaces
*/
public function __construct(Telemetry\Info $telemetryInfo, array $interfaces)
{
$this->telemetryInfo = $telemetryInfo;
$this->interfaces = $interfaces;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return list<class-string>
*/
public function interfaces(): array
{
return $this->interfaces;
}
public function asString(): string
{
return sprintf(
'Test Stub Created (%s)',
implode('&', $this->interfaces),
);
}
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForAbstractClassCreatedSubscriber.php 0000644 00000001105 15243417753 0025536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForAbstractClassCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForAbstractClassCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectFromWsdlCreated.php 0000644 00000005202 15243417753 0022051 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectFromWsdlCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $wsdlFile;
/**
* @psalm-var class-string
*/
private readonly string $originalClassName;
/**
* @psalm-var class-string
*/
private readonly string $mockClassName;
/**
* @psalm-var list<string>
*/
private readonly array $methods;
private readonly bool $callOriginalConstructor;
private readonly array $options;
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options)
{
$this->telemetryInfo = $telemetryInfo;
$this->wsdlFile = $wsdlFile;
$this->originalClassName = $originalClassName;
$this->mockClassName = $mockClassName;
$this->methods = $methods;
$this->callOriginalConstructor = $callOriginalConstructor;
$this->options = $options;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function wsdlFile(): string
{
return $this->wsdlFile;
}
/**
* @psalm-return class-string
*/
public function originalClassName(): string
{
return $this->originalClassName;
}
/**
* @psalm-return class-string
*/
public function mockClassName(): string
{
return $this->mockClassName;
}
/**
* @psalm-return list<string>
*/
public function methods(): array
{
return $this->methods;
}
public function callOriginalConstructor(): bool
{
return $this->callOriginalConstructor;
}
public function options(): array
{
return $this->options;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->wsdlFile,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForTraitCreatedSubscriber.php 0000644 00000001065 15243417753 0024075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForTraitCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForTraitCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/TestStubCreatedSubscriber.php 0000644 00000001041 15243417753 0022151 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestStubCreatedSubscriber extends Subscriber
{
public function notify(TestStubCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectCreated.php 0000644 00000002460 15243417753 0020376 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectCreatedSubscriber.php 0000644 00000001045 15243417753 0022420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectCreatedSubscriber extends Subscriber
{
public function notify(MockObjectCreated $event): void;
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForIntersectionOfInterfacesCreated.php 0000644 00000002577 15243417753 0025736 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function implode;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForIntersectionOfInterfacesCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var list<class-string>
*/
private readonly array $interfaces;
/**
* @psalm-param list<class-string> $interfaces
*/
public function __construct(Telemetry\Info $telemetryInfo, array $interfaces)
{
$this->telemetryInfo = $telemetryInfo;
$this->interfaces = $interfaces;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return list<class-string>
*/
public function interfaces(): array
{
return $this->interfaces;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
implode('&', $this->interfaces),
);
}
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForTraitCreated.php 0000644 00000002470 15243417753 0022052 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForTraitCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var trait-string
*/
private readonly string $traitName;
/**
* @psalm-param trait-string $traitName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $traitName)
{
$this->telemetryInfo = $telemetryInfo;
$this->traitName = $traitName;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return trait-string
*/
public function traitName(): string
{
return $this->traitName;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->traitName,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/MockObjectForAbstractClassCreated.php 0000644 00000002500 15243417753 0023512 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForAbstractClassCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/TestDouble/TestStubForIntersectionOfInterfacesCreatedSubscriber.php 0000644 00000001127 15243417753 0027505 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestStubForIntersectionOfInterfacesCreatedSubscriber extends Subscriber
{
public function notify(TestStubForIntersectionOfInterfacesCreated $event): void;
}
phpunit/src/Event/Events/Test/ComparatorRegisteredSubscriber.php 0000644 00000001053 15243417753 0021162 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ComparatorRegisteredSubscriber extends Subscriber
{
public function notify(ComparatorRegistered $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpunitErrorTriggered.php 0000644 00000003266 15243417753 0020407 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitErrorTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = trim($this->message);
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Error (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/NoticeTriggered.php 0000644 00000005573 15243417753 0017172 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoticeTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sNotice (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/DeprecationTriggered.php 0000644 00000006244 15243417753 0020202 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
private readonly bool $ignoredByTest;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
$this->ignoredByTest = $ignoredByTest;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function ignoredByTest(): bool
{
return $this->ignoredByTest;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByTest) {
$status = 'Test-Ignored ';
} elseif ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sDeprecation (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpWarningTriggered.php 0000644 00000005604 15243417753 0020021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpWarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Warning (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpunitErrorTriggeredSubscriber.php 0000644 00000001055 15243417753 0022425 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitErrorTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitErrorTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/WarningTriggeredSubscriber.php 0000644 00000001043 15243417753 0021366 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface WarningTriggeredSubscriber extends Subscriber
{
public function notify(WarningTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpunitDeprecationTriggeredSubscriber.php 0000644 00000001071 15243417753 0023567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitDeprecationTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitDeprecationTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/WarningTriggered.php 0000644 00000005575 15243417753 0017360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sWarning (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/ErrorTriggered.php 0000644 00000004742 15243417753 0017037 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered %sError (%s)%s',
$this->wasSuppressed() ? 'Suppressed ' : '',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpunitWarningTriggeredSubscriber.php 0000644 00000001061 15243417753 0022736 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitWarningTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitWarningTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/ConsideredRisky.php 0000644 00000003075 15243417753 0017210 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ConsideredRisky implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Considered Risky (%s)%s%s',
$this->test->id(),
PHP_EOL,
$this->message,
);
}
}
phpunit/src/Event/Events/Test/Issue/ConsideredRiskySubscriber.php 0000644 00000001041 15243417753 0021223 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ConsideredRiskySubscriber extends Subscriber
{
public function notify(ConsideredRisky $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpDeprecationTriggered.php 0000644 00000006253 15243417753 0020652 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpDeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
private readonly bool $ignoredByTest;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
$this->ignoredByTest = $ignoredByTest;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function ignoredByTest(): bool
{
return $this->ignoredByTest;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByTest) {
$status = 'Test-Ignored ';
} elseif ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Deprecation (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpNoticeTriggeredSubscriber.php 0000644 00000001047 15243417753 0021656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpNoticeTriggeredSubscriber extends Subscriber
{
public function notify(PhpNoticeTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpWarningTriggeredSubscriber.php 0000644 00000001051 15243417753 0022035 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpWarningTriggeredSubscriber extends Subscriber
{
public function notify(PhpWarningTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpunitWarningTriggered.php 0000644 00000003241 15243417753 0020714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitWarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Warning (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpunitDeprecationTriggered.php 0000644 00000003251 15243417753 0021545 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitDeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Deprecation (%s)%s',
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/PhpDeprecationTriggeredSubscriber.php 0000644 00000001061 15243417753 0022666 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpDeprecationTriggeredSubscriber extends Subscriber
{
public function notify(PhpDeprecationTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/NoticeTriggeredSubscriber.php 0000644 00000001041 15243417753 0021200 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface NoticeTriggeredSubscriber extends Subscriber
{
public function notify(NoticeTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/PhpNoticeTriggered.php 0000644 00000005602 15243417753 0017633 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpNoticeTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Notice (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
phpunit/src/Event/Events/Test/Issue/ErrorTriggeredSubscriber.php 0000644 00000001037 15243417753 0021055 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ErrorTriggeredSubscriber extends Subscriber
{
public function notify(ErrorTriggered $event): void;
}
phpunit/src/Event/Events/Test/Issue/DeprecationTriggeredSubscriber.php 0000644 00000001053 15243417753 0022217 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DeprecationTriggeredSubscriber extends Subscriber
{
public function notify(DeprecationTriggered $event): void;
}
phpunit/src/Event/Events/Test/ComparatorRegistered.php 0000644 00000002465 15243417753 0017146 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparatorRegistered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Comparator Registered (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/Test/Assertion/AssertionFailed.php 0000644 00000003461 15243417753 0020041 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class AssertionFailed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $value;
private readonly string $constraint;
private readonly int $count;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $value, string $constraint, int $count, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->value = $value;
$this->constraint = $constraint;
$this->count = $count;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function value(): string
{
return $this->value;
}
public function count(): int
{
return $this->count;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = '';
if (!empty($this->message)) {
$message = sprintf(
', Message: %s',
$this->message,
);
}
return sprintf(
'Assertion Failed (Constraint: %s, Value: %s%s)',
$this->constraint,
$this->value,
$message,
);
}
}
phpunit/src/Event/Events/Test/Assertion/AssertionSucceededSubscriber.php 0000644 00000001071 15243417753 0022560 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
interface AssertionSucceededSubscriber extends Subscriber
{
public function notify(AssertionSucceeded $event): void;
}
phpunit/src/Event/Events/Test/Assertion/AssertionSucceeded.php 0000644 00000003467 15243417753 0020547 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class AssertionSucceeded implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $value;
private readonly string $constraint;
private readonly int $count;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $value, string $constraint, int $count, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->value = $value;
$this->constraint = $constraint;
$this->count = $count;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function value(): string
{
return $this->value;
}
public function count(): int
{
return $this->count;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = '';
if (!empty($this->message)) {
$message = sprintf(
', Message: %s',
$this->message,
);
}
return sprintf(
'Assertion Succeeded (Constraint: %s, Value: %s%s)',
$this->constraint,
$this->value,
$message,
);
}
}
phpunit/src/Event/Events/Test/Assertion/AssertionFailedSubscriber.php 0000644 00000001063 15243417753 0022061 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
interface AssertionFailedSubscriber extends Subscriber
{
public function notify(AssertionFailed $event): void;
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionDisabled.php 0000644 00000001637 15243417753 0021207 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionDisabled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Disabled Garbage Collection';
}
}
phpunit/src/Event/Events/TestRunner/DeprecationTriggered.php 0000644 00000002235 15243417753 0020300 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Runner Triggered Deprecation (%s)',
$this->message,
);
}
}
phpunit/src/Event/Events/TestRunner/ExtensionLoadedFromPharSubscriber.php 0000644 00000001067 15243417753 0022760 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExtensionLoadedFromPharSubscriber extends Subscriber
{
public function notify(ExtensionLoadedFromPhar $event): void;
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionDisabledSubscriber.php 0000644 00000001073 15243417753 0023225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionDisabledSubscriber extends Subscriber
{
public function notify(GarbageCollectionDisabled $event): void;
}
phpunit/src/Event/Events/TestRunner/ExecutionStartedSubscriber.php 0000644 00000001051 15243417753 0021517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionStartedSubscriber extends Subscriber
{
public function notify(ExecutionStarted $event): void;
}
phpunit/src/Event/Events/TestRunner/WarningTriggeredSubscriber.php 0000644 00000001051 15243417753 0021467 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface WarningTriggeredSubscriber extends Subscriber
{
public function notify(WarningTriggered $event): void;
}
phpunit/src/Event/Events/TestRunner/Finished.php 0000644 00000001573 15243417753 0015743 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Finished';
}
}
phpunit/src/Event/Events/TestRunner/WarningTriggered.php 0000644 00000002225 15243417753 0017447 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Runner Triggered Warning (%s)',
$this->message,
);
}
}
phpunit/src/Event/Events/TestRunner/FinishedSubscriber.php 0000644 00000001031 15243417753 0017754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
phpunit/src/Event/Events/TestRunner/ExecutionAborted.php 0000644 00000001614 15243417753 0017452 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionAborted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Execution Aborted';
}
}
phpunit/src/Event/Events/TestRunner/ConfiguredSubscriber.php 0000644 00000001035 15243417753 0020314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ConfiguredSubscriber extends Subscriber
{
public function notify(Configured $event): void;
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionEnabled.php 0000644 00000001635 15243417753 0021030 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionEnabled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Enabled Garbage Collection';
}
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionEnabledSubscriber.php 0000644 00000001071 15243417753 0023046 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionEnabledSubscriber extends Subscriber
{
public function notify(GarbageCollectionEnabled $event): void;
}
phpunit/src/Event/Events/TestRunner/ExtensionLoadedFromPhar.php 0000644 00000003017 15243417753 0020731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionLoadedFromPhar implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $filename;
private readonly string $name;
private readonly string $version;
public function __construct(Telemetry\Info $telemetryInfo, string $filename, string $name, string $version)
{
$this->telemetryInfo = $telemetryInfo;
$this->filename = $filename;
$this->name = $name;
$this->version = $version;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function filename(): string
{
return $this->filename;
}
public function name(): string
{
return $this->name;
}
public function version(): string
{
return $this->version;
}
public function asString(): string
{
return sprintf(
'Extension Loaded from PHAR (%s %s)',
$this->name,
$this->version,
);
}
}
phpunit/src/Event/Events/TestRunner/ExecutionAbortedSubscriber.php 0000644 00000001051 15243417753 0021471 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionAbortedSubscriber extends Subscriber
{
public function notify(ExecutionAborted $event): void;
}
phpunit/src/Event/Events/TestRunner/ExtensionBootstrapped.php 0000644 00000003245 15243417753 0020553 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionBootstrapped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var array<string, string>
*/
private readonly array $parameters;
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, array $parameters)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->parameters = $parameters;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return array<string, string>
*/
public function parameters(): array
{
return $this->parameters;
}
public function asString(): string
{
return sprintf(
'Extension Bootstrapped (%s)',
$this->className,
);
}
}
phpunit/src/Event/Events/TestRunner/ExtensionBootstrappedSubscriber.php 0000644 00000001063 15243417753 0022573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExtensionBootstrappedSubscriber extends Subscriber
{
public function notify(ExtensionBootstrapped $event): void;
}
phpunit/src/Event/Events/TestRunner/Configured.php 0000644 00000002175 15243417753 0016276 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Configured implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Configuration $configuration;
public function __construct(Telemetry\Info $telemetryInfo, Configuration $configuration)
{
$this->telemetryInfo = $telemetryInfo;
$this->configuration = $configuration;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function configuration(): Configuration
{
return $this->configuration;
}
public function asString(): string
{
return 'Test Runner Configured';
}
}
phpunit/src/Event/Events/TestRunner/StartedSubscriber.php 0000644 00000001027 15243417753 0017636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
phpunit/src/Event/Events/TestRunner/ExecutionFinishedSubscriber.php 0000644 00000001053 15243417753 0021644 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionFinishedSubscriber extends Subscriber
{
public function notify(ExecutionFinished $event): void;
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionTriggered.php 0000644 00000001641 15243417753 0021407 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Triggered Garbage Collection';
}
}
phpunit/src/Event/Events/TestRunner/GarbageCollectionTriggeredSubscriber.php 0000644 00000001075 15243417753 0023434 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionTriggeredSubscriber extends Subscriber
{
public function notify(GarbageCollectionTriggered $event): void;
}
phpunit/src/Event/Events/TestRunner/EventFacadeSealed.php 0000644 00000001603 15243417753 0017467 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventFacadeSealed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Event Facade Sealed';
}
}
phpunit/src/Event/Events/TestRunner/ExecutionFinished.php 0000644 00000001616 15243417753 0017625 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Execution Finished';
}
}
phpunit/src/Event/Events/TestRunner/Started.php 0000644 00000001571 15243417753 0015616 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Started';
}
}
phpunit/src/Event/Events/TestRunner/BootstrapFinished.php 0000644 00000002221 15243417753 0017630 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BootstrapFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $filename;
public function __construct(Telemetry\Info $telemetryInfo, string $filename)
{
$this->telemetryInfo = $telemetryInfo;
$this->filename = $filename;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function filename(): string
{
return $this->filename;
}
public function asString(): string
{
return sprintf(
'Bootstrap Finished (%s)',
$this->filename,
);
}
}
phpunit/src/Event/Events/TestRunner/EventFacadeSealedSubscriber.php 0000644 00000001053 15243417753 0021512 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface EventFacadeSealedSubscriber extends Subscriber
{
public function notify(EventFacadeSealed $event): void;
}
phpunit/src/Event/Events/TestRunner/ExecutionStarted.php 0000644 00000002431 15243417753 0017476 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
use PHPUnit\Event\TestSuite\TestSuite;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStarted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Runner Execution Started (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
phpunit/src/Event/Events/TestRunner/BootstrapFinishedSubscriber.php 0000644 00000001053 15243417753 0021656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BootstrapFinishedSubscriber extends Subscriber
{
public function notify(BootstrapFinished $event): void;
}
phpunit/src/Event/Events/TestRunner/DeprecationTriggeredSubscriber.php 0000644 00000001061 15243417753 0022320 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DeprecationTriggeredSubscriber extends Subscriber
{
public function notify(DeprecationTriggered $event): void;
}
phpunit/src/Event/Events/EventCollection.php 0000644 00000002441 15243417753 0015171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Event>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Event>
*/
private array $events = [];
public function add(Event ...$events): void
{
foreach ($events as $event) {
$this->events[] = $event;
}
}
/**
* @psalm-return list<Event>
*/
public function asArray(): array
{
return $this->events;
}
public function count(): int
{
return count($this->events);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
public function isNotEmpty(): bool
{
return $this->count() > 0;
}
public function getIterator(): EventCollectionIterator
{
return new EventCollectionIterator($this);
}
}
phpunit/src/Event/Events/Application/Finished.php 0000644 00000002255 15243417753 0016073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly int $shellExitCode;
public function __construct(Telemetry\Info $telemetryInfo, int $shellExitCode)
{
$this->telemetryInfo = $telemetryInfo;
$this->shellExitCode = $shellExitCode;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function shellExitCode(): int
{
return $this->shellExitCode;
}
public function asString(): string
{
return sprintf(
'PHPUnit Finished (Shell Exit Code: %d)',
$this->shellExitCode,
);
}
}
phpunit/src/Event/Events/Application/FinishedSubscriber.php 0000644 00000001032 15243417753 0020107 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
phpunit/src/Event/Events/Application/StartedSubscriber.php 0000644 00000001030 15243417753 0017762 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
phpunit/src/Event/Events/Application/Started.php 0000644 00000002261 15243417753 0015745 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Runtime\Runtime;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Runtime $runtime;
public function __construct(Telemetry\Info $telemetryInfo, Runtime $runtime)
{
$this->telemetryInfo = $telemetryInfo;
$this->runtime = $runtime;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function runtime(): Runtime
{
return $this->runtime;
}
public function asString(): string
{
return sprintf(
'PHPUnit Started (%s)',
$this->runtime->asString(),
);
}
}
phpunit/src/Event/Value/Runtime/PHP.php 0000644 00000004537 15243417753 0013766 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use const PHP_EXTRA_VERSION;
use const PHP_MAJOR_VERSION;
use const PHP_MINOR_VERSION;
use const PHP_RELEASE_VERSION;
use const PHP_SAPI;
use const PHP_VERSION;
use const PHP_VERSION_ID;
use function array_merge;
use function get_loaded_extensions;
use function sort;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PHP
{
private readonly string $version;
private readonly int $versionId;
private readonly int $majorVersion;
private readonly int $minorVersion;
private readonly int $releaseVersion;
private readonly string $extraVersion;
private readonly string $sapi;
/**
* @psalm-var list<string>
*/
private readonly array $extensions;
public function __construct()
{
$this->version = PHP_VERSION;
$this->versionId = PHP_VERSION_ID;
$this->majorVersion = PHP_MAJOR_VERSION;
$this->minorVersion = PHP_MINOR_VERSION;
$this->releaseVersion = PHP_RELEASE_VERSION;
$this->extraVersion = PHP_EXTRA_VERSION;
$this->sapi = PHP_SAPI;
$extensions = array_merge(
get_loaded_extensions(true),
get_loaded_extensions(),
);
sort($extensions);
$this->extensions = $extensions;
}
public function version(): string
{
return $this->version;
}
public function sapi(): string
{
return $this->sapi;
}
public function majorVersion(): int
{
return $this->majorVersion;
}
public function minorVersion(): int
{
return $this->minorVersion;
}
public function releaseVersion(): int
{
return $this->releaseVersion;
}
public function extraVersion(): string
{
return $this->extraVersion;
}
public function versionId(): int
{
return $this->versionId;
}
/**
* @psalm-return list<string>
*/
public function extensions(): array
{
return $this->extensions;
}
}
phpunit/src/Event/Value/Runtime/OperatingSystem.php 0000644 00000001671 15243417753 0016470 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use const PHP_OS;
use const PHP_OS_FAMILY;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class OperatingSystem
{
private readonly string $operatingSystem;
private readonly string $operatingSystemFamily;
public function __construct()
{
$this->operatingSystem = PHP_OS;
$this->operatingSystemFamily = PHP_OS_FAMILY;
}
public function operatingSystem(): string
{
return $this->operatingSystem;
}
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
phpunit/src/Event/Value/Runtime/Runtime.php 0000644 00000002527 15243417753 0014757 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use function sprintf;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Runtime
{
private readonly OperatingSystem $operatingSystem;
private readonly PHP $php;
private readonly PHPUnit $phpunit;
public function __construct()
{
$this->operatingSystem = new OperatingSystem;
$this->php = new PHP;
$this->phpunit = new PHPUnit;
}
public function asString(): string
{
$php = $this->php();
return sprintf(
'PHPUnit %s using PHP %s (%s) on %s',
$this->phpunit()->versionId(),
$php->version(),
$php->sapi(),
$this->operatingSystem()->operatingSystem(),
);
}
public function operatingSystem(): OperatingSystem
{
return $this->operatingSystem;
}
public function php(): PHP
{
return $this->php;
}
public function phpunit(): PHPUnit
{
return $this->phpunit;
}
}
phpunit/src/Event/Value/Runtime/PHPUnit.php 0000644 00000001563 15243417753 0014622 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use PHPUnit\Runner\Version;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PHPUnit
{
private readonly string $versionId;
private readonly string $releaseSeries;
public function __construct()
{
$this->versionId = Version::id();
$this->releaseSeries = Version::series();
}
public function versionId(): string
{
return $this->versionId;
}
public function releaseSeries(): string
{
return $this->releaseSeries;
}
}
phpunit/src/Event/Value/ThrowableBuilder.php 0000644 00000002053 15243417753 0015141 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Framework\Exception;
use PHPUnit\Util\Filter;
use PHPUnit\Util\ThrowableToStringMapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ThrowableBuilder
{
/**
* @throws Exception
* @throws NoPreviousThrowableException
*/
public static function from(\Throwable $t): Throwable
{
$previous = $t->getPrevious();
if ($previous !== null) {
$previous = self::from($previous);
}
return new Throwable(
$t::class,
$t->getMessage(),
ThrowableToStringMapper::map($t),
Filter::getFilteredStacktrace($t, false),
$previous,
);
}
}
phpunit/src/Event/Value/Telemetry/HRTime.php 0000644 00000005046 15243417753 0015012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function sprintf;
use PHPUnit\Event\InvalidArgumentException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class HRTime
{
private readonly int $seconds;
private readonly int $nanoseconds;
/**
* @throws InvalidArgumentException
*/
public static function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds): self
{
return new self(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function __construct(int $seconds, int $nanoseconds)
{
$this->ensureNotNegative($seconds, 'seconds');
$this->ensureNotNegative($nanoseconds, 'nanoseconds');
$this->ensureNanoSecondsInRange($nanoseconds);
$this->seconds = $seconds;
$this->nanoseconds = $nanoseconds;
}
public function seconds(): int
{
return $this->seconds;
}
public function nanoseconds(): int
{
return $this->nanoseconds;
}
public function duration(self $start): Duration
{
$seconds = $this->seconds - $start->seconds();
$nanoseconds = $this->nanoseconds - $start->nanoseconds();
if ($nanoseconds < 0) {
$seconds--;
$nanoseconds += 1000000000;
}
if ($seconds < 0) {
return Duration::fromSecondsAndNanoseconds(0, 0);
}
return Duration::fromSecondsAndNanoseconds(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function ensureNotNegative(int $value, string $type): void
{
if ($value < 0) {
throw new InvalidArgumentException(
sprintf(
'Value for %s must not be negative.',
$type,
),
);
}
}
/**
* @throws InvalidArgumentException
*/
private function ensureNanoSecondsInRange(int $nanoseconds): void
{
if ($nanoseconds > 999999999) {
throw new InvalidArgumentException(
'Value for nanoseconds must not be greater than 999999999.',
);
}
}
}
phpunit/src/Event/Value/Telemetry/StopWatch.php 0000644 00000000705 15243417753 0015573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface StopWatch
{
public function current(): HRTime;
}
phpunit/src/Event/Value/Telemetry/Php81GarbageCollectorStatusProvider.php 0000644 00000001671 15243417753 0022621 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function gc_status;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class Php81GarbageCollectorStatusProvider implements GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus
{
$status = gc_status();
return new GarbageCollectorStatus(
$status['runs'],
$status['collected'],
$status['threshold'],
$status['roots'],
null,
null,
null,
null,
null,
null,
null,
null,
);
}
}
phpunit/src/Event/Value/Telemetry/MemoryUsage.php 0000644 00000001546 15243417753 0016120 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MemoryUsage
{
private readonly int $bytes;
public static function fromBytes(int $bytes): self
{
return new self($bytes);
}
private function __construct(int $bytes)
{
$this->bytes = $bytes;
}
public function bytes(): int
{
return $this->bytes;
}
public function diff(self $other): self
{
return self::fromBytes($this->bytes - $other->bytes);
}
}
phpunit/src/Event/Value/Telemetry/MemoryMeter.php 0000644 00000001005 15243417753 0016116 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface MemoryMeter
{
public function memoryUsage(): MemoryUsage;
public function peakMemoryUsage(): MemoryUsage;
}
phpunit/src/Event/Value/Telemetry/SystemStopWatchWithOffset.php 0000644 00000001730 15243417753 0021002 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function hrtime;
use PHPUnit\Event\InvalidArgumentException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class SystemStopWatchWithOffset implements StopWatch
{
private ?HRTime $offset;
public function __construct(HRTime $offset)
{
$this->offset = $offset;
}
/**
* @throws InvalidArgumentException
*/
public function current(): HRTime
{
if ($this->offset !== null) {
$offset = $this->offset;
$this->offset = null;
return $offset;
}
return HRTime::fromSecondsAndNanoseconds(...hrtime());
}
}
phpunit/src/Event/Value/Telemetry/GarbageCollectorStatusProvider.php 0000644 00000000751 15243417753 0021776 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus;
}
phpunit/src/Event/Value/Telemetry/SystemStopWatch.php 0000644 00000001242 15243417753 0016775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function hrtime;
use PHPUnit\Event\InvalidArgumentException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SystemStopWatch implements StopWatch
{
/**
* @throws InvalidArgumentException
*/
public function current(): HRTime
{
return HRTime::fromSecondsAndNanoseconds(...hrtime());
}
}
phpunit/src/Event/Value/Telemetry/Info.php 0000644 00000004501 15243417753 0014550 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function sprintf;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Info
{
private readonly Snapshot $current;
private readonly Duration $durationSinceStart;
private readonly MemoryUsage $memorySinceStart;
private readonly Duration $durationSincePrevious;
private readonly MemoryUsage $memorySincePrevious;
public function __construct(Snapshot $current, Duration $durationSinceStart, MemoryUsage $memorySinceStart, Duration $durationSincePrevious, MemoryUsage $memorySincePrevious)
{
$this->current = $current;
$this->durationSinceStart = $durationSinceStart;
$this->memorySinceStart = $memorySinceStart;
$this->durationSincePrevious = $durationSincePrevious;
$this->memorySincePrevious = $memorySincePrevious;
}
public function time(): HRTime
{
return $this->current->time();
}
public function memoryUsage(): MemoryUsage
{
return $this->current->memoryUsage();
}
public function peakMemoryUsage(): MemoryUsage
{
return $this->current->peakMemoryUsage();
}
public function durationSinceStart(): Duration
{
return $this->durationSinceStart;
}
public function memoryUsageSinceStart(): MemoryUsage
{
return $this->memorySinceStart;
}
public function durationSincePrevious(): Duration
{
return $this->durationSincePrevious;
}
public function memoryUsageSincePrevious(): MemoryUsage
{
return $this->memorySincePrevious;
}
public function garbageCollectorStatus(): GarbageCollectorStatus
{
return $this->current->garbageCollectorStatus();
}
public function asString(): string
{
return sprintf(
'[%s / %s] [%d bytes]',
$this->durationSinceStart()->asString(),
$this->durationSincePrevious()->asString(),
$this->memoryUsage()->bytes(),
);
}
}
phpunit/src/Event/Value/Telemetry/Duration.php 0000644 00000006727 15243417753 0015456 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function floor;
use function sprintf;
use PHPUnit\Event\InvalidArgumentException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Duration
{
private readonly int $seconds;
private readonly int $nanoseconds;
/**
* @throws InvalidArgumentException
*/
public static function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds): self
{
return new self(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function __construct(int $seconds, int $nanoseconds)
{
$this->ensureNotNegative($seconds, 'seconds');
$this->ensureNotNegative($nanoseconds, 'nanoseconds');
$this->ensureNanoSecondsInRange($nanoseconds);
$this->seconds = $seconds;
$this->nanoseconds = $nanoseconds;
}
public function seconds(): int
{
return $this->seconds;
}
public function nanoseconds(): int
{
return $this->nanoseconds;
}
public function asFloat(): float
{
return $this->seconds() + ($this->nanoseconds() / 1000000000);
}
public function asString(): string
{
$seconds = $this->seconds();
$minutes = 0;
$hours = 0;
if ($seconds > 60 * 60) {
$hours = floor($seconds / 60 / 60);
$seconds -= ($hours * 60 * 60);
}
if ($seconds > 60) {
$minutes = floor($seconds / 60);
$seconds -= ($minutes * 60);
}
return sprintf(
'%02d:%02d:%02d.%09d',
$hours,
$minutes,
$seconds,
$this->nanoseconds(),
);
}
public function equals(self $other): bool
{
return $this->seconds === $other->seconds &&
$this->nanoseconds === $other->nanoseconds;
}
public function isLessThan(self $other): bool
{
if ($this->seconds < $other->seconds) {
return true;
}
if ($this->seconds > $other->seconds) {
return false;
}
return $this->nanoseconds < $other->nanoseconds;
}
public function isGreaterThan(self $other): bool
{
if ($this->seconds > $other->seconds) {
return true;
}
if ($this->seconds < $other->seconds) {
return false;
}
return $this->nanoseconds > $other->nanoseconds;
}
/**
* @throws InvalidArgumentException
*/
private function ensureNotNegative(int $value, string $type): void
{
if ($value < 0) {
throw new InvalidArgumentException(
sprintf(
'Value for %s must not be negative.',
$type,
),
);
}
}
/**
* @throws InvalidArgumentException
*/
private function ensureNanoSecondsInRange(int $nanoseconds): void
{
if ($nanoseconds > 999999999) {
throw new InvalidArgumentException(
'Value for nanoseconds must not be greater than 999999999.',
);
}
}
}
phpunit/src/Event/Value/Telemetry/SystemMemoryMeter.php 0000644 00000001375 15243417753 0017335 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function memory_get_peak_usage;
use function memory_get_usage;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SystemMemoryMeter implements MemoryMeter
{
public function memoryUsage(): MemoryUsage
{
return MemoryUsage::fromBytes(memory_get_usage(true));
}
public function peakMemoryUsage(): MemoryUsage
{
return MemoryUsage::fromBytes(memory_get_peak_usage(true));
}
}
phpunit/src/Event/Value/Telemetry/Snapshot.php 0000644 00000002641 15243417753 0015457 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Snapshot
{
private readonly HRTime $time;
private readonly MemoryUsage $memoryUsage;
private readonly MemoryUsage $peakMemoryUsage;
private readonly GarbageCollectorStatus $garbageCollectorStatus;
public function __construct(HRTime $time, MemoryUsage $memoryUsage, MemoryUsage $peakMemoryUsage, GarbageCollectorStatus $garbageCollectorStatus)
{
$this->time = $time;
$this->memoryUsage = $memoryUsage;
$this->peakMemoryUsage = $peakMemoryUsage;
$this->garbageCollectorStatus = $garbageCollectorStatus;
}
public function time(): HRTime
{
return $this->time;
}
public function memoryUsage(): MemoryUsage
{
return $this->memoryUsage;
}
public function peakMemoryUsage(): MemoryUsage
{
return $this->peakMemoryUsage;
}
public function garbageCollectorStatus(): GarbageCollectorStatus
{
return $this->garbageCollectorStatus;
}
}
phpunit/src/Event/Value/Telemetry/System.php 0000644 00000002326 15243417753 0015144 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class System
{
private readonly StopWatch $stopWatch;
private readonly MemoryMeter $memoryMeter;
private readonly GarbageCollectorStatusProvider $garbageCollectorStatusProvider;
public function __construct(StopWatch $stopWatch, MemoryMeter $memoryMeter, GarbageCollectorStatusProvider $garbageCollectorStatusProvider)
{
$this->stopWatch = $stopWatch;
$this->memoryMeter = $memoryMeter;
$this->garbageCollectorStatusProvider = $garbageCollectorStatusProvider;
}
public function snapshot(): Snapshot
{
return new Snapshot(
$this->stopWatch->current(),
$this->memoryMeter->memoryUsage(),
$this->memoryMeter->peakMemoryUsage(),
$this->garbageCollectorStatusProvider->status(),
);
}
}
phpunit/src/Event/Value/Telemetry/Php83GarbageCollectorStatusProvider.php 0000644 00000002054 15243417753 0022617 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function gc_status;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Php83GarbageCollectorStatusProvider implements GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus
{
$status = gc_status();
return new GarbageCollectorStatus(
$status['runs'],
$status['collected'],
$status['threshold'],
$status['roots'],
$status['application_time'],
$status['collector_time'],
$status['destructor_time'],
$status['free_time'],
$status['running'],
$status['protected'],
$status['full'],
$status['buffer_size'],
);
}
}
phpunit/src/Event/Value/Telemetry/GarbageCollectorStatus.php 0000644 00000011250 15243417753 0020257 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use PHPUnit\Event\RuntimeException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectorStatus
{
private readonly int $runs;
private readonly int $collected;
private readonly int $threshold;
private readonly int $roots;
private readonly ?float $applicationTime;
private readonly ?float $collectorTime;
private readonly ?float $destructorTime;
private readonly ?float $freeTime;
private readonly ?bool $running;
private readonly ?bool $protected;
private readonly ?bool $full;
private readonly ?int $bufferSize;
public function __construct(int $runs, int $collected, int $threshold, int $roots, ?float $applicationTime, ?float $collectorTime, ?float $destructorTime, ?float $freeTime, ?bool $running, ?bool $protected, ?bool $full, ?int $bufferSize)
{
$this->runs = $runs;
$this->collected = $collected;
$this->threshold = $threshold;
$this->roots = $roots;
$this->applicationTime = $applicationTime;
$this->collectorTime = $collectorTime;
$this->destructorTime = $destructorTime;
$this->freeTime = $freeTime;
$this->running = $running;
$this->protected = $protected;
$this->full = $full;
$this->bufferSize = $bufferSize;
}
public function runs(): int
{
return $this->runs;
}
public function collected(): int
{
return $this->collected;
}
public function threshold(): int
{
return $this->threshold;
}
public function roots(): int
{
return $this->roots;
}
/**
* @psalm-assert-if-true !null $this->applicationTime
* @psalm-assert-if-true !null $this->collectorTime
* @psalm-assert-if-true !null $this->destructorTime
* @psalm-assert-if-true !null $this->freeTime
* @psalm-assert-if-true !null $this->running
* @psalm-assert-if-true !null $this->protected
* @psalm-assert-if-true !null $this->full
* @psalm-assert-if-true !null $this->bufferSize
*/
public function hasExtendedInformation(): bool
{
return $this->running !== null;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function applicationTime(): float
{
if ($this->applicationTime === null) {
throw new RuntimeException('Information not available');
}
return $this->applicationTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function collectorTime(): float
{
if ($this->collectorTime === null) {
throw new RuntimeException('Information not available');
}
return $this->collectorTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function destructorTime(): float
{
if ($this->destructorTime === null) {
throw new RuntimeException('Information not available');
}
return $this->destructorTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function freeTime(): float
{
if ($this->freeTime === null) {
throw new RuntimeException('Information not available');
}
return $this->freeTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isRunning(): bool
{
if ($this->running === null) {
throw new RuntimeException('Information not available');
}
return $this->running;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isProtected(): bool
{
if ($this->protected === null) {
throw new RuntimeException('Information not available');
}
return $this->protected;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isFull(): bool
{
if ($this->full === null) {
throw new RuntimeException('Information not available');
}
return $this->full;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function bufferSize(): int
{
if ($this->bufferSize === null) {
throw new RuntimeException('Information not available');
}
return $this->bufferSize;
}
}
phpunit/src/Event/Value/ComparisonFailureBuilder.php 0000644 00000003360 15243417753 0016636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function is_bool;
use function is_scalar;
use function print_r;
use PHPUnit\Framework\ExpectationFailedException;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonFailureBuilder
{
public static function from(Throwable $t): ?ComparisonFailure
{
if (!$t instanceof ExpectationFailedException) {
return null;
}
if (!$t->getComparisonFailure()) {
return null;
}
$expectedAsString = $t->getComparisonFailure()->getExpectedAsString();
if (empty($expectedAsString)) {
$expectedAsString = self::mapScalarValueToString($t->getComparisonFailure()->getExpected());
}
$actualAsString = $t->getComparisonFailure()->getActualAsString();
if (empty($actualAsString)) {
$actualAsString = self::mapScalarValueToString($t->getComparisonFailure()->getActual());
}
return new ComparisonFailure(
$expectedAsString,
$actualAsString,
$t->getComparisonFailure()->getDiff(),
);
}
private static function mapScalarValueToString(mixed $value): string
{
if ($value === null) {
return 'null';
}
if (is_bool($value)) {
return $value ? 'true' : 'false';
}
if (is_scalar($value)) {
return print_r($value, true);
}
return '';
}
}
phpunit/src/Event/Value/TestSuite/TestSuiteForTestClass.php 0000644 00000002635 15243417753 0020070 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteForTestClass extends TestSuite
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $file;
private readonly int $line;
/**
* @psalm-param class-string $name
*/
public function __construct(string $name, int $size, TestCollection $tests, string $file, int $line)
{
parent::__construct($name, $size, $tests);
$this->className = $name;
$this->file = $file;
$this->line = $line;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function file(): string
{
return $this->file;
}
public function line(): int
{
return $this->line;
}
/**
* @psalm-assert-if-true TestSuiteForTestClass $this
*/
public function isForTestClass(): bool
{
return true;
}
}
phpunit/src/Event/Value/TestSuite/TestSuiteForTestMethodWithDataProvider.php 0000644 00000003564 15243417753 0023406 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteForTestMethodWithDataProvider extends TestSuite
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly string $file;
private readonly int $line;
/**
* @psalm-param non-empty-string $name
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $name, int $size, TestCollection $tests, string $className, string $methodName, string $file, int $line)
{
parent::__construct($name, $size, $tests);
$this->className = $className;
$this->methodName = $methodName;
$this->file = $file;
$this->line = $line;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function file(): string
{
return $this->file;
}
public function line(): int
{
return $this->line;
}
/**
* @psalm-assert-if-true TestSuiteForTestMethodWithDataProvider $this
*/
public function isForTestMethodWithDataProvider(): bool
{
return true;
}
}
phpunit/src/Event/Value/TestSuite/TestSuiteWithName.php 0000644 00000001152 15243417753 0017221 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteWithName extends TestSuite
{
/**
* @psalm-assert-if-true TestSuiteWithName $this
*/
public function isWithName(): bool
{
return true;
}
}
phpunit/src/Event/Value/TestSuite/TestSuiteBuilder.php 0000644 00000006376 15243417753 0017110 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function explode;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestCollection;
use PHPUnit\Event\RuntimeException;
use PHPUnit\Framework\DataProviderTestSuite;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite as FrameworkTestSuite;
use PHPUnit\Runner\PhptTestCase;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteBuilder
{
/**
* @throws RuntimeException
*/
public static function from(FrameworkTestSuite $testSuite): TestSuite
{
$tests = [];
self::process($testSuite, $tests);
if ($testSuite instanceof DataProviderTestSuite) {
[$className, $methodName] = explode('::', $testSuite->name());
try {
$reflector = new ReflectionMethod($className, $methodName);
return new TestSuiteForTestMethodWithDataProvider(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
$className,
$methodName,
$reflector->getFileName(),
$reflector->getStartLine(),
);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
if ($testSuite->isForTestClass()) {
try {
$reflector = new ReflectionClass($testSuite->name());
return new TestSuiteForTestClass(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
$reflector->getFileName(),
$reflector->getStartLine(),
);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
return new TestSuiteWithName(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
);
}
/**
* @psalm-param list<Test> $tests
*/
private static function process(FrameworkTestSuite $testSuite, array &$tests): void
{
foreach ($testSuite->getIterator() as $test) {
if ($test instanceof FrameworkTestSuite) {
self::process($test, $tests);
continue;
}
if ($test instanceof TestCase || $test instanceof PhptTestCase) {
$tests[] = $test->valueObjectForEvents();
}
}
}
}
phpunit/src/Event/Value/TestSuite/TestSuite.php 0000644 00000003206 15243417753 0015566 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestSuite
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
private readonly int $count;
private readonly TestCollection $tests;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name, int $size, TestCollection $tests)
{
$this->name = $name;
$this->count = $size;
$this->tests = $tests;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
public function count(): int
{
return $this->count;
}
public function tests(): TestCollection
{
return $this->tests;
}
/**
* @psalm-assert-if-true TestSuiteWithName $this
*/
public function isWithName(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestSuiteForTestClass $this
*/
public function isForTestClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestSuiteForTestMethodWithDataProvider $this
*/
public function isForTestMethodWithDataProvider(): bool
{
return false;
}
}
phpunit/src/Event/Value/Test/Test.php 0000644 00000002365 15243417753 0013547 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Test
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-param non-empty-string $file
*/
public function __construct(string $file)
{
$this->file = $file;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-assert-if-true TestMethod $this
*/
public function isTestMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true Phpt $this
*/
public function isPhpt(): bool
{
return false;
}
/**
* @psalm-return non-empty-string
*/
abstract public function id(): string;
/**
* @psalm-return non-empty-string
*/
abstract public function name(): string;
}
phpunit/src/Event/Value/Test/TestCollectionIterator.php 0000644 00000002235 15243417753 0017271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Test>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestCollectionIterator implements Iterator
{
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
private int $position = 0;
public function __construct(TestCollection $tests)
{
$this->tests = $tests->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->tests);
}
public function key(): int
{
return $this->position;
}
public function current(): Test
{
return $this->tests[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/Event/Value/Test/TestCollection.php 0000644 00000002365 15243417753 0015563 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Test>
*
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
/**
* @psalm-param list<Test> $tests
*/
public static function fromArray(array $tests): self
{
return new self(...$tests);
}
private function __construct(Test ...$tests)
{
$this->tests = $tests;
}
/**
* @psalm-return list<Test>
*/
public function asArray(): array
{
return $this->tests;
}
public function count(): int
{
return count($this->tests);
}
public function getIterator(): TestCollectionIterator
{
return new TestCollectionIterator($this);
}
}
phpunit/src/Event/Value/Test/TestDoxBuilder.php 0000644 00000002741 15243417753 0015527 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\TestCase;
use PHPUnit\Logging\TestDox\NamePrettifier;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestDoxBuilder
{
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromTestCase(TestCase $testCase): TestDox
{
$prettifier = new NamePrettifier;
return new TestDox(
$prettifier->prettifyTestClassName($testCase::class),
$prettifier->prettifyTestCase($testCase, false),
$prettifier->prettifyTestCase($testCase, true),
);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function fromClassNameAndMethodName(string $className, string $methodName): TestDox
{
$prettifier = new NamePrettifier;
$prettifiedMethodName = $prettifier->prettifyTestMethodName($methodName);
return new TestDox(
$prettifier->prettifyTestClassName($className),
$prettifiedMethodName,
$prettifiedMethodName,
);
}
}
phpunit/src/Event/Value/Test/TestMethod.php 0000644 00000007067 15243417753 0014714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function assert;
use function is_int;
use function sprintf;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Metadata\MetadataCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestMethod extends Test
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-var non-negative-int
*/
private readonly int $line;
private readonly TestDox $testDox;
private readonly MetadataCollection $metadata;
private readonly TestDataCollection $testData;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param non-empty-string $file
* @psalm-param non-negative-int $line
*/
public function __construct(string $className, string $methodName, string $file, int $line, TestDox $testDox, MetadataCollection $metadata, TestDataCollection $testData)
{
parent::__construct($file);
$this->className = $className;
$this->methodName = $methodName;
$this->line = $line;
$this->testDox = $testDox;
$this->metadata = $metadata;
$this->testData = $testData;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
/**
* @psalm-return non-negative-int
*/
public function line(): int
{
return $this->line;
}
public function testDox(): TestDox
{
return $this->testDox;
}
public function metadata(): MetadataCollection
{
return $this->metadata;
}
public function testData(): TestDataCollection
{
return $this->testData;
}
/**
* @psalm-assert-if-true TestMethod $this
*/
public function isTestMethod(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function id(): string
{
$buffer = $this->className . '::' . $this->methodName;
if ($this->testData()->hasDataFromDataProvider()) {
$buffer .= '#' . $this->testData->dataFromDataProvider()->dataSetName();
}
return $buffer;
}
/**
* @psalm-return non-empty-string
*/
public function nameWithClass(): string
{
return $this->className . '::' . $this->name();
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
if (!$this->testData->hasDataFromDataProvider()) {
return $this->methodName;
}
$dataSetName = $this->testData->dataFromDataProvider()->dataSetName();
if (is_int($dataSetName)) {
$dataSetName = sprintf(
' with data set #%d',
$dataSetName,
);
} else {
$dataSetName = sprintf(
' with data set "%s"',
$dataSetName,
);
}
return $this->methodName . $dataSetName;
}
}
phpunit/src/Event/Value/Test/TestDox.php 0000644 00000002444 15243417753 0014220 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDox
{
private readonly string $prettifiedClassName;
private readonly string $prettifiedMethodName;
private readonly string $prettifiedAndColorizedMethodName;
public function __construct(string $prettifiedClassName, string $prettifiedMethodName, string $prettifiedAndColorizedMethodName)
{
$this->prettifiedClassName = $prettifiedClassName;
$this->prettifiedMethodName = $prettifiedMethodName;
$this->prettifiedAndColorizedMethodName = $prettifiedAndColorizedMethodName;
}
public function prettifiedClassName(): string
{
return $this->prettifiedClassName;
}
public function prettifiedMethodName(bool $colorize = false): string
{
if ($colorize) {
return $this->prettifiedAndColorizedMethodName;
}
return $this->prettifiedMethodName;
}
}
phpunit/src/Event/Value/Test/TestMethodBuilder.php 0000644 00000005557 15243417753 0016225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function assert;
use function debug_backtrace;
use function is_numeric;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\TestData\DataFromDataProvider;
use PHPUnit\Event\TestData\DataFromTestDependency;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Framework\TestCase;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Util\Exporter;
use PHPUnit\Util\Reflection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMethodBuilder
{
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromTestCase(TestCase $testCase): TestMethod
{
$methodName = $testCase->name();
assert(!empty($methodName));
$location = Reflection::sourceLocationFor($testCase::class, $methodName);
return new TestMethod(
$testCase::class,
$methodName,
$location['file'],
$location['line'],
TestDoxBuilder::fromTestCase($testCase),
MetadataRegistry::parser()->forClassAndMethod($testCase::class, $methodName),
self::dataFor($testCase),
);
}
/**
* @throws NoTestCaseObjectOnCallStackException
*/
public static function fromCallStack(): TestMethod
{
foreach (debug_backtrace() as $frame) {
if (isset($frame['object']) && $frame['object'] instanceof TestCase) {
return $frame['object']->valueObjectForEvents();
}
}
throw new NoTestCaseObjectOnCallStackException;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private static function dataFor(TestCase $testCase): TestDataCollection
{
$testData = [];
if ($testCase->usesDataProvider()) {
$dataSetName = $testCase->dataName();
if (is_numeric($dataSetName)) {
$dataSetName = (int) $dataSetName;
}
$testData[] = DataFromDataProvider::from(
$dataSetName,
Exporter::export($testCase->providedData(), EventFacade::emitter()->exportsObjects()),
$testCase->dataSetAsStringWithData(),
);
}
if ($testCase->hasDependencyInput()) {
$testData[] = DataFromTestDependency::from(
Exporter::export($testCase->dependencyInput(), EventFacade::emitter()->exportsObjects()),
);
}
return TestDataCollection::fromArray($testData);
}
}
phpunit/src/Event/Value/Test/TestData/DataFromDataProvider.php 0000644 00000003027 15243417753 0020337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataFromDataProvider extends TestData
{
private readonly int|string $dataSetName;
private readonly string $dataAsStringForResultOutput;
public static function from(int|string $dataSetName, string $data, string $dataAsStringForResultOutput): self
{
return new self($dataSetName, $data, $dataAsStringForResultOutput);
}
protected function __construct(int|string $dataSetName, string $data, string $dataAsStringForResultOutput)
{
$this->dataSetName = $dataSetName;
$this->dataAsStringForResultOutput = $dataAsStringForResultOutput;
parent::__construct($data);
}
public function dataSetName(): int|string
{
return $this->dataSetName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function dataAsStringForResultOutput(): string
{
return $this->dataAsStringForResultOutput;
}
/**
* @psalm-assert-if-true DataFromDataProvider $this
*/
public function isFromDataProvider(): bool
{
return true;
}
}
phpunit/src/Event/Value/Test/TestData/TestDataCollectionIterator.php 0000644 00000002257 15243417753 0021600 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, TestData>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDataCollectionIterator implements Iterator
{
/**
* @psalm-var list<TestData>
*/
private readonly array $data;
private int $position = 0;
public function __construct(TestDataCollection $data)
{
$this->data = $data->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->data);
}
public function key(): int
{
return $this->position;
}
public function current(): TestData
{
return $this->data[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/Event/Value/Test/TestData/DataFromTestDependency.php 0000644 00000001335 15243417753 0020671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataFromTestDependency extends TestData
{
public static function from(string $data): self
{
return new self($data);
}
/**
* @psalm-assert-if-true DataFromTestDependency $this
*/
public function isFromTestDependency(): bool
{
return true;
}
}
phpunit/src/Event/Value/Test/TestData/TestData.php 0000644 00000001706 15243417753 0016050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestData
{
private readonly string $data;
protected function __construct(string $data)
{
$this->data = $data;
}
public function data(): string
{
return $this->data;
}
/**
* @psalm-assert-if-true DataFromDataProvider $this
*/
public function isFromDataProvider(): bool
{
return false;
}
/**
* @psalm-assert-if-true DataFromTestDependency $this
*/
public function isFromTestDependency(): bool
{
return false;
}
}
phpunit/src/Event/Value/Test/TestData/TestDataCollection.php 0000644 00000004771 15243417753 0020071 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, TestData>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDataCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestData>
*/
private readonly array $data;
private ?DataFromDataProvider $fromDataProvider = null;
/**
* @psalm-param list<TestData> $data
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromArray(array $data): self
{
return new self(...$data);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function __construct(TestData ...$data)
{
$this->ensureNoMoreThanOneDataFromDataProvider($data);
$this->data = $data;
}
/**
* @psalm-return list<TestData>
*/
public function asArray(): array
{
return $this->data;
}
public function count(): int
{
return count($this->data);
}
/**
* @psalm-assert-if-true !null $this->fromDataProvider
*/
public function hasDataFromDataProvider(): bool
{
return $this->fromDataProvider !== null;
}
/**
* @throws NoDataSetFromDataProviderException
*/
public function dataFromDataProvider(): DataFromDataProvider
{
if (!$this->hasDataFromDataProvider()) {
throw new NoDataSetFromDataProviderException;
}
return $this->fromDataProvider;
}
public function getIterator(): TestDataCollectionIterator
{
return new TestDataCollectionIterator($this);
}
/**
* @psalm-param list<TestData> $data
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function ensureNoMoreThanOneDataFromDataProvider(array $data): void
{
foreach ($data as $_data) {
if ($_data->isFromDataProvider()) {
if ($this->fromDataProvider !== null) {
throw new MoreThanOneDataSetFromDataProviderException;
}
$this->fromDataProvider = $_data;
}
}
}
}
phpunit/src/Event/Value/Test/Phpt.php 0000644 00000001510 15243417753 0013532 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Phpt extends Test
{
/**
* @psalm-assert-if-true Phpt $this
*/
public function isPhpt(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function id(): string
{
return $this->file();
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->file();
}
}
phpunit/src/Event/Value/ComparisonFailure.php 0000644 00000001753 15243417753 0015333 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonFailure
{
private readonly string $expected;
private readonly string $actual;
private readonly string $diff;
public function __construct(string $expected, string $actual, string $diff)
{
$this->expected = $expected;
$this->actual = $actual;
$this->diff = $diff;
}
public function expected(): string
{
return $this->expected;
}
public function actual(): string
{
return $this->actual;
}
public function diff(): string
{
return $this->diff;
}
}
phpunit/src/Event/Value/ClassMethod.php 0000644 00000002234 15243417753 0014112 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ClassMethod
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Event/Value/Throwable.php 0000644 00000004527 15243417753 0013642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use const PHP_EOL;
use PHPUnit\Event\NoPreviousThrowableException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Throwable
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $message;
private readonly string $description;
private readonly string $stackTrace;
private readonly ?Throwable $previous;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className, string $message, string $description, string $stackTrace, ?self $previous)
{
$this->className = $className;
$this->message = $message;
$this->description = $description;
$this->stackTrace = $stackTrace;
$this->previous = $previous;
}
/**
* @throws NoPreviousThrowableException
*/
public function asString(): string
{
$buffer = $this->description();
if (!empty($this->stackTrace())) {
$buffer .= PHP_EOL . $this->stackTrace();
}
if ($this->hasPrevious()) {
$buffer .= PHP_EOL . 'Caused by' . PHP_EOL . $this->previous()->asString();
}
return $buffer;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function message(): string
{
return $this->message;
}
public function description(): string
{
return $this->description;
}
public function stackTrace(): string
{
return $this->stackTrace;
}
/**
* @psalm-assert-if-true !null $this->previous
*/
public function hasPrevious(): bool
{
return $this->previous !== null;
}
/**
* @throws NoPreviousThrowableException
*/
public function previous(): self
{
if ($this->previous === null) {
throw new NoPreviousThrowableException;
}
return $this->previous;
}
}
phpunit/src/Metadata/RunTestsInSeparateProcesses.php 0000644 00000001211 15243417753 0016713 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunTestsInSeparateProcesses extends Metadata
{
/**
* @psalm-assert-if-true RunTestsInSeparateProcesses $this
*/
public function isRunTestsInSeparateProcesses(): bool
{
return true;
}
}
phpunit/src/Metadata/AfterClass.php 0000644 00000001126 15243417753 0013315 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterClass extends Metadata
{
/**
* @psalm-assert-if-true AfterClass $this
*/
public function isAfterClass(): bool
{
return true;
}
}
phpunit/src/Metadata/RequiresSetting.php 0000644 00000002562 15243417753 0014430 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresSetting extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $setting;
/**
* @psalm-var non-empty-string
*/
private readonly string $value;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
protected function __construct(int $level, string $setting, string $value)
{
parent::__construct($level);
$this->setting = $setting;
$this->value = $value;
}
/**
* @psalm-assert-if-true RequiresSetting $this
*/
public function isRequiresSetting(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function setting(): string
{
return $this->setting;
}
/**
* @psalm-return non-empty-string
*/
public function value(): string
{
return $this->value;
}
}
phpunit/src/Metadata/Test.php 0000644 00000001104 15243417753 0012201 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Test extends Metadata
{
/**
* @psalm-assert-if-true Test $this
*/
public function isTest(): bool
{
return true;
}
}
phpunit/src/Metadata/BeforeClass.php 0000644 00000001131 15243417753 0013452 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeClass extends Metadata
{
/**
* @psalm-assert-if-true BeforeClass $this
*/
public function isBeforeClass(): bool
{
return true;
}
}
phpunit/src/Metadata/BackupGlobals.php 0000644 00000001627 15243417753 0014005 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BackupGlobals extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true BackupGlobals $this
*/
public function isBackupGlobals(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Metadata/RunInSeparateProcess.php 0000644 00000001164 15243417753 0015347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunInSeparateProcess extends Metadata
{
/**
* @psalm-assert-if-true RunInSeparateProcess $this
*/
public function isRunInSeparateProcess(): bool
{
return true;
}
}
phpunit/src/Metadata/MetadataCollectionIterator.php 0000644 00000002301 15243417753 0016530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Metadata>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MetadataCollectionIterator implements Iterator
{
/**
* @psalm-var list<Metadata>
*/
private readonly array $metadata;
private int $position = 0;
public function __construct(MetadataCollection $metadata)
{
$this->metadata = $metadata->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->metadata);
}
public function key(): int
{
return $this->position;
}
public function current(): Metadata
{
return $this->metadata[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/Metadata/CoversClass.php 0000644 00000002455 15243417753 0013523 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true CoversClass $this
*/
public function isCoversClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return class-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return $this->className;
}
}
phpunit/src/Metadata/IgnoreClassForCodeCoverage.php 0000644 00000002250 15243417753 0016414 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreClassForCodeCoverage extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true IgnoreClassForCodeCoverage $this
*/
public function isIgnoreClassForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Metadata/DependsOnClass.php 0000644 00000002665 15243417753 0014144 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DependsOnClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly bool $deepClone;
private readonly bool $shallowClone;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className, bool $deepClone, bool $shallowClone)
{
parent::__construct($level);
$this->className = $className;
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
}
/**
* @psalm-assert-if-true DependsOnClass $this
*/
public function isDependsOnClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
}
phpunit/src/Metadata/MetadataCollection.php 0000644 00000034007 15243417753 0015026 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function array_filter;
use function array_merge;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Metadata>
*
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MetadataCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Metadata>
*/
private readonly array $metadata;
/**
* @psalm-param list<Metadata> $metadata
*/
public static function fromArray(array $metadata): self
{
return new self(...$metadata);
}
private function __construct(Metadata ...$metadata)
{
$this->metadata = $metadata;
}
/**
* @psalm-return list<Metadata>
*/
public function asArray(): array
{
return $this->metadata;
}
public function count(): int
{
return count($this->metadata);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
public function isNotEmpty(): bool
{
return $this->count() > 0;
}
public function getIterator(): MetadataCollectionIterator
{
return new MetadataCollectionIterator($this);
}
public function mergeWith(self $other): self
{
return new self(
...array_merge(
$this->asArray(),
$other->asArray(),
),
);
}
public function isClassLevel(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isClassLevel(),
),
);
}
public function isMethodLevel(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isMethodLevel(),
),
);
}
public function isAfter(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isAfter(),
),
);
}
public function isAfterClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isAfterClass(),
),
);
}
public function isBackupGlobals(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBackupGlobals(),
),
);
}
public function isBackupStaticProperties(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBackupStaticProperties(),
),
);
}
public function isBeforeClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBeforeClass(),
),
);
}
public function isBefore(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBefore(),
),
);
}
public function isCovers(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCovers(),
),
);
}
public function isCoversClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversClass(),
),
);
}
public function isCoversDefaultClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversDefaultClass(),
),
);
}
public function isCoversFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversFunction(),
),
);
}
public function isExcludeGlobalVariableFromBackup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isExcludeGlobalVariableFromBackup(),
),
);
}
public function isExcludeStaticPropertyFromBackup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isExcludeStaticPropertyFromBackup(),
),
);
}
public function isCoversNothing(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversNothing(),
),
);
}
public function isDataProvider(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDataProvider(),
),
);
}
public function isDepends(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnClass() || $metadata->isDependsOnMethod(),
),
);
}
public function isDependsOnClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnClass(),
),
);
}
public function isDependsOnMethod(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnMethod(),
),
);
}
public function isDoesNotPerformAssertions(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDoesNotPerformAssertions(),
),
);
}
public function isGroup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isGroup(),
),
);
}
public function isIgnoreDeprecations(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreDeprecations(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreClassForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreClassForCodeCoverage(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreMethodForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreMethodForCodeCoverage(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreFunctionForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreFunctionForCodeCoverage(),
),
);
}
public function isRunClassInSeparateProcess(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunClassInSeparateProcess(),
),
);
}
public function isRunInSeparateProcess(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunInSeparateProcess(),
),
);
}
public function isRunTestsInSeparateProcesses(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunTestsInSeparateProcesses(),
),
);
}
public function isTest(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTest(),
),
);
}
public function isPreCondition(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPreCondition(),
),
);
}
public function isPostCondition(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPostCondition(),
),
);
}
public function isPreserveGlobalState(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPreserveGlobalState(),
),
);
}
public function isRequiresMethod(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresMethod(),
),
);
}
public function isRequiresFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresFunction(),
),
);
}
public function isRequiresOperatingSystem(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresOperatingSystem(),
),
);
}
public function isRequiresOperatingSystemFamily(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresOperatingSystemFamily(),
),
);
}
public function isRequiresPhp(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhp(),
),
);
}
public function isRequiresPhpExtension(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhpExtension(),
),
);
}
public function isRequiresPhpunit(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhpunit(),
),
);
}
public function isRequiresSetting(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresSetting(),
),
);
}
public function isTestDox(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTestDox(),
),
);
}
public function isTestWith(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTestWith(),
),
);
}
public function isUses(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUses(),
),
);
}
public function isUsesClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesClass(),
),
);
}
public function isUsesDefaultClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesDefaultClass(),
),
);
}
public function isUsesFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesFunction(),
),
);
}
public function isWithoutErrorHandler(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isWithoutErrorHandler(),
),
);
}
}
phpunit/src/Metadata/DataProvider.php 0000644 00000002615 15243417753 0013656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProvider extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true DataProvider $this
*/
public function isDataProvider(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Metadata/CoversNothing.php 0000644 00000001137 15243417753 0014060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversNothing extends Metadata
{
/**
* @psalm-assert-if-true CoversNothing $this
*/
public function isCoversNothing(): bool
{
return true;
}
}
phpunit/src/Metadata/Before.php 0000644 00000001112 15243417753 0012463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Before extends Metadata
{
/**
* @psalm-assert-if-true Before $this
*/
public function isBefore(): bool
{
return true;
}
}
phpunit/src/Metadata/RunClassInSeparateProcess.php 0000644 00000001203 15243417753 0016327 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunClassInSeparateProcess extends Metadata
{
/**
* @psalm-assert-if-true RunClassInSeparateProcess $this
*/
public function isRunClassInSeparateProcess(): bool
{
return true;
}
}
phpunit/src/Metadata/RequiresOperatingSystem.php 0000644 00000002207 15243417753 0016144 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresOperatingSystem extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystem;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $operatingSystem
*/
public function __construct(int $level, string $operatingSystem)
{
parent::__construct($level);
$this->operatingSystem = $operatingSystem;
}
/**
* @psalm-assert-if-true RequiresOperatingSystem $this
*/
public function isRequiresOperatingSystem(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystem(): string
{
return $this->operatingSystem;
}
}
phpunit/src/Metadata/Version/ComparisonRequirement.php 0000644 00000002117 15243417753 0017247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function version_compare;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonRequirement extends Requirement
{
private readonly string $version;
private readonly VersionComparisonOperator $operator;
public function __construct(string $version, VersionComparisonOperator $operator)
{
$this->version = $version;
$this->operator = $operator;
}
public function isSatisfiedBy(string $version): bool
{
return version_compare($version, $this->version, $this->operator->asString());
}
public function asString(): string
{
return $this->operator->asString() . ' ' . $this->version;
}
}
phpunit/src/Metadata/Version/ConstraintRequirement.php 0000644 00000002453 15243417753 0017264 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function preg_replace;
use PharIo\Version\Version;
use PharIo\Version\VersionConstraint;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ConstraintRequirement extends Requirement
{
private readonly VersionConstraint $constraint;
public function __construct(VersionConstraint $constraint)
{
$this->constraint = $constraint;
}
/**
* @psalm-suppress ImpureMethodCall
*/
public function isSatisfiedBy(string $version): bool
{
return $this->constraint->complies(
new Version($this->sanitize($version)),
);
}
/**
* @psalm-suppress ImpureMethodCall
*/
public function asString(): string
{
return $this->constraint->asString();
}
private function sanitize(string $version): string
{
return preg_replace(
'/^(\d+\.\d+(?:.\d+)?).*$/',
'$1',
$version,
);
}
}
phpunit/src/Metadata/Version/Requirement.php 0000644 00000003504 15243417753 0015215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function preg_match;
use PharIo\Version\UnsupportedVersionConstraintException;
use PharIo\Version\VersionConstraintParser;
use PHPUnit\Metadata\InvalidVersionRequirementException;
use PHPUnit\Util\InvalidVersionOperatorException;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Requirement
{
private const VERSION_COMPARISON = '/(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+(dev|(RC|alpha|beta)[\d\.])?)[ \t]*\r?$/m';
/**
* @throws InvalidVersionOperatorException
* @throws InvalidVersionRequirementException
*/
public static function from(string $versionRequirement): self
{
try {
return new ConstraintRequirement(
(new VersionConstraintParser)->parse(
$versionRequirement,
),
);
} catch (UnsupportedVersionConstraintException) {
if (preg_match(self::VERSION_COMPARISON, $versionRequirement, $matches)) {
return new ComparisonRequirement(
$matches['version'],
new VersionComparisonOperator(
!empty($matches['operator']) ? $matches['operator'] : '>=',
),
);
}
}
throw new InvalidVersionRequirementException;
}
abstract public function isSatisfiedBy(string $version): bool;
abstract public function asString(): string;
}
phpunit/src/Metadata/PreCondition.php 0000644 00000001134 15243417753 0013662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreCondition extends Metadata
{
/**
* @psalm-assert-if-true PreCondition $this
*/
public function isPreCondition(): bool
{
return true;
}
}
phpunit/src/Metadata/RequiresOperatingSystemFamily.php 0000644 00000002306 15243417753 0017306 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresOperatingSystemFamily extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystemFamily;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $operatingSystemFamily
*/
protected function __construct(int $level, string $operatingSystemFamily)
{
parent::__construct($level);
$this->operatingSystemFamily = $operatingSystemFamily;
}
/**
* @psalm-assert-if-true RequiresOperatingSystemFamily $this
*/
public function isRequiresOperatingSystemFamily(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
phpunit/src/Metadata/IgnoreMethodForCodeCoverage.php 0000644 00000003005 15243417753 0016566 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreMethodForCodeCoverage extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true IgnoreMethodForCodeCoverage $this
*/
public function isIgnoreMethodForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Metadata/BackupStaticProperties.php 0000644 00000001662 15243417753 0015725 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BackupStaticProperties extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true BackupStaticProperties $this
*/
public function isBackupStaticProperties(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Metadata/WithoutErrorHandler.php 0000644 00000001161 15243417753 0015240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WithoutErrorHandler extends Metadata
{
/**
* @psalm-assert-if-true WithoutErrorHandler $this
*/
public function isWithoutErrorHandler(): bool
{
return true;
}
}
phpunit/src/Metadata/TestDox.php 0000644 00000002015 15243417753 0012656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDox extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $text
*/
protected function __construct(int $level, string $text)
{
parent::__construct($level);
$this->text = $text;
}
/**
* @psalm-assert-if-true TestDox $this
*/
public function isTestDox(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
phpunit/src/Metadata/RequiresFunction.php 0000644 00000002140 15243417753 0014570 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true RequiresFunction $this
*/
public function isRequiresFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Metadata/UsesFunction.php 0000644 00000002457 15243417753 0013723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
public function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true UsesFunction $this
*/
public function isUsesFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return '::' . $this->functionName;
}
}
phpunit/src/Metadata/UsesClass.php 0000644 00000002447 15243417753 0013202 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true UsesClass $this
*/
public function isUsesClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return class-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return $this->className;
}
}
phpunit/src/Metadata/After.php 0000644 00000001107 15243417753 0012326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class After extends Metadata
{
/**
* @psalm-assert-if-true After $this
*/
public function isAfter(): bool
{
return true;
}
}
phpunit/src/Metadata/Group.php 0000644 00000002052 15243417753 0012361 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Group extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $groupName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $groupName
*/
protected function __construct(int $level, string $groupName)
{
parent::__construct($level);
$this->groupName = $groupName;
}
/**
* @psalm-assert-if-true Group $this
*/
public function isGroup(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function groupName(): string
{
return $this->groupName;
}
}
phpunit/src/Metadata/Api/DataProvider.php 0000644 00000023310 15243417753 0014362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_key_exists;
use function assert;
use function explode;
use function is_array;
use function is_int;
use function json_decode;
use function json_last_error;
use function json_last_error_msg;
use function preg_match;
use function preg_replace;
use function rtrim;
use function sprintf;
use function str_replace;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Event;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Framework\InvalidDataProviderException;
use PHPUnit\Metadata\DataProvider as DataProviderMetadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\TestWith;
use PHPUnit\Util\Reflection;
use ReflectionClass;
use ReflectionMethod;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DataProvider
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
public function providedData(string $className, string $methodName): ?array
{
$dataProvider = MetadataRegistry::parser()->forMethod($className, $methodName)->isDataProvider();
$testWith = MetadataRegistry::parser()->forMethod($className, $methodName)->isTestWith();
if ($dataProvider->isEmpty() && $testWith->isEmpty()) {
return $this->dataProvidedByTestWithAnnotation($className, $methodName);
}
if ($dataProvider->isNotEmpty()) {
$data = $this->dataProvidedByMethods($className, $methodName, $dataProvider);
} else {
$data = $this->dataProvidedByMetadata($testWith);
}
if ($data === []) {
throw new InvalidDataProviderException(
'Empty data set provided by data provider',
);
}
foreach ($data as $key => $value) {
if (!is_array($value)) {
throw new InvalidDataProviderException(
sprintf(
'Data set %s is invalid',
is_int($key) ? '#' . $key : '"' . $key . '"',
),
);
}
}
return $data;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
private function dataProvidedByMethods(string $className, string $methodName, MetadataCollection $dataProvider): array
{
$testMethod = new Event\Code\ClassMethod($className, $methodName);
$methodsCalled = [];
$result = [];
foreach ($dataProvider as $_dataProvider) {
assert($_dataProvider instanceof DataProviderMetadata);
$dataProviderMethod = new Event\Code\ClassMethod($_dataProvider->className(), $_dataProvider->methodName());
Event\Facade::emitter()->dataProviderMethodCalled(
$testMethod,
$dataProviderMethod,
);
$methodsCalled[] = $dataProviderMethod;
try {
$class = new ReflectionClass($_dataProvider->className());
$method = $class->getMethod($_dataProvider->methodName());
$object = null;
if (!$method->isPublic()) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() is not public',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
}
if (!$method->isStatic()) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() is not static',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
$object = $class->newInstanceWithoutConstructor();
}
if ($method->getNumberOfParameters() === 0) {
$data = $method->invoke($object);
} else {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() expects an argument',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
$data = $method->invoke($object, $_dataProvider->methodName());
}
} catch (Throwable $e) {
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
throw new InvalidDataProviderException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
foreach ($data as $key => $value) {
if (is_int($key)) {
$result[] = $value;
} elseif (array_key_exists($key, $result)) {
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
throw new InvalidDataProviderException(
sprintf(
'The key "%s" has already been defined by a previous data provider',
$key,
),
);
} else {
$result[$key] = $value;
}
}
}
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
return $result;
}
private function dataProvidedByMetadata(MetadataCollection $testWith): array
{
$result = [];
foreach ($testWith as $_testWith) {
assert($_testWith instanceof TestWith);
$result[] = $_testWith->data();
}
return $result;
}
/**
* @psalm-param class-string $className
*
* @throws InvalidDataProviderException
*/
private function dataProvidedByTestWithAnnotation(string $className, string $methodName): ?array
{
$docComment = (new ReflectionMethod($className, $methodName))->getDocComment();
if ($docComment === false) {
return null;
}
$docComment = str_replace("\r\n", "\n", $docComment);
$docComment = preg_replace('/\n\s*\*\s?/', "\n", $docComment);
$docComment = substr($docComment, 0, -1);
$docComment = rtrim($docComment, "\n");
if (!preg_match('/@testWith\s+/', $docComment, $matches, PREG_OFFSET_CAPTURE)) {
return null;
}
$offset = strlen($matches[0][0]) + (int) $matches[0][1];
$annotationContent = substr($docComment, $offset);
$data = [];
foreach (explode("\n", $annotationContent) as $candidateRow) {
$candidateRow = trim($candidateRow);
if ($candidateRow === '' || $candidateRow[0] !== '[') {
break;
}
$dataSet = json_decode($candidateRow, true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new InvalidDataProviderException(
'The data set for the @testWith annotation cannot be parsed: ' . json_last_error_msg(),
);
}
$data[] = $dataSet;
}
if (!$data) {
throw new InvalidDataProviderException(
'The data set for the @testWith annotation cannot be parsed.',
);
}
return $data;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function valueObjectForTestMethodWithoutTestData(string $className, string $methodName): TestMethod
{
$location = Reflection::sourceLocationFor($className, $methodName);
return new TestMethod(
$className,
$methodName,
$location['file'],
$location['line'],
Event\Code\TestDoxBuilder::fromClassNameAndMethodName(
$className,
$methodName,
),
MetadataRegistry::parser()->forClassAndMethod(
$className,
$methodName,
),
TestDataCollection::fromArray([]),
);
}
}
phpunit/src/Metadata/Api/Requirements.php 0000644 00000012313 15243417753 0014462 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use const PHP_OS;
use const PHP_OS_FAMILY;
use const PHP_VERSION;
use function addcslashes;
use function assert;
use function extension_loaded;
use function function_exists;
use function ini_get;
use function method_exists;
use function phpversion;
use function preg_match;
use function sprintf;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\RequiresFunction;
use PHPUnit\Metadata\RequiresMethod;
use PHPUnit\Metadata\RequiresOperatingSystem;
use PHPUnit\Metadata\RequiresOperatingSystemFamily;
use PHPUnit\Metadata\RequiresPhp;
use PHPUnit\Metadata\RequiresPhpExtension;
use PHPUnit\Metadata\RequiresPhpunit;
use PHPUnit\Metadata\RequiresSetting;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Requirements
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return list<string>
*/
public function requirementsNotSatisfiedFor(string $className, string $methodName): array
{
$notSatisfied = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isRequiresPhp()) {
assert($metadata instanceof RequiresPhp);
if (!$metadata->versionRequirement()->isSatisfiedBy(PHP_VERSION)) {
$notSatisfied[] = sprintf(
'PHP %s is required.',
$metadata->versionRequirement()->asString(),
);
}
}
if ($metadata->isRequiresPhpExtension()) {
assert($metadata instanceof RequiresPhpExtension);
if (!extension_loaded($metadata->extension()) ||
($metadata->hasVersionRequirement() &&
!$metadata->versionRequirement()->isSatisfiedBy(phpversion($metadata->extension())))) {
$notSatisfied[] = sprintf(
'PHP extension %s%s is required.',
$metadata->extension(),
$metadata->hasVersionRequirement() ? (' ' . $metadata->versionRequirement()->asString()) : '',
);
}
}
if ($metadata->isRequiresPhpunit()) {
assert($metadata instanceof RequiresPhpunit);
if (!$metadata->versionRequirement()->isSatisfiedBy(Version::id())) {
$notSatisfied[] = sprintf(
'PHPUnit %s is required.',
$metadata->versionRequirement()->asString(),
);
}
}
if ($metadata->isRequiresOperatingSystemFamily()) {
assert($metadata instanceof RequiresOperatingSystemFamily);
if ($metadata->operatingSystemFamily() !== PHP_OS_FAMILY) {
$notSatisfied[] = sprintf(
'Operating system %s is required.',
$metadata->operatingSystemFamily(),
);
}
}
if ($metadata->isRequiresOperatingSystem()) {
assert($metadata instanceof RequiresOperatingSystem);
$pattern = sprintf(
'/%s/i',
addcslashes($metadata->operatingSystem(), '/'),
);
if (!preg_match($pattern, PHP_OS)) {
$notSatisfied[] = sprintf(
'Operating system %s is required.',
$metadata->operatingSystem(),
);
}
}
if ($metadata->isRequiresFunction()) {
assert($metadata instanceof RequiresFunction);
if (!function_exists($metadata->functionName())) {
$notSatisfied[] = sprintf(
'Function %s() is required.',
$metadata->functionName(),
);
}
}
if ($metadata->isRequiresMethod()) {
assert($metadata instanceof RequiresMethod);
if (!method_exists($metadata->className(), $metadata->methodName())) {
$notSatisfied[] = sprintf(
'Method %s::%s() is required.',
$metadata->className(),
$metadata->methodName(),
);
}
}
if ($metadata->isRequiresSetting()) {
assert($metadata instanceof RequiresSetting);
if (ini_get($metadata->setting()) !== $metadata->value()) {
$notSatisfied[] = sprintf(
'Setting "%s" is required to be "%s".',
$metadata->setting(),
$metadata->value(),
);
}
}
}
return $notSatisfied;
}
}
phpunit/src/Metadata/Api/Dependencies.php 0000644 00000003046 15243417753 0014370 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function assert;
use PHPUnit\Framework\ExecutionOrderDependency;
use PHPUnit\Metadata\DependsOnClass;
use PHPUnit\Metadata\DependsOnMethod;
use PHPUnit\Metadata\Parser\Registry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Dependencies
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function dependencies(string $className, string $methodName): array
{
$dependencies = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName)->isDepends() as $metadata) {
if ($metadata->isDependsOnClass()) {
assert($metadata instanceof DependsOnClass);
$dependencies[] = ExecutionOrderDependency::forClass($metadata);
continue;
}
assert($metadata instanceof DependsOnMethod);
if (empty($metadata->methodName())) {
$dependencies[] = ExecutionOrderDependency::invalid();
continue;
}
$dependencies[] = ExecutionOrderDependency::forMethod($metadata);
}
return $dependencies;
}
}
phpunit/src/Metadata/Api/Groups.php 0000644 00000007307 15243417753 0013265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_flip;
use function array_key_exists;
use function array_unique;
use function assert;
use function strtolower;
use function trim;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Covers;
use PHPUnit\Metadata\CoversClass;
use PHPUnit\Metadata\CoversFunction;
use PHPUnit\Metadata\Group;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\Uses;
use PHPUnit\Metadata\UsesClass;
use PHPUnit\Metadata\UsesFunction;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Groups
{
/**
* @var array<string, array<int, string>>
*/
private static array $groupCache = [];
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<int, string>
*/
public function groups(string $className, string $methodName, bool $includeVirtual = true): array
{
$key = $className . '::' . $methodName . '::' . $includeVirtual;
if (array_key_exists($key, self::$groupCache)) {
return self::$groupCache[$key];
}
$groups = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName)->isGroup() as $group) {
assert($group instanceof Group);
$groups[] = $group->groupName();
}
if ($groups === []) {
$groups[] = 'default';
}
if (!$includeVirtual) {
return self::$groupCache[$key] = array_unique($groups);
}
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isCoversClass() || $metadata->isCoversFunction()) {
assert($metadata instanceof CoversClass || $metadata instanceof CoversFunction);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isCovers()) {
assert($metadata instanceof Covers);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->target());
continue;
}
if ($metadata->isUsesClass() || $metadata->isUsesFunction()) {
assert($metadata instanceof UsesClass || $metadata instanceof UsesFunction);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isUses()) {
assert($metadata instanceof Uses);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->target());
}
}
return self::$groupCache[$key] = array_unique($groups);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function size(string $className, string $methodName): TestSize
{
$groups = array_flip($this->groups($className, $methodName));
if (isset($groups['large'])) {
return TestSize::large();
}
if (isset($groups['medium'])) {
return TestSize::medium();
}
if (isset($groups['small'])) {
return TestSize::small();
}
return TestSize::unknown();
}
private function canonicalizeName(string $name): string
{
return strtolower(trim($name, '\\'));
}
}
phpunit/src/Metadata/Api/HookMethods.php 0000644 00000007245 15243417753 0014233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_unshift;
use function assert;
use function class_exists;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Util\Reflection;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class HookMethods
{
/**
* @psalm-var array<class-string, array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}>
*/
private static array $hookMethods = [];
/**
* @psalm-param class-string $className
*
* @psalm-return array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}
*/
public function hookMethods(string $className): array
{
if (!class_exists($className)) {
return self::emptyHookMethodsArray();
}
if (isset(self::$hookMethods[$className])) {
return self::$hookMethods[$className];
}
self::$hookMethods[$className] = self::emptyHookMethodsArray();
foreach (Reflection::methodsInTestClass(new ReflectionClass($className)) as $method) {
$methodName = $method->getName();
assert(!empty($methodName));
$metadata = Registry::parser()->forMethod($className, $methodName);
if ($method->isStatic()) {
if ($metadata->isBeforeClass()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['beforeClass'],
$methodName,
);
}
if ($metadata->isAfterClass()->isNotEmpty()) {
self::$hookMethods[$className]['afterClass'][] = $methodName;
}
}
if ($metadata->isBefore()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['before'],
$methodName,
);
}
if ($metadata->isPreCondition()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['preCondition'],
$methodName,
);
}
if ($metadata->isPostCondition()->isNotEmpty()) {
self::$hookMethods[$className]['postCondition'][] = $methodName;
}
if ($metadata->isAfter()->isNotEmpty()) {
self::$hookMethods[$className]['after'][] = $methodName;
}
}
return self::$hookMethods[$className];
}
/**
* @psalm-return array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}
*/
private function emptyHookMethodsArray(): array
{
return [
'beforeClass' => ['setUpBeforeClass'],
'before' => ['setUp'],
'preCondition' => ['assertPreConditions'],
'postCondition' => ['assertPostConditions'],
'after' => ['tearDown'],
'afterClass' => ['tearDownAfterClass'],
];
}
}
phpunit/src/Metadata/Api/CodeCoverage.php 0000644 00000024654 15243417753 0014340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_unique;
use function array_values;
use function assert;
use function count;
use function interface_exists;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\CodeCoverageException;
use PHPUnit\Framework\InvalidCoversTargetException;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Metadata\Covers;
use PHPUnit\Metadata\CoversClass;
use PHPUnit\Metadata\CoversDefaultClass;
use PHPUnit\Metadata\CoversFunction;
use PHPUnit\Metadata\IgnoreClassForCodeCoverage;
use PHPUnit\Metadata\IgnoreFunctionForCodeCoverage;
use PHPUnit\Metadata\IgnoreMethodForCodeCoverage;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\Uses;
use PHPUnit\Metadata\UsesClass;
use PHPUnit\Metadata\UsesDefaultClass;
use PHPUnit\Metadata\UsesFunction;
use RecursiveIteratorIterator;
use SebastianBergmann\CodeUnit\CodeUnitCollection;
use SebastianBergmann\CodeUnit\Exception as CodeUnitException;
use SebastianBergmann\CodeUnit\InvalidCodeUnitException;
use SebastianBergmann\CodeUnit\Mapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverage
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<string,list<int>>|false
*
* @throws CodeCoverageException
*/
public function linesToBeCovered(string $className, string $methodName): array|false
{
if (!$this->shouldCodeCoverageBeCollectedFor($className, $methodName)) {
return false;
}
$metadataForClass = Registry::parser()->forClass($className);
$classShortcut = null;
if ($metadataForClass->isCoversDefaultClass()->isNotEmpty()) {
if (count($metadataForClass->isCoversDefaultClass()) > 1) {
throw new CodeCoverageException(
sprintf(
'More than one @coversDefaultClass annotation for class or interface "%s"',
$className,
),
);
}
$metadata = $metadataForClass->isCoversDefaultClass()->asArray()[0];
assert($metadata instanceof CoversDefaultClass);
$classShortcut = $metadata->className();
}
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if (!$metadata->isCoversClass() && !$metadata->isCoversFunction() && !$metadata->isCovers()) {
continue;
}
assert($metadata instanceof CoversClass || $metadata instanceof CoversFunction || $metadata instanceof Covers);
if ($metadata->isCoversClass() || $metadata->isCoversFunction()) {
$codeUnits = $codeUnits->mergeWith($this->mapToCodeUnits($metadata));
} elseif ($metadata->isCovers()) {
assert($metadata instanceof Covers);
$target = $metadata->target();
if (interface_exists($target)) {
throw new InvalidCoversTargetException(
sprintf(
'Trying to @cover interface "%s".',
$target,
),
);
}
if ($classShortcut !== null && str_starts_with($target, '::')) {
$target = $classShortcut . $target;
}
try {
$codeUnits = $codeUnits->mergeWith($mapper->stringToCodeUnits($target));
} catch (InvalidCodeUnitException $e) {
throw new InvalidCoversTargetException(
sprintf(
'"@covers %s" is invalid',
$target,
),
$e->getCode(),
$e,
);
}
}
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<string,list<int>>
*
* @throws CodeCoverageException
*/
public function linesToBeUsed(string $className, string $methodName): array
{
$metadataForClass = Registry::parser()->forClass($className);
$classShortcut = null;
if ($metadataForClass->isUsesDefaultClass()->isNotEmpty()) {
if (count($metadataForClass->isUsesDefaultClass()) > 1) {
throw new CodeCoverageException(
sprintf(
'More than one @usesDefaultClass annotation for class or interface "%s"',
$className,
),
);
}
$metadata = $metadataForClass->isUsesDefaultClass()->asArray()[0];
assert($metadata instanceof UsesDefaultClass);
$classShortcut = $metadata->className();
}
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if (!$metadata->isUsesClass() && !$metadata->isUsesFunction() && !$metadata->isUses()) {
continue;
}
assert($metadata instanceof UsesClass || $metadata instanceof UsesFunction || $metadata instanceof Uses);
if ($metadata->isUsesClass() || $metadata->isUsesFunction()) {
$codeUnits = $codeUnits->mergeWith($this->mapToCodeUnits($metadata));
} elseif ($metadata->isUses()) {
assert($metadata instanceof Uses);
$target = $metadata->target();
if ($classShortcut !== null && str_starts_with($target, '::')) {
$target = $classShortcut . $target;
}
try {
$codeUnits = $codeUnits->mergeWith($mapper->stringToCodeUnits($target));
} catch (InvalidCodeUnitException $e) {
throw new InvalidCoversTargetException(
sprintf(
'"@uses %s" is invalid',
$target,
),
$e->getCode(),
$e,
);
}
}
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-return array<string,list<int>>
*/
public function linesToBeIgnored(TestSuite $testSuite): array
{
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach ($this->testCaseClassesIn($testSuite) as $testCaseClassName) {
$codeUnits = $codeUnits->mergeWith(
$this->codeUnitsIgnoredBy($testCaseClassName),
);
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function shouldCodeCoverageBeCollectedFor(string $className, string $methodName): bool
{
$metadataForClass = Registry::parser()->forClass($className);
$metadataForMethod = Registry::parser()->forMethod($className, $methodName);
if ($metadataForMethod->isCoversNothing()->isNotEmpty()) {
return false;
}
if ($metadataForMethod->isCovers()->isNotEmpty() ||
$metadataForMethod->isCoversClass()->isNotEmpty() ||
$metadataForMethod->isCoversFunction()->isNotEmpty()) {
return true;
}
if ($metadataForClass->isCoversNothing()->isNotEmpty()) {
return false;
}
return true;
}
/**
* @psalm-return list<class-string>
*/
private function testCaseClassesIn(TestSuite $testSuite): array
{
$classNames = [];
foreach (new RecursiveIteratorIterator($testSuite) as $test) {
$classNames[] = $test::class;
}
return array_values(array_unique($classNames));
}
/**
* @psalm-param class-string $className
*/
private function codeUnitsIgnoredBy(string $className): CodeUnitCollection
{
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClass($className) as $metadata) {
if ($metadata instanceof IgnoreClassForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits($metadata->className()),
);
}
if ($metadata instanceof IgnoreMethodForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits($metadata->className() . '::' . $metadata->methodName()),
);
}
if ($metadata instanceof IgnoreFunctionForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits('::' . $metadata->functionName()),
);
}
}
return $codeUnits;
}
/**
* @throws InvalidCoversTargetException
*/
private function mapToCodeUnits(CoversClass|CoversFunction|UsesClass|UsesFunction $metadata): CodeUnitCollection
{
$mapper = new Mapper;
try {
return $mapper->stringToCodeUnits($metadata->asStringForCodeUnitMapper());
} catch (CodeUnitException $e) {
if ($metadata->isCoversClass() || $metadata->isUsesClass()) {
if (interface_exists($metadata->className())) {
$type = 'Interface';
} else {
$type = 'Class';
}
} else {
$type = 'Function';
}
throw new InvalidCoversTargetException(
sprintf(
'%s "%s" is not a valid target for code coverage',
$type,
$metadata->asStringForCodeUnitMapper(),
),
$e->getCode(),
$e,
);
}
}
}
phpunit/src/Metadata/ExcludeGlobalVariableFromBackup.php 0000644 00000002267 15243417753 0017427 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeGlobalVariableFromBackup extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $globalVariableName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $globalVariableName
*/
protected function __construct(int $level, string $globalVariableName)
{
parent::__construct($level);
$this->globalVariableName = $globalVariableName;
}
/**
* @psalm-assert-if-true ExcludeGlobalVariableFromBackup $this
*/
public function isExcludeGlobalVariableFromBackup(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function globalVariableName(): string
{
return $this->globalVariableName;
}
}
phpunit/src/Metadata/IgnoreDeprecations.php 0000644 00000001156 15243417753 0015055 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IgnoreDeprecations extends Metadata
{
/**
* @psalm-assert-if-true IgnoreDeprecations $this
*/
public function isIgnoreDeprecations(): bool
{
return true;
}
}
phpunit/src/Metadata/DoesNotPerformAssertions.php 0000644 00000001200 15243417753 0016240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DoesNotPerformAssertions extends Metadata
{
/**
* @psalm-assert-if-true DoesNotPerformAssertions $this
*/
public function isDoesNotPerformAssertions(): bool
{
return true;
}
}
phpunit/src/Metadata/Exception/AnnotationsAreNotSupportedForInternalClassesException.php 0000644 00000001615 15243417753 0026104 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function sprintf;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnnotationsAreNotSupportedForInternalClassesException extends RuntimeException implements Exception
{
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Annotations can only be parsed for user-defined classes, trying to parse annotations for class "%s"',
$className,
),
);
}
}
phpunit/src/Metadata/Exception/InvalidVersionRequirementException.php 0000644 00000000622 15243417753 0022260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use RuntimeException;
final class InvalidVersionRequirementException extends RuntimeException implements Exception
{
}
phpunit/src/Metadata/Exception/Exception.php 0000644 00000000515 15243417753 0015163 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
interface Exception extends \PHPUnit\Exception
{
}
phpunit/src/Metadata/Exception/ReflectionException.php 0000644 00000000773 15243417753 0017204 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
phpunit/src/Metadata/Exception/NoVersionRequirementException.php 0000644 00000000615 15243417753 0021250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use RuntimeException;
final class NoVersionRequirementException extends RuntimeException implements Exception
{
}
phpunit/src/Metadata/Metadata.php 0000644 00000051316 15243417753 0013014 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Metadata
{
private const CLASS_LEVEL = 0;
private const METHOD_LEVEL = 1;
/**
* @psalm-var 0|1
*/
private readonly int $level;
public static function after(): After
{
return new After(self::METHOD_LEVEL);
}
public static function afterClass(): AfterClass
{
return new AfterClass(self::METHOD_LEVEL);
}
public static function backupGlobalsOnClass(bool $enabled): BackupGlobals
{
return new BackupGlobals(self::CLASS_LEVEL, $enabled);
}
public static function backupGlobalsOnMethod(bool $enabled): BackupGlobals
{
return new BackupGlobals(self::METHOD_LEVEL, $enabled);
}
public static function backupStaticPropertiesOnClass(bool $enabled): BackupStaticProperties
{
return new BackupStaticProperties(self::CLASS_LEVEL, $enabled);
}
public static function backupStaticPropertiesOnMethod(bool $enabled): BackupStaticProperties
{
return new BackupStaticProperties(self::METHOD_LEVEL, $enabled);
}
public static function before(): Before
{
return new Before(self::METHOD_LEVEL);
}
public static function beforeClass(): BeforeClass
{
return new BeforeClass(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
*/
public static function coversClass(string $className): CoversClass
{
return new CoversClass(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function coversFunction(string $functionName): CoversFunction
{
return new CoversFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $target
*/
public static function coversOnClass(string $target): Covers
{
return new Covers(self::CLASS_LEVEL, $target);
}
/**
* @psalm-param non-empty-string $target
*/
public static function coversOnMethod(string $target): Covers
{
return new Covers(self::METHOD_LEVEL, $target);
}
/**
* @psalm-param class-string $className
*/
public static function coversDefaultClass(string $className): CoversDefaultClass
{
return new CoversDefaultClass(self::CLASS_LEVEL, $className);
}
public static function coversNothingOnClass(): CoversNothing
{
return new CoversNothing(self::CLASS_LEVEL);
}
public static function coversNothingOnMethod(): CoversNothing
{
return new CoversNothing(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function dataProvider(string $className, string $methodName): DataProvider
{
return new DataProvider(self::METHOD_LEVEL, $className, $methodName);
}
/**
* @psalm-param class-string $className
*/
public static function dependsOnClass(string $className, bool $deepClone, bool $shallowClone): DependsOnClass
{
return new DependsOnClass(self::METHOD_LEVEL, $className, $deepClone, $shallowClone);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function dependsOnMethod(string $className, string $methodName, bool $deepClone, bool $shallowClone): DependsOnMethod
{
return new DependsOnMethod(self::METHOD_LEVEL, $className, $methodName, $deepClone, $shallowClone);
}
public static function doesNotPerformAssertionsOnClass(): DoesNotPerformAssertions
{
return new DoesNotPerformAssertions(self::CLASS_LEVEL);
}
public static function doesNotPerformAssertionsOnMethod(): DoesNotPerformAssertions
{
return new DoesNotPerformAssertions(self::METHOD_LEVEL);
}
/**
* @psalm-param non-empty-string $globalVariableName
*/
public static function excludeGlobalVariableFromBackupOnClass(string $globalVariableName): ExcludeGlobalVariableFromBackup
{
return new ExcludeGlobalVariableFromBackup(self::CLASS_LEVEL, $globalVariableName);
}
/**
* @psalm-param non-empty-string $globalVariableName
*/
public static function excludeGlobalVariableFromBackupOnMethod(string $globalVariableName): ExcludeGlobalVariableFromBackup
{
return new ExcludeGlobalVariableFromBackup(self::METHOD_LEVEL, $globalVariableName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public static function excludeStaticPropertyFromBackupOnClass(string $className, string $propertyName): ExcludeStaticPropertyFromBackup
{
return new ExcludeStaticPropertyFromBackup(self::CLASS_LEVEL, $className, $propertyName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public static function excludeStaticPropertyFromBackupOnMethod(string $className, string $propertyName): ExcludeStaticPropertyFromBackup
{
return new ExcludeStaticPropertyFromBackup(self::METHOD_LEVEL, $className, $propertyName);
}
/**
* @psalm-param non-empty-string $groupName
*/
public static function groupOnClass(string $groupName): Group
{
return new Group(self::CLASS_LEVEL, $groupName);
}
/**
* @psalm-param non-empty-string $groupName
*/
public static function groupOnMethod(string $groupName): Group
{
return new Group(self::METHOD_LEVEL, $groupName);
}
public static function ignoreDeprecationsOnClass(): IgnoreDeprecations
{
return new IgnoreDeprecations(self::CLASS_LEVEL);
}
public static function ignoreDeprecationsOnMethod(): IgnoreDeprecations
{
return new IgnoreDeprecations(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
*/
public static function ignoreClassForCodeCoverage(string $className): IgnoreClassForCodeCoverage
{
return new IgnoreClassForCodeCoverage(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function ignoreMethodForCodeCoverage(string $className, string $methodName): IgnoreMethodForCodeCoverage
{
return new IgnoreMethodForCodeCoverage(self::CLASS_LEVEL, $className, $methodName);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function ignoreFunctionForCodeCoverage(string $functionName): IgnoreFunctionForCodeCoverage
{
return new IgnoreFunctionForCodeCoverage(self::CLASS_LEVEL, $functionName);
}
public static function postCondition(): PostCondition
{
return new PostCondition(self::METHOD_LEVEL);
}
public static function preCondition(): PreCondition
{
return new PreCondition(self::METHOD_LEVEL);
}
public static function preserveGlobalStateOnClass(bool $enabled): PreserveGlobalState
{
return new PreserveGlobalState(self::CLASS_LEVEL, $enabled);
}
public static function preserveGlobalStateOnMethod(bool $enabled): PreserveGlobalState
{
return new PreserveGlobalState(self::METHOD_LEVEL, $enabled);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function requiresFunctionOnClass(string $functionName): RequiresFunction
{
return new RequiresFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function requiresFunctionOnMethod(string $functionName): RequiresFunction
{
return new RequiresFunction(self::METHOD_LEVEL, $functionName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function requiresMethodOnClass(string $className, string $methodName): RequiresMethod
{
return new RequiresMethod(self::CLASS_LEVEL, $className, $methodName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function requiresMethodOnMethod(string $className, string $methodName): RequiresMethod
{
return new RequiresMethod(self::METHOD_LEVEL, $className, $methodName);
}
/**
* @psalm-param non-empty-string $operatingSystem
*/
public static function requiresOperatingSystemOnClass(string $operatingSystem): RequiresOperatingSystem
{
return new RequiresOperatingSystem(self::CLASS_LEVEL, $operatingSystem);
}
/**
* @psalm-param non-empty-string $operatingSystem
*/
public static function requiresOperatingSystemOnMethod(string $operatingSystem): RequiresOperatingSystem
{
return new RequiresOperatingSystem(self::METHOD_LEVEL, $operatingSystem);
}
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public static function requiresOperatingSystemFamilyOnClass(string $operatingSystemFamily): RequiresOperatingSystemFamily
{
return new RequiresOperatingSystemFamily(self::CLASS_LEVEL, $operatingSystemFamily);
}
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public static function requiresOperatingSystemFamilyOnMethod(string $operatingSystemFamily): RequiresOperatingSystemFamily
{
return new RequiresOperatingSystemFamily(self::METHOD_LEVEL, $operatingSystemFamily);
}
public static function requiresPhpOnClass(Requirement $versionRequirement): RequiresPhp
{
return new RequiresPhp(self::CLASS_LEVEL, $versionRequirement);
}
public static function requiresPhpOnMethod(Requirement $versionRequirement): RequiresPhp
{
return new RequiresPhp(self::METHOD_LEVEL, $versionRequirement);
}
/**
* @psalm-param non-empty-string $extension
*/
public static function requiresPhpExtensionOnClass(string $extension, ?Requirement $versionRequirement): RequiresPhpExtension
{
return new RequiresPhpExtension(self::CLASS_LEVEL, $extension, $versionRequirement);
}
/**
* @psalm-param non-empty-string $extension
*/
public static function requiresPhpExtensionOnMethod(string $extension, ?Requirement $versionRequirement): RequiresPhpExtension
{
return new RequiresPhpExtension(self::METHOD_LEVEL, $extension, $versionRequirement);
}
public static function requiresPhpunitOnClass(Requirement $versionRequirement): RequiresPhpunit
{
return new RequiresPhpunit(self::CLASS_LEVEL, $versionRequirement);
}
public static function requiresPhpunitOnMethod(Requirement $versionRequirement): RequiresPhpunit
{
return new RequiresPhpunit(self::METHOD_LEVEL, $versionRequirement);
}
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public static function requiresSettingOnClass(string $setting, string $value): RequiresSetting
{
return new RequiresSetting(self::CLASS_LEVEL, $setting, $value);
}
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public static function requiresSettingOnMethod(string $setting, string $value): RequiresSetting
{
return new RequiresSetting(self::METHOD_LEVEL, $setting, $value);
}
public static function runClassInSeparateProcess(): RunClassInSeparateProcess
{
return new RunClassInSeparateProcess(self::CLASS_LEVEL);
}
public static function runTestsInSeparateProcesses(): RunTestsInSeparateProcesses
{
return new RunTestsInSeparateProcesses(self::CLASS_LEVEL);
}
public static function runInSeparateProcess(): RunInSeparateProcess
{
return new RunInSeparateProcess(self::METHOD_LEVEL);
}
public static function test(): Test
{
return new Test(self::METHOD_LEVEL);
}
/**
* @psalm-param non-empty-string $text
*/
public static function testDoxOnClass(string $text): TestDox
{
return new TestDox(self::CLASS_LEVEL, $text);
}
/**
* @psalm-param non-empty-string $text
*/
public static function testDoxOnMethod(string $text): TestDox
{
return new TestDox(self::METHOD_LEVEL, $text);
}
public static function testWith(array $data): TestWith
{
return new TestWith(self::METHOD_LEVEL, $data);
}
/**
* @psalm-param class-string $className
*/
public static function usesClass(string $className): UsesClass
{
return new UsesClass(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function usesFunction(string $functionName): UsesFunction
{
return new UsesFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $target
*/
public static function usesOnClass(string $target): Uses
{
return new Uses(self::CLASS_LEVEL, $target);
}
/**
* @psalm-param non-empty-string $target
*/
public static function usesOnMethod(string $target): Uses
{
return new Uses(self::METHOD_LEVEL, $target);
}
/**
* @psalm-param class-string $className
*/
public static function usesDefaultClass(string $className): UsesDefaultClass
{
return new UsesDefaultClass(self::CLASS_LEVEL, $className);
}
public static function withoutErrorHandler(): WithoutErrorHandler
{
return new WithoutErrorHandler(self::METHOD_LEVEL);
}
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level)
{
$this->level = $level;
}
public function isClassLevel(): bool
{
return $this->level === self::CLASS_LEVEL;
}
public function isMethodLevel(): bool
{
return $this->level === self::METHOD_LEVEL;
}
/**
* @psalm-assert-if-true After $this
*/
public function isAfter(): bool
{
return false;
}
/**
* @psalm-assert-if-true AfterClass $this
*/
public function isAfterClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true BackupGlobals $this
*/
public function isBackupGlobals(): bool
{
return false;
}
/**
* @psalm-assert-if-true BackupStaticProperties $this
*/
public function isBackupStaticProperties(): bool
{
return false;
}
/**
* @psalm-assert-if-true BeforeClass $this
*/
public function isBeforeClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true Before $this
*/
public function isBefore(): bool
{
return false;
}
/**
* @psalm-assert-if-true Covers $this
*/
public function isCovers(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversClass $this
*/
public function isCoversClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversDefaultClass $this
*/
public function isCoversDefaultClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversFunction $this
*/
public function isCoversFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversNothing $this
*/
public function isCoversNothing(): bool
{
return false;
}
/**
* @psalm-assert-if-true DataProvider $this
*/
public function isDataProvider(): bool
{
return false;
}
/**
* @psalm-assert-if-true DependsOnClass $this
*/
public function isDependsOnClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true DependsOnMethod $this
*/
public function isDependsOnMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true DoesNotPerformAssertions $this
*/
public function isDoesNotPerformAssertions(): bool
{
return false;
}
/**
* @psalm-assert-if-true ExcludeGlobalVariableFromBackup $this
*/
public function isExcludeGlobalVariableFromBackup(): bool
{
return false;
}
/**
* @psalm-assert-if-true ExcludeStaticPropertyFromBackup $this
*/
public function isExcludeStaticPropertyFromBackup(): bool
{
return false;
}
/**
* @psalm-assert-if-true Group $this
*/
public function isGroup(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreDeprecations $this
*/
public function isIgnoreDeprecations(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreClassForCodeCoverage $this
*/
public function isIgnoreClassForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreMethodForCodeCoverage $this
*/
public function isIgnoreMethodForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreFunctionForCodeCoverage $this
*/
public function isIgnoreFunctionForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunClassInSeparateProcess $this
*/
public function isRunClassInSeparateProcess(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunInSeparateProcess $this
*/
public function isRunInSeparateProcess(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunTestsInSeparateProcesses $this
*/
public function isRunTestsInSeparateProcesses(): bool
{
return false;
}
/**
* @psalm-assert-if-true Test $this
*/
public function isTest(): bool
{
return false;
}
/**
* @psalm-assert-if-true PreCondition $this
*/
public function isPreCondition(): bool
{
return false;
}
/**
* @psalm-assert-if-true PostCondition $this
*/
public function isPostCondition(): bool
{
return false;
}
/**
* @psalm-assert-if-true PreserveGlobalState $this
*/
public function isPreserveGlobalState(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresMethod $this
*/
public function isRequiresMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresFunction $this
*/
public function isRequiresFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresOperatingSystem $this
*/
public function isRequiresOperatingSystem(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresOperatingSystemFamily $this
*/
public function isRequiresOperatingSystemFamily(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhp $this
*/
public function isRequiresPhp(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhpExtension $this
*/
public function isRequiresPhpExtension(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhpunit $this
*/
public function isRequiresPhpunit(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresSetting $this
*/
public function isRequiresSetting(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestDox $this
*/
public function isTestDox(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestWith $this
*/
public function isTestWith(): bool
{
return false;
}
/**
* @psalm-assert-if-true Uses $this
*/
public function isUses(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesClass $this
*/
public function isUsesClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesDefaultClass $this
*/
public function isUsesDefaultClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesFunction $this
*/
public function isUsesFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true WithoutErrorHandler $this
*/
public function isWithoutErrorHandler(): bool
{
return false;
}
}
phpunit/src/Metadata/PostCondition.php 0000644 00000001137 15243417753 0014064 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostCondition extends Metadata
{
/**
* @psalm-assert-if-true PostCondition $this
*/
public function isPostCondition(): bool
{
return true;
}
}
phpunit/src/Metadata/PreserveGlobalState.php 0000644 00000001651 15243417753 0015206 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreserveGlobalState extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true PreserveGlobalState $this
*/
public function isPreserveGlobalState(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Metadata/Covers.php 0000644 00000002030 15243417753 0012522 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Covers extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $target;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $target
*/
protected function __construct(int $level, string $target)
{
parent::__construct($level);
$this->target = $target;
}
/**
* @psalm-assert-if-true Covers $this
*/
public function isCovers(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function target(): string
{
return $this->target;
}
}
phpunit/src/Metadata/Parser/Registry.php 0000644 00000001655 15243417753 0014341 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
/**
* Attribute and annotation information is static within a single PHP process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Parser $instance = null;
public static function parser(): Parser
{
return self::$instance ?? self::$instance = self::build();
}
private static function build(): Parser
{
return new CachingParser(
new ParserChain(
new AttributeParser,
new AnnotationParser,
),
);
}
}
phpunit/src/Metadata/Parser/CachingParser.php 0000644 00000004225 15243417753 0015236 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CachingParser implements Parser
{
private readonly Parser $reader;
private array $classCache = [];
private array $methodCache = [];
private array $classAndMethodCache = [];
public function __construct(Parser $reader)
{
$this->reader = $reader;
}
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
if (isset($this->classCache[$className])) {
return $this->classCache[$className];
}
$this->classCache[$className] = $this->reader->forClass($className);
return $this->classCache[$className];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$key = $className . '::' . $methodName;
if (isset($this->methodCache[$key])) {
return $this->methodCache[$key];
}
$this->methodCache[$key] = $this->reader->forMethod($className, $methodName);
return $this->methodCache[$key];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
$key = $className . '::' . $methodName;
if (isset($this->classAndMethodCache[$key])) {
return $this->classAndMethodCache[$key];
}
$this->classAndMethodCache[$key] = $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
return $this->classAndMethodCache[$key];
}
}
phpunit/src/Metadata/Parser/Parser.php 0000644 00000001732 15243417753 0013761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Parser
{
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection;
}
phpunit/src/Metadata/Parser/AnnotationParser.php 0000644 00000043203 15243417753 0016013 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use function array_merge;
use function assert;
use function count;
use function explode;
use function method_exists;
use function preg_replace;
use function rtrim;
use function str_contains;
use function str_starts_with;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Metadata\Annotation\Parser\Registry as AnnotationRegistry;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\ReflectionException;
use PHPUnit\Metadata\Version\ComparisonRequirement;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use PHPUnit\Util\InvalidVersionOperatorException;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnnotationParser implements Parser
{
/**
* @psalm-param class-string $className
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClass(string $className): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forClassName($className)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnClass($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnClass($this->stringToBool($values[0]));
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnClass($value);
}
break;
case 'coversDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::coversDefaultClass($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnClass();
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnClass();
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnClass($value);
}
break;
case 'large':
$result[] = Metadata::groupOnClass('large');
break;
case 'medium':
$result[] = Metadata::groupOnClass('medium');
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnClass($this->stringToBool($values[0]));
break;
case 'runClassInSeparateProcess':
$result[] = Metadata::runClassInSeparateProcess();
break;
case 'runTestsInSeparateProcesses':
$result[] = Metadata::runTestsInSeparateProcesses();
break;
case 'small':
$result[] = Metadata::groupOnClass('small');
break;
case 'testdox':
$result[] = Metadata::testDoxOnClass($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnClass($value);
}
break;
case 'usesDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::usesDefaultClass($value);
}
break;
}
}
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forClassName($className)->requirements(),
'class',
),
);
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forMethod($className, $methodName)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'after':
$result[] = Metadata::after();
break;
case 'afterClass':
$result[] = Metadata::afterClass();
break;
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnMethod($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnMethod($this->stringToBool($values[0]));
break;
case 'before':
$result[] = Metadata::before();
break;
case 'beforeClass':
$result[] = Metadata::beforeClass();
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnMethod($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnMethod();
break;
case 'dataProvider':
foreach ($values as $value) {
$value = rtrim($value, " ()\n\r\t\v\x00");
if (str_contains($value, '::')) {
$result[] = Metadata::dataProvider(...explode('::', $value));
continue;
}
$result[] = Metadata::dataProvider($className, $value);
}
break;
case 'depends':
foreach ($values as $value) {
$deepClone = false;
$shallowClone = false;
if (str_starts_with($value, 'clone ')) {
$deepClone = true;
$value = substr($value, strlen('clone '));
} elseif (str_starts_with($value, '!clone ')) {
$value = substr($value, strlen('!clone '));
} elseif (str_starts_with($value, 'shallowClone ')) {
$shallowClone = true;
$value = substr($value, strlen('shallowClone '));
} elseif (str_starts_with($value, '!shallowClone ')) {
$value = substr($value, strlen('!shallowClone '));
}
if (str_contains($value, '::')) {
[$_className, $_methodName] = explode('::', $value);
assert($_className !== '');
assert($_methodName !== '');
if ($_methodName === 'class') {
$result[] = Metadata::dependsOnClass($_className, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($_className, $_methodName, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($className, $value, $deepClone, $shallowClone);
}
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnMethod();
break;
case 'excludeGlobalVariableFromBackup':
foreach ($values as $value) {
$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($value);
}
break;
case 'excludeStaticPropertyFromBackup':
foreach ($values as $value) {
$tmp = explode(' ', $value);
if (count($tmp) !== 2) {
continue;
}
$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
trim($tmp[0]),
trim($tmp[1]),
);
}
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnMethod($value);
}
break;
case 'large':
$result[] = Metadata::groupOnMethod('large');
break;
case 'medium':
$result[] = Metadata::groupOnMethod('medium');
break;
case 'postCondition':
$result[] = Metadata::postCondition();
break;
case 'preCondition':
$result[] = Metadata::preCondition();
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnMethod($this->stringToBool($values[0]));
break;
case 'runInSeparateProcess':
$result[] = Metadata::runInSeparateProcess();
break;
case 'small':
$result[] = Metadata::groupOnMethod('small');
break;
case 'test':
$result[] = Metadata::test();
break;
case 'testdox':
$result[] = Metadata::testDoxOnMethod($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnMethod($value);
}
break;
}
}
if (method_exists($className, $methodName)) {
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forMethod($className, $methodName)->requirements(),
'method',
),
);
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
private function stringToBool(string $value): bool
{
if ($value === 'enabled') {
return true;
}
return false;
}
private function cleanUpCoversOrUsesTarget(string $value): string
{
$value = preg_replace('/[\s()]+$/', '', $value);
return explode(' ', $value, 2)[0];
}
/**
* @psalm-return list<Metadata>
*
* @throws InvalidVersionOperatorException
*/
private function parseRequirements(array $requirements, string $level): array
{
$result = [];
if (!empty($requirements['PHP'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHP']['version'],
new VersionComparisonOperator(empty($requirements['PHP']['operator']) ? '>=' : $requirements['PHP']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHP_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHP_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
}
if (!empty($requirements['extensions'])) {
foreach ($requirements['extensions'] as $extension) {
if (isset($requirements['extension_versions'][$extension])) {
continue;
}
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, null);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, null);
}
}
}
if (!empty($requirements['extension_versions'])) {
foreach ($requirements['extension_versions'] as $extension => $version) {
$versionRequirement = new ComparisonRequirement(
$version['version'],
new VersionComparisonOperator(empty($version['operator']) ? '>=' : $version['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, $versionRequirement);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, $versionRequirement);
}
}
}
if (!empty($requirements['PHPUnit'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHPUnit']['version'],
new VersionComparisonOperator(empty($requirements['PHPUnit']['operator']) ? '>=' : $requirements['PHPUnit']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHPUnit_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHPUnit_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
}
if (!empty($requirements['OSFAMILY'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemFamilyOnClass($requirements['OSFAMILY']);
} else {
$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($requirements['OSFAMILY']);
}
}
if (!empty($requirements['OS'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemOnClass($requirements['OS']);
} else {
$result[] = Metadata::requiresOperatingSystemOnMethod($requirements['OS']);
}
}
if (!empty($requirements['functions'])) {
foreach ($requirements['functions'] as $function) {
$pieces = explode('::', $function);
if (count($pieces) === 2) {
if ($level === 'class') {
$result[] = Metadata::requiresMethodOnClass($pieces[0], $pieces[1]);
} else {
$result[] = Metadata::requiresMethodOnMethod($pieces[0], $pieces[1]);
}
} elseif ($level === 'class') {
$result[] = Metadata::requiresFunctionOnClass($function);
} else {
$result[] = Metadata::requiresFunctionOnMethod($function);
}
}
}
if (!empty($requirements['setting'])) {
foreach ($requirements['setting'] as $setting => $value) {
if ($level === 'class') {
$result[] = Metadata::requiresSettingOnClass($setting, $value);
} else {
$result[] = Metadata::requiresSettingOnMethod($setting, $value);
}
}
}
return $result;
}
}
phpunit/src/Metadata/Parser/AttributeParser.php 0000644 00000056163 15243417753 0015655 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use const JSON_THROW_ON_ERROR;
use function assert;
use function json_decode;
use function str_starts_with;
use PHPUnit\Framework\Attributes\After;
use PHPUnit\Framework\Attributes\AfterClass;
use PHPUnit\Framework\Attributes\BackupGlobals;
use PHPUnit\Framework\Attributes\BackupStaticProperties;
use PHPUnit\Framework\Attributes\Before;
use PHPUnit\Framework\Attributes\BeforeClass;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\CoversFunction;
use PHPUnit\Framework\Attributes\CoversNothing;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\DataProviderExternal;
use PHPUnit\Framework\Attributes\Depends;
use PHPUnit\Framework\Attributes\DependsExternal;
use PHPUnit\Framework\Attributes\DependsExternalUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsExternalUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsOnClass;
use PHPUnit\Framework\Attributes\DependsOnClassUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsOnClassUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsUsingShallowClone;
use PHPUnit\Framework\Attributes\DoesNotPerformAssertions;
use PHPUnit\Framework\Attributes\ExcludeGlobalVariableFromBackup;
use PHPUnit\Framework\Attributes\ExcludeStaticPropertyFromBackup;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\IgnoreClassForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreDeprecations;
use PHPUnit\Framework\Attributes\IgnoreFunctionForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreMethodForCodeCoverage;
use PHPUnit\Framework\Attributes\Large;
use PHPUnit\Framework\Attributes\Medium;
use PHPUnit\Framework\Attributes\PostCondition;
use PHPUnit\Framework\Attributes\PreCondition;
use PHPUnit\Framework\Attributes\PreserveGlobalState;
use PHPUnit\Framework\Attributes\RequiresFunction;
use PHPUnit\Framework\Attributes\RequiresMethod;
use PHPUnit\Framework\Attributes\RequiresOperatingSystem;
use PHPUnit\Framework\Attributes\RequiresOperatingSystemFamily;
use PHPUnit\Framework\Attributes\RequiresPhp;
use PHPUnit\Framework\Attributes\RequiresPhpExtension;
use PHPUnit\Framework\Attributes\RequiresPhpunit;
use PHPUnit\Framework\Attributes\RequiresSetting;
use PHPUnit\Framework\Attributes\RunClassInSeparateProcess;
use PHPUnit\Framework\Attributes\RunInSeparateProcess;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
use PHPUnit\Framework\Attributes\Small;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\Attributes\TestDox;
use PHPUnit\Framework\Attributes\TestWith;
use PHPUnit\Framework\Attributes\TestWithJson;
use PHPUnit\Framework\Attributes\Ticket;
use PHPUnit\Framework\Attributes\UsesClass;
use PHPUnit\Framework\Attributes\UsesFunction;
use PHPUnit\Framework\Attributes\WithoutErrorHandler;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use ReflectionClass;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AttributeParser implements Parser
{
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
$result = [];
foreach ((new ReflectionClass($className))->getAttributes() as $attribute) {
if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
continue;
}
$attributeInstance = $attribute->newInstance();
switch ($attribute->getName()) {
case BackupGlobals::class:
assert($attributeInstance instanceof BackupGlobals);
$result[] = Metadata::backupGlobalsOnClass($attributeInstance->enabled());
break;
case BackupStaticProperties::class:
assert($attributeInstance instanceof BackupStaticProperties);
$result[] = Metadata::backupStaticPropertiesOnClass($attributeInstance->enabled());
break;
case CoversClass::class:
assert($attributeInstance instanceof CoversClass);
$result[] = Metadata::coversClass($attributeInstance->className());
break;
case CoversFunction::class:
assert($attributeInstance instanceof CoversFunction);
$result[] = Metadata::coversFunction($attributeInstance->functionName());
break;
case CoversNothing::class:
$result[] = Metadata::coversNothingOnClass();
break;
case DoesNotPerformAssertions::class:
$result[] = Metadata::doesNotPerformAssertionsOnClass();
break;
case ExcludeGlobalVariableFromBackup::class:
assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);
$result[] = Metadata::excludeGlobalVariableFromBackupOnClass($attributeInstance->globalVariableName());
break;
case ExcludeStaticPropertyFromBackup::class:
assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);
$result[] = Metadata::excludeStaticPropertyFromBackupOnClass(
$attributeInstance->className(),
$attributeInstance->propertyName(),
);
break;
case Group::class:
assert($attributeInstance instanceof Group);
$result[] = Metadata::groupOnClass($attributeInstance->name());
break;
case Large::class:
$result[] = Metadata::groupOnClass('large');
break;
case Medium::class:
$result[] = Metadata::groupOnClass('medium');
break;
case IgnoreClassForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreClassForCodeCoverage);
$result[] = Metadata::ignoreClassForCodeCoverage($attributeInstance->className());
break;
case IgnoreDeprecations::class:
assert($attributeInstance instanceof IgnoreDeprecations);
$result[] = Metadata::ignoreDeprecationsOnClass();
break;
case IgnoreMethodForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreMethodForCodeCoverage);
$result[] = Metadata::ignoreMethodForCodeCoverage($attributeInstance->className(), $attributeInstance->methodName());
break;
case IgnoreFunctionForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreFunctionForCodeCoverage);
$result[] = Metadata::ignoreFunctionForCodeCoverage($attributeInstance->functionName());
break;
case PreserveGlobalState::class:
assert($attributeInstance instanceof PreserveGlobalState);
$result[] = Metadata::preserveGlobalStateOnClass($attributeInstance->enabled());
break;
case RequiresMethod::class:
assert($attributeInstance instanceof RequiresMethod);
$result[] = Metadata::requiresMethodOnClass(
$attributeInstance->className(),
$attributeInstance->methodName(),
);
break;
case RequiresFunction::class:
assert($attributeInstance instanceof RequiresFunction);
$result[] = Metadata::requiresFunctionOnClass($attributeInstance->functionName());
break;
case RequiresOperatingSystem::class:
assert($attributeInstance instanceof RequiresOperatingSystem);
$result[] = Metadata::requiresOperatingSystemOnClass($attributeInstance->regularExpression());
break;
case RequiresOperatingSystemFamily::class:
assert($attributeInstance instanceof RequiresOperatingSystemFamily);
$result[] = Metadata::requiresOperatingSystemFamilyOnClass($attributeInstance->operatingSystemFamily());
break;
case RequiresPhp::class:
assert($attributeInstance instanceof RequiresPhp);
$result[] = Metadata::requiresPhpOnClass(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresPhpExtension::class:
assert($attributeInstance instanceof RequiresPhpExtension);
$versionConstraint = null;
$versionRequirement = $attributeInstance->versionRequirement();
if ($versionRequirement !== null) {
$versionConstraint = ConstraintRequirement::from($versionRequirement);
}
$result[] = Metadata::requiresPhpExtensionOnClass(
$attributeInstance->extension(),
$versionConstraint,
);
break;
case RequiresPhpunit::class:
assert($attributeInstance instanceof RequiresPhpunit);
$result[] = Metadata::requiresPhpunitOnClass(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresSetting::class:
assert($attributeInstance instanceof RequiresSetting);
$result[] = Metadata::requiresSettingOnClass(
$attributeInstance->setting(),
$attributeInstance->value(),
);
break;
case RunClassInSeparateProcess::class:
$result[] = Metadata::runClassInSeparateProcess();
break;
case RunTestsInSeparateProcesses::class:
$result[] = Metadata::runTestsInSeparateProcesses();
break;
case Small::class:
$result[] = Metadata::groupOnClass('small');
break;
case TestDox::class:
assert($attributeInstance instanceof TestDox);
$result[] = Metadata::testDoxOnClass($attributeInstance->text());
break;
case Ticket::class:
assert($attributeInstance instanceof Ticket);
$result[] = Metadata::groupOnClass($attributeInstance->text());
break;
case UsesClass::class:
assert($attributeInstance instanceof UsesClass);
$result[] = Metadata::usesClass($attributeInstance->className());
break;
case UsesFunction::class:
assert($attributeInstance instanceof UsesFunction);
$result[] = Metadata::usesFunction($attributeInstance->functionName());
break;
}
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$result = [];
foreach ((new ReflectionMethod($className, $methodName))->getAttributes() as $attribute) {
if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
continue;
}
$attributeInstance = $attribute->newInstance();
switch ($attribute->getName()) {
case After::class:
$result[] = Metadata::after();
break;
case AfterClass::class:
$result[] = Metadata::afterClass();
break;
case BackupGlobals::class:
assert($attributeInstance instanceof BackupGlobals);
$result[] = Metadata::backupGlobalsOnMethod($attributeInstance->enabled());
break;
case BackupStaticProperties::class:
assert($attributeInstance instanceof BackupStaticProperties);
$result[] = Metadata::backupStaticPropertiesOnMethod($attributeInstance->enabled());
break;
case Before::class:
$result[] = Metadata::before();
break;
case BeforeClass::class:
$result[] = Metadata::beforeClass();
break;
case CoversNothing::class:
$result[] = Metadata::coversNothingOnMethod();
break;
case DataProvider::class:
assert($attributeInstance instanceof DataProvider);
$result[] = Metadata::dataProvider($className, $attributeInstance->methodName());
break;
case DataProviderExternal::class:
assert($attributeInstance instanceof DataProviderExternal);
$result[] = Metadata::dataProvider($attributeInstance->className(), $attributeInstance->methodName());
break;
case Depends::class:
assert($attributeInstance instanceof Depends);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, false);
break;
case DependsUsingDeepClone::class:
assert($attributeInstance instanceof DependsUsingDeepClone);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), true, false);
break;
case DependsUsingShallowClone::class:
assert($attributeInstance instanceof DependsUsingShallowClone);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, true);
break;
case DependsExternal::class:
assert($attributeInstance instanceof DependsExternal);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, false);
break;
case DependsExternalUsingDeepClone::class:
assert($attributeInstance instanceof DependsExternalUsingDeepClone);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), true, false);
break;
case DependsExternalUsingShallowClone::class:
assert($attributeInstance instanceof DependsExternalUsingShallowClone);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, true);
break;
case DependsOnClass::class:
assert($attributeInstance instanceof DependsOnClass);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, false);
break;
case DependsOnClassUsingDeepClone::class:
assert($attributeInstance instanceof DependsOnClassUsingDeepClone);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), true, false);
break;
case DependsOnClassUsingShallowClone::class:
assert($attributeInstance instanceof DependsOnClassUsingShallowClone);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, true);
break;
case DoesNotPerformAssertions::class:
assert($attributeInstance instanceof DoesNotPerformAssertions);
$result[] = Metadata::doesNotPerformAssertionsOnMethod();
break;
case ExcludeGlobalVariableFromBackup::class:
assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);
$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($attributeInstance->globalVariableName());
break;
case ExcludeStaticPropertyFromBackup::class:
assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);
$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
$attributeInstance->className(),
$attributeInstance->propertyName(),
);
break;
case Group::class:
assert($attributeInstance instanceof Group);
$result[] = Metadata::groupOnMethod($attributeInstance->name());
break;
case IgnoreDeprecations::class:
assert($attributeInstance instanceof IgnoreDeprecations);
$result[] = Metadata::ignoreDeprecationsOnMethod();
break;
case PostCondition::class:
$result[] = Metadata::postCondition();
break;
case PreCondition::class:
$result[] = Metadata::preCondition();
break;
case PreserveGlobalState::class:
assert($attributeInstance instanceof PreserveGlobalState);
$result[] = Metadata::preserveGlobalStateOnMethod($attributeInstance->enabled());
break;
case RequiresMethod::class:
assert($attributeInstance instanceof RequiresMethod);
$result[] = Metadata::requiresMethodOnMethod(
$attributeInstance->className(),
$attributeInstance->methodName(),
);
break;
case RequiresFunction::class:
assert($attributeInstance instanceof RequiresFunction);
$result[] = Metadata::requiresFunctionOnMethod($attributeInstance->functionName());
break;
case RequiresOperatingSystem::class:
assert($attributeInstance instanceof RequiresOperatingSystem);
$result[] = Metadata::requiresOperatingSystemOnMethod($attributeInstance->regularExpression());
break;
case RequiresOperatingSystemFamily::class:
assert($attributeInstance instanceof RequiresOperatingSystemFamily);
$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($attributeInstance->operatingSystemFamily());
break;
case RequiresPhp::class:
assert($attributeInstance instanceof RequiresPhp);
$result[] = Metadata::requiresPhpOnMethod(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresPhpExtension::class:
assert($attributeInstance instanceof RequiresPhpExtension);
$versionConstraint = null;
$versionRequirement = $attributeInstance->versionRequirement();
if ($versionRequirement !== null) {
$versionConstraint = ConstraintRequirement::from($versionRequirement);
}
$result[] = Metadata::requiresPhpExtensionOnMethod(
$attributeInstance->extension(),
$versionConstraint,
);
break;
case RequiresPhpunit::class:
assert($attributeInstance instanceof RequiresPhpunit);
$result[] = Metadata::requiresPhpunitOnMethod(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresSetting::class:
assert($attributeInstance instanceof RequiresSetting);
$result[] = Metadata::requiresSettingOnMethod(
$attributeInstance->setting(),
$attributeInstance->value(),
);
break;
case RunInSeparateProcess::class:
$result[] = Metadata::runInSeparateProcess();
break;
case Test::class:
$result[] = Metadata::test();
break;
case TestDox::class:
assert($attributeInstance instanceof TestDox);
$result[] = Metadata::testDoxOnMethod($attributeInstance->text());
break;
case TestWith::class:
assert($attributeInstance instanceof TestWith);
$result[] = Metadata::testWith($attributeInstance->data());
break;
case TestWithJson::class:
assert($attributeInstance instanceof TestWithJson);
$result[] = Metadata::testWith(json_decode($attributeInstance->json(), true, 512, JSON_THROW_ON_ERROR));
break;
case Ticket::class:
assert($attributeInstance instanceof Ticket);
$result[] = Metadata::groupOnMethod($attributeInstance->text());
break;
case WithoutErrorHandler::class:
assert($attributeInstance instanceof WithoutErrorHandler);
$result[] = Metadata::withoutErrorHandler();
break;
}
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
}
phpunit/src/Metadata/Parser/ParserChain.php 0000644 00000003556 15243417753 0014732 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ParserChain implements Parser
{
private readonly Parser $attributeReader;
private readonly Parser $annotationReader;
public function __construct(Parser $attributeReader, Parser $annotationReader)
{
$this->attributeReader = $attributeReader;
$this->annotationReader = $annotationReader;
}
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
$metadata = $this->attributeReader->forClass($className);
if (!$metadata->isEmpty()) {
return $metadata;
}
return $this->annotationReader->forClass($className);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$metadata = $this->attributeReader->forMethod($className, $methodName);
if (!$metadata->isEmpty()) {
return $metadata;
}
return $this->annotationReader->forMethod($className, $methodName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
}
phpunit/src/Metadata/Parser/Annotation/Registry.php 0000644 00000005516 15243417753 0016453 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Annotation\Parser;
use function array_key_exists;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\ReflectionException;
use ReflectionClass;
use ReflectionMethod;
/**
* Reflection information, and therefore DocBlock information, is static within
* a single PHP process. It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Registry $instance = null;
/**
* @psalm-var array<string, DocBlock> indexed by class name
*/
private array $classDocBlocks = [];
/**
* @psalm-var array<string, array<string, DocBlock>> indexed by class name and method name
*/
private array $methodDocBlocks = [];
public static function getInstance(): self
{
return self::$instance ?? self::$instance = new self;
}
/**
* @psalm-param class-string $class
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws ReflectionException
*/
public function forClassName(string $class): DocBlock
{
if (array_key_exists($class, $this->classDocBlocks)) {
return $this->classDocBlocks[$class];
}
try {
$reflection = new ReflectionClass($class);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $this->classDocBlocks[$class] = DocBlock::ofClass($reflection);
}
/**
* @psalm-param class-string $classInHierarchy
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws ReflectionException
*/
public function forMethod(string $classInHierarchy, string $method): DocBlock
{
if (isset($this->methodDocBlocks[$classInHierarchy][$method])) {
return $this->methodDocBlocks[$classInHierarchy][$method];
}
try {
$reflection = new ReflectionMethod($classInHierarchy, $method);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $this->methodDocBlocks[$classInHierarchy][$method] = DocBlock::ofMethod($reflection);
}
}
phpunit/src/Metadata/Parser/Annotation/DocBlock.php 0000644 00000022622 15243417753 0016320 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Annotation\Parser;
use function array_filter;
use function array_map;
use function array_merge;
use function array_values;
use function count;
use function preg_match;
use function preg_match_all;
use function preg_replace;
use function preg_split;
use function realpath;
use function substr;
use function trim;
use PharIo\Version\Exception as PharIoVersionException;
use PharIo\Version\VersionConstraintParser;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\InvalidVersionRequirementException;
use ReflectionClass;
use ReflectionFunctionAbstract;
use ReflectionMethod;
/**
* This is an abstraction around a PHPUnit-specific docBlock,
* allowing us to ask meaningful questions about a specific
* reflection symbol.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DocBlock
{
private const REGEX_REQUIRES_VERSION = '/@requires\s+(?P<name>PHP(?:Unit)?)\s+(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+(dev|(RC|alpha|beta)[\d\.])?)[ \t]*\r?$/m';
private const REGEX_REQUIRES_VERSION_CONSTRAINT = '/@requires\s+(?P<name>PHP(?:Unit)?)\s+(?P<constraint>[\d\t \-.|~^]+)[ \t]*\r?$/m';
private const REGEX_REQUIRES_OS = '/@requires\s+(?P<name>OS(?:FAMILY)?)\s+(?P<value>.+?)[ \t]*\r?$/m';
private const REGEX_REQUIRES_SETTING = '/@requires\s+(?P<name>setting)\s+(?P<setting>([^ ]+?))\s*(?P<value>[\w\.-]+[\w\.]?)?[ \t]*\r?$/m';
private const REGEX_REQUIRES = '/@requires\s+(?P<name>function|extension)\s+(?P<value>([^\s<>=!]+))\s*(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+[\d\.]?)?[ \t]*\r?$/m';
private readonly string $docComment;
/**
* @psalm-var array<string, array<int, string>> pre-parsed annotations indexed by name and occurrence index
*/
private readonly array $symbolAnnotations;
/**
* @psalm-var null|(array{
* __OFFSET: array<string, int>&array{__FILE: string},
* setting?: array<string, string>,
* extension_versions?: array<string, array{version: string, operator: string}>
* }&array<
* string,
* string|array{version: string, operator: string}|array{constraint: string}|array<int|string, string>
* >)
*/
private ?array $parsedRequirements = null;
private readonly int $startLine;
private readonly string $fileName;
/**
* @throws AnnotationsAreNotSupportedForInternalClassesException
*/
public static function ofClass(ReflectionClass $class): self
{
if ($class->isInternal()) {
throw new AnnotationsAreNotSupportedForInternalClassesException($class->getName());
}
return new self(
(string) $class->getDocComment(),
self::extractAnnotationsFromReflector($class),
$class->getStartLine(),
$class->getFileName(),
);
}
/**
* @throws AnnotationsAreNotSupportedForInternalClassesException
*/
public static function ofMethod(ReflectionMethod $method): self
{
if ($method->getDeclaringClass()->isInternal()) {
throw new AnnotationsAreNotSupportedForInternalClassesException($method->getDeclaringClass()->getName());
}
return new self(
(string) $method->getDocComment(),
self::extractAnnotationsFromReflector($method),
$method->getStartLine(),
$method->getFileName(),
);
}
/**
* Note: we do not preserve an instance of the reflection object, since it cannot be safely (de-)serialized.
*
* @param array<string, array<int, string>> $symbolAnnotations
*/
private function __construct(string $docComment, array $symbolAnnotations, int $startLine, string $fileName)
{
$this->docComment = $docComment;
$this->symbolAnnotations = $symbolAnnotations;
$this->startLine = $startLine;
$this->fileName = $fileName;
}
/**
* @psalm-return array{
* __OFFSET: array<string, int>&array{__FILE: string},
* setting?: array<string, string>,
* extension_versions?: array<string, array{version: string, operator: string}>
* }&array<
* string,
* string|array{version: string, operator: string}|array{constraint: string}|array<int|string, string>
* >
*/
public function requirements(): array
{
if ($this->parsedRequirements !== null) {
return $this->parsedRequirements;
}
$offset = $this->startLine;
$requires = [];
$recordedSettings = [];
$extensionVersions = [];
$recordedOffsets = [
'__FILE' => realpath($this->fileName),
];
// Trim docblock markers, split it into lines and rewind offset to start of docblock
$lines = preg_replace(['#^/\*{2}#', '#\*/$#'], '', preg_split('/\r\n|\r|\n/', $this->docComment));
$offset -= count($lines);
foreach ($lines as $line) {
if (preg_match(self::REGEX_REQUIRES_OS, $line, $matches)) {
$requires[$matches['name']] = $matches['value'];
$recordedOffsets[$matches['name']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES_VERSION, $line, $matches)) {
$requires[$matches['name']] = [
'version' => $matches['version'],
'operator' => $matches['operator'],
];
$recordedOffsets[$matches['name']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES_VERSION_CONSTRAINT, $line, $matches)) {
if (!empty($requires[$matches['name']])) {
$offset++;
continue;
}
try {
$versionConstraintParser = new VersionConstraintParser;
$requires[$matches['name'] . '_constraint'] = [
'constraint' => $versionConstraintParser->parse(trim($matches['constraint'])),
];
$recordedOffsets[$matches['name'] . '_constraint'] = $offset;
} catch (PharIoVersionException $e) {
throw new InvalidVersionRequirementException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
if (preg_match(self::REGEX_REQUIRES_SETTING, $line, $matches)) {
$recordedSettings[$matches['setting']] = $matches['value'];
$recordedOffsets['__SETTING_' . $matches['setting']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES, $line, $matches)) {
$name = $matches['name'] . 's';
if (!isset($requires[$name])) {
$requires[$name] = [];
}
$requires[$name][] = $matches['value'];
$recordedOffsets[$matches['name'] . '_' . $matches['value']] = $offset;
if ($name === 'extensions' && !empty($matches['version'])) {
$extensionVersions[$matches['value']] = [
'version' => $matches['version'],
'operator' => $matches['operator'],
];
}
}
$offset++;
}
return $this->parsedRequirements = array_merge(
$requires,
['__OFFSET' => $recordedOffsets],
array_filter(
[
'setting' => $recordedSettings,
'extension_versions' => $extensionVersions,
],
),
);
}
public function symbolAnnotations(): array
{
return $this->symbolAnnotations;
}
/**
* @psalm-return array<string, array<int, string>>
*/
private static function parseDocBlock(string $docBlock): array
{
// Strip away the docblock header and footer to ease parsing of one line annotations
$docBlock = substr($docBlock, 3, -2);
$annotations = [];
if (preg_match_all('/@(?P<name>[A-Za-z_-]+)(?:[ \t]+(?P<value>.*?))?[ \t]*\r?$/m', $docBlock, $matches)) {
$numMatches = count($matches[0]);
for ($i = 0; $i < $numMatches; $i++) {
$annotations[$matches['name'][$i]][] = $matches['value'][$i];
}
}
return $annotations;
}
private static function extractAnnotationsFromReflector(ReflectionClass|ReflectionFunctionAbstract $reflector): array
{
$annotations = [];
if ($reflector instanceof ReflectionClass) {
$annotations = array_merge(
$annotations,
...array_map(
static fn (ReflectionClass $trait): array => self::parseDocBlock((string) $trait->getDocComment()),
array_values($reflector->getTraits()),
),
);
}
return array_merge(
$annotations,
self::parseDocBlock((string) $reflector->getDocComment()),
);
}
}
phpunit/src/Metadata/RequiresMethod.php 0000644 00000002623 15243417753 0014231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresMethod extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true RequiresMethod $this
*/
public function isRequiresMethod(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Metadata/IgnoreFunctionForCodeCoverage.php 0000644 00000002322 15243417753 0017134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreFunctionForCodeCoverage extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true IgnoreFunctionForCodeCoverage $this
*/
public function isIgnoreFunctionForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Metadata/CoversDefaultClass.php 0000644 00000002105 15243417753 0015020 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversDefaultClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true CoversDefaultClass $this
*/
public function isCoversDefaultClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Metadata/TestWith.php 0000644 00000001571 15243417753 0013045 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestWith extends Metadata
{
private readonly array $data;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, array $data)
{
parent::__construct($level);
$this->data = $data;
}
/**
* @psalm-assert-if-true TestWith $this
*/
public function isTestWith(): bool
{
return true;
}
public function data(): array
{
return $this->data;
}
}
phpunit/src/Metadata/RequiresPhpExtension.php 0000644 00000003370 15243417753 0015435 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhpExtension extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $extension;
private readonly ?Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $extension
*/
protected function __construct(int $level, string $extension, ?Requirement $versionRequirement)
{
parent::__construct($level);
$this->extension = $extension;
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhpExtension $this
*/
public function isRequiresPhpExtension(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function extension(): string
{
return $this->extension;
}
/**
* @psalm-assert-if-true !null $this->versionRequirement
*/
public function hasVersionRequirement(): bool
{
return $this->versionRequirement !== null;
}
/**
* @throws NoVersionRequirementException
*/
public function versionRequirement(): Requirement
{
if ($this->versionRequirement === null) {
throw new NoVersionRequirementException;
}
return $this->versionRequirement;
}
}
phpunit/src/Metadata/RequiresPhpunit.php 0000644 00000002037 15243417753 0014437 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhpunit extends Metadata
{
private readonly Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, Requirement $versionRequirement)
{
parent::__construct($level);
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhpunit $this
*/
public function isRequiresPhpunit(): bool
{
return true;
}
public function versionRequirement(): Requirement
{
return $this->versionRequirement;
}
}
phpunit/src/Metadata/ExcludeStaticPropertyFromBackup.php 0000644 00000002726 15243417753 0017555 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeStaticPropertyFromBackup extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $propertyName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
protected function __construct(int $level, string $className, string $propertyName)
{
parent::__construct($level);
$this->className = $className;
$this->propertyName = $propertyName;
}
/**
* @psalm-assert-if-true ExcludeStaticPropertyFromBackup $this
*/
public function isExcludeStaticPropertyFromBackup(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function propertyName(): string
{
return $this->propertyName;
}
}
phpunit/src/Metadata/CoversFunction.php 0000644 00000002470 15243417753 0014240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true CoversFunction $this
*/
public function isCoversFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return '::' . $this->functionName;
}
}
phpunit/src/Metadata/Uses.php 0000644 00000002022 15243417753 0012201 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Uses extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $target;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $target
*/
protected function __construct(int $level, string $target)
{
parent::__construct($level);
$this->target = $target;
}
/**
* @psalm-assert-if-true Uses $this
*/
public function isUses(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function target(): string
{
return $this->target;
}
}
phpunit/src/Metadata/RequiresPhp.php 0000644 00000002023 15243417753 0013532 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhp extends Metadata
{
private readonly Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, Requirement $versionRequirement)
{
parent::__construct($level);
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhp $this
*/
public function isRequiresPhp(): bool
{
return true;
}
public function versionRequirement(): Requirement
{
return $this->versionRequirement;
}
}
phpunit/src/Metadata/UsesDefaultClass.php 0000644 00000002077 15243417753 0014506 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesDefaultClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true UsesDefaultClass $this
*/
public function isUsesDefaultClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Metadata/DependsOnMethod.php 0000644 00000003423 15243417753 0014310 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DependsOnMethod extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly bool $deepClone;
private readonly bool $shallowClone;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName, bool $deepClone, bool $shallowClone)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
}
/**
* @psalm-assert-if-true DependsOnMethod $this
*/
public function isDependsOnMethod(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
}
phpunit/src/TextUI/ShellExitCodeCalculator.php 0000644 00000003754 15243417753 0015447 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use PHPUnit\TestRunner\TestResult\TestResult;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShellExitCodeCalculator
{
private const SUCCESS_EXIT = 0;
private const FAILURE_EXIT = 1;
private const EXCEPTION_EXIT = 2;
public function calculate(bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, TestResult $result): int
{
$returnCode = self::FAILURE_EXIT;
if ($result->wasSuccessful()) {
$returnCode = self::SUCCESS_EXIT;
}
if ($failOnEmptyTestSuite && !$result->hasTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($result->wasSuccessfulIgnoringPhpunitWarnings()) {
if ($failOnDeprecation && $result->hasDeprecations()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnIncomplete && $result->hasIncompleteTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnNotice && $result->hasNotices()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnRisky && $result->hasRiskyTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnSkipped && $result->hasSkippedTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnWarning && $result->hasWarnings()) {
$returnCode = self::FAILURE_EXIT;
}
}
if ($result->hasErrors()) {
$returnCode = self::EXCEPTION_EXIT;
}
return $returnCode;
}
}
phpunit/src/TextUI/Command/Command.php 0000644 00000000676 15243417753 0013675 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Command
{
public function execute(): Result;
}
phpunit/src/TextUI/Command/Result.php 0000644 00000002161 15243417753 0013564 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Result
{
public const SUCCESS = 0;
public const FAILURE = 1;
public const EXCEPTION = 2;
public const CRASH = 255;
private readonly string $output;
private readonly int $shellExitCode;
public static function from(string $output = '', int $shellExitCode = self::SUCCESS): self
{
return new self($output, $shellExitCode);
}
private function __construct(string $output, int $shellExitCode)
{
$this->output = $output;
$this->shellExitCode = $shellExitCode;
}
public function output(): string
{
return $this->output;
}
public function shellExitCode(): int
{
return $this->shellExitCode;
}
}
phpunit/src/TextUI/Command/Commands/GenerateConfigurationCommand.php 0000644 00000004401 15243417753 0021627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function fgets;
use function file_put_contents;
use function getcwd;
use function trim;
use PHPUnit\Runner\Version;
use PHPUnit\TextUI\XmlConfiguration\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GenerateConfigurationCommand implements Command
{
public function execute(): Result
{
print 'Generating phpunit.xml in ' . getcwd() . PHP_EOL . PHP_EOL;
print 'Bootstrap script (relative to path shown above; default: vendor/autoload.php): ';
$bootstrapScript = $this->read();
print 'Tests directory (relative to path shown above; default: tests): ';
$testsDirectory = $this->read();
print 'Source directory (relative to path shown above; default: src): ';
$src = $this->read();
print 'Cache directory (relative to path shown above; default: .phpunit.cache): ';
$cacheDirectory = $this->read();
if ($bootstrapScript === '') {
$bootstrapScript = 'vendor/autoload.php';
}
if ($testsDirectory === '') {
$testsDirectory = 'tests';
}
if ($src === '') {
$src = 'src';
}
if ($cacheDirectory === '') {
$cacheDirectory = '.phpunit.cache';
}
$generator = new Generator;
file_put_contents(
'phpunit.xml',
$generator->generateDefaultConfiguration(
Version::series(),
$bootstrapScript,
$testsDirectory,
$src,
$cacheDirectory,
),
);
/* @noinspection MissingDirectorySeparatorInspection */
print PHP_EOL . 'Generated phpunit.xml in ' . getcwd() . '.' . PHP_EOL;
print 'Make sure to exclude the ' . $cacheDirectory . ' directory from version control.' . PHP_EOL;
return Result::from();
}
private function read(): string
{
return trim(fgets(STDIN));
}
}
phpunit/src/TextUI/Command/Commands/ShowVersionCommand.php 0000644 00000001010 15243417753 0017624 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShowVersionCommand implements Command
{
public function execute(): Result
{
return Result::from();
}
}
phpunit/src/TextUI/Command/Commands/VersionCheckCommand.php 0000644 00000003404 15243417753 0017732 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function file_get_contents;
use function sprintf;
use function version_compare;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class VersionCheckCommand implements Command
{
public function execute(): Result
{
$latestVersion = file_get_contents('https://phar.phpunit.de/latest-version-of/phpunit');
$latestCompatibleVersion = file_get_contents('https://phar.phpunit.de/latest-version-of/phpunit-' . Version::majorVersionNumber());
$notLatest = version_compare($latestVersion, Version::id(), '>');
$notLatestCompatible = version_compare($latestCompatibleVersion, Version::id(), '>');
if (!$notLatest && !$notLatestCompatible) {
return Result::from(
'You are using the latest version of PHPUnit.' . PHP_EOL,
);
}
$buffer = 'You are not using the latest version of PHPUnit.' . PHP_EOL;
if ($notLatestCompatible) {
$buffer .= sprintf(
'The latest version compatible with PHPUnit %s is PHPUnit %s.' . PHP_EOL,
Version::id(),
$latestCompatibleVersion,
);
}
if ($notLatest) {
$buffer .= sprintf(
'The latest version is PHPUnit %s.' . PHP_EOL,
$latestVersion,
);
}
return Result::from($buffer);
}
}
phpunit/src/TextUI/Command/Commands/WarmCodeCoverageCacheCommand.php 0000644 00000004650 15243417753 0021454 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use const PHP_EOL;
use function printf;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\NoCoverageCacheDirectoryException;
use SebastianBergmann\CodeCoverage\StaticAnalysis\CacheWarmer;
use SebastianBergmann\Timer\NoActiveTimerException;
use SebastianBergmann\Timer\Timer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class WarmCodeCoverageCacheCommand implements Command
{
private readonly Configuration $configuration;
private readonly CodeCoverageFilterRegistry $codeCoverageFilterRegistry;
public function __construct(Configuration $configuration, CodeCoverageFilterRegistry $codeCoverageFilterRegistry)
{
$this->configuration = $configuration;
$this->codeCoverageFilterRegistry = $codeCoverageFilterRegistry;
}
/**
* @throws NoActiveTimerException
* @throws NoCoverageCacheDirectoryException
*/
public function execute(): Result
{
if (!$this->configuration->hasCoverageCacheDirectory()) {
return Result::from(
'Cache for static analysis has not been configured' . PHP_EOL,
Result::FAILURE,
);
}
$this->codeCoverageFilterRegistry->init($this->configuration, true);
if (!$this->codeCoverageFilterRegistry->configured()) {
return Result::from(
'Filter for code coverage has not been configured' . PHP_EOL,
Result::FAILURE,
);
}
$timer = new Timer;
$timer->start();
print 'Warming cache for static analysis ... ';
(new CacheWarmer)->warmCache(
$this->configuration->coverageCacheDirectory(),
!$this->configuration->disableCodeCoverageIgnore(),
$this->configuration->ignoreDeprecatedCodeUnitsFromCodeCoverage(),
$this->codeCoverageFilterRegistry->get(),
);
printf(
'[%s]%s',
$timer->stop()->asString(),
PHP_EOL,
);
return Result::from();
}
}
phpunit/src/TextUI/Command/Commands/ListTestsAsXmlCommand.php 0000644 00000010122 15243417753 0020245 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function file_put_contents;
use function implode;
use function sprintf;
use function str_replace;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\TextUI\Configuration\Registry;
use RecursiveIteratorIterator;
use XMLWriter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestsAsXmlCommand implements Command
{
private readonly string $filename;
private readonly TestSuite $suite;
public function __construct(string $filename, TestSuite $suite)
{
$this->filename = $filename;
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$writer = new XMLWriter;
$writer->openMemory();
$writer->setIndent(true);
$writer->startDocument();
$writer->startElement('tests');
$currentTestCase = null;
foreach (new RecursiveIteratorIterator($this->suite) as $test) {
if ($test instanceof TestCase) {
if ($test::class !== $currentTestCase) {
if ($currentTestCase !== null) {
$writer->endElement();
}
$writer->startElement('testCaseClass');
$writer->writeAttribute('name', $test::class);
$currentTestCase = $test::class;
}
$writer->startElement('testCaseMethod');
$writer->writeAttribute('id', $test->valueObjectForEvents()->id());
$writer->writeAttribute('name', $test->name());
$writer->writeAttribute('groups', implode(',', $test->groups()));
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5481
*/
if (!empty($test->dataSetAsString())) {
$writer->writeAttribute(
'dataSet',
str_replace(
' with data set ',
'',
$test->dataSetAsString(),
),
);
}
$writer->endElement();
continue;
}
if ($test instanceof PhptTestCase) {
if ($currentTestCase !== null) {
$writer->endElement();
$currentTestCase = null;
}
$writer->startElement('phptFile');
$writer->writeAttribute('path', $test->getName());
$writer->endElement();
}
}
if ($currentTestCase !== null) {
$writer->endElement();
}
$writer->endElement();
file_put_contents($this->filename, $writer->outputMemory());
$buffer .= sprintf(
'Wrote list of tests that would have been run to %s' . PHP_EOL,
$this->filename,
);
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-tests-xml options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-tests-xml options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-tests-xml options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
phpunit/src/TextUI/Command/Commands/ListTestSuitesCommand.php 0000644 00000003776 15243417753 0020333 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sprintf;
use PHPUnit\TextUI\Configuration\Registry;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestSuitesCommand implements Command
{
private readonly TestSuiteCollection $suites;
public function __construct(TestSuiteCollection $suites)
{
$this->suites = $suites;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test suite(s):' . PHP_EOL;
foreach ($this->suites as $suite) {
$buffer .= sprintf(
' - %s' . PHP_EOL,
$suite->name(),
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-suites options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-suites options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-suites options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if ($configuration->includeTestSuite() !== '') {
$buffer .= 'The --testsuite and --list-suites options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
phpunit/src/TextUI/Command/Commands/AtLeastVersionCommand.php 0000644 00000001523 15243417753 0020252 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function version_compare;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AtLeastVersionCommand implements Command
{
private readonly string $version;
public function __construct(string $version)
{
$this->version = $version;
}
public function execute(): Result
{
if (version_compare(Version::id(), $this->version, '>=')) {
return Result::from();
}
return Result::from('', Result::FAILURE);
}
}
phpunit/src/TextUI/Command/Commands/ShowHelpCommand.php 0000644 00000001410 15243417753 0017073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use PHPUnit\TextUI\Help;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShowHelpCommand implements Command
{
private readonly int $shellExitCode;
public function __construct(int $shellExitCode)
{
$this->shellExitCode = $shellExitCode;
}
public function execute(): Result
{
return Result::from(
(new Help)->generate(),
$this->shellExitCode,
);
}
}
phpunit/src/TextUI/Command/Commands/MigrateConfigurationCommand.php 0000644 00000003146 15243417753 0021472 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function copy;
use function file_put_contents;
use function sprintf;
use PHPUnit\TextUI\XmlConfiguration\Migrator;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrateConfigurationCommand implements Command
{
private readonly string $filename;
public function __construct(string $filename)
{
$this->filename = $filename;
}
public function execute(): Result
{
try {
$migrated = (new Migrator)->migrate($this->filename);
copy($this->filename, $this->filename . '.bak');
file_put_contents($this->filename, $migrated);
return Result::from(
sprintf(
'Created backup: %s.bak%sMigrated configuration: %s%s',
$this->filename,
PHP_EOL,
$this->filename,
PHP_EOL,
),
);
} catch (Throwable $t) {
return Result::from(
sprintf(
'Migration of %s failed:%s%s%s',
$this->filename,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
),
Result::FAILURE,
);
}
}
}
phpunit/src/TextUI/Command/Commands/ListTestsAsTextCommand.php 0000644 00000004451 15243417753 0020441 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sprintf;
use function str_replace;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\TextUI\Configuration\Registry;
use RecursiveIteratorIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestsAsTextCommand implements Command
{
private readonly TestSuite $suite;
public function __construct(TestSuite $suite)
{
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test(s):' . PHP_EOL;
foreach (new RecursiveIteratorIterator($this->suite) as $test) {
if ($test instanceof TestCase) {
$name = sprintf(
'%s::%s',
$test::class,
str_replace(' with data set ', '', $test->nameWithDataSet()),
);
} elseif ($test instanceof PhptTestCase) {
$name = $test->getName();
} else {
continue;
}
$buffer .= sprintf(
' - %s' . PHP_EOL,
$name,
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-tests options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-tests options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-tests options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
phpunit/src/TextUI/Command/Commands/ListGroupsCommand.php 0000644 00000004224 15243417753 0017463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sort;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\TestSuite;
use PHPUnit\TextUI\Configuration\Registry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListGroupsCommand implements Command
{
private readonly TestSuite $suite;
public function __construct(TestSuite $suite)
{
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test group(s):' . PHP_EOL;
$groups = $this->suite->groups();
sort($groups);
foreach ($groups as $group) {
if (str_starts_with($group, '__phpunit_')) {
continue;
}
$buffer .= sprintf(
' - %s' . PHP_EOL,
$group,
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-groups options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-groups options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-groups options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if ($configuration->includeTestSuite() !== '') {
$buffer .= 'The --testsuite and --list-groups options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
phpunit/src/TextUI/TestRunner.php 0000644 00000004600 15243417753 0013041 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function mt_srand;
use PHPUnit\Event;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\ResultCache\ResultCache;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\Configuration\Configuration;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunner
{
/**
* @throws RuntimeException
*/
public function run(Configuration $configuration, ResultCache $resultCache, TestSuite $suite): void
{
try {
Event\Facade::emitter()->testRunnerStarted();
if ($configuration->executionOrder() === TestSuiteSorter::ORDER_RANDOMIZED) {
mt_srand($configuration->randomOrderSeed());
}
if ($configuration->executionOrder() !== TestSuiteSorter::ORDER_DEFAULT ||
$configuration->executionOrderDefects() !== TestSuiteSorter::ORDER_DEFAULT ||
$configuration->resolveDependencies()) {
$resultCache->load();
(new TestSuiteSorter($resultCache))->reorderTestsInSuite(
$suite,
$configuration->executionOrder(),
$configuration->resolveDependencies(),
$configuration->executionOrderDefects(),
);
Event\Facade::emitter()->testSuiteSorted(
$configuration->executionOrder(),
$configuration->executionOrderDefects(),
$configuration->resolveDependencies(),
);
}
(new TestSuiteFilterProcessor)->process($configuration, $suite);
Event\Facade::emitter()->testRunnerExecutionStarted(
Event\TestSuite\TestSuiteBuilder::from($suite),
);
$suite->run();
Event\Facade::emitter()->testRunnerExecutionFinished();
Event\Facade::emitter()->testRunnerFinished();
} catch (Throwable $t) {
throw new RuntimeException(
$t->getMessage(),
(int) $t->getCode(),
$t,
);
}
}
}
phpunit/src/TextUI/Help.php 0000644 00000036727 15243417753 0011637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use const PHP_EOL;
use function count;
use function defined;
use function explode;
use function max;
use function preg_replace_callback;
use function str_pad;
use function str_repeat;
use function strlen;
use function wordwrap;
use PHPUnit\Util\Color;
use SebastianBergmann\Environment\Console;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Help
{
private const LEFT_MARGIN = ' ';
private int $lengthOfLongestOptionName = 0;
private readonly int $columnsAvailableForDescription;
private ?bool $hasColor;
public function __construct(?int $width = null, ?bool $withColor = null)
{
if ($width === null) {
$width = (new Console)->getNumberOfColumns();
}
if ($withColor === null) {
$this->hasColor = (new Console)->hasColorSupport();
} else {
$this->hasColor = $withColor;
}
foreach ($this->elements() as $options) {
foreach ($options as $option) {
if (isset($option['arg'])) {
$this->lengthOfLongestOptionName = max($this->lengthOfLongestOptionName, strlen($option['arg']));
}
}
}
$this->columnsAvailableForDescription = $width - $this->lengthOfLongestOptionName - 4;
}
public function generate(): string
{
if ($this->hasColor) {
return $this->writeWithColor();
}
return $this->writeWithoutColor();
}
private function writeWithoutColor(): string
{
$buffer = '';
foreach ($this->elements() as $section => $options) {
$buffer .= "{$section}:" . PHP_EOL;
if ($section !== 'Usage') {
$buffer .= PHP_EOL;
}
foreach ($options as $option) {
if (isset($option['spacer'])) {
$buffer .= PHP_EOL;
}
if (isset($option['text'])) {
$buffer .= self::LEFT_MARGIN . $option['text'] . PHP_EOL;
}
if (isset($option['arg'])) {
$arg = str_pad($option['arg'], $this->lengthOfLongestOptionName);
$buffer .= self::LEFT_MARGIN . $arg . ' ' . $option['desc'] . PHP_EOL;
}
}
$buffer .= PHP_EOL;
}
return $buffer;
}
private function writeWithColor(): string
{
$buffer = '';
foreach ($this->elements() as $section => $options) {
$buffer .= Color::colorize('fg-yellow', "{$section}:") . PHP_EOL;
if ($section !== 'Usage') {
$buffer .= PHP_EOL;
}
foreach ($options as $option) {
if (isset($option['spacer'])) {
$buffer .= PHP_EOL;
}
if (isset($option['text'])) {
$buffer .= self::LEFT_MARGIN . $option['text'] . PHP_EOL;
}
if (isset($option['arg'])) {
$arg = Color::colorize('fg-green', str_pad($option['arg'], $this->lengthOfLongestOptionName));
$arg = preg_replace_callback(
'/(<[^>]+>)/',
static fn ($matches) => Color::colorize('fg-cyan', $matches[0]),
$arg,
);
$desc = explode(PHP_EOL, wordwrap($option['desc'], $this->columnsAvailableForDescription, PHP_EOL));
$buffer .= self::LEFT_MARGIN . $arg . ' ' . $desc[0] . PHP_EOL;
for ($i = 1; $i < count($desc); $i++) {
$buffer .= str_repeat(' ', $this->lengthOfLongestOptionName + 3) . $desc[$i] . PHP_EOL;
}
}
}
$buffer .= PHP_EOL;
}
return $buffer;
}
/**
* @psalm-return array<non-empty-string, non-empty-list<array{text: non-empty-string}|array{arg: non-empty-string, desc: non-empty-string}|array{spacer: ''}>>
*/
private function elements(): array
{
$elements = [
'Usage' => [
['text' => 'phpunit [options] <directory|file> ...'],
],
'Configuration' => [
['arg' => '--bootstrap <file>', 'desc' => 'A PHP script that is included before the tests run'],
['arg' => '-c|--configuration <file>', 'desc' => 'Read configuration from XML file'],
['arg' => '--no-configuration', 'desc' => 'Ignore default configuration file (phpunit.xml)'],
['arg' => '--no-extensions', 'desc' => 'Do not load PHPUnit extensions'],
['arg' => '--include-path <path(s)>', 'desc' => 'Prepend PHP\'s include_path with given path(s)'],
['arg' => '-d <key[=value]>', 'desc' => 'Sets a php.ini value'],
['arg' => '--cache-directory <dir>', 'desc' => 'Specify cache directory'],
['arg' => '--generate-configuration', 'desc' => 'Generate configuration file with suggested settings'],
['arg' => '--migrate-configuration', 'desc' => 'Migrate configuration file to current format'],
['arg' => '--generate-baseline <file>', 'desc' => 'Generate baseline for issues'],
['arg' => '--use-baseline <file>', 'desc' => 'Use baseline to ignore issues'],
['arg' => '--ignore-baseline', 'desc' => 'Do not use baseline to ignore issues'],
],
'Selection' => [
['arg' => '--list-suites', 'desc' => 'List available test suites'],
['arg' => '--testsuite <name>', 'desc' => 'Only run tests from the specified test suite(s)'],
['arg' => '--exclude-testsuite <name>', 'desc' => 'Exclude tests from the specified test suite(s)'],
['arg' => '--list-groups', 'desc' => 'List available test groups'],
['arg' => '--group <name>', 'desc' => 'Only run tests from the specified group(s)'],
['arg' => '--exclude-group <name>', 'desc' => 'Exclude tests from the specified group(s)'],
['arg' => '--covers <name>', 'desc' => 'Only run tests that intend to cover <name>'],
['arg' => '--uses <name>', 'desc' => 'Only run tests that intend to use <name>'],
['arg' => '--list-tests', 'desc' => 'List available tests'],
['arg' => '--list-tests-xml <file>', 'desc' => 'List available tests in XML format'],
['arg' => '--filter <pattern>', 'desc' => 'Filter which tests to run'],
['arg' => '--test-suffix <suffixes>', 'desc' => 'Only search for test in files with specified suffix(es). Default: Test.php,.phpt'],
],
'Execution' => [
['arg' => '--process-isolation', 'desc' => 'Run each test in a separate PHP process'],
['arg' => '--globals-backup', 'desc' => 'Backup and restore $GLOBALS for each test'],
['arg' => '--static-backup', 'desc' => 'Backup and restore static properties for each test'],
['spacer' => ''],
['arg' => '--strict-coverage', 'desc' => 'Be strict about code coverage metadata'],
['arg' => '--strict-global-state', 'desc' => 'Be strict about changes to global state'],
['arg' => '--disallow-test-output', 'desc' => 'Be strict about output during tests'],
['arg' => '--enforce-time-limit', 'desc' => 'Enforce time limit based on test size'],
['arg' => '--default-time-limit <sec>', 'desc' => 'Timeout in seconds for tests that have no declared size'],
['arg' => '--dont-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
['spacer' => ''],
['arg' => '--stop-on-defect', 'desc' => 'Stop after first error, failure, warning, or risky test'],
['arg' => '--stop-on-error', 'desc' => 'Stop after first error'],
['arg' => '--stop-on-failure', 'desc' => 'Stop after first failure'],
['arg' => '--stop-on-warning', 'desc' => 'Stop after first warning'],
['arg' => '--stop-on-risky', 'desc' => 'Stop after first risky test'],
['arg' => '--stop-on-deprecation', 'desc' => 'Stop after first test that triggered a deprecation'],
['arg' => '--stop-on-notice', 'desc' => 'Stop after first test that triggered a notice'],
['arg' => '--stop-on-skipped', 'desc' => 'Stop after first skipped test'],
['arg' => '--stop-on-incomplete', 'desc' => 'Stop after first incomplete test'],
['spacer' => ''],
['arg' => '--fail-on-empty-test-suite', 'desc' => 'Signal failure using shell exit code when no tests were run'],
['arg' => '--fail-on-warning', 'desc' => 'Signal failure using shell exit code when a warning was triggered'],
['arg' => '--fail-on-risky', 'desc' => 'Signal failure using shell exit code when a test was considered risky'],
['arg' => '--fail-on-deprecation', 'desc' => 'Signal failure using shell exit code when a deprecation was triggered'],
['arg' => '--fail-on-notice', 'desc' => 'Signal failure using shell exit code when a notice was triggered'],
['arg' => '--fail-on-skipped', 'desc' => 'Signal failure using shell exit code when a test was skipped'],
['arg' => '--fail-on-incomplete', 'desc' => 'Signal failure using shell exit code when a test was marked incomplete'],
['spacer' => ''],
['arg' => '--cache-result', 'desc' => 'Write test results to cache file'],
['arg' => '--do-not-cache-result', 'desc' => 'Do not write test results to cache file'],
['spacer' => ''],
['arg' => '--order-by <order>', 'desc' => 'Run tests in order: default|defects|depends|duration|no-depends|random|reverse|size'],
['arg' => '--random-order-seed <N>', 'desc' => 'Use the specified random seed when running tests in random order'],
],
'Reporting' => [
['arg' => '--colors <flag>', 'desc' => 'Use colors in output ("never", "auto" or "always")'],
['arg' => '--columns <n>', 'desc' => 'Number of columns to use for progress output'],
['arg' => '--columns max', 'desc' => 'Use maximum number of columns for progress output'],
['arg' => '--stderr', 'desc' => 'Write to STDERR instead of STDOUT'],
['spacer' => ''],
['arg' => '--no-progress', 'desc' => 'Disable output of test execution progress'],
['arg' => '--no-results', 'desc' => 'Disable output of test results'],
['arg' => '--no-output', 'desc' => 'Disable all output'],
['spacer' => ''],
['arg' => '--display-incomplete', 'desc' => 'Display details for incomplete tests'],
['arg' => '--display-skipped', 'desc' => 'Display details for skipped tests'],
['arg' => '--display-deprecations', 'desc' => 'Display details for deprecations triggered by tests'],
['arg' => '--display-errors', 'desc' => 'Display details for errors triggered by tests'],
['arg' => '--display-notices', 'desc' => 'Display details for notices triggered by tests'],
['arg' => '--display-warnings', 'desc' => 'Display details for warnings triggered by tests'],
['arg' => '--reverse-list', 'desc' => 'Print defects in reverse order'],
['spacer' => ''],
['arg' => '--teamcity', 'desc' => 'Replace default progress and result output with TeamCity format'],
['arg' => '--testdox', 'desc' => 'Replace default result output with TestDox format'],
['spacer' => ''],
['arg' => '--debug', 'desc' => 'Replace default progress and result output with debugging information'],
],
'Logging' => [
['arg' => '--log-junit <file>', 'desc' => 'Write test results in JUnit XML format to file'],
['arg' => '--log-teamcity <file>', 'desc' => 'Write test results in TeamCity format to file'],
['arg' => '--testdox-html <file>', 'desc' => 'Write test results in TestDox format (HTML) to file'],
['arg' => '--testdox-text <file>', 'desc' => 'Write test results in TestDox format (plain text) to file'],
['arg' => '--log-events-text <file>', 'desc' => 'Stream events as plain text to file'],
['arg' => '--log-events-verbose-text <file>', 'desc' => 'Stream events as plain text with extended information to file'],
['arg' => '--no-logging', 'desc' => 'Ignore logging configured in the XML configuration file'],
],
'Code Coverage' => [
['arg' => '--coverage-clover <file>', 'desc' => 'Write code coverage report in Clover XML format to file'],
['arg' => '--coverage-cobertura <file>', 'desc' => 'Write code coverage report in Cobertura XML format to file'],
['arg' => '--coverage-crap4j <file>', 'desc' => 'Write code coverage report in Crap4J XML format to file'],
['arg' => '--coverage-html <dir>', 'desc' => 'Write code coverage report in HTML format to directory'],
['arg' => '--coverage-php <file>', 'desc' => 'Write serialized code coverage data to file'],
['arg' => '--coverage-text=<file>', 'desc' => 'Write code coverage report in text format to file [default: standard output]'],
['arg' => '--coverage-xml <dir>', 'desc' => 'Write code coverage report in XML format to directory'],
['arg' => '--warm-coverage-cache', 'desc' => 'Warm static analysis cache'],
['arg' => '--coverage-filter <dir>', 'desc' => 'Include <dir> in code coverage reporting'],
['arg' => '--path-coverage', 'desc' => 'Report path coverage in addition to line coverage'],
['arg' => '--disable-coverage-ignore', 'desc' => 'Disable metadata for ignoring code coverage'],
['arg' => '--no-coverage', 'desc' => 'Ignore code coverage reporting configured in the XML configuration file'],
],
];
if (defined('__PHPUNIT_PHAR__')) {
$elements['PHAR'] = [
['arg' => '--manifest', 'desc' => 'Print Software Bill of Materials (SBOM) in plain-text format'],
['arg' => '--sbom', 'desc' => 'Print Software Bill of Materials (SBOM) in CycloneDX XML format'],
['arg' => '--composer-lock', 'desc' => 'Print composer.lock file used to build the PHAR'],
];
}
$elements['Miscellaneous'] = [
['arg' => '-h|--help', 'desc' => 'Prints this usage information'],
['arg' => '--version', 'desc' => 'Prints the version and exits'],
['arg' => '--atleast-version <min>', 'desc' => 'Checks that version is greater than <min> and exits'],
['arg' => '--check-version', 'desc' => 'Checks whether PHPUnit is the latest version and exits'],
];
return $elements;
}
}
phpunit/src/TextUI/TestSuiteFilterProcessor.php 0000644 00000004507 15243417753 0015735 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function array_map;
use PHPUnit\Event;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\Filter\Factory;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\FilterNotConfiguredException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFilterProcessor
{
/**
* @throws Event\RuntimeException
* @throws FilterNotConfiguredException
*/
public function process(Configuration $configuration, TestSuite $suite): void
{
$factory = new Factory;
if (!$configuration->hasFilter() &&
!$configuration->hasGroups() &&
!$configuration->hasExcludeGroups() &&
!$configuration->hasTestsCovering() &&
!$configuration->hasTestsUsing()) {
return;
}
if ($configuration->hasExcludeGroups()) {
$factory->addExcludeGroupFilter(
$configuration->excludeGroups(),
);
}
if ($configuration->hasGroups()) {
$factory->addIncludeGroupFilter(
$configuration->groups(),
);
}
if ($configuration->hasTestsCovering()) {
$factory->addIncludeGroupFilter(
array_map(
static fn (string $name): string => '__phpunit_covers_' . $name,
$configuration->testsCovering(),
),
);
}
if ($configuration->hasTestsUsing()) {
$factory->addIncludeGroupFilter(
array_map(
static fn (string $name): string => '__phpunit_uses_' . $name,
$configuration->testsUsing(),
),
);
}
if ($configuration->hasFilter()) {
$factory->addNameFilter(
$configuration->filter(),
);
}
$suite->injectFilter($factory);
Event\Facade::emitter()->testSuiteFiltered(
Event\TestSuite\TestSuiteBuilder::from($suite),
);
}
}
phpunit/src/TextUI/Output/Printer/NullPrinter.php 0000644 00000001032 15243417753 0016125 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NullPrinter implements Printer
{
public function print(string $buffer): void
{
}
public function flush(): void
{
}
}
phpunit/src/TextUI/Output/Printer/DefaultPrinter.php 0000644 00000005447 15243417753 0016615 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function assert;
use function count;
use function dirname;
use function explode;
use function fclose;
use function fopen;
use function fsockopen;
use function fwrite;
use function sprintf;
use function str_replace;
use function str_starts_with;
use PHPUnit\TextUI\DirectoryDoesNotExistException;
use PHPUnit\TextUI\InvalidSocketException;
use PHPUnit\Util\Filesystem;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DefaultPrinter implements Printer
{
/**
* @psalm-var closed-resource|resource
*/
private $stream;
private readonly bool $isPhpStream;
private bool $isOpen;
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function from(string $out): self
{
return new self($out);
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function standardOutput(): self
{
return new self('php://stdout');
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function standardError(): self
{
return new self('php://stderr');
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
private function __construct(string $out)
{
$this->isPhpStream = str_starts_with($out, 'php://');
if (str_starts_with($out, 'socket://')) {
$tmp = explode(':', str_replace('socket://', '', $out));
if (count($tmp) !== 2) {
throw new InvalidSocketException(
sprintf(
'"%s" does not match "socket://hostname:port" format',
$out,
),
);
}
$this->stream = fsockopen($tmp[0], (int) $tmp[1]);
$this->isOpen = true;
return;
}
if (!$this->isPhpStream && !Filesystem::createDirectory(dirname($out))) {
throw new DirectoryDoesNotExistException(dirname($out));
}
$this->stream = fopen($out, 'wb');
$this->isOpen = true;
}
public function print(string $buffer): void
{
assert($this->isOpen);
fwrite($this->stream, $buffer);
}
public function flush(): void
{
if ($this->isOpen && $this->isPhpStream) {
fclose($this->stream);
$this->isOpen = false;
}
}
}
phpunit/src/TextUI/Output/Printer/Printer.php 0000644 00000000757 15243417753 0015307 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Printer
{
public function print(string $buffer): void;
public function flush(): void;
}
phpunit/src/TextUI/Output/Facade.php 0000644 00000020511 15243417753 0013372 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function assert;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Logging\TeamCity\TeamCityLogger;
use PHPUnit\Logging\TestDox\TestResultCollection;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\DirectoryDoesNotExistException;
use PHPUnit\TextUI\InvalidSocketException;
use PHPUnit\TextUI\Output\Default\ProgressPrinter\ProgressPrinter as DefaultProgressPrinter;
use PHPUnit\TextUI\Output\Default\ResultPrinter as DefaultResultPrinter;
use PHPUnit\TextUI\Output\Default\UnexpectedOutputPrinter;
use PHPUnit\TextUI\Output\TestDox\ResultPrinter as TestDoxResultPrinter;
use SebastianBergmann\Timer\Duration;
use SebastianBergmann\Timer\ResourceUsageFormatter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?Printer $printer = null;
private static ?DefaultResultPrinter $defaultResultPrinter = null;
private static ?TestDoxResultPrinter $testDoxResultPrinter = null;
private static ?SummaryPrinter $summaryPrinter = null;
private static bool $defaultProgressPrinter = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function init(Configuration $configuration, bool $extensionReplacesProgressOutput, bool $extensionReplacesResultOutput): Printer
{
self::createPrinter($configuration);
assert(self::$printer !== null);
if ($configuration->debug()) {
return self::$printer;
}
self::createUnexpectedOutputPrinter();
if (!$extensionReplacesProgressOutput) {
self::createProgressPrinter($configuration);
}
if (!$extensionReplacesResultOutput) {
self::createResultPrinter($configuration);
self::createSummaryPrinter($configuration);
}
if ($configuration->outputIsTeamCity()) {
new TeamCityLogger(
DefaultPrinter::standardOutput(),
EventFacade::instance(),
);
}
return self::$printer;
}
/**
* @psalm-param ?array<string, TestResultCollection> $testDoxResult
*/
public static function printResult(TestResult $result, ?array $testDoxResult, Duration $duration): void
{
assert(self::$printer !== null);
if ($result->numberOfTestsRun() > 0) {
if (self::$defaultProgressPrinter) {
self::$printer->print(PHP_EOL . PHP_EOL);
}
self::$printer->print((new ResourceUsageFormatter)->resourceUsage($duration) . PHP_EOL . PHP_EOL);
}
if (self::$testDoxResultPrinter !== null && $testDoxResult !== null) {
self::$testDoxResultPrinter->print($testDoxResult);
}
if (self::$defaultResultPrinter !== null) {
self::$defaultResultPrinter->print($result);
}
if (self::$summaryPrinter !== null) {
self::$summaryPrinter->print($result);
}
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function printerFor(string $target): Printer
{
if ($target === 'php://stdout') {
if (!self::$printer instanceof NullPrinter) {
return self::$printer;
}
return DefaultPrinter::standardOutput();
}
return DefaultPrinter::from($target);
}
private static function createPrinter(Configuration $configuration): void
{
$printerNeeded = false;
if ($configuration->debug()) {
$printerNeeded = true;
}
if ($configuration->outputIsTeamCity()) {
$printerNeeded = true;
}
if ($configuration->outputIsTestDox()) {
$printerNeeded = true;
}
if (!$configuration->noOutput() && !$configuration->noProgress()) {
$printerNeeded = true;
}
if (!$configuration->noOutput() && !$configuration->noResults()) {
$printerNeeded = true;
}
if ($printerNeeded) {
if ($configuration->outputToStandardErrorStream()) {
self::$printer = DefaultPrinter::standardError();
return;
}
self::$printer = DefaultPrinter::standardOutput();
return;
}
self::$printer = new NullPrinter;
}
private static function createProgressPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if (!self::useDefaultProgressPrinter($configuration)) {
return;
}
new DefaultProgressPrinter(
self::$printer,
EventFacade::instance(),
$configuration->colors(),
$configuration->columns(),
$configuration->source(),
);
self::$defaultProgressPrinter = true;
}
private static function useDefaultProgressPrinter(Configuration $configuration): bool
{
if ($configuration->noOutput()) {
return false;
}
if ($configuration->noProgress()) {
return false;
}
if ($configuration->outputIsTeamCity()) {
return false;
}
return true;
}
private static function createResultPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if ($configuration->outputIsTestDox()) {
self::$defaultResultPrinter = new DefaultResultPrinter(
self::$printer,
true,
true,
true,
false,
false,
true,
false,
false,
$configuration->displayDetailsOnTestsThatTriggerDeprecations(),
$configuration->displayDetailsOnTestsThatTriggerErrors(),
$configuration->displayDetailsOnTestsThatTriggerNotices(),
$configuration->displayDetailsOnTestsThatTriggerWarnings(),
$configuration->reverseDefectList(),
);
}
if ($configuration->outputIsTestDox()) {
self::$testDoxResultPrinter = new TestDoxResultPrinter(
self::$printer,
$configuration->colors(),
);
}
if ($configuration->noOutput() || $configuration->noResults()) {
return;
}
if (self::$defaultResultPrinter !== null) {
return;
}
self::$defaultResultPrinter = new DefaultResultPrinter(
self::$printer,
true,
true,
true,
true,
true,
true,
$configuration->displayDetailsOnIncompleteTests(),
$configuration->displayDetailsOnSkippedTests(),
$configuration->displayDetailsOnTestsThatTriggerDeprecations(),
$configuration->displayDetailsOnTestsThatTriggerErrors(),
$configuration->displayDetailsOnTestsThatTriggerNotices(),
$configuration->displayDetailsOnTestsThatTriggerWarnings(),
$configuration->reverseDefectList(),
);
}
private static function createSummaryPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if (($configuration->noOutput() || $configuration->noResults()) &&
!($configuration->outputIsTeamCity() || $configuration->outputIsTestDox())) {
return;
}
self::$summaryPrinter = new SummaryPrinter(
self::$printer,
$configuration->colors(),
);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private static function createUnexpectedOutputPrinter(): void
{
assert(self::$printer !== null);
new UnexpectedOutputPrinter(self::$printer, EventFacade::instance());
}
}
phpunit/src/TextUI/Output/TestDox/ResultPrinter.php 0000644 00000023311 15243417753 0016444 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\TestDox;
use const PHP_EOL;
use function array_map;
use function assert;
use function explode;
use function implode;
use function preg_match;
use function preg_split;
use function rtrim;
use function str_starts_with;
use function trim;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Logging\TestDox\TestResult as TestDoxTestResult;
use PHPUnit\Logging\TestDox\TestResultCollection;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
public function __construct(Printer $printer, bool $colors)
{
$this->printer = $printer;
$this->colors = $colors;
}
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function print(array $tests): void
{
foreach ($tests as $prettifiedClassName => $_tests) {
$this->printPrettifiedClassName($prettifiedClassName);
foreach ($_tests as $test) {
$this->printTestResult($test);
}
$this->printer->print(PHP_EOL);
}
}
public function flush(): void
{
$this->printer->flush();
}
/**
* @psalm-param string $prettifiedClassName
*/
private function printPrettifiedClassName(string $prettifiedClassName): void
{
$buffer = $prettifiedClassName;
if ($this->colors) {
$buffer = Color::colorizeTextBox('underlined', $buffer);
}
$this->printer->print($buffer . PHP_EOL);
}
private function printTestResult(TestDoxTestResult $test): void
{
$this->printTestResultHeader($test);
$this->printTestResultBody($test);
}
private function printTestResultHeader(TestDoxTestResult $test): void
{
$buffer = ' ' . $this->symbolFor($test->status()) . ' ';
if ($this->colors) {
$this->printer->print(
Color::colorizeTextBox(
$this->colorFor($test->status()),
$buffer,
),
);
} else {
$this->printer->print($buffer);
}
$this->printer->print($test->test()->testDox()->prettifiedMethodName($this->colors) . PHP_EOL);
}
private function printTestResultBody(TestDoxTestResult $test): void
{
if ($test->status()->isSuccess()) {
return;
}
if (!$test->hasThrowable()) {
return;
}
$this->printTestResultBodyStart($test);
$this->printThrowable($test);
$this->printTestResultBodyEnd($test);
}
private function printTestResultBodyStart(TestDoxTestResult $test): void
{
$this->printer->print(
$this->prefixLines(
$this->prefixFor('start', $test->status()),
'',
),
);
$this->printer->print(PHP_EOL);
}
private function printTestResultBodyEnd(TestDoxTestResult $test): void
{
$this->printer->print(PHP_EOL);
$this->printer->print(
$this->prefixLines(
$this->prefixFor('last', $test->status()),
'',
),
);
$this->printer->print(PHP_EOL);
}
private function printThrowable(TestDoxTestResult $test): void
{
$throwable = $test->throwable();
assert($throwable instanceof Throwable);
$message = trim($throwable->description());
$stackTrace = $this->formatStackTrace($throwable->stackTrace());
$diff = '';
if (!empty($message) && $this->colors) {
['message' => $message, 'diff' => $diff] = $this->colorizeMessageAndDiff(
$message,
$this->messageColorFor($test->status()),
);
}
if (!empty($message)) {
$this->printer->print(
$this->prefixLines(
$this->prefixFor('message', $test->status()),
$message,
),
);
$this->printer->print(PHP_EOL);
}
if (!empty($diff)) {
$this->printer->print(
$this->prefixLines(
$this->prefixFor('diff', $test->status()),
$diff,
),
);
$this->printer->print(PHP_EOL);
}
if (!empty($stackTrace)) {
if (!empty($message) || !empty($diff)) {
$prefix = $this->prefixFor('default', $test->status());
} else {
$prefix = $this->prefixFor('trace', $test->status());
}
$this->printer->print(
$this->prefixLines($prefix, PHP_EOL . $stackTrace),
);
}
}
/**
* @psalm-return array{message: string, diff: string}
*/
private function colorizeMessageAndDiff(string $buffer, string $style): array
{
$lines = $buffer ? array_map('\rtrim', explode(PHP_EOL, $buffer)) : [];
$message = [];
$diff = [];
$insideDiff = false;
foreach ($lines as $line) {
if ($line === '--- Expected') {
$insideDiff = true;
}
if (!$insideDiff) {
$message[] = $line;
} else {
if (str_starts_with($line, '-')) {
$line = Color::colorize('fg-red', Color::visualizeWhitespace($line, true));
} elseif (str_starts_with($line, '+')) {
$line = Color::colorize('fg-green', Color::visualizeWhitespace($line, true));
} elseif ($line === '@@ @@') {
$line = Color::colorize('fg-cyan', $line);
}
$diff[] = $line;
}
}
$message = implode(PHP_EOL, $message);
$diff = implode(PHP_EOL, $diff);
if (!empty($message)) {
$message = Color::colorizeTextBox($style, $message);
}
return [
'message' => $message,
'diff' => $diff,
];
}
private function formatStackTrace(string $stackTrace): string
{
if (!$this->colors) {
return rtrim($stackTrace);
}
$lines = [];
$previousPath = '';
foreach (explode(PHP_EOL, $stackTrace) as $line) {
if (preg_match('/^(.*):(\d+)$/', $line, $matches)) {
$lines[] = Color::colorizePath($matches[1], $previousPath) . Color::dim(':') . Color::colorize('fg-blue', $matches[2]) . "\n";
$previousPath = $matches[1];
continue;
}
$lines[] = $line;
$previousPath = '';
}
return rtrim(implode('', $lines));
}
private function prefixLines(string $prefix, string $message): string
{
return implode(
PHP_EOL,
array_map(
static fn (string $line) => ' ' . $prefix . ($line ? ' ' . $line : ''),
preg_split('/\r\n|\r|\n/', $message),
),
);
}
/**
* @psalm-param 'default'|'start'|'message'|'diff'|'trace'|'last' $type
*/
private function prefixFor(string $type, TestStatus $status): string
{
if (!$this->colors) {
return '│';
}
return Color::colorize(
$this->colorFor($status),
match ($type) {
'default' => '│',
'start' => '┐',
'message' => '├',
'diff' => '┊',
'trace' => '╵',
'last' => '┴',
},
);
}
private function colorFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return 'fg-green';
}
if ($status->isError()) {
return 'fg-yellow';
}
if ($status->isFailure()) {
return 'fg-red';
}
if ($status->isSkipped()) {
return 'fg-cyan';
}
if ($status->isIncomplete() || $status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return 'fg-yellow';
}
return 'fg-blue';
}
private function messageColorFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return '';
}
if ($status->isError()) {
return 'bg-yellow,fg-black';
}
if ($status->isFailure()) {
return 'bg-red,fg-white';
}
if ($status->isSkipped()) {
return 'fg-cyan';
}
if ($status->isIncomplete() || $status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return 'fg-yellow';
}
return 'fg-white,bg-blue';
}
private function symbolFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return '✔';
}
if ($status->isError() || $status->isFailure()) {
return '✘';
}
if ($status->isSkipped()) {
return '↩';
}
if ($status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return '⚠';
}
if ($status->isIncomplete()) {
return '∅';
}
return '?';
}
}
phpunit/src/TextUI/Output/Default/UnexpectedOutputPrinter.php 0000644 00000002065 15243417753 0020510 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\PrintedUnexpectedOutput;
use PHPUnit\Event\Test\PrintedUnexpectedOutputSubscriber;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Output\Printer;
final class UnexpectedOutputPrinter implements PrintedUnexpectedOutputSubscriber
{
private readonly Printer $printer;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$facade->registerSubscriber($this);
}
public function notify(PrintedUnexpectedOutput $event): void
{
$this->printer->print($event->output());
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/ProgressPrinter.php 0000644 00000027615 15243417753 0022147 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use function floor;
use function sprintf;
use function str_contains;
use function str_repeat;
use function strlen;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ProgressPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
private readonly int $numberOfColumns;
private readonly Source $source;
private int $column = 0;
private int $numberOfTests = 0;
private int $numberOfTestsWidth = 0;
private int $maxColumn = 0;
private int $numberOfTestsRun = 0;
private ?TestStatus $status = null;
private bool $prepared = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade, bool $colors, int $numberOfColumns, Source $source)
{
$this->printer = $printer;
$this->colors = $colors;
$this->numberOfColumns = $numberOfColumns;
$this->source = $source;
$this->registerSubscribers($facade);
}
public function testRunnerExecutionStarted(ExecutionStarted $event): void
{
$this->numberOfTestsRun = 0;
$this->numberOfTests = $event->testSuite()->count();
$this->numberOfTestsWidth = strlen((string) $this->numberOfTests);
$this->column = 0;
$this->maxColumn = $this->numberOfColumns - strlen(' / (XXX%)') - (2 * $this->numberOfTestsWidth);
}
public function beforeTestClassMethodErrored(): void
{
$this->printProgressForError();
$this->updateTestStatus(TestStatus::error());
}
public function testPrepared(): void
{
$this->prepared = true;
}
public function testSkipped(): void
{
if (!$this->prepared) {
$this->printProgressForSkipped();
} else {
$this->updateTestStatus(TestStatus::skipped());
}
}
public function testMarkedIncomplete(): void
{
$this->updateTestStatus(TestStatus::incomplete());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictNotices() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfNotices() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictNotices() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpNotices() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if ($event->ignoredByBaseline() || $event->ignoredByTest()) {
return;
}
if ($this->source->restrictDeprecations() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfDeprecations() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if ($event->ignoredByBaseline() || $event->ignoredByTest()) {
return;
}
if ($this->source->restrictDeprecations() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpDeprecations() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpunitDeprecation(): void
{
$this->updateTestStatus(TestStatus::deprecation());
}
public function testConsideredRisky(): void
{
$this->updateTestStatus(TestStatus::risky());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictWarnings() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfWarnings() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictWarnings() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpunitWarning(): void
{
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredError(ErrorTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfErrors() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::error());
}
public function testFailed(): void
{
$this->updateTestStatus(TestStatus::failure());
}
public function testErrored(Errored $event): void
{
/*
* @todo Eliminate this special case
*/
if (str_contains($event->asString(), 'Test was run in child process and ended unexpectedly')) {
$this->updateTestStatus(TestStatus::error());
return;
}
if (!$this->prepared) {
$this->printProgressForError();
} else {
$this->updateTestStatus(TestStatus::error());
}
}
public function testFinished(): void
{
if ($this->status === null) {
$this->printProgressForSuccess();
} elseif ($this->status->isSkipped()) {
$this->printProgressForSkipped();
} elseif ($this->status->isIncomplete()) {
$this->printProgressForIncomplete();
} elseif ($this->status->isRisky()) {
$this->printProgressForRisky();
} elseif ($this->status->isNotice()) {
$this->printProgressForNotice();
} elseif ($this->status->isDeprecation()) {
$this->printProgressForDeprecation();
} elseif ($this->status->isWarning()) {
$this->printProgressForWarning();
} elseif ($this->status->isFailure()) {
$this->printProgressForFailure();
} else {
$this->printProgressForError();
}
$this->status = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new BeforeTestClassMethodErroredSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestFinishedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestPreparedSubscriber($this),
new TestRunnerExecutionStartedSubscriber($this),
new TestSkippedSubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
}
private function updateTestStatus(TestStatus $status): void
{
if ($this->status !== null &&
$this->status->isMoreImportantThan($status)) {
return;
}
$this->status = $status;
}
private function printProgressForSuccess(): void
{
$this->printProgress('.');
}
private function printProgressForSkipped(): void
{
$this->printProgressWithColor('fg-cyan, bold', 'S');
}
private function printProgressForIncomplete(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'I');
}
private function printProgressForNotice(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'N');
}
private function printProgressForDeprecation(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'D');
}
private function printProgressForRisky(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'R');
}
private function printProgressForWarning(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'W');
}
private function printProgressForFailure(): void
{
$this->printProgressWithColor('bg-red, fg-white', 'F');
}
private function printProgressForError(): void
{
$this->printProgressWithColor('fg-red, bold', 'E');
}
private function printProgressWithColor(string $color, string $progress): void
{
if ($this->colors) {
$progress = Color::colorizeTextBox($color, $progress);
}
$this->printProgress($progress);
}
private function printProgress(string $progress): void
{
$this->printer->print($progress);
$this->column++;
$this->numberOfTestsRun++;
if ($this->column === $this->maxColumn || $this->numberOfTestsRun === $this->numberOfTests) {
if ($this->numberOfTestsRun === $this->numberOfTests) {
$this->printer->print(str_repeat(' ', $this->maxColumn - $this->column));
}
$this->printer->print(
sprintf(
' %' . $this->numberOfTestsWidth . 'd / %' .
$this->numberOfTestsWidth . 'd (%3s%%)',
$this->numberOfTestsRun,
$this->numberOfTests,
floor(($this->numberOfTestsRun / $this->numberOfTests) * 100),
),
);
if ($this->column === $this->maxColumn) {
$this->column = 0;
$this->printer->print("\n");
}
}
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001325 15243417753 0027032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->printer()->testTriggeredNotice($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestFailedSubscriber.php 0000644 00000001231 15243417753 0025134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->printer()->testFailed();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001377 15243417753 0030516 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->printer()->testTriggeredPhpunitWarning();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001405 15243417753 0030436 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->printer()->testTriggeredPhpDeprecation($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001333 15243417753 0027215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->printer()->testTriggeredWarning($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestPreparedSubscriber.php 0000644 00000001245 15243417753 0025517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->printer()->testPrepared();
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001347 15243417753 0027506 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->printer()->testTriggeredPhpNotice($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestFinishedSubscriber.php 0000644 00000001245 15243417753 0025506 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->printer()->testFinished();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/BeforeTestClassMethodErroredSubscriber.php 0000644 00000001425 15243417753 0030552 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\BeforeFirstTestMethodErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestClassMethodErroredSubscriber extends Subscriber implements BeforeFirstTestMethodErroredSubscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void
{
$this->printer()->beforeTestClassMethodErrored();
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestSkippedSubscriber.php 0000644 00000001237 15243417753 0025355 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->printer()->testSkipped();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestRunnerExecutionStartedSubscriber.php 0000644 00000001363 15243417753 0030363 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionStartedSubscriber extends Subscriber implements ExecutionStartedSubscriber
{
public function notify(ExecutionStarted $event): void
{
$this->printer()->testRunnerExecutionStarted($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/Subscriber.php 0000644 00000001255 15243417753 0023175 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly ProgressPrinter $printer;
public function __construct(ProgressPrinter $printer)
{
$this->printer = $printer;
}
protected function printer(): ProgressPrinter
{
return $this->printer;
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestErroredSubscriber.php 0000644 00000001245 15243417753 0025357 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->printer()->testErrored($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001427 15243417753 0031342 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->printer()->testTriggeredPhpunitDeprecation();
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredErrorSubscriber.php 0000644 00000001317 15243417753 0026703 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\ErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredErrorSubscriber extends Subscriber implements ErrorTriggeredSubscriber
{
public function notify(ErrorTriggered $event): void
{
$this->printer()->testTriggeredError($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001355 15243417753 0027671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->printer()->testTriggeredPhpWarning($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001363 15243417753 0030050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->printer()->testTriggeredDeprecation($event);
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001325 15243417753 0027177 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->printer()->testMarkedIncomplete();
}
}
phpunit/src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001317 15243417753 0027056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->printer()->testConsideredRisky();
}
}
phpunit/src/TextUI/Output/Default/ResultPrinter.php 0000644 00000050376 15243417753 0016451 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default;
use const PHP_EOL;
use function array_keys;
use function array_merge;
use function array_reverse;
use function array_unique;
use function assert;
use function count;
use function explode;
use function ksort;
use function range;
use function sprintf;
use function str_starts_with;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\TextUI\Output\Printer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultPrinter
{
private readonly Printer $printer;
private readonly bool $displayPhpunitErrors;
private readonly bool $displayPhpunitWarnings;
private readonly bool $displayTestsWithErrors;
private readonly bool $displayTestsWithFailedAssertions;
private readonly bool $displayRiskyTests;
private readonly bool $displayPhpunitDeprecations;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $displayDefectsInReverseOrder;
private bool $listPrinted = false;
public function __construct(Printer $printer, bool $displayPhpunitErrors, bool $displayPhpunitWarnings, bool $displayPhpunitDeprecations, bool $displayTestsWithErrors, bool $displayTestsWithFailedAssertions, bool $displayRiskyTests, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $displayDefectsInReverseOrder)
{
$this->printer = $printer;
$this->displayPhpunitErrors = $displayPhpunitErrors;
$this->displayPhpunitWarnings = $displayPhpunitWarnings;
$this->displayPhpunitDeprecations = $displayPhpunitDeprecations;
$this->displayTestsWithErrors = $displayTestsWithErrors;
$this->displayTestsWithFailedAssertions = $displayTestsWithFailedAssertions;
$this->displayRiskyTests = $displayRiskyTests;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->displayDefectsInReverseOrder = $displayDefectsInReverseOrder;
}
public function print(TestResult $result): void
{
if ($this->displayPhpunitErrors) {
$this->printPhpunitErrors($result);
}
if ($this->displayPhpunitWarnings) {
$this->printTestRunnerWarnings($result);
}
if ($this->displayPhpunitDeprecations) {
$this->printTestRunnerDeprecations($result);
}
if ($this->displayTestsWithErrors) {
$this->printTestsWithErrors($result);
}
if ($this->displayTestsWithFailedAssertions) {
$this->printTestsWithFailedAssertions($result);
}
if ($this->displayPhpunitWarnings) {
$this->printDetailsOnTestsThatTriggeredPhpunitWarnings($result);
}
if ($this->displayPhpunitDeprecations) {
$this->printDetailsOnTestsThatTriggeredPhpunitDeprecations($result);
}
if ($this->displayRiskyTests) {
$this->printRiskyTests($result);
}
if ($this->displayDetailsOnIncompleteTests) {
$this->printIncompleteTests($result);
}
if ($this->displayDetailsOnSkippedTests) {
$this->printSkippedTestSuites($result);
$this->printSkippedTests($result);
}
if ($this->displayDetailsOnTestsThatTriggerErrors) {
$this->printIssueList('error', $result->errors());
}
if ($this->displayDetailsOnTestsThatTriggerWarnings) {
$this->printIssueList('PHP warning', $result->phpWarnings());
$this->printIssueList('warning', $result->warnings());
}
if ($this->displayDetailsOnTestsThatTriggerNotices) {
$this->printIssueList('PHP notice', $result->phpNotices());
$this->printIssueList('notice', $result->notices());
}
if ($this->displayDetailsOnTestsThatTriggerDeprecations) {
$this->printIssueList('PHP deprecation', $result->phpDeprecations());
$this->printIssueList('deprecation', $result->deprecations());
}
}
public function flush(): void
{
$this->printer->flush();
}
private function printPhpunitErrors(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitErrorEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitErrorEvents());
$this->printListHeaderWithNumber($elements['numberOfTestsWithIssues'], 'PHPUnit error');
$this->printList($elements['elements']);
}
private function printDetailsOnTestsThatTriggeredPhpunitDeprecations(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitDeprecationEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitDeprecationEvents());
$this->printListHeaderWithNumberOfTestsAndNumberOfIssues(
$elements['numberOfTestsWithIssues'],
$elements['numberOfIssues'],
'PHPUnit deprecation',
);
$this->printList($elements['elements']);
}
private function printTestRunnerWarnings(TestResult $result): void
{
if (!$result->hasTestRunnerTriggeredWarningEvents()) {
return;
}
$elements = [];
foreach ($result->testRunnerTriggeredWarningEvents() as $event) {
$elements[] = [
'title' => $event->message(),
'body' => '',
];
}
$this->printListHeaderWithNumber(count($elements), 'PHPUnit test runner warning');
$this->printList($elements);
}
private function printTestRunnerDeprecations(TestResult $result): void
{
if (!$result->hasTestRunnerTriggeredDeprecationEvents()) {
return;
}
$elements = [];
foreach ($result->testRunnerTriggeredDeprecationEvents() as $event) {
$elements[] = [
'title' => $event->message(),
'body' => '',
];
}
$this->printListHeaderWithNumber(count($elements), 'PHPUnit test runner deprecation');
$this->printList($elements);
}
private function printDetailsOnTestsThatTriggeredPhpunitWarnings(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitWarningEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitWarningEvents());
$this->printListHeaderWithNumberOfTestsAndNumberOfIssues(
$elements['numberOfTestsWithIssues'],
$elements['numberOfIssues'],
'PHPUnit warning',
);
$this->printList($elements['elements']);
}
private function printTestsWithErrors(TestResult $result): void
{
if (!$result->hasTestErroredEvents()) {
return;
}
$elements = [];
foreach ($result->testErroredEvents() as $event) {
if ($event instanceof BeforeFirstTestMethodErrored) {
$title = $event->testClassName();
} else {
$title = $this->name($event->test());
}
$elements[] = [
'title' => $title,
'body' => $event->throwable()->asString(),
];
}
$this->printListHeaderWithNumber(count($elements), 'error');
$this->printList($elements);
}
private function printTestsWithFailedAssertions(TestResult $result): void
{
if (!$result->hasTestFailedEvents()) {
return;
}
$elements = [];
foreach ($result->testFailedEvents() as $event) {
$body = $event->throwable()->asString();
if (str_starts_with($body, 'AssertionError: ')) {
$body = substr($body, strlen('AssertionError: '));
}
$elements[] = [
'title' => $this->name($event->test()),
'body' => $body,
];
}
$this->printListHeaderWithNumber(count($elements), 'failure');
$this->printList($elements);
}
private function printRiskyTests(TestResult $result): void
{
if (!$result->hasTestConsideredRiskyEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testConsideredRiskyEvents());
$this->printListHeaderWithNumber($elements['numberOfTestsWithIssues'], 'risky test');
$this->printList($elements['elements']);
}
private function printIncompleteTests(TestResult $result): void
{
if (!$result->hasTestMarkedIncompleteEvents()) {
return;
}
$elements = [];
foreach ($result->testMarkedIncompleteEvents() as $event) {
$elements[] = [
'title' => $this->name($event->test()),
'body' => $event->throwable()->asString(),
];
}
$this->printListHeaderWithNumber(count($elements), 'incomplete test');
$this->printList($elements);
}
private function printSkippedTestSuites(TestResult $result): void
{
if (!$result->hasTestSuiteSkippedEvents()) {
return;
}
$elements = [];
foreach ($result->testSuiteSkippedEvents() as $event) {
$elements[] = [
'title' => $event->testSuite()->name(),
'body' => $event->message(),
];
}
$this->printListHeaderWithNumber(count($elements), 'skipped test suite');
$this->printList($elements);
}
private function printSkippedTests(TestResult $result): void
{
if (!$result->hasTestSkippedEvents()) {
return;
}
$elements = [];
foreach ($result->testSkippedEvents() as $event) {
$elements[] = [
'title' => $this->name($event->test()),
'body' => $event->message(),
];
}
$this->printListHeaderWithNumber(count($elements), 'skipped test');
$this->printList($elements);
}
/**
* @psalm-param non-empty-string $type
* @psalm-param list<Issue> $issues
*/
private function printIssueList(string $type, array $issues): void
{
if (empty($issues)) {
return;
}
$numberOfUniqueIssues = count($issues);
$triggeringTests = [];
foreach ($issues as $issue) {
$triggeringTests = array_merge($triggeringTests, array_keys($issue->triggeringTests()));
}
$numberOfTests = count(array_unique($triggeringTests));
unset($triggeringTests);
$this->printListHeader(
sprintf(
'%d test%s triggered %d %s%s:' . PHP_EOL . PHP_EOL,
$numberOfTests,
$numberOfTests !== 1 ? 's' : '',
$numberOfUniqueIssues,
$type,
$numberOfUniqueIssues !== 1 ? 's' : '',
),
);
$i = 1;
foreach ($issues as $issue) {
$title = sprintf(
'%s:%d',
$issue->file(),
$issue->line(),
);
$body = trim($issue->description()) . PHP_EOL . PHP_EOL . 'Triggered by:';
$triggeringTests = $issue->triggeringTests();
ksort($triggeringTests);
foreach ($triggeringTests as $triggeringTest) {
$body .= PHP_EOL . PHP_EOL . '* ' . $triggeringTest['test']->id();
if ($triggeringTest['count'] > 1) {
$body .= sprintf(
' (%d times)',
$triggeringTest['count'],
);
}
if ($triggeringTest['test']->isTestMethod()) {
$body .= PHP_EOL . ' ' . $triggeringTest['test']->file() . ':' . $triggeringTest['test']->line();
}
}
$this->printIssueListElement($i++, $title, $body);
$this->printer->print(PHP_EOL);
}
}
private function printListHeaderWithNumberOfTestsAndNumberOfIssues(int $numberOfTestsWithIssues, int $numberOfIssues, string $type): void
{
$this->printListHeader(
sprintf(
"%d test%s triggered %d %s%s:\n\n",
$numberOfTestsWithIssues,
$numberOfTestsWithIssues !== 1 ? 's' : '',
$numberOfIssues,
$type,
$numberOfIssues !== 1 ? 's' : '',
),
);
}
private function printListHeaderWithNumber(int $number, string $type): void
{
$this->printListHeader(
sprintf(
"There %s %d %s%s:\n\n",
($number === 1) ? 'was' : 'were',
$number,
$type,
($number === 1) ? '' : 's',
),
);
}
private function printListHeader(string $header): void
{
if ($this->listPrinted) {
$this->printer->print("--\n\n");
}
$this->listPrinted = true;
$this->printer->print($header);
}
/**
* @psalm-param list<array{title: string, body: string}> $elements
*/
private function printList(array $elements): void
{
$i = 1;
if ($this->displayDefectsInReverseOrder) {
$elements = array_reverse($elements);
}
foreach ($elements as $element) {
$this->printListElement($i++, $element['title'], $element['body']);
}
$this->printer->print("\n");
}
private function printListElement(int $number, string $title, string $body): void
{
$body = trim($body);
$this->printer->print(
sprintf(
"%s%d) %s\n%s%s",
$number > 1 ? "\n" : '',
$number,
$title,
$body,
!empty($body) ? "\n" : '',
),
);
}
private function printIssueListElement(int $number, string $title, string $body): void
{
$body = trim($body);
$this->printer->print(
sprintf(
"%d) %s\n%s%s",
$number,
$title,
$body,
!empty($body) ? "\n" : '',
),
);
}
private function name(Test $test): string
{
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
if (!$test->testData()->hasDataFromDataProvider()) {
return $test->nameWithClass();
}
return $test->className() . '::' . $test->methodName() . $test->testData()->dataFromDataProvider()->dataAsStringForResultOutput();
}
return $test->name();
}
/**
* @psalm-param array<string,list<ConsideredRisky|DeprecationTriggered|PhpDeprecationTriggered|PhpunitDeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpNoticeTriggered|WarningTriggered|PhpWarningTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered>> $events
*
* @psalm-return array{numberOfTestsWithIssues: int, numberOfIssues: int, elements: list<array{title: string, body: string}>}
*/
private function mapTestsWithIssuesEventsToElements(array $events): array
{
$elements = [];
$issues = 0;
foreach ($events as $reasons) {
$test = $reasons[0]->test();
$testLocation = $this->testLocation($test);
$title = $this->name($test);
$body = '';
$first = true;
$single = count($reasons) === 1;
foreach ($reasons as $reason) {
if ($first) {
$first = false;
} else {
$body .= PHP_EOL;
}
$body .= $this->reasonMessage($reason, $single);
$body .= $this->reasonLocation($reason, $single);
$issues++;
}
if (!empty($testLocation)) {
$body .= $testLocation;
}
$elements[] = [
'title' => $title,
'body' => $body,
];
}
return [
'numberOfTestsWithIssues' => count($events),
'numberOfIssues' => $issues,
'elements' => $elements,
];
}
private function testLocation(Test $test): string
{
if (!$test->isTestMethod()) {
return '';
}
assert($test instanceof TestMethod);
return sprintf(
'%s%s:%d%s',
PHP_EOL,
$test->file(),
$test->line(),
PHP_EOL,
);
}
private function reasonMessage(ConsideredRisky|DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpunitDeprecationTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered|PhpWarningTriggered|WarningTriggered $reason, bool $single): string
{
$message = trim($reason->message());
if ($single) {
return $message . PHP_EOL;
}
$lines = explode(PHP_EOL, $message);
$buffer = '* ' . $lines[0] . PHP_EOL;
if (count($lines) > 1) {
foreach (range(1, count($lines) - 1) as $line) {
$buffer .= ' ' . $lines[$line] . PHP_EOL;
}
}
return $buffer;
}
private function reasonLocation(ConsideredRisky|DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpunitDeprecationTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered|PhpWarningTriggered|WarningTriggered $reason, bool $single): string
{
if (!$reason instanceof DeprecationTriggered &&
!$reason instanceof PhpDeprecationTriggered &&
!$reason instanceof ErrorTriggered &&
!$reason instanceof NoticeTriggered &&
!$reason instanceof PhpNoticeTriggered &&
!$reason instanceof WarningTriggered &&
!$reason instanceof PhpWarningTriggered) {
return '';
}
return sprintf(
'%s%s:%d%s',
$single ? '' : ' ',
$reason->file(),
$reason->line(),
PHP_EOL,
);
}
}
phpunit/src/TextUI/Output/SummaryPrinter.php 0000644 00000013024 15243417753 0015231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function sprintf;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SummaryPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
private bool $countPrinted = false;
public function __construct(Printer $printer, bool $colors)
{
$this->printer = $printer;
$this->colors = $colors;
}
public function print(TestResult $result): void
{
if ($result->numberOfTestsRun() === 0) {
$this->printWithColor(
'fg-black, bg-yellow',
'No tests executed!',
);
return;
}
if ($result->wasSuccessfulAndNoTestHasIssues() &&
!$result->hasTestSuiteSkippedEvents() &&
!$result->hasTestSkippedEvents()) {
$this->printWithColor(
'fg-black, bg-green',
sprintf(
'OK (%d test%s, %d assertion%s)',
$result->numberOfTestsRun(),
$result->numberOfTestsRun() === 1 ? '' : 's',
$result->numberOfAssertions(),
$result->numberOfAssertions() === 1 ? '' : 's',
),
);
$this->printNumberOfIssuesIgnoredByBaseline($result);
return;
}
$color = 'fg-black, bg-yellow';
if ($result->wasSuccessful()) {
if (!$result->hasTestsWithIssues()) {
$this->printWithColor(
$color,
'OK, but some tests were skipped!',
);
} else {
$this->printWithColor(
$color,
'OK, but there were issues!',
);
}
} else {
if ($result->hasTestErroredEvents() || $result->hasTestTriggeredPhpunitErrorEvents()) {
$color = 'fg-white, bg-red';
$this->printWithColor(
$color,
'ERRORS!',
);
} elseif ($result->hasTestFailedEvents()) {
$color = 'fg-white, bg-red';
$this->printWithColor(
$color,
'FAILURES!',
);
} elseif ($result->hasWarnings()) {
$this->printWithColor(
$color,
'WARNINGS!',
);
} elseif ($result->hasDeprecations()) {
$this->printWithColor(
$color,
'DEPRECATIONS!',
);
} elseif ($result->hasNotices()) {
$this->printWithColor(
$color,
'NOTICES!',
);
}
}
$this->printCountString($result->numberOfTestsRun(), 'Tests', $color, true);
$this->printCountString($result->numberOfAssertions(), 'Assertions', $color, true);
$this->printCountString($result->numberOfErrors(), 'Errors', $color);
$this->printCountString($result->numberOfTestFailedEvents(), 'Failures', $color);
$this->printCountString($result->numberOfWarnings(), 'Warnings', $color);
$this->printCountString($result->numberOfDeprecations(), 'Deprecations', $color);
$this->printCountString($result->numberOfNotices(), 'Notices', $color);
$this->printCountString($result->numberOfTestSuiteSkippedEvents() + $result->numberOfTestSkippedEvents(), 'Skipped', $color);
$this->printCountString($result->numberOfTestMarkedIncompleteEvents(), 'Incomplete', $color);
$this->printCountString($result->numberOfTestsWithTestConsideredRiskyEvents(), 'Risky', $color);
$this->printWithColor($color, '.');
$this->printNumberOfIssuesIgnoredByBaseline($result);
}
private function printCountString(int $count, string $name, string $color, bool $always = false): void
{
if ($always || $count > 0) {
$this->printWithColor(
$color,
sprintf(
'%s%s: %d',
$this->countPrinted ? ', ' : '',
$name,
$count,
),
false,
);
$this->countPrinted = true;
}
}
private function printWithColor(string $color, string $buffer, bool $lf = true): void
{
if ($this->colors) {
$buffer = Color::colorizeTextBox($color, $buffer);
}
$this->printer->print($buffer);
if ($lf) {
$this->printer->print(PHP_EOL);
}
}
private function printNumberOfIssuesIgnoredByBaseline(TestResult $result): void
{
if ($result->hasIssuesIgnoredByBaseline()) {
$this->printer->print(
sprintf(
'%s%d issue%s %s ignored by baseline.%s',
PHP_EOL,
$result->numberOfIssuesIgnoredByBaseline(),
$result->numberOfIssuesIgnoredByBaseline() > 1 ? 's' : '',
$result->numberOfIssuesIgnoredByBaseline() > 1 ? 'were' : 'was',
PHP_EOL,
),
);
}
}
}
phpunit/src/TextUI/Exception/InvalidSocketException.php 0000644 00000001343 15243417753 0017305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidSocketException extends RuntimeException implements Exception
{
public function __construct(string $socket)
{
parent::__construct(
sprintf(
'"%s" does not match "socket://hostname:port" format',
$socket,
),
);
}
}
phpunit/src/TextUI/Exception/TestFileNotFoundException.php 0000644 00000001307 15243417753 0017742 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFileNotFoundException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(
sprintf(
'Test file "%s" not found',
$path,
),
);
}
}
phpunit/src/TextUI/Exception/ExtensionsNotConfiguredException.php 0000644 00000000757 15243417753 0021404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionsNotConfiguredException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Exception/TestDirectoryNotFoundException.php 0000644 00000001321 15243417753 0021023 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestDirectoryNotFoundException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(
sprintf(
'Test directory "%s" not found',
$path,
),
);
}
}
phpunit/src/TextUI/Exception/Exception.php 0000644 00000000667 15243417753 0014635 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use Throwable;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
phpunit/src/TextUI/Exception/RuntimeException.php 0000644 00000000711 15243417753 0016167 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
phpunit/src/TextUI/Exception/ReflectionException.php 0000644 00000000742 15243417753 0016642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Exception/DirectoryDoesNotExistException.php 0000644 00000001364 15243417753 0021026 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'Directory "%s" does not exist and could not be created',
$directory,
),
);
}
}
phpunit/src/TextUI/Application.php 0000644 00000055012 15243417753 0013176 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use const PHP_EOL;
use function is_file;
use function is_readable;
use function printf;
use function realpath;
use function sprintf;
use function trim;
use function unlink;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Logging\EventLogger;
use PHPUnit\Logging\JUnit\JunitXmlLogger;
use PHPUnit\Logging\TeamCity\TeamCityLogger;
use PHPUnit\Logging\TestDox\HtmlRenderer as TestDoxHtmlRenderer;
use PHPUnit\Logging\TestDox\PlainTextRenderer as TestDoxTextRenderer;
use PHPUnit\Logging\TestDox\TestResultCollector as TestDoxResultCollector;
use PHPUnit\Metadata\Api\CodeCoverage as CodeCoverageMetadataApi;
use PHPUnit\Runner\Baseline\CannotLoadBaselineException;
use PHPUnit\Runner\Baseline\Generator as BaselineGenerator;
use PHPUnit\Runner\Baseline\Reader;
use PHPUnit\Runner\Baseline\Writer;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\Runner\ErrorHandler;
use PHPUnit\Runner\Extension\ExtensionBootstrapper;
use PHPUnit\Runner\Extension\Facade as ExtensionFacade;
use PHPUnit\Runner\Extension\PharLoader;
use PHPUnit\Runner\GarbageCollection\GarbageCollectionHandler;
use PHPUnit\Runner\ResultCache\DefaultResultCache;
use PHPUnit\Runner\ResultCache\NullResultCache;
use PHPUnit\Runner\ResultCache\ResultCache;
use PHPUnit\Runner\ResultCache\ResultCacheHandler;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Runner\Version;
use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
use PHPUnit\TextUI\CliArguments\Builder;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception as ArgumentsException;
use PHPUnit\TextUI\CliArguments\XmlConfigurationFileFinder;
use PHPUnit\TextUI\Command\AtLeastVersionCommand;
use PHPUnit\TextUI\Command\GenerateConfigurationCommand;
use PHPUnit\TextUI\Command\ListGroupsCommand;
use PHPUnit\TextUI\Command\ListTestsAsTextCommand;
use PHPUnit\TextUI\Command\ListTestsAsXmlCommand;
use PHPUnit\TextUI\Command\ListTestSuitesCommand;
use PHPUnit\TextUI\Command\MigrateConfigurationCommand;
use PHPUnit\TextUI\Command\Result;
use PHPUnit\TextUI\Command\ShowHelpCommand;
use PHPUnit\TextUI\Command\ShowVersionCommand;
use PHPUnit\TextUI\Command\VersionCheckCommand;
use PHPUnit\TextUI\Command\WarmCodeCoverageCacheCommand;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TextUI\Configuration\Registry;
use PHPUnit\TextUI\Configuration\TestSuiteBuilder;
use PHPUnit\TextUI\Output\DefaultPrinter;
use PHPUnit\TextUI\Output\Facade as OutputFacade;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\TextUI\XmlConfiguration\DefaultConfiguration;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use SebastianBergmann\Timer\Timer;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Application
{
public function run(array $argv): int
{
try {
EventFacade::emitter()->applicationStarted();
$cliConfiguration = $this->buildCliConfiguration($argv);
$pathToXmlConfigurationFile = (new XmlConfigurationFileFinder)->find($cliConfiguration);
$this->executeCommandsThatOnlyRequireCliConfiguration($cliConfiguration, $pathToXmlConfigurationFile);
$xmlConfiguration = $this->loadXmlConfiguration($pathToXmlConfigurationFile);
$configuration = Registry::init(
$cliConfiguration,
$xmlConfiguration,
);
(new PhpHandler)->handle($configuration->php());
if ($configuration->hasBootstrap()) {
$this->loadBootstrapScript($configuration->bootstrap());
}
$this->executeCommandsThatRequireCompleteConfiguration($configuration, $cliConfiguration);
$testSuite = $this->buildTestSuite($configuration);
$this->executeCommandsThatRequireCliConfigurationAndTestSuite($cliConfiguration, $testSuite);
$this->executeHelpCommandWhenThereIsNothingElseToDo($configuration, $testSuite);
$pharExtensions = null;
$extensionRequiresCodeCoverageCollection = false;
$extensionReplacesOutput = false;
$extensionReplacesProgressOutput = false;
$extensionReplacesResultOutput = false;
$extensionRequiresExportOfObjects = false;
if (!$configuration->noExtensions()) {
if ($configuration->hasPharExtensionDirectory()) {
$pharExtensions = (new PharLoader)->loadPharExtensionsInDirectory(
$configuration->pharExtensionDirectory(),
);
}
$bootstrappedExtensions = $this->bootstrapExtensions($configuration);
$extensionRequiresCodeCoverageCollection = $bootstrappedExtensions['requiresCodeCoverageCollection'];
$extensionReplacesOutput = $bootstrappedExtensions['replacesOutput'];
$extensionReplacesProgressOutput = $bootstrappedExtensions['replacesProgressOutput'];
$extensionReplacesResultOutput = $bootstrappedExtensions['replacesResultOutput'];
$extensionRequiresExportOfObjects = $bootstrappedExtensions['requiresExportOfObjects'];
}
if ($extensionRequiresExportOfObjects) {
EventFacade::emitter()->exportObjects();
}
CodeCoverage::instance()->init(
$configuration,
CodeCoverageFilterRegistry::instance(),
$extensionRequiresCodeCoverageCollection,
);
if (CodeCoverage::instance()->isActive()) {
CodeCoverage::instance()->ignoreLines(
(new CodeCoverageMetadataApi)->linesToBeIgnored($testSuite),
);
}
$printer = OutputFacade::init(
$configuration,
$extensionReplacesProgressOutput,
$extensionReplacesResultOutput,
);
if (!$configuration->debug() && !$extensionReplacesOutput) {
$this->writeRuntimeInformation($printer, $configuration);
$this->writePharExtensionInformation($printer, $pharExtensions);
$this->writeRandomSeedInformation($printer, $configuration);
$printer->print(PHP_EOL);
}
if ($configuration->debug()) {
EventFacade::instance()->registerTracer(
new EventLogger(
'php://stdout',
false,
),
);
}
$this->registerLogfileWriters($configuration);
$testDoxResultCollector = $this->testDoxResultCollector($configuration);
TestResultFacade::init();
$resultCache = $this->initializeTestResultCache($configuration);
if ($configuration->controlGarbageCollector()) {
new GarbageCollectionHandler(
EventFacade::instance(),
$configuration->numberOfTestsBeforeGarbageCollection(),
);
}
$baselineGenerator = $this->configureBaseline($configuration);
EventFacade::instance()->seal();
$timer = new Timer;
$timer->start();
$runner = new TestRunner;
$runner->run(
$configuration,
$resultCache,
$testSuite,
);
$duration = $timer->stop();
$testDoxResult = null;
if (isset($testDoxResultCollector)) {
$testDoxResult = $testDoxResultCollector->testMethodsGroupedByClass();
}
if ($testDoxResult !== null &&
$configuration->hasLogfileTestdoxHtml()) {
OutputFacade::printerFor($configuration->logfileTestdoxHtml())->print(
(new TestDoxHtmlRenderer)->render($testDoxResult),
);
}
if ($testDoxResult !== null &&
$configuration->hasLogfileTestdoxText()) {
OutputFacade::printerFor($configuration->logfileTestdoxText())->print(
(new TestDoxTextRenderer)->render($testDoxResult),
);
}
$result = TestResultFacade::result();
if (!$extensionReplacesResultOutput && !$configuration->debug()) {
OutputFacade::printResult($result, $testDoxResult, $duration);
}
CodeCoverage::instance()->generateReports($printer, $configuration);
if (isset($baselineGenerator)) {
(new Writer)->write(
$configuration->generateBaseline(),
$baselineGenerator->baseline(),
);
$printer->print(
sprintf(
PHP_EOL . 'Baseline written to %s.' . PHP_EOL,
realpath($configuration->generateBaseline()),
),
);
}
$shellExitCode = (new ShellExitCodeCalculator)->calculate(
$configuration->failOnDeprecation(),
$configuration->failOnEmptyTestSuite(),
$configuration->failOnIncomplete(),
$configuration->failOnNotice(),
$configuration->failOnRisky(),
$configuration->failOnSkipped(),
$configuration->failOnWarning(),
$result,
);
EventFacade::emitter()->applicationFinished($shellExitCode);
return $shellExitCode;
// @codeCoverageIgnoreStart
} catch (Throwable $t) {
$this->exitWithCrashMessage($t);
}
// @codeCoverageIgnoreEnd
}
private function execute(Command\Command $command): never
{
print Version::getVersionString() . PHP_EOL . PHP_EOL;
$result = $command->execute();
print $result->output();
exit($result->shellExitCode());
}
private function loadBootstrapScript(string $filename): void
{
if (!is_readable($filename)) {
$this->exitWithErrorMessage(
sprintf(
'Cannot open bootstrap script "%s"',
$filename,
),
);
}
try {
include_once $filename;
} catch (Throwable $t) {
$message = sprintf(
'Error in bootstrap script: %s:%s%s%s%s',
$t::class,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
);
while ($t = $t->getPrevious()) {
$message .= sprintf(
'%s%sPrevious error: %s:%s%s%s%s',
PHP_EOL,
PHP_EOL,
$t::class,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
);
}
$this->exitWithErrorMessage($message);
}
EventFacade::emitter()->testRunnerBootstrapFinished($filename);
}
private function buildCliConfiguration(array $argv): CliConfiguration
{
try {
$cliConfiguration = (new Builder)->fromParameters($argv);
} catch (ArgumentsException $e) {
$this->exitWithErrorMessage($e->getMessage());
}
return $cliConfiguration;
}
private function loadXmlConfiguration(false|string $configurationFile): XmlConfiguration
{
if ($configurationFile === false) {
return DefaultConfiguration::create();
}
try {
return (new Loader)->load($configurationFile);
} catch (Throwable $e) {
$this->exitWithErrorMessage($e->getMessage());
}
}
private function buildTestSuite(Configuration $configuration): TestSuite
{
try {
return (new TestSuiteBuilder)->build($configuration);
} catch (Exception $e) {
$this->exitWithErrorMessage($e->getMessage());
}
}
/**
* @psalm-return array{requiresCodeCoverageCollection: bool, replacesOutput: bool, replacesProgressOutput: bool, replacesResultOutput: bool, requiresExportOfObjects: bool}
*/
private function bootstrapExtensions(Configuration $configuration): array
{
$facade = new ExtensionFacade;
$extensionBootstrapper = new ExtensionBootstrapper(
$configuration,
$facade,
);
foreach ($configuration->extensionBootstrappers() as $bootstrapper) {
$extensionBootstrapper->bootstrap(
$bootstrapper['className'],
$bootstrapper['parameters'],
);
}
return [
'requiresCodeCoverageCollection' => $facade->requiresCodeCoverageCollection(),
'replacesOutput' => $facade->replacesOutput(),
'replacesProgressOutput' => $facade->replacesProgressOutput(),
'replacesResultOutput' => $facade->replacesResultOutput(),
'requiresExportOfObjects' => $facade->requiresExportOfObjects(),
];
}
private function executeCommandsThatOnlyRequireCliConfiguration(CliConfiguration $cliConfiguration, false|string $configurationFile): void
{
if ($cliConfiguration->generateConfiguration()) {
$this->execute(new GenerateConfigurationCommand);
}
if ($cliConfiguration->migrateConfiguration()) {
if ($configurationFile === false) {
$this->exitWithErrorMessage('No configuration file found to migrate');
}
$this->execute(new MigrateConfigurationCommand(realpath($configurationFile)));
}
if ($cliConfiguration->hasAtLeastVersion()) {
$this->execute(new AtLeastVersionCommand($cliConfiguration->atLeastVersion()));
}
if ($cliConfiguration->version()) {
$this->execute(new ShowVersionCommand);
}
if ($cliConfiguration->checkVersion()) {
$this->execute(new VersionCheckCommand);
}
if ($cliConfiguration->help()) {
$this->execute(new ShowHelpCommand(Result::SUCCESS));
}
}
private function executeCommandsThatRequireCliConfigurationAndTestSuite(CliConfiguration $cliConfiguration, TestSuite $testSuite): void
{
if ($cliConfiguration->listGroups()) {
$this->execute(new ListGroupsCommand($testSuite));
}
if ($cliConfiguration->listTests()) {
$this->execute(new ListTestsAsTextCommand($testSuite));
}
if ($cliConfiguration->hasListTestsXml()) {
$this->execute(
new ListTestsAsXmlCommand(
$cliConfiguration->listTestsXml(),
$testSuite,
),
);
}
}
private function executeCommandsThatRequireCompleteConfiguration(Configuration $configuration, CliConfiguration $cliConfiguration): void
{
if ($cliConfiguration->listSuites()) {
$this->execute(new ListTestSuitesCommand($configuration->testSuite()));
}
if ($cliConfiguration->warmCoverageCache()) {
$this->execute(new WarmCodeCoverageCacheCommand($configuration, CodeCoverageFilterRegistry::instance()));
}
}
private function executeHelpCommandWhenThereIsNothingElseToDo(Configuration $configuration, TestSuite $testSuite): void
{
if ($testSuite->isEmpty() && !$configuration->hasCliArguments() && $configuration->testSuite()->isEmpty()) {
$this->execute(new ShowHelpCommand(Result::FAILURE));
}
}
private function writeRuntimeInformation(Printer $printer, Configuration $configuration): void
{
$printer->print(Version::getVersionString() . PHP_EOL . PHP_EOL);
$runtime = 'PHP ' . PHP_VERSION;
if (CodeCoverage::instance()->isActive()) {
$runtime .= ' with ' . CodeCoverage::instance()->driver()->nameAndVersion();
}
$this->writeMessage($printer, 'Runtime', $runtime);
if ($configuration->hasConfigurationFile()) {
$this->writeMessage(
$printer,
'Configuration',
$configuration->configurationFile(),
);
}
}
/**
* @psalm-param ?list<string> $pharExtensions
*/
private function writePharExtensionInformation(Printer $printer, ?array $pharExtensions): void
{
if ($pharExtensions === null) {
return;
}
foreach ($pharExtensions as $extension) {
$this->writeMessage(
$printer,
'Extension',
$extension,
);
}
}
private function writeMessage(Printer $printer, string $type, string $message): void
{
$printer->print(
sprintf(
"%-15s%s\n",
$type . ':',
$message,
),
);
}
private function writeRandomSeedInformation(Printer $printer, Configuration $configuration): void
{
if ($configuration->executionOrder() === TestSuiteSorter::ORDER_RANDOMIZED) {
$this->writeMessage(
$printer,
'Random Seed',
(string) $configuration->randomOrderSeed(),
);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerLogfileWriters(Configuration $configuration): void
{
if ($configuration->hasLogEventsText()) {
if (is_file($configuration->logEventsText())) {
unlink($configuration->logEventsText());
}
EventFacade::instance()->registerTracer(
new EventLogger(
$configuration->logEventsText(),
false,
),
);
}
if ($configuration->hasLogEventsVerboseText()) {
if (is_file($configuration->logEventsVerboseText())) {
unlink($configuration->logEventsVerboseText());
}
EventFacade::instance()->registerTracer(
new EventLogger(
$configuration->logEventsVerboseText(),
true,
),
);
EventFacade::emitter()->exportObjects();
}
if ($configuration->hasLogfileJunit()) {
new JunitXmlLogger(
OutputFacade::printerFor($configuration->logfileJunit()),
EventFacade::instance(),
);
}
if ($configuration->hasLogfileTeamcity()) {
new TeamCityLogger(
DefaultPrinter::from(
$configuration->logfileTeamcity(),
),
EventFacade::instance(),
);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function testDoxResultCollector(Configuration $configuration): ?TestDoxResultCollector
{
if ($configuration->hasLogfileTestdoxHtml() ||
$configuration->hasLogfileTestdoxText() ||
$configuration->outputIsTestDox()) {
return new TestDoxResultCollector(EventFacade::instance());
}
return null;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function initializeTestResultCache(Configuration $configuration): ResultCache
{
if ($configuration->cacheResult()) {
$cache = new DefaultResultCache($configuration->testResultCacheFile());
new ResultCacheHandler($cache, EventFacade::instance());
return $cache;
}
return new NullResultCache;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function configureBaseline(Configuration $configuration): ?BaselineGenerator
{
if ($configuration->hasGenerateBaseline()) {
return new BaselineGenerator(
EventFacade::instance(),
$configuration->source(),
);
}
if ($configuration->source()->useBaseline()) {
/** @psalm-suppress MissingThrowsDocblock */
$baselineFile = $configuration->source()->baseline();
$baseline = null;
try {
$baseline = (new Reader)->read($baselineFile);
} catch (CannotLoadBaselineException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning($e->getMessage());
}
if ($baseline !== null) {
ErrorHandler::instance()->use($baseline);
}
}
return null;
}
/**
* @codeCoverageIgnore
*/
private function exitWithCrashMessage(Throwable $t): never
{
$message = $t->getMessage();
if (empty(trim($message))) {
$message = '(no message)';
}
printf(
'%s%sAn error occurred inside PHPUnit.%s%sMessage: %s',
PHP_EOL,
PHP_EOL,
PHP_EOL,
PHP_EOL,
$message,
);
$first = true;
if ($t->getPrevious()) {
$t = $t->getPrevious();
}
do {
printf(
'%s%s: %s:%d%s%s%s%s',
PHP_EOL,
$first ? 'Location' : 'Caused by',
$t->getFile(),
$t->getLine(),
PHP_EOL,
PHP_EOL,
$t->getTraceAsString(),
PHP_EOL,
);
$first = false;
} while ($t = $t->getPrevious());
exit(Result::CRASH);
}
private function exitWithErrorMessage(string $message): never
{
print Version::getVersionString() . PHP_EOL . PHP_EOL . $message . PHP_EOL;
exit(Result::EXCEPTION);
}
}
phpunit/src/TextUI/Configuration/Registry.php 0000644 00000006175 15243417753 0015360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function assert;
use function file_get_contents;
use function file_put_contents;
use function serialize;
use function unserialize;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* CLI options and XML configuration are static within a single PHPUnit process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Configuration $instance = null;
public static function saveTo(string $path): bool
{
$result = file_put_contents(
$path,
serialize(self::get()),
);
if ($result) {
return true;
}
return false;
}
/**
* This method is used by the "run test(s) in separate process" templates.
*
* @noinspection PhpUnused
*/
public static function loadFrom(string $path): void
{
self::$instance = unserialize(
file_get_contents($path),
[
'allowed_classes' => [
Configuration::class,
Php::class,
ConstantCollection::class,
Constant::class,
IniSettingCollection::class,
IniSetting::class,
VariableCollection::class,
Variable::class,
DirectoryCollection::class,
Directory::class,
FileCollection::class,
File::class,
FilterDirectoryCollection::class,
FilterDirectory::class,
TestDirectoryCollection::class,
TestDirectory::class,
TestFileCollection::class,
TestFile::class,
TestSuiteCollection::class,
TestSuite::class,
VersionComparisonOperator::class,
Source::class,
],
],
);
}
public static function get(): Configuration
{
assert(self::$instance instanceof Configuration);
return self::$instance;
}
/**
* @throws \PHPUnit\TextUI\XmlConfiguration\Exception
* @throws Exception
* @throws NoCustomCssFileException
*/
public static function init(CliConfiguration $cliConfiguration, XmlConfiguration $xmlConfiguration): Configuration
{
self::$instance = (new Merger)->merge($cliConfiguration, $xmlConfiguration);
EventFacade::emitter()->testRunnerConfigured(self::$instance);
return self::$instance;
}
}
phpunit/src/TextUI/Configuration/PhpHandler.php 0000644 00000007300 15243417753 0015564 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use const PATH_SEPARATOR;
use function constant;
use function define;
use function defined;
use function getenv;
use function implode;
use function ini_get;
use function ini_set;
use function putenv;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhpHandler
{
public function handle(Php $configuration): void
{
$this->handleIncludePaths($configuration->includePaths());
$this->handleIniSettings($configuration->iniSettings());
$this->handleConstants($configuration->constants());
$this->handleGlobalVariables($configuration->globalVariables());
$this->handleServerVariables($configuration->serverVariables());
$this->handleEnvVariables($configuration->envVariables());
$this->handleVariables('_POST', $configuration->postVariables());
$this->handleVariables('_GET', $configuration->getVariables());
$this->handleVariables('_COOKIE', $configuration->cookieVariables());
$this->handleVariables('_FILES', $configuration->filesVariables());
$this->handleVariables('_REQUEST', $configuration->requestVariables());
}
private function handleIncludePaths(DirectoryCollection $includePaths): void
{
if (!$includePaths->isEmpty()) {
$includePathsAsStrings = [];
foreach ($includePaths as $includePath) {
$includePathsAsStrings[] = $includePath->path();
}
ini_set(
'include_path',
implode(PATH_SEPARATOR, $includePathsAsStrings) .
PATH_SEPARATOR .
ini_get('include_path'),
);
}
}
private function handleIniSettings(IniSettingCollection $iniSettings): void
{
foreach ($iniSettings as $iniSetting) {
$value = $iniSetting->value();
if (defined($value)) {
$value = (string) constant($value);
}
ini_set($iniSetting->name(), $value);
}
}
private function handleConstants(ConstantCollection $constants): void
{
foreach ($constants as $constant) {
if (!defined($constant->name())) {
define($constant->name(), $constant->value());
}
}
}
private function handleGlobalVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$GLOBALS[$variable->name()] = $variable->value();
}
}
private function handleServerVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$_SERVER[$variable->name()] = $variable->value();
}
}
private function handleVariables(string $target, VariableCollection $variables): void
{
foreach ($variables as $variable) {
$GLOBALS[$target][$variable->name()] = $variable->value();
}
}
private function handleEnvVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$name = $variable->name();
$value = $variable->value();
$force = $variable->force();
if ($force || getenv($name) === false) {
putenv("{$name}={$value}");
}
$value = getenv($name);
if ($force || !isset($_ENV[$name])) {
$_ENV[$name] = $value;
}
}
}
}
phpunit/src/TextUI/Configuration/Builder.php 0000644 00000003303 15243417753 0015124 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\TextUI\CliArguments\Builder as CliConfigurationBuilder;
use PHPUnit\TextUI\CliArguments\Exception as CliConfigurationException;
use PHPUnit\TextUI\CliArguments\XmlConfigurationFileFinder;
use PHPUnit\TextUI\XmlConfiguration\DefaultConfiguration;
use PHPUnit\TextUI\XmlConfiguration\Exception as XmlConfigurationException;
use PHPUnit\TextUI\XmlConfiguration\Loader;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class Builder
{
/**
* @throws ConfigurationCannotBeBuiltException
*/
public function build(array $argv): Configuration
{
try {
$cliConfiguration = (new CliConfigurationBuilder)->fromParameters($argv);
$configurationFile = (new XmlConfigurationFileFinder)->find($cliConfiguration);
$xmlConfiguration = DefaultConfiguration::create();
if ($configurationFile !== false) {
$xmlConfiguration = (new Loader)->load($configurationFile);
}
return Registry::init(
$cliConfiguration,
$xmlConfiguration,
);
} catch (CliConfigurationException|XmlConfigurationException $e) {
throw new ConfigurationCannotBeBuiltException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
}
phpunit/src/TextUI/Configuration/Cli/Builder.php 0000644 00000067535 15243417753 0015654 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use function array_map;
use function basename;
use function explode;
use function getcwd;
use function is_file;
use function is_numeric;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Util\Filesystem;
use SebastianBergmann\CliParser\Exception as CliParserException;
use SebastianBergmann\CliParser\Parser as CliParser;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Builder
{
private const LONG_OPTIONS = [
'atleast-version=',
'bootstrap=',
'cache-result',
'do-not-cache-result',
'cache-directory=',
'cache-result-file=',
'check-version',
'colors==',
'columns=',
'configuration=',
'coverage-cache=',
'warm-coverage-cache',
'coverage-filter=',
'coverage-clover=',
'coverage-cobertura=',
'coverage-crap4j=',
'coverage-html=',
'coverage-php=',
'coverage-text==',
'coverage-xml=',
'path-coverage',
'disallow-test-output',
'display-incomplete',
'display-skipped',
'display-deprecations',
'display-errors',
'display-notices',
'display-warnings',
'default-time-limit=',
'enforce-time-limit',
'exclude-group=',
'filter=',
'generate-baseline=',
'use-baseline=',
'ignore-baseline',
'generate-configuration',
'globals-backup',
'group=',
'covers=',
'uses=',
'help',
'resolve-dependencies',
'ignore-dependencies',
'include-path=',
'list-groups',
'list-suites',
'list-tests',
'list-tests-xml=',
'log-junit=',
'log-teamcity=',
'migrate-configuration',
'no-configuration',
'no-coverage',
'no-logging',
'no-extensions',
'no-output',
'no-progress',
'no-results',
'order-by=',
'process-isolation',
'dont-report-useless-tests',
'random-order',
'random-order-seed=',
'reverse-order',
'reverse-list',
'static-backup',
'stderr',
'fail-on-deprecation',
'fail-on-empty-test-suite',
'fail-on-incomplete',
'fail-on-notice',
'fail-on-risky',
'fail-on-skipped',
'fail-on-warning',
'stop-on-defect',
'stop-on-deprecation',
'stop-on-error',
'stop-on-failure',
'stop-on-incomplete',
'stop-on-notice',
'stop-on-risky',
'stop-on-skipped',
'stop-on-warning',
'strict-coverage',
'disable-coverage-ignore',
'strict-global-state',
'teamcity',
'testdox',
'testdox-html=',
'testdox-text=',
'test-suffix=',
'testsuite=',
'exclude-testsuite=',
'log-events-text=',
'log-events-verbose-text=',
'version',
'debug',
];
private const SHORT_OPTIONS = 'd:c:h';
/**
* @psalm-var array<string, non-negative-int>
*/
private array $processed = [];
/**
* @throws Exception
*/
public function fromParameters(array $parameters): Configuration
{
try {
$options = (new CliParser)->parse(
$parameters,
self::SHORT_OPTIONS,
self::LONG_OPTIONS,
);
} catch (CliParserException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$atLeastVersion = null;
$backupGlobals = null;
$backupStaticProperties = null;
$beStrictAboutChangesToGlobalState = null;
$bootstrap = null;
$cacheDirectory = null;
$cacheResult = null;
$cacheResultFile = null;
$checkVersion = false;
$colors = null;
$columns = null;
$configuration = null;
$coverageCacheDirectory = null;
$warmCoverageCache = false;
$coverageFilter = null;
$coverageClover = null;
$coverageCobertura = null;
$coverageCrap4J = null;
$coverageHtml = null;
$coveragePhp = null;
$coverageText = null;
$coverageTextShowUncoveredFiles = null;
$coverageTextShowOnlySummary = null;
$coverageXml = null;
$pathCoverage = null;
$defaultTimeLimit = null;
$disableCodeCoverageIgnore = null;
$disallowTestOutput = null;
$displayIncomplete = null;
$displaySkipped = null;
$displayDeprecations = null;
$displayErrors = null;
$displayNotices = null;
$displayWarnings = null;
$enforceTimeLimit = null;
$excludeGroups = null;
$executionOrder = null;
$executionOrderDefects = null;
$failOnDeprecation = null;
$failOnEmptyTestSuite = null;
$failOnIncomplete = null;
$failOnNotice = null;
$failOnRisky = null;
$failOnSkipped = null;
$failOnWarning = null;
$stopOnDefect = null;
$stopOnDeprecation = null;
$stopOnError = null;
$stopOnFailure = null;
$stopOnIncomplete = null;
$stopOnNotice = null;
$stopOnRisky = null;
$stopOnSkipped = null;
$stopOnWarning = null;
$filter = null;
$generateBaseline = null;
$useBaseline = null;
$ignoreBaseline = false;
$generateConfiguration = false;
$migrateConfiguration = false;
$groups = null;
$testsCovering = null;
$testsUsing = null;
$help = false;
$includePath = null;
$iniSettings = [];
$junitLogfile = null;
$listGroups = false;
$listSuites = false;
$listTests = false;
$listTestsXml = null;
$noCoverage = null;
$noExtensions = null;
$noOutput = null;
$noProgress = null;
$noResults = null;
$noLogging = null;
$processIsolation = null;
$randomOrderSeed = null;
$reportUselessTests = null;
$resolveDependencies = null;
$reverseList = null;
$stderr = null;
$strictCoverage = null;
$teamcityLogfile = null;
$testdoxHtmlFile = null;
$testdoxTextFile = null;
$testSuffixes = null;
$testSuite = null;
$excludeTestSuite = null;
$useDefaultConfiguration = true;
$version = false;
$logEventsText = null;
$logEventsVerboseText = null;
$printerTeamCity = null;
$printerTestDox = null;
$debug = false;
foreach ($options[0] as $option) {
$optionAllowedMultipleTimes = false;
switch ($option[0]) {
case '--colors':
$colors = $option[1] ?: \PHPUnit\TextUI\Configuration\Configuration::COLOR_AUTO;
break;
case '--bootstrap':
$bootstrap = $option[1];
break;
case '--cache-directory':
$cacheDirectory = $option[1];
break;
case '--cache-result':
$cacheResult = true;
break;
case '--do-not-cache-result':
$cacheResult = false;
break;
case '--cache-result-file':
$cacheResultFile = $option[1];
break;
case '--columns':
if (is_numeric($option[1])) {
$columns = (int) $option[1];
} elseif ($option[1] === 'max') {
$columns = 'max';
}
break;
case 'c':
case '--configuration':
$configuration = $option[1];
break;
case '--coverage-cache':
$coverageCacheDirectory = $option[1];
break;
case '--warm-coverage-cache':
$warmCoverageCache = true;
break;
case '--coverage-clover':
$coverageClover = $option[1];
break;
case '--coverage-cobertura':
$coverageCobertura = $option[1];
break;
case '--coverage-crap4j':
$coverageCrap4J = $option[1];
break;
case '--coverage-html':
$coverageHtml = $option[1];
break;
case '--coverage-php':
$coveragePhp = $option[1];
break;
case '--coverage-text':
if ($option[1] === null) {
$option[1] = 'php://stdout';
}
$coverageText = $option[1];
$coverageTextShowUncoveredFiles = false;
$coverageTextShowOnlySummary = false;
break;
case '--coverage-xml':
$coverageXml = $option[1];
break;
case '--path-coverage':
$pathCoverage = true;
break;
case 'd':
$tmp = explode('=', $option[1]);
if (isset($tmp[0])) {
if (isset($tmp[1])) {
$iniSettings[$tmp[0]] = $tmp[1];
} else {
$iniSettings[$tmp[0]] = '1';
}
}
$optionAllowedMultipleTimes = true;
break;
case 'h':
case '--help':
$help = true;
break;
case '--filter':
$filter = $option[1];
break;
case '--testsuite':
$testSuite = $option[1];
break;
case '--exclude-testsuite':
$excludeTestSuite = $option[1];
break;
case '--generate-baseline':
$generateBaseline = $option[1];
if (basename($generateBaseline) === $generateBaseline) {
$generateBaseline = getcwd() . DIRECTORY_SEPARATOR . $generateBaseline;
}
break;
case '--use-baseline':
$useBaseline = $option[1];
if (basename($useBaseline) === $useBaseline && !is_file($useBaseline)) {
$useBaseline = getcwd() . DIRECTORY_SEPARATOR . $useBaseline;
}
break;
case '--ignore-baseline':
$ignoreBaseline = true;
break;
case '--generate-configuration':
$generateConfiguration = true;
break;
case '--migrate-configuration':
$migrateConfiguration = true;
break;
case '--group':
$groups = explode(',', $option[1]);
break;
case '--exclude-group':
$excludeGroups = explode(',', $option[1]);
break;
case '--covers':
$testsCovering = array_map('strtolower', explode(',', $option[1]));
break;
case '--uses':
$testsUsing = array_map('strtolower', explode(',', $option[1]));
break;
case '--test-suffix':
$testSuffixes = explode(',', $option[1]);
break;
case '--include-path':
$includePath = $option[1];
break;
case '--list-groups':
$listGroups = true;
break;
case '--list-suites':
$listSuites = true;
break;
case '--list-tests':
$listTests = true;
break;
case '--list-tests-xml':
$listTestsXml = $option[1];
break;
case '--log-junit':
$junitLogfile = $option[1];
break;
case '--log-teamcity':
$teamcityLogfile = $option[1];
break;
case '--order-by':
foreach (explode(',', $option[1]) as $order) {
switch ($order) {
case 'default':
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$executionOrderDefects = TestSuiteSorter::ORDER_DEFAULT;
$resolveDependencies = true;
break;
case 'defects':
$executionOrderDefects = TestSuiteSorter::ORDER_DEFECTS_FIRST;
break;
case 'depends':
$resolveDependencies = true;
break;
case 'duration':
$executionOrder = TestSuiteSorter::ORDER_DURATION;
break;
case 'no-depends':
$resolveDependencies = false;
break;
case 'random':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case 'reverse':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case 'size':
$executionOrder = TestSuiteSorter::ORDER_SIZE;
break;
default:
throw new Exception(
sprintf(
'unrecognized --order-by option: %s',
$order,
),
);
}
}
break;
case '--process-isolation':
$processIsolation = true;
break;
case '--stderr':
$stderr = true;
break;
case '--fail-on-deprecation':
$failOnDeprecation = true;
break;
case '--fail-on-empty-test-suite':
$failOnEmptyTestSuite = true;
break;
case '--fail-on-incomplete':
$failOnIncomplete = true;
break;
case '--fail-on-notice':
$failOnNotice = true;
break;
case '--fail-on-risky':
$failOnRisky = true;
break;
case '--fail-on-skipped':
$failOnSkipped = true;
break;
case '--fail-on-warning':
$failOnWarning = true;
break;
case '--stop-on-defect':
$stopOnDefect = true;
break;
case '--stop-on-deprecation':
$stopOnDeprecation = true;
break;
case '--stop-on-error':
$stopOnError = true;
break;
case '--stop-on-failure':
$stopOnFailure = true;
break;
case '--stop-on-incomplete':
$stopOnIncomplete = true;
break;
case '--stop-on-notice':
$stopOnNotice = true;
break;
case '--stop-on-risky':
$stopOnRisky = true;
break;
case '--stop-on-skipped':
$stopOnSkipped = true;
break;
case '--stop-on-warning':
$stopOnWarning = true;
break;
case '--teamcity':
$printerTeamCity = true;
break;
case '--testdox':
$printerTestDox = true;
break;
case '--testdox-html':
$testdoxHtmlFile = $option[1];
break;
case '--testdox-text':
$testdoxTextFile = $option[1];
break;
case '--no-configuration':
$useDefaultConfiguration = false;
break;
case '--no-extensions':
$noExtensions = true;
break;
case '--no-coverage':
$noCoverage = true;
break;
case '--no-logging':
$noLogging = true;
break;
case '--no-output':
$noOutput = true;
break;
case '--no-progress':
$noProgress = true;
break;
case '--no-results':
$noResults = true;
break;
case '--globals-backup':
$backupGlobals = true;
break;
case '--static-backup':
$backupStaticProperties = true;
break;
case '--atleast-version':
$atLeastVersion = $option[1];
break;
case '--version':
$version = true;
break;
case '--dont-report-useless-tests':
$reportUselessTests = false;
break;
case '--strict-coverage':
$strictCoverage = true;
break;
case '--disable-coverage-ignore':
$disableCodeCoverageIgnore = true;
break;
case '--strict-global-state':
$beStrictAboutChangesToGlobalState = true;
break;
case '--disallow-test-output':
$disallowTestOutput = true;
break;
case '--display-incomplete':
$displayIncomplete = true;
break;
case '--display-skipped':
$displaySkipped = true;
break;
case '--display-deprecations':
$displayDeprecations = true;
break;
case '--display-errors':
$displayErrors = true;
break;
case '--display-notices':
$displayNotices = true;
break;
case '--display-warnings':
$displayWarnings = true;
break;
case '--default-time-limit':
$defaultTimeLimit = (int) $option[1];
break;
case '--enforce-time-limit':
$enforceTimeLimit = true;
break;
case '--reverse-list':
$reverseList = true;
break;
case '--check-version':
$checkVersion = true;
break;
case '--coverage-filter':
if ($coverageFilter === null) {
$coverageFilter = [];
}
$coverageFilter[] = $option[1];
break;
case '--random-order':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case '--random-order-seed':
$randomOrderSeed = (int) $option[1];
break;
case '--resolve-dependencies':
$resolveDependencies = true;
break;
case '--ignore-dependencies':
$resolveDependencies = false;
break;
case '--reverse-order':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case '--log-events-text':
$logEventsText = Filesystem::resolveStreamOrFile($option[1]);
if ($logEventsText === false) {
throw new Exception(
sprintf(
'The path "%s" specified for the --log-events-text option could not be resolved',
$option[1],
),
);
}
break;
case '--log-events-verbose-text':
$logEventsVerboseText = Filesystem::resolveStreamOrFile($option[1]);
if ($logEventsVerboseText === false) {
throw new Exception(
sprintf(
'The path "%s" specified for the --log-events-verbose-text option could not be resolved',
$option[1],
),
);
}
break;
case '--debug':
$debug = true;
break;
}
if (!$optionAllowedMultipleTimes) {
$this->markProcessed($option[0]);
}
}
if (empty($iniSettings)) {
$iniSettings = null;
}
if (empty($coverageFilter)) {
$coverageFilter = null;
}
return new Configuration(
$options[1],
$atLeastVersion,
$backupGlobals,
$backupStaticProperties,
$beStrictAboutChangesToGlobalState,
$bootstrap,
$cacheDirectory,
$cacheResult,
$cacheResultFile,
$checkVersion,
$colors,
$columns,
$configuration,
$coverageClover,
$coverageCobertura,
$coverageCrap4J,
$coverageHtml,
$coveragePhp,
$coverageText,
$coverageTextShowUncoveredFiles,
$coverageTextShowOnlySummary,
$coverageXml,
$pathCoverage,
$coverageCacheDirectory,
$warmCoverageCache,
$defaultTimeLimit,
$disableCodeCoverageIgnore,
$disallowTestOutput,
$enforceTimeLimit,
$excludeGroups,
$executionOrder,
$executionOrderDefects,
$failOnDeprecation,
$failOnEmptyTestSuite,
$failOnIncomplete,
$failOnNotice,
$failOnRisky,
$failOnSkipped,
$failOnWarning,
$stopOnDefect,
$stopOnDeprecation,
$stopOnError,
$stopOnFailure,
$stopOnIncomplete,
$stopOnNotice,
$stopOnRisky,
$stopOnSkipped,
$stopOnWarning,
$filter,
$generateBaseline,
$useBaseline,
$ignoreBaseline,
$generateConfiguration,
$migrateConfiguration,
$groups,
$testsCovering,
$testsUsing,
$help,
$includePath,
$iniSettings,
$junitLogfile,
$listGroups,
$listSuites,
$listTests,
$listTestsXml,
$noCoverage,
$noExtensions,
$noOutput,
$noProgress,
$noResults,
$noLogging,
$processIsolation,
$randomOrderSeed,
$reportUselessTests,
$resolveDependencies,
$reverseList,
$stderr,
$strictCoverage,
$teamcityLogfile,
$testdoxHtmlFile,
$testdoxTextFile,
$testSuffixes,
$testSuite,
$excludeTestSuite,
$useDefaultConfiguration,
$displayIncomplete,
$displaySkipped,
$displayDeprecations,
$displayErrors,
$displayNotices,
$displayWarnings,
$version,
$coverageFilter,
$logEventsText,
$logEventsVerboseText,
$printerTeamCity,
$printerTestDox,
$debug,
);
}
/**
* @psalm-param non-empty-string $option
*/
private function markProcessed(string $option): void
{
if (!isset($this->processed[$option])) {
$this->processed[$option] = 1;
return;
}
$this->processed[$option]++;
if ($this->processed[$option] === 2) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Option %s cannot be used more than once',
$option,
),
);
}
}
}
phpunit/src/TextUI/Configuration/Cli/Configuration.php 0000644 00000145325 15243417753 0017067 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Configuration
{
/**
* @psalm-var list<non-empty-string>
*/
private readonly array $arguments;
private readonly ?string $atLeastVersion;
private readonly ?bool $backupGlobals;
private readonly ?bool $backupStaticProperties;
private readonly ?bool $beStrictAboutChangesToGlobalState;
private readonly ?string $bootstrap;
private readonly ?string $cacheDirectory;
private readonly ?bool $cacheResult;
private readonly ?string $cacheResultFile;
private readonly bool $checkVersion;
private readonly ?string $colors;
private readonly null|int|string $columns;
private readonly ?string $configurationFile;
private readonly ?array $coverageFilter;
private readonly ?string $coverageClover;
private readonly ?string $coverageCobertura;
private readonly ?string $coverageCrap4J;
private readonly ?string $coverageHtml;
private readonly ?string $coveragePhp;
private readonly ?string $coverageText;
private readonly ?bool $coverageTextShowUncoveredFiles;
private readonly ?bool $coverageTextShowOnlySummary;
private readonly ?string $coverageXml;
private readonly ?bool $pathCoverage;
private readonly ?string $coverageCacheDirectory;
private readonly bool $warmCoverageCache;
private readonly ?int $defaultTimeLimit;
private readonly ?bool $disableCodeCoverageIgnore;
private readonly ?bool $disallowTestOutput;
private readonly ?bool $enforceTimeLimit;
private readonly ?array $excludeGroups;
private readonly ?int $executionOrder;
private readonly ?int $executionOrderDefects;
private readonly ?bool $failOnDeprecation;
private readonly ?bool $failOnEmptyTestSuite;
private readonly ?bool $failOnIncomplete;
private readonly ?bool $failOnNotice;
private readonly ?bool $failOnRisky;
private readonly ?bool $failOnSkipped;
private readonly ?bool $failOnWarning;
private readonly ?bool $stopOnDefect;
private readonly ?bool $stopOnDeprecation;
private readonly ?bool $stopOnError;
private readonly ?bool $stopOnFailure;
private readonly ?bool $stopOnIncomplete;
private readonly ?bool $stopOnNotice;
private readonly ?bool $stopOnRisky;
private readonly ?bool $stopOnSkipped;
private readonly ?bool $stopOnWarning;
private readonly ?string $filter;
private readonly ?string $generateBaseline;
private readonly ?string $useBaseline;
private readonly bool $ignoreBaseline;
private readonly bool $generateConfiguration;
private readonly bool $migrateConfiguration;
private readonly ?array $groups;
private readonly ?array $testsCovering;
private readonly ?array $testsUsing;
private readonly bool $help;
private readonly ?string $includePath;
private readonly ?array $iniSettings;
private readonly ?string $junitLogfile;
private readonly bool $listGroups;
private readonly bool $listSuites;
private readonly bool $listTests;
private readonly ?string $listTestsXml;
private readonly ?bool $noCoverage;
private readonly ?bool $noExtensions;
private readonly ?bool $noOutput;
private readonly ?bool $noProgress;
private readonly ?bool $noResults;
private readonly ?bool $noLogging;
private readonly ?bool $processIsolation;
private readonly ?int $randomOrderSeed;
private readonly ?bool $reportUselessTests;
private readonly ?bool $resolveDependencies;
private readonly ?bool $reverseList;
private readonly ?bool $stderr;
private readonly ?bool $strictCoverage;
private readonly ?string $teamcityLogfile;
private readonly ?bool $teamCityPrinter;
private readonly ?string $testdoxHtmlFile;
private readonly ?string $testdoxTextFile;
private readonly ?bool $testdoxPrinter;
/**
* @psalm-var ?non-empty-list<non-empty-string>
*/
private readonly ?array $testSuffixes;
private readonly ?string $testSuite;
private readonly ?string $excludeTestSuite;
private readonly bool $useDefaultConfiguration;
private readonly ?bool $displayDetailsOnIncompleteTests;
private readonly ?bool $displayDetailsOnSkippedTests;
private readonly ?bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly ?bool $displayDetailsOnTestsThatTriggerErrors;
private readonly ?bool $displayDetailsOnTestsThatTriggerNotices;
private readonly ?bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $version;
private readonly ?string $logEventsText;
private readonly ?string $logEventsVerboseText;
private readonly bool $debug;
/**
* @psalm-param list<non-empty-string> $arguments
* @psalm-param ?non-empty-list<non-empty-string> $testSuffixes
*/
public function __construct(array $arguments, ?string $atLeastVersion, ?bool $backupGlobals, ?bool $backupStaticProperties, ?bool $beStrictAboutChangesToGlobalState, ?string $bootstrap, ?string $cacheDirectory, ?bool $cacheResult, ?string $cacheResultFile, bool $checkVersion, ?string $colors, null|int|string $columns, ?string $configurationFile, ?string $coverageClover, ?string $coverageCobertura, ?string $coverageCrap4J, ?string $coverageHtml, ?string $coveragePhp, ?string $coverageText, ?bool $coverageTextShowUncoveredFiles, ?bool $coverageTextShowOnlySummary, ?string $coverageXml, ?bool $pathCoverage, ?string $coverageCacheDirectory, bool $warmCoverageCache, ?int $defaultTimeLimit, ?bool $disableCodeCoverageIgnore, ?bool $disallowTestOutput, ?bool $enforceTimeLimit, ?array $excludeGroups, ?int $executionOrder, ?int $executionOrderDefects, ?bool $failOnDeprecation, ?bool $failOnEmptyTestSuite, ?bool $failOnIncomplete, ?bool $failOnNotice, ?bool $failOnRisky, ?bool $failOnSkipped, ?bool $failOnWarning, ?bool $stopOnDefect, ?bool $stopOnDeprecation, ?bool $stopOnError, ?bool $stopOnFailure, ?bool $stopOnIncomplete, ?bool $stopOnNotice, ?bool $stopOnRisky, ?bool $stopOnSkipped, ?bool $stopOnWarning, ?string $filter, ?string $generateBaseline, ?string $useBaseline, bool $ignoreBaseline, bool $generateConfiguration, bool $migrateConfiguration, ?array $groups, ?array $testsCovering, ?array $testsUsing, bool $help, ?string $includePath, ?array $iniSettings, ?string $junitLogfile, bool $listGroups, bool $listSuites, bool $listTests, ?string $listTestsXml, ?bool $noCoverage, ?bool $noExtensions, ?bool $noOutput, ?bool $noProgress, ?bool $noResults, ?bool $noLogging, ?bool $processIsolation, ?int $randomOrderSeed, ?bool $reportUselessTests, ?bool $resolveDependencies, ?bool $reverseList, ?bool $stderr, ?bool $strictCoverage, ?string $teamcityLogfile, ?string $testdoxHtmlFile, ?string $testdoxTextFile, ?array $testSuffixes, ?string $testSuite, ?string $excludeTestSuite, bool $useDefaultConfiguration, ?bool $displayDetailsOnIncompleteTests, ?bool $displayDetailsOnSkippedTests, ?bool $displayDetailsOnTestsThatTriggerDeprecations, ?bool $displayDetailsOnTestsThatTriggerErrors, ?bool $displayDetailsOnTestsThatTriggerNotices, ?bool $displayDetailsOnTestsThatTriggerWarnings, bool $version, ?array $coverageFilter, ?string $logEventsText, ?string $logEventsVerboseText, ?bool $printerTeamCity, ?bool $printerTestDox, bool $debug)
{
$this->arguments = $arguments;
$this->atLeastVersion = $atLeastVersion;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->bootstrap = $bootstrap;
$this->cacheDirectory = $cacheDirectory;
$this->cacheResult = $cacheResult;
$this->cacheResultFile = $cacheResultFile;
$this->checkVersion = $checkVersion;
$this->colors = $colors;
$this->columns = $columns;
$this->configurationFile = $configurationFile;
$this->coverageFilter = $coverageFilter;
$this->coverageClover = $coverageClover;
$this->coverageCobertura = $coverageCobertura;
$this->coverageCrap4J = $coverageCrap4J;
$this->coverageHtml = $coverageHtml;
$this->coveragePhp = $coveragePhp;
$this->coverageText = $coverageText;
$this->coverageTextShowUncoveredFiles = $coverageTextShowUncoveredFiles;
$this->coverageTextShowOnlySummary = $coverageTextShowOnlySummary;
$this->coverageXml = $coverageXml;
$this->pathCoverage = $pathCoverage;
$this->coverageCacheDirectory = $coverageCacheDirectory;
$this->warmCoverageCache = $warmCoverageCache;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->disallowTestOutput = $disallowTestOutput;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->excludeGroups = $excludeGroups;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->filter = $filter;
$this->generateBaseline = $generateBaseline;
$this->useBaseline = $useBaseline;
$this->ignoreBaseline = $ignoreBaseline;
$this->generateConfiguration = $generateConfiguration;
$this->migrateConfiguration = $migrateConfiguration;
$this->groups = $groups;
$this->testsCovering = $testsCovering;
$this->testsUsing = $testsUsing;
$this->help = $help;
$this->includePath = $includePath;
$this->iniSettings = $iniSettings;
$this->junitLogfile = $junitLogfile;
$this->listGroups = $listGroups;
$this->listSuites = $listSuites;
$this->listTests = $listTests;
$this->listTestsXml = $listTestsXml;
$this->noCoverage = $noCoverage;
$this->noExtensions = $noExtensions;
$this->noOutput = $noOutput;
$this->noProgress = $noProgress;
$this->noResults = $noResults;
$this->noLogging = $noLogging;
$this->processIsolation = $processIsolation;
$this->randomOrderSeed = $randomOrderSeed;
$this->reportUselessTests = $reportUselessTests;
$this->resolveDependencies = $resolveDependencies;
$this->reverseList = $reverseList;
$this->stderr = $stderr;
$this->strictCoverage = $strictCoverage;
$this->teamcityLogfile = $teamcityLogfile;
$this->testdoxHtmlFile = $testdoxHtmlFile;
$this->testdoxTextFile = $testdoxTextFile;
$this->testSuffixes = $testSuffixes;
$this->testSuite = $testSuite;
$this->excludeTestSuite = $excludeTestSuite;
$this->useDefaultConfiguration = $useDefaultConfiguration;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->version = $version;
$this->logEventsText = $logEventsText;
$this->logEventsVerboseText = $logEventsVerboseText;
$this->teamCityPrinter = $printerTeamCity;
$this->testdoxPrinter = $printerTestDox;
$this->debug = $debug;
}
/**
* @psalm-return list<non-empty-string>
*/
public function arguments(): array
{
return $this->arguments;
}
/**
* @psalm-assert-if-true !null $this->atLeastVersion
*/
public function hasAtLeastVersion(): bool
{
return $this->atLeastVersion !== null;
}
/**
* @throws Exception
*/
public function atLeastVersion(): string
{
if (!$this->hasAtLeastVersion()) {
throw new Exception;
}
return $this->atLeastVersion;
}
/**
* @psalm-assert-if-true !null $this->backupGlobals
*/
public function hasBackupGlobals(): bool
{
return $this->backupGlobals !== null;
}
/**
* @throws Exception
*/
public function backupGlobals(): bool
{
if (!$this->hasBackupGlobals()) {
throw new Exception;
}
return $this->backupGlobals;
}
/**
* @psalm-assert-if-true !null $this->backupStaticProperties
*/
public function hasBackupStaticProperties(): bool
{
return $this->backupStaticProperties !== null;
}
/**
* @throws Exception
*/
public function backupStaticProperties(): bool
{
if (!$this->hasBackupStaticProperties()) {
throw new Exception;
}
return $this->backupStaticProperties;
}
/**
* @psalm-assert-if-true !null $this->beStrictAboutChangesToGlobalState
*/
public function hasBeStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState !== null;
}
/**
* @throws Exception
*/
public function beStrictAboutChangesToGlobalState(): bool
{
if (!$this->hasBeStrictAboutChangesToGlobalState()) {
throw new Exception;
}
return $this->beStrictAboutChangesToGlobalState;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws Exception
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new Exception;
}
return $this->bootstrap;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new Exception;
}
return $this->cacheDirectory;
}
/**
* @psalm-assert-if-true !null $this->cacheResult
*/
public function hasCacheResult(): bool
{
return $this->cacheResult !== null;
}
/**
* @throws Exception
*/
public function cacheResult(): bool
{
if (!$this->hasCacheResult()) {
throw new Exception;
}
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheResultFile
*
* @deprecated
*/
public function hasCacheResultFile(): bool
{
return $this->cacheResultFile !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheResultFile(): string
{
if (!$this->hasCacheResultFile()) {
throw new Exception;
}
return $this->cacheResultFile;
}
public function checkVersion(): bool
{
return $this->checkVersion;
}
/**
* @psalm-assert-if-true !null $this->colors
*/
public function hasColors(): bool
{
return $this->colors !== null;
}
/**
* @throws Exception
*/
public function colors(): string
{
if (!$this->hasColors()) {
throw new Exception;
}
return $this->colors;
}
/**
* @psalm-assert-if-true !null $this->columns
*/
public function hasColumns(): bool
{
return $this->columns !== null;
}
/**
* @throws Exception
*/
public function columns(): int|string
{
if (!$this->hasColumns()) {
throw new Exception;
}
return $this->columns;
}
/**
* @psalm-assert-if-true !null $this->configurationFile
*/
public function hasConfigurationFile(): bool
{
return $this->configurationFile !== null;
}
/**
* @throws Exception
*/
public function configurationFile(): string
{
if (!$this->hasConfigurationFile()) {
throw new Exception;
}
return $this->configurationFile;
}
/**
* @psalm-assert-if-true !null $this->coverageFilter
*/
public function hasCoverageFilter(): bool
{
return $this->coverageFilter !== null;
}
/**
* @throws Exception
*/
public function coverageFilter(): array
{
if (!$this->hasCoverageFilter()) {
throw new Exception;
}
return $this->coverageFilter;
}
/**
* @psalm-assert-if-true !null $this->coverageClover
*/
public function hasCoverageClover(): bool
{
return $this->coverageClover !== null;
}
/**
* @throws Exception
*/
public function coverageClover(): string
{
if (!$this->hasCoverageClover()) {
throw new Exception;
}
return $this->coverageClover;
}
/**
* @psalm-assert-if-true !null $this->coverageCobertura
*/
public function hasCoverageCobertura(): bool
{
return $this->coverageCobertura !== null;
}
/**
* @throws Exception
*/
public function coverageCobertura(): string
{
if (!$this->hasCoverageCobertura()) {
throw new Exception;
}
return $this->coverageCobertura;
}
/**
* @psalm-assert-if-true !null $this->coverageCrap4J
*/
public function hasCoverageCrap4J(): bool
{
return $this->coverageCrap4J !== null;
}
/**
* @throws Exception
*/
public function coverageCrap4J(): string
{
if (!$this->hasCoverageCrap4J()) {
throw new Exception;
}
return $this->coverageCrap4J;
}
/**
* @psalm-assert-if-true !null $this->coverageHtml
*/
public function hasCoverageHtml(): bool
{
return $this->coverageHtml !== null;
}
/**
* @throws Exception
*/
public function coverageHtml(): string
{
if (!$this->hasCoverageHtml()) {
throw new Exception;
}
return $this->coverageHtml;
}
/**
* @psalm-assert-if-true !null $this->coveragePhp
*/
public function hasCoveragePhp(): bool
{
return $this->coveragePhp !== null;
}
/**
* @throws Exception
*/
public function coveragePhp(): string
{
if (!$this->hasCoveragePhp()) {
throw new Exception;
}
return $this->coveragePhp;
}
/**
* @psalm-assert-if-true !null $this->coverageText
*/
public function hasCoverageText(): bool
{
return $this->coverageText !== null;
}
/**
* @throws Exception
*/
public function coverageText(): string
{
if (!$this->hasCoverageText()) {
throw new Exception;
}
return $this->coverageText;
}
/**
* @psalm-assert-if-true !null $this->coverageTextShowUncoveredFiles
*/
public function hasCoverageTextShowUncoveredFiles(): bool
{
return $this->coverageTextShowUncoveredFiles !== null;
}
/**
* @throws Exception
*/
public function coverageTextShowUncoveredFiles(): bool
{
if (!$this->hasCoverageTextShowUncoveredFiles()) {
throw new Exception;
}
return $this->coverageTextShowUncoveredFiles;
}
/**
* @psalm-assert-if-true !null $this->coverageTextShowOnlySummary
*/
public function hasCoverageTextShowOnlySummary(): bool
{
return $this->coverageTextShowOnlySummary !== null;
}
/**
* @throws Exception
*/
public function coverageTextShowOnlySummary(): bool
{
if (!$this->hasCoverageTextShowOnlySummary()) {
throw new Exception;
}
return $this->coverageTextShowOnlySummary;
}
/**
* @psalm-assert-if-true !null $this->coverageXml
*/
public function hasCoverageXml(): bool
{
return $this->coverageXml !== null;
}
/**
* @throws Exception
*/
public function coverageXml(): string
{
if (!$this->hasCoverageXml()) {
throw new Exception;
}
return $this->coverageXml;
}
/**
* @psalm-assert-if-true !null $this->pathCoverage
*/
public function hasPathCoverage(): bool
{
return $this->pathCoverage !== null;
}
/**
* @throws Exception
*/
public function pathCoverage(): bool
{
if (!$this->hasPathCoverage()) {
throw new Exception;
}
return $this->pathCoverage;
}
/**
* @psalm-assert-if-true !null $this->coverageCacheDirectory
*
* @deprecated
*/
public function hasCoverageCacheDirectory(): bool
{
return $this->coverageCacheDirectory !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function coverageCacheDirectory(): string
{
if (!$this->hasCoverageCacheDirectory()) {
throw new Exception;
}
return $this->coverageCacheDirectory;
}
public function warmCoverageCache(): bool
{
return $this->warmCoverageCache;
}
/**
* @psalm-assert-if-true !null $this->defaultTimeLimit
*/
public function hasDefaultTimeLimit(): bool
{
return $this->defaultTimeLimit !== null;
}
/**
* @throws Exception
*/
public function defaultTimeLimit(): int
{
if (!$this->hasDefaultTimeLimit()) {
throw new Exception;
}
return $this->defaultTimeLimit;
}
/**
* @psalm-assert-if-true !null $this->disableCodeCoverageIgnore
*/
public function hasDisableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore !== null;
}
/**
* @throws Exception
*/
public function disableCodeCoverageIgnore(): bool
{
if (!$this->hasDisableCodeCoverageIgnore()) {
throw new Exception;
}
return $this->disableCodeCoverageIgnore;
}
/**
* @psalm-assert-if-true !null $this->disallowTestOutput
*/
public function hasDisallowTestOutput(): bool
{
return $this->disallowTestOutput !== null;
}
/**
* @throws Exception
*/
public function disallowTestOutput(): bool
{
if (!$this->hasDisallowTestOutput()) {
throw new Exception;
}
return $this->disallowTestOutput;
}
/**
* @psalm-assert-if-true !null $this->enforceTimeLimit
*/
public function hasEnforceTimeLimit(): bool
{
return $this->enforceTimeLimit !== null;
}
/**
* @throws Exception
*/
public function enforceTimeLimit(): bool
{
if (!$this->hasEnforceTimeLimit()) {
throw new Exception;
}
return $this->enforceTimeLimit;
}
/**
* @psalm-assert-if-true !null $this->excludeGroups
*/
public function hasExcludeGroups(): bool
{
return $this->excludeGroups !== null;
}
/**
* @throws Exception
*/
public function excludeGroups(): array
{
if (!$this->hasExcludeGroups()) {
throw new Exception;
}
return $this->excludeGroups;
}
/**
* @psalm-assert-if-true !null $this->executionOrder
*/
public function hasExecutionOrder(): bool
{
return $this->executionOrder !== null;
}
/**
* @throws Exception
*/
public function executionOrder(): int
{
if (!$this->hasExecutionOrder()) {
throw new Exception;
}
return $this->executionOrder;
}
/**
* @psalm-assert-if-true !null $this->executionOrderDefects
*/
public function hasExecutionOrderDefects(): bool
{
return $this->executionOrderDefects !== null;
}
/**
* @throws Exception
*/
public function executionOrderDefects(): int
{
if (!$this->hasExecutionOrderDefects()) {
throw new Exception;
}
return $this->executionOrderDefects;
}
/**
* @psalm-assert-if-true !null $this->failOnDeprecation
*/
public function hasFailOnDeprecation(): bool
{
return $this->failOnDeprecation !== null;
}
/**
* @throws Exception
*/
public function failOnDeprecation(): bool
{
if (!$this->hasFailOnDeprecation()) {
throw new Exception;
}
return $this->failOnDeprecation;
}
/**
* @psalm-assert-if-true !null $this->failOnEmptyTestSuite
*/
public function hasFailOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite !== null;
}
/**
* @throws Exception
*/
public function failOnEmptyTestSuite(): bool
{
if (!$this->hasFailOnEmptyTestSuite()) {
throw new Exception;
}
return $this->failOnEmptyTestSuite;
}
/**
* @psalm-assert-if-true !null $this->failOnIncomplete
*/
public function hasFailOnIncomplete(): bool
{
return $this->failOnIncomplete !== null;
}
/**
* @throws Exception
*/
public function failOnIncomplete(): bool
{
if (!$this->hasFailOnIncomplete()) {
throw new Exception;
}
return $this->failOnIncomplete;
}
/**
* @psalm-assert-if-true !null $this->failOnNotice
*/
public function hasFailOnNotice(): bool
{
return $this->failOnNotice !== null;
}
/**
* @throws Exception
*/
public function failOnNotice(): bool
{
if (!$this->hasFailOnNotice()) {
throw new Exception;
}
return $this->failOnNotice;
}
/**
* @psalm-assert-if-true !null $this->failOnRisky
*/
public function hasFailOnRisky(): bool
{
return $this->failOnRisky !== null;
}
/**
* @throws Exception
*/
public function failOnRisky(): bool
{
if (!$this->hasFailOnRisky()) {
throw new Exception;
}
return $this->failOnRisky;
}
/**
* @psalm-assert-if-true !null $this->failOnSkipped
*/
public function hasFailOnSkipped(): bool
{
return $this->failOnSkipped !== null;
}
/**
* @throws Exception
*/
public function failOnSkipped(): bool
{
if (!$this->hasFailOnSkipped()) {
throw new Exception;
}
return $this->failOnSkipped;
}
/**
* @psalm-assert-if-true !null $this->failOnWarning
*/
public function hasFailOnWarning(): bool
{
return $this->failOnWarning !== null;
}
/**
* @throws Exception
*/
public function failOnWarning(): bool
{
if (!$this->hasFailOnWarning()) {
throw new Exception;
}
return $this->failOnWarning;
}
/**
* @psalm-assert-if-true !null $this->stopOnDefect
*/
public function hasStopOnDefect(): bool
{
return $this->stopOnDefect !== null;
}
/**
* @throws Exception
*/
public function stopOnDefect(): bool
{
if (!$this->hasStopOnDefect()) {
throw new Exception;
}
return $this->stopOnDefect;
}
/**
* @psalm-assert-if-true !null $this->stopOnDeprecation
*/
public function hasStopOnDeprecation(): bool
{
return $this->stopOnDeprecation !== null;
}
/**
* @throws Exception
*/
public function stopOnDeprecation(): bool
{
if (!$this->hasStopOnDeprecation()) {
throw new Exception;
}
return $this->stopOnDeprecation;
}
/**
* @psalm-assert-if-true !null $this->stopOnError
*/
public function hasStopOnError(): bool
{
return $this->stopOnError !== null;
}
/**
* @throws Exception
*/
public function stopOnError(): bool
{
if (!$this->hasStopOnError()) {
throw new Exception;
}
return $this->stopOnError;
}
/**
* @psalm-assert-if-true !null $this->stopOnFailure
*/
public function hasStopOnFailure(): bool
{
return $this->stopOnFailure !== null;
}
/**
* @throws Exception
*/
public function stopOnFailure(): bool
{
if (!$this->hasStopOnFailure()) {
throw new Exception;
}
return $this->stopOnFailure;
}
/**
* @psalm-assert-if-true !null $this->stopOnIncomplete
*/
public function hasStopOnIncomplete(): bool
{
return $this->stopOnIncomplete !== null;
}
/**
* @throws Exception
*/
public function stopOnIncomplete(): bool
{
if (!$this->hasStopOnIncomplete()) {
throw new Exception;
}
return $this->stopOnIncomplete;
}
/**
* @psalm-assert-if-true !null $this->stopOnNotice
*/
public function hasStopOnNotice(): bool
{
return $this->stopOnNotice !== null;
}
/**
* @throws Exception
*/
public function stopOnNotice(): bool
{
if (!$this->hasStopOnNotice()) {
throw new Exception;
}
return $this->stopOnNotice;
}
/**
* @psalm-assert-if-true !null $this->stopOnRisky
*/
public function hasStopOnRisky(): bool
{
return $this->stopOnRisky !== null;
}
/**
* @throws Exception
*/
public function stopOnRisky(): bool
{
if (!$this->hasStopOnRisky()) {
throw new Exception;
}
return $this->stopOnRisky;
}
/**
* @psalm-assert-if-true !null $this->stopOnSkipped
*/
public function hasStopOnSkipped(): bool
{
return $this->stopOnSkipped !== null;
}
/**
* @throws Exception
*/
public function stopOnSkipped(): bool
{
if (!$this->hasStopOnSkipped()) {
throw new Exception;
}
return $this->stopOnSkipped;
}
/**
* @psalm-assert-if-true !null $this->stopOnWarning
*/
public function hasStopOnWarning(): bool
{
return $this->stopOnWarning !== null;
}
/**
* @throws Exception
*/
public function stopOnWarning(): bool
{
if (!$this->hasStopOnWarning()) {
throw new Exception;
}
return $this->stopOnWarning;
}
/**
* @psalm-assert-if-true !null $this->filter
*/
public function hasFilter(): bool
{
return $this->filter !== null;
}
/**
* @throws Exception
*/
public function filter(): string
{
if (!$this->hasFilter()) {
throw new Exception;
}
return $this->filter;
}
/**
* @psalm-assert-if-true !null $this->generateBaseline
*/
public function hasGenerateBaseline(): bool
{
return $this->generateBaseline !== null;
}
/**
* @throws Exception
*/
public function generateBaseline(): string
{
if (!$this->hasGenerateBaseline()) {
throw new Exception;
}
return $this->generateBaseline;
}
/**
* @psalm-assert-if-true !null $this->useBaseline
*/
public function hasUseBaseline(): bool
{
return $this->useBaseline !== null;
}
/**
* @throws Exception
*/
public function useBaseline(): string
{
if (!$this->hasUseBaseline()) {
throw new Exception;
}
return $this->useBaseline;
}
public function ignoreBaseline(): bool
{
return $this->ignoreBaseline;
}
public function generateConfiguration(): bool
{
return $this->generateConfiguration;
}
public function migrateConfiguration(): bool
{
return $this->migrateConfiguration;
}
/**
* @psalm-assert-if-true !null $this->groups
*/
public function hasGroups(): bool
{
return $this->groups !== null;
}
/**
* @throws Exception
*/
public function groups(): array
{
if (!$this->hasGroups()) {
throw new Exception;
}
return $this->groups;
}
/**
* @psalm-assert-if-true !null $this->testsCovering
*/
public function hasTestsCovering(): bool
{
return $this->testsCovering !== null;
}
/**
* @throws Exception
*/
public function testsCovering(): array
{
if (!$this->hasTestsCovering()) {
throw new Exception;
}
return $this->testsCovering;
}
/**
* @psalm-assert-if-true !null $this->testsUsing
*/
public function hasTestsUsing(): bool
{
return $this->testsUsing !== null;
}
/**
* @throws Exception
*/
public function testsUsing(): array
{
if (!$this->hasTestsUsing()) {
throw new Exception;
}
return $this->testsUsing;
}
public function help(): bool
{
return $this->help;
}
/**
* @psalm-assert-if-true !null $this->includePath
*/
public function hasIncludePath(): bool
{
return $this->includePath !== null;
}
/**
* @throws Exception
*/
public function includePath(): string
{
if (!$this->hasIncludePath()) {
throw new Exception;
}
return $this->includePath;
}
/**
* @psalm-assert-if-true !null $this->iniSettings
*/
public function hasIniSettings(): bool
{
return $this->iniSettings !== null;
}
/**
* @throws Exception
*/
public function iniSettings(): array
{
if (!$this->hasIniSettings()) {
throw new Exception;
}
return $this->iniSettings;
}
/**
* @psalm-assert-if-true !null $this->junitLogfile
*/
public function hasJunitLogfile(): bool
{
return $this->junitLogfile !== null;
}
/**
* @throws Exception
*/
public function junitLogfile(): string
{
if (!$this->hasJunitLogfile()) {
throw new Exception;
}
return $this->junitLogfile;
}
public function listGroups(): bool
{
return $this->listGroups;
}
public function listSuites(): bool
{
return $this->listSuites;
}
public function listTests(): bool
{
return $this->listTests;
}
/**
* @psalm-assert-if-true !null $this->listTestsXml
*/
public function hasListTestsXml(): bool
{
return $this->listTestsXml !== null;
}
/**
* @throws Exception
*/
public function listTestsXml(): string
{
if (!$this->hasListTestsXml()) {
throw new Exception;
}
return $this->listTestsXml;
}
/**
* @psalm-assert-if-true !null $this->noCoverage
*/
public function hasNoCoverage(): bool
{
return $this->noCoverage !== null;
}
/**
* @throws Exception
*/
public function noCoverage(): bool
{
if (!$this->hasNoCoverage()) {
throw new Exception;
}
return $this->noCoverage;
}
/**
* @psalm-assert-if-true !null $this->noExtensions
*/
public function hasNoExtensions(): bool
{
return $this->noExtensions !== null;
}
/**
* @throws Exception
*/
public function noExtensions(): bool
{
if (!$this->hasNoExtensions()) {
throw new Exception;
}
return $this->noExtensions;
}
/**
* @psalm-assert-if-true !null $this->noOutput
*/
public function hasNoOutput(): bool
{
return $this->noOutput !== null;
}
/**
* @throws Exception
*/
public function noOutput(): bool
{
if ($this->noOutput === null) {
throw new Exception;
}
return $this->noOutput;
}
/**
* @psalm-assert-if-true !null $this->noProgress
*/
public function hasNoProgress(): bool
{
return $this->noProgress !== null;
}
/**
* @throws Exception
*/
public function noProgress(): bool
{
if ($this->noProgress === null) {
throw new Exception;
}
return $this->noProgress;
}
/**
* @psalm-assert-if-true !null $this->noResults
*/
public function hasNoResults(): bool
{
return $this->noResults !== null;
}
/**
* @throws Exception
*/
public function noResults(): bool
{
if ($this->noResults === null) {
throw new Exception;
}
return $this->noResults;
}
/**
* @psalm-assert-if-true !null $this->noLogging
*/
public function hasNoLogging(): bool
{
return $this->noLogging !== null;
}
/**
* @throws Exception
*/
public function noLogging(): bool
{
if (!$this->hasNoLogging()) {
throw new Exception;
}
return $this->noLogging;
}
/**
* @psalm-assert-if-true !null $this->processIsolation
*/
public function hasProcessIsolation(): bool
{
return $this->processIsolation !== null;
}
/**
* @throws Exception
*/
public function processIsolation(): bool
{
if (!$this->hasProcessIsolation()) {
throw new Exception;
}
return $this->processIsolation;
}
/**
* @psalm-assert-if-true !null $this->randomOrderSeed
*/
public function hasRandomOrderSeed(): bool
{
return $this->randomOrderSeed !== null;
}
/**
* @throws Exception
*/
public function randomOrderSeed(): int
{
if (!$this->hasRandomOrderSeed()) {
throw new Exception;
}
return $this->randomOrderSeed;
}
/**
* @psalm-assert-if-true !null $this->reportUselessTests
*/
public function hasReportUselessTests(): bool
{
return $this->reportUselessTests !== null;
}
/**
* @throws Exception
*/
public function reportUselessTests(): bool
{
if (!$this->hasReportUselessTests()) {
throw new Exception;
}
return $this->reportUselessTests;
}
/**
* @psalm-assert-if-true !null $this->resolveDependencies
*/
public function hasResolveDependencies(): bool
{
return $this->resolveDependencies !== null;
}
/**
* @throws Exception
*/
public function resolveDependencies(): bool
{
if (!$this->hasResolveDependencies()) {
throw new Exception;
}
return $this->resolveDependencies;
}
/**
* @psalm-assert-if-true !null $this->reverseList
*/
public function hasReverseList(): bool
{
return $this->reverseList !== null;
}
/**
* @throws Exception
*/
public function reverseList(): bool
{
if (!$this->hasReverseList()) {
throw new Exception;
}
return $this->reverseList;
}
/**
* @psalm-assert-if-true !null $this->stderr
*/
public function hasStderr(): bool
{
return $this->stderr !== null;
}
/**
* @throws Exception
*/
public function stderr(): bool
{
if (!$this->hasStderr()) {
throw new Exception;
}
return $this->stderr;
}
/**
* @psalm-assert-if-true !null $this->strictCoverage
*/
public function hasStrictCoverage(): bool
{
return $this->strictCoverage !== null;
}
/**
* @throws Exception
*/
public function strictCoverage(): bool
{
if (!$this->hasStrictCoverage()) {
throw new Exception;
}
return $this->strictCoverage;
}
/**
* @psalm-assert-if-true !null $this->teamcityLogfile
*/
public function hasTeamcityLogfile(): bool
{
return $this->teamcityLogfile !== null;
}
/**
* @throws Exception
*/
public function teamcityLogfile(): string
{
if (!$this->hasTeamcityLogfile()) {
throw new Exception;
}
return $this->teamcityLogfile;
}
/**
* @psalm-assert-if-true !null $this->teamcityPrinter
*/
public function hasTeamCityPrinter(): bool
{
return $this->teamCityPrinter !== null;
}
/**
* @throws Exception
*/
public function teamCityPrinter(): bool
{
if (!$this->hasTeamCityPrinter()) {
throw new Exception;
}
return $this->teamCityPrinter;
}
/**
* @psalm-assert-if-true !null $this->testdoxHtmlFile
*/
public function hasTestdoxHtmlFile(): bool
{
return $this->testdoxHtmlFile !== null;
}
/**
* @throws Exception
*/
public function testdoxHtmlFile(): string
{
if (!$this->hasTestdoxHtmlFile()) {
throw new Exception;
}
return $this->testdoxHtmlFile;
}
/**
* @psalm-assert-if-true !null $this->testdoxTextFile
*/
public function hasTestdoxTextFile(): bool
{
return $this->testdoxTextFile !== null;
}
/**
* @throws Exception
*/
public function testdoxTextFile(): string
{
if (!$this->hasTestdoxTextFile()) {
throw new Exception;
}
return $this->testdoxTextFile;
}
/**
* @psalm-assert-if-true !null $this->testdoxPrinter
*/
public function hasTestDoxPrinter(): bool
{
return $this->testdoxPrinter !== null;
}
/**
* @throws Exception
*/
public function testdoxPrinter(): bool
{
if (!$this->hasTestdoxPrinter()) {
throw new Exception;
}
return $this->testdoxPrinter;
}
/**
* @psalm-assert-if-true !null $this->testSuffixes
*/
public function hasTestSuffixes(): bool
{
return $this->testSuffixes !== null;
}
/**
* @psalm-return non-empty-list<non-empty-string>
*
* @throws Exception
*/
public function testSuffixes(): array
{
if (!$this->hasTestSuffixes()) {
throw new Exception;
}
return $this->testSuffixes;
}
/**
* @psalm-assert-if-true !null $this->testSuite
*/
public function hasTestSuite(): bool
{
return $this->testSuite !== null;
}
/**
* @throws Exception
*/
public function testSuite(): string
{
if (!$this->hasTestSuite()) {
throw new Exception;
}
return $this->testSuite;
}
/**
* @psalm-assert-if-true !null $this->excludedTestSuite
*/
public function hasExcludedTestSuite(): bool
{
return $this->excludeTestSuite !== null;
}
/**
* @throws Exception
*/
public function excludedTestSuite(): string
{
if (!$this->hasExcludedTestSuite()) {
throw new Exception;
}
return $this->excludeTestSuite;
}
public function useDefaultConfiguration(): bool
{
return $this->useDefaultConfiguration;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnIncompleteTests
*/
public function hasDisplayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnIncompleteTests(): bool
{
if (!$this->hasDisplayDetailsOnIncompleteTests()) {
throw new Exception;
}
return $this->displayDetailsOnIncompleteTests;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnSkippedTests
*/
public function hasDisplayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnSkippedTests(): bool
{
if (!$this->hasDisplayDetailsOnSkippedTests()) {
throw new Exception;
}
return $this->displayDetailsOnSkippedTests;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerDeprecations
*/
public function hasDisplayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerDeprecations()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerErrors
*/
public function hasDisplayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerErrors()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerErrors;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerNotices
*/
public function hasDisplayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerNotices()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerNotices;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerWarnings
*/
public function hasDisplayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerWarnings()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function version(): bool
{
return $this->version;
}
/**
* @psalm-assert-if-true !null $this->logEventsText
*/
public function hasLogEventsText(): bool
{
return $this->logEventsText !== null;
}
/**
* @throws Exception
*/
public function logEventsText(): string
{
if (!$this->hasLogEventsText()) {
throw new Exception;
}
return $this->logEventsText;
}
/**
* @psalm-assert-if-true !null $this->logEventsVerboseText
*/
public function hasLogEventsVerboseText(): bool
{
return $this->logEventsVerboseText !== null;
}
/**
* @throws Exception
*/
public function logEventsVerboseText(): string
{
if (!$this->hasLogEventsVerboseText()) {
throw new Exception;
}
return $this->logEventsVerboseText;
}
public function debug(): bool
{
return $this->debug;
}
}
phpunit/src/TextUI/Configuration/Cli/Exception.php 0000644 00000000756 15243417753 0016214 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
phpunit/src/TextUI/Configuration/Cli/XmlConfigurationFileFinder.php 0000644 00000003401 15243417753 0021464 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use function getcwd;
use function is_dir;
use function is_file;
use function realpath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class XmlConfigurationFileFinder
{
public function find(Configuration $configuration): false|string
{
$useDefaultConfiguration = $configuration->useDefaultConfiguration();
if ($configuration->hasConfigurationFile()) {
if (is_dir($configuration->configurationFile())) {
$candidate = $this->configurationFileInDirectory($configuration->configurationFile());
if ($candidate !== false) {
return $candidate;
}
return false;
}
return $configuration->configurationFile();
}
if ($useDefaultConfiguration) {
$candidate = $this->configurationFileInDirectory(getcwd());
if ($candidate !== false) {
return $candidate;
}
}
return false;
}
private function configurationFileInDirectory(string $directory): false|string
{
$candidates = [
$directory . '/phpunit.xml',
$directory . '/phpunit.dist.xml',
$directory . '/phpunit.xml.dist',
];
foreach ($candidates as $candidate) {
if (is_file($candidate)) {
return realpath($candidate);
}
}
return false;
}
}
phpunit/src/TextUI/Configuration/SourceFilter.php 0000644 00000001112 15243417753 0016140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SourceFilter
{
public function includes(Source $source, string $path): bool
{
$files = (new SourceMapper)->map($source);
return isset($files[$path]);
}
}
phpunit/src/TextUI/Configuration/SourceMapper.php 0000644 00000004624 15243417753 0016152 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function realpath;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use SplObjectStorage;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SourceMapper
{
/**
* @psalm-var SplObjectStorage<Source, array<non-empty-string, true>>
*/
private static ?SplObjectStorage $files = null;
/**
* @psalm-return array<non-empty-string, true>
*/
public function map(Source $source): array
{
if (self::$files === null) {
self::$files = new SplObjectStorage;
}
if (isset(self::$files[$source])) {
return self::$files[$source];
}
$files = [];
foreach ($source->includeDirectories() as $directory) {
foreach ((new FileIteratorFacade)->getFilesAsArray($directory->path(), $directory->suffix(), $directory->prefix()) as $file) {
$file = realpath($file);
if (!$file) {
continue;
}
$files[$file] = true;
}
}
foreach ($source->includeFiles() as $file) {
$file = realpath($file->path());
if (!$file) {
continue;
}
$files[$file] = true;
}
foreach ($source->excludeDirectories() as $directory) {
foreach ((new FileIteratorFacade)->getFilesAsArray($directory->path(), $directory->suffix(), $directory->prefix()) as $file) {
$file = realpath($file);
if (!$file) {
continue;
}
if (!isset($files[$file])) {
continue;
}
unset($files[$file]);
}
}
foreach ($source->excludeFiles() as $file) {
$file = realpath($file->path());
if (!$file) {
continue;
}
if (!isset($files[$file])) {
continue;
}
unset($files[$file]);
}
self::$files[$source] = $files;
return $files;
}
}
phpunit/src/TextUI/Configuration/CodeCoverageFilterRegistry.php 0000644 00000003226 15243417753 0020767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function array_keys;
use function assert;
use SebastianBergmann\CodeCoverage\Filter;
/**
* CLI options and XML configuration are static within a single PHPUnit process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverageFilterRegistry
{
private static ?self $instance = null;
private ?Filter $filter = null;
private bool $configured = false;
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public function get(): Filter
{
assert($this->filter !== null);
return $this->filter;
}
public function init(Configuration $configuration, bool $force = false): void
{
if (!$configuration->hasCoverageReport() && !$force) {
return;
}
if ($this->configured && !$force) {
return;
}
$this->filter = new Filter;
if ($configuration->source()->notEmpty()) {
$this->filter->includeFiles(array_keys((new SourceMapper)->map($configuration->source())));
$this->configured = true;
}
}
public function configured(): bool
{
return $this->configured;
}
}
phpunit/src/TextUI/Configuration/Configuration.php 0000644 00000117676 15243417753 0016370 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Configuration
{
public const COLOR_NEVER = 'never';
public const COLOR_AUTO = 'auto';
public const COLOR_ALWAYS = 'always';
public const COLOR_DEFAULT = self::COLOR_NEVER;
/**
* @psalm-var list<non-empty-string>
*/
private readonly array $cliArguments;
private readonly ?string $configurationFile;
private readonly ?string $bootstrap;
private readonly bool $cacheResult;
private readonly ?string $cacheDirectory;
private readonly ?string $coverageCacheDirectory;
private readonly Source $source;
private readonly bool $pathCoverage;
private readonly ?string $coverageClover;
private readonly ?string $coverageCobertura;
private readonly ?string $coverageCrap4j;
private readonly int $coverageCrap4jThreshold;
private readonly ?string $coverageHtml;
private readonly int $coverageHtmlLowUpperBound;
private readonly int $coverageHtmlHighLowerBound;
private readonly string $coverageHtmlColorSuccessLow;
private readonly string $coverageHtmlColorSuccessMedium;
private readonly string $coverageHtmlColorSuccessHigh;
private readonly string $coverageHtmlColorWarning;
private readonly string $coverageHtmlColorDanger;
private readonly ?string $coverageHtmlCustomCssFile;
private readonly ?string $coveragePhp;
private readonly ?string $coverageText;
private readonly bool $coverageTextShowUncoveredFiles;
private readonly bool $coverageTextShowOnlySummary;
private readonly ?string $coverageXml;
private readonly string $testResultCacheFile;
private readonly bool $ignoreDeprecatedCodeUnitsFromCodeCoverage;
private readonly bool $disableCodeCoverageIgnore;
private readonly bool $failOnDeprecation;
private readonly bool $failOnEmptyTestSuite;
private readonly bool $failOnIncomplete;
private readonly bool $failOnNotice;
private readonly bool $failOnRisky;
private readonly bool $failOnSkipped;
private readonly bool $failOnWarning;
private readonly bool $stopOnDefect;
private readonly bool $stopOnDeprecation;
private readonly bool $stopOnError;
private readonly bool $stopOnFailure;
private readonly bool $stopOnIncomplete;
private readonly bool $stopOnNotice;
private readonly bool $stopOnRisky;
private readonly bool $stopOnSkipped;
private readonly bool $stopOnWarning;
private readonly bool $outputToStandardErrorStream;
private readonly int $columns;
private readonly bool $noExtensions;
/**
* @psalm-var ?non-empty-string
*/
private readonly ?string $pharExtensionDirectory;
/**
* @psalm-var list<array{className: class-string, parameters: array<string, string>}>
*/
private readonly array $extensionBootstrappers;
private readonly bool $backupGlobals;
private readonly bool $backupStaticProperties;
private readonly bool $beStrictAboutChangesToGlobalState;
private readonly bool $colors;
private readonly bool $processIsolation;
private readonly bool $enforceTimeLimit;
private readonly int $defaultTimeLimit;
private readonly int $timeoutForSmallTests;
private readonly int $timeoutForMediumTests;
private readonly int $timeoutForLargeTests;
private readonly bool $reportUselessTests;
private readonly bool $strictCoverage;
private readonly bool $disallowTestOutput;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $reverseDefectList;
private readonly bool $requireCoverageMetadata;
private readonly bool $registerMockObjectsFromTestArgumentsRecursively;
private readonly bool $noProgress;
private readonly bool $noResults;
private readonly bool $noOutput;
private readonly int $executionOrder;
private readonly int $executionOrderDefects;
private readonly bool $resolveDependencies;
private readonly ?string $logfileTeamcity;
private readonly ?string $logfileJunit;
private readonly ?string $logfileTestdoxHtml;
private readonly ?string $logfileTestdoxText;
private readonly ?string $logEventsText;
private readonly ?string $logEventsVerboseText;
private readonly ?array $testsCovering;
private readonly ?array $testsUsing;
private readonly bool $teamCityOutput;
private readonly bool $testDoxOutput;
private readonly ?string $filter;
private readonly ?array $groups;
private readonly ?array $excludeGroups;
private readonly int $randomOrderSeed;
private readonly bool $includeUncoveredFiles;
private readonly TestSuiteCollection $testSuite;
private readonly string $includeTestSuite;
private readonly string $excludeTestSuite;
private readonly ?string $defaultTestSuite;
/**
* @psalm-var non-empty-list<non-empty-string>
*/
private readonly array $testSuffixes;
private readonly Php $php;
private readonly bool $controlGarbageCollector;
private readonly int $numberOfTestsBeforeGarbageCollection;
private readonly ?string $generateBaseline;
private readonly bool $debug;
/**
* @psalm-param list<non-empty-string> $cliArguments
* @psalm-param ?non-empty-string $pharExtensionDirectory
* @psalm-param non-empty-list<non-empty-string> $testSuffixes
* @psalm-param list<array{className: class-string, parameters: array<string, string>}> $extensionBootstrappers
*/
public function __construct(array $cliArguments, ?string $configurationFile, ?string $bootstrap, bool $cacheResult, ?string $cacheDirectory, ?string $coverageCacheDirectory, Source $source, string $testResultCacheFile, ?string $coverageClover, ?string $coverageCobertura, ?string $coverageCrap4j, int $coverageCrap4jThreshold, ?string $coverageHtml, int $coverageHtmlLowUpperBound, int $coverageHtmlHighLowerBound, string $coverageHtmlColorSuccessLow, string $coverageHtmlColorSuccessMedium, string $coverageHtmlColorSuccessHigh, string $coverageHtmlColorWarning, string $coverageHtmlColorDanger, ?string $coverageHtmlCustomCssFile, ?string $coveragePhp, ?string $coverageText, bool $coverageTextShowUncoveredFiles, bool $coverageTextShowOnlySummary, ?string $coverageXml, bool $pathCoverage, bool $ignoreDeprecatedCodeUnitsFromCodeCoverage, bool $disableCodeCoverageIgnore, bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, bool $stopOnDefect, bool $stopOnDeprecation, bool $stopOnError, bool $stopOnFailure, bool $stopOnIncomplete, bool $stopOnNotice, bool $stopOnRisky, bool $stopOnSkipped, bool $stopOnWarning, bool $outputToStandardErrorStream, int|string $columns, bool $noExtensions, ?string $pharExtensionDirectory, array $extensionBootstrappers, bool $backupGlobals, bool $backupStaticProperties, bool $beStrictAboutChangesToGlobalState, bool $colors, bool $processIsolation, bool $enforceTimeLimit, int $defaultTimeLimit, int $timeoutForSmallTests, int $timeoutForMediumTests, int $timeoutForLargeTests, bool $reportUselessTests, bool $strictCoverage, bool $disallowTestOutput, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $reverseDefectList, bool $requireCoverageMetadata, bool $registerMockObjectsFromTestArgumentsRecursively, bool $noProgress, bool $noResults, bool $noOutput, int $executionOrder, int $executionOrderDefects, bool $resolveDependencies, ?string $logfileTeamcity, ?string $logfileJunit, ?string $logfileTestdoxHtml, ?string $logfileTestdoxText, ?string $logEventsText, ?string $logEventsVerboseText, bool $teamCityOutput, bool $testDoxOutput, ?array $testsCovering, ?array $testsUsing, ?string $filter, ?array $groups, ?array $excludeGroups, int $randomOrderSeed, bool $includeUncoveredFiles, TestSuiteCollection $testSuite, string $includeTestSuite, string $excludeTestSuite, ?string $defaultTestSuite, array $testSuffixes, Php $php, bool $controlGarbageCollector, int $numberOfTestsBeforeGarbageCollection, ?string $generateBaseline, bool $debug)
{
$this->cliArguments = $cliArguments;
$this->configurationFile = $configurationFile;
$this->bootstrap = $bootstrap;
$this->cacheResult = $cacheResult;
$this->cacheDirectory = $cacheDirectory;
$this->coverageCacheDirectory = $coverageCacheDirectory;
$this->source = $source;
$this->testResultCacheFile = $testResultCacheFile;
$this->coverageClover = $coverageClover;
$this->coverageCobertura = $coverageCobertura;
$this->coverageCrap4j = $coverageCrap4j;
$this->coverageCrap4jThreshold = $coverageCrap4jThreshold;
$this->coverageHtml = $coverageHtml;
$this->coverageHtmlLowUpperBound = $coverageHtmlLowUpperBound;
$this->coverageHtmlHighLowerBound = $coverageHtmlHighLowerBound;
$this->coverageHtmlColorSuccessLow = $coverageHtmlColorSuccessLow;
$this->coverageHtmlColorSuccessMedium = $coverageHtmlColorSuccessMedium;
$this->coverageHtmlColorSuccessHigh = $coverageHtmlColorSuccessHigh;
$this->coverageHtmlColorWarning = $coverageHtmlColorWarning;
$this->coverageHtmlColorDanger = $coverageHtmlColorDanger;
$this->coverageHtmlCustomCssFile = $coverageHtmlCustomCssFile;
$this->coveragePhp = $coveragePhp;
$this->coverageText = $coverageText;
$this->coverageTextShowUncoveredFiles = $coverageTextShowUncoveredFiles;
$this->coverageTextShowOnlySummary = $coverageTextShowOnlySummary;
$this->coverageXml = $coverageXml;
$this->pathCoverage = $pathCoverage;
$this->ignoreDeprecatedCodeUnitsFromCodeCoverage = $ignoreDeprecatedCodeUnitsFromCodeCoverage;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->outputToStandardErrorStream = $outputToStandardErrorStream;
$this->columns = $columns;
$this->noExtensions = $noExtensions;
$this->pharExtensionDirectory = $pharExtensionDirectory;
$this->extensionBootstrappers = $extensionBootstrappers;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->colors = $colors;
$this->processIsolation = $processIsolation;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->timeoutForSmallTests = $timeoutForSmallTests;
$this->timeoutForMediumTests = $timeoutForMediumTests;
$this->timeoutForLargeTests = $timeoutForLargeTests;
$this->reportUselessTests = $reportUselessTests;
$this->strictCoverage = $strictCoverage;
$this->disallowTestOutput = $disallowTestOutput;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->reverseDefectList = $reverseDefectList;
$this->requireCoverageMetadata = $requireCoverageMetadata;
$this->registerMockObjectsFromTestArgumentsRecursively = $registerMockObjectsFromTestArgumentsRecursively;
$this->noProgress = $noProgress;
$this->noResults = $noResults;
$this->noOutput = $noOutput;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->resolveDependencies = $resolveDependencies;
$this->logfileTeamcity = $logfileTeamcity;
$this->logfileJunit = $logfileJunit;
$this->logfileTestdoxHtml = $logfileTestdoxHtml;
$this->logfileTestdoxText = $logfileTestdoxText;
$this->logEventsText = $logEventsText;
$this->logEventsVerboseText = $logEventsVerboseText;
$this->teamCityOutput = $teamCityOutput;
$this->testDoxOutput = $testDoxOutput;
$this->testsCovering = $testsCovering;
$this->testsUsing = $testsUsing;
$this->filter = $filter;
$this->groups = $groups;
$this->excludeGroups = $excludeGroups;
$this->randomOrderSeed = $randomOrderSeed;
$this->includeUncoveredFiles = $includeUncoveredFiles;
$this->testSuite = $testSuite;
$this->includeTestSuite = $includeTestSuite;
$this->excludeTestSuite = $excludeTestSuite;
$this->defaultTestSuite = $defaultTestSuite;
$this->testSuffixes = $testSuffixes;
$this->php = $php;
$this->controlGarbageCollector = $controlGarbageCollector;
$this->numberOfTestsBeforeGarbageCollection = $numberOfTestsBeforeGarbageCollection;
$this->generateBaseline = $generateBaseline;
$this->debug = $debug;
}
/**
* @psalm-assert-if-true !empty $this->cliArguments
*/
public function hasCliArguments(): bool
{
return !empty($this->cliArguments);
}
/**
* @psalm-return list<non-empty-string>
*/
public function cliArguments(): array
{
return $this->cliArguments;
}
/**
* @psalm-assert-if-true !empty $this->cliArguments
*
* @deprecated Use hasCliArguments() instead
*/
public function hasCliArgument(): bool
{
return !empty($this->cliArguments);
}
/**
* @throws NoCliArgumentException
*
* @return non-empty-string
*
* @deprecated Use cliArguments()[0] instead
*/
public function cliArgument(): string
{
if (!$this->hasCliArguments()) {
throw new NoCliArgumentException;
}
return $this->cliArguments[0];
}
/**
* @psalm-assert-if-true !null $this->configurationFile
*/
public function hasConfigurationFile(): bool
{
return $this->configurationFile !== null;
}
/**
* @throws NoConfigurationFileException
*/
public function configurationFile(): string
{
if (!$this->hasConfigurationFile()) {
throw new NoConfigurationFileException;
}
return $this->configurationFile;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws NoBootstrapException
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new NoBootstrapException;
}
return $this->bootstrap;
}
public function cacheResult(): bool
{
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws NoCacheDirectoryException
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new NoCacheDirectoryException;
}
return $this->cacheDirectory;
}
/**
* @psalm-assert-if-true !null $this->coverageCacheDirectory
*/
public function hasCoverageCacheDirectory(): bool
{
return $this->coverageCacheDirectory !== null;
}
/**
* @throws NoCoverageCacheDirectoryException
*/
public function coverageCacheDirectory(): string
{
if (!$this->hasCoverageCacheDirectory()) {
throw new NoCoverageCacheDirectoryException;
}
return $this->coverageCacheDirectory;
}
public function source(): Source
{
return $this->source;
}
/**
* @deprecated Use source()->restrictDeprecations() instead
*/
public function restrictDeprecations(): bool
{
return $this->source()->restrictDeprecations();
}
/**
* @deprecated Use source()->restrictNotices() instead
*/
public function restrictNotices(): bool
{
return $this->source()->restrictNotices();
}
/**
* @deprecated Use source()->restrictWarnings() instead
*/
public function restrictWarnings(): bool
{
return $this->source()->restrictWarnings();
}
/**
* @deprecated Use source()->notEmpty() instead
*/
public function hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport(): bool
{
return $this->source->notEmpty();
}
/**
* @deprecated Use source()->includeDirectories() instead
*/
public function coverageIncludeDirectories(): FilterDirectoryCollection
{
return $this->source()->includeDirectories();
}
/**
* @deprecated Use source()->includeFiles() instead
*/
public function coverageIncludeFiles(): FileCollection
{
return $this->source()->includeFiles();
}
/**
* @deprecated Use source()->excludeDirectories() instead
*/
public function coverageExcludeDirectories(): FilterDirectoryCollection
{
return $this->source()->excludeDirectories();
}
/**
* @deprecated Use source()->excludeFiles() instead
*/
public function coverageExcludeFiles(): FileCollection
{
return $this->source()->excludeFiles();
}
public function testResultCacheFile(): string
{
return $this->testResultCacheFile;
}
public function ignoreDeprecatedCodeUnitsFromCodeCoverage(): bool
{
return $this->ignoreDeprecatedCodeUnitsFromCodeCoverage;
}
public function disableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore;
}
public function pathCoverage(): bool
{
return $this->pathCoverage;
}
public function hasCoverageReport(): bool
{
return $this->hasCoverageClover() ||
$this->hasCoverageCobertura() ||
$this->hasCoverageCrap4j() ||
$this->hasCoverageHtml() ||
$this->hasCoveragePhp() ||
$this->hasCoverageText() ||
$this->hasCoverageXml();
}
/**
* @psalm-assert-if-true !null $this->coverageClover
*/
public function hasCoverageClover(): bool
{
return $this->coverageClover !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageClover(): string
{
if (!$this->hasCoverageClover()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageClover;
}
/**
* @psalm-assert-if-true !null $this->coverageCobertura
*/
public function hasCoverageCobertura(): bool
{
return $this->coverageCobertura !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageCobertura(): string
{
if (!$this->hasCoverageCobertura()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageCobertura;
}
/**
* @psalm-assert-if-true !null $this->coverageCrap4j
*/
public function hasCoverageCrap4j(): bool
{
return $this->coverageCrap4j !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageCrap4j(): string
{
if (!$this->hasCoverageCrap4j()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageCrap4j;
}
public function coverageCrap4jThreshold(): int
{
return $this->coverageCrap4jThreshold;
}
/**
* @psalm-assert-if-true !null $this->coverageHtml
*/
public function hasCoverageHtml(): bool
{
return $this->coverageHtml !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageHtml(): string
{
if (!$this->hasCoverageHtml()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageHtml;
}
public function coverageHtmlLowUpperBound(): int
{
return $this->coverageHtmlLowUpperBound;
}
public function coverageHtmlHighLowerBound(): int
{
return $this->coverageHtmlHighLowerBound;
}
public function coverageHtmlColorSuccessLow(): string
{
return $this->coverageHtmlColorSuccessLow;
}
public function coverageHtmlColorSuccessMedium(): string
{
return $this->coverageHtmlColorSuccessMedium;
}
public function coverageHtmlColorSuccessHigh(): string
{
return $this->coverageHtmlColorSuccessHigh;
}
public function coverageHtmlColorWarning(): string
{
return $this->coverageHtmlColorWarning;
}
public function coverageHtmlColorDanger(): string
{
return $this->coverageHtmlColorDanger;
}
/**
* @psalm-assert-if-true !null $this->coverageHtmlCustomCssFile
*/
public function hasCoverageHtmlCustomCssFile(): bool
{
return $this->coverageHtmlCustomCssFile !== null;
}
/**
* @throws NoCustomCssFileException
*/
public function coverageHtmlCustomCssFile(): string
{
if (!$this->hasCoverageHtmlCustomCssFile()) {
throw new NoCustomCssFileException;
}
return $this->coverageHtmlCustomCssFile;
}
/**
* @psalm-assert-if-true !null $this->coveragePhp
*/
public function hasCoveragePhp(): bool
{
return $this->coveragePhp !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coveragePhp(): string
{
if (!$this->hasCoveragePhp()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coveragePhp;
}
/**
* @psalm-assert-if-true !null $this->coverageText
*/
public function hasCoverageText(): bool
{
return $this->coverageText !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageText(): string
{
if (!$this->hasCoverageText()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageText;
}
public function coverageTextShowUncoveredFiles(): bool
{
return $this->coverageTextShowUncoveredFiles;
}
public function coverageTextShowOnlySummary(): bool
{
return $this->coverageTextShowOnlySummary;
}
/**
* @psalm-assert-if-true !null $this->coverageXml
*/
public function hasCoverageXml(): bool
{
return $this->coverageXml !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageXml(): string
{
if (!$this->hasCoverageXml()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageXml;
}
public function failOnDeprecation(): bool
{
return $this->failOnDeprecation;
}
public function failOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite;
}
public function failOnIncomplete(): bool
{
return $this->failOnIncomplete;
}
public function failOnNotice(): bool
{
return $this->failOnNotice;
}
public function failOnRisky(): bool
{
return $this->failOnRisky;
}
public function failOnSkipped(): bool
{
return $this->failOnSkipped;
}
public function failOnWarning(): bool
{
return $this->failOnWarning;
}
public function stopOnDefect(): bool
{
return $this->stopOnDefect;
}
public function stopOnDeprecation(): bool
{
return $this->stopOnDeprecation;
}
public function stopOnError(): bool
{
return $this->stopOnError;
}
public function stopOnFailure(): bool
{
return $this->stopOnFailure;
}
public function stopOnIncomplete(): bool
{
return $this->stopOnIncomplete;
}
public function stopOnNotice(): bool
{
return $this->stopOnNotice;
}
public function stopOnRisky(): bool
{
return $this->stopOnRisky;
}
public function stopOnSkipped(): bool
{
return $this->stopOnSkipped;
}
public function stopOnWarning(): bool
{
return $this->stopOnWarning;
}
public function outputToStandardErrorStream(): bool
{
return $this->outputToStandardErrorStream;
}
public function columns(): int
{
return $this->columns;
}
/**
* @deprecated Use noExtensions() instead
*/
public function loadPharExtensions(): bool
{
return $this->noExtensions;
}
public function noExtensions(): bool
{
return $this->noExtensions;
}
/**
* @psalm-assert-if-true !null $this->pharExtensionDirectory
*/
public function hasPharExtensionDirectory(): bool
{
return $this->pharExtensionDirectory !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws NoPharExtensionDirectoryException
*/
public function pharExtensionDirectory(): string
{
if (!$this->hasPharExtensionDirectory()) {
throw new NoPharExtensionDirectoryException;
}
return $this->pharExtensionDirectory;
}
/**
* @psalm-return list<array{className: class-string, parameters: array<string, string>}>
*/
public function extensionBootstrappers(): array
{
return $this->extensionBootstrappers;
}
public function backupGlobals(): bool
{
return $this->backupGlobals;
}
public function backupStaticProperties(): bool
{
return $this->backupStaticProperties;
}
public function beStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState;
}
public function colors(): bool
{
return $this->colors;
}
public function processIsolation(): bool
{
return $this->processIsolation;
}
public function enforceTimeLimit(): bool
{
return $this->enforceTimeLimit;
}
public function defaultTimeLimit(): int
{
return $this->defaultTimeLimit;
}
public function timeoutForSmallTests(): int
{
return $this->timeoutForSmallTests;
}
public function timeoutForMediumTests(): int
{
return $this->timeoutForMediumTests;
}
public function timeoutForLargeTests(): int
{
return $this->timeoutForLargeTests;
}
public function reportUselessTests(): bool
{
return $this->reportUselessTests;
}
public function strictCoverage(): bool
{
return $this->strictCoverage;
}
public function disallowTestOutput(): bool
{
return $this->disallowTestOutput;
}
public function displayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests;
}
public function displayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests;
}
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors;
}
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices;
}
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function reverseDefectList(): bool
{
return $this->reverseDefectList;
}
public function requireCoverageMetadata(): bool
{
return $this->requireCoverageMetadata;
}
/**
* @deprecated
*/
public function registerMockObjectsFromTestArgumentsRecursively(): bool
{
return $this->registerMockObjectsFromTestArgumentsRecursively;
}
public function noProgress(): bool
{
return $this->noProgress;
}
public function noResults(): bool
{
return $this->noResults;
}
public function noOutput(): bool
{
return $this->noOutput;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function executionOrderDefects(): int
{
return $this->executionOrderDefects;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
/**
* @psalm-assert-if-true !null $this->logfileTeamcity
*/
public function hasLogfileTeamcity(): bool
{
return $this->logfileTeamcity !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTeamcity(): string
{
if (!$this->hasLogfileTeamcity()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTeamcity;
}
/**
* @psalm-assert-if-true !null $this->logfileJunit
*/
public function hasLogfileJunit(): bool
{
return $this->logfileJunit !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileJunit(): string
{
if (!$this->hasLogfileJunit()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileJunit;
}
/**
* @psalm-assert-if-true !null $this->logfileTestdoxHtml
*/
public function hasLogfileTestdoxHtml(): bool
{
return $this->logfileTestdoxHtml !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTestdoxHtml(): string
{
if (!$this->hasLogfileTestdoxHtml()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTestdoxHtml;
}
/**
* @psalm-assert-if-true !null $this->logfileTestdoxText
*/
public function hasLogfileTestdoxText(): bool
{
return $this->logfileTestdoxText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTestdoxText(): string
{
if (!$this->hasLogfileTestdoxText()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTestdoxText;
}
/**
* @psalm-assert-if-true !null $this->logEventsText
*/
public function hasLogEventsText(): bool
{
return $this->logEventsText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logEventsText(): string
{
if (!$this->hasLogEventsText()) {
throw new LoggingNotConfiguredException;
}
return $this->logEventsText;
}
/**
* @psalm-assert-if-true !null $this->logEventsVerboseText
*/
public function hasLogEventsVerboseText(): bool
{
return $this->logEventsVerboseText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logEventsVerboseText(): string
{
if (!$this->hasLogEventsVerboseText()) {
throw new LoggingNotConfiguredException;
}
return $this->logEventsVerboseText;
}
public function outputIsTeamCity(): bool
{
return $this->teamCityOutput;
}
public function outputIsTestDox(): bool
{
return $this->testDoxOutput;
}
/**
* @psalm-assert-if-true !empty $this->testsCovering
*/
public function hasTestsCovering(): bool
{
return !empty($this->testsCovering);
}
/**
* @psalm-return list<string>
*
* @throws FilterNotConfiguredException
*/
public function testsCovering(): array
{
if (!$this->hasTestsCovering()) {
throw new FilterNotConfiguredException;
}
return $this->testsCovering;
}
/**
* @psalm-assert-if-true !empty $this->testsUsing
*/
public function hasTestsUsing(): bool
{
return !empty($this->testsUsing);
}
/**
* @psalm-return list<string>
*
* @throws FilterNotConfiguredException
*/
public function testsUsing(): array
{
if (!$this->hasTestsUsing()) {
throw new FilterNotConfiguredException;
}
return $this->testsUsing;
}
/**
* @psalm-assert-if-true !null $this->filter
*/
public function hasFilter(): bool
{
return $this->filter !== null;
}
/**
* @throws FilterNotConfiguredException
*/
public function filter(): string
{
if (!$this->hasFilter()) {
throw new FilterNotConfiguredException;
}
return $this->filter;
}
/**
* @psalm-assert-if-true !empty $this->groups
*/
public function hasGroups(): bool
{
return !empty($this->groups);
}
/**
* @throws FilterNotConfiguredException
*/
public function groups(): array
{
if (!$this->hasGroups()) {
throw new FilterNotConfiguredException;
}
return $this->groups;
}
/**
* @psalm-assert-if-true !empty $this->excludeGroups
*/
public function hasExcludeGroups(): bool
{
return !empty($this->excludeGroups);
}
/**
* @throws FilterNotConfiguredException
*/
public function excludeGroups(): array
{
if (!$this->hasExcludeGroups()) {
throw new FilterNotConfiguredException;
}
return $this->excludeGroups;
}
public function randomOrderSeed(): int
{
return $this->randomOrderSeed;
}
public function includeUncoveredFiles(): bool
{
return $this->includeUncoveredFiles;
}
public function testSuite(): TestSuiteCollection
{
return $this->testSuite;
}
public function includeTestSuite(): string
{
return $this->includeTestSuite;
}
public function excludeTestSuite(): string
{
return $this->excludeTestSuite;
}
/**
* @psalm-assert-if-true !null $this->defaultTestSuite
*/
public function hasDefaultTestSuite(): bool
{
return $this->defaultTestSuite !== null;
}
/**
* @throws NoDefaultTestSuiteException
*/
public function defaultTestSuite(): string
{
if (!$this->hasDefaultTestSuite()) {
throw new NoDefaultTestSuiteException;
}
return $this->defaultTestSuite;
}
/**
* @psalm-return non-empty-list<non-empty-string>
*/
public function testSuffixes(): array
{
return $this->testSuffixes;
}
public function php(): Php
{
return $this->php;
}
public function controlGarbageCollector(): bool
{
return $this->controlGarbageCollector;
}
public function numberOfTestsBeforeGarbageCollection(): int
{
return $this->numberOfTestsBeforeGarbageCollection;
}
/**
* @psalm-assert-if-true !null $this->generateBaseline
*/
public function hasGenerateBaseline(): bool
{
return $this->generateBaseline !== null;
}
/**
* @throws NoBaselineException
*/
public function generateBaseline(): string
{
if (!$this->hasGenerateBaseline()) {
throw new NoBaselineException;
}
return $this->generateBaseline;
}
public function debug(): bool
{
return $this->debug;
}
}
phpunit/src/TextUI/Configuration/Exception/LoggingNotConfiguredException.php 0000644 00000000772 15243417753 0023437 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class LoggingNotConfiguredException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoCliArgumentException.php 0000644 00000000763 15243417753 0022071 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCliArgumentException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/IncludePathNotConfiguredException.php 0000644 00000000776 15243417753 0024255 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncludePathNotConfiguredException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoCoverageCacheDirectoryException.php 0000644 00000000776 15243417753 0024227 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCoverageCacheDirectoryException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/ConfigurationCannotBeBuiltException.php 0000644 00000001000 15243417753 0024564 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConfigurationCannotBeBuiltException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoBaselineException.php 0000644 00000000760 15243417753 0021376 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoBaselineException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoCustomCssFileException.php 0000644 00000000765 15243417753 0022404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCustomCssFileException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoCacheDirectoryException.php 0000644 00000000766 15243417753 0022552 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCacheDirectoryException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/FilterNotConfiguredException.php 0000644 00000000771 15243417753 0023275 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FilterNotConfiguredException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoConfigurationFileException.php 0000644 00000000771 15243417753 0023265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoConfigurationFileException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoDefaultTestSuiteException.php 0000644 00000000770 15243417753 0023113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoDefaultTestSuiteException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoPharExtensionDirectoryException.php 0000644 00000000776 15243417753 0024337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoPharExtensionDirectoryException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/Exception.php 0000644 00000000705 15243417753 0017435 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends \PHPUnit\TextUI\Exception
{
}
phpunit/src/TextUI/Configuration/Exception/CannotFindSchemaException.php 0000644 00000001045 15243417753 0022520 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotFindSchemaException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/NoBootstrapException.php 0000644 00000000761 15243417753 0021632 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoBootstrapException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Exception/CodeCoverageReportNotConfiguredException.php 0000644 00000001005 15243417753 0025561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverageReportNotConfiguredException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/TestSuiteBuilder.php 0000644 00000010157 15243417753 0017003 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function assert;
use function count;
use function is_dir;
use function is_file;
use function realpath;
use function str_ends_with;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Exception;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\TestSuiteLoader;
use PHPUnit\TextUI\RuntimeException;
use PHPUnit\TextUI\TestDirectoryNotFoundException;
use PHPUnit\TextUI\TestFileNotFoundException;
use PHPUnit\TextUI\XmlConfiguration\TestSuiteMapper;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteBuilder
{
/**
* @throws \PHPUnit\Framework\Exception
* @throws RuntimeException
* @throws TestDirectoryNotFoundException
* @throws TestFileNotFoundException
*/
public function build(Configuration $configuration): TestSuite
{
if ($configuration->hasCliArguments()) {
$arguments = [];
foreach ($configuration->cliArguments() as $cliArgument) {
$argument = realpath($cliArgument);
if (!$argument) {
throw new TestFileNotFoundException($cliArgument);
}
$arguments[] = $argument;
}
if (count($arguments) === 1) {
$testSuite = $this->testSuiteFromPath(
$arguments[0],
$configuration->testSuffixes(),
);
} else {
$testSuite = $this->testSuiteFromPathList(
$arguments,
$configuration->testSuffixes(),
);
}
}
if (!isset($testSuite)) {
$xmlConfigurationFile = $configuration->hasConfigurationFile() ? $configuration->configurationFile() : 'Root Test Suite';
assert(!empty($xmlConfigurationFile));
$testSuite = (new TestSuiteMapper)->map(
$xmlConfigurationFile,
$configuration->testSuite(),
$configuration->includeTestSuite(),
$configuration->excludeTestSuite(),
);
}
EventFacade::emitter()->testSuiteLoaded(\PHPUnit\Event\TestSuite\TestSuiteBuilder::from($testSuite));
return $testSuite;
}
/**
* @psalm-param non-empty-string $path
* @psalm-param list<non-empty-string> $suffixes
* @psalm-param ?TestSuite $suite
*
* @throws \PHPUnit\Framework\Exception
*/
private function testSuiteFromPath(string $path, array $suffixes, ?TestSuite $suite = null): TestSuite
{
if (str_ends_with($path, '.phpt') && is_file($path)) {
$suite = $suite ?: TestSuite::empty($path);
$suite->addTestFile($path);
return $suite;
}
if (is_dir($path)) {
$files = (new FileIteratorFacade)->getFilesAsArray($path, $suffixes);
$suite = $suite ?: TestSuite::empty('CLI Arguments');
$suite->addTestFiles($files);
return $suite;
}
try {
$testClass = (new TestSuiteLoader)->load($path);
} catch (Exception $e) {
print $e->getMessage() . PHP_EOL;
exit(1);
}
if (!$suite) {
return TestSuite::fromClassReflector($testClass);
}
$suite->addTestSuite($testClass);
return $suite;
}
/**
* @psalm-param list<non-empty-string> $paths
* @psalm-param list<non-empty-string> $suffixes
*
* @throws \PHPUnit\Framework\Exception
*/
private function testSuiteFromPathList(array $paths, array $suffixes): TestSuite
{
$suite = TestSuite::empty('CLI Arguments');
foreach ($paths as $path) {
$this->testSuiteFromPath($path, $suffixes, $suite);
}
return $suite;
}
}
phpunit/src/TextUI/Configuration/Merger.php 0000644 00000105542 15243417753 0014767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use const DIRECTORY_SEPARATOR;
use function array_diff;
use function assert;
use function dirname;
use function explode;
use function is_int;
use function realpath;
use function time;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\TextUI\XmlConfiguration\LoadedFromFileConfiguration;
use PHPUnit\TextUI\XmlConfiguration\SchemaDetector;
use PHPUnit\Util\Filesystem;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\Environment\Console;
use SebastianBergmann\Invoker\Invoker;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Merger
{
/**
* @throws \PHPUnit\TextUI\XmlConfiguration\Exception
* @throws Exception
* @throws NoCustomCssFileException
*/
public function merge(CliConfiguration $cliConfiguration, XmlConfiguration $xmlConfiguration): Configuration
{
$configurationFile = null;
if ($xmlConfiguration->wasLoadedFromFile()) {
assert($xmlConfiguration instanceof LoadedFromFileConfiguration);
$configurationFile = $xmlConfiguration->filename();
}
$bootstrap = null;
if ($cliConfiguration->hasBootstrap()) {
$bootstrap = $cliConfiguration->bootstrap();
} elseif ($xmlConfiguration->phpunit()->hasBootstrap()) {
$bootstrap = $xmlConfiguration->phpunit()->bootstrap();
}
if ($cliConfiguration->hasCacheResult()) {
$cacheResult = $cliConfiguration->cacheResult();
} else {
$cacheResult = $xmlConfiguration->phpunit()->cacheResult();
}
$cacheDirectory = null;
$coverageCacheDirectory = null;
if ($cliConfiguration->hasCacheDirectory() && Filesystem::createDirectory($cliConfiguration->cacheDirectory())) {
$cacheDirectory = realpath($cliConfiguration->cacheDirectory());
} elseif ($xmlConfiguration->phpunit()->hasCacheDirectory() && Filesystem::createDirectory($xmlConfiguration->phpunit()->cacheDirectory())) {
$cacheDirectory = realpath($xmlConfiguration->phpunit()->cacheDirectory());
}
if ($cacheDirectory !== null) {
$coverageCacheDirectory = $cacheDirectory . DIRECTORY_SEPARATOR . 'code-coverage';
$testResultCacheFile = $cacheDirectory . DIRECTORY_SEPARATOR . 'test-results';
}
if ($coverageCacheDirectory === null) {
if ($cliConfiguration->hasCoverageCacheDirectory() && Filesystem::createDirectory($cliConfiguration->coverageCacheDirectory())) {
$coverageCacheDirectory = realpath($cliConfiguration->coverageCacheDirectory());
} elseif ($xmlConfiguration->codeCoverage()->hasCacheDirectory()) {
$coverageCacheDirectory = $xmlConfiguration->codeCoverage()->cacheDirectory()->path();
}
}
if (!isset($testResultCacheFile)) {
if ($cliConfiguration->hasCacheResultFile()) {
$testResultCacheFile = $cliConfiguration->cacheResultFile();
} elseif ($xmlConfiguration->phpunit()->hasCacheResultFile()) {
$testResultCacheFile = $xmlConfiguration->phpunit()->cacheResultFile();
} elseif ($xmlConfiguration->wasLoadedFromFile()) {
$testResultCacheFile = dirname(realpath($xmlConfiguration->filename())) . DIRECTORY_SEPARATOR . '.phpunit.result.cache';
} else {
$candidate = realpath($_SERVER['PHP_SELF']);
if ($candidate) {
$testResultCacheFile = dirname($candidate) . DIRECTORY_SEPARATOR . '.phpunit.result.cache';
} else {
$testResultCacheFile = '.phpunit.result.cache';
}
}
}
if ($cliConfiguration->hasDisableCodeCoverageIgnore()) {
$disableCodeCoverageIgnore = $cliConfiguration->disableCodeCoverageIgnore();
} else {
$disableCodeCoverageIgnore = $xmlConfiguration->codeCoverage()->disableCodeCoverageIgnore();
}
if ($cliConfiguration->hasFailOnDeprecation()) {
$failOnDeprecation = $cliConfiguration->failOnDeprecation();
} else {
$failOnDeprecation = $xmlConfiguration->phpunit()->failOnDeprecation();
}
if ($cliConfiguration->hasFailOnEmptyTestSuite()) {
$failOnEmptyTestSuite = $cliConfiguration->failOnEmptyTestSuite();
} else {
$failOnEmptyTestSuite = $xmlConfiguration->phpunit()->failOnEmptyTestSuite();
}
if ($cliConfiguration->hasFailOnIncomplete()) {
$failOnIncomplete = $cliConfiguration->failOnIncomplete();
} else {
$failOnIncomplete = $xmlConfiguration->phpunit()->failOnIncomplete();
}
if ($cliConfiguration->hasFailOnNotice()) {
$failOnNotice = $cliConfiguration->failOnNotice();
} else {
$failOnNotice = $xmlConfiguration->phpunit()->failOnNotice();
}
if ($cliConfiguration->hasFailOnRisky()) {
$failOnRisky = $cliConfiguration->failOnRisky();
} else {
$failOnRisky = $xmlConfiguration->phpunit()->failOnRisky();
}
if ($cliConfiguration->hasFailOnSkipped()) {
$failOnSkipped = $cliConfiguration->failOnSkipped();
} else {
$failOnSkipped = $xmlConfiguration->phpunit()->failOnSkipped();
}
if ($cliConfiguration->hasFailOnWarning()) {
$failOnWarning = $cliConfiguration->failOnWarning();
} else {
$failOnWarning = $xmlConfiguration->phpunit()->failOnWarning();
}
if ($cliConfiguration->hasStopOnDefect()) {
$stopOnDefect = $cliConfiguration->stopOnDefect();
} else {
$stopOnDefect = $xmlConfiguration->phpunit()->stopOnDefect();
}
if ($cliConfiguration->hasStopOnDeprecation()) {
$stopOnDeprecation = $cliConfiguration->stopOnDeprecation();
} else {
$stopOnDeprecation = $xmlConfiguration->phpunit()->stopOnDeprecation();
}
if ($cliConfiguration->hasStopOnError()) {
$stopOnError = $cliConfiguration->stopOnError();
} else {
$stopOnError = $xmlConfiguration->phpunit()->stopOnError();
}
if ($cliConfiguration->hasStopOnFailure()) {
$stopOnFailure = $cliConfiguration->stopOnFailure();
} else {
$stopOnFailure = $xmlConfiguration->phpunit()->stopOnFailure();
}
if ($cliConfiguration->hasStopOnIncomplete()) {
$stopOnIncomplete = $cliConfiguration->stopOnIncomplete();
} else {
$stopOnIncomplete = $xmlConfiguration->phpunit()->stopOnIncomplete();
}
if ($cliConfiguration->hasStopOnNotice()) {
$stopOnNotice = $cliConfiguration->stopOnNotice();
} else {
$stopOnNotice = $xmlConfiguration->phpunit()->stopOnNotice();
}
if ($cliConfiguration->hasStopOnRisky()) {
$stopOnRisky = $cliConfiguration->stopOnRisky();
} else {
$stopOnRisky = $xmlConfiguration->phpunit()->stopOnRisky();
}
if ($cliConfiguration->hasStopOnSkipped()) {
$stopOnSkipped = $cliConfiguration->stopOnSkipped();
} else {
$stopOnSkipped = $xmlConfiguration->phpunit()->stopOnSkipped();
}
if ($cliConfiguration->hasStopOnWarning()) {
$stopOnWarning = $cliConfiguration->stopOnWarning();
} else {
$stopOnWarning = $xmlConfiguration->phpunit()->stopOnWarning();
}
if ($cliConfiguration->hasStderr() && $cliConfiguration->stderr()) {
$outputToStandardErrorStream = true;
} else {
$outputToStandardErrorStream = $xmlConfiguration->phpunit()->stderr();
}
if ($cliConfiguration->hasColumns()) {
$columns = $cliConfiguration->columns();
} else {
$columns = $xmlConfiguration->phpunit()->columns();
}
if ($columns === 'max') {
$columns = (new Console)->getNumberOfColumns();
}
if ($columns < 16) {
$columns = 16;
EventFacade::emitter()->testRunnerTriggeredWarning(
'Less than 16 columns requested, number of columns set to 16',
);
}
assert(is_int($columns));
$noExtensions = false;
if ($cliConfiguration->hasNoExtensions() && $cliConfiguration->noExtensions()) {
$noExtensions = true;
}
$pharExtensionDirectory = null;
if ($xmlConfiguration->phpunit()->hasExtensionsDirectory()) {
$pharExtensionDirectory = $xmlConfiguration->phpunit()->extensionsDirectory();
}
$extensionBootstrappers = [];
foreach ($xmlConfiguration->extensions() as $extension) {
$extensionBootstrappers[] = [
'className' => $extension->className(),
'parameters' => $extension->parameters(),
];
}
if ($cliConfiguration->hasPathCoverage() && $cliConfiguration->pathCoverage()) {
$pathCoverage = $cliConfiguration->pathCoverage();
} else {
$pathCoverage = $xmlConfiguration->codeCoverage()->pathCoverage();
}
$defaultColors = Colors::default();
$defaultThresholds = Thresholds::default();
$coverageClover = null;
$coverageCobertura = null;
$coverageCrap4j = null;
$coverageCrap4jThreshold = 30;
$coverageHtml = null;
$coverageHtmlLowUpperBound = $defaultThresholds->lowUpperBound();
$coverageHtmlHighLowerBound = $defaultThresholds->highLowerBound();
$coverageHtmlColorSuccessLow = $defaultColors->successLow();
$coverageHtmlColorSuccessMedium = $defaultColors->successMedium();
$coverageHtmlColorSuccessHigh = $defaultColors->successHigh();
$coverageHtmlColorWarning = $defaultColors->warning();
$coverageHtmlColorDanger = $defaultColors->danger();
$coverageHtmlCustomCssFile = null;
$coveragePhp = null;
$coverageText = null;
$coverageTextShowUncoveredFiles = false;
$coverageTextShowOnlySummary = false;
$coverageXml = null;
$coverageFromXmlConfiguration = true;
if ($cliConfiguration->hasNoCoverage() && $cliConfiguration->noCoverage()) {
$coverageFromXmlConfiguration = false;
}
if ($cliConfiguration->hasCoverageClover()) {
$coverageClover = $cliConfiguration->coverageClover();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasClover()) {
$coverageClover = $xmlConfiguration->codeCoverage()->clover()->target()->path();
}
if ($cliConfiguration->hasCoverageCobertura()) {
$coverageCobertura = $cliConfiguration->coverageCobertura();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasCobertura()) {
$coverageCobertura = $xmlConfiguration->codeCoverage()->cobertura()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasCrap4j()) {
$coverageCrap4jThreshold = $xmlConfiguration->codeCoverage()->crap4j()->threshold();
}
if ($cliConfiguration->hasCoverageCrap4J()) {
$coverageCrap4j = $cliConfiguration->coverageCrap4J();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasCrap4j()) {
$coverageCrap4j = $xmlConfiguration->codeCoverage()->crap4j()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasHtml()) {
$coverageHtmlHighLowerBound = $xmlConfiguration->codeCoverage()->html()->highLowerBound();
$coverageHtmlLowUpperBound = $xmlConfiguration->codeCoverage()->html()->lowUpperBound();
if ($coverageHtmlLowUpperBound > $coverageHtmlHighLowerBound) {
$coverageHtmlLowUpperBound = $defaultThresholds->lowUpperBound();
$coverageHtmlHighLowerBound = $defaultThresholds->highLowerBound();
}
$coverageHtmlColorSuccessLow = $xmlConfiguration->codeCoverage()->html()->colorSuccessLow();
$coverageHtmlColorSuccessMedium = $xmlConfiguration->codeCoverage()->html()->colorSuccessMedium();
$coverageHtmlColorSuccessHigh = $xmlConfiguration->codeCoverage()->html()->colorSuccessHigh();
$coverageHtmlColorWarning = $xmlConfiguration->codeCoverage()->html()->colorWarning();
$coverageHtmlColorDanger = $xmlConfiguration->codeCoverage()->html()->colorDanger();
if ($xmlConfiguration->codeCoverage()->html()->hasCustomCssFile()) {
$coverageHtmlCustomCssFile = $xmlConfiguration->codeCoverage()->html()->customCssFile();
}
}
if ($cliConfiguration->hasCoverageHtml()) {
$coverageHtml = $cliConfiguration->coverageHtml();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasHtml()) {
$coverageHtml = $xmlConfiguration->codeCoverage()->html()->target()->path();
}
if ($cliConfiguration->hasCoveragePhp()) {
$coveragePhp = $cliConfiguration->coveragePhp();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasPhp()) {
$coveragePhp = $xmlConfiguration->codeCoverage()->php()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasText()) {
$coverageTextShowUncoveredFiles = $xmlConfiguration->codeCoverage()->text()->showUncoveredFiles();
$coverageTextShowOnlySummary = $xmlConfiguration->codeCoverage()->text()->showOnlySummary();
}
if ($cliConfiguration->hasCoverageText()) {
$coverageText = $cliConfiguration->coverageText();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasText()) {
$coverageText = $xmlConfiguration->codeCoverage()->text()->target()->path();
}
if ($cliConfiguration->hasCoverageXml()) {
$coverageXml = $cliConfiguration->coverageXml();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasXml()) {
$coverageXml = $xmlConfiguration->codeCoverage()->xml()->target()->path();
}
if ($cliConfiguration->hasBackupGlobals()) {
$backupGlobals = $cliConfiguration->backupGlobals();
} else {
$backupGlobals = $xmlConfiguration->phpunit()->backupGlobals();
}
if ($cliConfiguration->hasBackupStaticProperties()) {
$backupStaticProperties = $cliConfiguration->backupStaticProperties();
} else {
$backupStaticProperties = $xmlConfiguration->phpunit()->backupStaticProperties();
}
if ($cliConfiguration->hasBeStrictAboutChangesToGlobalState()) {
$beStrictAboutChangesToGlobalState = $cliConfiguration->beStrictAboutChangesToGlobalState();
} else {
$beStrictAboutChangesToGlobalState = $xmlConfiguration->phpunit()->beStrictAboutChangesToGlobalState();
}
if ($cliConfiguration->hasProcessIsolation()) {
$processIsolation = $cliConfiguration->processIsolation();
} else {
$processIsolation = $xmlConfiguration->phpunit()->processIsolation();
}
if ($cliConfiguration->hasEnforceTimeLimit()) {
$enforceTimeLimit = $cliConfiguration->enforceTimeLimit();
} else {
$enforceTimeLimit = $xmlConfiguration->phpunit()->enforceTimeLimit();
}
if ($enforceTimeLimit && !(new Invoker)->canInvokeWithTimeout()) {
EventFacade::emitter()->testRunnerTriggeredWarning(
'The pcntl extension is required for enforcing time limits',
);
}
if ($cliConfiguration->hasDefaultTimeLimit()) {
$defaultTimeLimit = $cliConfiguration->defaultTimeLimit();
} else {
$defaultTimeLimit = $xmlConfiguration->phpunit()->defaultTimeLimit();
}
$timeoutForSmallTests = $xmlConfiguration->phpunit()->timeoutForSmallTests();
$timeoutForMediumTests = $xmlConfiguration->phpunit()->timeoutForMediumTests();
$timeoutForLargeTests = $xmlConfiguration->phpunit()->timeoutForLargeTests();
if ($cliConfiguration->hasReportUselessTests()) {
$reportUselessTests = $cliConfiguration->reportUselessTests();
} else {
$reportUselessTests = $xmlConfiguration->phpunit()->beStrictAboutTestsThatDoNotTestAnything();
}
if ($cliConfiguration->hasStrictCoverage()) {
$strictCoverage = $cliConfiguration->strictCoverage();
} else {
$strictCoverage = $xmlConfiguration->phpunit()->beStrictAboutCoverageMetadata();
}
if ($cliConfiguration->hasDisallowTestOutput()) {
$disallowTestOutput = $cliConfiguration->disallowTestOutput();
} else {
$disallowTestOutput = $xmlConfiguration->phpunit()->beStrictAboutOutputDuringTests();
}
if ($cliConfiguration->hasDisplayDetailsOnIncompleteTests()) {
$displayDetailsOnIncompleteTests = $cliConfiguration->displayDetailsOnIncompleteTests();
} else {
$displayDetailsOnIncompleteTests = $xmlConfiguration->phpunit()->displayDetailsOnIncompleteTests();
}
if ($cliConfiguration->hasDisplayDetailsOnSkippedTests()) {
$displayDetailsOnSkippedTests = $cliConfiguration->displayDetailsOnSkippedTests();
} else {
$displayDetailsOnSkippedTests = $xmlConfiguration->phpunit()->displayDetailsOnSkippedTests();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerDeprecations()) {
$displayDetailsOnTestsThatTriggerDeprecations = $cliConfiguration->displayDetailsOnTestsThatTriggerDeprecations();
} else {
$displayDetailsOnTestsThatTriggerDeprecations = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerDeprecations();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerErrors()) {
$displayDetailsOnTestsThatTriggerErrors = $cliConfiguration->displayDetailsOnTestsThatTriggerErrors();
} else {
$displayDetailsOnTestsThatTriggerErrors = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerErrors();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerNotices()) {
$displayDetailsOnTestsThatTriggerNotices = $cliConfiguration->displayDetailsOnTestsThatTriggerNotices();
} else {
$displayDetailsOnTestsThatTriggerNotices = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerNotices();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerWarnings()) {
$displayDetailsOnTestsThatTriggerWarnings = $cliConfiguration->displayDetailsOnTestsThatTriggerWarnings();
} else {
$displayDetailsOnTestsThatTriggerWarnings = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerWarnings();
}
if ($cliConfiguration->hasReverseList()) {
$reverseDefectList = $cliConfiguration->reverseList();
} else {
$reverseDefectList = $xmlConfiguration->phpunit()->reverseDefectList();
}
$requireCoverageMetadata = $xmlConfiguration->phpunit()->requireCoverageMetadata();
$registerMockObjectsFromTestArgumentsRecursively = $xmlConfiguration->phpunit()->registerMockObjectsFromTestArgumentsRecursively();
if ($cliConfiguration->hasExecutionOrder()) {
$executionOrder = $cliConfiguration->executionOrder();
} else {
$executionOrder = $xmlConfiguration->phpunit()->executionOrder();
}
$executionOrderDefects = TestSuiteSorter::ORDER_DEFAULT;
if ($cliConfiguration->hasExecutionOrderDefects()) {
$executionOrderDefects = $cliConfiguration->executionOrderDefects();
} elseif ($xmlConfiguration->phpunit()->defectsFirst()) {
$executionOrderDefects = TestSuiteSorter::ORDER_DEFECTS_FIRST;
}
if ($cliConfiguration->hasResolveDependencies()) {
$resolveDependencies = $cliConfiguration->resolveDependencies();
} else {
$resolveDependencies = $xmlConfiguration->phpunit()->resolveDependencies();
}
$colors = false;
$colorsSupported = (new Console)->hasColorSupport();
if ($cliConfiguration->hasColors()) {
if ($cliConfiguration->colors() === Configuration::COLOR_ALWAYS) {
$colors = true;
} elseif ($colorsSupported && $cliConfiguration->colors() === Configuration::COLOR_AUTO) {
$colors = true;
}
} elseif ($xmlConfiguration->phpunit()->colors() === Configuration::COLOR_ALWAYS) {
$colors = true;
} elseif ($colorsSupported && $xmlConfiguration->phpunit()->colors() === Configuration::COLOR_AUTO) {
$colors = true;
}
$logfileTeamcity = null;
$logfileJunit = null;
$logfileTestdoxHtml = null;
$logfileTestdoxText = null;
$loggingFromXmlConfiguration = true;
if ($cliConfiguration->hasNoLogging() && $cliConfiguration->noLogging()) {
$loggingFromXmlConfiguration = false;
}
if ($cliConfiguration->hasTeamcityLogfile()) {
$logfileTeamcity = $cliConfiguration->teamcityLogfile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTeamCity()) {
$logfileTeamcity = $xmlConfiguration->logging()->teamCity()->target()->path();
}
if ($cliConfiguration->hasJunitLogfile()) {
$logfileJunit = $cliConfiguration->junitLogfile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasJunit()) {
$logfileJunit = $xmlConfiguration->logging()->junit()->target()->path();
}
if ($cliConfiguration->hasTestdoxHtmlFile()) {
$logfileTestdoxHtml = $cliConfiguration->testdoxHtmlFile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTestDoxHtml()) {
$logfileTestdoxHtml = $xmlConfiguration->logging()->testDoxHtml()->target()->path();
}
if ($cliConfiguration->hasTestdoxTextFile()) {
$logfileTestdoxText = $cliConfiguration->testdoxTextFile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTestDoxText()) {
$logfileTestdoxText = $xmlConfiguration->logging()->testDoxText()->target()->path();
}
$logEventsText = null;
if ($cliConfiguration->hasLogEventsText()) {
$logEventsText = $cliConfiguration->logEventsText();
}
$logEventsVerboseText = null;
if ($cliConfiguration->hasLogEventsVerboseText()) {
$logEventsVerboseText = $cliConfiguration->logEventsVerboseText();
}
$teamCityOutput = false;
if ($cliConfiguration->hasTeamCityPrinter() && $cliConfiguration->teamCityPrinter()) {
$teamCityOutput = true;
}
if ($cliConfiguration->hasTestDoxPrinter() && $cliConfiguration->testdoxPrinter()) {
$testDoxOutput = true;
} else {
$testDoxOutput = $xmlConfiguration->phpunit()->testdoxPrinter();
}
$noProgress = false;
if ($cliConfiguration->hasNoProgress() && $cliConfiguration->noProgress()) {
$noProgress = true;
}
$noResults = false;
if ($cliConfiguration->hasNoResults() && $cliConfiguration->noResults()) {
$noResults = true;
}
$noOutput = false;
if ($cliConfiguration->hasNoOutput() && $cliConfiguration->noOutput()) {
$noOutput = true;
}
$testsCovering = null;
if ($cliConfiguration->hasTestsCovering()) {
$testsCovering = $cliConfiguration->testsCovering();
}
$testsUsing = null;
if ($cliConfiguration->hasTestsUsing()) {
$testsUsing = $cliConfiguration->testsUsing();
}
$filter = null;
if ($cliConfiguration->hasFilter()) {
$filter = $cliConfiguration->filter();
}
if ($cliConfiguration->hasGroups()) {
$groups = $cliConfiguration->groups();
} else {
$groups = $xmlConfiguration->groups()->include()->asArrayOfStrings();
}
if ($cliConfiguration->hasExcludeGroups()) {
$excludeGroups = $cliConfiguration->excludeGroups();
} else {
$excludeGroups = $xmlConfiguration->groups()->exclude()->asArrayOfStrings();
}
$excludeGroups = array_diff($excludeGroups, $groups);
if ($cliConfiguration->hasRandomOrderSeed()) {
$randomOrderSeed = $cliConfiguration->randomOrderSeed();
} else {
$randomOrderSeed = time();
}
if ($xmlConfiguration->wasLoadedFromFile() && $xmlConfiguration->hasValidationErrors()) {
if ((new SchemaDetector)->detect($xmlConfiguration->filename())->detected()) {
EventFacade::emitter()->testRunnerTriggeredDeprecation(
'Your XML configuration validates against a deprecated schema. Migrate your XML configuration using "--migrate-configuration"!',
);
} else {
EventFacade::emitter()->testRunnerTriggeredWarning(
"Test results may not be as expected because the XML configuration file did not pass validation:\n" .
$xmlConfiguration->validationErrors(),
);
}
}
$includeUncoveredFiles = $xmlConfiguration->codeCoverage()->includeUncoveredFiles();
$includePaths = [];
if ($cliConfiguration->hasIncludePath()) {
foreach (explode(PATH_SEPARATOR, $cliConfiguration->includePath()) as $includePath) {
$includePaths[] = new Directory($includePath);
}
}
foreach ($xmlConfiguration->php()->includePaths() as $includePath) {
$includePaths[] = $includePath;
}
$iniSettings = [];
if ($cliConfiguration->hasIniSettings()) {
foreach ($cliConfiguration->iniSettings() as $name => $value) {
$iniSettings[] = new IniSetting($name, $value);
}
}
foreach ($xmlConfiguration->php()->iniSettings() as $iniSetting) {
$iniSettings[] = $iniSetting;
}
$includeTestSuite = '';
if ($cliConfiguration->hasTestSuite()) {
$includeTestSuite = $cliConfiguration->testSuite();
} elseif ($xmlConfiguration->phpunit()->hasDefaultTestSuite()) {
$includeTestSuite = $xmlConfiguration->phpunit()->defaultTestSuite();
}
$excludeTestSuite = '';
if ($cliConfiguration->hasExcludedTestSuite()) {
$excludeTestSuite = $cliConfiguration->excludedTestSuite();
}
$testSuffixes = ['Test.php', '.phpt'];
if ($cliConfiguration->hasTestSuffixes()) {
$testSuffixes = $cliConfiguration->testSuffixes();
}
$sourceIncludeDirectories = [];
if ($cliConfiguration->hasCoverageFilter()) {
foreach ($cliConfiguration->coverageFilter() as $directory) {
$sourceIncludeDirectories[] = new FilterDirectory($directory, '', '.php');
}
}
if ($xmlConfiguration->codeCoverage()->hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport()) {
foreach ($xmlConfiguration->codeCoverage()->directories() as $directory) {
$sourceIncludeDirectories[] = $directory;
}
$sourceIncludeFiles = $xmlConfiguration->codeCoverage()->files();
$sourceExcludeDirectories = $xmlConfiguration->codeCoverage()->excludeDirectories();
$sourceExcludeFiles = $xmlConfiguration->codeCoverage()->excludeFiles();
} else {
foreach ($xmlConfiguration->source()->includeDirectories() as $directory) {
$sourceIncludeDirectories[] = $directory;
}
$sourceIncludeFiles = $xmlConfiguration->source()->includeFiles();
$sourceExcludeDirectories = $xmlConfiguration->source()->excludeDirectories();
$sourceExcludeFiles = $xmlConfiguration->source()->excludeFiles();
}
$useBaseline = null;
$generateBaseline = null;
if (!$cliConfiguration->hasGenerateBaseline()) {
if ($cliConfiguration->hasUseBaseline()) {
$useBaseline = $cliConfiguration->useBaseline();
} elseif ($xmlConfiguration->source()->hasBaseline()) {
$useBaseline = $xmlConfiguration->source()->baseline();
}
} else {
$generateBaseline = $cliConfiguration->generateBaseline();
}
assert($useBaseline !== '');
assert($generateBaseline !== '');
return new Configuration(
$cliConfiguration->arguments(),
$configurationFile,
$bootstrap,
$cacheResult,
$cacheDirectory,
$coverageCacheDirectory,
new Source(
$useBaseline,
$cliConfiguration->ignoreBaseline(),
FilterDirectoryCollection::fromArray($sourceIncludeDirectories),
$sourceIncludeFiles,
$sourceExcludeDirectories,
$sourceExcludeFiles,
$xmlConfiguration->source()->restrictDeprecations(),
$xmlConfiguration->source()->restrictNotices(),
$xmlConfiguration->source()->restrictWarnings(),
$xmlConfiguration->source()->ignoreSuppressionOfDeprecations(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpDeprecations(),
$xmlConfiguration->source()->ignoreSuppressionOfErrors(),
$xmlConfiguration->source()->ignoreSuppressionOfNotices(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpNotices(),
$xmlConfiguration->source()->ignoreSuppressionOfWarnings(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpWarnings(),
),
$testResultCacheFile,
$coverageClover,
$coverageCobertura,
$coverageCrap4j,
$coverageCrap4jThreshold,
$coverageHtml,
$coverageHtmlLowUpperBound,
$coverageHtmlHighLowerBound,
$coverageHtmlColorSuccessLow,
$coverageHtmlColorSuccessMedium,
$coverageHtmlColorSuccessHigh,
$coverageHtmlColorWarning,
$coverageHtmlColorDanger,
$coverageHtmlCustomCssFile,
$coveragePhp,
$coverageText,
$coverageTextShowUncoveredFiles,
$coverageTextShowOnlySummary,
$coverageXml,
$pathCoverage,
$xmlConfiguration->codeCoverage()->ignoreDeprecatedCodeUnits(),
$disableCodeCoverageIgnore,
$failOnDeprecation,
$failOnEmptyTestSuite,
$failOnIncomplete,
$failOnNotice,
$failOnRisky,
$failOnSkipped,
$failOnWarning,
$stopOnDefect,
$stopOnDeprecation,
$stopOnError,
$stopOnFailure,
$stopOnIncomplete,
$stopOnNotice,
$stopOnRisky,
$stopOnSkipped,
$stopOnWarning,
$outputToStandardErrorStream,
$columns,
$noExtensions,
$pharExtensionDirectory,
$extensionBootstrappers,
$backupGlobals,
$backupStaticProperties,
$beStrictAboutChangesToGlobalState,
$colors,
$processIsolation,
$enforceTimeLimit,
$defaultTimeLimit,
$timeoutForSmallTests,
$timeoutForMediumTests,
$timeoutForLargeTests,
$reportUselessTests,
$strictCoverage,
$disallowTestOutput,
$displayDetailsOnIncompleteTests,
$displayDetailsOnSkippedTests,
$displayDetailsOnTestsThatTriggerDeprecations,
$displayDetailsOnTestsThatTriggerErrors,
$displayDetailsOnTestsThatTriggerNotices,
$displayDetailsOnTestsThatTriggerWarnings,
$reverseDefectList,
$requireCoverageMetadata,
$registerMockObjectsFromTestArgumentsRecursively,
$noProgress,
$noResults,
$noOutput,
$executionOrder,
$executionOrderDefects,
$resolveDependencies,
$logfileTeamcity,
$logfileJunit,
$logfileTestdoxHtml,
$logfileTestdoxText,
$logEventsText,
$logEventsVerboseText,
$teamCityOutput,
$testDoxOutput,
$testsCovering,
$testsUsing,
$filter,
$groups,
$excludeGroups,
$randomOrderSeed,
$includeUncoveredFiles,
$xmlConfiguration->testSuite(),
$includeTestSuite,
$excludeTestSuite,
$xmlConfiguration->phpunit()->hasDefaultTestSuite() ? $xmlConfiguration->phpunit()->defaultTestSuite() : null,
$testSuffixes,
new Php(
DirectoryCollection::fromArray($includePaths),
IniSettingCollection::fromArray($iniSettings),
$xmlConfiguration->php()->constants(),
$xmlConfiguration->php()->globalVariables(),
$xmlConfiguration->php()->envVariables(),
$xmlConfiguration->php()->postVariables(),
$xmlConfiguration->php()->getVariables(),
$xmlConfiguration->php()->cookieVariables(),
$xmlConfiguration->php()->serverVariables(),
$xmlConfiguration->php()->filesVariables(),
$xmlConfiguration->php()->requestVariables(),
),
$xmlConfiguration->phpunit()->controlGarbageCollector(),
$xmlConfiguration->phpunit()->numberOfTestsBeforeGarbageCollection(),
$generateBaseline,
$cliConfiguration->debug(),
);
}
}
phpunit/src/TextUI/Configuration/Xml/SchemaFinder.php 0000644 00000003520 15243417753 0016627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use function defined;
use function is_file;
use function rsort;
use function sprintf;
use DirectoryIterator;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SchemaFinder
{
/**
* @psalm-return non-empty-list<non-empty-string>
*/
public function available(): array
{
$result = [Version::series()];
foreach ((new DirectoryIterator($this->path() . 'schema')) as $file) {
if ($file->isDot()) {
continue;
}
$version = $file->getBasename('.xsd');
assert(!empty($version));
$result[] = $version;
}
rsort($result);
return $result;
}
/**
* @throws CannotFindSchemaException
*/
public function find(string $version): string
{
if ($version === Version::series()) {
$filename = $this->path() . 'phpunit.xsd';
} else {
$filename = $this->path() . 'schema/' . $version . '.xsd';
}
if (!is_file($filename)) {
throw new CannotFindSchemaException(
sprintf(
'Schema for PHPUnit %s is not available',
$version,
),
);
}
return $filename;
}
private function path(): string
{
if (defined('__PHPUNIT_PHAR_ROOT__')) {
return __PHPUNIT_PHAR_ROOT__ . '/';
}
return __DIR__ . '/../../../../';
}
}
phpunit/src/TextUI/Configuration/Xml/TestSuiteMapper.php 0000644 00000007736 15243417753 0017412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use const PHP_VERSION;
use function array_merge;
use function array_unique;
use function explode;
use function in_array;
use function is_dir;
use function is_file;
use function str_contains;
use function version_compare;
use PHPUnit\Framework\Exception as FrameworkException;
use PHPUnit\Framework\TestSuite as TestSuiteObject;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\RuntimeException;
use PHPUnit\TextUI\TestDirectoryNotFoundException;
use PHPUnit\TextUI\TestFileNotFoundException;
use SebastianBergmann\FileIterator\Facade;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteMapper
{
/**
* @psalm-param non-empty-string $xmlConfigurationFile,
*
* @throws RuntimeException
* @throws TestDirectoryNotFoundException
* @throws TestFileNotFoundException
*/
public function map(string $xmlConfigurationFile, TestSuiteCollection $configuration, string $filter, string $excludedTestSuites): TestSuiteObject
{
try {
$filterAsArray = $filter ? explode(',', $filter) : [];
$excludedFilterAsArray = $excludedTestSuites ? explode(',', $excludedTestSuites) : [];
$result = TestSuiteObject::empty($xmlConfigurationFile);
foreach ($configuration as $testSuiteConfiguration) {
if (!empty($filterAsArray) && !in_array($testSuiteConfiguration->name(), $filterAsArray, true)) {
continue;
}
if (!empty($excludedFilterAsArray) && in_array($testSuiteConfiguration->name(), $excludedFilterAsArray, true)) {
continue;
}
$exclude = [];
foreach ($testSuiteConfiguration->exclude()->asArray() as $file) {
$exclude[] = $file->path();
}
$files = [];
foreach ($testSuiteConfiguration->directories() as $directory) {
if (!str_contains($directory->path(), '*') && !is_dir($directory->path())) {
throw new TestDirectoryNotFoundException($directory->path());
}
if (!version_compare(PHP_VERSION, $directory->phpVersion(), $directory->phpVersionOperator()->asString())) {
continue;
}
$files = array_merge(
$files,
(new Facade)->getFilesAsArray(
$directory->path(),
$directory->suffix(),
$directory->prefix(),
$exclude,
),
);
}
foreach ($testSuiteConfiguration->files() as $file) {
if (!is_file($file->path())) {
throw new TestFileNotFoundException($file->path());
}
if (!version_compare(PHP_VERSION, $file->phpVersion(), $file->phpVersionOperator()->asString())) {
continue;
}
$files[] = $file->path();
}
if (!empty($files)) {
$testSuite = TestSuiteObject::empty($testSuiteConfiguration->name());
$testSuite->addTestFiles(array_unique($files));
$result->addTest($testSuite);
}
}
return $result;
} catch (FrameworkException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/MigrationBuilder.php 0000644 00000005336 15243417753 0021477 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function version_compare;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationBuilder
{
private const AVAILABLE_MIGRATIONS = [
'8.5' => [
RemoveLogTypes::class,
],
'9.2' => [
RemoveCacheTokensAttribute::class,
IntroduceCoverageElement::class,
MoveAttributesFromRootToCoverage::class,
MoveAttributesFromFilterWhitelistToCoverage::class,
MoveWhitelistIncludesToCoverage::class,
MoveWhitelistExcludesToCoverage::class,
RemoveEmptyFilter::class,
CoverageCloverToReport::class,
CoverageCrap4jToReport::class,
CoverageHtmlToReport::class,
CoveragePhpToReport::class,
CoverageTextToReport::class,
CoverageXmlToReport::class,
ConvertLogTypes::class,
],
'9.5' => [
RemoveListeners::class,
RemoveTestSuiteLoaderAttributes::class,
RemoveCacheResultFileAttribute::class,
RemoveCoverageElementCacheDirectoryAttribute::class,
RemoveCoverageElementProcessUncoveredFilesAttribute::class,
IntroduceCacheDirectoryAttribute::class,
RenameBackupStaticAttributesAttribute::class,
RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute::class,
RemoveBeStrictAboutTodoAnnotatedTestsAttribute::class,
RemovePrinterAttributes::class,
RemoveVerboseAttribute::class,
RenameForceCoversAnnotationAttribute::class,
RenameBeStrictAboutCoversAnnotationAttribute::class,
RemoveConversionToExceptionsAttributes::class,
RemoveNoInteractionAttribute::class,
RemoveLoggingElements::class,
RemoveTestDoxGroupsElement::class,
],
'10.0' => [
MoveCoverageDirectoriesToSource::class,
],
];
/**
* @throws MigrationBuilderException
*/
public function build(string $fromVersion): array
{
$stack = [new UpdateSchemaLocation];
foreach (self::AVAILABLE_MIGRATIONS as $version => $migrations) {
if (version_compare($version, $fromVersion, '<')) {
continue;
}
foreach ($migrations as $migration) {
$stack[] = new $migration;
}
}
return $stack;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/MigrationException.php 0000644 00000001011 15243417753 0022031 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveAttributesFromFilterWhitelistToCoverage.php 0000644 00000002625 15243417753 0031115 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveAttributesFromFilterWhitelistToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if (!$whitelist) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$map = [
'addUncoveredFilesFromWhitelist' => 'includeUncoveredFiles',
'processUncoveredFilesFromWhitelist' => 'processUncoveredFiles',
];
foreach ($map as $old => $new) {
if (!$whitelist->hasAttribute($old)) {
continue;
}
$coverage->setAttribute($new, $whitelist->getAttribute($old));
$whitelist->removeAttribute($old);
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoverageCrap4jToReport.php 0000644 00000001573 15243417753 0024650 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageCrap4jToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-crap4j';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$crap4j = $logNode->ownerDocument->createElement('crap4j');
$crap4j->setAttribute('outputFile', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $crap4j, ['threshold']);
return $crap4j;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCoverageElementCacheDirectoryAttribute.php 0000644 00000001550 15243417753 0031206 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCoverageElementCacheDirectoryAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('coverage')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
if ($node->hasAttribute('cacheDirectory')) {
$node->removeAttribute('cacheDirectory');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/MoveWhitelistIncludesToCoverage.php 0000644 00000002627 15243417753 0026624 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveWhitelistIncludesToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist === null) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$include = $document->createElement('include');
$coverage->appendChild($include);
foreach (SnapshotNodeList::fromNodeList($whitelist->childNodes) as $child) {
if (!$child instanceof DOMElement) {
continue;
}
if (!($child->nodeName === 'directory' || $child->nodeName === 'file')) {
continue;
}
$include->appendChild($child);
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/IntroduceCoverageElement.php 0000644 00000001342 15243417753 0025266 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IntroduceCoverageElement implements Migration
{
public function migrate(DOMDocument $document): void
{
$coverage = $document->createElement('coverage');
$document->documentElement->insertBefore(
$coverage,
$document->documentElement->firstChild,
);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/ConvertLogTypes.php 0000644 00000002764 15243417753 0023464 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConvertLogTypes implements Migration
{
public function migrate(DOMDocument $document): void
{
$logging = $document->getElementsByTagName('logging')->item(0);
if (!$logging instanceof DOMElement) {
return;
}
$types = [
'junit' => 'junit',
'teamcity' => 'teamcity',
'testdox-html' => 'testdoxHtml',
'testdox-text' => 'testdoxText',
'testdox-xml' => 'testdoxXml',
'plain' => 'text',
];
$logNodes = [];
foreach ($logging->getElementsByTagName('log') as $logNode) {
if (!isset($types[$logNode->getAttribute('type')])) {
continue;
}
$logNodes[] = $logNode;
}
foreach ($logNodes as $oldNode) {
$newLogNode = $document->createElement($types[$oldNode->getAttribute('type')]);
$newLogNode->setAttribute('outputFile', $oldNode->getAttribute('target'));
$logging->replaceChild($newLogNode, $oldNode);
}
}
}
Configuration/Xml/Migration/Migrations/RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute.php0000644 00000001555 15243417753 0033731 0 ustar 00 phpunit/src/TextUI <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutResourceUsageDuringSmallTests')) {
$root->removeAttribute('beStrictAboutResourceUsageDuringSmallTests');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveVerboseAttribute.php 0000644 00000001404 15243417753 0025012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveVerboseAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('verbose')) {
$root->removeAttribute('verbose');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveBeStrictAboutTodoAnnotatedTestsAttribute.php0000644 00000001514 15243417753 0031551 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveBeStrictAboutTodoAnnotatedTestsAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutTodoAnnotatedTests')) {
$root->removeAttribute('beStrictAboutTodoAnnotatedTests');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/MoveWhitelistExcludesToCoverage.php 0000644 00000004105 15243417753 0026623 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use function in_array;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveWhitelistExcludesToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist === null) {
return;
}
$excludeNodes = SnapshotNodeList::fromNodeList($whitelist->getElementsByTagName('exclude'));
if ($excludeNodes->count() === 0) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$targetExclude = $coverage->getElementsByTagName('exclude')->item(0);
if ($targetExclude === null) {
$targetExclude = $coverage->appendChild(
$document->createElement('exclude'),
);
}
foreach ($excludeNodes as $excludeNode) {
assert($excludeNode instanceof DOMElement);
foreach (SnapshotNodeList::fromNodeList($excludeNode->childNodes) as $child) {
if (!$child instanceof DOMElement || !in_array($child->nodeName, ['directory', 'file'], true)) {
continue;
}
$targetExclude->appendChild($child);
}
if ($excludeNode->getElementsByTagName('*')->count() !== 0) {
throw new MigrationException('Dangling child elements in exclude found.');
}
$whitelist->removeChild($excludeNode);
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveListeners.php 0000644 00000001406 15243417753 0023473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveListeners implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('listeners')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveConversionToExceptionsAttributes.php0000644 00000002356 15243417753 0030271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveConversionToExceptionsAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('convertDeprecationsToExceptions')) {
$root->removeAttribute('convertDeprecationsToExceptions');
}
if ($root->hasAttribute('convertErrorsToExceptions')) {
$root->removeAttribute('convertErrorsToExceptions');
}
if ($root->hasAttribute('convertNoticesToExceptions')) {
$root->removeAttribute('convertNoticesToExceptions');
}
if ($root->hasAttribute('convertWarningsToExceptions')) {
$root->removeAttribute('convertWarningsToExceptions');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/UpdateSchemaLocation.php 0000644 00000001626 15243417753 0024405 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UpdateSchemaLocation implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
$root->setAttributeNS(
'http://www.w3.org/2001/XMLSchema-instance',
'xsi:noNamespaceSchemaLocation',
'https://schema.phpunit.de/' . Version::series() . '/phpunit.xsd',
);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/IntroduceCacheDirectoryAttribute.php 0000644 00000001474 15243417753 0027003 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IntroduceCacheDirectoryAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheDirectory')) {
return;
}
$root->setAttribute('cacheDirectory', '.phpunit.cache');
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/MoveAttributesFromRootToCoverage.php 0000644 00000002572 15243417753 0026776 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveAttributesFromRootToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$map = [
'disableCodeCoverageIgnore' => 'disableCodeCoverageIgnore',
'ignoreDeprecatedCodeUnitsFromCodeCoverage' => 'ignoreDeprecatedCodeUnits',
];
$root = $document->documentElement;
assert($root instanceof DOMElement);
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
foreach ($map as $old => $new) {
if (!$root->hasAttribute($old)) {
continue;
}
$coverage->setAttribute($new, $root->getAttribute($old));
$root->removeAttribute($old);
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveLogTypes.php 0000644 00000002050 15243417753 0023265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveLogTypes implements Migration
{
public function migrate(DOMDocument $document): void
{
$logging = $document->getElementsByTagName('logging')->item(0);
if (!$logging instanceof DOMElement) {
return;
}
foreach (SnapshotNodeList::fromNodeList($logging->getElementsByTagName('log')) as $logNode) {
assert($logNode instanceof DOMElement);
switch ($logNode->getAttribute('type')) {
case 'json':
case 'tap':
$logging->removeChild($logNode);
}
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoveragePhpToReport.php 0000644 00000001444 15243417753 0024251 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoveragePhpToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-php';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$php = $logNode->ownerDocument->createElement('php');
$php->setAttribute('outputFile', $logNode->getAttribute('target'));
return $php;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RenameForceCoversAnnotationAttribute.php 0000644 00000002003 15243417753 0027626 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameForceCoversAnnotationAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('requireCoverageMetadata')) {
return;
}
if (!$root->hasAttribute('forceCoversAnnotation')) {
return;
}
$root->setAttribute('requireCoverageMetadata', $root->getAttribute('forceCoversAnnotation'));
$root->removeAttribute('forceCoversAnnotation');
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCacheTokensAttribute.php 0000644 00000001420 15243417753 0025572 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCacheTokensAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheTokens')) {
$root->removeAttribute('cacheTokens');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveTestDoxGroupsElement.php 0000644 00000001425 15243417753 0025630 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveTestDoxGroupsElement implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('testdoxGroups')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/Migration.php 0000644 00000000756 15243417753 0022305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Migration
{
public function migrate(DOMDocument $document): void;
}
src/TextUI/Configuration/Xml/Migration/Migrations/RenameBeStrictAboutCoversAnnotationAttribute.php 0000644 00000002057 15243417753 0031234 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameBeStrictAboutCoversAnnotationAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutCoverageMetadata')) {
return;
}
if (!$root->hasAttribute('beStrictAboutCoversAnnotation')) {
return;
}
$root->setAttribute('beStrictAboutCoverageMetadata', $root->getAttribute('beStrictAboutCoversAnnotation'));
$root->removeAttribute('beStrictAboutCoversAnnotation');
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveNoInteractionAttribute.php 0000644 00000001426 15243417753 0026165 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveNoInteractionAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('noInteraction')) {
$root->removeAttribute('noInteraction');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RenameBackupStaticAttributesAttribute.php 0000644 00000002005 15243417753 0030001 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameBackupStaticAttributesAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('backupStaticProperties')) {
return;
}
if (!$root->hasAttribute('backupStaticAttributes')) {
return;
}
$root->setAttribute('backupStaticProperties', $root->getAttribute('backupStaticAttributes'));
$root->removeAttribute('backupStaticAttributes');
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCacheResultFileAttribute.php 0000644 00000001434 15243417753 0026412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCacheResultFileAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheResultFile')) {
$root->removeAttribute('cacheResultFile');
}
}
}
Configuration/Xml/Migration/Migrations/RemoveCoverageElementProcessUncoveredFilesAttribute.php 0000644 00000001575 15243417753 0032601 0 ustar 00 phpunit/src/TextUI <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCoverageElementProcessUncoveredFilesAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('coverage')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
if ($node->hasAttribute('processUncoveredFiles')) {
$node->removeAttribute('processUncoveredFiles');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/LogToReportMigration.php 0000644 00000004152 15243417753 0024440 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class LogToReportMigration implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$logNode = $this->findLogNode($document);
if ($logNode === null) {
return;
}
$reportChild = $this->toReportFormat($logNode);
$report = $coverage->getElementsByTagName('report')->item(0);
if ($report === null) {
$report = $coverage->appendChild($document->createElement('report'));
}
$report->appendChild($reportChild);
$logNode->parentNode->removeChild($logNode);
}
protected function migrateAttributes(DOMElement $src, DOMElement $dest, array $attributes): void
{
foreach ($attributes as $attr) {
if (!$src->hasAttribute($attr)) {
continue;
}
$dest->setAttribute($attr, $src->getAttribute($attr));
$src->removeAttribute($attr);
}
}
abstract protected function forType(): string;
abstract protected function toReportFormat(DOMElement $logNode): DOMElement;
private function findLogNode(DOMDocument $document): ?DOMElement
{
$logNode = (new DOMXPath($document))->query(
sprintf('//logging/log[@type="%s"]', $this->forType()),
)->item(0);
if (!$logNode instanceof DOMElement) {
return null;
}
return $logNode;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveTestSuiteLoaderAttributes.php 0000644 00000001647 15243417753 0026661 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveTestSuiteLoaderAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('testSuiteLoaderClass')) {
$root->removeAttribute('testSuiteLoaderClass');
}
if ($root->hasAttribute('testSuiteLoaderFile')) {
$root->removeAttribute('testSuiteLoaderFile');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoverageCloverToReport.php 0000644 00000001467 15243417753 0024761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageCloverToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-clover';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$clover = $logNode->ownerDocument->createElement('clover');
$clover->setAttribute('outputFile', $logNode->getAttribute('target'));
return $clover;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveLoggingElements.php 0000644 00000002412 15243417753 0024604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveLoggingElements implements Migration
{
public function migrate(DOMDocument $document): void
{
$this->removeTestDoxElement($document);
$this->removeTextElement($document);
}
private function removeTestDoxElement(DOMDocument $document): void
{
$node = (new DOMXPath($document))->query('logging/testdoxXml')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
private function removeTextElement(DOMDocument $document): void
{
$node = (new DOMXPath($document))->query('logging/text')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/MoveCoverageDirectoriesToSource.php 0000644 00000003036 15243417753 0026611 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveCoverageDirectoriesToSource implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$source = $document->getElementsByTagName('source')->item(0);
if ($source !== null) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if ($coverage === null) {
return;
}
$root = $document->documentElement;
assert($root instanceof DOMElement);
$source = $document->createElement('source');
$root->appendChild($source);
$xpath = new DOMXPath($document);
foreach (['include', 'exclude'] as $element) {
foreach (SnapshotNodeList::fromNodeList($xpath->query('//coverage/' . $element)) as $node) {
$source->appendChild($node);
}
}
if ($coverage->childElementCount !== 0) {
return;
}
assert($coverage->parentNode !== null);
$coverage->parentNode->removeChild($coverage);
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemoveEmptyFilter.php 0000644 00000003032 15243417753 0023764 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveEmptyFilter implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist instanceof DOMElement) {
$this->ensureEmpty($whitelist);
$whitelist->parentNode->removeChild($whitelist);
}
$filter = $document->getElementsByTagName('filter')->item(0);
if ($filter instanceof DOMElement) {
$this->ensureEmpty($filter);
$filter->parentNode->removeChild($filter);
}
}
/**
* @throws MigrationException
*/
private function ensureEmpty(DOMElement $element): void
{
if ($element->attributes->length > 0) {
throw new MigrationException(sprintf('%s element has unexpected attributes', $element->nodeName));
}
if ($element->getElementsByTagName('*')->length > 0) {
throw new MigrationException(sprintf('%s element has unexpected children', $element->nodeName));
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/RemovePrinterAttributes.php 0000644 00000001577 15243417753 0025226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemovePrinterAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('printerClass')) {
$root->removeAttribute('printerClass');
}
if ($root->hasAttribute('printerFile')) {
$root->removeAttribute('printerFile');
}
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoverageTextToReport.php 0000644 00000001611 15243417753 0024442 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageTextToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-text';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$text = $logNode->ownerDocument->createElement('text');
$text->setAttribute('outputFile', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $text, ['showUncoveredFiles', 'showOnlySummary']);
return $text;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoverageXmlToReport.php 0000644 00000001451 15243417753 0024260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageXmlToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-xml';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$xml = $logNode->ownerDocument->createElement('xml');
$xml->setAttribute('outputDirectory', $logNode->getAttribute('target'));
return $xml;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrations/CoverageHtmlToReport.php 0000644 00000001610 15243417753 0024421 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageHtmlToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-html';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$html = $logNode->ownerDocument->createElement('html');
$html->setAttribute('outputDirectory', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $html, ['lowUpperBound', 'highLowerBound']);
return $html;
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/MigrationBuilderException.php 0000644 00000001020 15243417753 0023340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationBuilderException extends RuntimeException implements Exception
{
}
phpunit/src/TextUI/Configuration/Xml/Migration/Migrator.php 0000644 00000002670 15243417753 0020021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Runner\Version;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Migrator
{
/**
* @throws Exception
* @throws MigrationBuilderException
* @throws MigrationException
* @throws XmlException
*/
public function migrate(string $filename): string
{
$origin = (new SchemaDetector)->detect($filename);
if (!$origin->detected()) {
throw new Exception('The file does not validate against any know schema');
}
if ($origin->version() === Version::series()) {
throw new Exception('The file does not need to be migrated');
}
$configurationDocument = (new XmlLoader)->loadFile($filename);
foreach ((new MigrationBuilder)->build($origin->version()) as $migration) {
$migration->migrate($configurationDocument);
}
$configurationDocument->formatOutput = true;
$configurationDocument->preserveWhiteSpace = false;
return $configurationDocument->saveXML();
}
}
phpunit/src/TextUI/Configuration/Xml/Migration/SnapshotNodeList.php 0000644 00000002146 15243417753 0021474 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function count;
use ArrayIterator;
use Countable;
use DOMNode;
use DOMNodeList;
use IteratorAggregate;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @template-implements IteratorAggregate<int, DOMNode>
*/
final class SnapshotNodeList implements Countable, IteratorAggregate
{
/**
* @psalm-var list<DOMNode>
*/
private array $nodes = [];
public static function fromNodeList(DOMNodeList $list): self
{
$snapshot = new self;
foreach ($list as $node) {
$snapshot->nodes[] = $node;
}
return $snapshot;
}
public function count(): int
{
return count($this->nodes);
}
public function getIterator(): ArrayIterator
{
return new ArrayIterator($this->nodes);
}
}
phpunit/src/TextUI/Configuration/Xml/SchemaDetector/SchemaDetector.php 0000644 00000002055 15243417753 0022065 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Util\Xml\Loader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SchemaDetector
{
/**
* @throws XmlException
*/
public function detect(string $filename): SchemaDetectionResult
{
$document = (new Loader)->loadFile($filename);
$schemaFinder = new SchemaFinder;
foreach ($schemaFinder->available() as $candidate) {
$schema = (new SchemaFinder)->find($candidate);
if (!(new Validator)->validate($document, $schema)->hasValidationErrors()) {
return new SuccessfulSchemaDetectionResult($candidate);
}
}
return new FailedSchemaDetectionResult;
}
}
phpunit/src/TextUI/Configuration/Xml/SchemaDetector/FailedSchemaDetectionResult.php 0000644 00000000753 15243417753 0024541 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class FailedSchemaDetectionResult extends SchemaDetectionResult
{
}
phpunit/src/TextUI/Configuration/Xml/SchemaDetector/SchemaDetectionResult.php 0000644 00000001453 15243417753 0023432 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class SchemaDetectionResult
{
/**
* @psalm-assert-if-true SuccessfulSchemaDetectionResult $this
*/
public function detected(): bool
{
return false;
}
/**
* @throws XmlException
*/
public function version(): string
{
throw new XmlException('No supported schema was detected');
}
}
phpunit/src/TextUI/Configuration/Xml/SchemaDetector/SuccessfulSchemaDetectionResult.php 0000644 00000002011 15243417753 0025461 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class SuccessfulSchemaDetectionResult extends SchemaDetectionResult
{
/**
* @psalm-var non-empty-string
*/
private readonly string $version;
/**
* @psalm-param non-empty-string $version
*/
public function __construct(string $version)
{
$this->version = $version;
}
/**
* @psalm-assert-if-true SuccessfulSchemaDetectionResult $this
*/
public function detected(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function version(): string
{
return $this->version;
}
}
phpunit/src/TextUI/Configuration/Xml/Loader.php 0000644 00000112405 15243417753 0015510 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use const DIRECTORY_SEPARATOR;
use const PHP_VERSION;
use function assert;
use function defined;
use function dirname;
use function explode;
use function is_numeric;
use function preg_match;
use function realpath;
use function str_contains;
use function str_starts_with;
use function strlen;
use function strtolower;
use function substr;
use function trim;
use DOMDocument;
use DOMElement;
use DOMNode;
use DOMXPath;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Runner\Version;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\Constant;
use PHPUnit\TextUI\Configuration\ConstantCollection;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\DirectoryCollection;
use PHPUnit\TextUI\Configuration\ExtensionBootstrap;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\File;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectory;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection;
use PHPUnit\TextUI\Configuration\Group;
use PHPUnit\TextUI\Configuration\GroupCollection;
use PHPUnit\TextUI\Configuration\IniSetting;
use PHPUnit\TextUI\Configuration\IniSettingCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestDirectory;
use PHPUnit\TextUI\Configuration\TestDirectoryCollection;
use PHPUnit\TextUI\Configuration\TestFile;
use PHPUnit\TextUI\Configuration\TestFileCollection;
use PHPUnit\TextUI\Configuration\TestSuite as TestSuiteConfiguration;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\Configuration\Variable;
use PHPUnit\TextUI\Configuration\VariableCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Clover;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Cobertura;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Crap4j;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Html as CodeCoverageHtml;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Php as CodeCoveragePhp;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Text as CodeCoverageText;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Xml as CodeCoverageXml;
use PHPUnit\TextUI\XmlConfiguration\Logging\Junit;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
use PHPUnit\TextUI\XmlConfiguration\Logging\TeamCity;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Html as TestDoxHtml;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Text as TestDoxText;
use PHPUnit\Util\VersionComparisonOperator;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Loader
{
/**
* @throws Exception
*/
public function load(string $filename): LoadedFromFileConfiguration
{
try {
$document = (new XmlLoader)->loadFile($filename);
} catch (XmlException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$xpath = new DOMXPath($document);
try {
$xsdFilename = (new SchemaFinder)->find(Version::series());
} catch (CannotFindSchemaException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$configurationFileRealpath = realpath($filename);
return new LoadedFromFileConfiguration(
$configurationFileRealpath,
(new Validator)->validate($document, $xsdFilename),
$this->extensions($xpath),
$this->source($configurationFileRealpath, $xpath),
$this->codeCoverage($configurationFileRealpath, $xpath),
$this->groups($xpath),
$this->logging($configurationFileRealpath, $xpath),
$this->php($configurationFileRealpath, $xpath),
$this->phpunit($configurationFileRealpath, $document),
$this->testSuite($configurationFileRealpath, $xpath),
);
}
private function logging(string $filename, DOMXPath $xpath): Logging
{
$junit = null;
$element = $this->element($xpath, 'logging/junit');
if ($element) {
$junit = new Junit(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$teamCity = null;
$element = $this->element($xpath, 'logging/teamcity');
if ($element) {
$teamCity = new TeamCity(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$testDoxHtml = null;
$element = $this->element($xpath, 'logging/testdoxHtml');
if ($element) {
$testDoxHtml = new TestDoxHtml(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$testDoxText = null;
$element = $this->element($xpath, 'logging/testdoxText');
if ($element) {
$testDoxText = new TestDoxText(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
return new Logging(
$junit,
$teamCity,
$testDoxHtml,
$testDoxText,
);
}
private function extensions(DOMXPath $xpath): ExtensionBootstrapCollection
{
$extensionBootstrappers = [];
foreach ($xpath->query('extensions/bootstrap') as $bootstrap) {
assert($bootstrap instanceof DOMElement);
$parameters = [];
foreach ($xpath->query('parameter', $bootstrap) as $parameter) {
assert($parameter instanceof DOMElement);
$parameters[$parameter->getAttribute('name')] = $parameter->getAttribute('value');
}
$extensionBootstrappers[] = new ExtensionBootstrap(
$bootstrap->getAttribute('class'),
$parameters,
);
}
return ExtensionBootstrapCollection::fromArray($extensionBootstrappers);
}
/**
* @psalm-return non-empty-string
*/
private function toAbsolutePath(string $filename, string $path): string
{
$path = trim($path);
if (str_starts_with($path, '/')) {
return $path;
}
// Matches the following on Windows:
// - \\NetworkComputer\Path
// - \\.\D:
// - \\.\c:
// - C:\Windows
// - C:\windows
// - C:/windows
// - c:/windows
if (defined('PHP_WINDOWS_VERSION_BUILD') &&
!empty($path) &&
($path[0] === '\\' || (strlen($path) >= 3 && preg_match('#^[A-Z]:[/\\\]#i', substr($path, 0, 3))))) {
return $path;
}
if (str_contains($path, '://')) {
return $path;
}
return dirname($filename) . DIRECTORY_SEPARATOR . $path;
}
private function source(string $filename, DOMXPath $xpath): Source
{
$baseline = null;
$restrictDeprecations = false;
$restrictNotices = false;
$restrictWarnings = false;
$ignoreSuppressionOfDeprecations = false;
$ignoreSuppressionOfPhpDeprecations = false;
$ignoreSuppressionOfErrors = false;
$ignoreSuppressionOfNotices = false;
$ignoreSuppressionOfPhpNotices = false;
$ignoreSuppressionOfWarnings = false;
$ignoreSuppressionOfPhpWarnings = false;
$element = $this->element($xpath, 'source');
if ($element) {
$baseline = $this->getStringAttribute($element, 'baseline');
if ($baseline !== null) {
$baseline = $this->toAbsolutePath($filename, $baseline);
}
$restrictDeprecations = $this->getBooleanAttribute($element, 'restrictDeprecations', false);
$restrictNotices = $this->getBooleanAttribute($element, 'restrictNotices', false);
$restrictWarnings = $this->getBooleanAttribute($element, 'restrictWarnings', false);
$ignoreSuppressionOfDeprecations = $this->getBooleanAttribute($element, 'ignoreSuppressionOfDeprecations', false);
$ignoreSuppressionOfPhpDeprecations = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpDeprecations', false);
$ignoreSuppressionOfErrors = $this->getBooleanAttribute($element, 'ignoreSuppressionOfErrors', false);
$ignoreSuppressionOfNotices = $this->getBooleanAttribute($element, 'ignoreSuppressionOfNotices', false);
$ignoreSuppressionOfPhpNotices = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpNotices', false);
$ignoreSuppressionOfWarnings = $this->getBooleanAttribute($element, 'ignoreSuppressionOfWarnings', false);
$ignoreSuppressionOfPhpWarnings = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpWarnings', false);
}
return new Source(
$baseline,
false,
$this->readFilterDirectories($filename, $xpath, 'source/include/directory'),
$this->readFilterFiles($filename, $xpath, 'source/include/file'),
$this->readFilterDirectories($filename, $xpath, 'source/exclude/directory'),
$this->readFilterFiles($filename, $xpath, 'source/exclude/file'),
$restrictDeprecations,
$restrictNotices,
$restrictWarnings,
$ignoreSuppressionOfDeprecations,
$ignoreSuppressionOfPhpDeprecations,
$ignoreSuppressionOfErrors,
$ignoreSuppressionOfNotices,
$ignoreSuppressionOfPhpNotices,
$ignoreSuppressionOfWarnings,
$ignoreSuppressionOfPhpWarnings,
);
}
private function codeCoverage(string $filename, DOMXPath $xpath): CodeCoverage
{
$cacheDirectory = null;
$pathCoverage = false;
$includeUncoveredFiles = true;
$ignoreDeprecatedCodeUnits = false;
$disableCodeCoverageIgnore = false;
$element = $this->element($xpath, 'coverage');
if ($element) {
$cacheDirectory = $this->getStringAttribute($element, 'cacheDirectory');
if ($cacheDirectory !== null) {
$cacheDirectory = new Directory(
$this->toAbsolutePath($filename, $cacheDirectory),
);
}
$pathCoverage = $this->getBooleanAttribute(
$element,
'pathCoverage',
false,
);
$includeUncoveredFiles = $this->getBooleanAttribute(
$element,
'includeUncoveredFiles',
true,
);
$ignoreDeprecatedCodeUnits = $this->getBooleanAttribute(
$element,
'ignoreDeprecatedCodeUnits',
false,
);
$disableCodeCoverageIgnore = $this->getBooleanAttribute(
$element,
'disableCodeCoverageIgnore',
false,
);
}
$clover = null;
$element = $this->element($xpath, 'coverage/report/clover');
if ($element) {
$clover = new Clover(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$cobertura = null;
$element = $this->element($xpath, 'coverage/report/cobertura');
if ($element) {
$cobertura = new Cobertura(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$crap4j = null;
$element = $this->element($xpath, 'coverage/report/crap4j');
if ($element) {
$crap4j = new Crap4j(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
$this->getIntegerAttribute($element, 'threshold', 30),
);
}
$html = null;
$element = $this->element($xpath, 'coverage/report/html');
if ($element) {
$defaultColors = Colors::default();
$defaultThresholds = Thresholds::default();
$html = new CodeCoverageHtml(
new Directory(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputDirectory'),
),
),
$this->getIntegerAttribute($element, 'lowUpperBound', $defaultThresholds->lowUpperBound()),
$this->getIntegerAttribute($element, 'highLowerBound', $defaultThresholds->highLowerBound()),
$this->getStringAttributeWithDefault($element, 'colorSuccessLow', $defaultColors->successLow()),
$this->getStringAttributeWithDefault($element, 'colorSuccessMedium', $defaultColors->successMedium()),
$this->getStringAttributeWithDefault($element, 'colorSuccessHigh', $defaultColors->successHigh()),
$this->getStringAttributeWithDefault($element, 'colorWarning', $defaultColors->warning()),
$this->getStringAttributeWithDefault($element, 'colorDanger', $defaultColors->danger()),
$this->getStringAttribute($element, 'customCssFile'),
);
}
$php = null;
$element = $this->element($xpath, 'coverage/report/php');
if ($element) {
$php = new CodeCoveragePhp(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$text = null;
$element = $this->element($xpath, 'coverage/report/text');
if ($element) {
$text = new CodeCoverageText(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
$this->getBooleanAttribute($element, 'showUncoveredFiles', false),
$this->getBooleanAttribute($element, 'showOnlySummary', false),
);
}
$xml = null;
$element = $this->element($xpath, 'coverage/report/xml');
if ($element) {
$xml = new CodeCoverageXml(
new Directory(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputDirectory'),
),
),
);
}
return new CodeCoverage(
$cacheDirectory,
$this->readFilterDirectories($filename, $xpath, 'coverage/include/directory'),
$this->readFilterFiles($filename, $xpath, 'coverage/include/file'),
$this->readFilterDirectories($filename, $xpath, 'coverage/exclude/directory'),
$this->readFilterFiles($filename, $xpath, 'coverage/exclude/file'),
$pathCoverage,
$includeUncoveredFiles,
$ignoreDeprecatedCodeUnits,
$disableCodeCoverageIgnore,
$clover,
$cobertura,
$crap4j,
$html,
$php,
$text,
$xml,
);
}
private function getBoolean(string $value, bool $default): bool
{
if (strtolower($value) === 'false') {
return false;
}
if (strtolower($value) === 'true') {
return true;
}
return $default;
}
private function getValue(string $value): bool|string
{
if (strtolower($value) === 'false') {
return false;
}
if (strtolower($value) === 'true') {
return true;
}
return $value;
}
private function readFilterDirectories(string $filename, DOMXPath $xpath, string $query): FilterDirectoryCollection
{
$directories = [];
foreach ($xpath->query($query) as $directoryNode) {
assert($directoryNode instanceof DOMElement);
$directoryPath = $directoryNode->textContent;
if (!$directoryPath) {
continue;
}
$directories[] = new FilterDirectory(
$this->toAbsolutePath($filename, $directoryPath),
$directoryNode->hasAttribute('prefix') ? $directoryNode->getAttribute('prefix') : '',
$directoryNode->hasAttribute('suffix') ? $directoryNode->getAttribute('suffix') : '.php',
);
}
return FilterDirectoryCollection::fromArray($directories);
}
private function readFilterFiles(string $filename, DOMXPath $xpath, string $query): FileCollection
{
$files = [];
foreach ($xpath->query($query) as $file) {
assert($file instanceof DOMNode);
$filePath = $file->textContent;
if ($filePath) {
$files[] = new File($this->toAbsolutePath($filename, $filePath));
}
}
return FileCollection::fromArray($files);
}
private function groups(DOMXPath $xpath): Groups
{
$include = [];
$exclude = [];
foreach ($xpath->query('groups/include/group') as $group) {
assert($group instanceof DOMNode);
$include[] = new Group($group->textContent);
}
foreach ($xpath->query('groups/exclude/group') as $group) {
assert($group instanceof DOMNode);
$exclude[] = new Group($group->textContent);
}
return new Groups(
GroupCollection::fromArray($include),
GroupCollection::fromArray($exclude),
);
}
private function getBooleanAttribute(DOMElement $element, string $attribute, bool $default): bool
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $this->getBoolean(
$element->getAttribute($attribute),
false,
);
}
private function getIntegerAttribute(DOMElement $element, string $attribute, int $default): int
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $this->getInteger(
$element->getAttribute($attribute),
$default,
);
}
private function getStringAttribute(DOMElement $element, string $attribute): ?string
{
if (!$element->hasAttribute($attribute)) {
return null;
}
return $element->getAttribute($attribute);
}
private function getStringAttributeWithDefault(DOMElement $element, string $attribute, string $default): string
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $element->getAttribute($attribute);
}
private function getInteger(string $value, int $default): int
{
if (is_numeric($value)) {
return (int) $value;
}
return $default;
}
private function php(string $filename, DOMXPath $xpath): Php
{
$includePaths = [];
foreach ($xpath->query('php/includePath') as $includePath) {
assert($includePath instanceof DOMNode);
$path = $includePath->textContent;
if ($path) {
$includePaths[] = new Directory($this->toAbsolutePath($filename, $path));
}
}
$iniSettings = [];
foreach ($xpath->query('php/ini') as $ini) {
assert($ini instanceof DOMElement);
$iniSettings[] = new IniSetting(
$ini->getAttribute('name'),
$ini->getAttribute('value'),
);
}
$constants = [];
foreach ($xpath->query('php/const') as $const) {
assert($const instanceof DOMElement);
$value = $const->getAttribute('value');
$constants[] = new Constant(
$const->getAttribute('name'),
$this->getValue($value),
);
}
$variables = [
'var' => [],
'env' => [],
'post' => [],
'get' => [],
'cookie' => [],
'server' => [],
'files' => [],
'request' => [],
];
foreach (['var', 'env', 'post', 'get', 'cookie', 'server', 'files', 'request'] as $array) {
foreach ($xpath->query('php/' . $array) as $var) {
assert($var instanceof DOMElement);
$name = $var->getAttribute('name');
$value = $var->getAttribute('value');
$force = false;
$verbatim = false;
if ($var->hasAttribute('force')) {
$force = $this->getBoolean($var->getAttribute('force'), false);
}
if ($var->hasAttribute('verbatim')) {
$verbatim = $this->getBoolean($var->getAttribute('verbatim'), false);
}
if (!$verbatim) {
$value = $this->getValue($value);
}
$variables[$array][] = new Variable($name, $value, $force);
}
}
return new Php(
DirectoryCollection::fromArray($includePaths),
IniSettingCollection::fromArray($iniSettings),
ConstantCollection::fromArray($constants),
VariableCollection::fromArray($variables['var']),
VariableCollection::fromArray($variables['env']),
VariableCollection::fromArray($variables['post']),
VariableCollection::fromArray($variables['get']),
VariableCollection::fromArray($variables['cookie']),
VariableCollection::fromArray($variables['server']),
VariableCollection::fromArray($variables['files']),
VariableCollection::fromArray($variables['request']),
);
}
private function phpunit(string $filename, DOMDocument $document): PHPUnit
{
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$defectsFirst = false;
$resolveDependencies = $this->getBooleanAttribute($document->documentElement, 'resolveDependencies', true);
if ($document->documentElement->hasAttribute('executionOrder')) {
foreach (explode(',', $document->documentElement->getAttribute('executionOrder')) as $order) {
switch ($order) {
case 'default':
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$defectsFirst = false;
$resolveDependencies = true;
break;
case 'depends':
$resolveDependencies = true;
break;
case 'no-depends':
$resolveDependencies = false;
break;
case 'defects':
$defectsFirst = true;
break;
case 'duration':
$executionOrder = TestSuiteSorter::ORDER_DURATION;
break;
case 'random':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case 'reverse':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case 'size':
$executionOrder = TestSuiteSorter::ORDER_SIZE;
break;
}
}
}
$cacheDirectory = $this->getStringAttribute($document->documentElement, 'cacheDirectory');
if ($cacheDirectory !== null) {
$cacheDirectory = $this->toAbsolutePath($filename, $cacheDirectory);
}
$cacheResultFile = $this->getStringAttribute($document->documentElement, 'cacheResultFile');
if ($cacheResultFile !== null) {
$cacheResultFile = $this->toAbsolutePath($filename, $cacheResultFile);
}
$bootstrap = $this->getStringAttribute($document->documentElement, 'bootstrap');
if ($bootstrap !== null) {
$bootstrap = $this->toAbsolutePath($filename, $bootstrap);
}
$extensionsDirectory = $this->getStringAttribute($document->documentElement, 'extensionsDirectory');
if ($extensionsDirectory !== null) {
$extensionsDirectory = $this->toAbsolutePath($filename, $extensionsDirectory);
}
$backupStaticProperties = false;
if ($document->documentElement->hasAttribute('backupStaticProperties')) {
$backupStaticProperties = $this->getBooleanAttribute($document->documentElement, 'backupStaticProperties', false);
} elseif ($document->documentElement->hasAttribute('backupStaticAttributes')) {
$backupStaticProperties = $this->getBooleanAttribute($document->documentElement, 'backupStaticAttributes', false);
}
$requireCoverageMetadata = false;
if ($document->documentElement->hasAttribute('requireCoverageMetadata')) {
$requireCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'requireCoverageMetadata', false);
} elseif ($document->documentElement->hasAttribute('forceCoversAnnotation')) {
$requireCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'forceCoversAnnotation', false);
}
$beStrictAboutCoverageMetadata = false;
if ($document->documentElement->hasAttribute('beStrictAboutCoverageMetadata')) {
$beStrictAboutCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'beStrictAboutCoverageMetadata', false);
} elseif ($document->documentElement->hasAttribute('forceCoversAnnotation')) {
$beStrictAboutCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'beStrictAboutCoversAnnotation', false);
}
return new PHPUnit(
$cacheDirectory,
$this->getBooleanAttribute($document->documentElement, 'cacheResult', true),
$cacheResultFile,
$this->getColumns($document),
$this->getColors($document),
$this->getBooleanAttribute($document->documentElement, 'stderr', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnIncompleteTests', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnSkippedTests', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerDeprecations', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerErrors', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerNotices', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerWarnings', false),
$this->getBooleanAttribute($document->documentElement, 'reverseDefectList', false),
$requireCoverageMetadata,
$bootstrap,
$this->getBooleanAttribute($document->documentElement, 'processIsolation', false),
$this->getBooleanAttribute($document->documentElement, 'failOnDeprecation', false),
$this->getBooleanAttribute($document->documentElement, 'failOnEmptyTestSuite', false),
$this->getBooleanAttribute($document->documentElement, 'failOnIncomplete', false),
$this->getBooleanAttribute($document->documentElement, 'failOnNotice', false),
$this->getBooleanAttribute($document->documentElement, 'failOnRisky', false),
$this->getBooleanAttribute($document->documentElement, 'failOnSkipped', false),
$this->getBooleanAttribute($document->documentElement, 'failOnWarning', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnDefect', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnDeprecation', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnError', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnFailure', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnIncomplete', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnNotice', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnRisky', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnSkipped', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnWarning', false),
$extensionsDirectory,
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutChangesToGlobalState', false),
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutOutputDuringTests', false),
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutTestsThatDoNotTestAnything', true),
$beStrictAboutCoverageMetadata,
$this->getBooleanAttribute($document->documentElement, 'enforceTimeLimit', false),
$this->getIntegerAttribute($document->documentElement, 'defaultTimeLimit', 1),
$this->getIntegerAttribute($document->documentElement, 'timeoutForSmallTests', 1),
$this->getIntegerAttribute($document->documentElement, 'timeoutForMediumTests', 10),
$this->getIntegerAttribute($document->documentElement, 'timeoutForLargeTests', 60),
$this->getStringAttribute($document->documentElement, 'defaultTestSuite'),
$executionOrder,
$resolveDependencies,
$defectsFirst,
$this->getBooleanAttribute($document->documentElement, 'backupGlobals', false),
$backupStaticProperties,
$this->getBooleanAttribute($document->documentElement, 'registerMockObjectsFromTestArgumentsRecursively', false),
$this->getBooleanAttribute($document->documentElement, 'testdox', false),
$this->getBooleanAttribute($document->documentElement, 'controlGarbageCollector', false),
$this->getIntegerAttribute($document->documentElement, 'numberOfTestsBeforeGarbageCollection', 100),
);
}
private function getColors(DOMDocument $document): string
{
$colors = Configuration::COLOR_DEFAULT;
if ($document->documentElement->hasAttribute('colors')) {
/* only allow boolean for compatibility with previous versions
'always' only allowed from command line */
if ($this->getBoolean($document->documentElement->getAttribute('colors'), false)) {
$colors = Configuration::COLOR_AUTO;
} else {
$colors = Configuration::COLOR_NEVER;
}
}
return $colors;
}
private function getColumns(DOMDocument $document): int|string
{
$columns = 80;
if ($document->documentElement->hasAttribute('columns')) {
$columns = $document->documentElement->getAttribute('columns');
if ($columns !== 'max') {
$columns = $this->getInteger($columns, 80);
}
}
return $columns;
}
private function testSuite(string $filename, DOMXPath $xpath): TestSuiteCollection
{
$testSuites = [];
foreach ($this->getTestSuiteElements($xpath) as $element) {
$exclude = [];
foreach ($element->getElementsByTagName('exclude') as $excludeNode) {
$excludeFile = $excludeNode->textContent;
if ($excludeFile) {
$exclude[] = new File($this->toAbsolutePath($filename, $excludeFile));
}
}
$directories = [];
foreach ($element->getElementsByTagName('directory') as $directoryNode) {
assert($directoryNode instanceof DOMElement);
$directory = $directoryNode->textContent;
if (empty($directory)) {
continue;
}
$prefix = '';
if ($directoryNode->hasAttribute('prefix')) {
$prefix = $directoryNode->getAttribute('prefix');
}
$suffix = 'Test.php';
if ($directoryNode->hasAttribute('suffix')) {
$suffix = $directoryNode->getAttribute('suffix');
}
$phpVersion = PHP_VERSION;
if ($directoryNode->hasAttribute('phpVersion')) {
$phpVersion = $directoryNode->getAttribute('phpVersion');
}
$phpVersionOperator = new VersionComparisonOperator('>=');
if ($directoryNode->hasAttribute('phpVersionOperator')) {
$phpVersionOperator = new VersionComparisonOperator($directoryNode->getAttribute('phpVersionOperator'));
}
$directories[] = new TestDirectory(
$this->toAbsolutePath($filename, $directory),
$prefix,
$suffix,
$phpVersion,
$phpVersionOperator,
);
}
$files = [];
foreach ($element->getElementsByTagName('file') as $fileNode) {
assert($fileNode instanceof DOMElement);
$file = $fileNode->textContent;
if (empty($file)) {
continue;
}
$phpVersion = PHP_VERSION;
if ($fileNode->hasAttribute('phpVersion')) {
$phpVersion = $fileNode->getAttribute('phpVersion');
}
$phpVersionOperator = new VersionComparisonOperator('>=');
if ($fileNode->hasAttribute('phpVersionOperator')) {
$phpVersionOperator = new VersionComparisonOperator($fileNode->getAttribute('phpVersionOperator'));
}
$files[] = new TestFile(
$this->toAbsolutePath($filename, $file),
$phpVersion,
$phpVersionOperator,
);
}
$name = $element->getAttribute('name');
assert(!empty($name));
$testSuites[] = new TestSuiteConfiguration(
$name,
TestDirectoryCollection::fromArray($directories),
TestFileCollection::fromArray($files),
FileCollection::fromArray($exclude),
);
}
return TestSuiteCollection::fromArray($testSuites);
}
/**
* @psalm-return list<DOMElement>
*/
private function getTestSuiteElements(DOMXPath $xpath): array
{
$elements = [];
$testSuiteNodes = $xpath->query('testsuites/testsuite');
if ($testSuiteNodes->length === 0) {
$testSuiteNodes = $xpath->query('testsuite');
}
if ($testSuiteNodes->length === 1) {
$element = $testSuiteNodes->item(0);
assert($element instanceof DOMElement);
$elements[] = $element;
} else {
foreach ($testSuiteNodes as $testSuiteNode) {
assert($testSuiteNode instanceof DOMElement);
$elements[] = $testSuiteNode;
}
}
return $elements;
}
private function element(DOMXPath $xpath, string $element): ?DOMElement
{
$nodes = $xpath->query($element);
if ($nodes->length === 1) {
$node = $nodes->item(0);
assert($node instanceof DOMElement);
return $node;
}
return null;
}
}
phpunit/src/TextUI/Configuration/Xml/Generator.php 0000644 00000004003 15243417753 0016222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function str_replace;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
/**
* @var string
*/
private const TEMPLATE = <<<'EOT'
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/{phpunit_version}/phpunit.xsd"
bootstrap="{bootstrap_script}"
cacheDirectory="{cache_directory}"
executionOrder="depends,defects"
requireCoverageMetadata="true"
beStrictAboutCoverageMetadata="true"
beStrictAboutOutputDuringTests="true"
failOnRisky="true"
failOnWarning="true">
<testsuites>
<testsuite name="default">
<directory>{tests_directory}</directory>
</testsuite>
</testsuites>
<source restrictDeprecations="true" restrictNotices="true" restrictWarnings="true">
<include>
<directory>{src_directory}</directory>
</include>
</source>
</phpunit>
EOT;
public function generateDefaultConfiguration(string $phpunitVersion, string $bootstrapScript, string $testsDirectory, string $srcDirectory, string $cacheDirectory): string
{
return str_replace(
[
'{phpunit_version}',
'{bootstrap_script}',
'{tests_directory}',
'{src_directory}',
'{cache_directory}',
],
[
$phpunitVersion,
$bootstrapScript,
$testsDirectory,
$srcDirectory,
$cacheDirectory,
],
self::TEMPLATE,
);
}
}
phpunit/src/TextUI/Configuration/Xml/DefaultConfiguration.php 0000644 00000011217 15243417753 0020415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\Configuration\ConstantCollection;
use PHPUnit\TextUI\Configuration\DirectoryCollection;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection as CodeCoverageFilterDirectoryCollection;
use PHPUnit\TextUI\Configuration\GroupCollection;
use PHPUnit\TextUI\Configuration\IniSettingCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\Configuration\VariableCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class DefaultConfiguration extends Configuration
{
public static function create(): self
{
return new self(
ExtensionBootstrapCollection::fromArray([]),
new Source(
null,
false,
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
),
new CodeCoverage(
null,
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
false,
true,
false,
false,
null,
null,
null,
null,
null,
null,
null,
),
new Groups(
GroupCollection::fromArray([]),
GroupCollection::fromArray([]),
),
new Logging(
null,
null,
null,
null,
),
new Php(
DirectoryCollection::fromArray([]),
IniSettingCollection::fromArray([]),
ConstantCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
),
new PHPUnit(
null,
true,
null,
80,
\PHPUnit\TextUI\Configuration\Configuration::COLOR_DEFAULT,
false,
false,
false,
false,
false,
false,
false,
false,
false,
null,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
null,
false,
false,
true,
false,
false,
1,
1,
10,
60,
null,
TestSuiteSorter::ORDER_DEFAULT,
true,
false,
false,
false,
false,
false,
false,
100,
),
TestSuiteCollection::fromArray([]),
);
}
public function isDefault(): bool
{
return true;
}
}
phpunit/src/TextUI/Configuration/Xml/Configuration.php 0000644 00000005155 15243417753 0017114 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class Configuration
{
private readonly ExtensionBootstrapCollection $extensions;
private readonly Source $source;
private readonly CodeCoverage $codeCoverage;
private readonly Groups $groups;
private readonly Logging $logging;
private readonly Php $php;
private readonly PHPUnit $phpunit;
private readonly TestSuiteCollection $testSuite;
public function __construct(ExtensionBootstrapCollection $extensions, Source $source, CodeCoverage $codeCoverage, Groups $groups, Logging $logging, Php $php, PHPUnit $phpunit, TestSuiteCollection $testSuite)
{
$this->extensions = $extensions;
$this->source = $source;
$this->codeCoverage = $codeCoverage;
$this->groups = $groups;
$this->logging = $logging;
$this->php = $php;
$this->phpunit = $phpunit;
$this->testSuite = $testSuite;
}
public function extensions(): ExtensionBootstrapCollection
{
return $this->extensions;
}
public function source(): Source
{
return $this->source;
}
public function codeCoverage(): CodeCoverage
{
return $this->codeCoverage;
}
public function groups(): Groups
{
return $this->groups;
}
public function logging(): Logging
{
return $this->logging;
}
public function php(): Php
{
return $this->php;
}
public function phpunit(): PHPUnit
{
return $this->phpunit;
}
public function testSuite(): TestSuiteCollection
{
return $this->testSuite;
}
/**
* @psalm-assert-if-true DefaultConfiguration $this
*/
public function isDefault(): bool
{
return false;
}
/**
* @psalm-assert-if-true LoadedFromFileConfiguration $this
*/
public function wasLoadedFromFile(): bool
{
return false;
}
}
phpunit/src/TextUI/Configuration/Xml/Groups.php 0000644 00000002144 15243417753 0015557 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\GroupCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Groups
{
private readonly GroupCollection $include;
private readonly GroupCollection $exclude;
public function __construct(GroupCollection $include, GroupCollection $exclude)
{
$this->include = $include;
$this->exclude = $exclude;
}
public function hasInclude(): bool
{
return !$this->include->isEmpty();
}
public function include(): GroupCollection
{
return $this->include;
}
public function hasExclude(): bool
{
return !$this->exclude->isEmpty();
}
public function exclude(): GroupCollection
{
return $this->exclude;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Html.php 0000644 00000005447 15243417753 0021016 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\NoCustomCssFileException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Html
{
private readonly Directory $target;
private readonly int $lowUpperBound;
private readonly int $highLowerBound;
private readonly string $colorSuccessLow;
private readonly string $colorSuccessMedium;
private readonly string $colorSuccessHigh;
private readonly string $colorWarning;
private readonly string $colorDanger;
private readonly ?string $customCssFile;
public function __construct(Directory $target, int $lowUpperBound, int $highLowerBound, string $colorSuccessLow, string $colorSuccessMedium, string $colorSuccessHigh, string $colorWarning, string $colorDanger, ?string $customCssFile)
{
$this->target = $target;
$this->lowUpperBound = $lowUpperBound;
$this->highLowerBound = $highLowerBound;
$this->colorSuccessLow = $colorSuccessLow;
$this->colorSuccessMedium = $colorSuccessMedium;
$this->colorSuccessHigh = $colorSuccessHigh;
$this->colorWarning = $colorWarning;
$this->colorDanger = $colorDanger;
$this->customCssFile = $customCssFile;
}
public function target(): Directory
{
return $this->target;
}
public function lowUpperBound(): int
{
return $this->lowUpperBound;
}
public function highLowerBound(): int
{
return $this->highLowerBound;
}
public function colorSuccessLow(): string
{
return $this->colorSuccessLow;
}
public function colorSuccessMedium(): string
{
return $this->colorSuccessMedium;
}
public function colorSuccessHigh(): string
{
return $this->colorSuccessHigh;
}
public function colorWarning(): string
{
return $this->colorWarning;
}
public function colorDanger(): string
{
return $this->colorDanger;
}
/**
* @psalm-assert-if-true !null $this->customCssFile
*/
public function hasCustomCssFile(): bool
{
return $this->customCssFile !== null;
}
/**
* @throws NoCustomCssFileException
*/
public function customCssFile(): string
{
if (!$this->hasCustomCssFile()) {
throw new NoCustomCssFileException;
}
return $this->customCssFile;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Crap4j.php 0000644 00000001563 15243417753 0021230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Crap4j
{
private readonly File $target;
private readonly int $threshold;
public function __construct(File $target, int $threshold)
{
$this->target = $target;
$this->threshold = $threshold;
}
public function target(): File
{
return $this->target;
}
public function threshold(): int
{
return $this->threshold;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Text.php 0000644 00000002214 15243417753 0021023 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Text
{
private readonly File $target;
private readonly bool $showUncoveredFiles;
private readonly bool $showOnlySummary;
public function __construct(File $target, bool $showUncoveredFiles, bool $showOnlySummary)
{
$this->target = $target;
$this->showUncoveredFiles = $showUncoveredFiles;
$this->showOnlySummary = $showOnlySummary;
}
public function target(): File
{
return $this->target;
}
public function showUncoveredFiles(): bool
{
return $this->showUncoveredFiles;
}
public function showOnlySummary(): bool
{
return $this->showOnlySummary;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Php.php 0000644 00000001276 15243417753 0020635 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Php
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Cobertura.php 0000644 00000001304 15243417753 0022024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Cobertura
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Clover.php 0000644 00000001301 15243417753 0021325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Clover
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/Report/Xml.php 0000644 00000001322 15243417753 0020636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\Directory;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Xml
{
private readonly Directory $target;
public function __construct(Directory $target)
{
$this->target = $target;
}
public function target(): Directory
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/CodeCoverage/CodeCoverage.php 0000644 00000017161 15243417753 0021161 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage;
use function count;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Clover;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Cobertura;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Crap4j;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Html;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Php;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Text;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Xml;
use PHPUnit\TextUI\XmlConfiguration\Exception;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class CodeCoverage
{
private readonly ?Directory $cacheDirectory;
private readonly FilterDirectoryCollection $directories;
private readonly FileCollection $files;
private readonly FilterDirectoryCollection $excludeDirectories;
private readonly FileCollection $excludeFiles;
private readonly bool $pathCoverage;
private readonly bool $includeUncoveredFiles;
private readonly bool $ignoreDeprecatedCodeUnits;
private readonly bool $disableCodeCoverageIgnore;
private readonly ?Clover $clover;
private readonly ?Cobertura $cobertura;
private readonly ?Crap4j $crap4j;
private readonly ?Html $html;
private readonly ?Php $php;
private readonly ?Text $text;
private readonly ?Xml $xml;
public function __construct(?Directory $cacheDirectory, FilterDirectoryCollection $directories, FileCollection $files, FilterDirectoryCollection $excludeDirectories, FileCollection $excludeFiles, bool $pathCoverage, bool $includeUncoveredFiles, bool $ignoreDeprecatedCodeUnits, bool $disableCodeCoverageIgnore, ?Clover $clover, ?Cobertura $cobertura, ?Crap4j $crap4j, ?Html $html, ?Php $php, ?Text $text, ?Xml $xml)
{
$this->cacheDirectory = $cacheDirectory;
$this->directories = $directories;
$this->files = $files;
$this->excludeDirectories = $excludeDirectories;
$this->excludeFiles = $excludeFiles;
$this->pathCoverage = $pathCoverage;
$this->includeUncoveredFiles = $includeUncoveredFiles;
$this->ignoreDeprecatedCodeUnits = $ignoreDeprecatedCodeUnits;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->clover = $clover;
$this->cobertura = $cobertura;
$this->crap4j = $crap4j;
$this->html = $html;
$this->php = $php;
$this->text = $text;
$this->xml = $xml;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*
* @deprecated
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheDirectory(): Directory
{
if (!$this->hasCacheDirectory()) {
throw new Exception(
'No cache directory has been configured',
);
}
return $this->cacheDirectory;
}
public function hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport(): bool
{
return count($this->directories) > 0 || count($this->files) > 0;
}
public function directories(): FilterDirectoryCollection
{
return $this->directories;
}
public function files(): FileCollection
{
return $this->files;
}
public function excludeDirectories(): FilterDirectoryCollection
{
return $this->excludeDirectories;
}
public function excludeFiles(): FileCollection
{
return $this->excludeFiles;
}
public function pathCoverage(): bool
{
return $this->pathCoverage;
}
public function includeUncoveredFiles(): bool
{
return $this->includeUncoveredFiles;
}
public function ignoreDeprecatedCodeUnits(): bool
{
return $this->ignoreDeprecatedCodeUnits;
}
public function disableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore;
}
/**
* @psalm-assert-if-true !null $this->clover
*/
public function hasClover(): bool
{
return $this->clover !== null;
}
/**
* @throws Exception
*/
public function clover(): Clover
{
if (!$this->hasClover()) {
throw new Exception(
'Code Coverage report "Clover XML" has not been configured',
);
}
return $this->clover;
}
/**
* @psalm-assert-if-true !null $this->cobertura
*/
public function hasCobertura(): bool
{
return $this->cobertura !== null;
}
/**
* @throws Exception
*/
public function cobertura(): Cobertura
{
if (!$this->hasCobertura()) {
throw new Exception(
'Code Coverage report "Cobertura XML" has not been configured',
);
}
return $this->cobertura;
}
/**
* @psalm-assert-if-true !null $this->crap4j
*/
public function hasCrap4j(): bool
{
return $this->crap4j !== null;
}
/**
* @throws Exception
*/
public function crap4j(): Crap4j
{
if (!$this->hasCrap4j()) {
throw new Exception(
'Code Coverage report "Crap4J" has not been configured',
);
}
return $this->crap4j;
}
/**
* @psalm-assert-if-true !null $this->html
*/
public function hasHtml(): bool
{
return $this->html !== null;
}
/**
* @throws Exception
*/
public function html(): Html
{
if (!$this->hasHtml()) {
throw new Exception(
'Code Coverage report "HTML" has not been configured',
);
}
return $this->html;
}
/**
* @psalm-assert-if-true !null $this->php
*/
public function hasPhp(): bool
{
return $this->php !== null;
}
/**
* @throws Exception
*/
public function php(): Php
{
if (!$this->hasPhp()) {
throw new Exception(
'Code Coverage report "PHP" has not been configured',
);
}
return $this->php;
}
/**
* @psalm-assert-if-true !null $this->text
*/
public function hasText(): bool
{
return $this->text !== null;
}
/**
* @throws Exception
*/
public function text(): Text
{
if (!$this->hasText()) {
throw new Exception(
'Code Coverage report "Text" has not been configured',
);
}
return $this->text;
}
/**
* @psalm-assert-if-true !null $this->xml
*/
public function hasXml(): bool
{
return $this->xml !== null;
}
/**
* @throws Exception
*/
public function xml(): Xml
{
if (!$this->hasXml()) {
throw new Exception(
'Code Coverage report "XML" has not been configured',
);
}
return $this->xml;
}
}
phpunit/src/TextUI/Configuration/Xml/PHPUnit.php 0000644 00000040236 15243417753 0015573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class PHPUnit
{
private readonly ?string $cacheDirectory;
private readonly bool $cacheResult;
private readonly ?string $cacheResultFile;
private readonly int|string $columns;
private readonly string $colors;
private readonly bool $stderr;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $reverseDefectList;
private readonly bool $requireCoverageMetadata;
private readonly ?string $bootstrap;
private readonly bool $processIsolation;
private readonly bool $failOnDeprecation;
private readonly bool $failOnEmptyTestSuite;
private readonly bool $failOnIncomplete;
private readonly bool $failOnNotice;
private readonly bool $failOnRisky;
private readonly bool $failOnSkipped;
private readonly bool $failOnWarning;
private readonly bool $stopOnDefect;
private readonly bool $stopOnDeprecation;
private readonly bool $stopOnError;
private readonly bool $stopOnFailure;
private readonly bool $stopOnIncomplete;
private readonly bool $stopOnNotice;
private readonly bool $stopOnRisky;
private readonly bool $stopOnSkipped;
private readonly bool $stopOnWarning;
/**
* @psalm-var ?non-empty-string
*/
private readonly ?string $extensionsDirectory;
private readonly bool $beStrictAboutChangesToGlobalState;
private readonly bool $beStrictAboutOutputDuringTests;
private readonly bool $beStrictAboutTestsThatDoNotTestAnything;
private readonly bool $beStrictAboutCoverageMetadata;
private readonly bool $enforceTimeLimit;
private readonly int $defaultTimeLimit;
private readonly int $timeoutForSmallTests;
private readonly int $timeoutForMediumTests;
private readonly int $timeoutForLargeTests;
private readonly ?string $defaultTestSuite;
private readonly int $executionOrder;
private readonly bool $resolveDependencies;
private readonly bool $defectsFirst;
private readonly bool $backupGlobals;
private readonly bool $backupStaticProperties;
private readonly bool $registerMockObjectsFromTestArgumentsRecursively;
private readonly bool $testdoxPrinter;
private readonly bool $controlGarbageCollector;
private readonly int $numberOfTestsBeforeGarbageCollection;
/**
* @psalm-param ?non-empty-string $extensionsDirectory
*/
public function __construct(?string $cacheDirectory, bool $cacheResult, ?string $cacheResultFile, int|string $columns, string $colors, bool $stderr, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $reverseDefectList, bool $requireCoverageMetadata, ?string $bootstrap, bool $processIsolation, bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, bool $stopOnDefect, bool $stopOnDeprecation, bool $stopOnError, bool $stopOnFailure, bool $stopOnIncomplete, bool $stopOnNotice, bool $stopOnRisky, bool $stopOnSkipped, bool $stopOnWarning, ?string $extensionsDirectory, bool $beStrictAboutChangesToGlobalState, bool $beStrictAboutOutputDuringTests, bool $beStrictAboutTestsThatDoNotTestAnything, bool $beStrictAboutCoverageMetadata, bool $enforceTimeLimit, int $defaultTimeLimit, int $timeoutForSmallTests, int $timeoutForMediumTests, int $timeoutForLargeTests, ?string $defaultTestSuite, int $executionOrder, bool $resolveDependencies, bool $defectsFirst, bool $backupGlobals, bool $backupStaticProperties, bool $registerMockObjectsFromTestArgumentsRecursively, bool $testdoxPrinter, bool $controlGarbageCollector, int $numberOfTestsBeforeGarbageCollection)
{
$this->cacheDirectory = $cacheDirectory;
$this->cacheResult = $cacheResult;
$this->cacheResultFile = $cacheResultFile;
$this->columns = $columns;
$this->colors = $colors;
$this->stderr = $stderr;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->reverseDefectList = $reverseDefectList;
$this->requireCoverageMetadata = $requireCoverageMetadata;
$this->bootstrap = $bootstrap;
$this->processIsolation = $processIsolation;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->extensionsDirectory = $extensionsDirectory;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->beStrictAboutOutputDuringTests = $beStrictAboutOutputDuringTests;
$this->beStrictAboutTestsThatDoNotTestAnything = $beStrictAboutTestsThatDoNotTestAnything;
$this->beStrictAboutCoverageMetadata = $beStrictAboutCoverageMetadata;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->timeoutForSmallTests = $timeoutForSmallTests;
$this->timeoutForMediumTests = $timeoutForMediumTests;
$this->timeoutForLargeTests = $timeoutForLargeTests;
$this->defaultTestSuite = $defaultTestSuite;
$this->executionOrder = $executionOrder;
$this->resolveDependencies = $resolveDependencies;
$this->defectsFirst = $defectsFirst;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->registerMockObjectsFromTestArgumentsRecursively = $registerMockObjectsFromTestArgumentsRecursively;
$this->testdoxPrinter = $testdoxPrinter;
$this->controlGarbageCollector = $controlGarbageCollector;
$this->numberOfTestsBeforeGarbageCollection = $numberOfTestsBeforeGarbageCollection;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new Exception('Cache directory is not configured');
}
return $this->cacheDirectory;
}
public function cacheResult(): bool
{
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheResultFile
*
* @deprecated
*/
public function hasCacheResultFile(): bool
{
return $this->cacheResultFile !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheResultFile(): string
{
if (!$this->hasCacheResultFile()) {
throw new Exception('Cache result file is not configured');
}
return $this->cacheResultFile;
}
public function columns(): int|string
{
return $this->columns;
}
public function colors(): string
{
return $this->colors;
}
public function stderr(): bool
{
return $this->stderr;
}
public function displayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests;
}
public function displayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests;
}
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors;
}
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices;
}
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function reverseDefectList(): bool
{
return $this->reverseDefectList;
}
public function requireCoverageMetadata(): bool
{
return $this->requireCoverageMetadata;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws Exception
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new Exception('Bootstrap script is not configured');
}
return $this->bootstrap;
}
public function processIsolation(): bool
{
return $this->processIsolation;
}
public function failOnDeprecation(): bool
{
return $this->failOnDeprecation;
}
public function failOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite;
}
public function failOnIncomplete(): bool
{
return $this->failOnIncomplete;
}
public function failOnNotice(): bool
{
return $this->failOnNotice;
}
public function failOnRisky(): bool
{
return $this->failOnRisky;
}
public function failOnSkipped(): bool
{
return $this->failOnSkipped;
}
public function failOnWarning(): bool
{
return $this->failOnWarning;
}
public function stopOnDefect(): bool
{
return $this->stopOnDefect;
}
public function stopOnDeprecation(): bool
{
return $this->stopOnDeprecation;
}
public function stopOnError(): bool
{
return $this->stopOnError;
}
public function stopOnFailure(): bool
{
return $this->stopOnFailure;
}
public function stopOnIncomplete(): bool
{
return $this->stopOnIncomplete;
}
public function stopOnNotice(): bool
{
return $this->stopOnNotice;
}
public function stopOnRisky(): bool
{
return $this->stopOnRisky;
}
public function stopOnSkipped(): bool
{
return $this->stopOnSkipped;
}
public function stopOnWarning(): bool
{
return $this->stopOnWarning;
}
/**
* @psalm-assert-if-true !null $this->extensionsDirectory
*/
public function hasExtensionsDirectory(): bool
{
return $this->extensionsDirectory !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws Exception
*/
public function extensionsDirectory(): string
{
if (!$this->hasExtensionsDirectory()) {
throw new Exception('Extensions directory is not configured');
}
return $this->extensionsDirectory;
}
public function beStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState;
}
public function beStrictAboutOutputDuringTests(): bool
{
return $this->beStrictAboutOutputDuringTests;
}
public function beStrictAboutTestsThatDoNotTestAnything(): bool
{
return $this->beStrictAboutTestsThatDoNotTestAnything;
}
public function beStrictAboutCoverageMetadata(): bool
{
return $this->beStrictAboutCoverageMetadata;
}
public function enforceTimeLimit(): bool
{
return $this->enforceTimeLimit;
}
public function defaultTimeLimit(): int
{
return $this->defaultTimeLimit;
}
public function timeoutForSmallTests(): int
{
return $this->timeoutForSmallTests;
}
public function timeoutForMediumTests(): int
{
return $this->timeoutForMediumTests;
}
public function timeoutForLargeTests(): int
{
return $this->timeoutForLargeTests;
}
/**
* @psalm-assert-if-true !null $this->defaultTestSuite
*/
public function hasDefaultTestSuite(): bool
{
return $this->defaultTestSuite !== null;
}
/**
* @throws Exception
*/
public function defaultTestSuite(): string
{
if (!$this->hasDefaultTestSuite()) {
throw new Exception('Default test suite is not configured');
}
return $this->defaultTestSuite;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
public function defectsFirst(): bool
{
return $this->defectsFirst;
}
public function backupGlobals(): bool
{
return $this->backupGlobals;
}
public function backupStaticProperties(): bool
{
return $this->backupStaticProperties;
}
/**
* @deprecated
*/
public function registerMockObjectsFromTestArgumentsRecursively(): bool
{
return $this->registerMockObjectsFromTestArgumentsRecursively;
}
public function testdoxPrinter(): bool
{
return $this->testdoxPrinter;
}
public function controlGarbageCollector(): bool
{
return $this->controlGarbageCollector;
}
public function numberOfTestsBeforeGarbageCollection(): int
{
return $this->numberOfTestsBeforeGarbageCollection;
}
}
phpunit/src/TextUI/Configuration/Xml/Exception.php 0000644 00000000762 15243417753 0016242 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
phpunit/src/TextUI/Configuration/Xml/LoadedFromFileConfiguration.php 0000644 00000003542 15243417753 0021647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class LoadedFromFileConfiguration extends Configuration
{
private readonly string $filename;
private readonly ValidationResult $validationResult;
public function __construct(string $filename, ValidationResult $validationResult, ExtensionBootstrapCollection $extensions, Source $source, CodeCoverage $codeCoverage, Groups $groups, Logging $logging, Php $php, PHPUnit $phpunit, TestSuiteCollection $testSuite)
{
$this->filename = $filename;
$this->validationResult = $validationResult;
parent::__construct(
$extensions,
$source,
$codeCoverage,
$groups,
$logging,
$php,
$phpunit,
$testSuite,
);
}
public function filename(): string
{
return $this->filename;
}
public function hasValidationErrors(): bool
{
return $this->validationResult->hasValidationErrors();
}
public function validationErrors(): string
{
return $this->validationResult->asString();
}
public function wasLoadedFromFile(): bool
{
return true;
}
}
phpunit/src/TextUI/Configuration/Xml/Logging/TeamCity.php 0000644 00000001267 15243417753 0017412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TeamCity
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/Logging/Junit.php 0000644 00000001264 15243417753 0016761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Junit
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/Logging/Logging.php 0000644 00000004727 15243417753 0017265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\XmlConfiguration\Exception;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Html as TestDoxHtml;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Text as TestDoxText;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Logging
{
private readonly ?Junit $junit;
private readonly ?TeamCity $teamCity;
private readonly ?TestDoxHtml $testDoxHtml;
private readonly ?TestDoxText $testDoxText;
public function __construct(?Junit $junit, ?TeamCity $teamCity, ?TestDoxHtml $testDoxHtml, ?TestDoxText $testDoxText)
{
$this->junit = $junit;
$this->teamCity = $teamCity;
$this->testDoxHtml = $testDoxHtml;
$this->testDoxText = $testDoxText;
}
public function hasJunit(): bool
{
return $this->junit !== null;
}
/**
* @throws Exception
*/
public function junit(): Junit
{
if ($this->junit === null) {
throw new Exception('Logger "JUnit XML" is not configured');
}
return $this->junit;
}
public function hasTeamCity(): bool
{
return $this->teamCity !== null;
}
/**
* @throws Exception
*/
public function teamCity(): TeamCity
{
if ($this->teamCity === null) {
throw new Exception('Logger "Team City" is not configured');
}
return $this->teamCity;
}
public function hasTestDoxHtml(): bool
{
return $this->testDoxHtml !== null;
}
/**
* @throws Exception
*/
public function testDoxHtml(): TestDoxHtml
{
if ($this->testDoxHtml === null) {
throw new Exception('Logger "TestDox HTML" is not configured');
}
return $this->testDoxHtml;
}
public function hasTestDoxText(): bool
{
return $this->testDoxText !== null;
}
/**
* @throws Exception
*/
public function testDoxText(): TestDoxText
{
if ($this->testDoxText === null) {
throw new Exception('Logger "TestDox Text" is not configured');
}
return $this->testDoxText;
}
}
phpunit/src/TextUI/Configuration/Xml/Logging/TestDox/Html.php 0000644 00000001273 15243417753 0020166 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging\TestDox;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Html
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/Logging/TestDox/Text.php 0000644 00000001273 15243417753 0020206 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging\TestDox;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Text
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
phpunit/src/TextUI/Configuration/Xml/Validator/Validator.php 0000644 00000001757 15243417753 0020163 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function file_get_contents;
use function libxml_clear_errors;
use function libxml_get_errors;
use function libxml_use_internal_errors;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Validator
{
public function validate(DOMDocument $document, string $xsdFilename): ValidationResult
{
$originalErrorHandling = libxml_use_internal_errors(true);
$document->schemaValidateSource(file_get_contents($xsdFilename));
$errors = libxml_get_errors();
libxml_clear_errors();
libxml_use_internal_errors($originalErrorHandling);
return ValidationResult::fromArray($errors);
}
}
phpunit/src/TextUI/Configuration/Xml/Validator/ValidationResult.php 0000644 00000003301 15243417753 0021512 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use function trim;
use LibXMLError;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ValidationResult
{
/**
* @psalm-var array<int,list<string>>
*/
private readonly array $validationErrors;
/**
* @psalm-param array<int,LibXMLError> $errors
*/
public static function fromArray(array $errors): self
{
$validationErrors = [];
foreach ($errors as $error) {
if (!isset($validationErrors[$error->line])) {
$validationErrors[$error->line] = [];
}
$validationErrors[$error->line][] = trim($error->message);
}
return new self($validationErrors);
}
private function __construct(array $validationErrors)
{
$this->validationErrors = $validationErrors;
}
public function hasValidationErrors(): bool
{
return !empty($this->validationErrors);
}
public function asString(): string
{
$buffer = '';
foreach ($this->validationErrors as $line => $validationErrorsOnLine) {
$buffer .= sprintf(PHP_EOL . ' Line %d:' . PHP_EOL, $line);
foreach ($validationErrorsOnLine as $validationError) {
$buffer .= sprintf(' - %s' . PHP_EOL, $validationError);
}
}
return $buffer;
}
}
phpunit/src/TextUI/Configuration/Value/TestDirectory.php 0000644 00000003303 15243417753 0017416 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestDirectory
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
private readonly string $prefix;
private readonly string $suffix;
private readonly string $phpVersion;
private readonly VersionComparisonOperator $phpVersionOperator;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path, string $prefix, string $suffix, string $phpVersion, VersionComparisonOperator $phpVersionOperator)
{
$this->path = $path;
$this->prefix = $prefix;
$this->suffix = $suffix;
$this->phpVersion = $phpVersion;
$this->phpVersionOperator = $phpVersionOperator;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
public function prefix(): string
{
return $this->prefix;
}
public function suffix(): string
{
return $this->suffix;
}
public function phpVersion(): string
{
return $this->phpVersion;
}
public function phpVersionOperator(): VersionComparisonOperator
{
return $this->phpVersionOperator;
}
}
phpunit/src/TextUI/Configuration/Value/ExtensionBootstrapCollectionIterator.php 0000644 00000002714 15243417753 0024217 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, ExtensionBootstrap>
*/
final class ExtensionBootstrapCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<ExtensionBootstrap>
*/
private readonly array $extensionBootstraps;
private int $position = 0;
public function __construct(ExtensionBootstrapCollection $extensionBootstraps)
{
$this->extensionBootstraps = $extensionBootstraps->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->extensionBootstraps);
}
public function key(): int
{
return $this->position;
}
public function current(): ExtensionBootstrap
{
return $this->extensionBootstraps[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/TestSuiteCollectionIterator.php 0000644 00000002551 15243417753 0022275 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestSuite>
*/
final class TestSuiteCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestSuite>
*/
private readonly array $testSuites;
private int $position = 0;
public function __construct(TestSuiteCollection $testSuites)
{
$this->testSuites = $testSuites->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->testSuites);
}
public function key(): int
{
return $this->position;
}
public function current(): TestSuite
{
return $this->testSuites[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/GroupCollection.php 0000644 00000002740 15243417753 0017726 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Group>
*/
final class GroupCollection implements IteratorAggregate
{
/**
* @psalm-var list<Group>
*/
private readonly array $groups;
/**
* @psalm-param list<Group> $groups
*/
public static function fromArray(array $groups): self
{
return new self(...$groups);
}
private function __construct(Group ...$groups)
{
$this->groups = $groups;
}
/**
* @psalm-return list<Group>
*/
public function asArray(): array
{
return $this->groups;
}
/**
* @psalm-return list<string>
*/
public function asArrayOfStrings(): array
{
$result = [];
foreach ($this->groups as $group) {
$result[] = $group->name();
}
return $result;
}
public function isEmpty(): bool
{
return empty($this->groups);
}
public function getIterator(): GroupCollectionIterator
{
return new GroupCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/Variable.php 0000644 00000001706 15243417753 0016344 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Variable
{
private readonly string $name;
private readonly mixed $value;
private readonly bool $force;
public function __construct(string $name, mixed $value, bool $force)
{
$this->name = $name;
$this->value = $value;
$this->force = $force;
}
public function name(): string
{
return $this->name;
}
public function value(): mixed
{
return $this->value;
}
public function force(): bool
{
return $this->force;
}
}
phpunit/src/TextUI/Configuration/Value/FilterDirectoryCollection.php 0000644 00000002752 15243417753 0021747 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, FilterDirectory>
*/
final class FilterDirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<FilterDirectory>
*/
private readonly array $directories;
/**
* @psalm-param list<FilterDirectory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(FilterDirectory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<FilterDirectory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function notEmpty(): bool
{
return !empty($this->directories);
}
public function getIterator(): FilterDirectoryCollectionIterator
{
return new FilterDirectoryCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/FilterDirectoryCollectionIterator.php 0000644 00000002615 15243417753 0023457 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, FilterDirectory>
*/
final class FilterDirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<FilterDirectory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(FilterDirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): FilterDirectory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/TestFileCollection.php 0000644 00000002565 15243417753 0020356 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestFile>
*/
final class TestFileCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestFile>
*/
private readonly array $files;
/**
* @psalm-param list<TestFile> $files
*/
public static function fromArray(array $files): self
{
return new self(...$files);
}
private function __construct(TestFile ...$files)
{
$this->files = $files;
}
/**
* @psalm-return list<TestFile>
*/
public function asArray(): array
{
return $this->files;
}
public function count(): int
{
return count($this->files);
}
public function getIterator(): TestFileCollectionIterator
{
return new TestFileCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
phpunit/src/TextUI/Configuration/Value/FilterDirectory.php 0000644 00000002207 15243417753 0017726 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class FilterDirectory
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
private readonly string $prefix;
private readonly string $suffix;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path, string $prefix, string $suffix)
{
$this->path = $path;
$this->prefix = $prefix;
$this->suffix = $suffix;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
public function prefix(): string
{
return $this->prefix;
}
public function suffix(): string
{
return $this->suffix;
}
}
phpunit/src/TextUI/Configuration/Value/GroupCollectionIterator.php 0000644 00000002475 15243417753 0021445 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Group>
*/
final class GroupCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Group>
*/
private readonly array $groups;
private int $position = 0;
public function __construct(GroupCollection $groups)
{
$this->groups = $groups->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->groups);
}
public function key(): int
{
return $this->position;
}
public function current(): Group
{
return $this->groups[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/DirectoryCollection.php 0000644 00000002663 15243417753 0020602 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Directory>
*/
final class DirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Directory>
*/
private readonly array $directories;
/**
* @psalm-param list<Directory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(Directory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<Directory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function getIterator(): DirectoryCollectionIterator
{
return new DirectoryCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
phpunit/src/TextUI/Configuration/Value/Constant.php 0000644 00000001476 15243417753 0016414 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Constant
{
private readonly string $name;
private readonly bool|string $value;
public function __construct(string $name, bool|string $value)
{
$this->name = $name;
$this->value = $value;
}
public function name(): string
{
return $this->name;
}
public function value(): bool|string
{
return $this->value;
}
}
phpunit/src/TextUI/Configuration/Value/Directory.php 0000644 00000001217 15243417753 0016560 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Directory
{
private readonly string $path;
public function __construct(string $path)
{
$this->path = $path;
}
public function path(): string
{
return $this->path;
}
}
phpunit/src/TextUI/Configuration/Value/IniSettingCollection.php 0000644 00000002545 15243417753 0020712 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, IniSetting>
*/
final class IniSettingCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<IniSetting>
*/
private readonly array $iniSettings;
/**
* @psalm-param list<IniSetting> $iniSettings
*/
public static function fromArray(array $iniSettings): self
{
return new self(...$iniSettings);
}
private function __construct(IniSetting ...$iniSettings)
{
$this->iniSettings = $iniSettings;
}
/**
* @psalm-return list<IniSetting>
*/
public function asArray(): array
{
return $this->iniSettings;
}
public function count(): int
{
return count($this->iniSettings);
}
public function getIterator(): IniSettingCollectionIterator
{
return new IniSettingCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/Source.php 0000644 00000012721 15243417753 0016056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Source
{
/**
* @psalm-var non-empty-string
*/
private readonly ?string $baseline;
private readonly bool $ignoreBaseline;
private readonly FilterDirectoryCollection $includeDirectories;
private readonly FileCollection $includeFiles;
private readonly FilterDirectoryCollection $excludeDirectories;
private readonly FileCollection $excludeFiles;
private readonly bool $restrictDeprecations;
private readonly bool $restrictNotices;
private readonly bool $restrictWarnings;
private readonly bool $ignoreSuppressionOfDeprecations;
private readonly bool $ignoreSuppressionOfPhpDeprecations;
private readonly bool $ignoreSuppressionOfErrors;
private readonly bool $ignoreSuppressionOfNotices;
private readonly bool $ignoreSuppressionOfPhpNotices;
private readonly bool $ignoreSuppressionOfWarnings;
private readonly bool $ignoreSuppressionOfPhpWarnings;
/**
* @psalm-param non-empty-string $baseline
*/
public function __construct(?string $baseline, bool $ignoreBaseline, FilterDirectoryCollection $includeDirectories, FileCollection $includeFiles, FilterDirectoryCollection $excludeDirectories, FileCollection $excludeFiles, bool $restrictDeprecations, bool $restrictNotices, bool $restrictWarnings, bool $ignoreSuppressionOfDeprecations, bool $ignoreSuppressionOfPhpDeprecations, bool $ignoreSuppressionOfErrors, bool $ignoreSuppressionOfNotices, bool $ignoreSuppressionOfPhpNotices, bool $ignoreSuppressionOfWarnings, bool $ignoreSuppressionOfPhpWarnings)
{
$this->baseline = $baseline;
$this->ignoreBaseline = $ignoreBaseline;
$this->includeDirectories = $includeDirectories;
$this->includeFiles = $includeFiles;
$this->excludeDirectories = $excludeDirectories;
$this->excludeFiles = $excludeFiles;
$this->restrictDeprecations = $restrictDeprecations;
$this->restrictNotices = $restrictNotices;
$this->restrictWarnings = $restrictWarnings;
$this->ignoreSuppressionOfDeprecations = $ignoreSuppressionOfDeprecations;
$this->ignoreSuppressionOfPhpDeprecations = $ignoreSuppressionOfPhpDeprecations;
$this->ignoreSuppressionOfErrors = $ignoreSuppressionOfErrors;
$this->ignoreSuppressionOfNotices = $ignoreSuppressionOfNotices;
$this->ignoreSuppressionOfPhpNotices = $ignoreSuppressionOfPhpNotices;
$this->ignoreSuppressionOfWarnings = $ignoreSuppressionOfWarnings;
$this->ignoreSuppressionOfPhpWarnings = $ignoreSuppressionOfPhpWarnings;
}
/**
* @psalm-assert-if-true !null $this->baseline
*/
public function useBaseline(): bool
{
return $this->hasBaseline() && !$this->ignoreBaseline;
}
/**
* @psalm-assert-if-true !null $this->baseline
*/
public function hasBaseline(): bool
{
return $this->baseline !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws NoBaselineException
*/
public function baseline(): string
{
if (!$this->hasBaseline()) {
throw new NoBaselineException;
}
return $this->baseline;
}
public function includeDirectories(): FilterDirectoryCollection
{
return $this->includeDirectories;
}
public function includeFiles(): FileCollection
{
return $this->includeFiles;
}
public function excludeDirectories(): FilterDirectoryCollection
{
return $this->excludeDirectories;
}
public function excludeFiles(): FileCollection
{
return $this->excludeFiles;
}
public function notEmpty(): bool
{
return $this->includeDirectories->notEmpty() || $this->includeFiles->notEmpty();
}
public function restrictDeprecations(): bool
{
return $this->restrictDeprecations;
}
public function restrictNotices(): bool
{
return $this->restrictNotices;
}
public function restrictWarnings(): bool
{
return $this->restrictWarnings;
}
public function ignoreSuppressionOfDeprecations(): bool
{
return $this->ignoreSuppressionOfDeprecations;
}
public function ignoreSuppressionOfPhpDeprecations(): bool
{
return $this->ignoreSuppressionOfPhpDeprecations;
}
public function ignoreSuppressionOfErrors(): bool
{
return $this->ignoreSuppressionOfErrors;
}
public function ignoreSuppressionOfNotices(): bool
{
return $this->ignoreSuppressionOfNotices;
}
public function ignoreSuppressionOfPhpNotices(): bool
{
return $this->ignoreSuppressionOfPhpNotices;
}
public function ignoreSuppressionOfWarnings(): bool
{
return $this->ignoreSuppressionOfWarnings;
}
public function ignoreSuppressionOfPhpWarnings(): bool
{
return $this->ignoreSuppressionOfPhpWarnings;
}
}
phpunit/src/TextUI/Configuration/Value/VariableCollection.php 0000644 00000002503 15243417753 0020354 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Variable>
*/
final class VariableCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Variable>
*/
private readonly array $variables;
/**
* @psalm-param list<Variable> $variables
*/
public static function fromArray(array $variables): self
{
return new self(...$variables);
}
private function __construct(Variable ...$variables)
{
$this->variables = $variables;
}
/**
* @psalm-return list<Variable>
*/
public function asArray(): array
{
return $this->variables;
}
public function count(): int
{
return count($this->variables);
}
public function getIterator(): VariableCollectionIterator
{
return new VariableCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/TestFileCollectionIterator.php 0000644 00000002506 15243417753 0022063 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestFile>
*/
final class TestFileCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestFile>
*/
private readonly array $files;
private int $position = 0;
public function __construct(TestFileCollection $files)
{
$this->files = $files->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->files);
}
public function key(): int
{
return $this->position;
}
public function current(): TestFile
{
return $this->files[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/FileCollectionIterator.php 0000644 00000002462 15243417753 0021224 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, File>
*/
final class FileCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<File>
*/
private readonly array $files;
private int $position = 0;
public function __construct(FileCollection $files)
{
$this->files = $files->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->files);
}
public function key(): int
{
return $this->position;
}
public function current(): File
{
return $this->files[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/TestFile.php 0000644 00000002266 15243417753 0016340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestFile
{
private readonly string $path;
private readonly string $phpVersion;
private readonly VersionComparisonOperator $phpVersionOperator;
public function __construct(string $path, string $phpVersion, VersionComparisonOperator $phpVersionOperator)
{
$this->path = $path;
$this->phpVersion = $phpVersion;
$this->phpVersionOperator = $phpVersionOperator;
}
public function path(): string
{
return $this->path;
}
public function phpVersion(): string
{
return $this->phpVersion;
}
public function phpVersionOperator(): VersionComparisonOperator
{
return $this->phpVersionOperator;
}
}
phpunit/src/TextUI/Configuration/Value/VariableCollectionIterator.php 0000644 00000002536 15243417753 0022074 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Variable>
*/
final class VariableCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Variable>
*/
private readonly array $variables;
private int $position = 0;
public function __construct(VariableCollection $variables)
{
$this->variables = $variables->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->variables);
}
public function key(): int
{
return $this->position;
}
public function current(): Variable
{
return $this->variables[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/Group.php 0000644 00000001213 15243417753 0015704 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Group
{
private readonly string $name;
public function __construct(string $name)
{
$this->name = $name;
}
public function name(): string
{
return $this->name;
}
}
phpunit/src/TextUI/Configuration/Value/ConstantCollection.php 0000644 00000002503 15243417753 0020420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Constant>
*/
final class ConstantCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Constant>
*/
private readonly array $constants;
/**
* @psalm-param list<Constant> $constants
*/
public static function fromArray(array $constants): self
{
return new self(...$constants);
}
private function __construct(Constant ...$constants)
{
$this->constants = $constants;
}
/**
* @psalm-return list<Constant>
*/
public function asArray(): array
{
return $this->constants;
}
public function count(): int
{
return count($this->constants);
}
public function getIterator(): ConstantCollectionIterator
{
return new ConstantCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/TestSuiteCollection.php 0000644 00000002652 15243417753 0020565 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestSuite>
*/
final class TestSuiteCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestSuite>
*/
private readonly array $testSuites;
/**
* @psalm-param list<TestSuite> $testSuites
*/
public static function fromArray(array $testSuites): self
{
return new self(...$testSuites);
}
private function __construct(TestSuite ...$testSuites)
{
$this->testSuites = $testSuites;
}
/**
* @psalm-return list<TestSuite>
*/
public function asArray(): array
{
return $this->testSuites;
}
public function count(): int
{
return count($this->testSuites);
}
public function getIterator(): TestSuiteCollectionIterator
{
return new TestSuiteCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
phpunit/src/TextUI/Configuration/Value/Php.php 0000644 00000006232 15243417753 0015345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Php
{
private readonly DirectoryCollection $includePaths;
private readonly IniSettingCollection $iniSettings;
private readonly ConstantCollection $constants;
private readonly VariableCollection $globalVariables;
private readonly VariableCollection $envVariables;
private readonly VariableCollection $postVariables;
private readonly VariableCollection $getVariables;
private readonly VariableCollection $cookieVariables;
private readonly VariableCollection $serverVariables;
private readonly VariableCollection $filesVariables;
private readonly VariableCollection $requestVariables;
public function __construct(DirectoryCollection $includePaths, IniSettingCollection $iniSettings, ConstantCollection $constants, VariableCollection $globalVariables, VariableCollection $envVariables, VariableCollection $postVariables, VariableCollection $getVariables, VariableCollection $cookieVariables, VariableCollection $serverVariables, VariableCollection $filesVariables, VariableCollection $requestVariables)
{
$this->includePaths = $includePaths;
$this->iniSettings = $iniSettings;
$this->constants = $constants;
$this->globalVariables = $globalVariables;
$this->envVariables = $envVariables;
$this->postVariables = $postVariables;
$this->getVariables = $getVariables;
$this->cookieVariables = $cookieVariables;
$this->serverVariables = $serverVariables;
$this->filesVariables = $filesVariables;
$this->requestVariables = $requestVariables;
}
public function includePaths(): DirectoryCollection
{
return $this->includePaths;
}
public function iniSettings(): IniSettingCollection
{
return $this->iniSettings;
}
public function constants(): ConstantCollection
{
return $this->constants;
}
public function globalVariables(): VariableCollection
{
return $this->globalVariables;
}
public function envVariables(): VariableCollection
{
return $this->envVariables;
}
public function postVariables(): VariableCollection
{
return $this->postVariables;
}
public function getVariables(): VariableCollection
{
return $this->getVariables;
}
public function cookieVariables(): VariableCollection
{
return $this->cookieVariables;
}
public function serverVariables(): VariableCollection
{
return $this->serverVariables;
}
public function filesVariables(): VariableCollection
{
return $this->filesVariables;
}
public function requestVariables(): VariableCollection
{
return $this->requestVariables;
}
}
phpunit/src/TextUI/Configuration/Value/File.php 0000644 00000001456 15243417753 0015500 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class File
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path)
{
$this->path = $path;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
}
phpunit/src/TextUI/Configuration/Value/ExtensionBootstrapCollection.php 0000644 00000002537 15243417753 0022510 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, ExtensionBootstrap>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ExtensionBootstrapCollection implements IteratorAggregate
{
/**
* @psalm-var list<ExtensionBootstrap>
*/
private readonly array $extensionBootstraps;
/**
* @psalm-param list<ExtensionBootstrap> $extensionBootstraps
*/
public static function fromArray(array $extensionBootstraps): self
{
return new self(...$extensionBootstraps);
}
private function __construct(ExtensionBootstrap ...$extensionBootstraps)
{
$this->extensionBootstraps = $extensionBootstraps;
}
/**
* @psalm-return list<ExtensionBootstrap>
*/
public function asArray(): array
{
return $this->extensionBootstraps;
}
public function getIterator(): ExtensionBootstrapCollectionIterator
{
return new ExtensionBootstrapCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/TestDirectoryCollection.php 0000644 00000002723 15243417753 0021437 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestDirectory>
*/
final class TestDirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestDirectory>
*/
private readonly array $directories;
/**
* @psalm-param list<TestDirectory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(TestDirectory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<TestDirectory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function getIterator(): TestDirectoryCollectionIterator
{
return new TestDirectoryCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
phpunit/src/TextUI/Configuration/Value/ConstantCollectionIterator.php 0000644 00000002536 15243417753 0022140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Constant>
*/
final class ConstantCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Constant>
*/
private readonly array $constants;
private int $position = 0;
public function __construct(ConstantCollection $constants)
{
$this->constants = $constants->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->constants);
}
public function key(): int
{
return $this->position;
}
public function current(): Constant
{
return $this->constants[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/DirectoryCollectionIterator.php 0000644 00000002557 15243417753 0022316 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Directory>
*/
final class DirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Directory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(DirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): Directory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/ExtensionBootstrap.php 0000644 00000002266 15243417753 0020473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ExtensionBootstrap
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var array<string,string>
*/
private readonly array $parameters;
/**
* @psalm-param class-string $className
* @psalm-param array<string,string> $parameters
*/
public function __construct(string $className, array $parameters)
{
$this->className = $className;
$this->parameters = $parameters;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return array<string,string>
*/
public function parameters(): array
{
return $this->parameters;
}
}
phpunit/src/TextUI/Configuration/Value/FileCollection.php 0000644 00000002526 15243417753 0017513 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, File>
*/
final class FileCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<File>
*/
private readonly array $files;
/**
* @psalm-param list<File> $files
*/
public static function fromArray(array $files): self
{
return new self(...$files);
}
private function __construct(File ...$files)
{
$this->files = $files;
}
/**
* @psalm-return list<File>
*/
public function asArray(): array
{
return $this->files;
}
public function count(): int
{
return count($this->files);
}
public function notEmpty(): bool
{
return !empty($this->files);
}
public function getIterator(): FileCollectionIterator
{
return new FileCollectionIterator($this);
}
}
phpunit/src/TextUI/Configuration/Value/IniSetting.php 0000644 00000001461 15243417753 0016672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class IniSetting
{
private readonly string $name;
private readonly string $value;
public function __construct(string $name, string $value)
{
$this->name = $name;
$this->value = $value;
}
public function name(): string
{
return $this->name;
}
public function value(): string
{
return $this->value;
}
}
phpunit/src/TextUI/Configuration/Value/TestDirectoryCollectionIterator.php 0000644 00000002603 15243417753 0023146 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestDirectory>
*/
final class TestDirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestDirectory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(TestDirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): TestDirectory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/IniSettingCollectionIterator.php 0000644 00000002564 15243417753 0022425 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, IniSetting>
*/
final class IniSettingCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<IniSetting>
*/
private readonly array $iniSettings;
private int $position = 0;
public function __construct(IniSettingCollection $iniSettings)
{
$this->iniSettings = $iniSettings->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->iniSettings);
}
public function key(): int
{
return $this->position;
}
public function current(): IniSetting
{
return $this->iniSettings[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/TextUI/Configuration/Value/TestSuite.php 0000644 00000002703 15243417753 0016546 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestSuite
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
private readonly TestDirectoryCollection $directories;
private readonly TestFileCollection $files;
private readonly FileCollection $exclude;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name, TestDirectoryCollection $directories, TestFileCollection $files, FileCollection $exclude)
{
$this->name = $name;
$this->directories = $directories;
$this->files = $files;
$this->exclude = $exclude;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
public function directories(): TestDirectoryCollection
{
return $this->directories;
}
public function files(): TestFileCollection
{
return $this->files;
}
public function exclude(): FileCollection
{
return $this->exclude;
}
}
phpunit/src/Framework/TestSize/Known.php 0000644 00000001204 15243417753 0014346 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class Known extends TestSize
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
abstract public function isGreaterThan(self $other): bool;
}
phpunit/src/Framework/TestSize/Medium.php 0000644 00000001366 15243417753 0014503 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Medium extends Known
{
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return $other->isSmall();
}
public function asString(): string
{
return 'medium';
}
}
phpunit/src/Framework/TestSize/Unknown.php 0000644 00000001225 15243417753 0014714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Unknown extends TestSize
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asString(): string
{
return 'unknown';
}
}
phpunit/src/Framework/TestSize/TestSize.php 0000644 00000002665 15243417753 0015040 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class TestSize
{
public static function unknown(): self
{
return new Unknown;
}
public static function small(): self
{
return new Small;
}
public static function medium(): self
{
return new Medium;
}
public static function large(): self
{
return new Large;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return false;
}
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return false;
}
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return false;
}
abstract public function asString(): string;
}
phpunit/src/Framework/TestSize/Small.php 0000644 00000001346 15243417753 0014331 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Small extends Known
{
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return false;
}
public function asString(): string
{
return 'small';
}
}
phpunit/src/Framework/TestSize/Large.php 0000644 00000001363 15243417753 0014312 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Large extends Known
{
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return !$other->isLarge();
}
public function asString(): string
{
return 'large';
}
}
phpunit/src/Framework/TestBuilder.php 0000644 00000023433 15243417753 0013736 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function assert;
use PHPUnit\Metadata\Api\DataProvider;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\BackupGlobals;
use PHPUnit\Metadata\BackupStaticProperties;
use PHPUnit\Metadata\ExcludeGlobalVariableFromBackup;
use PHPUnit\Metadata\ExcludeStaticPropertyFromBackup;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\PreserveGlobalState;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestBuilder
{
/**
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
public function build(ReflectionClass $theClass, string $methodName): Test
{
$className = $theClass->getName();
$data = (new DataProvider)->providedData(
$className,
$methodName,
);
if ($data !== null) {
return $this->buildDataProviderTestSuite(
$methodName,
$className,
$data,
$this->shouldTestMethodBeRunInSeparateProcess($className, $methodName),
$this->shouldGlobalStateBePreserved($className, $methodName),
$this->shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess($className),
$this->backupSettings($className, $methodName),
);
}
$test = new $className($methodName);
assert($test instanceof TestCase);
$this->configureTestCase(
$test,
$this->shouldTestMethodBeRunInSeparateProcess($className, $methodName),
$this->shouldGlobalStateBePreserved($className, $methodName),
$this->shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess($className),
$this->backupSettings($className, $methodName),
);
return $test;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>} $backupSettings
*/
private function buildDataProviderTestSuite(string $methodName, string $className, array $data, bool $runTestInSeparateProcess, ?bool $preserveGlobalState, bool $runClassInSeparateProcess, array $backupSettings): DataProviderTestSuite
{
$dataProviderTestSuite = DataProviderTestSuite::empty(
$className . '::' . $methodName,
);
$groups = (new Groups)->groups($className, $methodName);
foreach ($data as $_dataName => $_data) {
$_test = new $className($methodName);
assert($_test instanceof TestCase);
$_test->setData($_dataName, $_data);
$this->configureTestCase(
$_test,
$runTestInSeparateProcess,
$preserveGlobalState,
$runClassInSeparateProcess,
$backupSettings,
);
$dataProviderTestSuite->addTest($_test, $groups);
}
return $dataProviderTestSuite;
}
/**
* @psalm-param array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>} $backupSettings
*/
private function configureTestCase(TestCase $test, bool $runTestInSeparateProcess, ?bool $preserveGlobalState, bool $runClassInSeparateProcess, array $backupSettings): void
{
if ($runTestInSeparateProcess) {
$test->setRunTestInSeparateProcess(true);
}
if ($runClassInSeparateProcess) {
$test->setRunClassInSeparateProcess(true);
}
if ($preserveGlobalState !== null) {
$test->setPreserveGlobalState($preserveGlobalState);
}
if ($backupSettings['backupGlobals'] !== null) {
$test->setBackupGlobals($backupSettings['backupGlobals']);
} else {
$test->setBackupGlobals(ConfigurationRegistry::get()->backupGlobals());
}
$test->setBackupGlobalsExcludeList($backupSettings['backupGlobalsExcludeList']);
if ($backupSettings['backupStaticProperties'] !== null) {
$test->setBackupStaticProperties($backupSettings['backupStaticProperties']);
} else {
$test->setBackupStaticProperties(ConfigurationRegistry::get()->backupStaticProperties());
}
$test->setBackupStaticPropertiesExcludeList($backupSettings['backupStaticPropertiesExcludeList']);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>}
*/
private function backupSettings(string $className, string $methodName): array
{
$metadataForClass = MetadataRegistry::parser()->forClass($className);
$metadataForMethod = MetadataRegistry::parser()->forMethod($className, $methodName);
$metadataForClassAndMethod = MetadataRegistry::parser()->forClassAndMethod($className, $methodName);
$backupGlobals = null;
$backupGlobalsExcludeList = [];
if ($metadataForMethod->isBackupGlobals()->isNotEmpty()) {
$metadata = $metadataForMethod->isBackupGlobals()->asArray()[0];
assert($metadata instanceof BackupGlobals);
if ($metadata->enabled()) {
$backupGlobals = true;
}
} elseif ($metadataForClass->isBackupGlobals()->isNotEmpty()) {
$metadata = $metadataForClass->isBackupGlobals()->asArray()[0];
assert($metadata instanceof BackupGlobals);
if ($metadata->enabled()) {
$backupGlobals = true;
}
}
foreach ($metadataForClassAndMethod->isExcludeGlobalVariableFromBackup() as $metadata) {
assert($metadata instanceof ExcludeGlobalVariableFromBackup);
$backupGlobalsExcludeList[] = $metadata->globalVariableName();
}
$backupStaticProperties = null;
$backupStaticPropertiesExcludeList = [];
if ($metadataForMethod->isBackupStaticProperties()->isNotEmpty()) {
$metadata = $metadataForMethod->isBackupStaticProperties()->asArray()[0];
assert($metadata instanceof BackupStaticProperties);
if ($metadata->enabled()) {
$backupStaticProperties = true;
}
} elseif ($metadataForClass->isBackupStaticProperties()->isNotEmpty()) {
$metadata = $metadataForClass->isBackupStaticProperties()->asArray()[0];
assert($metadata instanceof BackupStaticProperties);
if ($metadata->enabled()) {
$backupStaticProperties = true;
}
}
foreach ($metadataForClassAndMethod->isExcludeStaticPropertyFromBackup() as $metadata) {
assert($metadata instanceof ExcludeStaticPropertyFromBackup);
if (!isset($backupStaticPropertiesExcludeList[$metadata->className()])) {
$backupStaticPropertiesExcludeList[$metadata->className()] = [];
}
$backupStaticPropertiesExcludeList[$metadata->className()][] = $metadata->propertyName();
}
return [
'backupGlobals' => $backupGlobals,
'backupGlobalsExcludeList' => $backupGlobalsExcludeList,
'backupStaticProperties' => $backupStaticProperties,
'backupStaticPropertiesExcludeList' => $backupStaticPropertiesExcludeList,
];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function shouldGlobalStateBePreserved(string $className, string $methodName): ?bool
{
$metadataForMethod = MetadataRegistry::parser()->forMethod($className, $methodName);
if ($metadataForMethod->isPreserveGlobalState()->isNotEmpty()) {
$metadata = $metadataForMethod->isPreserveGlobalState()->asArray()[0];
assert($metadata instanceof PreserveGlobalState);
return $metadata->enabled();
}
$metadataForClass = MetadataRegistry::parser()->forClass($className);
if ($metadataForClass->isPreserveGlobalState()->isNotEmpty()) {
$metadata = $metadataForClass->isPreserveGlobalState()->asArray()[0];
assert($metadata instanceof PreserveGlobalState);
return $metadata->enabled();
}
return null;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function shouldTestMethodBeRunInSeparateProcess(string $className, string $methodName): bool
{
if (MetadataRegistry::parser()->forClass($className)->isRunTestsInSeparateProcesses()->isNotEmpty()) {
return true;
}
if (MetadataRegistry::parser()->forMethod($className, $methodName)->isRunInSeparateProcess()->isNotEmpty()) {
return true;
}
return false;
}
/**
* @psalm-param class-string $className
*/
private function shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess(string $className): bool
{
return MetadataRegistry::parser()->forClass($className)->isRunClassInSeparateProcess()->isNotEmpty();
}
}
phpunit/src/Framework/Test.php 0000644 00000000742 15243417753 0012425 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Countable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Test extends Countable
{
public function run(): void;
}
phpunit/src/Framework/TestRunner.php 0000644 00000037640 15243417753 0013626 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const PHP_EOL;
use function assert;
use function class_exists;
use function defined;
use function error_clear_last;
use function extension_loaded;
use function get_include_path;
use function hrtime;
use function serialize;
use function sprintf;
use function sys_get_temp_dir;
use function tempnam;
use function unlink;
use function var_export;
use AssertionError;
use PHPUnit\Event;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Metadata\Api\CodeCoverage as CodeCoverageMetadataApi;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\Runner\ErrorHandler;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\GlobalState;
use PHPUnit\Util\PHP\AbstractPhpProcess;
use ReflectionClass;
use SebastianBergmann\CodeCoverage\Exception as OriginalCodeCoverageException;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Invoker\Invoker;
use SebastianBergmann\Invoker\TimeoutException;
use SebastianBergmann\Template\Template;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunner
{
private ?bool $timeLimitCanBeEnforced = null;
private readonly Configuration $configuration;
public function __construct()
{
$this->configuration = ConfigurationRegistry::get();
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws CodeCoverageException
* @throws InvalidArgumentException
* @throws MoreThanOneDataSetFromDataProviderException
* @throws UnintentionallyCoveredCodeException
*/
public function run(TestCase $test): void
{
Assert::resetCount();
if ($this->configuration->registerMockObjectsFromTestArgumentsRecursively()) {
$test->registerMockObjectsFromTestArgumentsRecursively();
}
$shouldCodeCoverageBeCollected = (new CodeCoverageMetadataApi)->shouldCodeCoverageBeCollectedFor(
$test::class,
$test->name(),
);
$error = false;
$failure = false;
$incomplete = false;
$risky = false;
$skipped = false;
error_clear_last();
if ($this->shouldErrorHandlerBeUsed($test)) {
ErrorHandler::instance()->enable();
}
$collectCodeCoverage = CodeCoverage::instance()->isActive() &&
$shouldCodeCoverageBeCollected;
if ($collectCodeCoverage) {
CodeCoverage::instance()->start($test);
}
try {
if ($this->canTimeLimitBeEnforced() &&
$this->shouldTimeLimitBeEnforced($test)) {
$risky = $this->runTestWithTimeout($test);
} else {
$test->runBare();
}
} catch (AssertionFailedError $e) {
$failure = true;
if ($e instanceof IncompleteTestError) {
$incomplete = true;
} elseif ($e instanceof SkippedTest) {
$skipped = true;
}
} catch (AssertionError $e) {
$test->addToAssertionCount(1);
$failure = true;
$frame = $e->getTrace()[0];
assert(isset($frame['file']));
assert(isset($frame['line']));
$e = new AssertionFailedError(
sprintf(
'%s in %s:%s',
$e->getMessage(),
$frame['file'],
$frame['line'],
),
);
} catch (Throwable $e) {
$error = true;
}
$test->addToAssertionCount(Assert::getCount());
if ($this->configuration->reportUselessTests() &&
!$test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() === 0) {
$risky = true;
}
if (!$error && !$failure && !$incomplete && !$skipped && !$risky &&
$this->configuration->requireCoverageMetadata() &&
!$this->hasCoverageMetadata($test::class, $test->name())) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test does not define a code coverage target but is expected to do so',
);
$risky = true;
}
if ($collectCodeCoverage) {
$append = !$risky && !$incomplete && !$skipped;
$linesToBeCovered = [];
$linesToBeUsed = [];
if ($append) {
try {
$linesToBeCovered = (new CodeCoverageMetadataApi)->linesToBeCovered(
$test::class,
$test->name(),
);
$linesToBeUsed = (new CodeCoverageMetadataApi)->linesToBeUsed(
$test::class,
$test->name(),
);
} catch (InvalidCoversTargetException $cce) {
Event\Facade::emitter()->testTriggeredPhpunitWarning(
$test->valueObjectForEvents(),
$cce->getMessage(),
);
$append = false;
}
}
try {
CodeCoverage::instance()->stop(
$append,
$linesToBeCovered,
$linesToBeUsed,
);
} catch (UnintentionallyCoveredCodeException $cce) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test executed code that is not listed as code to be covered or used:' .
PHP_EOL .
$cce->getMessage(),
);
} catch (OriginalCodeCoverageException $cce) {
$error = true;
$e = $e ?? $cce;
}
}
ErrorHandler::instance()->disable();
if (!$error &&
!$incomplete &&
!$skipped &&
$this->configuration->reportUselessTests() &&
!$test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() === 0) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test did not perform any assertions',
);
}
if ($test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() > 0) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test is not expected to perform assertions but performed %d assertion%s',
$test->numberOfAssertionsPerformed(),
$test->numberOfAssertionsPerformed() > 1 ? 's' : '',
),
);
}
if ($test->hasUnexpectedOutput()) {
Event\Facade::emitter()->testPrintedUnexpectedOutput($test->output());
}
if ($this->configuration->disallowTestOutput() && $test->hasUnexpectedOutput()) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test printed output: %s',
$test->output(),
),
);
}
if ($test->wasPrepared()) {
Event\Facade::emitter()->testFinished(
$test->valueObjectForEvents(),
$test->numberOfAssertionsPerformed(),
);
}
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws \PHPUnit\Util\Exception
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
* @throws ProcessIsolationException
* @throws StaticAnalysisCacheNotConfiguredException
*/
public function runInSeparateProcess(TestCase $test, bool $runEntireClass, bool $preserveGlobalState): void
{
$class = new ReflectionClass($test);
if ($runEntireClass) {
$template = new Template(
__DIR__ . '/../Util/PHP/Template/TestCaseClass.tpl',
);
} else {
$template = new Template(
__DIR__ . '/../Util/PHP/Template/TestCaseMethod.tpl',
);
}
$bootstrap = '';
$constants = '';
$globals = '';
$includedFiles = '';
$iniSettings = '';
if (ConfigurationRegistry::get()->hasBootstrap()) {
$bootstrap = ConfigurationRegistry::get()->bootstrap();
}
if ($preserveGlobalState) {
$constants = GlobalState::getConstantsAsString();
$globals = GlobalState::getGlobalsAsString();
$includedFiles = GlobalState::getIncludedFilesAsString();
$iniSettings = GlobalState::getIniSettingsAsString();
}
$exportObjects = Event\Facade::emitter()->exportsObjects() ? 'true' : 'false';
$coverage = CodeCoverage::instance()->isActive() ? 'true' : 'false';
$linesToBeIgnored = var_export(CodeCoverage::instance()->linesToBeIgnored(), true);
if (defined('PHPUNIT_COMPOSER_INSTALL')) {
$composerAutoload = var_export(PHPUNIT_COMPOSER_INSTALL, true);
} else {
$composerAutoload = '\'\'';
}
if (defined('__PHPUNIT_PHAR__')) {
$phar = var_export(__PHPUNIT_PHAR__, true);
} else {
$phar = '\'\'';
}
$data = var_export(serialize($test->providedData()), true);
$dataName = var_export($test->dataName(), true);
$dependencyInput = var_export(serialize($test->dependencyInput()), true);
$includePath = var_export(get_include_path(), true);
// must do these fixes because TestCaseMethod.tpl has unserialize('{data}') in it, and we can't break BC
// the lines above used to use addcslashes() rather than var_export(), which breaks null byte escape sequences
$data = "'." . $data . ".'";
$dataName = "'.(" . $dataName . ").'";
$dependencyInput = "'." . $dependencyInput . ".'";
$includePath = "'." . $includePath . ".'";
$offset = hrtime();
$serializedConfiguration = $this->saveConfigurationForChildProcess();
$processResultFile = tempnam(sys_get_temp_dir(), 'phpunit_');
$var = [
'bootstrap' => $bootstrap,
'composerAutoload' => $composerAutoload,
'phar' => $phar,
'filename' => $class->getFileName(),
'className' => $class->getName(),
'collectCodeCoverageInformation' => $coverage,
'linesToBeIgnored' => $linesToBeIgnored,
'data' => $data,
'dataName' => $dataName,
'dependencyInput' => $dependencyInput,
'constants' => $constants,
'globals' => $globals,
'include_path' => $includePath,
'included_files' => $includedFiles,
'iniSettings' => $iniSettings,
'name' => $test->name(),
'offsetSeconds' => $offset[0],
'offsetNanoseconds' => $offset[1],
'serializedConfiguration' => $serializedConfiguration,
'processResultFile' => $processResultFile,
'exportObjects' => $exportObjects,
];
if (!$runEntireClass) {
$var['methodName'] = $test->name();
}
$template->setVar($var);
$php = AbstractPhpProcess::factory();
$php->runTestJob($template->render(), $test, $processResultFile);
@unlink($serializedConfiguration);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function hasCoverageMetadata(string $className, string $methodName): bool
{
foreach (MetadataRegistry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isCovers()) {
return true;
}
if ($metadata->isCoversClass()) {
return true;
}
if ($metadata->isCoversFunction()) {
return true;
}
if ($metadata->isCoversNothing()) {
return true;
}
}
return false;
}
private function canTimeLimitBeEnforced(): bool
{
if ($this->timeLimitCanBeEnforced !== null) {
return $this->timeLimitCanBeEnforced;
}
if (!class_exists(Invoker::class)) {
$this->timeLimitCanBeEnforced = false;
return $this->timeLimitCanBeEnforced;
}
$this->timeLimitCanBeEnforced = (new Invoker)->canInvokeWithTimeout();
return $this->timeLimitCanBeEnforced;
}
private function shouldTimeLimitBeEnforced(TestCase $test): bool
{
if (!$this->configuration->enforceTimeLimit()) {
return false;
}
if (!(($this->configuration->defaultTimeLimit() || $test->size()->isKnown()))) {
return false;
}
if (extension_loaded('xdebug') && xdebug_is_debugger_active()) {
return false;
}
return true;
}
/**
* @throws Throwable
*/
private function runTestWithTimeout(TestCase $test): bool
{
$_timeout = $this->configuration->defaultTimeLimit();
$testSize = $test->size();
if ($testSize->isSmall()) {
$_timeout = $this->configuration->timeoutForSmallTests();
} elseif ($testSize->isMedium()) {
$_timeout = $this->configuration->timeoutForMediumTests();
} elseif ($testSize->isLarge()) {
$_timeout = $this->configuration->timeoutForLargeTests();
}
try {
(new Invoker)->invoke([$test, 'runBare'], [], $_timeout);
} catch (TimeoutException) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test was aborted after %d second%s',
$_timeout,
$_timeout !== 1 ? 's' : '',
),
);
return true;
}
return false;
}
/**
* @throws ProcessIsolationException
*/
private function saveConfigurationForChildProcess(): string
{
$path = tempnam(sys_get_temp_dir(), 'phpunit_');
if ($path === false) {
throw new ProcessIsolationException;
}
if (!ConfigurationRegistry::saveTo($path)) {
throw new ProcessIsolationException;
}
return $path;
}
private function shouldErrorHandlerBeUsed(TestCase $test): bool
{
if (MetadataRegistry::parser()->forMethod($test::class, $test->name())->isWithoutErrorHandler()->isNotEmpty()) {
return false;
}
return true;
}
}
phpunit/src/Framework/TestStatus/TestStatus.php 0000644 00000007530 15243417753 0015756 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestStatus
{
private readonly string $message;
public static function from(int $status): self
{
return match ($status) {
0 => self::success(),
1 => self::skipped(),
2 => self::incomplete(),
3 => self::notice(),
4 => self::deprecation(),
5 => self::risky(),
6 => self::warning(),
7 => self::failure(),
8 => self::error(),
default => self::unknown(),
};
}
public static function unknown(): self
{
return new Unknown;
}
public static function success(): self
{
return new Success;
}
public static function skipped(string $message = ''): self
{
return new Skipped($message);
}
public static function incomplete(string $message = ''): self
{
return new Incomplete($message);
}
public static function notice(string $message = ''): self
{
return new Notice($message);
}
public static function deprecation(string $message = ''): self
{
return new Deprecation($message);
}
public static function failure(string $message = ''): self
{
return new Failure($message);
}
public static function error(string $message = ''): self
{
return new Error($message);
}
public static function warning(string $message = ''): self
{
return new Warning($message);
}
public static function risky(string $message = ''): self
{
return new Risky($message);
}
private function __construct(string $message = '')
{
$this->message = $message;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return false;
}
/**
* @psalm-assert-if-true Skipped $this
*/
public function isSkipped(): bool
{
return false;
}
/**
* @psalm-assert-if-true Incomplete $this
*/
public function isIncomplete(): bool
{
return false;
}
/**
* @psalm-assert-if-true Notice $this
*/
public function isNotice(): bool
{
return false;
}
/**
* @psalm-assert-if-true Deprecation $this
*/
public function isDeprecation(): bool
{
return false;
}
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return false;
}
/**
* @psalm-assert-if-true Error $this
*/
public function isError(): bool
{
return false;
}
/**
* @psalm-assert-if-true Warning $this
*/
public function isWarning(): bool
{
return false;
}
/**
* @psalm-assert-if-true Risky $this
*/
public function isRisky(): bool
{
return false;
}
public function message(): string
{
return $this->message;
}
public function isMoreImportantThan(self $other): bool
{
return $this->asInt() > $other->asInt();
}
abstract public function asInt(): int;
abstract public function asString(): string;
}
phpunit/src/Framework/TestStatus/Success.php 0000644 00000001324 15243417753 0015236 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Success extends Known
{
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return true;
}
public function asInt(): int
{
return 0;
}
public function asString(): string
{
return 'success';
}
}
phpunit/src/Framework/TestStatus/Deprecation.php 0000644 00000001344 15243417753 0016065 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Deprecation extends Known
{
/**
* @psalm-assert-if-true Deprecation $this
*/
public function isDeprecation(): bool
{
return true;
}
public function asInt(): int
{
return 4;
}
public function asString(): string
{
return 'deprecation';
}
}
phpunit/src/Framework/TestStatus/Known.php 0000644 00000001110 15243417753 0014713 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Known extends TestStatus
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
}
phpunit/src/Framework/TestStatus/Unknown.php 0000644 00000001332 15243417753 0015264 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Unknown extends TestStatus
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asInt(): int
{
return -1;
}
public function asString(): string
{
return 'unknown';
}
}
phpunit/src/Framework/TestStatus/Incomplete.php 0000644 00000001340 15243417753 0015723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Incomplete extends Known
{
/**
* @psalm-assert-if-true Incomplete $this
*/
public function isIncomplete(): bool
{
return true;
}
public function asInt(): int
{
return 2;
}
public function asString(): string
{
return 'incomplete';
}
}
phpunit/src/Framework/TestStatus/Error.php 0000644 00000001314 15243417753 0014716 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Error extends Known
{
/**
* @psalm-assert-if-true Error $this
*/
public function isError(): bool
{
return true;
}
public function asInt(): int
{
return 8;
}
public function asString(): string
{
return 'error';
}
}
phpunit/src/Framework/TestStatus/Risky.php 0000644 00000001314 15243417753 0014726 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Risky extends Known
{
/**
* @psalm-assert-if-true Risky $this
*/
public function isRisky(): bool
{
return true;
}
public function asInt(): int
{
return 5;
}
public function asString(): string
{
return 'risky';
}
}
phpunit/src/Framework/TestStatus/Failure.php 0000644 00000001324 15243417753 0015215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Failure extends Known
{
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return true;
}
public function asInt(): int
{
return 7;
}
public function asString(): string
{
return 'failure';
}
}
phpunit/src/Framework/TestStatus/Warning.php 0000644 00000001324 15243417753 0015233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Warning extends Known
{
/**
* @psalm-assert-if-true Warning $this
*/
public function isWarning(): bool
{
return true;
}
public function asInt(): int
{
return 6;
}
public function asString(): string
{
return 'warning';
}
}
phpunit/src/Framework/TestStatus/Skipped.php 0000644 00000001324 15243417753 0015225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped extends Known
{
/**
* @psalm-assert-if-true Skipped $this
*/
public function isSkipped(): bool
{
return true;
}
public function asInt(): int
{
return 1;
}
public function asString(): string
{
return 'skipped';
}
}
phpunit/src/Framework/TestStatus/Notice.php 0000644 00000001320 15243417753 0015043 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Notice extends Known
{
/**
* @psalm-assert-if-true Notice $this
*/
public function isNotice(): bool
{
return true;
}
public function asInt(): int
{
return 3;
}
public function asString(): string
{
return 'notice';
}
}
phpunit/src/Framework/Assert/Functions.php 0000644 00000247316 15243417753 0014731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function func_get_args;
use function function_exists;
use ArrayAccess;
use Countable;
use PHPUnit\Framework\Constraint\ArrayHasKey;
use PHPUnit\Framework\Constraint\Callback;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\Count;
use PHPUnit\Framework\Constraint\DirectoryExists;
use PHPUnit\Framework\Constraint\FileExists;
use PHPUnit\Framework\Constraint\GreaterThan;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEmpty;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\Constraint\IsEqualCanonicalizing;
use PHPUnit\Framework\Constraint\IsEqualIgnoringCase;
use PHPUnit\Framework\Constraint\IsEqualWithDelta;
use PHPUnit\Framework\Constraint\IsFalse;
use PHPUnit\Framework\Constraint\IsFinite;
use PHPUnit\Framework\Constraint\IsIdentical;
use PHPUnit\Framework\Constraint\IsInfinite;
use PHPUnit\Framework\Constraint\IsInstanceOf;
use PHPUnit\Framework\Constraint\IsJson;
use PHPUnit\Framework\Constraint\IsList;
use PHPUnit\Framework\Constraint\IsNan;
use PHPUnit\Framework\Constraint\IsNull;
use PHPUnit\Framework\Constraint\IsReadable;
use PHPUnit\Framework\Constraint\IsTrue;
use PHPUnit\Framework\Constraint\IsType;
use PHPUnit\Framework\Constraint\IsWritable;
use PHPUnit\Framework\Constraint\LessThan;
use PHPUnit\Framework\Constraint\LogicalAnd;
use PHPUnit\Framework\Constraint\LogicalNot;
use PHPUnit\Framework\Constraint\LogicalOr;
use PHPUnit\Framework\Constraint\LogicalXor;
use PHPUnit\Framework\Constraint\ObjectEquals;
use PHPUnit\Framework\Constraint\RegularExpression;
use PHPUnit\Framework\Constraint\StringContains;
use PHPUnit\Framework\Constraint\StringEndsWith;
use PHPUnit\Framework\Constraint\StringEqualsStringIgnoringLineEndings;
use PHPUnit\Framework\Constraint\StringMatchesFormatDescription;
use PHPUnit\Framework\Constraint\StringStartsWith;
use PHPUnit\Framework\Constraint\TraversableContainsEqual;
use PHPUnit\Framework\Constraint\TraversableContainsIdentical;
use PHPUnit\Framework\Constraint\TraversableContainsOnly;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount as AnyInvokedCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastCount as InvokedAtLeastCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastOnce as InvokedAtLeastOnceMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount as InvokedAtMostCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedCount as InvokedCountMatcher;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls as ConsecutiveCallsStub;
use PHPUnit\Framework\MockObject\Stub\Exception as ExceptionStub;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument as ReturnArgumentStub;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback as ReturnCallbackStub;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf as ReturnSelfStub;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap as ReturnValueMapStub;
use PHPUnit\Util\Xml\XmlException;
use Throwable;
if (!function_exists('PHPUnit\Framework\assertArrayHasKey')) {
/**
* Asserts that an array has a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertArrayHasKey
*/
function assertArrayHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
Assert::assertArrayHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertArrayNotHasKey')) {
/**
* Asserts that an array does not have a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertArrayNotHasKey
*/
function assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
Assert::assertArrayNotHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsList')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsList
*/
function assertIsList(mixed $array, string $message = ''): void
{
Assert::assertIsList(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContains')) {
/**
* Asserts that a haystack contains a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContains
*/
function assertContains(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsEquals
*/
function assertContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertContainsEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContains')) {
/**
* Asserts that a haystack does not contain a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContains
*/
function assertNotContains(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertNotContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContainsEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContainsEquals
*/
function assertNotContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertNotContainsEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsOnly')) {
/**
* Asserts that a haystack contains only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsOnly
*/
function assertContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
Assert::assertContainsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsOnlyInstancesOf')) {
/**
* Asserts that a haystack contains only instances of a given class name.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsOnlyInstancesOf
*/
function assertContainsOnlyInstancesOf(string $className, iterable $haystack, string $message = ''): void
{
Assert::assertContainsOnlyInstancesOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContainsOnly')) {
/**
* Asserts that a haystack does not contain only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContainsOnly
*/
function assertNotContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
Assert::assertNotContainsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertCount')) {
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertCount
*/
function assertCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
Assert::assertCount(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotCount')) {
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotCount
*/
function assertNotCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
Assert::assertNotCount(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEquals')) {
/**
* Asserts that two variables are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEquals
*/
function assertEquals(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsCanonicalizing')) {
/**
* Asserts that two variables are equal (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsCanonicalizing
*/
function assertEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsIgnoringCase')) {
/**
* Asserts that two variables are equal (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsIgnoringCase
*/
function assertEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsWithDelta')) {
/**
* Asserts that two variables are equal (with delta).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsWithDelta
*/
function assertEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
Assert::assertEqualsWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEquals')) {
/**
* Asserts that two variables are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEquals
*/
function assertNotEquals(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsCanonicalizing')) {
/**
* Asserts that two variables are not equal (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsCanonicalizing
*/
function assertNotEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsIgnoringCase')) {
/**
* Asserts that two variables are not equal (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsIgnoringCase
*/
function assertNotEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsWithDelta')) {
/**
* Asserts that two variables are not equal (with delta).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsWithDelta
*/
function assertNotEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
Assert::assertNotEqualsWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectEquals
*/
function assertObjectEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
{
Assert::assertObjectEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEmpty')) {
/**
* Asserts that a variable is empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert empty $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEmpty
*/
function assertEmpty(mixed $actual, string $message = ''): void
{
Assert::assertEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEmpty')) {
/**
* Asserts that a variable is not empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert !empty $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEmpty
*/
function assertNotEmpty(mixed $actual, string $message = ''): void
{
Assert::assertNotEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertGreaterThan')) {
/**
* Asserts that a value is greater than another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertGreaterThan
*/
function assertGreaterThan(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertGreaterThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertGreaterThanOrEqual')) {
/**
* Asserts that a value is greater than or equal to another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertGreaterThanOrEqual
*/
function assertGreaterThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertGreaterThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertLessThan')) {
/**
* Asserts that a value is smaller than another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertLessThan
*/
function assertLessThan(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertLessThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertLessThanOrEqual')) {
/**
* Asserts that a value is smaller than or equal to another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertLessThanOrEqual
*/
function assertLessThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertLessThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEquals')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEquals
*/
function assertFileEquals(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEqualsCanonicalizing')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEqualsCanonicalizing
*/
function assertFileEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEqualsIgnoringCase')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEqualsIgnoringCase
*/
function assertFileEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEquals')) {
/**
* Asserts that the contents of one file is not equal to the contents of
* another file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEquals
*/
function assertFileNotEquals(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEqualsCanonicalizing')) {
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEqualsCanonicalizing
*/
function assertFileNotEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEqualsIgnoringCase')) {
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEqualsIgnoringCase
*/
function assertFileNotEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFile')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFile
*/
function assertStringEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFileCanonicalizing')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFileCanonicalizing
*/
function assertStringEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFileCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFileIgnoringCase')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFileIgnoringCase
*/
function assertStringEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFileIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFile')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFile
*/
function assertStringNotEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFileCanonicalizing')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFileCanonicalizing
*/
function assertStringNotEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFileCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFileIgnoringCase')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFileIgnoringCase
*/
function assertStringNotEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFileIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsReadable')) {
/**
* Asserts that a file/dir is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsReadable
*/
function assertIsReadable(string $filename, string $message = ''): void
{
Assert::assertIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotReadable')) {
/**
* Asserts that a file/dir exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotReadable
*/
function assertIsNotReadable(string $filename, string $message = ''): void
{
Assert::assertIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsWritable')) {
/**
* Asserts that a file/dir exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsWritable
*/
function assertIsWritable(string $filename, string $message = ''): void
{
Assert::assertIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotWritable')) {
/**
* Asserts that a file/dir exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotWritable
*/
function assertIsNotWritable(string $filename, string $message = ''): void
{
Assert::assertIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryExists')) {
/**
* Asserts that a directory exists.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryExists
*/
function assertDirectoryExists(string $directory, string $message = ''): void
{
Assert::assertDirectoryExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryDoesNotExist')) {
/**
* Asserts that a directory does not exist.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryDoesNotExist
*/
function assertDirectoryDoesNotExist(string $directory, string $message = ''): void
{
Assert::assertDirectoryDoesNotExist(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsReadable')) {
/**
* Asserts that a directory exists and is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsReadable
*/
function assertDirectoryIsReadable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsNotReadable')) {
/**
* Asserts that a directory exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsNotReadable
*/
function assertDirectoryIsNotReadable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsWritable')) {
/**
* Asserts that a directory exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsWritable
*/
function assertDirectoryIsWritable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsNotWritable')) {
/**
* Asserts that a directory exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsNotWritable
*/
function assertDirectoryIsNotWritable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileExists')) {
/**
* Asserts that a file exists.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileExists
*/
function assertFileExists(string $filename, string $message = ''): void
{
Assert::assertFileExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileDoesNotExist')) {
/**
* Asserts that a file does not exist.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileDoesNotExist
*/
function assertFileDoesNotExist(string $filename, string $message = ''): void
{
Assert::assertFileDoesNotExist(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsReadable')) {
/**
* Asserts that a file exists and is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsReadable
*/
function assertFileIsReadable(string $file, string $message = ''): void
{
Assert::assertFileIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsNotReadable')) {
/**
* Asserts that a file exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsNotReadable
*/
function assertFileIsNotReadable(string $file, string $message = ''): void
{
Assert::assertFileIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsWritable')) {
/**
* Asserts that a file exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsWritable
*/
function assertFileIsWritable(string $file, string $message = ''): void
{
Assert::assertFileIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsNotWritable')) {
/**
* Asserts that a file exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsNotWritable
*/
function assertFileIsNotWritable(string $file, string $message = ''): void
{
Assert::assertFileIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertTrue')) {
/**
* Asserts that a condition is true.
*
* @throws ExpectationFailedException
*
* @psalm-assert true $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertTrue
*/
function assertTrue(mixed $condition, string $message = ''): void
{
Assert::assertTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotTrue')) {
/**
* Asserts that a condition is not true.
*
* @throws ExpectationFailedException
*
* @psalm-assert !true $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotTrue
*/
function assertNotTrue(mixed $condition, string $message = ''): void
{
Assert::assertNotTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFalse')) {
/**
* Asserts that a condition is false.
*
* @throws ExpectationFailedException
*
* @psalm-assert false $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFalse
*/
function assertFalse(mixed $condition, string $message = ''): void
{
Assert::assertFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotFalse')) {
/**
* Asserts that a condition is not false.
*
* @throws ExpectationFailedException
*
* @psalm-assert !false $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotFalse
*/
function assertNotFalse(mixed $condition, string $message = ''): void
{
Assert::assertNotFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNull')) {
/**
* Asserts that a variable is null.
*
* @throws ExpectationFailedException
*
* @psalm-assert null $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNull
*/
function assertNull(mixed $actual, string $message = ''): void
{
Assert::assertNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotNull')) {
/**
* Asserts that a variable is not null.
*
* @throws ExpectationFailedException
*
* @psalm-assert !null $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotNull
*/
function assertNotNull(mixed $actual, string $message = ''): void
{
Assert::assertNotNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFinite')) {
/**
* Asserts that a variable is finite.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFinite
*/
function assertFinite(mixed $actual, string $message = ''): void
{
Assert::assertFinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertInfinite')) {
/**
* Asserts that a variable is infinite.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertInfinite
*/
function assertInfinite(mixed $actual, string $message = ''): void
{
Assert::assertInfinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNan')) {
/**
* Asserts that a variable is nan.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNan
*/
function assertNan(mixed $actual, string $message = ''): void
{
Assert::assertNan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectHasProperty')) {
/**
* Asserts that an object has a specified property.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectHasProperty
*/
function assertObjectHasProperty(string $propertyName, object $object, string $message = ''): void
{
Assert::assertObjectHasProperty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectNotHasProperty')) {
/**
* Asserts that an object does not have a specified property.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectNotHasProperty
*/
function assertObjectNotHasProperty(string $propertyName, object $object, string $message = ''): void
{
Assert::assertObjectNotHasProperty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertSame')) {
/**
* Asserts that two variables have the same type and value.
* Used on objects, it asserts that two variables reference
* the same object.
*
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType
*
* @psalm-param ExpectedType $expected
*
* @psalm-assert =ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertSame
*/
function assertSame(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertSame(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotSame')) {
/**
* Asserts that two variables do not have the same type and value.
* Used on objects, it asserts that two variables do not reference
* the same object.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotSame
*/
function assertNotSame(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotSame(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertInstanceOf')) {
/**
* Asserts that a variable is of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws UnknownClassOrInterfaceException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert =ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertInstanceOf
*/
function assertInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
Assert::assertInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotInstanceOf')) {
/**
* Asserts that a variable is not of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert !ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotInstanceOf
*/
function assertNotInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsArray')) {
/**
* Asserts that a variable is of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert array $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsArray
*/
function assertIsArray(mixed $actual, string $message = ''): void
{
Assert::assertIsArray(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsBool')) {
/**
* Asserts that a variable is of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert bool $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsBool
*/
function assertIsBool(mixed $actual, string $message = ''): void
{
Assert::assertIsBool(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsFloat')) {
/**
* Asserts that a variable is of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert float $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsFloat
*/
function assertIsFloat(mixed $actual, string $message = ''): void
{
Assert::assertIsFloat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsInt')) {
/**
* Asserts that a variable is of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert int $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsInt
*/
function assertIsInt(mixed $actual, string $message = ''): void
{
Assert::assertIsInt(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNumeric')) {
/**
* Asserts that a variable is of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert numeric $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNumeric
*/
function assertIsNumeric(mixed $actual, string $message = ''): void
{
Assert::assertIsNumeric(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsObject')) {
/**
* Asserts that a variable is of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert object $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsObject
*/
function assertIsObject(mixed $actual, string $message = ''): void
{
Assert::assertIsObject(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsResource')) {
/**
* Asserts that a variable is of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsResource
*/
function assertIsResource(mixed $actual, string $message = ''): void
{
Assert::assertIsResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsClosedResource')) {
/**
* Asserts that a variable is of type resource and is closed.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsClosedResource
*/
function assertIsClosedResource(mixed $actual, string $message = ''): void
{
Assert::assertIsClosedResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsString')) {
/**
* Asserts that a variable is of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert string $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsString
*/
function assertIsString(mixed $actual, string $message = ''): void
{
Assert::assertIsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsScalar')) {
/**
* Asserts that a variable is of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert scalar $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsScalar
*/
function assertIsScalar(mixed $actual, string $message = ''): void
{
Assert::assertIsScalar(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsCallable')) {
/**
* Asserts that a variable is of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert callable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsCallable
*/
function assertIsCallable(mixed $actual, string $message = ''): void
{
Assert::assertIsCallable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsIterable')) {
/**
* Asserts that a variable is of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert iterable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsIterable
*/
function assertIsIterable(mixed $actual, string $message = ''): void
{
Assert::assertIsIterable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotArray')) {
/**
* Asserts that a variable is not of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !array $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotArray
*/
function assertIsNotArray(mixed $actual, string $message = ''): void
{
Assert::assertIsNotArray(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotBool')) {
/**
* Asserts that a variable is not of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !bool $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotBool
*/
function assertIsNotBool(mixed $actual, string $message = ''): void
{
Assert::assertIsNotBool(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotFloat')) {
/**
* Asserts that a variable is not of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !float $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotFloat
*/
function assertIsNotFloat(mixed $actual, string $message = ''): void
{
Assert::assertIsNotFloat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotInt')) {
/**
* Asserts that a variable is not of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !int $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotInt
*/
function assertIsNotInt(mixed $actual, string $message = ''): void
{
Assert::assertIsNotInt(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotNumeric')) {
/**
* Asserts that a variable is not of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !numeric $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotNumeric
*/
function assertIsNotNumeric(mixed $actual, string $message = ''): void
{
Assert::assertIsNotNumeric(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotObject')) {
/**
* Asserts that a variable is not of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !object $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotObject
*/
function assertIsNotObject(mixed $actual, string $message = ''): void
{
Assert::assertIsNotObject(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotResource')) {
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotResource
*/
function assertIsNotResource(mixed $actual, string $message = ''): void
{
Assert::assertIsNotResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotClosedResource')) {
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotClosedResource
*/
function assertIsNotClosedResource(mixed $actual, string $message = ''): void
{
Assert::assertIsNotClosedResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotString')) {
/**
* Asserts that a variable is not of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !string $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotString
*/
function assertIsNotString(mixed $actual, string $message = ''): void
{
Assert::assertIsNotString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotScalar')) {
/**
* Asserts that a variable is not of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !scalar $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotScalar
*/
function assertIsNotScalar(mixed $actual, string $message = ''): void
{
Assert::assertIsNotScalar(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotCallable')) {
/**
* Asserts that a variable is not of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !callable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotCallable
*/
function assertIsNotCallable(mixed $actual, string $message = ''): void
{
Assert::assertIsNotCallable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotIterable')) {
/**
* Asserts that a variable is not of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !iterable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotIterable
*/
function assertIsNotIterable(mixed $actual, string $message = ''): void
{
Assert::assertIsNotIterable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertMatchesRegularExpression')) {
/**
* Asserts that a string matches a given regular expression.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertMatchesRegularExpression
*/
function assertMatchesRegularExpression(string $pattern, string $string, string $message = ''): void
{
Assert::assertMatchesRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDoesNotMatchRegularExpression')) {
/**
* Asserts that a string does not match a given regular expression.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDoesNotMatchRegularExpression
*/
function assertDoesNotMatchRegularExpression(string $pattern, string $string, string $message = ''): void
{
Assert::assertDoesNotMatchRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertSameSize')) {
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertSameSize
*/
function assertSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
Assert::assertSameSize(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotSameSize')) {
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is not the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotSameSize
*/
function assertNotSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
Assert::assertNotSameSize(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsStringIgnoringLineEndings')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsStringIgnoringLineEndings
*/
function assertStringContainsStringIgnoringLineEndings(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsStringIgnoringLineEndings')) {
/**
* Asserts that two strings are equal except for line endings.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsStringIgnoringLineEndings
*/
function assertStringEqualsStringIgnoringLineEndings(string $expected, string $actual, string $message = ''): void
{
Assert::assertStringEqualsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileMatchesFormat')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileMatchesFormat
*/
function assertFileMatchesFormat(string $format, string $actualFile, string $message = ''): void
{
Assert::assertFileMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileMatchesFormatFile')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileMatchesFormatFile
*/
function assertFileMatchesFormatFile(string $formatFile, string $actualFile, string $message = ''): void
{
Assert::assertFileMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringMatchesFormat')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringMatchesFormat
*/
function assertStringMatchesFormat(string $format, string $string, string $message = ''): void
{
Assert::assertStringMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotMatchesFormat')) {
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotMatchesFormat
*/
function assertStringNotMatchesFormat(string $format, string $string, string $message = ''): void
{
Assert::assertStringNotMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringMatchesFormatFile')) {
/**
* Asserts that a string matches a given format file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringMatchesFormatFile
*/
function assertStringMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
Assert::assertStringMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotMatchesFormatFile')) {
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotMatchesFormatFile
*/
function assertStringNotMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
Assert::assertStringNotMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringStartsWith')) {
/**
* Asserts that a string starts with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringStartsWith
*/
function assertStringStartsWith(string $prefix, string $string, string $message = ''): void
{
Assert::assertStringStartsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringStartsNotWith')) {
/**
* Asserts that a string starts not with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringStartsNotWith
*/
function assertStringStartsNotWith(string $prefix, string $string, string $message = ''): void
{
Assert::assertStringStartsNotWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsString')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsString
*/
function assertStringContainsString(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsStringIgnoringCase')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsStringIgnoringCase
*/
function assertStringContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsStringIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotContainsString')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotContainsString
*/
function assertStringNotContainsString(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringNotContainsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotContainsStringIgnoringCase')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotContainsStringIgnoringCase
*/
function assertStringNotContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringNotContainsStringIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEndsWith')) {
/**
* Asserts that a string ends with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEndsWith
*/
function assertStringEndsWith(string $suffix, string $string, string $message = ''): void
{
Assert::assertStringEndsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEndsNotWith')) {
/**
* Asserts that a string ends not with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEndsNotWith
*/
function assertStringEndsNotWith(string $suffix, string $string, string $message = ''): void
{
Assert::assertStringEndsNotWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlFileEqualsXmlFile')) {
/**
* Asserts that two XML files are equal.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlFileEqualsXmlFile
*/
function assertXmlFileEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertXmlFileEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlFileNotEqualsXmlFile')) {
/**
* Asserts that two XML files are not equal.
*
* @throws \PHPUnit\Util\Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlFileNotEqualsXmlFile
*/
function assertXmlFileNotEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertXmlFileNotEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringEqualsXmlFile')) {
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringEqualsXmlFile
*/
function assertXmlStringEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringNotEqualsXmlFile')) {
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringNotEqualsXmlFile
*/
function assertXmlStringNotEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringNotEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringEqualsXmlString')) {
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringEqualsXmlString
*/
function assertXmlStringEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringEqualsXmlString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringNotEqualsXmlString')) {
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringNotEqualsXmlString
*/
function assertXmlStringNotEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringNotEqualsXmlString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertThat')) {
/**
* Evaluates a PHPUnit\Framework\Constraint matcher object.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertThat
*/
function assertThat(mixed $value, Constraint $constraint, string $message = ''): void
{
Assert::assertThat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJson')) {
/**
* Asserts that a string is a valid JSON string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJson
*/
function assertJson(string $actual, string $message = ''): void
{
Assert::assertJson(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringEqualsJsonString')) {
/**
* Asserts that two given JSON encoded objects or arrays are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringEqualsJsonString
*/
function assertJsonStringEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringEqualsJsonString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringNotEqualsJsonString')) {
/**
* Asserts that two given JSON encoded objects or arrays are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringNotEqualsJsonString
*/
function assertJsonStringNotEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringNotEqualsJsonString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringEqualsJsonFile')) {
/**
* Asserts that the generated JSON encoded object and the content of the given file are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringEqualsJsonFile
*/
function assertJsonStringEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringNotEqualsJsonFile')) {
/**
* Asserts that the generated JSON encoded object and the content of the given file are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringNotEqualsJsonFile
*/
function assertJsonStringNotEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringNotEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonFileEqualsJsonFile')) {
/**
* Asserts that two JSON files are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonFileEqualsJsonFile
*/
function assertJsonFileEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertJsonFileEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonFileNotEqualsJsonFile')) {
/**
* Asserts that two JSON files are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonFileNotEqualsJsonFile
*/
function assertJsonFileNotEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertJsonFileNotEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalAnd')) {
function logicalAnd(mixed ...$constraints): LogicalAnd
{
return Assert::logicalAnd(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalOr')) {
function logicalOr(mixed ...$constraints): LogicalOr
{
return Assert::logicalOr(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalNot')) {
function logicalNot(Constraint $constraint): LogicalNot
{
return Assert::logicalNot(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalXor')) {
function logicalXor(mixed ...$constraints): LogicalXor
{
return Assert::logicalXor(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\anything')) {
function anything(): IsAnything
{
return Assert::anything(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isTrue')) {
function isTrue(): IsTrue
{
return Assert::isTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isFalse')) {
function isFalse(): IsFalse
{
return Assert::isFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isJson')) {
function isJson(): IsJson
{
return Assert::isJson(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isNull')) {
function isNull(): IsNull
{
return Assert::isNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isFinite')) {
function isFinite(): IsFinite
{
return Assert::isFinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isInfinite')) {
function isInfinite(): IsInfinite
{
return Assert::isInfinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isNan')) {
function isNan(): IsNan
{
return Assert::isNan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsEqual')) {
function containsEqual(mixed $value): TraversableContainsEqual
{
return Assert::containsEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsIdentical')) {
function containsIdentical(mixed $value): TraversableContainsIdentical
{
return Assert::containsIdentical(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsOnly')) {
function containsOnly(string $type): TraversableContainsOnly
{
return Assert::containsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsOnlyInstancesOf')) {
function containsOnlyInstancesOf(string $className): TraversableContainsOnly
{
return Assert::containsOnlyInstancesOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\arrayHasKey')) {
function arrayHasKey(int|string $key): ArrayHasKey
{
return Assert::arrayHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isList')) {
function isList(): IsList
{
return Assert::isList(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalTo')) {
function equalTo(mixed $value): IsEqual
{
return Assert::equalTo(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToCanonicalizing')) {
function equalToCanonicalizing(mixed $value): IsEqualCanonicalizing
{
return Assert::equalToCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToIgnoringCase')) {
function equalToIgnoringCase(mixed $value): IsEqualIgnoringCase
{
return Assert::equalToIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToWithDelta')) {
function equalToWithDelta(mixed $value, float $delta): IsEqualWithDelta
{
return Assert::equalToWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isEmpty')) {
function isEmpty(): IsEmpty
{
return Assert::isEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isWritable')) {
function isWritable(): IsWritable
{
return Assert::isWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isReadable')) {
function isReadable(): IsReadable
{
return Assert::isReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\directoryExists')) {
function directoryExists(): DirectoryExists
{
return Assert::directoryExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\fileExists')) {
function fileExists(): FileExists
{
return Assert::fileExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\greaterThan')) {
function greaterThan(mixed $value): GreaterThan
{
return Assert::greaterThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\greaterThanOrEqual')) {
function greaterThanOrEqual(mixed $value): LogicalOr
{
return Assert::greaterThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\identicalTo')) {
function identicalTo(mixed $value): IsIdentical
{
return Assert::identicalTo(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isInstanceOf')) {
function isInstanceOf(string $className): IsInstanceOf
{
return Assert::isInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isType')) {
function isType(string $type): IsType
{
return Assert::isType(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\lessThan')) {
function lessThan(mixed $value): LessThan
{
return Assert::lessThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\lessThanOrEqual')) {
function lessThanOrEqual(mixed $value): LogicalOr
{
return Assert::lessThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\matchesRegularExpression')) {
function matchesRegularExpression(string $pattern): RegularExpression
{
return Assert::matchesRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\matches')) {
function matches(string $string): StringMatchesFormatDescription
{
return Assert::matches(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringStartsWith')) {
function stringStartsWith(string $prefix): StringStartsWith
{
return Assert::stringStartsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringContains')) {
function stringContains(string $string, bool $case = true): StringContains
{
return Assert::stringContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringEndsWith')) {
function stringEndsWith(string $suffix): StringEndsWith
{
return Assert::stringEndsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringEqualsStringIgnoringLineEndings')) {
function stringEqualsStringIgnoringLineEndings(string $string): StringEqualsStringIgnoringLineEndings
{
return Assert::stringEqualsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\countOf')) {
function countOf(int $count): Count
{
return Assert::countOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\objectEquals')) {
function objectEquals(object $object, string $method = 'equals'): ObjectEquals
{
return Assert::objectEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\callback')) {
/**
* @psalm-template CallbackInput of mixed
*
* @psalm-param callable(CallbackInput $callback): bool $callback
*
* @psalm-return Callback<CallbackInput>
*/
function callback(callable $callback): Callback
{
return Assert::callback($callback);
}
}
if (!function_exists('PHPUnit\Framework\any')) {
/**
* Returns a matcher that matches when the method is executed
* zero or more times.
*/
function any(): AnyInvokedCountMatcher
{
return new AnyInvokedCountMatcher;
}
}
if (!function_exists('PHPUnit\Framework\never')) {
/**
* Returns a matcher that matches when the method is never executed.
*/
function never(): InvokedCountMatcher
{
return new InvokedCountMatcher(0);
}
}
if (!function_exists('PHPUnit\Framework\atLeast')) {
/**
* Returns a matcher that matches when the method is executed
* at least N times.
*/
function atLeast(int $requiredInvocations): InvokedAtLeastCountMatcher
{
return new InvokedAtLeastCountMatcher(
$requiredInvocations,
);
}
}
if (!function_exists('PHPUnit\Framework\atLeastOnce')) {
/**
* Returns a matcher that matches when the method is executed at least once.
*/
function atLeastOnce(): InvokedAtLeastOnceMatcher
{
return new InvokedAtLeastOnceMatcher;
}
}
if (!function_exists('PHPUnit\Framework\once')) {
/**
* Returns a matcher that matches when the method is executed exactly once.
*/
function once(): InvokedCountMatcher
{
return new InvokedCountMatcher(1);
}
}
if (!function_exists('PHPUnit\Framework\exactly')) {
/**
* Returns a matcher that matches when the method is executed
* exactly $count times.
*/
function exactly(int $count): InvokedCountMatcher
{
return new InvokedCountMatcher($count);
}
}
if (!function_exists('PHPUnit\Framework\atMost')) {
/**
* Returns a matcher that matches when the method is executed
* at most N times.
*/
function atMost(int $allowedInvocations): InvokedAtMostCountMatcher
{
return new InvokedAtMostCountMatcher($allowedInvocations);
}
}
if (!function_exists('PHPUnit\Framework\returnValue')) {
function returnValue(mixed $value): ReturnStub
{
return new ReturnStub($value);
}
}
if (!function_exists('PHPUnit\Framework\returnValueMap')) {
function returnValueMap(array $valueMap): ReturnValueMapStub
{
return new ReturnValueMapStub($valueMap);
}
}
if (!function_exists('PHPUnit\Framework\returnArgument')) {
function returnArgument(int $argumentIndex): ReturnArgumentStub
{
return new ReturnArgumentStub($argumentIndex);
}
}
if (!function_exists('PHPUnit\Framework\returnCallback')) {
function returnCallback(callable $callback): ReturnCallbackStub
{
return new ReturnCallbackStub($callback);
}
}
if (!function_exists('PHPUnit\Framework\returnSelf')) {
/**
* Returns the current object.
*
* This method is useful when mocking a fluent interface.
*/
function returnSelf(): ReturnSelfStub
{
return new ReturnSelfStub;
}
}
if (!function_exists('PHPUnit\Framework\throwException')) {
function throwException(Throwable $exception): ExceptionStub
{
return new ExceptionStub($exception);
}
}
if (!function_exists('PHPUnit\Framework\onConsecutiveCalls')) {
function onConsecutiveCalls(): ConsecutiveCallsStub
{
$arguments = func_get_args();
return new ConsecutiveCallsStub($arguments);
}
}
phpunit/src/Framework/Attributes/RunTestsInSeparateProcesses.php 0000644 00000001020 15243417753 0021254 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class RunTestsInSeparateProcesses
{
}
phpunit/src/Framework/Attributes/DependsUsingDeepClone.php 0000644 00000001673 15243417753 0020007 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsUsingDeepClone
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/AfterClass.php 0000644 00000001000 15243417753 0015647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class AfterClass
{
}
phpunit/src/Framework/Attributes/RequiresSetting.php 0000644 00000002362 15243417753 0016771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresSetting
{
/**
* @psalm-var non-empty-string
*/
private readonly string $setting;
/**
* @psalm-var non-empty-string
*/
private readonly string $value;
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public function __construct(string $setting, string $value)
{
$this->setting = $setting;
$this->value = $value;
}
/**
* @psalm-return non-empty-string
*/
public function setting(): string
{
return $this->setting;
}
/**
* @psalm-return non-empty-string
*/
public function value(): string
{
return $this->value;
}
}
phpunit/src/Framework/Attributes/Test.php 0000644 00000000772 15243417753 0014556 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class Test
{
}
phpunit/src/Framework/Attributes/BeforeClass.php 0000644 00000001001 15243417753 0016011 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class BeforeClass
{
}
phpunit/src/Framework/Attributes/DependsExternalUsingDeepClone.php 0000644 00000002412 15243417753 0021502 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternalUsingDeepClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/BackupGlobals.php 0000644 00000001360 15243417753 0016342 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class BackupGlobals
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Framework/Attributes/DependsUsingShallowClone.php 0000644 00000001676 15243417753 0020546 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsUsingShallowClone
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/RunInSeparateProcess.php 0000644 00000001012 15243417753 0017702 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class RunInSeparateProcess
{
}
phpunit/src/Framework/Attributes/CoversClass.php 0000644 00000001635 15243417753 0016065 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class CoversClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/IgnoreClassForCodeCoverage.php 0000644 00000001767 15243417753 0020773 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreClassForCodeCoverage
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/DependsOnClass.php 0000644 00000001641 15243417753 0016500 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/TestWithJson.php 0000644 00000001610 15243417753 0016234 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class TestWithJson
{
/**
* @psalm-var non-empty-string
*/
private readonly string $json;
/**
* @psalm-param non-empty-string $json
*/
public function __construct(string $json)
{
$this->json = $json;
}
/**
* @psalm-return non-empty-string
*/
public function json(): string
{
return $this->json;
}
}
phpunit/src/Framework/Attributes/DataProvider.php 0000644 00000001662 15243417753 0016222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DataProvider
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/CoversNothing.php 0000644 00000001035 15243417753 0016420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class CoversNothing
{
}
phpunit/src/Framework/Attributes/Before.php 0000644 00000000774 15243417753 0015043 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class Before
{
}
phpunit/src/Framework/Attributes/DependsOnClassUsingDeepClone.php 0000644 00000001657 15243417753 0021274 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClassUsingDeepClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/RunClassInSeparateProcess.php 0000644 00000001016 15243417753 0020674 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class RunClassInSeparateProcess
{
}
phpunit/src/Framework/Attributes/Medium.php 0000644 00000000773 15243417753 0015060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Medium
{
}
phpunit/src/Framework/Attributes/RequiresOperatingSystem.php 0000644 00000001755 15243417753 0020516 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresOperatingSystem
{
/**
* @psalm-var non-empty-string
*/
private readonly string $regularExpression;
/**
* @psalm-param non-empty-string $regularExpression
*/
public function __construct(string $regularExpression)
{
$this->regularExpression = $regularExpression;
}
/**
* @psalm-return non-empty-string
*/
public function regularExpression(): string
{
return $this->regularExpression;
}
}
phpunit/src/Framework/Attributes/Ticket.php 0000644 00000001634 15243417753 0015060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Ticket
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param non-empty-string $text
*/
public function __construct(string $text)
{
$this->text = $text;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
phpunit/src/Framework/Attributes/PreCondition.php 0000644 00000001002 15243417753 0016217 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class PreCondition
{
}
phpunit/src/Framework/Attributes/RequiresOperatingSystemFamily.php 0000644 00000002017 15243417753 0021650 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresOperatingSystemFamily
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystemFamily;
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public function __construct(string $operatingSystemFamily)
{
$this->operatingSystemFamily = $operatingSystemFamily;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
phpunit/src/Framework/Attributes/IgnoreMethodForCodeCoverage.php 0000644 00000002522 15243417753 0021134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreMethodForCodeCoverage
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/BackupStaticProperties.php 0000644 00000001371 15243417753 0020265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class BackupStaticProperties
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Framework/Attributes/WithoutErrorHandler.php 0000644 00000001011 15243417753 0017575 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class WithoutErrorHandler
{
}
phpunit/src/Framework/Attributes/TestDox.php 0000644 00000001602 15243417753 0015222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class TestDox
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param non-empty-string $text
*/
public function __construct(string $text)
{
$this->text = $text;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
phpunit/src/Framework/Attributes/RequiresFunction.php 0000644 00000001736 15243417753 0017145 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Framework/Attributes/UsesFunction.php 0000644 00000001677 15243417753 0016271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class UsesFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Framework/Attributes/UsesClass.php 0000644 00000001633 15243417753 0015541 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class UsesClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/After.php 0000644 00000000773 15243417753 0014701 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class After
{
}
phpunit/src/Framework/Attributes/Group.php 0000644 00000001633 15243417753 0014730 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Group
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name)
{
$this->name = $name;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
}
phpunit/src/Framework/Attributes/Small.php 0000644 00000000772 15243417753 0014707 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Small
{
}
phpunit/src/Framework/Attributes/ExcludeGlobalVariableFromBackup.php 0000644 00000002027 15243417753 0021764 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class ExcludeGlobalVariableFromBackup
{
/**
* @psalm-var non-empty-string
*/
private readonly string $globalVariableName;
/**
* @psalm-param non-empty-string $globalVariableName
*/
public function __construct(string $globalVariableName)
{
$this->globalVariableName = $globalVariableName;
}
/**
* @psalm-return non-empty-string
*/
public function globalVariableName(): string
{
return $this->globalVariableName;
}
}
phpunit/src/Framework/Attributes/IgnoreDeprecations.php 0000644 00000001042 15243417753 0017412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class IgnoreDeprecations
{
}
phpunit/src/Framework/Attributes/DoesNotPerformAssertions.php 0000644 00000001050 15243417753 0020606 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class DoesNotPerformAssertions
{
}
phpunit/src/Framework/Attributes/Depends.php 0000644 00000001655 15243417753 0015222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Depends
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/PostCondition.php 0000644 00000001003 15243417753 0016417 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class PostCondition
{
}
phpunit/src/Framework/Attributes/PreserveGlobalState.php 0000644 00000001366 15243417753 0017554 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class PreserveGlobalState
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
phpunit/src/Framework/Attributes/RequiresMethod.php 0000644 00000002425 15243417753 0016574 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresMethod
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/IgnoreFunctionForCodeCoverage.php 0000644 00000002033 15243417753 0021476 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreFunctionForCodeCoverage
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Framework/Attributes/Large.php 0000644 00000000772 15243417753 0014671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Large
{
}
phpunit/src/Framework/Attributes/CodeCoverageIgnore.php 0000644 00000001155 15243417753 0017325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5236
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class CodeCoverageIgnore
{
}
phpunit/src/Framework/Attributes/DataProviderExternal.php 0000644 00000002401 15243417753 0017715 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DataProviderExternal
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/TestWith.php 0000644 00000001335 15243417753 0015406 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class TestWith
{
private readonly array $data;
public function __construct(array $data)
{
$this->data = $data;
}
public function data(): array
{
return $this->data;
}
}
phpunit/src/Framework/Attributes/RequiresPhpExtension.php 0000644 00000002600 15243417753 0017773 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresPhpExtension
{
/**
* @psalm-var non-empty-string
*/
private readonly string $extension;
/**
* @psalm-var null|non-empty-string
*/
private readonly ?string $versionRequirement;
/**
* @psalm-param non-empty-string $extension
* @psalm-param null|non-empty-string $versionRequirement
*/
public function __construct(string $extension, ?string $versionRequirement = null)
{
$this->extension = $extension;
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function extension(): string
{
return $this->extension;
}
/**
* @psalm-return null|non-empty-string
*/
public function versionRequirement(): ?string
{
return $this->versionRequirement;
}
}
phpunit/src/Framework/Attributes/RequiresPhpunit.php 0000644 00000001754 15243417753 0017007 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresPhpunit
{
/**
* @psalm-var non-empty-string
*/
private readonly string $versionRequirement;
/**
* @psalm-param non-empty-string $versionRequirement
*/
public function __construct(string $versionRequirement)
{
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function versionRequirement(): string
{
return $this->versionRequirement;
}
}
phpunit/src/Framework/Attributes/ExcludeStaticPropertyFromBackup.php 0000644 00000002466 15243417753 0022121 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class ExcludeStaticPropertyFromBackup
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $propertyName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public function __construct(string $className, string $propertyName)
{
$this->className = $className;
$this->propertyName = $propertyName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function propertyName(): string
{
return $this->propertyName;
}
}
phpunit/src/Framework/Attributes/CoversFunction.php 0000644 00000001701 15243417753 0016577 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class CoversFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
phpunit/src/Framework/Attributes/RequiresPhp.php 0000644 00000001750 15243417753 0016103 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresPhp
{
/**
* @psalm-var non-empty-string
*/
private readonly string $versionRequirement;
/**
* @psalm-param non-empty-string $versionRequirement
*/
public function __construct(string $versionRequirement)
{
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function versionRequirement(): string
{
return $this->versionRequirement;
}
}
phpunit/src/Framework/Attributes/DependsOnClassUsingShallowClone.php 0000644 00000001662 15243417753 0022024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClassUsingShallowClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
phpunit/src/Framework/Attributes/DependsExternal.php 0000644 00000002374 15243417753 0016724 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternal
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Attributes/DependsExternalUsingShallowClone.php 0000644 00000002415 15243417753 0022241 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternalUsingShallowClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
phpunit/src/Framework/Assert.php 0000644 00000205623 15243417753 0012754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function class_exists;
use function count;
use function file_get_contents;
use function interface_exists;
use function is_bool;
use ArrayAccess;
use Countable;
use Generator;
use PHPUnit\Event;
use PHPUnit\Framework\Constraint\ArrayHasKey;
use PHPUnit\Framework\Constraint\Callback;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\Count;
use PHPUnit\Framework\Constraint\DirectoryExists;
use PHPUnit\Framework\Constraint\FileExists;
use PHPUnit\Framework\Constraint\GreaterThan;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEmpty;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\Constraint\IsEqualCanonicalizing;
use PHPUnit\Framework\Constraint\IsEqualIgnoringCase;
use PHPUnit\Framework\Constraint\IsEqualWithDelta;
use PHPUnit\Framework\Constraint\IsFalse;
use PHPUnit\Framework\Constraint\IsFinite;
use PHPUnit\Framework\Constraint\IsIdentical;
use PHPUnit\Framework\Constraint\IsInfinite;
use PHPUnit\Framework\Constraint\IsInstanceOf;
use PHPUnit\Framework\Constraint\IsJson;
use PHPUnit\Framework\Constraint\IsList;
use PHPUnit\Framework\Constraint\IsNan;
use PHPUnit\Framework\Constraint\IsNull;
use PHPUnit\Framework\Constraint\IsReadable;
use PHPUnit\Framework\Constraint\IsTrue;
use PHPUnit\Framework\Constraint\IsType;
use PHPUnit\Framework\Constraint\IsWritable;
use PHPUnit\Framework\Constraint\JsonMatches;
use PHPUnit\Framework\Constraint\LessThan;
use PHPUnit\Framework\Constraint\LogicalAnd;
use PHPUnit\Framework\Constraint\LogicalNot;
use PHPUnit\Framework\Constraint\LogicalOr;
use PHPUnit\Framework\Constraint\LogicalXor;
use PHPUnit\Framework\Constraint\ObjectEquals;
use PHPUnit\Framework\Constraint\ObjectHasProperty;
use PHPUnit\Framework\Constraint\RegularExpression;
use PHPUnit\Framework\Constraint\SameSize;
use PHPUnit\Framework\Constraint\StringContains;
use PHPUnit\Framework\Constraint\StringEndsWith;
use PHPUnit\Framework\Constraint\StringEqualsStringIgnoringLineEndings;
use PHPUnit\Framework\Constraint\StringMatchesFormatDescription;
use PHPUnit\Framework\Constraint\StringStartsWith;
use PHPUnit\Framework\Constraint\TraversableContainsEqual;
use PHPUnit\Framework\Constraint\TraversableContainsIdentical;
use PHPUnit\Framework\Constraint\TraversableContainsOnly;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Assert
{
private static int $count = 0;
/**
* Asserts that an array has a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertArrayHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
$constraint = new ArrayHasKey($key);
static::assertThat($array, $constraint, $message);
}
/**
* Asserts that an array does not have a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
$constraint = new LogicalNot(
new ArrayHasKey($key),
);
static::assertThat($array, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertIsList(mixed $array, string $message = ''): void
{
static::assertThat(
$array,
new IsList,
$message,
);
}
/**
* Asserts that a haystack contains a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContains(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new TraversableContainsIdentical($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new TraversableContainsEqual($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a haystack does not contain a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertNotContains(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new LogicalNot(
new TraversableContainsIdentical($needle),
);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertNotContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new TraversableContainsEqual($needle));
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a haystack contains only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
if ($isNativeType === null) {
$isNativeType = self::isNativeType($type);
}
static::assertThat(
$haystack,
new TraversableContainsOnly(
$type,
$isNativeType,
),
$message,
);
}
/**
* Asserts that a haystack contains only instances of a given class name.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContainsOnlyInstancesOf(string $className, iterable $haystack, string $message = ''): void
{
static::assertThat(
$haystack,
new TraversableContainsOnly(
$className,
false,
),
$message,
);
}
/**
* Asserts that a haystack does not contain only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertNotContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
if ($isNativeType === null) {
$isNativeType = self::isNativeType($type);
}
static::assertThat(
$haystack,
new LogicalNot(
new TraversableContainsOnly(
$type,
$isNativeType,
),
),
$message,
);
}
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
if ($haystack instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$haystack');
}
static::assertThat(
$haystack,
new Count($expectedCount),
$message,
);
}
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertNotCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
if ($haystack instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$haystack');
}
$constraint = new LogicalNot(
new Count($expectedCount),
);
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that two variables are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertEquals(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqual($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqualCanonicalizing($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqualIgnoringCase($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (with delta).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
$constraint = new IsEqualWithDelta(
$expected,
$delta,
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertNotEquals(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqual($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualCanonicalizing($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualIgnoringCase($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (with delta).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualWithDelta(
$expected,
$delta,
),
);
static::assertThat($actual, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertObjectEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
{
static::assertThat(
$actual,
static::objectEquals($expected, $method),
$message,
);
}
/**
* Asserts that a variable is empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert empty $actual
*/
final public static function assertEmpty(mixed $actual, string $message = ''): void
{
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat($actual, static::isEmpty(), $message);
}
/**
* Asserts that a variable is not empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert !empty $actual
*/
final public static function assertNotEmpty(mixed $actual, string $message = ''): void
{
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat($actual, static::logicalNot(static::isEmpty()), $message);
}
/**
* Asserts that a value is greater than another value.
*
* @throws ExpectationFailedException
*/
final public static function assertGreaterThan(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::greaterThan($expected), $message);
}
/**
* Asserts that a value is greater than or equal to another value.
*
* @throws ExpectationFailedException
*/
final public static function assertGreaterThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
static::greaterThanOrEqual($expected),
$message,
);
}
/**
* Asserts that a value is smaller than another value.
*
* @throws ExpectationFailedException
*/
final public static function assertLessThan(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::lessThan($expected), $message);
}
/**
* Asserts that a value is smaller than or equal to another value.
*
* @throws ExpectationFailedException
*/
final public static function assertLessThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::lessThanOrEqual($expected), $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file.
*
* @throws ExpectationFailedException
*/
final public static function assertFileEquals(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqual(file_get_contents($expected));
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertFileEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqualCanonicalizing(
file_get_contents($expected),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertFileEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqualIgnoringCase(file_get_contents($expected));
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of
* another file.
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEquals(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqual(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqualCanonicalizing(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqualIgnoringCase(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqual(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqualCanonicalizing(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqualIgnoringCase(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqual(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqualCanonicalizing(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqualIgnoringCase(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that a file/dir is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsReadable(string $filename, string $message = ''): void
{
static::assertThat($filename, new IsReadable, $message);
}
/**
* Asserts that a file/dir exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsNotReadable(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new IsReadable), $message);
}
/**
* Asserts that a file/dir exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsWritable(string $filename, string $message = ''): void
{
static::assertThat($filename, new IsWritable, $message);
}
/**
* Asserts that a file/dir exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsNotWritable(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new IsWritable), $message);
}
/**
* Asserts that a directory exists.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryExists(string $directory, string $message = ''): void
{
static::assertThat($directory, new DirectoryExists, $message);
}
/**
* Asserts that a directory does not exist.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryDoesNotExist(string $directory, string $message = ''): void
{
static::assertThat($directory, new LogicalNot(new DirectoryExists), $message);
}
/**
* Asserts that a directory exists and is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsReadable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsReadable($directory, $message);
}
/**
* Asserts that a directory exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsNotReadable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsNotReadable($directory, $message);
}
/**
* Asserts that a directory exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsWritable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsWritable($directory, $message);
}
/**
* Asserts that a directory exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsNotWritable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsNotWritable($directory, $message);
}
/**
* Asserts that a file exists.
*
* @throws ExpectationFailedException
*/
final public static function assertFileExists(string $filename, string $message = ''): void
{
static::assertThat($filename, new FileExists, $message);
}
/**
* Asserts that a file does not exist.
*
* @throws ExpectationFailedException
*/
final public static function assertFileDoesNotExist(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new FileExists), $message);
}
/**
* Asserts that a file exists and is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsReadable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsReadable($file, $message);
}
/**
* Asserts that a file exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsNotReadable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsNotReadable($file, $message);
}
/**
* Asserts that a file exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsWritable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsWritable($file, $message);
}
/**
* Asserts that a file exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsNotWritable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsNotWritable($file, $message);
}
/**
* Asserts that a condition is true.
*
* @throws ExpectationFailedException
*
* @psalm-assert true $condition
*/
final public static function assertTrue(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::isTrue(), $message);
}
/**
* Asserts that a condition is not true.
*
* @throws ExpectationFailedException
*
* @psalm-assert !true $condition
*/
final public static function assertNotTrue(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::logicalNot(static::isTrue()), $message);
}
/**
* Asserts that a condition is false.
*
* @throws ExpectationFailedException
*
* @psalm-assert false $condition
*/
final public static function assertFalse(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::isFalse(), $message);
}
/**
* Asserts that a condition is not false.
*
* @throws ExpectationFailedException
*
* @psalm-assert !false $condition
*/
final public static function assertNotFalse(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::logicalNot(static::isFalse()), $message);
}
/**
* Asserts that a variable is null.
*
* @throws ExpectationFailedException
*
* @psalm-assert null $actual
*/
final public static function assertNull(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isNull(), $message);
}
/**
* Asserts that a variable is not null.
*
* @throws ExpectationFailedException
*
* @psalm-assert !null $actual
*/
final public static function assertNotNull(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::logicalNot(static::isNull()), $message);
}
/**
* Asserts that a variable is finite.
*
* @throws ExpectationFailedException
*/
final public static function assertFinite(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isFinite(), $message);
}
/**
* Asserts that a variable is infinite.
*
* @throws ExpectationFailedException
*/
final public static function assertInfinite(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isInfinite(), $message);
}
/**
* Asserts that a variable is nan.
*
* @throws ExpectationFailedException
*/
final public static function assertNan(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isNan(), $message);
}
/**
* Asserts that an object has a specified property.
*
* @throws ExpectationFailedException
*/
final public static function assertObjectHasProperty(string $propertyName, object $object, string $message = ''): void
{
static::assertThat(
$object,
new ObjectHasProperty($propertyName),
$message,
);
}
/**
* Asserts that an object does not have a specified property.
*
* @throws ExpectationFailedException
*/
final public static function assertObjectNotHasProperty(string $propertyName, object $object, string $message = ''): void
{
static::assertThat(
$object,
new LogicalNot(
new ObjectHasProperty($propertyName),
),
$message,
);
}
/**
* Asserts that two variables have the same type and value.
* Used on objects, it asserts that two variables reference
* the same object.
*
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType
*
* @psalm-param ExpectedType $expected
*
* @psalm-assert =ExpectedType $actual
*/
final public static function assertSame(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsIdentical($expected),
$message,
);
}
/**
* Asserts that two variables do not have the same type and value.
* Used on objects, it asserts that two variables do not reference
* the same object.
*
* @throws ExpectationFailedException
*/
final public static function assertNotSame(mixed $expected, mixed $actual, string $message = ''): void
{
if (is_bool($expected) && is_bool($actual)) {
static::assertNotEquals($expected, $actual, $message);
}
static::assertThat(
$actual,
new LogicalNot(
new IsIdentical($expected),
),
$message,
);
}
/**
* Asserts that a variable is of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws UnknownClassOrInterfaceException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert =ExpectedType $actual
*/
final public static function assertInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
if (!class_exists($expected) && !interface_exists($expected)) {
throw new UnknownClassOrInterfaceException($expected);
}
static::assertThat(
$actual,
new IsInstanceOf($expected),
$message,
);
}
/**
* Asserts that a variable is not of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert !ExpectedType $actual
*/
final public static function assertNotInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
if (!class_exists($expected) && !interface_exists($expected)) {
throw new UnknownClassOrInterfaceException($expected);
}
static::assertThat(
$actual,
new LogicalNot(
new IsInstanceOf($expected),
),
$message,
);
}
/**
* Asserts that a variable is of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert array $actual
*/
final public static function assertIsArray(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_ARRAY),
$message,
);
}
/**
* Asserts that a variable is of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert bool $actual
*/
final public static function assertIsBool(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_BOOL),
$message,
);
}
/**
* Asserts that a variable is of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert float $actual
*/
final public static function assertIsFloat(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_FLOAT),
$message,
);
}
/**
* Asserts that a variable is of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert int $actual
*/
final public static function assertIsInt(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_INT),
$message,
);
}
/**
* Asserts that a variable is of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert numeric $actual
*/
final public static function assertIsNumeric(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_NUMERIC),
$message,
);
}
/**
* Asserts that a variable is of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert object $actual
*/
final public static function assertIsObject(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_OBJECT),
$message,
);
}
/**
* Asserts that a variable is of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*/
final public static function assertIsResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_RESOURCE),
$message,
);
}
/**
* Asserts that a variable is of type resource and is closed.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*/
final public static function assertIsClosedResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_CLOSED_RESOURCE),
$message,
);
}
/**
* Asserts that a variable is of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert string $actual
*/
final public static function assertIsString(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_STRING),
$message,
);
}
/**
* Asserts that a variable is of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert scalar $actual
*/
final public static function assertIsScalar(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_SCALAR),
$message,
);
}
/**
* Asserts that a variable is of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert callable $actual
*/
final public static function assertIsCallable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_CALLABLE),
$message,
);
}
/**
* Asserts that a variable is of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert iterable $actual
*/
final public static function assertIsIterable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_ITERABLE),
$message,
);
}
/**
* Asserts that a variable is not of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !array $actual
*/
final public static function assertIsNotArray(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_ARRAY)),
$message,
);
}
/**
* Asserts that a variable is not of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !bool $actual
*/
final public static function assertIsNotBool(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_BOOL)),
$message,
);
}
/**
* Asserts that a variable is not of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !float $actual
*/
final public static function assertIsNotFloat(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_FLOAT)),
$message,
);
}
/**
* Asserts that a variable is not of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !int $actual
*/
final public static function assertIsNotInt(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_INT)),
$message,
);
}
/**
* Asserts that a variable is not of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !numeric $actual
*/
final public static function assertIsNotNumeric(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_NUMERIC)),
$message,
);
}
/**
* Asserts that a variable is not of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !object $actual
*/
final public static function assertIsNotObject(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_OBJECT)),
$message,
);
}
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*/
final public static function assertIsNotResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_RESOURCE)),
$message,
);
}
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*/
final public static function assertIsNotClosedResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_CLOSED_RESOURCE)),
$message,
);
}
/**
* Asserts that a variable is not of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !string $actual
*/
final public static function assertIsNotString(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_STRING)),
$message,
);
}
/**
* Asserts that a variable is not of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !scalar $actual
*/
final public static function assertIsNotScalar(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_SCALAR)),
$message,
);
}
/**
* Asserts that a variable is not of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !callable $actual
*/
final public static function assertIsNotCallable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_CALLABLE)),
$message,
);
}
/**
* Asserts that a variable is not of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !iterable $actual
*/
final public static function assertIsNotIterable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_ITERABLE)),
$message,
);
}
/**
* Asserts that a string matches a given regular expression.
*
* @throws ExpectationFailedException
*/
final public static function assertMatchesRegularExpression(string $pattern, string $string, string $message = ''): void
{
static::assertThat($string, new RegularExpression($pattern), $message);
}
/**
* Asserts that a string does not match a given regular expression.
*
* @throws ExpectationFailedException
*/
final public static function assertDoesNotMatchRegularExpression(string $pattern, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new RegularExpression($pattern),
),
$message,
);
}
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
if ($expected instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$expected');
}
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat(
$actual,
new SameSize($expected),
$message,
);
}
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is not the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertNotSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
if ($expected instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$expected');
}
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat(
$actual,
new LogicalNot(
new SameSize($expected),
),
$message,
);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsStringIgnoringLineEndings(string $needle, string $haystack, string $message = ''): void
{
static::assertThat($haystack, new StringContains($needle, false, true), $message);
}
/**
* Asserts that two strings are equal except for line endings.
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsStringIgnoringLineEndings(string $expected, string $actual, string $message = ''): void
{
static::assertThat($actual, new StringEqualsStringIgnoringLineEndings($expected), $message);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertFileMatchesFormat(string $format, string $actualFile, string $message = ''): void
{
static::assertFileExists($actualFile, $message);
static::assertThat(
file_get_contents($actualFile),
new StringMatchesFormatDescription($format),
$message,
);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertFileMatchesFormatFile(string $formatFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertFileExists($actualFile, $message);
static::assertThat(
file_get_contents($actualFile),
new StringMatchesFormatDescription(file_get_contents($formatFile)),
$message,
);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertStringMatchesFormat(string $format, string $string, string $message = ''): void
{
static::assertThat($string, new StringMatchesFormatDescription($format), $message);
}
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*/
final public static function assertStringNotMatchesFormat(string $format, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringMatchesFormatDescription($format),
),
$message,
);
}
/**
* Asserts that a string matches a given format file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertThat(
$string,
new StringMatchesFormatDescription(
file_get_contents($formatFile),
),
$message,
);
}
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*/
final public static function assertStringNotMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertThat(
$string,
new LogicalNot(
new StringMatchesFormatDescription(
file_get_contents($formatFile),
),
),
$message,
);
}
/**
* Asserts that a string starts with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringStartsWith(string $prefix, string $string, string $message = ''): void
{
static::assertThat($string, new StringStartsWith($prefix), $message);
}
/**
* Asserts that a string starts not with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringStartsNotWith(string $prefix, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringStartsWith($prefix),
),
$message,
);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsString(string $needle, string $haystack, string $message = ''): void
{
$constraint = new StringContains($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
$constraint = new StringContains($needle, true);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringNotContainsString(string $needle, string $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new StringContains($needle));
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringNotContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new StringContains($needle, true));
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a string ends with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringEndsWith(string $suffix, string $string, string $message = ''): void
{
static::assertThat($string, new StringEndsWith($suffix), $message);
}
/**
* Asserts that a string ends not with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringEndsNotWith(string $suffix, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringEndsWith($suffix),
),
$message,
);
}
/**
* Asserts that two XML files are equal.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlFileEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->loadFile($actualFile);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML files are not equal.
*
* @throws \PHPUnit\Util\Exception
* @throws ExpectationFailedException
*/
final public static function assertXmlFileNotEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->loadFile($actualFile);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->load($actualXml);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringNotEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->load($actualXml);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->load($expectedXml);
$actual = (new XmlLoader)->load($actualXml);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringNotEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->load($expectedXml);
$actual = (new XmlLoader)->load($actualXml);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Evaluates a PHPUnit\Framework\Constraint matcher object.
*
* @throws ExpectationFailedException
*/
final public static function assertThat(mixed $value, Constraint $constraint, string $message = ''): void
{
self::$count += count($constraint);
$hasFailed = true;
try {
$constraint->evaluate($value, $message);
$hasFailed = false;
} finally {
if ($hasFailed) {
Event\Facade::emitter()->testAssertionFailed(
$value,
$constraint,
$message,
);
} else {
Event\Facade::emitter()->testAssertionSucceeded(
$value,
$constraint,
$message,
);
}
}
}
/**
* Asserts that a string is a valid JSON string.
*
* @throws ExpectationFailedException
*/
final public static function assertJson(string $actual, string $message = ''): void
{
static::assertThat($actual, static::isJson(), $message);
}
/**
* Asserts that two given JSON encoded objects or arrays are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat($actualJson, new JsonMatches($expectedJson), $message);
}
/**
* Asserts that two given JSON encoded objects or arrays are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringNotEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat(
$actualJson,
new LogicalNot(
new JsonMatches($expectedJson),
),
$message,
);
}
/**
* Asserts that the generated JSON encoded object and the content of the given file are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat($actualJson, new JsonMatches($expectedJson), $message);
}
/**
* Asserts that the generated JSON encoded object and the content of the given file are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringNotEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat(
$actualJson,
new LogicalNot(
new JsonMatches($expectedJson),
),
$message,
);
}
/**
* Asserts that two JSON files are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonFileEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
static::assertFileExists($actualFile, $message);
$actualJson = file_get_contents($actualFile);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
$constraintExpected = new JsonMatches(
$expectedJson,
);
$constraintActual = new JsonMatches($actualJson);
static::assertThat($expectedJson, $constraintActual, $message);
static::assertThat($actualJson, $constraintExpected, $message);
}
/**
* Asserts that two JSON files are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonFileNotEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
static::assertFileExists($actualFile, $message);
$actualJson = file_get_contents($actualFile);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
$constraintExpected = new JsonMatches(
$expectedJson,
);
$constraintActual = new JsonMatches($actualJson);
static::assertThat($expectedJson, new LogicalNot($constraintActual), $message);
static::assertThat($actualJson, new LogicalNot($constraintExpected), $message);
}
/**
* @throws Exception
*/
final public static function logicalAnd(mixed ...$constraints): LogicalAnd
{
return LogicalAnd::fromConstraints(...$constraints);
}
final public static function logicalOr(mixed ...$constraints): LogicalOr
{
return LogicalOr::fromConstraints(...$constraints);
}
final public static function logicalNot(Constraint $constraint): LogicalNot
{
return new LogicalNot($constraint);
}
final public static function logicalXor(mixed ...$constraints): LogicalXor
{
return LogicalXor::fromConstraints(...$constraints);
}
final public static function anything(): IsAnything
{
return new IsAnything;
}
final public static function isTrue(): IsTrue
{
return new IsTrue;
}
/**
* @psalm-template CallbackInput of mixed
*
* @psalm-param callable(CallbackInput $callback): bool $callback
*
* @psalm-return Callback<CallbackInput>
*/
final public static function callback(callable $callback): Callback
{
return new Callback($callback);
}
final public static function isFalse(): IsFalse
{
return new IsFalse;
}
final public static function isJson(): IsJson
{
return new IsJson;
}
final public static function isNull(): IsNull
{
return new IsNull;
}
final public static function isFinite(): IsFinite
{
return new IsFinite;
}
final public static function isInfinite(): IsInfinite
{
return new IsInfinite;
}
final public static function isNan(): IsNan
{
return new IsNan;
}
final public static function containsEqual(mixed $value): TraversableContainsEqual
{
return new TraversableContainsEqual($value);
}
final public static function containsIdentical(mixed $value): TraversableContainsIdentical
{
return new TraversableContainsIdentical($value);
}
/**
* @throws Exception
*/
final public static function containsOnly(string $type): TraversableContainsOnly
{
return new TraversableContainsOnly($type);
}
/**
* @throws Exception
*/
final public static function containsOnlyInstancesOf(string $className): TraversableContainsOnly
{
return new TraversableContainsOnly($className, false);
}
final public static function arrayHasKey(int|string $key): ArrayHasKey
{
return new ArrayHasKey($key);
}
final public static function isList(): IsList
{
return new IsList;
}
final public static function equalTo(mixed $value): IsEqual
{
return new IsEqual($value, 0.0, false, false);
}
final public static function equalToCanonicalizing(mixed $value): IsEqualCanonicalizing
{
return new IsEqualCanonicalizing($value);
}
final public static function equalToIgnoringCase(mixed $value): IsEqualIgnoringCase
{
return new IsEqualIgnoringCase($value);
}
final public static function equalToWithDelta(mixed $value, float $delta): IsEqualWithDelta
{
return new IsEqualWithDelta($value, $delta);
}
final public static function isEmpty(): IsEmpty
{
return new IsEmpty;
}
final public static function isWritable(): IsWritable
{
return new IsWritable;
}
final public static function isReadable(): IsReadable
{
return new IsReadable;
}
final public static function directoryExists(): DirectoryExists
{
return new DirectoryExists;
}
final public static function fileExists(): FileExists
{
return new FileExists;
}
final public static function greaterThan(mixed $value): GreaterThan
{
return new GreaterThan($value);
}
final public static function greaterThanOrEqual(mixed $value): LogicalOr
{
return static::logicalOr(
new IsEqual($value),
new GreaterThan($value),
);
}
final public static function identicalTo(mixed $value): IsIdentical
{
return new IsIdentical($value);
}
/**
* @throws UnknownClassOrInterfaceException
*/
final public static function isInstanceOf(string $className): IsInstanceOf
{
return new IsInstanceOf($className);
}
/**
* @psalm-param 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable' $type
*
* @throws Exception
*/
final public static function isType(string $type): IsType
{
return new IsType($type);
}
final public static function lessThan(mixed $value): LessThan
{
return new LessThan($value);
}
final public static function lessThanOrEqual(mixed $value): LogicalOr
{
return static::logicalOr(
new IsEqual($value),
new LessThan($value),
);
}
final public static function matchesRegularExpression(string $pattern): RegularExpression
{
return new RegularExpression($pattern);
}
final public static function matches(string $string): StringMatchesFormatDescription
{
return new StringMatchesFormatDescription($string);
}
/**
* @psalm-param non-empty-string $prefix
*
* @throws InvalidArgumentException
*/
final public static function stringStartsWith(string $prefix): StringStartsWith
{
return new StringStartsWith($prefix);
}
final public static function stringContains(string $string, bool $case = true): StringContains
{
return new StringContains($string, $case);
}
/**
* @psalm-param non-empty-string $suffix
*
* @throws InvalidArgumentException
*/
final public static function stringEndsWith(string $suffix): StringEndsWith
{
return new StringEndsWith($suffix);
}
final public static function stringEqualsStringIgnoringLineEndings(string $string): StringEqualsStringIgnoringLineEndings
{
return new StringEqualsStringIgnoringLineEndings($string);
}
final public static function countOf(int $count): Count
{
return new Count($count);
}
final public static function objectEquals(object $object, string $method = 'equals'): ObjectEquals
{
return new ObjectEquals($object, $method);
}
/**
* Fails a test with the given message.
*
* @throws AssertionFailedError
*/
final public static function fail(string $message = ''): never
{
self::$count++;
throw new AssertionFailedError($message);
}
/**
* Mark the test as incomplete.
*
* @throws IncompleteTestError
*/
final public static function markTestIncomplete(string $message = ''): never
{
throw new IncompleteTestError($message);
}
/**
* Mark the test as skipped.
*
* @throws SkippedWithMessageException
*/
final public static function markTestSkipped(string $message = ''): never
{
throw new SkippedWithMessageException($message);
}
/**
* Return the current assertion count.
*/
final public static function getCount(): int
{
return self::$count;
}
/**
* Reset the assertion counter.
*/
final public static function resetCount(): void
{
self::$count = 0;
}
private static function isNativeType(string $type): bool
{
return match ($type) {
'numeric', 'integer', 'int', 'iterable', 'float', 'string', 'boolean', 'bool', 'null', 'array', 'object', 'resource', 'scalar' => true,
default => false,
};
}
}
phpunit/src/Framework/TestSuiteIterator.php 0000644 00000003367 15243417753 0015157 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function assert;
use function count;
use RecursiveIterator;
/**
* @template-implements RecursiveIterator<int, Test>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteIterator implements RecursiveIterator
{
private int $position = 0;
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
public function __construct(TestSuite $testSuite)
{
$this->tests = $testSuite->tests();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->tests);
}
public function key(): int
{
return $this->position;
}
public function current(): Test
{
return $this->tests[$this->position];
}
public function next(): void
{
$this->position++;
}
/**
* @throws NoChildTestSuiteException
*/
public function getChildren(): self
{
if (!$this->hasChildren()) {
throw new NoChildTestSuiteException(
'The current item is not a TestSuite instance and therefore does not have any children.',
);
}
$current = $this->current();
assert($current instanceof TestSuite);
return new self($current);
}
public function hasChildren(): bool
{
return $this->valid() && $this->current() instanceof TestSuite;
}
}
phpunit/src/Framework/ExecutionOrderDependency.php 0000644 00000011452 15243417753 0016444 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function array_filter;
use function array_map;
use function array_values;
use function explode;
use function in_array;
use function str_contains;
use PHPUnit\Metadata\DependsOnClass;
use PHPUnit\Metadata\DependsOnMethod;
use Stringable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionOrderDependency implements Stringable
{
private string $className = '';
private string $methodName = '';
private readonly bool $shallowClone;
private readonly bool $deepClone;
public static function invalid(): self
{
return new self(
'',
'',
false,
false,
);
}
public static function forClass(DependsOnClass $metadata): self
{
return new self(
$metadata->className(),
'class',
$metadata->deepClone(),
$metadata->shallowClone(),
);
}
public static function forMethod(DependsOnMethod $metadata): self
{
return new self(
$metadata->className(),
$metadata->methodName(),
$metadata->deepClone(),
$metadata->shallowClone(),
);
}
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function filterInvalid(array $dependencies): array
{
return array_values(
array_filter(
$dependencies,
static fn (self $d) => $d->isValid(),
),
);
}
/**
* @psalm-param list<ExecutionOrderDependency> $existing
* @psalm-param list<ExecutionOrderDependency> $additional
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function mergeUnique(array $existing, array $additional): array
{
$existingTargets = array_map(
static fn ($dependency) => $dependency->getTarget(),
$existing,
);
foreach ($additional as $dependency) {
$additionalTarget = $dependency->getTarget();
if (in_array($additionalTarget, $existingTargets, true)) {
continue;
}
$existingTargets[] = $additionalTarget;
$existing[] = $dependency;
}
return $existing;
}
/**
* @psalm-param list<ExecutionOrderDependency> $left
* @psalm-param list<ExecutionOrderDependency> $right
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function diff(array $left, array $right): array
{
if ($right === []) {
return $left;
}
if ($left === []) {
return [];
}
$diff = [];
$rightTargets = array_map(
static fn ($dependency) => $dependency->getTarget(),
$right,
);
foreach ($left as $dependency) {
if (in_array($dependency->getTarget(), $rightTargets, true)) {
continue;
}
$diff[] = $dependency;
}
return $diff;
}
public function __construct(string $classOrCallableName, ?string $methodName = null, bool $deepClone = false, bool $shallowClone = false)
{
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
if ($classOrCallableName === '') {
return;
}
if (str_contains($classOrCallableName, '::')) {
[$this->className, $this->methodName] = explode('::', $classOrCallableName);
} else {
$this->className = $classOrCallableName;
$this->methodName = !empty($methodName) ? $methodName : 'class';
}
}
public function __toString(): string
{
return $this->getTarget();
}
public function isValid(): bool
{
// Invalid dependencies can be declared and are skipped by the runner
return $this->className !== '' && $this->methodName !== '';
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function targetIsClass(): bool
{
return $this->methodName === 'class';
}
public function getTarget(): string
{
return $this->isValid()
? $this->className . '::' . $this->methodName
: '';
}
public function getTargetClassName(): string
{
return $this->className;
}
}
phpunit/src/Framework/Reorderable.php 0000644 00000001224 15243417753 0013730 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Reorderable
{
public function sortId(): string;
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array;
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array;
}
phpunit/src/Framework/Exception/ExpectationFailedException.php 0000644 00000002241 15243417753 0020707 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Exception;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* Exception for expectations which failed their check.
*
* The exception contains the error message and optionally a
* SebastianBergmann\Comparator\ComparisonFailure which is used to
* generate diff output of the failed expectations.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExpectationFailedException extends AssertionFailedError
{
protected ?ComparisonFailure $comparisonFailure = null;
public function __construct(string $message, ?ComparisonFailure $comparisonFailure = null, ?Exception $previous = null)
{
$this->comparisonFailure = $comparisonFailure;
parent::__construct($message, 0, $previous);
}
public function getComparisonFailure(): ?ComparisonFailure
{
return $this->comparisonFailure;
}
}
phpunit/src/Framework/Exception/AssertionFailedError.php 0000644 00000001152 15243417753 0017526 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class AssertionFailedError extends Exception implements SelfDescribing
{
/**
* Wrapper for getMessage() which is declared as final.
*/
public function toString(): string
{
return $this->getMessage();
}
}
phpunit/src/Framework/Exception/InvalidArgumentException.php 0000644 00000000672 15243417753 0020416 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class InvalidArgumentException extends Exception
{
}
phpunit/src/Framework/Exception/UnknownTypeException.php 0000644 00000001240 15243417753 0017616 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownTypeException extends InvalidArgumentException
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Type "%s" is not known',
$name,
),
);
}
}
phpunit/src/Framework/Exception/Incomplete/IncompleteTestError.php 0000644 00000000727 15243417753 0021517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncompleteTestError extends AssertionFailedError implements IncompleteTest
{
}
phpunit/src/Framework/Exception/Incomplete/IncompleteTest.php 0000644 00000000673 15243417753 0020505 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface IncompleteTest extends Throwable
{
}
phpunit/src/Framework/Exception/NoChildTestSuiteException.php 0000644 00000000670 15243417753 0020515 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoChildTestSuiteException extends Exception
{
}
phpunit/src/Framework/Exception/EmptyStringException.php 0000644 00000000702 15243417753 0017604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class EmptyStringException extends InvalidArgumentException
{
}
phpunit/src/Framework/Exception/Skipped/SkippedWithMessageException.php 0000644 00000000734 15243417753 0022463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SkippedWithMessageException extends AssertionFailedError implements SkippedTest
{
}
phpunit/src/Framework/Exception/Skipped/SkippedTestSuiteError.php 0000644 00000000726 15243417753 0021330 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SkippedTestSuiteError extends AssertionFailedError implements SkippedTest
{
}
phpunit/src/Framework/Exception/Skipped/SkippedTest.php 0000644 00000000670 15243417753 0017302 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedTest extends Throwable
{
}
phpunit/src/Framework/Exception/CodeCoverageException.php 0000644 00000000656 15243417753 0017655 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class CodeCoverageException extends Exception
{
}
phpunit/src/Framework/Exception/InvalidDataProviderException.php 0000644 00000000673 15243417753 0021221 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDataProviderException extends Exception
{
}
phpunit/src/Framework/Exception/PhptAssertionFailedError.php 0000644 00000002453 15243417753 0020367 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptAssertionFailedError extends AssertionFailedError
{
private readonly string $syntheticFile;
private readonly int $syntheticLine;
private readonly array $syntheticTrace;
private readonly string $diff;
public function __construct(string $message, int $code, string $file, int $line, array $trace, string $diff)
{
parent::__construct($message, $code);
$this->syntheticFile = $file;
$this->syntheticLine = $line;
$this->syntheticTrace = $trace;
$this->diff = $diff;
}
public function syntheticFile(): string
{
return $this->syntheticFile;
}
public function syntheticLine(): int
{
return $this->syntheticLine;
}
public function syntheticTrace(): array
{
return $this->syntheticTrace;
}
public function diff(): string
{
return $this->diff;
}
}
phpunit/src/Framework/Exception/Exception.php 0000644 00000004204 15243417753 0015377 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function array_keys;
use function get_object_vars;
use RuntimeException;
use Throwable;
/**
* Base class for all PHPUnit Framework exceptions.
*
* Ensures that exceptions thrown during a test run do not leave stray
* references behind.
*
* Every Exception contains a stack trace. Each stack frame contains the 'args'
* of the called function. The function arguments can contain references to
* instantiated objects. The references prevent the objects from being
* destructed (until test results are eventually printed), so memory cannot be
* freed up.
*
* With enabled process isolation, test results are serialized in the child
* process and unserialized in the parent process. The stack trace of Exceptions
* may contain objects that cannot be serialized or unserialized (e.g., PDO
* connections). Unserializing user-space objects from the child process into
* the parent would break the intended encapsulation of process isolation.
*
* @see http://fabien.potencier.org/article/9/php-serialization-stack-traces-and-exceptions
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class Exception extends RuntimeException implements \PHPUnit\Exception
{
protected array $serializableTrace;
public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
$this->serializableTrace = $this->getTrace();
foreach (array_keys($this->serializableTrace) as $key) {
unset($this->serializableTrace[$key]['args']);
}
}
public function __sleep(): array
{
return array_keys(get_object_vars($this));
}
/**
* Returns the serializable trace (without 'args').
*/
public function getSerializableTrace(): array
{
return $this->serializableTrace;
}
}
phpunit/src/Framework/Exception/GeneratorNotSupportedException.php 0000644 00000001400 15243417753 0021630 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GeneratorNotSupportedException extends InvalidArgumentException
{
public static function fromParameterName(string $parameterName): self
{
return new self(
sprintf(
'Passing an argument of type Generator for the %s parameter is not supported',
$parameterName,
),
);
}
}
phpunit/src/Framework/Exception/UnknownClassOrInterfaceException.php 0000644 00000001274 15243417753 0022073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownClassOrInterfaceException extends InvalidArgumentException
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Class or interface "%s" does not exist',
$name,
),
);
}
}
phpunit/src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotAcceptParameterTypeException.php0000644 00000001475 15243417753 0030302 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotAcceptParameterTypeException extends Exception
{
public function __construct(string $className, string $methodName, string $type)
{
parent::__construct(
sprintf(
'%s is not an accepted argument type for comparison method %s::%s().',
$type,
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareBoolReturnTypeException.php 0000644 00000001424 15243417753 0030530 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareBoolReturnTypeException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not declare bool return type.',
$className,
$methodName,
),
);
}
}
phpunit/src/Framework/Exception/ObjectEquals/ActualValueIsNotAnObjectException.php 0000644 00000001103 15243417753 0024465 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ActualValueIsNotAnObjectException extends Exception
{
public function __construct()
{
parent::__construct(
'Actual value is not an object',
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareExactlyOneParameterException.php 0000644 00000001436 15243417753 0031512 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareExactlyOneParameterException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not declare exactly one parameter.',
$className,
$methodName,
),
);
}
}
phpunit/src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotExistException.php 0000644 00000001361 15243417753 0025466 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotExistException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not exist.',
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareParameterTypeException.php 0000644 00000001434 15243417753 0030356 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareParameterTypeException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Parameter of comparison method %s::%s() does not have a declared type.',
$className,
$methodName,
),
);
}
}
phpunit/src/Framework/Exception/InvalidDependencyException.php 0000644 00000000733 15243417753 0020710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDependencyException extends AssertionFailedError implements SkippedTest
{
}
phpunit/src/Framework/Exception/InvalidCoversTargetException.php 0000644 00000000707 15243417753 0021243 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidCoversTargetException extends CodeCoverageException
{
}
phpunit/src/Framework/Exception/ProcessIsolationException.php 0000644 00000000670 15243417753 0020623 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ProcessIsolationException extends Exception
{
}
phpunit/src/Framework/TestCase.php 0000644 00000215636 15243417753 0013233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const LC_ALL;
use const LC_COLLATE;
use const LC_CTYPE;
use const LC_MONETARY;
use const LC_NUMERIC;
use const LC_TIME;
use const PATHINFO_FILENAME;
use const PHP_EOL;
use const PHP_URL_PATH;
use function array_is_list;
use function array_keys;
use function array_map;
use function array_merge;
use function array_values;
use function assert;
use function basename;
use function chdir;
use function class_exists;
use function clearstatcache;
use function count;
use function defined;
use function explode;
use function getcwd;
use function implode;
use function in_array;
use function ini_set;
use function is_array;
use function is_callable;
use function is_int;
use function is_object;
use function is_string;
use function libxml_clear_errors;
use function method_exists;
use function ob_end_clean;
use function ob_get_clean;
use function ob_get_contents;
use function ob_get_level;
use function ob_start;
use function parse_url;
use function pathinfo;
use function preg_replace;
use function setlocale;
use function sprintf;
use function str_contains;
use function trim;
use AssertionError;
use DeepCopy\DeepCopy;
use PHPUnit\Event;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\RuntimeException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\Constraint\Exception as ExceptionConstraint;
use PHPUnit\Framework\Constraint\ExceptionCode;
use PHPUnit\Framework\Constraint\ExceptionMessageIsOrContains;
use PHPUnit\Framework\Constraint\ExceptionMessageMatchesRegularExpression;
use PHPUnit\Framework\MockObject\Exception as MockObjectException;
use PHPUnit\Framework\MockObject\Generator\Generator as MockGenerator;
use PHPUnit\Framework\MockObject\MockBuilder;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\MockObject\MockObjectInternal;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount as AnyInvokedCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastCount as InvokedAtLeastCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastOnce as InvokedAtLeastOnceMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount as InvokedAtMostCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedCount as InvokedCountMatcher;
use PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls as ConsecutiveCallsStub;
use PHPUnit\Framework\MockObject\Stub\Exception as ExceptionStub;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument as ReturnArgumentStub;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback as ReturnCallbackStub;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf as ReturnSelfStub;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap as ReturnValueMapStub;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\Api\HookMethods;
use PHPUnit\Metadata\Api\Requirements;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\TestRunner\TestResult\PassedTests;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\Cloner;
use PHPUnit\Util\Test as TestUtil;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
use ReflectionObject;
use ReflectionParameter;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
use SebastianBergmann\Diff\Differ;
use SebastianBergmann\Diff\Output\UnifiedDiffOutputBuilder;
use SebastianBergmann\Exporter\Exporter;
use SebastianBergmann\GlobalState\ExcludeList as GlobalStateExcludeList;
use SebastianBergmann\GlobalState\Restorer;
use SebastianBergmann\GlobalState\Snapshot;
use SebastianBergmann\Invoker\TimeoutException;
use SebastianBergmann\ObjectEnumerator\Enumerator;
use SebastianBergmann\RecursionContext\Context;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestCase extends Assert implements Reorderable, SelfDescribing, Test
{
private const LOCALE_CATEGORIES = [LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC, LC_TIME];
private ?bool $backupGlobals = null;
/**
* @psalm-var list<string>
*/
private array $backupGlobalsExcludeList = [];
private ?bool $backupStaticProperties = null;
/**
* @psalm-var array<string,list<class-string>>
*/
private array $backupStaticPropertiesExcludeList = [];
private ?Snapshot $snapshot = null;
private ?bool $runClassInSeparateProcess = null;
private ?bool $runTestInSeparateProcess = null;
private bool $preserveGlobalState = false;
private bool $inIsolation = false;
private ?string $expectedException = null;
private ?string $expectedExceptionMessage = null;
private ?string $expectedExceptionMessageRegExp = null;
private null|int|string $expectedExceptionCode = null;
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $providedTests = [];
private array $data = [];
private int|string $dataName = '';
/**
* @psalm-var non-empty-string
*/
private string $name;
/**
* @psalm-var list<string>
*/
private array $groups = [];
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $dependencies = [];
private array $dependencyInput = [];
/**
* @psalm-var array<string,string>
*/
private array $iniSettings = [];
private array $locale = [];
/**
* @psalm-var list<MockObjectInternal>
*/
private array $mockObjects = [];
private bool $registerMockObjectsFromTestArgumentsRecursively = false;
private TestStatus $status;
private int $numberOfAssertionsPerformed = 0;
private mixed $testResult = null;
private string $output = '';
private ?string $outputExpectedRegex = null;
private ?string $outputExpectedString = null;
private bool $outputBufferingActive = false;
private int $outputBufferingLevel;
private bool $outputRetrievedForAssertion = false;
private bool $doesNotPerformAssertions = false;
/**
* @psalm-var list<Comparator>
*/
private array $customComparators = [];
private ?Event\Code\TestMethod $testValueObjectForEvents = null;
private bool $wasPrepared = false;
/**
* @psalm-var array<class-string, true>
*/
private array $failureTypes = [];
/**
* Returns a matcher that matches when the method is executed
* zero or more times.
*/
final public static function any(): AnyInvokedCountMatcher
{
return new AnyInvokedCountMatcher;
}
/**
* Returns a matcher that matches when the method is never executed.
*/
final public static function never(): InvokedCountMatcher
{
return new InvokedCountMatcher(0);
}
/**
* Returns a matcher that matches when the method is executed
* at least N times.
*/
final public static function atLeast(int $requiredInvocations): InvokedAtLeastCountMatcher
{
return new InvokedAtLeastCountMatcher(
$requiredInvocations,
);
}
/**
* Returns a matcher that matches when the method is executed at least once.
*/
final public static function atLeastOnce(): InvokedAtLeastOnceMatcher
{
return new InvokedAtLeastOnceMatcher;
}
/**
* Returns a matcher that matches when the method is executed exactly once.
*/
final public static function once(): InvokedCountMatcher
{
return new InvokedCountMatcher(1);
}
/**
* Returns a matcher that matches when the method is executed
* exactly $count times.
*/
final public static function exactly(int $count): InvokedCountMatcher
{
return new InvokedCountMatcher($count);
}
/**
* Returns a matcher that matches when the method is executed
* at most N times.
*/
final public static function atMost(int $allowedInvocations): InvokedAtMostCountMatcher
{
return new InvokedAtMostCountMatcher($allowedInvocations);
}
/**
* @deprecated Use <code>$double->willReturn()</code> instead of <code>$double->will($this->returnValue())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnValue(mixed $value): ReturnStub
{
return new ReturnStub($value);
}
/**
* @deprecated Use <code>$double->willReturnMap()</code> instead of <code>$double->will($this->returnValueMap())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnValueMap(array $valueMap): ReturnValueMapStub
{
return new ReturnValueMapStub($valueMap);
}
/**
* @deprecated Use <code>$double->willReturnArgument()</code> instead of <code>$double->will($this->returnArgument())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnArgument(int $argumentIndex): ReturnArgumentStub
{
return new ReturnArgumentStub($argumentIndex);
}
/**
* @deprecated Use <code>$double->willReturnCallback()</code> instead of <code>$double->will($this->returnCallback())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnCallback(callable $callback): ReturnCallbackStub
{
return new ReturnCallbackStub($callback);
}
/**
* @deprecated Use <code>$double->willReturnSelf()</code> instead of <code>$double->will($this->returnSelf())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnSelf(): ReturnSelfStub
{
return new ReturnSelfStub;
}
final public static function throwException(Throwable $exception): ExceptionStub
{
return new ExceptionStub($exception);
}
/**
* @deprecated Use <code>$double->willReturn()</code> instead of <code>$double->will($this->onConsecutiveCalls())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
* @see https://github.com/sebastianbergmann/phpunit/issues/5425
*/
final public static function onConsecutiveCalls(mixed ...$arguments): ConsecutiveCallsStub
{
return new ConsecutiveCallsStub($arguments);
}
/**
* @psalm-param non-empty-string $name
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function __construct(string $name)
{
$this->setName($name);
$this->status = TestStatus::unknown();
}
/**
* This method is called before the first test of this test class is run.
*/
public static function setUpBeforeClass(): void
{
}
/**
* This method is called after the last test of this test class is run.
*/
public static function tearDownAfterClass(): void
{
}
/**
* This method is called before each test.
*/
protected function setUp(): void
{
}
/**
* Performs assertions shared by all tests of a test case.
*
* This method is called between setUp() and test.
*/
protected function assertPreConditions(): void
{
}
/**
* Performs assertions shared by all tests of a test case.
*
* This method is called between test and tearDown().
*/
protected function assertPostConditions(): void
{
}
/**
* This method is called after each test.
*/
protected function tearDown(): void
{
}
/**
* Returns a string representation of the test case.
*
* @throws Exception
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function toString(): string
{
$buffer = sprintf(
'%s::%s',
(new ReflectionClass($this))->getName(),
$this->name,
);
return $buffer . $this->dataSetAsStringWithData();
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function count(): int
{
return 1;
}
final public function getActualOutputForAssertion(): string
{
$this->outputRetrievedForAssertion = true;
return $this->output();
}
final public function expectOutputRegex(string $expectedRegex): void
{
$this->outputExpectedRegex = $expectedRegex;
}
final public function expectOutputString(string $expectedString): void
{
$this->outputExpectedString = $expectedString;
}
/**
* @psalm-param class-string<Throwable> $exception
*/
final public function expectException(string $exception): void
{
$this->expectedException = $exception;
}
final public function expectExceptionCode(int|string $code): void
{
$this->expectedExceptionCode = $code;
}
final public function expectExceptionMessage(string $message): void
{
$this->expectedExceptionMessage = $message;
}
final public function expectExceptionMessageMatches(string $regularExpression): void
{
$this->expectedExceptionMessageRegExp = $regularExpression;
}
/**
* Sets up an expectation for an exception to be raised by the code under test.
* Information for expected exception class, expected exception message, and
* expected exception code are retrieved from a given Exception object.
*/
final public function expectExceptionObject(\Exception $exception): void
{
$this->expectException($exception::class);
$this->expectExceptionMessage($exception->getMessage());
$this->expectExceptionCode($exception->getCode());
}
final public function expectNotToPerformAssertions(): void
{
$this->doesNotPerformAssertions = true;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function status(): TestStatus
{
return $this->status;
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws \PHPUnit\Util\Exception
* @throws \SebastianBergmann\CodeCoverage\InvalidArgumentException
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws CodeCoverageException
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
* @throws ProcessIsolationException
* @throws StaticAnalysisCacheNotConfiguredException
* @throws UnintentionallyCoveredCodeException
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function run(): void
{
if (!$this->handleDependencies()) {
return;
}
if (!$this->shouldRunInSeparateProcess()) {
(new TestRunner)->run($this);
} else {
(new TestRunner)->runInSeparateProcess(
$this,
$this->runClassInSeparateProcess && !$this->runTestInSeparateProcess,
$this->preserveGlobalState,
);
}
}
/**
* Returns a builder object to create mock objects using a fluent interface.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $className
*
* @psalm-return MockBuilder<RealInstanceType>
*/
final public function getMockBuilder(string $className): MockBuilder
{
return new MockBuilder($this, $className);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function groups(): array
{
return $this->groups;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setGroups(array $groups): void
{
$this->groups = $groups;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function nameWithDataSet(): string
{
return $this->name . $this->dataSetAsString();
}
/**
* @psalm-return non-empty-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function name(): string
{
return $this->name;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function size(): TestSize
{
return (new Groups)->size(
static::class,
$this->name,
);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function hasUnexpectedOutput(): bool
{
if ($this->output === '') {
return false;
}
if ($this->expectsOutput()) {
return false;
}
return true;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function output(): string
{
if (!$this->outputBufferingActive) {
return $this->output;
}
return (string) ob_get_contents();
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function doesNotPerformAssertions(): bool
{
return $this->doesNotPerformAssertions;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function expectsOutput(): bool
{
return $this->hasExpectationOnOutput() || $this->outputRetrievedForAssertion;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final public function registerMockObjectsFromTestArgumentsRecursively(): void
{
$this->registerMockObjectsFromTestArgumentsRecursively = true;
}
/**
* @throws Throwable
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function runBare(): void
{
$emitter = Event\Facade::emitter();
$emitter->testPreparationStarted(
$this->valueObjectForEvents(),
);
$this->snapshotGlobalState();
$this->startOutputBuffering();
clearstatcache();
$hookMethods = (new HookMethods)->hookMethods(static::class);
$hasMetRequirements = false;
$this->numberOfAssertionsPerformed = 0;
$currentWorkingDirectory = getcwd();
try {
$this->checkRequirements();
$hasMetRequirements = true;
if ($this->inIsolation) {
$this->invokeBeforeClassHookMethods($hookMethods, $emitter);
}
if (method_exists(static::class, $this->name) &&
MetadataRegistry::parser()->forClassAndMethod(static::class, $this->name)->isDoesNotPerformAssertions()->isNotEmpty()) {
$this->doesNotPerformAssertions = true;
}
$this->invokeBeforeTestHookMethods($hookMethods, $emitter);
$this->invokePreConditionHookMethods($hookMethods, $emitter);
$emitter->testPrepared(
$this->valueObjectForEvents(),
);
$this->wasPrepared = true;
$this->testResult = $this->runTest();
$this->verifyMockObjects();
$this->invokePostConditionHookMethods($hookMethods, $emitter);
$this->status = TestStatus::success();
} catch (IncompleteTest $e) {
$this->status = TestStatus::incomplete($e->getMessage());
$emitter->testMarkedAsIncomplete(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
);
} catch (SkippedTest $e) {
$this->status = TestStatus::skipped($e->getMessage());
$emitter->testSkipped(
$this->valueObjectForEvents(),
$e->getMessage(),
);
} catch (AssertionError|AssertionFailedError $e) {
if (!$this->wasPrepared) {
$this->wasPrepared = true;
$emitter->testPreparationFailed(
$this->valueObjectForEvents(),
);
}
$this->status = TestStatus::failure($e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
} catch (TimeoutException $e) {
$this->status = TestStatus::risky($e->getMessage());
} catch (Throwable $_e) {
if ($this->isRegisteredFailure($_e)) {
$this->status = TestStatus::failure($_e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($_e),
null,
);
} else {
$e = $this->transformException($_e);
$this->status = TestStatus::error($e->getMessage());
$emitter->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
);
}
}
$outputBufferingStopped = false;
if (!isset($e) &&
$this->hasExpectationOnOutput() &&
$this->stopOutputBuffering()) {
$outputBufferingStopped = true;
$this->performAssertionsOnOutput();
}
if ($this->status->isSuccess()) {
$emitter->testPassed(
$this->valueObjectForEvents(),
);
if (!$this->usesDataProvider()) {
PassedTests::instance()->testMethodPassed(
$this->valueObjectForEvents(),
$this->testResult,
);
}
}
try {
$this->mockObjects = [];
} catch (Throwable $t) {
Event\Facade::emitter()->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($t),
);
}
// Tear down the fixture. An exception raised in tearDown() will be
// caught and passed on when no exception was raised before.
try {
if ($hasMetRequirements) {
$this->invokeAfterTestHookMethods($hookMethods, $emitter);
if ($this->inIsolation) {
$this->invokeAfterClassHookMethods($hookMethods, $emitter);
}
}
} catch (AssertionError|AssertionFailedError $e) {
$this->status = TestStatus::failure($e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
} catch (Throwable $exceptionRaisedDuringTearDown) {
if (!isset($e)) {
$this->status = TestStatus::error($exceptionRaisedDuringTearDown->getMessage());
$e = $exceptionRaisedDuringTearDown;
$emitter->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($exceptionRaisedDuringTearDown),
);
}
}
if (!$outputBufferingStopped) {
$this->stopOutputBuffering();
}
clearstatcache();
if ($currentWorkingDirectory !== getcwd()) {
chdir($currentWorkingDirectory);
}
$this->restoreGlobalState();
$this->unregisterCustomComparators();
$this->cleanupIniSettings();
$this->cleanupLocaleSettings();
libxml_clear_errors();
$this->testValueObjectForEvents = null;
if (isset($e)) {
$this->onNotSuccessfulTest($e);
}
}
/**
* @psalm-param non-empty-string $name
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setName(string $name): void
{
$this->name = $name;
if (is_callable($this->sortId(), true)) {
$this->providedTests = [new ExecutionOrderDependency($this->sortId())];
}
}
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setDependencies(array $dependencies): void
{
$this->dependencies = $dependencies;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setDependencyInput(array $dependencyInput): void
{
$this->dependencyInput = $dependencyInput;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dependencyInput(): array
{
return $this->dependencyInput;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function hasDependencyInput(): bool
{
return !empty($this->dependencyInput);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupGlobals(bool $backupGlobals): void
{
$this->backupGlobals = $backupGlobals;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupGlobalsExcludeList(array $backupGlobalsExcludeList): void
{
$this->backupGlobalsExcludeList = $backupGlobalsExcludeList;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupStaticProperties(bool $backupStaticProperties): void
{
$this->backupStaticProperties = $backupStaticProperties;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupStaticPropertiesExcludeList(array $backupStaticPropertiesExcludeList): void
{
$this->backupStaticPropertiesExcludeList = $backupStaticPropertiesExcludeList;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setRunTestInSeparateProcess(bool $runTestInSeparateProcess): void
{
if ($this->runTestInSeparateProcess === null) {
$this->runTestInSeparateProcess = $runTestInSeparateProcess;
}
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setRunClassInSeparateProcess(bool $runClassInSeparateProcess): void
{
$this->runClassInSeparateProcess = $runClassInSeparateProcess;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setPreserveGlobalState(bool $preserveGlobalState): void
{
$this->preserveGlobalState = $preserveGlobalState;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setInIsolation(bool $inIsolation): void
{
$this->inIsolation = $inIsolation;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function isInIsolation(): bool
{
return $this->inIsolation;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function result(): mixed
{
return $this->testResult;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setResult(mixed $result): void
{
$this->testResult = $result;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function registerMockObject(MockObject $mockObject): void
{
assert($mockObject instanceof MockObjectInternal);
$this->mockObjects[] = $mockObject;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function addToAssertionCount(int $count): void
{
$this->numberOfAssertionsPerformed += $count;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function numberOfAssertionsPerformed(): int
{
return $this->numberOfAssertionsPerformed;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function usesDataProvider(): bool
{
return !empty($this->data);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataName(): int|string
{
return $this->dataName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataSetAsString(): string
{
$buffer = '';
if (!empty($this->data)) {
if (is_int($this->dataName)) {
$buffer .= sprintf(' with data set #%d', $this->dataName);
} else {
$buffer .= sprintf(' with data set "%s"', $this->dataName);
}
}
return $buffer;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataSetAsStringWithData(): string
{
if (empty($this->data)) {
return '';
}
return $this->dataSetAsString() . sprintf(
' (%s)',
(new Exporter)->shortenedRecursiveExport($this->data),
);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function providedData(): array
{
return $this->data;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function sortId(): string
{
$id = $this->name;
if (!str_contains($id, '::')) {
$id = static::class . '::' . $id;
}
if ($this->usesDataProvider()) {
$id .= $this->dataSetAsString();
}
return $id;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function provides(): array
{
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function requires(): array
{
return $this->dependencies;
}
/**
* @throws RuntimeException
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setData(int|string $dataName, array $data): void
{
$this->dataName = $dataName;
$this->data = $data;
if (array_is_list($data)) {
return;
}
try {
$reflector = new ReflectionMethod($this, $this->name);
$parameters = array_map(static fn (ReflectionParameter $parameter) => $parameter->name, $reflector->getParameters());
foreach (array_keys($data) as $parameter) {
if (is_string($parameter) && !in_array($parameter, $parameters, true)) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForEvents(),
sprintf(
'Providing invalid named argument $%s for method %s::%s() is deprecated and will not be supported in PHPUnit 11.0.',
$parameter,
$this::class,
$this->name,
),
);
}
}
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
final public function valueObjectForEvents(): Event\Code\TestMethod
{
if ($this->testValueObjectForEvents !== null) {
return $this->testValueObjectForEvents;
}
$this->testValueObjectForEvents = Event\Code\TestMethodBuilder::fromTestCase($this);
return $this->testValueObjectForEvents;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function wasPrepared(): bool
{
return $this->wasPrepared;
}
final protected function registerComparator(Comparator $comparator): void
{
ComparatorFactory::getInstance()->register($comparator);
Event\Facade::emitter()->testRegisteredComparator($comparator::class);
$this->customComparators[] = $comparator;
}
/**
* @psalm-param class-string $classOrInterface
*/
final protected function registerFailureType(string $classOrInterface): void
{
$this->failureTypes[$classOrInterface] = true;
}
/**
* @throws AssertionFailedError
* @throws Exception
* @throws ExpectationFailedException
* @throws Throwable
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
protected function runTest(): mixed
{
$testArguments = array_merge($this->data, $this->dependencyInput);
$this->registerMockObjectsFromTestArguments($testArguments);
try {
$testResult = $this->{$this->name}(...array_values($testArguments));
} catch (Throwable $exception) {
if (!$this->shouldExceptionExpectationsBeVerified($exception)) {
throw $exception;
}
$this->verifyExceptionExpectations($exception);
return null;
}
$this->expectedExceptionWasNotRaised();
return $testResult;
}
/**
* This method is a wrapper for the ini_set() function that automatically
* resets the modified php.ini setting to its original value after the
* test is run.
*
* @throws Exception
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5214
*/
protected function iniSet(string $varName, string $newValue): void
{
$currentValue = ini_set($varName, $newValue);
if ($currentValue !== false) {
$this->iniSettings[$varName] = $currentValue;
} else {
throw new Exception(
sprintf(
'INI setting "%s" could not be set to "%s".',
$varName,
$newValue,
),
);
}
}
/**
* This method is a wrapper for the setlocale() function that automatically
* resets the locale to its original value after the test is run.
*
* @throws Exception
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5216
*/
protected function setLocale(mixed ...$arguments): void
{
if (count($arguments) < 2) {
throw new Exception;
}
[$category, $locale] = $arguments;
if (!in_array($category, self::LOCALE_CATEGORIES, true)) {
throw new Exception;
}
if (!is_array($locale) && !is_string($locale)) {
throw new Exception;
}
$this->locale[$category] = setlocale($category, '0');
$result = setlocale(...$arguments);
if ($result === false) {
throw new Exception(
'The locale functionality is not implemented on your platform, ' .
'the specified locale does not exist or the category name is ' .
'invalid.',
);
}
}
/**
* Creates a mock object for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected function createMock(string $originalClassName): MockObject
{
$mock = (new MockGenerator)->testDouble(
$originalClassName,
true,
callOriginalConstructor: false,
callOriginalClone: false,
cloneArguments: false,
allowMockingUnknownTypes: false,
);
assert($mock instanceof $originalClassName);
assert($mock instanceof MockObject);
$this->registerMockObject($mock);
Event\Facade::emitter()->testCreatedMockObject($originalClassName);
return $mock;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws MockObjectException
*/
protected function createMockForIntersectionOfInterfaces(array $interfaces): MockObject
{
$mock = (new MockGenerator)->testDoubleForInterfaceIntersection($interfaces, true);
assert($mock instanceof MockObject);
$this->registerMockObject($mock);
Event\Facade::emitter()->testCreatedMockObjectForIntersectionOfInterfaces($interfaces);
return $mock;
}
/**
* Creates (and configures) a mock object for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected function createConfiguredMock(string $originalClassName, array $configuration): MockObject
{
$o = $this->createMock($originalClassName);
foreach ($configuration as $method => $return) {
$o->method($method)->willReturn($return);
}
return $o;
}
/**
* Creates a partial mock object for the specified interface or class.
*
* @psalm-param list<non-empty-string> $methods
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*/
protected function createPartialMock(string $originalClassName, array $methods): MockObject
{
$partialMock = $this->getMockBuilder($originalClassName)
->disableOriginalConstructor()
->disableOriginalClone()
->disableArgumentCloning()
->disallowMockingUnknownTypes()
->onlyMethods($methods)
->getMock();
Event\Facade::emitter()->testCreatedPartialMockObject(
$originalClassName,
...$methods,
);
return $partialMock;
}
/**
* Creates a test proxy for the specified class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5240
*/
protected function createTestProxy(string $originalClassName, array $constructorArguments = []): MockObject
{
$testProxy = $this->getMockBuilder($originalClassName)
->setConstructorArgs($constructorArguments)
->enableProxyingToOriginalMethods()
->getMock();
Event\Facade::emitter()->testCreatedTestProxy(
$originalClassName,
$constructorArguments,
);
return $testProxy;
}
/**
* Creates a mock object for the specified abstract class with all abstract
* methods of the class mocked. Concrete methods are not mocked by default.
* To mock concrete methods, use the 7th parameter ($mockedMethods).
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5241
*/
protected function getMockForAbstractClass(string $originalClassName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
{
$mockObject = (new MockGenerator)->mockObjectForAbstractClass(
$originalClassName,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$mockedMethods,
$cloneArguments,
);
$this->registerMockObject($mockObject);
Event\Facade::emitter()->testCreatedMockObjectForAbstractClass($originalClassName);
assert($mockObject instanceof $originalClassName);
assert($mockObject instanceof MockObject);
return $mockObject;
}
/**
* Creates a mock object based on the given WSDL file.
*
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5242
*/
protected function getMockFromWsdl(string $wsdlFile, string $originalClassName = '', string $mockClassName = '', array $methods = [], bool $callOriginalConstructor = true, array $options = []): MockObject
{
if ($originalClassName === '') {
$fileName = pathinfo(basename(parse_url($wsdlFile, PHP_URL_PATH)), PATHINFO_FILENAME);
$originalClassName = preg_replace('/\W/', '', $fileName);
}
if (!class_exists($originalClassName)) {
eval(
(new MockGenerator)->generateClassFromWsdl(
$wsdlFile,
$originalClassName,
$methods,
$options,
)
);
}
$mockObject = (new MockGenerator)->testDouble(
$originalClassName,
true,
$methods,
['', $options],
$mockClassName,
$callOriginalConstructor,
false,
false,
);
Event\Facade::emitter()->testCreatedMockObjectFromWsdl(
$wsdlFile,
$originalClassName,
$mockClassName,
$methods,
$callOriginalConstructor,
$options,
);
assert($mockObject instanceof MockObject);
$this->registerMockObject($mockObject);
return $mockObject;
}
/**
* Creates a mock object for the specified trait with all abstract methods
* of the trait mocked. Concrete methods to mock can be specified with the
* `$mockedMethods` parameter.
*
* @psalm-param trait-string $traitName
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
protected function getMockForTrait(string $traitName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
{
$mockObject = (new MockGenerator)->mockObjectForTrait(
$traitName,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$mockedMethods,
$cloneArguments,
);
$this->registerMockObject($mockObject);
Event\Facade::emitter()->testCreatedMockObjectForTrait($traitName);
return $mockObject;
}
/**
* Creates an object that uses the specified trait.
*
* @psalm-param trait-string $traitName
*
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5244
*/
protected function getObjectForTrait(string $traitName, array $arguments = [], string $traitClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true): object
{
return (new MockGenerator)->objectForTrait(
$traitName,
$traitClassName,
$callAutoload,
$callOriginalConstructor,
$arguments,
);
}
protected function transformException(Throwable $t): Throwable
{
return $t;
}
/**
* This method is called when a test method did not execute successfully.
*
* @throws Throwable
*/
protected function onNotSuccessfulTest(Throwable $t): never
{
throw $t;
}
/**
* @throws Throwable
*/
private function verifyMockObjects(): void
{
foreach ($this->mockObjects as $mockObject) {
if ($mockObject->__phpunit_hasMatchers()) {
$this->numberOfAssertionsPerformed++;
}
$mockObject->__phpunit_verify(
$this->shouldInvocationMockerBeReset($mockObject),
);
}
}
/**
* @throws SkippedTest
*/
private function checkRequirements(): void
{
if (!$this->name || !method_exists($this, $this->name)) {
return;
}
$missingRequirements = (new Requirements)->requirementsNotSatisfiedFor(
static::class,
$this->name,
);
if (!empty($missingRequirements)) {
$this->markTestSkipped(implode(PHP_EOL, $missingRequirements));
}
}
private function handleDependencies(): bool
{
if ([] === $this->dependencies || $this->inIsolation) {
return true;
}
$passedTests = PassedTests::instance();
foreach ($this->dependencies as $dependency) {
if (!$dependency->isValid()) {
$this->markErrorForInvalidDependency();
return false;
}
if ($dependency->targetIsClass()) {
$dependencyClassName = $dependency->getTargetClassName();
if (!class_exists($dependencyClassName)) {
$this->markErrorForInvalidDependency($dependency);
return false;
}
if (!$passedTests->hasTestClassPassed($dependencyClassName)) {
$this->markSkippedForMissingDependency($dependency);
return false;
}
continue;
}
$dependencyTarget = $dependency->getTarget();
if (!$passedTests->hasTestMethodPassed($dependencyTarget)) {
if (!$this->isCallableTestMethod($dependencyTarget)) {
$this->markErrorForInvalidDependency($dependency);
} else {
$this->markSkippedForMissingDependency($dependency);
}
return false;
}
if ($passedTests->isGreaterThan($dependencyTarget, $this->size())) {
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
'This test depends on a test that is larger than itself',
);
return false;
}
$returnValue = $passedTests->returnValue($dependencyTarget);
if ($dependency->deepClone()) {
$deepCopy = new DeepCopy;
$deepCopy->skipUncloneable(false);
$this->dependencyInput[$dependencyTarget] = $deepCopy->copy($returnValue);
} elseif ($dependency->shallowClone()) {
$this->dependencyInput[$dependencyTarget] = clone $returnValue;
} else {
$this->dependencyInput[$dependencyTarget] = $returnValue;
}
}
$this->testValueObjectForEvents = null;
return true;
}
/**
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function markErrorForInvalidDependency(?ExecutionOrderDependency $dependency = null): void
{
$message = 'This test has an invalid dependency';
if ($dependency !== null) {
$message = sprintf(
'This test depends on "%s" which does not exist',
$dependency->targetIsClass() ? $dependency->getTargetClassName() : $dependency->getTarget(),
);
}
$exception = new InvalidDependencyException($message);
Event\Facade::emitter()->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($exception),
);
$this->status = TestStatus::error($message);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function markSkippedForMissingDependency(ExecutionOrderDependency $dependency): void
{
$message = sprintf(
'This test depends on "%s" to pass',
$dependency->getTarget(),
);
Event\Facade::emitter()->testSkipped(
$this->valueObjectForEvents(),
$message,
);
$this->status = TestStatus::skipped($message);
}
private function startOutputBuffering(): void
{
ob_start();
$this->outputBufferingActive = true;
$this->outputBufferingLevel = ob_get_level();
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function stopOutputBuffering(): bool
{
$bufferingLevel = ob_get_level();
if ($bufferingLevel !== $this->outputBufferingLevel) {
if ($bufferingLevel > $this->outputBufferingLevel) {
$message = 'Test code or tested code did not close its own output buffers';
} else {
$message = 'Test code or tested code closed output buffers other than its own';
}
while (ob_get_level() >= $this->outputBufferingLevel) {
ob_end_clean();
}
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
$message,
);
$this->status = TestStatus::risky($message);
return false;
}
$this->output = ob_get_clean();
$this->outputBufferingActive = false;
$this->outputBufferingLevel = ob_get_level();
return true;
}
private function snapshotGlobalState(): void
{
if ($this->runTestInSeparateProcess || $this->inIsolation ||
(!$this->backupGlobals && !$this->backupStaticProperties)) {
return;
}
$snapshot = $this->createGlobalStateSnapshot($this->backupGlobals === true);
$this->snapshot = $snapshot;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function restoreGlobalState(): void
{
if (!$this->snapshot instanceof Snapshot) {
return;
}
if (ConfigurationRegistry::get()->beStrictAboutChangesToGlobalState()) {
$this->compareGlobalStateSnapshots(
$this->snapshot,
$this->createGlobalStateSnapshot($this->backupGlobals === true),
);
}
$restorer = new Restorer;
if ($this->backupGlobals) {
$restorer->restoreGlobalVariables($this->snapshot);
}
if ($this->backupStaticProperties) {
$restorer->restoreStaticProperties($this->snapshot);
}
$this->snapshot = null;
}
private function createGlobalStateSnapshot(bool $backupGlobals): Snapshot
{
$excludeList = new GlobalStateExcludeList;
foreach ($this->backupGlobalsExcludeList as $globalVariable) {
$excludeList->addGlobalVariable($globalVariable);
}
if (!defined('PHPUNIT_TESTSUITE')) {
$excludeList->addClassNamePrefix('PHPUnit');
$excludeList->addClassNamePrefix('SebastianBergmann\CodeCoverage');
$excludeList->addClassNamePrefix('SebastianBergmann\FileIterator');
$excludeList->addClassNamePrefix('SebastianBergmann\Invoker');
$excludeList->addClassNamePrefix('SebastianBergmann\Template');
$excludeList->addClassNamePrefix('SebastianBergmann\Timer');
$excludeList->addStaticProperty(ComparatorFactory::class, 'instance');
foreach ($this->backupStaticPropertiesExcludeList as $class => $properties) {
foreach ($properties as $property) {
$excludeList->addStaticProperty($class, $property);
}
}
}
return new Snapshot(
$excludeList,
$backupGlobals,
(bool) $this->backupStaticProperties,
false,
false,
false,
false,
false,
false,
false,
);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function compareGlobalStateSnapshots(Snapshot $before, Snapshot $after): void
{
$backupGlobals = $this->backupGlobals === null || $this->backupGlobals;
if ($backupGlobals) {
$this->compareGlobalStateSnapshotPart(
$before->globalVariables(),
$after->globalVariables(),
"--- Global variables before the test\n+++ Global variables after the test\n",
);
$this->compareGlobalStateSnapshotPart(
$before->superGlobalVariables(),
$after->superGlobalVariables(),
"--- Super-global variables before the test\n+++ Super-global variables after the test\n",
);
}
if ($this->backupStaticProperties) {
$this->compareGlobalStateSnapshotPart(
$before->staticProperties(),
$after->staticProperties(),
"--- Static properties before the test\n+++ Static properties after the test\n",
);
}
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function compareGlobalStateSnapshotPart(array $before, array $after, string $header): void
{
if ($before != $after) {
$differ = new Differ(new UnifiedDiffOutputBuilder($header));
$exporter = new Exporter;
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
'This test modified global state but was not expected to do so' . PHP_EOL .
trim(
$differ->diff(
$exporter->export($before),
$exporter->export($after),
),
),
);
}
}
private function shouldInvocationMockerBeReset(MockObject $mock): bool
{
$enumerator = new Enumerator;
if (in_array($mock, $enumerator->enumerate($this->dependencyInput), true)) {
return false;
}
if (!is_array($this->testResult) && !is_object($this->testResult)) {
return true;
}
return !in_array($mock, $enumerator->enumerate($this->testResult), true);
}
/**
* @deprecated
*/
private function registerMockObjectsFromTestArguments(array $testArguments, Context $context = new Context): void
{
if ($this->registerMockObjectsFromTestArgumentsRecursively) {
foreach ((new Enumerator)->enumerate($testArguments) as $object) {
if ($object instanceof MockObject) {
$this->registerMockObject($object);
}
}
} else {
foreach ($testArguments as &$testArgument) {
if ($testArgument instanceof MockObject) {
$testArgument = Cloner::clone($testArgument);
$this->registerMockObject($testArgument);
} elseif (is_array($testArgument) && !$context->contains($testArgument)) {
$testArgumentCopy = $testArgument;
$context->add($testArgument);
$this->registerMockObjectsFromTestArguments(
$testArgumentCopy,
$context,
);
}
}
}
}
private function unregisterCustomComparators(): void
{
$factory = ComparatorFactory::getInstance();
foreach ($this->customComparators as $comparator) {
$factory->unregister($comparator);
}
$this->customComparators = [];
}
private function cleanupIniSettings(): void
{
foreach ($this->iniSettings as $varName => $oldValue) {
ini_set($varName, $oldValue);
}
$this->iniSettings = [];
}
private function cleanupLocaleSettings(): void
{
foreach ($this->locale as $category => $locale) {
setlocale($category, $locale);
}
$this->locale = [];
}
/**
* @throws Exception
*/
private function shouldExceptionExpectationsBeVerified(Throwable $throwable): bool
{
$result = false;
if ($this->expectedException !== null || $this->expectedExceptionCode !== null || $this->expectedExceptionMessage !== null || $this->expectedExceptionMessageRegExp !== null) {
$result = true;
}
if ($throwable instanceof Exception) {
$result = false;
}
if (is_string($this->expectedException)) {
try {
$reflector = new ReflectionClass($this->expectedException);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
if ($this->expectedException === 'PHPUnit\Framework\Exception' ||
$this->expectedException === '\PHPUnit\Framework\Exception' ||
$reflector->isSubclassOf(Exception::class)) {
$result = true;
}
}
return $result;
}
private function shouldRunInSeparateProcess(): bool
{
if ($this->inIsolation) {
return false;
}
if ($this->runTestInSeparateProcess) {
return true;
}
if ($this->runClassInSeparateProcess) {
return true;
}
return ConfigurationRegistry::get()->processIsolation();
}
private function isCallableTestMethod(string $dependency): bool
{
[$className, $methodName] = explode('::', $dependency);
if (!class_exists($className)) {
return false;
}
$class = new ReflectionClass($className);
if (!$class->isSubclassOf(__CLASS__)) {
return false;
}
if (!$class->hasMethod($methodName)) {
return false;
}
return TestUtil::isTestMethod(
$class->getMethod($methodName),
);
}
/**
* @throws Exception
* @throws ExpectationFailedException
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function performAssertionsOnOutput(): void
{
try {
if ($this->outputExpectedRegex !== null) {
$this->assertMatchesRegularExpression($this->outputExpectedRegex, $this->output);
} elseif ($this->outputExpectedString !== null) {
$this->assertSame($this->outputExpectedString, $this->output);
}
} catch (ExpectationFailedException $e) {
$this->status = TestStatus::failure($e->getMessage());
Event\Facade::emitter()->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
throw $e;
}
}
/**
* @throws Throwable
*/
private function invokeBeforeClassHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['beforeClass'],
$emitter,
'testBeforeFirstTestMethodCalled',
'testBeforeFirstTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokeBeforeTestHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['before'],
$emitter,
'testBeforeTestMethodCalled',
'testBeforeTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokePreConditionHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['preCondition'],
$emitter,
'testPreConditionCalled',
'testPreConditionFinished',
);
}
/**
* @throws Throwable
*/
private function invokePostConditionHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['postCondition'],
$emitter,
'testPostConditionCalled',
'testPostConditionFinished',
);
}
/**
* @throws Throwable
*/
private function invokeAfterTestHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['after'],
$emitter,
'testAfterTestMethodCalled',
'testAfterTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokeAfterClassHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['afterClass'],
$emitter,
'testAfterLastTestMethodCalled',
'testAfterLastTestMethodFinished',
);
}
/**
* @psalm-param list<non-empty-string> $hookMethods
* @psalm-param 'testBeforeFirstTestMethodCalled'|'testBeforeTestMethodCalled'|'testPreConditionCalled'|'testPostConditionCalled'|'testAfterTestMethodCalled'|'testAfterLastTestMethodCalled' $calledMethod
* @psalm-param 'testBeforeFirstTestMethodFinished'|'testBeforeTestMethodFinished'|'testPreConditionFinished'|'testPostConditionFinished'|'testAfterTestMethodFinished'|'testAfterLastTestMethodFinished' $finishedMethod
*
* @throws Throwable
*/
private function invokeHookMethods(array $hookMethods, Event\Emitter $emitter, string $calledMethod, string $finishedMethod): void
{
$methodsInvoked = [];
foreach ($hookMethods as $methodName) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($methodName)) {
continue;
}
try {
$this->{$methodName}();
} catch (Throwable $t) {
}
$methodInvoked = new Event\Code\ClassMethod(
static::class,
$methodName,
);
$emitter->{$calledMethod}(
static::class,
$methodInvoked
);
$methodsInvoked[] = $methodInvoked;
if (isset($t)) {
break;
}
}
if (!empty($methodsInvoked)) {
$emitter->{$finishedMethod}(
static::class,
...$methodsInvoked
);
}
if (isset($t)) {
throw $t;
}
}
private function methodDoesNotExistOrIsDeclaredInTestCase(string $methodName): bool
{
$reflector = new ReflectionObject($this);
return !$reflector->hasMethod($methodName) ||
$reflector->getMethod($methodName)->getDeclaringClass()->getName() === self::class;
}
/**
* @throws ExpectationFailedException
*/
private function verifyExceptionExpectations(\Exception|Throwable $exception): void
{
if ($this->expectedException !== null) {
$this->assertThat(
$exception,
new ExceptionConstraint(
$this->expectedException,
),
);
}
if ($this->expectedExceptionMessage !== null) {
$this->assertThat(
$exception->getMessage(),
new ExceptionMessageIsOrContains(
$this->expectedExceptionMessage,
),
);
}
if ($this->expectedExceptionMessageRegExp !== null) {
$this->assertThat(
$exception->getMessage(),
new ExceptionMessageMatchesRegularExpression(
$this->expectedExceptionMessageRegExp,
),
);
}
if ($this->expectedExceptionCode !== null) {
$this->assertThat(
$exception->getCode(),
new ExceptionCode(
$this->expectedExceptionCode,
),
);
}
}
/**
* @throws AssertionFailedError
*/
private function expectedExceptionWasNotRaised(): void
{
if ($this->expectedException !== null) {
$this->assertThat(
null,
new ExceptionConstraint($this->expectedException),
);
} elseif ($this->expectedExceptionMessage !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with message "%s" is thrown',
$this->expectedExceptionMessage,
),
);
} elseif ($this->expectedExceptionMessageRegExp !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with message matching "%s" is thrown',
$this->expectedExceptionMessageRegExp,
),
);
} elseif ($this->expectedExceptionCode !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with code "%s" is thrown',
$this->expectedExceptionCode,
),
);
}
}
private function isRegisteredFailure(Throwable $t): bool
{
foreach (array_keys($this->failureTypes) as $failureType) {
if ($t instanceof $failureType) {
return true;
}
}
return false;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
private function hasExpectationOnOutput(): bool
{
return is_string($this->outputExpectedString) || is_string($this->outputExpectedRegex);
}
/**
* Creates a test stub for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return Stub&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected static function createStub(string $originalClassName): Stub
{
$stub = (new MockGenerator)->testDouble(
$originalClassName,
true,
callOriginalConstructor: false,
callOriginalClone: false,
cloneArguments: false,
allowMockingUnknownTypes: false,
);
Event\Facade::emitter()->testCreatedStub($originalClassName);
assert($stub instanceof $originalClassName);
assert($stub instanceof Stub);
return $stub;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws MockObjectException
*/
protected static function createStubForIntersectionOfInterfaces(array $interfaces): Stub
{
$stub = (new MockGenerator)->testDoubleForInterfaceIntersection($interfaces, true);
Event\Facade::emitter()->testCreatedStubForIntersectionOfInterfaces($interfaces);
return $stub;
}
/**
* Creates (and configures) a test stub for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return Stub&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
final protected static function createConfiguredStub(string $originalClassName, array $configuration): Stub
{
$o = self::createStub($originalClassName);
foreach ($configuration as $method => $return) {
$o->method($method)->willReturn($return);
}
return $o;
}
}
phpunit/src/Framework/TestSuite.php 0000644 00000044557 15243417753 0013453 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const PHP_EOL;
use function array_keys;
use function array_map;
use function assert;
use function call_user_func;
use function class_exists;
use function count;
use function implode;
use function is_callable;
use function is_file;
use function is_subclass_of;
use function sprintf;
use function str_ends_with;
use function str_starts_with;
use function trim;
use Iterator;
use IteratorAggregate;
use PHPUnit\Event;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Metadata\Api\Dependencies;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\Api\HookMethods;
use PHPUnit\Metadata\Api\Requirements;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Runner\Exception as RunnerException;
use PHPUnit\Runner\Filter\Factory;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\Runner\TestSuiteLoader;
use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
use PHPUnit\Util\Filter;
use PHPUnit\Util\Reflection;
use PHPUnit\Util\Test as TestUtil;
use ReflectionClass;
use ReflectionMethod;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use Throwable;
/**
* @template-implements IteratorAggregate<int, Test>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class TestSuite implements IteratorAggregate, Reorderable, SelfDescribing, Test
{
/**
* @psalm-var non-empty-string
*/
private string $name;
/**
* @psalm-var array<string,list<Test>>
*/
private array $groups = [];
/**
* @psalm-var ?list<ExecutionOrderDependency>
*/
private ?array $requiredTests = null;
/**
* @psalm-var list<Test>
*/
private array $tests = [];
/**
* @psalm-var ?list<ExecutionOrderDependency>
*/
private ?array $providedTests = null;
private ?Factory $iteratorFilter = null;
/**
* @psalm-param non-empty-string $name
*/
public static function empty(string $name): static
{
return new static($name);
}
/**
* @psalm-param class-string $className
*/
public static function fromClassName(string $className): static
{
assert(class_exists($className));
$class = new ReflectionClass($className);
return static::fromClassReflector($class);
}
public static function fromClassReflector(ReflectionClass $class): static
{
$testSuite = new static($class->getName());
$constructor = $class->getConstructor();
if ($constructor !== null && !$constructor->isPublic()) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Class "%s" has no public constructor.',
$class->getName(),
),
);
return $testSuite;
}
foreach (Reflection::publicMethodsInTestClass($class) as $method) {
if ($method->getDeclaringClass()->getName() === Assert::class) {
continue;
}
if ($method->getDeclaringClass()->getName() === TestCase::class) {
continue;
}
if (!TestUtil::isTestMethod($method)) {
continue;
}
$testSuite->addTestMethod($class, $method);
}
if (count($testSuite) === 0) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'No tests found in class "%s".',
$class->getName(),
),
);
}
return $testSuite;
}
/**
* @psalm-param non-empty-string $name
*/
final private function __construct(string $name)
{
$this->name = $name;
}
/**
* Returns a string representation of the test suite.
*/
public function toString(): string
{
return $this->name();
}
/**
* Adds a test to the suite.
*/
public function addTest(Test $test, array $groups = []): void
{
$class = new ReflectionClass($test);
if (!$class->isAbstract()) {
$this->tests[] = $test;
$this->clearCaches();
if ($test instanceof self && empty($groups)) {
$groups = $test->groups();
}
if ($this->containsOnlyVirtualGroups($groups)) {
$groups[] = 'default';
}
foreach ($groups as $group) {
if (!isset($this->groups[$group])) {
$this->groups[$group] = [$test];
} else {
$this->groups[$group][] = $test;
}
}
if ($test instanceof TestCase) {
$test->setGroups($groups);
}
}
}
/**
* Adds the tests from the given class to the suite.
*
* @throws Exception
*/
public function addTestSuite(ReflectionClass $testClass): void
{
if ($testClass->isAbstract()) {
throw new Exception(
sprintf(
'Class %s is abstract',
$testClass->getName(),
),
);
}
if (!$testClass->isSubclassOf(TestCase::class)) {
throw new Exception(
sprintf(
'Class %s is not a subclass of %s',
$testClass->getName(),
TestCase::class,
),
);
}
$this->addTest(self::fromClassReflector($testClass));
}
/**
* Wraps both <code>addTest()</code> and <code>addTestSuite</code>
* as well as the separate import statements for the user's convenience.
*
* If the named file cannot be read or there are no new tests that can be
* added, a <code>PHPUnit\Framework\WarningTestCase</code> will be created instead,
* leaving the current test run untouched.
*
* @throws Exception
*/
public function addTestFile(string $filename): void
{
if (str_ends_with($filename, '.phpt') && is_file($filename)) {
try {
$this->addTest(new PhptTestCase($filename));
} catch (RunnerException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
return;
}
try {
$this->addTestSuite(
(new TestSuiteLoader)->load($filename),
);
} catch (RunnerException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
}
/**
* Wrapper for addTestFile() that adds multiple test files.
*
* @throws Exception
*/
public function addTestFiles(iterable $fileNames): void
{
foreach ($fileNames as $filename) {
$this->addTestFile((string) $filename);
}
}
/**
* Counts the number of test cases that will be run by this test.
*/
public function count(): int
{
$numTests = 0;
foreach ($this as $test) {
$numTests += count($test);
}
return $numTests;
}
public function isEmpty(): bool
{
return empty($this->tests);
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
/**
* Returns the test groups of the suite.
*
* @psalm-return list<string>
*/
public function groups(): array
{
return array_map(
'strval',
array_keys($this->groups),
);
}
public function groupDetails(): array
{
return $this->groups;
}
/**
* @throws CodeCoverageException
* @throws Event\RuntimeException
* @throws Exception
* @throws InvalidArgumentException
* @throws NoPreviousThrowableException
* @throws UnintentionallyCoveredCodeException
*/
public function run(): void
{
if (count($this) === 0) {
return;
}
$emitter = Event\Facade::emitter();
$testSuiteValueObjectForEvents = Event\TestSuite\TestSuiteBuilder::from($this);
$emitter->testSuiteStarted($testSuiteValueObjectForEvents);
if (!$this->invokeMethodsBeforeFirstTest($emitter, $testSuiteValueObjectForEvents)) {
return;
}
foreach ($this as $test) {
if (TestResultFacade::shouldStop()) {
$emitter->testRunnerExecutionAborted();
break;
}
$test->run();
}
$this->invokeMethodsAfterLastTest($emitter);
$emitter->testSuiteFinished($testSuiteValueObjectForEvents);
}
/**
* Returns the tests as an enumeration.
*
* @psalm-return list<Test>
*/
public function tests(): array
{
return $this->tests;
}
/**
* Set tests of the test suite.
*
* @psalm-param list<Test> $tests
*/
public function setTests(array $tests): void
{
$this->tests = $tests;
}
/**
* Mark the test suite as skipped.
*
* @throws SkippedTestSuiteError
*/
public function markTestSuiteSkipped(string $message = ''): never
{
throw new SkippedTestSuiteError($message);
}
/**
* Returns an iterator for this test suite.
*/
public function getIterator(): Iterator
{
$iterator = new TestSuiteIterator($this);
if ($this->iteratorFilter !== null) {
$iterator = $this->iteratorFilter->factory($iterator, $this);
}
return $iterator;
}
public function injectFilter(Factory $filter): void
{
$this->iteratorFilter = $filter;
foreach ($this as $test) {
if ($test instanceof self) {
$test->injectFilter($filter);
}
}
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
if ($this->providedTests === null) {
$this->providedTests = [];
if (is_callable($this->sortId(), true)) {
$this->providedTests[] = new ExecutionOrderDependency($this->sortId());
}
foreach ($this->tests as $test) {
if (!($test instanceof Reorderable)) {
continue;
}
$this->providedTests = ExecutionOrderDependency::mergeUnique($this->providedTests, $test->provides());
}
}
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
if ($this->requiredTests === null) {
$this->requiredTests = [];
foreach ($this->tests as $test) {
if (!($test instanceof Reorderable)) {
continue;
}
$this->requiredTests = ExecutionOrderDependency::mergeUnique(
ExecutionOrderDependency::filterInvalid($this->requiredTests),
$test->requires(),
);
}
$this->requiredTests = ExecutionOrderDependency::diff($this->requiredTests, $this->provides());
}
return $this->requiredTests;
}
public function sortId(): string
{
return $this->name() . '::class';
}
/**
* @psalm-assert-if-true class-string $this->name
*/
public function isForTestClass(): bool
{
return class_exists($this->name, false) && is_subclass_of($this->name, TestCase::class);
}
/**
* @throws Event\TestData\MoreThanOneDataSetFromDataProviderException
* @throws Exception
*/
protected function addTestMethod(ReflectionClass $class, ReflectionMethod $method): void
{
$className = $class->getName();
$methodName = $method->getName();
assert(!empty($methodName));
try {
$test = (new TestBuilder)->build($class, $methodName);
} catch (InvalidDataProviderException $e) {
Event\Facade::emitter()->testTriggeredPhpunitError(
new TestMethod(
$className,
$methodName,
$class->getFileName(),
$method->getStartLine(),
Event\Code\TestDoxBuilder::fromClassNameAndMethodName(
$className,
$methodName,
),
MetadataCollection::fromArray([]),
Event\TestData\TestDataCollection::fromArray([]),
),
sprintf(
"The data provider specified for %s::%s is invalid\n%s",
$className,
$methodName,
$this->throwableToString($e),
),
);
return;
}
if ($test instanceof TestCase || $test instanceof DataProviderTestSuite) {
$test->setDependencies(
Dependencies::dependencies($class->getName(), $methodName),
);
}
$this->addTest(
$test,
(new Groups)->groups($class->getName(), $methodName),
);
}
private function clearCaches(): void
{
$this->providedTests = null;
$this->requiredTests = null;
}
private function containsOnlyVirtualGroups(array $groups): bool
{
foreach ($groups as $group) {
if (!str_starts_with($group, '__phpunit_')) {
return false;
}
}
return true;
}
private function methodDoesNotExistOrIsDeclaredInTestCase(string $methodName): bool
{
$reflector = new ReflectionClass($this->name);
return !$reflector->hasMethod($methodName) ||
$reflector->getMethod($methodName)->getDeclaringClass()->getName() === TestCase::class;
}
/**
* @throws Exception
*/
private function throwableToString(Throwable $t): string
{
$message = $t->getMessage();
if (empty(trim($message))) {
$message = '<no message>';
}
if ($t instanceof InvalidDataProviderException) {
return sprintf(
"%s\n%s",
$message,
Filter::getFilteredStacktrace($t),
);
}
return sprintf(
"%s: %s\n%s",
$t::class,
$message,
Filter::getFilteredStacktrace($t),
);
}
/**
* @throws Exception
* @throws NoPreviousThrowableException
*/
private function invokeMethodsBeforeFirstTest(Event\Emitter $emitter, Event\TestSuite\TestSuite $testSuiteValueObjectForEvents): bool
{
if (!$this->isForTestClass()) {
return true;
}
$methodsCalledBeforeFirstTest = [];
$beforeClassMethods = (new HookMethods)->hookMethods($this->name)['beforeClass'];
try {
foreach ($beforeClassMethods as $beforeClassMethod) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($beforeClassMethod)) {
continue;
}
if ($missingRequirements = (new Requirements)->requirementsNotSatisfiedFor($this->name, $beforeClassMethod)) {
$this->markTestSuiteSkipped(implode(PHP_EOL, $missingRequirements));
}
$methodCalledBeforeFirstTest = new Event\Code\ClassMethod(
$this->name,
$beforeClassMethod,
);
$emitter->testBeforeFirstTestMethodCalled(
$this->name,
$methodCalledBeforeFirstTest,
);
$methodsCalledBeforeFirstTest[] = $methodCalledBeforeFirstTest;
call_user_func([$this->name, $beforeClassMethod]);
}
} catch (SkippedTest|SkippedTestSuiteError $e) {
$emitter->testSuiteSkipped(
$testSuiteValueObjectForEvents,
$e->getMessage(),
);
return false;
} catch (Throwable $t) {
assert(isset($methodCalledBeforeFirstTest));
$emitter->testBeforeFirstTestMethodErrored(
$this->name,
$methodCalledBeforeFirstTest,
Event\Code\ThrowableBuilder::from($t),
);
if (!empty($methodsCalledBeforeFirstTest)) {
$emitter->testBeforeFirstTestMethodFinished(
$this->name,
...$methodsCalledBeforeFirstTest,
);
}
return false;
}
if (!empty($methodsCalledBeforeFirstTest)) {
$emitter->testBeforeFirstTestMethodFinished(
$this->name,
...$methodsCalledBeforeFirstTest,
);
}
return true;
}
private function invokeMethodsAfterLastTest(Event\Emitter $emitter): void
{
if (!$this->isForTestClass()) {
return;
}
$methodsCalledAfterLastTest = [];
$afterClassMethods = (new HookMethods)->hookMethods($this->name)['afterClass'];
foreach ($afterClassMethods as $afterClassMethod) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($afterClassMethod)) {
continue;
}
try {
call_user_func([$this->name, $afterClassMethod]);
$methodCalledAfterLastTest = new Event\Code\ClassMethod(
$this->name,
$afterClassMethod,
);
$emitter->testAfterLastTestMethodCalled(
$this->name,
$methodCalledAfterLastTest,
);
$methodsCalledAfterLastTest[] = $methodCalledAfterLastTest;
} catch (Throwable) {
// @todo
}
}
if (!empty($methodsCalledAfterLastTest)) {
$emitter->testAfterLastTestMethodFinished(
$this->name,
...$methodsCalledAfterLastTest,
);
}
}
}
phpunit/src/Framework/Constraint/Operator/LogicalXor.php 0000644 00000003217 15243417753 0017470 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_reduce;
use function array_shift;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalXor extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'xor';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php.
*/
public function precedence(): int
{
return 23;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws ExpectationFailedException
*/
public function matches(mixed $other): bool
{
$constraints = $this->constraints();
$initial = array_shift($constraints);
if ($initial === null) {
return false;
}
return array_reduce(
$constraints,
static fn (bool $matches, Constraint $constraint): bool => $matches xor $constraint->evaluate($other, '', true),
$initial->evaluate($other, '', true),
);
}
}
phpunit/src/Framework/Constraint/Operator/BinaryOperator.php 0000644 00000006334 15243417753 0020370 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_map;
use function count;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class BinaryOperator extends Operator
{
/**
* @psalm-var list<Constraint>
*/
private readonly array $constraints;
protected function __construct(mixed ...$constraints)
{
$this->constraints = array_map(
fn ($constraint): Constraint => $this->checkConstraint($constraint),
$constraints,
);
}
/**
* Returns the number of operands (constraints).
*/
final public function arity(): int
{
return count($this->constraints);
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->toString();
}
$text = '';
foreach ($this->constraints as $key => $constraint) {
$constraint = $constraint->reduce();
$text .= $this->constraintToString($constraint, $key);
}
return $text;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
$count = 0;
foreach ($this->constraints as $constraint) {
$count += count($constraint);
}
return $count;
}
/**
* @psalm-return list<Constraint>
*/
final protected function constraints(): array
{
return $this->constraints;
}
/**
* Returns true if the $constraint needs to be wrapped with braces.
*/
final protected function constraintNeedsParentheses(Constraint $constraint): bool
{
return $this->arity() > 1 && parent::constraintNeedsParentheses($constraint);
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* See Constraint::reduce() for more.
*/
protected function reduce(): Constraint
{
if ($this->arity() === 1 && $this->constraints[0] instanceof Operator) {
return $this->constraints[0]->reduce();
}
return parent::reduce();
}
/**
* Returns string representation of given operand in context of this operator.
*/
private function constraintToString(Constraint $constraint, int $position): string
{
$prefix = '';
if ($position > 0) {
$prefix = (' ' . $this->operator() . ' ');
}
if ($this->constraintNeedsParentheses($constraint)) {
return $prefix . '( ' . $constraint->toString() . ' )';
}
$string = $constraint->toStringInContext($this, $position);
if ($string === '') {
$string = $constraint->toString();
}
return $prefix . $string;
}
}
phpunit/src/Framework/Constraint/Operator/LogicalNot.php 0000644 00000007000 15243417753 0017452 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_map;
use function count;
use function preg_match;
use function preg_quote;
use function preg_replace;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalNot extends UnaryOperator
{
public static function negate(string $string): string
{
$positives = [
'contains ',
'exists',
'has ',
'is ',
'are ',
'matches ',
'starts with ',
'ends with ',
'reference ',
'not not ',
];
$negatives = [
'does not contain ',
'does not exist',
'does not have ',
'is not ',
'are not ',
'does not match ',
'starts not with ',
'ends not with ',
'don\'t reference ',
'not ',
];
preg_match('/(\'[\w\W]*\')([\w\W]*)("[\w\W]*")/i', $string, $matches);
if (count($matches) === 0) {
preg_match('/(\'[\w\W]*\')([\w\W]*)(\'[\w\W]*\')/i', $string, $matches);
}
$positives = array_map(
static fn (string $s) => '/\\b' . preg_quote($s, '/') . '/',
$positives,
);
if (count($matches) > 0) {
$nonInput = $matches[2];
$negatedString = preg_replace(
'/' . preg_quote($nonInput, '/') . '/',
preg_replace(
$positives,
$negatives,
$nonInput,
),
$string,
);
} else {
$negatedString = preg_replace(
$positives,
$negatives,
$string,
);
}
return $negatedString;
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'not';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 5;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws ExpectationFailedException
*/
protected function matches(mixed $other): bool
{
return !$this->constraint()->evaluate($other, '', true);
}
/**
* Applies additional transformation to strings returned by toString() or
* failureDescription().
*/
protected function transformString(string $string): string
{
return self::negate($string);
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* See Constraint::reduce() for more.
*/
protected function reduce(): Constraint
{
$constraint = $this->constraint();
if ($constraint instanceof self) {
return $constraint->constraint()->reduce();
}
return parent::reduce();
}
}
phpunit/src/Framework/Constraint/Operator/UnaryOperator.php 0000644 00000006653 15243417753 0020246 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class UnaryOperator extends Operator
{
private readonly Constraint $constraint;
public function __construct(mixed $constraint)
{
$this->constraint = $this->checkConstraint($constraint);
}
/**
* Returns the number of operands (constraints).
*/
public function arity(): int
{
return 1;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->toString();
}
$constraint = $this->constraint->reduce();
if ($this->constraintNeedsParentheses($constraint)) {
return $this->operator() . '( ' . $constraint->toString() . ' )';
}
$string = $constraint->toStringInContext($this, 0);
if ($string === '') {
return $this->transformString($constraint->toString());
}
return $string;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return count($this->constraint);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->failureDescription($other);
}
$constraint = $this->constraint->reduce();
if ($this->constraintNeedsParentheses($constraint)) {
return $this->operator() . '( ' . $constraint->failureDescription($other) . ' )';
}
$string = $constraint->failureDescriptionInContext($this, 0, $other);
if ($string === '') {
return $this->transformString($constraint->failureDescription($other));
}
return $string;
}
/**
* Transforms string returned by the memeber constraint's toString() or
* failureDescription() such that it reflects constraint's participation in
* this expression.
*
* The method may be overwritten in a subclass to apply default
* transformation in case the operand constraint does not provide its own
* custom strings via toStringInContext() or failureDescriptionInContext().
*/
protected function transformString(string $string): string
{
return $string;
}
/**
* Provides access to $this->constraint for subclasses.
*/
final protected function constraint(): Constraint
{
return $this->constraint;
}
/**
* Returns true if the $constraint needs to be wrapped with parentheses.
*/
protected function constraintNeedsParentheses(Constraint $constraint): bool
{
$constraint = $constraint->reduce();
return $constraint instanceof self || parent::constraintNeedsParentheses($constraint);
}
}
phpunit/src/Framework/Constraint/Operator/LogicalAnd.php 0000644 00000002473 15243417753 0017425 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalAnd extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'and';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 22;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
foreach ($this->constraints() as $constraint) {
if (!$constraint->evaluate($other, '', true)) {
return false;
}
}
return [] !== $this->constraints();
}
}
phpunit/src/Framework/Constraint/Operator/Operator.php 0000644 00000002662 15243417753 0017223 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Operator extends Constraint
{
/**
* Returns the name of this operator.
*/
abstract public function operator(): string;
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
abstract public function precedence(): int;
/**
* Returns the number of operands.
*/
abstract public function arity(): int;
/**
* Validates $constraint argument.
*/
protected function checkConstraint(mixed $constraint): Constraint
{
if (!$constraint instanceof Constraint) {
return new IsEqual($constraint);
}
return $constraint;
}
/**
* Returns true if the $constraint needs to be wrapped with braces.
*/
protected function constraintNeedsParentheses(Constraint $constraint): bool
{
return $constraint instanceof self &&
$constraint->arity() > 1 &&
$this->precedence() <= $constraint->precedence();
}
}
phpunit/src/Framework/Constraint/Operator/LogicalOr.php 0000644 00000002436 15243417753 0017302 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalOr extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'or';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 24;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
public function matches(mixed $other): bool
{
foreach ($this->constraints() as $constraint) {
if ($constraint->evaluate($other, '', true)) {
return true;
}
}
return false;
}
}
phpunit/src/Framework/Constraint/Traversable/TraversableContainsOnly.php 0000644 00000003752 15243417753 0022723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsOnly extends Constraint
{
private Constraint $constraint;
private readonly string $type;
/**
* @throws Exception
*/
public function __construct(string $type, bool $isNativeType = true)
{
if ($isNativeType) {
$this->constraint = new IsType($type);
} else {
$this->constraint = new IsInstanceOf($type);
}
$this->type = $type;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): bool
{
$success = true;
foreach ($other as $item) {
if (!$this->constraint->evaluate($item, '', true)) {
$success = false;
break;
}
}
if (!$success && !$returnResult) {
$this->fail($other, $description);
}
return $success;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'contains only values of type "' . $this->type . '"';
}
}
phpunit/src/Framework/Constraint/Traversable/TraversableContainsIdentical.php 0000644 00000001717 15243417753 0023675 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use SplObjectStorage;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsIdentical extends TraversableContains
{
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof SplObjectStorage) {
return $other->contains($this->value());
}
foreach ($other as $element) {
if ($this->value() === $element) {
return true;
}
}
return false;
}
}
phpunit/src/Framework/Constraint/Traversable/IsList.php 0000644 00000002471 15243417753 0017314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_is_list;
use function is_array;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsList extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is a list';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (!is_array($other)) {
return false;
}
return array_is_list($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return $this->valueToTypeStringFragment($other) . $this->toString(true);
}
}
phpunit/src/Framework/Constraint/Traversable/ArrayHasKey.php 0000644 00000003155 15243417753 0020270 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_key_exists;
use function is_array;
use ArrayAccess;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ArrayHasKey extends Constraint
{
private readonly int|string $key;
public function __construct(int|string $key)
{
$this->key = $key;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'has the key ' . Exporter::export($this->key);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (is_array($other)) {
return array_key_exists($this->key, $other);
}
if ($other instanceof ArrayAccess) {
return $other->offsetExists($this->key);
}
return false;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return 'an array ' . $this->toString(true);
}
}
phpunit/src/Framework/Constraint/Traversable/TraversableContains.php 0000644 00000002616 15243417753 0022057 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_array;
use function sprintf;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TraversableContains extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'contains ' . Exporter::export($this->value, $exportObjects);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'%s %s',
is_array($other) ? 'an array' : 'a traversable',
$this->toString(true),
);
}
protected function value(): mixed
{
return $this->value;
}
}
phpunit/src/Framework/Constraint/Traversable/TraversableContainsEqual.php 0000644 00000002011 15243417753 0023034 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use SplObjectStorage;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsEqual extends TraversableContains
{
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof SplObjectStorage) {
return $other->contains($this->value());
}
foreach ($other as $element) {
/* @noinspection TypeUnsafeComparisonInspection */
if ($this->value() == $element) {
return true;
}
}
return false;
}
}
phpunit/src/Framework/Constraint/Constraint.php 0000644 00000020270 15243417753 0015754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function sprintf;
use function strtolower;
use Countable;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Constraint implements Countable, SelfDescribing
{
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
$success = false;
if ($this->matches($other)) {
$success = true;
}
if ($returnResult) {
return $success;
}
if (!$success) {
$this->fail($other, $description);
}
return null;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return 1;
}
/**
* @deprecated
*/
protected function exporter(): \SebastianBergmann\Exporter\Exporter
{
return new \SebastianBergmann\Exporter\Exporter;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* This method can be overridden to implement the evaluation algorithm.
*/
protected function matches(mixed $other): bool
{
return false;
}
/**
* Throws an exception for the given compared value and test description.
*
* @throws ExpectationFailedException
*/
protected function fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): never
{
$failureDescription = sprintf(
'Failed asserting that %s.',
$this->failureDescription($other),
);
$additionalFailureDescription = $this->additionalFailureDescription($other);
if ($additionalFailureDescription) {
$failureDescription .= "\n" . $additionalFailureDescription;
}
if (!empty($description)) {
$failureDescription = $description . "\n" . $failureDescription;
}
throw new ExpectationFailedException(
$failureDescription,
$comparisonFailure,
);
}
/**
* Return additional failure description where needed.
*
* The function can be overridden to provide additional failure
* information like a diff
*/
protected function additionalFailureDescription(mixed $other): string
{
return '';
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* To provide additional failure information additionalFailureDescription
* can be used.
*/
protected function failureDescription(mixed $other): string
{
return Exporter::export($other, true) . ' ' . $this->toString(true);
}
/**
* Returns a custom string representation of the constraint object when it
* appears in context of an $operator expression.
*
* The purpose of this method is to provide meaningful descriptive string
* in context of operators such as LogicalNot. Native PHPUnit constraints
* are supported out of the box by LogicalNot, but externally developed
* ones had no way to provide correct strings in this context.
*
* The method shall return empty string, when it does not handle
* customization by itself.
*/
protected function toStringInContext(Operator $operator, mixed $role): string
{
return '';
}
/**
* Returns the description of the failure when this constraint appears in
* context of an $operator expression.
*
* The purpose of this method is to provide meaningful failure description
* in context of operators such as LogicalNot. Native PHPUnit constraints
* are supported out of the box by LogicalNot, but externally developed
* ones had no way to provide correct messages in this context.
*
* The method shall return empty string, when it does not handle
* customization by itself.
*/
protected function failureDescriptionInContext(Operator $operator, mixed $role, mixed $other): string
{
$string = $this->toStringInContext($operator, $role);
if ($string === '') {
return '';
}
return Exporter::export($other, true) . ' ' . $string;
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* Returns $this for terminal constraints and for operators that start
* non-reducible sub-expression, or the nearest descendant of $this that
* starts a non-reducible sub-expression.
*
* A constraint expression may be modelled as a tree with non-terminal
* nodes (operators) and terminal nodes. For example:
*
* LogicalOr (operator, non-terminal)
* + LogicalAnd (operator, non-terminal)
* | + IsType('int') (terminal)
* | + GreaterThan(10) (terminal)
* + LogicalNot (operator, non-terminal)
* + IsType('array') (terminal)
*
* A degenerate sub-expression is a part of the tree, that effectively does
* not contribute to the evaluation of the expression it appears in. An example
* of degenerate sub-expression is a BinaryOperator constructed with single
* operand or nested BinaryOperators, each with single operand. An
* expression involving a degenerate sub-expression is equivalent to a
* reduced expression with the degenerate sub-expression removed, for example
*
* LogicalAnd (operator)
* + LogicalOr (degenerate operator)
* | + LogicalAnd (degenerate operator)
* | + IsType('int') (terminal)
* + GreaterThan(10) (terminal)
*
* is equivalent to
*
* LogicalAnd (operator)
* + IsType('int') (terminal)
* + GreaterThan(10) (terminal)
*
* because the subexpression
*
* + LogicalOr
* + LogicalAnd
* + -
*
* is degenerate. Calling reduce() on the LogicalOr object above, as well
* as on LogicalAnd, shall return the IsType('int') instance.
*
* Other specific reductions can be implemented, for example cascade of
* LogicalNot operators
*
* + LogicalNot
* + LogicalNot
* +LogicalNot
* + IsTrue
*
* can be reduced to
*
* LogicalNot
* + IsTrue
*/
protected function reduce(): self
{
return $this;
}
/**
* @psalm-return non-empty-string
*/
protected function valueToTypeStringFragment(mixed $value): string
{
$type = strtolower(gettype($value));
if ($type === 'double') {
$type = 'float';
}
if ($type === 'resource (closed)') {
$type = 'closed resource';
}
return match ($type) {
'array', 'integer', 'object' => 'an ' . $type . ' ',
'boolean', 'closed resource', 'float', 'resource', 'string' => 'a ' . $type . ' ',
'null' => 'null ',
default => 'a value of ' . $type . ' ',
};
}
}
phpunit/src/Framework/Constraint/JsonMatches.php 0000644 00000005143 15243417753 0016050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function json_decode;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\InvalidJsonException;
use PHPUnit\Util\Json;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class JsonMatches extends Constraint
{
private readonly string $value;
public function __construct(string $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the object.
*/
public function toString(): string
{
return sprintf(
'matches JSON string "%s"',
$this->value,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* This method can be overridden to implement the evaluation algorithm.
*/
protected function matches(mixed $other): bool
{
[$error, $recodedOther] = Json::canonicalize($other);
if ($error) {
return false;
}
[$error, $recodedValue] = Json::canonicalize($this->value);
if ($error) {
return false;
}
return $recodedOther == $recodedValue;
}
/**
* Throws an exception for the given compared value and test description.
*
* @throws ExpectationFailedException
* @throws InvalidJsonException
*/
protected function fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): never
{
if ($comparisonFailure === null) {
[$error, $recodedOther] = Json::canonicalize($other);
if ($error) {
parent::fail($other, $description);
}
[$error, $recodedValue] = Json::canonicalize($this->value);
if ($error) {
parent::fail($other, $description);
}
$comparisonFailure = new ComparisonFailure(
json_decode($this->value),
json_decode($other),
Json::prettify($recodedValue),
Json::prettify($recodedOther),
'Failed asserting that two json values are equal.',
);
}
parent::fail($other, $description, $comparisonFailure);
}
}
phpunit/src/Framework/Constraint/Equality/IsEqualIgnoringCase.php 0000644 00000005554 15243417753 0021271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualIgnoringCase extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
0.0,
false,
true,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
return sprintf(
'is equal to %s',
Exporter::export($this->value, $exportObjects),
);
}
}
phpunit/src/Framework/Constraint/Equality/IsEqualWithDelta.php 0000644 00000005175 15243417753 0020605 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualWithDelta extends Constraint
{
private readonly mixed $value;
private readonly float $delta;
public function __construct(mixed $value, float $delta)
{
$this->value = $value;
$this->delta = $delta;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
$this->delta,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return sprintf(
'is equal to %s with delta <%F>',
Exporter::export($this->value, $exportObjects),
$this->delta,
);
}
}
phpunit/src/Framework/Constraint/Equality/IsEqualCanonicalizing.php 0000644 00000005527 15243417753 0021651 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualCanonicalizing extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
0.0,
true,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
return sprintf(
'is equal to %s',
Exporter::export($this->value, $exportObjects),
);
}
}
phpunit/src/Framework/Constraint/Equality/IsEqual.php 0000644 00000006615 15243417753 0016777 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqual extends Constraint
{
private readonly mixed $value;
private readonly float $delta;
private readonly bool $canonicalize;
private readonly bool $ignoreCase;
public function __construct(mixed $value, float $delta = 0.0, bool $canonicalize = false, bool $ignoreCase = false)
{
$this->value = $value;
$this->delta = $delta;
$this->canonicalize = $canonicalize;
$this->ignoreCase = $ignoreCase;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
$this->delta,
$this->canonicalize,
$this->ignoreCase,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
$delta = '';
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
if ($this->delta != 0) {
$delta = sprintf(
' with delta <%F>',
$this->delta,
);
}
return sprintf(
'is equal to %s%s',
Exporter::export($this->value, $exportObjects),
$delta,
);
}
}
phpunit/src/Framework/Constraint/Callback.php 0000644 00000002347 15243417753 0015331 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @psalm-template CallbackInput of mixed
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Callback extends Constraint
{
/**
* @psalm-var callable(CallbackInput $input): bool
*/
private readonly mixed $callback;
/**
* @psalm-param callable(CallbackInput $input): bool $callback
*/
public function __construct(callable $callback)
{
$this->callback = $callback;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is accepted by specified callback';
}
/**
* Evaluates the constraint for parameter $value. Returns true if the
* constraint is met, false otherwise.
*
* @psalm-param CallbackInput $other
*/
protected function matches(mixed $other): bool
{
return ($this->callback)($other);
}
}
phpunit/src/Framework/Constraint/Math/IsInfinite.php 0000644 00000001544 15243417753 0016565 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_infinite;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsInfinite extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is infinite';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_infinite($other);
}
}
phpunit/src/Framework/Constraint/Math/IsNan.php 0000644 00000001520 15243417753 0015526 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_nan;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsNan extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is nan';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_nan($other);
}
}
phpunit/src/Framework/Constraint/Math/IsFinite.php 0000644 00000001534 15243417753 0016235 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_finite;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsFinite extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is finite';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_finite($other);
}
}
phpunit/src/Framework/Constraint/Boolean/IsFalse.php 0000644 00000001500 15243417753 0016530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsFalse extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is false';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === false;
}
}
phpunit/src/Framework/Constraint/Boolean/IsTrue.php 0000644 00000001475 15243417753 0016430 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsTrue extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is true';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === true;
}
}
phpunit/src/Framework/Constraint/IsIdentical.php 0000644 00000007332 15243417753 0016024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function explode;
use function gettype;
use function is_array;
use function is_object;
use function is_string;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use UnitEnum;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsIdentical extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
$success = $this->value === $other;
if ($returnResult) {
return $success;
}
if (!$success) {
$f = null;
// if both values are strings, make sure a diff is generated
if (is_string($this->value) && is_string($other)) {
$f = new ComparisonFailure(
$this->value,
$other,
sprintf("'%s'", $this->value),
sprintf("'%s'", $other),
);
}
// if both values are array or enums, make sure a diff is generated
if ((is_array($this->value) && is_array($other)) || ($this->value instanceof UnitEnum && $other instanceof UnitEnum)) {
$f = new ComparisonFailure(
$this->value,
$other,
Exporter::export($this->value, true),
Exporter::export($other, true),
);
}
$this->fail($other, $description, $f);
}
return null;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_object($this->value)) {
return 'is identical to an object of class "' .
$this->value::class . '"';
}
return 'is identical to ' . Exporter::export($this->value, $exportObjects);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if (is_object($this->value) && is_object($other)) {
return 'two variables reference the same object';
}
if (explode(' ', gettype($this->value), 2)[0] === 'resource' && explode(' ', gettype($other), 2)[0] === 'resource') {
return 'two variables reference the same resource';
}
if (is_string($this->value) && is_string($other)) {
return 'two strings are identical';
}
if (is_array($this->value) && is_array($other)) {
return 'two arrays are identical';
}
return parent::failureDescription($other);
}
}
phpunit/src/Framework/Constraint/String/StringContains.php 0000644 00000010456 15243417753 0020050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function mb_detect_encoding;
use function mb_stripos;
use function mb_strtolower;
use function sprintf;
use function str_contains;
use function strlen;
use function strtr;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringContains extends Constraint
{
private readonly string $needle;
private readonly bool $ignoreCase;
private readonly bool $ignoreLineEndings;
public function __construct(string $needle, bool $ignoreCase = false, bool $ignoreLineEndings = false)
{
if ($ignoreLineEndings) {
$needle = $this->normalizeLineEndings($needle);
}
$this->needle = $needle;
$this->ignoreCase = $ignoreCase;
$this->ignoreLineEndings = $ignoreLineEndings;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$needle = $this->needle;
if ($this->ignoreCase) {
$needle = mb_strtolower($this->needle, 'UTF-8');
}
return sprintf(
'contains "%s" [%s](length: %s)',
$needle,
$this->getDetectedEncoding($needle),
strlen($needle),
);
}
public function failureDescription(mixed $other): string
{
$stringifiedHaystack = Exporter::export($other, true);
$haystackEncoding = $this->getDetectedEncoding($other);
$haystackLength = $this->getHaystackLength($other);
$haystackInformation = sprintf(
'%s [%s](length: %s) ',
$stringifiedHaystack,
$haystackEncoding,
$haystackLength,
);
$needleInformation = $this->toString(true);
return $haystackInformation . $needleInformation;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
$haystack = $other;
if ('' === $this->needle) {
return true;
}
if (!is_string($haystack)) {
return false;
}
if ($this->ignoreLineEndings) {
$haystack = $this->normalizeLineEndings($haystack);
}
if ($this->ignoreCase) {
/*
* We must use the multibyte-safe version, so we can accurately compare non-latin uppercase characters with
* their lowercase equivalents.
*/
return mb_stripos($haystack, $this->needle, 0, 'UTF-8') !== false;
}
/*
* Use the non-multibyte safe functions to see if the string is contained in $other.
*
* This function is very fast, and we don't care about the character position in the string.
*
* Additionally, we want this method to be binary safe, so we can check if some binary data is in other binary
* data.
*/
return str_contains($haystack, $this->needle);
}
private function getDetectedEncoding(mixed $other): string
{
if ($this->ignoreCase) {
return 'Encoding ignored';
}
if (!is_string($other)) {
return 'Encoding detection failed';
}
$detectedEncoding = mb_detect_encoding($other, null, true);
if ($detectedEncoding === false) {
return 'Encoding detection failed';
}
return $detectedEncoding;
}
private function getHaystackLength(mixed $haystack): int
{
if (!is_string($haystack)) {
return 0;
}
if ($this->ignoreLineEndings) {
$haystack = $this->normalizeLineEndings($haystack);
}
return strlen($haystack);
}
private function normalizeLineEndings(string $string): string
{
return strtr(
$string,
[
"\r\n" => "\n",
"\r" => "\n",
],
);
}
}
phpunit/src/Framework/Constraint/String/StringMatchesFormatDescription.php 0000644 00000006306 15243417753 0023232 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use const DIRECTORY_SEPARATOR;
use function explode;
use function implode;
use function preg_match;
use function preg_quote;
use function preg_replace;
use function strtr;
use SebastianBergmann\Diff\Differ;
use SebastianBergmann\Diff\Output\UnifiedDiffOutputBuilder;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringMatchesFormatDescription extends Constraint
{
private readonly string $formatDescription;
public function __construct(string $formatDescription)
{
$this->formatDescription = $formatDescription;
}
public function toString(): string
{
return 'matches format description:' . PHP_EOL . $this->formatDescription;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
$other = $this->convertNewlines($other);
$matches = preg_match(
$this->regularExpressionForFormatDescription(
$this->convertNewlines($this->formatDescription),
),
$other,
);
return $matches > 0;
}
protected function failureDescription(mixed $other): string
{
return 'string matches format description';
}
protected function additionalFailureDescription(mixed $other): string
{
$from = explode("\n", $this->formatDescription);
$to = explode("\n", $this->convertNewlines($other));
foreach ($from as $index => $line) {
if (isset($to[$index]) && $line !== $to[$index]) {
$line = $this->regularExpressionForFormatDescription($line);
if (preg_match($line, $to[$index]) > 0) {
$from[$index] = $to[$index];
}
}
}
$from = implode("\n", $from);
$to = implode("\n", $to);
return $this->differ()->diff($from, $to);
}
private function regularExpressionForFormatDescription(string $string): string
{
$string = strtr(
preg_quote($string, '/'),
[
'%%' => '%',
'%e' => '\\' . DIRECTORY_SEPARATOR,
'%s' => '[^\r\n]+',
'%S' => '[^\r\n]*',
'%a' => '.+',
'%A' => '.*',
'%w' => '\s*',
'%i' => '[+-]?\d+',
'%d' => '\d+',
'%x' => '[0-9a-fA-F]+',
'%f' => '[+-]?\.?\d+\.?\d*(?:[Ee][+-]?\d+)?',
'%c' => '.',
],
);
return '/^' . $string . '$/s';
}
private function convertNewlines(string $text): string
{
return preg_replace('/\r\n/', "\n", $text);
}
private function differ(): Differ
{
return new Differ(new UnifiedDiffOutputBuilder("--- Expected\n+++ Actual\n"));
}
}
phpunit/src/Framework/Constraint/String/StringEndsWith.php 0000644 00000002323 15243417753 0020011 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function str_ends_with;
use PHPUnit\Framework\EmptyStringException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringEndsWith extends Constraint
{
private readonly string $suffix;
/**
* @throws EmptyStringException
*/
public function __construct(string $suffix)
{
if ($suffix === '') {
throw new EmptyStringException;
}
$this->suffix = $suffix;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'ends with "' . $this->suffix . '"';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return str_ends_with((string) $other, $this->suffix);
}
}
phpunit/src/Framework/Constraint/String/RegularExpression.php 0000644 00000002145 15243417753 0020560 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function preg_match;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RegularExpression extends Constraint
{
private readonly string $pattern;
public function __construct(string $pattern)
{
$this->pattern = $pattern;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'matches PCRE pattern "%s"',
$this->pattern,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return preg_match($this->pattern, $other) > 0;
}
}
phpunit/src/Framework/Constraint/String/IsJson.php 0000644 00000004560 15243417753 0016307 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function json_decode;
use function json_last_error;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsJson extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is valid JSON';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (!is_string($other) || $other === '') {
return false;
}
json_decode($other);
if (json_last_error()) {
return false;
}
return true;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if (!is_string($other)) {
return $this->valueToTypeStringFragment($other) . 'is valid JSON';
}
if ($other === '') {
return 'an empty string is valid JSON';
}
return sprintf(
'a string is valid JSON (%s)',
$this->determineJsonError($other),
);
}
private function determineJsonError(string $json): string
{
json_decode($json);
return match (json_last_error()) {
JSON_ERROR_NONE => '',
JSON_ERROR_DEPTH => 'Maximum stack depth exceeded',
JSON_ERROR_STATE_MISMATCH => 'Underflow or the modes mismatch',
JSON_ERROR_CTRL_CHAR => 'Unexpected control character found',
JSON_ERROR_SYNTAX => 'Syntax error, malformed JSON',
JSON_ERROR_UTF8 => 'Malformed UTF-8 characters, possibly incorrectly encoded',
default => 'Unknown error',
};
}
}
phpunit/src/Framework/Constraint/String/StringStartsWith.php 0000644 00000002333 15243417753 0020401 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function str_starts_with;
use PHPUnit\Framework\EmptyStringException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringStartsWith extends Constraint
{
private readonly string $prefix;
/**
* @throws EmptyStringException
*/
public function __construct(string $prefix)
{
if ($prefix === '') {
throw new EmptyStringException;
}
$this->prefix = $prefix;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'starts with "' . $this->prefix . '"';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return str_starts_with((string) $other, $this->prefix);
}
}
phpunit/src/Framework/Constraint/String/StringEqualsStringIgnoringLineEndings.php 0000644 00000002623 15243417753 0024525 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function strtr;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringEqualsStringIgnoringLineEndings extends Constraint
{
private readonly string $string;
public function __construct(string $string)
{
$this->string = $this->normalizeLineEndings($string);
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is equal to "%s" ignoring line endings',
$this->string,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->string === $this->normalizeLineEndings((string) $other);
}
private function normalizeLineEndings(string $string): string
{
return strtr(
$string,
[
"\r\n" => "\n",
"\r" => "\n",
],
);
}
}
phpunit/src/Framework/Constraint/Type/IsNull.php 0000644 00000001475 15243417753 0015765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsNull extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is null';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === null;
}
}
phpunit/src/Framework/Constraint/Type/IsInstanceOf.php 0000644 00000003760 15243417753 0017103 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function class_exists;
use function interface_exists;
use function sprintf;
use PHPUnit\Framework\UnknownClassOrInterfaceException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsInstanceOf extends Constraint
{
/**
* @psalm-var class-string
*/
private readonly string $name;
/**
* @psalm-var 'class'|'interface'
*/
private readonly string $type;
/**
* @throws UnknownClassOrInterfaceException
*/
public function __construct(string $name)
{
if (class_exists($name)) {
$this->type = 'class';
} elseif (interface_exists($name)) {
$this->type = 'interface';
} else {
throw new UnknownClassOrInterfaceException($name);
}
$this->name = $name;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is an instance of %s %s',
$this->type,
$this->name,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other instanceof $this->name;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return $this->valueToTypeStringFragment($other) . $this->toString(true);
}
}
phpunit/src/Framework/Constraint/Type/IsType.php 0000644 00000011324 15243417753 0015766 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function is_array;
use function is_bool;
use function is_callable;
use function is_float;
use function is_int;
use function is_iterable;
use function is_numeric;
use function is_object;
use function is_scalar;
use function is_string;
use function sprintf;
use PHPUnit\Framework\UnknownTypeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsType extends Constraint
{
/**
* @var string
*/
public const TYPE_ARRAY = 'array';
/**
* @var string
*/
public const TYPE_BOOL = 'bool';
/**
* @var string
*/
public const TYPE_FLOAT = 'float';
/**
* @var string
*/
public const TYPE_INT = 'int';
/**
* @var string
*/
public const TYPE_NULL = 'null';
/**
* @var string
*/
public const TYPE_NUMERIC = 'numeric';
/**
* @var string
*/
public const TYPE_OBJECT = 'object';
/**
* @var string
*/
public const TYPE_RESOURCE = 'resource';
/**
* @var string
*/
public const TYPE_CLOSED_RESOURCE = 'resource (closed)';
/**
* @var string
*/
public const TYPE_STRING = 'string';
/**
* @var string
*/
public const TYPE_SCALAR = 'scalar';
/**
* @var string
*/
public const TYPE_CALLABLE = 'callable';
/**
* @var string
*/
public const TYPE_ITERABLE = 'iterable';
/**
* @psalm-var array<string,bool>
*/
private const KNOWN_TYPES = [
'array' => true,
'boolean' => true,
'bool' => true,
'double' => true,
'float' => true,
'integer' => true,
'int' => true,
'null' => true,
'numeric' => true,
'object' => true,
'real' => true,
'resource' => true,
'resource (closed)' => true,
'string' => true,
'scalar' => true,
'callable' => true,
'iterable' => true,
];
/**
* @psalm-var 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable'
*/
private readonly string $type;
/**
* @psalm-param 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable' $type
*
* @throws UnknownTypeException
*/
public function __construct(string $type)
{
if (!isset(self::KNOWN_TYPES[$type])) {
throw new UnknownTypeException($type);
}
$this->type = $type;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is of type %s',
$this->type,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
switch ($this->type) {
case 'numeric':
return is_numeric($other);
case 'integer':
case 'int':
return is_int($other);
case 'double':
case 'float':
case 'real':
return is_float($other);
case 'string':
return is_string($other);
case 'boolean':
case 'bool':
return is_bool($other);
case 'null':
return null === $other;
case 'array':
return is_array($other);
case 'object':
return is_object($other);
case 'resource':
$type = gettype($other);
return $type === 'resource' || $type === 'resource (closed)';
case 'resource (closed)':
return gettype($other) === 'resource (closed)';
case 'scalar':
return is_scalar($other);
case 'callable':
return is_callable($other);
case 'iterable':
return is_iterable($other);
default:
return false;
}
}
}
phpunit/src/Framework/Constraint/Cardinality/IsEmpty.php 0000644 00000003200 15243417753 0017457 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
use function gettype;
use function sprintf;
use function str_starts_with;
use Countable;
use EmptyIterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEmpty extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is empty';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof EmptyIterator) {
return true;
}
if ($other instanceof Countable) {
return count($other) === 0;
}
return empty($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
$type = gettype($other);
return sprintf(
'%s %s %s',
str_starts_with($type, 'a') || str_starts_with($type, 'o') ? 'an' : 'a',
$type,
$this->toString(true),
);
}
}
phpunit/src/Framework/Constraint/Cardinality/SameSize.php 0000644 00000001310 15243417753 0017605 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use Countable;
use PHPUnit\Framework\Exception;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class SameSize extends Count
{
/**
* @psalm-param Countable|iterable $expected
*
* @throws Exception
*/
public function __construct($expected)
{
parent::__construct((int) $this->getCountOf($expected));
}
}
phpunit/src/Framework/Constraint/Cardinality/LessThan.php 0000644 00000002061 15243417753 0017612 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LessThan extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'is less than ' . Exporter::export($this->value, $exportObjects);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->value > $other;
}
}
phpunit/src/Framework/Constraint/Cardinality/GreaterThan.php 0000644 00000002067 15243417753 0020303 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GreaterThan extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'is greater than ' . Exporter::export($this->value, $exportObjects);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->value < $other;
}
}
phpunit/src/Framework/Constraint/Cardinality/Count.php 0000644 00000006254 15243417753 0017171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
use function is_countable;
use function iterator_count;
use function sprintf;
use EmptyIterator;
use Generator;
use Iterator;
use IteratorAggregate;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\GeneratorNotSupportedException;
use Traversable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
class Count extends Constraint
{
private readonly int $expectedCount;
public function __construct(int $expected)
{
$this->expectedCount = $expected;
}
public function toString(): string
{
return sprintf(
'count matches %d',
$this->expectedCount,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws Exception
*/
protected function matches(mixed $other): bool
{
return $this->expectedCount === $this->getCountOf($other);
}
/**
* @throws Exception
*/
protected function getCountOf(mixed $other): ?int
{
if (is_countable($other)) {
return count($other);
}
if ($other instanceof EmptyIterator) {
return 0;
}
if ($other instanceof Traversable) {
while ($other instanceof IteratorAggregate) {
try {
$other = $other->getIterator();
} catch (\Exception $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
$iterator = $other;
if ($iterator instanceof Generator) {
throw new GeneratorNotSupportedException;
}
if (!$iterator instanceof Iterator) {
return iterator_count($iterator);
}
$key = $iterator->key();
$count = iterator_count($iterator);
// Manually rewind $iterator to previous key, since iterator_count
// moves pointer.
if ($key !== null) {
$iterator->rewind();
while ($iterator->valid() && $key !== $iterator->key()) {
$iterator->next();
}
}
return $count;
}
return null;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @throws Exception
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'actual size %d matches expected size %d',
(int) $this->getCountOf($other),
$this->expectedCount,
);
}
}
phpunit/src/Framework/Constraint/Filesystem/IsWritable.php 0000644 00000002372 15243417753 0020024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_writable;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsWritable extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is writable';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_writable($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'"%s" is writable',
$other,
);
}
}
phpunit/src/Framework/Constraint/Filesystem/IsReadable.php 0000644 00000002372 15243417753 0017752 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_readable;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsReadable extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is readable';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_readable($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'"%s" is readable',
$other,
);
}
}
phpunit/src/Framework/Constraint/Filesystem/FileExists.php 0000644 00000002372 15243417753 0020036 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function file_exists;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class FileExists extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'file exists';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return file_exists($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'file "%s" exists',
$other,
);
}
}
phpunit/src/Framework/Constraint/Filesystem/DirectoryExists.php 0000644 00000002377 15243417753 0021130 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_dir;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryExists extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'directory exists';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_dir($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'directory "%s" exists',
$other,
);
}
}
phpunit/src/Framework/Constraint/Exception/ExceptionCode.php 0000644 00000002744 15243417753 0020325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionCode extends Constraint
{
private readonly int|string $expectedCode;
public function __construct(int|string $expected)
{
$this->expectedCode = $expected;
}
public function toString(): string
{
return 'exception code is ' . $this->expectedCode;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return (string) $other === (string) $this->expectedCode;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'%s is equal to expected exception code %s',
Exporter::export($other, true),
Exporter::export($this->expectedCode, true),
);
}
}
phpunit/src/Framework/Constraint/Exception/ExceptionMessageIsOrContains.php 0000644 00000003376 15243417753 0023335 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function str_contains;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionMessageIsOrContains extends Constraint
{
private readonly string $expectedMessage;
public function __construct(string $expectedMessage)
{
$this->expectedMessage = $expectedMessage;
}
public function toString(): string
{
if ($this->expectedMessage === '') {
return 'exception message is empty';
}
return 'exception message contains ' . Exporter::export($this->expectedMessage);
}
protected function matches(mixed $other): bool
{
if ($this->expectedMessage === '') {
return $other === '';
}
return str_contains((string) $other, $this->expectedMessage);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if ($this->expectedMessage === '') {
return sprintf(
"exception message is empty but is '%s'",
$other,
);
}
return sprintf(
"exception message '%s' contains '%s'",
$other,
$this->expectedMessage,
);
}
}
phpunit/src/Framework/Constraint/Exception/Exception.php 0000644 00000003770 15243417753 0017532 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use PHPUnit\Util\Filter;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends Constraint
{
private readonly string $className;
public function __construct(string $className)
{
$this->className = $className;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'exception of type "%s"',
$this->className,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other instanceof $this->className;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @throws \PHPUnit\Framework\Exception
*/
protected function failureDescription(mixed $other): string
{
if ($other === null) {
return sprintf(
'exception of type "%s" is thrown',
$this->className,
);
}
$message = '';
if ($other instanceof Throwable) {
$message = '. Message was: "' . $other->getMessage() . '" at'
. "\n" . Filter::getFilteredStacktrace($other);
}
return sprintf(
'exception of type "%s" matches expected exception "%s"%s',
$other::class,
$this->className,
$message,
);
}
}
phpunit/src/Framework/Constraint/Exception/ExceptionMessageMatchesRegularExpression.php 0000644 00000003672 15243417753 0025747 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function preg_match;
use function sprintf;
use Exception;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionMessageMatchesRegularExpression extends Constraint
{
private readonly string $regularExpression;
public function __construct(string $regularExpression)
{
$this->regularExpression = $regularExpression;
}
public function toString(): string
{
return 'exception message matches ' . Exporter::export($this->regularExpression);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws \PHPUnit\Framework\Exception
* @throws Exception
*/
protected function matches(mixed $other): bool
{
$match = @preg_match($this->regularExpression, (string) $other);
if ($match === false) {
throw new \PHPUnit\Framework\Exception(
sprintf(
'Invalid expected exception message regular expression given: %s',
$this->regularExpression,
),
);
}
return $match === 1;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
"exception message '%s' matches '%s'",
$other,
$this->regularExpression,
);
}
}
phpunit/src/Framework/Constraint/Object/ObjectEquals.php 0000644 00000010435 15243417753 0017421 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_object;
use PHPUnit\Framework\ActualValueIsNotAnObjectException;
use PHPUnit\Framework\ComparisonMethodDoesNotAcceptParameterTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareBoolReturnTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareExactlyOneParameterException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareParameterTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotExistException;
use ReflectionNamedType;
use ReflectionObject;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ObjectEquals extends Constraint
{
private readonly object $expected;
private readonly string $method;
public function __construct(object $object, string $method = 'equals')
{
$this->expected = $object;
$this->method = $method;
}
public function toString(): string
{
return 'two objects are equal';
}
/**
* @throws ActualValueIsNotAnObjectException
* @throws ComparisonMethodDoesNotAcceptParameterTypeException
* @throws ComparisonMethodDoesNotDeclareBoolReturnTypeException
* @throws ComparisonMethodDoesNotDeclareExactlyOneParameterException
* @throws ComparisonMethodDoesNotDeclareParameterTypeException
* @throws ComparisonMethodDoesNotExistException
*/
protected function matches(mixed $other): bool
{
if (!is_object($other)) {
throw new ActualValueIsNotAnObjectException;
}
$object = new ReflectionObject($other);
if (!$object->hasMethod($this->method)) {
throw new ComparisonMethodDoesNotExistException(
$other::class,
$this->method,
);
}
$method = $object->getMethod($this->method);
if (!$method->hasReturnType()) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
$returnType = $method->getReturnType();
if (!$returnType instanceof ReflectionNamedType) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($returnType->allowsNull()) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($returnType->getName() !== 'bool') {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($method->getNumberOfParameters() !== 1 || $method->getNumberOfRequiredParameters() !== 1) {
throw new ComparisonMethodDoesNotDeclareExactlyOneParameterException(
$other::class,
$this->method,
);
}
$parameter = $method->getParameters()[0];
if (!$parameter->hasType()) {
throw new ComparisonMethodDoesNotDeclareParameterTypeException(
$other::class,
$this->method,
);
}
$type = $parameter->getType();
if (!$type instanceof ReflectionNamedType) {
throw new ComparisonMethodDoesNotDeclareParameterTypeException(
$other::class,
$this->method,
);
}
$typeName = $type->getName();
if ($typeName === 'self') {
$typeName = $other::class;
}
if (!$this->expected instanceof $typeName) {
throw new ComparisonMethodDoesNotAcceptParameterTypeException(
$other::class,
$this->method,
$this->expected::class,
);
}
return $other->{$this->method}($this->expected);
}
protected function failureDescription(mixed $other): string
{
return $this->toString(true);
}
}
phpunit/src/Framework/Constraint/Object/ObjectHasProperty.php 0000644 00000004000 15243417753 0020436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function is_object;
use function sprintf;
use ReflectionObject;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ObjectHasProperty extends Constraint
{
private readonly string $propertyName;
public function __construct(string $propertyName)
{
$this->propertyName = $propertyName;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'has property "%s"',
$this->propertyName,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @param mixed $other value or object to evaluate
*/
protected function matches(mixed $other): bool
{
if (!is_object($other)) {
return false;
}
return (new ReflectionObject($other))->hasProperty($this->propertyName);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @param mixed $other evaluated value or object
*/
protected function failureDescription(mixed $other): string
{
if (is_object($other)) {
return sprintf(
'object of class "%s" %s',
$other::class,
$this->toString(true),
);
}
return sprintf(
'"%s" (%s) %s',
$other,
gettype($other),
$this->toString(true),
);
}
}
phpunit/src/Framework/Constraint/IsAnything.php 0000644 00000002552 15243417753 0015710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsAnything extends Constraint
{
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
return $returnResult ? true : null;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is anything';
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return 0;
}
}
phpunit/src/Framework/SelfDescribing.php 0000644 00000001007 15243417753 0014364 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface SelfDescribing
{
/**
* Returns a string representation of the object.
*/
public function toString(): string;
}
phpunit/src/Framework/MockObject/Runtime/Invocation.php 0000644 00000007426 15243417753 0017270 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_map;
use function implode;
use function is_object;
use function sprintf;
use function str_starts_with;
use function strtolower;
use function substr;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Util\Cloner;
use SebastianBergmann\Exporter\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Invocation implements SelfDescribing
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly array $parameters;
private readonly string $returnType;
private readonly bool $isReturnTypeNullable;
private readonly bool $proxiedCall;
private readonly MockObjectInternal|StubInternal $object;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName, array $parameters, string $returnType, MockObjectInternal|StubInternal $object, bool $cloneObjects = false, bool $proxiedCall = false)
{
$this->className = $className;
$this->methodName = $methodName;
$this->object = $object;
$this->proxiedCall = $proxiedCall;
if (strtolower($methodName) === '__tostring') {
$returnType = 'string';
}
if (str_starts_with($returnType, '?')) {
$returnType = substr($returnType, 1);
$this->isReturnTypeNullable = true;
} else {
$this->isReturnTypeNullable = false;
}
$this->returnType = $returnType;
if (!$cloneObjects) {
$this->parameters = $parameters;
return;
}
foreach ($parameters as $key => $value) {
if (is_object($value)) {
$parameters[$key] = Cloner::clone($value);
}
}
$this->parameters = $parameters;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function parameters(): array
{
return $this->parameters;
}
/**
* @throws Exception
*/
public function generateReturnValue(): mixed
{
if ($this->returnType === 'never') {
throw new NeverReturningMethodException(
$this->className,
$this->methodName,
);
}
if ($this->isReturnTypeNullable || $this->proxiedCall) {
return null;
}
return (new ReturnValueGenerator)->generate(
$this->className,
$this->methodName,
$this->object::class,
$this->returnType,
);
}
public function toString(): string
{
$exporter = new Exporter;
return sprintf(
'%s::%s(%s)%s',
$this->className,
$this->methodName,
implode(
', ',
array_map(
[$exporter, 'shortenedExport'],
$this->parameters,
),
),
$this->returnType ? sprintf(': %s', $this->returnType) : '',
);
}
public function object(): MockObjectInternal|StubInternal
{
return $this->object;
}
}
phpunit/src/Framework/MockObject/Runtime/Builder/InvocationStubber.php 0000644 00000002203 15243417753 0022171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\MockObject\Stub\Stub;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface InvocationStubber
{
public function will(Stub $stub): Identity;
public function willReturn(mixed $value, mixed ...$nextValues): self;
public function willReturnReference(mixed &$reference): self;
/**
* @psalm-param array<int, array<int, mixed>> $valueMap
*/
public function willReturnMap(array $valueMap): self;
public function willReturnArgument(int $argumentIndex): self;
public function willReturnCallback(callable $callback): self;
public function willReturnSelf(): self;
public function willReturnOnConsecutiveCalls(mixed ...$values): self;
public function willThrowException(Throwable $exception): self;
}
phpunit/src/Framework/MockObject/Runtime/Builder/InvocationMocker.php 0000644 00000021556 15243417753 0022017 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use function array_flip;
use function array_key_exists;
use function array_map;
use function array_merge;
use function array_pop;
use function assert;
use function count;
use function is_string;
use function range;
use function strtolower;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
use PHPUnit\Framework\MockObject\IncompatibleReturnValueException;
use PHPUnit\Framework\MockObject\InvocationHandler;
use PHPUnit\Framework\MockObject\Matcher;
use PHPUnit\Framework\MockObject\MatcherAlreadyRegisteredException;
use PHPUnit\Framework\MockObject\MethodCannotBeConfiguredException;
use PHPUnit\Framework\MockObject\MethodNameAlreadyConfiguredException;
use PHPUnit\Framework\MockObject\MethodNameNotConfiguredException;
use PHPUnit\Framework\MockObject\MethodParametersAlreadyConfiguredException;
use PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls;
use PHPUnit\Framework\MockObject\Stub\Exception;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback;
use PHPUnit\Framework\MockObject\Stub\ReturnReference;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap;
use PHPUnit\Framework\MockObject\Stub\Stub;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvocationMocker implements InvocationStubber, MethodNameMatch
{
private readonly InvocationHandler $invocationHandler;
private readonly Matcher $matcher;
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
/**
* @psalm-var ?array<string, int>
*/
private ?array $configurableMethodNames = null;
public function __construct(InvocationHandler $handler, Matcher $matcher, ConfigurableMethod ...$configurableMethods)
{
$this->invocationHandler = $handler;
$this->matcher = $matcher;
$this->configurableMethods = $configurableMethods;
}
/**
* @throws MatcherAlreadyRegisteredException
*
* @return $this
*/
public function id(string $id): self
{
$this->invocationHandler->registerMatcher($id, $this->matcher);
return $this;
}
/**
* @return $this
*/
public function will(Stub $stub): Identity
{
$this->matcher->setStub($stub);
return $this;
}
/**
* @throws IncompatibleReturnValueException
*/
public function willReturn(mixed $value, mixed ...$nextValues): self
{
if (count($nextValues) === 0) {
$this->ensureTypeOfReturnValues([$value]);
$stub = $value instanceof Stub ? $value : new ReturnStub($value);
return $this->will($stub);
}
$values = array_merge([$value], $nextValues);
$this->ensureTypeOfReturnValues($values);
$stub = new ConsecutiveCalls($values);
return $this->will($stub);
}
public function willReturnReference(mixed &$reference): self
{
$stub = new ReturnReference($reference);
return $this->will($stub);
}
public function willReturnMap(array $valueMap): self
{
$method = $this->configuredMethod();
assert($method instanceof ConfigurableMethod);
$numberOfParameters = $method->numberOfParameters();
$defaultValues = $method->defaultParameterValues();
$hasDefaultValues = !empty($defaultValues);
$_valueMap = [];
foreach ($valueMap as $mapping) {
$numberOfConfiguredParameters = count($mapping) - 1;
if ($numberOfConfiguredParameters === $numberOfParameters || !$hasDefaultValues) {
$_valueMap[] = $mapping;
continue;
}
$_mapping = [];
$returnValue = array_pop($mapping);
foreach (range(0, $numberOfParameters - 1) as $i) {
if (isset($mapping[$i])) {
$_mapping[] = $mapping[$i];
continue;
}
if (isset($defaultValues[$i])) {
$_mapping[] = $defaultValues[$i];
}
}
$_mapping[] = $returnValue;
$_valueMap[] = $_mapping;
}
$stub = new ReturnValueMap($_valueMap);
return $this->will($stub);
}
public function willReturnArgument(int $argumentIndex): self
{
$stub = new ReturnArgument($argumentIndex);
return $this->will($stub);
}
public function willReturnCallback(callable $callback): self
{
$stub = new ReturnCallback($callback);
return $this->will($stub);
}
public function willReturnSelf(): self
{
$stub = new ReturnSelf;
return $this->will($stub);
}
public function willReturnOnConsecutiveCalls(mixed ...$values): self
{
$stub = new ConsecutiveCalls($values);
return $this->will($stub);
}
public function willThrowException(Throwable $exception): self
{
$stub = new Exception($exception);
return $this->will($stub);
}
/**
* @return $this
*/
public function after(string $id): self
{
$this->matcher->setAfterMatchBuilderId($id);
return $this;
}
/**
* @throws \PHPUnit\Framework\Exception
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*
* @return $this
*/
public function with(mixed ...$arguments): self
{
$this->ensureParametersCanBeConfigured();
$this->matcher->setParametersRule(new Rule\Parameters($arguments));
return $this;
}
/**
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*
* @return $this
*/
public function withAnyParameters(): self
{
$this->ensureParametersCanBeConfigured();
$this->matcher->setParametersRule(new Rule\AnyParameters);
return $this;
}
/**
* @throws InvalidArgumentException
* @throws MethodCannotBeConfiguredException
* @throws MethodNameAlreadyConfiguredException
*
* @return $this
*/
public function method(Constraint|string $constraint): self
{
if ($this->matcher->hasMethodNameRule()) {
throw new MethodNameAlreadyConfiguredException;
}
if (is_string($constraint)) {
$this->configurableMethodNames ??= array_flip(
array_map(
static fn (ConfigurableMethod $configurable) => strtolower($configurable->name()),
$this->configurableMethods,
),
);
if (!array_key_exists(strtolower($constraint), $this->configurableMethodNames)) {
throw new MethodCannotBeConfiguredException($constraint);
}
}
$this->matcher->setMethodNameRule(new Rule\MethodName($constraint));
return $this;
}
/**
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*/
private function ensureParametersCanBeConfigured(): void
{
if (!$this->matcher->hasMethodNameRule()) {
throw new MethodNameNotConfiguredException;
}
if ($this->matcher->hasParametersRule()) {
throw new MethodParametersAlreadyConfiguredException;
}
}
private function configuredMethod(): ?ConfigurableMethod
{
$configuredMethod = null;
foreach ($this->configurableMethods as $configurableMethod) {
if ($this->matcher->methodNameRule()->matchesName($configurableMethod->name())) {
if ($configuredMethod !== null) {
return null;
}
$configuredMethod = $configurableMethod;
}
}
return $configuredMethod;
}
/**
* @throws IncompatibleReturnValueException
*/
private function ensureTypeOfReturnValues(array $values): void
{
$configuredMethod = $this->configuredMethod();
if ($configuredMethod === null) {
return;
}
foreach ($values as $value) {
if (!$configuredMethod->mayReturn($value)) {
throw new IncompatibleReturnValueException(
$configuredMethod,
$value,
);
}
}
}
}
phpunit/src/Framework/MockObject/Runtime/Builder/ParametersMatch.php 0000644 00000002777 15243417753 0021631 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface ParametersMatch extends Stub
{
/**
* Defines the expectation which must occur before the current is valid.
*/
public function after(string $id): Stub;
/**
* Sets the parameters to match for, each parameter to this function will
* be part of match. To perform specific matches or constraints create a
* new PHPUnit\Framework\Constraint\Constraint and use it for the parameter.
* If the parameter value is not a constraint it will use the
* PHPUnit\Framework\Constraint\IsEqual for the value.
*
* Some examples:
* <code>
* // match first parameter with value 2
* $b->with(2);
* // match first parameter with value 'smock' and second identical to 42
* $b->with('smock', new PHPUnit\Framework\Constraint\IsEqual(42));
* </code>
*/
public function with(mixed ...$arguments): self;
/**
* Sets a rule which allows any kind of parameters.
*
* Some examples:
* <code>
* // match any number of parameters
* $b->withAnyParameters();
* </code>
*/
public function withAnyParameters(): self;
}
phpunit/src/Framework/MockObject/Runtime/Builder/Stub.php 0000644 00000001303 15243417753 0017446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\MockObject\Stub\Stub as BaseStub;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Stub extends Identity
{
/**
* Stubs the matching method with the stub object $stub. Any invocations of
* the matched method will now be handled by the stub instead.
*/
public function will(BaseStub $stub): Identity;
}
phpunit/src/Framework/MockObject/Runtime/Builder/MethodNameMatch.php 0000644 00000001272 15243417753 0021534 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\Constraint\Constraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface MethodNameMatch extends ParametersMatch
{
/**
* Adds a new method name match and returns the parameter match object for
* further matching possibilities.
*/
public function method(Constraint|string $constraint): self;
}
phpunit/src/Framework/MockObject/Runtime/Builder/Identity.php 0000644 00000001130 15243417753 0020320 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Identity
{
/**
* Sets the identification of the expectation to $id.
*
* @note The identifier is unique per mock object.
*/
public function id(string $id): self;
}
phpunit/src/Framework/MockObject/Runtime/Rule/InvocationOrder.php 0000644 00000002327 15243417753 0021166 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function count;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
use PHPUnit\Framework\SelfDescribing;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class InvocationOrder implements SelfDescribing
{
/**
* @psalm-var list<BaseInvocation>
*/
private array $invocations = [];
public function numberOfInvocations(): int
{
return count($this->invocations);
}
public function hasBeenInvoked(): bool
{
return count($this->invocations) > 0;
}
final public function invoked(BaseInvocation $invocation): void
{
$this->invocations[] = $invocation;
$this->invokedDo($invocation);
}
abstract public function matches(BaseInvocation $invocation): bool;
abstract public function verify(): void;
protected function invokedDo(BaseInvocation $invocation): void
{
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/ParametersRule.php 0000644 00000001353 15243417753 0021012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ParametersRule
{
/**
* @throws ExpectationFailedException if the invocation violates the rule
*/
public function apply(BaseInvocation $invocation): void;
public function verify(): void;
}
phpunit/src/Framework/MockObject/Runtime/Rule/AnyInvokedCount.php 0000644 00000001364 15243417753 0021141 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnyInvokedCount extends InvocationOrder
{
public function toString(): string
{
return 'invoked zero or more times';
}
public function verify(): void
{
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/InvokedAtMostCount.php 0000644 00000003527 15243417753 0021624 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtMostCount extends InvocationOrder
{
private readonly int $allowedInvocations;
public function __construct(int $allowedInvocations)
{
$this->allowedInvocations = $allowedInvocations;
}
public function toString(): string
{
return sprintf(
'invoked at most %d time%s',
$this->allowedInvocations,
$this->allowedInvocations !== 1 ? 's' : '',
);
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualInvocations = $this->numberOfInvocations();
if ($actualInvocations > $this->allowedInvocations) {
throw new ExpectationFailedException(
sprintf(
'Expected invocation at most %d time%s but it occurred %d time%s.',
$this->allowedInvocations,
$this->allowedInvocations !== 1 ? 's' : '',
$actualInvocations,
$actualInvocations !== 1 ? 's' : '',
),
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/InvokedCount.php 0000644 00000005106 15243417753 0020467 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedCount extends InvocationOrder
{
private readonly int $expectedCount;
public function __construct(int $expectedCount)
{
$this->expectedCount = $expectedCount;
}
public function isNever(): bool
{
return $this->expectedCount === 0;
}
public function toString(): string
{
return sprintf(
'invoked %d time%s',
$this->expectedCount,
$this->expectedCount !== 1 ? 's' : '',
);
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualCount = $this->numberOfInvocations();
if ($actualCount !== $this->expectedCount) {
throw new ExpectationFailedException(
sprintf(
'Method was expected to be called %d time%s, actually called %d time%s.',
$this->expectedCount,
$this->expectedCount !== 1 ? 's' : '',
$actualCount,
$actualCount !== 1 ? 's' : '',
),
);
}
}
/**
* @throws ExpectationFailedException
*/
protected function invokedDo(BaseInvocation $invocation): void
{
$count = $this->numberOfInvocations();
if ($count > $this->expectedCount) {
$message = $invocation->toString() . ' ';
$message .= match ($this->expectedCount) {
0 => 'was not expected to be called.',
1 => 'was not expected to be called more than once.',
default => sprintf(
'was not expected to be called more than %d times.',
$this->expectedCount,
),
};
throw new ExpectationFailedException($message);
}
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/InvokedAtLeastOnce.php 0000644 00000002330 15243417753 0021535 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtLeastOnce extends InvocationOrder
{
public function toString(): string
{
return 'invoked at least once';
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$count = $this->numberOfInvocations();
if ($count < 1) {
throw new ExpectationFailedException(
'Expected invocation at least once but it never occurred.',
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/AnyParameters.php 0000644 00000001174 15243417753 0020633 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnyParameters implements ParametersRule
{
public function apply(BaseInvocation $invocation): void
{
}
public function verify(): void
{
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/Parameters.php 0000644 00000010044 15243417753 0020157 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function count;
use function sprintf;
use Exception;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Parameters implements ParametersRule
{
/**
* @psalm-var list<Constraint>
*/
private array $parameters = [];
private ?BaseInvocation $invocation = null;
private null|bool|ExpectationFailedException $parameterVerificationResult;
/**
* @throws \PHPUnit\Framework\Exception
*/
public function __construct(array $parameters)
{
foreach ($parameters as $parameter) {
if (!($parameter instanceof Constraint)) {
$parameter = new IsEqual(
$parameter,
);
}
$this->parameters[] = $parameter;
}
}
/**
* @throws Exception
*/
public function apply(BaseInvocation $invocation): void
{
$this->invocation = $invocation;
$this->parameterVerificationResult = null;
try {
$this->parameterVerificationResult = $this->doVerify();
} catch (ExpectationFailedException $e) {
$this->parameterVerificationResult = $e;
throw $this->parameterVerificationResult;
}
}
/**
* Checks if the invocation $invocation matches the current rules. If it
* does the rule will get the invoked() method called which should check
* if an expectation is met.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$this->doVerify();
}
/**
* @throws ExpectationFailedException
*/
private function doVerify(): bool
{
if (isset($this->parameterVerificationResult)) {
return $this->guardAgainstDuplicateEvaluationOfParameterConstraints();
}
if ($this->invocation === null) {
throw new ExpectationFailedException('Mocked method does not exist.');
}
if (count($this->invocation->parameters()) < count($this->parameters)) {
$message = 'Parameter count for invocation %s is too low.';
// The user called `->with($this->anything())`, but may have meant
// `->withAnyParameters()`.
//
// @see https://github.com/sebastianbergmann/phpunit-mock-objects/issues/199
if (count($this->parameters) === 1 &&
$this->parameters[0]::class === IsAnything::class) {
$message .= "\nTo allow 0 or more parameters with any value, omit ->with() or use ->withAnyParameters() instead.";
}
throw new ExpectationFailedException(
sprintf($message, $this->invocation->toString()),
);
}
foreach ($this->parameters as $i => $parameter) {
$parameter->evaluate(
$this->invocation->parameters()[$i],
sprintf(
'Parameter %s for invocation %s does not match expected ' .
'value.',
$i,
$this->invocation->toString(),
),
);
}
return true;
}
/**
* @throws ExpectationFailedException
*/
private function guardAgainstDuplicateEvaluationOfParameterConstraints(): bool
{
if ($this->parameterVerificationResult instanceof ExpectationFailedException) {
throw $this->parameterVerificationResult;
}
return (bool) $this->parameterVerificationResult;
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/MethodName.php 0000644 00000003022 15243417753 0020073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function is_string;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
use PHPUnit\Framework\MockObject\MethodNameConstraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodName
{
private readonly Constraint $constraint;
/**
* @throws InvalidArgumentException
*/
public function __construct(Constraint|string $constraint)
{
if (is_string($constraint)) {
$constraint = new MethodNameConstraint($constraint);
}
$this->constraint = $constraint;
}
public function toString(): string
{
return 'method name ' . $this->constraint->toString();
}
/**
* @throws ExpectationFailedException
*/
public function matches(BaseInvocation $invocation): bool
{
return $this->matchesName($invocation->methodName());
}
/**
* @throws ExpectationFailedException
*/
public function matchesName(string $methodName): bool
{
return (bool) $this->constraint->evaluate($methodName, '', true);
}
}
phpunit/src/Framework/MockObject/Runtime/Rule/InvokedAtLeastCount.php 0000644 00000003543 15243417753 0021750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtLeastCount extends InvocationOrder
{
private readonly int $requiredInvocations;
public function __construct(int $requiredInvocations)
{
$this->requiredInvocations = $requiredInvocations;
}
public function toString(): string
{
return sprintf(
'invoked at least %d time%s',
$this->requiredInvocations,
$this->requiredInvocations !== 1 ? 's' : '',
);
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualInvocations = $this->numberOfInvocations();
if ($actualInvocations < $this->requiredInvocations) {
throw new ExpectationFailedException(
sprintf(
'Expected invocation at least %d time%s but it occurred %d time%s.',
$this->requiredInvocations,
$this->requiredInvocations !== 1 ? 's' : '',
$actualInvocations,
$actualInvocations !== 1 ? 's' : '',
),
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
phpunit/src/Framework/MockObject/Runtime/ReturnValueGenerator.php 0000644 00000016166 15243417753 0021303 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_keys;
use function array_map;
use function explode;
use function in_array;
use function interface_exists;
use function sprintf;
use function str_contains;
use function str_ends_with;
use function str_starts_with;
use function substr;
use PHPUnit\Framework\MockObject\Generator\Generator;
use ReflectionClass;
use stdClass;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueGenerator
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param class-string $stubClassName
*
* @throws Exception
*/
public function generate(string $className, string $methodName, string $stubClassName, string $returnType): mixed
{
$intersection = false;
$union = false;
if (str_contains($returnType, '|')) {
$types = explode('|', $returnType);
$union = true;
foreach (array_keys($types) as $key) {
if (str_starts_with($types[$key], '(') && str_ends_with($types[$key], ')')) {
$types[$key] = substr($types[$key], 1, -1);
}
}
} elseif (str_contains($returnType, '&')) {
$types = explode('&', $returnType);
$intersection = true;
} else {
$types = [$returnType];
}
if (!$intersection) {
$lowerTypes = array_map('strtolower', $types);
if (in_array('', $lowerTypes, true) ||
in_array('null', $lowerTypes, true) ||
in_array('mixed', $lowerTypes, true) ||
in_array('void', $lowerTypes, true)) {
return null;
}
if (in_array('true', $lowerTypes, true)) {
return true;
}
if (in_array('false', $lowerTypes, true) ||
in_array('bool', $lowerTypes, true)) {
return false;
}
if (in_array('float', $lowerTypes, true)) {
return 0.0;
}
if (in_array('int', $lowerTypes, true)) {
return 0;
}
if (in_array('string', $lowerTypes, true)) {
return '';
}
if (in_array('array', $lowerTypes, true)) {
return [];
}
if (in_array('static', $lowerTypes, true)) {
return $this->newInstanceOf($stubClassName, $className, $methodName);
}
if (in_array('object', $lowerTypes, true)) {
return new stdClass;
}
if (in_array('callable', $lowerTypes, true) ||
in_array('closure', $lowerTypes, true)) {
return static function (): void
{
};
}
if (in_array('traversable', $lowerTypes, true) ||
in_array('generator', $lowerTypes, true) ||
in_array('iterable', $lowerTypes, true)) {
$generator = static function (): \Generator
{
yield from [];
};
return $generator();
}
if (!$union) {
return $this->testDoubleFor($returnType, $className, $methodName);
}
}
if ($union) {
foreach ($types as $type) {
if (str_contains($type, '&')) {
$_types = explode('&', $type);
if ($this->onlyInterfaces($_types)) {
return $this->testDoubleForIntersectionOfInterfaces($_types, $className, $methodName);
}
}
}
}
if ($intersection && $this->onlyInterfaces($types)) {
return $this->testDoubleForIntersectionOfInterfaces($types, $className, $methodName);
}
$reason = '';
if ($union) {
$reason = ' because the declared return type is a union';
} elseif ($intersection) {
$reason = ' because the declared return type is an intersection';
}
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated%s, please configure a return value for this method',
$className,
$methodName,
$reason,
),
);
}
/**
* @psalm-param non-empty-list<string> $types
*/
private function onlyInterfaces(array $types): bool
{
foreach ($types as $type) {
if (!interface_exists($type)) {
return false;
}
}
return true;
}
/**
* @psalm-param class-string $stubClassName
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function newInstanceOf(string $stubClassName, string $className, string $methodName): Stub
{
try {
return (new ReflectionClass($stubClassName))->newInstanceWithoutConstructor();
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
/**
* @psalm-param class-string $type
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function testDoubleFor(string $type, string $className, string $methodName): Stub
{
try {
return (new Generator)->testDouble($type, false, [], [], '', false);
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
/**
* @psalm-param non-empty-list<string> $types
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function testDoubleForIntersectionOfInterfaces(array $types, string $className, string $methodName): Stub
{
try {
return (new Generator)->testDoubleForInterfaceIntersection($types, false);
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
}
phpunit/src/Framework/MockObject/Runtime/InvocationHandler.php 0000644 00000007446 15243417753 0020570 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function strtolower;
use Exception;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvocationHandler
{
/**
* @psalm-var list<Matcher>
*/
private array $matchers = [];
/**
* @psalm-var array<string,Matcher>
*/
private array $matcherMap = [];
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
private readonly bool $returnValueGeneration;
/**
* @psalm-param list<ConfigurableMethod> $configurableMethods
*/
public function __construct(array $configurableMethods, bool $returnValueGeneration)
{
$this->configurableMethods = $configurableMethods;
$this->returnValueGeneration = $returnValueGeneration;
}
public function hasMatchers(): bool
{
foreach ($this->matchers as $matcher) {
if ($matcher->hasMatchers()) {
return true;
}
}
return false;
}
/**
* Looks up the match builder with identification $id and returns it.
*/
public function lookupMatcher(string $id): ?Matcher
{
return $this->matcherMap[$id] ?? null;
}
/**
* Registers a matcher with the identification $id. The matcher can later be
* looked up using lookupMatcher() to figure out if it has been invoked.
*
* @throws MatcherAlreadyRegisteredException
*/
public function registerMatcher(string $id, Matcher $matcher): void
{
if (isset($this->matcherMap[$id])) {
throw new MatcherAlreadyRegisteredException($id);
}
$this->matcherMap[$id] = $matcher;
}
public function expects(InvocationOrder $rule): InvocationMocker
{
$matcher = new Matcher($rule);
$this->addMatcher($matcher);
return new InvocationMocker(
$this,
$matcher,
...$this->configurableMethods,
);
}
/**
* @throws \PHPUnit\Framework\MockObject\Exception
* @throws Exception
*/
public function invoke(Invocation $invocation): mixed
{
$exception = null;
$hasReturnValue = false;
$returnValue = null;
foreach ($this->matchers as $match) {
try {
if ($match->matches($invocation)) {
$value = $match->invoked($invocation);
if (!$hasReturnValue) {
$returnValue = $value;
$hasReturnValue = true;
}
}
} catch (Exception $e) {
$exception = $e;
}
}
if ($exception !== null) {
throw $exception;
}
if ($hasReturnValue) {
return $returnValue;
}
if (!$this->returnValueGeneration) {
if (strtolower($invocation->methodName()) === '__tostring') {
return '';
}
throw new ReturnValueNotConfiguredException($invocation);
}
return $invocation->generateReturnValue();
}
/**
* @throws Throwable
*/
public function verify(): void
{
foreach ($this->matchers as $matcher) {
$matcher->verify();
}
}
private function addMatcher(Matcher $matcher): void
{
$this->matchers[] = $matcher;
}
}
phpunit/src/Framework/MockObject/Runtime/Api/StubApi.php 0000644 00000003363 15243417753 0017233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait StubApi
{
/**
* @psalm-var list<ConfigurableMethod>
*/
private static array $__phpunit_configurableMethods;
private bool $__phpunit_returnValueGeneration = true;
private ?InvocationHandler $__phpunit_invocationMocker = null;
/** @noinspection MagicMethodsValidityInspection */
public static function __phpunit_initConfigurableMethods(ConfigurableMethod ...$configurableMethods): void
{
static::$__phpunit_configurableMethods = $configurableMethods;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_setReturnValueGeneration(bool $returnValueGeneration): void
{
$this->__phpunit_returnValueGeneration = $returnValueGeneration;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_getInvocationHandler(): InvocationHandler
{
if ($this->__phpunit_invocationMocker === null) {
$this->__phpunit_invocationMocker = new InvocationHandler(
static::$__phpunit_configurableMethods,
$this->__phpunit_returnValueGeneration,
);
}
return $this->__phpunit_invocationMocker;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_unsetInvocationMocker(): void
{
$this->__phpunit_invocationMocker = null;
}
}
phpunit/src/Framework/MockObject/Runtime/Api/ProxiedCloneMethod.php 0000644 00000001113 15243417753 0021407 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait ProxiedCloneMethod
{
public function __clone(): void
{
$this->__phpunit_invocationMocker = clone $this->__phpunit_getInvocationHandler();
parent::__clone();
}
}
phpunit/src/Framework/MockObject/Runtime/Api/MockObjectApi.php 0000644 00000003136 15243417753 0020334 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker as InvocationMockerBuilder;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait MockObjectApi
{
private object $__phpunit_originalObject;
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_hasMatchers(): bool
{
return $this->__phpunit_getInvocationHandler()->hasMatchers();
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_setOriginalObject(object $originalObject): void
{
$this->__phpunit_originalObject = $originalObject;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_verify(bool $unsetInvocationMocker = true): void
{
$this->__phpunit_getInvocationHandler()->verify();
if ($unsetInvocationMocker) {
$this->__phpunit_unsetInvocationMocker();
}
}
abstract public function __phpunit_getInvocationHandler(): InvocationHandler;
abstract public function __phpunit_unsetInvocationMocker(): void;
public function expects(InvocationOrder $matcher): InvocationMockerBuilder
{
return $this->__phpunit_getInvocationHandler()->expects($matcher);
}
}
phpunit/src/Framework/MockObject/Runtime/Api/DoubledCloneMethod.php 0000644 00000001057 15243417753 0021362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait DoubledCloneMethod
{
public function __clone(): void
{
$this->__phpunit_invocationMocker = clone $this->__phpunit_getInvocationHandler();
}
}
phpunit/src/Framework/MockObject/Runtime/Api/Method.php 0000644 00000001455 15243417753 0017104 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function call_user_func_array;
use function func_get_args;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait Method
{
public function method(): InvocationMocker
{
$expects = $this->expects(new AnyInvokedCount);
return call_user_func_array(
[$expects, 'method'],
func_get_args(),
);
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnSelf.php 0000644 00000001265 15243417753 0020160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
use PHPUnit\Framework\MockObject\RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnSelf implements Stub
{
/**
* @throws RuntimeException
*/
public function invoke(Invocation $invocation): object
{
return $invocation->object();
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnStub.php 0000644 00000001306 15243417753 0020200 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnStub implements Stub
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
public function invoke(Invocation $invocation): mixed
{
return $this->value;
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnArgument.php 0000644 00000001421 15243417753 0021043 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnArgument implements Stub
{
private readonly int $argumentIndex;
public function __construct(int $argumentIndex)
{
$this->argumentIndex = $argumentIndex;
}
public function invoke(Invocation $invocation): mixed
{
return $invocation->parameters()[$this->argumentIndex] ?? null;
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnCallback.php 0000644 00000001506 15243417753 0020761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function call_user_func_array;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnCallback implements Stub
{
/**
* @var callable
*/
private $callback;
public function __construct(callable $callback)
{
$this->callback = $callback;
}
public function invoke(Invocation $invocation): mixed
{
return call_user_func_array($this->callback, $invocation->parameters());
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ConsecutiveCalls.php 0000644 00000001547 15243417753 0021340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function array_shift;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConsecutiveCalls implements Stub
{
private array $stack;
public function __construct(array $stack)
{
$this->stack = $stack;
}
public function invoke(Invocation $invocation): mixed
{
$value = array_shift($this->stack);
if ($value instanceof Stub) {
$value = $value->invoke($invocation);
}
return $value;
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/Stub.php 0000644 00000001170 15243417753 0016777 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Stub
{
/**
* Fakes the processing of the invocation $invocation by returning a
* specific value.
*/
public function invoke(Invocation $invocation): mixed;
}
phpunit/src/Framework/MockObject/Runtime/Stub/Exception.php 0000644 00000001430 15243417753 0020017 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception implements Stub
{
private readonly Throwable $exception;
public function __construct(Throwable $exception)
{
$this->exception = $exception;
}
/**
* @throws Throwable
*/
public function invoke(Invocation $invocation): never
{
throw $this->exception;
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnValueMap.php 0000644 00000002206 15243417753 0020775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function array_pop;
use function count;
use function is_array;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueMap implements Stub
{
private readonly array $valueMap;
public function __construct(array $valueMap)
{
$this->valueMap = $valueMap;
}
public function invoke(Invocation $invocation): mixed
{
$parameterCount = count($invocation->parameters());
foreach ($this->valueMap as $map) {
if (!is_array($map) || $parameterCount !== (count($map) - 1)) {
continue;
}
$return = array_pop($map);
if ($invocation->parameters() === $map) {
return $return;
}
}
return null;
}
}
phpunit/src/Framework/MockObject/Runtime/Stub/ReturnReference.php 0000644 00000001330 15243417753 0021156 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnReference implements Stub
{
private mixed $reference;
public function __construct(mixed &$reference)
{
$this->reference = &$reference;
}
public function invoke(Invocation $invocation): mixed
{
return $this->reference;
}
}
phpunit/src/Framework/MockObject/Runtime/Matcher.php 0000644 00000014361 15243417753 0016536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount;
use PHPUnit\Framework\MockObject\Rule\AnyParameters;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount;
use PHPUnit\Framework\MockObject\Rule\InvokedCount;
use PHPUnit\Framework\MockObject\Rule\MethodName;
use PHPUnit\Framework\MockObject\Rule\ParametersRule;
use PHPUnit\Framework\MockObject\Stub\Stub;
use PHPUnit\Util\ThrowableToStringMapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Matcher
{
private readonly InvocationOrder $invocationRule;
private ?string $afterMatchBuilderId = null;
private ?MethodName $methodNameRule = null;
private ?ParametersRule $parametersRule = null;
private ?Stub $stub = null;
public function __construct(InvocationOrder $rule)
{
$this->invocationRule = $rule;
}
public function hasMatchers(): bool
{
return !$this->invocationRule instanceof AnyInvokedCount;
}
public function hasMethodNameRule(): bool
{
return $this->methodNameRule !== null;
}
public function methodNameRule(): MethodName
{
return $this->methodNameRule;
}
public function setMethodNameRule(MethodName $rule): void
{
$this->methodNameRule = $rule;
}
public function hasParametersRule(): bool
{
return $this->parametersRule !== null;
}
public function setParametersRule(ParametersRule $rule): void
{
$this->parametersRule = $rule;
}
public function setStub(Stub $stub): void
{
$this->stub = $stub;
}
public function setAfterMatchBuilderId(string $id): void
{
$this->afterMatchBuilderId = $id;
}
/**
* @throws Exception
* @throws ExpectationFailedException
* @throws MatchBuilderNotFoundException
* @throws MethodNameNotConfiguredException
* @throws RuntimeException
*/
public function invoked(Invocation $invocation): mixed
{
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
if ($this->afterMatchBuilderId !== null) {
$matcher = $invocation->object()
->__phpunit_getInvocationHandler()
->lookupMatcher($this->afterMatchBuilderId);
if (!$matcher) {
throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
}
}
$this->invocationRule->invoked($invocation);
try {
$this->parametersRule?->apply($invocation);
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
$e->getMessage(),
),
$e->getComparisonFailure(),
);
}
if ($this->stub) {
return $this->stub->invoke($invocation);
}
return $invocation->generateReturnValue();
}
/**
* @throws ExpectationFailedException
* @throws MatchBuilderNotFoundException
* @throws MethodNameNotConfiguredException
* @throws RuntimeException
*/
public function matches(Invocation $invocation): bool
{
if ($this->afterMatchBuilderId !== null) {
$matcher = $invocation->object()
->__phpunit_getInvocationHandler()
->lookupMatcher($this->afterMatchBuilderId);
if (!$matcher) {
throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
}
if (!$matcher->invocationRule->hasBeenInvoked()) {
return false;
}
}
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
if (!$this->invocationRule->matches($invocation)) {
return false;
}
try {
if (!$this->methodNameRule->matches($invocation)) {
return false;
}
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
$e->getMessage(),
),
$e->getComparisonFailure(),
);
}
return true;
}
/**
* @throws ExpectationFailedException
* @throws MethodNameNotConfiguredException
*/
public function verify(): void
{
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
try {
$this->invocationRule->verify();
if ($this->parametersRule === null) {
$this->parametersRule = new AnyParameters;
}
$invocationIsAny = $this->invocationRule instanceof AnyInvokedCount;
$invocationIsNever = $this->invocationRule instanceof InvokedCount && $this->invocationRule->isNever();
$invocationIsAtMost = $this->invocationRule instanceof InvokedAtMostCount;
if (!$invocationIsAny && !$invocationIsNever && !$invocationIsAtMost) {
$this->parametersRule->verify();
}
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s.\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
ThrowableToStringMapper::map($e),
),
);
}
}
}
phpunit/src/Framework/MockObject/Runtime/Interface/MockObjectInternal.php 0000644 00000001241 15243417753 0022561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectInternal extends MockObject, StubInternal
{
public function __phpunit_hasMatchers(): bool;
public function __phpunit_setOriginalObject(object $originalObject): void;
public function __phpunit_verify(bool $unsetInvocationMocker = true): void;
}
phpunit/src/Framework/MockObject/Runtime/Interface/Stub.php 0000644 00000001033 15243417753 0017760 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationStubber;
/**
* @method InvocationStubber method($constraint)
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Stub
{
}
phpunit/src/Framework/MockObject/Runtime/Interface/MockObject.php 0000644 00000001263 15243417753 0021070 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
/**
* @method InvocationMocker method($constraint)
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObject extends Stub
{
public function expects(InvocationOrder $invocationRule): InvocationMocker;
}
phpunit/src/Framework/MockObject/Runtime/Interface/StubInternal.php 0000644 00000001407 15243417753 0021462 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface StubInternal extends Stub
{
public static function __phpunit_initConfigurableMethods(ConfigurableMethod ...$configurableMethods): void;
public function __phpunit_getInvocationHandler(): InvocationHandler;
public function __phpunit_setReturnValueGeneration(bool $returnValueGeneration): void;
public function __phpunit_unsetInvocationMocker(): void;
}
phpunit/src/Framework/MockObject/Runtime/MethodNameConstraint.php 0000644 00000001712 15243417753 0021235 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use function strtolower;
use PHPUnit\Framework\Constraint\Constraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameConstraint extends Constraint
{
private readonly string $methodName;
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
public function toString(): string
{
return sprintf(
'is "%s"',
$this->methodName,
);
}
protected function matches(mixed $other): bool
{
return strtolower($this->methodName) === strtolower((string) $other);
}
}
phpunit/src/Framework/MockObject/MockBuilder.php 0000644 00000030346 15243417753 0015731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_merge;
use function assert;
use function trait_exists;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\Generator\ClassAlreadyExistsException;
use PHPUnit\Framework\MockObject\Generator\ClassIsEnumerationException;
use PHPUnit\Framework\MockObject\Generator\ClassIsFinalException;
use PHPUnit\Framework\MockObject\Generator\ClassIsReadonlyException;
use PHPUnit\Framework\MockObject\Generator\DuplicateMethodException;
use PHPUnit\Framework\MockObject\Generator\Generator;
use PHPUnit\Framework\MockObject\Generator\InvalidMethodNameException;
use PHPUnit\Framework\MockObject\Generator\OriginalConstructorInvocationRequiredException;
use PHPUnit\Framework\MockObject\Generator\ReflectionException;
use PHPUnit\Framework\MockObject\Generator\RuntimeException;
use PHPUnit\Framework\MockObject\Generator\UnknownTypeException;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
/**
* @psalm-template MockedType
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockBuilder
{
private readonly TestCase $testCase;
/**
* @psalm-var class-string|trait-string
*/
private readonly string $type;
/**
* @psalm-var list<non-empty-string>
*/
private array $methods = [];
private bool $emptyMethodsArray = false;
/**
* @psalm-var ?class-string
*/
private ?string $mockClassName = null;
private array $constructorArgs = [];
private bool $originalConstructor = true;
private bool $originalClone = true;
private bool $autoload = true;
private bool $cloneArguments = false;
private bool $callOriginalMethods = false;
private ?object $proxyTarget = null;
private bool $allowMockingUnknownTypes = true;
private bool $returnValueGeneration = true;
private readonly Generator $generator;
/**
* @psalm-param class-string|trait-string $type
*/
public function __construct(TestCase $testCase, string $type)
{
$this->testCase = $testCase;
$this->type = $type;
$this->generator = new Generator;
}
/**
* Creates a mock object using a fluent interface.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTypeException
*
* @psalm-return MockObject&MockedType
*/
public function getMock(): MockObject
{
$object = $this->generator->testDouble(
$this->type,
true,
!$this->emptyMethodsArray ? $this->methods : null,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->cloneArguments,
$this->callOriginalMethods,
$this->proxyTarget,
$this->allowMockingUnknownTypes,
$this->returnValueGeneration,
);
assert($object instanceof $this->type);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Creates a mock object for an abstract class using a fluent interface.
*
* @psalm-return MockObject&MockedType
*
* @throws Exception
* @throws ReflectionException
* @throws RuntimeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5305
*/
public function getMockForAbstractClass(): MockObject
{
$object = $this->generator->mockObjectForAbstractClass(
$this->type,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->methods,
$this->cloneArguments,
);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Creates a mock object for a trait using a fluent interface.
*
* @psalm-return MockObject&MockedType
*
* @throws Exception
* @throws ReflectionException
* @throws RuntimeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5306
*/
public function getMockForTrait(): MockObject
{
assert(trait_exists($this->type));
$object = $this->generator->mockObjectForTrait(
$this->type,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->methods,
$this->cloneArguments,
);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Specifies the subset of methods to mock, requiring each to exist in the class.
*
* @psalm-param list<non-empty-string> $methods
*
* @throws CannotUseOnlyMethodsException
* @throws ReflectionException
*
* @return $this
*/
public function onlyMethods(array $methods): self
{
if (empty($methods)) {
$this->emptyMethodsArray = true;
return $this;
}
try {
$reflector = new ReflectionClass($this->type);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
foreach ($methods as $method) {
if (!$reflector->hasMethod($method)) {
throw new CannotUseOnlyMethodsException($this->type, $method);
}
}
$this->methods = array_merge($this->methods, $methods);
return $this;
}
/**
* Specifies methods that don't exist in the class which you want to mock.
*
* @psalm-param list<non-empty-string> $methods
*
* @throws CannotUseAddMethodsException
* @throws ReflectionException
* @throws RuntimeException
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5320
*/
public function addMethods(array $methods): self
{
if (empty($methods)) {
$this->emptyMethodsArray = true;
return $this;
}
try {
$reflector = new ReflectionClass($this->type);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
foreach ($methods as $method) {
if ($reflector->hasMethod($method)) {
throw new CannotUseAddMethodsException($this->type, $method);
}
}
$this->methods = array_merge($this->methods, $methods);
return $this;
}
/**
* Specifies the arguments for the constructor.
*
* @return $this
*/
public function setConstructorArgs(array $arguments): self
{
$this->constructorArgs = $arguments;
return $this;
}
/**
* Specifies the name for the mock class.
*
* @psalm-param class-string $name
*
* @return $this
*/
public function setMockClassName(string $name): self
{
$this->mockClassName = $name;
return $this;
}
/**
* Disables the invocation of the original constructor.
*
* @return $this
*/
public function disableOriginalConstructor(): self
{
$this->originalConstructor = false;
return $this;
}
/**
* Enables the invocation of the original constructor.
*
* @return $this
*/
public function enableOriginalConstructor(): self
{
$this->originalConstructor = true;
return $this;
}
/**
* Disables the invocation of the original clone constructor.
*
* @return $this
*/
public function disableOriginalClone(): self
{
$this->originalClone = false;
return $this;
}
/**
* Enables the invocation of the original clone constructor.
*
* @return $this
*/
public function enableOriginalClone(): self
{
$this->originalClone = true;
return $this;
}
/**
* Disables the use of class autoloading while creating the mock object.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5309
*/
public function disableAutoload(): self
{
$this->autoload = false;
return $this;
}
/**
* Enables the use of class autoloading while creating the mock object.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5309
*/
public function enableAutoload(): self
{
$this->autoload = true;
return $this;
}
/**
* Disables the cloning of arguments passed to mocked methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5315
*/
public function disableArgumentCloning(): self
{
$this->cloneArguments = false;
return $this;
}
/**
* Enables the cloning of arguments passed to mocked methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5315
*/
public function enableArgumentCloning(): self
{
$this->cloneArguments = true;
return $this;
}
/**
* Enables the invocation of the original methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function enableProxyingToOriginalMethods(): self
{
$this->callOriginalMethods = true;
return $this;
}
/**
* Disables the invocation of the original methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function disableProxyingToOriginalMethods(): self
{
$this->callOriginalMethods = false;
$this->proxyTarget = null;
return $this;
}
/**
* Sets the proxy target.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function setProxyTarget(object $object): self
{
$this->proxyTarget = $object;
return $this;
}
/**
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5308
*/
public function allowMockingUnknownTypes(): self
{
$this->allowMockingUnknownTypes = true;
return $this;
}
/**
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5308
*/
public function disallowMockingUnknownTypes(): self
{
$this->allowMockingUnknownTypes = false;
return $this;
}
/**
* @return $this
*/
public function enableAutoReturnValueGeneration(): self
{
$this->returnValueGeneration = true;
return $this;
}
/**
* @return $this
*/
public function disableAutoReturnValueGeneration(): self
{
$this->returnValueGeneration = false;
return $this;
}
}
phpunit/src/Framework/MockObject/ConfigurableMethod.php 0000644 00000003756 15243417753 0017277 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use SebastianBergmann\Type\Type;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConfigurableMethod
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
/**
* @psalm-var array<int, mixed>
*/
private readonly array $defaultParameterValues;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfParameters;
private readonly Type $returnType;
/**
* @psalm-param non-empty-string $name
* @psalm-param array<int, mixed> $defaultParameterValues
* @psalm-param non-negative-int $numberOfParameters
*/
public function __construct(string $name, array $defaultParameterValues, int $numberOfParameters, Type $returnType)
{
$this->name = $name;
$this->defaultParameterValues = $defaultParameterValues;
$this->numberOfParameters = $numberOfParameters;
$this->returnType = $returnType;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
/**
* @psalm-return array<int, mixed>
*/
public function defaultParameterValues(): array
{
return $this->defaultParameterValues;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfParameters(): int
{
return $this->numberOfParameters;
}
public function mayReturn(mixed $value): bool
{
return $this->returnType->isAssignable(Type::fromValue($value, false));
}
public function returnTypeDeclaration(): string
{
return $this->returnType->asString();
}
}
phpunit/src/Framework/MockObject/Exception/MethodCannotBeConfiguredException.php 0000644 00000001503 15243417753 0024177 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodCannotBeConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $method)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" which cannot be configured because it does not exist, has not been specified, is final, or is static',
$method,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/CannotUseAddMethodsException.php 0000644 00000001554 15243417753 0023201 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotUseAddMethodsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type, string $methodName)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" with addMethods(), but it exists in class "%s". Use onlyMethods() for methods that exist in the class',
$methodName,
$type,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/MatchBuilderNotFoundException.php 0000644 00000001351 15243417753 0023360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MatchBuilderNotFoundException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $id)
{
parent::__construct(
sprintf(
'No builder found for match builder identification <%s>',
$id,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/MatcherAlreadyRegisteredException.php 0000644 00000001341 15243417753 0024242 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MatcherAlreadyRegisteredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $id)
{
parent::__construct(
sprintf(
'Matcher with id <%s> is already registered',
$id,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/IncompatibleReturnValueException.php 0000644 00000001642 15243417753 0024146 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function get_debug_type;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncompatibleReturnValueException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(ConfigurableMethod $method, mixed $value)
{
parent::__construct(
sprintf(
'Method %s may not return value of type %s, its declared return type is "%s"',
$method->name(),
get_debug_type($value),
$method->returnTypeDeclaration(),
),
);
}
}
phpunit/src/Framework/MockObject/Exception/BadMethodCallException.php 0000644 00000000743 15243417753 0021767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BadMethodCallException extends \BadMethodCallException implements Exception
{
}
phpunit/src/Framework/MockObject/Exception/ReturnValueNotConfiguredException.php 0000644 00000001525 15243417753 0024306 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueNotConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(Invocation $invocation)
{
parent::__construct(
sprintf(
'No return value is configured for %s::%s() and return value generation is disabled',
$invocation->className(),
$invocation->methodName(),
),
);
}
}
phpunit/src/Framework/MockObject/Exception/MethodNameAlreadyConfiguredException.php 0000644 00000001146 15243417753 0024673 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameAlreadyConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method name is already configured');
}
}
phpunit/src/Framework/MockObject/Exception/Exception.php 0000644 00000000701 15243417753 0017415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
phpunit/src/Framework/MockObject/Exception/RuntimeException.php 0000644 00000000727 15243417753 0020771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
phpunit/src/Framework/MockObject/Exception/ReflectionException.php 0000644 00000000760 15243417753 0021435 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
phpunit/src/Framework/MockObject/Exception/MethodParametersAlreadyConfiguredException.php 0000644 00000001157 15243417753 0026120 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodParametersAlreadyConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method parameters already configured');
}
}
phpunit/src/Framework/MockObject/Exception/NeverReturningMethodException.php 0000644 00000001644 15243417753 0023463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NeverReturningMethodException extends RuntimeException implements Exception
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Method %s::%s() is declared to never return',
$className,
$methodName,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/CannotUseOnlyMethodsException.php 0000644 00000001477 15243417753 0023436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotUseOnlyMethodsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type, string $methodName)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" with onlyMethods(), but it does not exist in class "%s"',
$methodName,
$type,
),
);
}
}
phpunit/src/Framework/MockObject/Exception/MethodNameNotConfiguredException.php 0000644 00000001136 15243417753 0024051 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameNotConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method name is not configured');
}
}
phpunit/src/Framework/MockObject/Generator/MockMethod.php 0000644 00000026673 15243417753 0017521 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function count;
use function explode;
use function implode;
use function is_object;
use function is_string;
use function preg_match;
use function preg_replace;
use function sprintf;
use function strlen;
use function strpos;
use function substr;
use function substr_count;
use function trim;
use function var_export;
use ReflectionMethod;
use ReflectionParameter;
use SebastianBergmann\Type\ReflectionMapper;
use SebastianBergmann\Type\Type;
use SebastianBergmann\Type\UnknownType;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockMethod
{
use TemplateLoader;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly bool $cloneArguments;
private readonly string $modifier;
private readonly string $argumentsForDeclaration;
private readonly string $argumentsForCall;
private readonly Type $returnType;
private readonly string $reference;
private readonly bool $callOriginalMethod;
private readonly bool $static;
private readonly ?string $deprecation;
/**
* @psalm-var array<int, mixed>
*/
private readonly array $defaultParameterValues;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfParameters;
/**
* @throws ReflectionException
* @throws RuntimeException
*/
public static function fromReflection(ReflectionMethod $method, bool $callOriginalMethod, bool $cloneArguments): self
{
if ($method->isPrivate()) {
$modifier = 'private';
} elseif ($method->isProtected()) {
$modifier = 'protected';
} else {
$modifier = 'public';
}
if ($method->isStatic()) {
$modifier .= ' static';
}
if ($method->returnsReference()) {
$reference = '&';
} else {
$reference = '';
}
$docComment = $method->getDocComment();
if (is_string($docComment) &&
preg_match('#\*[ \t]*+@deprecated[ \t]*+(.*?)\r?+\n[ \t]*+\*(?:[ \t]*+@|/$)#s', $docComment, $deprecation)) {
$deprecation = trim(preg_replace('#[ \t]*\r?\n[ \t]*+\*[ \t]*+#', ' ', $deprecation[1]));
} else {
$deprecation = null;
}
return new self(
$method->getDeclaringClass()->getName(),
$method->getName(),
$cloneArguments,
$modifier,
self::methodParametersForDeclaration($method),
self::methodParametersForCall($method),
self::methodParametersDefaultValues($method),
count($method->getParameters()),
(new ReflectionMapper)->fromReturnType($method),
$reference,
$callOriginalMethod,
$method->isStatic(),
$deprecation,
);
}
/**
* @param class-string $className
* @param non-empty-string $methodName
*/
public static function fromName(string $className, string $methodName, bool $cloneArguments): self
{
return new self(
$className,
$methodName,
$cloneArguments,
'public',
'',
'',
[],
0,
new UnknownType,
'',
false,
false,
null,
);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param array<int, mixed> $defaultParameterValues
* @psalm-param non-negative-int $numberOfParameters
*/
private function __construct(string $className, string $methodName, bool $cloneArguments, string $modifier, string $argumentsForDeclaration, string $argumentsForCall, array $defaultParameterValues, int $numberOfParameters, Type $returnType, string $reference, bool $callOriginalMethod, bool $static, ?string $deprecation)
{
$this->className = $className;
$this->methodName = $methodName;
$this->cloneArguments = $cloneArguments;
$this->modifier = $modifier;
$this->argumentsForDeclaration = $argumentsForDeclaration;
$this->argumentsForCall = $argumentsForCall;
$this->defaultParameterValues = $defaultParameterValues;
$this->numberOfParameters = $numberOfParameters;
$this->returnType = $returnType;
$this->reference = $reference;
$this->callOriginalMethod = $callOriginalMethod;
$this->static = $static;
$this->deprecation = $deprecation;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
/**
* @throws RuntimeException
*/
public function generateCode(): string
{
if ($this->static) {
$templateFile = 'doubled_static_method.tpl';
} else {
$templateFile = sprintf(
'%s_method.tpl',
$this->callOriginalMethod ? 'proxied' : 'doubled',
);
}
$deprecation = $this->deprecation;
$returnResult = '';
if (!$this->returnType->isNever() && !$this->returnType->isVoid()) {
$returnResult = <<<'EOT'
return $__phpunit_result;
EOT;
}
if (null !== $this->deprecation) {
$deprecation = "The {$this->className}::{$this->methodName} method is deprecated ({$this->deprecation}).";
$deprecationTemplate = $this->loadTemplate('deprecation.tpl');
$deprecationTemplate->setVar(
[
'deprecation' => var_export($deprecation, true),
],
);
$deprecation = $deprecationTemplate->render();
}
$template = $this->loadTemplate($templateFile);
$template->setVar(
[
'arguments_decl' => $this->argumentsForDeclaration,
'arguments_call' => $this->argumentsForCall,
'return_declaration' => !empty($this->returnType->asString()) ? (': ' . $this->returnType->asString()) : '',
'return_type' => $this->returnType->asString(),
'arguments_count' => !empty($this->argumentsForCall) ? substr_count($this->argumentsForCall, ',') + 1 : 0,
'class_name' => $this->className,
'method_name' => $this->methodName,
'modifier' => $this->modifier,
'reference' => $this->reference,
'clone_arguments' => $this->cloneArguments ? 'true' : 'false',
'deprecation' => $deprecation,
'return_result' => $returnResult,
],
);
return $template->render();
}
public function returnType(): Type
{
return $this->returnType;
}
/**
* @psalm-return array<int, mixed>
*/
public function defaultParameterValues(): array
{
return $this->defaultParameterValues;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfParameters(): int
{
return $this->numberOfParameters;
}
/**
* Returns the parameters of a function or method.
*
* @throws RuntimeException
*/
private static function methodParametersForDeclaration(ReflectionMethod $method): string
{
$parameters = [];
$types = (new ReflectionMapper)->fromParameterTypes($method);
foreach ($method->getParameters() as $i => $parameter) {
$name = '$' . $parameter->getName();
/* Note: PHP extensions may use empty names for reference arguments
* or "..." for methods taking a variable number of arguments.
*/
if ($name === '$' || $name === '$...') {
$name = '$arg' . $i;
}
$default = '';
$reference = '';
$typeDeclaration = '';
if (!$types[$i]->type()->isUnknown()) {
$typeDeclaration = $types[$i]->type()->asString() . ' ';
}
if ($parameter->isPassedByReference()) {
$reference = '&';
}
if ($parameter->isVariadic()) {
$name = '...' . $name;
} elseif ($parameter->isDefaultValueAvailable()) {
$default = ' = ' . self::exportDefaultValue($parameter);
} elseif ($parameter->isOptional()) {
$default = ' = null';
}
$parameters[] = $typeDeclaration . $reference . $name . $default;
}
return implode(', ', $parameters);
}
/**
* Returns the parameters of a function or method.
*
* @throws ReflectionException
*/
private static function methodParametersForCall(ReflectionMethod $method): string
{
$parameters = [];
foreach ($method->getParameters() as $i => $parameter) {
$name = '$' . $parameter->getName();
/* Note: PHP extensions may use empty names for reference arguments
* or "..." for methods taking a variable number of arguments.
*/
if ($name === '$' || $name === '$...') {
$name = '$arg' . $i;
}
if ($parameter->isVariadic()) {
continue;
}
if ($parameter->isPassedByReference()) {
$parameters[] = '&' . $name;
} else {
$parameters[] = $name;
}
}
return implode(', ', $parameters);
}
/**
* @throws ReflectionException
*/
private static function exportDefaultValue(ReflectionParameter $parameter): string
{
try {
$defaultValue = $parameter->getDefaultValue();
if (!is_object($defaultValue)) {
return var_export($defaultValue, true);
}
$parameterAsString = $parameter->__toString();
return explode(
' = ',
substr(
substr(
$parameterAsString,
strpos($parameterAsString, '<optional> ') + strlen('<optional> '),
),
0,
-2,
),
)[1];
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
/**
* @psalm-return array<int, mixed>
*/
private static function methodParametersDefaultValues(ReflectionMethod $method): array
{
$result = [];
foreach ($method->getParameters() as $i => $parameter) {
if (!$parameter->isDefaultValueAvailable()) {
continue;
}
$result[$i] = $parameter->getDefaultValue();
}
return $result;
}
}
phpunit/src/Framework/MockObject/Generator/MockClass.php 0000644 00000003276 15243417753 0017340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function call_user_func;
use function class_exists;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockClass implements MockType
{
private readonly string $classCode;
/**
* @psalm-var class-string
*/
private readonly string $mockName;
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
/**
* @psalm-param class-string $mockName
* @psalm-param list<ConfigurableMethod> $configurableMethods
*/
public function __construct(string $classCode, string $mockName, array $configurableMethods)
{
$this->classCode = $classCode;
$this->mockName = $mockName;
$this->configurableMethods = $configurableMethods;
}
/**
* @psalm-return class-string
*/
public function generate(): string
{
if (!class_exists($this->mockName, false)) {
eval($this->classCode);
call_user_func(
[
$this->mockName,
'__phpunit_initConfigurableMethods',
],
...$this->configurableMethods,
);
}
return $this->mockName;
}
public function classCode(): string
{
return $this->classCode;
}
}
phpunit/src/Framework/MockObject/Generator/Generator.php 0000644 00000103420 15243417753 0017377 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use const PHP_EOL;
use const PREG_OFFSET_CAPTURE;
use const WSDL_CACHE_NONE;
use function array_merge;
use function array_pop;
use function array_unique;
use function assert;
use function class_exists;
use function count;
use function explode;
use function extension_loaded;
use function implode;
use function in_array;
use function interface_exists;
use function is_array;
use function is_object;
use function md5;
use function method_exists;
use function mt_rand;
use function preg_match;
use function preg_match_all;
use function range;
use function serialize;
use function sort;
use function sprintf;
use function str_contains;
use function str_replace;
use function strlen;
use function strpos;
use function substr;
use function trait_exists;
use Exception;
use Iterator;
use IteratorAggregate;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
use PHPUnit\Framework\MockObject\DoubledCloneMethod;
use PHPUnit\Framework\MockObject\Method;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\MockObject\MockObjectApi;
use PHPUnit\Framework\MockObject\MockObjectInternal;
use PHPUnit\Framework\MockObject\ProxiedCloneMethod;
use PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\StubApi;
use PHPUnit\Framework\MockObject\StubInternal;
use ReflectionClass;
use ReflectionMethod;
use SoapClient;
use SoapFault;
use Throwable;
use Traversable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
use TemplateLoader;
/**
* @var array
*/
private const EXCLUDED_METHOD_NAMES = [
'__CLASS__' => true,
'__DIR__' => true,
'__FILE__' => true,
'__FUNCTION__' => true,
'__LINE__' => true,
'__METHOD__' => true,
'__NAMESPACE__' => true,
'__TRAIT__' => true,
'__clone' => true,
'__halt_compiler' => true,
];
/**
* @psalm-var array<non-empty-string, MockClass>
*/
private static array $cache = [];
/**
* Returns a test double for the specified class.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTypeException
*/
public function testDouble(string $type, bool $mockObject, ?array $methods = [], array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, bool $cloneArguments = true, bool $callOriginalMethods = false, ?object $proxyTarget = null, bool $allowMockingUnknownTypes = true, bool $returnValueGeneration = true): MockObject|Stub
{
if ($type === Traversable::class) {
$type = Iterator::class;
}
if (!$allowMockingUnknownTypes) {
$this->ensureKnownType($type, $callAutoload);
}
$this->ensureValidMethods($methods);
$this->ensureMockedClassDoesNotAlreadyExist($mockClassName);
if (!$callOriginalConstructor && $callOriginalMethods) {
throw new OriginalConstructorInvocationRequiredException;
}
$mock = $this->generate(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
$object = $this->getObject(
$mock,
$type,
$callOriginalConstructor,
$arguments,
$callOriginalMethods,
$proxyTarget,
$returnValueGeneration,
);
assert($object instanceof $type);
if ($mockObject) {
assert($object instanceof MockObject);
} else {
assert($object instanceof Stub);
}
return $object;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws RuntimeException
* @throws UnknownTypeException
*/
public function testDoubleForInterfaceIntersection(array $interfaces, bool $mockObject, bool $callAutoload = true): MockObject|Stub
{
if (count($interfaces) < 2) {
throw new RuntimeException('At least two interfaces must be specified');
}
foreach ($interfaces as $interface) {
if (!interface_exists($interface, $callAutoload)) {
throw new UnknownTypeException($interface);
}
}
sort($interfaces);
$methods = [];
foreach ($interfaces as $interface) {
$methods = array_merge($methods, $this->namesOfMethodsIn($interface));
}
if (count(array_unique($methods)) < count($methods)) {
throw new RuntimeException('Interfaces must not declare the same method');
}
$unqualifiedNames = [];
foreach ($interfaces as $interface) {
$parts = explode('\\', $interface);
$unqualifiedNames[] = array_pop($parts);
}
sort($unqualifiedNames);
do {
$intersectionName = sprintf(
'Intersection_%s_%s',
implode('_', $unqualifiedNames),
substr(md5((string) mt_rand()), 0, 8),
);
} while (interface_exists($intersectionName, false));
$template = $this->loadTemplate('intersection.tpl');
$template->setVar(
[
'intersection' => $intersectionName,
'interfaces' => implode(', ', $interfaces),
],
);
eval($template->render());
return $this->testDouble($intersectionName, $mockObject);
}
/**
* Returns a mock object for the specified abstract class with all abstract
* methods of the class mocked.
*
* Concrete methods to mock can be specified with the $mockedMethods parameter.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownClassException
* @throws UnknownTypeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5241
*/
public function mockObjectForAbstractClass(string $originalClassName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, ?array $mockedMethods = null, bool $cloneArguments = true): MockObject
{
if (class_exists($originalClassName, $callAutoload) ||
interface_exists($originalClassName, $callAutoload)) {
$reflector = $this->reflectClass($originalClassName);
$methods = $mockedMethods;
foreach ($reflector->getMethods() as $method) {
if ($method->isAbstract() && !in_array($method->getName(), $methods ?? [], true)) {
$methods[] = $method->getName();
}
}
if (empty($methods)) {
$methods = null;
}
$mockObject = $this->testDouble(
$originalClassName,
true,
$methods,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$cloneArguments,
);
assert($mockObject instanceof $originalClassName);
assert($mockObject instanceof MockObject);
return $mockObject;
}
throw new UnknownClassException($originalClassName);
}
/**
* Returns a mock object for the specified trait with all abstract methods
* of the trait mocked. Concrete methods to mock can be specified with the
* `$mockedMethods` parameter.
*
* @psalm-param trait-string $traitName
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownClassException
* @throws UnknownTraitException
* @throws UnknownTypeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
public function mockObjectForTrait(string $traitName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, ?array $mockedMethods = null, bool $cloneArguments = true): MockObject
{
if (!trait_exists($traitName, $callAutoload)) {
throw new UnknownTraitException($traitName);
}
$className = $this->generateClassName(
$traitName,
'',
'Trait_',
);
$classTemplate = $this->loadTemplate('trait_class.tpl');
$classTemplate->setVar(
[
'prologue' => 'abstract ',
'class_name' => $className['className'],
'trait_name' => $traitName,
],
);
$mockTrait = new MockTrait($classTemplate->render(), $className['className']);
$mockTrait->generate();
return $this->mockObjectForAbstractClass($className['className'], $arguments, $mockClassName, $callOriginalConstructor, $callOriginalClone, $callAutoload, $mockedMethods, $cloneArguments);
}
/**
* Returns an object for the specified trait.
*
* @psalm-param trait-string $traitName
*
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTraitException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5244
*/
public function objectForTrait(string $traitName, string $traitClassName = '', bool $callAutoload = true, bool $callOriginalConstructor = false, array $arguments = []): object
{
if (!trait_exists($traitName, $callAutoload)) {
throw new UnknownTraitException($traitName);
}
$className = $this->generateClassName(
$traitName,
$traitClassName,
'Trait_',
);
$classTemplate = $this->loadTemplate('trait_class.tpl');
$classTemplate->setVar(
[
'prologue' => '',
'class_name' => $className['className'],
'trait_name' => $traitName,
],
);
return $this->getObject(
new MockTrait(
$classTemplate->render(),
$className['className'],
),
'',
$callOriginalConstructor,
$arguments,
);
}
/**
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws ReflectionException
* @throws RuntimeException
*
* @todo This method is only public because it is used to test generated code in PHPT tests
*
* @see https://github.com/sebastianbergmann/phpunit/issues/5476
*/
public function generate(string $type, bool $mockObject, ?array $methods = null, string $mockClassName = '', bool $callOriginalClone = true, bool $callAutoload = true, bool $cloneArguments = true, bool $callOriginalMethods = false): MockClass
{
if ($mockClassName !== '') {
return $this->generateCodeForTestDoubleClass(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
}
$key = md5(
$type .
($mockObject ? 'MockObject' : 'TestStub') .
serialize($methods) .
serialize($callOriginalClone) .
serialize($cloneArguments) .
serialize($callOriginalMethods),
);
if (!isset(self::$cache[$key])) {
self::$cache[$key] = $this->generateCodeForTestDoubleClass(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
}
return self::$cache[$key];
}
/**
* @throws RuntimeException
* @throws SoapExtensionNotAvailableException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5242
*/
public function generateClassFromWsdl(string $wsdlFile, string $className, array $methods = [], array $options = []): string
{
if (!extension_loaded('soap')) {
throw new SoapExtensionNotAvailableException;
}
$options['cache_wsdl'] = WSDL_CACHE_NONE;
try {
$client = new SoapClient($wsdlFile, $options);
$_methods = array_unique($client->__getFunctions());
unset($client);
} catch (SoapFault $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
sort($_methods);
$methodTemplate = $this->loadTemplate('wsdl_method.tpl');
$methodsBuffer = '';
foreach ($_methods as $method) {
preg_match_all('/[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*\(/', $method, $matches, PREG_OFFSET_CAPTURE);
$lastFunction = array_pop($matches[0]);
$nameStart = $lastFunction[1];
$nameEnd = $nameStart + strlen($lastFunction[0]) - 1;
$name = str_replace('(', '', $lastFunction[0]);
if (empty($methods) || in_array($name, $methods, true)) {
$arguments = explode(
',',
str_replace(')', '', substr($method, $nameEnd + 1)),
);
foreach (range(0, count($arguments) - 1) as $i) {
$parameterStart = strpos($arguments[$i], '$');
if (!$parameterStart) {
continue;
}
$arguments[$i] = substr($arguments[$i], $parameterStart);
}
$methodTemplate->setVar(
[
'method_name' => $name,
'arguments' => implode(', ', $arguments),
],
);
$methodsBuffer .= $methodTemplate->render();
}
}
$optionsBuffer = '[';
foreach ($options as $key => $value) {
$optionsBuffer .= $key . ' => ' . $value;
}
$optionsBuffer .= ']';
$classTemplate = $this->loadTemplate('wsdl_class.tpl');
$namespace = '';
if (str_contains($className, '\\')) {
$parts = explode('\\', $className);
$className = array_pop($parts);
$namespace = 'namespace ' . implode('\\', $parts) . ';' . "\n\n";
}
$classTemplate->setVar(
[
'namespace' => $namespace,
'class_name' => $className,
'wsdl' => $wsdlFile,
'options' => $optionsBuffer,
'methods' => $methodsBuffer,
],
);
return $classTemplate->render();
}
/**
* @throws ReflectionException
*
* @psalm-return list<MockMethod>
*/
public function mockClassMethods(string $className, bool $callOriginalMethods, bool $cloneArguments): array
{
$class = $this->reflectClass($className);
$methods = [];
foreach ($class->getMethods() as $method) {
if (($method->isPublic() || $method->isAbstract()) && $this->canMethodBeDoubled($method)) {
$methods[] = MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments);
}
}
return $methods;
}
/**
* @psalm-param class-string $interfaceName
*
* @throws ReflectionException
*
* @psalm-return list<ReflectionMethod>
*/
private function userDefinedInterfaceMethods(string $interfaceName): array
{
$interface = $this->reflectClass($interfaceName);
$methods = [];
foreach ($interface->getMethods() as $method) {
if (!$method->isUserDefined()) {
continue;
}
$methods[] = $method;
}
return $methods;
}
/**
* @throws ReflectionException
* @throws RuntimeException
*/
private function getObject(MockType $mockClass, string $type = '', bool $callOriginalConstructor = false, array $arguments = [], bool $callOriginalMethods = false, ?object $proxyTarget = null, bool $returnValueGeneration = true): object
{
$className = $mockClass->generate();
$object = $this->instantiate($className, $callOriginalConstructor, $arguments);
if ($callOriginalMethods) {
$this->instantiateProxyTarget($proxyTarget, $object, $type, $arguments);
}
if ($object instanceof StubInternal) {
$object->__phpunit_setReturnValueGeneration($returnValueGeneration);
}
return $object;
}
/**
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws ReflectionException
* @throws RuntimeException
*/
private function generateCodeForTestDoubleClass(string $type, bool $mockObject, ?array $explicitMethods, string $mockClassName, bool $callOriginalClone, bool $callAutoload, bool $cloneArguments, bool $callOriginalMethods): MockClass
{
$classTemplate = $this->loadTemplate('test_double_class.tpl');
$additionalInterfaces = [];
$doubledCloneMethod = false;
$proxiedCloneMethod = false;
$isClass = false;
$isInterface = false;
$class = null;
$mockMethods = new MockMethodSet;
$testDoubleClassPrefix = $mockObject ? 'MockObject_' : 'TestStub_';
$_mockClassName = $this->generateClassName(
$type,
$mockClassName,
$testDoubleClassPrefix,
);
if (class_exists($_mockClassName['fullClassName'], $callAutoload)) {
$isClass = true;
} elseif (interface_exists($_mockClassName['fullClassName'], $callAutoload)) {
$isInterface = true;
}
if (!$isClass && !$isInterface) {
$prologue = 'class ' . $_mockClassName['originalClassName'] . "\n{\n}\n\n";
if (!empty($_mockClassName['namespaceName'])) {
$prologue = 'namespace ' . $_mockClassName['namespaceName'] .
" {\n\n" . $prologue . "}\n\n" .
"namespace {\n\n";
$epilogue = "\n\n}";
}
$doubledCloneMethod = true;
} else {
$class = $this->reflectClass($_mockClassName['fullClassName']);
if ($class->isEnum()) {
throw new ClassIsEnumerationException($_mockClassName['fullClassName']);
}
if ($class->isFinal()) {
throw new ClassIsFinalException($_mockClassName['fullClassName']);
}
if (method_exists($class, 'isReadOnly') && $class->isReadOnly()) {
throw new ClassIsReadonlyException($_mockClassName['fullClassName']);
}
// @see https://github.com/sebastianbergmann/phpunit/issues/2995
if ($isInterface && $class->implementsInterface(Throwable::class)) {
$actualClassName = Exception::class;
$additionalInterfaces[] = $class->getName();
$isInterface = false;
$class = $this->reflectClass($actualClassName);
foreach ($this->userDefinedInterfaceMethods($_mockClassName['fullClassName']) as $method) {
$methodName = $method->getName();
if ($class->hasMethod($methodName)) {
$classMethod = $class->getMethod($methodName);
if (!$this->canMethodBeDoubled($classMethod)) {
continue;
}
}
$mockMethods->addMethods(
MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments),
);
}
$_mockClassName = $this->generateClassName(
$actualClassName,
$_mockClassName['className'],
$testDoubleClassPrefix,
);
}
// @see https://github.com/sebastianbergmann/phpunit-mock-objects/issues/103
if ($isInterface && $class->implementsInterface(Traversable::class) &&
!$class->implementsInterface(Iterator::class) &&
!$class->implementsInterface(IteratorAggregate::class)) {
$additionalInterfaces[] = Iterator::class;
$mockMethods->addMethods(
...$this->mockClassMethods(Iterator::class, $callOriginalMethods, $cloneArguments),
);
}
if ($class->hasMethod('__clone')) {
$cloneMethod = $class->getMethod('__clone');
if (!$cloneMethod->isFinal()) {
if ($callOriginalClone && !$isInterface) {
$proxiedCloneMethod = true;
} else {
$doubledCloneMethod = true;
}
}
} else {
$doubledCloneMethod = true;
}
}
if ($isClass && $explicitMethods === []) {
$mockMethods->addMethods(
...$this->mockClassMethods($_mockClassName['fullClassName'], $callOriginalMethods, $cloneArguments),
);
}
if ($isInterface && ($explicitMethods === [] || $explicitMethods === null)) {
$mockMethods->addMethods(
...$this->interfaceMethods($_mockClassName['fullClassName'], $cloneArguments),
);
}
if (is_array($explicitMethods)) {
foreach ($explicitMethods as $methodName) {
if ($class !== null && $class->hasMethod($methodName)) {
$method = $class->getMethod($methodName);
if ($this->canMethodBeDoubled($method)) {
$mockMethods->addMethods(
MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments),
);
}
} else {
$mockMethods->addMethods(
MockMethod::fromName(
$_mockClassName['fullClassName'],
$methodName,
$cloneArguments,
),
);
}
}
}
$mockedMethods = '';
$configurable = [];
foreach ($mockMethods->asArray() as $mockMethod) {
$mockedMethods .= $mockMethod->generateCode();
$configurable[] = new ConfigurableMethod(
$mockMethod->methodName(),
$mockMethod->defaultParameterValues(),
$mockMethod->numberOfParameters(),
$mockMethod->returnType(),
);
}
/** @psalm-var trait-string[] $traits */
$traits = [StubApi::class];
if ($mockObject) {
$traits[] = MockObjectApi::class;
}
if (!$mockMethods->hasMethod('method') && (!isset($class) || !$class->hasMethod('method'))) {
$traits[] = Method::class;
}
if ($doubledCloneMethod) {
$traits[] = DoubledCloneMethod::class;
}
if ($proxiedCloneMethod) {
$traits[] = ProxiedCloneMethod::class;
}
$useStatements = '';
foreach ($traits as $trait) {
$useStatements .= sprintf(
' use %s;' . PHP_EOL,
$trait,
);
}
unset($traits);
$classTemplate->setVar(
[
'prologue' => $prologue ?? '',
'epilogue' => $epilogue ?? '',
'class_declaration' => $this->generateTestDoubleClassDeclaration(
$mockObject,
$_mockClassName,
$isInterface,
$additionalInterfaces,
),
'use_statements' => $useStatements,
'mock_class_name' => $_mockClassName['className'],
'mocked_methods' => $mockedMethods,
],
);
return new MockClass(
$classTemplate->render(),
$_mockClassName['className'],
$configurable,
);
}
private function generateClassName(string $type, string $className, string $prefix): array
{
if ($type[0] === '\\') {
$type = substr($type, 1);
}
$classNameParts = explode('\\', $type);
if (count($classNameParts) > 1) {
$type = array_pop($classNameParts);
$namespaceName = implode('\\', $classNameParts);
$fullClassName = $namespaceName . '\\' . $type;
} else {
$namespaceName = '';
$fullClassName = $type;
}
if ($className === '') {
do {
$className = $prefix . $type . '_' .
substr(md5((string) mt_rand()), 0, 8);
} while (class_exists($className, false));
}
return [
'className' => $className,
'originalClassName' => $type,
'fullClassName' => $fullClassName,
'namespaceName' => $namespaceName,
];
}
private function generateTestDoubleClassDeclaration(bool $mockObject, array $mockClassName, bool $isInterface, array $additionalInterfaces = []): string
{
if ($mockObject) {
$additionalInterfaces[] = MockObjectInternal::class;
} else {
$additionalInterfaces[] = StubInternal::class;
}
$buffer = 'class ';
$interfaces = implode(', ', $additionalInterfaces);
if ($isInterface) {
$buffer .= sprintf(
'%s implements %s',
$mockClassName['className'],
$interfaces,
);
if (!in_array($mockClassName['originalClassName'], $additionalInterfaces, true)) {
$buffer .= ', ';
if (!empty($mockClassName['namespaceName'])) {
$buffer .= $mockClassName['namespaceName'] . '\\';
}
$buffer .= $mockClassName['originalClassName'];
}
} else {
$buffer .= sprintf(
'%s extends %s%s implements %s',
$mockClassName['className'],
!empty($mockClassName['namespaceName']) ? $mockClassName['namespaceName'] . '\\' : '',
$mockClassName['originalClassName'],
$interfaces,
);
}
return $buffer;
}
private function canMethodBeDoubled(ReflectionMethod $method): bool
{
if ($method->isConstructor()) {
return false;
}
if ($method->isDestructor()) {
return false;
}
if ($method->isFinal()) {
return false;
}
if ($method->isPrivate()) {
return false;
}
return !$this->isMethodNameExcluded($method->getName());
}
private function isMethodNameExcluded(string $name): bool
{
return isset(self::EXCLUDED_METHOD_NAMES[$name]);
}
/**
* @throws UnknownTypeException
*/
private function ensureKnownType(string $type, bool $callAutoload): void
{
if (!class_exists($type, $callAutoload) && !interface_exists($type, $callAutoload)) {
throw new UnknownTypeException($type);
}
}
/**
* @throws DuplicateMethodException
* @throws InvalidMethodNameException
*/
private function ensureValidMethods(?array $methods): void
{
if ($methods === null) {
return;
}
foreach ($methods as $method) {
if (!preg_match('~[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*~', (string) $method)) {
throw new InvalidMethodNameException((string) $method);
}
}
if ($methods !== array_unique($methods)) {
throw new DuplicateMethodException($methods);
}
}
/**
* @throws ClassAlreadyExistsException
* @throws ReflectionException
*/
private function ensureMockedClassDoesNotAlreadyExist(string $mockClassName): void
{
if ($mockClassName !== '' && class_exists($mockClassName, false)) {
$reflector = $this->reflectClass($mockClassName);
if (!$reflector->implementsInterface(MockObject::class)) {
throw new ClassAlreadyExistsException($mockClassName);
}
}
}
/**
* @psalm-param class-string $className
*
* @throws ReflectionException
*/
private function instantiate(string $className, bool $callOriginalConstructor, array $arguments): object
{
if ($callOriginalConstructor) {
if (count($arguments) === 0) {
return new $className;
}
try {
return (new ReflectionClass($className))->newInstanceArgs($arguments);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
try {
return (new ReflectionClass($className))->newInstanceWithoutConstructor();
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
}
/**
* @psalm-param class-string $type
*
* @throws ReflectionException
*/
private function instantiateProxyTarget(?object $proxyTarget, object $object, string $type, array $arguments): void
{
if (!is_object($proxyTarget)) {
assert(class_exists($type));
if (count($arguments) === 0) {
$proxyTarget = new $type;
} else {
$class = new ReflectionClass($type);
try {
$proxyTarget = $class->newInstanceArgs($arguments);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
}
$object->__phpunit_setOriginalObject($proxyTarget);
}
/**
* @psalm-param class-string $className
*
* @throws ReflectionException
*/
private function reflectClass(string $className): ReflectionClass
{
try {
$class = new ReflectionClass($className);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $class;
}
/**
* @psalm-param class-string $classOrInterfaceName
*
* @psalm-return list<string>
*
* @throws ReflectionException
*/
private function namesOfMethodsIn(string $classOrInterfaceName): array
{
$class = $this->reflectClass($classOrInterfaceName);
$methods = [];
foreach ($class->getMethods() as $method) {
if ($method->isPublic() || $method->isAbstract()) {
$methods[] = $method->getName();
}
}
return $methods;
}
/**
* @psalm-param class-string $interfaceName
*
* @psalm-return list<MockMethod>
*
* @throws ReflectionException
*/
private function interfaceMethods(string $interfaceName, bool $cloneArguments): array
{
$class = $this->reflectClass($interfaceName);
$methods = [];
foreach ($class->getMethods() as $method) {
$methods[] = MockMethod::fromReflection($method, false, $cloneArguments);
}
return $methods;
}
}
phpunit/src/Framework/MockObject/Generator/MockType.php 0000644 00000001002 15243417753 0017175 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface MockType
{
/**
* @psalm-return class-string
*/
public function generate(): string;
}
phpunit/src/Framework/MockObject/Generator/Exception/ClassIsReadonlyException.php 0000644 00000001375 15243417753 0024333 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsReadonlyException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is declared "readonly" and cannot be doubled',
$className,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/ClassAlreadyExistsException.php 0000644 00000001342 15243417753 0025035 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassAlreadyExistsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" already exists',
$className,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/UnknownTraitException.php 0000644 00000001447 15243417753 0023737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
final class UnknownTraitException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $traitName)
{
parent::__construct(
sprintf(
'Trait "%s" does not exist',
$traitName,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/UnknownTypeException.php 0000644 00000001336 15243417753 0023572 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownTypeException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type)
{
parent::__construct(
sprintf(
'Class or interface "%s" does not exist',
$type,
),
);
}
}
src/Framework/MockObject/Generator/Exception/OriginalConstructorInvocationRequiredException.php 0000644 00000001240 15243417753 0030751 0 ustar 00 phpunit <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class OriginalConstructorInvocationRequiredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Proxying to original methods requires invoking the original constructor');
}
}
phpunit/src/Framework/MockObject/Generator/Exception/UnknownClassException.php 0000644 00000001334 15243417753 0023714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownClassException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" does not exist',
$className,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/DuplicateMethodException.php 0000644 00000002015 15243417753 0024337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function array_diff_assoc;
use function array_unique;
use function implode;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DuplicateMethodException extends \PHPUnit\Framework\Exception implements Exception
{
/**
* @psalm-param list<string> $methods
*/
public function __construct(array $methods)
{
parent::__construct(
sprintf(
'Cannot double using a method list that contains duplicates: "%s" (duplicate: "%s")',
implode(', ', $methods),
implode(', ', array_unique(array_diff_assoc($methods, array_unique($methods)))),
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/Exception.php 0000644 00000001001 15243417753 0021335 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use PHPUnit\Framework\MockObject\Exception as BaseException;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends BaseException
{
}
phpunit/src/Framework/MockObject/Generator/Exception/RuntimeException.php 0000644 00000000754 15243417753 0022717 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \PHPUnit\Framework\Exception implements Exception
{
}
phpunit/src/Framework/MockObject/Generator/Exception/ReflectionException.php 0000644 00000000757 15243417753 0023371 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends \PHPUnit\Framework\Exception implements Exception
{
}
phpunit/src/Framework/MockObject/Generator/Exception/ClassIsEnumerationException.php 0000644 00000001373 15243417753 0025042 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsEnumerationException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is an enumeration and cannot be doubled',
$className,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/SoapExtensionNotAvailableException.php 0000644 00000001246 15243417753 0026352 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SoapExtensionNotAvailableException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct(
'The SOAP extension is required to generate a test double from WSDL',
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/ClassIsFinalException.php 0000644 00000001367 15243417753 0023610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsFinalException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is declared "final" and cannot be doubled',
$className,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/Exception/InvalidMethodNameException.php 0000644 00000001355 15243417753 0024622 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidMethodNameException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $method)
{
parent::__construct(
sprintf(
'Cannot double method with invalid name "%s"',
$method,
),
);
}
}
phpunit/src/Framework/MockObject/Generator/templates/doubled_static_method.tpl 0000644 00000000356 15243417753 0024010 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{
throw new \PHPUnit\Framework\MockObject\BadMethodCallException('Static method "{method_name}" cannot be invoked on mock object');
}
phpunit/src/Framework/MockObject/Generator/templates/proxied_method.tpl 0000644 00000003232 15243417753 0022471 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{
$__phpunit_definedVariables = get_defined_vars();
$__phpunit_namedVariadicParameters = [];
foreach ($__phpunit_definedVariables as $__phpunit_definedVariableName => $__phpunit_definedVariableValue) {
if ((new ReflectionParameter([__CLASS__, __FUNCTION__], $__phpunit_definedVariableName))->isVariadic()) {
foreach ($__phpunit_definedVariableValue as $__phpunit_key => $__phpunit_namedValue) {
if (is_string($__phpunit_key)) {
$__phpunit_namedVariadicParameters[$__phpunit_key] = $__phpunit_namedValue;
}
}
}
}
$__phpunit_arguments = [{arguments_call}];
$__phpunit_count = func_num_args();
if ($__phpunit_count > {arguments_count}) {
$__phpunit_arguments_tmp = func_get_args();
for ($__phpunit_i = {arguments_count}; $__phpunit_i < $__phpunit_count; $__phpunit_i++) {
$__phpunit_arguments[] = $__phpunit_arguments_tmp[$__phpunit_i];
}
}
$__phpunit_arguments = array_merge($__phpunit_arguments, $__phpunit_namedVariadicParameters);
$this->__phpunit_getInvocationHandler()->invoke(
new \PHPUnit\Framework\MockObject\Invocation(
'{class_name}', '{method_name}', $__phpunit_arguments, '{return_type}', $this, {clone_arguments}, true
)
);
$__phpunit_result = call_user_func_array([$this->__phpunit_originalObject, "{method_name}"], $__phpunit_arguments);{return_result}
}
phpunit/src/Framework/MockObject/Generator/templates/doubled_method.tpl 0000644 00000003070 15243417753 0022435 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{{deprecation}
$__phpunit_definedVariables = get_defined_vars();
$__phpunit_namedVariadicParameters = [];
foreach ($__phpunit_definedVariables as $__phpunit_definedVariableName => $__phpunit_definedVariableValue) {
if ((new ReflectionParameter([__CLASS__, __FUNCTION__], $__phpunit_definedVariableName))->isVariadic()) {
foreach ($__phpunit_definedVariableValue as $__phpunit_key => $__phpunit_namedValue) {
if (is_string($__phpunit_key)) {
$__phpunit_namedVariadicParameters[$__phpunit_key] = $__phpunit_namedValue;
}
}
}
}
$__phpunit_arguments = [{arguments_call}];
$__phpunit_count = func_num_args();
if ($__phpunit_count > {arguments_count}) {
$__phpunit_arguments_tmp = func_get_args();
for ($__phpunit_i = {arguments_count}; $__phpunit_i < $__phpunit_count; $__phpunit_i++) {
$__phpunit_arguments[] = $__phpunit_arguments_tmp[$__phpunit_i];
}
}
$__phpunit_arguments = array_merge($__phpunit_arguments, $__phpunit_namedVariadicParameters);
$__phpunit_result = $this->__phpunit_getInvocationHandler()->invoke(
new \PHPUnit\Framework\MockObject\Invocation(
'{class_name}', '{method_name}', $__phpunit_arguments, '{return_type}', $this, {clone_arguments}
)
);{return_result}
}
phpunit/src/Framework/MockObject/Generator/templates/deprecation.tpl 0000644 00000000073 15243417753 0021754 0 ustar 00
@trigger_error({deprecation}, E_USER_DEPRECATED);
phpunit/src/Framework/MockObject/Generator/templates/intersection.tpl 0000644 00000000114 15243417753 0022161 0 ustar 00 declare(strict_types=1);
interface {intersection} extends {interfaces}
{
}
phpunit/src/Framework/MockObject/Generator/templates/test_double_class.tpl 0000644 00000000146 15243417753 0023156 0 ustar 00 declare(strict_types=1);
{prologue}{class_declaration}
{
{use_statements}{mocked_methods}}{epilogue}
phpunit/src/Framework/MockObject/Generator/templates/wsdl_class.tpl 0000644 00000000315 15243417753 0021614 0 ustar 00 declare(strict_types=1);
{namespace}class {class_name} extends \SoapClient
{
public function __construct($wsdl, array $options)
{
parent::__construct('{wsdl}', $options);
}
{methods}}
phpunit/src/Framework/MockObject/Generator/templates/trait_class.tpl 0000644 00000000121 15243417753 0021761 0 ustar 00 declare(strict_types=1);
{prologue}class {class_name}
{
use {trait_name};
}
phpunit/src/Framework/MockObject/Generator/templates/wsdl_method.tpl 0000644 00000000074 15243417753 0021771 0 ustar 00
public function {method_name}({arguments})
{
}
phpunit/src/Framework/MockObject/Generator/MockMethodSet.php 0000644 00000002110 15243417753 0020151 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function array_key_exists;
use function array_values;
use function strtolower;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockMethodSet
{
/**
* @psalm-var array<string,MockMethod>
*/
private array $methods = [];
public function addMethods(MockMethod ...$methods): void
{
foreach ($methods as $method) {
$this->methods[strtolower($method->methodName())] = $method;
}
}
/**
* @psalm-return list<MockMethod>
*/
public function asArray(): array
{
return array_values($this->methods);
}
public function hasMethod(string $methodName): bool
{
return array_key_exists(strtolower($methodName), $this->methods);
}
}
phpunit/src/Framework/MockObject/Generator/TemplateLoader.php 0000644 00000001646 15243417753 0020362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use SebastianBergmann\Template\Template;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait TemplateLoader
{
/**
* @psalm-var array<string,Template>
*/
private static array $templates = [];
/**
* @psalm-suppress MissingThrowsDocblock
*/
private function loadTemplate(string $template): Template
{
$filename = __DIR__ . '/templates/' . $template;
if (!isset(self::$templates[$filename])) {
self::$templates[$filename] = new Template($filename);
}
return self::$templates[$filename];
}
}
phpunit/src/Framework/MockObject/Generator/MockTrait.php 0000644 00000002151 15243417753 0017345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function class_exists;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
final class MockTrait implements MockType
{
private readonly string $classCode;
/**
* @psalm-var class-string
*/
private readonly string $mockName;
/**
* @psalm-param class-string $mockName
*/
public function __construct(string $classCode, string $mockName)
{
$this->classCode = $classCode;
$this->mockName = $mockName;
}
/**
* @psalm-return class-string
*/
public function generate(): string
{
if (!class_exists($this->mockName, false)) {
eval($this->classCode);
}
return $this->mockName;
}
}
phpunit/src/Framework/DataProviderTestSuite.php 0000644 00000003635 15243417753 0015750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function explode;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Api\Groups;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderTestSuite extends TestSuite
{
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $dependencies = [];
private ?array $providedTests = null;
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*/
public function setDependencies(array $dependencies): void
{
$this->dependencies = $dependencies;
foreach ($this->tests() as $test) {
if (!$test instanceof TestCase) {
continue;
}
$test->setDependencies($dependencies);
}
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
if ($this->providedTests === null) {
$this->providedTests = [new ExecutionOrderDependency($this->name())];
}
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
// A DataProviderTestSuite does not have to traverse its child tests
// as these are inherited and cannot reference dataProvider rows directly
return $this->dependencies;
}
/**
* Returns the size of each test created using the data provider(s).
*/
public function size(): TestSize
{
[$className, $methodName] = explode('::', $this->name());
return (new Groups)->size($className, $methodName);
}
}
phpunit/src/Exception.php 0000644 00000000513 15243417753 0011503 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit;
use Throwable;
interface Exception extends Throwable
{
}
phpunit/src/Runner/Filter/Factory.php 0000644 00000003726 15243417753 0013663 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function assert;
use FilterIterator;
use Iterator;
use PHPUnit\Framework\TestSuite;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Factory
{
/**
* @psalm-var array<int,array{0: ReflectionClass, 1: array|string}>
*/
private array $filters = [];
/**
* @psalm-param list<non-empty-string> $testIds
*/
public function addTestIdFilter(array $testIds): void
{
$this->filters[] = [
new ReflectionClass(TestIdFilterIterator::class), $testIds,
];
}
/**
* @psalm-param list<non-empty-string> $groups
*/
public function addExcludeGroupFilter(array $groups): void
{
$this->filters[] = [
new ReflectionClass(ExcludeGroupFilterIterator::class), $groups,
];
}
/**
* @psalm-param list<non-empty-string> $groups
*/
public function addIncludeGroupFilter(array $groups): void
{
$this->filters[] = [
new ReflectionClass(IncludeGroupFilterIterator::class), $groups,
];
}
/**
* @psalm-param non-empty-string $name
*/
public function addNameFilter(string $name): void
{
$this->filters[] = [
new ReflectionClass(NameFilterIterator::class), $name,
];
}
public function factory(Iterator $iterator, TestSuite $suite): FilterIterator
{
foreach ($this->filters as $filter) {
[$class, $arguments] = $filter;
$iterator = $class->newInstance($iterator, $arguments, $suite);
}
assert($iterator instanceof FilterIterator);
return $iterator;
}
}
phpunit/src/Runner/Filter/GroupFilterIterator.php 0000644 00000003166 15243417753 0016226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function array_map;
use function array_push;
use function in_array;
use function spl_object_id;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestSuite;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class GroupFilterIterator extends RecursiveFilterIterator
{
/**
* @psalm-var list<int>
*/
protected array $groupTests = [];
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param list<non-empty-string> $groups
*/
public function __construct(RecursiveIterator $iterator, array $groups, TestSuite $suite)
{
parent::__construct($iterator);
foreach ($suite->groupDetails() as $group => $tests) {
if (in_array((string) $group, $groups, true)) {
$testHashes = array_map(
'spl_object_id',
$tests,
);
array_push($this->groupTests, ...$testHashes);
}
}
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
return $this->doAccept(spl_object_id($test));
}
abstract protected function doAccept(int $id): bool;
}
phpunit/src/Runner/Filter/IncludeGroupFilterIterator.php 0000644 00000001121 15243417753 0017517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncludeGroupFilterIterator extends GroupFilterIterator
{
protected function doAccept(int $id): bool
{
return in_array($id, $this->groupTests, true);
}
}
phpunit/src/Runner/Filter/NameFilterIterator.php 0000644 00000007427 15243417753 0016016 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function end;
use function implode;
use function preg_match;
use function sprintf;
use function str_replace;
use Exception;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NameFilterIterator extends RecursiveFilterIterator
{
private ?string $filter = null;
private ?int $filterMin = null;
private ?int $filterMax = null;
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param non-empty-string $filter
*
* @throws Exception
*/
public function __construct(RecursiveIterator $iterator, string $filter)
{
parent::__construct($iterator);
$this->setFilter($filter);
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
$tmp = $this->describe($test);
if ($tmp[0] !== '') {
$name = implode('::', $tmp);
} else {
$name = $tmp[1];
}
$accepted = @preg_match($this->filter, $name, $matches);
if ($accepted && isset($this->filterMax)) {
$set = end($matches);
$accepted = $set >= $this->filterMin && $set <= $this->filterMax;
}
return (bool) $accepted;
}
/**
* @throws Exception
*/
private function setFilter(string $filter): void
{
if (@preg_match($filter, '') === false) {
// Handles:
// * testAssertEqualsSucceeds#4
// * testAssertEqualsSucceeds#4-8
if (preg_match('/^(.*?)#(\d+)(?:-(\d+))?$/', $filter, $matches)) {
if (isset($matches[3]) && $matches[2] < $matches[3]) {
$filter = sprintf(
'%s.*with data set #(\d+)$',
$matches[1],
);
$this->filterMin = (int) $matches[2];
$this->filterMax = (int) $matches[3];
} else {
$filter = sprintf(
'%s.*with data set #%s$',
$matches[1],
$matches[2],
);
}
} // Handles:
// * testDetermineJsonError@JSON_ERROR_NONE
// * testDetermineJsonError@JSON.*
elseif (preg_match('/^(.*?)@(.+)$/', $filter, $matches)) {
$filter = sprintf(
'%s.*with data set "%s"$',
$matches[1],
$matches[2],
);
}
// Escape delimiters in regular expression. Do NOT use preg_quote,
// to keep magic characters.
$filter = sprintf(
'/%s/i',
str_replace(
'/',
'\\/',
$filter,
),
);
}
$this->filter = $filter;
}
/**
* @psalm-return array{0: string, 1: string}
*/
private function describe(Test $test): array
{
if ($test instanceof TestCase) {
return [$test::class, $test->nameWithDataSet()];
}
if ($test instanceof SelfDescribing) {
return ['', $test->toString()];
}
return ['', $test::class];
}
}
phpunit/src/Runner/Filter/TestIdFilterIterator.php 0000644 00000003300 15243417753 0016314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\NoDataSetFromDataProviderException;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestIdFilterIterator extends RecursiveFilterIterator
{
/**
* @psalm-var non-empty-list<non-empty-string>
*/
private readonly array $testIds;
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param non-empty-list<non-empty-string> $testIds
*/
public function __construct(RecursiveIterator $iterator, array $testIds)
{
parent::__construct($iterator);
$this->testIds = $testIds;
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
if (!$test instanceof TestCase && !$test instanceof PhptTestCase) {
return false;
}
try {
return in_array($test->valueObjectForEvents()->id(), $this->testIds, true);
} catch (MoreThanOneDataSetFromDataProviderException|NoDataSetFromDataProviderException) {
return false;
}
}
}
phpunit/src/Runner/Filter/ExcludeGroupFilterIterator.php 0000644 00000001122 15243417753 0017526 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeGroupFilterIterator extends GroupFilterIterator
{
protected function doAccept(int $id): bool
{
return !in_array($id, $this->groupTests, true);
}
}
phpunit/src/Runner/GarbageCollection/GarbageCollectionHandler.php 0000644 00000004244 15243417753 0021231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use function gc_collect_cycles;
use function gc_disable;
use function gc_enable;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\UnknownSubscriberTypeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionHandler
{
private readonly Facade $facade;
private readonly int $threshold;
private int $tests = 0;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, int $threshold)
{
$this->facade = $facade;
$this->threshold = $threshold;
$this->registerSubscribers();
}
public function executionStarted(): void
{
gc_disable();
$this->facade->emitter()->testRunnerDisabledGarbageCollection();
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
}
public function executionFinished(): void
{
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
gc_enable();
$this->facade->emitter()->testRunnerEnabledGarbageCollection();
}
public function testFinished(): void
{
$this->tests++;
if ($this->tests === $this->threshold) {
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
$this->tests = 0;
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(): void
{
$this->facade->registerSubscribers(
new ExecutionStartedSubscriber($this),
new ExecutionFinishedSubscriber($this),
new TestFinishedSubscriber($this),
);
}
}
phpunit/src/Runner/GarbageCollection/Subscriber/ExecutionStartedSubscriber.php 0000644 00000001635 15243417753 0024011 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber as TestRunnerExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStartedSubscriber extends Subscriber implements TestRunnerExecutionStartedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(ExecutionStarted $event): void
{
$this->handler()->executionStarted();
}
}
phpunit/src/Runner/GarbageCollection/Subscriber/TestFinishedSubscriber.php 0000644 00000001467 15243417753 0023113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->handler()->testFinished();
}
}
phpunit/src/Runner/GarbageCollection/Subscriber/Subscriber.php 0000644 00000001273 15243417753 0020574 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly GarbageCollectionHandler $handler;
public function __construct(GarbageCollectionHandler $handler)
{
$this->handler = $handler;
}
protected function handler(): GarbageCollectionHandler
{
return $this->handler;
}
}
phpunit/src/Runner/GarbageCollection/Subscriber/ExecutionFinishedSubscriber.php 0000644 00000001644 15243417753 0024134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber as TestRunnerExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionFinishedSubscriber extends Subscriber implements TestRunnerExecutionFinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(ExecutionFinished $event): void
{
$this->handler()->executionFinished();
}
}
phpunit/src/Runner/ErrorHandler.php 0000644 00000014065 15243417753 0013414 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use const E_COMPILE_ERROR;
use const E_COMPILE_WARNING;
use const E_CORE_ERROR;
use const E_CORE_WARNING;
use const E_DEPRECATED;
use const E_ERROR;
use const E_NOTICE;
use const E_PARSE;
use const E_RECOVERABLE_ERROR;
use const E_STRICT;
use const E_USER_DEPRECATED;
use const E_USER_ERROR;
use const E_USER_NOTICE;
use const E_USER_WARNING;
use const E_WARNING;
use function error_reporting;
use function restore_error_handler;
use function set_error_handler;
use PHPUnit\Event;
use PHPUnit\Event\Code\NoTestCaseObjectOnCallStackException;
use PHPUnit\Runner\Baseline\Baseline;
use PHPUnit\Runner\Baseline\Issue;
use PHPUnit\Util\ExcludeList;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorHandler
{
private const UNHANDLEABLE_LEVELS = E_ERROR | E_PARSE | E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_COMPILE_WARNING;
private const INSUPPRESSIBLE_LEVELS = E_ERROR | E_PARSE | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR;
private static ?self $instance = null;
private ?Baseline $baseline = null;
private bool $enabled = false;
private ?int $originalErrorReportingLevel = null;
public static function instance(): self
{
return self::$instance ?? self::$instance = new self;
}
/**
* @throws NoTestCaseObjectOnCallStackException
*/
public function __invoke(int $errorNumber, string $errorString, string $errorFile, int $errorLine): bool
{
$suppressed = (error_reporting() & ~self::INSUPPRESSIBLE_LEVELS) === 0;
if ($suppressed && (new ExcludeList)->isExcluded($errorFile)) {
return false;
}
$test = Event\Code\TestMethodBuilder::fromCallStack();
$ignoredByBaseline = $this->ignoredByBaseline($errorFile, $errorLine, $errorString);
$ignoredByTest = $test->metadata()->isIgnoreDeprecations()->isNotEmpty();
switch ($errorNumber) {
case E_NOTICE:
case E_STRICT:
Event\Facade::emitter()->testTriggeredPhpNotice(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_USER_NOTICE:
Event\Facade::emitter()->testTriggeredNotice(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_WARNING:
Event\Facade::emitter()->testTriggeredPhpWarning(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_USER_WARNING:
Event\Facade::emitter()->testTriggeredWarning(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_DEPRECATED:
Event\Facade::emitter()->testTriggeredPhpDeprecation(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
);
break;
case E_USER_DEPRECATED:
Event\Facade::emitter()->testTriggeredDeprecation(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
);
break;
case E_USER_ERROR:
Event\Facade::emitter()->testTriggeredError(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
);
throw new ErrorException('E_USER_ERROR was triggered');
default:
return false;
}
return false;
}
public function enable(): void
{
if ($this->enabled) {
return;
}
$oldErrorHandler = set_error_handler($this);
if ($oldErrorHandler !== null) {
restore_error_handler();
return;
}
$this->enabled = true;
$this->originalErrorReportingLevel = error_reporting();
error_reporting($this->originalErrorReportingLevel & self::UNHANDLEABLE_LEVELS);
}
public function disable(): void
{
if (!$this->enabled) {
return;
}
restore_error_handler();
error_reporting(error_reporting() | $this->originalErrorReportingLevel);
$this->enabled = false;
$this->originalErrorReportingLevel = null;
}
public function use(Baseline $baseline): void
{
$this->baseline = $baseline;
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
private function ignoredByBaseline(string $file, int $line, string $description): bool
{
if ($this->baseline === null) {
return false;
}
return $this->baseline->has(Issue::from($file, $line, null, $description));
}
}
phpunit/src/Runner/Extension/PharLoader.php 0000644 00000010752 15243417753 0015021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function count;
use function explode;
use function extension_loaded;
use function implode;
use function is_file;
use function sprintf;
use function str_contains;
use PharIo\Manifest\ApplicationName;
use PharIo\Manifest\Exception as ManifestException;
use PharIo\Manifest\ManifestLoader;
use PharIo\Version\Version as PharIoVersion;
use PHPUnit\Event;
use PHPUnit\Runner\Version;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PharLoader
{
/**
* @psalm-param non-empty-string $directory
*
* @psalm-return list<string>
*/
public function loadPharExtensionsInDirectory(string $directory): array
{
$pharExtensionLoaded = extension_loaded('phar');
$loadedExtensions = [];
foreach ((new FileIteratorFacade)->getFilesAsArray($directory, '.phar') as $file) {
if (!$pharExtensionLoaded) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s because the PHAR extension is not available',
$file,
),
);
continue;
}
if (!is_file('phar://' . $file . '/manifest.xml')) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not an extension for PHPUnit',
$file,
),
);
continue;
}
try {
$applicationName = new ApplicationName('phpunit/phpunit');
$version = new PharIoVersion($this->phpunitVersion());
$manifest = ManifestLoader::fromFile('phar://' . $file . '/manifest.xml');
if (!$manifest->isExtensionFor($applicationName)) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not an extension for PHPUnit',
$file,
),
);
continue;
}
if (!$manifest->isExtensionFor($applicationName, $version)) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not compatible with PHPUnit %s',
$file,
Version::series(),
),
);
continue;
}
} catch (ManifestException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s: %s',
$file,
$e->getMessage(),
),
);
continue;
}
try {
/** @psalm-suppress UnresolvableInclude */
@require $file;
} catch (Throwable $t) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s: %s',
$file,
$t->getMessage(),
),
);
continue;
}
$loadedExtensions[] = $manifest->getName()->asString() . ' ' . $manifest->getVersion()->getVersionString();
Event\Facade::emitter()->testRunnerLoadedExtensionFromPhar(
$file,
$manifest->getName()->asString(),
$manifest->getVersion()->getVersionString(),
);
}
return $loadedExtensions;
}
private function phpunitVersion(): string
{
$version = Version::id();
if (!str_contains($version, '-')) {
return $version;
}
$parts = explode('.', explode('-', $version)[0]);
if (count($parts) === 2) {
$parts[] = 0;
}
return implode('.', $parts);
}
}
phpunit/src/Runner/Extension/ParameterCollection.php 0000644 00000002352 15243417753 0016731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function array_key_exists;
use PHPUnit\Runner\ParameterDoesNotExistException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ParameterCollection
{
private readonly array $parameters;
/**
* @psalm-param array<string, string> $parameters
*/
public static function fromArray(array $parameters): self
{
return new self($parameters);
}
private function __construct(array $parameters)
{
$this->parameters = $parameters;
}
public function has(string $name): bool
{
return array_key_exists($name, $this->parameters);
}
/**
* @throws ParameterDoesNotExistException
*/
public function get(string $name): string
{
if (!$this->has($name)) {
throw new ParameterDoesNotExistException($name);
}
return $this->parameters[$name];
}
}
phpunit/src/Runner/Extension/Facade.php 0000644 00000005424 15243417753 0014143 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\Subscriber;
use PHPUnit\Event\Tracer\Tracer;
use PHPUnit\Event\UnknownSubscriberTypeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private bool $replacesOutput = false;
private bool $replacesProgressOutput = false;
private bool $replacesResultOutput = false;
private bool $requiresCodeCoverageCollection = false;
private bool $requiresExportOfObjects = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscribers(Subscriber ...$subscribers): void
{
EventFacade::instance()->registerSubscribers(...$subscribers);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
EventFacade::instance()->registerSubscriber($subscriber);
}
/**
* @throws EventFacadeIsSealedException
*/
public function registerTracer(Tracer $tracer): void
{
EventFacade::instance()->registerTracer($tracer);
}
public function replaceOutput(): void
{
$this->replacesOutput = true;
}
public function replacesOutput(): bool
{
return $this->replacesOutput;
}
public function replaceProgressOutput(): void
{
$this->replacesProgressOutput = true;
}
public function replacesProgressOutput(): bool
{
return $this->replacesOutput || $this->replacesProgressOutput;
}
public function replaceResultOutput(): void
{
$this->replacesResultOutput = true;
}
public function replacesResultOutput(): bool
{
return $this->replacesOutput || $this->replacesResultOutput;
}
public function requireCodeCoverageCollection(): void
{
$this->requiresCodeCoverageCollection = true;
}
public function requiresCodeCoverageCollection(): bool
{
return $this->requiresCodeCoverageCollection;
}
/**
* @deprecated
*/
public function requireExportOfObjects(): void
{
$this->requiresExportOfObjects = true;
}
/**
* @deprecated
*/
public function requiresExportOfObjects(): bool
{
return $this->requiresExportOfObjects;
}
}
phpunit/src/Runner/Extension/ExtensionBootstrapper.php 0000644 00000005214 15243417753 0017356 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function assert;
use function class_exists;
use function class_implements;
use function in_array;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\TextUI\Configuration\Configuration;
use ReflectionClass;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionBootstrapper
{
private readonly Configuration $configuration;
private readonly Facade $facade;
public function __construct(Configuration $configuration, Facade $facade)
{
$this->configuration = $configuration;
$this->facade = $facade;
}
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function bootstrap(string $className, array $parameters): void
{
if (!class_exists($className)) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot bootstrap extension because class %s does not exist',
$className,
),
);
return;
}
if (!in_array(Extension::class, class_implements($className), true)) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot bootstrap extension because class %s does not implement interface %s',
$className,
Extension::class,
),
);
return;
}
try {
$instance = (new ReflectionClass($className))->newInstance();
assert($instance instanceof Extension);
$instance->bootstrap(
$this->configuration,
$this->facade,
ParameterCollection::fromArray($parameters),
);
} catch (Throwable $t) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Bootstrapping of extension %s failed: %s%s%s',
$className,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
),
);
return;
}
EventFacade::emitter()->testRunnerBootstrappedExtension(
$className,
$parameters,
);
}
}
phpunit/src/Runner/Extension/Extension.php 0000644 00000001120 15243417753 0014741 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Extension
{
public function bootstrap(Configuration $configuration, Facade $facade, ParameterCollection $parameters): void;
}
phpunit/src/Runner/PhptTestCase.php 0000644 00000056220 15243417753 0013373 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use const DEBUG_BACKTRACE_IGNORE_ARGS;
use const DIRECTORY_SEPARATOR;
use function array_merge;
use function basename;
use function debug_backtrace;
use function defined;
use function dirname;
use function explode;
use function extension_loaded;
use function file;
use function file_get_contents;
use function file_put_contents;
use function is_array;
use function is_file;
use function is_readable;
use function is_string;
use function ltrim;
use function preg_match;
use function preg_replace;
use function preg_split;
use function realpath;
use function rtrim;
use function str_contains;
use function str_replace;
use function str_starts_with;
use function strncasecmp;
use function substr;
use function trim;
use function unlink;
use function unserialize;
use function var_export;
use PHPUnit\Event\Code\Phpt;
use PHPUnit\Event\Code\ThrowableBuilder;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Framework\Assert;
use PHPUnit\Framework\AssertionFailedError;
use PHPUnit\Framework\ExecutionOrderDependency;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\IncompleteTestError;
use PHPUnit\Framework\PhptAssertionFailedError;
use PHPUnit\Framework\Reorderable;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Framework\Test;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\PHP\AbstractPhpProcess;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\ReflectionException;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
use SebastianBergmann\CodeCoverage\Test\TestStatus\TestStatus;
use SebastianBergmann\CodeCoverage\TestIdMissingException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Template\Template;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptTestCase implements Reorderable, SelfDescribing, Test
{
/**
* @psalm-var non-empty-string
*/
private readonly string $filename;
private readonly AbstractPhpProcess $phpUtil;
private string $output = '';
/**
* Constructs a test case with the given filename.
*
* @psalm-param non-empty-string $filename
*
* @throws Exception
*/
public function __construct(string $filename, ?AbstractPhpProcess $phpUtil = null)
{
if (!is_file($filename)) {
throw new FileDoesNotExistException($filename);
}
$this->filename = $filename;
$this->phpUtil = $phpUtil ?: AbstractPhpProcess::factory();
}
/**
* Counts the number of test cases executed by run(TestResult result).
*/
public function count(): int
{
return 1;
}
/**
* Runs a test and collects its result in a TestResult instance.
*
* @throws \PHPUnit\Framework\Exception
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws Exception
* @throws InvalidArgumentException
* @throws NoPreviousThrowableException
* @throws ReflectionException
* @throws StaticAnalysisCacheNotConfiguredException
* @throws TestIdMissingException
* @throws UnintentionallyCoveredCodeException
*
* @noinspection RepetitiveMethodCallsInspection
*/
public function run(): void
{
$emitter = EventFacade::emitter();
$emitter->testPreparationStarted(
$this->valueObjectForEvents(),
);
try {
$sections = $this->parse();
} catch (Exception $e) {
$emitter->testPrepared($this->valueObjectForEvents());
$emitter->testErrored($this->valueObjectForEvents(), ThrowableBuilder::from($e));
$emitter->testFinished($this->valueObjectForEvents(), 0);
return;
}
$code = $this->render($sections['FILE']);
$xfail = false;
$settings = $this->parseIniSection($this->settings(CodeCoverage::instance()->isActive()));
$emitter->testPrepared($this->valueObjectForEvents());
if (isset($sections['INI'])) {
$settings = $this->parseIniSection($sections['INI'], $settings);
}
if (isset($sections['ENV'])) {
$env = $this->parseEnvSection($sections['ENV']);
$this->phpUtil->setEnv($env);
}
$this->phpUtil->setUseStderrRedirection(true);
if ($this->shouldTestBeSkipped($sections, $settings)) {
return;
}
if (isset($sections['XFAIL'])) {
$xfail = trim($sections['XFAIL']);
}
if (isset($sections['STDIN'])) {
$this->phpUtil->setStdin($sections['STDIN']);
}
if (isset($sections['ARGS'])) {
$this->phpUtil->setArgs($sections['ARGS']);
}
if (CodeCoverage::instance()->isActive()) {
$codeCoverageCacheDirectory = null;
if (CodeCoverage::instance()->codeCoverage()->cachesStaticAnalysis()) {
$codeCoverageCacheDirectory = CodeCoverage::instance()->codeCoverage()->cacheDirectory();
}
$this->renderForCoverage(
$code,
CodeCoverage::instance()->codeCoverage()->collectsBranchAndPathCoverage(),
$codeCoverageCacheDirectory,
);
}
$jobResult = $this->phpUtil->runJob($code, $this->stringifyIni($settings));
$this->output = $jobResult['stdout'] ?? '';
if (CodeCoverage::instance()->isActive()) {
$coverage = $this->cleanupForCoverage();
CodeCoverage::instance()->codeCoverage()->start($this->filename, TestSize::large());
CodeCoverage::instance()->codeCoverage()->append(
$coverage,
$this->filename,
true,
TestStatus::unknown(),
);
}
try {
$this->assertPhptExpectation($sections, $this->output);
} catch (AssertionFailedError $e) {
$failure = $e;
if ($xfail !== false) {
$failure = new IncompleteTestError($xfail, 0, $e);
} elseif ($e instanceof ExpectationFailedException) {
$comparisonFailure = $e->getComparisonFailure();
if ($comparisonFailure) {
$diff = $comparisonFailure->getDiff();
} else {
$diff = $e->getMessage();
}
$hint = $this->getLocationHintFromDiff($diff, $sections);
$trace = array_merge($hint, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS));
$failure = new PhptAssertionFailedError(
$e->getMessage(),
0,
(string) $trace[0]['file'],
(int) $trace[0]['line'],
$trace,
$comparisonFailure ? $diff : '',
);
}
if ($failure instanceof IncompleteTestError) {
$emitter->testMarkedAsIncomplete($this->valueObjectForEvents(), ThrowableBuilder::from($failure));
} else {
$emitter->testFailed($this->valueObjectForEvents(), ThrowableBuilder::from($failure), null);
}
} catch (Throwable $t) {
$emitter->testErrored($this->valueObjectForEvents(), ThrowableBuilder::from($t));
}
$this->runClean($sections, CodeCoverage::instance()->isActive());
$emitter->testFinished($this->valueObjectForEvents(), 1);
}
/**
* Returns the name of the test case.
*/
public function getName(): string
{
return $this->toString();
}
/**
* Returns a string representation of the test case.
*/
public function toString(): string
{
return $this->filename;
}
public function usesDataProvider(): bool
{
return false;
}
public function numberOfAssertionsPerformed(): int
{
return 1;
}
public function output(): string
{
return $this->output;
}
public function hasOutput(): bool
{
return !empty($this->output);
}
public function sortId(): string
{
return $this->filename;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
return [];
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
return [];
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function valueObjectForEvents(): Phpt
{
return new Phpt($this->filename);
}
/**
* Parse --INI-- section key value pairs and return as array.
*/
private function parseIniSection(array|string $content, array $ini = []): array
{
if (is_string($content)) {
$content = explode("\n", trim($content));
}
foreach ($content as $setting) {
if (!str_contains($setting, '=')) {
continue;
}
$setting = explode('=', $setting, 2);
$name = trim($setting[0]);
$value = trim($setting[1]);
if ($name === 'extension' || $name === 'zend_extension') {
if (!isset($ini[$name])) {
$ini[$name] = [];
}
$ini[$name][] = $value;
continue;
}
$ini[$name] = $value;
}
return $ini;
}
private function parseEnvSection(string $content): array
{
$env = [];
foreach (explode("\n", trim($content)) as $e) {
$e = explode('=', trim($e), 2);
if (!empty($e[0]) && isset($e[1])) {
$env[$e[0]] = $e[1];
}
}
return $env;
}
/**
* @throws Exception
* @throws ExpectationFailedException
*/
private function assertPhptExpectation(array $sections, string $output): void
{
$assertions = [
'EXPECT' => 'assertEquals',
'EXPECTF' => 'assertStringMatchesFormat',
'EXPECTREGEX' => 'assertMatchesRegularExpression',
];
$actual = preg_replace('/\r\n/', "\n", trim($output));
foreach ($assertions as $sectionName => $sectionAssertion) {
if (isset($sections[$sectionName])) {
$sectionContent = preg_replace('/\r\n/', "\n", trim($sections[$sectionName]));
$expected = $sectionName === 'EXPECTREGEX' ? "/{$sectionContent}/" : $sectionContent;
Assert::$sectionAssertion($expected, $actual);
return;
}
}
throw new InvalidPhptFileException;
}
private function shouldTestBeSkipped(array $sections, array $settings): bool
{
if (!isset($sections['SKIPIF'])) {
return false;
}
$skipif = $this->render($sections['SKIPIF']);
$jobResult = $this->phpUtil->runJob($skipif, $this->stringifyIni($settings));
if (!strncasecmp('skip', ltrim($jobResult['stdout']), 4)) {
$message = '';
if (preg_match('/^\s*skip\s*(.+)\s*/i', $jobResult['stdout'], $skipMatch)) {
$message = substr($skipMatch[1], 2);
}
EventFacade::emitter()->testSkipped(
$this->valueObjectForEvents(),
$message,
);
EventFacade::emitter()->testFinished($this->valueObjectForEvents(), 0);
return true;
}
return false;
}
private function runClean(array $sections, bool $collectCoverage): void
{
$this->phpUtil->setStdin('');
$this->phpUtil->setArgs('');
if (isset($sections['CLEAN'])) {
$cleanCode = $this->render($sections['CLEAN']);
$this->phpUtil->runJob($cleanCode, $this->settings($collectCoverage));
}
}
/**
* @throws Exception
*/
private function parse(): array
{
$sections = [];
$section = '';
$unsupportedSections = [
'CGI',
'COOKIE',
'DEFLATE_POST',
'EXPECTHEADERS',
'EXTENSIONS',
'GET',
'GZIP_POST',
'HEADERS',
'PHPDBG',
'POST',
'POST_RAW',
'PUT',
'REDIRECTTEST',
'REQUEST',
];
$lineNr = 0;
foreach (file($this->filename) as $line) {
$lineNr++;
if (preg_match('/^--([_A-Z]+)--/', $line, $result)) {
$section = $result[1];
$sections[$section] = '';
$sections[$section . '_offset'] = $lineNr;
continue;
}
if (empty($section)) {
throw new InvalidPhptFileException;
}
$sections[$section] .= $line;
}
if (isset($sections['FILEEOF'])) {
$sections['FILE'] = rtrim($sections['FILEEOF'], "\r\n");
unset($sections['FILEEOF']);
}
$this->parseExternal($sections);
if (!$this->validate($sections)) {
throw new InvalidPhptFileException;
}
foreach ($unsupportedSections as $section) {
if (isset($sections[$section])) {
throw new UnsupportedPhptSectionException($section);
}
}
return $sections;
}
/**
* @throws Exception
*/
private function parseExternal(array &$sections): void
{
$allowSections = [
'FILE',
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
];
$testDirectory = dirname($this->filename) . DIRECTORY_SEPARATOR;
foreach ($allowSections as $section) {
if (isset($sections[$section . '_EXTERNAL'])) {
$externalFilename = trim($sections[$section . '_EXTERNAL']);
if (!is_file($testDirectory . $externalFilename) ||
!is_readable($testDirectory . $externalFilename)) {
throw new PhptExternalFileCannotBeLoadedException(
$section,
$testDirectory . $externalFilename,
);
}
$sections[$section] = file_get_contents($testDirectory . $externalFilename);
}
}
}
private function validate(array $sections): bool
{
$requiredSections = [
'FILE',
[
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
],
];
foreach ($requiredSections as $section) {
if (is_array($section)) {
$foundSection = false;
foreach ($section as $anySection) {
if (isset($sections[$anySection])) {
$foundSection = true;
break;
}
}
if (!$foundSection) {
return false;
}
continue;
}
if (!isset($sections[$section])) {
return false;
}
}
return true;
}
private function render(string $code): string
{
return str_replace(
[
'__DIR__',
'__FILE__',
],
[
"'" . dirname($this->filename) . "'",
"'" . $this->filename . "'",
],
$code,
);
}
private function getCoverageFiles(): array
{
$baseDir = dirname(realpath($this->filename)) . DIRECTORY_SEPARATOR;
$basename = basename($this->filename, 'phpt');
return [
'coverage' => $baseDir . $basename . 'coverage',
'job' => $baseDir . $basename . 'php',
];
}
/**
* @throws \SebastianBergmann\Template\InvalidArgumentException
*/
private function renderForCoverage(string &$job, bool $pathCoverage, ?string $codeCoverageCacheDirectory): void
{
$files = $this->getCoverageFiles();
$template = new Template(
__DIR__ . '/../Util/PHP/Template/PhptTestCase.tpl',
);
$composerAutoload = '\'\'';
if (defined('PHPUNIT_COMPOSER_INSTALL')) {
$composerAutoload = var_export(PHPUNIT_COMPOSER_INSTALL, true);
}
$phar = '\'\'';
if (defined('__PHPUNIT_PHAR__')) {
$phar = var_export(__PHPUNIT_PHAR__, true);
}
if ($codeCoverageCacheDirectory === null) {
$codeCoverageCacheDirectory = 'null';
} else {
$codeCoverageCacheDirectory = "'" . $codeCoverageCacheDirectory . "'";
}
$bootstrap = '';
if (ConfigurationRegistry::get()->hasBootstrap()) {
$bootstrap = ConfigurationRegistry::get()->bootstrap();
}
$template->setVar(
[
'bootstrap' => $bootstrap,
'composerAutoload' => $composerAutoload,
'phar' => $phar,
'job' => $files['job'],
'coverageFile' => $files['coverage'],
'driverMethod' => $pathCoverage ? 'forLineAndPathCoverage' : 'forLineCoverage',
'codeCoverageCacheDirectory' => $codeCoverageCacheDirectory,
],
);
file_put_contents($files['job'], $job);
$job = $template->render();
}
private function cleanupForCoverage(): RawCodeCoverageData
{
$coverage = RawCodeCoverageData::fromXdebugWithoutPathCoverage([]);
$files = $this->getCoverageFiles();
$buffer = false;
if (is_file($files['coverage'])) {
$buffer = @file_get_contents($files['coverage']);
}
if ($buffer !== false) {
$coverage = @unserialize($buffer);
if ($coverage === false) {
$coverage = RawCodeCoverageData::fromXdebugWithoutPathCoverage([]);
}
}
foreach ($files as $file) {
@unlink($file);
}
return $coverage;
}
private function stringifyIni(array $ini): array
{
$settings = [];
foreach ($ini as $key => $value) {
if (is_array($value)) {
foreach ($value as $val) {
$settings[] = $key . '=' . $val;
}
continue;
}
$settings[] = $key . '=' . $value;
}
return $settings;
}
private function getLocationHintFromDiff(string $message, array $sections): array
{
$needle = '';
$previousLine = '';
$block = 'message';
foreach (preg_split('/\r\n|\r|\n/', $message) as $line) {
$line = trim($line);
if ($block === 'message' && $line === '--- Expected') {
$block = 'expected';
}
if ($block === 'expected' && $line === '@@ @@') {
$block = 'diff';
}
if ($block === 'diff') {
if (str_starts_with($line, '+')) {
$needle = $this->getCleanDiffLine($previousLine);
break;
}
if (str_starts_with($line, '-')) {
$needle = $this->getCleanDiffLine($line);
break;
}
}
if (!empty($line)) {
$previousLine = $line;
}
}
return $this->getLocationHint($needle, $sections);
}
private function getCleanDiffLine(string $line): string
{
if (preg_match('/^[\-+]([\'\"]?)(.*)\1$/', $line, $matches)) {
$line = $matches[2];
}
return $line;
}
private function getLocationHint(string $needle, array $sections): array
{
$needle = trim($needle);
if (empty($needle)) {
return [[
'file' => realpath($this->filename),
'line' => 1,
]];
}
$search = [
// 'FILE',
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
];
foreach ($search as $section) {
if (!isset($sections[$section])) {
continue;
}
if (isset($sections[$section . '_EXTERNAL'])) {
$externalFile = trim($sections[$section . '_EXTERNAL']);
return [
[
'file' => realpath(dirname($this->filename) . DIRECTORY_SEPARATOR . $externalFile),
'line' => 1,
],
[
'file' => realpath($this->filename),
'line' => ($sections[$section . '_EXTERNAL_offset'] ?? 0) + 1,
],
];
}
$sectionOffset = $sections[$section . '_offset'] ?? 0;
$offset = $sectionOffset + 1;
foreach (preg_split('/\r\n|\r|\n/', $sections[$section]) as $line) {
if (str_contains($line, $needle)) {
return [
[
'file' => realpath($this->filename),
'line' => $offset,
],
];
}
$offset++;
}
}
return [
[
'file' => realpath($this->filename),
'line' => 1,
],
];
}
/**
* @psalm-return list<string>
*/
private function settings(bool $collectCoverage): array
{
$settings = [
'allow_url_fopen=1',
'auto_append_file=',
'auto_prepend_file=',
'disable_functions=',
'display_errors=1',
'docref_ext=.html',
'docref_root=',
'error_append_string=',
'error_prepend_string=',
'error_reporting=-1',
'html_errors=0',
'log_errors=0',
'open_basedir=',
'output_buffering=Off',
'output_handler=',
'report_memleaks=0',
'report_zend_debug=0',
];
if (extension_loaded('pcov')) {
if ($collectCoverage) {
$settings[] = 'pcov.enabled=1';
} else {
$settings[] = 'pcov.enabled=0';
}
}
if (extension_loaded('xdebug')) {
if ($collectCoverage) {
$settings[] = 'xdebug.mode=coverage';
} else {
$settings[] = 'xdebug.mode=off';
}
}
return $settings;
}
}
phpunit/src/Runner/ResultCache/NullResultCache.php 0000644 00000001622 15243417753 0016257 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NullResultCache implements ResultCache
{
public function setStatus(string $id, TestStatus $status): void
{
}
public function status(string $id): TestStatus
{
return TestStatus::unknown();
}
public function setTime(string $id, float $time): void
{
}
public function time(string $id): float
{
return 0;
}
public function load(): void
{
}
public function persist(): void
{
}
}
phpunit/src/Runner/ResultCache/ResultCache.php 0000644 00000001373 15243417753 0015427 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface ResultCache
{
public function setStatus(string $id, TestStatus $status): void;
public function status(string $id): TestStatus;
public function setTime(string $id, float $time): void;
public function time(string $id): float;
public function load(): void;
public function persist(): void;
}
phpunit/src/Runner/ResultCache/DefaultResultCache.php 0000644 00000007161 15243417753 0016735 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use const DIRECTORY_SEPARATOR;
use function array_keys;
use function assert;
use function dirname;
use function file_get_contents;
use function file_put_contents;
use function is_array;
use function is_dir;
use function is_file;
use function json_decode;
use function json_encode;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Runner\DirectoryCannotBeCreatedException;
use PHPUnit\Runner\Exception;
use PHPUnit\Util\Filesystem;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DefaultResultCache implements ResultCache
{
/**
* @var int
*/
private const VERSION = 1;
/**
* @var string
*/
private const DEFAULT_RESULT_CACHE_FILENAME = '.phpunit.result.cache';
private readonly string $cacheFilename;
/**
* @psalm-var array<string, TestStatus>
*/
private array $defects = [];
/**
* @psalm-var array<string, float>
*/
private array $times = [];
public function __construct(?string $filepath = null)
{
if ($filepath !== null && is_dir($filepath)) {
$filepath .= DIRECTORY_SEPARATOR . self::DEFAULT_RESULT_CACHE_FILENAME;
}
$this->cacheFilename = $filepath ?? $_ENV['PHPUNIT_RESULT_CACHE'] ?? self::DEFAULT_RESULT_CACHE_FILENAME;
}
public function setStatus(string $id, TestStatus $status): void
{
if ($status->isSuccess()) {
return;
}
$this->defects[$id] = $status;
}
public function status(string $id): TestStatus
{
return $this->defects[$id] ?? TestStatus::unknown();
}
public function setTime(string $id, float $time): void
{
$this->times[$id] = $time;
}
public function time(string $id): float
{
return $this->times[$id] ?? 0.0;
}
public function load(): void
{
if (!is_file($this->cacheFilename)) {
return;
}
$contents = file_get_contents($this->cacheFilename);
if ($contents === false) {
return;
}
$data = json_decode(
$contents,
true,
);
if ($data === null) {
return;
}
if (!isset($data['version'])) {
return;
}
if ($data['version'] !== self::VERSION) {
return;
}
assert(isset($data['defects']) && is_array($data['defects']));
assert(isset($data['times']) && is_array($data['times']));
foreach (array_keys($data['defects']) as $test) {
$data['defects'][$test] = TestStatus::from($data['defects'][$test]);
}
$this->defects = $data['defects'];
$this->times = $data['times'];
}
/**
* @throws Exception
*/
public function persist(): void
{
if (!Filesystem::createDirectory(dirname($this->cacheFilename))) {
throw new DirectoryCannotBeCreatedException($this->cacheFilename);
}
$data = [
'version' => self::VERSION,
'defects' => [],
'times' => $this->times,
];
foreach ($this->defects as $test => $status) {
$data['defects'][$test] = $status->asInt();
}
file_put_contents(
$this->cacheFilename,
json_encode($data),
LOCK_EX,
);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestFailedSubscriber.php 0000644 00000001214 15243417753 0021372 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->handler()->testFailed($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestPreparedSubscriber.php 0000644 00000001230 15243417753 0021746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->handler()->testPrepared($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestFinishedSubscriber.php 0000644 00000001467 15243417753 0021751 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->handler()->testFinished($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001246 15243417753 0022756 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->handler()->testSuiteFinished();
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestSkippedSubscriber.php 0000644 00000001461 15243417753 0021611 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->handler()->testSkipped($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/Subscriber.php 0000644 00000001243 15243417753 0017427 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly ResultCacheHandler $handler;
public function __construct(ResultCacheHandler $handler)
{
$this->handler = $handler;
}
protected function handler(): ResultCacheHandler
{
return $this->handler;
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestErroredSubscriber.php 0000644 00000001222 15243417753 0021607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->handler()->testErrored($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001310 15243417753 0023426 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->handler()->testMarkedIncomplete($event);
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001240 15243417753 0022625 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->handler()->testSuiteStarted();
}
}
phpunit/src/Runner/ResultCache/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001302 15243417753 0023305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->handler()->testConsideredRisky($event);
}
}
phpunit/src/Runner/ResultCache/ResultCacheHandler.php 0000644 00000010250 15243417753 0016717 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use function round;
use PHPUnit\Event\Event;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultCacheHandler
{
private readonly ResultCache $cache;
private ?HRTime $time = null;
private int $testSuite = 0;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(ResultCache $cache, Facade $facade)
{
$this->cache = $cache;
$this->registerSubscribers($facade);
}
public function testSuiteStarted(): void
{
$this->testSuite++;
}
public function testSuiteFinished(): void
{
$this->testSuite--;
if ($this->testSuite === 0) {
$this->cache->persist();
}
}
public function testPrepared(Prepared $event): void
{
$this->time = $event->telemetryInfo()->time();
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::incomplete($event->throwable()->message()),
);
}
public function testConsideredRisky(ConsideredRisky $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::risky($event->message()),
);
}
public function testErrored(Errored $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::error($event->throwable()->message()),
);
}
public function testFailed(Failed $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::failure($event->throwable()->message()),
);
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::skipped($event->message()),
);
$this->cache->setTime($event->test()->id(), $this->duration($event));
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
$this->cache->setTime($event->test()->id(), $this->duration($event));
$this->time = null;
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
private function duration(Event $event): float
{
if ($this->time === null) {
return 0.0;
}
return round($event->telemetryInfo()->time()->duration($this->time)->asFloat(), 3);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestSkippedSubscriber($this),
new TestFinishedSubscriber($this),
);
}
}
phpunit/src/Runner/Baseline/Writer.php 0000644 00000003516 15243417753 0014022 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function dirname;
use function file_put_contents;
use XMLWriter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Writer
{
/**
* @psalm-param non-empty-string $baselineFile
*/
public function write(string $baselineFile, Baseline $baseline): void
{
$pathCalculator = new RelativePathCalculator(dirname($baselineFile));
$writer = new XMLWriter;
$writer->openMemory();
$writer->setIndent(true);
$writer->startDocument();
$writer->startElement('files');
$writer->writeAttribute('version', (string) Baseline::VERSION);
foreach ($baseline->groupedByFileAndLine() as $file => $lines) {
assert(!empty($file));
$writer->startElement('file');
$writer->writeAttribute('path', $pathCalculator->calculate($file));
foreach ($lines as $line => $issues) {
$writer->startElement('line');
$writer->writeAttribute('number', (string) $line);
$writer->writeAttribute('hash', $issues[0]->hash());
foreach ($issues as $issue) {
$writer->startElement('issue');
$writer->writeCData($issue->description());
$writer->endElement();
}
$writer->endElement();
}
$writer->endElement();
}
$writer->endElement();
file_put_contents($baselineFile, $writer->outputMemory());
}
}
phpunit/src/Runner/Baseline/Generator.php 0000644 00000004674 15243417753 0014502 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Runner\FileDoesNotExistException;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
private Baseline $baseline;
private readonly Source $source;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, Source $source)
{
$facade->registerSubscribers(
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
$this->baseline = new Baseline;
$this->source = $source;
}
public function baseline(): Baseline
{
return $this->baseline;
}
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function testTriggeredIssue(DeprecationTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpWarningTriggered|WarningTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$this->baseline->add(
Issue::from(
$event->file(),
$event->line(),
null,
$event->message(),
),
);
}
}
phpunit/src/Runner/Baseline/Reader.php 0000644 00000005720 15243417753 0013747 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function dirname;
use function file_exists;
use function realpath;
use function sprintf;
use function str_replace;
use function trim;
use DOMElement;
use DOMXPath;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Reader
{
/**
* @psalm-param non-empty-string $baselineFile
*
* @throws CannotLoadBaselineException
*/
public function read(string $baselineFile): Baseline
{
if (!file_exists($baselineFile)) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline %s, file does not exist',
$baselineFile,
),
);
}
try {
$document = (new XmlLoader)->loadFile($baselineFile);
} catch (XmlException $e) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline: %s',
trim($e->getMessage()),
),
);
}
$version = (int) $document->documentElement->getAttribute('version');
if ($version !== Baseline::VERSION) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline %s, version %d is not supported',
$baselineFile,
$version,
),
);
}
$baseline = new Baseline;
$baselineDirectory = dirname(realpath($baselineFile));
$xpath = new DOMXPath($document);
foreach ($xpath->query('file') as $fileElement) {
assert($fileElement instanceof DOMElement);
$file = $baselineDirectory . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $fileElement->getAttribute('path'));
foreach ($xpath->query('line', $fileElement) as $lineElement) {
assert($lineElement instanceof DOMElement);
$line = (int) $lineElement->getAttribute('number');
$hash = $lineElement->getAttribute('hash');
foreach ($xpath->query('issue', $lineElement) as $issueElement) {
assert($issueElement instanceof DOMElement);
$description = $issueElement->textContent;
assert($line > 0);
assert(!empty($hash));
assert(!empty($description));
$baseline->add(Issue::from($file, $line, $hash, $description));
}
}
}
return $baseline;
}
}
phpunit/src/Runner/Baseline/Exception/CannotLoadBaselineException.php 0000644 00000001021 15243417753 0022035 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Runner\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotLoadBaselineException extends RuntimeException implements Exception
{
}
phpunit/src/Runner/Baseline/Exception/FileDoesNotHaveLineException.php 0000644 00000001432 15243417753 0022145 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function sprintf;
use PHPUnit\Runner\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FileDoesNotHaveLineException extends RuntimeException implements Exception
{
public function __construct(string $file, int $line)
{
parent::__construct(
sprintf(
'File "%s" does not have line %d',
$file,
$line,
),
);
}
}
phpunit/src/Runner/Baseline/Issue.php 0000644 00000006523 15243417753 0013637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function file;
use function is_file;
use function sha1;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Issue
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
/**
* @psalm-var non-empty-string
*/
private readonly string $hash;
/**
* @psalm-var non-empty-string
*/
private readonly string $description;
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param ?non-empty-string $hash
* @psalm-param non-empty-string $description
*
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public static function from(string $file, int $line, ?string $hash, string $description): self
{
if ($hash === null) {
$hash = self::calculateHash($file, $line);
}
return new self($file, $line, $hash, $description);
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $hash
* @psalm-param non-empty-string $description
*/
private function __construct(string $file, int $line, string $hash, string $description)
{
$this->file = $file;
$this->line = $line;
$this->hash = $hash;
$this->description = $description;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
/**
* @psalm-return non-empty-string
*/
public function hash(): string
{
return $this->hash;
}
/**
* @psalm-return non-empty-string
*/
public function description(): string
{
return $this->description;
}
public function equals(self $other): bool
{
return $this->file() === $other->file() &&
$this->line() === $other->line() &&
$this->hash() === $other->hash() &&
$this->description() === $other->description();
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @psalm-return non-empty-string
*
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
private static function calculateHash(string $file, int $line): string
{
$lines = @file($file, FILE_IGNORE_NEW_LINES);
if ($lines === false && !is_file($file)) {
throw new FileDoesNotExistException($file);
}
$key = $line - 1;
if (!isset($lines[$key])) {
throw new FileDoesNotHaveLineException($file, $line);
}
$hash = sha1($lines[$key]);
assert($hash !== '');
return $hash;
}
}
phpunit/src/Runner/Baseline/Baseline.php 0000644 00000002712 15243417753 0014265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Baseline
{
public const VERSION = 1;
/**
* @psalm-var array<non-empty-string, array<positive-int, list<Issue>>>
*/
private array $issues = [];
public function add(Issue $issue): void
{
if (!isset($this->issues[$issue->file()])) {
$this->issues[$issue->file()] = [];
}
if (!isset($this->issues[$issue->file()][$issue->line()])) {
$this->issues[$issue->file()][$issue->line()] = [];
}
$this->issues[$issue->file()][$issue->line()][] = $issue;
}
public function has(Issue $issue): bool
{
if (!isset($this->issues[$issue->file()][$issue->line()])) {
return false;
}
foreach ($this->issues[$issue->file()][$issue->line()] as $_issue) {
if ($_issue->equals($issue)) {
return true;
}
}
return false;
}
/**
* @psalm-return array<string, array<positive-int, list<Issue>>>
*/
public function groupedByFileAndLine(): array
{
return $this->issues;
}
}
phpunit/src/Runner/Baseline/RelativePathCalculator.php 0000644 00000005267 15243417753 0017155 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function array_fill;
use function array_merge;
use function array_slice;
use function assert;
use function count;
use function explode;
use function implode;
use function str_replace;
use function strpos;
use function substr;
use function trim;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @see Copied from https://github.com/phpstan/phpstan-src/blob/1.10.33/src/File/ParentDirectoryRelativePathHelper.php
*/
final class RelativePathCalculator
{
/**
* @psalm-var non-empty-string $baselineDirectory
*/
private readonly string $baselineDirectory;
/**
* @psalm-param non-empty-string $baselineDirectory
*/
public function __construct(string $baselineDirectory)
{
$this->baselineDirectory = $baselineDirectory;
}
/**
* @psalm-param non-empty-string $filename
*
* @psalm-return non-empty-string
*/
public function calculate(string $filename): string
{
$result = implode('/', $this->parts($filename));
assert($result !== '');
return $result;
}
/**
* @psalm-param non-empty-string $filename
*
* @psalm-return list<non-empty-string>
*/
public function parts(string $filename): array
{
$schemePosition = strpos($filename, '://');
if ($schemePosition !== false) {
$filename = substr($filename, $schemePosition + 3);
assert($filename !== '');
}
$parentParts = explode('/', trim(str_replace('\\', '/', $this->baselineDirectory), '/'));
$parentPartsCount = count($parentParts);
$filenameParts = explode('/', trim(str_replace('\\', '/', $filename), '/'));
$filenamePartsCount = count($filenameParts);
$i = 0;
for (; $i < $filenamePartsCount; $i++) {
if ($parentPartsCount < $i + 1) {
break;
}
$parentPath = implode('/', array_slice($parentParts, 0, $i + 1));
$filenamePath = implode('/', array_slice($filenameParts, 0, $i + 1));
if ($parentPath !== $filenamePath) {
break;
}
}
if ($i === 0) {
return [$filename];
}
$dotsCount = $parentPartsCount - $i;
assert($dotsCount >= 0);
return array_merge(array_fill(0, $dotsCount, '..'), array_slice($filenameParts, $i));
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001523 15243417753 0022607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(NoticeTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001573 15243417753 0024300 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpDeprecationTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001530 15243417753 0022771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(WarningTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001542 15243417753 0023260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpNoticeTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/Baseline/Subscriber/Subscriber.php 0000644 00000001221 15243417753 0016743 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly Generator $generator;
public function __construct(Generator $generator)
{
$this->generator = $generator;
}
protected function generator(): Generator
{
return $this->generator;
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001547 15243417753 0023451 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpWarningTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/Baseline/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001554 15243417753 0023627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(DeprecationTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
phpunit/src/Runner/TestSuiteLoader.php 0000644 00000007412 15243417753 0014103 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_diff;
use function array_values;
use function basename;
use function class_exists;
use function get_declared_classes;
use function realpath;
use function str_ends_with;
use function strpos;
use function strtolower;
use function substr;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteLoader
{
/**
* @psalm-var list<class-string>
*/
private static array $declaredClasses = [];
/**
* @psalm-var array<non-empty-string, list<class-string>>
*/
private static array $fileToClassesMap = [];
/**
* @throws Exception
*/
public function load(string $suiteClassFile): ReflectionClass
{
$suiteClassFile = realpath($suiteClassFile);
$suiteClassName = $this->classNameFromFileName($suiteClassFile);
$loadedClasses = $this->loadSuiteClassFile($suiteClassFile);
foreach ($loadedClasses as $className) {
/** @noinspection PhpUnhandledExceptionInspection */
$class = new ReflectionClass($className);
if ($class->isAnonymous()) {
continue;
}
if ($class->getFileName() !== $suiteClassFile) {
continue;
}
if (!$class->isSubclassOf(TestCase::class)) {
continue;
}
if (!str_ends_with(strtolower($class->getShortName()), strtolower($suiteClassName))) {
continue;
}
if (!$class->isAbstract()) {
return $class;
}
$e = new ClassIsAbstractException($class->getName(), $suiteClassFile);
}
if (isset($e)) {
throw $e;
}
if (!class_exists($suiteClassName)) {
throw new ClassCannotBeFoundException($suiteClassName, $suiteClassFile);
}
throw new ClassDoesNotExtendTestCaseException($suiteClassName, $suiteClassFile);
}
private function classNameFromFileName(string $suiteClassFile): string
{
$className = basename($suiteClassFile, '.php');
$dotPos = strpos($className, '.');
if ($dotPos !== false) {
$className = substr($className, 0, $dotPos);
}
return $className;
}
/**
* @psalm-return list<class-string>
*/
private function loadSuiteClassFile(string $suiteClassFile): array
{
if (isset(self::$fileToClassesMap[$suiteClassFile])) {
return self::$fileToClassesMap[$suiteClassFile];
}
if (empty(self::$declaredClasses)) {
self::$declaredClasses = get_declared_classes();
}
require_once $suiteClassFile;
$loadedClasses = array_values(
array_diff(
get_declared_classes(),
self::$declaredClasses,
),
);
foreach ($loadedClasses as $loadedClass) {
/** @noinspection PhpUnhandledExceptionInspection */
$class = new ReflectionClass($loadedClass);
if (!isset(self::$fileToClassesMap[$class->getFileName()])) {
self::$fileToClassesMap[$class->getFileName()] = [];
}
self::$fileToClassesMap[$class->getFileName()][] = $class->getName();
}
self::$declaredClasses = get_declared_classes();
if (empty($loadedClasses)) {
return self::$declaredClasses;
}
return $loadedClasses;
}
}
phpunit/src/Runner/Exception/ErrorException.php 0000644 00000000707 15243417753 0015731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use Error;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorException extends Error implements Exception
{
}
phpunit/src/Runner/Exception/ClassDoesNotExtendTestCaseException.php 0000644 00000001452 15243417753 0022003 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassDoesNotExtendTestCaseException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s declared in %s does not extend PHPUnit\Framework\TestCase',
$className,
$file,
),
);
}
}
phpunit/src/Runner/Exception/ClassCannotBeFoundException.php 0000644 00000001376 15243417753 0020316 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassCannotBeFoundException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s cannot be found in %s',
$className,
$file,
),
);
}
}
phpunit/src/Runner/Exception/InvalidPhptFileException.php 0000644 00000000747 15243417753 0017666 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidPhptFileException extends RuntimeException implements Exception
{
}
phpunit/src/Runner/Exception/ParameterDoesNotExistException.php 0000644 00000001321 15243417753 0021062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ParameterDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Parameter "%s" does not exist',
$name,
),
);
}
}
phpunit/src/Runner/Exception/UnsupportedPhptSectionException.php 0000644 00000001344 15243417753 0021347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnsupportedPhptSectionException extends RuntimeException implements Exception
{
public function __construct(string $section)
{
parent::__construct(
sprintf(
'PHPUnit does not support PHPT %s sections',
$section,
),
);
}
}
phpunit/src/Runner/Exception/PhptExternalFileCannotBeLoadedException.php 0000644 00000001434 15243417753 0022577 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptExternalFileCannotBeLoadedException extends RuntimeException implements Exception
{
public function __construct(string $section, string $file)
{
parent::__construct(
sprintf(
'Could not load --%s-- %s for PHPT file',
$section . '_EXTERNAL',
$file,
),
);
}
}
phpunit/src/Runner/Exception/ClassIsAbstractException.php 0000644 00000001400 15243417753 0017654 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsAbstractException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s declared in %s is abstract',
$className,
$file,
),
);
}
}
phpunit/src/Runner/Exception/Exception.php 0000644 00000000654 15243417753 0014720 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends \PHPUnit\Exception
{
}
phpunit/src/Runner/Exception/InvalidOrderException.php 0000644 00000000744 15243417753 0017223 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidOrderException extends RuntimeException implements Exception
{
}
phpunit/src/Runner/Exception/ReflectionException.php 0000644 00000000742 15243417753 0016731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
phpunit/src/Runner/Exception/NoIgnoredEventException.php 0000644 00000000746 15243417753 0017531 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoIgnoredEventException extends RuntimeException implements Exception
{
}
phpunit/src/Runner/Exception/FileDoesNotExistException.php 0000644 00000001307 15243417753 0020025 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FileDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $file)
{
parent::__construct(
sprintf(
'File "%s" does not exist',
$file,
),
);
}
}
phpunit/src/Runner/Exception/DirectoryCannotBeCreatedException.php 0000644 00000001335 15243417753 0021504 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryCannotBeCreatedException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'Cannot create directory "%s"',
$directory,
),
);
}
}
phpunit/src/Runner/TestResult/Collector.php 0000644 00000045453 15243417753 0015076 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function array_values;
use function assert;
use function implode;
use function str_contains;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\Skipped as TestSkipped;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\TestRunner\DeprecationTriggered as TestRunnerDeprecationTriggered;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\WarningTriggered as TestRunnerWarningTriggered;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuiteForTestClass;
use PHPUnit\Event\TestSuite\TestSuiteForTestMethodWithDataProvider;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Collector
{
private readonly Source $source;
private int $numberOfTests = 0;
private int $numberOfTestsRun = 0;
private int $numberOfAssertions = 0;
private bool $prepared = false;
private bool $currentTestSuiteForTestClassFailed = false;
/**
* @psalm-var non-negative-int
*/
private int $numberOfIssuesIgnoredByBaseline = 0;
/**
* @psalm-var list<BeforeFirstTestMethodErrored|Errored>
*/
private array $testErroredEvents = [];
/**
* @psalm-var list<Failed>
*/
private array $testFailedEvents = [];
/**
* @psalm-var list<MarkedIncomplete>
*/
private array $testMarkedIncompleteEvents = [];
/**
* @psalm-var list<TestSuiteSkipped>
*/
private array $testSuiteSkippedEvents = [];
/**
* @psalm-var list<TestSkipped>
*/
private array $testSkippedEvents = [];
/**
* @psalm-var array<string,list<ConsideredRisky>>
*/
private array $testConsideredRiskyEvents = [];
/**
* @psalm-var array<string,list<PhpunitDeprecationTriggered>>
*/
private array $testTriggeredPhpunitDeprecationEvents = [];
/**
* @psalm-var array<string,list<PhpunitErrorTriggered>>
*/
private array $testTriggeredPhpunitErrorEvents = [];
/**
* @psalm-var array<string,list<PhpunitWarningTriggered>>
*/
private array $testTriggeredPhpunitWarningEvents = [];
/**
* @psalm-var list<TestRunnerWarningTriggered>
*/
private array $testRunnerTriggeredWarningEvents = [];
/**
* @psalm-var list<TestRunnerDeprecationTriggered>
*/
private array $testRunnerTriggeredDeprecationEvents = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $errors = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $deprecations = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $notices = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $warnings = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpDeprecations = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpNotices = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpWarnings = [];
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, Source $source)
{
$facade->registerSubscribers(
new ExecutionStartedSubscriber($this),
new TestSuiteSkippedSubscriber($this),
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new BeforeTestClassMethodErroredSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredErrorSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitErrorSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
new TestRunnerTriggeredDeprecationSubscriber($this),
new TestRunnerTriggeredWarningSubscriber($this),
);
$this->source = $source;
}
public function result(): TestResult
{
return new TestResult(
$this->numberOfTests,
$this->numberOfTestsRun,
$this->numberOfAssertions,
$this->testErroredEvents,
$this->testFailedEvents,
$this->testConsideredRiskyEvents,
$this->testSuiteSkippedEvents,
$this->testSkippedEvents,
$this->testMarkedIncompleteEvents,
$this->testTriggeredPhpunitDeprecationEvents,
$this->testTriggeredPhpunitErrorEvents,
$this->testTriggeredPhpunitWarningEvents,
$this->testRunnerTriggeredDeprecationEvents,
$this->testRunnerTriggeredWarningEvents,
array_values($this->errors),
array_values($this->deprecations),
array_values($this->notices),
array_values($this->warnings),
array_values($this->phpDeprecations),
array_values($this->phpNotices),
array_values($this->phpWarnings),
$this->numberOfIssuesIgnoredByBaseline,
);
}
public function executionStarted(ExecutionStarted $event): void
{
$this->numberOfTests = $event->testSuite()->count();
}
public function testSuiteSkipped(TestSuiteSkipped $event): void
{
$testSuite = $event->testSuite();
if (!$testSuite->isForTestClass()) {
return;
}
$this->testSuiteSkippedEvents[] = $event;
}
public function testSuiteStarted(TestSuiteStarted $event): void
{
$testSuite = $event->testSuite();
if (!$testSuite->isForTestClass()) {
return;
}
$this->currentTestSuiteForTestClassFailed = false;
}
public function testSuiteFinished(TestSuiteFinished $event): void
{
if ($this->currentTestSuiteForTestClassFailed) {
return;
}
$testSuite = $event->testSuite();
if ($testSuite->isWithName()) {
return;
}
if ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$test = $testSuite->tests()->asArray()[0];
assert($test instanceof TestMethod);
PassedTests::instance()->testMethodPassed($test, null);
return;
}
assert($testSuite instanceof TestSuiteForTestClass);
PassedTests::instance()->testClassPassed($testSuite->className());
}
public function testPrepared(): void
{
$this->prepared = true;
}
public function testFinished(Finished $event): void
{
$this->numberOfAssertions += $event->numberOfAssertionsPerformed();
$this->numberOfTestsRun++;
$this->prepared = false;
}
public function beforeTestClassMethodErrored(BeforeFirstTestMethodErrored $event): void
{
$this->testErroredEvents[] = $event;
$this->numberOfTestsRun++;
}
public function testErrored(Errored $event): void
{
$this->testErroredEvents[] = $event;
$this->currentTestSuiteForTestClassFailed = true;
/*
* @todo Eliminate this special case
*/
if (str_contains($event->asString(), 'Test was run in child process and ended unexpectedly')) {
return;
}
if (!$this->prepared) {
$this->numberOfTestsRun++;
}
}
public function testFailed(Failed $event): void
{
$this->testFailedEvents[] = $event;
$this->currentTestSuiteForTestClassFailed = true;
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->testMarkedIncompleteEvents[] = $event;
}
public function testSkipped(TestSkipped $event): void
{
$this->testSkippedEvents[] = $event;
if (!$this->prepared) {
$this->numberOfTestsRun++;
}
}
public function testConsideredRisky(ConsideredRisky $event): void
{
if (!isset($this->testConsideredRiskyEvents[$event->test()->id()])) {
$this->testConsideredRiskyEvents[$event->test()->id()] = [];
}
$this->testConsideredRiskyEvents[$event->test()->id()][] = $event;
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if ($event->ignoredByTest()) {
return;
}
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfDeprecations() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictDeprecations() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->deprecations[$id])) {
$this->deprecations[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->deprecations[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if ($event->ignoredByTest()) {
return;
}
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpDeprecations() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictDeprecations() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpDeprecations[$id])) {
$this->phpDeprecations[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpDeprecations[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpunitDeprecation(PhpunitDeprecationTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()][] = $event;
}
public function testTriggeredError(ErrorTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfErrors() && $event->wasSuppressed()) {
return;
}
$id = $this->issueId($event);
if (!isset($this->errors[$id])) {
$this->errors[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->errors[$id]->triggeredBy($event->test());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfNotices() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictNotices() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->notices[$id])) {
$this->notices[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->notices[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpNotices() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictNotices() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpNotices[$id])) {
$this->phpNotices[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpNotices[$id]->triggeredBy($event->test());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->warnings[$id])) {
$this->warnings[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->warnings[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpWarnings[$id])) {
$this->phpWarnings[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpWarnings[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpunitError(PhpunitErrorTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitErrorEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitErrorEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitErrorEvents[$event->test()->id()][] = $event;
}
public function testTriggeredPhpunitWarning(PhpunitWarningTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitWarningEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitWarningEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitWarningEvents[$event->test()->id()][] = $event;
}
public function testRunnerTriggeredDeprecation(TestRunnerDeprecationTriggered $event): void
{
$this->testRunnerTriggeredDeprecationEvents[] = $event;
}
public function testRunnerTriggeredWarning(TestRunnerWarningTriggered $event): void
{
$this->testRunnerTriggeredWarningEvents[] = $event;
}
public function hasErroredTests(): bool
{
return !empty($this->testErroredEvents);
}
public function hasFailedTests(): bool
{
return !empty($this->testFailedEvents);
}
public function hasRiskyTests(): bool
{
return !empty($this->testConsideredRiskyEvents);
}
public function hasSkippedTests(): bool
{
return !empty($this->testSkippedEvents);
}
public function hasIncompleteTests(): bool
{
return !empty($this->testMarkedIncompleteEvents);
}
public function hasDeprecations(): bool
{
return !empty($this->deprecations) ||
!empty($this->phpDeprecations) ||
!empty($this->testTriggeredPhpunitDeprecationEvents) ||
!empty($this->testRunnerTriggeredDeprecationEvents);
}
public function hasNotices(): bool
{
return !empty($this->notices) ||
!empty($this->phpNotices);
}
public function hasWarnings(): bool
{
return !empty($this->warnings) ||
!empty($this->phpWarnings) ||
!empty($this->testTriggeredPhpunitWarningEvents) ||
!empty($this->testRunnerTriggeredWarningEvents);
}
/**
* @psalm-return non-empty-string
*/
private function issueId(DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpWarningTriggered|WarningTriggered $event): string
{
return implode(':', [$event->file(), $event->line(), $event->message()]);
}
}
phpunit/src/Runner/TestResult/PassedTests.php 0000644 00000005673 15243417753 0015412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function array_merge;
use function assert;
use function in_array;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Framework\TestSize\Known;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Api\Groups;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PassedTests
{
private static ?self $instance = null;
/**
* @psalm-var list<class-string>
*/
private array $passedTestClasses = [];
/**
* @psalm-var array<string,array{returnValue: mixed, size: TestSize}>
*/
private array $passedTestMethods = [];
public static function instance(): self
{
if (self::$instance !== null) {
return self::$instance;
}
self::$instance = new self;
return self::$instance;
}
/**
* @psalm-param class-string $className
*/
public function testClassPassed(string $className): void
{
$this->passedTestClasses[] = $className;
}
public function testMethodPassed(TestMethod $test, mixed $returnValue): void
{
$size = (new Groups)->size(
$test->className(),
$test->methodName(),
);
$this->passedTestMethods[$test->className() . '::' . $test->methodName()] = [
'returnValue' => $returnValue,
'size' => $size,
];
}
public function import(self $other): void
{
$this->passedTestClasses = array_merge(
$this->passedTestClasses,
$other->passedTestClasses,
);
$this->passedTestMethods = array_merge(
$this->passedTestMethods,
$other->passedTestMethods,
);
}
/**
* @psalm-param class-string $className
*/
public function hasTestClassPassed(string $className): bool
{
return in_array($className, $this->passedTestClasses, true);
}
public function hasTestMethodPassed(string $method): bool
{
return isset($this->passedTestMethods[$method]);
}
public function isGreaterThan(string $method, TestSize $other): bool
{
if ($other->isUnknown()) {
return false;
}
assert($other instanceof Known);
$size = $this->passedTestMethods[$method]['size'];
if ($size->isUnknown()) {
return false;
}
assert($size instanceof Known);
return $size->isGreaterThan($other);
}
public function returnValue(string $method): mixed
{
if (isset($this->passedTestMethods[$method])) {
return $this->passedTestMethods[$method]['returnValue'];
}
return null;
}
}
phpunit/src/Runner/TestResult/TestResult.php 0000644 00000037552 15243417753 0015267 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function count;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\Skipped as TestSkipped;
use PHPUnit\Event\TestRunner\DeprecationTriggered as TestRunnerDeprecationTriggered;
use PHPUnit\Event\TestRunner\WarningTriggered as TestRunnerWarningTriggered;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResult
{
private readonly int $numberOfTests;
private readonly int $numberOfTestsRun;
private readonly int $numberOfAssertions;
/**
* @psalm-var list<BeforeFirstTestMethodErrored|Errored>
*/
private readonly array $testErroredEvents;
/**
* @psalm-var list<Failed>
*/
private readonly array $testFailedEvents;
/**
* @psalm-var list<MarkedIncomplete>
*/
private readonly array $testMarkedIncompleteEvents;
/**
* @psalm-var list<TestSuiteSkipped>
*/
private readonly array $testSuiteSkippedEvents;
/**
* @psalm-var list<TestSkipped>
*/
private readonly array $testSkippedEvents;
/**
* @psalm-var array<string,list<ConsideredRisky>>
*/
private readonly array $testConsideredRiskyEvents;
/**
* @psalm-var array<string,list<PhpunitDeprecationTriggered>>
*/
private readonly array $testTriggeredPhpunitDeprecationEvents;
/**
* @psalm-var array<string,list<PhpunitErrorTriggered>>
*/
private readonly array $testTriggeredPhpunitErrorEvents;
/**
* @psalm-var array<string,list<PhpunitWarningTriggered>>
*/
private readonly array $testTriggeredPhpunitWarningEvents;
/**
* @psalm-var list<TestRunnerDeprecationTriggered>
*/
private readonly array $testRunnerTriggeredDeprecationEvents;
/**
* @psalm-var list<TestRunnerWarningTriggered>
*/
private readonly array $testRunnerTriggeredWarningEvents;
/**
* @psalm-var list<Issue>
*/
private readonly array $errors;
/**
* @psalm-var list<Issue>
*/
private readonly array $deprecations;
/**
* @psalm-var list<Issue>
*/
private readonly array $notices;
/**
* @psalm-var list<Issue>
*/
private readonly array $warnings;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpDeprecations;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpNotices;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpWarnings;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfIssuesIgnoredByBaseline;
/**
* @psalm-param list<BeforeFirstTestMethodErrored|Errored> $testErroredEvents
* @psalm-param list<Failed> $testFailedEvents
* @psalm-param array<string,list<ConsideredRisky>> $testConsideredRiskyEvents
* @psalm-param list<TestSuiteSkipped> $testSuiteSkippedEvents
* @psalm-param list<TestSkipped> $testSkippedEvents
* @psalm-param list<MarkedIncomplete> $testMarkedIncompleteEvents
* @psalm-param array<string,list<PhpunitDeprecationTriggered>> $testTriggeredPhpunitDeprecationEvents
* @psalm-param array<string,list<PhpunitErrorTriggered>> $testTriggeredPhpunitErrorEvents
* @psalm-param array<string,list<PhpunitWarningTriggered>> $testTriggeredPhpunitWarningEvents
* @psalm-param list<TestRunnerDeprecationTriggered> $testRunnerTriggeredDeprecationEvents
* @psalm-param list<TestRunnerWarningTriggered> $testRunnerTriggeredWarningEvents
* @psalm-param list<Issue> $errors
* @psalm-param list<Issue> $deprecations
* @psalm-param list<Issue> $notices
* @psalm-param list<Issue> $warnings
* @psalm-param list<Issue> $phpDeprecations
* @psalm-param list<Issue> $phpNotices
* @psalm-param list<Issue> $phpWarnings
* @psalm-param non-negative-int $numberOfIssuesIgnoredByBaseline
*/
public function __construct(int $numberOfTests, int $numberOfTestsRun, int $numberOfAssertions, array $testErroredEvents, array $testFailedEvents, array $testConsideredRiskyEvents, array $testSuiteSkippedEvents, array $testSkippedEvents, array $testMarkedIncompleteEvents, array $testTriggeredPhpunitDeprecationEvents, array $testTriggeredPhpunitErrorEvents, array $testTriggeredPhpunitWarningEvents, array $testRunnerTriggeredDeprecationEvents, array $testRunnerTriggeredWarningEvents, array $errors, array $deprecations, array $notices, array $warnings, array $phpDeprecations, array $phpNotices, array $phpWarnings, int $numberOfIssuesIgnoredByBaseline)
{
$this->numberOfTests = $numberOfTests;
$this->numberOfTestsRun = $numberOfTestsRun;
$this->numberOfAssertions = $numberOfAssertions;
$this->testErroredEvents = $testErroredEvents;
$this->testFailedEvents = $testFailedEvents;
$this->testConsideredRiskyEvents = $testConsideredRiskyEvents;
$this->testSuiteSkippedEvents = $testSuiteSkippedEvents;
$this->testSkippedEvents = $testSkippedEvents;
$this->testMarkedIncompleteEvents = $testMarkedIncompleteEvents;
$this->testTriggeredPhpunitDeprecationEvents = $testTriggeredPhpunitDeprecationEvents;
$this->testTriggeredPhpunitErrorEvents = $testTriggeredPhpunitErrorEvents;
$this->testTriggeredPhpunitWarningEvents = $testTriggeredPhpunitWarningEvents;
$this->testRunnerTriggeredDeprecationEvents = $testRunnerTriggeredDeprecationEvents;
$this->testRunnerTriggeredWarningEvents = $testRunnerTriggeredWarningEvents;
$this->errors = $errors;
$this->deprecations = $deprecations;
$this->notices = $notices;
$this->warnings = $warnings;
$this->phpDeprecations = $phpDeprecations;
$this->phpNotices = $phpNotices;
$this->phpWarnings = $phpWarnings;
$this->numberOfIssuesIgnoredByBaseline = $numberOfIssuesIgnoredByBaseline;
}
public function numberOfTestsRun(): int
{
return $this->numberOfTestsRun;
}
public function numberOfAssertions(): int
{
return $this->numberOfAssertions;
}
/**
* @psalm-return list<BeforeFirstTestMethodErrored|Errored>
*/
public function testErroredEvents(): array
{
return $this->testErroredEvents;
}
public function numberOfTestErroredEvents(): int
{
return count($this->testErroredEvents);
}
public function hasTestErroredEvents(): bool
{
return $this->numberOfTestErroredEvents() > 0;
}
/**
* @psalm-return list<Failed>
*/
public function testFailedEvents(): array
{
return $this->testFailedEvents;
}
public function numberOfTestFailedEvents(): int
{
return count($this->testFailedEvents);
}
public function hasTestFailedEvents(): bool
{
return $this->numberOfTestFailedEvents() > 0;
}
/**
* @psalm-return array<string,list<ConsideredRisky>>
*/
public function testConsideredRiskyEvents(): array
{
return $this->testConsideredRiskyEvents;
}
public function numberOfTestsWithTestConsideredRiskyEvents(): int
{
return count($this->testConsideredRiskyEvents);
}
public function hasTestConsideredRiskyEvents(): bool
{
return $this->numberOfTestsWithTestConsideredRiskyEvents() > 0;
}
/**
* @psalm-return list<TestSuiteSkipped>
*/
public function testSuiteSkippedEvents(): array
{
return $this->testSuiteSkippedEvents;
}
public function numberOfTestSuiteSkippedEvents(): int
{
return count($this->testSuiteSkippedEvents);
}
public function hasTestSuiteSkippedEvents(): bool
{
return $this->numberOfTestSuiteSkippedEvents() > 0;
}
/**
* @psalm-return list<TestSkipped>
*/
public function testSkippedEvents(): array
{
return $this->testSkippedEvents;
}
public function numberOfTestSkippedEvents(): int
{
return count($this->testSkippedEvents);
}
public function hasTestSkippedEvents(): bool
{
return $this->numberOfTestSkippedEvents() > 0;
}
/**
* @psalm-return list<MarkedIncomplete>
*/
public function testMarkedIncompleteEvents(): array
{
return $this->testMarkedIncompleteEvents;
}
public function numberOfTestMarkedIncompleteEvents(): int
{
return count($this->testMarkedIncompleteEvents);
}
public function hasTestMarkedIncompleteEvents(): bool
{
return $this->numberOfTestMarkedIncompleteEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitDeprecationTriggered>>
*/
public function testTriggeredPhpunitDeprecationEvents(): array
{
return $this->testTriggeredPhpunitDeprecationEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitDeprecationEvents(): int
{
return count($this->testTriggeredPhpunitDeprecationEvents);
}
public function hasTestTriggeredPhpunitDeprecationEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitDeprecationEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitErrorTriggered>>
*/
public function testTriggeredPhpunitErrorEvents(): array
{
return $this->testTriggeredPhpunitErrorEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitErrorEvents(): int
{
return count($this->testTriggeredPhpunitErrorEvents);
}
public function hasTestTriggeredPhpunitErrorEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitErrorEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitWarningTriggered>>
*/
public function testTriggeredPhpunitWarningEvents(): array
{
return $this->testTriggeredPhpunitWarningEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitWarningEvents(): int
{
return count($this->testTriggeredPhpunitWarningEvents);
}
public function hasTestTriggeredPhpunitWarningEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitWarningEvents() > 0;
}
/**
* @psalm-return list<TestRunnerDeprecationTriggered>
*/
public function testRunnerTriggeredDeprecationEvents(): array
{
return $this->testRunnerTriggeredDeprecationEvents;
}
public function numberOfTestRunnerTriggeredDeprecationEvents(): int
{
return count($this->testRunnerTriggeredDeprecationEvents);
}
public function hasTestRunnerTriggeredDeprecationEvents(): bool
{
return $this->numberOfTestRunnerTriggeredDeprecationEvents() > 0;
}
/**
* @psalm-return list<TestRunnerWarningTriggered>
*/
public function testRunnerTriggeredWarningEvents(): array
{
return $this->testRunnerTriggeredWarningEvents;
}
public function numberOfTestRunnerTriggeredWarningEvents(): int
{
return count($this->testRunnerTriggeredWarningEvents);
}
public function hasTestRunnerTriggeredWarningEvents(): bool
{
return $this->numberOfTestRunnerTriggeredWarningEvents() > 0;
}
public function wasSuccessful(): bool
{
return $this->wasSuccessfulIgnoringPhpunitWarnings() &&
!$this->hasTestTriggeredPhpunitErrorEvents() &&
!$this->hasTestRunnerTriggeredWarningEvents() &&
!$this->hasTestTriggeredPhpunitWarningEvents();
}
public function wasSuccessfulIgnoringPhpunitWarnings(): bool
{
return !$this->hasTestErroredEvents() &&
!$this->hasTestFailedEvents();
}
public function wasSuccessfulAndNoTestHasIssues(): bool
{
return $this->wasSuccessful() && !$this->hasTestsWithIssues();
}
public function hasTestsWithIssues(): bool
{
return $this->hasRiskyTests() ||
$this->hasIncompleteTests() ||
$this->hasDeprecations() ||
!empty($this->errors) ||
$this->hasNotices() ||
$this->hasWarnings();
}
/**
* @psalm-return list<Issue>
*/
public function errors(): array
{
return $this->errors;
}
/**
* @psalm-return list<Issue>
*/
public function deprecations(): array
{
return $this->deprecations;
}
/**
* @psalm-return list<Issue>
*/
public function notices(): array
{
return $this->notices;
}
/**
* @psalm-return list<Issue>
*/
public function warnings(): array
{
return $this->warnings;
}
/**
* @psalm-return list<Issue>
*/
public function phpDeprecations(): array
{
return $this->phpDeprecations;
}
/**
* @psalm-return list<Issue>
*/
public function phpNotices(): array
{
return $this->phpNotices;
}
/**
* @psalm-return list<Issue>
*/
public function phpWarnings(): array
{
return $this->phpWarnings;
}
public function hasTests(): bool
{
return $this->numberOfTests > 0;
}
public function hasErrors(): bool
{
return $this->numberOfErrors() > 0;
}
public function numberOfErrors(): int
{
return $this->numberOfTestErroredEvents() +
count($this->errors) +
$this->numberOfTestsWithTestTriggeredPhpunitErrorEvents();
}
public function hasDeprecations(): bool
{
return $this->numberOfDeprecations() > 0;
}
public function numberOfDeprecations(): int
{
return count($this->deprecations) +
count($this->phpDeprecations) +
count($this->testTriggeredPhpunitDeprecationEvents) +
count($this->testRunnerTriggeredDeprecationEvents);
}
public function hasNotices(): bool
{
return $this->numberOfNotices() > 0;
}
public function numberOfNotices(): int
{
return count($this->notices) +
count($this->phpNotices);
}
public function hasWarnings(): bool
{
return $this->numberOfWarnings() > 0;
}
public function numberOfWarnings(): int
{
return count($this->warnings) +
count($this->phpWarnings) +
count($this->testTriggeredPhpunitWarningEvents) +
count($this->testRunnerTriggeredWarningEvents);
}
public function hasIncompleteTests(): bool
{
return !empty($this->testMarkedIncompleteEvents);
}
public function hasRiskyTests(): bool
{
return !empty($this->testConsideredRiskyEvents);
}
public function hasSkippedTests(): bool
{
return !empty($this->testSkippedEvents);
}
public function hasIssuesIgnoredByBaseline(): bool
{
return $this->numberOfIssuesIgnoredByBaseline > 0;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfIssuesIgnoredByBaseline(): int
{
return $this->numberOfIssuesIgnoredByBaseline;
}
}
phpunit/src/Runner/TestResult/Facade.php 0000644 00000005500 15243417753 0014300 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?Collector $collector = null;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function init(): void
{
self::collector();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function result(): TestResult
{
return self::collector()->result();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function shouldStop(): bool
{
$configuration = ConfigurationRegistry::get();
$collector = self::collector();
if (($configuration->stopOnDefect() || $configuration->stopOnError()) && $collector->hasErroredTests()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnFailure()) && $collector->hasFailedTests()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnWarning()) && $collector->hasWarnings()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnRisky()) && $collector->hasRiskyTests()) {
return true;
}
if ($configuration->stopOnDeprecation() && $collector->hasDeprecations()) {
return true;
}
if ($configuration->stopOnNotice() && $collector->hasNotices()) {
return true;
}
if ($configuration->stopOnIncomplete() && $collector->hasIncompleteTests()) {
return true;
}
if ($configuration->stopOnSkipped() && $collector->hasSkippedTests()) {
return true;
}
return false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private static function collector(): Collector
{
if (self::$collector === null) {
$configuration = ConfigurationRegistry::get();
self::$collector = new Collector(
EventFacade::instance(),
$configuration->source(),
);
}
return self::$collector;
}
}
phpunit/src/Runner/TestResult/Issue.php 0000644 00000005144 15243417753 0014231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult\Issues;
use PHPUnit\Event\Code\Test;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Issue
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
/**
* @psalm-var non-empty-string
*/
private readonly string $description;
/**
* @psalm-var non-empty-array<non-empty-string, array{test: Test, count: int}>
*/
private array $triggeringTests;
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
public static function from(string $file, int $line, string $description, Test $triggeringTest): self
{
return new self($file, $line, $description, $triggeringTest);
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
private function __construct(string $file, int $line, string $description, Test $triggeringTest)
{
$this->file = $file;
$this->line = $line;
$this->description = $description;
$this->triggeringTests = [
$triggeringTest->id() => [
'test' => $triggeringTest,
'count' => 1,
],
];
}
public function triggeredBy(Test $test): void
{
if (isset($this->triggeringTests[$test->id()])) {
$this->triggeringTests[$test->id()]['count']++;
return;
}
$this->triggeringTests[$test->id()] = [
'test' => $test,
'count' => 1,
];
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
/**
* @psalm-return non-empty-string
*/
public function description(): string
{
return $this->description;
}
/**
* @psalm-return non-empty-array<non-empty-string, array{test: Test, count: int}>
*/
public function triggeringTests(): array
{
return $this->triggeringTests;
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001307 15243417753 0023203 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->collector()->testTriggeredNotice($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestFailedSubscriber.php 0000644 00000001221 15243417753 0021304 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->collector()->testFailed($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001367 15243417753 0024745 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpunitWarning($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001367 15243417753 0024675 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpDeprecation($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001315 15243417753 0023366 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testTriggeredWarning($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestPreparedSubscriber.php 0000644 00000001227 15243417753 0021670 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->collector()->testPrepared();
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpunitErrorSubscriber.php 0000644 00000001353 15243417753 0024424 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitErrorSubscriber extends Subscriber implements PhpunitErrorTriggeredSubscriber
{
public function notify(PhpunitErrorTriggered $event): void
{
$this->collector()->testTriggeredPhpunitError($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/ExecutionStartedSubscriber.php 0000644 00000001403 15243417753 0022554 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber as TestRunnerExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStartedSubscriber extends Subscriber implements TestRunnerExecutionStartedSubscriber
{
public function notify(ExecutionStarted $event): void
{
$this->collector()->executionStarted($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001331 15243417753 0023650 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->collector()->testTriggeredPhpNotice($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestFinishedSubscriber.php 0000644 00000001235 15243417753 0021656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->collector()->testFinished($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/BeforeTestClassMethodErroredSubscriber.php 0000644 00000001415 15243417753 0025001 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\BeforeFirstTestMethodErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestClassMethodErroredSubscriber extends Subscriber implements BeforeFirstTestMethodErroredSubscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void
{
$this->collector()->beforeTestClassMethodErrored($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001261 15243417753 0022667 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->collector()->testSuiteFinished($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestRunnerTriggeredDeprecationSubscriber.php 0000644 00000001375 15243417753 0025416 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\DeprecationTriggered;
use PHPUnit\Event\TestRunner\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testRunnerTriggeredDeprecation($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestSkippedSubscriber.php 0000644 00000001227 15243417753 0021525 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSkipped($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestSuiteSkippedSubscriber.php 0000644 00000001253 15243417753 0022536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Skipped;
use PHPUnit\Event\TestSuite\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSuiteSkipped($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestRunnerTriggeredWarningSubscriber.php 0000644 00000001345 15243417753 0024563 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\WarningTriggered;
use PHPUnit\Event\TestRunner\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testRunnerTriggeredWarning($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/Subscriber.php 0000644 00000001227 15243417753 0017345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly Collector $collector;
public function __construct(Collector $collector)
{
$this->collector = $collector;
}
protected function collector(): Collector
{
return $this->collector;
}
}
phpunit/src/Runner/TestResult/Subscriber/TestErroredSubscriber.php 0000644 00000001227 15243417753 0021530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->collector()->testErrored($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001417 15243417753 0025571 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpunitDeprecation($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredErrorSubscriber.php 0000644 00000001301 15243417753 0023045 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\ErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredErrorSubscriber extends Subscriber implements ErrorTriggeredSubscriber
{
public function notify(ErrorTriggered $event): void
{
$this->collector()->testTriggeredError($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001337 15243417753 0024042 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpWarning($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001345 15243417753 0024221 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testTriggeredDeprecation($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001315 15243417753 0023347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->collector()->testMarkedIncomplete($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001253 15243417753 0022545 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->collector()->testSuiteStarted($event);
}
}
phpunit/src/Runner/TestResult/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001307 15243417753 0023226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->collector()->testConsideredRisky($event);
}
}
phpunit/src/Runner/Version.php 0000644 00000003113 15243417753 0012442 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_slice;
use function dirname;
use function explode;
use function implode;
use function str_contains;
use SebastianBergmann\Version as VersionId;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Version
{
private static string $pharVersion = '';
private static string $version = '';
/**
* Returns the current version of PHPUnit.
*/
public static function id(): string
{
if (self::$pharVersion !== '') {
return self::$pharVersion;
}
if (self::$version === '') {
self::$version = (new VersionId('10.5.20', dirname(__DIR__, 2)))->asString();
}
return self::$version;
}
public static function series(): string
{
if (str_contains(self::id(), '-')) {
$version = explode('-', self::id(), 2)[0];
} else {
$version = self::id();
}
return implode('.', array_slice(explode('.', $version), 0, 2));
}
public static function majorVersionNumber(): int
{
return (int) explode('.', self::series())[0];
}
public static function getVersionString(): string
{
return 'PHPUnit ' . self::id() . ' by Sebastian Bergmann and contributors.';
}
}
phpunit/src/Runner/TestSuiteSorter.php 0000644 00000023311 15243417753 0014147 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_diff;
use function array_merge;
use function array_reverse;
use function array_splice;
use function count;
use function in_array;
use function max;
use function shuffle;
use function usort;
use PHPUnit\Framework\DataProviderTestSuite;
use PHPUnit\Framework\Reorderable;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\ResultCache\NullResultCache;
use PHPUnit\Runner\ResultCache\ResultCache;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteSorter
{
/**
* @var int
*/
public const ORDER_DEFAULT = 0;
/**
* @var int
*/
public const ORDER_RANDOMIZED = 1;
/**
* @var int
*/
public const ORDER_REVERSED = 2;
/**
* @var int
*/
public const ORDER_DEFECTS_FIRST = 3;
/**
* @var int
*/
public const ORDER_DURATION = 4;
/**
* @var int
*/
public const ORDER_SIZE = 5;
private const SIZE_SORT_WEIGHT = [
'small' => 1,
'medium' => 2,
'large' => 3,
'unknown' => 4,
];
/**
* @psalm-var array<string, int> Associative array of (string => DEFECT_SORT_WEIGHT) elements
*/
private array $defectSortOrder = [];
private readonly ResultCache $cache;
/**
* @psalm-var array<string> A list of normalized names of tests before reordering
*/
private array $originalExecutionOrder = [];
/**
* @psalm-var array<string> A list of normalized names of tests affected by reordering
*/
private array $executionOrder = [];
public function __construct(?ResultCache $cache = null)
{
$this->cache = $cache ?? new NullResultCache;
}
/**
* @throws Exception
*/
public function reorderTestsInSuite(Test $suite, int $order, bool $resolveDependencies, int $orderDefects, bool $isRootTestSuite = true): void
{
$allowedOrders = [
self::ORDER_DEFAULT,
self::ORDER_REVERSED,
self::ORDER_RANDOMIZED,
self::ORDER_DURATION,
self::ORDER_SIZE,
];
if (!in_array($order, $allowedOrders, true)) {
throw new InvalidOrderException;
}
$allowedOrderDefects = [
self::ORDER_DEFAULT,
self::ORDER_DEFECTS_FIRST,
];
if (!in_array($orderDefects, $allowedOrderDefects, true)) {
throw new InvalidOrderException;
}
if ($isRootTestSuite) {
$this->originalExecutionOrder = $this->calculateTestExecutionOrder($suite);
}
if ($suite instanceof TestSuite) {
foreach ($suite as $_suite) {
$this->reorderTestsInSuite($_suite, $order, $resolveDependencies, $orderDefects, false);
}
if ($orderDefects === self::ORDER_DEFECTS_FIRST) {
$this->addSuiteToDefectSortOrder($suite);
}
$this->sort($suite, $order, $resolveDependencies, $orderDefects);
}
if ($isRootTestSuite) {
$this->executionOrder = $this->calculateTestExecutionOrder($suite);
}
}
public function getOriginalExecutionOrder(): array
{
return $this->originalExecutionOrder;
}
public function getExecutionOrder(): array
{
return $this->executionOrder;
}
private function sort(TestSuite $suite, int $order, bool $resolveDependencies, int $orderDefects): void
{
if (empty($suite->tests())) {
return;
}
if ($order === self::ORDER_REVERSED) {
$suite->setTests($this->reverse($suite->tests()));
} elseif ($order === self::ORDER_RANDOMIZED) {
$suite->setTests($this->randomize($suite->tests()));
} elseif ($order === self::ORDER_DURATION) {
$suite->setTests($this->sortByDuration($suite->tests()));
} elseif ($order === self::ORDER_SIZE) {
$suite->setTests($this->sortBySize($suite->tests()));
}
if ($orderDefects === self::ORDER_DEFECTS_FIRST) {
$suite->setTests($this->sortDefectsFirst($suite->tests()));
}
if ($resolveDependencies && !($suite instanceof DataProviderTestSuite)) {
$tests = $suite->tests();
$suite->setTests($this->resolveDependencies($tests));
}
}
private function addSuiteToDefectSortOrder(TestSuite $suite): void
{
$max = 0;
foreach ($suite->tests() as $test) {
if (!$test instanceof Reorderable) {
continue;
}
if (!isset($this->defectSortOrder[$test->sortId()])) {
$this->defectSortOrder[$test->sortId()] = $this->cache->status($test->sortId())->asInt();
$max = max($max, $this->defectSortOrder[$test->sortId()]);
}
}
$this->defectSortOrder[$suite->sortId()] = $max;
}
private function reverse(array $tests): array
{
return array_reverse($tests);
}
private function randomize(array $tests): array
{
shuffle($tests);
return $tests;
}
private function sortDefectsFirst(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpDefectPriorityAndTime($left, $right),
);
return $tests;
}
private function sortByDuration(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpDuration($left, $right),
);
return $tests;
}
private function sortBySize(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpSize($left, $right),
);
return $tests;
}
/**
* Comparator callback function to sort tests for "reach failure as fast as possible".
*
* 1. sort tests by defect weight defined in self::DEFECT_SORT_WEIGHT
* 2. when tests are equally defective, sort the fastest to the front
* 3. do not reorder successful tests
*/
private function cmpDefectPriorityAndTime(Test $a, Test $b): int
{
if (!($a instanceof Reorderable && $b instanceof Reorderable)) {
return 0;
}
$priorityA = $this->defectSortOrder[$a->sortId()] ?? 0;
$priorityB = $this->defectSortOrder[$b->sortId()] ?? 0;
if ($priorityB <=> $priorityA) {
// Sort defect weight descending
return $priorityB <=> $priorityA;
}
if ($priorityA || $priorityB) {
return $this->cmpDuration($a, $b);
}
// do not change execution order
return 0;
}
/**
* Compares test duration for sorting tests by duration ascending.
*/
private function cmpDuration(Test $a, Test $b): int
{
if (!($a instanceof Reorderable && $b instanceof Reorderable)) {
return 0;
}
return $this->cache->time($a->sortId()) <=> $this->cache->time($b->sortId());
}
/**
* Compares test size for sorting tests small->medium->large->unknown.
*/
private function cmpSize(Test $a, Test $b): int
{
$sizeA = ($a instanceof TestCase || $a instanceof DataProviderTestSuite)
? $a->size()->asString()
: 'unknown';
$sizeB = ($b instanceof TestCase || $b instanceof DataProviderTestSuite)
? $b->size()->asString()
: 'unknown';
return self::SIZE_SORT_WEIGHT[$sizeA] <=> self::SIZE_SORT_WEIGHT[$sizeB];
}
/**
* Reorder Tests within a TestCase in such a way as to resolve as many dependencies as possible.
* The algorithm will leave the tests in original running order when it can.
* For more details see the documentation for test dependencies.
*
* Short description of algorithm:
* 1. Pick the next Test from remaining tests to be checked for dependencies.
* 2. If the test has no dependencies: mark done, start again from the top
* 3. If the test has dependencies but none left to do: mark done, start again from the top
* 4. When we reach the end add any leftover tests to the end. These will be marked 'skipped' during execution.
*
* @psalm-param array<DataProviderTestSuite|TestCase> $tests
*
* @psalm-return array<DataProviderTestSuite|TestCase>
*/
private function resolveDependencies(array $tests): array
{
$newTestOrder = [];
$i = 0;
$provided = [];
do {
if ([] === array_diff($tests[$i]->requires(), $provided)) {
$provided = array_merge($provided, $tests[$i]->provides());
$newTestOrder = array_merge($newTestOrder, array_splice($tests, $i, 1));
$i = 0;
} else {
$i++;
}
} while (!empty($tests) && ($i < count($tests)));
return array_merge($newTestOrder, $tests);
}
private function calculateTestExecutionOrder(Test $suite): array
{
$tests = [];
if ($suite instanceof TestSuite) {
foreach ($suite->tests() as $test) {
if (!$test instanceof TestSuite && $test instanceof Reorderable) {
$tests[] = $test->sortId();
} else {
$tests = array_merge($tests, $this->calculateTestExecutionOrder($test));
}
}
}
return $tests;
}
}
phpunit/src/Runner/CodeCoverage.php 0000644 00000033022 15243417753 0013345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function file_put_contents;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\TestCase;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Output\Printer;
use SebastianBergmann\CodeCoverage\Driver\Driver;
use SebastianBergmann\CodeCoverage\Driver\Selector;
use SebastianBergmann\CodeCoverage\Exception as CodeCoverageException;
use SebastianBergmann\CodeCoverage\Filter;
use SebastianBergmann\CodeCoverage\Report\Clover as CloverReport;
use SebastianBergmann\CodeCoverage\Report\Cobertura as CoberturaReport;
use SebastianBergmann\CodeCoverage\Report\Crap4j as Crap4jReport;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Html\CustomCssFile;
use SebastianBergmann\CodeCoverage\Report\Html\Facade as HtmlReport;
use SebastianBergmann\CodeCoverage\Report\PHP as PhpReport;
use SebastianBergmann\CodeCoverage\Report\Text as TextReport;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\CodeCoverage\Report\Xml\Facade as XmlReport;
use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
use SebastianBergmann\CodeCoverage\Test\TestStatus\TestStatus;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Timer\NoActiveTimerException;
use SebastianBergmann\Timer\Timer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverage
{
private static ?self $instance = null;
private ?\SebastianBergmann\CodeCoverage\CodeCoverage $codeCoverage = null;
private ?Driver $driver = null;
private bool $collecting = false;
private ?TestCase $test = null;
private ?Timer $timer = null;
/**
* @psalm-var array<string,list<int>>
*/
private array $linesToBeIgnored = [];
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public function init(Configuration $configuration, CodeCoverageFilterRegistry $codeCoverageFilterRegistry, bool $extensionRequiresCodeCoverageCollection): void
{
$codeCoverageFilterRegistry->init($configuration);
if (!$configuration->hasCoverageReport() && !$extensionRequiresCodeCoverageCollection) {
return;
}
$this->activate($codeCoverageFilterRegistry->get(), $configuration->pathCoverage());
if (!$this->isActive()) {
return;
}
if ($configuration->hasCoverageCacheDirectory()) {
$this->codeCoverage()->cacheStaticAnalysis($configuration->coverageCacheDirectory());
}
$this->codeCoverage()->excludeSubclassesOfThisClassFromUnintentionallyCoveredCodeCheck(Comparator::class);
if ($configuration->strictCoverage()) {
$this->codeCoverage()->enableCheckForUnintentionallyCoveredCode();
}
if ($configuration->ignoreDeprecatedCodeUnitsFromCodeCoverage()) {
$this->codeCoverage()->ignoreDeprecatedCode();
} else {
$this->codeCoverage()->doNotIgnoreDeprecatedCode();
}
if ($configuration->disableCodeCoverageIgnore()) {
$this->codeCoverage()->disableAnnotationsForIgnoringCode();
} else {
$this->codeCoverage()->enableAnnotationsForIgnoringCode();
}
if ($configuration->includeUncoveredFiles()) {
$this->codeCoverage()->includeUncoveredFiles();
} else {
$this->codeCoverage()->excludeUncoveredFiles();
}
if ($codeCoverageFilterRegistry->get()->isEmpty()) {
if (!$codeCoverageFilterRegistry->configured()) {
EventFacade::emitter()->testRunnerTriggeredWarning(
'No filter is configured, code coverage will not be processed',
);
} else {
EventFacade::emitter()->testRunnerTriggeredWarning(
'Incorrect filter configuration, code coverage will not be processed',
);
}
$this->deactivate();
}
}
/**
* @psalm-assert-if-true !null $this->instance
*/
public function isActive(): bool
{
return $this->codeCoverage !== null;
}
public function codeCoverage(): \SebastianBergmann\CodeCoverage\CodeCoverage
{
return $this->codeCoverage;
}
public function driver(): Driver
{
return $this->driver;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public function start(TestCase $test): void
{
if ($this->collecting) {
return;
}
$size = TestSize::unknown();
if ($test->size()->isSmall()) {
$size = TestSize::small();
} elseif ($test->size()->isMedium()) {
$size = TestSize::medium();
} elseif ($test->size()->isLarge()) {
$size = TestSize::large();
}
$this->test = $test;
$this->codeCoverage->start(
$test->valueObjectForEvents()->id(),
$size,
);
$this->collecting = true;
}
public function stop(bool $append = true, array|false $linesToBeCovered = [], array $linesToBeUsed = []): void
{
if (!$this->collecting) {
return;
}
$status = TestStatus::unknown();
if ($this->test !== null) {
if ($this->test->status()->isSuccess()) {
$status = TestStatus::success();
} else {
$status = TestStatus::failure();
}
}
/* @noinspection UnusedFunctionResultInspection */
$this->codeCoverage->stop($append, $status, $linesToBeCovered, $linesToBeUsed, $this->linesToBeIgnored);
$this->test = null;
$this->collecting = false;
}
public function deactivate(): void
{
$this->driver = null;
$this->codeCoverage = null;
$this->test = null;
}
public function generateReports(Printer $printer, Configuration $configuration): void
{
if (!$this->isActive()) {
return;
}
if ($configuration->hasCoveragePhp()) {
$this->codeCoverageGenerationStart($printer, 'PHP');
try {
$writer = new PhpReport;
$writer->process($this->codeCoverage(), $configuration->coveragePhp());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageClover()) {
$this->codeCoverageGenerationStart($printer, 'Clover XML');
try {
$writer = new CloverReport;
$writer->process($this->codeCoverage(), $configuration->coverageClover());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageCobertura()) {
$this->codeCoverageGenerationStart($printer, 'Cobertura XML');
try {
$writer = new CoberturaReport;
$writer->process($this->codeCoverage(), $configuration->coverageCobertura());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageCrap4j()) {
$this->codeCoverageGenerationStart($printer, 'Crap4J XML');
try {
$writer = new Crap4jReport($configuration->coverageCrap4jThreshold());
$writer->process($this->codeCoverage(), $configuration->coverageCrap4j());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageHtml()) {
$this->codeCoverageGenerationStart($printer, 'HTML');
try {
$customCssFile = CustomCssFile::default();
if ($configuration->hasCoverageHtmlCustomCssFile()) {
$customCssFile = CustomCssFile::from($configuration->coverageHtmlCustomCssFile());
}
$writer = new HtmlReport(
sprintf(
' and <a href="https://phpunit.de/">PHPUnit %s</a>',
Version::id(),
),
Colors::from(
$configuration->coverageHtmlColorSuccessLow(),
$configuration->coverageHtmlColorSuccessMedium(),
$configuration->coverageHtmlColorSuccessHigh(),
$configuration->coverageHtmlColorWarning(),
$configuration->coverageHtmlColorDanger(),
),
Thresholds::from(
$configuration->coverageHtmlLowUpperBound(),
$configuration->coverageHtmlHighLowerBound(),
),
$customCssFile,
);
$writer->process($this->codeCoverage(), $configuration->coverageHtml());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageText()) {
$processor = new TextReport(
Thresholds::default(),
$configuration->coverageTextShowUncoveredFiles(),
$configuration->coverageTextShowOnlySummary(),
);
$textReport = $processor->process($this->codeCoverage(), $configuration->colors());
if ($configuration->coverageText() === 'php://stdout') {
$printer->print($textReport);
} else {
file_put_contents($configuration->coverageText(), $textReport);
}
}
if ($configuration->hasCoverageXml()) {
$this->codeCoverageGenerationStart($printer, 'PHPUnit XML');
try {
$writer = new XmlReport(Version::id());
$writer->process($this->codeCoverage(), $configuration->coverageXml());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
}
/**
* @psalm-param array<string,list<int>> $linesToBeIgnored
*/
public function ignoreLines(array $linesToBeIgnored): void
{
$this->linesToBeIgnored = $linesToBeIgnored;
}
/**
* @psalm-return array<string,list<int>>
*/
public function linesToBeIgnored(): array
{
return $this->linesToBeIgnored;
}
private function activate(Filter $filter, bool $pathCoverage): void
{
try {
if ($pathCoverage) {
$this->driver = (new Selector)->forLineAndPathCoverage($filter);
} else {
$this->driver = (new Selector)->forLineCoverage($filter);
}
$this->codeCoverage = new \SebastianBergmann\CodeCoverage\CodeCoverage(
$this->driver,
$filter,
);
} catch (CodeCoverageException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
}
private function codeCoverageGenerationStart(Printer $printer, string $format): void
{
$printer->print(
sprintf(
"\nGenerating code coverage report in %s format ... ",
$format,
),
);
$this->timer()->start();
}
/**
* @throws NoActiveTimerException
*/
private function codeCoverageGenerationSucceeded(Printer $printer): void
{
$printer->print(
sprintf(
"done [%s]\n",
$this->timer()->stop()->asString(),
),
);
}
/**
* @throws NoActiveTimerException
*/
private function codeCoverageGenerationFailed(Printer $printer, CodeCoverageException $e): void
{
$printer->print(
sprintf(
"failed [%s]\n%s\n",
$this->timer()->stop()->asString(),
$e->getMessage(),
),
);
}
private function timer(): Timer
{
if ($this->timer === null) {
$this->timer = new Timer;
}
return $this->timer;
}
}
phpunit/src/Logging/EventLogger.php 0000644 00000003267 15243417753 0013365 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging;
use const FILE_APPEND;
use const LOCK_EX;
use const PHP_EOL;
use function file_put_contents;
use function implode;
use function preg_split;
use function str_repeat;
use function strlen;
use PHPUnit\Event\Event;
use PHPUnit\Event\Tracer\Tracer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class EventLogger implements Tracer
{
private readonly string $path;
private readonly bool $includeTelemetryInfo;
public function __construct(string $path, bool $includeTelemetryInfo)
{
$this->path = $path;
$this->includeTelemetryInfo = $includeTelemetryInfo;
}
public function trace(Event $event): void
{
$telemetryInfo = $this->telemetryInfo($event);
$indentation = PHP_EOL . str_repeat(' ', strlen($telemetryInfo));
$lines = preg_split('/\r\n|\r|\n/', $event->asString());
$flags = FILE_APPEND;
if (PHP_OS_FAMILY !== 'Windows' || $this->path !== 'php://stdout') {
$flags |= LOCK_EX;
}
file_put_contents(
$this->path,
$telemetryInfo . implode($indentation, $lines) . PHP_EOL,
$flags,
);
}
private function telemetryInfo(Event $event): string
{
if (!$this->includeTelemetryInfo) {
return '';
}
return $event->telemetryInfo()->asString() . ' ';
}
}
phpunit/src/Logging/JUnit/JunitXmlLogger.php 0000644 00000030703 15243417753 0015102 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use function assert;
use function basename;
use function is_int;
use function sprintf;
use function str_replace;
use function trim;
use DOMDocument;
use DOMElement;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Telemetry\Info;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\PreparationStarted;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Xml;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class JunitXmlLogger
{
private readonly Printer $printer;
private DOMDocument $document;
private DOMElement $root;
/**
* @var DOMElement[]
*/
private array $testSuites = [];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteTests = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteAssertions = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteErrors = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteFailures = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteSkipped = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteTimes = [0];
private int $testSuiteLevel = 0;
private ?DOMElement $currentTestCase = null;
private ?HRTime $time = null;
private bool $prepared = false;
private bool $preparationFailed = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$this->registerSubscribers($facade);
$this->createDocument();
}
public function flush(): void
{
$this->printer->print($this->document->saveXML());
$this->printer->flush();
}
public function testSuiteStarted(Started $event): void
{
$testSuite = $this->document->createElement('testsuite');
$testSuite->setAttribute('name', $event->testSuite()->name());
if ($event->testSuite()->isForTestClass()) {
$testSuite->setAttribute('file', $event->testSuite()->file());
}
if ($this->testSuiteLevel > 0) {
$this->testSuites[$this->testSuiteLevel]->appendChild($testSuite);
} else {
$this->root->appendChild($testSuite);
}
$this->testSuiteLevel++;
$this->testSuites[$this->testSuiteLevel] = $testSuite;
$this->testSuiteTests[$this->testSuiteLevel] = 0;
$this->testSuiteAssertions[$this->testSuiteLevel] = 0;
$this->testSuiteErrors[$this->testSuiteLevel] = 0;
$this->testSuiteFailures[$this->testSuiteLevel] = 0;
$this->testSuiteSkipped[$this->testSuiteLevel] = 0;
$this->testSuiteTimes[$this->testSuiteLevel] = 0;
}
public function testSuiteFinished(): void
{
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'tests',
(string) $this->testSuiteTests[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'assertions',
(string) $this->testSuiteAssertions[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'errors',
(string) $this->testSuiteErrors[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'failures',
(string) $this->testSuiteFailures[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'skipped',
(string) $this->testSuiteSkipped[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'time',
sprintf('%F', $this->testSuiteTimes[$this->testSuiteLevel]),
);
if ($this->testSuiteLevel > 1) {
$this->testSuiteTests[$this->testSuiteLevel - 1] += $this->testSuiteTests[$this->testSuiteLevel];
$this->testSuiteAssertions[$this->testSuiteLevel - 1] += $this->testSuiteAssertions[$this->testSuiteLevel];
$this->testSuiteErrors[$this->testSuiteLevel - 1] += $this->testSuiteErrors[$this->testSuiteLevel];
$this->testSuiteFailures[$this->testSuiteLevel - 1] += $this->testSuiteFailures[$this->testSuiteLevel];
$this->testSuiteSkipped[$this->testSuiteLevel - 1] += $this->testSuiteSkipped[$this->testSuiteLevel];
$this->testSuiteTimes[$this->testSuiteLevel - 1] += $this->testSuiteTimes[$this->testSuiteLevel];
}
$this->testSuiteLevel--;
}
/**
* @throws InvalidArgumentException
*/
public function testPreparationStarted(PreparationStarted $event): void
{
$this->createTestCase($event);
}
/**
* @throws InvalidArgumentException
*/
public function testPreparationFailed(): void
{
$this->preparationFailed = true;
}
/**
* @throws InvalidArgumentException
*/
public function testPrepared(): void
{
$this->prepared = true;
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
if (!$this->prepared || $this->preparationFailed) {
return;
}
$this->handleFinish($event->telemetryInfo(), $event->numberOfAssertionsPerformed());
}
/**
* @throws InvalidArgumentException
*/
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->handleIncompleteOrSkipped($event);
}
/**
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
$this->handleIncompleteOrSkipped($event);
}
/**
* @throws InvalidArgumentException
*/
public function testErrored(Errored $event): void
{
$this->handleFault($event, 'error');
$this->testSuiteErrors[$this->testSuiteLevel]++;
}
/**
* @throws InvalidArgumentException
*/
public function testFailed(Failed $event): void
{
$this->handleFault($event, 'failure');
$this->testSuiteFailures[$this->testSuiteLevel]++;
}
/**
* @throws InvalidArgumentException
*/
private function handleFinish(Info $telemetryInfo, int $numberOfAssertionsPerformed): void
{
assert($this->currentTestCase !== null);
assert($this->time !== null);
$time = $telemetryInfo->time()->duration($this->time)->asFloat();
$this->testSuiteAssertions[$this->testSuiteLevel] += $numberOfAssertionsPerformed;
$this->currentTestCase->setAttribute(
'assertions',
(string) $numberOfAssertionsPerformed,
);
$this->currentTestCase->setAttribute(
'time',
sprintf('%F', $time),
);
$this->testSuites[$this->testSuiteLevel]->appendChild(
$this->currentTestCase,
);
$this->testSuiteTests[$this->testSuiteLevel]++;
$this->testSuiteTimes[$this->testSuiteLevel] += $time;
$this->currentTestCase = null;
$this->time = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparationStartedSubscriber($this),
new TestPreparationFailedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestRunnerExecutionFinishedSubscriber($this),
);
}
private function createDocument(): void
{
$this->document = new DOMDocument('1.0', 'UTF-8');
$this->document->formatOutput = true;
$this->root = $this->document->createElement('testsuites');
$this->document->appendChild($this->root);
}
/**
* @throws InvalidArgumentException
*/
private function handleFault(Errored|Failed $event, string $type): void
{
if (!$this->prepared) {
$this->createTestCase($event);
}
assert($this->currentTestCase !== null);
$buffer = $this->testAsString($event->test());
$throwable = $event->throwable();
$buffer .= trim(
$throwable->description() . PHP_EOL .
$throwable->stackTrace(),
);
$fault = $this->document->createElement(
$type,
Xml::prepareString($buffer),
);
$fault->setAttribute('type', $throwable->className());
$this->currentTestCase->appendChild($fault);
if (!$this->prepared) {
$this->handleFinish($event->telemetryInfo(), 0);
}
}
/**
* @throws InvalidArgumentException
*/
private function handleIncompleteOrSkipped(MarkedIncomplete|Skipped $event): void
{
if (!$this->prepared) {
$this->createTestCase($event);
}
assert($this->currentTestCase !== null);
$skipped = $this->document->createElement('skipped');
$this->currentTestCase->appendChild($skipped);
$this->testSuiteSkipped[$this->testSuiteLevel]++;
if (!$this->prepared) {
$this->handleFinish($event->telemetryInfo(), 0);
}
}
/**
* @throws InvalidArgumentException
*/
private function testAsString(Test $test): string
{
if ($test->isPhpt()) {
return basename($test->file());
}
assert($test instanceof TestMethod);
return sprintf(
'%s::%s%s',
$test->className(),
$this->name($test),
PHP_EOL,
);
}
/**
* @throws InvalidArgumentException
*/
private function name(Test $test): string
{
if ($test->isPhpt()) {
return basename($test->file());
}
assert($test instanceof TestMethod);
if (!$test->testData()->hasDataFromDataProvider()) {
return $test->methodName();
}
$dataSetName = $test->testData()->dataFromDataProvider()->dataSetName();
if (is_int($dataSetName)) {
return sprintf(
'%s with data set #%d',
$test->methodName(),
$dataSetName,
);
}
return sprintf(
'%s with data set "%s"',
$test->methodName(),
$dataSetName,
);
}
/**
* @throws InvalidArgumentException
*
* @psalm-assert !null $this->currentTestCase
*/
private function createTestCase(Errored|Failed|MarkedIncomplete|PreparationStarted|Prepared|Skipped $event): void
{
$testCase = $this->document->createElement('testcase');
$test = $event->test();
$testCase->setAttribute('name', $this->name($test));
$testCase->setAttribute('file', $test->file());
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
$testCase->setAttribute('line', (string) $test->line());
$testCase->setAttribute('class', $test->className());
$testCase->setAttribute('classname', str_replace('\\', '.', $test->className()));
}
$this->currentTestCase = $testCase;
$this->time = $event->telemetryInfo()->time();
}
}
phpunit/src/Logging/JUnit/Subscriber/TestFailedSubscriber.php 0000644 00000001352 15243417753 0020341 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Failed $event): void
{
$this->logger()->testFailed($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/TestPreparationFailedSubscriber.php 0000644 00000001446 15243417753 0022552 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\PreparationFailed;
use PHPUnit\Event\Test\PreparationFailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparationFailedSubscriber extends Subscriber implements PreparationFailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(PreparationFailed $event): void
{
$this->logger()->testPreparationFailed();
}
}
phpunit/src/Logging/JUnit/Subscriber/TestPreparedSubscriber.php 0000644 00000001360 15243417753 0020716 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Prepared $event): void
{
$this->logger()->testPrepared();
}
}
phpunit/src/Logging/JUnit/Subscriber/TestFinishedSubscriber.php 0000644 00000001366 15243417753 0020713 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->logger()->testFinished($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/TestRunnerExecutionFinishedSubscriber.php 0000644 00000001304 15243417753 0023761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionFinishedSubscriber extends Subscriber implements ExecutionFinishedSubscriber
{
public function notify(ExecutionFinished $event): void
{
$this->logger()->flush();
}
}
phpunit/src/Logging/JUnit/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001240 15243417753 0021714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->logger()->testSuiteFinished();
}
}
phpunit/src/Logging/JUnit/Subscriber/TestSkippedSubscriber.php 0000644 00000001360 15243417753 0020553 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->logger()->testSkipped($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/Subscriber.php 0000644 00000001214 15243417753 0016371 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly JunitXmlLogger $logger;
public function __construct(JunitXmlLogger $logger)
{
$this->logger = $logger;
}
protected function logger(): JunitXmlLogger
{
return $this->logger;
}
}
phpunit/src/Logging/JUnit/Subscriber/TestErroredSubscriber.php 0000644 00000001360 15243417753 0020556 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Errored $event): void
{
$this->logger()->testErrored($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/TestPreparationStartedSubscriber.php 0000644 00000001462 15243417753 0022772 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\PreparationStarted;
use PHPUnit\Event\Test\PreparationStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparationStartedSubscriber extends Subscriber implements PreparationStartedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(PreparationStarted $event): void
{
$this->logger()->testPreparationStarted($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001446 15243417753 0022404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(MarkedIncomplete $event): void
{
$this->logger()->testMarkedIncomplete($event);
}
}
phpunit/src/Logging/JUnit/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001240 15243417753 0021571 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->logger()->testSuiteStarted($event);
}
}
phpunit/src/Logging/TeamCity/TeamCityLogger.php 0000644 00000024253 15243417753 0015540 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use function assert;
use function getmypid;
use function ini_get;
use function is_a;
use function round;
use function sprintf;
use function str_replace;
use function stripos;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuiteForTestClass;
use PHPUnit\Event\TestSuite\TestSuiteForTestMethodWithDataProvider;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\Exception as FrameworkException;
use PHPUnit\TextUI\Output\Printer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TeamCityLogger
{
private readonly Printer $printer;
private bool $isSummaryTestCountPrinted = false;
private ?HRTime $time = null;
private ?int $flowId;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$this->registerSubscribers($facade);
$this->setFlowId();
}
public function testSuiteStarted(TestSuiteStarted $event): void
{
$testSuite = $event->testSuite();
if (!$this->isSummaryTestCountPrinted) {
$this->isSummaryTestCountPrinted = true;
$this->writeMessage(
'testCount',
['count' => $testSuite->count()],
);
}
$parameters = ['name' => $testSuite->name()];
if ($testSuite->isForTestClass()) {
assert($testSuite instanceof TestSuiteForTestClass);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s',
$testSuite->file(),
$testSuite->name(),
);
} elseif ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s',
$testSuite->file(),
$testSuite->name(),
);
$parameters['name'] = $testSuite->methodName();
}
$this->writeMessage('testSuiteStarted', $parameters);
}
public function testSuiteFinished(TestSuiteFinished $event): void
{
$testSuite = $event->testSuite();
$parameters = ['name' => $testSuite->name()];
if ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$parameters['name'] = $testSuite->methodName();
}
$this->writeMessage('testSuiteFinished', $parameters);
}
public function testPrepared(Prepared $event): void
{
$test = $event->test();
$parameters = [
'name' => $test->name(),
];
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s::%s',
$test->file(),
$test->className(),
$test->name(),
);
}
$this->writeMessage('testStarted', $parameters);
$this->time = $event->telemetryInfo()->time();
}
/**
* @throws InvalidArgumentException
*/
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testIgnored',
[
'name' => $event->test()->name(),
'message' => $event->throwable()->message(),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$parameters = [
'name' => $event->test()->name(),
'message' => $event->message(),
];
$parameters['duration'] = $this->duration($event);
$this->writeMessage('testIgnored', $parameters);
}
/**
* @throws InvalidArgumentException
*/
public function testErrored(Errored $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testFailed',
[
'name' => $event->test()->name(),
'message' => $this->message($event->throwable()),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testFailed(Failed $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$parameters = [
'name' => $event->test()->name(),
'message' => $this->message($event->throwable()),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
];
if ($event->hasComparisonFailure()) {
$parameters['type'] = 'comparisonFailure';
$parameters['actual'] = $event->comparisonFailure()->actual();
$parameters['expected'] = $event->comparisonFailure()->expected();
}
$this->writeMessage('testFailed', $parameters);
}
/**
* @throws InvalidArgumentException
*/
public function testConsideredRisky(ConsideredRisky $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testFailed',
[
'name' => $event->test()->name(),
'message' => $event->message(),
'details' => '',
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
$this->writeMessage(
'testFinished',
[
'name' => $event->test()->name(),
'duration' => $this->duration($event),
],
);
$this->time = null;
}
public function flush(): void
{
$this->printer->flush();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestRunnerExecutionFinishedSubscriber($this),
);
}
private function setFlowId(): void
{
if (stripos(ini_get('disable_functions'), 'getmypid') === false) {
$this->flowId = getmypid();
}
}
private function writeMessage(string $eventName, array $parameters = []): void
{
$this->printer->print(
sprintf(
"\n##teamcity[%s",
$eventName,
),
);
if ($this->flowId !== null) {
$parameters['flowId'] = $this->flowId;
}
foreach ($parameters as $key => $value) {
$this->printer->print(
sprintf(
" %s='%s'",
$key,
$this->escape((string) $value),
),
);
}
$this->printer->print("]\n");
}
/**
* @throws InvalidArgumentException
*/
private function duration(Event $event): int
{
if ($this->time === null) {
return 0;
}
return (int) round($event->telemetryInfo()->time()->duration($this->time)->asFloat() * 1000);
}
private function escape(string $string): string
{
return str_replace(
['|', "'", "\n", "\r", ']', '['],
['||', "|'", '|n', '|r', '|]', '|['],
$string,
);
}
private function message(Throwable $throwable): string
{
if (is_a($throwable->className(), FrameworkException::class, true)) {
return $throwable->message();
}
$buffer = $throwable->className();
if (!empty($throwable->message())) {
$buffer .= ': ' . $throwable->message();
}
return $buffer;
}
private function details(Throwable $throwable): string
{
$buffer = $throwable->stackTrace();
while ($throwable->hasPrevious()) {
$throwable = $throwable->previous();
$buffer .= sprintf(
"\nCaused by\n%s\n%s",
$throwable->description(),
$throwable->stackTrace(),
);
}
return $buffer;
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestFailedSubscriber.php 0000644 00000001355 15243417753 0021032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Failed $event): void
{
$this->logger()->testFailed($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestPreparedSubscriber.php 0000644 00000001225 15243417753 0021404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->logger()->testPrepared($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestFinishedSubscriber.php 0000644 00000001371 15243417753 0021375 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->logger()->testFinished($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestRunnerExecutionFinishedSubscriber.php 0000644 00000001307 15243417753 0024452 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionFinishedSubscriber extends Subscriber implements ExecutionFinishedSubscriber
{
public function notify(ExecutionFinished $event): void
{
$this->logger()->flush();
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001251 15243417753 0022404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->logger()->testSuiteFinished($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestSkippedSubscriber.php 0000644 00000001363 15243417753 0021244 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->logger()->testSkipped($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/Subscriber.php 0000644 00000001217 15243417753 0017062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly TeamCityLogger $logger;
public function __construct(TeamCityLogger $logger)
{
$this->logger = $logger;
}
protected function logger(): TeamCityLogger
{
return $this->logger;
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestErroredSubscriber.php 0000644 00000001363 15243417753 0021247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Errored $event): void
{
$this->logger()->testErrored($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001451 15243417753 0023066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(MarkedIncomplete $event): void
{
$this->logger()->testMarkedIncomplete($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001243 15243417753 0022262 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->logger()->testSuiteStarted($event);
}
}
phpunit/src/Logging/TeamCity/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001443 15243417753 0022745 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(ConsideredRisky $event): void
{
$this->logger()->testConsideredRisky($event);
}
}
phpunit/src/Logging/TestDox/NamePrettifier.php 0000644 00000021110 15243417753 0015437 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function array_key_exists;
use function array_keys;
use function array_map;
use function array_pop;
use function array_values;
use function assert;
use function class_exists;
use function explode;
use function gettype;
use function implode;
use function is_bool;
use function is_float;
use function is_int;
use function is_object;
use function is_scalar;
use function method_exists;
use function preg_quote;
use function preg_replace;
use function rtrim;
use function sprintf;
use function str_contains;
use function str_ends_with;
use function str_replace;
use function str_starts_with;
use function strlen;
use function strtolower;
use function strtoupper;
use function substr;
use function trim;
use PHPUnit\Framework\TestCase;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\TestDox;
use PHPUnit\Util\Color;
use ReflectionEnum;
use ReflectionMethod;
use ReflectionObject;
use SebastianBergmann\Exporter\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NamePrettifier
{
/**
* @psalm-var array<string, int>
*/
private static array $strings = [];
/**
* @psalm-param class-string $className
*/
public function prettifyTestClassName(string $className): string
{
if (class_exists($className)) {
$classLevelTestDox = MetadataRegistry::parser()->forClass($className)->isTestDox();
if ($classLevelTestDox->isNotEmpty()) {
$classLevelTestDox = $classLevelTestDox->asArray()[0];
assert($classLevelTestDox instanceof TestDox);
return $classLevelTestDox->text();
}
}
$parts = explode('\\', $className);
$className = array_pop($parts);
if (str_ends_with($className, 'Test')) {
$className = substr($className, 0, strlen($className) - strlen('Test'));
}
if (str_starts_with($className, 'Tests')) {
$className = substr($className, strlen('Tests'));
} elseif (str_starts_with($className, 'Test')) {
$className = substr($className, strlen('Test'));
}
if (empty($className)) {
$className = 'UnnamedTests';
}
if (!empty($parts)) {
$parts[] = $className;
$fullyQualifiedName = implode('\\', $parts);
} else {
$fullyQualifiedName = $className;
}
$result = preg_replace('/(?<=[[:lower:]])(?=[[:upper:]])/u', ' ', $className);
if ($fullyQualifiedName !== $className) {
return $result . ' (' . $fullyQualifiedName . ')';
}
return $result;
}
// NOTE: this method is on a hot path and very performance sensitive. change with care.
public function prettifyTestMethodName(string $name): string
{
if ($name === '') {
return '';
}
$string = rtrim($name, '0123456789');
if (array_key_exists($string, self::$strings)) {
$name = $string;
} elseif ($string === $name) {
self::$strings[$string] = 1;
}
if (str_starts_with($name, 'test_')) {
$name = substr($name, 5);
} elseif (str_starts_with($name, 'test')) {
$name = substr($name, 4);
}
if ($name === '') {
return '';
}
$name[0] = strtoupper($name[0]);
$noUnderscore = str_replace('_', ' ', $name);
if ($noUnderscore !== $name) {
return trim($noUnderscore);
}
$wasNumeric = false;
$buffer = '';
$len = strlen($name);
for ($i = 0; $i < $len; $i++) {
if ($i > 0 && $name[$i] >= 'A' && $name[$i] <= 'Z') {
$buffer .= ' ' . strtolower($name[$i]);
} else {
$isNumeric = $name[$i] >= '0' && $name[$i] <= '9';
if (!$wasNumeric && $isNumeric) {
$buffer .= ' ';
$wasNumeric = true;
}
if ($wasNumeric && !$isNumeric) {
$wasNumeric = false;
}
$buffer .= $name[$i];
}
}
return $buffer;
}
public function prettifyTestCase(TestCase $test, bool $colorize): string
{
$annotationWithPlaceholders = false;
$methodLevelTestDox = MetadataRegistry::parser()->forMethod($test::class, $test->name())->isTestDox()->isMethodLevel();
if ($methodLevelTestDox->isNotEmpty()) {
$methodLevelTestDox = $methodLevelTestDox->asArray()[0];
assert($methodLevelTestDox instanceof TestDox);
$result = $methodLevelTestDox->text();
if (str_contains($result, '$')) {
$annotation = $result;
$providedData = $this->mapTestMethodParameterNamesToProvidedDataValues($test, $colorize);
$variables = array_map(
static fn (string $variable): string => sprintf(
'/%s(?=\b)/',
preg_quote($variable, '/'),
),
array_keys($providedData),
);
$result = trim(preg_replace($variables, $providedData, $annotation));
$annotationWithPlaceholders = true;
}
} else {
$result = $this->prettifyTestMethodName($test->name());
}
if (!$annotationWithPlaceholders && $test->usesDataProvider()) {
$result .= $this->prettifyDataSet($test, $colorize);
}
return $result;
}
public function prettifyDataSet(TestCase $test, bool $colorize): string
{
if (!$colorize) {
return $test->dataSetAsString();
}
if (is_int($test->dataName())) {
return Color::dim(' with data set ') . Color::colorize('fg-cyan', (string) $test->dataName());
}
return Color::dim(' with ') . Color::colorize('fg-cyan', Color::visualizeWhitespace($test->dataName()));
}
private function mapTestMethodParameterNamesToProvidedDataValues(TestCase $test, bool $colorize): array
{
assert(method_exists($test, $test->name()));
/** @noinspection PhpUnhandledExceptionInspection */
$reflector = new ReflectionMethod($test::class, $test->name());
$providedData = [];
$providedDataValues = array_values($test->providedData());
$i = 0;
$providedData['$_dataName'] = $test->dataName();
foreach ($reflector->getParameters() as $parameter) {
if (!array_key_exists($i, $providedDataValues) && $parameter->isDefaultValueAvailable()) {
$providedDataValues[$i] = $parameter->getDefaultValue();
}
$value = $providedDataValues[$i++] ?? null;
if (is_object($value)) {
$reflector = new ReflectionObject($value);
if ($reflector->isEnum()) {
$enumReflector = new ReflectionEnum($value);
if ($enumReflector->isBacked()) {
$value = $value->value;
} else {
$value = $value->name;
}
} elseif ($reflector->hasMethod('__toString')) {
$value = (string) $value;
} else {
$value = $value::class;
}
}
if (!is_scalar($value)) {
$value = gettype($value);
if ($value === 'NULL') {
$value = 'null';
}
}
if (is_bool($value) || is_int($value) || is_float($value)) {
$value = (new Exporter)->export($value);
}
if ($value === '') {
if ($colorize) {
$value = Color::colorize('dim,underlined', 'empty');
} else {
$value = "''";
}
}
$providedData['$' . $parameter->getName()] = $value;
}
if ($colorize) {
$providedData = array_map(
static fn ($value) => Color::colorize('fg-cyan', Color::visualizeWhitespace((string) $value, true)),
$providedData,
);
}
return $providedData;
}
}
phpunit/src/Logging/TestDox/PlainTextRenderer.php 0000644 00000003613 15243417753 0016130 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PlainTextRenderer
{
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function render(array $tests): string
{
$buffer = '';
foreach ($tests as $prettifiedClassName => $_tests) {
$buffer .= $prettifiedClassName . "\n";
foreach ($this->reduce($_tests) as $prettifiedMethodName => $outcome) {
$buffer .= sprintf(
' [%s] %s' . "\n",
$outcome,
$prettifiedMethodName,
);
}
$buffer .= "\n";
}
return $buffer;
}
/**
* @psalm-return array<string, 'x'|' '>
*/
private function reduce(TestResultCollection $tests): array
{
$result = [];
foreach ($tests as $test) {
$prettifiedMethodName = $test->test()->testDox()->prettifiedMethodName();
$success = true;
if ($test->status()->isError() ||
$test->status()->isFailure() ||
$test->status()->isIncomplete() ||
$test->status()->isSkipped()) {
$success = false;
}
if (!isset($result[$prettifiedMethodName])) {
$result[$prettifiedMethodName] = $success ? 'x' : ' ';
continue;
}
if ($success) {
continue;
}
$result[$prettifiedMethodName] = ' ';
}
return $result;
}
}
phpunit/src/Logging/TestDox/TestResult/TestResult.php 0000644 00000002434 15243417753 0016765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResult
{
private readonly TestMethod $test;
private readonly TestStatus $status;
private readonly ?Throwable $throwable;
public function __construct(TestMethod $test, TestStatus $status, ?Throwable $throwable)
{
$this->test = $test;
$this->status = $status;
$this->throwable = $throwable;
}
public function test(): TestMethod
{
return $this->test;
}
public function status(): TestStatus
{
return $this->status;
}
/**
* @psalm-assert-if-true !null $this->throwable
*/
public function hasThrowable(): bool
{
return $this->throwable !== null;
}
public function throwable(): ?Throwable
{
return $this->throwable;
}
}
phpunit/src/Logging/TestDox/TestResult/TestResultCollectionIterator.php 0000644 00000002324 15243417753 0022511 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, TestResult>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollectionIterator implements Iterator
{
/**
* @psalm-var list<TestResult>
*/
private readonly array $testResults;
private int $position = 0;
public function __construct(TestResultCollection $testResults)
{
$this->testResults = $testResults->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->testResults);
}
public function key(): int
{
return $this->position;
}
public function current(): TestResult
{
return $this->testResults[$this->position];
}
public function next(): void
{
$this->position++;
}
}
phpunit/src/Logging/TestDox/TestResult/TestResultCollection.php 0000644 00000002312 15243417753 0020774 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, TestResult>
*
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollection implements IteratorAggregate
{
/**
* @psalm-var list<TestResult>
*/
private readonly array $testResults;
/**
* @psalm-param list<TestResult> $testResults
*/
public static function fromArray(array $testResults): self
{
return new self(...$testResults);
}
private function __construct(TestResult ...$testResults)
{
$this->testResults = $testResults;
}
/**
* @psalm-return list<TestResult>
*/
public function asArray(): array
{
return $this->testResults;
}
public function getIterator(): TestResultCollectionIterator
{
return new TestResultCollectionIterator($this);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001301 15243417753 0024704 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->collector()->testTriggeredNotice($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestFailedSubscriber.php 0000644 00000001213 15243417753 0023014 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->collector()->testFailed($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001361 15243417753 0026446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpunitWarning($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001361 15243417753 0026376 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpDeprecation($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001307 15243417753 0025076 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testTriggeredWarning($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestPreparedSubscriber.php 0000644 00000001227 15243417753 0023377 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->collector()->testPrepared($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitErrorSubscriber.php 0000644 00000001345 15243417753 0026134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitErrorSubscriber extends Subscriber implements PhpunitErrorTriggeredSubscriber
{
public function notify(PhpunitErrorTriggered $event): void
{
$this->collector()->testTriggeredPhpunitError($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001323 15243417753 0025360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->collector()->testTriggeredPhpNotice($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestFinishedSubscriber.php 0000644 00000001373 15243417753 0023370 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->collector()->testFinished($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestSkippedSubscriber.php 0000644 00000001221 15243417753 0023226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSkipped($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestPassedSubscriber.php 0000644 00000001213 15243417753 0023047 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Passed;
use PHPUnit\Event\Test\PassedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPassedSubscriber extends Subscriber implements PassedSubscriber
{
public function notify(Passed $event): void
{
$this->collector()->testPassed($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/Subscriber.php 0000644 00000001257 15243417753 0021057 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly TestResultCollector $collector;
public function __construct(TestResultCollector $collector)
{
$this->collector = $collector;
}
protected function collector(): TestResultCollector
{
return $this->collector;
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestErroredSubscriber.php 0000644 00000001221 15243417753 0023231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->collector()->testErrored($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001411 15243417753 0027272 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpunitDeprecation($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001331 15243417753 0025543 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpWarning($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001337 15243417753 0025731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testTriggeredDeprecation($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001307 15243417753 0025057 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->collector()->testMarkedIncomplete($event);
}
}
phpunit/src/Logging/TestDox/TestResult/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001301 15243417753 0024727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->collector()->testConsideredRisky($event);
}
}
phpunit/src/Logging/TestDox/TestResult/TestResultCollector.php 0000644 00000023754 15243417753 0020644 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function array_keys;
use function array_merge;
use function assert;
use function is_subclass_of;
use function ksort;
use function uksort;
use function usort;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\Passed;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Logging\TestDox\TestResult as TestDoxTestMethod;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollector
{
/**
* @psalm-var array<string, list<TestDoxTestMethod>>
*/
private array $tests = [];
private ?TestStatus $status = null;
private ?Throwable $throwable = null;
private bool $prepared = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade)
{
$this->registerSubscribers($facade);
}
/**
* @psalm-return array<string, TestResultCollection>
*/
public function testMethodsGroupedByClass(): array
{
$result = [];
foreach ($this->tests as $prettifiedClassName => $tests) {
$testsByDeclaringClass = [];
foreach ($tests as $test) {
$declaringClassName = (new ReflectionMethod($test->test()->className(), $test->test()->methodName()))->getDeclaringClass()->getName();
if (!isset($testsByDeclaringClass[$declaringClassName])) {
$testsByDeclaringClass[$declaringClassName] = [];
}
$testsByDeclaringClass[$declaringClassName][] = $test;
}
foreach (array_keys($testsByDeclaringClass) as $declaringClassName) {
usort(
$testsByDeclaringClass[$declaringClassName],
static function (TestDoxTestMethod $a, TestDoxTestMethod $b): int
{
return $a->test()->line() <=> $b->test()->line();
},
);
}
uksort(
$testsByDeclaringClass,
/**
* @psalm-param class-string $a
* @psalm-param class-string $b
*/
static function (string $a, string $b): int
{
if (is_subclass_of($b, $a)) {
return -1;
}
if (is_subclass_of($a, $b)) {
return 1;
}
return 0;
},
);
$tests = [];
foreach ($testsByDeclaringClass as $_tests) {
$tests = array_merge($tests, $_tests);
}
$result[$prettifiedClassName] = TestResultCollection::fromArray($tests);
}
ksort($result);
return $result;
}
public function testPrepared(Prepared $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::unknown();
$this->throwable = null;
$this->prepared = true;
}
public function testErrored(Errored $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::error($event->throwable()->message());
$this->throwable = $event->throwable();
if (!$this->prepared) {
$test = $event->test();
assert($test instanceof TestMethod);
$this->process($test);
}
}
public function testFailed(Failed $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::failure($event->throwable()->message());
$this->throwable = $event->throwable();
}
public function testPassed(Passed $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::success());
}
public function testSkipped(Skipped $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::skipped($event->message()));
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::incomplete($event->throwable()->message()));
$this->throwable = $event->throwable();
}
public function testConsideredRisky(ConsideredRisky $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::risky());
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpunitDeprecation(PhpunitDeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpunitError(PhpunitErrorTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::error());
}
public function testTriggeredPhpunitWarning(PhpunitWarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$test = $event->test();
assert($test instanceof TestMethod);
$this->process($test);
$this->status = null;
$this->throwable = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestFinishedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestPassedSubscriber($this),
new TestPreparedSubscriber($this),
new TestSkippedSubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitErrorSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
}
private function updateTestStatus(TestStatus $status): void
{
if ($this->status !== null &&
$this->status->isMoreImportantThan($status)) {
return;
}
$this->status = $status;
}
private function process(TestMethod $test): void
{
if (!isset($this->tests[$test->testDox()->prettifiedClassName()])) {
$this->tests[$test->testDox()->prettifiedClassName()] = [];
}
$this->tests[$test->testDox()->prettifiedClassName()][] = new TestDoxTestMethod(
$test,
$this->status,
$this->throwable,
);
}
}
phpunit/src/Logging/TestDox/HtmlRenderer.php 0000644 00000007061 15243417753 0015125 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class HtmlRenderer
{
/**
* @var string
*/
private const PAGE_HEADER = <<<'EOT'
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8"/>
<title>Test Documentation</title>
<style>
body {
text-rendering: optimizeLegibility;
font-family: Source SansSerif Pro, Arial, sans-serif;
font-variant-ligatures: common-ligatures;
font-kerning: normal;
margin-left: 2rem;
background-color: #fff;
color: #000;
}
body > ul > li {
font-size: larger;
}
h2 {
font-size: larger;
text-decoration-line: underline;
text-decoration-thickness: 2px;
margin: 0;
padding: 0.5rem 0;
}
ul {
list-style: none;
margin: 0 0 2rem;
padding: 0 0 0 1rem;
text-indent: -1rem;
}
.success:before {
color: #4e9a06;
content: '✓';
padding-right: 0.5rem;
}
.defect {
color: #a40000;
}
.defect:before {
color: #a40000;
content: '✗';
padding-right: 0.5rem;
}
</style>
</head>
<body>
EOT;
/**
* @var string
*/
private const CLASS_HEADER = <<<'EOT'
<h2>%s</h2>
<ul>
EOT;
/**
* @var string
*/
private const CLASS_FOOTER = <<<'EOT'
</ul>
EOT;
/**
* @var string
*/
private const PAGE_FOOTER = <<<'EOT'
</body>
</html>
EOT;
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function render(array $tests): string
{
$buffer = self::PAGE_HEADER;
foreach ($tests as $prettifiedClassName => $_tests) {
$buffer .= sprintf(
self::CLASS_HEADER,
$prettifiedClassName,
);
foreach ($this->reduce($_tests) as $prettifiedMethodName => $outcome) {
$buffer .= sprintf(
" <li class=\"%s\">%s</li>\n",
$outcome,
$prettifiedMethodName,
);
}
$buffer .= self::CLASS_FOOTER;
}
return $buffer . self::PAGE_FOOTER;
}
/**
* @psalm-return array<string, 'success'|'defect'>
*/
private function reduce(TestResultCollection $tests): array
{
$result = [];
foreach ($tests as $test) {
$prettifiedMethodName = $test->test()->testDox()->prettifiedMethodName();
if (!isset($result[$prettifiedMethodName])) {
$result[$prettifiedMethodName] = $test->status()->isSuccess() ? 'success' : 'defect';
continue;
}
if ($test->status()->isSuccess()) {
continue;
}
$result[$prettifiedMethodName] = 'defect';
}
return $result;
}
}
phpunit/src/Logging/Exception.php 0000644 00000000742 15243417753 0013075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
phpunit/SECURITY.md 0000644 00000004371 15243417753 0010044 0 ustar 00 # Security Policy
If you believe you have found a security vulnerability in PHPUnit, please report it to us through coordinated disclosure.
**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**
Instead, please email `sebastian@phpunit.de`.
Please include as much of the information listed below as you can to help us better understand and resolve the issue:
* The type of issue
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
## Web Context
PHPUnit is a framework for writing as well as a command-line tool for running tests. Writing and running tests is a development-time activity. There is no reason why PHPUnit should be installed on a webserver and/or in a production environment.
**If you upload PHPUnit to a webserver then your deployment process is broken. On a more general note, if your `vendor` directory is publicly accessible on your webserver then your deployment process is also broken.**
Please note that if you upload PHPUnit to a webserver "bad things" may happen. [You have been warned.](https://thephp.cc/articles/phpunit-a-security-risk?ref=phpunit)
PHPUnit is developed with a focus on development environments and the command-line. No specific testing or hardening with regard to using PHPUnit in an HTTP or web context or with untrusted input data is performed. PHPUnit might also contain functionality that intentionally exposes internal application data for debugging purposes.
If PHPUnit is used in a web application, the application developer is responsible for filtering inputs or escaping outputs as necessary and for verifying that the used functionality is safe for use within the intended context.
Vulnerabilities specific to the use outside a development context will be fixed as applicable, provided that the fix does not have an averse effect on the primary use case for development purposes.
phpunit/schema/9.1.xsd 0000644 00000041325 15243417753 0010542 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="35"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="70"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
phpunit/schema/9.3.xsd 0000644 00000042674 15243417753 0010554 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.3 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/10.0.xsd 0000644 00000036404 15243417753 0010613 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/9.2.xsd 0000644 00000041334 15243417753 0010543 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.2 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="50"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="90"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
phpunit/schema/9.5.xsd 0000644 00000043104 15243417753 0010543 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="false"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/10.4.xsd 0000644 00000043107 15243417753 0010615 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.4 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="baseline" type="xs:anyURI"/>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/8.5.xsd 0000644 00000041323 15243417753 0010543 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 8.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="json"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="tap"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="50"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="90"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="false"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
phpunit/schema/9.4.xsd 0000644 00000043012 15243417753 0010540 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.4 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/10.2.xsd 0000644 00000042521 15243417753 0010612 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.2 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/9.0.xsd 0000644 00000041064 15243417753 0010541 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="35"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="70"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
phpunit/schema/10.3.xsd 0000644 00000043016 15243417753 0010613 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.3 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/schema/10.1.xsd 0000644 00000041253 15243417753 0010612 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.1 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/phpunit 0000755 00000005325 15243417753 0007670 0 ustar 00 #!/usr/bin/env php
<?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (!version_compare(PHP_VERSION, PHP_VERSION, '=')) {
fwrite(
STDERR,
sprintf(
'%s declares an invalid value for PHP_VERSION.' . PHP_EOL .
'This breaks fundamental functionality such as version_compare().' . PHP_EOL .
'Please use a different PHP interpreter.' . PHP_EOL,
PHP_BINARY
)
);
die(1);
}
if (version_compare('8.1.0', PHP_VERSION, '>')) {
fwrite(
STDERR,
sprintf(
'This version of PHPUnit requires PHP >= 8.1.' . PHP_EOL .
'You are using PHP %s (%s).' . PHP_EOL,
PHP_VERSION,
PHP_BINARY
)
);
die(1);
}
if (!ini_get('date.timezone')) {
ini_set('date.timezone', 'UTC');
}
if (isset($GLOBALS['_composer_autoload_path'])) {
define('PHPUNIT_COMPOSER_INSTALL', $GLOBALS['_composer_autoload_path']);
unset($GLOBALS['_composer_autoload_path']);
} else {
foreach (array(__DIR__ . '/../../autoload.php', __DIR__ . '/../vendor/autoload.php', __DIR__ . '/vendor/autoload.php') as $file) {
if (file_exists($file)) {
define('PHPUNIT_COMPOSER_INSTALL', $file);
break;
}
}
unset($file);
}
if (!defined('PHPUNIT_COMPOSER_INSTALL')) {
fwrite(
STDERR,
'You need to set up the project dependencies using Composer:' . PHP_EOL . PHP_EOL .
' composer install' . PHP_EOL . PHP_EOL .
'You can learn all about Composer on https://getcomposer.org/.' . PHP_EOL
);
die(1);
}
require PHPUNIT_COMPOSER_INSTALL;
$requiredExtensions = ['dom', 'json', 'libxml', 'mbstring', 'tokenizer', 'xml', 'xmlwriter'];
$unavailableExtensions = array_filter(
$requiredExtensions,
static function ($extension) {
return !extension_loaded($extension);
}
);
// Workaround for https://github.com/sebastianbergmann/phpunit/issues/5662
if (!function_exists('ctype_alnum')) {
$unavailableExtensions[] = 'ctype';
}
if ([] !== $unavailableExtensions) {
fwrite(
STDERR,
sprintf(
'PHPUnit requires the "%s" extensions, but the "%s" %s not available.' . PHP_EOL,
implode('", "', $requiredExtensions),
implode('", "', $unavailableExtensions),
count($unavailableExtensions) === 1 ? 'extension is' : 'extensions are'
)
);
die(1);
}
unset($requiredExtensions, $unavailableExtensions);
exit((new PHPUnit\TextUI\Application)->run($_SERVER['argv']));
phpunit/phpunit.xsd 0000644 00000043107 15243417753 0010462 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="baseline" type="xs:anyURI"/>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit/composer.json 0000644 00000004773 15243417753 0011003 0 ustar 00 {
"name": "phpunit/phpunit",
"description": "The PHP Unit Testing framework.",
"type": "library",
"keywords": [
"phpunit",
"xunit",
"testing"
],
"homepage": "https://phpunit.de/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/phpunit/issues",
"security": "https://github.com/sebastianbergmann/phpunit/security/policy"
},
"prefer-stable": true,
"require": {
"php": ">=8.1",
"ext-dom": "*",
"ext-json": "*",
"ext-libxml": "*",
"ext-mbstring": "*",
"ext-xml": "*",
"ext-xmlwriter": "*",
"myclabs/deep-copy": "^1.10.1",
"phar-io/manifest": "^2.0.3",
"phar-io/version": "^3.0.2",
"phpunit/php-code-coverage": "^10.1.5",
"phpunit/php-file-iterator": "^4.0",
"phpunit/php-invoker": "^4.0",
"phpunit/php-text-template": "^3.0",
"phpunit/php-timer": "^6.0",
"sebastian/cli-parser": "^2.0",
"sebastian/code-unit": "^2.0",
"sebastian/comparator": "^5.0",
"sebastian/diff": "^5.0",
"sebastian/environment": "^6.0",
"sebastian/exporter": "^5.1",
"sebastian/global-state": "^6.0.1",
"sebastian/object-enumerator": "^5.0",
"sebastian/recursion-context": "^5.0",
"sebastian/type": "^4.0",
"sebastian/version": "^4.0"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"suggest": {
"ext-soap": "To be able to generate mocks based on WSDL files"
},
"bin": [
"phpunit"
],
"autoload": {
"classmap": [
"src/"
],
"files": [
"src/Framework/Assert/Functions.php"
]
},
"autoload-dev": {
"classmap": [
"tests/"
],
"files": [
"tests/_files/CoverageNamespacedFunctionTest.php",
"tests/_files/CoveredFunction.php",
"tests/_files/Generator.php",
"tests/_files/NamespaceCoveredFunction.php",
"tests/end-to-end/code-coverage/ignore-function-using-attribute/src/CoveredFunction.php"
]
},
"extra": {
"branch-alias": {
"dev-main": "10.5-dev"
}
}
}
phpunit/DEPRECATIONS.md 0000644 00000032650 15243417753 0010456 0 ustar 00 # Deprecations
## Soft Deprecations
This functionality is currently [soft-deprecated](https://phpunit.de/backward-compatibility.html#soft-deprecation):
### Writing Tests
#### Assertions, Constraints, and Expectations
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|------------------------------------------------|--------|-------------|
| [#5472](https://github.com/sebastianbergmann/phpunit/issues/5472) | `TestCase::assertStringNotMatchesFormat()` | 10.4.0 | |
| [#5472](https://github.com/sebastianbergmann/phpunit/issues/5472) | `TestCase::assertStringNotMatchesFormatFile()` | 10.4.0 | |
#### Test Double API
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|---------------------------------------------------|--------|-----------------------------------------------------------------------------------------|
| [#5240](https://github.com/sebastianbergmann/phpunit/issues/5240) | `TestCase::createTestProxy()` | 10.1.0 | |
| [#5241](https://github.com/sebastianbergmann/phpunit/issues/5241) | `TestCase::getMockForAbstractClass()` | 10.1.0 | |
| [#5242](https://github.com/sebastianbergmann/phpunit/issues/5242) | `TestCase::getMockFromWsdl()` | 10.1.0 | |
| [#5243](https://github.com/sebastianbergmann/phpunit/issues/5243) | `TestCase::getMockForTrait()` | 10.1.0 | |
| [#5244](https://github.com/sebastianbergmann/phpunit/issues/5244) | `TestCase::getObjectForTrait()` | 10.1.0 | |
| [#5305](https://github.com/sebastianbergmann/phpunit/issues/5305) | `MockBuilder::getMockForAbstractClass()` | 10.1.0 | |
| [#5306](https://github.com/sebastianbergmann/phpunit/issues/5306) | `MockBuilder::getMockForTrait()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::disableProxyingToOriginalMethods()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::enableProxyingToOriginalMethods()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::setProxyTarget()` | 10.1.0 | |
| [#5308](https://github.com/sebastianbergmann/phpunit/issues/5308) | `MockBuilder::allowMockingUnknownTypes()` | 10.1.0 | |
| [#5308](https://github.com/sebastianbergmann/phpunit/issues/5308) | `MockBuilder::disallowMockingUnknownTypes()` | 10.1.0 | |
| [#5309](https://github.com/sebastianbergmann/phpunit/issues/5309) | `MockBuilder::disableAutoload()` | 10.1.0 | |
| [#5309](https://github.com/sebastianbergmann/phpunit/issues/5309) | `MockBuilder::enableAutoload()` | 10.1.0 | |
| [#5315](https://github.com/sebastianbergmann/phpunit/issues/5315) | `MockBuilder::disableArgumentCloning()` | 10.1.0 | |
| [#5315](https://github.com/sebastianbergmann/phpunit/issues/5315) | `MockBuilder::enableArgumentCloning()` | 10.1.0 | |
| [#5320](https://github.com/sebastianbergmann/phpunit/issues/5320) | `MockBuilder::addMethods()` | 10.1.0 | |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::onConsecutiveCalls()` | 10.3.0 | Use `$double->willReturn()` instead of `$double->will($this->onConsecutiveCalls())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnArgument()` | 10.3.0 | Use `$double->willReturnArgument()` instead of `$double->will($this->returnArgument())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnCallback()` | 10.3.0 | Use `$double->willReturnCallback()` instead of `$double->will($this->returnCallback())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnSelf()` | 10.3.0 | Use `$double->willReturnSelf()` instead of `$double->will($this->returnSelf())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnValue()` | 10.3.0 | Use `$double->willReturn()` instead of `$double->will($this->returnValue())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnValueMap()` | 10.3.0 | Use `$double->willReturnMap()` instead of `$double->will($this->returnValueMap())` |
#### Miscellaneous
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|----------------------------------------------------------------|--------|--------------------------------------------------------------------|
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5236) | `PHPUnit\Framework\Attributes\CodeCoverageIgnore()` | 10.1.0 | |
| [#5214](https://github.com/sebastianbergmann/phpunit/issues/5214) | `TestCase::iniSet()` | 10.3.0 | |
| [#5216](https://github.com/sebastianbergmann/phpunit/issues/5216) | `TestCase::setLocale()` | 10.3.0 | |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreClassForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the class' doc-comment |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreMethodForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the method's doc-comment |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreFunctionForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the function's doc-comment |
### Running Tests
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|--------|-------------|
| [#5481](https://github.com/sebastianbergmann/phpunit/issues/5481) | `dataSet` attribute for `testCaseMethod` elements in the XML document generated by `--list-tests-xml` | 10.4.0 | |
### Extending PHPUnit
| Issue | Description | Since | Replacement |
|-------|------------------------------------------------------------------------------------------------------------------------------|--------|--------------------------------------------------------------------------------|
| | `PHPUnit\TextUI\Configuration\Configuration::coverageExcludeDirectories()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->excludeDirectories()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageExcludeFiles()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->excludeFiles()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageIncludeDirectories()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->includeDirectories()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageIncludeFiles()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->includeFiles()` |
| | `PHPUnit\TextUI\Configuration\Configuration::loadPharExtensions()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::noExtensions()` |
| | `PHPUnit\TextUI\Configuration\Configuration::hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->notEmpty()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictDeprecations()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictDeprecations()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictNotices()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictNotices()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictWarnings()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictWarnings()` |
| | `PHPUnit\TextUI\Configuration\Configuration::cliArgument()` | 10.4.0 | `PHPUnit\TextUI\Configuration\Configuration::cliArguments()[0]` |
| | `PHPUnit\TextUI\Configuration\Configuration::hasCliArgument()` | 10.4.0 | `PHPUnit\TextUI\Configuration\Configuration::hasCliArguments()` |
| | `PHPUnit\Framework\Constraint\Constraint::exporter()` | 10.4.0 | |
| | `PHPUnit\TextUI\Configuration\Configuration::registerMockObjectsFromTestArgumentsRecursively()` | 10.5.3 | |
| | `Test\AssertionFailed` and `Test\AssertionSucceeded` events | 10.5.3 | |
| | `PHPUnit\Runner\Extension\Facade::requireExportOfObjects()` and `PHPUnit\Runner\Extension\Facade::requiresExportOfObjects()` | 10.5.3 | |
## Hard Deprecations
This functionality is currently [hard-deprecated](https://phpunit.de/backward-compatibility.html#hard-deprecation):
### Writing Tests
#### Miscellaneous
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|---------|-------------|
| [#5100](https://github.com/sebastianbergmann/phpunit/issues/5100) | Support for non-static data provider methods, non-public data provider methods, and data provider methods that declare parameters | 10.0.0 | |
| [#5812](https://github.com/sebastianbergmann/phpunit/pull/5812) | Support for string array keys in data sets returned by data provider methods that do not match the parameter names of the test method(s) that use(s) them | 10.5.18 | |
phpunit/.phpstorm.meta.php 0000644 00000001375 15243417753 0011644 0 ustar 00 <?php
namespace PHPSTORM_META {
override(
\PHPUnit\Framework\TestCase::createStub(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createConfiguredStub(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createConfiguredMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createPartialMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createTestProxy(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::getMockForAbstractClass(0),
map([""=>"$0"])
);
}
phpunit/README.md 0000644 00000003761 15243417753 0007534 0 ustar 00 # PHPUnit
[](https://packagist.org/packages/phpunit/phpunit)
[](https://github.com/sebastianbergmann/phpunit/actions)
[](https://shepherd.dev/github/sebastianbergmann/phpunit)
[](https://codecov.io/gh/sebastianbergmann/phpunit)
PHPUnit is a programmer-oriented testing framework for PHP. It is an instance of the xUnit architecture for unit testing frameworks.
## Installation
We distribute a [PHP Archive (PHAR)](https://php.net/phar) that has all required (as well as some optional) dependencies of PHPUnit bundled in a single file:
```bash
$ wget https://phar.phpunit.de/phpunit-X.Y.phar
$ php phpunit-X.Y.phar --version
```
Please replace `X.Y` with the version of PHPUnit you are interested in.
Alternatively, you may use [Composer](https://getcomposer.org/) to download and install PHPUnit as well as its dependencies. Please refer to the [documentation](https://phpunit.de/documentation.html) for details on how to install PHPUnit.
## Contribute
Please refer to [CONTRIBUTING.md](https://github.com/sebastianbergmann/phpunit/blob/main/.github/CONTRIBUTING.md) for information on how to contribute to PHPUnit and its related projects.
## List of Contributors
Thanks to everyone who has contributed to PHPUnit! You can find a detailed list of contributors on every PHPUnit related package on GitHub. This list shows only the major components:
* [PHPUnit](https://github.com/sebastianbergmann/phpunit/graphs/contributors)
* [php-code-coverage](https://github.com/sebastianbergmann/php-code-coverage/graphs/contributors)
A very special thanks to everyone who has contributed to the [documentation](https://github.com/sebastianbergmann/phpunit-documentation-english/graphs/contributors).
phpunit/ChangeLog-10.5.md 0000644 00000027161 15243417753 0011007 0 ustar 00 # Changes in PHPUnit 10.5
All notable changes of the PHPUnit 10.5 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
## [10.5.20] - 2024-04-24
* [#5771](https://github.com/sebastianbergmann/phpunit/issues/5771): JUnit XML logger may crash when test that is run in separate process exits unexpectedly
* [#5819](https://github.com/sebastianbergmann/phpunit/issues/5819): Duplicate keys from different data providers are not handled properly
## [10.5.19] - 2024-04-17
### Fixed
* [#5818](https://github.com/sebastianbergmann/phpunit/issues/5818): Calling `method()` on a test stub created using `createStubForIntersectionOfInterfaces()` throws an unexpected exception
## [10.5.18] - 2024-04-14
### Deprecated
* [#5812](https://github.com/sebastianbergmann/phpunit/pull/5812): Support for string array keys in data sets returned by data provider methods that do not match the parameter names of the test method(s) that use(s) them
### Fixed
* [#5795](https://github.com/sebastianbergmann/phpunit/issues/5795): Using `@testWith` annotation may generate `PHP Warning: Uninitialized string offset 0`
## [10.5.17] - 2024-04-05
### Changed
* The namespaces of dependencies are now prefixed with `PHPUnitPHAR` instead of just `PHPUnit` for the PHAR distribution of PHPUnit
## [10.5.16] - 2024-03-28
### Changed
* [#5766](https://github.com/sebastianbergmann/phpunit/pull/5766): Do not use a shell in `proc_open()` if not really needed
* [#5772](https://github.com/sebastianbergmann/phpunit/pull/5772): Cleanup process handling after dropping temp-file handling
### Fixed
* [#5570](https://github.com/sebastianbergmann/phpunit/pull/5570): Windows does not support exclusive locks on stdout
## [10.5.15] - 2024-03-22
### Fixed
* [#5765](https://github.com/sebastianbergmann/phpunit/pull/5765): Be more forgiving with error handlers that do not respect error suppression
## [10.5.14] - 2024-03-21
### Changed
* [#5747](https://github.com/sebastianbergmann/phpunit/pull/5747): Cache result of `Groups::groups()`
* [#5748](https://github.com/sebastianbergmann/phpunit/pull/5748): Improve performance of `NamePrettifier::prettifyTestMethodName()`
* [#5750](https://github.com/sebastianbergmann/phpunit/pull/5750): Micro-optimize `NamePrettifier::prettifyTestMethodName()` once again
### Fixed
* [#5760](https://github.com/sebastianbergmann/phpunit/issues/5760): TestDox printer does not display details about exceptions raised in before-test methods
## [10.5.13] - 2024-03-12
### Changed
* [#5727](https://github.com/sebastianbergmann/phpunit/pull/5727): Prevent duplicate call of `NamePrettifier::prettifyTestMethodName()`
* [#5739](https://github.com/sebastianbergmann/phpunit/pull/5739): Micro-optimize `NamePrettifier::prettifyTestMethodName()`
* [#5740](https://github.com/sebastianbergmann/phpunit/pull/5740): Micro-optimize `TestRunner::runTestWithTimeout()`
* [#5741](https://github.com/sebastianbergmann/phpunit/pull/5741): Save call to `Telemetry\System::snapshot()`
* [#5742](https://github.com/sebastianbergmann/phpunit/pull/5742): Prevent file IO when not strictly necessary
* [#5743](https://github.com/sebastianbergmann/phpunit/pull/5743): Prevent unnecessary `ExecutionOrderDependency::getTarget()` call
* [#5744](https://github.com/sebastianbergmann/phpunit/pull/5744): Simplify `NamePrettifier::prettifyTestMethodName()`
### Fixed
* [#5351](https://github.com/sebastianbergmann/phpunit/issues/5351): Incorrect code coverage metadata does not prevent code coverage data from being collected
* [#5746](https://github.com/sebastianbergmann/phpunit/issues/5746): Using `-d` CLI option multiple times triggers warning
## [10.5.12] - 2024-03-09
### Fixed
* [#5652](https://github.com/sebastianbergmann/phpunit/issues/5652): `HRTime::duration()` throws `InvalidArgumentException`
## [10.5.11] - 2024-02-25
### Fixed
* [#5704](https://github.com/sebastianbergmann/phpunit/issues/5704#issuecomment-1951105254): No warning when CLI options are used multiple times
* [#5707](https://github.com/sebastianbergmann/phpunit/issues/5707): `--fail-on-empty-test-suite` CLI option is not documented in `--help` output
* No warning when the `#[CoversClass]` and `#[UsesClass]` attributes are used with the name of an interface
* Resource usage information is printed when the `--debug` CLI option is used
## [10.5.10] - 2024-02-04
### Changed
* Improve output of `--check-version` CLI option
* Improve description of `--check-version` CLI option
### Fixed
* [#5692](https://github.com/sebastianbergmann/phpunit/issues/5692): `--log-events-text` and `--log-events-verbose-text` require the destination file to exit
## [10.5.9] - 2024-01-22
### Changed
* Show help for `--manifest`, `--sbom`, and `--composer-lock` when the PHAR is used
### Fixed
* [#5676](https://github.com/sebastianbergmann/phpunit/issues/5676): PHPUnit's test runner overwrites custom error handler registered using `set_error_handler()` in bootstrap script
## [10.5.8] - 2024-01-19
### Fixed
* [#5673](https://github.com/sebastianbergmann/phpunit/issues/5673): Confusing error message when migration of a configuration is requested that does not need to be migrated
## [10.5.7] - 2024-01-14
### Fixed
* [#5662](https://github.com/sebastianbergmann/phpunit/issues/5662): PHPUnit errors out on startup when the `ctype` extension is not loaded but a polyfill for it was installed
## [10.5.6] - 2024-01-13
### Added
* Added the `--debug` CLI option as an alias for `--no-output --log-events-text php://stdout`
### Fixed
* [#5455](https://github.com/sebastianbergmann/phpunit/issues/5455): `willReturnCallback()` does not pass unknown named variadic arguments to callback
* [#5488](https://github.com/sebastianbergmann/phpunit/issues/5488): Details about tests that are considered risky are not displayed when the TestDox result printer is used
* [#5516](https://github.com/sebastianbergmann/phpunit/issues/5516): Assertions that use the `LogicalNot` constraint (`assertNotEquals()`, `assertStringNotContainsString()`, ...) can generate confusing failure messages
* [#5518](https://github.com/sebastianbergmann/phpunit/issues/5518): Details about deprecations, notices, and warnings are not displayed when the TestDox result printer is used
* [#5574](https://github.com/sebastianbergmann/phpunit/issues/5574): Wrong backtrace line is reported
* [#5633](https://github.com/sebastianbergmann/phpunit/pull/5633): `--log-events-text` and `--log-events-verbose-text` CLI options do not handle absolute and relative paths
* [#5634](https://github.com/sebastianbergmann/phpunit/pull/5634): Exceptions in the destructor of a test double are ignored
* [#5641](https://github.com/sebastianbergmann/phpunit/issues/5641): The `TestSuite` value object returned by `TestSuite\Filtered::testSuite()` contains all tests instead of only the filtered tests
## [10.5.5] - 2023-12-27
### Fixed
* [#5619](https://github.com/sebastianbergmann/phpunit/pull/5619): Reverted change introduced in PHPUnit 10.5.4 that broke backward compatibility
## [10.5.4] - 2023-12-27
### Fixed
* [#5592](https://github.com/sebastianbergmann/phpunit/issues/5592): Error Handler prevents `error_get_last()` usage in tests
* [#5592](https://github.com/sebastianbergmann/phpunit/issues/5592): `E_USER_ERROR` does not abort test execution
* [#5612](https://github.com/sebastianbergmann/phpunit/issues/5612): Empty `<coverage>` element in XML configuration after migrating configuration
* [#5616](https://github.com/sebastianbergmann/phpunit/issues/5616): Values from data provider are not shown for failed test
* [#5619](https://github.com/sebastianbergmann/phpunit/pull/5619): Check and restore error/exception global handlers
* [#5621](https://github.com/sebastianbergmann/phpunit/issues/5621): Name of data set is missing from TeamCity output
## [10.5.3] - 2023-12-13
### Changed
* Make PHAR build reproducible (the only remaining differences were in the timestamps for the files in the PHAR)
### Deprecated
* `Test\AssertionFailed` and `Test\AssertionSucceeded` events
* `PHPUnit\Runner\Extension\Facade::requireExportOfObjects()` and `PHPUnit\Runner\Extension\Facade::requiresExportOfObjects()`
* `registerMockObjectsFromTestArgumentsRecursively` attribute on the `<phpunit>` element of the XML configuration file
* `PHPUnit\TextUI\Configuration\Configuration::registerMockObjectsFromTestArgumentsRecursively()`
### Fixed
* [#5614](https://github.com/sebastianbergmann/phpunit/issues/5614): Infinite recursion when data provider provides recursive array
## [10.5.2] - 2023-12-05
### Fixed
* [#5561](https://github.com/sebastianbergmann/phpunit/issues/5561): JUnit XML logger does not handle assertion failures in before-test methods
* [#5567](https://github.com/sebastianbergmann/phpunit/issues/5567): Infinite recursion when recursive / self-referencing arrays are checked whether they contain only scalar values
## [10.5.1] - 2023-12-01
### Fixed
* [#5593](https://github.com/sebastianbergmann/phpunit/issues/5593): Return Value Generator fails to correctly create test stub for method with `static` return type declaration when used recursively
* [#5596](https://github.com/sebastianbergmann/phpunit/issues/5596): `PHPUnit\Framework\TestCase` has `@internal` annotation in PHAR
## [10.5.0] - 2023-12-01
### Added
* [#5532](https://github.com/sebastianbergmann/phpunit/issues/5532): `#[IgnoreDeprecations]` attribute to ignore `E_(USER_)DEPRECATED` issues on test class and test method level
* [#5551](https://github.com/sebastianbergmann/phpunit/issues/5551): Support for omitting parameter default values for `willReturnMap()`
* [#5577](https://github.com/sebastianbergmann/phpunit/issues/5577): `--composer-lock` CLI option for PHAR binary that displays the `composer.lock` used to build the PHAR
### Changed
* `MockBuilder::disableAutoReturnValueGeneration()` and `MockBuilder::enableAutoReturnValueGeneration()` are no longer deprecated
### Fixed
* [#5563](https://github.com/sebastianbergmann/phpunit/issues/5563): `createMockForIntersectionOfInterfaces()` does not automatically register mock object for expectation verification
[10.5.20]: https://github.com/sebastianbergmann/phpunit/compare/10.5.19...10.5.20
[10.5.19]: https://github.com/sebastianbergmann/phpunit/compare/10.5.18...10.5.19
[10.5.18]: https://github.com/sebastianbergmann/phpunit/compare/10.5.17...10.5.18
[10.5.17]: https://github.com/sebastianbergmann/phpunit/compare/10.5.16...10.5.17
[10.5.16]: https://github.com/sebastianbergmann/phpunit/compare/10.5.15...10.5.16
[10.5.15]: https://github.com/sebastianbergmann/phpunit/compare/10.5.14...10.5.15
[10.5.14]: https://github.com/sebastianbergmann/phpunit/compare/10.5.13...10.5.14
[10.5.13]: https://github.com/sebastianbergmann/phpunit/compare/10.5.12...10.5.13
[10.5.12]: https://github.com/sebastianbergmann/phpunit/compare/10.5.11...10.5.12
[10.5.11]: https://github.com/sebastianbergmann/phpunit/compare/10.5.10...10.5.11
[10.5.10]: https://github.com/sebastianbergmann/phpunit/compare/10.5.9...10.5.10
[10.5.9]: https://github.com/sebastianbergmann/phpunit/compare/10.5.8...10.5.9
[10.5.8]: https://github.com/sebastianbergmann/phpunit/compare/10.5.7...10.5.8
[10.5.7]: https://github.com/sebastianbergmann/phpunit/compare/10.5.6...10.5.7
[10.5.6]: https://github.com/sebastianbergmann/phpunit/compare/10.5.5...10.5.6
[10.5.5]: https://github.com/sebastianbergmann/phpunit/compare/10.5.4...10.5.5
[10.5.4]: https://github.com/sebastianbergmann/phpunit/compare/10.5.3...10.5.4
[10.5.3]: https://github.com/sebastianbergmann/phpunit/compare/10.5.2...10.5.3
[10.5.2]: https://github.com/sebastianbergmann/phpunit/compare/10.5.1...10.5.2
[10.5.1]: https://github.com/sebastianbergmann/phpunit/compare/10.5.0...10.5.1
[10.5.0]: https://github.com/sebastianbergmann/phpunit/compare/10.4.2...10.5.0
php-invoker/LICENSE 0000644 00000002773 15243417753 0010037 0 ustar 00 BSD 3-Clause License
Copyright (c) 2011-2023, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
php-invoker/src/exceptions/ProcessControlExtensionNotLoadedException.php 0000644 00000000656 15243417753 0023036 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-invoker.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Invoker;
use RuntimeException;
final class ProcessControlExtensionNotLoadedException extends RuntimeException implements Exception
{
}
php-invoker/src/exceptions/TimeoutException.php 0000644 00000000625 15243417753 0016012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-invoker.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Invoker;
use RuntimeException;
final class TimeoutException extends RuntimeException implements Exception
{
}
php-invoker/src/exceptions/Exception.php 0000644 00000000551 15243417753 0014441 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-invoker.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Invoker;
use Throwable;
interface Exception extends Throwable
{
}
php-invoker/src/Invoker.php 0000644 00000003320 15243417753 0011734 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of phpunit/php-invoker.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Invoker;
use const SIGALRM;
use function call_user_func_array;
use function function_exists;
use function pcntl_alarm;
use function pcntl_async_signals;
use function pcntl_signal;
use function sprintf;
use Throwable;
final class Invoker
{
private int $timeout;
/**
* @throws Throwable
*/
public function invoke(callable $callable, array $arguments, int $timeout): mixed
{
if (!$this->canInvokeWithTimeout()) {
throw new ProcessControlExtensionNotLoadedException(
'The pcntl (process control) extension for PHP is required'
);
}
pcntl_signal(
SIGALRM,
function (): void
{
throw new TimeoutException(
sprintf(
'Execution aborted after %d second%s',
$this->timeout,
$this->timeout === 1 ? '' : 's'
)
);
},
true
);
$this->timeout = $timeout;
pcntl_async_signals(true);
pcntl_alarm($timeout);
try {
return call_user_func_array($callable, $arguments);
} finally {
pcntl_alarm(0);
}
}
public function canInvokeWithTimeout(): bool
{
return function_exists('pcntl_signal') && function_exists('pcntl_async_signals') && function_exists('pcntl_alarm');
}
}
php-invoker/SECURITY.md 0000644 00000001120 15243417753 0010604 0 ustar 00 # Security Policy
This library is intended to be used in development environments only. For instance, it is used by the testing framework PHPUnit. There is no reason why this library should be installed on a webserver.
**If you upload this library to a webserver then your deployment process is broken. On a more general note, if your `vendor` directory is publicly accessible on your webserver then your deployment process is also broken.**
## Security Contact Information
After the above, if you still would like to report a security vulnerability, please email `sebastian@phpunit.de`.
php-invoker/.psalm/baseline.xml 0000644 00000000334 15243417753 0012517 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<files psalm-version="dev-master@">
<file src="src/Invoker.php">
<MissingConstructor occurrences="1">
<code>$timeout</code>
</MissingConstructor>
</file>
</files>
php-invoker/.psalm/config.xml 0000644 00000000722 15243417753 0012203 0 ustar 00 <?xml version="1.0"?>
<psalm
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://getpsalm.org/schema/config"
xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
resolveFromConfigFile="false"
errorBaseline=".psalm/baseline.xml"
>
<projectFiles>
<directory name="src" />
<ignoreFiles>
<directory name="vendor" />
</ignoreFiles>
</projectFiles>
</psalm>
php-invoker/composer.json 0000644 00000002162 15243417753 0011544 0 ustar 00 {
"name": "phpunit/php-invoker",
"description": "Invoke callables with a timeout",
"type": "library",
"keywords": [
"process"
],
"homepage": "https://github.com/sebastianbergmann/php-invoker/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-invoker/issues"
},
"prefer-stable": true,
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"ext-pcntl": "*",
"phpunit/phpunit": "^10.0"
},
"autoload": {
"classmap": [
"src/"
]
},
"autoload-dev": {
"classmap": [
"tests/_fixture/"
]
},
"suggest": {
"ext-pcntl": "*"
},
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
}
}
php-invoker/README.md 0000644 00000001741 15243417753 0010303 0 ustar 00 # phpunit/php-invoker
[](https://packagist.org/packages/phpunit/php-invoker)
[](https://github.com/sebastianbergmann/php-invoker/actions)
[](https://shepherd.dev/github/sebastianbergmann/php-invoker)
[](https://codecov.io/gh/sebastianbergmann/php-invoker)
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
```
composer require phpunit/php-invoker
```
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
```
composer require --dev phpunit/php-invoker
```
php-invoker/ChangeLog.md 0000644 00000003205 15243417753 0011172 0 ustar 00 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
## [4.0.0] - 2023-02-03
### Removed
* This component is no longer supported on PHP 7.3, PHP 7.4 and PHP 8.0
## [3.1.1] - 2020-09-28
### Changed
* Changed PHP version constraint in `composer.json` from `^7.3 || ^8.0` to `>=7.3`
## [3.1.0] - 2020-08-06
### Changed
* [#14](https://github.com/sebastianbergmann/php-invoker/pull/14): Clear alarm in `finally` block
## [3.0.2] - 2020-06-26
### Added
* This component is now supported on PHP 8
## [3.0.1] - 2020-06-15
### Changed
* Tests etc. are now ignored for archive exports
## [3.0.0] - 2020-02-07
### Added
* Added `canInvokeWithTimeout()` method to check requirements for the functionality provided by this component to work
### Changed
* Moved `"ext-pcntl": "*"` requirement from `require` to `suggest` so that this component can be installed even if `ext/pcntl` is not available
* `invoke()` now raises an exception when the requirements for the functionality provided by this component to work are not met
### Removed
* This component is no longer supported on PHP 7.1 and PHP 7.2
[4.0.0]: https://github.com/sebastianbergmann/php-invoker/compare/3.1.1...4.0.0
[3.1.1]: https://github.com/sebastianbergmann/php-invoker/compare/3.1.0...3.1.1
[3.1.0]: https://github.com/sebastianbergmann/php-invoker/compare/3.0.2...3.1.0
[3.0.2]: https://github.com/sebastianbergmann/php-invoker/compare/3.0.1...3.0.2
[3.0.1]: https://github.com/sebastianbergmann/php-invoker/compare/3.0.0...3.0.1
[3.0.0]: https://github.com/sebastianbergmann/php-invoker/compare/2.0.0...3.0.0
composer.lock 0000644 00000155230 15243426620 0007257 0 ustar 00 {
"_readme": [
"This file locks the dependencies of your project to a known state",
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
"content-hash": "e06728e5442edec84af96f94a889b4a7",
"packages": [
{
"name": "myclabs/deep-copy",
"version": "1.11.1",
"source": {
"type": "git",
"url": "https://github.com/myclabs/DeepCopy.git",
"reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/7284c22080590fb39f2ffa3e9057f10a4ddd0e0c",
"reference": "7284c22080590fb39f2ffa3e9057f10a4ddd0e0c",
"shasum": ""
},
"require": {
"php": "^7.1 || ^8.0"
},
"conflict": {
"doctrine/collections": "<1.6.8",
"doctrine/common": "<2.13.3 || >=3,<3.2.2"
},
"require-dev": {
"doctrine/collections": "^1.6.8",
"doctrine/common": "^2.13.3 || ^3.2.2",
"phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13"
},
"type": "library",
"autoload": {
"files": [
"src/DeepCopy/deep_copy.php"
],
"psr-4": {
"DeepCopy\\": "src/DeepCopy/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"description": "Create deep copies (clones) of your objects",
"keywords": [
"clone",
"copy",
"duplicate",
"object",
"object graph"
],
"support": {
"issues": "https://github.com/myclabs/DeepCopy/issues",
"source": "https://github.com/myclabs/DeepCopy/tree/1.11.1"
},
"funding": [
{
"url": "https://tidelift.com/funding/github/packagist/myclabs/deep-copy",
"type": "tidelift"
}
],
"time": "2023-03-08T13:26:56+00:00"
},
{
"name": "nikic/php-parser",
"version": "v5.0.2",
"source": {
"type": "git",
"url": "https://github.com/nikic/PHP-Parser.git",
"reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/139676794dc1e9231bf7bcd123cfc0c99182cb13",
"reference": "139676794dc1e9231bf7bcd123cfc0c99182cb13",
"shasum": ""
},
"require": {
"ext-ctype": "*",
"ext-json": "*",
"ext-tokenizer": "*",
"php": ">=7.4"
},
"require-dev": {
"ircmaxell/php-yacc": "^0.0.7",
"phpunit/phpunit": "^7.0 || ^8.0 || ^9.0"
},
"bin": [
"bin/php-parse"
],
"type": "library",
"extra": {
"branch-alias": {
"dev-master": "5.0-dev"
}
},
"autoload": {
"psr-4": {
"PhpParser\\": "lib/PhpParser"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Nikita Popov"
}
],
"description": "A PHP parser written in PHP",
"keywords": [
"parser",
"php"
],
"support": {
"issues": "https://github.com/nikic/PHP-Parser/issues",
"source": "https://github.com/nikic/PHP-Parser/tree/v5.0.2"
},
"time": "2024-03-05T20:51:40+00:00"
},
{
"name": "phar-io/manifest",
"version": "2.0.4",
"source": {
"type": "git",
"url": "https://github.com/phar-io/manifest.git",
"reference": "54750ef60c58e43759730615a392c31c80e23176"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/phar-io/manifest/zipball/54750ef60c58e43759730615a392c31c80e23176",
"reference": "54750ef60c58e43759730615a392c31c80e23176",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-libxml": "*",
"ext-phar": "*",
"ext-xmlwriter": "*",
"phar-io/version": "^3.0.1",
"php": "^7.2 || ^8.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-master": "2.0.x-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
},
{
"name": "Sebastian Heuer",
"email": "sebastian@phpeople.de",
"role": "Developer"
},
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "Developer"
}
],
"description": "Component for reading phar.io manifest information from a PHP Archive (PHAR)",
"support": {
"issues": "https://github.com/phar-io/manifest/issues",
"source": "https://github.com/phar-io/manifest/tree/2.0.4"
},
"funding": [
{
"url": "https://github.com/theseer",
"type": "github"
}
],
"time": "2024-03-03T12:33:53+00:00"
},
{
"name": "phar-io/version",
"version": "3.2.1",
"source": {
"type": "git",
"url": "https://github.com/phar-io/version.git",
"reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/phar-io/version/zipball/4f7fd7836c6f332bb2933569e566a0d6c4cbed74",
"reference": "4f7fd7836c6f332bb2933569e566a0d6c4cbed74",
"shasum": ""
},
"require": {
"php": "^7.2 || ^8.0"
},
"type": "library",
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
},
{
"name": "Sebastian Heuer",
"email": "sebastian@phpeople.de",
"role": "Developer"
},
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "Developer"
}
],
"description": "Library for handling version information and constraints",
"support": {
"issues": "https://github.com/phar-io/version/issues",
"source": "https://github.com/phar-io/version/tree/3.2.1"
},
"time": "2022-02-21T01:04:05+00:00"
},
{
"name": "phpunit/php-code-coverage",
"version": "10.1.14",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-code-coverage.git",
"reference": "e3f51450ebffe8e0efdf7346ae966a656f7d5e5b"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/e3f51450ebffe8e0efdf7346ae966a656f7d5e5b",
"reference": "e3f51450ebffe8e0efdf7346ae966a656f7d5e5b",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-libxml": "*",
"ext-xmlwriter": "*",
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1",
"phpunit/php-file-iterator": "^4.0",
"phpunit/php-text-template": "^3.0",
"sebastian/code-unit-reverse-lookup": "^3.0",
"sebastian/complexity": "^3.0",
"sebastian/environment": "^6.0",
"sebastian/lines-of-code": "^2.0",
"sebastian/version": "^4.0",
"theseer/tokenizer": "^1.2.0"
},
"require-dev": {
"phpunit/phpunit": "^10.1"
},
"suggest": {
"ext-pcov": "PHP extension that provides line coverage",
"ext-xdebug": "PHP extension that provides line coverage as well as branch and path coverage"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "10.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library that provides collection, processing, and rendering functionality for PHP code coverage information.",
"homepage": "https://github.com/sebastianbergmann/php-code-coverage",
"keywords": [
"coverage",
"testing",
"xunit"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-code-coverage/issues",
"security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy",
"source": "https://github.com/sebastianbergmann/php-code-coverage/tree/10.1.14"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-12T15:33:41+00:00"
},
{
"name": "phpunit/php-file-iterator",
"version": "4.1.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-file-iterator.git",
"reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/a95037b6d9e608ba092da1b23931e537cadc3c3c",
"reference": "a95037b6d9e608ba092da1b23931e537cadc3c3c",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "FilterIterator implementation that filters files based on a list of suffixes.",
"homepage": "https://github.com/sebastianbergmann/php-file-iterator/",
"keywords": [
"filesystem",
"iterator"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-file-iterator/issues",
"security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy",
"source": "https://github.com/sebastianbergmann/php-file-iterator/tree/4.1.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-31T06:24:48+00:00"
},
{
"name": "phpunit/php-invoker",
"version": "4.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-invoker.git",
"reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7",
"reference": "f5e568ba02fa5ba0ddd0f618391d5a9ea50b06d7",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"ext-pcntl": "*",
"phpunit/phpunit": "^10.0"
},
"suggest": {
"ext-pcntl": "*"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Invoke callables with a timeout",
"homepage": "https://github.com/sebastianbergmann/php-invoker/",
"keywords": [
"process"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-invoker/issues",
"source": "https://github.com/sebastianbergmann/php-invoker/tree/4.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:56:09+00:00"
},
{
"name": "phpunit/php-text-template",
"version": "3.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-text-template.git",
"reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/0c7b06ff49e3d5072f057eb1fa59258bf287a748",
"reference": "0c7b06ff49e3d5072f057eb1fa59258bf287a748",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Simple template engine.",
"homepage": "https://github.com/sebastianbergmann/php-text-template/",
"keywords": [
"template"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-text-template/issues",
"security": "https://github.com/sebastianbergmann/php-text-template/security/policy",
"source": "https://github.com/sebastianbergmann/php-text-template/tree/3.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-31T14:07:24+00:00"
},
{
"name": "phpunit/php-timer",
"version": "6.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/php-timer.git",
"reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/e2a2d67966e740530f4a3343fe2e030ffdc1161d",
"reference": "e2a2d67966e740530f4a3343fe2e030ffdc1161d",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Utility class for timing",
"homepage": "https://github.com/sebastianbergmann/php-timer/",
"keywords": [
"timer"
],
"support": {
"issues": "https://github.com/sebastianbergmann/php-timer/issues",
"source": "https://github.com/sebastianbergmann/php-timer/tree/6.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:57:52+00:00"
},
{
"name": "sebastian/cli-parser",
"version": "2.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/cli-parser.git",
"reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/c34583b87e7b7a8055bf6c450c2c77ce32a24084",
"reference": "c34583b87e7b7a8055bf6c450c2c77ce32a24084",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for parsing CLI options",
"homepage": "https://github.com/sebastianbergmann/cli-parser",
"support": {
"issues": "https://github.com/sebastianbergmann/cli-parser/issues",
"security": "https://github.com/sebastianbergmann/cli-parser/security/policy",
"source": "https://github.com/sebastianbergmann/cli-parser/tree/2.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:12:49+00:00"
},
{
"name": "sebastian/code-unit",
"version": "2.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/code-unit.git",
"reference": "a81fee9eef0b7a76af11d121767abc44c104e503"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/code-unit/zipball/a81fee9eef0b7a76af11d121767abc44c104e503",
"reference": "a81fee9eef0b7a76af11d121767abc44c104e503",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Collection of value objects that represent the PHP code units",
"homepage": "https://github.com/sebastianbergmann/code-unit",
"support": {
"issues": "https://github.com/sebastianbergmann/code-unit/issues",
"source": "https://github.com/sebastianbergmann/code-unit/tree/2.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:58:43+00:00"
},
{
"name": "sebastian/code-unit-reverse-lookup",
"version": "3.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/code-unit-reverse-lookup.git",
"reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/code-unit-reverse-lookup/zipball/5e3a687f7d8ae33fb362c5c0743794bbb2420a1d",
"reference": "5e3a687f7d8ae33fb362c5c0743794bbb2420a1d",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Looks up which function or method a line of code belongs to",
"homepage": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/",
"support": {
"issues": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/issues",
"source": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/tree/3.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T06:59:15+00:00"
},
{
"name": "sebastian/comparator",
"version": "5.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/comparator.git",
"reference": "2db5010a484d53ebf536087a70b4a5423c102372"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/2db5010a484d53ebf536087a70b4a5423c102372",
"reference": "2db5010a484d53ebf536087a70b4a5423c102372",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-mbstring": "*",
"php": ">=8.1",
"sebastian/diff": "^5.0",
"sebastian/exporter": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.3"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Volker Dusch",
"email": "github@wallbash.com"
},
{
"name": "Bernhard Schussek",
"email": "bschussek@2bepublished.at"
}
],
"description": "Provides the functionality to compare PHP values for equality",
"homepage": "https://github.com/sebastianbergmann/comparator",
"keywords": [
"comparator",
"compare",
"equality"
],
"support": {
"issues": "https://github.com/sebastianbergmann/comparator/issues",
"security": "https://github.com/sebastianbergmann/comparator/security/policy",
"source": "https://github.com/sebastianbergmann/comparator/tree/5.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-08-14T13:18:12+00:00"
},
{
"name": "sebastian/complexity",
"version": "3.2.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/complexity.git",
"reference": "68ff824baeae169ec9f2137158ee529584553799"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/68ff824baeae169ec9f2137158ee529584553799",
"reference": "68ff824baeae169ec9f2137158ee529584553799",
"shasum": ""
},
"require": {
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.2-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for calculating the complexity of PHP code units",
"homepage": "https://github.com/sebastianbergmann/complexity",
"support": {
"issues": "https://github.com/sebastianbergmann/complexity/issues",
"security": "https://github.com/sebastianbergmann/complexity/security/policy",
"source": "https://github.com/sebastianbergmann/complexity/tree/3.2.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-12-21T08:37:17+00:00"
},
{
"name": "sebastian/diff",
"version": "5.1.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/diff.git",
"reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/c41e007b4b62af48218231d6c2275e4c9b975b2e",
"reference": "c41e007b4b62af48218231d6c2275e4c9b975b2e",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0",
"symfony/process": "^6.4"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Kore Nordmann",
"email": "mail@kore-nordmann.de"
}
],
"description": "Diff implementation",
"homepage": "https://github.com/sebastianbergmann/diff",
"keywords": [
"diff",
"udiff",
"unidiff",
"unified diff"
],
"support": {
"issues": "https://github.com/sebastianbergmann/diff/issues",
"security": "https://github.com/sebastianbergmann/diff/security/policy",
"source": "https://github.com/sebastianbergmann/diff/tree/5.1.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:15:17+00:00"
},
{
"name": "sebastian/environment",
"version": "6.1.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/environment.git",
"reference": "8074dbcd93529b357029f5cc5058fd3e43666984"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/8074dbcd93529b357029f5cc5058fd3e43666984",
"reference": "8074dbcd93529b357029f5cc5058fd3e43666984",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"suggest": {
"ext-posix": "*"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Provides functionality to handle HHVM/PHP environments",
"homepage": "https://github.com/sebastianbergmann/environment",
"keywords": [
"Xdebug",
"environment",
"hhvm"
],
"support": {
"issues": "https://github.com/sebastianbergmann/environment/issues",
"security": "https://github.com/sebastianbergmann/environment/security/policy",
"source": "https://github.com/sebastianbergmann/environment/tree/6.1.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-23T08:47:14+00:00"
},
{
"name": "sebastian/exporter",
"version": "5.1.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/exporter.git",
"reference": "955288482d97c19a372d3f31006ab3f37da47adf"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/955288482d97c19a372d3f31006ab3f37da47adf",
"reference": "955288482d97c19a372d3f31006ab3f37da47adf",
"shasum": ""
},
"require": {
"ext-mbstring": "*",
"php": ">=8.1",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.1-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Volker Dusch",
"email": "github@wallbash.com"
},
{
"name": "Adam Harvey",
"email": "aharvey@php.net"
},
{
"name": "Bernhard Schussek",
"email": "bschussek@gmail.com"
}
],
"description": "Provides the functionality to export PHP variables for visualization",
"homepage": "https://www.github.com/sebastianbergmann/exporter",
"keywords": [
"export",
"exporter"
],
"support": {
"issues": "https://github.com/sebastianbergmann/exporter/issues",
"security": "https://github.com/sebastianbergmann/exporter/security/policy",
"source": "https://github.com/sebastianbergmann/exporter/tree/5.1.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:17:12+00:00"
},
{
"name": "sebastian/global-state",
"version": "6.0.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/global-state.git",
"reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/987bafff24ecc4c9ac418cab1145b96dd6e9cbd9",
"reference": "987bafff24ecc4c9ac418cab1145b96dd6e9cbd9",
"shasum": ""
},
"require": {
"php": ">=8.1",
"sebastian/object-reflector": "^3.0",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"ext-dom": "*",
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "6.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Snapshotting of global state",
"homepage": "https://www.github.com/sebastianbergmann/global-state",
"keywords": [
"global state"
],
"support": {
"issues": "https://github.com/sebastianbergmann/global-state/issues",
"security": "https://github.com/sebastianbergmann/global-state/security/policy",
"source": "https://github.com/sebastianbergmann/global-state/tree/6.0.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2024-03-02T07:19:19+00:00"
},
{
"name": "sebastian/lines-of-code",
"version": "2.0.2",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/lines-of-code.git",
"reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/856e7f6a75a84e339195d48c556f23be2ebf75d0",
"reference": "856e7f6a75a84e339195d48c556f23be2ebf75d0",
"shasum": ""
},
"require": {
"nikic/php-parser": "^4.18 || ^5.0",
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "2.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library for counting the lines of code in PHP source code",
"homepage": "https://github.com/sebastianbergmann/lines-of-code",
"support": {
"issues": "https://github.com/sebastianbergmann/lines-of-code/issues",
"security": "https://github.com/sebastianbergmann/lines-of-code/security/policy",
"source": "https://github.com/sebastianbergmann/lines-of-code/tree/2.0.2"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-12-21T08:38:20+00:00"
},
{
"name": "sebastian/object-enumerator",
"version": "5.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/object-enumerator.git",
"reference": "202d0e344a580d7f7d04b3fafce6933e59dae906"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/202d0e344a580d7f7d04b3fafce6933e59dae906",
"reference": "202d0e344a580d7f7d04b3fafce6933e59dae906",
"shasum": ""
},
"require": {
"php": ">=8.1",
"sebastian/object-reflector": "^3.0",
"sebastian/recursion-context": "^5.0"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Traverses array structures and object graphs to enumerate all referenced objects",
"homepage": "https://github.com/sebastianbergmann/object-enumerator/",
"support": {
"issues": "https://github.com/sebastianbergmann/object-enumerator/issues",
"source": "https://github.com/sebastianbergmann/object-enumerator/tree/5.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:08:32+00:00"
},
{
"name": "sebastian/object-reflector",
"version": "3.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/object-reflector.git",
"reference": "24ed13d98130f0e7122df55d06c5c4942a577957"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/24ed13d98130f0e7122df55d06c5c4942a577957",
"reference": "24ed13d98130f0e7122df55d06c5c4942a577957",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "3.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
}
],
"description": "Allows reflection of object attributes, including inherited and non-public ones",
"homepage": "https://github.com/sebastianbergmann/object-reflector/",
"support": {
"issues": "https://github.com/sebastianbergmann/object-reflector/issues",
"source": "https://github.com/sebastianbergmann/object-reflector/tree/3.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:06:18+00:00"
},
{
"name": "sebastian/recursion-context",
"version": "5.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/recursion-context.git",
"reference": "05909fb5bc7df4c52992396d0116aed689f93712"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/05909fb5bc7df4c52992396d0116aed689f93712",
"reference": "05909fb5bc7df4c52992396d0116aed689f93712",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "5.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de"
},
{
"name": "Jeff Welch",
"email": "whatthejeff@gmail.com"
},
{
"name": "Adam Harvey",
"email": "aharvey@php.net"
}
],
"description": "Provides functionality to recursively process PHP variables",
"homepage": "https://github.com/sebastianbergmann/recursion-context",
"support": {
"issues": "https://github.com/sebastianbergmann/recursion-context/issues",
"source": "https://github.com/sebastianbergmann/recursion-context/tree/5.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:05:40+00:00"
},
{
"name": "sebastian/type",
"version": "4.0.0",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/type.git",
"reference": "462699a16464c3944eefc02ebdd77882bd3925bf"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/type/zipball/462699a16464c3944eefc02ebdd77882bd3925bf",
"reference": "462699a16464c3944eefc02ebdd77882bd3925bf",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Collection of value objects that represent the types of the PHP type system",
"homepage": "https://github.com/sebastianbergmann/type",
"support": {
"issues": "https://github.com/sebastianbergmann/type/issues",
"source": "https://github.com/sebastianbergmann/type/tree/4.0.0"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-03T07:10:45+00:00"
},
{
"name": "sebastian/version",
"version": "4.0.1",
"source": {
"type": "git",
"url": "https://github.com/sebastianbergmann/version.git",
"reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/sebastianbergmann/version/zipball/c51fa83a5d8f43f1402e3f32a005e6262244ef17",
"reference": "c51fa83a5d8f43f1402e3f32a005e6262244ef17",
"shasum": ""
},
"require": {
"php": ">=8.1"
},
"type": "library",
"extra": {
"branch-alias": {
"dev-main": "4.0-dev"
}
},
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"description": "Library that helps with managing the version number of Git-hosted PHP projects",
"homepage": "https://github.com/sebastianbergmann/version",
"support": {
"issues": "https://github.com/sebastianbergmann/version/issues",
"source": "https://github.com/sebastianbergmann/version/tree/4.0.1"
},
"funding": [
{
"url": "https://github.com/sebastianbergmann",
"type": "github"
}
],
"time": "2023-02-07T11:34:05+00:00"
},
{
"name": "theseer/tokenizer",
"version": "1.2.3",
"source": {
"type": "git",
"url": "https://github.com/theseer/tokenizer.git",
"reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/theseer/tokenizer/zipball/737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
"reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
"shasum": ""
},
"require": {
"ext-dom": "*",
"ext-tokenizer": "*",
"ext-xmlwriter": "*",
"php": "^7.2 || ^8.0"
},
"type": "library",
"autoload": {
"classmap": [
"src/"
]
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"BSD-3-Clause"
],
"authors": [
{
"name": "Arne Blankerts",
"email": "arne@blankerts.de",
"role": "Developer"
}
],
"description": "A small library for converting tokenized PHP source code into XML and potentially other formats",
"support": {
"issues": "https://github.com/theseer/tokenizer/issues",
"source": "https://github.com/theseer/tokenizer/tree/1.2.3"
},
"funding": [
{
"url": "https://github.com/theseer",
"type": "github"
}
],
"time": "2024-03-03T12:36:25+00:00"
}
],
"packages-dev": [],
"aliases": [],
"minimum-stability": "stable",
"stability-flags": [],
"prefer-stable": true,
"prefer-lowest": false,
"platform": {
"php": ">=8.1",
"ext-dom": "*",
"ext-json": "*",
"ext-libxml": "*",
"ext-mbstring": "*",
"ext-xml": "*",
"ext-xmlwriter": "*"
},
"platform-dev": [],
"platform-overrides": {
"php": "8.1.0"
},
"plugin-api-version": "2.6.0"
}
LICENSE 0000644 00000002773 15243426620 0005566 0 ustar 00 BSD 3-Clause License
Copyright (c) 2001-2024, Sebastian Bergmann
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
src/Util/Test.php 0000644 00000001651 15243426620 0007707 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function str_starts_with;
use PHPUnit\Metadata\Parser\Registry;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Test
{
public static function isTestMethod(ReflectionMethod $method): bool
{
if (!$method->isPublic()) {
return false;
}
if (str_starts_with($method->getName(), 'test')) {
return true;
}
$metadata = Registry::parser()->forMethod(
$method->getDeclaringClass()->getName(),
$method->getName(),
);
return $metadata->isTest()->isNotEmpty();
}
}
src/Util/Json.php 0000644 00000005344 15243426620 0007704 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const JSON_PRETTY_PRINT;
use const JSON_UNESCAPED_SLASHES;
use const JSON_UNESCAPED_UNICODE;
use function count;
use function is_array;
use function is_object;
use function json_decode;
use function json_encode;
use function json_last_error;
use function ksort;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Json
{
/**
* @throws InvalidJsonException
*/
public static function prettify(string $json): string
{
$decodedJson = json_decode($json, false);
if (json_last_error()) {
throw new InvalidJsonException;
}
return json_encode($decodedJson, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
}
/**
* To allow comparison of JSON strings, first process them into a consistent
* format so that they can be compared as strings.
*
* @return array ($error, $canonicalized_json) The $error parameter is used
* to indicate an error decoding the json. This is used to avoid ambiguity
* with JSON strings consisting entirely of 'null' or 'false'.
*/
public static function canonicalize(string $json): array
{
$decodedJson = json_decode($json);
if (json_last_error()) {
return [true, null];
}
self::recursiveSort($decodedJson);
$reencodedJson = json_encode($decodedJson);
return [false, $reencodedJson];
}
/**
* JSON object keys are unordered while PHP array keys are ordered.
*
* Sort all array keys to ensure both the expected and actual values have
* their keys in the same order.
*/
private static function recursiveSort(mixed &$json): void
{
if (!is_array($json)) {
// If the object is not empty, change it to an associative array
// so we can sort the keys (and we will still re-encode it
// correctly, since PHP encodes associative arrays as JSON objects.)
// But EMPTY objects MUST remain empty objects. (Otherwise we will
// re-encode it as a JSON array rather than a JSON object.)
// See #2919.
if (is_object($json) && count((array) $json) > 0) {
$json = (array) $json;
} else {
return;
}
}
ksort($json);
foreach ($json as &$value) {
self::recursiveSort($value);
}
}
}
src/Util/ThrowableToStringMapper.php 0000644 00000002474 15243426620 0013562 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\PhptAssertionFailedError;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Runner\ErrorException;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ThrowableToStringMapper
{
public static function map(Throwable $t): string
{
if ($t instanceof ErrorException) {
return $t->getMessage();
}
if ($t instanceof SelfDescribing) {
$buffer = $t->toString();
if ($t instanceof ExpectationFailedException && $t->getComparisonFailure()) {
$buffer .= $t->getComparisonFailure()->getDiff();
}
if ($t instanceof PhptAssertionFailedError) {
$buffer .= $t->diff();
}
if (!empty($buffer)) {
$buffer = trim($buffer) . "\n";
}
return $buffer;
}
return $t::class . ': ' . $t->getMessage() . "\n";
}
}
src/Util/VersionComparisonOperator.php 0000644 00000003045 15243426620 0014163 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function in_array;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class VersionComparisonOperator
{
/**
* @psalm-var '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne'
*/
private readonly string $operator;
/**
* @psalm-param '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne' $operator
*
* @throws InvalidVersionOperatorException
*/
public function __construct(string $operator)
{
$this->ensureOperatorIsValid($operator);
$this->operator = $operator;
}
/**
* @psalm-return '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne'
*/
public function asString(): string
{
return $this->operator;
}
/**
* @psalm-param '<'|'lt'|'<='|'le'|'>'|'gt'|'>='|'ge'|'=='|'='|'eq'|'!='|'<>'|'ne' $operator
*
* @throws InvalidVersionOperatorException
*/
private function ensureOperatorIsValid(string $operator): void
{
if (!in_array($operator, ['<', 'lt', '<=', 'le', '>', 'gt', '>=', 'ge', '==', '=', 'eq', '!=', '<>', 'ne'], true)) {
throw new InvalidVersionOperatorException($operator);
}
}
}
src/Util/Reflection.php 0000644 00000005426 15243426620 0011066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function array_keys;
use function array_merge;
use function array_reverse;
use PHPUnit\Framework\Assert;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Reflection
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array{file: non-empty-string, line: non-negative-int}
*/
public static function sourceLocationFor(string $className, string $methodName): array
{
try {
$reflector = new ReflectionMethod($className, $methodName);
$file = $reflector->getFileName();
$line = $reflector->getStartLine();
} catch (ReflectionException) {
$file = 'unknown';
$line = 0;
}
return [
'file' => $file,
'line' => $line,
];
}
/**
* @psalm-return list<ReflectionMethod>
*/
public static function publicMethodsInTestClass(ReflectionClass $class): array
{
return self::filterAndSortMethods($class, ReflectionMethod::IS_PUBLIC, true);
}
/**
* @psalm-return list<ReflectionMethod>
*/
public static function methodsInTestClass(ReflectionClass $class): array
{
return self::filterAndSortMethods($class, null, false);
}
/**
* @psalm-return list<ReflectionMethod>
*/
private static function filterAndSortMethods(ReflectionClass $class, ?int $filter, bool $sortHighestToLowest): array
{
$methodsByClass = [];
foreach ($class->getMethods($filter) as $method) {
$declaringClassName = $method->getDeclaringClass()->getName();
if ($declaringClassName === TestCase::class) {
continue;
}
if ($declaringClassName === Assert::class) {
continue;
}
if (!isset($methodsByClass[$declaringClassName])) {
$methodsByClass[$declaringClassName] = [];
}
$methodsByClass[$declaringClassName][] = $method;
}
$classNames = array_keys($methodsByClass);
if ($sortHighestToLowest) {
$classNames = array_reverse($classNames);
}
$methods = [];
foreach ($classNames as $className) {
$methods = array_merge($methods, $methodsByClass[$className]);
}
return $methods;
}
}
src/Util/Cloner.php 0000644 00000001366 15243426620 0010215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Cloner
{
/**
* @psalm-template OriginalType of object
*
* @psalm-param OriginalType $original
*
* @psalm-return OriginalType
*/
public static function clone(object $original): object
{
try {
return clone $original;
} catch (Throwable) {
return $original;
}
}
}
src/Util/PHP/AbstractPhpProcess.php 0000644 00000020501 15243426620 0013164 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use const PHP_BINARY;
use const PHP_SAPI;
use function array_keys;
use function array_merge;
use function assert;
use function explode;
use function file_exists;
use function file_get_contents;
use function ini_get_all;
use function restore_error_handler;
use function set_error_handler;
use function trim;
use function unlink;
use function unserialize;
use ErrorException;
use PHPUnit\Event\Code\TestMethodBuilder;
use PHPUnit\Event\Code\ThrowableBuilder;
use PHPUnit\Event\Facade;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\AssertionFailedError;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TestRunner\TestResult\PassedTests;
use SebastianBergmann\Environment\Runtime;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class AbstractPhpProcess
{
protected bool $stderrRedirection = false;
protected string $stdin = '';
protected string $arguments = '';
/**
* @psalm-var array<string, string>
*/
protected array $env = [];
public static function factory(): self
{
return new DefaultPhpProcess;
}
/**
* Defines if should use STDERR redirection or not.
*
* Then $stderrRedirection is TRUE, STDERR is redirected to STDOUT.
*/
public function setUseStderrRedirection(bool $stderrRedirection): void
{
$this->stderrRedirection = $stderrRedirection;
}
/**
* Returns TRUE if uses STDERR redirection or FALSE if not.
*/
public function useStderrRedirection(): bool
{
return $this->stderrRedirection;
}
/**
* Sets the input string to be sent via STDIN.
*/
public function setStdin(string $stdin): void
{
$this->stdin = $stdin;
}
/**
* Returns the input string to be sent via STDIN.
*/
public function getStdin(): string
{
return $this->stdin;
}
/**
* Sets the string of arguments to pass to the php job.
*/
public function setArgs(string $arguments): void
{
$this->arguments = $arguments;
}
/**
* Returns the string of arguments to pass to the php job.
*/
public function getArgs(): string
{
return $this->arguments;
}
/**
* Sets the array of environment variables to start the child process with.
*
* @psalm-param array<string, string> $env
*/
public function setEnv(array $env): void
{
$this->env = $env;
}
/**
* Returns the array of environment variables to start the child process with.
*/
public function getEnv(): array
{
return $this->env;
}
/**
* Runs a single test in a separate PHP process.
*
* @throws \PHPUnit\Runner\Exception
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
public function runTestJob(string $job, Test $test, string $processResultFile): void
{
$_result = $this->runJob($job);
$processResult = '';
if (file_exists($processResultFile)) {
$processResult = file_get_contents($processResultFile);
@unlink($processResultFile);
}
$this->processChildResult(
$test,
$processResult,
$_result['stderr'],
);
}
/**
* Returns the command based into the configurations.
*
* @return string[]
*/
public function getCommand(array $settings, ?string $file = null): array
{
$runtime = new Runtime;
$command = [];
$command[] = PHP_BINARY;
if ($runtime->hasPCOV()) {
$settings = array_merge(
$settings,
$runtime->getCurrentSettings(
array_keys(ini_get_all('pcov')),
),
);
} elseif ($runtime->hasXdebug()) {
$settings = array_merge(
$settings,
$runtime->getCurrentSettings(
array_keys(ini_get_all('xdebug')),
),
);
}
$command = array_merge($command, $this->settingsToParameters($settings));
if (PHP_SAPI === 'phpdbg') {
$command[] = '-qrr';
if (!$file) {
$command[] = 's=';
}
}
if ($file) {
$command[] = '-f';
$command[] = $file;
}
if ($this->arguments) {
if (!$file) {
$command[] = '--';
}
foreach (explode(' ', $this->arguments) as $arg) {
$command[] = trim($arg);
}
}
return $command;
}
/**
* Runs a single job (PHP code) using a separate PHP process.
*/
abstract public function runJob(string $job, array $settings = []): array;
/**
* @return list<string>
*/
protected function settingsToParameters(array $settings): array
{
$buffer = [];
foreach ($settings as $setting) {
$buffer[] = '-d';
$buffer[] = $setting;
}
return $buffer;
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function processChildResult(Test $test, string $stdout, string $stderr): void
{
if (!empty($stderr)) {
$exception = new Exception(trim($stderr));
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
return;
}
set_error_handler(
/**
* @throws ErrorException
*/
static function (int $errno, string $errstr, string $errfile, int $errline): never
{
throw new ErrorException($errstr, $errno, $errno, $errfile, $errline);
},
);
try {
$childResult = unserialize($stdout);
restore_error_handler();
if ($childResult === false) {
$exception = new AssertionFailedError('Test was run in child process and ended unexpectedly');
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
Facade::emitter()->testFinished(
TestMethodBuilder::fromTestCase($test),
0,
);
}
} catch (ErrorException $e) {
restore_error_handler();
$childResult = false;
$exception = new Exception(trim($stdout), 0, $e);
assert($test instanceof TestCase);
Facade::emitter()->testErrored(
TestMethodBuilder::fromTestCase($test),
ThrowableBuilder::from($exception),
);
}
if ($childResult !== false) {
if (!empty($childResult['output'])) {
$output = $childResult['output'];
}
Facade::instance()->forward($childResult['events']);
PassedTests::instance()->import($childResult['passedTests']);
assert($test instanceof TestCase);
$test->setResult($childResult['testResult']);
$test->addToAssertionCount($childResult['numAssertions']);
if (CodeCoverage::instance()->isActive() && $childResult['codeCoverage'] instanceof \SebastianBergmann\CodeCoverage\CodeCoverage) {
CodeCoverage::instance()->codeCoverage()->merge(
$childResult['codeCoverage'],
);
}
}
if (!empty($output)) {
print $output;
}
}
}
src/Util/PHP/Template/TestCaseMethod.tpl 0000644 00000006226 15243426620 0014061 0 ustar 00 <?php declare(strict_types=1);
use PHPUnit\Event\Facade;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TestRunner\TestResult\PassedTests;
// php://stdout does not obey output buffering. Any output would break
// unserialization of child process results in the parent process.
if (!defined('STDOUT')) {
define('STDOUT', fopen('php://temp', 'w+b'));
define('STDERR', fopen('php://stderr', 'wb'));
}
{iniSettings}
ini_set('display_errors', 'stderr');
set_include_path('{include_path}');
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
function __phpunit_run_isolated_test()
{
$dispatcher = Facade::instance()->initForIsolation(
PHPUnit\Event\Telemetry\HRTime::fromSecondsAndNanoseconds(
{offsetSeconds},
{offsetNanoseconds}
),
{exportObjects},
);
require_once '{filename}';
if ({collectCodeCoverageInformation}) {
CodeCoverage::instance()->init(ConfigurationRegistry::get(), CodeCoverageFilterRegistry::instance(), true);
CodeCoverage::instance()->ignoreLines({linesToBeIgnored});
}
$test = new {className}('{methodName}');
$test->setData('{dataName}', unserialize('{data}'));
$test->setDependencyInput(unserialize('{dependencyInput}'));
$test->setInIsolation(true);
ob_end_clean();
$test->run();
$output = '';
if (!$test->expectsOutput()) {
$output = $test->output();
}
ini_set('xdebug.scream', '0');
// Not every STDOUT target stream is rewindable
@rewind(STDOUT);
if ($stdout = @stream_get_contents(STDOUT)) {
$output = $stdout . $output;
$streamMetaData = stream_get_meta_data(STDOUT);
if (!empty($streamMetaData['stream_type']) && 'STDIO' === $streamMetaData['stream_type']) {
@ftruncate(STDOUT, 0);
@rewind(STDOUT);
}
}
file_put_contents(
'{processResultFile}',
serialize(
[
'testResult' => $test->result(),
'codeCoverage' => {collectCodeCoverageInformation} ? CodeCoverage::instance()->codeCoverage() : null,
'numAssertions' => $test->numberOfAssertionsPerformed(),
'output' => $output,
'events' => $dispatcher->flush(),
'passedTests' => PassedTests::instance()
]
)
);
}
function __phpunit_error_handler($errno, $errstr, $errfile, $errline)
{
return true;
}
set_error_handler('__phpunit_error_handler');
{constants}
{included_files}
{globals}
restore_error_handler();
ConfigurationRegistry::loadFrom('{serializedConfiguration}');
(new PhpHandler)->handle(ConfigurationRegistry::get()->php());
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
__phpunit_run_isolated_test();
src/Util/PHP/Template/PhptTestCase.tpl 0000644 00000002243 15243426620 0013547 0 ustar 00 <?php declare(strict_types=1);
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeCoverage\Driver\Selector;
use SebastianBergmann\CodeCoverage\Filter;
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
$GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'][] = '{job}';
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
$coverage = null;
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
if (class_exists('SebastianBergmann\CodeCoverage\CodeCoverage')) {
$filter = new Filter;
$coverage = new CodeCoverage(
(new Selector)->{driverMethod}($filter),
$filter
);
if ({codeCoverageCacheDirectory}) {
$coverage->cacheStaticAnalysis({codeCoverageCacheDirectory});
}
$coverage->start(__FILE__);
}
register_shutdown_function(
function() use ($coverage) {
$output = null;
if ($coverage) {
$output = $coverage->stop();
}
file_put_contents('{coverageFile}', serialize($output));
}
);
ob_end_clean();
require '{job}';
src/Util/PHP/Template/TestCaseClass.tpl 0000644 00000006220 15243426620 0013700 0 ustar 00 <?php declare(strict_types=1);
use PHPUnit\Event\Facade;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TestRunner\TestResult\PassedTests;
// php://stdout does not obey output buffering. Any output would break
// unserialization of child process results in the parent process.
if (!defined('STDOUT')) {
define('STDOUT', fopen('php://temp', 'w+b'));
define('STDERR', fopen('php://stderr', 'wb'));
}
{iniSettings}
ini_set('display_errors', 'stderr');
set_include_path('{include_path}');
$composerAutoload = {composerAutoload};
$phar = {phar};
ob_start();
if ($composerAutoload) {
require_once $composerAutoload;
define('PHPUNIT_COMPOSER_INSTALL', $composerAutoload);
} else if ($phar) {
require $phar;
}
function __phpunit_run_isolated_test()
{
$dispatcher = Facade::instance()->initForIsolation(
PHPUnit\Event\Telemetry\HRTime::fromSecondsAndNanoseconds(
{offsetSeconds},
{offsetNanoseconds}
),
{exportObjects},
);
require_once '{filename}';
if ({collectCodeCoverageInformation}) {
CodeCoverage::instance()->init(ConfigurationRegistry::get(), CodeCoverageFilterRegistry::instance(), true);
CodeCoverage::instance()->ignoreLines({linesToBeIgnored});
}
$test = new {className}('{name}');
$test->setData('{dataName}', unserialize('{data}'));
$test->setDependencyInput(unserialize('{dependencyInput}'));
$test->setInIsolation(true);
ob_end_clean();
$test->run();
$output = '';
if (!$test->expectsOutput()) {
$output = $test->output();
}
ini_set('xdebug.scream', '0');
// Not every STDOUT target stream is rewindable
@rewind(STDOUT);
if ($stdout = @stream_get_contents(STDOUT)) {
$output = $stdout . $output;
$streamMetaData = stream_get_meta_data(STDOUT);
if (!empty($streamMetaData['stream_type']) && 'STDIO' === $streamMetaData['stream_type']) {
@ftruncate(STDOUT, 0);
@rewind(STDOUT);
}
}
file_put_contents(
'{processResultFile}',
serialize(
[
'testResult' => $test->result(),
'codeCoverage' => {collectCodeCoverageInformation} ? CodeCoverage::instance()->codeCoverage() : null,
'numAssertions' => $test->numberOfAssertionsPerformed(),
'output' => $output,
'events' => $dispatcher->flush(),
'passedTests' => PassedTests::instance()
]
)
);
}
function __phpunit_error_handler($errno, $errstr, $errfile, $errline)
{
return true;
}
set_error_handler('__phpunit_error_handler');
{constants}
{included_files}
{globals}
restore_error_handler();
ConfigurationRegistry::loadFrom('{serializedConfiguration}');
(new PhpHandler)->handle(ConfigurationRegistry::get()->php());
if ('{bootstrap}' !== '') {
require_once '{bootstrap}';
}
__phpunit_run_isolated_test();
src/Util/PHP/DefaultPhpProcess.php 0000644 00000006717 15243426620 0013022 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use function array_merge;
use function fclose;
use function file_put_contents;
use function fwrite;
use function is_array;
use function is_resource;
use function proc_close;
use function proc_open;
use function stream_get_contents;
use function sys_get_temp_dir;
use function tempnam;
use function unlink;
use PHPUnit\Framework\Exception;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class DefaultPhpProcess extends AbstractPhpProcess
{
private ?string $tempFile = null;
/**
* Runs a single job (PHP code) using a separate PHP process.
*
* @psalm-return array{stdout: string, stderr: string}
*
* @throws Exception
* @throws PhpProcessException
*/
public function runJob(string $job, array $settings = []): array
{
if ($this->stdin) {
if (!($this->tempFile = tempnam(sys_get_temp_dir(), 'phpunit_')) ||
file_put_contents($this->tempFile, $job) === false) {
throw new PhpProcessException(
'Unable to write temporary file',
);
}
$job = $this->stdin;
}
return $this->runProcess($job, $settings);
}
/**
* Handles creating the child process and returning the STDOUT and STDERR.
*
* @psalm-return array{stdout: string, stderr: string}
*
* @throws Exception
* @throws PhpProcessException
*/
protected function runProcess(string $job, array $settings): array
{
$env = null;
if ($this->env) {
$env = $_SERVER ?? [];
unset($env['argv'], $env['argc']);
$env = array_merge($env, $this->env);
foreach ($env as $envKey => $envVar) {
if (is_array($envVar)) {
unset($env[$envKey]);
}
}
}
$pipeSpec = [
0 => ['pipe', 'r'],
1 => ['pipe', 'w'],
2 => ['pipe', 'w'],
];
if ($this->stderrRedirection) {
$pipeSpec[2] = ['redirect', 1];
}
$process = proc_open(
$this->getCommand($settings, $this->tempFile),
$pipeSpec,
$pipes,
null,
$env,
);
if (!is_resource($process)) {
throw new PhpProcessException(
'Unable to spawn worker process',
);
}
if ($job) {
$this->process($pipes[0], $job);
}
fclose($pipes[0]);
$stderr = $stdout = '';
if (isset($pipes[1])) {
$stdout = stream_get_contents($pipes[1]);
fclose($pipes[1]);
}
if (isset($pipes[2])) {
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[2]);
}
proc_close($process);
$this->cleanup();
return ['stdout' => $stdout, 'stderr' => $stderr];
}
/**
* @param resource $pipe
*/
protected function process($pipe, string $job): void
{
fwrite($pipe, $job);
}
protected function cleanup(): void
{
if ($this->tempFile) {
unlink($this->tempFile);
}
}
}
src/Util/Exporter.php 0000644 00000002701 15243426620 0010575 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function is_array;
use function is_scalar;
use SebastianBergmann\RecursionContext\Context;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class Exporter
{
public static function export(mixed $value, bool $exportObjects = false): string
{
if (self::isExportable($value) || $exportObjects) {
return (new \SebastianBergmann\Exporter\Exporter)->export($value);
}
return '{enable export of objects to see this value}';
}
private static function isExportable(mixed &$value, ?Context $context = null): bool
{
if (is_scalar($value) || $value === null) {
return true;
}
if (!is_array($value)) {
return false;
}
if (!$context) {
$context = new Context;
}
if ($context->contains($value) !== false) {
return true;
}
$array = $value;
$context->add($value);
foreach ($array as &$_value) {
if (!self::isExportable($_value, $context)) {
return false;
}
}
return true;
}
}
src/Util/Exception/PhpProcessException.php 0000644 00000001000 15243426620 0014657 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\PHP;
use PHPUnit\Util\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhpProcessException extends RuntimeException implements Exception
{
}
src/Util/Exception/XmlException.php 0000644 00000000771 15243426620 0013347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\Xml;
use PHPUnit\Util\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class XmlException extends RuntimeException implements Exception
{
}
src/Util/Exception/InvalidJsonException.php 0000644 00000000741 15243426620 0015024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidJsonException extends RuntimeException implements Exception
{
}
src/Util/Exception/InvalidDirectoryException.php 0000644 00000001316 15243426620 0016056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDirectoryException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'"%s" is not a directory',
$directory,
),
);
}
}
src/Util/Exception/InvalidVersionOperatorException.php 0000644 00000001351 15243426620 0017252 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidVersionOperatorException extends RuntimeException implements Exception
{
public function __construct(string $operator)
{
parent::__construct(
sprintf(
'"%s" is not a valid version_compare() operator',
$operator,
),
);
}
}
src/Util/Exception/Exception.php 0000644 00000000665 15243426620 0012670 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use Throwable;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
src/Util/Filter.php 0000644 00000006646 15243426620 0010226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function array_unshift;
use function defined;
use function in_array;
use function is_file;
use function realpath;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\PhptAssertionFailedError;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Filter
{
/**
* @throws Exception
*/
public static function getFilteredStacktrace(Throwable $t, bool $unwrap = true): string
{
$filteredStacktrace = '';
if ($t instanceof PhptAssertionFailedError) {
$eTrace = $t->syntheticTrace();
$eFile = $t->syntheticFile();
$eLine = $t->syntheticLine();
} elseif ($t instanceof Exception) {
$eTrace = $t->getSerializableTrace();
$eFile = $t->getFile();
$eLine = $t->getLine();
} else {
if ($unwrap && $t->getPrevious()) {
$t = $t->getPrevious();
}
$eTrace = $t->getTrace();
$eFile = $t->getFile();
$eLine = $t->getLine();
}
if (!self::frameExists($eTrace, $eFile, $eLine)) {
array_unshift(
$eTrace,
['file' => $eFile, 'line' => $eLine],
);
}
$prefix = defined('__PHPUNIT_PHAR_ROOT__') ? __PHPUNIT_PHAR_ROOT__ : false;
$excludeList = new ExcludeList;
foreach ($eTrace as $frame) {
if (self::shouldPrintFrame($frame, $prefix, $excludeList)) {
$filteredStacktrace .= sprintf(
"%s:%s\n",
$frame['file'],
$frame['line'] ?? '?',
);
}
}
return $filteredStacktrace;
}
private static function shouldPrintFrame(array $frame, false|string $prefix, ExcludeList $excludeList): bool
{
if (!isset($frame['file'])) {
return false;
}
$file = $frame['file'];
$fileIsNotPrefixed = $prefix === false || !str_starts_with($file, $prefix);
// @see https://github.com/sebastianbergmann/phpunit/issues/4033
if (isset($GLOBALS['_SERVER']['SCRIPT_NAME'])) {
$script = realpath($GLOBALS['_SERVER']['SCRIPT_NAME']);
} else {
$script = '';
}
return $fileIsNotPrefixed &&
$file !== $script &&
self::fileIsExcluded($file, $excludeList) &&
is_file($file);
}
private static function fileIsExcluded(string $file, ExcludeList $excludeList): bool
{
return (empty($GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST']) ||
!in_array($file, $GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'], true)) &&
!$excludeList->isExcluded($file);
}
private static function frameExists(array $trace, string $file, int $line): bool
{
foreach ($trace as $frame) {
if (isset($frame['file'], $frame['line']) && $frame['file'] === $file && $frame['line'] === $line) {
return true;
}
}
return false;
}
}
src/Util/Color.php 0000644 00000011207 15243426620 0010044 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const DIRECTORY_SEPARATOR;
use const PHP_EOL;
use function array_map;
use function count;
use function explode;
use function implode;
use function max;
use function min;
use function preg_replace;
use function preg_replace_callback;
use function preg_split;
use function sprintf;
use function str_pad;
use function strtr;
use function trim;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Color
{
/**
* @psalm-var array<string,string>
*/
private const WHITESPACE_MAP = [
' ' => '·',
"\t" => '⇥',
];
/**
* @psalm-var array<string,string>
*/
private const WHITESPACE_EOL_MAP = [
' ' => '·',
"\t" => '⇥',
"\n" => '↵',
"\r" => '⟵',
];
/**
* @psalm-var array<string,string>
*/
private static array $ansiCodes = [
'reset' => '0',
'bold' => '1',
'dim' => '2',
'dim-reset' => '22',
'underlined' => '4',
'fg-default' => '39',
'fg-black' => '30',
'fg-red' => '31',
'fg-green' => '32',
'fg-yellow' => '33',
'fg-blue' => '34',
'fg-magenta' => '35',
'fg-cyan' => '36',
'fg-white' => '37',
'bg-default' => '49',
'bg-black' => '40',
'bg-red' => '41',
'bg-green' => '42',
'bg-yellow' => '43',
'bg-blue' => '44',
'bg-magenta' => '45',
'bg-cyan' => '46',
'bg-white' => '47',
];
public static function colorize(string $color, string $buffer): string
{
if (trim($buffer) === '') {
return $buffer;
}
$codes = array_map('\trim', explode(',', $color));
$styles = [];
foreach ($codes as $code) {
if (isset(self::$ansiCodes[$code])) {
$styles[] = self::$ansiCodes[$code] ?? '';
}
}
if (empty($styles)) {
return $buffer;
}
return self::optimizeColor(sprintf("\x1b[%sm", implode(';', $styles)) . $buffer . "\x1b[0m");
}
public static function colorizeTextBox(string $color, string $buffer): string
{
$lines = preg_split('/\r\n|\r|\n/', $buffer);
$padding = max(array_map('\strlen', $lines));
$styledLines = [];
foreach ($lines as $line) {
$styledLines[] = self::colorize($color, str_pad($line, $padding));
}
return implode(PHP_EOL, $styledLines);
}
public static function colorizePath(string $path, ?string $previousPath = null, bool $colorizeFilename = false): string
{
if ($previousPath === null) {
$previousPath = '';
}
$path = explode(DIRECTORY_SEPARATOR, $path);
$previousPath = explode(DIRECTORY_SEPARATOR, $previousPath);
for ($i = 0; $i < min(count($path), count($previousPath)); $i++) {
if ($path[$i] === $previousPath[$i]) {
$path[$i] = self::dim($path[$i]);
}
}
if ($colorizeFilename) {
$last = count($path) - 1;
$path[$last] = preg_replace_callback(
'/([\-_.]+|phpt$)/',
static fn ($matches) => self::dim($matches[0]),
$path[$last],
);
}
return self::optimizeColor(implode(self::dim(DIRECTORY_SEPARATOR), $path));
}
public static function dim(string $buffer): string
{
if (trim($buffer) === '') {
return $buffer;
}
return "\e[2m{$buffer}\e[22m";
}
public static function visualizeWhitespace(string $buffer, bool $visualizeEOL = false): string
{
$replaceMap = $visualizeEOL ? self::WHITESPACE_EOL_MAP : self::WHITESPACE_MAP;
return preg_replace_callback(
'/\s+/',
static fn ($matches) => self::dim(strtr($matches[0], $replaceMap)),
$buffer,
);
}
private static function optimizeColor(string $buffer): string
{
return preg_replace(
[
"/\e\\[22m\e\\[2m/",
"/\e\\[([^m]*)m\e\\[([1-9][0-9;]*)m/",
"/(\e\\[[^m]*m)+(\e\\[0m)/",
],
[
'',
"\e[$1;$2m",
'$2',
],
$buffer,
);
}
}
src/Util/Filesystem.php 0000644 00000002306 15243426620 0011112 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function basename;
use function dirname;
use function is_dir;
use function mkdir;
use function realpath;
use function str_starts_with;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Filesystem
{
public static function createDirectory(string $directory): bool
{
return !(!is_dir($directory) && !@mkdir($directory, 0o777, true) && !is_dir($directory));
}
/**
* @psalm-param non-empty-string $path
*
* @return false|non-empty-string
*/
public static function resolveStreamOrFile(string $path): false|string
{
if (str_starts_with($path, 'php://') || str_starts_with($path, 'socket://')) {
return $path;
}
$directory = dirname($path);
if (is_dir($directory)) {
return realpath($directory) . DIRECTORY_SEPARATOR . basename($path);
}
return false;
}
}
src/Util/ExcludeList.php 0000644 00000013216 15243426620 0011215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use function class_exists;
use function defined;
use function dirname;
use function is_dir;
use function realpath;
use function str_starts_with;
use function sys_get_temp_dir;
use Composer\Autoload\ClassLoader;
use DeepCopy\DeepCopy;
use PharIo\Manifest\Manifest;
use PharIo\Version\Version as PharIoVersion;
use PhpParser\Parser;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
use SebastianBergmann\CliParser\Parser as CliParser;
use SebastianBergmann\CodeCoverage\CodeCoverage;
use SebastianBergmann\CodeUnit\CodeUnit;
use SebastianBergmann\CodeUnitReverseLookup\Wizard;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Complexity\Calculator;
use SebastianBergmann\Diff\Diff;
use SebastianBergmann\Environment\Runtime;
use SebastianBergmann\Exporter\Exporter;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use SebastianBergmann\GlobalState\Snapshot;
use SebastianBergmann\Invoker\Invoker;
use SebastianBergmann\LinesOfCode\Counter;
use SebastianBergmann\ObjectEnumerator\Enumerator;
use SebastianBergmann\ObjectReflector\ObjectReflector;
use SebastianBergmann\RecursionContext\Context;
use SebastianBergmann\Template\Template;
use SebastianBergmann\Timer\Timer;
use SebastianBergmann\Type\TypeName;
use SebastianBergmann\Version;
use TheSeer\Tokenizer\Tokenizer;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeList
{
/**
* @psalm-var array<string,int>
*/
private const EXCLUDED_CLASS_NAMES = [
// composer
ClassLoader::class => 1,
// myclabs/deepcopy
DeepCopy::class => 1,
// nikic/php-parser
Parser::class => 1,
// phar-io/manifest
Manifest::class => 1,
// phar-io/version
PharIoVersion::class => 1,
// phpunit/phpunit
TestCase::class => 2,
// phpunit/php-code-coverage
CodeCoverage::class => 1,
// phpunit/php-file-iterator
FileIteratorFacade::class => 1,
// phpunit/php-invoker
Invoker::class => 1,
// phpunit/php-text-template
Template::class => 1,
// phpunit/php-timer
Timer::class => 1,
// sebastian/cli-parser
CliParser::class => 1,
// sebastian/code-unit
CodeUnit::class => 1,
// sebastian/code-unit-reverse-lookup
Wizard::class => 1,
// sebastian/comparator
Comparator::class => 1,
// sebastian/complexity
Calculator::class => 1,
// sebastian/diff
Diff::class => 1,
// sebastian/environment
Runtime::class => 1,
// sebastian/exporter
Exporter::class => 1,
// sebastian/global-state
Snapshot::class => 1,
// sebastian/lines-of-code
Counter::class => 1,
// sebastian/object-enumerator
Enumerator::class => 1,
// sebastian/object-reflector
ObjectReflector::class => 1,
// sebastian/recursion-context
Context::class => 1,
// sebastian/type
TypeName::class => 1,
// sebastian/version
Version::class => 1,
// theseer/tokenizer
Tokenizer::class => 1,
];
/**
* @psalm-var list<string>
*/
private static array $directories = [];
private static bool $initialized = false;
private readonly bool $enabled;
/**
* @psalm-param non-empty-string $directory
*
* @throws InvalidDirectoryException
*/
public static function addDirectory(string $directory): void
{
if (!is_dir($directory)) {
throw new InvalidDirectoryException($directory);
}
self::$directories[] = realpath($directory);
}
public function __construct(?bool $enabled = null)
{
if ($enabled === null) {
$enabled = !defined('PHPUNIT_TESTSUITE');
}
$this->enabled = $enabled;
}
/**
* @psalm-return list<string>
*/
public function getExcludedDirectories(): array
{
self::initialize();
return self::$directories;
}
public function isExcluded(string $file): bool
{
if (!$this->enabled) {
return false;
}
self::initialize();
foreach (self::$directories as $directory) {
if (str_starts_with($file, $directory)) {
return true;
}
}
return false;
}
private static function initialize(): void
{
if (self::$initialized) {
return;
}
foreach (self::EXCLUDED_CLASS_NAMES as $className => $parent) {
if (!class_exists($className)) {
continue;
}
$directory = (new ReflectionClass($className))->getFileName();
for ($i = 0; $i < $parent; $i++) {
$directory = dirname($directory);
}
self::$directories[] = $directory;
}
/**
* Hide process isolation workaround on Windows:
* tempnam() prefix is limited to first 3 characters.
*
* @see https://php.net/manual/en/function.tempnam.php
*/
if (PHP_OS_FAMILY === 'Windows') {
// @codeCoverageIgnoreStart
self::$directories[] = sys_get_temp_dir() . '\\PHP';
// @codeCoverageIgnoreEnd
}
self::$initialized = true;
}
}
src/Util/Xml/Loader.php 0000644 00000006130 15243426620 0010733 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util\Xml;
use function chdir;
use function dirname;
use function error_reporting;
use function file_get_contents;
use function getcwd;
use function libxml_get_errors;
use function libxml_use_internal_errors;
use function sprintf;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Loader
{
/**
* @throws XmlException
*/
public function loadFile(string $filename): DOMDocument
{
$reporting = error_reporting(0);
$contents = file_get_contents($filename);
error_reporting($reporting);
if ($contents === false) {
throw new XmlException(
sprintf(
'Could not read XML from file "%s"',
$filename,
),
);
}
return $this->load($contents, $filename);
}
/**
* @throws XmlException
*/
public function load(string $actual, ?string $filename = null): DOMDocument
{
if ($actual === '') {
if ($filename === null) {
throw new XmlException('Could not parse XML from empty string');
}
throw new XmlException(
sprintf(
'Could not parse XML from empty file "%s"',
$filename,
),
);
}
$document = new DOMDocument;
$document->preserveWhiteSpace = false;
$internal = libxml_use_internal_errors(true);
$message = '';
$reporting = error_reporting(0);
// Required for XInclude
if ($filename !== null) {
// Required for XInclude on Windows
if (PHP_OS_FAMILY === 'Windows') {
$cwd = getcwd();
@chdir(dirname($filename));
}
$document->documentURI = $filename;
}
$loaded = $document->loadXML($actual);
if ($filename !== null) {
$document->xinclude();
}
foreach (libxml_get_errors() as $error) {
$message .= "\n" . $error->message;
}
libxml_use_internal_errors($internal);
error_reporting($reporting);
if (isset($cwd)) {
@chdir($cwd);
}
if ($loaded === false || $message !== '') {
if ($filename !== null) {
throw new XmlException(
sprintf(
'Could not load "%s"%s',
$filename,
$message !== '' ? ":\n" . $message : '',
),
);
}
if ($message === '') {
$message = 'Could not load XML for unknown reason';
}
throw new XmlException($message);
}
return $document;
}
}
src/Util/Xml/Xml.php 0000644 00000004051 15243426620 0010265 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const ENT_QUOTES;
use function htmlspecialchars;
use function mb_convert_encoding;
use function ord;
use function preg_replace;
use function strlen;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Xml
{
/**
* Escapes a string for the use in XML documents.
*
* Any Unicode character is allowed, excluding the surrogate blocks, FFFE,
* and FFFF (not even as character reference).
*
* @see https://www.w3.org/TR/xml/#charsets
*/
public static function prepareString(string $string): string
{
return preg_replace(
'/[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f]/',
'',
htmlspecialchars(
self::convertToUtf8($string),
ENT_QUOTES,
),
);
}
private static function convertToUtf8(string $string): string
{
if (!self::isUtf8($string)) {
$string = mb_convert_encoding($string, 'UTF-8');
}
return $string;
}
private static function isUtf8(string $string): bool
{
$length = strlen($string);
for ($i = 0; $i < $length; $i++) {
if (ord($string[$i]) < 0x80) {
$n = 0;
} elseif ((ord($string[$i]) & 0xE0) === 0xC0) {
$n = 1;
} elseif ((ord($string[$i]) & 0xF0) === 0xE0) {
$n = 2;
} elseif ((ord($string[$i]) & 0xF0) === 0xF0) {
$n = 3;
} else {
return false;
}
for ($j = 0; $j < $n; $j++) {
if ((++$i === $length) || ((ord($string[$i]) & 0xC0) !== 0x80)) {
return false;
}
}
}
return true;
}
}
src/Util/GlobalState.php 0000644 00000021307 15243426620 0011171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Util;
use const PHP_MAJOR_VERSION;
use const PHP_MINOR_VERSION;
use function array_keys;
use function array_reverse;
use function array_shift;
use function defined;
use function get_defined_constants;
use function get_included_files;
use function in_array;
use function ini_get_all;
use function is_array;
use function is_file;
use function is_scalar;
use function preg_match;
use function serialize;
use function sprintf;
use function str_ends_with;
use function str_starts_with;
use function strtr;
use function var_export;
use Closure;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GlobalState
{
/**
* @psalm-var list<string>
*/
private const SUPER_GLOBAL_ARRAYS = [
'_ENV',
'_POST',
'_GET',
'_COOKIE',
'_SERVER',
'_FILES',
'_REQUEST',
];
/**
* @psalm-var array<string, array<string, true>>
*/
private const DEPRECATED_INI_SETTINGS = [
'7.3' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.func_overload' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'string.strip_tags' => true,
],
'7.4' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.func_overload' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'pdo_odbc.db2_instance_name' => true,
'string.strip_tags' => true,
],
'8.0' => [
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
],
'8.1' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
'8.2' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
'8.3' => [
'auto_detect_line_endings' => true,
'filter.default' => true,
'iconv.input_encoding' => true,
'iconv.output_encoding' => true,
'iconv.internal_encoding' => true,
'mbstring.http_input' => true,
'mbstring.http_output' => true,
'mbstring.internal_encoding' => true,
'oci8.old_oci_close_semantics' => true,
],
];
/**
* @throws Exception
*/
public static function getIncludedFilesAsString(): string
{
return self::processIncludedFilesAsString(get_included_files());
}
/**
* @psalm-param list<string> $files
*
* @throws Exception
*/
public static function processIncludedFilesAsString(array $files): string
{
$excludeList = new ExcludeList;
$prefix = false;
$result = '';
if (defined('__PHPUNIT_PHAR__')) {
$prefix = 'phar://' . __PHPUNIT_PHAR__ . '/';
}
// Do not process bootstrap script
array_shift($files);
// If bootstrap script was a Composer bin proxy, skip the second entry as well
if (str_ends_with(strtr($files[0], '\\', '/'), '/phpunit/phpunit/phpunit')) {
array_shift($files);
}
foreach (array_reverse($files) as $file) {
if (!empty($GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST']) &&
in_array($file, $GLOBALS['__PHPUNIT_ISOLATION_EXCLUDE_LIST'], true)) {
continue;
}
if ($prefix !== false && str_starts_with($file, $prefix)) {
continue;
}
// Skip virtual file system protocols
if (preg_match('/^(vfs|phpvfs[a-z0-9]+):/', $file)) {
continue;
}
if (!$excludeList->isExcluded($file) && is_file($file)) {
$result = 'require_once \'' . $file . "';\n" . $result;
}
}
return $result;
}
public static function getIniSettingsAsString(): string
{
$result = '';
foreach (ini_get_all(null, false) as $key => $value) {
if (self::isIniSettingDeprecated($key)) {
continue;
}
$result .= sprintf(
'@ini_set(%s, %s);' . "\n",
self::exportVariable($key),
self::exportVariable((string) $value),
);
}
return $result;
}
public static function getConstantsAsString(): string
{
$constants = get_defined_constants(true);
$result = '';
if (isset($constants['user'])) {
foreach ($constants['user'] as $name => $value) {
$result .= sprintf(
'if (!defined(\'%s\')) define(\'%s\', %s);' . "\n",
$name,
$name,
self::exportVariable($value),
);
}
}
return $result;
}
public static function getGlobalsAsString(): string
{
$result = '';
foreach (self::SUPER_GLOBAL_ARRAYS as $superGlobalArray) {
if (isset($GLOBALS[$superGlobalArray]) && is_array($GLOBALS[$superGlobalArray])) {
foreach (array_keys($GLOBALS[$superGlobalArray]) as $key) {
if ($GLOBALS[$superGlobalArray][$key] instanceof Closure) {
continue;
}
$result .= sprintf(
'$GLOBALS[\'%s\'][\'%s\'] = %s;' . "\n",
$superGlobalArray,
$key,
self::exportVariable($GLOBALS[$superGlobalArray][$key]),
);
}
}
}
$excludeList = self::SUPER_GLOBAL_ARRAYS;
$excludeList[] = 'GLOBALS';
foreach (array_keys($GLOBALS) as $key) {
if (!$GLOBALS[$key] instanceof Closure && !in_array($key, $excludeList, true)) {
$result .= sprintf(
'$GLOBALS[\'%s\'] = %s;' . "\n",
$key,
self::exportVariable($GLOBALS[$key]),
);
}
}
return $result;
}
private static function exportVariable(mixed $variable): string
{
if (is_scalar($variable) || $variable === null ||
(is_array($variable) && self::arrayOnlyContainsScalars($variable))) {
return var_export($variable, true);
}
return 'unserialize(' . var_export(serialize($variable), true) . ')';
}
private static function arrayOnlyContainsScalars(array $array): bool
{
$result = true;
foreach ($array as $element) {
if (is_array($element)) {
$result = self::arrayOnlyContainsScalars($element);
} elseif (!is_scalar($element) && $element !== null) {
$result = false;
}
if (!$result) {
break;
}
}
return $result;
}
private static function isIniSettingDeprecated(string $iniSetting): bool
{
return isset(self::DEPRECATED_INI_SETTINGS[PHP_MAJOR_VERSION . '.' . PHP_MINOR_VERSION][$iniSetting]);
}
}
src/Event/Tracer.php 0000644 00000000755 15243426620 0010360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Tracer;
use PHPUnit\Event\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Tracer
{
public function trace(Event $event): void;
}
src/Event/Emitter/DispatchingEmitter.php 0000644 00000102264 15243426620 0014336 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Test\DataProviderMethodCalled;
use PHPUnit\Event\Test\DataProviderMethodFinished;
use PHPUnit\Event\TestSuite\Filtered as TestSuiteFiltered;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Loaded as TestSuiteLoaded;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\Event\TestSuite\Sorted as TestSuiteSorted;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuite;
use PHPUnit\Framework\Constraint;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DispatchingEmitter implements Emitter
{
private readonly Dispatcher $dispatcher;
private readonly Telemetry\System $system;
private readonly Telemetry\Snapshot $startSnapshot;
private Telemetry\Snapshot $previousSnapshot;
private bool $exportObjects = false;
public function __construct(Dispatcher $dispatcher, Telemetry\System $system)
{
$this->dispatcher = $dispatcher;
$this->system = $system;
$this->startSnapshot = $system->snapshot();
$this->previousSnapshot = $this->startSnapshot;
}
/**
* @deprecated
*/
public function exportObjects(): void
{
$this->exportObjects = true;
}
/**
* @deprecated
*/
public function exportsObjects(): bool
{
return $this->exportObjects;
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function applicationStarted(): void
{
$this->dispatcher->dispatch(
new Application\Started(
$this->telemetryInfo(),
new Runtime\Runtime,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerStarted(): void
{
$this->dispatcher->dispatch(
new TestRunner\Started(
$this->telemetryInfo(),
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerConfigured(Configuration $configuration): void
{
$this->dispatcher->dispatch(
new TestRunner\Configured(
$this->telemetryInfo(),
$configuration,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerBootstrapFinished(string $filename): void
{
$this->dispatcher->dispatch(
new TestRunner\BootstrapFinished(
$this->telemetryInfo(),
$filename,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerLoadedExtensionFromPhar(string $filename, string $name, string $version): void
{
$this->dispatcher->dispatch(
new TestRunner\ExtensionLoadedFromPhar(
$this->telemetryInfo(),
$filename,
$name,
$version,
),
);
}
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerBootstrappedExtension(string $className, array $parameters): void
{
$this->dispatcher->dispatch(
new TestRunner\ExtensionBootstrapped(
$this->telemetryInfo(),
$className,
$parameters,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function dataProviderMethodCalled(ClassMethod $testMethod, ClassMethod $dataProviderMethod): void
{
$this->dispatcher->dispatch(
new DataProviderMethodCalled(
$this->telemetryInfo(),
$testMethod,
$dataProviderMethod,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function dataProviderMethodFinished(ClassMethod $testMethod, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new DataProviderMethodFinished(
$this->telemetryInfo(),
$testMethod,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteLoaded(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteLoaded(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteFiltered(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteFiltered(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteSorted(int $executionOrder, int $executionOrderDefects, bool $resolveDependencies): void
{
$this->dispatcher->dispatch(
new TestSuiteSorted(
$this->telemetryInfo(),
$executionOrder,
$executionOrderDefects,
$resolveDependencies,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerEventFacadeSealed(): void
{
$this->dispatcher->dispatch(
new TestRunner\EventFacadeSealed(
$this->telemetryInfo(),
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionStarted(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionStarted(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerDisabledGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionDisabled($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionTriggered($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteSkipped(TestSuite $testSuite, string $message): void
{
$this->dispatcher->dispatch(
new TestSuiteSkipped(
$this->telemetryInfo(),
$testSuite,
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteStarted(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteStarted(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreparationStarted(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\PreparationStarted(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreparationFailed(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\PreparationFailed(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodErrored(string $testClassName, ClassMethod $calledMethod, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodErrored(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
$throwable,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeFirstTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\BeforeFirstTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\BeforeTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testBeforeTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\BeforeTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreConditionCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\PreConditionCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPreConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\PreConditionFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPrepared(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\Prepared(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRegisteredComparator(string $className): void
{
$this->dispatcher->dispatch(
new Test\ComparatorRegistered(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*
* @deprecated
*/
public function testAssertionSucceeded(mixed $value, Constraint\Constraint $constraint, string $message): void
{
$this->dispatcher->dispatch(
new Test\AssertionSucceeded(
$this->telemetryInfo(),
Exporter::export($value, $this->exportObjects),
$constraint->toString($this->exportObjects),
$constraint->count(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*
* @deprecated
*/
public function testAssertionFailed(mixed $value, Constraint\Constraint $constraint, string $message): void
{
$this->dispatcher->dispatch(
new Test\AssertionFailed(
$this->telemetryInfo(),
Exporter::export($value, $this->exportObjects),
$constraint->toString($this->exportObjects),
$constraint->count(),
$message,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObject(string $className): void
{
$this->dispatcher->dispatch(
new Test\MockObjectCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForIntersectionOfInterfaces(array $interfaces): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForIntersectionOfInterfacesCreated(
$this->telemetryInfo(),
$interfaces,
),
);
}
/**
* @psalm-param trait-string $traitName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForTrait(string $traitName): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForTraitCreated(
$this->telemetryInfo(),
$traitName,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectForAbstractClass(string $className): void
{
$this->dispatcher->dispatch(
new Test\MockObjectForAbstractClassCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedMockObjectFromWsdl(string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options): void
{
$this->dispatcher->dispatch(
new Test\MockObjectFromWsdlCreated(
$this->telemetryInfo(),
$wsdlFile,
$originalClassName,
$mockClassName,
$methods,
$callOriginalConstructor,
$options,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedPartialMockObject(string $className, string ...$methodNames): void
{
$this->dispatcher->dispatch(
new Test\PartialMockObjectCreated(
$this->telemetryInfo(),
$className,
...$methodNames,
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedTestProxy(string $className, array $constructorArguments): void
{
$this->dispatcher->dispatch(
new Test\TestProxyCreated(
$this->telemetryInfo(),
$className,
Exporter::export($constructorArguments, $this->exportObjects),
),
);
}
/**
* @psalm-param class-string $className
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedStub(string $className): void
{
$this->dispatcher->dispatch(
new Test\TestStubCreated(
$this->telemetryInfo(),
$className,
),
);
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testCreatedStubForIntersectionOfInterfaces(array $interfaces): void
{
$this->dispatcher->dispatch(
new Test\TestStubForIntersectionOfInterfacesCreated(
$this->telemetryInfo(),
$interfaces,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testErrored(Code\Test $test, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\Errored(
$this->telemetryInfo(),
$test,
$throwable,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testFailed(Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure): void
{
$this->dispatcher->dispatch(
new Test\Failed(
$this->telemetryInfo(),
$test,
$throwable,
$comparisonFailure,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPassed(Code\Test $test): void
{
$this->dispatcher->dispatch(
new Test\Passed(
$this->telemetryInfo(),
$test,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testConsideredRisky(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\ConsideredRisky(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testMarkedAsIncomplete(Code\Test $test, Throwable $throwable): void
{
$this->dispatcher->dispatch(
new Test\MarkedIncomplete(
$this->telemetryInfo(),
$test,
$throwable,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSkipped(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\Skipped(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitDeprecation(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitDeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void
{
$this->dispatcher->dispatch(
new Test\PhpDeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void
{
$this->dispatcher->dispatch(
new Test\DeprecationTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredError(Code\Test $test, string $message, string $file, int $line, bool $suppressed): void
{
$this->dispatcher->dispatch(
new Test\ErrorTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\NoticeTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\PhpNoticeTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\WarningTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void
{
$this->dispatcher->dispatch(
new Test\PhpWarningTriggered(
$this->telemetryInfo(),
$test,
$message,
$file,
$line,
$suppressed,
$ignoredByBaseline,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitError(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitErrorTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $message
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testTriggeredPhpunitWarning(Code\Test $test, string $message): void
{
$this->dispatcher->dispatch(
new Test\PhpunitWarningTriggered(
$this->telemetryInfo(),
$test,
$message,
),
);
}
/**
* @psalm-param non-empty-string $output
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPrintedUnexpectedOutput(string $output): void
{
$this->dispatcher->dispatch(
new Test\PrintedUnexpectedOutput(
$this->telemetryInfo(),
$output,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testFinished(Code\Test $test, int $numberOfAssertionsPerformed): void
{
$this->dispatcher->dispatch(
new Test\Finished(
$this->telemetryInfo(),
$test,
$numberOfAssertionsPerformed,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPostConditionCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\PostConditionCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testPostConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\PostConditionFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\AfterTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\AfterTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterLastTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void
{
$this->dispatcher->dispatch(
new Test\AfterLastTestMethodCalled(
$this->telemetryInfo(),
$testClassName,
$calledMethod,
),
);
}
/**
* @psalm-param class-string $testClassName
*
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testAfterLastTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void
{
$this->dispatcher->dispatch(
new Test\AfterLastTestMethodFinished(
$this->telemetryInfo(),
$testClassName,
...$calledMethods,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testSuiteFinished(TestSuite $testSuite): void
{
$this->dispatcher->dispatch(
new TestSuiteFinished(
$this->telemetryInfo(),
$testSuite,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredDeprecation(string $message): void
{
$this->dispatcher->dispatch(
new TestRunner\DeprecationTriggered(
$this->telemetryInfo(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerTriggeredWarning(string $message): void
{
$this->dispatcher->dispatch(
new TestRunner\WarningTriggered(
$this->telemetryInfo(),
$message,
),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerEnabledGarbageCollection(): void
{
$this->dispatcher->dispatch(
new TestRunner\GarbageCollectionEnabled($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionAborted(): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionAborted($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerExecutionFinished(): void
{
$this->dispatcher->dispatch(
new TestRunner\ExecutionFinished($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function testRunnerFinished(): void
{
$this->dispatcher->dispatch(
new TestRunner\Finished($this->telemetryInfo()),
);
}
/**
* @throws InvalidArgumentException
* @throws UnknownEventTypeException
*/
public function applicationFinished(int $shellExitCode): void
{
$this->dispatcher->dispatch(
new Application\Finished(
$this->telemetryInfo(),
$shellExitCode,
),
);
}
/**
* @throws InvalidArgumentException
*/
private function telemetryInfo(): Telemetry\Info
{
$current = $this->system->snapshot();
$info = new Telemetry\Info(
$current,
$current->time()->duration($this->startSnapshot->time()),
$current->memoryUsage()->diff($this->startSnapshot->memoryUsage()),
$current->time()->duration($this->previousSnapshot->time()),
$current->memoryUsage()->diff($this->previousSnapshot->memoryUsage()),
);
$this->previousSnapshot = $current;
return $info;
}
}
src/Event/Emitter/Emitter.php 0000644 00000024446 15243426620 0012165 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\TestSuite\TestSuite;
use PHPUnit\Framework\Constraint;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Emitter
{
/**
* @deprecated
*/
public function exportObjects(): void;
/**
* @deprecated
*/
public function exportsObjects(): bool;
public function applicationStarted(): void;
public function testRunnerStarted(): void;
public function testRunnerConfigured(Configuration $configuration): void;
public function testRunnerBootstrapFinished(string $filename): void;
public function testRunnerLoadedExtensionFromPhar(string $filename, string $name, string $version): void;
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function testRunnerBootstrappedExtension(string $className, array $parameters): void;
public function dataProviderMethodCalled(ClassMethod $testMethod, ClassMethod $dataProviderMethod): void;
public function dataProviderMethodFinished(ClassMethod $testMethod, ClassMethod ...$calledMethods): void;
public function testSuiteLoaded(TestSuite $testSuite): void;
public function testSuiteFiltered(TestSuite $testSuite): void;
public function testSuiteSorted(int $executionOrder, int $executionOrderDefects, bool $resolveDependencies): void;
public function testRunnerEventFacadeSealed(): void;
public function testRunnerExecutionStarted(TestSuite $testSuite): void;
public function testRunnerDisabledGarbageCollection(): void;
public function testRunnerTriggeredGarbageCollection(): void;
public function testSuiteSkipped(TestSuite $testSuite, string $message): void;
public function testSuiteStarted(TestSuite $testSuite): void;
public function testPreparationStarted(Code\Test $test): void;
public function testPreparationFailed(Code\Test $test): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodErrored(string $testClassName, ClassMethod $calledMethod, Throwable $throwable): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeFirstTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testBeforeTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPreConditionCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPreConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void;
public function testPrepared(Code\Test $test): void;
/**
* @psalm-param class-string $className
*/
public function testRegisteredComparator(string $className): void;
/**
* @deprecated
*/
public function testAssertionSucceeded(mixed $value, Constraint\Constraint $constraint, string $message): void;
/**
* @deprecated
*/
public function testAssertionFailed(mixed $value, Constraint\Constraint $constraint, string $message): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedMockObject(string $className): void;
/**
* @psalm-param list<class-string> $interfaces
*/
public function testCreatedMockObjectForIntersectionOfInterfaces(array $interfaces): void;
/**
* @psalm-param trait-string $traitName
*/
public function testCreatedMockObjectForTrait(string $traitName): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedMockObjectForAbstractClass(string $className): void;
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*/
public function testCreatedMockObjectFromWsdl(string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedPartialMockObject(string $className, string ...$methodNames): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedTestProxy(string $className, array $constructorArguments): void;
/**
* @psalm-param class-string $className
*/
public function testCreatedStub(string $className): void;
/**
* @psalm-param list<class-string> $interfaces
*/
public function testCreatedStubForIntersectionOfInterfaces(array $interfaces): void;
public function testErrored(Code\Test $test, Throwable $throwable): void;
public function testFailed(Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure): void;
public function testPassed(Code\Test $test): void;
/**
* @psalm-param non-empty-string $message
*/
public function testConsideredRisky(Code\Test $test, string $message): void;
public function testMarkedAsIncomplete(Code\Test $test, Throwable $throwable): void;
/**
* @psalm-param non-empty-string $message
*/
public function testSkipped(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitDeprecation(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredDeprecation(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredError(Code\Test $test, string $message, string $file, int $line, bool $suppressed): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpNotice(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function testTriggeredPhpWarning(Code\Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitError(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $message
*/
public function testTriggeredPhpunitWarning(Code\Test $test, string $message): void;
/**
* @psalm-param non-empty-string $output
*/
public function testPrintedUnexpectedOutput(string $output): void;
public function testFinished(Code\Test $test, int $numberOfAssertionsPerformed): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPostConditionCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testPostConditionFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterLastTestMethodCalled(string $testClassName, ClassMethod $calledMethod): void;
/**
* @psalm-param class-string $testClassName
*/
public function testAfterLastTestMethodFinished(string $testClassName, ClassMethod ...$calledMethods): void;
public function testSuiteFinished(TestSuite $testSuite): void;
public function testRunnerTriggeredDeprecation(string $message): void;
public function testRunnerTriggeredWarning(string $message): void;
public function testRunnerEnabledGarbageCollection(): void;
public function testRunnerExecutionAborted(): void;
public function testRunnerExecutionFinished(): void;
public function testRunnerFinished(): void;
public function applicationFinished(int $shellExitCode): void;
}
src/Event/Dispatcher/DirectDispatcher.php 0000644 00000007022 15243426620 0014441 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function array_key_exists;
use function dirname;
use function sprintf;
use function str_starts_with;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectDispatcher implements SubscribableDispatcher
{
private readonly TypeMap $typeMap;
/**
* @psalm-var array<class-string, list<Subscriber>>
*/
private array $subscribers = [];
/**
* @psalm-var list<Tracer\Tracer>
*/
private array $tracers = [];
public function __construct(TypeMap $map)
{
$this->typeMap = $map;
}
public function registerTracer(Tracer\Tracer $tracer): void
{
$this->tracers[] = $tracer;
}
/**
* @throws MapError
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
if (!$this->typeMap->isKnownSubscriberType($subscriber)) {
throw new UnknownSubscriberTypeException(
sprintf(
'Subscriber "%s" does not implement any known interface - did you forget to register it?',
$subscriber::class,
),
);
}
$eventClassName = $this->typeMap->map($subscriber);
if (!array_key_exists($eventClassName, $this->subscribers)) {
$this->subscribers[$eventClassName] = [];
}
$this->subscribers[$eventClassName][] = $subscriber;
}
/**
* @throws Throwable
* @throws UnknownEventTypeException
*/
public function dispatch(Event $event): void
{
$eventClassName = $event::class;
if (!$this->typeMap->isKnownEventType($event)) {
throw new UnknownEventTypeException(
sprintf(
'Unknown event type "%s"',
$eventClassName,
),
);
}
foreach ($this->tracers as $tracer) {
try {
$tracer->trace($event);
// @codeCoverageIgnoreStart
} catch (Throwable $t) {
$this->handleThrowable($t);
}
// @codeCoverageIgnoreEnd
}
if (!array_key_exists($eventClassName, $this->subscribers)) {
return;
}
foreach ($this->subscribers[$eventClassName] as $subscriber) {
try {
$subscriber->notify($event);
} catch (Throwable $t) {
$this->handleThrowable($t);
}
}
}
/**
* @throws Throwable
*/
public function handleThrowable(Throwable $t): void
{
if ($this->isThrowableFromThirdPartySubscriber($t)) {
Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Exception in third-party event subscriber: %s%s%s',
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
),
);
return;
}
// @codeCoverageIgnoreStart
throw $t;
// @codeCoverageIgnoreEnd
}
private function isThrowableFromThirdPartySubscriber(Throwable $t): bool
{
return !str_starts_with($t->getFile(), dirname(__DIR__, 2));
}
}
src/Event/Dispatcher/SubscribableDispatcher.php 0000644 00000001172 15243426620 0015627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface SubscribableDispatcher extends Dispatcher
{
/**
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void;
public function registerTracer(Tracer\Tracer $tracer): void;
}
src/Event/Dispatcher/Dispatcher.php 0000644 00000001000 15243426620 0013274 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Dispatcher
{
/**
* @throws UnknownEventTypeException
*/
public function dispatch(Event $event): void;
}
src/Event/Dispatcher/CollectingDispatcher.php 0000644 00000001470 15243426620 0015313 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CollectingDispatcher implements Dispatcher
{
private EventCollection $events;
public function __construct()
{
$this->events = new EventCollection;
}
public function dispatch(Event $event): void
{
$this->events->add($event);
}
public function flush(): EventCollection
{
$events = $this->events;
$this->events = new EventCollection;
return $events;
}
}
src/Event/Dispatcher/DeferringDispatcher.php 0000644 00000002664 15243426620 0015143 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DeferringDispatcher implements SubscribableDispatcher
{
private readonly SubscribableDispatcher $dispatcher;
private EventCollection $events;
private bool $recording = true;
public function __construct(SubscribableDispatcher $dispatcher)
{
$this->dispatcher = $dispatcher;
$this->events = new EventCollection;
}
public function registerTracer(Tracer\Tracer $tracer): void
{
$this->dispatcher->registerTracer($tracer);
}
public function registerSubscriber(Subscriber $subscriber): void
{
$this->dispatcher->registerSubscriber($subscriber);
}
public function dispatch(Event $event): void
{
if ($this->recording) {
$this->events->add($event);
return;
}
$this->dispatcher->dispatch($event);
}
public function flush(): void
{
$this->recording = false;
foreach ($this->events as $event) {
$this->dispatcher->dispatch($event);
}
$this->events = new EventCollection;
}
}
src/Event/Facade.php 0000644 00000020113 15243426620 0010271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function gc_status;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Telemetry\Php81GarbageCollectorStatusProvider;
use PHPUnit\Event\Telemetry\Php83GarbageCollectorStatusProvider;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?self $instance = null;
private Emitter $emitter;
private ?TypeMap $typeMap = null;
private ?DeferringDispatcher $deferringDispatcher = null;
private bool $sealed = false;
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public static function emitter(): Emitter
{
return self::instance()->emitter;
}
public function __construct()
{
$this->emitter = $this->createDispatchingEmitter();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscribers(Subscriber ...$subscribers): void
{
foreach ($subscribers as $subscriber) {
$this->registerSubscriber($subscriber);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
if ($this->sealed) {
throw new EventFacadeIsSealedException;
}
$this->deferredDispatcher()->registerSubscriber($subscriber);
}
/**
* @throws EventFacadeIsSealedException
*/
public function registerTracer(Tracer\Tracer $tracer): void
{
if ($this->sealed) {
throw new EventFacadeIsSealedException;
}
$this->deferredDispatcher()->registerTracer($tracer);
}
/**
* @codeCoverageIgnore
*
* @noinspection PhpUnused
*/
public function initForIsolation(HRTime $offset, bool $exportObjects): CollectingDispatcher
{
$dispatcher = new CollectingDispatcher;
$this->emitter = new DispatchingEmitter(
$dispatcher,
new Telemetry\System(
new Telemetry\SystemStopWatchWithOffset($offset),
new Telemetry\SystemMemoryMeter,
$this->garbageCollectorStatusProvider(),
),
);
if ($exportObjects) {
$this->emitter->exportObjects();
}
$this->sealed = true;
return $dispatcher;
}
public function forward(EventCollection $events): void
{
$dispatcher = $this->deferredDispatcher();
foreach ($events as $event) {
$dispatcher->dispatch($event);
}
}
public function seal(): void
{
$this->deferredDispatcher()->flush();
$this->sealed = true;
$this->emitter->testRunnerEventFacadeSealed();
}
private function createDispatchingEmitter(): DispatchingEmitter
{
return new DispatchingEmitter(
$this->deferredDispatcher(),
$this->createTelemetrySystem(),
);
}
private function createTelemetrySystem(): Telemetry\System
{
return new Telemetry\System(
new Telemetry\SystemStopWatch,
new Telemetry\SystemMemoryMeter,
$this->garbageCollectorStatusProvider(),
);
}
private function deferredDispatcher(): DeferringDispatcher
{
if ($this->deferringDispatcher === null) {
$this->deferringDispatcher = new DeferringDispatcher(
new DirectDispatcher($this->typeMap()),
);
}
return $this->deferringDispatcher;
}
private function typeMap(): TypeMap
{
if ($this->typeMap === null) {
$typeMap = new TypeMap;
$this->registerDefaultTypes($typeMap);
$this->typeMap = $typeMap;
}
return $this->typeMap;
}
private function registerDefaultTypes(TypeMap $typeMap): void
{
$defaultEvents = [
Application\Started::class,
Application\Finished::class,
Test\DataProviderMethodCalled::class,
Test\DataProviderMethodFinished::class,
Test\MarkedIncomplete::class,
Test\AfterLastTestMethodCalled::class,
Test\AfterLastTestMethodFinished::class,
Test\AfterTestMethodCalled::class,
Test\AfterTestMethodFinished::class,
Test\AssertionSucceeded::class,
Test\AssertionFailed::class,
Test\BeforeFirstTestMethodCalled::class,
Test\BeforeFirstTestMethodErrored::class,
Test\BeforeFirstTestMethodFinished::class,
Test\BeforeTestMethodCalled::class,
Test\BeforeTestMethodFinished::class,
Test\ComparatorRegistered::class,
Test\ConsideredRisky::class,
Test\DeprecationTriggered::class,
Test\Errored::class,
Test\ErrorTriggered::class,
Test\Failed::class,
Test\Finished::class,
Test\NoticeTriggered::class,
Test\Passed::class,
Test\PhpDeprecationTriggered::class,
Test\PhpNoticeTriggered::class,
Test\PhpunitDeprecationTriggered::class,
Test\PhpunitErrorTriggered::class,
Test\PhpunitWarningTriggered::class,
Test\PhpWarningTriggered::class,
Test\PostConditionCalled::class,
Test\PostConditionFinished::class,
Test\PreConditionCalled::class,
Test\PreConditionFinished::class,
Test\PreparationStarted::class,
Test\Prepared::class,
Test\PreparationFailed::class,
Test\PrintedUnexpectedOutput::class,
Test\Skipped::class,
Test\WarningTriggered::class,
Test\MockObjectCreated::class,
Test\MockObjectForAbstractClassCreated::class,
Test\MockObjectForIntersectionOfInterfacesCreated::class,
Test\MockObjectForTraitCreated::class,
Test\MockObjectFromWsdlCreated::class,
Test\PartialMockObjectCreated::class,
Test\TestProxyCreated::class,
Test\TestStubCreated::class,
Test\TestStubForIntersectionOfInterfacesCreated::class,
TestRunner\BootstrapFinished::class,
TestRunner\Configured::class,
TestRunner\EventFacadeSealed::class,
TestRunner\ExecutionAborted::class,
TestRunner\ExecutionFinished::class,
TestRunner\ExecutionStarted::class,
TestRunner\ExtensionLoadedFromPhar::class,
TestRunner\ExtensionBootstrapped::class,
TestRunner\Finished::class,
TestRunner\Started::class,
TestRunner\DeprecationTriggered::class,
TestRunner\WarningTriggered::class,
TestRunner\GarbageCollectionDisabled::class,
TestRunner\GarbageCollectionTriggered::class,
TestRunner\GarbageCollectionEnabled::class,
TestSuite\Filtered::class,
TestSuite\Finished::class,
TestSuite\Loaded::class,
TestSuite\Skipped::class,
TestSuite\Sorted::class,
TestSuite\Started::class,
];
foreach ($defaultEvents as $eventClass) {
$typeMap->addMapping(
$eventClass . 'Subscriber',
$eventClass,
);
}
}
private function garbageCollectorStatusProvider(): Telemetry\GarbageCollectorStatusProvider
{
if (!isset(gc_status()['running'])) {
// @codeCoverageIgnoreStart
return new Php81GarbageCollectorStatusProvider;
// @codeCoverageIgnoreEnd
}
return new Php83GarbageCollectorStatusProvider;
}
}
src/Event/Subscriber.php 0000644 00000000641 15243426620 0011235 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Subscriber
{
}
src/Event/Exception/UnknownSubscriberTypeException.php 0000644 00000000774 15243426620 0017303 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownSubscriberTypeException extends RuntimeException implements Exception
{
}
src/Event/Exception/NoTestCaseObjectOnCallStackException.php 0000644 00000001214 15243426620 0020162 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoTestCaseObjectOnCallStackException extends RuntimeException implements Exception
{
public function __construct()
{
parent::__construct('Cannot find TestCase object on call stack');
}
}
src/Event/Exception/UnknownSubscriberException.php 0000644 00000000770 15243426620 0016435 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownSubscriberException extends RuntimeException implements Exception
{
}
src/Event/Exception/MapError.php 0000644 00000000746 15243426620 0012625 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MapError extends RuntimeException implements Exception
{
}
src/Event/Exception/NoPreviousThrowableException.php 0000644 00000000772 15243426620 0016735 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoPreviousThrowableException extends RuntimeException implements Exception
{
}
src/Event/Exception/InvalidSubscriberException.php 0000644 00000000770 15243426620 0016364 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidSubscriberException extends RuntimeException implements Exception
{
}
src/Event/Exception/NoDataSetFromDataProviderException.php 0000644 00000001046 15243426620 0017722 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoDataSetFromDataProviderException extends RuntimeException implements Exception
{
}
src/Event/Exception/InvalidArgumentException.php 0000644 00000000750 15243426620 0016041 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidArgumentException extends \InvalidArgumentException implements Exception
{
}
src/Event/Exception/MoreThanOneDataSetFromDataProviderException.php 0000644 00000001057 15243426620 0021527 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MoreThanOneDataSetFromDataProviderException extends RuntimeException implements Exception
{
}
src/Event/Exception/UnknownEventException.php 0000644 00000000763 15243426620 0015415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownEventException extends RuntimeException implements Exception
{
}
src/Event/Exception/NoComparisonFailureException.php 0000644 00000001034 15243426620 0016663 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Exception;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoComparisonFailureException extends RuntimeException implements Exception
{
}
src/Event/Exception/InvalidEventException.php 0000644 00000000763 15243426620 0015344 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidEventException extends RuntimeException implements Exception
{
}
src/Event/Exception/EventAlreadyAssignedException.php 0000644 00000000773 15243426620 0017016 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventAlreadyAssignedException extends RuntimeException implements Exception
{
}
src/Event/Exception/EventFacadeIsSealedException.php 0000644 00000000772 15243426620 0016533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventFacadeIsSealedException extends RuntimeException implements Exception
{
}
src/Event/Exception/UnknownEventTypeException.php 0000644 00000000767 15243426620 0016263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownEventTypeException extends RuntimeException implements Exception
{
}
src/Event/Exception/SubscriberTypeAlreadyRegisteredException.php 0000644 00000001006 15243426620 0021230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class SubscriberTypeAlreadyRegisteredException extends RuntimeException implements Exception
{
}
src/Event/Exception/Exception.php 0000644 00000000512 15243426620 0013023 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
interface Exception extends \PHPUnit\Exception
{
}
src/Event/Exception/RuntimeException.php 0000644 00000000730 15243426620 0014371 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
src/Event/TypeMap.php 0000644 00000012737 15243426620 0010522 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function array_key_exists;
use function class_exists;
use function class_implements;
use function in_array;
use function interface_exists;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TypeMap
{
/**
* @psalm-var array<class-string, class-string>
*/
private array $mapping = [];
/**
* @psalm-param class-string $subscriberInterface
* @psalm-param class-string $eventClass
*
* @throws EventAlreadyAssignedException
* @throws InvalidEventException
* @throws InvalidSubscriberException
* @throws SubscriberTypeAlreadyRegisteredException
* @throws UnknownEventException
* @throws UnknownSubscriberException
*/
public function addMapping(string $subscriberInterface, string $eventClass): void
{
$this->ensureSubscriberInterfaceExists($subscriberInterface);
$this->ensureSubscriberInterfaceExtendsInterface($subscriberInterface);
$this->ensureEventClassExists($eventClass);
$this->ensureEventClassImplementsEventInterface($eventClass);
$this->ensureSubscriberWasNotAlreadyRegistered($subscriberInterface);
$this->ensureEventWasNotAlreadyAssigned($eventClass);
$this->mapping[$subscriberInterface] = $eventClass;
}
public function isKnownSubscriberType(Subscriber $subscriber): bool
{
foreach (class_implements($subscriber) as $interface) {
if (array_key_exists($interface, $this->mapping)) {
return true;
}
}
return false;
}
public function isKnownEventType(Event $event): bool
{
return in_array($event::class, $this->mapping, true);
}
/**
* @psalm-return class-string
*
* @throws MapError
*/
public function map(Subscriber $subscriber): string
{
foreach (class_implements($subscriber) as $interface) {
if (array_key_exists($interface, $this->mapping)) {
return $this->mapping[$interface];
}
}
throw new MapError(
sprintf(
'Subscriber "%s" does not implement a known interface',
$subscriber::class,
),
);
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws UnknownSubscriberException
*/
private function ensureSubscriberInterfaceExists(string $subscriberInterface): void
{
if (!interface_exists($subscriberInterface)) {
throw new UnknownSubscriberException(
sprintf(
'Subscriber "%s" does not exist or is not an interface',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws UnknownEventException
*/
private function ensureEventClassExists(string $eventClass): void
{
if (!class_exists($eventClass)) {
throw new UnknownEventException(
sprintf(
'Event class "%s" does not exist',
$eventClass,
),
);
}
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws InvalidSubscriberException
*/
private function ensureSubscriberInterfaceExtendsInterface(string $subscriberInterface): void
{
if (!in_array(Subscriber::class, class_implements($subscriberInterface), true)) {
throw new InvalidSubscriberException(
sprintf(
'Subscriber "%s" does not extend Subscriber interface',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws InvalidEventException
*/
private function ensureEventClassImplementsEventInterface(string $eventClass): void
{
if (!in_array(Event::class, class_implements($eventClass), true)) {
throw new InvalidEventException(
sprintf(
'Event "%s" does not implement Event interface',
$eventClass,
),
);
}
}
/**
* @psalm-param class-string $subscriberInterface
*
* @throws SubscriberTypeAlreadyRegisteredException
*/
private function ensureSubscriberWasNotAlreadyRegistered(string $subscriberInterface): void
{
if (array_key_exists($subscriberInterface, $this->mapping)) {
throw new SubscriberTypeAlreadyRegisteredException(
sprintf(
'Subscriber type "%s" already registered',
$subscriberInterface,
),
);
}
}
/**
* @psalm-param class-string $eventClass
*
* @throws EventAlreadyAssignedException
*/
private function ensureEventWasNotAlreadyAssigned(string $eventClass): void
{
if (in_array($eventClass, $this->mapping, true)) {
throw new EventAlreadyAssignedException(
sprintf(
'Event "%s" already assigned',
$eventClass,
),
);
}
}
}
src/Event/Events/EventCollectionIterator.php 0000644 00000002243 15243426620 0015205 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Event>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventCollectionIterator implements Iterator
{
/**
* @psalm-var list<Event>
*/
private readonly array $events;
private int $position = 0;
public function __construct(EventCollection $events)
{
$this->events = $events->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->events);
}
public function key(): int
{
return $this->position;
}
public function current(): Event
{
return $this->events[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/Event/Events/Event.php 0000644 00000000772 15243426620 0011464 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Event
{
public function telemetryInfo(): Telemetry\Info;
public function asString(): string;
}
src/Event/Events/TestSuite/Finished.php 0000644 00000002411 15243426620 0014055 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Finished (%s, %d test%s)',
$this->testSuite->name(),
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
src/Event/Events/TestSuite/FinishedSubscriber.php 0000644 00000001030 15243426620 0016075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
src/Event/Events/TestSuite/SkippedSubscriber.php 0000644 00000001026 15243426620 0015750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedSubscriber extends Subscriber
{
public function notify(Skipped $event): void;
}
src/Event/Events/TestSuite/Sorted.php 0000644 00000003070 15243426620 0013566 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Sorted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly int $executionOrder;
private readonly int $executionOrderDefects;
private readonly bool $resolveDependencies;
public function __construct(Telemetry\Info $telemetryInfo, int $executionOrder, int $executionOrderDefects, bool $resolveDependencies)
{
$this->telemetryInfo = $telemetryInfo;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->resolveDependencies = $resolveDependencies;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function executionOrderDefects(): int
{
return $this->executionOrderDefects;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
public function asString(): string
{
return 'Test Suite Sorted';
}
}
src/Event/Events/TestSuite/LoadedSubscriber.php 0000644 00000001024 15243426620 0015537 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface LoadedSubscriber extends Subscriber
{
public function notify(Loaded $event): void;
}
src/Event/Events/TestSuite/StartedSubscriber.php 0000644 00000001026 15243426620 0015757 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
src/Event/Events/TestSuite/SortedSubscriber.php 0000644 00000001024 15243426620 0015607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SortedSubscriber extends Subscriber
{
public function notify(Sorted $event): void;
}
src/Event/Events/TestSuite/FilteredSubscriber.php 0000644 00000001030 15243426620 0016102 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FilteredSubscriber extends Subscriber
{
public function notify(Filtered $event): void;
}
src/Event/Events/TestSuite/Started.php 0000644 00000002407 15243426620 0013737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Started (%s, %d test%s)',
$this->testSuite->name(),
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
src/Event/Events/TestSuite/Skipped.php 0000644 00000002557 15243426620 0013736 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Suite Skipped (%s, %s)',
$this->testSuite->name(),
$this->message,
);
}
}
src/Event/Events/TestSuite/Loaded.php 0000644 00000002333 15243426620 0013517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Loaded implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Loaded (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
src/Event/Events/TestSuite/Filtered.php 0000644 00000002337 15243426620 0014071 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Filtered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Suite Filtered (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
src/Event/Events/Test/PrintedUnexpectedOutput.php 0000644 00000002514 15243426620 0016171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PrintedUnexpectedOutput implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var non-empty-string
*/
private readonly string $output;
/**
* @psalm-param non-empty-string $output
*/
public function __construct(Telemetry\Info $telemetryInfo, string $output)
{
$this->telemetryInfo = $telemetryInfo;
$this->output = $output;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return non-empty-string
*/
public function output(): string
{
return $this->output;
}
public function asString(): string
{
return sprintf(
'Test Printed Unexpected Output%s%s',
PHP_EOL,
$this->output,
);
}
}
src/Event/Events/Test/HookMethod/PostConditionCalledSubscriber.php 0000644 00000001051 15243426620 0021277 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PostConditionCalledSubscriber extends Subscriber
{
public function notify(PostConditionCalled $event): void;
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodErroredSubscriber.php 0000644 00000001073 15243426620 0023140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodErroredSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void;
}
src/Event/Events/Test/HookMethod/PreConditionFinishedSubscriber.php 0000644 00000001053 15243426620 0021447 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreConditionFinishedSubscriber extends Subscriber
{
public function notify(PreConditionFinished $event): void;
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodErrored.php 0000644 00000004052 15243426620 0021114 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodErrored implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
private readonly Throwable $throwable;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = $this->throwable->message();
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Before First Test Method Errored (%s::%s)%s',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
$message,
);
}
}
src/Event/Events/Test/HookMethod/PostConditionFinishedSubscriber.php 0000644 00000001055 15243426620 0021650 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PostConditionFinishedSubscriber extends Subscriber
{
public function notify(PostConditionFinished $event): void;
}
src/Event/Events/Test/HookMethod/BeforeTestMethodCalledSubscriber.php 0000644 00000001057 15243426620 0021714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeTestMethodCalledSubscriber extends Subscriber
{
public function notify(BeforeTestMethodCalled $event): void;
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodCalled.php 0000644 00000003242 15243426620 0020676 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Before First Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/AfterLastTestMethodFinishedSubscriber.php 0000644 00000001071 15243426620 0022740 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterLastTestMethodFinishedSubscriber extends Subscriber
{
public function notify(AfterLastTestMethodFinished $event): void;
}
src/Event/Events/Test/HookMethod/AfterTestMethodFinished.php 0000644 00000003636 15243426620 0020101 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'After Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/BeforeTestMethodFinished.php 0000644 00000003640 15243426620 0020235 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Before Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/PreConditionCalled.php 0000644 00000003224 15243426620 0017060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreConditionCalled implements Event
{
private readonly Telemetry\Info$telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Pre Condition Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodFinished.php 0000644 00000003652 15243426620 0021250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeFirstTestMethodFinished implements Event
{
private readonly Telemetry\Info$telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Before First Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/BeforeTestMethodFinishedSubscriber.php 0000644 00000001063 15243426620 0022256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeTestMethodFinishedSubscriber extends Subscriber
{
public function notify(BeforeTestMethodFinished $event): void;
}
src/Event/Events/Test/HookMethod/AfterTestMethodFinishedSubscriber.php 0000644 00000001061 15243426620 0022113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterTestMethodFinishedSubscriber extends Subscriber
{
public function notify(AfterTestMethodFinished $event): void;
}
src/Event/Events/Test/HookMethod/PostConditionFinished.php 0000644 00000003640 15243426620 0017626 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostConditionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Post Condition Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/AfterLastTestMethodCalled.php 0000644 00000003236 15243426620 0020354 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterLastTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'After Last Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/BeforeTestMethodCalled.php 0000644 00000003227 15243426620 0017671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Before Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodCalledSubscriber.php 0000644 00000001071 15243426620 0022720 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodCalledSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodCalled $event): void;
}
src/Event/Events/Test/HookMethod/PreConditionCalledSubscriber.php 0000644 00000001047 15243426620 0021105 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreConditionCalledSubscriber extends Subscriber
{
public function notify(PreConditionCalled $event): void;
}
src/Event/Events/Test/HookMethod/AfterLastTestMethodFinished.php 0000644 00000003647 15243426620 0020727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterLastTestMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'After Last Test Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/PostConditionCalled.php 0000644 00000003227 15243426620 0017262 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostConditionCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'Post Condition Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/PreConditionFinished.php 0000644 00000003636 15243426620 0017434 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreConditionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
/**
* @psalm-var list<Code\ClassMethod>
*/
private readonly array $calledMethods;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = 'Pre Condition Method Finished:';
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/HookMethod/AfterTestMethodCalled.php 0000644 00000003225 15243426620 0017526 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterTestMethodCalled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $testClassName;
private readonly Code\ClassMethod $calledMethod;
/**
* @psalm-param class-string $testClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $testClassName, Code\ClassMethod $calledMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testClassName = $testClassName;
$this->calledMethod = $calledMethod;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function testClassName(): string
{
return $this->testClassName;
}
public function calledMethod(): Code\ClassMethod
{
return $this->calledMethod;
}
public function asString(): string
{
return sprintf(
'After Test Method Called (%s::%s)',
$this->calledMethod->className(),
$this->calledMethod->methodName(),
);
}
}
src/Event/Events/Test/HookMethod/AfterTestMethodCalledSubscriber.php 0000644 00000001055 15243426620 0021551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterTestMethodCalledSubscriber extends Subscriber
{
public function notify(AfterTestMethodCalled $event): void;
}
src/Event/Events/Test/HookMethod/BeforeFirstTestMethodFinishedSubscriber.php 0000644 00000001075 15243426620 0023271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BeforeFirstTestMethodFinishedSubscriber extends Subscriber
{
public function notify(BeforeFirstTestMethodFinished $event): void;
}
src/Event/Events/Test/HookMethod/AfterLastTestMethodCalledSubscriber.php 0000644 00000001065 15243426620 0022376 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface AfterLastTestMethodCalledSubscriber extends Subscriber
{
public function notify(AfterLastTestMethodCalled $event): void;
}
src/Event/Events/Test/PrintedUnexpectedOutputSubscriber.php 0000644 00000001061 15243426620 0020211 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PrintedUnexpectedOutputSubscriber extends Subscriber
{
public function notify(PrintedUnexpectedOutput $event): void;
}
src/Event/Events/Test/Outcome/ErroredSubscriber.php 0000644 00000001021 15243426620 0016347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ErroredSubscriber extends Subscriber
{
public function notify(Errored $event): void;
}
src/Event/Events/Test/Outcome/SkippedSubscriber.php 0000644 00000001021 15243426620 0016344 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedSubscriber extends Subscriber
{
public function notify(Skipped $event): void;
}
src/Event/Events/Test/Outcome/Errored.php 0000644 00000003074 15243426620 0014335 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Errored implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Errored (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Outcome/MarkedIncompleteSubscriber.php 0000644 00000001043 15243426620 0020174 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MarkedIncompleteSubscriber extends Subscriber
{
public function notify(MarkedIncomplete $event): void;
}
src/Event/Events/Test/Outcome/PassedSubscriber.php 0000644 00000001017 15243426620 0016171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PassedSubscriber extends Subscriber
{
public function notify(Passed $event): void;
}
src/Event/Events/Test/Outcome/Failed.php 0000644 00000004343 15243426620 0014117 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\ComparisonFailure;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Failed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
private readonly ?ComparisonFailure $comparisonFailure;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable, ?ComparisonFailure $comparisonFailure)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
$this->comparisonFailure = $comparisonFailure;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
/**
* @psalm-assert-if-true !null $this->comparisonFailure
*/
public function hasComparisonFailure(): bool
{
return $this->comparisonFailure !== null;
}
/**
* @throws NoComparisonFailureException
*/
public function comparisonFailure(): ComparisonFailure
{
if ($this->comparisonFailure === null) {
throw new NoComparisonFailureException;
}
return $this->comparisonFailure;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Failed (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Outcome/MarkedIncomplete.php 0000644 00000003117 15243426620 0016154 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MarkedIncomplete implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly Throwable $throwable;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, Throwable $throwable)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->throwable = $throwable;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function throwable(): Throwable
{
return $this->throwable;
}
public function asString(): string
{
$message = trim($this->throwable->message());
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Marked Incomplete (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Outcome/Skipped.php 0000644 00000002741 15243426620 0014332 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Skipped (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Outcome/Passed.php 0000644 00000002210 15243426620 0014141 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Passed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Passed (%s)',
$this->test->id(),
);
}
}
src/Event/Events/Test/Outcome/FailedSubscriber.php 0000644 00000001017 15243426620 0016136 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FailedSubscriber extends Subscriber
{
public function notify(Failed $event): void;
}
src/Event/Events/Test/Lifecycle/Finished.php 0000644 00000002703 15243426620 0014746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
private readonly int $numberOfAssertionsPerformed;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, int $numberOfAssertionsPerformed)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->numberOfAssertionsPerformed = $numberOfAssertionsPerformed;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function numberOfAssertionsPerformed(): int
{
return $this->numberOfAssertionsPerformed;
}
public function asString(): string
{
return sprintf(
'Test Finished (%s)',
$this->test->id(),
);
}
}
src/Event/Events/Test/Lifecycle/FinishedSubscriber.php 0000644 00000001023 15243426620 0016764 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
src/Event/Events/Test/Lifecycle/DataProviderMethodFinished.php 0000644 00000003640 15243426620 0020415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderMethodFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly ClassMethod $testMethod;
/**
* @psalm-var list<ClassMethod>
*/
private readonly array $calledMethods;
public function __construct(Telemetry\Info $telemetryInfo, ClassMethod $testMethod, ClassMethod ...$calledMethods)
{
$this->telemetryInfo = $telemetryInfo;
$this->testMethod = $testMethod;
$this->calledMethods = $calledMethods;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testMethod(): ClassMethod
{
return $this->testMethod;
}
/**
* @psalm-return list<Code\ClassMethod>
*/
public function calledMethods(): array
{
return $this->calledMethods;
}
public function asString(): string
{
$buffer = sprintf(
'Data Provider Method Finished for %s::%s:',
$this->testMethod->className(),
$this->testMethod->methodName(),
);
foreach ($this->calledMethods as $calledMethod) {
$buffer .= sprintf(
PHP_EOL . '- %s::%s',
$calledMethod->className(),
$calledMethod->methodName(),
);
}
return $buffer;
}
}
src/Event/Events/Test/Lifecycle/DataProviderMethodFinishedSubscriber.php 0000644 00000001067 15243426620 0022442 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DataProviderMethodFinishedSubscriber extends Subscriber
{
public function notify(DataProviderMethodFinished $event): void;
}
src/Event/Events/Test/Lifecycle/DataProviderMethodCalledSubscriber.php 0000644 00000001063 15243426620 0022071 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DataProviderMethodCalledSubscriber extends Subscriber
{
public function notify(DataProviderMethodCalled $event): void;
}
src/Event/Events/Test/Lifecycle/Prepared.php 0000644 00000002214 15243426620 0014754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Prepared implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Prepared (%s)',
$this->test->id(),
);
}
}
src/Event/Events/Test/Lifecycle/PreparationStarted.php 0000644 00000002241 15243426620 0017025 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreparationStarted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Preparation Started (%s)',
$this->test->id(),
);
}
}
src/Event/Events/Test/Lifecycle/PreparedSubscriber.php 0000644 00000001023 15243426620 0016775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparedSubscriber extends Subscriber
{
public function notify(Prepared $event): void;
}
src/Event/Events/Test/Lifecycle/DataProviderMethodCalled.php 0000644 00000003206 15243426620 0020046 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code\ClassMethod;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry\Info;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderMethodCalled implements Event
{
private readonly Info $telemetryInfo;
private readonly ClassMethod $testMethod;
private readonly ClassMethod $dataProviderMethod;
public function __construct(Info $telemetryInfo, ClassMethod $testMethod, ClassMethod $dataProviderMethod)
{
$this->telemetryInfo = $telemetryInfo;
$this->testMethod = $testMethod;
$this->dataProviderMethod = $dataProviderMethod;
}
public function telemetryInfo(): Info
{
return $this->telemetryInfo;
}
public function testMethod(): ClassMethod
{
return $this->testMethod;
}
public function dataProviderMethod(): ClassMethod
{
return $this->dataProviderMethod;
}
public function asString(): string
{
return sprintf(
'Data Provider Method Called (%s::%s for test method %s::%s)',
$this->dataProviderMethod->className(),
$this->dataProviderMethod->methodName(),
$this->testMethod->className(),
$this->testMethod->methodName(),
);
}
}
src/Event/Events/Test/Lifecycle/PreparationFailedSubscriber.php 0000644 00000001045 15243426620 0020630 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparationFailedSubscriber extends Subscriber
{
public function notify(PreparationFailed $event): void;
}
src/Event/Events/Test/Lifecycle/PreparationFailed.php 0000644 00000002237 15243426620 0016610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreparationFailed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
public function asString(): string
{
return sprintf(
'Test Preparation Failed (%s)',
$this->test->id(),
);
}
}
src/Event/Events/Test/Lifecycle/PreparationStartedSubscriber.php 0000644 00000001047 15243426620 0021054 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PreparationStartedSubscriber extends Subscriber
{
public function notify(PreparationStarted $event): void;
}
src/Event/Events/Test/TestDouble/TestProxyCreated.php 0000644 00000003066 15243426620 0016644 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestProxyCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $constructorArguments;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, string $constructorArguments)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->constructorArguments = $constructorArguments;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function constructorArguments(): string
{
return $this->constructorArguments;
}
public function asString(): string
{
return sprintf(
'Test Proxy Created (%s)',
$this->className,
);
}
}
src/Event/Events/Test/TestDouble/TestProxyCreatedSubscriber.php 0000644 00000001043 15243426620 0020661 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestProxyCreatedSubscriber extends Subscriber
{
public function notify(TestProxyCreated $event): void;
}
src/Event/Events/Test/TestDouble/MockObjectFromWsdlCreatedSubscriber.php 0000644 00000001065 15243426620 0022402 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectFromWsdlCreatedSubscriber extends Subscriber
{
public function notify(MockObjectFromWsdlCreated $event): void;
}
src/Event/Events/Test/TestDouble/PartialMockObjectCreated.php 0000644 00000003150 15243426620 0020212 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PartialMockObjectCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var list<string>
*/
private readonly array $methodNames;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, string ...$methodNames)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->methodNames = $methodNames;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return list<string>
*/
public function methodNames(): array
{
return $this->methodNames;
}
public function asString(): string
{
return sprintf(
'Partial Mock Object Created (%s)',
$this->className,
);
}
}
src/Event/Events/Test/TestDouble/PartialMockObjectCreatedSubscriber.php 0000644 00000001063 15243426620 0022237 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PartialMockObjectCreatedSubscriber extends Subscriber
{
public function notify(PartialMockObjectCreated $event): void;
}
src/Event/Events/Test/TestDouble/MockObjectForIntersectionOfInterfacesCreatedSubscriber.php 0000644 00000001133 15243426620 0026247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForIntersectionOfInterfacesCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForIntersectionOfInterfacesCreated $event): void;
}
src/Event/Events/Test/TestDouble/TestStubCreated.php 0000644 00000002440 15243426620 0016433 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestStubCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Test Stub Created (%s)',
$this->className,
);
}
}
src/Event/Events/Test/TestDouble/TestStubForIntersectionOfInterfacesCreated.php 0000644 00000002573 15243426620 0023771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function implode;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestStubForIntersectionOfInterfacesCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var list<class-string>
*/
private readonly array $interfaces;
/**
* @psalm-param list<class-string> $interfaces
*/
public function __construct(Telemetry\Info $telemetryInfo, array $interfaces)
{
$this->telemetryInfo = $telemetryInfo;
$this->interfaces = $interfaces;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return list<class-string>
*/
public function interfaces(): array
{
return $this->interfaces;
}
public function asString(): string
{
return sprintf(
'Test Stub Created (%s)',
implode('&', $this->interfaces),
);
}
}
src/Event/Events/Test/TestDouble/MockObjectForAbstractClassCreatedSubscriber.php 0000644 00000001105 15243426620 0024040 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForAbstractClassCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForAbstractClassCreated $event): void;
}
src/Event/Events/Test/TestDouble/MockObjectFromWsdlCreated.php 0000644 00000005202 15243426620 0020353 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectFromWsdlCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $wsdlFile;
/**
* @psalm-var class-string
*/
private readonly string $originalClassName;
/**
* @psalm-var class-string
*/
private readonly string $mockClassName;
/**
* @psalm-var list<string>
*/
private readonly array $methods;
private readonly bool $callOriginalConstructor;
private readonly array $options;
/**
* @psalm-param class-string $originalClassName
* @psalm-param class-string $mockClassName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $wsdlFile, string $originalClassName, string $mockClassName, array $methods, bool $callOriginalConstructor, array $options)
{
$this->telemetryInfo = $telemetryInfo;
$this->wsdlFile = $wsdlFile;
$this->originalClassName = $originalClassName;
$this->mockClassName = $mockClassName;
$this->methods = $methods;
$this->callOriginalConstructor = $callOriginalConstructor;
$this->options = $options;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function wsdlFile(): string
{
return $this->wsdlFile;
}
/**
* @psalm-return class-string
*/
public function originalClassName(): string
{
return $this->originalClassName;
}
/**
* @psalm-return class-string
*/
public function mockClassName(): string
{
return $this->mockClassName;
}
/**
* @psalm-return list<string>
*/
public function methods(): array
{
return $this->methods;
}
public function callOriginalConstructor(): bool
{
return $this->callOriginalConstructor;
}
public function options(): array
{
return $this->options;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->wsdlFile,
);
}
}
src/Event/Events/Test/TestDouble/MockObjectForTraitCreatedSubscriber.php 0000644 00000001065 15243426620 0022377 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectForTraitCreatedSubscriber extends Subscriber
{
public function notify(MockObjectForTraitCreated $event): void;
}
src/Event/Events/Test/TestDouble/TestStubCreatedSubscriber.php 0000644 00000001041 15243426620 0020453 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestStubCreatedSubscriber extends Subscriber
{
public function notify(TestStubCreated $event): void;
}
src/Event/Events/Test/TestDouble/MockObjectCreated.php 0000644 00000002460 15243426620 0016700 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->className,
);
}
}
src/Event/Events/Test/TestDouble/MockObjectCreatedSubscriber.php 0000644 00000001045 15243426620 0020722 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectCreatedSubscriber extends Subscriber
{
public function notify(MockObjectCreated $event): void;
}
src/Event/Events/Test/TestDouble/MockObjectForIntersectionOfInterfacesCreated.php 0000644 00000002577 15243426620 0024240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function implode;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForIntersectionOfInterfacesCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var list<class-string>
*/
private readonly array $interfaces;
/**
* @psalm-param list<class-string> $interfaces
*/
public function __construct(Telemetry\Info $telemetryInfo, array $interfaces)
{
$this->telemetryInfo = $telemetryInfo;
$this->interfaces = $interfaces;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @return list<class-string>
*/
public function interfaces(): array
{
return $this->interfaces;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
implode('&', $this->interfaces),
);
}
}
src/Event/Events/Test/TestDouble/MockObjectForTraitCreated.php 0000644 00000002470 15243426620 0020354 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForTraitCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var trait-string
*/
private readonly string $traitName;
/**
* @psalm-param trait-string $traitName
*/
public function __construct(Telemetry\Info $telemetryInfo, string $traitName)
{
$this->telemetryInfo = $telemetryInfo;
$this->traitName = $traitName;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return trait-string
*/
public function traitName(): string
{
return $this->traitName;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->traitName,
);
}
}
src/Event/Events/Test/TestDouble/MockObjectForAbstractClassCreated.php 0000644 00000002500 15243426620 0022014 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockObjectForAbstractClassCreated implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Mock Object Created (%s)',
$this->className,
);
}
}
src/Event/Events/Test/TestDouble/TestStubForIntersectionOfInterfacesCreatedSubscriber.php 0000644 00000001127 15243426620 0026007 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface TestStubForIntersectionOfInterfacesCreatedSubscriber extends Subscriber
{
public function notify(TestStubForIntersectionOfInterfacesCreated $event): void;
}
src/Event/Events/Test/ComparatorRegisteredSubscriber.php 0000644 00000001053 15243426620 0017464 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ComparatorRegisteredSubscriber extends Subscriber
{
public function notify(ComparatorRegistered $event): void;
}
src/Event/Events/Test/Issue/PhpunitErrorTriggered.php 0000644 00000003266 15243426620 0016711 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use function trim;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitErrorTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = trim($this->message);
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Error (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/NoticeTriggered.php 0000644 00000005573 15243426620 0015474 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NoticeTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sNotice (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/DeprecationTriggered.php 0000644 00000006244 15243426620 0016504 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
private readonly bool $ignoredByTest;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
$this->ignoredByTest = $ignoredByTest;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function ignoredByTest(): bool
{
return $this->ignoredByTest;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByTest) {
$status = 'Test-Ignored ';
} elseif ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sDeprecation (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpWarningTriggered.php 0000644 00000005604 15243426620 0016323 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpWarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Warning (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpunitErrorTriggeredSubscriber.php 0000644 00000001055 15243426620 0020727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitErrorTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitErrorTriggered $event): void;
}
src/Event/Events/Test/Issue/WarningTriggeredSubscriber.php 0000644 00000001043 15243426620 0017670 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface WarningTriggeredSubscriber extends Subscriber
{
public function notify(WarningTriggered $event): void;
}
src/Event/Events/Test/Issue/PhpunitDeprecationTriggeredSubscriber.php 0000644 00000001071 15243426620 0022071 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitDeprecationTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitDeprecationTriggered $event): void;
}
src/Event/Events/Test/Issue/WarningTriggered.php 0000644 00000005575 15243426620 0015662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sWarning (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/ErrorTriggered.php 0000644 00000004742 15243426620 0015341 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered %sError (%s)%s',
$this->wasSuppressed() ? 'Suppressed ' : '',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpunitWarningTriggeredSubscriber.php 0000644 00000001061 15243426620 0021240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpunitWarningTriggeredSubscriber extends Subscriber
{
public function notify(PhpunitWarningTriggered $event): void;
}
src/Event/Events/Test/Issue/ConsideredRisky.php 0000644 00000003075 15243426620 0015512 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ConsideredRisky implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Code\Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Code\Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Code\Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Considered Risky (%s)%s%s',
$this->test->id(),
PHP_EOL,
$this->message,
);
}
}
src/Event/Events/Test/Issue/ConsideredRiskySubscriber.php 0000644 00000001041 15243426620 0017525 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ConsideredRiskySubscriber extends Subscriber
{
public function notify(ConsideredRisky $event): void;
}
src/Event/Events/Test/Issue/PhpDeprecationTriggered.php 0000644 00000006253 15243426620 0017154 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpDeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
private readonly bool $ignoredByTest;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline, bool $ignoredByTest)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
$this->ignoredByTest = $ignoredByTest;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function ignoredByTest(): bool
{
return $this->ignoredByTest;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByTest) {
$status = 'Test-Ignored ';
} elseif ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Deprecation (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpNoticeTriggeredSubscriber.php 0000644 00000001047 15243426620 0020160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpNoticeTriggeredSubscriber extends Subscriber
{
public function notify(PhpNoticeTriggered $event): void;
}
src/Event/Events/Test/Issue/PhpWarningTriggeredSubscriber.php 0000644 00000001051 15243426620 0020337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpWarningTriggeredSubscriber extends Subscriber
{
public function notify(PhpWarningTriggered $event): void;
}
src/Event/Events/Test/Issue/PhpunitWarningTriggered.php 0000644 00000003241 15243426620 0017216 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitWarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Warning (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpunitDeprecationTriggered.php 0000644 00000003251 15243426620 0020047 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpunitDeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-param non-empty-string $message
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
return sprintf(
'Test Triggered PHPUnit Deprecation (%s)%s',
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/PhpDeprecationTriggeredSubscriber.php 0000644 00000001061 15243426620 0021170 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface PhpDeprecationTriggeredSubscriber extends Subscriber
{
public function notify(PhpDeprecationTriggered $event): void;
}
src/Event/Events/Test/Issue/NoticeTriggeredSubscriber.php 0000644 00000001041 15243426620 0017502 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface NoticeTriggeredSubscriber extends Subscriber
{
public function notify(NoticeTriggered $event): void;
}
src/Event/Events/Test/Issue/PhpNoticeTriggered.php 0000644 00000005602 15243426620 0016135 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use const PHP_EOL;
use function sprintf;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PhpNoticeTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Test $test;
/**
* @psalm-var non-empty-string
*/
private readonly string $message;
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
private readonly bool $suppressed;
private readonly bool $ignoredByBaseline;
/**
* @psalm-param non-empty-string $message
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*/
public function __construct(Telemetry\Info $telemetryInfo, Test $test, string $message, string $file, int $line, bool $suppressed, bool $ignoredByBaseline)
{
$this->telemetryInfo = $telemetryInfo;
$this->test = $test;
$this->message = $message;
$this->file = $file;
$this->line = $line;
$this->suppressed = $suppressed;
$this->ignoredByBaseline = $ignoredByBaseline;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function test(): Test
{
return $this->test;
}
/**
* @psalm-return non-empty-string
*/
public function message(): string
{
return $this->message;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
public function wasSuppressed(): bool
{
return $this->suppressed;
}
public function ignoredByBaseline(): bool
{
return $this->ignoredByBaseline;
}
public function asString(): string
{
$message = $this->message;
if (!empty($message)) {
$message = PHP_EOL . $message;
}
$status = '';
if ($this->ignoredByBaseline) {
$status = 'Baseline-Ignored ';
} elseif ($this->suppressed) {
$status = 'Suppressed ';
}
return sprintf(
'Test Triggered %sPHP Notice (%s)%s',
$status,
$this->test->id(),
$message,
);
}
}
src/Event/Events/Test/Issue/ErrorTriggeredSubscriber.php 0000644 00000001037 15243426620 0017357 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ErrorTriggeredSubscriber extends Subscriber
{
public function notify(ErrorTriggered $event): void;
}
src/Event/Events/Test/Issue/DeprecationTriggeredSubscriber.php 0000644 00000001053 15243426620 0020521 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DeprecationTriggeredSubscriber extends Subscriber
{
public function notify(DeprecationTriggered $event): void;
}
src/Event/Events/Test/ComparatorRegistered.php 0000644 00000002465 15243426620 0015450 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparatorRegistered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function asString(): string
{
return sprintf(
'Comparator Registered (%s)',
$this->className,
);
}
}
src/Event/Events/Test/Assertion/AssertionFailed.php 0000644 00000003461 15243426620 0016343 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class AssertionFailed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $value;
private readonly string $constraint;
private readonly int $count;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $value, string $constraint, int $count, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->value = $value;
$this->constraint = $constraint;
$this->count = $count;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function value(): string
{
return $this->value;
}
public function count(): int
{
return $this->count;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = '';
if (!empty($this->message)) {
$message = sprintf(
', Message: %s',
$this->message,
);
}
return sprintf(
'Assertion Failed (Constraint: %s, Value: %s%s)',
$this->constraint,
$this->value,
$message,
);
}
}
src/Event/Events/Test/Assertion/AssertionSucceededSubscriber.php 0000644 00000001071 15243426620 0021062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
interface AssertionSucceededSubscriber extends Subscriber
{
public function notify(AssertionSucceeded $event): void;
}
src/Event/Events/Test/Assertion/AssertionSucceeded.php 0000644 00000003467 15243426620 0017051 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final class AssertionSucceeded implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $value;
private readonly string $constraint;
private readonly int $count;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $value, string $constraint, int $count, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->value = $value;
$this->constraint = $constraint;
$this->count = $count;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function value(): string
{
return $this->value;
}
public function count(): int
{
return $this->count;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
$message = '';
if (!empty($this->message)) {
$message = sprintf(
', Message: %s',
$this->message,
);
}
return sprintf(
'Assertion Succeeded (Constraint: %s, Value: %s%s)',
$this->constraint,
$this->value,
$message,
);
}
}
src/Event/Events/Test/Assertion/AssertionFailedSubscriber.php 0000644 00000001063 15243426620 0020363 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Test;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
interface AssertionFailedSubscriber extends Subscriber
{
public function notify(AssertionFailed $event): void;
}
src/Event/Events/TestRunner/GarbageCollectionDisabled.php 0000644 00000001637 15243426620 0017511 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionDisabled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Disabled Garbage Collection';
}
}
src/Event/Events/TestRunner/DeprecationTriggered.php 0000644 00000002235 15243426620 0016602 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DeprecationTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Runner Triggered Deprecation (%s)',
$this->message,
);
}
}
src/Event/Events/TestRunner/ExtensionLoadedFromPharSubscriber.php 0000644 00000001067 15243426620 0021262 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExtensionLoadedFromPharSubscriber extends Subscriber
{
public function notify(ExtensionLoadedFromPhar $event): void;
}
src/Event/Events/TestRunner/GarbageCollectionDisabledSubscriber.php 0000644 00000001073 15243426620 0021527 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionDisabledSubscriber extends Subscriber
{
public function notify(GarbageCollectionDisabled $event): void;
}
src/Event/Events/TestRunner/ExecutionStartedSubscriber.php 0000644 00000001051 15243426620 0020021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionStartedSubscriber extends Subscriber
{
public function notify(ExecutionStarted $event): void;
}
src/Event/Events/TestRunner/WarningTriggeredSubscriber.php 0000644 00000001051 15243426620 0017771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface WarningTriggeredSubscriber extends Subscriber
{
public function notify(WarningTriggered $event): void;
}
src/Event/Events/TestRunner/Finished.php 0000644 00000001573 15243426620 0014245 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Finished';
}
}
src/Event/Events/TestRunner/WarningTriggered.php 0000644 00000002225 15243426620 0015751 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WarningTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $message;
public function __construct(Telemetry\Info $telemetryInfo, string $message)
{
$this->telemetryInfo = $telemetryInfo;
$this->message = $message;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function message(): string
{
return $this->message;
}
public function asString(): string
{
return sprintf(
'Test Runner Triggered Warning (%s)',
$this->message,
);
}
}
src/Event/Events/TestRunner/FinishedSubscriber.php 0000644 00000001031 15243426620 0016256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
src/Event/Events/TestRunner/ExecutionAborted.php 0000644 00000001614 15243426620 0015754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionAborted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Execution Aborted';
}
}
src/Event/Events/TestRunner/ConfiguredSubscriber.php 0000644 00000001035 15243426620 0016616 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ConfiguredSubscriber extends Subscriber
{
public function notify(Configured $event): void;
}
src/Event/Events/TestRunner/GarbageCollectionEnabled.php 0000644 00000001635 15243426620 0017332 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionEnabled implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Enabled Garbage Collection';
}
}
src/Event/Events/TestRunner/GarbageCollectionEnabledSubscriber.php 0000644 00000001071 15243426620 0021350 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionEnabledSubscriber extends Subscriber
{
public function notify(GarbageCollectionEnabled $event): void;
}
src/Event/Events/TestRunner/ExtensionLoadedFromPhar.php 0000644 00000003017 15243426620 0017233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionLoadedFromPhar implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $filename;
private readonly string $name;
private readonly string $version;
public function __construct(Telemetry\Info $telemetryInfo, string $filename, string $name, string $version)
{
$this->telemetryInfo = $telemetryInfo;
$this->filename = $filename;
$this->name = $name;
$this->version = $version;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function filename(): string
{
return $this->filename;
}
public function name(): string
{
return $this->name;
}
public function version(): string
{
return $this->version;
}
public function asString(): string
{
return sprintf(
'Extension Loaded from PHAR (%s %s)',
$this->name,
$this->version,
);
}
}
src/Event/Events/TestRunner/ExecutionAbortedSubscriber.php 0000644 00000001051 15243426620 0017773 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionAbortedSubscriber extends Subscriber
{
public function notify(ExecutionAborted $event): void;
}
src/Event/Events/TestRunner/ExtensionBootstrapped.php 0000644 00000003245 15243426620 0017055 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionBootstrapped implements Event
{
private readonly Telemetry\Info $telemetryInfo;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var array<string, string>
*/
private readonly array $parameters;
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function __construct(Telemetry\Info $telemetryInfo, string $className, array $parameters)
{
$this->telemetryInfo = $telemetryInfo;
$this->className = $className;
$this->parameters = $parameters;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return array<string, string>
*/
public function parameters(): array
{
return $this->parameters;
}
public function asString(): string
{
return sprintf(
'Extension Bootstrapped (%s)',
$this->className,
);
}
}
src/Event/Events/TestRunner/ExtensionBootstrappedSubscriber.php 0000644 00000001063 15243426620 0021075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExtensionBootstrappedSubscriber extends Subscriber
{
public function notify(ExtensionBootstrapped $event): void;
}
src/Event/Events/TestRunner/Configured.php 0000644 00000002175 15243426620 0014600 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Configured implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Configuration $configuration;
public function __construct(Telemetry\Info $telemetryInfo, Configuration $configuration)
{
$this->telemetryInfo = $telemetryInfo;
$this->configuration = $configuration;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function configuration(): Configuration
{
return $this->configuration;
}
public function asString(): string
{
return 'Test Runner Configured';
}
}
src/Event/Events/TestRunner/StartedSubscriber.php 0000644 00000001027 15243426620 0016140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
src/Event/Events/TestRunner/ExecutionFinishedSubscriber.php 0000644 00000001053 15243426620 0020146 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ExecutionFinishedSubscriber extends Subscriber
{
public function notify(ExecutionFinished $event): void;
}
src/Event/Events/TestRunner/GarbageCollectionTriggered.php 0000644 00000001641 15243426620 0017711 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionTriggered implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Triggered Garbage Collection';
}
}
src/Event/Events/TestRunner/GarbageCollectionTriggeredSubscriber.php 0000644 00000001075 15243426620 0021736 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectionTriggeredSubscriber extends Subscriber
{
public function notify(GarbageCollectionTriggered $event): void;
}
src/Event/Events/TestRunner/EventFacadeSealed.php 0000644 00000001603 15243426620 0015771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventFacadeSealed implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Event Facade Sealed';
}
}
src/Event/Events/TestRunner/ExecutionFinished.php 0000644 00000001616 15243426620 0016127 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Execution Finished';
}
}
src/Event/Events/TestRunner/Started.php 0000644 00000001571 15243426620 0014120 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
public function __construct(Telemetry\Info $telemetryInfo)
{
$this->telemetryInfo = $telemetryInfo;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function asString(): string
{
return 'Test Runner Started';
}
}
src/Event/Events/TestRunner/BootstrapFinished.php 0000644 00000002221 15243426620 0016132 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BootstrapFinished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly string $filename;
public function __construct(Telemetry\Info $telemetryInfo, string $filename)
{
$this->telemetryInfo = $telemetryInfo;
$this->filename = $filename;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function filename(): string
{
return $this->filename;
}
public function asString(): string
{
return sprintf(
'Bootstrap Finished (%s)',
$this->filename,
);
}
}
src/Event/Events/TestRunner/EventFacadeSealedSubscriber.php 0000644 00000001053 15243426620 0020014 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface EventFacadeSealedSubscriber extends Subscriber
{
public function notify(EventFacadeSealed $event): void;
}
src/Event/Events/TestRunner/ExecutionStarted.php 0000644 00000002431 15243426620 0016000 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
use PHPUnit\Event\TestSuite\TestSuite;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStarted implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly TestSuite $testSuite;
public function __construct(Telemetry\Info $telemetryInfo, TestSuite $testSuite)
{
$this->telemetryInfo = $telemetryInfo;
$this->testSuite = $testSuite;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function testSuite(): TestSuite
{
return $this->testSuite;
}
public function asString(): string
{
return sprintf(
'Test Runner Execution Started (%d test%s)',
$this->testSuite->count(),
$this->testSuite->count() !== 1 ? 's' : '',
);
}
}
src/Event/Events/TestRunner/BootstrapFinishedSubscriber.php 0000644 00000001053 15243426620 0020160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface BootstrapFinishedSubscriber extends Subscriber
{
public function notify(BootstrapFinished $event): void;
}
src/Event/Events/TestRunner/DeprecationTriggeredSubscriber.php 0000644 00000001061 15243426620 0020622 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestRunner;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface DeprecationTriggeredSubscriber extends Subscriber
{
public function notify(DeprecationTriggered $event): void;
}
src/Event/Events/EventCollection.php 0000644 00000002441 15243426620 0013473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Event>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class EventCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Event>
*/
private array $events = [];
public function add(Event ...$events): void
{
foreach ($events as $event) {
$this->events[] = $event;
}
}
/**
* @psalm-return list<Event>
*/
public function asArray(): array
{
return $this->events;
}
public function count(): int
{
return count($this->events);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
public function isNotEmpty(): bool
{
return $this->count() > 0;
}
public function getIterator(): EventCollectionIterator
{
return new EventCollectionIterator($this);
}
}
src/Event/Events/Application/Finished.php 0000644 00000002255 15243426620 0014375 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Finished implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly int $shellExitCode;
public function __construct(Telemetry\Info $telemetryInfo, int $shellExitCode)
{
$this->telemetryInfo = $telemetryInfo;
$this->shellExitCode = $shellExitCode;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function shellExitCode(): int
{
return $this->shellExitCode;
}
public function asString(): string
{
return sprintf(
'PHPUnit Finished (Shell Exit Code: %d)',
$this->shellExitCode,
);
}
}
src/Event/Events/Application/FinishedSubscriber.php 0000644 00000001032 15243426620 0016411 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface FinishedSubscriber extends Subscriber
{
public function notify(Finished $event): void;
}
src/Event/Events/Application/StartedSubscriber.php 0000644 00000001030 15243426620 0016264 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use PHPUnit\Event\Subscriber;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface StartedSubscriber extends Subscriber
{
public function notify(Started $event): void;
}
src/Event/Events/Application/Started.php 0000644 00000002261 15243426620 0014247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Application;
use function sprintf;
use PHPUnit\Event\Event;
use PHPUnit\Event\Runtime\Runtime;
use PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Started implements Event
{
private readonly Telemetry\Info $telemetryInfo;
private readonly Runtime $runtime;
public function __construct(Telemetry\Info $telemetryInfo, Runtime $runtime)
{
$this->telemetryInfo = $telemetryInfo;
$this->runtime = $runtime;
}
public function telemetryInfo(): Telemetry\Info
{
return $this->telemetryInfo;
}
public function runtime(): Runtime
{
return $this->runtime;
}
public function asString(): string
{
return sprintf(
'PHPUnit Started (%s)',
$this->runtime->asString(),
);
}
}
src/Event/Value/Runtime/PHP.php 0000644 00000004537 15243426620 0012270 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use const PHP_EXTRA_VERSION;
use const PHP_MAJOR_VERSION;
use const PHP_MINOR_VERSION;
use const PHP_RELEASE_VERSION;
use const PHP_SAPI;
use const PHP_VERSION;
use const PHP_VERSION_ID;
use function array_merge;
use function get_loaded_extensions;
use function sort;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PHP
{
private readonly string $version;
private readonly int $versionId;
private readonly int $majorVersion;
private readonly int $minorVersion;
private readonly int $releaseVersion;
private readonly string $extraVersion;
private readonly string $sapi;
/**
* @psalm-var list<string>
*/
private readonly array $extensions;
public function __construct()
{
$this->version = PHP_VERSION;
$this->versionId = PHP_VERSION_ID;
$this->majorVersion = PHP_MAJOR_VERSION;
$this->minorVersion = PHP_MINOR_VERSION;
$this->releaseVersion = PHP_RELEASE_VERSION;
$this->extraVersion = PHP_EXTRA_VERSION;
$this->sapi = PHP_SAPI;
$extensions = array_merge(
get_loaded_extensions(true),
get_loaded_extensions(),
);
sort($extensions);
$this->extensions = $extensions;
}
public function version(): string
{
return $this->version;
}
public function sapi(): string
{
return $this->sapi;
}
public function majorVersion(): int
{
return $this->majorVersion;
}
public function minorVersion(): int
{
return $this->minorVersion;
}
public function releaseVersion(): int
{
return $this->releaseVersion;
}
public function extraVersion(): string
{
return $this->extraVersion;
}
public function versionId(): int
{
return $this->versionId;
}
/**
* @psalm-return list<string>
*/
public function extensions(): array
{
return $this->extensions;
}
}
src/Event/Value/Runtime/OperatingSystem.php 0000644 00000001671 15243426620 0014772 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use const PHP_OS;
use const PHP_OS_FAMILY;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class OperatingSystem
{
private readonly string $operatingSystem;
private readonly string $operatingSystemFamily;
public function __construct()
{
$this->operatingSystem = PHP_OS;
$this->operatingSystemFamily = PHP_OS_FAMILY;
}
public function operatingSystem(): string
{
return $this->operatingSystem;
}
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
src/Event/Value/Runtime/Runtime.php 0000644 00000002527 15243426620 0013261 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use function sprintf;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Runtime
{
private readonly OperatingSystem $operatingSystem;
private readonly PHP $php;
private readonly PHPUnit $phpunit;
public function __construct()
{
$this->operatingSystem = new OperatingSystem;
$this->php = new PHP;
$this->phpunit = new PHPUnit;
}
public function asString(): string
{
$php = $this->php();
return sprintf(
'PHPUnit %s using PHP %s (%s) on %s',
$this->phpunit()->versionId(),
$php->version(),
$php->sapi(),
$this->operatingSystem()->operatingSystem(),
);
}
public function operatingSystem(): OperatingSystem
{
return $this->operatingSystem;
}
public function php(): PHP
{
return $this->php;
}
public function phpunit(): PHPUnit
{
return $this->phpunit;
}
}
src/Event/Value/Runtime/PHPUnit.php 0000644 00000001563 15243426620 0013124 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Runtime;
use PHPUnit\Runner\Version;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PHPUnit
{
private readonly string $versionId;
private readonly string $releaseSeries;
public function __construct()
{
$this->versionId = Version::id();
$this->releaseSeries = Version::series();
}
public function versionId(): string
{
return $this->versionId;
}
public function releaseSeries(): string
{
return $this->releaseSeries;
}
}
src/Event/Value/ThrowableBuilder.php 0000644 00000002053 15243426620 0013443 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Framework\Exception;
use PHPUnit\Util\Filter;
use PHPUnit\Util\ThrowableToStringMapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ThrowableBuilder
{
/**
* @throws Exception
* @throws NoPreviousThrowableException
*/
public static function from(\Throwable $t): Throwable
{
$previous = $t->getPrevious();
if ($previous !== null) {
$previous = self::from($previous);
}
return new Throwable(
$t::class,
$t->getMessage(),
ThrowableToStringMapper::map($t),
Filter::getFilteredStacktrace($t, false),
$previous,
);
}
}
src/Event/Value/Telemetry/HRTime.php 0000644 00000005046 15243426620 0013314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function sprintf;
use PHPUnit\Event\InvalidArgumentException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class HRTime
{
private readonly int $seconds;
private readonly int $nanoseconds;
/**
* @throws InvalidArgumentException
*/
public static function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds): self
{
return new self(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function __construct(int $seconds, int $nanoseconds)
{
$this->ensureNotNegative($seconds, 'seconds');
$this->ensureNotNegative($nanoseconds, 'nanoseconds');
$this->ensureNanoSecondsInRange($nanoseconds);
$this->seconds = $seconds;
$this->nanoseconds = $nanoseconds;
}
public function seconds(): int
{
return $this->seconds;
}
public function nanoseconds(): int
{
return $this->nanoseconds;
}
public function duration(self $start): Duration
{
$seconds = $this->seconds - $start->seconds();
$nanoseconds = $this->nanoseconds - $start->nanoseconds();
if ($nanoseconds < 0) {
$seconds--;
$nanoseconds += 1000000000;
}
if ($seconds < 0) {
return Duration::fromSecondsAndNanoseconds(0, 0);
}
return Duration::fromSecondsAndNanoseconds(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function ensureNotNegative(int $value, string $type): void
{
if ($value < 0) {
throw new InvalidArgumentException(
sprintf(
'Value for %s must not be negative.',
$type,
),
);
}
}
/**
* @throws InvalidArgumentException
*/
private function ensureNanoSecondsInRange(int $nanoseconds): void
{
if ($nanoseconds > 999999999) {
throw new InvalidArgumentException(
'Value for nanoseconds must not be greater than 999999999.',
);
}
}
}
src/Event/Value/Telemetry/StopWatch.php 0000644 00000000705 15243426620 0014075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface StopWatch
{
public function current(): HRTime;
}
src/Event/Value/Telemetry/Php81GarbageCollectorStatusProvider.php 0000644 00000001671 15243426620 0021123 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function gc_status;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class Php81GarbageCollectorStatusProvider implements GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus
{
$status = gc_status();
return new GarbageCollectorStatus(
$status['runs'],
$status['collected'],
$status['threshold'],
$status['roots'],
null,
null,
null,
null,
null,
null,
null,
null,
);
}
}
src/Event/Value/Telemetry/MemoryUsage.php 0000644 00000001546 15243426620 0014422 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MemoryUsage
{
private readonly int $bytes;
public static function fromBytes(int $bytes): self
{
return new self($bytes);
}
private function __construct(int $bytes)
{
$this->bytes = $bytes;
}
public function bytes(): int
{
return $this->bytes;
}
public function diff(self $other): self
{
return self::fromBytes($this->bytes - $other->bytes);
}
}
src/Event/Value/Telemetry/MemoryMeter.php 0000644 00000001005 15243426620 0014420 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface MemoryMeter
{
public function memoryUsage(): MemoryUsage;
public function peakMemoryUsage(): MemoryUsage;
}
src/Event/Value/Telemetry/SystemStopWatchWithOffset.php 0000644 00000001730 15243426620 0017304 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function hrtime;
use PHPUnit\Event\InvalidArgumentException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class SystemStopWatchWithOffset implements StopWatch
{
private ?HRTime $offset;
public function __construct(HRTime $offset)
{
$this->offset = $offset;
}
/**
* @throws InvalidArgumentException
*/
public function current(): HRTime
{
if ($this->offset !== null) {
$offset = $this->offset;
$this->offset = null;
return $offset;
}
return HRTime::fromSecondsAndNanoseconds(...hrtime());
}
}
src/Event/Value/Telemetry/GarbageCollectorStatusProvider.php 0000644 00000000751 15243426620 0020300 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus;
}
src/Event/Value/Telemetry/SystemStopWatch.php 0000644 00000001242 15243426620 0015277 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function hrtime;
use PHPUnit\Event\InvalidArgumentException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SystemStopWatch implements StopWatch
{
/**
* @throws InvalidArgumentException
*/
public function current(): HRTime
{
return HRTime::fromSecondsAndNanoseconds(...hrtime());
}
}
src/Event/Value/Telemetry/Info.php 0000644 00000004501 15243426620 0013052 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function sprintf;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Info
{
private readonly Snapshot $current;
private readonly Duration $durationSinceStart;
private readonly MemoryUsage $memorySinceStart;
private readonly Duration $durationSincePrevious;
private readonly MemoryUsage $memorySincePrevious;
public function __construct(Snapshot $current, Duration $durationSinceStart, MemoryUsage $memorySinceStart, Duration $durationSincePrevious, MemoryUsage $memorySincePrevious)
{
$this->current = $current;
$this->durationSinceStart = $durationSinceStart;
$this->memorySinceStart = $memorySinceStart;
$this->durationSincePrevious = $durationSincePrevious;
$this->memorySincePrevious = $memorySincePrevious;
}
public function time(): HRTime
{
return $this->current->time();
}
public function memoryUsage(): MemoryUsage
{
return $this->current->memoryUsage();
}
public function peakMemoryUsage(): MemoryUsage
{
return $this->current->peakMemoryUsage();
}
public function durationSinceStart(): Duration
{
return $this->durationSinceStart;
}
public function memoryUsageSinceStart(): MemoryUsage
{
return $this->memorySinceStart;
}
public function durationSincePrevious(): Duration
{
return $this->durationSincePrevious;
}
public function memoryUsageSincePrevious(): MemoryUsage
{
return $this->memorySincePrevious;
}
public function garbageCollectorStatus(): GarbageCollectorStatus
{
return $this->current->garbageCollectorStatus();
}
public function asString(): string
{
return sprintf(
'[%s / %s] [%d bytes]',
$this->durationSinceStart()->asString(),
$this->durationSincePrevious()->asString(),
$this->memoryUsage()->bytes(),
);
}
}
src/Event/Value/Telemetry/Duration.php 0000644 00000006727 15243426620 0013760 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function floor;
use function sprintf;
use PHPUnit\Event\InvalidArgumentException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Duration
{
private readonly int $seconds;
private readonly int $nanoseconds;
/**
* @throws InvalidArgumentException
*/
public static function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds): self
{
return new self(
$seconds,
$nanoseconds,
);
}
/**
* @throws InvalidArgumentException
*/
private function __construct(int $seconds, int $nanoseconds)
{
$this->ensureNotNegative($seconds, 'seconds');
$this->ensureNotNegative($nanoseconds, 'nanoseconds');
$this->ensureNanoSecondsInRange($nanoseconds);
$this->seconds = $seconds;
$this->nanoseconds = $nanoseconds;
}
public function seconds(): int
{
return $this->seconds;
}
public function nanoseconds(): int
{
return $this->nanoseconds;
}
public function asFloat(): float
{
return $this->seconds() + ($this->nanoseconds() / 1000000000);
}
public function asString(): string
{
$seconds = $this->seconds();
$minutes = 0;
$hours = 0;
if ($seconds > 60 * 60) {
$hours = floor($seconds / 60 / 60);
$seconds -= ($hours * 60 * 60);
}
if ($seconds > 60) {
$minutes = floor($seconds / 60);
$seconds -= ($minutes * 60);
}
return sprintf(
'%02d:%02d:%02d.%09d',
$hours,
$minutes,
$seconds,
$this->nanoseconds(),
);
}
public function equals(self $other): bool
{
return $this->seconds === $other->seconds &&
$this->nanoseconds === $other->nanoseconds;
}
public function isLessThan(self $other): bool
{
if ($this->seconds < $other->seconds) {
return true;
}
if ($this->seconds > $other->seconds) {
return false;
}
return $this->nanoseconds < $other->nanoseconds;
}
public function isGreaterThan(self $other): bool
{
if ($this->seconds > $other->seconds) {
return true;
}
if ($this->seconds < $other->seconds) {
return false;
}
return $this->nanoseconds > $other->nanoseconds;
}
/**
* @throws InvalidArgumentException
*/
private function ensureNotNegative(int $value, string $type): void
{
if ($value < 0) {
throw new InvalidArgumentException(
sprintf(
'Value for %s must not be negative.',
$type,
),
);
}
}
/**
* @throws InvalidArgumentException
*/
private function ensureNanoSecondsInRange(int $nanoseconds): void
{
if ($nanoseconds > 999999999) {
throw new InvalidArgumentException(
'Value for nanoseconds must not be greater than 999999999.',
);
}
}
}
src/Event/Value/Telemetry/SystemMemoryMeter.php 0000644 00000001375 15243426620 0015637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function memory_get_peak_usage;
use function memory_get_usage;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SystemMemoryMeter implements MemoryMeter
{
public function memoryUsage(): MemoryUsage
{
return MemoryUsage::fromBytes(memory_get_usage(true));
}
public function peakMemoryUsage(): MemoryUsage
{
return MemoryUsage::fromBytes(memory_get_peak_usage(true));
}
}
src/Event/Value/Telemetry/Snapshot.php 0000644 00000002641 15243426620 0013761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Snapshot
{
private readonly HRTime $time;
private readonly MemoryUsage $memoryUsage;
private readonly MemoryUsage $peakMemoryUsage;
private readonly GarbageCollectorStatus $garbageCollectorStatus;
public function __construct(HRTime $time, MemoryUsage $memoryUsage, MemoryUsage $peakMemoryUsage, GarbageCollectorStatus $garbageCollectorStatus)
{
$this->time = $time;
$this->memoryUsage = $memoryUsage;
$this->peakMemoryUsage = $peakMemoryUsage;
$this->garbageCollectorStatus = $garbageCollectorStatus;
}
public function time(): HRTime
{
return $this->time;
}
public function memoryUsage(): MemoryUsage
{
return $this->memoryUsage;
}
public function peakMemoryUsage(): MemoryUsage
{
return $this->peakMemoryUsage;
}
public function garbageCollectorStatus(): GarbageCollectorStatus
{
return $this->garbageCollectorStatus;
}
}
src/Event/Value/Telemetry/System.php 0000644 00000002326 15243426620 0013446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class System
{
private readonly StopWatch $stopWatch;
private readonly MemoryMeter $memoryMeter;
private readonly GarbageCollectorStatusProvider $garbageCollectorStatusProvider;
public function __construct(StopWatch $stopWatch, MemoryMeter $memoryMeter, GarbageCollectorStatusProvider $garbageCollectorStatusProvider)
{
$this->stopWatch = $stopWatch;
$this->memoryMeter = $memoryMeter;
$this->garbageCollectorStatusProvider = $garbageCollectorStatusProvider;
}
public function snapshot(): Snapshot
{
return new Snapshot(
$this->stopWatch->current(),
$this->memoryMeter->memoryUsage(),
$this->memoryMeter->peakMemoryUsage(),
$this->garbageCollectorStatusProvider->status(),
);
}
}
src/Event/Value/Telemetry/Php83GarbageCollectorStatusProvider.php 0000644 00000002054 15243426620 0021121 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use function gc_status;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Php83GarbageCollectorStatusProvider implements GarbageCollectorStatusProvider
{
public function status(): GarbageCollectorStatus
{
$status = gc_status();
return new GarbageCollectorStatus(
$status['runs'],
$status['collected'],
$status['threshold'],
$status['roots'],
$status['application_time'],
$status['collector_time'],
$status['destructor_time'],
$status['free_time'],
$status['running'],
$status['protected'],
$status['full'],
$status['buffer_size'],
);
}
}
src/Event/Value/Telemetry/GarbageCollectorStatus.php 0000644 00000011250 15243426620 0016561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Telemetry;
use PHPUnit\Event\RuntimeException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectorStatus
{
private readonly int $runs;
private readonly int $collected;
private readonly int $threshold;
private readonly int $roots;
private readonly ?float $applicationTime;
private readonly ?float $collectorTime;
private readonly ?float $destructorTime;
private readonly ?float $freeTime;
private readonly ?bool $running;
private readonly ?bool $protected;
private readonly ?bool $full;
private readonly ?int $bufferSize;
public function __construct(int $runs, int $collected, int $threshold, int $roots, ?float $applicationTime, ?float $collectorTime, ?float $destructorTime, ?float $freeTime, ?bool $running, ?bool $protected, ?bool $full, ?int $bufferSize)
{
$this->runs = $runs;
$this->collected = $collected;
$this->threshold = $threshold;
$this->roots = $roots;
$this->applicationTime = $applicationTime;
$this->collectorTime = $collectorTime;
$this->destructorTime = $destructorTime;
$this->freeTime = $freeTime;
$this->running = $running;
$this->protected = $protected;
$this->full = $full;
$this->bufferSize = $bufferSize;
}
public function runs(): int
{
return $this->runs;
}
public function collected(): int
{
return $this->collected;
}
public function threshold(): int
{
return $this->threshold;
}
public function roots(): int
{
return $this->roots;
}
/**
* @psalm-assert-if-true !null $this->applicationTime
* @psalm-assert-if-true !null $this->collectorTime
* @psalm-assert-if-true !null $this->destructorTime
* @psalm-assert-if-true !null $this->freeTime
* @psalm-assert-if-true !null $this->running
* @psalm-assert-if-true !null $this->protected
* @psalm-assert-if-true !null $this->full
* @psalm-assert-if-true !null $this->bufferSize
*/
public function hasExtendedInformation(): bool
{
return $this->running !== null;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function applicationTime(): float
{
if ($this->applicationTime === null) {
throw new RuntimeException('Information not available');
}
return $this->applicationTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function collectorTime(): float
{
if ($this->collectorTime === null) {
throw new RuntimeException('Information not available');
}
return $this->collectorTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function destructorTime(): float
{
if ($this->destructorTime === null) {
throw new RuntimeException('Information not available');
}
return $this->destructorTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function freeTime(): float
{
if ($this->freeTime === null) {
throw new RuntimeException('Information not available');
}
return $this->freeTime;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isRunning(): bool
{
if ($this->running === null) {
throw new RuntimeException('Information not available');
}
return $this->running;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isProtected(): bool
{
if ($this->protected === null) {
throw new RuntimeException('Information not available');
}
return $this->protected;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function isFull(): bool
{
if ($this->full === null) {
throw new RuntimeException('Information not available');
}
return $this->full;
}
/**
* @throws RuntimeException on PHP < 8.3
*/
public function bufferSize(): int
{
if ($this->bufferSize === null) {
throw new RuntimeException('Information not available');
}
return $this->bufferSize;
}
}
src/Event/Value/ComparisonFailureBuilder.php 0000644 00000003360 15243426620 0015140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function is_bool;
use function is_scalar;
use function print_r;
use PHPUnit\Framework\ExpectationFailedException;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonFailureBuilder
{
public static function from(Throwable $t): ?ComparisonFailure
{
if (!$t instanceof ExpectationFailedException) {
return null;
}
if (!$t->getComparisonFailure()) {
return null;
}
$expectedAsString = $t->getComparisonFailure()->getExpectedAsString();
if (empty($expectedAsString)) {
$expectedAsString = self::mapScalarValueToString($t->getComparisonFailure()->getExpected());
}
$actualAsString = $t->getComparisonFailure()->getActualAsString();
if (empty($actualAsString)) {
$actualAsString = self::mapScalarValueToString($t->getComparisonFailure()->getActual());
}
return new ComparisonFailure(
$expectedAsString,
$actualAsString,
$t->getComparisonFailure()->getDiff(),
);
}
private static function mapScalarValueToString(mixed $value): string
{
if ($value === null) {
return 'null';
}
if (is_bool($value)) {
return $value ? 'true' : 'false';
}
if (is_scalar($value)) {
return print_r($value, true);
}
return '';
}
}
src/Event/Value/TestSuite/TestSuiteForTestClass.php 0000644 00000002635 15243426620 0016372 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteForTestClass extends TestSuite
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $file;
private readonly int $line;
/**
* @psalm-param class-string $name
*/
public function __construct(string $name, int $size, TestCollection $tests, string $file, int $line)
{
parent::__construct($name, $size, $tests);
$this->className = $name;
$this->file = $file;
$this->line = $line;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function file(): string
{
return $this->file;
}
public function line(): int
{
return $this->line;
}
/**
* @psalm-assert-if-true TestSuiteForTestClass $this
*/
public function isForTestClass(): bool
{
return true;
}
}
src/Event/Value/TestSuite/TestSuiteForTestMethodWithDataProvider.php 0000644 00000003564 15243426620 0021710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteForTestMethodWithDataProvider extends TestSuite
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly string $file;
private readonly int $line;
/**
* @psalm-param non-empty-string $name
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $name, int $size, TestCollection $tests, string $className, string $methodName, string $file, int $line)
{
parent::__construct($name, $size, $tests);
$this->className = $className;
$this->methodName = $methodName;
$this->file = $file;
$this->line = $line;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function file(): string
{
return $this->file;
}
public function line(): int
{
return $this->line;
}
/**
* @psalm-assert-if-true TestSuiteForTestMethodWithDataProvider $this
*/
public function isForTestMethodWithDataProvider(): bool
{
return true;
}
}
src/Event/Value/TestSuite/TestSuiteWithName.php 0000644 00000001152 15243426620 0015523 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteWithName extends TestSuite
{
/**
* @psalm-assert-if-true TestSuiteWithName $this
*/
public function isWithName(): bool
{
return true;
}
}
src/Event/Value/TestSuite/TestSuiteBuilder.php 0000644 00000006376 15243426620 0015412 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use function explode;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestCollection;
use PHPUnit\Event\RuntimeException;
use PHPUnit\Framework\DataProviderTestSuite;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite as FrameworkTestSuite;
use PHPUnit\Runner\PhptTestCase;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteBuilder
{
/**
* @throws RuntimeException
*/
public static function from(FrameworkTestSuite $testSuite): TestSuite
{
$tests = [];
self::process($testSuite, $tests);
if ($testSuite instanceof DataProviderTestSuite) {
[$className, $methodName] = explode('::', $testSuite->name());
try {
$reflector = new ReflectionMethod($className, $methodName);
return new TestSuiteForTestMethodWithDataProvider(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
$className,
$methodName,
$reflector->getFileName(),
$reflector->getStartLine(),
);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
if ($testSuite->isForTestClass()) {
try {
$reflector = new ReflectionClass($testSuite->name());
return new TestSuiteForTestClass(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
$reflector->getFileName(),
$reflector->getStartLine(),
);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
return new TestSuiteWithName(
$testSuite->name(),
$testSuite->count(),
TestCollection::fromArray($tests),
);
}
/**
* @psalm-param list<Test> $tests
*/
private static function process(FrameworkTestSuite $testSuite, array &$tests): void
{
foreach ($testSuite->getIterator() as $test) {
if ($test instanceof FrameworkTestSuite) {
self::process($test, $tests);
continue;
}
if ($test instanceof TestCase || $test instanceof PhptTestCase) {
$tests[] = $test->valueObjectForEvents();
}
}
}
}
src/Event/Value/TestSuite/TestSuite.php 0000644 00000003206 15243426620 0014070 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestSuite;
use PHPUnit\Event\Code\TestCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestSuite
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
private readonly int $count;
private readonly TestCollection $tests;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name, int $size, TestCollection $tests)
{
$this->name = $name;
$this->count = $size;
$this->tests = $tests;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
public function count(): int
{
return $this->count;
}
public function tests(): TestCollection
{
return $this->tests;
}
/**
* @psalm-assert-if-true TestSuiteWithName $this
*/
public function isWithName(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestSuiteForTestClass $this
*/
public function isForTestClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestSuiteForTestMethodWithDataProvider $this
*/
public function isForTestMethodWithDataProvider(): bool
{
return false;
}
}
src/Event/Value/Test/Test.php 0000644 00000002365 15243426620 0012051 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Test
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-param non-empty-string $file
*/
public function __construct(string $file)
{
$this->file = $file;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-assert-if-true TestMethod $this
*/
public function isTestMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true Phpt $this
*/
public function isPhpt(): bool
{
return false;
}
/**
* @psalm-return non-empty-string
*/
abstract public function id(): string;
/**
* @psalm-return non-empty-string
*/
abstract public function name(): string;
}
src/Event/Value/Test/TestCollectionIterator.php 0000644 00000002235 15243426620 0015573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Test>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestCollectionIterator implements Iterator
{
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
private int $position = 0;
public function __construct(TestCollection $tests)
{
$this->tests = $tests->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->tests);
}
public function key(): int
{
return $this->position;
}
public function current(): Test
{
return $this->tests[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/Event/Value/Test/TestCollection.php 0000644 00000002365 15243426620 0014065 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Test>
*
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
/**
* @psalm-param list<Test> $tests
*/
public static function fromArray(array $tests): self
{
return new self(...$tests);
}
private function __construct(Test ...$tests)
{
$this->tests = $tests;
}
/**
* @psalm-return list<Test>
*/
public function asArray(): array
{
return $this->tests;
}
public function count(): int
{
return count($this->tests);
}
public function getIterator(): TestCollectionIterator
{
return new TestCollectionIterator($this);
}
}
src/Event/Value/Test/TestDoxBuilder.php 0000644 00000002741 15243426620 0014031 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\TestCase;
use PHPUnit\Logging\TestDox\NamePrettifier;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestDoxBuilder
{
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromTestCase(TestCase $testCase): TestDox
{
$prettifier = new NamePrettifier;
return new TestDox(
$prettifier->prettifyTestClassName($testCase::class),
$prettifier->prettifyTestCase($testCase, false),
$prettifier->prettifyTestCase($testCase, true),
);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function fromClassNameAndMethodName(string $className, string $methodName): TestDox
{
$prettifier = new NamePrettifier;
$prettifiedMethodName = $prettifier->prettifyTestMethodName($methodName);
return new TestDox(
$prettifier->prettifyTestClassName($className),
$prettifiedMethodName,
$prettifiedMethodName,
);
}
}
src/Event/Value/Test/TestMethod.php 0000644 00000007067 15243426620 0013216 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function assert;
use function is_int;
use function sprintf;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Metadata\MetadataCollection;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestMethod extends Test
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-var non-negative-int
*/
private readonly int $line;
private readonly TestDox $testDox;
private readonly MetadataCollection $metadata;
private readonly TestDataCollection $testData;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param non-empty-string $file
* @psalm-param non-negative-int $line
*/
public function __construct(string $className, string $methodName, string $file, int $line, TestDox $testDox, MetadataCollection $metadata, TestDataCollection $testData)
{
parent::__construct($file);
$this->className = $className;
$this->methodName = $methodName;
$this->line = $line;
$this->testDox = $testDox;
$this->metadata = $metadata;
$this->testData = $testData;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
/**
* @psalm-return non-negative-int
*/
public function line(): int
{
return $this->line;
}
public function testDox(): TestDox
{
return $this->testDox;
}
public function metadata(): MetadataCollection
{
return $this->metadata;
}
public function testData(): TestDataCollection
{
return $this->testData;
}
/**
* @psalm-assert-if-true TestMethod $this
*/
public function isTestMethod(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function id(): string
{
$buffer = $this->className . '::' . $this->methodName;
if ($this->testData()->hasDataFromDataProvider()) {
$buffer .= '#' . $this->testData->dataFromDataProvider()->dataSetName();
}
return $buffer;
}
/**
* @psalm-return non-empty-string
*/
public function nameWithClass(): string
{
return $this->className . '::' . $this->name();
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
if (!$this->testData->hasDataFromDataProvider()) {
return $this->methodName;
}
$dataSetName = $this->testData->dataFromDataProvider()->dataSetName();
if (is_int($dataSetName)) {
$dataSetName = sprintf(
' with data set #%d',
$dataSetName,
);
} else {
$dataSetName = sprintf(
' with data set "%s"',
$dataSetName,
);
}
return $this->methodName . $dataSetName;
}
}
src/Event/Value/Test/TestDox.php 0000644 00000002444 15243426620 0012522 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDox
{
private readonly string $prettifiedClassName;
private readonly string $prettifiedMethodName;
private readonly string $prettifiedAndColorizedMethodName;
public function __construct(string $prettifiedClassName, string $prettifiedMethodName, string $prettifiedAndColorizedMethodName)
{
$this->prettifiedClassName = $prettifiedClassName;
$this->prettifiedMethodName = $prettifiedMethodName;
$this->prettifiedAndColorizedMethodName = $prettifiedAndColorizedMethodName;
}
public function prettifiedClassName(): string
{
return $this->prettifiedClassName;
}
public function prettifiedMethodName(bool $colorize = false): string
{
if ($colorize) {
return $this->prettifiedAndColorizedMethodName;
}
return $this->prettifiedMethodName;
}
}
src/Event/Value/Test/TestMethodBuilder.php 0000644 00000005557 15243426620 0014527 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use function assert;
use function debug_backtrace;
use function is_numeric;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\TestData\DataFromDataProvider;
use PHPUnit\Event\TestData\DataFromTestDependency;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Framework\TestCase;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Util\Exporter;
use PHPUnit\Util\Reflection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMethodBuilder
{
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromTestCase(TestCase $testCase): TestMethod
{
$methodName = $testCase->name();
assert(!empty($methodName));
$location = Reflection::sourceLocationFor($testCase::class, $methodName);
return new TestMethod(
$testCase::class,
$methodName,
$location['file'],
$location['line'],
TestDoxBuilder::fromTestCase($testCase),
MetadataRegistry::parser()->forClassAndMethod($testCase::class, $methodName),
self::dataFor($testCase),
);
}
/**
* @throws NoTestCaseObjectOnCallStackException
*/
public static function fromCallStack(): TestMethod
{
foreach (debug_backtrace() as $frame) {
if (isset($frame['object']) && $frame['object'] instanceof TestCase) {
return $frame['object']->valueObjectForEvents();
}
}
throw new NoTestCaseObjectOnCallStackException;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private static function dataFor(TestCase $testCase): TestDataCollection
{
$testData = [];
if ($testCase->usesDataProvider()) {
$dataSetName = $testCase->dataName();
if (is_numeric($dataSetName)) {
$dataSetName = (int) $dataSetName;
}
$testData[] = DataFromDataProvider::from(
$dataSetName,
Exporter::export($testCase->providedData(), EventFacade::emitter()->exportsObjects()),
$testCase->dataSetAsStringWithData(),
);
}
if ($testCase->hasDependencyInput()) {
$testData[] = DataFromTestDependency::from(
Exporter::export($testCase->dependencyInput(), EventFacade::emitter()->exportsObjects()),
);
}
return TestDataCollection::fromArray($testData);
}
}
src/Event/Value/Test/TestData/DataFromDataProvider.php 0000644 00000003027 15243426620 0016641 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataFromDataProvider extends TestData
{
private readonly int|string $dataSetName;
private readonly string $dataAsStringForResultOutput;
public static function from(int|string $dataSetName, string $data, string $dataAsStringForResultOutput): self
{
return new self($dataSetName, $data, $dataAsStringForResultOutput);
}
protected function __construct(int|string $dataSetName, string $data, string $dataAsStringForResultOutput)
{
$this->dataSetName = $dataSetName;
$this->dataAsStringForResultOutput = $dataAsStringForResultOutput;
parent::__construct($data);
}
public function dataSetName(): int|string
{
return $this->dataSetName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function dataAsStringForResultOutput(): string
{
return $this->dataAsStringForResultOutput;
}
/**
* @psalm-assert-if-true DataFromDataProvider $this
*/
public function isFromDataProvider(): bool
{
return true;
}
}
src/Event/Value/Test/TestData/TestDataCollectionIterator.php 0000644 00000002257 15243426620 0020102 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, TestData>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDataCollectionIterator implements Iterator
{
/**
* @psalm-var list<TestData>
*/
private readonly array $data;
private int $position = 0;
public function __construct(TestDataCollection $data)
{
$this->data = $data->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->data);
}
public function key(): int
{
return $this->position;
}
public function current(): TestData
{
return $this->data[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/Event/Value/Test/TestData/DataFromTestDependency.php 0000644 00000001335 15243426620 0017173 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataFromTestDependency extends TestData
{
public static function from(string $data): self
{
return new self($data);
}
/**
* @psalm-assert-if-true DataFromTestDependency $this
*/
public function isFromTestDependency(): bool
{
return true;
}
}
src/Event/Value/Test/TestData/TestData.php 0000644 00000001706 15243426620 0014352 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestData
{
private readonly string $data;
protected function __construct(string $data)
{
$this->data = $data;
}
public function data(): string
{
return $this->data;
}
/**
* @psalm-assert-if-true DataFromDataProvider $this
*/
public function isFromDataProvider(): bool
{
return false;
}
/**
* @psalm-assert-if-true DataFromTestDependency $this
*/
public function isFromTestDependency(): bool
{
return false;
}
}
src/Event/Value/Test/TestData/TestDataCollection.php 0000644 00000004771 15243426620 0016373 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\TestData;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, TestData>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDataCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestData>
*/
private readonly array $data;
private ?DataFromDataProvider $fromDataProvider = null;
/**
* @psalm-param list<TestData> $data
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
public static function fromArray(array $data): self
{
return new self(...$data);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function __construct(TestData ...$data)
{
$this->ensureNoMoreThanOneDataFromDataProvider($data);
$this->data = $data;
}
/**
* @psalm-return list<TestData>
*/
public function asArray(): array
{
return $this->data;
}
public function count(): int
{
return count($this->data);
}
/**
* @psalm-assert-if-true !null $this->fromDataProvider
*/
public function hasDataFromDataProvider(): bool
{
return $this->fromDataProvider !== null;
}
/**
* @throws NoDataSetFromDataProviderException
*/
public function dataFromDataProvider(): DataFromDataProvider
{
if (!$this->hasDataFromDataProvider()) {
throw new NoDataSetFromDataProviderException;
}
return $this->fromDataProvider;
}
public function getIterator(): TestDataCollectionIterator
{
return new TestDataCollectionIterator($this);
}
/**
* @psalm-param list<TestData> $data
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function ensureNoMoreThanOneDataFromDataProvider(array $data): void
{
foreach ($data as $_data) {
if ($_data->isFromDataProvider()) {
if ($this->fromDataProvider !== null) {
throw new MoreThanOneDataSetFromDataProviderException;
}
$this->fromDataProvider = $_data;
}
}
}
}
src/Event/Value/Test/Phpt.php 0000644 00000001510 15243426620 0012034 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Phpt extends Test
{
/**
* @psalm-assert-if-true Phpt $this
*/
public function isPhpt(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function id(): string
{
return $this->file();
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->file();
}
}
src/Event/Value/ComparisonFailure.php 0000644 00000001753 15243426620 0013635 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonFailure
{
private readonly string $expected;
private readonly string $actual;
private readonly string $diff;
public function __construct(string $expected, string $actual, string $diff)
{
$this->expected = $expected;
$this->actual = $actual;
$this->diff = $diff;
}
public function expected(): string
{
return $this->expected;
}
public function actual(): string
{
return $this->actual;
}
public function diff(): string
{
return $this->diff;
}
}
src/Event/Value/ClassMethod.php 0000644 00000002234 15243426620 0012414 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ClassMethod
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Event/Value/Throwable.php 0000644 00000004527 15243426620 0012144 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Event\Code;
use const PHP_EOL;
use PHPUnit\Event\NoPreviousThrowableException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Throwable
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly string $message;
private readonly string $description;
private readonly string $stackTrace;
private readonly ?Throwable $previous;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className, string $message, string $description, string $stackTrace, ?self $previous)
{
$this->className = $className;
$this->message = $message;
$this->description = $description;
$this->stackTrace = $stackTrace;
$this->previous = $previous;
}
/**
* @throws NoPreviousThrowableException
*/
public function asString(): string
{
$buffer = $this->description();
if (!empty($this->stackTrace())) {
$buffer .= PHP_EOL . $this->stackTrace();
}
if ($this->hasPrevious()) {
$buffer .= PHP_EOL . 'Caused by' . PHP_EOL . $this->previous()->asString();
}
return $buffer;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function message(): string
{
return $this->message;
}
public function description(): string
{
return $this->description;
}
public function stackTrace(): string
{
return $this->stackTrace;
}
/**
* @psalm-assert-if-true !null $this->previous
*/
public function hasPrevious(): bool
{
return $this->previous !== null;
}
/**
* @throws NoPreviousThrowableException
*/
public function previous(): self
{
if ($this->previous === null) {
throw new NoPreviousThrowableException;
}
return $this->previous;
}
}
src/Metadata/RunTestsInSeparateProcesses.php 0000644 00000001211 15243426620 0015215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunTestsInSeparateProcesses extends Metadata
{
/**
* @psalm-assert-if-true RunTestsInSeparateProcesses $this
*/
public function isRunTestsInSeparateProcesses(): bool
{
return true;
}
}
src/Metadata/AfterClass.php 0000644 00000001126 15243426620 0011617 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class AfterClass extends Metadata
{
/**
* @psalm-assert-if-true AfterClass $this
*/
public function isAfterClass(): bool
{
return true;
}
}
src/Metadata/RequiresSetting.php 0000644 00000002562 15243426620 0012732 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresSetting extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $setting;
/**
* @psalm-var non-empty-string
*/
private readonly string $value;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
protected function __construct(int $level, string $setting, string $value)
{
parent::__construct($level);
$this->setting = $setting;
$this->value = $value;
}
/**
* @psalm-assert-if-true RequiresSetting $this
*/
public function isRequiresSetting(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function setting(): string
{
return $this->setting;
}
/**
* @psalm-return non-empty-string
*/
public function value(): string
{
return $this->value;
}
}
src/Metadata/Test.php 0000644 00000001104 15243426620 0010503 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Test extends Metadata
{
/**
* @psalm-assert-if-true Test $this
*/
public function isTest(): bool
{
return true;
}
}
src/Metadata/BeforeClass.php 0000644 00000001131 15243426620 0011754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeClass extends Metadata
{
/**
* @psalm-assert-if-true BeforeClass $this
*/
public function isBeforeClass(): bool
{
return true;
}
}
src/Metadata/BackupGlobals.php 0000644 00000001627 15243426620 0012307 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BackupGlobals extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true BackupGlobals $this
*/
public function isBackupGlobals(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Metadata/RunInSeparateProcess.php 0000644 00000001164 15243426620 0013651 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunInSeparateProcess extends Metadata
{
/**
* @psalm-assert-if-true RunInSeparateProcess $this
*/
public function isRunInSeparateProcess(): bool
{
return true;
}
}
src/Metadata/MetadataCollectionIterator.php 0000644 00000002301 15243426620 0015032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, Metadata>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MetadataCollectionIterator implements Iterator
{
/**
* @psalm-var list<Metadata>
*/
private readonly array $metadata;
private int $position = 0;
public function __construct(MetadataCollection $metadata)
{
$this->metadata = $metadata->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->metadata);
}
public function key(): int
{
return $this->position;
}
public function current(): Metadata
{
return $this->metadata[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/Metadata/CoversClass.php 0000644 00000002455 15243426620 0012025 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true CoversClass $this
*/
public function isCoversClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return class-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return $this->className;
}
}
src/Metadata/IgnoreClassForCodeCoverage.php 0000644 00000002250 15243426620 0014716 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreClassForCodeCoverage extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true IgnoreClassForCodeCoverage $this
*/
public function isIgnoreClassForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Metadata/DependsOnClass.php 0000644 00000002665 15243426620 0012446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DependsOnClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
private readonly bool $deepClone;
private readonly bool $shallowClone;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className, bool $deepClone, bool $shallowClone)
{
parent::__construct($level);
$this->className = $className;
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
}
/**
* @psalm-assert-if-true DependsOnClass $this
*/
public function isDependsOnClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
}
src/Metadata/MetadataCollection.php 0000644 00000034007 15243426620 0013330 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function array_filter;
use function array_merge;
use function count;
use Countable;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, Metadata>
*
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MetadataCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Metadata>
*/
private readonly array $metadata;
/**
* @psalm-param list<Metadata> $metadata
*/
public static function fromArray(array $metadata): self
{
return new self(...$metadata);
}
private function __construct(Metadata ...$metadata)
{
$this->metadata = $metadata;
}
/**
* @psalm-return list<Metadata>
*/
public function asArray(): array
{
return $this->metadata;
}
public function count(): int
{
return count($this->metadata);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
public function isNotEmpty(): bool
{
return $this->count() > 0;
}
public function getIterator(): MetadataCollectionIterator
{
return new MetadataCollectionIterator($this);
}
public function mergeWith(self $other): self
{
return new self(
...array_merge(
$this->asArray(),
$other->asArray(),
),
);
}
public function isClassLevel(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isClassLevel(),
),
);
}
public function isMethodLevel(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isMethodLevel(),
),
);
}
public function isAfter(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isAfter(),
),
);
}
public function isAfterClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isAfterClass(),
),
);
}
public function isBackupGlobals(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBackupGlobals(),
),
);
}
public function isBackupStaticProperties(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBackupStaticProperties(),
),
);
}
public function isBeforeClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBeforeClass(),
),
);
}
public function isBefore(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isBefore(),
),
);
}
public function isCovers(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCovers(),
),
);
}
public function isCoversClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversClass(),
),
);
}
public function isCoversDefaultClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversDefaultClass(),
),
);
}
public function isCoversFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversFunction(),
),
);
}
public function isExcludeGlobalVariableFromBackup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isExcludeGlobalVariableFromBackup(),
),
);
}
public function isExcludeStaticPropertyFromBackup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isExcludeStaticPropertyFromBackup(),
),
);
}
public function isCoversNothing(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isCoversNothing(),
),
);
}
public function isDataProvider(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDataProvider(),
),
);
}
public function isDepends(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnClass() || $metadata->isDependsOnMethod(),
),
);
}
public function isDependsOnClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnClass(),
),
);
}
public function isDependsOnMethod(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDependsOnMethod(),
),
);
}
public function isDoesNotPerformAssertions(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isDoesNotPerformAssertions(),
),
);
}
public function isGroup(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isGroup(),
),
);
}
public function isIgnoreDeprecations(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreDeprecations(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreClassForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreClassForCodeCoverage(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreMethodForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreMethodForCodeCoverage(),
),
);
}
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
public function isIgnoreFunctionForCodeCoverage(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isIgnoreFunctionForCodeCoverage(),
),
);
}
public function isRunClassInSeparateProcess(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunClassInSeparateProcess(),
),
);
}
public function isRunInSeparateProcess(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunInSeparateProcess(),
),
);
}
public function isRunTestsInSeparateProcesses(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRunTestsInSeparateProcesses(),
),
);
}
public function isTest(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTest(),
),
);
}
public function isPreCondition(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPreCondition(),
),
);
}
public function isPostCondition(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPostCondition(),
),
);
}
public function isPreserveGlobalState(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isPreserveGlobalState(),
),
);
}
public function isRequiresMethod(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresMethod(),
),
);
}
public function isRequiresFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresFunction(),
),
);
}
public function isRequiresOperatingSystem(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresOperatingSystem(),
),
);
}
public function isRequiresOperatingSystemFamily(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresOperatingSystemFamily(),
),
);
}
public function isRequiresPhp(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhp(),
),
);
}
public function isRequiresPhpExtension(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhpExtension(),
),
);
}
public function isRequiresPhpunit(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresPhpunit(),
),
);
}
public function isRequiresSetting(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isRequiresSetting(),
),
);
}
public function isTestDox(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTestDox(),
),
);
}
public function isTestWith(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isTestWith(),
),
);
}
public function isUses(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUses(),
),
);
}
public function isUsesClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesClass(),
),
);
}
public function isUsesDefaultClass(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesDefaultClass(),
),
);
}
public function isUsesFunction(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isUsesFunction(),
),
);
}
public function isWithoutErrorHandler(): self
{
return new self(
...array_filter(
$this->metadata,
static fn (Metadata $metadata): bool => $metadata->isWithoutErrorHandler(),
),
);
}
}
src/Metadata/DataProvider.php 0000644 00000002615 15243426620 0012160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DataProvider extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true DataProvider $this
*/
public function isDataProvider(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Metadata/CoversNothing.php 0000644 00000001137 15243426620 0012362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversNothing extends Metadata
{
/**
* @psalm-assert-if-true CoversNothing $this
*/
public function isCoversNothing(): bool
{
return true;
}
}
src/Metadata/Before.php 0000644 00000001112 15243426620 0010765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Before extends Metadata
{
/**
* @psalm-assert-if-true Before $this
*/
public function isBefore(): bool
{
return true;
}
}
src/Metadata/RunClassInSeparateProcess.php 0000644 00000001203 15243426620 0014631 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RunClassInSeparateProcess extends Metadata
{
/**
* @psalm-assert-if-true RunClassInSeparateProcess $this
*/
public function isRunClassInSeparateProcess(): bool
{
return true;
}
}
src/Metadata/RequiresOperatingSystem.php 0000644 00000002207 15243426620 0014446 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresOperatingSystem extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystem;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $operatingSystem
*/
public function __construct(int $level, string $operatingSystem)
{
parent::__construct($level);
$this->operatingSystem = $operatingSystem;
}
/**
* @psalm-assert-if-true RequiresOperatingSystem $this
*/
public function isRequiresOperatingSystem(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystem(): string
{
return $this->operatingSystem;
}
}
src/Metadata/Version/ComparisonRequirement.php 0000644 00000002117 15243426620 0015551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function version_compare;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonRequirement extends Requirement
{
private readonly string $version;
private readonly VersionComparisonOperator $operator;
public function __construct(string $version, VersionComparisonOperator $operator)
{
$this->version = $version;
$this->operator = $operator;
}
public function isSatisfiedBy(string $version): bool
{
return version_compare($version, $this->version, $this->operator->asString());
}
public function asString(): string
{
return $this->operator->asString() . ' ' . $this->version;
}
}
src/Metadata/Version/ConstraintRequirement.php 0000644 00000002453 15243426620 0015566 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function preg_replace;
use PharIo\Version\Version;
use PharIo\Version\VersionConstraint;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ConstraintRequirement extends Requirement
{
private readonly VersionConstraint $constraint;
public function __construct(VersionConstraint $constraint)
{
$this->constraint = $constraint;
}
/**
* @psalm-suppress ImpureMethodCall
*/
public function isSatisfiedBy(string $version): bool
{
return $this->constraint->complies(
new Version($this->sanitize($version)),
);
}
/**
* @psalm-suppress ImpureMethodCall
*/
public function asString(): string
{
return $this->constraint->asString();
}
private function sanitize(string $version): string
{
return preg_replace(
'/^(\d+\.\d+(?:.\d+)?).*$/',
'$1',
$version,
);
}
}
src/Metadata/Version/Requirement.php 0000644 00000003504 15243426620 0013517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Version;
use function preg_match;
use PharIo\Version\UnsupportedVersionConstraintException;
use PharIo\Version\VersionConstraintParser;
use PHPUnit\Metadata\InvalidVersionRequirementException;
use PHPUnit\Util\InvalidVersionOperatorException;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Requirement
{
private const VERSION_COMPARISON = '/(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+(dev|(RC|alpha|beta)[\d\.])?)[ \t]*\r?$/m';
/**
* @throws InvalidVersionOperatorException
* @throws InvalidVersionRequirementException
*/
public static function from(string $versionRequirement): self
{
try {
return new ConstraintRequirement(
(new VersionConstraintParser)->parse(
$versionRequirement,
),
);
} catch (UnsupportedVersionConstraintException) {
if (preg_match(self::VERSION_COMPARISON, $versionRequirement, $matches)) {
return new ComparisonRequirement(
$matches['version'],
new VersionComparisonOperator(
!empty($matches['operator']) ? $matches['operator'] : '>=',
),
);
}
}
throw new InvalidVersionRequirementException;
}
abstract public function isSatisfiedBy(string $version): bool;
abstract public function asString(): string;
}
src/Metadata/PreCondition.php 0000644 00000001134 15243426620 0012164 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreCondition extends Metadata
{
/**
* @psalm-assert-if-true PreCondition $this
*/
public function isPreCondition(): bool
{
return true;
}
}
src/Metadata/RequiresOperatingSystemFamily.php 0000644 00000002306 15243426620 0015610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresOperatingSystemFamily extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystemFamily;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $operatingSystemFamily
*/
protected function __construct(int $level, string $operatingSystemFamily)
{
parent::__construct($level);
$this->operatingSystemFamily = $operatingSystemFamily;
}
/**
* @psalm-assert-if-true RequiresOperatingSystemFamily $this
*/
public function isRequiresOperatingSystemFamily(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
src/Metadata/IgnoreMethodForCodeCoverage.php 0000644 00000003005 15243426620 0015070 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreMethodForCodeCoverage extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true IgnoreMethodForCodeCoverage $this
*/
public function isIgnoreMethodForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Metadata/BackupStaticProperties.php 0000644 00000001662 15243426620 0014227 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class BackupStaticProperties extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true BackupStaticProperties $this
*/
public function isBackupStaticProperties(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Metadata/WithoutErrorHandler.php 0000644 00000001161 15243426620 0013542 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class WithoutErrorHandler extends Metadata
{
/**
* @psalm-assert-if-true WithoutErrorHandler $this
*/
public function isWithoutErrorHandler(): bool
{
return true;
}
}
src/Metadata/TestDox.php 0000644 00000002015 15243426620 0011160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestDox extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $text
*/
protected function __construct(int $level, string $text)
{
parent::__construct($level);
$this->text = $text;
}
/**
* @psalm-assert-if-true TestDox $this
*/
public function isTestDox(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
src/Metadata/RequiresFunction.php 0000644 00000002140 15243426620 0013072 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true RequiresFunction $this
*/
public function isRequiresFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Metadata/UsesFunction.php 0000644 00000002457 15243426620 0012225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
public function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true UsesFunction $this
*/
public function isUsesFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return '::' . $this->functionName;
}
}
src/Metadata/UsesClass.php 0000644 00000002447 15243426620 0011504 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true UsesClass $this
*/
public function isUsesClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return class-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return $this->className;
}
}
src/Metadata/After.php 0000644 00000001107 15243426620 0010630 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class After extends Metadata
{
/**
* @psalm-assert-if-true After $this
*/
public function isAfter(): bool
{
return true;
}
}
src/Metadata/Group.php 0000644 00000002052 15243426620 0010663 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Group extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $groupName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $groupName
*/
protected function __construct(int $level, string $groupName)
{
parent::__construct($level);
$this->groupName = $groupName;
}
/**
* @psalm-assert-if-true Group $this
*/
public function isGroup(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function groupName(): string
{
return $this->groupName;
}
}
src/Metadata/Api/DataProvider.php 0000644 00000023310 15243426620 0012664 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_key_exists;
use function assert;
use function explode;
use function is_array;
use function is_int;
use function json_decode;
use function json_last_error;
use function json_last_error_msg;
use function preg_match;
use function preg_replace;
use function rtrim;
use function sprintf;
use function str_replace;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Event;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\TestDataCollection;
use PHPUnit\Framework\InvalidDataProviderException;
use PHPUnit\Metadata\DataProvider as DataProviderMetadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\TestWith;
use PHPUnit\Util\Reflection;
use ReflectionClass;
use ReflectionMethod;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DataProvider
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
public function providedData(string $className, string $methodName): ?array
{
$dataProvider = MetadataRegistry::parser()->forMethod($className, $methodName)->isDataProvider();
$testWith = MetadataRegistry::parser()->forMethod($className, $methodName)->isTestWith();
if ($dataProvider->isEmpty() && $testWith->isEmpty()) {
return $this->dataProvidedByTestWithAnnotation($className, $methodName);
}
if ($dataProvider->isNotEmpty()) {
$data = $this->dataProvidedByMethods($className, $methodName, $dataProvider);
} else {
$data = $this->dataProvidedByMetadata($testWith);
}
if ($data === []) {
throw new InvalidDataProviderException(
'Empty data set provided by data provider',
);
}
foreach ($data as $key => $value) {
if (!is_array($value)) {
throw new InvalidDataProviderException(
sprintf(
'Data set %s is invalid',
is_int($key) ? '#' . $key : '"' . $key . '"',
),
);
}
}
return $data;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
private function dataProvidedByMethods(string $className, string $methodName, MetadataCollection $dataProvider): array
{
$testMethod = new Event\Code\ClassMethod($className, $methodName);
$methodsCalled = [];
$result = [];
foreach ($dataProvider as $_dataProvider) {
assert($_dataProvider instanceof DataProviderMetadata);
$dataProviderMethod = new Event\Code\ClassMethod($_dataProvider->className(), $_dataProvider->methodName());
Event\Facade::emitter()->dataProviderMethodCalled(
$testMethod,
$dataProviderMethod,
);
$methodsCalled[] = $dataProviderMethod;
try {
$class = new ReflectionClass($_dataProvider->className());
$method = $class->getMethod($_dataProvider->methodName());
$object = null;
if (!$method->isPublic()) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() is not public',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
}
if (!$method->isStatic()) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() is not static',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
$object = $class->newInstanceWithoutConstructor();
}
if ($method->getNumberOfParameters() === 0) {
$data = $method->invoke($object);
} else {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForTestMethodWithoutTestData(
$className,
$methodName,
),
sprintf(
'Data Provider method %s::%s() expects an argument',
$_dataProvider->className(),
$_dataProvider->methodName(),
),
);
$data = $method->invoke($object, $_dataProvider->methodName());
}
} catch (Throwable $e) {
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
throw new InvalidDataProviderException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
foreach ($data as $key => $value) {
if (is_int($key)) {
$result[] = $value;
} elseif (array_key_exists($key, $result)) {
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
throw new InvalidDataProviderException(
sprintf(
'The key "%s" has already been defined by a previous data provider',
$key,
),
);
} else {
$result[$key] = $value;
}
}
}
Event\Facade::emitter()->dataProviderMethodFinished(
$testMethod,
...$methodsCalled,
);
return $result;
}
private function dataProvidedByMetadata(MetadataCollection $testWith): array
{
$result = [];
foreach ($testWith as $_testWith) {
assert($_testWith instanceof TestWith);
$result[] = $_testWith->data();
}
return $result;
}
/**
* @psalm-param class-string $className
*
* @throws InvalidDataProviderException
*/
private function dataProvidedByTestWithAnnotation(string $className, string $methodName): ?array
{
$docComment = (new ReflectionMethod($className, $methodName))->getDocComment();
if ($docComment === false) {
return null;
}
$docComment = str_replace("\r\n", "\n", $docComment);
$docComment = preg_replace('/\n\s*\*\s?/', "\n", $docComment);
$docComment = substr($docComment, 0, -1);
$docComment = rtrim($docComment, "\n");
if (!preg_match('/@testWith\s+/', $docComment, $matches, PREG_OFFSET_CAPTURE)) {
return null;
}
$offset = strlen($matches[0][0]) + (int) $matches[0][1];
$annotationContent = substr($docComment, $offset);
$data = [];
foreach (explode("\n", $annotationContent) as $candidateRow) {
$candidateRow = trim($candidateRow);
if ($candidateRow === '' || $candidateRow[0] !== '[') {
break;
}
$dataSet = json_decode($candidateRow, true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new InvalidDataProviderException(
'The data set for the @testWith annotation cannot be parsed: ' . json_last_error_msg(),
);
}
$data[] = $dataSet;
}
if (!$data) {
throw new InvalidDataProviderException(
'The data set for the @testWith annotation cannot be parsed.',
);
}
return $data;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function valueObjectForTestMethodWithoutTestData(string $className, string $methodName): TestMethod
{
$location = Reflection::sourceLocationFor($className, $methodName);
return new TestMethod(
$className,
$methodName,
$location['file'],
$location['line'],
Event\Code\TestDoxBuilder::fromClassNameAndMethodName(
$className,
$methodName,
),
MetadataRegistry::parser()->forClassAndMethod(
$className,
$methodName,
),
TestDataCollection::fromArray([]),
);
}
}
src/Metadata/Api/Requirements.php 0000644 00000012313 15243426620 0012764 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use const PHP_OS;
use const PHP_OS_FAMILY;
use const PHP_VERSION;
use function addcslashes;
use function assert;
use function extension_loaded;
use function function_exists;
use function ini_get;
use function method_exists;
use function phpversion;
use function preg_match;
use function sprintf;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\RequiresFunction;
use PHPUnit\Metadata\RequiresMethod;
use PHPUnit\Metadata\RequiresOperatingSystem;
use PHPUnit\Metadata\RequiresOperatingSystemFamily;
use PHPUnit\Metadata\RequiresPhp;
use PHPUnit\Metadata\RequiresPhpExtension;
use PHPUnit\Metadata\RequiresPhpunit;
use PHPUnit\Metadata\RequiresSetting;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Requirements
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return list<string>
*/
public function requirementsNotSatisfiedFor(string $className, string $methodName): array
{
$notSatisfied = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isRequiresPhp()) {
assert($metadata instanceof RequiresPhp);
if (!$metadata->versionRequirement()->isSatisfiedBy(PHP_VERSION)) {
$notSatisfied[] = sprintf(
'PHP %s is required.',
$metadata->versionRequirement()->asString(),
);
}
}
if ($metadata->isRequiresPhpExtension()) {
assert($metadata instanceof RequiresPhpExtension);
if (!extension_loaded($metadata->extension()) ||
($metadata->hasVersionRequirement() &&
!$metadata->versionRequirement()->isSatisfiedBy(phpversion($metadata->extension())))) {
$notSatisfied[] = sprintf(
'PHP extension %s%s is required.',
$metadata->extension(),
$metadata->hasVersionRequirement() ? (' ' . $metadata->versionRequirement()->asString()) : '',
);
}
}
if ($metadata->isRequiresPhpunit()) {
assert($metadata instanceof RequiresPhpunit);
if (!$metadata->versionRequirement()->isSatisfiedBy(Version::id())) {
$notSatisfied[] = sprintf(
'PHPUnit %s is required.',
$metadata->versionRequirement()->asString(),
);
}
}
if ($metadata->isRequiresOperatingSystemFamily()) {
assert($metadata instanceof RequiresOperatingSystemFamily);
if ($metadata->operatingSystemFamily() !== PHP_OS_FAMILY) {
$notSatisfied[] = sprintf(
'Operating system %s is required.',
$metadata->operatingSystemFamily(),
);
}
}
if ($metadata->isRequiresOperatingSystem()) {
assert($metadata instanceof RequiresOperatingSystem);
$pattern = sprintf(
'/%s/i',
addcslashes($metadata->operatingSystem(), '/'),
);
if (!preg_match($pattern, PHP_OS)) {
$notSatisfied[] = sprintf(
'Operating system %s is required.',
$metadata->operatingSystem(),
);
}
}
if ($metadata->isRequiresFunction()) {
assert($metadata instanceof RequiresFunction);
if (!function_exists($metadata->functionName())) {
$notSatisfied[] = sprintf(
'Function %s() is required.',
$metadata->functionName(),
);
}
}
if ($metadata->isRequiresMethod()) {
assert($metadata instanceof RequiresMethod);
if (!method_exists($metadata->className(), $metadata->methodName())) {
$notSatisfied[] = sprintf(
'Method %s::%s() is required.',
$metadata->className(),
$metadata->methodName(),
);
}
}
if ($metadata->isRequiresSetting()) {
assert($metadata instanceof RequiresSetting);
if (ini_get($metadata->setting()) !== $metadata->value()) {
$notSatisfied[] = sprintf(
'Setting "%s" is required to be "%s".',
$metadata->setting(),
$metadata->value(),
);
}
}
}
return $notSatisfied;
}
}
src/Metadata/Api/Dependencies.php 0000644 00000003046 15243426620 0012672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function assert;
use PHPUnit\Framework\ExecutionOrderDependency;
use PHPUnit\Metadata\DependsOnClass;
use PHPUnit\Metadata\DependsOnMethod;
use PHPUnit\Metadata\Parser\Registry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Dependencies
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function dependencies(string $className, string $methodName): array
{
$dependencies = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName)->isDepends() as $metadata) {
if ($metadata->isDependsOnClass()) {
assert($metadata instanceof DependsOnClass);
$dependencies[] = ExecutionOrderDependency::forClass($metadata);
continue;
}
assert($metadata instanceof DependsOnMethod);
if (empty($metadata->methodName())) {
$dependencies[] = ExecutionOrderDependency::invalid();
continue;
}
$dependencies[] = ExecutionOrderDependency::forMethod($metadata);
}
return $dependencies;
}
}
src/Metadata/Api/Groups.php 0000644 00000007307 15243426620 0011567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_flip;
use function array_key_exists;
use function array_unique;
use function assert;
use function strtolower;
use function trim;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Covers;
use PHPUnit\Metadata\CoversClass;
use PHPUnit\Metadata\CoversFunction;
use PHPUnit\Metadata\Group;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\Uses;
use PHPUnit\Metadata\UsesClass;
use PHPUnit\Metadata\UsesFunction;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Groups
{
/**
* @var array<string, array<int, string>>
*/
private static array $groupCache = [];
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<int, string>
*/
public function groups(string $className, string $methodName, bool $includeVirtual = true): array
{
$key = $className . '::' . $methodName . '::' . $includeVirtual;
if (array_key_exists($key, self::$groupCache)) {
return self::$groupCache[$key];
}
$groups = [];
foreach (Registry::parser()->forClassAndMethod($className, $methodName)->isGroup() as $group) {
assert($group instanceof Group);
$groups[] = $group->groupName();
}
if ($groups === []) {
$groups[] = 'default';
}
if (!$includeVirtual) {
return self::$groupCache[$key] = array_unique($groups);
}
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isCoversClass() || $metadata->isCoversFunction()) {
assert($metadata instanceof CoversClass || $metadata instanceof CoversFunction);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isCovers()) {
assert($metadata instanceof Covers);
$groups[] = '__phpunit_covers_' . $this->canonicalizeName($metadata->target());
continue;
}
if ($metadata->isUsesClass() || $metadata->isUsesFunction()) {
assert($metadata instanceof UsesClass || $metadata instanceof UsesFunction);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->asStringForCodeUnitMapper());
continue;
}
if ($metadata->isUses()) {
assert($metadata instanceof Uses);
$groups[] = '__phpunit_uses_' . $this->canonicalizeName($metadata->target());
}
}
return self::$groupCache[$key] = array_unique($groups);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function size(string $className, string $methodName): TestSize
{
$groups = array_flip($this->groups($className, $methodName));
if (isset($groups['large'])) {
return TestSize::large();
}
if (isset($groups['medium'])) {
return TestSize::medium();
}
if (isset($groups['small'])) {
return TestSize::small();
}
return TestSize::unknown();
}
private function canonicalizeName(string $name): string
{
return strtolower(trim($name, '\\'));
}
}
src/Metadata/Api/HookMethods.php 0000644 00000007245 15243426620 0012535 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_unshift;
use function assert;
use function class_exists;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Util\Reflection;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class HookMethods
{
/**
* @psalm-var array<class-string, array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}>
*/
private static array $hookMethods = [];
/**
* @psalm-param class-string $className
*
* @psalm-return array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}
*/
public function hookMethods(string $className): array
{
if (!class_exists($className)) {
return self::emptyHookMethodsArray();
}
if (isset(self::$hookMethods[$className])) {
return self::$hookMethods[$className];
}
self::$hookMethods[$className] = self::emptyHookMethodsArray();
foreach (Reflection::methodsInTestClass(new ReflectionClass($className)) as $method) {
$methodName = $method->getName();
assert(!empty($methodName));
$metadata = Registry::parser()->forMethod($className, $methodName);
if ($method->isStatic()) {
if ($metadata->isBeforeClass()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['beforeClass'],
$methodName,
);
}
if ($metadata->isAfterClass()->isNotEmpty()) {
self::$hookMethods[$className]['afterClass'][] = $methodName;
}
}
if ($metadata->isBefore()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['before'],
$methodName,
);
}
if ($metadata->isPreCondition()->isNotEmpty()) {
array_unshift(
self::$hookMethods[$className]['preCondition'],
$methodName,
);
}
if ($metadata->isPostCondition()->isNotEmpty()) {
self::$hookMethods[$className]['postCondition'][] = $methodName;
}
if ($metadata->isAfter()->isNotEmpty()) {
self::$hookMethods[$className]['after'][] = $methodName;
}
}
return self::$hookMethods[$className];
}
/**
* @psalm-return array{beforeClass: list<non-empty-string>, before: list<non-empty-string>, preCondition: list<non-empty-string>, postCondition: list<non-empty-string>, after: list<non-empty-string>, afterClass: list<non-empty-string>}
*/
private function emptyHookMethodsArray(): array
{
return [
'beforeClass' => ['setUpBeforeClass'],
'before' => ['setUp'],
'preCondition' => ['assertPreConditions'],
'postCondition' => ['assertPostConditions'],
'after' => ['tearDown'],
'afterClass' => ['tearDownAfterClass'],
];
}
}
src/Metadata/Api/CodeCoverage.php 0000644 00000024654 15243426620 0012642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Api;
use function array_unique;
use function array_values;
use function assert;
use function count;
use function interface_exists;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\CodeCoverageException;
use PHPUnit\Framework\InvalidCoversTargetException;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Metadata\Covers;
use PHPUnit\Metadata\CoversClass;
use PHPUnit\Metadata\CoversDefaultClass;
use PHPUnit\Metadata\CoversFunction;
use PHPUnit\Metadata\IgnoreClassForCodeCoverage;
use PHPUnit\Metadata\IgnoreFunctionForCodeCoverage;
use PHPUnit\Metadata\IgnoreMethodForCodeCoverage;
use PHPUnit\Metadata\Parser\Registry;
use PHPUnit\Metadata\Uses;
use PHPUnit\Metadata\UsesClass;
use PHPUnit\Metadata\UsesDefaultClass;
use PHPUnit\Metadata\UsesFunction;
use RecursiveIteratorIterator;
use SebastianBergmann\CodeUnit\CodeUnitCollection;
use SebastianBergmann\CodeUnit\Exception as CodeUnitException;
use SebastianBergmann\CodeUnit\InvalidCodeUnitException;
use SebastianBergmann\CodeUnit\Mapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverage
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<string,list<int>>|false
*
* @throws CodeCoverageException
*/
public function linesToBeCovered(string $className, string $methodName): array|false
{
if (!$this->shouldCodeCoverageBeCollectedFor($className, $methodName)) {
return false;
}
$metadataForClass = Registry::parser()->forClass($className);
$classShortcut = null;
if ($metadataForClass->isCoversDefaultClass()->isNotEmpty()) {
if (count($metadataForClass->isCoversDefaultClass()) > 1) {
throw new CodeCoverageException(
sprintf(
'More than one @coversDefaultClass annotation for class or interface "%s"',
$className,
),
);
}
$metadata = $metadataForClass->isCoversDefaultClass()->asArray()[0];
assert($metadata instanceof CoversDefaultClass);
$classShortcut = $metadata->className();
}
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if (!$metadata->isCoversClass() && !$metadata->isCoversFunction() && !$metadata->isCovers()) {
continue;
}
assert($metadata instanceof CoversClass || $metadata instanceof CoversFunction || $metadata instanceof Covers);
if ($metadata->isCoversClass() || $metadata->isCoversFunction()) {
$codeUnits = $codeUnits->mergeWith($this->mapToCodeUnits($metadata));
} elseif ($metadata->isCovers()) {
assert($metadata instanceof Covers);
$target = $metadata->target();
if (interface_exists($target)) {
throw new InvalidCoversTargetException(
sprintf(
'Trying to @cover interface "%s".',
$target,
),
);
}
if ($classShortcut !== null && str_starts_with($target, '::')) {
$target = $classShortcut . $target;
}
try {
$codeUnits = $codeUnits->mergeWith($mapper->stringToCodeUnits($target));
} catch (InvalidCodeUnitException $e) {
throw new InvalidCoversTargetException(
sprintf(
'"@covers %s" is invalid',
$target,
),
$e->getCode(),
$e,
);
}
}
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array<string,list<int>>
*
* @throws CodeCoverageException
*/
public function linesToBeUsed(string $className, string $methodName): array
{
$metadataForClass = Registry::parser()->forClass($className);
$classShortcut = null;
if ($metadataForClass->isUsesDefaultClass()->isNotEmpty()) {
if (count($metadataForClass->isUsesDefaultClass()) > 1) {
throw new CodeCoverageException(
sprintf(
'More than one @usesDefaultClass annotation for class or interface "%s"',
$className,
),
);
}
$metadata = $metadataForClass->isUsesDefaultClass()->asArray()[0];
assert($metadata instanceof UsesDefaultClass);
$classShortcut = $metadata->className();
}
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if (!$metadata->isUsesClass() && !$metadata->isUsesFunction() && !$metadata->isUses()) {
continue;
}
assert($metadata instanceof UsesClass || $metadata instanceof UsesFunction || $metadata instanceof Uses);
if ($metadata->isUsesClass() || $metadata->isUsesFunction()) {
$codeUnits = $codeUnits->mergeWith($this->mapToCodeUnits($metadata));
} elseif ($metadata->isUses()) {
assert($metadata instanceof Uses);
$target = $metadata->target();
if ($classShortcut !== null && str_starts_with($target, '::')) {
$target = $classShortcut . $target;
}
try {
$codeUnits = $codeUnits->mergeWith($mapper->stringToCodeUnits($target));
} catch (InvalidCodeUnitException $e) {
throw new InvalidCoversTargetException(
sprintf(
'"@uses %s" is invalid',
$target,
),
$e->getCode(),
$e,
);
}
}
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-return array<string,list<int>>
*/
public function linesToBeIgnored(TestSuite $testSuite): array
{
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach ($this->testCaseClassesIn($testSuite) as $testCaseClassName) {
$codeUnits = $codeUnits->mergeWith(
$this->codeUnitsIgnoredBy($testCaseClassName),
);
}
return $mapper->codeUnitsToSourceLines($codeUnits);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function shouldCodeCoverageBeCollectedFor(string $className, string $methodName): bool
{
$metadataForClass = Registry::parser()->forClass($className);
$metadataForMethod = Registry::parser()->forMethod($className, $methodName);
if ($metadataForMethod->isCoversNothing()->isNotEmpty()) {
return false;
}
if ($metadataForMethod->isCovers()->isNotEmpty() ||
$metadataForMethod->isCoversClass()->isNotEmpty() ||
$metadataForMethod->isCoversFunction()->isNotEmpty()) {
return true;
}
if ($metadataForClass->isCoversNothing()->isNotEmpty()) {
return false;
}
return true;
}
/**
* @psalm-return list<class-string>
*/
private function testCaseClassesIn(TestSuite $testSuite): array
{
$classNames = [];
foreach (new RecursiveIteratorIterator($testSuite) as $test) {
$classNames[] = $test::class;
}
return array_values(array_unique($classNames));
}
/**
* @psalm-param class-string $className
*/
private function codeUnitsIgnoredBy(string $className): CodeUnitCollection
{
$codeUnits = CodeUnitCollection::fromList();
$mapper = new Mapper;
foreach (Registry::parser()->forClass($className) as $metadata) {
if ($metadata instanceof IgnoreClassForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits($metadata->className()),
);
}
if ($metadata instanceof IgnoreMethodForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits($metadata->className() . '::' . $metadata->methodName()),
);
}
if ($metadata instanceof IgnoreFunctionForCodeCoverage) {
$codeUnits = $codeUnits->mergeWith(
$mapper->stringToCodeUnits('::' . $metadata->functionName()),
);
}
}
return $codeUnits;
}
/**
* @throws InvalidCoversTargetException
*/
private function mapToCodeUnits(CoversClass|CoversFunction|UsesClass|UsesFunction $metadata): CodeUnitCollection
{
$mapper = new Mapper;
try {
return $mapper->stringToCodeUnits($metadata->asStringForCodeUnitMapper());
} catch (CodeUnitException $e) {
if ($metadata->isCoversClass() || $metadata->isUsesClass()) {
if (interface_exists($metadata->className())) {
$type = 'Interface';
} else {
$type = 'Class';
}
} else {
$type = 'Function';
}
throw new InvalidCoversTargetException(
sprintf(
'%s "%s" is not a valid target for code coverage',
$type,
$metadata->asStringForCodeUnitMapper(),
),
$e->getCode(),
$e,
);
}
}
}
src/Metadata/ExcludeGlobalVariableFromBackup.php 0000644 00000002267 15243426620 0015731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeGlobalVariableFromBackup extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $globalVariableName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $globalVariableName
*/
protected function __construct(int $level, string $globalVariableName)
{
parent::__construct($level);
$this->globalVariableName = $globalVariableName;
}
/**
* @psalm-assert-if-true ExcludeGlobalVariableFromBackup $this
*/
public function isExcludeGlobalVariableFromBackup(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function globalVariableName(): string
{
return $this->globalVariableName;
}
}
src/Metadata/IgnoreDeprecations.php 0000644 00000001156 15243426620 0013357 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IgnoreDeprecations extends Metadata
{
/**
* @psalm-assert-if-true IgnoreDeprecations $this
*/
public function isIgnoreDeprecations(): bool
{
return true;
}
}
src/Metadata/DoesNotPerformAssertions.php 0000644 00000001200 15243426620 0014542 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DoesNotPerformAssertions extends Metadata
{
/**
* @psalm-assert-if-true DoesNotPerformAssertions $this
*/
public function isDoesNotPerformAssertions(): bool
{
return true;
}
}
src/Metadata/Exception/AnnotationsAreNotSupportedForInternalClassesException.php 0000644 00000001615 15243426620 0024406 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use function sprintf;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnnotationsAreNotSupportedForInternalClassesException extends RuntimeException implements Exception
{
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Annotations can only be parsed for user-defined classes, trying to parse annotations for class "%s"',
$className,
),
);
}
}
src/Metadata/Exception/InvalidVersionRequirementException.php 0000644 00000000622 15243426620 0020562 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use RuntimeException;
final class InvalidVersionRequirementException extends RuntimeException implements Exception
{
}
src/Metadata/Exception/Exception.php 0000644 00000000515 15243426620 0013465 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
interface Exception extends \PHPUnit\Exception
{
}
src/Metadata/Exception/ReflectionException.php 0000644 00000000773 15243426620 0015506 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
src/Metadata/Exception/NoVersionRequirementException.php 0000644 00000000615 15243426620 0017552 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use RuntimeException;
final class NoVersionRequirementException extends RuntimeException implements Exception
{
}
src/Metadata/Metadata.php 0000644 00000051316 15243426620 0011316 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Metadata
{
private const CLASS_LEVEL = 0;
private const METHOD_LEVEL = 1;
/**
* @psalm-var 0|1
*/
private readonly int $level;
public static function after(): After
{
return new After(self::METHOD_LEVEL);
}
public static function afterClass(): AfterClass
{
return new AfterClass(self::METHOD_LEVEL);
}
public static function backupGlobalsOnClass(bool $enabled): BackupGlobals
{
return new BackupGlobals(self::CLASS_LEVEL, $enabled);
}
public static function backupGlobalsOnMethod(bool $enabled): BackupGlobals
{
return new BackupGlobals(self::METHOD_LEVEL, $enabled);
}
public static function backupStaticPropertiesOnClass(bool $enabled): BackupStaticProperties
{
return new BackupStaticProperties(self::CLASS_LEVEL, $enabled);
}
public static function backupStaticPropertiesOnMethod(bool $enabled): BackupStaticProperties
{
return new BackupStaticProperties(self::METHOD_LEVEL, $enabled);
}
public static function before(): Before
{
return new Before(self::METHOD_LEVEL);
}
public static function beforeClass(): BeforeClass
{
return new BeforeClass(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
*/
public static function coversClass(string $className): CoversClass
{
return new CoversClass(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function coversFunction(string $functionName): CoversFunction
{
return new CoversFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $target
*/
public static function coversOnClass(string $target): Covers
{
return new Covers(self::CLASS_LEVEL, $target);
}
/**
* @psalm-param non-empty-string $target
*/
public static function coversOnMethod(string $target): Covers
{
return new Covers(self::METHOD_LEVEL, $target);
}
/**
* @psalm-param class-string $className
*/
public static function coversDefaultClass(string $className): CoversDefaultClass
{
return new CoversDefaultClass(self::CLASS_LEVEL, $className);
}
public static function coversNothingOnClass(): CoversNothing
{
return new CoversNothing(self::CLASS_LEVEL);
}
public static function coversNothingOnMethod(): CoversNothing
{
return new CoversNothing(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function dataProvider(string $className, string $methodName): DataProvider
{
return new DataProvider(self::METHOD_LEVEL, $className, $methodName);
}
/**
* @psalm-param class-string $className
*/
public static function dependsOnClass(string $className, bool $deepClone, bool $shallowClone): DependsOnClass
{
return new DependsOnClass(self::METHOD_LEVEL, $className, $deepClone, $shallowClone);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function dependsOnMethod(string $className, string $methodName, bool $deepClone, bool $shallowClone): DependsOnMethod
{
return new DependsOnMethod(self::METHOD_LEVEL, $className, $methodName, $deepClone, $shallowClone);
}
public static function doesNotPerformAssertionsOnClass(): DoesNotPerformAssertions
{
return new DoesNotPerformAssertions(self::CLASS_LEVEL);
}
public static function doesNotPerformAssertionsOnMethod(): DoesNotPerformAssertions
{
return new DoesNotPerformAssertions(self::METHOD_LEVEL);
}
/**
* @psalm-param non-empty-string $globalVariableName
*/
public static function excludeGlobalVariableFromBackupOnClass(string $globalVariableName): ExcludeGlobalVariableFromBackup
{
return new ExcludeGlobalVariableFromBackup(self::CLASS_LEVEL, $globalVariableName);
}
/**
* @psalm-param non-empty-string $globalVariableName
*/
public static function excludeGlobalVariableFromBackupOnMethod(string $globalVariableName): ExcludeGlobalVariableFromBackup
{
return new ExcludeGlobalVariableFromBackup(self::METHOD_LEVEL, $globalVariableName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public static function excludeStaticPropertyFromBackupOnClass(string $className, string $propertyName): ExcludeStaticPropertyFromBackup
{
return new ExcludeStaticPropertyFromBackup(self::CLASS_LEVEL, $className, $propertyName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public static function excludeStaticPropertyFromBackupOnMethod(string $className, string $propertyName): ExcludeStaticPropertyFromBackup
{
return new ExcludeStaticPropertyFromBackup(self::METHOD_LEVEL, $className, $propertyName);
}
/**
* @psalm-param non-empty-string $groupName
*/
public static function groupOnClass(string $groupName): Group
{
return new Group(self::CLASS_LEVEL, $groupName);
}
/**
* @psalm-param non-empty-string $groupName
*/
public static function groupOnMethod(string $groupName): Group
{
return new Group(self::METHOD_LEVEL, $groupName);
}
public static function ignoreDeprecationsOnClass(): IgnoreDeprecations
{
return new IgnoreDeprecations(self::CLASS_LEVEL);
}
public static function ignoreDeprecationsOnMethod(): IgnoreDeprecations
{
return new IgnoreDeprecations(self::METHOD_LEVEL);
}
/**
* @psalm-param class-string $className
*/
public static function ignoreClassForCodeCoverage(string $className): IgnoreClassForCodeCoverage
{
return new IgnoreClassForCodeCoverage(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function ignoreMethodForCodeCoverage(string $className, string $methodName): IgnoreMethodForCodeCoverage
{
return new IgnoreMethodForCodeCoverage(self::CLASS_LEVEL, $className, $methodName);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function ignoreFunctionForCodeCoverage(string $functionName): IgnoreFunctionForCodeCoverage
{
return new IgnoreFunctionForCodeCoverage(self::CLASS_LEVEL, $functionName);
}
public static function postCondition(): PostCondition
{
return new PostCondition(self::METHOD_LEVEL);
}
public static function preCondition(): PreCondition
{
return new PreCondition(self::METHOD_LEVEL);
}
public static function preserveGlobalStateOnClass(bool $enabled): PreserveGlobalState
{
return new PreserveGlobalState(self::CLASS_LEVEL, $enabled);
}
public static function preserveGlobalStateOnMethod(bool $enabled): PreserveGlobalState
{
return new PreserveGlobalState(self::METHOD_LEVEL, $enabled);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function requiresFunctionOnClass(string $functionName): RequiresFunction
{
return new RequiresFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function requiresFunctionOnMethod(string $functionName): RequiresFunction
{
return new RequiresFunction(self::METHOD_LEVEL, $functionName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function requiresMethodOnClass(string $className, string $methodName): RequiresMethod
{
return new RequiresMethod(self::CLASS_LEVEL, $className, $methodName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public static function requiresMethodOnMethod(string $className, string $methodName): RequiresMethod
{
return new RequiresMethod(self::METHOD_LEVEL, $className, $methodName);
}
/**
* @psalm-param non-empty-string $operatingSystem
*/
public static function requiresOperatingSystemOnClass(string $operatingSystem): RequiresOperatingSystem
{
return new RequiresOperatingSystem(self::CLASS_LEVEL, $operatingSystem);
}
/**
* @psalm-param non-empty-string $operatingSystem
*/
public static function requiresOperatingSystemOnMethod(string $operatingSystem): RequiresOperatingSystem
{
return new RequiresOperatingSystem(self::METHOD_LEVEL, $operatingSystem);
}
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public static function requiresOperatingSystemFamilyOnClass(string $operatingSystemFamily): RequiresOperatingSystemFamily
{
return new RequiresOperatingSystemFamily(self::CLASS_LEVEL, $operatingSystemFamily);
}
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public static function requiresOperatingSystemFamilyOnMethod(string $operatingSystemFamily): RequiresOperatingSystemFamily
{
return new RequiresOperatingSystemFamily(self::METHOD_LEVEL, $operatingSystemFamily);
}
public static function requiresPhpOnClass(Requirement $versionRequirement): RequiresPhp
{
return new RequiresPhp(self::CLASS_LEVEL, $versionRequirement);
}
public static function requiresPhpOnMethod(Requirement $versionRequirement): RequiresPhp
{
return new RequiresPhp(self::METHOD_LEVEL, $versionRequirement);
}
/**
* @psalm-param non-empty-string $extension
*/
public static function requiresPhpExtensionOnClass(string $extension, ?Requirement $versionRequirement): RequiresPhpExtension
{
return new RequiresPhpExtension(self::CLASS_LEVEL, $extension, $versionRequirement);
}
/**
* @psalm-param non-empty-string $extension
*/
public static function requiresPhpExtensionOnMethod(string $extension, ?Requirement $versionRequirement): RequiresPhpExtension
{
return new RequiresPhpExtension(self::METHOD_LEVEL, $extension, $versionRequirement);
}
public static function requiresPhpunitOnClass(Requirement $versionRequirement): RequiresPhpunit
{
return new RequiresPhpunit(self::CLASS_LEVEL, $versionRequirement);
}
public static function requiresPhpunitOnMethod(Requirement $versionRequirement): RequiresPhpunit
{
return new RequiresPhpunit(self::METHOD_LEVEL, $versionRequirement);
}
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public static function requiresSettingOnClass(string $setting, string $value): RequiresSetting
{
return new RequiresSetting(self::CLASS_LEVEL, $setting, $value);
}
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public static function requiresSettingOnMethod(string $setting, string $value): RequiresSetting
{
return new RequiresSetting(self::METHOD_LEVEL, $setting, $value);
}
public static function runClassInSeparateProcess(): RunClassInSeparateProcess
{
return new RunClassInSeparateProcess(self::CLASS_LEVEL);
}
public static function runTestsInSeparateProcesses(): RunTestsInSeparateProcesses
{
return new RunTestsInSeparateProcesses(self::CLASS_LEVEL);
}
public static function runInSeparateProcess(): RunInSeparateProcess
{
return new RunInSeparateProcess(self::METHOD_LEVEL);
}
public static function test(): Test
{
return new Test(self::METHOD_LEVEL);
}
/**
* @psalm-param non-empty-string $text
*/
public static function testDoxOnClass(string $text): TestDox
{
return new TestDox(self::CLASS_LEVEL, $text);
}
/**
* @psalm-param non-empty-string $text
*/
public static function testDoxOnMethod(string $text): TestDox
{
return new TestDox(self::METHOD_LEVEL, $text);
}
public static function testWith(array $data): TestWith
{
return new TestWith(self::METHOD_LEVEL, $data);
}
/**
* @psalm-param class-string $className
*/
public static function usesClass(string $className): UsesClass
{
return new UsesClass(self::CLASS_LEVEL, $className);
}
/**
* @psalm-param non-empty-string $functionName
*/
public static function usesFunction(string $functionName): UsesFunction
{
return new UsesFunction(self::CLASS_LEVEL, $functionName);
}
/**
* @psalm-param non-empty-string $target
*/
public static function usesOnClass(string $target): Uses
{
return new Uses(self::CLASS_LEVEL, $target);
}
/**
* @psalm-param non-empty-string $target
*/
public static function usesOnMethod(string $target): Uses
{
return new Uses(self::METHOD_LEVEL, $target);
}
/**
* @psalm-param class-string $className
*/
public static function usesDefaultClass(string $className): UsesDefaultClass
{
return new UsesDefaultClass(self::CLASS_LEVEL, $className);
}
public static function withoutErrorHandler(): WithoutErrorHandler
{
return new WithoutErrorHandler(self::METHOD_LEVEL);
}
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level)
{
$this->level = $level;
}
public function isClassLevel(): bool
{
return $this->level === self::CLASS_LEVEL;
}
public function isMethodLevel(): bool
{
return $this->level === self::METHOD_LEVEL;
}
/**
* @psalm-assert-if-true After $this
*/
public function isAfter(): bool
{
return false;
}
/**
* @psalm-assert-if-true AfterClass $this
*/
public function isAfterClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true BackupGlobals $this
*/
public function isBackupGlobals(): bool
{
return false;
}
/**
* @psalm-assert-if-true BackupStaticProperties $this
*/
public function isBackupStaticProperties(): bool
{
return false;
}
/**
* @psalm-assert-if-true BeforeClass $this
*/
public function isBeforeClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true Before $this
*/
public function isBefore(): bool
{
return false;
}
/**
* @psalm-assert-if-true Covers $this
*/
public function isCovers(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversClass $this
*/
public function isCoversClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversDefaultClass $this
*/
public function isCoversDefaultClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversFunction $this
*/
public function isCoversFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true CoversNothing $this
*/
public function isCoversNothing(): bool
{
return false;
}
/**
* @psalm-assert-if-true DataProvider $this
*/
public function isDataProvider(): bool
{
return false;
}
/**
* @psalm-assert-if-true DependsOnClass $this
*/
public function isDependsOnClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true DependsOnMethod $this
*/
public function isDependsOnMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true DoesNotPerformAssertions $this
*/
public function isDoesNotPerformAssertions(): bool
{
return false;
}
/**
* @psalm-assert-if-true ExcludeGlobalVariableFromBackup $this
*/
public function isExcludeGlobalVariableFromBackup(): bool
{
return false;
}
/**
* @psalm-assert-if-true ExcludeStaticPropertyFromBackup $this
*/
public function isExcludeStaticPropertyFromBackup(): bool
{
return false;
}
/**
* @psalm-assert-if-true Group $this
*/
public function isGroup(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreDeprecations $this
*/
public function isIgnoreDeprecations(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreClassForCodeCoverage $this
*/
public function isIgnoreClassForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreMethodForCodeCoverage $this
*/
public function isIgnoreMethodForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true IgnoreFunctionForCodeCoverage $this
*/
public function isIgnoreFunctionForCodeCoverage(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunClassInSeparateProcess $this
*/
public function isRunClassInSeparateProcess(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunInSeparateProcess $this
*/
public function isRunInSeparateProcess(): bool
{
return false;
}
/**
* @psalm-assert-if-true RunTestsInSeparateProcesses $this
*/
public function isRunTestsInSeparateProcesses(): bool
{
return false;
}
/**
* @psalm-assert-if-true Test $this
*/
public function isTest(): bool
{
return false;
}
/**
* @psalm-assert-if-true PreCondition $this
*/
public function isPreCondition(): bool
{
return false;
}
/**
* @psalm-assert-if-true PostCondition $this
*/
public function isPostCondition(): bool
{
return false;
}
/**
* @psalm-assert-if-true PreserveGlobalState $this
*/
public function isPreserveGlobalState(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresMethod $this
*/
public function isRequiresMethod(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresFunction $this
*/
public function isRequiresFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresOperatingSystem $this
*/
public function isRequiresOperatingSystem(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresOperatingSystemFamily $this
*/
public function isRequiresOperatingSystemFamily(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhp $this
*/
public function isRequiresPhp(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhpExtension $this
*/
public function isRequiresPhpExtension(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresPhpunit $this
*/
public function isRequiresPhpunit(): bool
{
return false;
}
/**
* @psalm-assert-if-true RequiresSetting $this
*/
public function isRequiresSetting(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestDox $this
*/
public function isTestDox(): bool
{
return false;
}
/**
* @psalm-assert-if-true TestWith $this
*/
public function isTestWith(): bool
{
return false;
}
/**
* @psalm-assert-if-true Uses $this
*/
public function isUses(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesClass $this
*/
public function isUsesClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesDefaultClass $this
*/
public function isUsesDefaultClass(): bool
{
return false;
}
/**
* @psalm-assert-if-true UsesFunction $this
*/
public function isUsesFunction(): bool
{
return false;
}
/**
* @psalm-assert-if-true WithoutErrorHandler $this
*/
public function isWithoutErrorHandler(): bool
{
return false;
}
}
src/Metadata/PostCondition.php 0000644 00000001137 15243426620 0012366 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PostCondition extends Metadata
{
/**
* @psalm-assert-if-true PostCondition $this
*/
public function isPostCondition(): bool
{
return true;
}
}
src/Metadata/PreserveGlobalState.php 0000644 00000001651 15243426620 0013510 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class PreserveGlobalState extends Metadata
{
private readonly bool $enabled;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, bool $enabled)
{
parent::__construct($level);
$this->enabled = $enabled;
}
/**
* @psalm-assert-if-true PreserveGlobalState $this
*/
public function isPreserveGlobalState(): bool
{
return true;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Metadata/Covers.php 0000644 00000002030 15243426620 0011024 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Covers extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $target;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $target
*/
protected function __construct(int $level, string $target)
{
parent::__construct($level);
$this->target = $target;
}
/**
* @psalm-assert-if-true Covers $this
*/
public function isCovers(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function target(): string
{
return $this->target;
}
}
src/Metadata/Parser/Registry.php 0000644 00000001655 15243426620 0012643 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
/**
* Attribute and annotation information is static within a single PHP process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Parser $instance = null;
public static function parser(): Parser
{
return self::$instance ?? self::$instance = self::build();
}
private static function build(): Parser
{
return new CachingParser(
new ParserChain(
new AttributeParser,
new AnnotationParser,
),
);
}
}
src/Metadata/Parser/CachingParser.php 0000644 00000004225 15243426620 0013540 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CachingParser implements Parser
{
private readonly Parser $reader;
private array $classCache = [];
private array $methodCache = [];
private array $classAndMethodCache = [];
public function __construct(Parser $reader)
{
$this->reader = $reader;
}
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
if (isset($this->classCache[$className])) {
return $this->classCache[$className];
}
$this->classCache[$className] = $this->reader->forClass($className);
return $this->classCache[$className];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$key = $className . '::' . $methodName;
if (isset($this->methodCache[$key])) {
return $this->methodCache[$key];
}
$this->methodCache[$key] = $this->reader->forMethod($className, $methodName);
return $this->methodCache[$key];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
$key = $className . '::' . $methodName;
if (isset($this->classAndMethodCache[$key])) {
return $this->classAndMethodCache[$key];
}
$this->classAndMethodCache[$key] = $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
return $this->classAndMethodCache[$key];
}
}
src/Metadata/Parser/Parser.php 0000644 00000001732 15243426620 0012263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Parser
{
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection;
}
src/Metadata/Parser/AnnotationParser.php 0000644 00000043203 15243426620 0014315 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use function array_merge;
use function assert;
use function count;
use function explode;
use function method_exists;
use function preg_replace;
use function rtrim;
use function str_contains;
use function str_starts_with;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Metadata\Annotation\Parser\Registry as AnnotationRegistry;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\ReflectionException;
use PHPUnit\Metadata\Version\ComparisonRequirement;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use PHPUnit\Util\InvalidVersionOperatorException;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnnotationParser implements Parser
{
/**
* @psalm-param class-string $className
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClass(string $className): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forClassName($className)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnClass($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnClass($this->stringToBool($values[0]));
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnClass($value);
}
break;
case 'coversDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::coversDefaultClass($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnClass();
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnClass();
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnClass($value);
}
break;
case 'large':
$result[] = Metadata::groupOnClass('large');
break;
case 'medium':
$result[] = Metadata::groupOnClass('medium');
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnClass($this->stringToBool($values[0]));
break;
case 'runClassInSeparateProcess':
$result[] = Metadata::runClassInSeparateProcess();
break;
case 'runTestsInSeparateProcesses':
$result[] = Metadata::runTestsInSeparateProcesses();
break;
case 'small':
$result[] = Metadata::groupOnClass('small');
break;
case 'testdox':
$result[] = Metadata::testDoxOnClass($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnClass($value);
}
break;
case 'usesDefaultClass':
foreach ($values as $value) {
$result[] = Metadata::usesDefaultClass($value);
}
break;
}
}
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forClassName($className)->requirements(),
'class',
),
);
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$result = [];
foreach (AnnotationRegistry::getInstance()->forMethod($className, $methodName)->symbolAnnotations() as $annotation => $values) {
switch ($annotation) {
case 'after':
$result[] = Metadata::after();
break;
case 'afterClass':
$result[] = Metadata::afterClass();
break;
case 'backupGlobals':
$result[] = Metadata::backupGlobalsOnMethod($this->stringToBool($values[0]));
break;
case 'backupStaticAttributes':
case 'backupStaticProperties':
$result[] = Metadata::backupStaticPropertiesOnMethod($this->stringToBool($values[0]));
break;
case 'before':
$result[] = Metadata::before();
break;
case 'beforeClass':
$result[] = Metadata::beforeClass();
break;
case 'covers':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::coversOnMethod($value);
}
break;
case 'coversNothing':
$result[] = Metadata::coversNothingOnMethod();
break;
case 'dataProvider':
foreach ($values as $value) {
$value = rtrim($value, " ()\n\r\t\v\x00");
if (str_contains($value, '::')) {
$result[] = Metadata::dataProvider(...explode('::', $value));
continue;
}
$result[] = Metadata::dataProvider($className, $value);
}
break;
case 'depends':
foreach ($values as $value) {
$deepClone = false;
$shallowClone = false;
if (str_starts_with($value, 'clone ')) {
$deepClone = true;
$value = substr($value, strlen('clone '));
} elseif (str_starts_with($value, '!clone ')) {
$value = substr($value, strlen('!clone '));
} elseif (str_starts_with($value, 'shallowClone ')) {
$shallowClone = true;
$value = substr($value, strlen('shallowClone '));
} elseif (str_starts_with($value, '!shallowClone ')) {
$value = substr($value, strlen('!shallowClone '));
}
if (str_contains($value, '::')) {
[$_className, $_methodName] = explode('::', $value);
assert($_className !== '');
assert($_methodName !== '');
if ($_methodName === 'class') {
$result[] = Metadata::dependsOnClass($_className, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($_className, $_methodName, $deepClone, $shallowClone);
continue;
}
$result[] = Metadata::dependsOnMethod($className, $value, $deepClone, $shallowClone);
}
break;
case 'doesNotPerformAssertions':
$result[] = Metadata::doesNotPerformAssertionsOnMethod();
break;
case 'excludeGlobalVariableFromBackup':
foreach ($values as $value) {
$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($value);
}
break;
case 'excludeStaticPropertyFromBackup':
foreach ($values as $value) {
$tmp = explode(' ', $value);
if (count($tmp) !== 2) {
continue;
}
$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
trim($tmp[0]),
trim($tmp[1]),
);
}
break;
case 'group':
case 'ticket':
foreach ($values as $value) {
$result[] = Metadata::groupOnMethod($value);
}
break;
case 'large':
$result[] = Metadata::groupOnMethod('large');
break;
case 'medium':
$result[] = Metadata::groupOnMethod('medium');
break;
case 'postCondition':
$result[] = Metadata::postCondition();
break;
case 'preCondition':
$result[] = Metadata::preCondition();
break;
case 'preserveGlobalState':
$result[] = Metadata::preserveGlobalStateOnMethod($this->stringToBool($values[0]));
break;
case 'runInSeparateProcess':
$result[] = Metadata::runInSeparateProcess();
break;
case 'small':
$result[] = Metadata::groupOnMethod('small');
break;
case 'test':
$result[] = Metadata::test();
break;
case 'testdox':
$result[] = Metadata::testDoxOnMethod($values[0]);
break;
case 'uses':
foreach ($values as $value) {
$value = $this->cleanUpCoversOrUsesTarget($value);
$result[] = Metadata::usesOnMethod($value);
}
break;
}
}
if (method_exists($className, $methodName)) {
$result = array_merge(
$result,
$this->parseRequirements(
AnnotationRegistry::getInstance()->forMethod($className, $methodName)->requirements(),
'method',
),
);
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws InvalidVersionOperatorException
* @throws ReflectionException
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
private function stringToBool(string $value): bool
{
if ($value === 'enabled') {
return true;
}
return false;
}
private function cleanUpCoversOrUsesTarget(string $value): string
{
$value = preg_replace('/[\s()]+$/', '', $value);
return explode(' ', $value, 2)[0];
}
/**
* @psalm-return list<Metadata>
*
* @throws InvalidVersionOperatorException
*/
private function parseRequirements(array $requirements, string $level): array
{
$result = [];
if (!empty($requirements['PHP'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHP']['version'],
new VersionComparisonOperator(empty($requirements['PHP']['operator']) ? '>=' : $requirements['PHP']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHP_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHP_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpOnMethod($versionRequirement);
}
}
if (!empty($requirements['extensions'])) {
foreach ($requirements['extensions'] as $extension) {
if (isset($requirements['extension_versions'][$extension])) {
continue;
}
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, null);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, null);
}
}
}
if (!empty($requirements['extension_versions'])) {
foreach ($requirements['extension_versions'] as $extension => $version) {
$versionRequirement = new ComparisonRequirement(
$version['version'],
new VersionComparisonOperator(empty($version['operator']) ? '>=' : $version['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpExtensionOnClass($extension, $versionRequirement);
} else {
$result[] = Metadata::requiresPhpExtensionOnMethod($extension, $versionRequirement);
}
}
}
if (!empty($requirements['PHPUnit'])) {
$versionRequirement = new ComparisonRequirement(
$requirements['PHPUnit']['version'],
new VersionComparisonOperator(empty($requirements['PHPUnit']['operator']) ? '>=' : $requirements['PHPUnit']['operator']),
);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
} elseif (!empty($requirements['PHPUnit_constraint'])) {
$versionRequirement = new ConstraintRequirement($requirements['PHPUnit_constraint']['constraint']);
if ($level === 'class') {
$result[] = Metadata::requiresPhpunitOnClass($versionRequirement);
} else {
$result[] = Metadata::requiresPhpunitOnMethod($versionRequirement);
}
}
if (!empty($requirements['OSFAMILY'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemFamilyOnClass($requirements['OSFAMILY']);
} else {
$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($requirements['OSFAMILY']);
}
}
if (!empty($requirements['OS'])) {
if ($level === 'class') {
$result[] = Metadata::requiresOperatingSystemOnClass($requirements['OS']);
} else {
$result[] = Metadata::requiresOperatingSystemOnMethod($requirements['OS']);
}
}
if (!empty($requirements['functions'])) {
foreach ($requirements['functions'] as $function) {
$pieces = explode('::', $function);
if (count($pieces) === 2) {
if ($level === 'class') {
$result[] = Metadata::requiresMethodOnClass($pieces[0], $pieces[1]);
} else {
$result[] = Metadata::requiresMethodOnMethod($pieces[0], $pieces[1]);
}
} elseif ($level === 'class') {
$result[] = Metadata::requiresFunctionOnClass($function);
} else {
$result[] = Metadata::requiresFunctionOnMethod($function);
}
}
}
if (!empty($requirements['setting'])) {
foreach ($requirements['setting'] as $setting => $value) {
if ($level === 'class') {
$result[] = Metadata::requiresSettingOnClass($setting, $value);
} else {
$result[] = Metadata::requiresSettingOnMethod($setting, $value);
}
}
}
return $result;
}
}
src/Metadata/Parser/AttributeParser.php 0000644 00000056163 15243426620 0014157 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use const JSON_THROW_ON_ERROR;
use function assert;
use function json_decode;
use function str_starts_with;
use PHPUnit\Framework\Attributes\After;
use PHPUnit\Framework\Attributes\AfterClass;
use PHPUnit\Framework\Attributes\BackupGlobals;
use PHPUnit\Framework\Attributes\BackupStaticProperties;
use PHPUnit\Framework\Attributes\Before;
use PHPUnit\Framework\Attributes\BeforeClass;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\CoversFunction;
use PHPUnit\Framework\Attributes\CoversNothing;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\DataProviderExternal;
use PHPUnit\Framework\Attributes\Depends;
use PHPUnit\Framework\Attributes\DependsExternal;
use PHPUnit\Framework\Attributes\DependsExternalUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsExternalUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsOnClass;
use PHPUnit\Framework\Attributes\DependsOnClassUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsOnClassUsingShallowClone;
use PHPUnit\Framework\Attributes\DependsUsingDeepClone;
use PHPUnit\Framework\Attributes\DependsUsingShallowClone;
use PHPUnit\Framework\Attributes\DoesNotPerformAssertions;
use PHPUnit\Framework\Attributes\ExcludeGlobalVariableFromBackup;
use PHPUnit\Framework\Attributes\ExcludeStaticPropertyFromBackup;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\IgnoreClassForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreDeprecations;
use PHPUnit\Framework\Attributes\IgnoreFunctionForCodeCoverage;
use PHPUnit\Framework\Attributes\IgnoreMethodForCodeCoverage;
use PHPUnit\Framework\Attributes\Large;
use PHPUnit\Framework\Attributes\Medium;
use PHPUnit\Framework\Attributes\PostCondition;
use PHPUnit\Framework\Attributes\PreCondition;
use PHPUnit\Framework\Attributes\PreserveGlobalState;
use PHPUnit\Framework\Attributes\RequiresFunction;
use PHPUnit\Framework\Attributes\RequiresMethod;
use PHPUnit\Framework\Attributes\RequiresOperatingSystem;
use PHPUnit\Framework\Attributes\RequiresOperatingSystemFamily;
use PHPUnit\Framework\Attributes\RequiresPhp;
use PHPUnit\Framework\Attributes\RequiresPhpExtension;
use PHPUnit\Framework\Attributes\RequiresPhpunit;
use PHPUnit\Framework\Attributes\RequiresSetting;
use PHPUnit\Framework\Attributes\RunClassInSeparateProcess;
use PHPUnit\Framework\Attributes\RunInSeparateProcess;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;
use PHPUnit\Framework\Attributes\Small;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\Attributes\TestDox;
use PHPUnit\Framework\Attributes\TestWith;
use PHPUnit\Framework\Attributes\TestWithJson;
use PHPUnit\Framework\Attributes\Ticket;
use PHPUnit\Framework\Attributes\UsesClass;
use PHPUnit\Framework\Attributes\UsesFunction;
use PHPUnit\Framework\Attributes\WithoutErrorHandler;
use PHPUnit\Metadata\Metadata;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Metadata\Version\ConstraintRequirement;
use ReflectionClass;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AttributeParser implements Parser
{
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
$result = [];
foreach ((new ReflectionClass($className))->getAttributes() as $attribute) {
if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
continue;
}
$attributeInstance = $attribute->newInstance();
switch ($attribute->getName()) {
case BackupGlobals::class:
assert($attributeInstance instanceof BackupGlobals);
$result[] = Metadata::backupGlobalsOnClass($attributeInstance->enabled());
break;
case BackupStaticProperties::class:
assert($attributeInstance instanceof BackupStaticProperties);
$result[] = Metadata::backupStaticPropertiesOnClass($attributeInstance->enabled());
break;
case CoversClass::class:
assert($attributeInstance instanceof CoversClass);
$result[] = Metadata::coversClass($attributeInstance->className());
break;
case CoversFunction::class:
assert($attributeInstance instanceof CoversFunction);
$result[] = Metadata::coversFunction($attributeInstance->functionName());
break;
case CoversNothing::class:
$result[] = Metadata::coversNothingOnClass();
break;
case DoesNotPerformAssertions::class:
$result[] = Metadata::doesNotPerformAssertionsOnClass();
break;
case ExcludeGlobalVariableFromBackup::class:
assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);
$result[] = Metadata::excludeGlobalVariableFromBackupOnClass($attributeInstance->globalVariableName());
break;
case ExcludeStaticPropertyFromBackup::class:
assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);
$result[] = Metadata::excludeStaticPropertyFromBackupOnClass(
$attributeInstance->className(),
$attributeInstance->propertyName(),
);
break;
case Group::class:
assert($attributeInstance instanceof Group);
$result[] = Metadata::groupOnClass($attributeInstance->name());
break;
case Large::class:
$result[] = Metadata::groupOnClass('large');
break;
case Medium::class:
$result[] = Metadata::groupOnClass('medium');
break;
case IgnoreClassForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreClassForCodeCoverage);
$result[] = Metadata::ignoreClassForCodeCoverage($attributeInstance->className());
break;
case IgnoreDeprecations::class:
assert($attributeInstance instanceof IgnoreDeprecations);
$result[] = Metadata::ignoreDeprecationsOnClass();
break;
case IgnoreMethodForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreMethodForCodeCoverage);
$result[] = Metadata::ignoreMethodForCodeCoverage($attributeInstance->className(), $attributeInstance->methodName());
break;
case IgnoreFunctionForCodeCoverage::class:
assert($attributeInstance instanceof IgnoreFunctionForCodeCoverage);
$result[] = Metadata::ignoreFunctionForCodeCoverage($attributeInstance->functionName());
break;
case PreserveGlobalState::class:
assert($attributeInstance instanceof PreserveGlobalState);
$result[] = Metadata::preserveGlobalStateOnClass($attributeInstance->enabled());
break;
case RequiresMethod::class:
assert($attributeInstance instanceof RequiresMethod);
$result[] = Metadata::requiresMethodOnClass(
$attributeInstance->className(),
$attributeInstance->methodName(),
);
break;
case RequiresFunction::class:
assert($attributeInstance instanceof RequiresFunction);
$result[] = Metadata::requiresFunctionOnClass($attributeInstance->functionName());
break;
case RequiresOperatingSystem::class:
assert($attributeInstance instanceof RequiresOperatingSystem);
$result[] = Metadata::requiresOperatingSystemOnClass($attributeInstance->regularExpression());
break;
case RequiresOperatingSystemFamily::class:
assert($attributeInstance instanceof RequiresOperatingSystemFamily);
$result[] = Metadata::requiresOperatingSystemFamilyOnClass($attributeInstance->operatingSystemFamily());
break;
case RequiresPhp::class:
assert($attributeInstance instanceof RequiresPhp);
$result[] = Metadata::requiresPhpOnClass(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresPhpExtension::class:
assert($attributeInstance instanceof RequiresPhpExtension);
$versionConstraint = null;
$versionRequirement = $attributeInstance->versionRequirement();
if ($versionRequirement !== null) {
$versionConstraint = ConstraintRequirement::from($versionRequirement);
}
$result[] = Metadata::requiresPhpExtensionOnClass(
$attributeInstance->extension(),
$versionConstraint,
);
break;
case RequiresPhpunit::class:
assert($attributeInstance instanceof RequiresPhpunit);
$result[] = Metadata::requiresPhpunitOnClass(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresSetting::class:
assert($attributeInstance instanceof RequiresSetting);
$result[] = Metadata::requiresSettingOnClass(
$attributeInstance->setting(),
$attributeInstance->value(),
);
break;
case RunClassInSeparateProcess::class:
$result[] = Metadata::runClassInSeparateProcess();
break;
case RunTestsInSeparateProcesses::class:
$result[] = Metadata::runTestsInSeparateProcesses();
break;
case Small::class:
$result[] = Metadata::groupOnClass('small');
break;
case TestDox::class:
assert($attributeInstance instanceof TestDox);
$result[] = Metadata::testDoxOnClass($attributeInstance->text());
break;
case Ticket::class:
assert($attributeInstance instanceof Ticket);
$result[] = Metadata::groupOnClass($attributeInstance->text());
break;
case UsesClass::class:
assert($attributeInstance instanceof UsesClass);
$result[] = Metadata::usesClass($attributeInstance->className());
break;
case UsesFunction::class:
assert($attributeInstance instanceof UsesFunction);
$result[] = Metadata::usesFunction($attributeInstance->functionName());
break;
}
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$result = [];
foreach ((new ReflectionMethod($className, $methodName))->getAttributes() as $attribute) {
if (!str_starts_with($attribute->getName(), 'PHPUnit\\Framework\\Attributes\\')) {
continue;
}
$attributeInstance = $attribute->newInstance();
switch ($attribute->getName()) {
case After::class:
$result[] = Metadata::after();
break;
case AfterClass::class:
$result[] = Metadata::afterClass();
break;
case BackupGlobals::class:
assert($attributeInstance instanceof BackupGlobals);
$result[] = Metadata::backupGlobalsOnMethod($attributeInstance->enabled());
break;
case BackupStaticProperties::class:
assert($attributeInstance instanceof BackupStaticProperties);
$result[] = Metadata::backupStaticPropertiesOnMethod($attributeInstance->enabled());
break;
case Before::class:
$result[] = Metadata::before();
break;
case BeforeClass::class:
$result[] = Metadata::beforeClass();
break;
case CoversNothing::class:
$result[] = Metadata::coversNothingOnMethod();
break;
case DataProvider::class:
assert($attributeInstance instanceof DataProvider);
$result[] = Metadata::dataProvider($className, $attributeInstance->methodName());
break;
case DataProviderExternal::class:
assert($attributeInstance instanceof DataProviderExternal);
$result[] = Metadata::dataProvider($attributeInstance->className(), $attributeInstance->methodName());
break;
case Depends::class:
assert($attributeInstance instanceof Depends);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, false);
break;
case DependsUsingDeepClone::class:
assert($attributeInstance instanceof DependsUsingDeepClone);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), true, false);
break;
case DependsUsingShallowClone::class:
assert($attributeInstance instanceof DependsUsingShallowClone);
$result[] = Metadata::dependsOnMethod($className, $attributeInstance->methodName(), false, true);
break;
case DependsExternal::class:
assert($attributeInstance instanceof DependsExternal);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, false);
break;
case DependsExternalUsingDeepClone::class:
assert($attributeInstance instanceof DependsExternalUsingDeepClone);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), true, false);
break;
case DependsExternalUsingShallowClone::class:
assert($attributeInstance instanceof DependsExternalUsingShallowClone);
$result[] = Metadata::dependsOnMethod($attributeInstance->className(), $attributeInstance->methodName(), false, true);
break;
case DependsOnClass::class:
assert($attributeInstance instanceof DependsOnClass);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, false);
break;
case DependsOnClassUsingDeepClone::class:
assert($attributeInstance instanceof DependsOnClassUsingDeepClone);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), true, false);
break;
case DependsOnClassUsingShallowClone::class:
assert($attributeInstance instanceof DependsOnClassUsingShallowClone);
$result[] = Metadata::dependsOnClass($attributeInstance->className(), false, true);
break;
case DoesNotPerformAssertions::class:
assert($attributeInstance instanceof DoesNotPerformAssertions);
$result[] = Metadata::doesNotPerformAssertionsOnMethod();
break;
case ExcludeGlobalVariableFromBackup::class:
assert($attributeInstance instanceof ExcludeGlobalVariableFromBackup);
$result[] = Metadata::excludeGlobalVariableFromBackupOnMethod($attributeInstance->globalVariableName());
break;
case ExcludeStaticPropertyFromBackup::class:
assert($attributeInstance instanceof ExcludeStaticPropertyFromBackup);
$result[] = Metadata::excludeStaticPropertyFromBackupOnMethod(
$attributeInstance->className(),
$attributeInstance->propertyName(),
);
break;
case Group::class:
assert($attributeInstance instanceof Group);
$result[] = Metadata::groupOnMethod($attributeInstance->name());
break;
case IgnoreDeprecations::class:
assert($attributeInstance instanceof IgnoreDeprecations);
$result[] = Metadata::ignoreDeprecationsOnMethod();
break;
case PostCondition::class:
$result[] = Metadata::postCondition();
break;
case PreCondition::class:
$result[] = Metadata::preCondition();
break;
case PreserveGlobalState::class:
assert($attributeInstance instanceof PreserveGlobalState);
$result[] = Metadata::preserveGlobalStateOnMethod($attributeInstance->enabled());
break;
case RequiresMethod::class:
assert($attributeInstance instanceof RequiresMethod);
$result[] = Metadata::requiresMethodOnMethod(
$attributeInstance->className(),
$attributeInstance->methodName(),
);
break;
case RequiresFunction::class:
assert($attributeInstance instanceof RequiresFunction);
$result[] = Metadata::requiresFunctionOnMethod($attributeInstance->functionName());
break;
case RequiresOperatingSystem::class:
assert($attributeInstance instanceof RequiresOperatingSystem);
$result[] = Metadata::requiresOperatingSystemOnMethod($attributeInstance->regularExpression());
break;
case RequiresOperatingSystemFamily::class:
assert($attributeInstance instanceof RequiresOperatingSystemFamily);
$result[] = Metadata::requiresOperatingSystemFamilyOnMethod($attributeInstance->operatingSystemFamily());
break;
case RequiresPhp::class:
assert($attributeInstance instanceof RequiresPhp);
$result[] = Metadata::requiresPhpOnMethod(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresPhpExtension::class:
assert($attributeInstance instanceof RequiresPhpExtension);
$versionConstraint = null;
$versionRequirement = $attributeInstance->versionRequirement();
if ($versionRequirement !== null) {
$versionConstraint = ConstraintRequirement::from($versionRequirement);
}
$result[] = Metadata::requiresPhpExtensionOnMethod(
$attributeInstance->extension(),
$versionConstraint,
);
break;
case RequiresPhpunit::class:
assert($attributeInstance instanceof RequiresPhpunit);
$result[] = Metadata::requiresPhpunitOnMethod(
ConstraintRequirement::from(
$attributeInstance->versionRequirement(),
),
);
break;
case RequiresSetting::class:
assert($attributeInstance instanceof RequiresSetting);
$result[] = Metadata::requiresSettingOnMethod(
$attributeInstance->setting(),
$attributeInstance->value(),
);
break;
case RunInSeparateProcess::class:
$result[] = Metadata::runInSeparateProcess();
break;
case Test::class:
$result[] = Metadata::test();
break;
case TestDox::class:
assert($attributeInstance instanceof TestDox);
$result[] = Metadata::testDoxOnMethod($attributeInstance->text());
break;
case TestWith::class:
assert($attributeInstance instanceof TestWith);
$result[] = Metadata::testWith($attributeInstance->data());
break;
case TestWithJson::class:
assert($attributeInstance instanceof TestWithJson);
$result[] = Metadata::testWith(json_decode($attributeInstance->json(), true, 512, JSON_THROW_ON_ERROR));
break;
case Ticket::class:
assert($attributeInstance instanceof Ticket);
$result[] = Metadata::groupOnMethod($attributeInstance->text());
break;
case WithoutErrorHandler::class:
assert($attributeInstance instanceof WithoutErrorHandler);
$result[] = Metadata::withoutErrorHandler();
break;
}
}
return MetadataCollection::fromArray($result);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
}
src/Metadata/Parser/ParserChain.php 0000644 00000003556 15243426620 0013234 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Parser;
use PHPUnit\Metadata\MetadataCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ParserChain implements Parser
{
private readonly Parser $attributeReader;
private readonly Parser $annotationReader;
public function __construct(Parser $attributeReader, Parser $annotationReader)
{
$this->attributeReader = $attributeReader;
$this->annotationReader = $annotationReader;
}
/**
* @psalm-param class-string $className
*/
public function forClass(string $className): MetadataCollection
{
$metadata = $this->attributeReader->forClass($className);
if (!$metadata->isEmpty()) {
return $metadata;
}
return $this->annotationReader->forClass($className);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forMethod(string $className, string $methodName): MetadataCollection
{
$metadata = $this->attributeReader->forMethod($className, $methodName);
if (!$metadata->isEmpty()) {
return $metadata;
}
return $this->annotationReader->forMethod($className, $methodName);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function forClassAndMethod(string $className, string $methodName): MetadataCollection
{
return $this->forClass($className)->mergeWith(
$this->forMethod($className, $methodName),
);
}
}
src/Metadata/Parser/Annotation/Registry.php 0000644 00000005516 15243426620 0014755 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Annotation\Parser;
use function array_key_exists;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\ReflectionException;
use ReflectionClass;
use ReflectionMethod;
/**
* Reflection information, and therefore DocBlock information, is static within
* a single PHP process. It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Registry $instance = null;
/**
* @psalm-var array<string, DocBlock> indexed by class name
*/
private array $classDocBlocks = [];
/**
* @psalm-var array<string, array<string, DocBlock>> indexed by class name and method name
*/
private array $methodDocBlocks = [];
public static function getInstance(): self
{
return self::$instance ?? self::$instance = new self;
}
/**
* @psalm-param class-string $class
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws ReflectionException
*/
public function forClassName(string $class): DocBlock
{
if (array_key_exists($class, $this->classDocBlocks)) {
return $this->classDocBlocks[$class];
}
try {
$reflection = new ReflectionClass($class);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $this->classDocBlocks[$class] = DocBlock::ofClass($reflection);
}
/**
* @psalm-param class-string $classInHierarchy
*
* @throws AnnotationsAreNotSupportedForInternalClassesException
* @throws ReflectionException
*/
public function forMethod(string $classInHierarchy, string $method): DocBlock
{
if (isset($this->methodDocBlocks[$classInHierarchy][$method])) {
return $this->methodDocBlocks[$classInHierarchy][$method];
}
try {
$reflection = new ReflectionMethod($classInHierarchy, $method);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $this->methodDocBlocks[$classInHierarchy][$method] = DocBlock::ofMethod($reflection);
}
}
src/Metadata/Parser/Annotation/DocBlock.php 0000644 00000022622 15243426620 0014622 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata\Annotation\Parser;
use function array_filter;
use function array_map;
use function array_merge;
use function array_values;
use function count;
use function preg_match;
use function preg_match_all;
use function preg_replace;
use function preg_split;
use function realpath;
use function substr;
use function trim;
use PharIo\Version\Exception as PharIoVersionException;
use PharIo\Version\VersionConstraintParser;
use PHPUnit\Metadata\AnnotationsAreNotSupportedForInternalClassesException;
use PHPUnit\Metadata\InvalidVersionRequirementException;
use ReflectionClass;
use ReflectionFunctionAbstract;
use ReflectionMethod;
/**
* This is an abstraction around a PHPUnit-specific docBlock,
* allowing us to ask meaningful questions about a specific
* reflection symbol.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DocBlock
{
private const REGEX_REQUIRES_VERSION = '/@requires\s+(?P<name>PHP(?:Unit)?)\s+(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+(dev|(RC|alpha|beta)[\d\.])?)[ \t]*\r?$/m';
private const REGEX_REQUIRES_VERSION_CONSTRAINT = '/@requires\s+(?P<name>PHP(?:Unit)?)\s+(?P<constraint>[\d\t \-.|~^]+)[ \t]*\r?$/m';
private const REGEX_REQUIRES_OS = '/@requires\s+(?P<name>OS(?:FAMILY)?)\s+(?P<value>.+?)[ \t]*\r?$/m';
private const REGEX_REQUIRES_SETTING = '/@requires\s+(?P<name>setting)\s+(?P<setting>([^ ]+?))\s*(?P<value>[\w\.-]+[\w\.]?)?[ \t]*\r?$/m';
private const REGEX_REQUIRES = '/@requires\s+(?P<name>function|extension)\s+(?P<value>([^\s<>=!]+))\s*(?P<operator>[<>=!]{0,2})\s*(?P<version>[\d\.-]+[\d\.]?)?[ \t]*\r?$/m';
private readonly string $docComment;
/**
* @psalm-var array<string, array<int, string>> pre-parsed annotations indexed by name and occurrence index
*/
private readonly array $symbolAnnotations;
/**
* @psalm-var null|(array{
* __OFFSET: array<string, int>&array{__FILE: string},
* setting?: array<string, string>,
* extension_versions?: array<string, array{version: string, operator: string}>
* }&array<
* string,
* string|array{version: string, operator: string}|array{constraint: string}|array<int|string, string>
* >)
*/
private ?array $parsedRequirements = null;
private readonly int $startLine;
private readonly string $fileName;
/**
* @throws AnnotationsAreNotSupportedForInternalClassesException
*/
public static function ofClass(ReflectionClass $class): self
{
if ($class->isInternal()) {
throw new AnnotationsAreNotSupportedForInternalClassesException($class->getName());
}
return new self(
(string) $class->getDocComment(),
self::extractAnnotationsFromReflector($class),
$class->getStartLine(),
$class->getFileName(),
);
}
/**
* @throws AnnotationsAreNotSupportedForInternalClassesException
*/
public static function ofMethod(ReflectionMethod $method): self
{
if ($method->getDeclaringClass()->isInternal()) {
throw new AnnotationsAreNotSupportedForInternalClassesException($method->getDeclaringClass()->getName());
}
return new self(
(string) $method->getDocComment(),
self::extractAnnotationsFromReflector($method),
$method->getStartLine(),
$method->getFileName(),
);
}
/**
* Note: we do not preserve an instance of the reflection object, since it cannot be safely (de-)serialized.
*
* @param array<string, array<int, string>> $symbolAnnotations
*/
private function __construct(string $docComment, array $symbolAnnotations, int $startLine, string $fileName)
{
$this->docComment = $docComment;
$this->symbolAnnotations = $symbolAnnotations;
$this->startLine = $startLine;
$this->fileName = $fileName;
}
/**
* @psalm-return array{
* __OFFSET: array<string, int>&array{__FILE: string},
* setting?: array<string, string>,
* extension_versions?: array<string, array{version: string, operator: string}>
* }&array<
* string,
* string|array{version: string, operator: string}|array{constraint: string}|array<int|string, string>
* >
*/
public function requirements(): array
{
if ($this->parsedRequirements !== null) {
return $this->parsedRequirements;
}
$offset = $this->startLine;
$requires = [];
$recordedSettings = [];
$extensionVersions = [];
$recordedOffsets = [
'__FILE' => realpath($this->fileName),
];
// Trim docblock markers, split it into lines and rewind offset to start of docblock
$lines = preg_replace(['#^/\*{2}#', '#\*/$#'], '', preg_split('/\r\n|\r|\n/', $this->docComment));
$offset -= count($lines);
foreach ($lines as $line) {
if (preg_match(self::REGEX_REQUIRES_OS, $line, $matches)) {
$requires[$matches['name']] = $matches['value'];
$recordedOffsets[$matches['name']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES_VERSION, $line, $matches)) {
$requires[$matches['name']] = [
'version' => $matches['version'],
'operator' => $matches['operator'],
];
$recordedOffsets[$matches['name']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES_VERSION_CONSTRAINT, $line, $matches)) {
if (!empty($requires[$matches['name']])) {
$offset++;
continue;
}
try {
$versionConstraintParser = new VersionConstraintParser;
$requires[$matches['name'] . '_constraint'] = [
'constraint' => $versionConstraintParser->parse(trim($matches['constraint'])),
];
$recordedOffsets[$matches['name'] . '_constraint'] = $offset;
} catch (PharIoVersionException $e) {
throw new InvalidVersionRequirementException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
if (preg_match(self::REGEX_REQUIRES_SETTING, $line, $matches)) {
$recordedSettings[$matches['setting']] = $matches['value'];
$recordedOffsets['__SETTING_' . $matches['setting']] = $offset;
}
if (preg_match(self::REGEX_REQUIRES, $line, $matches)) {
$name = $matches['name'] . 's';
if (!isset($requires[$name])) {
$requires[$name] = [];
}
$requires[$name][] = $matches['value'];
$recordedOffsets[$matches['name'] . '_' . $matches['value']] = $offset;
if ($name === 'extensions' && !empty($matches['version'])) {
$extensionVersions[$matches['value']] = [
'version' => $matches['version'],
'operator' => $matches['operator'],
];
}
}
$offset++;
}
return $this->parsedRequirements = array_merge(
$requires,
['__OFFSET' => $recordedOffsets],
array_filter(
[
'setting' => $recordedSettings,
'extension_versions' => $extensionVersions,
],
),
);
}
public function symbolAnnotations(): array
{
return $this->symbolAnnotations;
}
/**
* @psalm-return array<string, array<int, string>>
*/
private static function parseDocBlock(string $docBlock): array
{
// Strip away the docblock header and footer to ease parsing of one line annotations
$docBlock = substr($docBlock, 3, -2);
$annotations = [];
if (preg_match_all('/@(?P<name>[A-Za-z_-]+)(?:[ \t]+(?P<value>.*?))?[ \t]*\r?$/m', $docBlock, $matches)) {
$numMatches = count($matches[0]);
for ($i = 0; $i < $numMatches; $i++) {
$annotations[$matches['name'][$i]][] = $matches['value'][$i];
}
}
return $annotations;
}
private static function extractAnnotationsFromReflector(ReflectionClass|ReflectionFunctionAbstract $reflector): array
{
$annotations = [];
if ($reflector instanceof ReflectionClass) {
$annotations = array_merge(
$annotations,
...array_map(
static fn (ReflectionClass $trait): array => self::parseDocBlock((string) $trait->getDocComment()),
array_values($reflector->getTraits()),
),
);
}
return array_merge(
$annotations,
self::parseDocBlock((string) $reflector->getDocComment()),
);
}
}
src/Metadata/RequiresMethod.php 0000644 00000002623 15243426620 0012533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresMethod extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-assert-if-true RequiresMethod $this
*/
public function isRequiresMethod(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Metadata/IgnoreFunctionForCodeCoverage.php 0000644 00000002322 15243426620 0015436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
final class IgnoreFunctionForCodeCoverage extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true IgnoreFunctionForCodeCoverage $this
*/
public function isIgnoreFunctionForCodeCoverage(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Metadata/CoversDefaultClass.php 0000644 00000002105 15243426620 0013322 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversDefaultClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true CoversDefaultClass $this
*/
public function isCoversDefaultClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Metadata/TestWith.php 0000644 00000001571 15243426620 0011347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TestWith extends Metadata
{
private readonly array $data;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, array $data)
{
parent::__construct($level);
$this->data = $data;
}
/**
* @psalm-assert-if-true TestWith $this
*/
public function isTestWith(): bool
{
return true;
}
public function data(): array
{
return $this->data;
}
}
src/Metadata/RequiresPhpExtension.php 0000644 00000003370 15243426620 0013737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhpExtension extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $extension;
private readonly ?Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $extension
*/
protected function __construct(int $level, string $extension, ?Requirement $versionRequirement)
{
parent::__construct($level);
$this->extension = $extension;
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhpExtension $this
*/
public function isRequiresPhpExtension(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function extension(): string
{
return $this->extension;
}
/**
* @psalm-assert-if-true !null $this->versionRequirement
*/
public function hasVersionRequirement(): bool
{
return $this->versionRequirement !== null;
}
/**
* @throws NoVersionRequirementException
*/
public function versionRequirement(): Requirement
{
if ($this->versionRequirement === null) {
throw new NoVersionRequirementException;
}
return $this->versionRequirement;
}
}
src/Metadata/RequiresPhpunit.php 0000644 00000002037 15243426620 0012741 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhpunit extends Metadata
{
private readonly Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, Requirement $versionRequirement)
{
parent::__construct($level);
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhpunit $this
*/
public function isRequiresPhpunit(): bool
{
return true;
}
public function versionRequirement(): Requirement
{
return $this->versionRequirement;
}
}
src/Metadata/ExcludeStaticPropertyFromBackup.php 0000644 00000002726 15243426620 0016057 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeStaticPropertyFromBackup extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $propertyName;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
protected function __construct(int $level, string $className, string $propertyName)
{
parent::__construct($level);
$this->className = $className;
$this->propertyName = $propertyName;
}
/**
* @psalm-assert-if-true ExcludeStaticPropertyFromBackup $this
*/
public function isExcludeStaticPropertyFromBackup(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function propertyName(): string
{
return $this->propertyName;
}
}
src/Metadata/CoversFunction.php 0000644 00000002470 15243426620 0012542 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class CoversFunction extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $functionName
*/
protected function __construct(int $level, string $functionName)
{
parent::__construct($level);
$this->functionName = $functionName;
}
/**
* @psalm-assert-if-true CoversFunction $this
*/
public function isCoversFunction(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function asStringForCodeUnitMapper(): string
{
return '::' . $this->functionName;
}
}
src/Metadata/Uses.php 0000644 00000002022 15243426620 0010503 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Uses extends Metadata
{
/**
* @psalm-var non-empty-string
*/
private readonly string $target;
/**
* @psalm-param 0|1 $level
* @psalm-param non-empty-string $target
*/
protected function __construct(int $level, string $target)
{
parent::__construct($level);
$this->target = $target;
}
/**
* @psalm-assert-if-true Uses $this
*/
public function isUses(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function target(): string
{
return $this->target;
}
}
src/Metadata/RequiresPhp.php 0000644 00000002023 15243426620 0012034 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
use PHPUnit\Metadata\Version\Requirement;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RequiresPhp extends Metadata
{
private readonly Requirement $versionRequirement;
/**
* @psalm-param 0|1 $level
*/
protected function __construct(int $level, Requirement $versionRequirement)
{
parent::__construct($level);
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-assert-if-true RequiresPhp $this
*/
public function isRequiresPhp(): bool
{
return true;
}
public function versionRequirement(): Requirement
{
return $this->versionRequirement;
}
}
src/Metadata/UsesDefaultClass.php 0000644 00000002077 15243426620 0013010 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class UsesDefaultClass extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
*/
protected function __construct(int $level, string $className)
{
parent::__construct($level);
$this->className = $className;
}
/**
* @psalm-assert-if-true UsesDefaultClass $this
*/
public function isUsesDefaultClass(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Metadata/DependsOnMethod.php 0000644 00000003423 15243426620 0012612 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Metadata;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DependsOnMethod extends Metadata
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly bool $deepClone;
private readonly bool $shallowClone;
/**
* @psalm-param 0|1 $level
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
protected function __construct(int $level, string $className, string $methodName, bool $deepClone, bool $shallowClone)
{
parent::__construct($level);
$this->className = $className;
$this->methodName = $methodName;
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
}
/**
* @psalm-assert-if-true DependsOnMethod $this
*/
public function isDependsOnMethod(): bool
{
return true;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
}
src/TextUI/ShellExitCodeCalculator.php 0000644 00000003754 15243426620 0013751 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use PHPUnit\TestRunner\TestResult\TestResult;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShellExitCodeCalculator
{
private const SUCCESS_EXIT = 0;
private const FAILURE_EXIT = 1;
private const EXCEPTION_EXIT = 2;
public function calculate(bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, TestResult $result): int
{
$returnCode = self::FAILURE_EXIT;
if ($result->wasSuccessful()) {
$returnCode = self::SUCCESS_EXIT;
}
if ($failOnEmptyTestSuite && !$result->hasTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($result->wasSuccessfulIgnoringPhpunitWarnings()) {
if ($failOnDeprecation && $result->hasDeprecations()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnIncomplete && $result->hasIncompleteTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnNotice && $result->hasNotices()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnRisky && $result->hasRiskyTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnSkipped && $result->hasSkippedTests()) {
$returnCode = self::FAILURE_EXIT;
}
if ($failOnWarning && $result->hasWarnings()) {
$returnCode = self::FAILURE_EXIT;
}
}
if ($result->hasErrors()) {
$returnCode = self::EXCEPTION_EXIT;
}
return $returnCode;
}
}
src/TextUI/Command/Command.php 0000644 00000000676 15243426620 0012177 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Command
{
public function execute(): Result;
}
src/TextUI/Command/Result.php 0000644 00000002161 15243426620 0012066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Result
{
public const SUCCESS = 0;
public const FAILURE = 1;
public const EXCEPTION = 2;
public const CRASH = 255;
private readonly string $output;
private readonly int $shellExitCode;
public static function from(string $output = '', int $shellExitCode = self::SUCCESS): self
{
return new self($output, $shellExitCode);
}
private function __construct(string $output, int $shellExitCode)
{
$this->output = $output;
$this->shellExitCode = $shellExitCode;
}
public function output(): string
{
return $this->output;
}
public function shellExitCode(): int
{
return $this->shellExitCode;
}
}
src/TextUI/Command/Commands/GenerateConfigurationCommand.php 0000644 00000004401 15243426620 0020131 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function fgets;
use function file_put_contents;
use function getcwd;
use function trim;
use PHPUnit\Runner\Version;
use PHPUnit\TextUI\XmlConfiguration\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GenerateConfigurationCommand implements Command
{
public function execute(): Result
{
print 'Generating phpunit.xml in ' . getcwd() . PHP_EOL . PHP_EOL;
print 'Bootstrap script (relative to path shown above; default: vendor/autoload.php): ';
$bootstrapScript = $this->read();
print 'Tests directory (relative to path shown above; default: tests): ';
$testsDirectory = $this->read();
print 'Source directory (relative to path shown above; default: src): ';
$src = $this->read();
print 'Cache directory (relative to path shown above; default: .phpunit.cache): ';
$cacheDirectory = $this->read();
if ($bootstrapScript === '') {
$bootstrapScript = 'vendor/autoload.php';
}
if ($testsDirectory === '') {
$testsDirectory = 'tests';
}
if ($src === '') {
$src = 'src';
}
if ($cacheDirectory === '') {
$cacheDirectory = '.phpunit.cache';
}
$generator = new Generator;
file_put_contents(
'phpunit.xml',
$generator->generateDefaultConfiguration(
Version::series(),
$bootstrapScript,
$testsDirectory,
$src,
$cacheDirectory,
),
);
/* @noinspection MissingDirectorySeparatorInspection */
print PHP_EOL . 'Generated phpunit.xml in ' . getcwd() . '.' . PHP_EOL;
print 'Make sure to exclude the ' . $cacheDirectory . ' directory from version control.' . PHP_EOL;
return Result::from();
}
private function read(): string
{
return trim(fgets(STDIN));
}
}
src/TextUI/Command/Commands/ShowVersionCommand.php 0000644 00000001010 15243426620 0016126 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShowVersionCommand implements Command
{
public function execute(): Result
{
return Result::from();
}
}
src/TextUI/Command/Commands/VersionCheckCommand.php 0000644 00000003404 15243426620 0016234 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function file_get_contents;
use function sprintf;
use function version_compare;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class VersionCheckCommand implements Command
{
public function execute(): Result
{
$latestVersion = file_get_contents('https://phar.phpunit.de/latest-version-of/phpunit');
$latestCompatibleVersion = file_get_contents('https://phar.phpunit.de/latest-version-of/phpunit-' . Version::majorVersionNumber());
$notLatest = version_compare($latestVersion, Version::id(), '>');
$notLatestCompatible = version_compare($latestCompatibleVersion, Version::id(), '>');
if (!$notLatest && !$notLatestCompatible) {
return Result::from(
'You are using the latest version of PHPUnit.' . PHP_EOL,
);
}
$buffer = 'You are not using the latest version of PHPUnit.' . PHP_EOL;
if ($notLatestCompatible) {
$buffer .= sprintf(
'The latest version compatible with PHPUnit %s is PHPUnit %s.' . PHP_EOL,
Version::id(),
$latestCompatibleVersion,
);
}
if ($notLatest) {
$buffer .= sprintf(
'The latest version is PHPUnit %s.' . PHP_EOL,
$latestVersion,
);
}
return Result::from($buffer);
}
}
src/TextUI/Command/Commands/WarmCodeCoverageCacheCommand.php 0000644 00000004650 15243426620 0017756 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use const PHP_EOL;
use function printf;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\NoCoverageCacheDirectoryException;
use SebastianBergmann\CodeCoverage\StaticAnalysis\CacheWarmer;
use SebastianBergmann\Timer\NoActiveTimerException;
use SebastianBergmann\Timer\Timer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class WarmCodeCoverageCacheCommand implements Command
{
private readonly Configuration $configuration;
private readonly CodeCoverageFilterRegistry $codeCoverageFilterRegistry;
public function __construct(Configuration $configuration, CodeCoverageFilterRegistry $codeCoverageFilterRegistry)
{
$this->configuration = $configuration;
$this->codeCoverageFilterRegistry = $codeCoverageFilterRegistry;
}
/**
* @throws NoActiveTimerException
* @throws NoCoverageCacheDirectoryException
*/
public function execute(): Result
{
if (!$this->configuration->hasCoverageCacheDirectory()) {
return Result::from(
'Cache for static analysis has not been configured' . PHP_EOL,
Result::FAILURE,
);
}
$this->codeCoverageFilterRegistry->init($this->configuration, true);
if (!$this->codeCoverageFilterRegistry->configured()) {
return Result::from(
'Filter for code coverage has not been configured' . PHP_EOL,
Result::FAILURE,
);
}
$timer = new Timer;
$timer->start();
print 'Warming cache for static analysis ... ';
(new CacheWarmer)->warmCache(
$this->configuration->coverageCacheDirectory(),
!$this->configuration->disableCodeCoverageIgnore(),
$this->configuration->ignoreDeprecatedCodeUnitsFromCodeCoverage(),
$this->codeCoverageFilterRegistry->get(),
);
printf(
'[%s]%s',
$timer->stop()->asString(),
PHP_EOL,
);
return Result::from();
}
}
src/TextUI/Command/Commands/ListTestsAsXmlCommand.php 0000644 00000010122 15243426620 0016547 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function file_put_contents;
use function implode;
use function sprintf;
use function str_replace;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\TextUI\Configuration\Registry;
use RecursiveIteratorIterator;
use XMLWriter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestsAsXmlCommand implements Command
{
private readonly string $filename;
private readonly TestSuite $suite;
public function __construct(string $filename, TestSuite $suite)
{
$this->filename = $filename;
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$writer = new XMLWriter;
$writer->openMemory();
$writer->setIndent(true);
$writer->startDocument();
$writer->startElement('tests');
$currentTestCase = null;
foreach (new RecursiveIteratorIterator($this->suite) as $test) {
if ($test instanceof TestCase) {
if ($test::class !== $currentTestCase) {
if ($currentTestCase !== null) {
$writer->endElement();
}
$writer->startElement('testCaseClass');
$writer->writeAttribute('name', $test::class);
$currentTestCase = $test::class;
}
$writer->startElement('testCaseMethod');
$writer->writeAttribute('id', $test->valueObjectForEvents()->id());
$writer->writeAttribute('name', $test->name());
$writer->writeAttribute('groups', implode(',', $test->groups()));
/**
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5481
*/
if (!empty($test->dataSetAsString())) {
$writer->writeAttribute(
'dataSet',
str_replace(
' with data set ',
'',
$test->dataSetAsString(),
),
);
}
$writer->endElement();
continue;
}
if ($test instanceof PhptTestCase) {
if ($currentTestCase !== null) {
$writer->endElement();
$currentTestCase = null;
}
$writer->startElement('phptFile');
$writer->writeAttribute('path', $test->getName());
$writer->endElement();
}
}
if ($currentTestCase !== null) {
$writer->endElement();
}
$writer->endElement();
file_put_contents($this->filename, $writer->outputMemory());
$buffer .= sprintf(
'Wrote list of tests that would have been run to %s' . PHP_EOL,
$this->filename,
);
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-tests-xml options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-tests-xml options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-tests-xml options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
src/TextUI/Command/Commands/ListTestSuitesCommand.php 0000644 00000003776 15243426620 0016635 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sprintf;
use PHPUnit\TextUI\Configuration\Registry;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestSuitesCommand implements Command
{
private readonly TestSuiteCollection $suites;
public function __construct(TestSuiteCollection $suites)
{
$this->suites = $suites;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test suite(s):' . PHP_EOL;
foreach ($this->suites as $suite) {
$buffer .= sprintf(
' - %s' . PHP_EOL,
$suite->name(),
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-suites options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-suites options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-suites options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if ($configuration->includeTestSuite() !== '') {
$buffer .= 'The --testsuite and --list-suites options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
src/TextUI/Command/Commands/AtLeastVersionCommand.php 0000644 00000001523 15243426620 0016554 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function version_compare;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AtLeastVersionCommand implements Command
{
private readonly string $version;
public function __construct(string $version)
{
$this->version = $version;
}
public function execute(): Result
{
if (version_compare(Version::id(), $this->version, '>=')) {
return Result::from();
}
return Result::from('', Result::FAILURE);
}
}
src/TextUI/Command/Commands/ShowHelpCommand.php 0000644 00000001410 15243426620 0015375 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use PHPUnit\TextUI\Help;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ShowHelpCommand implements Command
{
private readonly int $shellExitCode;
public function __construct(int $shellExitCode)
{
$this->shellExitCode = $shellExitCode;
}
public function execute(): Result
{
return Result::from(
(new Help)->generate(),
$this->shellExitCode,
);
}
}
src/TextUI/Command/Commands/MigrateConfigurationCommand.php 0000644 00000003146 15243426620 0017774 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function copy;
use function file_put_contents;
use function sprintf;
use PHPUnit\TextUI\XmlConfiguration\Migrator;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrateConfigurationCommand implements Command
{
private readonly string $filename;
public function __construct(string $filename)
{
$this->filename = $filename;
}
public function execute(): Result
{
try {
$migrated = (new Migrator)->migrate($this->filename);
copy($this->filename, $this->filename . '.bak');
file_put_contents($this->filename, $migrated);
return Result::from(
sprintf(
'Created backup: %s.bak%sMigrated configuration: %s%s',
$this->filename,
PHP_EOL,
$this->filename,
PHP_EOL,
),
);
} catch (Throwable $t) {
return Result::from(
sprintf(
'Migration of %s failed:%s%s%s',
$this->filename,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
),
Result::FAILURE,
);
}
}
}
src/TextUI/Command/Commands/ListTestsAsTextCommand.php 0000644 00000004451 15243426620 0016743 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sprintf;
use function str_replace;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\TextUI\Configuration\Registry;
use RecursiveIteratorIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListTestsAsTextCommand implements Command
{
private readonly TestSuite $suite;
public function __construct(TestSuite $suite)
{
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test(s):' . PHP_EOL;
foreach (new RecursiveIteratorIterator($this->suite) as $test) {
if ($test instanceof TestCase) {
$name = sprintf(
'%s::%s',
$test::class,
str_replace(' with data set ', '', $test->nameWithDataSet()),
);
} elseif ($test instanceof PhptTestCase) {
$name = $test->getName();
} else {
continue;
}
$buffer .= sprintf(
' - %s' . PHP_EOL,
$name,
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-tests options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-tests options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-tests options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
src/TextUI/Command/Commands/ListGroupsCommand.php 0000644 00000004224 15243426620 0015765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Command;
use function sort;
use function sprintf;
use function str_starts_with;
use PHPUnit\Framework\TestSuite;
use PHPUnit\TextUI\Configuration\Registry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ListGroupsCommand implements Command
{
private readonly TestSuite $suite;
public function __construct(TestSuite $suite)
{
$this->suite = $suite;
}
public function execute(): Result
{
$buffer = $this->warnAboutConflictingOptions();
$buffer .= 'Available test group(s):' . PHP_EOL;
$groups = $this->suite->groups();
sort($groups);
foreach ($groups as $group) {
if (str_starts_with($group, '__phpunit_')) {
continue;
}
$buffer .= sprintf(
' - %s' . PHP_EOL,
$group,
);
}
return Result::from($buffer);
}
private function warnAboutConflictingOptions(): string
{
$buffer = '';
$configuration = Registry::get();
if ($configuration->hasFilter()) {
$buffer .= 'The --filter and --list-groups options cannot be combined, --filter is ignored' . PHP_EOL;
}
if ($configuration->hasGroups()) {
$buffer .= 'The --group and --list-groups options cannot be combined, --group is ignored' . PHP_EOL;
}
if ($configuration->hasExcludeGroups()) {
$buffer .= 'The --exclude-group and --list-groups options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if ($configuration->includeTestSuite() !== '') {
$buffer .= 'The --testsuite and --list-groups options cannot be combined, --exclude-group is ignored' . PHP_EOL;
}
if (!empty($buffer)) {
$buffer .= PHP_EOL;
}
return $buffer;
}
}
src/TextUI/TestRunner.php 0000644 00000004600 15243426620 0011343 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function mt_srand;
use PHPUnit\Event;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\ResultCache\ResultCache;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\Configuration\Configuration;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunner
{
/**
* @throws RuntimeException
*/
public function run(Configuration $configuration, ResultCache $resultCache, TestSuite $suite): void
{
try {
Event\Facade::emitter()->testRunnerStarted();
if ($configuration->executionOrder() === TestSuiteSorter::ORDER_RANDOMIZED) {
mt_srand($configuration->randomOrderSeed());
}
if ($configuration->executionOrder() !== TestSuiteSorter::ORDER_DEFAULT ||
$configuration->executionOrderDefects() !== TestSuiteSorter::ORDER_DEFAULT ||
$configuration->resolveDependencies()) {
$resultCache->load();
(new TestSuiteSorter($resultCache))->reorderTestsInSuite(
$suite,
$configuration->executionOrder(),
$configuration->resolveDependencies(),
$configuration->executionOrderDefects(),
);
Event\Facade::emitter()->testSuiteSorted(
$configuration->executionOrder(),
$configuration->executionOrderDefects(),
$configuration->resolveDependencies(),
);
}
(new TestSuiteFilterProcessor)->process($configuration, $suite);
Event\Facade::emitter()->testRunnerExecutionStarted(
Event\TestSuite\TestSuiteBuilder::from($suite),
);
$suite->run();
Event\Facade::emitter()->testRunnerExecutionFinished();
Event\Facade::emitter()->testRunnerFinished();
} catch (Throwable $t) {
throw new RuntimeException(
$t->getMessage(),
(int) $t->getCode(),
$t,
);
}
}
}
src/TextUI/Help.php 0000644 00000036727 15243426620 0010141 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use const PHP_EOL;
use function count;
use function defined;
use function explode;
use function max;
use function preg_replace_callback;
use function str_pad;
use function str_repeat;
use function strlen;
use function wordwrap;
use PHPUnit\Util\Color;
use SebastianBergmann\Environment\Console;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Help
{
private const LEFT_MARGIN = ' ';
private int $lengthOfLongestOptionName = 0;
private readonly int $columnsAvailableForDescription;
private ?bool $hasColor;
public function __construct(?int $width = null, ?bool $withColor = null)
{
if ($width === null) {
$width = (new Console)->getNumberOfColumns();
}
if ($withColor === null) {
$this->hasColor = (new Console)->hasColorSupport();
} else {
$this->hasColor = $withColor;
}
foreach ($this->elements() as $options) {
foreach ($options as $option) {
if (isset($option['arg'])) {
$this->lengthOfLongestOptionName = max($this->lengthOfLongestOptionName, strlen($option['arg']));
}
}
}
$this->columnsAvailableForDescription = $width - $this->lengthOfLongestOptionName - 4;
}
public function generate(): string
{
if ($this->hasColor) {
return $this->writeWithColor();
}
return $this->writeWithoutColor();
}
private function writeWithoutColor(): string
{
$buffer = '';
foreach ($this->elements() as $section => $options) {
$buffer .= "{$section}:" . PHP_EOL;
if ($section !== 'Usage') {
$buffer .= PHP_EOL;
}
foreach ($options as $option) {
if (isset($option['spacer'])) {
$buffer .= PHP_EOL;
}
if (isset($option['text'])) {
$buffer .= self::LEFT_MARGIN . $option['text'] . PHP_EOL;
}
if (isset($option['arg'])) {
$arg = str_pad($option['arg'], $this->lengthOfLongestOptionName);
$buffer .= self::LEFT_MARGIN . $arg . ' ' . $option['desc'] . PHP_EOL;
}
}
$buffer .= PHP_EOL;
}
return $buffer;
}
private function writeWithColor(): string
{
$buffer = '';
foreach ($this->elements() as $section => $options) {
$buffer .= Color::colorize('fg-yellow', "{$section}:") . PHP_EOL;
if ($section !== 'Usage') {
$buffer .= PHP_EOL;
}
foreach ($options as $option) {
if (isset($option['spacer'])) {
$buffer .= PHP_EOL;
}
if (isset($option['text'])) {
$buffer .= self::LEFT_MARGIN . $option['text'] . PHP_EOL;
}
if (isset($option['arg'])) {
$arg = Color::colorize('fg-green', str_pad($option['arg'], $this->lengthOfLongestOptionName));
$arg = preg_replace_callback(
'/(<[^>]+>)/',
static fn ($matches) => Color::colorize('fg-cyan', $matches[0]),
$arg,
);
$desc = explode(PHP_EOL, wordwrap($option['desc'], $this->columnsAvailableForDescription, PHP_EOL));
$buffer .= self::LEFT_MARGIN . $arg . ' ' . $desc[0] . PHP_EOL;
for ($i = 1; $i < count($desc); $i++) {
$buffer .= str_repeat(' ', $this->lengthOfLongestOptionName + 3) . $desc[$i] . PHP_EOL;
}
}
}
$buffer .= PHP_EOL;
}
return $buffer;
}
/**
* @psalm-return array<non-empty-string, non-empty-list<array{text: non-empty-string}|array{arg: non-empty-string, desc: non-empty-string}|array{spacer: ''}>>
*/
private function elements(): array
{
$elements = [
'Usage' => [
['text' => 'phpunit [options] <directory|file> ...'],
],
'Configuration' => [
['arg' => '--bootstrap <file>', 'desc' => 'A PHP script that is included before the tests run'],
['arg' => '-c|--configuration <file>', 'desc' => 'Read configuration from XML file'],
['arg' => '--no-configuration', 'desc' => 'Ignore default configuration file (phpunit.xml)'],
['arg' => '--no-extensions', 'desc' => 'Do not load PHPUnit extensions'],
['arg' => '--include-path <path(s)>', 'desc' => 'Prepend PHP\'s include_path with given path(s)'],
['arg' => '-d <key[=value]>', 'desc' => 'Sets a php.ini value'],
['arg' => '--cache-directory <dir>', 'desc' => 'Specify cache directory'],
['arg' => '--generate-configuration', 'desc' => 'Generate configuration file with suggested settings'],
['arg' => '--migrate-configuration', 'desc' => 'Migrate configuration file to current format'],
['arg' => '--generate-baseline <file>', 'desc' => 'Generate baseline for issues'],
['arg' => '--use-baseline <file>', 'desc' => 'Use baseline to ignore issues'],
['arg' => '--ignore-baseline', 'desc' => 'Do not use baseline to ignore issues'],
],
'Selection' => [
['arg' => '--list-suites', 'desc' => 'List available test suites'],
['arg' => '--testsuite <name>', 'desc' => 'Only run tests from the specified test suite(s)'],
['arg' => '--exclude-testsuite <name>', 'desc' => 'Exclude tests from the specified test suite(s)'],
['arg' => '--list-groups', 'desc' => 'List available test groups'],
['arg' => '--group <name>', 'desc' => 'Only run tests from the specified group(s)'],
['arg' => '--exclude-group <name>', 'desc' => 'Exclude tests from the specified group(s)'],
['arg' => '--covers <name>', 'desc' => 'Only run tests that intend to cover <name>'],
['arg' => '--uses <name>', 'desc' => 'Only run tests that intend to use <name>'],
['arg' => '--list-tests', 'desc' => 'List available tests'],
['arg' => '--list-tests-xml <file>', 'desc' => 'List available tests in XML format'],
['arg' => '--filter <pattern>', 'desc' => 'Filter which tests to run'],
['arg' => '--test-suffix <suffixes>', 'desc' => 'Only search for test in files with specified suffix(es). Default: Test.php,.phpt'],
],
'Execution' => [
['arg' => '--process-isolation', 'desc' => 'Run each test in a separate PHP process'],
['arg' => '--globals-backup', 'desc' => 'Backup and restore $GLOBALS for each test'],
['arg' => '--static-backup', 'desc' => 'Backup and restore static properties for each test'],
['spacer' => ''],
['arg' => '--strict-coverage', 'desc' => 'Be strict about code coverage metadata'],
['arg' => '--strict-global-state', 'desc' => 'Be strict about changes to global state'],
['arg' => '--disallow-test-output', 'desc' => 'Be strict about output during tests'],
['arg' => '--enforce-time-limit', 'desc' => 'Enforce time limit based on test size'],
['arg' => '--default-time-limit <sec>', 'desc' => 'Timeout in seconds for tests that have no declared size'],
['arg' => '--dont-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
['spacer' => ''],
['arg' => '--stop-on-defect', 'desc' => 'Stop after first error, failure, warning, or risky test'],
['arg' => '--stop-on-error', 'desc' => 'Stop after first error'],
['arg' => '--stop-on-failure', 'desc' => 'Stop after first failure'],
['arg' => '--stop-on-warning', 'desc' => 'Stop after first warning'],
['arg' => '--stop-on-risky', 'desc' => 'Stop after first risky test'],
['arg' => '--stop-on-deprecation', 'desc' => 'Stop after first test that triggered a deprecation'],
['arg' => '--stop-on-notice', 'desc' => 'Stop after first test that triggered a notice'],
['arg' => '--stop-on-skipped', 'desc' => 'Stop after first skipped test'],
['arg' => '--stop-on-incomplete', 'desc' => 'Stop after first incomplete test'],
['spacer' => ''],
['arg' => '--fail-on-empty-test-suite', 'desc' => 'Signal failure using shell exit code when no tests were run'],
['arg' => '--fail-on-warning', 'desc' => 'Signal failure using shell exit code when a warning was triggered'],
['arg' => '--fail-on-risky', 'desc' => 'Signal failure using shell exit code when a test was considered risky'],
['arg' => '--fail-on-deprecation', 'desc' => 'Signal failure using shell exit code when a deprecation was triggered'],
['arg' => '--fail-on-notice', 'desc' => 'Signal failure using shell exit code when a notice was triggered'],
['arg' => '--fail-on-skipped', 'desc' => 'Signal failure using shell exit code when a test was skipped'],
['arg' => '--fail-on-incomplete', 'desc' => 'Signal failure using shell exit code when a test was marked incomplete'],
['spacer' => ''],
['arg' => '--cache-result', 'desc' => 'Write test results to cache file'],
['arg' => '--do-not-cache-result', 'desc' => 'Do not write test results to cache file'],
['spacer' => ''],
['arg' => '--order-by <order>', 'desc' => 'Run tests in order: default|defects|depends|duration|no-depends|random|reverse|size'],
['arg' => '--random-order-seed <N>', 'desc' => 'Use the specified random seed when running tests in random order'],
],
'Reporting' => [
['arg' => '--colors <flag>', 'desc' => 'Use colors in output ("never", "auto" or "always")'],
['arg' => '--columns <n>', 'desc' => 'Number of columns to use for progress output'],
['arg' => '--columns max', 'desc' => 'Use maximum number of columns for progress output'],
['arg' => '--stderr', 'desc' => 'Write to STDERR instead of STDOUT'],
['spacer' => ''],
['arg' => '--no-progress', 'desc' => 'Disable output of test execution progress'],
['arg' => '--no-results', 'desc' => 'Disable output of test results'],
['arg' => '--no-output', 'desc' => 'Disable all output'],
['spacer' => ''],
['arg' => '--display-incomplete', 'desc' => 'Display details for incomplete tests'],
['arg' => '--display-skipped', 'desc' => 'Display details for skipped tests'],
['arg' => '--display-deprecations', 'desc' => 'Display details for deprecations triggered by tests'],
['arg' => '--display-errors', 'desc' => 'Display details for errors triggered by tests'],
['arg' => '--display-notices', 'desc' => 'Display details for notices triggered by tests'],
['arg' => '--display-warnings', 'desc' => 'Display details for warnings triggered by tests'],
['arg' => '--reverse-list', 'desc' => 'Print defects in reverse order'],
['spacer' => ''],
['arg' => '--teamcity', 'desc' => 'Replace default progress and result output with TeamCity format'],
['arg' => '--testdox', 'desc' => 'Replace default result output with TestDox format'],
['spacer' => ''],
['arg' => '--debug', 'desc' => 'Replace default progress and result output with debugging information'],
],
'Logging' => [
['arg' => '--log-junit <file>', 'desc' => 'Write test results in JUnit XML format to file'],
['arg' => '--log-teamcity <file>', 'desc' => 'Write test results in TeamCity format to file'],
['arg' => '--testdox-html <file>', 'desc' => 'Write test results in TestDox format (HTML) to file'],
['arg' => '--testdox-text <file>', 'desc' => 'Write test results in TestDox format (plain text) to file'],
['arg' => '--log-events-text <file>', 'desc' => 'Stream events as plain text to file'],
['arg' => '--log-events-verbose-text <file>', 'desc' => 'Stream events as plain text with extended information to file'],
['arg' => '--no-logging', 'desc' => 'Ignore logging configured in the XML configuration file'],
],
'Code Coverage' => [
['arg' => '--coverage-clover <file>', 'desc' => 'Write code coverage report in Clover XML format to file'],
['arg' => '--coverage-cobertura <file>', 'desc' => 'Write code coverage report in Cobertura XML format to file'],
['arg' => '--coverage-crap4j <file>', 'desc' => 'Write code coverage report in Crap4J XML format to file'],
['arg' => '--coverage-html <dir>', 'desc' => 'Write code coverage report in HTML format to directory'],
['arg' => '--coverage-php <file>', 'desc' => 'Write serialized code coverage data to file'],
['arg' => '--coverage-text=<file>', 'desc' => 'Write code coverage report in text format to file [default: standard output]'],
['arg' => '--coverage-xml <dir>', 'desc' => 'Write code coverage report in XML format to directory'],
['arg' => '--warm-coverage-cache', 'desc' => 'Warm static analysis cache'],
['arg' => '--coverage-filter <dir>', 'desc' => 'Include <dir> in code coverage reporting'],
['arg' => '--path-coverage', 'desc' => 'Report path coverage in addition to line coverage'],
['arg' => '--disable-coverage-ignore', 'desc' => 'Disable metadata for ignoring code coverage'],
['arg' => '--no-coverage', 'desc' => 'Ignore code coverage reporting configured in the XML configuration file'],
],
];
if (defined('__PHPUNIT_PHAR__')) {
$elements['PHAR'] = [
['arg' => '--manifest', 'desc' => 'Print Software Bill of Materials (SBOM) in plain-text format'],
['arg' => '--sbom', 'desc' => 'Print Software Bill of Materials (SBOM) in CycloneDX XML format'],
['arg' => '--composer-lock', 'desc' => 'Print composer.lock file used to build the PHAR'],
];
}
$elements['Miscellaneous'] = [
['arg' => '-h|--help', 'desc' => 'Prints this usage information'],
['arg' => '--version', 'desc' => 'Prints the version and exits'],
['arg' => '--atleast-version <min>', 'desc' => 'Checks that version is greater than <min> and exits'],
['arg' => '--check-version', 'desc' => 'Checks whether PHPUnit is the latest version and exits'],
];
return $elements;
}
}
src/TextUI/TestSuiteFilterProcessor.php 0000644 00000004507 15243426620 0014237 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function array_map;
use PHPUnit\Event;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\Filter\Factory;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\FilterNotConfiguredException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFilterProcessor
{
/**
* @throws Event\RuntimeException
* @throws FilterNotConfiguredException
*/
public function process(Configuration $configuration, TestSuite $suite): void
{
$factory = new Factory;
if (!$configuration->hasFilter() &&
!$configuration->hasGroups() &&
!$configuration->hasExcludeGroups() &&
!$configuration->hasTestsCovering() &&
!$configuration->hasTestsUsing()) {
return;
}
if ($configuration->hasExcludeGroups()) {
$factory->addExcludeGroupFilter(
$configuration->excludeGroups(),
);
}
if ($configuration->hasGroups()) {
$factory->addIncludeGroupFilter(
$configuration->groups(),
);
}
if ($configuration->hasTestsCovering()) {
$factory->addIncludeGroupFilter(
array_map(
static fn (string $name): string => '__phpunit_covers_' . $name,
$configuration->testsCovering(),
),
);
}
if ($configuration->hasTestsUsing()) {
$factory->addIncludeGroupFilter(
array_map(
static fn (string $name): string => '__phpunit_uses_' . $name,
$configuration->testsUsing(),
),
);
}
if ($configuration->hasFilter()) {
$factory->addNameFilter(
$configuration->filter(),
);
}
$suite->injectFilter($factory);
Event\Facade::emitter()->testSuiteFiltered(
Event\TestSuite\TestSuiteBuilder::from($suite),
);
}
}
src/TextUI/Output/Printer/NullPrinter.php 0000644 00000001032 15243426620 0014427 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NullPrinter implements Printer
{
public function print(string $buffer): void
{
}
public function flush(): void
{
}
}
src/TextUI/Output/Printer/DefaultPrinter.php 0000644 00000005447 15243426620 0015117 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function assert;
use function count;
use function dirname;
use function explode;
use function fclose;
use function fopen;
use function fsockopen;
use function fwrite;
use function sprintf;
use function str_replace;
use function str_starts_with;
use PHPUnit\TextUI\DirectoryDoesNotExistException;
use PHPUnit\TextUI\InvalidSocketException;
use PHPUnit\Util\Filesystem;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DefaultPrinter implements Printer
{
/**
* @psalm-var closed-resource|resource
*/
private $stream;
private readonly bool $isPhpStream;
private bool $isOpen;
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function from(string $out): self
{
return new self($out);
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function standardOutput(): self
{
return new self('php://stdout');
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function standardError(): self
{
return new self('php://stderr');
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
private function __construct(string $out)
{
$this->isPhpStream = str_starts_with($out, 'php://');
if (str_starts_with($out, 'socket://')) {
$tmp = explode(':', str_replace('socket://', '', $out));
if (count($tmp) !== 2) {
throw new InvalidSocketException(
sprintf(
'"%s" does not match "socket://hostname:port" format',
$out,
),
);
}
$this->stream = fsockopen($tmp[0], (int) $tmp[1]);
$this->isOpen = true;
return;
}
if (!$this->isPhpStream && !Filesystem::createDirectory(dirname($out))) {
throw new DirectoryDoesNotExistException(dirname($out));
}
$this->stream = fopen($out, 'wb');
$this->isOpen = true;
}
public function print(string $buffer): void
{
assert($this->isOpen);
fwrite($this->stream, $buffer);
}
public function flush(): void
{
if ($this->isOpen && $this->isPhpStream) {
fclose($this->stream);
$this->isOpen = false;
}
}
}
src/TextUI/Output/Printer/Printer.php 0000644 00000000757 15243426620 0013611 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Printer
{
public function print(string $buffer): void;
public function flush(): void;
}
src/TextUI/Output/Facade.php 0000644 00000020511 15243426620 0011674 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function assert;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Logging\TeamCity\TeamCityLogger;
use PHPUnit\Logging\TestDox\TestResultCollection;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\DirectoryDoesNotExistException;
use PHPUnit\TextUI\InvalidSocketException;
use PHPUnit\TextUI\Output\Default\ProgressPrinter\ProgressPrinter as DefaultProgressPrinter;
use PHPUnit\TextUI\Output\Default\ResultPrinter as DefaultResultPrinter;
use PHPUnit\TextUI\Output\Default\UnexpectedOutputPrinter;
use PHPUnit\TextUI\Output\TestDox\ResultPrinter as TestDoxResultPrinter;
use SebastianBergmann\Timer\Duration;
use SebastianBergmann\Timer\ResourceUsageFormatter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?Printer $printer = null;
private static ?DefaultResultPrinter $defaultResultPrinter = null;
private static ?TestDoxResultPrinter $testDoxResultPrinter = null;
private static ?SummaryPrinter $summaryPrinter = null;
private static bool $defaultProgressPrinter = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function init(Configuration $configuration, bool $extensionReplacesProgressOutput, bool $extensionReplacesResultOutput): Printer
{
self::createPrinter($configuration);
assert(self::$printer !== null);
if ($configuration->debug()) {
return self::$printer;
}
self::createUnexpectedOutputPrinter();
if (!$extensionReplacesProgressOutput) {
self::createProgressPrinter($configuration);
}
if (!$extensionReplacesResultOutput) {
self::createResultPrinter($configuration);
self::createSummaryPrinter($configuration);
}
if ($configuration->outputIsTeamCity()) {
new TeamCityLogger(
DefaultPrinter::standardOutput(),
EventFacade::instance(),
);
}
return self::$printer;
}
/**
* @psalm-param ?array<string, TestResultCollection> $testDoxResult
*/
public static function printResult(TestResult $result, ?array $testDoxResult, Duration $duration): void
{
assert(self::$printer !== null);
if ($result->numberOfTestsRun() > 0) {
if (self::$defaultProgressPrinter) {
self::$printer->print(PHP_EOL . PHP_EOL);
}
self::$printer->print((new ResourceUsageFormatter)->resourceUsage($duration) . PHP_EOL . PHP_EOL);
}
if (self::$testDoxResultPrinter !== null && $testDoxResult !== null) {
self::$testDoxResultPrinter->print($testDoxResult);
}
if (self::$defaultResultPrinter !== null) {
self::$defaultResultPrinter->print($result);
}
if (self::$summaryPrinter !== null) {
self::$summaryPrinter->print($result);
}
}
/**
* @throws DirectoryDoesNotExistException
* @throws InvalidSocketException
*/
public static function printerFor(string $target): Printer
{
if ($target === 'php://stdout') {
if (!self::$printer instanceof NullPrinter) {
return self::$printer;
}
return DefaultPrinter::standardOutput();
}
return DefaultPrinter::from($target);
}
private static function createPrinter(Configuration $configuration): void
{
$printerNeeded = false;
if ($configuration->debug()) {
$printerNeeded = true;
}
if ($configuration->outputIsTeamCity()) {
$printerNeeded = true;
}
if ($configuration->outputIsTestDox()) {
$printerNeeded = true;
}
if (!$configuration->noOutput() && !$configuration->noProgress()) {
$printerNeeded = true;
}
if (!$configuration->noOutput() && !$configuration->noResults()) {
$printerNeeded = true;
}
if ($printerNeeded) {
if ($configuration->outputToStandardErrorStream()) {
self::$printer = DefaultPrinter::standardError();
return;
}
self::$printer = DefaultPrinter::standardOutput();
return;
}
self::$printer = new NullPrinter;
}
private static function createProgressPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if (!self::useDefaultProgressPrinter($configuration)) {
return;
}
new DefaultProgressPrinter(
self::$printer,
EventFacade::instance(),
$configuration->colors(),
$configuration->columns(),
$configuration->source(),
);
self::$defaultProgressPrinter = true;
}
private static function useDefaultProgressPrinter(Configuration $configuration): bool
{
if ($configuration->noOutput()) {
return false;
}
if ($configuration->noProgress()) {
return false;
}
if ($configuration->outputIsTeamCity()) {
return false;
}
return true;
}
private static function createResultPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if ($configuration->outputIsTestDox()) {
self::$defaultResultPrinter = new DefaultResultPrinter(
self::$printer,
true,
true,
true,
false,
false,
true,
false,
false,
$configuration->displayDetailsOnTestsThatTriggerDeprecations(),
$configuration->displayDetailsOnTestsThatTriggerErrors(),
$configuration->displayDetailsOnTestsThatTriggerNotices(),
$configuration->displayDetailsOnTestsThatTriggerWarnings(),
$configuration->reverseDefectList(),
);
}
if ($configuration->outputIsTestDox()) {
self::$testDoxResultPrinter = new TestDoxResultPrinter(
self::$printer,
$configuration->colors(),
);
}
if ($configuration->noOutput() || $configuration->noResults()) {
return;
}
if (self::$defaultResultPrinter !== null) {
return;
}
self::$defaultResultPrinter = new DefaultResultPrinter(
self::$printer,
true,
true,
true,
true,
true,
true,
$configuration->displayDetailsOnIncompleteTests(),
$configuration->displayDetailsOnSkippedTests(),
$configuration->displayDetailsOnTestsThatTriggerDeprecations(),
$configuration->displayDetailsOnTestsThatTriggerErrors(),
$configuration->displayDetailsOnTestsThatTriggerNotices(),
$configuration->displayDetailsOnTestsThatTriggerWarnings(),
$configuration->reverseDefectList(),
);
}
private static function createSummaryPrinter(Configuration $configuration): void
{
assert(self::$printer !== null);
if (($configuration->noOutput() || $configuration->noResults()) &&
!($configuration->outputIsTeamCity() || $configuration->outputIsTestDox())) {
return;
}
self::$summaryPrinter = new SummaryPrinter(
self::$printer,
$configuration->colors(),
);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private static function createUnexpectedOutputPrinter(): void
{
assert(self::$printer !== null);
new UnexpectedOutputPrinter(self::$printer, EventFacade::instance());
}
}
src/TextUI/Output/TestDox/ResultPrinter.php 0000644 00000023311 15243426620 0014746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\TestDox;
use const PHP_EOL;
use function array_map;
use function assert;
use function explode;
use function implode;
use function preg_match;
use function preg_split;
use function rtrim;
use function str_starts_with;
use function trim;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Logging\TestDox\TestResult as TestDoxTestResult;
use PHPUnit\Logging\TestDox\TestResultCollection;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
public function __construct(Printer $printer, bool $colors)
{
$this->printer = $printer;
$this->colors = $colors;
}
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function print(array $tests): void
{
foreach ($tests as $prettifiedClassName => $_tests) {
$this->printPrettifiedClassName($prettifiedClassName);
foreach ($_tests as $test) {
$this->printTestResult($test);
}
$this->printer->print(PHP_EOL);
}
}
public function flush(): void
{
$this->printer->flush();
}
/**
* @psalm-param string $prettifiedClassName
*/
private function printPrettifiedClassName(string $prettifiedClassName): void
{
$buffer = $prettifiedClassName;
if ($this->colors) {
$buffer = Color::colorizeTextBox('underlined', $buffer);
}
$this->printer->print($buffer . PHP_EOL);
}
private function printTestResult(TestDoxTestResult $test): void
{
$this->printTestResultHeader($test);
$this->printTestResultBody($test);
}
private function printTestResultHeader(TestDoxTestResult $test): void
{
$buffer = ' ' . $this->symbolFor($test->status()) . ' ';
if ($this->colors) {
$this->printer->print(
Color::colorizeTextBox(
$this->colorFor($test->status()),
$buffer,
),
);
} else {
$this->printer->print($buffer);
}
$this->printer->print($test->test()->testDox()->prettifiedMethodName($this->colors) . PHP_EOL);
}
private function printTestResultBody(TestDoxTestResult $test): void
{
if ($test->status()->isSuccess()) {
return;
}
if (!$test->hasThrowable()) {
return;
}
$this->printTestResultBodyStart($test);
$this->printThrowable($test);
$this->printTestResultBodyEnd($test);
}
private function printTestResultBodyStart(TestDoxTestResult $test): void
{
$this->printer->print(
$this->prefixLines(
$this->prefixFor('start', $test->status()),
'',
),
);
$this->printer->print(PHP_EOL);
}
private function printTestResultBodyEnd(TestDoxTestResult $test): void
{
$this->printer->print(PHP_EOL);
$this->printer->print(
$this->prefixLines(
$this->prefixFor('last', $test->status()),
'',
),
);
$this->printer->print(PHP_EOL);
}
private function printThrowable(TestDoxTestResult $test): void
{
$throwable = $test->throwable();
assert($throwable instanceof Throwable);
$message = trim($throwable->description());
$stackTrace = $this->formatStackTrace($throwable->stackTrace());
$diff = '';
if (!empty($message) && $this->colors) {
['message' => $message, 'diff' => $diff] = $this->colorizeMessageAndDiff(
$message,
$this->messageColorFor($test->status()),
);
}
if (!empty($message)) {
$this->printer->print(
$this->prefixLines(
$this->prefixFor('message', $test->status()),
$message,
),
);
$this->printer->print(PHP_EOL);
}
if (!empty($diff)) {
$this->printer->print(
$this->prefixLines(
$this->prefixFor('diff', $test->status()),
$diff,
),
);
$this->printer->print(PHP_EOL);
}
if (!empty($stackTrace)) {
if (!empty($message) || !empty($diff)) {
$prefix = $this->prefixFor('default', $test->status());
} else {
$prefix = $this->prefixFor('trace', $test->status());
}
$this->printer->print(
$this->prefixLines($prefix, PHP_EOL . $stackTrace),
);
}
}
/**
* @psalm-return array{message: string, diff: string}
*/
private function colorizeMessageAndDiff(string $buffer, string $style): array
{
$lines = $buffer ? array_map('\rtrim', explode(PHP_EOL, $buffer)) : [];
$message = [];
$diff = [];
$insideDiff = false;
foreach ($lines as $line) {
if ($line === '--- Expected') {
$insideDiff = true;
}
if (!$insideDiff) {
$message[] = $line;
} else {
if (str_starts_with($line, '-')) {
$line = Color::colorize('fg-red', Color::visualizeWhitespace($line, true));
} elseif (str_starts_with($line, '+')) {
$line = Color::colorize('fg-green', Color::visualizeWhitespace($line, true));
} elseif ($line === '@@ @@') {
$line = Color::colorize('fg-cyan', $line);
}
$diff[] = $line;
}
}
$message = implode(PHP_EOL, $message);
$diff = implode(PHP_EOL, $diff);
if (!empty($message)) {
$message = Color::colorizeTextBox($style, $message);
}
return [
'message' => $message,
'diff' => $diff,
];
}
private function formatStackTrace(string $stackTrace): string
{
if (!$this->colors) {
return rtrim($stackTrace);
}
$lines = [];
$previousPath = '';
foreach (explode(PHP_EOL, $stackTrace) as $line) {
if (preg_match('/^(.*):(\d+)$/', $line, $matches)) {
$lines[] = Color::colorizePath($matches[1], $previousPath) . Color::dim(':') . Color::colorize('fg-blue', $matches[2]) . "\n";
$previousPath = $matches[1];
continue;
}
$lines[] = $line;
$previousPath = '';
}
return rtrim(implode('', $lines));
}
private function prefixLines(string $prefix, string $message): string
{
return implode(
PHP_EOL,
array_map(
static fn (string $line) => ' ' . $prefix . ($line ? ' ' . $line : ''),
preg_split('/\r\n|\r|\n/', $message),
),
);
}
/**
* @psalm-param 'default'|'start'|'message'|'diff'|'trace'|'last' $type
*/
private function prefixFor(string $type, TestStatus $status): string
{
if (!$this->colors) {
return '│';
}
return Color::colorize(
$this->colorFor($status),
match ($type) {
'default' => '│',
'start' => '┐',
'message' => '├',
'diff' => '┊',
'trace' => '╵',
'last' => '┴',
},
);
}
private function colorFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return 'fg-green';
}
if ($status->isError()) {
return 'fg-yellow';
}
if ($status->isFailure()) {
return 'fg-red';
}
if ($status->isSkipped()) {
return 'fg-cyan';
}
if ($status->isIncomplete() || $status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return 'fg-yellow';
}
return 'fg-blue';
}
private function messageColorFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return '';
}
if ($status->isError()) {
return 'bg-yellow,fg-black';
}
if ($status->isFailure()) {
return 'bg-red,fg-white';
}
if ($status->isSkipped()) {
return 'fg-cyan';
}
if ($status->isIncomplete() || $status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return 'fg-yellow';
}
return 'fg-white,bg-blue';
}
private function symbolFor(TestStatus $status): string
{
if ($status->isSuccess()) {
return '✔';
}
if ($status->isError() || $status->isFailure()) {
return '✘';
}
if ($status->isSkipped()) {
return '↩';
}
if ($status->isDeprecation() || $status->isNotice() || $status->isRisky() || $status->isWarning()) {
return '⚠';
}
if ($status->isIncomplete()) {
return '∅';
}
return '?';
}
}
src/TextUI/Output/Default/UnexpectedOutputPrinter.php 0000644 00000002065 15243426620 0017012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\PrintedUnexpectedOutput;
use PHPUnit\Event\Test\PrintedUnexpectedOutputSubscriber;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Output\Printer;
final class UnexpectedOutputPrinter implements PrintedUnexpectedOutputSubscriber
{
private readonly Printer $printer;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$facade->registerSubscriber($this);
}
public function notify(PrintedUnexpectedOutput $event): void
{
$this->printer->print($event->output());
}
}
src/TextUI/Output/Default/ProgressPrinter/ProgressPrinter.php 0000644 00000027615 15243426620 0020451 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use function floor;
use function sprintf;
use function str_contains;
use function str_repeat;
use function strlen;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ProgressPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
private readonly int $numberOfColumns;
private readonly Source $source;
private int $column = 0;
private int $numberOfTests = 0;
private int $numberOfTestsWidth = 0;
private int $maxColumn = 0;
private int $numberOfTestsRun = 0;
private ?TestStatus $status = null;
private bool $prepared = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade, bool $colors, int $numberOfColumns, Source $source)
{
$this->printer = $printer;
$this->colors = $colors;
$this->numberOfColumns = $numberOfColumns;
$this->source = $source;
$this->registerSubscribers($facade);
}
public function testRunnerExecutionStarted(ExecutionStarted $event): void
{
$this->numberOfTestsRun = 0;
$this->numberOfTests = $event->testSuite()->count();
$this->numberOfTestsWidth = strlen((string) $this->numberOfTests);
$this->column = 0;
$this->maxColumn = $this->numberOfColumns - strlen(' / (XXX%)') - (2 * $this->numberOfTestsWidth);
}
public function beforeTestClassMethodErrored(): void
{
$this->printProgressForError();
$this->updateTestStatus(TestStatus::error());
}
public function testPrepared(): void
{
$this->prepared = true;
}
public function testSkipped(): void
{
if (!$this->prepared) {
$this->printProgressForSkipped();
} else {
$this->updateTestStatus(TestStatus::skipped());
}
}
public function testMarkedIncomplete(): void
{
$this->updateTestStatus(TestStatus::incomplete());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictNotices() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfNotices() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictNotices() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpNotices() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if ($event->ignoredByBaseline() || $event->ignoredByTest()) {
return;
}
if ($this->source->restrictDeprecations() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfDeprecations() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if ($event->ignoredByBaseline() || $event->ignoredByTest()) {
return;
}
if ($this->source->restrictDeprecations() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpDeprecations() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpunitDeprecation(): void
{
$this->updateTestStatus(TestStatus::deprecation());
}
public function testConsideredRisky(): void
{
$this->updateTestStatus(TestStatus::risky());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictWarnings() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfWarnings() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
return;
}
if ($this->source->restrictWarnings() &&
!(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpunitWarning(): void
{
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredError(ErrorTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfErrors() && $event->wasSuppressed()) {
return;
}
$this->updateTestStatus(TestStatus::error());
}
public function testFailed(): void
{
$this->updateTestStatus(TestStatus::failure());
}
public function testErrored(Errored $event): void
{
/*
* @todo Eliminate this special case
*/
if (str_contains($event->asString(), 'Test was run in child process and ended unexpectedly')) {
$this->updateTestStatus(TestStatus::error());
return;
}
if (!$this->prepared) {
$this->printProgressForError();
} else {
$this->updateTestStatus(TestStatus::error());
}
}
public function testFinished(): void
{
if ($this->status === null) {
$this->printProgressForSuccess();
} elseif ($this->status->isSkipped()) {
$this->printProgressForSkipped();
} elseif ($this->status->isIncomplete()) {
$this->printProgressForIncomplete();
} elseif ($this->status->isRisky()) {
$this->printProgressForRisky();
} elseif ($this->status->isNotice()) {
$this->printProgressForNotice();
} elseif ($this->status->isDeprecation()) {
$this->printProgressForDeprecation();
} elseif ($this->status->isWarning()) {
$this->printProgressForWarning();
} elseif ($this->status->isFailure()) {
$this->printProgressForFailure();
} else {
$this->printProgressForError();
}
$this->status = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new BeforeTestClassMethodErroredSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestFinishedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestPreparedSubscriber($this),
new TestRunnerExecutionStartedSubscriber($this),
new TestSkippedSubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
}
private function updateTestStatus(TestStatus $status): void
{
if ($this->status !== null &&
$this->status->isMoreImportantThan($status)) {
return;
}
$this->status = $status;
}
private function printProgressForSuccess(): void
{
$this->printProgress('.');
}
private function printProgressForSkipped(): void
{
$this->printProgressWithColor('fg-cyan, bold', 'S');
}
private function printProgressForIncomplete(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'I');
}
private function printProgressForNotice(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'N');
}
private function printProgressForDeprecation(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'D');
}
private function printProgressForRisky(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'R');
}
private function printProgressForWarning(): void
{
$this->printProgressWithColor('fg-yellow, bold', 'W');
}
private function printProgressForFailure(): void
{
$this->printProgressWithColor('bg-red, fg-white', 'F');
}
private function printProgressForError(): void
{
$this->printProgressWithColor('fg-red, bold', 'E');
}
private function printProgressWithColor(string $color, string $progress): void
{
if ($this->colors) {
$progress = Color::colorizeTextBox($color, $progress);
}
$this->printProgress($progress);
}
private function printProgress(string $progress): void
{
$this->printer->print($progress);
$this->column++;
$this->numberOfTestsRun++;
if ($this->column === $this->maxColumn || $this->numberOfTestsRun === $this->numberOfTests) {
if ($this->numberOfTestsRun === $this->numberOfTests) {
$this->printer->print(str_repeat(' ', $this->maxColumn - $this->column));
}
$this->printer->print(
sprintf(
' %' . $this->numberOfTestsWidth . 'd / %' .
$this->numberOfTestsWidth . 'd (%3s%%)',
$this->numberOfTestsRun,
$this->numberOfTests,
floor(($this->numberOfTestsRun / $this->numberOfTests) * 100),
),
);
if ($this->column === $this->maxColumn) {
$this->column = 0;
$this->printer->print("\n");
}
}
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001325 15243426620 0025334 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->printer()->testTriggeredNotice($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestFailedSubscriber.php 0000644 00000001231 15243426620 0023436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->printer()->testFailed();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001377 15243426620 0027077 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->printer()->testTriggeredPhpunitWarning();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001405 15243426620 0027017 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->printer()->testTriggeredPhpDeprecation($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001333 15243426620 0025517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->printer()->testTriggeredWarning($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestPreparedSubscriber.php 0000644 00000001245 15243426620 0024021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->printer()->testPrepared();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001347 15243426620 0026010 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->printer()->testTriggeredPhpNotice($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestFinishedSubscriber.php 0000644 00000001245 15243426620 0024010 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->printer()->testFinished();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/BeforeTestClassMethodErroredSubscriber.php 0000644 00000001425 15243426620 0027133 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\BeforeFirstTestMethodErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestClassMethodErroredSubscriber extends Subscriber implements BeforeFirstTestMethodErroredSubscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void
{
$this->printer()->beforeTestClassMethodErrored();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestSkippedSubscriber.php 0000644 00000001237 15243426620 0023657 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->printer()->testSkipped();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestRunnerExecutionStartedSubscriber.php 0000644 00000001363 15243426620 0026744 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionStartedSubscriber extends Subscriber implements ExecutionStartedSubscriber
{
public function notify(ExecutionStarted $event): void
{
$this->printer()->testRunnerExecutionStarted($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/Subscriber.php 0000644 00000001255 15243426620 0021477 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly ProgressPrinter $printer;
public function __construct(ProgressPrinter $printer)
{
$this->printer = $printer;
}
protected function printer(): ProgressPrinter
{
return $this->printer;
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestErroredSubscriber.php 0000644 00000001245 15243426620 0023661 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->printer()->testErrored($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001427 15243426620 0027723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->printer()->testTriggeredPhpunitDeprecation();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredErrorSubscriber.php 0000644 00000001317 15243426620 0025205 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\ErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredErrorSubscriber extends Subscriber implements ErrorTriggeredSubscriber
{
public function notify(ErrorTriggered $event): void
{
$this->printer()->testTriggeredError($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001355 15243426620 0026173 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->printer()->testTriggeredPhpWarning($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001363 15243426620 0026352 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->printer()->testTriggeredDeprecation($event);
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001325 15243426620 0025501 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->printer()->testMarkedIncomplete();
}
}
src/TextUI/Output/Default/ProgressPrinter/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001317 15243426620 0025360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default\ProgressPrinter;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->printer()->testConsideredRisky();
}
}
src/TextUI/Output/Default/ResultPrinter.php 0000644 00000050376 15243426620 0014753 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output\Default;
use const PHP_EOL;
use function array_keys;
use function array_merge;
use function array_reverse;
use function array_unique;
use function assert;
use function count;
use function explode;
use function ksort;
use function range;
use function sprintf;
use function str_starts_with;
use function strlen;
use function substr;
use function trim;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\TextUI\Output\Printer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultPrinter
{
private readonly Printer $printer;
private readonly bool $displayPhpunitErrors;
private readonly bool $displayPhpunitWarnings;
private readonly bool $displayTestsWithErrors;
private readonly bool $displayTestsWithFailedAssertions;
private readonly bool $displayRiskyTests;
private readonly bool $displayPhpunitDeprecations;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $displayDefectsInReverseOrder;
private bool $listPrinted = false;
public function __construct(Printer $printer, bool $displayPhpunitErrors, bool $displayPhpunitWarnings, bool $displayPhpunitDeprecations, bool $displayTestsWithErrors, bool $displayTestsWithFailedAssertions, bool $displayRiskyTests, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $displayDefectsInReverseOrder)
{
$this->printer = $printer;
$this->displayPhpunitErrors = $displayPhpunitErrors;
$this->displayPhpunitWarnings = $displayPhpunitWarnings;
$this->displayPhpunitDeprecations = $displayPhpunitDeprecations;
$this->displayTestsWithErrors = $displayTestsWithErrors;
$this->displayTestsWithFailedAssertions = $displayTestsWithFailedAssertions;
$this->displayRiskyTests = $displayRiskyTests;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->displayDefectsInReverseOrder = $displayDefectsInReverseOrder;
}
public function print(TestResult $result): void
{
if ($this->displayPhpunitErrors) {
$this->printPhpunitErrors($result);
}
if ($this->displayPhpunitWarnings) {
$this->printTestRunnerWarnings($result);
}
if ($this->displayPhpunitDeprecations) {
$this->printTestRunnerDeprecations($result);
}
if ($this->displayTestsWithErrors) {
$this->printTestsWithErrors($result);
}
if ($this->displayTestsWithFailedAssertions) {
$this->printTestsWithFailedAssertions($result);
}
if ($this->displayPhpunitWarnings) {
$this->printDetailsOnTestsThatTriggeredPhpunitWarnings($result);
}
if ($this->displayPhpunitDeprecations) {
$this->printDetailsOnTestsThatTriggeredPhpunitDeprecations($result);
}
if ($this->displayRiskyTests) {
$this->printRiskyTests($result);
}
if ($this->displayDetailsOnIncompleteTests) {
$this->printIncompleteTests($result);
}
if ($this->displayDetailsOnSkippedTests) {
$this->printSkippedTestSuites($result);
$this->printSkippedTests($result);
}
if ($this->displayDetailsOnTestsThatTriggerErrors) {
$this->printIssueList('error', $result->errors());
}
if ($this->displayDetailsOnTestsThatTriggerWarnings) {
$this->printIssueList('PHP warning', $result->phpWarnings());
$this->printIssueList('warning', $result->warnings());
}
if ($this->displayDetailsOnTestsThatTriggerNotices) {
$this->printIssueList('PHP notice', $result->phpNotices());
$this->printIssueList('notice', $result->notices());
}
if ($this->displayDetailsOnTestsThatTriggerDeprecations) {
$this->printIssueList('PHP deprecation', $result->phpDeprecations());
$this->printIssueList('deprecation', $result->deprecations());
}
}
public function flush(): void
{
$this->printer->flush();
}
private function printPhpunitErrors(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitErrorEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitErrorEvents());
$this->printListHeaderWithNumber($elements['numberOfTestsWithIssues'], 'PHPUnit error');
$this->printList($elements['elements']);
}
private function printDetailsOnTestsThatTriggeredPhpunitDeprecations(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitDeprecationEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitDeprecationEvents());
$this->printListHeaderWithNumberOfTestsAndNumberOfIssues(
$elements['numberOfTestsWithIssues'],
$elements['numberOfIssues'],
'PHPUnit deprecation',
);
$this->printList($elements['elements']);
}
private function printTestRunnerWarnings(TestResult $result): void
{
if (!$result->hasTestRunnerTriggeredWarningEvents()) {
return;
}
$elements = [];
foreach ($result->testRunnerTriggeredWarningEvents() as $event) {
$elements[] = [
'title' => $event->message(),
'body' => '',
];
}
$this->printListHeaderWithNumber(count($elements), 'PHPUnit test runner warning');
$this->printList($elements);
}
private function printTestRunnerDeprecations(TestResult $result): void
{
if (!$result->hasTestRunnerTriggeredDeprecationEvents()) {
return;
}
$elements = [];
foreach ($result->testRunnerTriggeredDeprecationEvents() as $event) {
$elements[] = [
'title' => $event->message(),
'body' => '',
];
}
$this->printListHeaderWithNumber(count($elements), 'PHPUnit test runner deprecation');
$this->printList($elements);
}
private function printDetailsOnTestsThatTriggeredPhpunitWarnings(TestResult $result): void
{
if (!$result->hasTestTriggeredPhpunitWarningEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testTriggeredPhpunitWarningEvents());
$this->printListHeaderWithNumberOfTestsAndNumberOfIssues(
$elements['numberOfTestsWithIssues'],
$elements['numberOfIssues'],
'PHPUnit warning',
);
$this->printList($elements['elements']);
}
private function printTestsWithErrors(TestResult $result): void
{
if (!$result->hasTestErroredEvents()) {
return;
}
$elements = [];
foreach ($result->testErroredEvents() as $event) {
if ($event instanceof BeforeFirstTestMethodErrored) {
$title = $event->testClassName();
} else {
$title = $this->name($event->test());
}
$elements[] = [
'title' => $title,
'body' => $event->throwable()->asString(),
];
}
$this->printListHeaderWithNumber(count($elements), 'error');
$this->printList($elements);
}
private function printTestsWithFailedAssertions(TestResult $result): void
{
if (!$result->hasTestFailedEvents()) {
return;
}
$elements = [];
foreach ($result->testFailedEvents() as $event) {
$body = $event->throwable()->asString();
if (str_starts_with($body, 'AssertionError: ')) {
$body = substr($body, strlen('AssertionError: '));
}
$elements[] = [
'title' => $this->name($event->test()),
'body' => $body,
];
}
$this->printListHeaderWithNumber(count($elements), 'failure');
$this->printList($elements);
}
private function printRiskyTests(TestResult $result): void
{
if (!$result->hasTestConsideredRiskyEvents()) {
return;
}
$elements = $this->mapTestsWithIssuesEventsToElements($result->testConsideredRiskyEvents());
$this->printListHeaderWithNumber($elements['numberOfTestsWithIssues'], 'risky test');
$this->printList($elements['elements']);
}
private function printIncompleteTests(TestResult $result): void
{
if (!$result->hasTestMarkedIncompleteEvents()) {
return;
}
$elements = [];
foreach ($result->testMarkedIncompleteEvents() as $event) {
$elements[] = [
'title' => $this->name($event->test()),
'body' => $event->throwable()->asString(),
];
}
$this->printListHeaderWithNumber(count($elements), 'incomplete test');
$this->printList($elements);
}
private function printSkippedTestSuites(TestResult $result): void
{
if (!$result->hasTestSuiteSkippedEvents()) {
return;
}
$elements = [];
foreach ($result->testSuiteSkippedEvents() as $event) {
$elements[] = [
'title' => $event->testSuite()->name(),
'body' => $event->message(),
];
}
$this->printListHeaderWithNumber(count($elements), 'skipped test suite');
$this->printList($elements);
}
private function printSkippedTests(TestResult $result): void
{
if (!$result->hasTestSkippedEvents()) {
return;
}
$elements = [];
foreach ($result->testSkippedEvents() as $event) {
$elements[] = [
'title' => $this->name($event->test()),
'body' => $event->message(),
];
}
$this->printListHeaderWithNumber(count($elements), 'skipped test');
$this->printList($elements);
}
/**
* @psalm-param non-empty-string $type
* @psalm-param list<Issue> $issues
*/
private function printIssueList(string $type, array $issues): void
{
if (empty($issues)) {
return;
}
$numberOfUniqueIssues = count($issues);
$triggeringTests = [];
foreach ($issues as $issue) {
$triggeringTests = array_merge($triggeringTests, array_keys($issue->triggeringTests()));
}
$numberOfTests = count(array_unique($triggeringTests));
unset($triggeringTests);
$this->printListHeader(
sprintf(
'%d test%s triggered %d %s%s:' . PHP_EOL . PHP_EOL,
$numberOfTests,
$numberOfTests !== 1 ? 's' : '',
$numberOfUniqueIssues,
$type,
$numberOfUniqueIssues !== 1 ? 's' : '',
),
);
$i = 1;
foreach ($issues as $issue) {
$title = sprintf(
'%s:%d',
$issue->file(),
$issue->line(),
);
$body = trim($issue->description()) . PHP_EOL . PHP_EOL . 'Triggered by:';
$triggeringTests = $issue->triggeringTests();
ksort($triggeringTests);
foreach ($triggeringTests as $triggeringTest) {
$body .= PHP_EOL . PHP_EOL . '* ' . $triggeringTest['test']->id();
if ($triggeringTest['count'] > 1) {
$body .= sprintf(
' (%d times)',
$triggeringTest['count'],
);
}
if ($triggeringTest['test']->isTestMethod()) {
$body .= PHP_EOL . ' ' . $triggeringTest['test']->file() . ':' . $triggeringTest['test']->line();
}
}
$this->printIssueListElement($i++, $title, $body);
$this->printer->print(PHP_EOL);
}
}
private function printListHeaderWithNumberOfTestsAndNumberOfIssues(int $numberOfTestsWithIssues, int $numberOfIssues, string $type): void
{
$this->printListHeader(
sprintf(
"%d test%s triggered %d %s%s:\n\n",
$numberOfTestsWithIssues,
$numberOfTestsWithIssues !== 1 ? 's' : '',
$numberOfIssues,
$type,
$numberOfIssues !== 1 ? 's' : '',
),
);
}
private function printListHeaderWithNumber(int $number, string $type): void
{
$this->printListHeader(
sprintf(
"There %s %d %s%s:\n\n",
($number === 1) ? 'was' : 'were',
$number,
$type,
($number === 1) ? '' : 's',
),
);
}
private function printListHeader(string $header): void
{
if ($this->listPrinted) {
$this->printer->print("--\n\n");
}
$this->listPrinted = true;
$this->printer->print($header);
}
/**
* @psalm-param list<array{title: string, body: string}> $elements
*/
private function printList(array $elements): void
{
$i = 1;
if ($this->displayDefectsInReverseOrder) {
$elements = array_reverse($elements);
}
foreach ($elements as $element) {
$this->printListElement($i++, $element['title'], $element['body']);
}
$this->printer->print("\n");
}
private function printListElement(int $number, string $title, string $body): void
{
$body = trim($body);
$this->printer->print(
sprintf(
"%s%d) %s\n%s%s",
$number > 1 ? "\n" : '',
$number,
$title,
$body,
!empty($body) ? "\n" : '',
),
);
}
private function printIssueListElement(int $number, string $title, string $body): void
{
$body = trim($body);
$this->printer->print(
sprintf(
"%d) %s\n%s%s",
$number,
$title,
$body,
!empty($body) ? "\n" : '',
),
);
}
private function name(Test $test): string
{
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
if (!$test->testData()->hasDataFromDataProvider()) {
return $test->nameWithClass();
}
return $test->className() . '::' . $test->methodName() . $test->testData()->dataFromDataProvider()->dataAsStringForResultOutput();
}
return $test->name();
}
/**
* @psalm-param array<string,list<ConsideredRisky|DeprecationTriggered|PhpDeprecationTriggered|PhpunitDeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpNoticeTriggered|WarningTriggered|PhpWarningTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered>> $events
*
* @psalm-return array{numberOfTestsWithIssues: int, numberOfIssues: int, elements: list<array{title: string, body: string}>}
*/
private function mapTestsWithIssuesEventsToElements(array $events): array
{
$elements = [];
$issues = 0;
foreach ($events as $reasons) {
$test = $reasons[0]->test();
$testLocation = $this->testLocation($test);
$title = $this->name($test);
$body = '';
$first = true;
$single = count($reasons) === 1;
foreach ($reasons as $reason) {
if ($first) {
$first = false;
} else {
$body .= PHP_EOL;
}
$body .= $this->reasonMessage($reason, $single);
$body .= $this->reasonLocation($reason, $single);
$issues++;
}
if (!empty($testLocation)) {
$body .= $testLocation;
}
$elements[] = [
'title' => $title,
'body' => $body,
];
}
return [
'numberOfTestsWithIssues' => count($events),
'numberOfIssues' => $issues,
'elements' => $elements,
];
}
private function testLocation(Test $test): string
{
if (!$test->isTestMethod()) {
return '';
}
assert($test instanceof TestMethod);
return sprintf(
'%s%s:%d%s',
PHP_EOL,
$test->file(),
$test->line(),
PHP_EOL,
);
}
private function reasonMessage(ConsideredRisky|DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpunitDeprecationTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered|PhpWarningTriggered|WarningTriggered $reason, bool $single): string
{
$message = trim($reason->message());
if ($single) {
return $message . PHP_EOL;
}
$lines = explode(PHP_EOL, $message);
$buffer = '* ' . $lines[0] . PHP_EOL;
if (count($lines) > 1) {
foreach (range(1, count($lines) - 1) as $line) {
$buffer .= ' ' . $lines[$line] . PHP_EOL;
}
}
return $buffer;
}
private function reasonLocation(ConsideredRisky|DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpunitDeprecationTriggered|PhpunitErrorTriggered|PhpunitWarningTriggered|PhpWarningTriggered|WarningTriggered $reason, bool $single): string
{
if (!$reason instanceof DeprecationTriggered &&
!$reason instanceof PhpDeprecationTriggered &&
!$reason instanceof ErrorTriggered &&
!$reason instanceof NoticeTriggered &&
!$reason instanceof PhpNoticeTriggered &&
!$reason instanceof WarningTriggered &&
!$reason instanceof PhpWarningTriggered) {
return '';
}
return sprintf(
'%s%s:%d%s',
$single ? '' : ' ',
$reason->file(),
$reason->line(),
PHP_EOL,
);
}
}
src/TextUI/Output/SummaryPrinter.php 0000644 00000013024 15243426620 0013533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Output;
use function sprintf;
use PHPUnit\TestRunner\TestResult\TestResult;
use PHPUnit\Util\Color;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SummaryPrinter
{
private readonly Printer $printer;
private readonly bool $colors;
private bool $countPrinted = false;
public function __construct(Printer $printer, bool $colors)
{
$this->printer = $printer;
$this->colors = $colors;
}
public function print(TestResult $result): void
{
if ($result->numberOfTestsRun() === 0) {
$this->printWithColor(
'fg-black, bg-yellow',
'No tests executed!',
);
return;
}
if ($result->wasSuccessfulAndNoTestHasIssues() &&
!$result->hasTestSuiteSkippedEvents() &&
!$result->hasTestSkippedEvents()) {
$this->printWithColor(
'fg-black, bg-green',
sprintf(
'OK (%d test%s, %d assertion%s)',
$result->numberOfTestsRun(),
$result->numberOfTestsRun() === 1 ? '' : 's',
$result->numberOfAssertions(),
$result->numberOfAssertions() === 1 ? '' : 's',
),
);
$this->printNumberOfIssuesIgnoredByBaseline($result);
return;
}
$color = 'fg-black, bg-yellow';
if ($result->wasSuccessful()) {
if (!$result->hasTestsWithIssues()) {
$this->printWithColor(
$color,
'OK, but some tests were skipped!',
);
} else {
$this->printWithColor(
$color,
'OK, but there were issues!',
);
}
} else {
if ($result->hasTestErroredEvents() || $result->hasTestTriggeredPhpunitErrorEvents()) {
$color = 'fg-white, bg-red';
$this->printWithColor(
$color,
'ERRORS!',
);
} elseif ($result->hasTestFailedEvents()) {
$color = 'fg-white, bg-red';
$this->printWithColor(
$color,
'FAILURES!',
);
} elseif ($result->hasWarnings()) {
$this->printWithColor(
$color,
'WARNINGS!',
);
} elseif ($result->hasDeprecations()) {
$this->printWithColor(
$color,
'DEPRECATIONS!',
);
} elseif ($result->hasNotices()) {
$this->printWithColor(
$color,
'NOTICES!',
);
}
}
$this->printCountString($result->numberOfTestsRun(), 'Tests', $color, true);
$this->printCountString($result->numberOfAssertions(), 'Assertions', $color, true);
$this->printCountString($result->numberOfErrors(), 'Errors', $color);
$this->printCountString($result->numberOfTestFailedEvents(), 'Failures', $color);
$this->printCountString($result->numberOfWarnings(), 'Warnings', $color);
$this->printCountString($result->numberOfDeprecations(), 'Deprecations', $color);
$this->printCountString($result->numberOfNotices(), 'Notices', $color);
$this->printCountString($result->numberOfTestSuiteSkippedEvents() + $result->numberOfTestSkippedEvents(), 'Skipped', $color);
$this->printCountString($result->numberOfTestMarkedIncompleteEvents(), 'Incomplete', $color);
$this->printCountString($result->numberOfTestsWithTestConsideredRiskyEvents(), 'Risky', $color);
$this->printWithColor($color, '.');
$this->printNumberOfIssuesIgnoredByBaseline($result);
}
private function printCountString(int $count, string $name, string $color, bool $always = false): void
{
if ($always || $count > 0) {
$this->printWithColor(
$color,
sprintf(
'%s%s: %d',
$this->countPrinted ? ', ' : '',
$name,
$count,
),
false,
);
$this->countPrinted = true;
}
}
private function printWithColor(string $color, string $buffer, bool $lf = true): void
{
if ($this->colors) {
$buffer = Color::colorizeTextBox($color, $buffer);
}
$this->printer->print($buffer);
if ($lf) {
$this->printer->print(PHP_EOL);
}
}
private function printNumberOfIssuesIgnoredByBaseline(TestResult $result): void
{
if ($result->hasIssuesIgnoredByBaseline()) {
$this->printer->print(
sprintf(
'%s%d issue%s %s ignored by baseline.%s',
PHP_EOL,
$result->numberOfIssuesIgnoredByBaseline(),
$result->numberOfIssuesIgnoredByBaseline() > 1 ? 's' : '',
$result->numberOfIssuesIgnoredByBaseline() > 1 ? 'were' : 'was',
PHP_EOL,
),
);
}
}
}
src/TextUI/Exception/InvalidSocketException.php 0000644 00000001343 15243426620 0015607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidSocketException extends RuntimeException implements Exception
{
public function __construct(string $socket)
{
parent::__construct(
sprintf(
'"%s" does not match "socket://hostname:port" format',
$socket,
),
);
}
}
src/TextUI/Exception/TestFileNotFoundException.php 0000644 00000001307 15243426620 0016244 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFileNotFoundException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(
sprintf(
'Test file "%s" not found',
$path,
),
);
}
}
src/TextUI/Exception/ExtensionsNotConfiguredException.php 0000644 00000000757 15243426620 0017706 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionsNotConfiguredException extends RuntimeException implements Exception
{
}
src/TextUI/Exception/TestDirectoryNotFoundException.php 0000644 00000001321 15243426620 0017325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestDirectoryNotFoundException extends RuntimeException implements Exception
{
public function __construct(string $path)
{
parent::__construct(
sprintf(
'Test directory "%s" not found',
$path,
),
);
}
}
src/TextUI/Exception/Exception.php 0000644 00000000667 15243426620 0013137 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use Throwable;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
src/TextUI/Exception/RuntimeException.php 0000644 00000000711 15243426620 0014471 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
src/TextUI/Exception/ReflectionException.php 0000644 00000000742 15243426620 0015144 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
src/TextUI/Exception/DirectoryDoesNotExistException.php 0000644 00000001364 15243426620 0017330 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'Directory "%s" does not exist and could not be created',
$directory,
),
);
}
}
src/TextUI/Application.php 0000644 00000055012 15243426620 0011500 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI;
use const PHP_EOL;
use function is_file;
use function is_readable;
use function printf;
use function realpath;
use function sprintf;
use function trim;
use function unlink;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Logging\EventLogger;
use PHPUnit\Logging\JUnit\JunitXmlLogger;
use PHPUnit\Logging\TeamCity\TeamCityLogger;
use PHPUnit\Logging\TestDox\HtmlRenderer as TestDoxHtmlRenderer;
use PHPUnit\Logging\TestDox\PlainTextRenderer as TestDoxTextRenderer;
use PHPUnit\Logging\TestDox\TestResultCollector as TestDoxResultCollector;
use PHPUnit\Metadata\Api\CodeCoverage as CodeCoverageMetadataApi;
use PHPUnit\Runner\Baseline\CannotLoadBaselineException;
use PHPUnit\Runner\Baseline\Generator as BaselineGenerator;
use PHPUnit\Runner\Baseline\Reader;
use PHPUnit\Runner\Baseline\Writer;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\Runner\ErrorHandler;
use PHPUnit\Runner\Extension\ExtensionBootstrapper;
use PHPUnit\Runner\Extension\Facade as ExtensionFacade;
use PHPUnit\Runner\Extension\PharLoader;
use PHPUnit\Runner\GarbageCollection\GarbageCollectionHandler;
use PHPUnit\Runner\ResultCache\DefaultResultCache;
use PHPUnit\Runner\ResultCache\NullResultCache;
use PHPUnit\Runner\ResultCache\ResultCache;
use PHPUnit\Runner\ResultCache\ResultCacheHandler;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Runner\Version;
use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
use PHPUnit\TextUI\CliArguments\Builder;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception as ArgumentsException;
use PHPUnit\TextUI\CliArguments\XmlConfigurationFileFinder;
use PHPUnit\TextUI\Command\AtLeastVersionCommand;
use PHPUnit\TextUI\Command\GenerateConfigurationCommand;
use PHPUnit\TextUI\Command\ListGroupsCommand;
use PHPUnit\TextUI\Command\ListTestsAsTextCommand;
use PHPUnit\TextUI\Command\ListTestsAsXmlCommand;
use PHPUnit\TextUI\Command\ListTestSuitesCommand;
use PHPUnit\TextUI\Command\MigrateConfigurationCommand;
use PHPUnit\TextUI\Command\Result;
use PHPUnit\TextUI\Command\ShowHelpCommand;
use PHPUnit\TextUI\Command\ShowVersionCommand;
use PHPUnit\TextUI\Command\VersionCheckCommand;
use PHPUnit\TextUI\Command\WarmCodeCoverageCacheCommand;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\PhpHandler;
use PHPUnit\TextUI\Configuration\Registry;
use PHPUnit\TextUI\Configuration\TestSuiteBuilder;
use PHPUnit\TextUI\Output\DefaultPrinter;
use PHPUnit\TextUI\Output\Facade as OutputFacade;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\TextUI\XmlConfiguration\DefaultConfiguration;
use PHPUnit\TextUI\XmlConfiguration\Loader;
use SebastianBergmann\Timer\Timer;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Application
{
public function run(array $argv): int
{
try {
EventFacade::emitter()->applicationStarted();
$cliConfiguration = $this->buildCliConfiguration($argv);
$pathToXmlConfigurationFile = (new XmlConfigurationFileFinder)->find($cliConfiguration);
$this->executeCommandsThatOnlyRequireCliConfiguration($cliConfiguration, $pathToXmlConfigurationFile);
$xmlConfiguration = $this->loadXmlConfiguration($pathToXmlConfigurationFile);
$configuration = Registry::init(
$cliConfiguration,
$xmlConfiguration,
);
(new PhpHandler)->handle($configuration->php());
if ($configuration->hasBootstrap()) {
$this->loadBootstrapScript($configuration->bootstrap());
}
$this->executeCommandsThatRequireCompleteConfiguration($configuration, $cliConfiguration);
$testSuite = $this->buildTestSuite($configuration);
$this->executeCommandsThatRequireCliConfigurationAndTestSuite($cliConfiguration, $testSuite);
$this->executeHelpCommandWhenThereIsNothingElseToDo($configuration, $testSuite);
$pharExtensions = null;
$extensionRequiresCodeCoverageCollection = false;
$extensionReplacesOutput = false;
$extensionReplacesProgressOutput = false;
$extensionReplacesResultOutput = false;
$extensionRequiresExportOfObjects = false;
if (!$configuration->noExtensions()) {
if ($configuration->hasPharExtensionDirectory()) {
$pharExtensions = (new PharLoader)->loadPharExtensionsInDirectory(
$configuration->pharExtensionDirectory(),
);
}
$bootstrappedExtensions = $this->bootstrapExtensions($configuration);
$extensionRequiresCodeCoverageCollection = $bootstrappedExtensions['requiresCodeCoverageCollection'];
$extensionReplacesOutput = $bootstrappedExtensions['replacesOutput'];
$extensionReplacesProgressOutput = $bootstrappedExtensions['replacesProgressOutput'];
$extensionReplacesResultOutput = $bootstrappedExtensions['replacesResultOutput'];
$extensionRequiresExportOfObjects = $bootstrappedExtensions['requiresExportOfObjects'];
}
if ($extensionRequiresExportOfObjects) {
EventFacade::emitter()->exportObjects();
}
CodeCoverage::instance()->init(
$configuration,
CodeCoverageFilterRegistry::instance(),
$extensionRequiresCodeCoverageCollection,
);
if (CodeCoverage::instance()->isActive()) {
CodeCoverage::instance()->ignoreLines(
(new CodeCoverageMetadataApi)->linesToBeIgnored($testSuite),
);
}
$printer = OutputFacade::init(
$configuration,
$extensionReplacesProgressOutput,
$extensionReplacesResultOutput,
);
if (!$configuration->debug() && !$extensionReplacesOutput) {
$this->writeRuntimeInformation($printer, $configuration);
$this->writePharExtensionInformation($printer, $pharExtensions);
$this->writeRandomSeedInformation($printer, $configuration);
$printer->print(PHP_EOL);
}
if ($configuration->debug()) {
EventFacade::instance()->registerTracer(
new EventLogger(
'php://stdout',
false,
),
);
}
$this->registerLogfileWriters($configuration);
$testDoxResultCollector = $this->testDoxResultCollector($configuration);
TestResultFacade::init();
$resultCache = $this->initializeTestResultCache($configuration);
if ($configuration->controlGarbageCollector()) {
new GarbageCollectionHandler(
EventFacade::instance(),
$configuration->numberOfTestsBeforeGarbageCollection(),
);
}
$baselineGenerator = $this->configureBaseline($configuration);
EventFacade::instance()->seal();
$timer = new Timer;
$timer->start();
$runner = new TestRunner;
$runner->run(
$configuration,
$resultCache,
$testSuite,
);
$duration = $timer->stop();
$testDoxResult = null;
if (isset($testDoxResultCollector)) {
$testDoxResult = $testDoxResultCollector->testMethodsGroupedByClass();
}
if ($testDoxResult !== null &&
$configuration->hasLogfileTestdoxHtml()) {
OutputFacade::printerFor($configuration->logfileTestdoxHtml())->print(
(new TestDoxHtmlRenderer)->render($testDoxResult),
);
}
if ($testDoxResult !== null &&
$configuration->hasLogfileTestdoxText()) {
OutputFacade::printerFor($configuration->logfileTestdoxText())->print(
(new TestDoxTextRenderer)->render($testDoxResult),
);
}
$result = TestResultFacade::result();
if (!$extensionReplacesResultOutput && !$configuration->debug()) {
OutputFacade::printResult($result, $testDoxResult, $duration);
}
CodeCoverage::instance()->generateReports($printer, $configuration);
if (isset($baselineGenerator)) {
(new Writer)->write(
$configuration->generateBaseline(),
$baselineGenerator->baseline(),
);
$printer->print(
sprintf(
PHP_EOL . 'Baseline written to %s.' . PHP_EOL,
realpath($configuration->generateBaseline()),
),
);
}
$shellExitCode = (new ShellExitCodeCalculator)->calculate(
$configuration->failOnDeprecation(),
$configuration->failOnEmptyTestSuite(),
$configuration->failOnIncomplete(),
$configuration->failOnNotice(),
$configuration->failOnRisky(),
$configuration->failOnSkipped(),
$configuration->failOnWarning(),
$result,
);
EventFacade::emitter()->applicationFinished($shellExitCode);
return $shellExitCode;
// @codeCoverageIgnoreStart
} catch (Throwable $t) {
$this->exitWithCrashMessage($t);
}
// @codeCoverageIgnoreEnd
}
private function execute(Command\Command $command): never
{
print Version::getVersionString() . PHP_EOL . PHP_EOL;
$result = $command->execute();
print $result->output();
exit($result->shellExitCode());
}
private function loadBootstrapScript(string $filename): void
{
if (!is_readable($filename)) {
$this->exitWithErrorMessage(
sprintf(
'Cannot open bootstrap script "%s"',
$filename,
),
);
}
try {
include_once $filename;
} catch (Throwable $t) {
$message = sprintf(
'Error in bootstrap script: %s:%s%s%s%s',
$t::class,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
);
while ($t = $t->getPrevious()) {
$message .= sprintf(
'%s%sPrevious error: %s:%s%s%s%s',
PHP_EOL,
PHP_EOL,
$t::class,
PHP_EOL,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
);
}
$this->exitWithErrorMessage($message);
}
EventFacade::emitter()->testRunnerBootstrapFinished($filename);
}
private function buildCliConfiguration(array $argv): CliConfiguration
{
try {
$cliConfiguration = (new Builder)->fromParameters($argv);
} catch (ArgumentsException $e) {
$this->exitWithErrorMessage($e->getMessage());
}
return $cliConfiguration;
}
private function loadXmlConfiguration(false|string $configurationFile): XmlConfiguration
{
if ($configurationFile === false) {
return DefaultConfiguration::create();
}
try {
return (new Loader)->load($configurationFile);
} catch (Throwable $e) {
$this->exitWithErrorMessage($e->getMessage());
}
}
private function buildTestSuite(Configuration $configuration): TestSuite
{
try {
return (new TestSuiteBuilder)->build($configuration);
} catch (Exception $e) {
$this->exitWithErrorMessage($e->getMessage());
}
}
/**
* @psalm-return array{requiresCodeCoverageCollection: bool, replacesOutput: bool, replacesProgressOutput: bool, replacesResultOutput: bool, requiresExportOfObjects: bool}
*/
private function bootstrapExtensions(Configuration $configuration): array
{
$facade = new ExtensionFacade;
$extensionBootstrapper = new ExtensionBootstrapper(
$configuration,
$facade,
);
foreach ($configuration->extensionBootstrappers() as $bootstrapper) {
$extensionBootstrapper->bootstrap(
$bootstrapper['className'],
$bootstrapper['parameters'],
);
}
return [
'requiresCodeCoverageCollection' => $facade->requiresCodeCoverageCollection(),
'replacesOutput' => $facade->replacesOutput(),
'replacesProgressOutput' => $facade->replacesProgressOutput(),
'replacesResultOutput' => $facade->replacesResultOutput(),
'requiresExportOfObjects' => $facade->requiresExportOfObjects(),
];
}
private function executeCommandsThatOnlyRequireCliConfiguration(CliConfiguration $cliConfiguration, false|string $configurationFile): void
{
if ($cliConfiguration->generateConfiguration()) {
$this->execute(new GenerateConfigurationCommand);
}
if ($cliConfiguration->migrateConfiguration()) {
if ($configurationFile === false) {
$this->exitWithErrorMessage('No configuration file found to migrate');
}
$this->execute(new MigrateConfigurationCommand(realpath($configurationFile)));
}
if ($cliConfiguration->hasAtLeastVersion()) {
$this->execute(new AtLeastVersionCommand($cliConfiguration->atLeastVersion()));
}
if ($cliConfiguration->version()) {
$this->execute(new ShowVersionCommand);
}
if ($cliConfiguration->checkVersion()) {
$this->execute(new VersionCheckCommand);
}
if ($cliConfiguration->help()) {
$this->execute(new ShowHelpCommand(Result::SUCCESS));
}
}
private function executeCommandsThatRequireCliConfigurationAndTestSuite(CliConfiguration $cliConfiguration, TestSuite $testSuite): void
{
if ($cliConfiguration->listGroups()) {
$this->execute(new ListGroupsCommand($testSuite));
}
if ($cliConfiguration->listTests()) {
$this->execute(new ListTestsAsTextCommand($testSuite));
}
if ($cliConfiguration->hasListTestsXml()) {
$this->execute(
new ListTestsAsXmlCommand(
$cliConfiguration->listTestsXml(),
$testSuite,
),
);
}
}
private function executeCommandsThatRequireCompleteConfiguration(Configuration $configuration, CliConfiguration $cliConfiguration): void
{
if ($cliConfiguration->listSuites()) {
$this->execute(new ListTestSuitesCommand($configuration->testSuite()));
}
if ($cliConfiguration->warmCoverageCache()) {
$this->execute(new WarmCodeCoverageCacheCommand($configuration, CodeCoverageFilterRegistry::instance()));
}
}
private function executeHelpCommandWhenThereIsNothingElseToDo(Configuration $configuration, TestSuite $testSuite): void
{
if ($testSuite->isEmpty() && !$configuration->hasCliArguments() && $configuration->testSuite()->isEmpty()) {
$this->execute(new ShowHelpCommand(Result::FAILURE));
}
}
private function writeRuntimeInformation(Printer $printer, Configuration $configuration): void
{
$printer->print(Version::getVersionString() . PHP_EOL . PHP_EOL);
$runtime = 'PHP ' . PHP_VERSION;
if (CodeCoverage::instance()->isActive()) {
$runtime .= ' with ' . CodeCoverage::instance()->driver()->nameAndVersion();
}
$this->writeMessage($printer, 'Runtime', $runtime);
if ($configuration->hasConfigurationFile()) {
$this->writeMessage(
$printer,
'Configuration',
$configuration->configurationFile(),
);
}
}
/**
* @psalm-param ?list<string> $pharExtensions
*/
private function writePharExtensionInformation(Printer $printer, ?array $pharExtensions): void
{
if ($pharExtensions === null) {
return;
}
foreach ($pharExtensions as $extension) {
$this->writeMessage(
$printer,
'Extension',
$extension,
);
}
}
private function writeMessage(Printer $printer, string $type, string $message): void
{
$printer->print(
sprintf(
"%-15s%s\n",
$type . ':',
$message,
),
);
}
private function writeRandomSeedInformation(Printer $printer, Configuration $configuration): void
{
if ($configuration->executionOrder() === TestSuiteSorter::ORDER_RANDOMIZED) {
$this->writeMessage(
$printer,
'Random Seed',
(string) $configuration->randomOrderSeed(),
);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerLogfileWriters(Configuration $configuration): void
{
if ($configuration->hasLogEventsText()) {
if (is_file($configuration->logEventsText())) {
unlink($configuration->logEventsText());
}
EventFacade::instance()->registerTracer(
new EventLogger(
$configuration->logEventsText(),
false,
),
);
}
if ($configuration->hasLogEventsVerboseText()) {
if (is_file($configuration->logEventsVerboseText())) {
unlink($configuration->logEventsVerboseText());
}
EventFacade::instance()->registerTracer(
new EventLogger(
$configuration->logEventsVerboseText(),
true,
),
);
EventFacade::emitter()->exportObjects();
}
if ($configuration->hasLogfileJunit()) {
new JunitXmlLogger(
OutputFacade::printerFor($configuration->logfileJunit()),
EventFacade::instance(),
);
}
if ($configuration->hasLogfileTeamcity()) {
new TeamCityLogger(
DefaultPrinter::from(
$configuration->logfileTeamcity(),
),
EventFacade::instance(),
);
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function testDoxResultCollector(Configuration $configuration): ?TestDoxResultCollector
{
if ($configuration->hasLogfileTestdoxHtml() ||
$configuration->hasLogfileTestdoxText() ||
$configuration->outputIsTestDox()) {
return new TestDoxResultCollector(EventFacade::instance());
}
return null;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function initializeTestResultCache(Configuration $configuration): ResultCache
{
if ($configuration->cacheResult()) {
$cache = new DefaultResultCache($configuration->testResultCacheFile());
new ResultCacheHandler($cache, EventFacade::instance());
return $cache;
}
return new NullResultCache;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function configureBaseline(Configuration $configuration): ?BaselineGenerator
{
if ($configuration->hasGenerateBaseline()) {
return new BaselineGenerator(
EventFacade::instance(),
$configuration->source(),
);
}
if ($configuration->source()->useBaseline()) {
/** @psalm-suppress MissingThrowsDocblock */
$baselineFile = $configuration->source()->baseline();
$baseline = null;
try {
$baseline = (new Reader)->read($baselineFile);
} catch (CannotLoadBaselineException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning($e->getMessage());
}
if ($baseline !== null) {
ErrorHandler::instance()->use($baseline);
}
}
return null;
}
/**
* @codeCoverageIgnore
*/
private function exitWithCrashMessage(Throwable $t): never
{
$message = $t->getMessage();
if (empty(trim($message))) {
$message = '(no message)';
}
printf(
'%s%sAn error occurred inside PHPUnit.%s%sMessage: %s',
PHP_EOL,
PHP_EOL,
PHP_EOL,
PHP_EOL,
$message,
);
$first = true;
if ($t->getPrevious()) {
$t = $t->getPrevious();
}
do {
printf(
'%s%s: %s:%d%s%s%s%s',
PHP_EOL,
$first ? 'Location' : 'Caused by',
$t->getFile(),
$t->getLine(),
PHP_EOL,
PHP_EOL,
$t->getTraceAsString(),
PHP_EOL,
);
$first = false;
} while ($t = $t->getPrevious());
exit(Result::CRASH);
}
private function exitWithErrorMessage(string $message): never
{
print Version::getVersionString() . PHP_EOL . PHP_EOL . $message . PHP_EOL;
exit(Result::EXCEPTION);
}
}
src/TextUI/Configuration/Registry.php 0000644 00000006175 15243426620 0013662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function assert;
use function file_get_contents;
use function file_put_contents;
use function serialize;
use function unserialize;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* CLI options and XML configuration are static within a single PHPUnit process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Registry
{
private static ?Configuration $instance = null;
public static function saveTo(string $path): bool
{
$result = file_put_contents(
$path,
serialize(self::get()),
);
if ($result) {
return true;
}
return false;
}
/**
* This method is used by the "run test(s) in separate process" templates.
*
* @noinspection PhpUnused
*/
public static function loadFrom(string $path): void
{
self::$instance = unserialize(
file_get_contents($path),
[
'allowed_classes' => [
Configuration::class,
Php::class,
ConstantCollection::class,
Constant::class,
IniSettingCollection::class,
IniSetting::class,
VariableCollection::class,
Variable::class,
DirectoryCollection::class,
Directory::class,
FileCollection::class,
File::class,
FilterDirectoryCollection::class,
FilterDirectory::class,
TestDirectoryCollection::class,
TestDirectory::class,
TestFileCollection::class,
TestFile::class,
TestSuiteCollection::class,
TestSuite::class,
VersionComparisonOperator::class,
Source::class,
],
],
);
}
public static function get(): Configuration
{
assert(self::$instance instanceof Configuration);
return self::$instance;
}
/**
* @throws \PHPUnit\TextUI\XmlConfiguration\Exception
* @throws Exception
* @throws NoCustomCssFileException
*/
public static function init(CliConfiguration $cliConfiguration, XmlConfiguration $xmlConfiguration): Configuration
{
self::$instance = (new Merger)->merge($cliConfiguration, $xmlConfiguration);
EventFacade::emitter()->testRunnerConfigured(self::$instance);
return self::$instance;
}
}
src/TextUI/Configuration/PhpHandler.php 0000644 00000007300 15243426620 0014066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use const PATH_SEPARATOR;
use function constant;
use function define;
use function defined;
use function getenv;
use function implode;
use function ini_get;
use function ini_set;
use function putenv;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhpHandler
{
public function handle(Php $configuration): void
{
$this->handleIncludePaths($configuration->includePaths());
$this->handleIniSettings($configuration->iniSettings());
$this->handleConstants($configuration->constants());
$this->handleGlobalVariables($configuration->globalVariables());
$this->handleServerVariables($configuration->serverVariables());
$this->handleEnvVariables($configuration->envVariables());
$this->handleVariables('_POST', $configuration->postVariables());
$this->handleVariables('_GET', $configuration->getVariables());
$this->handleVariables('_COOKIE', $configuration->cookieVariables());
$this->handleVariables('_FILES', $configuration->filesVariables());
$this->handleVariables('_REQUEST', $configuration->requestVariables());
}
private function handleIncludePaths(DirectoryCollection $includePaths): void
{
if (!$includePaths->isEmpty()) {
$includePathsAsStrings = [];
foreach ($includePaths as $includePath) {
$includePathsAsStrings[] = $includePath->path();
}
ini_set(
'include_path',
implode(PATH_SEPARATOR, $includePathsAsStrings) .
PATH_SEPARATOR .
ini_get('include_path'),
);
}
}
private function handleIniSettings(IniSettingCollection $iniSettings): void
{
foreach ($iniSettings as $iniSetting) {
$value = $iniSetting->value();
if (defined($value)) {
$value = (string) constant($value);
}
ini_set($iniSetting->name(), $value);
}
}
private function handleConstants(ConstantCollection $constants): void
{
foreach ($constants as $constant) {
if (!defined($constant->name())) {
define($constant->name(), $constant->value());
}
}
}
private function handleGlobalVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$GLOBALS[$variable->name()] = $variable->value();
}
}
private function handleServerVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$_SERVER[$variable->name()] = $variable->value();
}
}
private function handleVariables(string $target, VariableCollection $variables): void
{
foreach ($variables as $variable) {
$GLOBALS[$target][$variable->name()] = $variable->value();
}
}
private function handleEnvVariables(VariableCollection $variables): void
{
foreach ($variables as $variable) {
$name = $variable->name();
$value = $variable->value();
$force = $variable->force();
if ($force || getenv($name) === false) {
putenv("{$name}={$value}");
}
$value = getenv($name);
if ($force || !isset($_ENV[$name])) {
$_ENV[$name] = $value;
}
}
}
}
src/TextUI/Configuration/Builder.php 0000644 00000003303 15243426620 0013426 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\TextUI\CliArguments\Builder as CliConfigurationBuilder;
use PHPUnit\TextUI\CliArguments\Exception as CliConfigurationException;
use PHPUnit\TextUI\CliArguments\XmlConfigurationFileFinder;
use PHPUnit\TextUI\XmlConfiguration\DefaultConfiguration;
use PHPUnit\TextUI\XmlConfiguration\Exception as XmlConfigurationException;
use PHPUnit\TextUI\XmlConfiguration\Loader;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @codeCoverageIgnore
*/
final class Builder
{
/**
* @throws ConfigurationCannotBeBuiltException
*/
public function build(array $argv): Configuration
{
try {
$cliConfiguration = (new CliConfigurationBuilder)->fromParameters($argv);
$configurationFile = (new XmlConfigurationFileFinder)->find($cliConfiguration);
$xmlConfiguration = DefaultConfiguration::create();
if ($configurationFile !== false) {
$xmlConfiguration = (new Loader)->load($configurationFile);
}
return Registry::init(
$cliConfiguration,
$xmlConfiguration,
);
} catch (CliConfigurationException|XmlConfigurationException $e) {
throw new ConfigurationCannotBeBuiltException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
}
src/TextUI/Configuration/Cli/Builder.php 0000644 00000067535 15243426620 0014156 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use function array_map;
use function basename;
use function explode;
use function getcwd;
use function is_file;
use function is_numeric;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Util\Filesystem;
use SebastianBergmann\CliParser\Exception as CliParserException;
use SebastianBergmann\CliParser\Parser as CliParser;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Builder
{
private const LONG_OPTIONS = [
'atleast-version=',
'bootstrap=',
'cache-result',
'do-not-cache-result',
'cache-directory=',
'cache-result-file=',
'check-version',
'colors==',
'columns=',
'configuration=',
'coverage-cache=',
'warm-coverage-cache',
'coverage-filter=',
'coverage-clover=',
'coverage-cobertura=',
'coverage-crap4j=',
'coverage-html=',
'coverage-php=',
'coverage-text==',
'coverage-xml=',
'path-coverage',
'disallow-test-output',
'display-incomplete',
'display-skipped',
'display-deprecations',
'display-errors',
'display-notices',
'display-warnings',
'default-time-limit=',
'enforce-time-limit',
'exclude-group=',
'filter=',
'generate-baseline=',
'use-baseline=',
'ignore-baseline',
'generate-configuration',
'globals-backup',
'group=',
'covers=',
'uses=',
'help',
'resolve-dependencies',
'ignore-dependencies',
'include-path=',
'list-groups',
'list-suites',
'list-tests',
'list-tests-xml=',
'log-junit=',
'log-teamcity=',
'migrate-configuration',
'no-configuration',
'no-coverage',
'no-logging',
'no-extensions',
'no-output',
'no-progress',
'no-results',
'order-by=',
'process-isolation',
'dont-report-useless-tests',
'random-order',
'random-order-seed=',
'reverse-order',
'reverse-list',
'static-backup',
'stderr',
'fail-on-deprecation',
'fail-on-empty-test-suite',
'fail-on-incomplete',
'fail-on-notice',
'fail-on-risky',
'fail-on-skipped',
'fail-on-warning',
'stop-on-defect',
'stop-on-deprecation',
'stop-on-error',
'stop-on-failure',
'stop-on-incomplete',
'stop-on-notice',
'stop-on-risky',
'stop-on-skipped',
'stop-on-warning',
'strict-coverage',
'disable-coverage-ignore',
'strict-global-state',
'teamcity',
'testdox',
'testdox-html=',
'testdox-text=',
'test-suffix=',
'testsuite=',
'exclude-testsuite=',
'log-events-text=',
'log-events-verbose-text=',
'version',
'debug',
];
private const SHORT_OPTIONS = 'd:c:h';
/**
* @psalm-var array<string, non-negative-int>
*/
private array $processed = [];
/**
* @throws Exception
*/
public function fromParameters(array $parameters): Configuration
{
try {
$options = (new CliParser)->parse(
$parameters,
self::SHORT_OPTIONS,
self::LONG_OPTIONS,
);
} catch (CliParserException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$atLeastVersion = null;
$backupGlobals = null;
$backupStaticProperties = null;
$beStrictAboutChangesToGlobalState = null;
$bootstrap = null;
$cacheDirectory = null;
$cacheResult = null;
$cacheResultFile = null;
$checkVersion = false;
$colors = null;
$columns = null;
$configuration = null;
$coverageCacheDirectory = null;
$warmCoverageCache = false;
$coverageFilter = null;
$coverageClover = null;
$coverageCobertura = null;
$coverageCrap4J = null;
$coverageHtml = null;
$coveragePhp = null;
$coverageText = null;
$coverageTextShowUncoveredFiles = null;
$coverageTextShowOnlySummary = null;
$coverageXml = null;
$pathCoverage = null;
$defaultTimeLimit = null;
$disableCodeCoverageIgnore = null;
$disallowTestOutput = null;
$displayIncomplete = null;
$displaySkipped = null;
$displayDeprecations = null;
$displayErrors = null;
$displayNotices = null;
$displayWarnings = null;
$enforceTimeLimit = null;
$excludeGroups = null;
$executionOrder = null;
$executionOrderDefects = null;
$failOnDeprecation = null;
$failOnEmptyTestSuite = null;
$failOnIncomplete = null;
$failOnNotice = null;
$failOnRisky = null;
$failOnSkipped = null;
$failOnWarning = null;
$stopOnDefect = null;
$stopOnDeprecation = null;
$stopOnError = null;
$stopOnFailure = null;
$stopOnIncomplete = null;
$stopOnNotice = null;
$stopOnRisky = null;
$stopOnSkipped = null;
$stopOnWarning = null;
$filter = null;
$generateBaseline = null;
$useBaseline = null;
$ignoreBaseline = false;
$generateConfiguration = false;
$migrateConfiguration = false;
$groups = null;
$testsCovering = null;
$testsUsing = null;
$help = false;
$includePath = null;
$iniSettings = [];
$junitLogfile = null;
$listGroups = false;
$listSuites = false;
$listTests = false;
$listTestsXml = null;
$noCoverage = null;
$noExtensions = null;
$noOutput = null;
$noProgress = null;
$noResults = null;
$noLogging = null;
$processIsolation = null;
$randomOrderSeed = null;
$reportUselessTests = null;
$resolveDependencies = null;
$reverseList = null;
$stderr = null;
$strictCoverage = null;
$teamcityLogfile = null;
$testdoxHtmlFile = null;
$testdoxTextFile = null;
$testSuffixes = null;
$testSuite = null;
$excludeTestSuite = null;
$useDefaultConfiguration = true;
$version = false;
$logEventsText = null;
$logEventsVerboseText = null;
$printerTeamCity = null;
$printerTestDox = null;
$debug = false;
foreach ($options[0] as $option) {
$optionAllowedMultipleTimes = false;
switch ($option[0]) {
case '--colors':
$colors = $option[1] ?: \PHPUnit\TextUI\Configuration\Configuration::COLOR_AUTO;
break;
case '--bootstrap':
$bootstrap = $option[1];
break;
case '--cache-directory':
$cacheDirectory = $option[1];
break;
case '--cache-result':
$cacheResult = true;
break;
case '--do-not-cache-result':
$cacheResult = false;
break;
case '--cache-result-file':
$cacheResultFile = $option[1];
break;
case '--columns':
if (is_numeric($option[1])) {
$columns = (int) $option[1];
} elseif ($option[1] === 'max') {
$columns = 'max';
}
break;
case 'c':
case '--configuration':
$configuration = $option[1];
break;
case '--coverage-cache':
$coverageCacheDirectory = $option[1];
break;
case '--warm-coverage-cache':
$warmCoverageCache = true;
break;
case '--coverage-clover':
$coverageClover = $option[1];
break;
case '--coverage-cobertura':
$coverageCobertura = $option[1];
break;
case '--coverage-crap4j':
$coverageCrap4J = $option[1];
break;
case '--coverage-html':
$coverageHtml = $option[1];
break;
case '--coverage-php':
$coveragePhp = $option[1];
break;
case '--coverage-text':
if ($option[1] === null) {
$option[1] = 'php://stdout';
}
$coverageText = $option[1];
$coverageTextShowUncoveredFiles = false;
$coverageTextShowOnlySummary = false;
break;
case '--coverage-xml':
$coverageXml = $option[1];
break;
case '--path-coverage':
$pathCoverage = true;
break;
case 'd':
$tmp = explode('=', $option[1]);
if (isset($tmp[0])) {
if (isset($tmp[1])) {
$iniSettings[$tmp[0]] = $tmp[1];
} else {
$iniSettings[$tmp[0]] = '1';
}
}
$optionAllowedMultipleTimes = true;
break;
case 'h':
case '--help':
$help = true;
break;
case '--filter':
$filter = $option[1];
break;
case '--testsuite':
$testSuite = $option[1];
break;
case '--exclude-testsuite':
$excludeTestSuite = $option[1];
break;
case '--generate-baseline':
$generateBaseline = $option[1];
if (basename($generateBaseline) === $generateBaseline) {
$generateBaseline = getcwd() . DIRECTORY_SEPARATOR . $generateBaseline;
}
break;
case '--use-baseline':
$useBaseline = $option[1];
if (basename($useBaseline) === $useBaseline && !is_file($useBaseline)) {
$useBaseline = getcwd() . DIRECTORY_SEPARATOR . $useBaseline;
}
break;
case '--ignore-baseline':
$ignoreBaseline = true;
break;
case '--generate-configuration':
$generateConfiguration = true;
break;
case '--migrate-configuration':
$migrateConfiguration = true;
break;
case '--group':
$groups = explode(',', $option[1]);
break;
case '--exclude-group':
$excludeGroups = explode(',', $option[1]);
break;
case '--covers':
$testsCovering = array_map('strtolower', explode(',', $option[1]));
break;
case '--uses':
$testsUsing = array_map('strtolower', explode(',', $option[1]));
break;
case '--test-suffix':
$testSuffixes = explode(',', $option[1]);
break;
case '--include-path':
$includePath = $option[1];
break;
case '--list-groups':
$listGroups = true;
break;
case '--list-suites':
$listSuites = true;
break;
case '--list-tests':
$listTests = true;
break;
case '--list-tests-xml':
$listTestsXml = $option[1];
break;
case '--log-junit':
$junitLogfile = $option[1];
break;
case '--log-teamcity':
$teamcityLogfile = $option[1];
break;
case '--order-by':
foreach (explode(',', $option[1]) as $order) {
switch ($order) {
case 'default':
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$executionOrderDefects = TestSuiteSorter::ORDER_DEFAULT;
$resolveDependencies = true;
break;
case 'defects':
$executionOrderDefects = TestSuiteSorter::ORDER_DEFECTS_FIRST;
break;
case 'depends':
$resolveDependencies = true;
break;
case 'duration':
$executionOrder = TestSuiteSorter::ORDER_DURATION;
break;
case 'no-depends':
$resolveDependencies = false;
break;
case 'random':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case 'reverse':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case 'size':
$executionOrder = TestSuiteSorter::ORDER_SIZE;
break;
default:
throw new Exception(
sprintf(
'unrecognized --order-by option: %s',
$order,
),
);
}
}
break;
case '--process-isolation':
$processIsolation = true;
break;
case '--stderr':
$stderr = true;
break;
case '--fail-on-deprecation':
$failOnDeprecation = true;
break;
case '--fail-on-empty-test-suite':
$failOnEmptyTestSuite = true;
break;
case '--fail-on-incomplete':
$failOnIncomplete = true;
break;
case '--fail-on-notice':
$failOnNotice = true;
break;
case '--fail-on-risky':
$failOnRisky = true;
break;
case '--fail-on-skipped':
$failOnSkipped = true;
break;
case '--fail-on-warning':
$failOnWarning = true;
break;
case '--stop-on-defect':
$stopOnDefect = true;
break;
case '--stop-on-deprecation':
$stopOnDeprecation = true;
break;
case '--stop-on-error':
$stopOnError = true;
break;
case '--stop-on-failure':
$stopOnFailure = true;
break;
case '--stop-on-incomplete':
$stopOnIncomplete = true;
break;
case '--stop-on-notice':
$stopOnNotice = true;
break;
case '--stop-on-risky':
$stopOnRisky = true;
break;
case '--stop-on-skipped':
$stopOnSkipped = true;
break;
case '--stop-on-warning':
$stopOnWarning = true;
break;
case '--teamcity':
$printerTeamCity = true;
break;
case '--testdox':
$printerTestDox = true;
break;
case '--testdox-html':
$testdoxHtmlFile = $option[1];
break;
case '--testdox-text':
$testdoxTextFile = $option[1];
break;
case '--no-configuration':
$useDefaultConfiguration = false;
break;
case '--no-extensions':
$noExtensions = true;
break;
case '--no-coverage':
$noCoverage = true;
break;
case '--no-logging':
$noLogging = true;
break;
case '--no-output':
$noOutput = true;
break;
case '--no-progress':
$noProgress = true;
break;
case '--no-results':
$noResults = true;
break;
case '--globals-backup':
$backupGlobals = true;
break;
case '--static-backup':
$backupStaticProperties = true;
break;
case '--atleast-version':
$atLeastVersion = $option[1];
break;
case '--version':
$version = true;
break;
case '--dont-report-useless-tests':
$reportUselessTests = false;
break;
case '--strict-coverage':
$strictCoverage = true;
break;
case '--disable-coverage-ignore':
$disableCodeCoverageIgnore = true;
break;
case '--strict-global-state':
$beStrictAboutChangesToGlobalState = true;
break;
case '--disallow-test-output':
$disallowTestOutput = true;
break;
case '--display-incomplete':
$displayIncomplete = true;
break;
case '--display-skipped':
$displaySkipped = true;
break;
case '--display-deprecations':
$displayDeprecations = true;
break;
case '--display-errors':
$displayErrors = true;
break;
case '--display-notices':
$displayNotices = true;
break;
case '--display-warnings':
$displayWarnings = true;
break;
case '--default-time-limit':
$defaultTimeLimit = (int) $option[1];
break;
case '--enforce-time-limit':
$enforceTimeLimit = true;
break;
case '--reverse-list':
$reverseList = true;
break;
case '--check-version':
$checkVersion = true;
break;
case '--coverage-filter':
if ($coverageFilter === null) {
$coverageFilter = [];
}
$coverageFilter[] = $option[1];
break;
case '--random-order':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case '--random-order-seed':
$randomOrderSeed = (int) $option[1];
break;
case '--resolve-dependencies':
$resolveDependencies = true;
break;
case '--ignore-dependencies':
$resolveDependencies = false;
break;
case '--reverse-order':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case '--log-events-text':
$logEventsText = Filesystem::resolveStreamOrFile($option[1]);
if ($logEventsText === false) {
throw new Exception(
sprintf(
'The path "%s" specified for the --log-events-text option could not be resolved',
$option[1],
),
);
}
break;
case '--log-events-verbose-text':
$logEventsVerboseText = Filesystem::resolveStreamOrFile($option[1]);
if ($logEventsVerboseText === false) {
throw new Exception(
sprintf(
'The path "%s" specified for the --log-events-verbose-text option could not be resolved',
$option[1],
),
);
}
break;
case '--debug':
$debug = true;
break;
}
if (!$optionAllowedMultipleTimes) {
$this->markProcessed($option[0]);
}
}
if (empty($iniSettings)) {
$iniSettings = null;
}
if (empty($coverageFilter)) {
$coverageFilter = null;
}
return new Configuration(
$options[1],
$atLeastVersion,
$backupGlobals,
$backupStaticProperties,
$beStrictAboutChangesToGlobalState,
$bootstrap,
$cacheDirectory,
$cacheResult,
$cacheResultFile,
$checkVersion,
$colors,
$columns,
$configuration,
$coverageClover,
$coverageCobertura,
$coverageCrap4J,
$coverageHtml,
$coveragePhp,
$coverageText,
$coverageTextShowUncoveredFiles,
$coverageTextShowOnlySummary,
$coverageXml,
$pathCoverage,
$coverageCacheDirectory,
$warmCoverageCache,
$defaultTimeLimit,
$disableCodeCoverageIgnore,
$disallowTestOutput,
$enforceTimeLimit,
$excludeGroups,
$executionOrder,
$executionOrderDefects,
$failOnDeprecation,
$failOnEmptyTestSuite,
$failOnIncomplete,
$failOnNotice,
$failOnRisky,
$failOnSkipped,
$failOnWarning,
$stopOnDefect,
$stopOnDeprecation,
$stopOnError,
$stopOnFailure,
$stopOnIncomplete,
$stopOnNotice,
$stopOnRisky,
$stopOnSkipped,
$stopOnWarning,
$filter,
$generateBaseline,
$useBaseline,
$ignoreBaseline,
$generateConfiguration,
$migrateConfiguration,
$groups,
$testsCovering,
$testsUsing,
$help,
$includePath,
$iniSettings,
$junitLogfile,
$listGroups,
$listSuites,
$listTests,
$listTestsXml,
$noCoverage,
$noExtensions,
$noOutput,
$noProgress,
$noResults,
$noLogging,
$processIsolation,
$randomOrderSeed,
$reportUselessTests,
$resolveDependencies,
$reverseList,
$stderr,
$strictCoverage,
$teamcityLogfile,
$testdoxHtmlFile,
$testdoxTextFile,
$testSuffixes,
$testSuite,
$excludeTestSuite,
$useDefaultConfiguration,
$displayIncomplete,
$displaySkipped,
$displayDeprecations,
$displayErrors,
$displayNotices,
$displayWarnings,
$version,
$coverageFilter,
$logEventsText,
$logEventsVerboseText,
$printerTeamCity,
$printerTestDox,
$debug,
);
}
/**
* @psalm-param non-empty-string $option
*/
private function markProcessed(string $option): void
{
if (!isset($this->processed[$option])) {
$this->processed[$option] = 1;
return;
}
$this->processed[$option]++;
if ($this->processed[$option] === 2) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Option %s cannot be used more than once',
$option,
),
);
}
}
}
src/TextUI/Configuration/Cli/Configuration.php 0000644 00000145325 15243426620 0015371 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Configuration
{
/**
* @psalm-var list<non-empty-string>
*/
private readonly array $arguments;
private readonly ?string $atLeastVersion;
private readonly ?bool $backupGlobals;
private readonly ?bool $backupStaticProperties;
private readonly ?bool $beStrictAboutChangesToGlobalState;
private readonly ?string $bootstrap;
private readonly ?string $cacheDirectory;
private readonly ?bool $cacheResult;
private readonly ?string $cacheResultFile;
private readonly bool $checkVersion;
private readonly ?string $colors;
private readonly null|int|string $columns;
private readonly ?string $configurationFile;
private readonly ?array $coverageFilter;
private readonly ?string $coverageClover;
private readonly ?string $coverageCobertura;
private readonly ?string $coverageCrap4J;
private readonly ?string $coverageHtml;
private readonly ?string $coveragePhp;
private readonly ?string $coverageText;
private readonly ?bool $coverageTextShowUncoveredFiles;
private readonly ?bool $coverageTextShowOnlySummary;
private readonly ?string $coverageXml;
private readonly ?bool $pathCoverage;
private readonly ?string $coverageCacheDirectory;
private readonly bool $warmCoverageCache;
private readonly ?int $defaultTimeLimit;
private readonly ?bool $disableCodeCoverageIgnore;
private readonly ?bool $disallowTestOutput;
private readonly ?bool $enforceTimeLimit;
private readonly ?array $excludeGroups;
private readonly ?int $executionOrder;
private readonly ?int $executionOrderDefects;
private readonly ?bool $failOnDeprecation;
private readonly ?bool $failOnEmptyTestSuite;
private readonly ?bool $failOnIncomplete;
private readonly ?bool $failOnNotice;
private readonly ?bool $failOnRisky;
private readonly ?bool $failOnSkipped;
private readonly ?bool $failOnWarning;
private readonly ?bool $stopOnDefect;
private readonly ?bool $stopOnDeprecation;
private readonly ?bool $stopOnError;
private readonly ?bool $stopOnFailure;
private readonly ?bool $stopOnIncomplete;
private readonly ?bool $stopOnNotice;
private readonly ?bool $stopOnRisky;
private readonly ?bool $stopOnSkipped;
private readonly ?bool $stopOnWarning;
private readonly ?string $filter;
private readonly ?string $generateBaseline;
private readonly ?string $useBaseline;
private readonly bool $ignoreBaseline;
private readonly bool $generateConfiguration;
private readonly bool $migrateConfiguration;
private readonly ?array $groups;
private readonly ?array $testsCovering;
private readonly ?array $testsUsing;
private readonly bool $help;
private readonly ?string $includePath;
private readonly ?array $iniSettings;
private readonly ?string $junitLogfile;
private readonly bool $listGroups;
private readonly bool $listSuites;
private readonly bool $listTests;
private readonly ?string $listTestsXml;
private readonly ?bool $noCoverage;
private readonly ?bool $noExtensions;
private readonly ?bool $noOutput;
private readonly ?bool $noProgress;
private readonly ?bool $noResults;
private readonly ?bool $noLogging;
private readonly ?bool $processIsolation;
private readonly ?int $randomOrderSeed;
private readonly ?bool $reportUselessTests;
private readonly ?bool $resolveDependencies;
private readonly ?bool $reverseList;
private readonly ?bool $stderr;
private readonly ?bool $strictCoverage;
private readonly ?string $teamcityLogfile;
private readonly ?bool $teamCityPrinter;
private readonly ?string $testdoxHtmlFile;
private readonly ?string $testdoxTextFile;
private readonly ?bool $testdoxPrinter;
/**
* @psalm-var ?non-empty-list<non-empty-string>
*/
private readonly ?array $testSuffixes;
private readonly ?string $testSuite;
private readonly ?string $excludeTestSuite;
private readonly bool $useDefaultConfiguration;
private readonly ?bool $displayDetailsOnIncompleteTests;
private readonly ?bool $displayDetailsOnSkippedTests;
private readonly ?bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly ?bool $displayDetailsOnTestsThatTriggerErrors;
private readonly ?bool $displayDetailsOnTestsThatTriggerNotices;
private readonly ?bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $version;
private readonly ?string $logEventsText;
private readonly ?string $logEventsVerboseText;
private readonly bool $debug;
/**
* @psalm-param list<non-empty-string> $arguments
* @psalm-param ?non-empty-list<non-empty-string> $testSuffixes
*/
public function __construct(array $arguments, ?string $atLeastVersion, ?bool $backupGlobals, ?bool $backupStaticProperties, ?bool $beStrictAboutChangesToGlobalState, ?string $bootstrap, ?string $cacheDirectory, ?bool $cacheResult, ?string $cacheResultFile, bool $checkVersion, ?string $colors, null|int|string $columns, ?string $configurationFile, ?string $coverageClover, ?string $coverageCobertura, ?string $coverageCrap4J, ?string $coverageHtml, ?string $coveragePhp, ?string $coverageText, ?bool $coverageTextShowUncoveredFiles, ?bool $coverageTextShowOnlySummary, ?string $coverageXml, ?bool $pathCoverage, ?string $coverageCacheDirectory, bool $warmCoverageCache, ?int $defaultTimeLimit, ?bool $disableCodeCoverageIgnore, ?bool $disallowTestOutput, ?bool $enforceTimeLimit, ?array $excludeGroups, ?int $executionOrder, ?int $executionOrderDefects, ?bool $failOnDeprecation, ?bool $failOnEmptyTestSuite, ?bool $failOnIncomplete, ?bool $failOnNotice, ?bool $failOnRisky, ?bool $failOnSkipped, ?bool $failOnWarning, ?bool $stopOnDefect, ?bool $stopOnDeprecation, ?bool $stopOnError, ?bool $stopOnFailure, ?bool $stopOnIncomplete, ?bool $stopOnNotice, ?bool $stopOnRisky, ?bool $stopOnSkipped, ?bool $stopOnWarning, ?string $filter, ?string $generateBaseline, ?string $useBaseline, bool $ignoreBaseline, bool $generateConfiguration, bool $migrateConfiguration, ?array $groups, ?array $testsCovering, ?array $testsUsing, bool $help, ?string $includePath, ?array $iniSettings, ?string $junitLogfile, bool $listGroups, bool $listSuites, bool $listTests, ?string $listTestsXml, ?bool $noCoverage, ?bool $noExtensions, ?bool $noOutput, ?bool $noProgress, ?bool $noResults, ?bool $noLogging, ?bool $processIsolation, ?int $randomOrderSeed, ?bool $reportUselessTests, ?bool $resolveDependencies, ?bool $reverseList, ?bool $stderr, ?bool $strictCoverage, ?string $teamcityLogfile, ?string $testdoxHtmlFile, ?string $testdoxTextFile, ?array $testSuffixes, ?string $testSuite, ?string $excludeTestSuite, bool $useDefaultConfiguration, ?bool $displayDetailsOnIncompleteTests, ?bool $displayDetailsOnSkippedTests, ?bool $displayDetailsOnTestsThatTriggerDeprecations, ?bool $displayDetailsOnTestsThatTriggerErrors, ?bool $displayDetailsOnTestsThatTriggerNotices, ?bool $displayDetailsOnTestsThatTriggerWarnings, bool $version, ?array $coverageFilter, ?string $logEventsText, ?string $logEventsVerboseText, ?bool $printerTeamCity, ?bool $printerTestDox, bool $debug)
{
$this->arguments = $arguments;
$this->atLeastVersion = $atLeastVersion;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->bootstrap = $bootstrap;
$this->cacheDirectory = $cacheDirectory;
$this->cacheResult = $cacheResult;
$this->cacheResultFile = $cacheResultFile;
$this->checkVersion = $checkVersion;
$this->colors = $colors;
$this->columns = $columns;
$this->configurationFile = $configurationFile;
$this->coverageFilter = $coverageFilter;
$this->coverageClover = $coverageClover;
$this->coverageCobertura = $coverageCobertura;
$this->coverageCrap4J = $coverageCrap4J;
$this->coverageHtml = $coverageHtml;
$this->coveragePhp = $coveragePhp;
$this->coverageText = $coverageText;
$this->coverageTextShowUncoveredFiles = $coverageTextShowUncoveredFiles;
$this->coverageTextShowOnlySummary = $coverageTextShowOnlySummary;
$this->coverageXml = $coverageXml;
$this->pathCoverage = $pathCoverage;
$this->coverageCacheDirectory = $coverageCacheDirectory;
$this->warmCoverageCache = $warmCoverageCache;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->disallowTestOutput = $disallowTestOutput;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->excludeGroups = $excludeGroups;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->filter = $filter;
$this->generateBaseline = $generateBaseline;
$this->useBaseline = $useBaseline;
$this->ignoreBaseline = $ignoreBaseline;
$this->generateConfiguration = $generateConfiguration;
$this->migrateConfiguration = $migrateConfiguration;
$this->groups = $groups;
$this->testsCovering = $testsCovering;
$this->testsUsing = $testsUsing;
$this->help = $help;
$this->includePath = $includePath;
$this->iniSettings = $iniSettings;
$this->junitLogfile = $junitLogfile;
$this->listGroups = $listGroups;
$this->listSuites = $listSuites;
$this->listTests = $listTests;
$this->listTestsXml = $listTestsXml;
$this->noCoverage = $noCoverage;
$this->noExtensions = $noExtensions;
$this->noOutput = $noOutput;
$this->noProgress = $noProgress;
$this->noResults = $noResults;
$this->noLogging = $noLogging;
$this->processIsolation = $processIsolation;
$this->randomOrderSeed = $randomOrderSeed;
$this->reportUselessTests = $reportUselessTests;
$this->resolveDependencies = $resolveDependencies;
$this->reverseList = $reverseList;
$this->stderr = $stderr;
$this->strictCoverage = $strictCoverage;
$this->teamcityLogfile = $teamcityLogfile;
$this->testdoxHtmlFile = $testdoxHtmlFile;
$this->testdoxTextFile = $testdoxTextFile;
$this->testSuffixes = $testSuffixes;
$this->testSuite = $testSuite;
$this->excludeTestSuite = $excludeTestSuite;
$this->useDefaultConfiguration = $useDefaultConfiguration;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->version = $version;
$this->logEventsText = $logEventsText;
$this->logEventsVerboseText = $logEventsVerboseText;
$this->teamCityPrinter = $printerTeamCity;
$this->testdoxPrinter = $printerTestDox;
$this->debug = $debug;
}
/**
* @psalm-return list<non-empty-string>
*/
public function arguments(): array
{
return $this->arguments;
}
/**
* @psalm-assert-if-true !null $this->atLeastVersion
*/
public function hasAtLeastVersion(): bool
{
return $this->atLeastVersion !== null;
}
/**
* @throws Exception
*/
public function atLeastVersion(): string
{
if (!$this->hasAtLeastVersion()) {
throw new Exception;
}
return $this->atLeastVersion;
}
/**
* @psalm-assert-if-true !null $this->backupGlobals
*/
public function hasBackupGlobals(): bool
{
return $this->backupGlobals !== null;
}
/**
* @throws Exception
*/
public function backupGlobals(): bool
{
if (!$this->hasBackupGlobals()) {
throw new Exception;
}
return $this->backupGlobals;
}
/**
* @psalm-assert-if-true !null $this->backupStaticProperties
*/
public function hasBackupStaticProperties(): bool
{
return $this->backupStaticProperties !== null;
}
/**
* @throws Exception
*/
public function backupStaticProperties(): bool
{
if (!$this->hasBackupStaticProperties()) {
throw new Exception;
}
return $this->backupStaticProperties;
}
/**
* @psalm-assert-if-true !null $this->beStrictAboutChangesToGlobalState
*/
public function hasBeStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState !== null;
}
/**
* @throws Exception
*/
public function beStrictAboutChangesToGlobalState(): bool
{
if (!$this->hasBeStrictAboutChangesToGlobalState()) {
throw new Exception;
}
return $this->beStrictAboutChangesToGlobalState;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws Exception
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new Exception;
}
return $this->bootstrap;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new Exception;
}
return $this->cacheDirectory;
}
/**
* @psalm-assert-if-true !null $this->cacheResult
*/
public function hasCacheResult(): bool
{
return $this->cacheResult !== null;
}
/**
* @throws Exception
*/
public function cacheResult(): bool
{
if (!$this->hasCacheResult()) {
throw new Exception;
}
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheResultFile
*
* @deprecated
*/
public function hasCacheResultFile(): bool
{
return $this->cacheResultFile !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheResultFile(): string
{
if (!$this->hasCacheResultFile()) {
throw new Exception;
}
return $this->cacheResultFile;
}
public function checkVersion(): bool
{
return $this->checkVersion;
}
/**
* @psalm-assert-if-true !null $this->colors
*/
public function hasColors(): bool
{
return $this->colors !== null;
}
/**
* @throws Exception
*/
public function colors(): string
{
if (!$this->hasColors()) {
throw new Exception;
}
return $this->colors;
}
/**
* @psalm-assert-if-true !null $this->columns
*/
public function hasColumns(): bool
{
return $this->columns !== null;
}
/**
* @throws Exception
*/
public function columns(): int|string
{
if (!$this->hasColumns()) {
throw new Exception;
}
return $this->columns;
}
/**
* @psalm-assert-if-true !null $this->configurationFile
*/
public function hasConfigurationFile(): bool
{
return $this->configurationFile !== null;
}
/**
* @throws Exception
*/
public function configurationFile(): string
{
if (!$this->hasConfigurationFile()) {
throw new Exception;
}
return $this->configurationFile;
}
/**
* @psalm-assert-if-true !null $this->coverageFilter
*/
public function hasCoverageFilter(): bool
{
return $this->coverageFilter !== null;
}
/**
* @throws Exception
*/
public function coverageFilter(): array
{
if (!$this->hasCoverageFilter()) {
throw new Exception;
}
return $this->coverageFilter;
}
/**
* @psalm-assert-if-true !null $this->coverageClover
*/
public function hasCoverageClover(): bool
{
return $this->coverageClover !== null;
}
/**
* @throws Exception
*/
public function coverageClover(): string
{
if (!$this->hasCoverageClover()) {
throw new Exception;
}
return $this->coverageClover;
}
/**
* @psalm-assert-if-true !null $this->coverageCobertura
*/
public function hasCoverageCobertura(): bool
{
return $this->coverageCobertura !== null;
}
/**
* @throws Exception
*/
public function coverageCobertura(): string
{
if (!$this->hasCoverageCobertura()) {
throw new Exception;
}
return $this->coverageCobertura;
}
/**
* @psalm-assert-if-true !null $this->coverageCrap4J
*/
public function hasCoverageCrap4J(): bool
{
return $this->coverageCrap4J !== null;
}
/**
* @throws Exception
*/
public function coverageCrap4J(): string
{
if (!$this->hasCoverageCrap4J()) {
throw new Exception;
}
return $this->coverageCrap4J;
}
/**
* @psalm-assert-if-true !null $this->coverageHtml
*/
public function hasCoverageHtml(): bool
{
return $this->coverageHtml !== null;
}
/**
* @throws Exception
*/
public function coverageHtml(): string
{
if (!$this->hasCoverageHtml()) {
throw new Exception;
}
return $this->coverageHtml;
}
/**
* @psalm-assert-if-true !null $this->coveragePhp
*/
public function hasCoveragePhp(): bool
{
return $this->coveragePhp !== null;
}
/**
* @throws Exception
*/
public function coveragePhp(): string
{
if (!$this->hasCoveragePhp()) {
throw new Exception;
}
return $this->coveragePhp;
}
/**
* @psalm-assert-if-true !null $this->coverageText
*/
public function hasCoverageText(): bool
{
return $this->coverageText !== null;
}
/**
* @throws Exception
*/
public function coverageText(): string
{
if (!$this->hasCoverageText()) {
throw new Exception;
}
return $this->coverageText;
}
/**
* @psalm-assert-if-true !null $this->coverageTextShowUncoveredFiles
*/
public function hasCoverageTextShowUncoveredFiles(): bool
{
return $this->coverageTextShowUncoveredFiles !== null;
}
/**
* @throws Exception
*/
public function coverageTextShowUncoveredFiles(): bool
{
if (!$this->hasCoverageTextShowUncoveredFiles()) {
throw new Exception;
}
return $this->coverageTextShowUncoveredFiles;
}
/**
* @psalm-assert-if-true !null $this->coverageTextShowOnlySummary
*/
public function hasCoverageTextShowOnlySummary(): bool
{
return $this->coverageTextShowOnlySummary !== null;
}
/**
* @throws Exception
*/
public function coverageTextShowOnlySummary(): bool
{
if (!$this->hasCoverageTextShowOnlySummary()) {
throw new Exception;
}
return $this->coverageTextShowOnlySummary;
}
/**
* @psalm-assert-if-true !null $this->coverageXml
*/
public function hasCoverageXml(): bool
{
return $this->coverageXml !== null;
}
/**
* @throws Exception
*/
public function coverageXml(): string
{
if (!$this->hasCoverageXml()) {
throw new Exception;
}
return $this->coverageXml;
}
/**
* @psalm-assert-if-true !null $this->pathCoverage
*/
public function hasPathCoverage(): bool
{
return $this->pathCoverage !== null;
}
/**
* @throws Exception
*/
public function pathCoverage(): bool
{
if (!$this->hasPathCoverage()) {
throw new Exception;
}
return $this->pathCoverage;
}
/**
* @psalm-assert-if-true !null $this->coverageCacheDirectory
*
* @deprecated
*/
public function hasCoverageCacheDirectory(): bool
{
return $this->coverageCacheDirectory !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function coverageCacheDirectory(): string
{
if (!$this->hasCoverageCacheDirectory()) {
throw new Exception;
}
return $this->coverageCacheDirectory;
}
public function warmCoverageCache(): bool
{
return $this->warmCoverageCache;
}
/**
* @psalm-assert-if-true !null $this->defaultTimeLimit
*/
public function hasDefaultTimeLimit(): bool
{
return $this->defaultTimeLimit !== null;
}
/**
* @throws Exception
*/
public function defaultTimeLimit(): int
{
if (!$this->hasDefaultTimeLimit()) {
throw new Exception;
}
return $this->defaultTimeLimit;
}
/**
* @psalm-assert-if-true !null $this->disableCodeCoverageIgnore
*/
public function hasDisableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore !== null;
}
/**
* @throws Exception
*/
public function disableCodeCoverageIgnore(): bool
{
if (!$this->hasDisableCodeCoverageIgnore()) {
throw new Exception;
}
return $this->disableCodeCoverageIgnore;
}
/**
* @psalm-assert-if-true !null $this->disallowTestOutput
*/
public function hasDisallowTestOutput(): bool
{
return $this->disallowTestOutput !== null;
}
/**
* @throws Exception
*/
public function disallowTestOutput(): bool
{
if (!$this->hasDisallowTestOutput()) {
throw new Exception;
}
return $this->disallowTestOutput;
}
/**
* @psalm-assert-if-true !null $this->enforceTimeLimit
*/
public function hasEnforceTimeLimit(): bool
{
return $this->enforceTimeLimit !== null;
}
/**
* @throws Exception
*/
public function enforceTimeLimit(): bool
{
if (!$this->hasEnforceTimeLimit()) {
throw new Exception;
}
return $this->enforceTimeLimit;
}
/**
* @psalm-assert-if-true !null $this->excludeGroups
*/
public function hasExcludeGroups(): bool
{
return $this->excludeGroups !== null;
}
/**
* @throws Exception
*/
public function excludeGroups(): array
{
if (!$this->hasExcludeGroups()) {
throw new Exception;
}
return $this->excludeGroups;
}
/**
* @psalm-assert-if-true !null $this->executionOrder
*/
public function hasExecutionOrder(): bool
{
return $this->executionOrder !== null;
}
/**
* @throws Exception
*/
public function executionOrder(): int
{
if (!$this->hasExecutionOrder()) {
throw new Exception;
}
return $this->executionOrder;
}
/**
* @psalm-assert-if-true !null $this->executionOrderDefects
*/
public function hasExecutionOrderDefects(): bool
{
return $this->executionOrderDefects !== null;
}
/**
* @throws Exception
*/
public function executionOrderDefects(): int
{
if (!$this->hasExecutionOrderDefects()) {
throw new Exception;
}
return $this->executionOrderDefects;
}
/**
* @psalm-assert-if-true !null $this->failOnDeprecation
*/
public function hasFailOnDeprecation(): bool
{
return $this->failOnDeprecation !== null;
}
/**
* @throws Exception
*/
public function failOnDeprecation(): bool
{
if (!$this->hasFailOnDeprecation()) {
throw new Exception;
}
return $this->failOnDeprecation;
}
/**
* @psalm-assert-if-true !null $this->failOnEmptyTestSuite
*/
public function hasFailOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite !== null;
}
/**
* @throws Exception
*/
public function failOnEmptyTestSuite(): bool
{
if (!$this->hasFailOnEmptyTestSuite()) {
throw new Exception;
}
return $this->failOnEmptyTestSuite;
}
/**
* @psalm-assert-if-true !null $this->failOnIncomplete
*/
public function hasFailOnIncomplete(): bool
{
return $this->failOnIncomplete !== null;
}
/**
* @throws Exception
*/
public function failOnIncomplete(): bool
{
if (!$this->hasFailOnIncomplete()) {
throw new Exception;
}
return $this->failOnIncomplete;
}
/**
* @psalm-assert-if-true !null $this->failOnNotice
*/
public function hasFailOnNotice(): bool
{
return $this->failOnNotice !== null;
}
/**
* @throws Exception
*/
public function failOnNotice(): bool
{
if (!$this->hasFailOnNotice()) {
throw new Exception;
}
return $this->failOnNotice;
}
/**
* @psalm-assert-if-true !null $this->failOnRisky
*/
public function hasFailOnRisky(): bool
{
return $this->failOnRisky !== null;
}
/**
* @throws Exception
*/
public function failOnRisky(): bool
{
if (!$this->hasFailOnRisky()) {
throw new Exception;
}
return $this->failOnRisky;
}
/**
* @psalm-assert-if-true !null $this->failOnSkipped
*/
public function hasFailOnSkipped(): bool
{
return $this->failOnSkipped !== null;
}
/**
* @throws Exception
*/
public function failOnSkipped(): bool
{
if (!$this->hasFailOnSkipped()) {
throw new Exception;
}
return $this->failOnSkipped;
}
/**
* @psalm-assert-if-true !null $this->failOnWarning
*/
public function hasFailOnWarning(): bool
{
return $this->failOnWarning !== null;
}
/**
* @throws Exception
*/
public function failOnWarning(): bool
{
if (!$this->hasFailOnWarning()) {
throw new Exception;
}
return $this->failOnWarning;
}
/**
* @psalm-assert-if-true !null $this->stopOnDefect
*/
public function hasStopOnDefect(): bool
{
return $this->stopOnDefect !== null;
}
/**
* @throws Exception
*/
public function stopOnDefect(): bool
{
if (!$this->hasStopOnDefect()) {
throw new Exception;
}
return $this->stopOnDefect;
}
/**
* @psalm-assert-if-true !null $this->stopOnDeprecation
*/
public function hasStopOnDeprecation(): bool
{
return $this->stopOnDeprecation !== null;
}
/**
* @throws Exception
*/
public function stopOnDeprecation(): bool
{
if (!$this->hasStopOnDeprecation()) {
throw new Exception;
}
return $this->stopOnDeprecation;
}
/**
* @psalm-assert-if-true !null $this->stopOnError
*/
public function hasStopOnError(): bool
{
return $this->stopOnError !== null;
}
/**
* @throws Exception
*/
public function stopOnError(): bool
{
if (!$this->hasStopOnError()) {
throw new Exception;
}
return $this->stopOnError;
}
/**
* @psalm-assert-if-true !null $this->stopOnFailure
*/
public function hasStopOnFailure(): bool
{
return $this->stopOnFailure !== null;
}
/**
* @throws Exception
*/
public function stopOnFailure(): bool
{
if (!$this->hasStopOnFailure()) {
throw new Exception;
}
return $this->stopOnFailure;
}
/**
* @psalm-assert-if-true !null $this->stopOnIncomplete
*/
public function hasStopOnIncomplete(): bool
{
return $this->stopOnIncomplete !== null;
}
/**
* @throws Exception
*/
public function stopOnIncomplete(): bool
{
if (!$this->hasStopOnIncomplete()) {
throw new Exception;
}
return $this->stopOnIncomplete;
}
/**
* @psalm-assert-if-true !null $this->stopOnNotice
*/
public function hasStopOnNotice(): bool
{
return $this->stopOnNotice !== null;
}
/**
* @throws Exception
*/
public function stopOnNotice(): bool
{
if (!$this->hasStopOnNotice()) {
throw new Exception;
}
return $this->stopOnNotice;
}
/**
* @psalm-assert-if-true !null $this->stopOnRisky
*/
public function hasStopOnRisky(): bool
{
return $this->stopOnRisky !== null;
}
/**
* @throws Exception
*/
public function stopOnRisky(): bool
{
if (!$this->hasStopOnRisky()) {
throw new Exception;
}
return $this->stopOnRisky;
}
/**
* @psalm-assert-if-true !null $this->stopOnSkipped
*/
public function hasStopOnSkipped(): bool
{
return $this->stopOnSkipped !== null;
}
/**
* @throws Exception
*/
public function stopOnSkipped(): bool
{
if (!$this->hasStopOnSkipped()) {
throw new Exception;
}
return $this->stopOnSkipped;
}
/**
* @psalm-assert-if-true !null $this->stopOnWarning
*/
public function hasStopOnWarning(): bool
{
return $this->stopOnWarning !== null;
}
/**
* @throws Exception
*/
public function stopOnWarning(): bool
{
if (!$this->hasStopOnWarning()) {
throw new Exception;
}
return $this->stopOnWarning;
}
/**
* @psalm-assert-if-true !null $this->filter
*/
public function hasFilter(): bool
{
return $this->filter !== null;
}
/**
* @throws Exception
*/
public function filter(): string
{
if (!$this->hasFilter()) {
throw new Exception;
}
return $this->filter;
}
/**
* @psalm-assert-if-true !null $this->generateBaseline
*/
public function hasGenerateBaseline(): bool
{
return $this->generateBaseline !== null;
}
/**
* @throws Exception
*/
public function generateBaseline(): string
{
if (!$this->hasGenerateBaseline()) {
throw new Exception;
}
return $this->generateBaseline;
}
/**
* @psalm-assert-if-true !null $this->useBaseline
*/
public function hasUseBaseline(): bool
{
return $this->useBaseline !== null;
}
/**
* @throws Exception
*/
public function useBaseline(): string
{
if (!$this->hasUseBaseline()) {
throw new Exception;
}
return $this->useBaseline;
}
public function ignoreBaseline(): bool
{
return $this->ignoreBaseline;
}
public function generateConfiguration(): bool
{
return $this->generateConfiguration;
}
public function migrateConfiguration(): bool
{
return $this->migrateConfiguration;
}
/**
* @psalm-assert-if-true !null $this->groups
*/
public function hasGroups(): bool
{
return $this->groups !== null;
}
/**
* @throws Exception
*/
public function groups(): array
{
if (!$this->hasGroups()) {
throw new Exception;
}
return $this->groups;
}
/**
* @psalm-assert-if-true !null $this->testsCovering
*/
public function hasTestsCovering(): bool
{
return $this->testsCovering !== null;
}
/**
* @throws Exception
*/
public function testsCovering(): array
{
if (!$this->hasTestsCovering()) {
throw new Exception;
}
return $this->testsCovering;
}
/**
* @psalm-assert-if-true !null $this->testsUsing
*/
public function hasTestsUsing(): bool
{
return $this->testsUsing !== null;
}
/**
* @throws Exception
*/
public function testsUsing(): array
{
if (!$this->hasTestsUsing()) {
throw new Exception;
}
return $this->testsUsing;
}
public function help(): bool
{
return $this->help;
}
/**
* @psalm-assert-if-true !null $this->includePath
*/
public function hasIncludePath(): bool
{
return $this->includePath !== null;
}
/**
* @throws Exception
*/
public function includePath(): string
{
if (!$this->hasIncludePath()) {
throw new Exception;
}
return $this->includePath;
}
/**
* @psalm-assert-if-true !null $this->iniSettings
*/
public function hasIniSettings(): bool
{
return $this->iniSettings !== null;
}
/**
* @throws Exception
*/
public function iniSettings(): array
{
if (!$this->hasIniSettings()) {
throw new Exception;
}
return $this->iniSettings;
}
/**
* @psalm-assert-if-true !null $this->junitLogfile
*/
public function hasJunitLogfile(): bool
{
return $this->junitLogfile !== null;
}
/**
* @throws Exception
*/
public function junitLogfile(): string
{
if (!$this->hasJunitLogfile()) {
throw new Exception;
}
return $this->junitLogfile;
}
public function listGroups(): bool
{
return $this->listGroups;
}
public function listSuites(): bool
{
return $this->listSuites;
}
public function listTests(): bool
{
return $this->listTests;
}
/**
* @psalm-assert-if-true !null $this->listTestsXml
*/
public function hasListTestsXml(): bool
{
return $this->listTestsXml !== null;
}
/**
* @throws Exception
*/
public function listTestsXml(): string
{
if (!$this->hasListTestsXml()) {
throw new Exception;
}
return $this->listTestsXml;
}
/**
* @psalm-assert-if-true !null $this->noCoverage
*/
public function hasNoCoverage(): bool
{
return $this->noCoverage !== null;
}
/**
* @throws Exception
*/
public function noCoverage(): bool
{
if (!$this->hasNoCoverage()) {
throw new Exception;
}
return $this->noCoverage;
}
/**
* @psalm-assert-if-true !null $this->noExtensions
*/
public function hasNoExtensions(): bool
{
return $this->noExtensions !== null;
}
/**
* @throws Exception
*/
public function noExtensions(): bool
{
if (!$this->hasNoExtensions()) {
throw new Exception;
}
return $this->noExtensions;
}
/**
* @psalm-assert-if-true !null $this->noOutput
*/
public function hasNoOutput(): bool
{
return $this->noOutput !== null;
}
/**
* @throws Exception
*/
public function noOutput(): bool
{
if ($this->noOutput === null) {
throw new Exception;
}
return $this->noOutput;
}
/**
* @psalm-assert-if-true !null $this->noProgress
*/
public function hasNoProgress(): bool
{
return $this->noProgress !== null;
}
/**
* @throws Exception
*/
public function noProgress(): bool
{
if ($this->noProgress === null) {
throw new Exception;
}
return $this->noProgress;
}
/**
* @psalm-assert-if-true !null $this->noResults
*/
public function hasNoResults(): bool
{
return $this->noResults !== null;
}
/**
* @throws Exception
*/
public function noResults(): bool
{
if ($this->noResults === null) {
throw new Exception;
}
return $this->noResults;
}
/**
* @psalm-assert-if-true !null $this->noLogging
*/
public function hasNoLogging(): bool
{
return $this->noLogging !== null;
}
/**
* @throws Exception
*/
public function noLogging(): bool
{
if (!$this->hasNoLogging()) {
throw new Exception;
}
return $this->noLogging;
}
/**
* @psalm-assert-if-true !null $this->processIsolation
*/
public function hasProcessIsolation(): bool
{
return $this->processIsolation !== null;
}
/**
* @throws Exception
*/
public function processIsolation(): bool
{
if (!$this->hasProcessIsolation()) {
throw new Exception;
}
return $this->processIsolation;
}
/**
* @psalm-assert-if-true !null $this->randomOrderSeed
*/
public function hasRandomOrderSeed(): bool
{
return $this->randomOrderSeed !== null;
}
/**
* @throws Exception
*/
public function randomOrderSeed(): int
{
if (!$this->hasRandomOrderSeed()) {
throw new Exception;
}
return $this->randomOrderSeed;
}
/**
* @psalm-assert-if-true !null $this->reportUselessTests
*/
public function hasReportUselessTests(): bool
{
return $this->reportUselessTests !== null;
}
/**
* @throws Exception
*/
public function reportUselessTests(): bool
{
if (!$this->hasReportUselessTests()) {
throw new Exception;
}
return $this->reportUselessTests;
}
/**
* @psalm-assert-if-true !null $this->resolveDependencies
*/
public function hasResolveDependencies(): bool
{
return $this->resolveDependencies !== null;
}
/**
* @throws Exception
*/
public function resolveDependencies(): bool
{
if (!$this->hasResolveDependencies()) {
throw new Exception;
}
return $this->resolveDependencies;
}
/**
* @psalm-assert-if-true !null $this->reverseList
*/
public function hasReverseList(): bool
{
return $this->reverseList !== null;
}
/**
* @throws Exception
*/
public function reverseList(): bool
{
if (!$this->hasReverseList()) {
throw new Exception;
}
return $this->reverseList;
}
/**
* @psalm-assert-if-true !null $this->stderr
*/
public function hasStderr(): bool
{
return $this->stderr !== null;
}
/**
* @throws Exception
*/
public function stderr(): bool
{
if (!$this->hasStderr()) {
throw new Exception;
}
return $this->stderr;
}
/**
* @psalm-assert-if-true !null $this->strictCoverage
*/
public function hasStrictCoverage(): bool
{
return $this->strictCoverage !== null;
}
/**
* @throws Exception
*/
public function strictCoverage(): bool
{
if (!$this->hasStrictCoverage()) {
throw new Exception;
}
return $this->strictCoverage;
}
/**
* @psalm-assert-if-true !null $this->teamcityLogfile
*/
public function hasTeamcityLogfile(): bool
{
return $this->teamcityLogfile !== null;
}
/**
* @throws Exception
*/
public function teamcityLogfile(): string
{
if (!$this->hasTeamcityLogfile()) {
throw new Exception;
}
return $this->teamcityLogfile;
}
/**
* @psalm-assert-if-true !null $this->teamcityPrinter
*/
public function hasTeamCityPrinter(): bool
{
return $this->teamCityPrinter !== null;
}
/**
* @throws Exception
*/
public function teamCityPrinter(): bool
{
if (!$this->hasTeamCityPrinter()) {
throw new Exception;
}
return $this->teamCityPrinter;
}
/**
* @psalm-assert-if-true !null $this->testdoxHtmlFile
*/
public function hasTestdoxHtmlFile(): bool
{
return $this->testdoxHtmlFile !== null;
}
/**
* @throws Exception
*/
public function testdoxHtmlFile(): string
{
if (!$this->hasTestdoxHtmlFile()) {
throw new Exception;
}
return $this->testdoxHtmlFile;
}
/**
* @psalm-assert-if-true !null $this->testdoxTextFile
*/
public function hasTestdoxTextFile(): bool
{
return $this->testdoxTextFile !== null;
}
/**
* @throws Exception
*/
public function testdoxTextFile(): string
{
if (!$this->hasTestdoxTextFile()) {
throw new Exception;
}
return $this->testdoxTextFile;
}
/**
* @psalm-assert-if-true !null $this->testdoxPrinter
*/
public function hasTestDoxPrinter(): bool
{
return $this->testdoxPrinter !== null;
}
/**
* @throws Exception
*/
public function testdoxPrinter(): bool
{
if (!$this->hasTestdoxPrinter()) {
throw new Exception;
}
return $this->testdoxPrinter;
}
/**
* @psalm-assert-if-true !null $this->testSuffixes
*/
public function hasTestSuffixes(): bool
{
return $this->testSuffixes !== null;
}
/**
* @psalm-return non-empty-list<non-empty-string>
*
* @throws Exception
*/
public function testSuffixes(): array
{
if (!$this->hasTestSuffixes()) {
throw new Exception;
}
return $this->testSuffixes;
}
/**
* @psalm-assert-if-true !null $this->testSuite
*/
public function hasTestSuite(): bool
{
return $this->testSuite !== null;
}
/**
* @throws Exception
*/
public function testSuite(): string
{
if (!$this->hasTestSuite()) {
throw new Exception;
}
return $this->testSuite;
}
/**
* @psalm-assert-if-true !null $this->excludedTestSuite
*/
public function hasExcludedTestSuite(): bool
{
return $this->excludeTestSuite !== null;
}
/**
* @throws Exception
*/
public function excludedTestSuite(): string
{
if (!$this->hasExcludedTestSuite()) {
throw new Exception;
}
return $this->excludeTestSuite;
}
public function useDefaultConfiguration(): bool
{
return $this->useDefaultConfiguration;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnIncompleteTests
*/
public function hasDisplayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnIncompleteTests(): bool
{
if (!$this->hasDisplayDetailsOnIncompleteTests()) {
throw new Exception;
}
return $this->displayDetailsOnIncompleteTests;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnSkippedTests
*/
public function hasDisplayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnSkippedTests(): bool
{
if (!$this->hasDisplayDetailsOnSkippedTests()) {
throw new Exception;
}
return $this->displayDetailsOnSkippedTests;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerDeprecations
*/
public function hasDisplayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerDeprecations()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerErrors
*/
public function hasDisplayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerErrors()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerErrors;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerNotices
*/
public function hasDisplayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerNotices()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerNotices;
}
/**
* @psalm-assert-if-true !null $this->displayDetailsOnTestsThatTriggerWarnings
*/
public function hasDisplayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings !== null;
}
/**
* @throws Exception
*/
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
if (!$this->hasDisplayDetailsOnTestsThatTriggerWarnings()) {
throw new Exception;
}
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function version(): bool
{
return $this->version;
}
/**
* @psalm-assert-if-true !null $this->logEventsText
*/
public function hasLogEventsText(): bool
{
return $this->logEventsText !== null;
}
/**
* @throws Exception
*/
public function logEventsText(): string
{
if (!$this->hasLogEventsText()) {
throw new Exception;
}
return $this->logEventsText;
}
/**
* @psalm-assert-if-true !null $this->logEventsVerboseText
*/
public function hasLogEventsVerboseText(): bool
{
return $this->logEventsVerboseText !== null;
}
/**
* @throws Exception
*/
public function logEventsVerboseText(): string
{
if (!$this->hasLogEventsVerboseText()) {
throw new Exception;
}
return $this->logEventsVerboseText;
}
public function debug(): bool
{
return $this->debug;
}
}
src/TextUI/Configuration/Cli/Exception.php 0000644 00000000756 15243426620 0014516 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
src/TextUI/Configuration/Cli/XmlConfigurationFileFinder.php 0000644 00000003401 15243426620 0017766 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\CliArguments;
use function getcwd;
use function is_dir;
use function is_file;
use function realpath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class XmlConfigurationFileFinder
{
public function find(Configuration $configuration): false|string
{
$useDefaultConfiguration = $configuration->useDefaultConfiguration();
if ($configuration->hasConfigurationFile()) {
if (is_dir($configuration->configurationFile())) {
$candidate = $this->configurationFileInDirectory($configuration->configurationFile());
if ($candidate !== false) {
return $candidate;
}
return false;
}
return $configuration->configurationFile();
}
if ($useDefaultConfiguration) {
$candidate = $this->configurationFileInDirectory(getcwd());
if ($candidate !== false) {
return $candidate;
}
}
return false;
}
private function configurationFileInDirectory(string $directory): false|string
{
$candidates = [
$directory . '/phpunit.xml',
$directory . '/phpunit.dist.xml',
$directory . '/phpunit.xml.dist',
];
foreach ($candidates as $candidate) {
if (is_file($candidate)) {
return realpath($candidate);
}
}
return false;
}
}
src/TextUI/Configuration/SourceFilter.php 0000644 00000001112 15243426620 0014442 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SourceFilter
{
public function includes(Source $source, string $path): bool
{
$files = (new SourceMapper)->map($source);
return isset($files[$path]);
}
}
src/TextUI/Configuration/SourceMapper.php 0000644 00000004624 15243426620 0014454 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function realpath;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use SplObjectStorage;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SourceMapper
{
/**
* @psalm-var SplObjectStorage<Source, array<non-empty-string, true>>
*/
private static ?SplObjectStorage $files = null;
/**
* @psalm-return array<non-empty-string, true>
*/
public function map(Source $source): array
{
if (self::$files === null) {
self::$files = new SplObjectStorage;
}
if (isset(self::$files[$source])) {
return self::$files[$source];
}
$files = [];
foreach ($source->includeDirectories() as $directory) {
foreach ((new FileIteratorFacade)->getFilesAsArray($directory->path(), $directory->suffix(), $directory->prefix()) as $file) {
$file = realpath($file);
if (!$file) {
continue;
}
$files[$file] = true;
}
}
foreach ($source->includeFiles() as $file) {
$file = realpath($file->path());
if (!$file) {
continue;
}
$files[$file] = true;
}
foreach ($source->excludeDirectories() as $directory) {
foreach ((new FileIteratorFacade)->getFilesAsArray($directory->path(), $directory->suffix(), $directory->prefix()) as $file) {
$file = realpath($file);
if (!$file) {
continue;
}
if (!isset($files[$file])) {
continue;
}
unset($files[$file]);
}
}
foreach ($source->excludeFiles() as $file) {
$file = realpath($file->path());
if (!$file) {
continue;
}
if (!isset($files[$file])) {
continue;
}
unset($files[$file]);
}
self::$files[$source] = $files;
return $files;
}
}
src/TextUI/Configuration/CodeCoverageFilterRegistry.php 0000644 00000003226 15243426620 0017271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function array_keys;
use function assert;
use SebastianBergmann\CodeCoverage\Filter;
/**
* CLI options and XML configuration are static within a single PHPUnit process.
* It is therefore okay to use a Singleton registry here.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverageFilterRegistry
{
private static ?self $instance = null;
private ?Filter $filter = null;
private bool $configured = false;
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public function get(): Filter
{
assert($this->filter !== null);
return $this->filter;
}
public function init(Configuration $configuration, bool $force = false): void
{
if (!$configuration->hasCoverageReport() && !$force) {
return;
}
if ($this->configured && !$force) {
return;
}
$this->filter = new Filter;
if ($configuration->source()->notEmpty()) {
$this->filter->includeFiles(array_keys((new SourceMapper)->map($configuration->source())));
$this->configured = true;
}
}
public function configured(): bool
{
return $this->configured;
}
}
src/TextUI/Configuration/Configuration.php 0000644 00000117676 15243426620 0014672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Configuration
{
public const COLOR_NEVER = 'never';
public const COLOR_AUTO = 'auto';
public const COLOR_ALWAYS = 'always';
public const COLOR_DEFAULT = self::COLOR_NEVER;
/**
* @psalm-var list<non-empty-string>
*/
private readonly array $cliArguments;
private readonly ?string $configurationFile;
private readonly ?string $bootstrap;
private readonly bool $cacheResult;
private readonly ?string $cacheDirectory;
private readonly ?string $coverageCacheDirectory;
private readonly Source $source;
private readonly bool $pathCoverage;
private readonly ?string $coverageClover;
private readonly ?string $coverageCobertura;
private readonly ?string $coverageCrap4j;
private readonly int $coverageCrap4jThreshold;
private readonly ?string $coverageHtml;
private readonly int $coverageHtmlLowUpperBound;
private readonly int $coverageHtmlHighLowerBound;
private readonly string $coverageHtmlColorSuccessLow;
private readonly string $coverageHtmlColorSuccessMedium;
private readonly string $coverageHtmlColorSuccessHigh;
private readonly string $coverageHtmlColorWarning;
private readonly string $coverageHtmlColorDanger;
private readonly ?string $coverageHtmlCustomCssFile;
private readonly ?string $coveragePhp;
private readonly ?string $coverageText;
private readonly bool $coverageTextShowUncoveredFiles;
private readonly bool $coverageTextShowOnlySummary;
private readonly ?string $coverageXml;
private readonly string $testResultCacheFile;
private readonly bool $ignoreDeprecatedCodeUnitsFromCodeCoverage;
private readonly bool $disableCodeCoverageIgnore;
private readonly bool $failOnDeprecation;
private readonly bool $failOnEmptyTestSuite;
private readonly bool $failOnIncomplete;
private readonly bool $failOnNotice;
private readonly bool $failOnRisky;
private readonly bool $failOnSkipped;
private readonly bool $failOnWarning;
private readonly bool $stopOnDefect;
private readonly bool $stopOnDeprecation;
private readonly bool $stopOnError;
private readonly bool $stopOnFailure;
private readonly bool $stopOnIncomplete;
private readonly bool $stopOnNotice;
private readonly bool $stopOnRisky;
private readonly bool $stopOnSkipped;
private readonly bool $stopOnWarning;
private readonly bool $outputToStandardErrorStream;
private readonly int $columns;
private readonly bool $noExtensions;
/**
* @psalm-var ?non-empty-string
*/
private readonly ?string $pharExtensionDirectory;
/**
* @psalm-var list<array{className: class-string, parameters: array<string, string>}>
*/
private readonly array $extensionBootstrappers;
private readonly bool $backupGlobals;
private readonly bool $backupStaticProperties;
private readonly bool $beStrictAboutChangesToGlobalState;
private readonly bool $colors;
private readonly bool $processIsolation;
private readonly bool $enforceTimeLimit;
private readonly int $defaultTimeLimit;
private readonly int $timeoutForSmallTests;
private readonly int $timeoutForMediumTests;
private readonly int $timeoutForLargeTests;
private readonly bool $reportUselessTests;
private readonly bool $strictCoverage;
private readonly bool $disallowTestOutput;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $reverseDefectList;
private readonly bool $requireCoverageMetadata;
private readonly bool $registerMockObjectsFromTestArgumentsRecursively;
private readonly bool $noProgress;
private readonly bool $noResults;
private readonly bool $noOutput;
private readonly int $executionOrder;
private readonly int $executionOrderDefects;
private readonly bool $resolveDependencies;
private readonly ?string $logfileTeamcity;
private readonly ?string $logfileJunit;
private readonly ?string $logfileTestdoxHtml;
private readonly ?string $logfileTestdoxText;
private readonly ?string $logEventsText;
private readonly ?string $logEventsVerboseText;
private readonly ?array $testsCovering;
private readonly ?array $testsUsing;
private readonly bool $teamCityOutput;
private readonly bool $testDoxOutput;
private readonly ?string $filter;
private readonly ?array $groups;
private readonly ?array $excludeGroups;
private readonly int $randomOrderSeed;
private readonly bool $includeUncoveredFiles;
private readonly TestSuiteCollection $testSuite;
private readonly string $includeTestSuite;
private readonly string $excludeTestSuite;
private readonly ?string $defaultTestSuite;
/**
* @psalm-var non-empty-list<non-empty-string>
*/
private readonly array $testSuffixes;
private readonly Php $php;
private readonly bool $controlGarbageCollector;
private readonly int $numberOfTestsBeforeGarbageCollection;
private readonly ?string $generateBaseline;
private readonly bool $debug;
/**
* @psalm-param list<non-empty-string> $cliArguments
* @psalm-param ?non-empty-string $pharExtensionDirectory
* @psalm-param non-empty-list<non-empty-string> $testSuffixes
* @psalm-param list<array{className: class-string, parameters: array<string, string>}> $extensionBootstrappers
*/
public function __construct(array $cliArguments, ?string $configurationFile, ?string $bootstrap, bool $cacheResult, ?string $cacheDirectory, ?string $coverageCacheDirectory, Source $source, string $testResultCacheFile, ?string $coverageClover, ?string $coverageCobertura, ?string $coverageCrap4j, int $coverageCrap4jThreshold, ?string $coverageHtml, int $coverageHtmlLowUpperBound, int $coverageHtmlHighLowerBound, string $coverageHtmlColorSuccessLow, string $coverageHtmlColorSuccessMedium, string $coverageHtmlColorSuccessHigh, string $coverageHtmlColorWarning, string $coverageHtmlColorDanger, ?string $coverageHtmlCustomCssFile, ?string $coveragePhp, ?string $coverageText, bool $coverageTextShowUncoveredFiles, bool $coverageTextShowOnlySummary, ?string $coverageXml, bool $pathCoverage, bool $ignoreDeprecatedCodeUnitsFromCodeCoverage, bool $disableCodeCoverageIgnore, bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, bool $stopOnDefect, bool $stopOnDeprecation, bool $stopOnError, bool $stopOnFailure, bool $stopOnIncomplete, bool $stopOnNotice, bool $stopOnRisky, bool $stopOnSkipped, bool $stopOnWarning, bool $outputToStandardErrorStream, int|string $columns, bool $noExtensions, ?string $pharExtensionDirectory, array $extensionBootstrappers, bool $backupGlobals, bool $backupStaticProperties, bool $beStrictAboutChangesToGlobalState, bool $colors, bool $processIsolation, bool $enforceTimeLimit, int $defaultTimeLimit, int $timeoutForSmallTests, int $timeoutForMediumTests, int $timeoutForLargeTests, bool $reportUselessTests, bool $strictCoverage, bool $disallowTestOutput, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $reverseDefectList, bool $requireCoverageMetadata, bool $registerMockObjectsFromTestArgumentsRecursively, bool $noProgress, bool $noResults, bool $noOutput, int $executionOrder, int $executionOrderDefects, bool $resolveDependencies, ?string $logfileTeamcity, ?string $logfileJunit, ?string $logfileTestdoxHtml, ?string $logfileTestdoxText, ?string $logEventsText, ?string $logEventsVerboseText, bool $teamCityOutput, bool $testDoxOutput, ?array $testsCovering, ?array $testsUsing, ?string $filter, ?array $groups, ?array $excludeGroups, int $randomOrderSeed, bool $includeUncoveredFiles, TestSuiteCollection $testSuite, string $includeTestSuite, string $excludeTestSuite, ?string $defaultTestSuite, array $testSuffixes, Php $php, bool $controlGarbageCollector, int $numberOfTestsBeforeGarbageCollection, ?string $generateBaseline, bool $debug)
{
$this->cliArguments = $cliArguments;
$this->configurationFile = $configurationFile;
$this->bootstrap = $bootstrap;
$this->cacheResult = $cacheResult;
$this->cacheDirectory = $cacheDirectory;
$this->coverageCacheDirectory = $coverageCacheDirectory;
$this->source = $source;
$this->testResultCacheFile = $testResultCacheFile;
$this->coverageClover = $coverageClover;
$this->coverageCobertura = $coverageCobertura;
$this->coverageCrap4j = $coverageCrap4j;
$this->coverageCrap4jThreshold = $coverageCrap4jThreshold;
$this->coverageHtml = $coverageHtml;
$this->coverageHtmlLowUpperBound = $coverageHtmlLowUpperBound;
$this->coverageHtmlHighLowerBound = $coverageHtmlHighLowerBound;
$this->coverageHtmlColorSuccessLow = $coverageHtmlColorSuccessLow;
$this->coverageHtmlColorSuccessMedium = $coverageHtmlColorSuccessMedium;
$this->coverageHtmlColorSuccessHigh = $coverageHtmlColorSuccessHigh;
$this->coverageHtmlColorWarning = $coverageHtmlColorWarning;
$this->coverageHtmlColorDanger = $coverageHtmlColorDanger;
$this->coverageHtmlCustomCssFile = $coverageHtmlCustomCssFile;
$this->coveragePhp = $coveragePhp;
$this->coverageText = $coverageText;
$this->coverageTextShowUncoveredFiles = $coverageTextShowUncoveredFiles;
$this->coverageTextShowOnlySummary = $coverageTextShowOnlySummary;
$this->coverageXml = $coverageXml;
$this->pathCoverage = $pathCoverage;
$this->ignoreDeprecatedCodeUnitsFromCodeCoverage = $ignoreDeprecatedCodeUnitsFromCodeCoverage;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->outputToStandardErrorStream = $outputToStandardErrorStream;
$this->columns = $columns;
$this->noExtensions = $noExtensions;
$this->pharExtensionDirectory = $pharExtensionDirectory;
$this->extensionBootstrappers = $extensionBootstrappers;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->colors = $colors;
$this->processIsolation = $processIsolation;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->timeoutForSmallTests = $timeoutForSmallTests;
$this->timeoutForMediumTests = $timeoutForMediumTests;
$this->timeoutForLargeTests = $timeoutForLargeTests;
$this->reportUselessTests = $reportUselessTests;
$this->strictCoverage = $strictCoverage;
$this->disallowTestOutput = $disallowTestOutput;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->reverseDefectList = $reverseDefectList;
$this->requireCoverageMetadata = $requireCoverageMetadata;
$this->registerMockObjectsFromTestArgumentsRecursively = $registerMockObjectsFromTestArgumentsRecursively;
$this->noProgress = $noProgress;
$this->noResults = $noResults;
$this->noOutput = $noOutput;
$this->executionOrder = $executionOrder;
$this->executionOrderDefects = $executionOrderDefects;
$this->resolveDependencies = $resolveDependencies;
$this->logfileTeamcity = $logfileTeamcity;
$this->logfileJunit = $logfileJunit;
$this->logfileTestdoxHtml = $logfileTestdoxHtml;
$this->logfileTestdoxText = $logfileTestdoxText;
$this->logEventsText = $logEventsText;
$this->logEventsVerboseText = $logEventsVerboseText;
$this->teamCityOutput = $teamCityOutput;
$this->testDoxOutput = $testDoxOutput;
$this->testsCovering = $testsCovering;
$this->testsUsing = $testsUsing;
$this->filter = $filter;
$this->groups = $groups;
$this->excludeGroups = $excludeGroups;
$this->randomOrderSeed = $randomOrderSeed;
$this->includeUncoveredFiles = $includeUncoveredFiles;
$this->testSuite = $testSuite;
$this->includeTestSuite = $includeTestSuite;
$this->excludeTestSuite = $excludeTestSuite;
$this->defaultTestSuite = $defaultTestSuite;
$this->testSuffixes = $testSuffixes;
$this->php = $php;
$this->controlGarbageCollector = $controlGarbageCollector;
$this->numberOfTestsBeforeGarbageCollection = $numberOfTestsBeforeGarbageCollection;
$this->generateBaseline = $generateBaseline;
$this->debug = $debug;
}
/**
* @psalm-assert-if-true !empty $this->cliArguments
*/
public function hasCliArguments(): bool
{
return !empty($this->cliArguments);
}
/**
* @psalm-return list<non-empty-string>
*/
public function cliArguments(): array
{
return $this->cliArguments;
}
/**
* @psalm-assert-if-true !empty $this->cliArguments
*
* @deprecated Use hasCliArguments() instead
*/
public function hasCliArgument(): bool
{
return !empty($this->cliArguments);
}
/**
* @throws NoCliArgumentException
*
* @return non-empty-string
*
* @deprecated Use cliArguments()[0] instead
*/
public function cliArgument(): string
{
if (!$this->hasCliArguments()) {
throw new NoCliArgumentException;
}
return $this->cliArguments[0];
}
/**
* @psalm-assert-if-true !null $this->configurationFile
*/
public function hasConfigurationFile(): bool
{
return $this->configurationFile !== null;
}
/**
* @throws NoConfigurationFileException
*/
public function configurationFile(): string
{
if (!$this->hasConfigurationFile()) {
throw new NoConfigurationFileException;
}
return $this->configurationFile;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws NoBootstrapException
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new NoBootstrapException;
}
return $this->bootstrap;
}
public function cacheResult(): bool
{
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws NoCacheDirectoryException
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new NoCacheDirectoryException;
}
return $this->cacheDirectory;
}
/**
* @psalm-assert-if-true !null $this->coverageCacheDirectory
*/
public function hasCoverageCacheDirectory(): bool
{
return $this->coverageCacheDirectory !== null;
}
/**
* @throws NoCoverageCacheDirectoryException
*/
public function coverageCacheDirectory(): string
{
if (!$this->hasCoverageCacheDirectory()) {
throw new NoCoverageCacheDirectoryException;
}
return $this->coverageCacheDirectory;
}
public function source(): Source
{
return $this->source;
}
/**
* @deprecated Use source()->restrictDeprecations() instead
*/
public function restrictDeprecations(): bool
{
return $this->source()->restrictDeprecations();
}
/**
* @deprecated Use source()->restrictNotices() instead
*/
public function restrictNotices(): bool
{
return $this->source()->restrictNotices();
}
/**
* @deprecated Use source()->restrictWarnings() instead
*/
public function restrictWarnings(): bool
{
return $this->source()->restrictWarnings();
}
/**
* @deprecated Use source()->notEmpty() instead
*/
public function hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport(): bool
{
return $this->source->notEmpty();
}
/**
* @deprecated Use source()->includeDirectories() instead
*/
public function coverageIncludeDirectories(): FilterDirectoryCollection
{
return $this->source()->includeDirectories();
}
/**
* @deprecated Use source()->includeFiles() instead
*/
public function coverageIncludeFiles(): FileCollection
{
return $this->source()->includeFiles();
}
/**
* @deprecated Use source()->excludeDirectories() instead
*/
public function coverageExcludeDirectories(): FilterDirectoryCollection
{
return $this->source()->excludeDirectories();
}
/**
* @deprecated Use source()->excludeFiles() instead
*/
public function coverageExcludeFiles(): FileCollection
{
return $this->source()->excludeFiles();
}
public function testResultCacheFile(): string
{
return $this->testResultCacheFile;
}
public function ignoreDeprecatedCodeUnitsFromCodeCoverage(): bool
{
return $this->ignoreDeprecatedCodeUnitsFromCodeCoverage;
}
public function disableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore;
}
public function pathCoverage(): bool
{
return $this->pathCoverage;
}
public function hasCoverageReport(): bool
{
return $this->hasCoverageClover() ||
$this->hasCoverageCobertura() ||
$this->hasCoverageCrap4j() ||
$this->hasCoverageHtml() ||
$this->hasCoveragePhp() ||
$this->hasCoverageText() ||
$this->hasCoverageXml();
}
/**
* @psalm-assert-if-true !null $this->coverageClover
*/
public function hasCoverageClover(): bool
{
return $this->coverageClover !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageClover(): string
{
if (!$this->hasCoverageClover()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageClover;
}
/**
* @psalm-assert-if-true !null $this->coverageCobertura
*/
public function hasCoverageCobertura(): bool
{
return $this->coverageCobertura !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageCobertura(): string
{
if (!$this->hasCoverageCobertura()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageCobertura;
}
/**
* @psalm-assert-if-true !null $this->coverageCrap4j
*/
public function hasCoverageCrap4j(): bool
{
return $this->coverageCrap4j !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageCrap4j(): string
{
if (!$this->hasCoverageCrap4j()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageCrap4j;
}
public function coverageCrap4jThreshold(): int
{
return $this->coverageCrap4jThreshold;
}
/**
* @psalm-assert-if-true !null $this->coverageHtml
*/
public function hasCoverageHtml(): bool
{
return $this->coverageHtml !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageHtml(): string
{
if (!$this->hasCoverageHtml()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageHtml;
}
public function coverageHtmlLowUpperBound(): int
{
return $this->coverageHtmlLowUpperBound;
}
public function coverageHtmlHighLowerBound(): int
{
return $this->coverageHtmlHighLowerBound;
}
public function coverageHtmlColorSuccessLow(): string
{
return $this->coverageHtmlColorSuccessLow;
}
public function coverageHtmlColorSuccessMedium(): string
{
return $this->coverageHtmlColorSuccessMedium;
}
public function coverageHtmlColorSuccessHigh(): string
{
return $this->coverageHtmlColorSuccessHigh;
}
public function coverageHtmlColorWarning(): string
{
return $this->coverageHtmlColorWarning;
}
public function coverageHtmlColorDanger(): string
{
return $this->coverageHtmlColorDanger;
}
/**
* @psalm-assert-if-true !null $this->coverageHtmlCustomCssFile
*/
public function hasCoverageHtmlCustomCssFile(): bool
{
return $this->coverageHtmlCustomCssFile !== null;
}
/**
* @throws NoCustomCssFileException
*/
public function coverageHtmlCustomCssFile(): string
{
if (!$this->hasCoverageHtmlCustomCssFile()) {
throw new NoCustomCssFileException;
}
return $this->coverageHtmlCustomCssFile;
}
/**
* @psalm-assert-if-true !null $this->coveragePhp
*/
public function hasCoveragePhp(): bool
{
return $this->coveragePhp !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coveragePhp(): string
{
if (!$this->hasCoveragePhp()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coveragePhp;
}
/**
* @psalm-assert-if-true !null $this->coverageText
*/
public function hasCoverageText(): bool
{
return $this->coverageText !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageText(): string
{
if (!$this->hasCoverageText()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageText;
}
public function coverageTextShowUncoveredFiles(): bool
{
return $this->coverageTextShowUncoveredFiles;
}
public function coverageTextShowOnlySummary(): bool
{
return $this->coverageTextShowOnlySummary;
}
/**
* @psalm-assert-if-true !null $this->coverageXml
*/
public function hasCoverageXml(): bool
{
return $this->coverageXml !== null;
}
/**
* @throws CodeCoverageReportNotConfiguredException
*/
public function coverageXml(): string
{
if (!$this->hasCoverageXml()) {
throw new CodeCoverageReportNotConfiguredException;
}
return $this->coverageXml;
}
public function failOnDeprecation(): bool
{
return $this->failOnDeprecation;
}
public function failOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite;
}
public function failOnIncomplete(): bool
{
return $this->failOnIncomplete;
}
public function failOnNotice(): bool
{
return $this->failOnNotice;
}
public function failOnRisky(): bool
{
return $this->failOnRisky;
}
public function failOnSkipped(): bool
{
return $this->failOnSkipped;
}
public function failOnWarning(): bool
{
return $this->failOnWarning;
}
public function stopOnDefect(): bool
{
return $this->stopOnDefect;
}
public function stopOnDeprecation(): bool
{
return $this->stopOnDeprecation;
}
public function stopOnError(): bool
{
return $this->stopOnError;
}
public function stopOnFailure(): bool
{
return $this->stopOnFailure;
}
public function stopOnIncomplete(): bool
{
return $this->stopOnIncomplete;
}
public function stopOnNotice(): bool
{
return $this->stopOnNotice;
}
public function stopOnRisky(): bool
{
return $this->stopOnRisky;
}
public function stopOnSkipped(): bool
{
return $this->stopOnSkipped;
}
public function stopOnWarning(): bool
{
return $this->stopOnWarning;
}
public function outputToStandardErrorStream(): bool
{
return $this->outputToStandardErrorStream;
}
public function columns(): int
{
return $this->columns;
}
/**
* @deprecated Use noExtensions() instead
*/
public function loadPharExtensions(): bool
{
return $this->noExtensions;
}
public function noExtensions(): bool
{
return $this->noExtensions;
}
/**
* @psalm-assert-if-true !null $this->pharExtensionDirectory
*/
public function hasPharExtensionDirectory(): bool
{
return $this->pharExtensionDirectory !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws NoPharExtensionDirectoryException
*/
public function pharExtensionDirectory(): string
{
if (!$this->hasPharExtensionDirectory()) {
throw new NoPharExtensionDirectoryException;
}
return $this->pharExtensionDirectory;
}
/**
* @psalm-return list<array{className: class-string, parameters: array<string, string>}>
*/
public function extensionBootstrappers(): array
{
return $this->extensionBootstrappers;
}
public function backupGlobals(): bool
{
return $this->backupGlobals;
}
public function backupStaticProperties(): bool
{
return $this->backupStaticProperties;
}
public function beStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState;
}
public function colors(): bool
{
return $this->colors;
}
public function processIsolation(): bool
{
return $this->processIsolation;
}
public function enforceTimeLimit(): bool
{
return $this->enforceTimeLimit;
}
public function defaultTimeLimit(): int
{
return $this->defaultTimeLimit;
}
public function timeoutForSmallTests(): int
{
return $this->timeoutForSmallTests;
}
public function timeoutForMediumTests(): int
{
return $this->timeoutForMediumTests;
}
public function timeoutForLargeTests(): int
{
return $this->timeoutForLargeTests;
}
public function reportUselessTests(): bool
{
return $this->reportUselessTests;
}
public function strictCoverage(): bool
{
return $this->strictCoverage;
}
public function disallowTestOutput(): bool
{
return $this->disallowTestOutput;
}
public function displayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests;
}
public function displayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests;
}
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors;
}
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices;
}
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function reverseDefectList(): bool
{
return $this->reverseDefectList;
}
public function requireCoverageMetadata(): bool
{
return $this->requireCoverageMetadata;
}
/**
* @deprecated
*/
public function registerMockObjectsFromTestArgumentsRecursively(): bool
{
return $this->registerMockObjectsFromTestArgumentsRecursively;
}
public function noProgress(): bool
{
return $this->noProgress;
}
public function noResults(): bool
{
return $this->noResults;
}
public function noOutput(): bool
{
return $this->noOutput;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function executionOrderDefects(): int
{
return $this->executionOrderDefects;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
/**
* @psalm-assert-if-true !null $this->logfileTeamcity
*/
public function hasLogfileTeamcity(): bool
{
return $this->logfileTeamcity !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTeamcity(): string
{
if (!$this->hasLogfileTeamcity()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTeamcity;
}
/**
* @psalm-assert-if-true !null $this->logfileJunit
*/
public function hasLogfileJunit(): bool
{
return $this->logfileJunit !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileJunit(): string
{
if (!$this->hasLogfileJunit()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileJunit;
}
/**
* @psalm-assert-if-true !null $this->logfileTestdoxHtml
*/
public function hasLogfileTestdoxHtml(): bool
{
return $this->logfileTestdoxHtml !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTestdoxHtml(): string
{
if (!$this->hasLogfileTestdoxHtml()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTestdoxHtml;
}
/**
* @psalm-assert-if-true !null $this->logfileTestdoxText
*/
public function hasLogfileTestdoxText(): bool
{
return $this->logfileTestdoxText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logfileTestdoxText(): string
{
if (!$this->hasLogfileTestdoxText()) {
throw new LoggingNotConfiguredException;
}
return $this->logfileTestdoxText;
}
/**
* @psalm-assert-if-true !null $this->logEventsText
*/
public function hasLogEventsText(): bool
{
return $this->logEventsText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logEventsText(): string
{
if (!$this->hasLogEventsText()) {
throw new LoggingNotConfiguredException;
}
return $this->logEventsText;
}
/**
* @psalm-assert-if-true !null $this->logEventsVerboseText
*/
public function hasLogEventsVerboseText(): bool
{
return $this->logEventsVerboseText !== null;
}
/**
* @throws LoggingNotConfiguredException
*/
public function logEventsVerboseText(): string
{
if (!$this->hasLogEventsVerboseText()) {
throw new LoggingNotConfiguredException;
}
return $this->logEventsVerboseText;
}
public function outputIsTeamCity(): bool
{
return $this->teamCityOutput;
}
public function outputIsTestDox(): bool
{
return $this->testDoxOutput;
}
/**
* @psalm-assert-if-true !empty $this->testsCovering
*/
public function hasTestsCovering(): bool
{
return !empty($this->testsCovering);
}
/**
* @psalm-return list<string>
*
* @throws FilterNotConfiguredException
*/
public function testsCovering(): array
{
if (!$this->hasTestsCovering()) {
throw new FilterNotConfiguredException;
}
return $this->testsCovering;
}
/**
* @psalm-assert-if-true !empty $this->testsUsing
*/
public function hasTestsUsing(): bool
{
return !empty($this->testsUsing);
}
/**
* @psalm-return list<string>
*
* @throws FilterNotConfiguredException
*/
public function testsUsing(): array
{
if (!$this->hasTestsUsing()) {
throw new FilterNotConfiguredException;
}
return $this->testsUsing;
}
/**
* @psalm-assert-if-true !null $this->filter
*/
public function hasFilter(): bool
{
return $this->filter !== null;
}
/**
* @throws FilterNotConfiguredException
*/
public function filter(): string
{
if (!$this->hasFilter()) {
throw new FilterNotConfiguredException;
}
return $this->filter;
}
/**
* @psalm-assert-if-true !empty $this->groups
*/
public function hasGroups(): bool
{
return !empty($this->groups);
}
/**
* @throws FilterNotConfiguredException
*/
public function groups(): array
{
if (!$this->hasGroups()) {
throw new FilterNotConfiguredException;
}
return $this->groups;
}
/**
* @psalm-assert-if-true !empty $this->excludeGroups
*/
public function hasExcludeGroups(): bool
{
return !empty($this->excludeGroups);
}
/**
* @throws FilterNotConfiguredException
*/
public function excludeGroups(): array
{
if (!$this->hasExcludeGroups()) {
throw new FilterNotConfiguredException;
}
return $this->excludeGroups;
}
public function randomOrderSeed(): int
{
return $this->randomOrderSeed;
}
public function includeUncoveredFiles(): bool
{
return $this->includeUncoveredFiles;
}
public function testSuite(): TestSuiteCollection
{
return $this->testSuite;
}
public function includeTestSuite(): string
{
return $this->includeTestSuite;
}
public function excludeTestSuite(): string
{
return $this->excludeTestSuite;
}
/**
* @psalm-assert-if-true !null $this->defaultTestSuite
*/
public function hasDefaultTestSuite(): bool
{
return $this->defaultTestSuite !== null;
}
/**
* @throws NoDefaultTestSuiteException
*/
public function defaultTestSuite(): string
{
if (!$this->hasDefaultTestSuite()) {
throw new NoDefaultTestSuiteException;
}
return $this->defaultTestSuite;
}
/**
* @psalm-return non-empty-list<non-empty-string>
*/
public function testSuffixes(): array
{
return $this->testSuffixes;
}
public function php(): Php
{
return $this->php;
}
public function controlGarbageCollector(): bool
{
return $this->controlGarbageCollector;
}
public function numberOfTestsBeforeGarbageCollection(): int
{
return $this->numberOfTestsBeforeGarbageCollection;
}
/**
* @psalm-assert-if-true !null $this->generateBaseline
*/
public function hasGenerateBaseline(): bool
{
return $this->generateBaseline !== null;
}
/**
* @throws NoBaselineException
*/
public function generateBaseline(): string
{
if (!$this->hasGenerateBaseline()) {
throw new NoBaselineException;
}
return $this->generateBaseline;
}
public function debug(): bool
{
return $this->debug;
}
}
src/TextUI/Configuration/Exception/LoggingNotConfiguredException.php 0000644 00000000772 15243426620 0021741 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class LoggingNotConfiguredException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoCliArgumentException.php 0000644 00000000763 15243426620 0020373 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCliArgumentException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/IncludePathNotConfiguredException.php 0000644 00000000776 15243426620 0022557 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncludePathNotConfiguredException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoCoverageCacheDirectoryException.php 0000644 00000000776 15243426620 0022531 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCoverageCacheDirectoryException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/ConfigurationCannotBeBuiltException.php 0000644 00000001000 15243426620 0023066 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConfigurationCannotBeBuiltException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoBaselineException.php 0000644 00000000760 15243426620 0017700 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoBaselineException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoCustomCssFileException.php 0000644 00000000765 15243426620 0020706 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCustomCssFileException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoCacheDirectoryException.php 0000644 00000000766 15243426620 0021054 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoCacheDirectoryException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/FilterNotConfiguredException.php 0000644 00000000771 15243426620 0021577 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FilterNotConfiguredException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoConfigurationFileException.php 0000644 00000000771 15243426620 0021567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoConfigurationFileException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoDefaultTestSuiteException.php 0000644 00000000770 15243426620 0021415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoDefaultTestSuiteException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoPharExtensionDirectoryException.php 0000644 00000000776 15243426620 0022641 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoPharExtensionDirectoryException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/Exception.php 0000644 00000000705 15243426620 0015737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends \PHPUnit\TextUI\Exception
{
}
src/TextUI/Configuration/Exception/CannotFindSchemaException.php 0000644 00000001045 15243426620 0021022 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotFindSchemaException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/NoBootstrapException.php 0000644 00000000761 15243426620 0020134 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoBootstrapException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Exception/CodeCoverageReportNotConfiguredException.php 0000644 00000001005 15243426620 0024063 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverageReportNotConfiguredException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/TestSuiteBuilder.php 0000644 00000010157 15243426620 0015305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function assert;
use function count;
use function is_dir;
use function is_file;
use function realpath;
use function str_ends_with;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Exception;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\TestSuiteLoader;
use PHPUnit\TextUI\RuntimeException;
use PHPUnit\TextUI\TestDirectoryNotFoundException;
use PHPUnit\TextUI\TestFileNotFoundException;
use PHPUnit\TextUI\XmlConfiguration\TestSuiteMapper;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteBuilder
{
/**
* @throws \PHPUnit\Framework\Exception
* @throws RuntimeException
* @throws TestDirectoryNotFoundException
* @throws TestFileNotFoundException
*/
public function build(Configuration $configuration): TestSuite
{
if ($configuration->hasCliArguments()) {
$arguments = [];
foreach ($configuration->cliArguments() as $cliArgument) {
$argument = realpath($cliArgument);
if (!$argument) {
throw new TestFileNotFoundException($cliArgument);
}
$arguments[] = $argument;
}
if (count($arguments) === 1) {
$testSuite = $this->testSuiteFromPath(
$arguments[0],
$configuration->testSuffixes(),
);
} else {
$testSuite = $this->testSuiteFromPathList(
$arguments,
$configuration->testSuffixes(),
);
}
}
if (!isset($testSuite)) {
$xmlConfigurationFile = $configuration->hasConfigurationFile() ? $configuration->configurationFile() : 'Root Test Suite';
assert(!empty($xmlConfigurationFile));
$testSuite = (new TestSuiteMapper)->map(
$xmlConfigurationFile,
$configuration->testSuite(),
$configuration->includeTestSuite(),
$configuration->excludeTestSuite(),
);
}
EventFacade::emitter()->testSuiteLoaded(\PHPUnit\Event\TestSuite\TestSuiteBuilder::from($testSuite));
return $testSuite;
}
/**
* @psalm-param non-empty-string $path
* @psalm-param list<non-empty-string> $suffixes
* @psalm-param ?TestSuite $suite
*
* @throws \PHPUnit\Framework\Exception
*/
private function testSuiteFromPath(string $path, array $suffixes, ?TestSuite $suite = null): TestSuite
{
if (str_ends_with($path, '.phpt') && is_file($path)) {
$suite = $suite ?: TestSuite::empty($path);
$suite->addTestFile($path);
return $suite;
}
if (is_dir($path)) {
$files = (new FileIteratorFacade)->getFilesAsArray($path, $suffixes);
$suite = $suite ?: TestSuite::empty('CLI Arguments');
$suite->addTestFiles($files);
return $suite;
}
try {
$testClass = (new TestSuiteLoader)->load($path);
} catch (Exception $e) {
print $e->getMessage() . PHP_EOL;
exit(1);
}
if (!$suite) {
return TestSuite::fromClassReflector($testClass);
}
$suite->addTestSuite($testClass);
return $suite;
}
/**
* @psalm-param list<non-empty-string> $paths
* @psalm-param list<non-empty-string> $suffixes
*
* @throws \PHPUnit\Framework\Exception
*/
private function testSuiteFromPathList(array $paths, array $suffixes): TestSuite
{
$suite = TestSuite::empty('CLI Arguments');
foreach ($paths as $path) {
$this->testSuiteFromPath($path, $suffixes, $suite);
}
return $suite;
}
}
src/TextUI/Configuration/Merger.php 0000644 00000105542 15243426620 0013271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use const DIRECTORY_SEPARATOR;
use function array_diff;
use function assert;
use function dirname;
use function explode;
use function is_int;
use function realpath;
use function time;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\CliArguments\Configuration as CliConfiguration;
use PHPUnit\TextUI\CliArguments\Exception;
use PHPUnit\TextUI\XmlConfiguration\Configuration as XmlConfiguration;
use PHPUnit\TextUI\XmlConfiguration\LoadedFromFileConfiguration;
use PHPUnit\TextUI\XmlConfiguration\SchemaDetector;
use PHPUnit\Util\Filesystem;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\Environment\Console;
use SebastianBergmann\Invoker\Invoker;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Merger
{
/**
* @throws \PHPUnit\TextUI\XmlConfiguration\Exception
* @throws Exception
* @throws NoCustomCssFileException
*/
public function merge(CliConfiguration $cliConfiguration, XmlConfiguration $xmlConfiguration): Configuration
{
$configurationFile = null;
if ($xmlConfiguration->wasLoadedFromFile()) {
assert($xmlConfiguration instanceof LoadedFromFileConfiguration);
$configurationFile = $xmlConfiguration->filename();
}
$bootstrap = null;
if ($cliConfiguration->hasBootstrap()) {
$bootstrap = $cliConfiguration->bootstrap();
} elseif ($xmlConfiguration->phpunit()->hasBootstrap()) {
$bootstrap = $xmlConfiguration->phpunit()->bootstrap();
}
if ($cliConfiguration->hasCacheResult()) {
$cacheResult = $cliConfiguration->cacheResult();
} else {
$cacheResult = $xmlConfiguration->phpunit()->cacheResult();
}
$cacheDirectory = null;
$coverageCacheDirectory = null;
if ($cliConfiguration->hasCacheDirectory() && Filesystem::createDirectory($cliConfiguration->cacheDirectory())) {
$cacheDirectory = realpath($cliConfiguration->cacheDirectory());
} elseif ($xmlConfiguration->phpunit()->hasCacheDirectory() && Filesystem::createDirectory($xmlConfiguration->phpunit()->cacheDirectory())) {
$cacheDirectory = realpath($xmlConfiguration->phpunit()->cacheDirectory());
}
if ($cacheDirectory !== null) {
$coverageCacheDirectory = $cacheDirectory . DIRECTORY_SEPARATOR . 'code-coverage';
$testResultCacheFile = $cacheDirectory . DIRECTORY_SEPARATOR . 'test-results';
}
if ($coverageCacheDirectory === null) {
if ($cliConfiguration->hasCoverageCacheDirectory() && Filesystem::createDirectory($cliConfiguration->coverageCacheDirectory())) {
$coverageCacheDirectory = realpath($cliConfiguration->coverageCacheDirectory());
} elseif ($xmlConfiguration->codeCoverage()->hasCacheDirectory()) {
$coverageCacheDirectory = $xmlConfiguration->codeCoverage()->cacheDirectory()->path();
}
}
if (!isset($testResultCacheFile)) {
if ($cliConfiguration->hasCacheResultFile()) {
$testResultCacheFile = $cliConfiguration->cacheResultFile();
} elseif ($xmlConfiguration->phpunit()->hasCacheResultFile()) {
$testResultCacheFile = $xmlConfiguration->phpunit()->cacheResultFile();
} elseif ($xmlConfiguration->wasLoadedFromFile()) {
$testResultCacheFile = dirname(realpath($xmlConfiguration->filename())) . DIRECTORY_SEPARATOR . '.phpunit.result.cache';
} else {
$candidate = realpath($_SERVER['PHP_SELF']);
if ($candidate) {
$testResultCacheFile = dirname($candidate) . DIRECTORY_SEPARATOR . '.phpunit.result.cache';
} else {
$testResultCacheFile = '.phpunit.result.cache';
}
}
}
if ($cliConfiguration->hasDisableCodeCoverageIgnore()) {
$disableCodeCoverageIgnore = $cliConfiguration->disableCodeCoverageIgnore();
} else {
$disableCodeCoverageIgnore = $xmlConfiguration->codeCoverage()->disableCodeCoverageIgnore();
}
if ($cliConfiguration->hasFailOnDeprecation()) {
$failOnDeprecation = $cliConfiguration->failOnDeprecation();
} else {
$failOnDeprecation = $xmlConfiguration->phpunit()->failOnDeprecation();
}
if ($cliConfiguration->hasFailOnEmptyTestSuite()) {
$failOnEmptyTestSuite = $cliConfiguration->failOnEmptyTestSuite();
} else {
$failOnEmptyTestSuite = $xmlConfiguration->phpunit()->failOnEmptyTestSuite();
}
if ($cliConfiguration->hasFailOnIncomplete()) {
$failOnIncomplete = $cliConfiguration->failOnIncomplete();
} else {
$failOnIncomplete = $xmlConfiguration->phpunit()->failOnIncomplete();
}
if ($cliConfiguration->hasFailOnNotice()) {
$failOnNotice = $cliConfiguration->failOnNotice();
} else {
$failOnNotice = $xmlConfiguration->phpunit()->failOnNotice();
}
if ($cliConfiguration->hasFailOnRisky()) {
$failOnRisky = $cliConfiguration->failOnRisky();
} else {
$failOnRisky = $xmlConfiguration->phpunit()->failOnRisky();
}
if ($cliConfiguration->hasFailOnSkipped()) {
$failOnSkipped = $cliConfiguration->failOnSkipped();
} else {
$failOnSkipped = $xmlConfiguration->phpunit()->failOnSkipped();
}
if ($cliConfiguration->hasFailOnWarning()) {
$failOnWarning = $cliConfiguration->failOnWarning();
} else {
$failOnWarning = $xmlConfiguration->phpunit()->failOnWarning();
}
if ($cliConfiguration->hasStopOnDefect()) {
$stopOnDefect = $cliConfiguration->stopOnDefect();
} else {
$stopOnDefect = $xmlConfiguration->phpunit()->stopOnDefect();
}
if ($cliConfiguration->hasStopOnDeprecation()) {
$stopOnDeprecation = $cliConfiguration->stopOnDeprecation();
} else {
$stopOnDeprecation = $xmlConfiguration->phpunit()->stopOnDeprecation();
}
if ($cliConfiguration->hasStopOnError()) {
$stopOnError = $cliConfiguration->stopOnError();
} else {
$stopOnError = $xmlConfiguration->phpunit()->stopOnError();
}
if ($cliConfiguration->hasStopOnFailure()) {
$stopOnFailure = $cliConfiguration->stopOnFailure();
} else {
$stopOnFailure = $xmlConfiguration->phpunit()->stopOnFailure();
}
if ($cliConfiguration->hasStopOnIncomplete()) {
$stopOnIncomplete = $cliConfiguration->stopOnIncomplete();
} else {
$stopOnIncomplete = $xmlConfiguration->phpunit()->stopOnIncomplete();
}
if ($cliConfiguration->hasStopOnNotice()) {
$stopOnNotice = $cliConfiguration->stopOnNotice();
} else {
$stopOnNotice = $xmlConfiguration->phpunit()->stopOnNotice();
}
if ($cliConfiguration->hasStopOnRisky()) {
$stopOnRisky = $cliConfiguration->stopOnRisky();
} else {
$stopOnRisky = $xmlConfiguration->phpunit()->stopOnRisky();
}
if ($cliConfiguration->hasStopOnSkipped()) {
$stopOnSkipped = $cliConfiguration->stopOnSkipped();
} else {
$stopOnSkipped = $xmlConfiguration->phpunit()->stopOnSkipped();
}
if ($cliConfiguration->hasStopOnWarning()) {
$stopOnWarning = $cliConfiguration->stopOnWarning();
} else {
$stopOnWarning = $xmlConfiguration->phpunit()->stopOnWarning();
}
if ($cliConfiguration->hasStderr() && $cliConfiguration->stderr()) {
$outputToStandardErrorStream = true;
} else {
$outputToStandardErrorStream = $xmlConfiguration->phpunit()->stderr();
}
if ($cliConfiguration->hasColumns()) {
$columns = $cliConfiguration->columns();
} else {
$columns = $xmlConfiguration->phpunit()->columns();
}
if ($columns === 'max') {
$columns = (new Console)->getNumberOfColumns();
}
if ($columns < 16) {
$columns = 16;
EventFacade::emitter()->testRunnerTriggeredWarning(
'Less than 16 columns requested, number of columns set to 16',
);
}
assert(is_int($columns));
$noExtensions = false;
if ($cliConfiguration->hasNoExtensions() && $cliConfiguration->noExtensions()) {
$noExtensions = true;
}
$pharExtensionDirectory = null;
if ($xmlConfiguration->phpunit()->hasExtensionsDirectory()) {
$pharExtensionDirectory = $xmlConfiguration->phpunit()->extensionsDirectory();
}
$extensionBootstrappers = [];
foreach ($xmlConfiguration->extensions() as $extension) {
$extensionBootstrappers[] = [
'className' => $extension->className(),
'parameters' => $extension->parameters(),
];
}
if ($cliConfiguration->hasPathCoverage() && $cliConfiguration->pathCoverage()) {
$pathCoverage = $cliConfiguration->pathCoverage();
} else {
$pathCoverage = $xmlConfiguration->codeCoverage()->pathCoverage();
}
$defaultColors = Colors::default();
$defaultThresholds = Thresholds::default();
$coverageClover = null;
$coverageCobertura = null;
$coverageCrap4j = null;
$coverageCrap4jThreshold = 30;
$coverageHtml = null;
$coverageHtmlLowUpperBound = $defaultThresholds->lowUpperBound();
$coverageHtmlHighLowerBound = $defaultThresholds->highLowerBound();
$coverageHtmlColorSuccessLow = $defaultColors->successLow();
$coverageHtmlColorSuccessMedium = $defaultColors->successMedium();
$coverageHtmlColorSuccessHigh = $defaultColors->successHigh();
$coverageHtmlColorWarning = $defaultColors->warning();
$coverageHtmlColorDanger = $defaultColors->danger();
$coverageHtmlCustomCssFile = null;
$coveragePhp = null;
$coverageText = null;
$coverageTextShowUncoveredFiles = false;
$coverageTextShowOnlySummary = false;
$coverageXml = null;
$coverageFromXmlConfiguration = true;
if ($cliConfiguration->hasNoCoverage() && $cliConfiguration->noCoverage()) {
$coverageFromXmlConfiguration = false;
}
if ($cliConfiguration->hasCoverageClover()) {
$coverageClover = $cliConfiguration->coverageClover();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasClover()) {
$coverageClover = $xmlConfiguration->codeCoverage()->clover()->target()->path();
}
if ($cliConfiguration->hasCoverageCobertura()) {
$coverageCobertura = $cliConfiguration->coverageCobertura();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasCobertura()) {
$coverageCobertura = $xmlConfiguration->codeCoverage()->cobertura()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasCrap4j()) {
$coverageCrap4jThreshold = $xmlConfiguration->codeCoverage()->crap4j()->threshold();
}
if ($cliConfiguration->hasCoverageCrap4J()) {
$coverageCrap4j = $cliConfiguration->coverageCrap4J();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasCrap4j()) {
$coverageCrap4j = $xmlConfiguration->codeCoverage()->crap4j()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasHtml()) {
$coverageHtmlHighLowerBound = $xmlConfiguration->codeCoverage()->html()->highLowerBound();
$coverageHtmlLowUpperBound = $xmlConfiguration->codeCoverage()->html()->lowUpperBound();
if ($coverageHtmlLowUpperBound > $coverageHtmlHighLowerBound) {
$coverageHtmlLowUpperBound = $defaultThresholds->lowUpperBound();
$coverageHtmlHighLowerBound = $defaultThresholds->highLowerBound();
}
$coverageHtmlColorSuccessLow = $xmlConfiguration->codeCoverage()->html()->colorSuccessLow();
$coverageHtmlColorSuccessMedium = $xmlConfiguration->codeCoverage()->html()->colorSuccessMedium();
$coverageHtmlColorSuccessHigh = $xmlConfiguration->codeCoverage()->html()->colorSuccessHigh();
$coverageHtmlColorWarning = $xmlConfiguration->codeCoverage()->html()->colorWarning();
$coverageHtmlColorDanger = $xmlConfiguration->codeCoverage()->html()->colorDanger();
if ($xmlConfiguration->codeCoverage()->html()->hasCustomCssFile()) {
$coverageHtmlCustomCssFile = $xmlConfiguration->codeCoverage()->html()->customCssFile();
}
}
if ($cliConfiguration->hasCoverageHtml()) {
$coverageHtml = $cliConfiguration->coverageHtml();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasHtml()) {
$coverageHtml = $xmlConfiguration->codeCoverage()->html()->target()->path();
}
if ($cliConfiguration->hasCoveragePhp()) {
$coveragePhp = $cliConfiguration->coveragePhp();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasPhp()) {
$coveragePhp = $xmlConfiguration->codeCoverage()->php()->target()->path();
}
if ($xmlConfiguration->codeCoverage()->hasText()) {
$coverageTextShowUncoveredFiles = $xmlConfiguration->codeCoverage()->text()->showUncoveredFiles();
$coverageTextShowOnlySummary = $xmlConfiguration->codeCoverage()->text()->showOnlySummary();
}
if ($cliConfiguration->hasCoverageText()) {
$coverageText = $cliConfiguration->coverageText();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasText()) {
$coverageText = $xmlConfiguration->codeCoverage()->text()->target()->path();
}
if ($cliConfiguration->hasCoverageXml()) {
$coverageXml = $cliConfiguration->coverageXml();
} elseif ($coverageFromXmlConfiguration && $xmlConfiguration->codeCoverage()->hasXml()) {
$coverageXml = $xmlConfiguration->codeCoverage()->xml()->target()->path();
}
if ($cliConfiguration->hasBackupGlobals()) {
$backupGlobals = $cliConfiguration->backupGlobals();
} else {
$backupGlobals = $xmlConfiguration->phpunit()->backupGlobals();
}
if ($cliConfiguration->hasBackupStaticProperties()) {
$backupStaticProperties = $cliConfiguration->backupStaticProperties();
} else {
$backupStaticProperties = $xmlConfiguration->phpunit()->backupStaticProperties();
}
if ($cliConfiguration->hasBeStrictAboutChangesToGlobalState()) {
$beStrictAboutChangesToGlobalState = $cliConfiguration->beStrictAboutChangesToGlobalState();
} else {
$beStrictAboutChangesToGlobalState = $xmlConfiguration->phpunit()->beStrictAboutChangesToGlobalState();
}
if ($cliConfiguration->hasProcessIsolation()) {
$processIsolation = $cliConfiguration->processIsolation();
} else {
$processIsolation = $xmlConfiguration->phpunit()->processIsolation();
}
if ($cliConfiguration->hasEnforceTimeLimit()) {
$enforceTimeLimit = $cliConfiguration->enforceTimeLimit();
} else {
$enforceTimeLimit = $xmlConfiguration->phpunit()->enforceTimeLimit();
}
if ($enforceTimeLimit && !(new Invoker)->canInvokeWithTimeout()) {
EventFacade::emitter()->testRunnerTriggeredWarning(
'The pcntl extension is required for enforcing time limits',
);
}
if ($cliConfiguration->hasDefaultTimeLimit()) {
$defaultTimeLimit = $cliConfiguration->defaultTimeLimit();
} else {
$defaultTimeLimit = $xmlConfiguration->phpunit()->defaultTimeLimit();
}
$timeoutForSmallTests = $xmlConfiguration->phpunit()->timeoutForSmallTests();
$timeoutForMediumTests = $xmlConfiguration->phpunit()->timeoutForMediumTests();
$timeoutForLargeTests = $xmlConfiguration->phpunit()->timeoutForLargeTests();
if ($cliConfiguration->hasReportUselessTests()) {
$reportUselessTests = $cliConfiguration->reportUselessTests();
} else {
$reportUselessTests = $xmlConfiguration->phpunit()->beStrictAboutTestsThatDoNotTestAnything();
}
if ($cliConfiguration->hasStrictCoverage()) {
$strictCoverage = $cliConfiguration->strictCoverage();
} else {
$strictCoverage = $xmlConfiguration->phpunit()->beStrictAboutCoverageMetadata();
}
if ($cliConfiguration->hasDisallowTestOutput()) {
$disallowTestOutput = $cliConfiguration->disallowTestOutput();
} else {
$disallowTestOutput = $xmlConfiguration->phpunit()->beStrictAboutOutputDuringTests();
}
if ($cliConfiguration->hasDisplayDetailsOnIncompleteTests()) {
$displayDetailsOnIncompleteTests = $cliConfiguration->displayDetailsOnIncompleteTests();
} else {
$displayDetailsOnIncompleteTests = $xmlConfiguration->phpunit()->displayDetailsOnIncompleteTests();
}
if ($cliConfiguration->hasDisplayDetailsOnSkippedTests()) {
$displayDetailsOnSkippedTests = $cliConfiguration->displayDetailsOnSkippedTests();
} else {
$displayDetailsOnSkippedTests = $xmlConfiguration->phpunit()->displayDetailsOnSkippedTests();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerDeprecations()) {
$displayDetailsOnTestsThatTriggerDeprecations = $cliConfiguration->displayDetailsOnTestsThatTriggerDeprecations();
} else {
$displayDetailsOnTestsThatTriggerDeprecations = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerDeprecations();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerErrors()) {
$displayDetailsOnTestsThatTriggerErrors = $cliConfiguration->displayDetailsOnTestsThatTriggerErrors();
} else {
$displayDetailsOnTestsThatTriggerErrors = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerErrors();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerNotices()) {
$displayDetailsOnTestsThatTriggerNotices = $cliConfiguration->displayDetailsOnTestsThatTriggerNotices();
} else {
$displayDetailsOnTestsThatTriggerNotices = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerNotices();
}
if ($cliConfiguration->hasDisplayDetailsOnTestsThatTriggerWarnings()) {
$displayDetailsOnTestsThatTriggerWarnings = $cliConfiguration->displayDetailsOnTestsThatTriggerWarnings();
} else {
$displayDetailsOnTestsThatTriggerWarnings = $xmlConfiguration->phpunit()->displayDetailsOnTestsThatTriggerWarnings();
}
if ($cliConfiguration->hasReverseList()) {
$reverseDefectList = $cliConfiguration->reverseList();
} else {
$reverseDefectList = $xmlConfiguration->phpunit()->reverseDefectList();
}
$requireCoverageMetadata = $xmlConfiguration->phpunit()->requireCoverageMetadata();
$registerMockObjectsFromTestArgumentsRecursively = $xmlConfiguration->phpunit()->registerMockObjectsFromTestArgumentsRecursively();
if ($cliConfiguration->hasExecutionOrder()) {
$executionOrder = $cliConfiguration->executionOrder();
} else {
$executionOrder = $xmlConfiguration->phpunit()->executionOrder();
}
$executionOrderDefects = TestSuiteSorter::ORDER_DEFAULT;
if ($cliConfiguration->hasExecutionOrderDefects()) {
$executionOrderDefects = $cliConfiguration->executionOrderDefects();
} elseif ($xmlConfiguration->phpunit()->defectsFirst()) {
$executionOrderDefects = TestSuiteSorter::ORDER_DEFECTS_FIRST;
}
if ($cliConfiguration->hasResolveDependencies()) {
$resolveDependencies = $cliConfiguration->resolveDependencies();
} else {
$resolveDependencies = $xmlConfiguration->phpunit()->resolveDependencies();
}
$colors = false;
$colorsSupported = (new Console)->hasColorSupport();
if ($cliConfiguration->hasColors()) {
if ($cliConfiguration->colors() === Configuration::COLOR_ALWAYS) {
$colors = true;
} elseif ($colorsSupported && $cliConfiguration->colors() === Configuration::COLOR_AUTO) {
$colors = true;
}
} elseif ($xmlConfiguration->phpunit()->colors() === Configuration::COLOR_ALWAYS) {
$colors = true;
} elseif ($colorsSupported && $xmlConfiguration->phpunit()->colors() === Configuration::COLOR_AUTO) {
$colors = true;
}
$logfileTeamcity = null;
$logfileJunit = null;
$logfileTestdoxHtml = null;
$logfileTestdoxText = null;
$loggingFromXmlConfiguration = true;
if ($cliConfiguration->hasNoLogging() && $cliConfiguration->noLogging()) {
$loggingFromXmlConfiguration = false;
}
if ($cliConfiguration->hasTeamcityLogfile()) {
$logfileTeamcity = $cliConfiguration->teamcityLogfile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTeamCity()) {
$logfileTeamcity = $xmlConfiguration->logging()->teamCity()->target()->path();
}
if ($cliConfiguration->hasJunitLogfile()) {
$logfileJunit = $cliConfiguration->junitLogfile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasJunit()) {
$logfileJunit = $xmlConfiguration->logging()->junit()->target()->path();
}
if ($cliConfiguration->hasTestdoxHtmlFile()) {
$logfileTestdoxHtml = $cliConfiguration->testdoxHtmlFile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTestDoxHtml()) {
$logfileTestdoxHtml = $xmlConfiguration->logging()->testDoxHtml()->target()->path();
}
if ($cliConfiguration->hasTestdoxTextFile()) {
$logfileTestdoxText = $cliConfiguration->testdoxTextFile();
} elseif ($loggingFromXmlConfiguration && $xmlConfiguration->logging()->hasTestDoxText()) {
$logfileTestdoxText = $xmlConfiguration->logging()->testDoxText()->target()->path();
}
$logEventsText = null;
if ($cliConfiguration->hasLogEventsText()) {
$logEventsText = $cliConfiguration->logEventsText();
}
$logEventsVerboseText = null;
if ($cliConfiguration->hasLogEventsVerboseText()) {
$logEventsVerboseText = $cliConfiguration->logEventsVerboseText();
}
$teamCityOutput = false;
if ($cliConfiguration->hasTeamCityPrinter() && $cliConfiguration->teamCityPrinter()) {
$teamCityOutput = true;
}
if ($cliConfiguration->hasTestDoxPrinter() && $cliConfiguration->testdoxPrinter()) {
$testDoxOutput = true;
} else {
$testDoxOutput = $xmlConfiguration->phpunit()->testdoxPrinter();
}
$noProgress = false;
if ($cliConfiguration->hasNoProgress() && $cliConfiguration->noProgress()) {
$noProgress = true;
}
$noResults = false;
if ($cliConfiguration->hasNoResults() && $cliConfiguration->noResults()) {
$noResults = true;
}
$noOutput = false;
if ($cliConfiguration->hasNoOutput() && $cliConfiguration->noOutput()) {
$noOutput = true;
}
$testsCovering = null;
if ($cliConfiguration->hasTestsCovering()) {
$testsCovering = $cliConfiguration->testsCovering();
}
$testsUsing = null;
if ($cliConfiguration->hasTestsUsing()) {
$testsUsing = $cliConfiguration->testsUsing();
}
$filter = null;
if ($cliConfiguration->hasFilter()) {
$filter = $cliConfiguration->filter();
}
if ($cliConfiguration->hasGroups()) {
$groups = $cliConfiguration->groups();
} else {
$groups = $xmlConfiguration->groups()->include()->asArrayOfStrings();
}
if ($cliConfiguration->hasExcludeGroups()) {
$excludeGroups = $cliConfiguration->excludeGroups();
} else {
$excludeGroups = $xmlConfiguration->groups()->exclude()->asArrayOfStrings();
}
$excludeGroups = array_diff($excludeGroups, $groups);
if ($cliConfiguration->hasRandomOrderSeed()) {
$randomOrderSeed = $cliConfiguration->randomOrderSeed();
} else {
$randomOrderSeed = time();
}
if ($xmlConfiguration->wasLoadedFromFile() && $xmlConfiguration->hasValidationErrors()) {
if ((new SchemaDetector)->detect($xmlConfiguration->filename())->detected()) {
EventFacade::emitter()->testRunnerTriggeredDeprecation(
'Your XML configuration validates against a deprecated schema. Migrate your XML configuration using "--migrate-configuration"!',
);
} else {
EventFacade::emitter()->testRunnerTriggeredWarning(
"Test results may not be as expected because the XML configuration file did not pass validation:\n" .
$xmlConfiguration->validationErrors(),
);
}
}
$includeUncoveredFiles = $xmlConfiguration->codeCoverage()->includeUncoveredFiles();
$includePaths = [];
if ($cliConfiguration->hasIncludePath()) {
foreach (explode(PATH_SEPARATOR, $cliConfiguration->includePath()) as $includePath) {
$includePaths[] = new Directory($includePath);
}
}
foreach ($xmlConfiguration->php()->includePaths() as $includePath) {
$includePaths[] = $includePath;
}
$iniSettings = [];
if ($cliConfiguration->hasIniSettings()) {
foreach ($cliConfiguration->iniSettings() as $name => $value) {
$iniSettings[] = new IniSetting($name, $value);
}
}
foreach ($xmlConfiguration->php()->iniSettings() as $iniSetting) {
$iniSettings[] = $iniSetting;
}
$includeTestSuite = '';
if ($cliConfiguration->hasTestSuite()) {
$includeTestSuite = $cliConfiguration->testSuite();
} elseif ($xmlConfiguration->phpunit()->hasDefaultTestSuite()) {
$includeTestSuite = $xmlConfiguration->phpunit()->defaultTestSuite();
}
$excludeTestSuite = '';
if ($cliConfiguration->hasExcludedTestSuite()) {
$excludeTestSuite = $cliConfiguration->excludedTestSuite();
}
$testSuffixes = ['Test.php', '.phpt'];
if ($cliConfiguration->hasTestSuffixes()) {
$testSuffixes = $cliConfiguration->testSuffixes();
}
$sourceIncludeDirectories = [];
if ($cliConfiguration->hasCoverageFilter()) {
foreach ($cliConfiguration->coverageFilter() as $directory) {
$sourceIncludeDirectories[] = new FilterDirectory($directory, '', '.php');
}
}
if ($xmlConfiguration->codeCoverage()->hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport()) {
foreach ($xmlConfiguration->codeCoverage()->directories() as $directory) {
$sourceIncludeDirectories[] = $directory;
}
$sourceIncludeFiles = $xmlConfiguration->codeCoverage()->files();
$sourceExcludeDirectories = $xmlConfiguration->codeCoverage()->excludeDirectories();
$sourceExcludeFiles = $xmlConfiguration->codeCoverage()->excludeFiles();
} else {
foreach ($xmlConfiguration->source()->includeDirectories() as $directory) {
$sourceIncludeDirectories[] = $directory;
}
$sourceIncludeFiles = $xmlConfiguration->source()->includeFiles();
$sourceExcludeDirectories = $xmlConfiguration->source()->excludeDirectories();
$sourceExcludeFiles = $xmlConfiguration->source()->excludeFiles();
}
$useBaseline = null;
$generateBaseline = null;
if (!$cliConfiguration->hasGenerateBaseline()) {
if ($cliConfiguration->hasUseBaseline()) {
$useBaseline = $cliConfiguration->useBaseline();
} elseif ($xmlConfiguration->source()->hasBaseline()) {
$useBaseline = $xmlConfiguration->source()->baseline();
}
} else {
$generateBaseline = $cliConfiguration->generateBaseline();
}
assert($useBaseline !== '');
assert($generateBaseline !== '');
return new Configuration(
$cliConfiguration->arguments(),
$configurationFile,
$bootstrap,
$cacheResult,
$cacheDirectory,
$coverageCacheDirectory,
new Source(
$useBaseline,
$cliConfiguration->ignoreBaseline(),
FilterDirectoryCollection::fromArray($sourceIncludeDirectories),
$sourceIncludeFiles,
$sourceExcludeDirectories,
$sourceExcludeFiles,
$xmlConfiguration->source()->restrictDeprecations(),
$xmlConfiguration->source()->restrictNotices(),
$xmlConfiguration->source()->restrictWarnings(),
$xmlConfiguration->source()->ignoreSuppressionOfDeprecations(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpDeprecations(),
$xmlConfiguration->source()->ignoreSuppressionOfErrors(),
$xmlConfiguration->source()->ignoreSuppressionOfNotices(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpNotices(),
$xmlConfiguration->source()->ignoreSuppressionOfWarnings(),
$xmlConfiguration->source()->ignoreSuppressionOfPhpWarnings(),
),
$testResultCacheFile,
$coverageClover,
$coverageCobertura,
$coverageCrap4j,
$coverageCrap4jThreshold,
$coverageHtml,
$coverageHtmlLowUpperBound,
$coverageHtmlHighLowerBound,
$coverageHtmlColorSuccessLow,
$coverageHtmlColorSuccessMedium,
$coverageHtmlColorSuccessHigh,
$coverageHtmlColorWarning,
$coverageHtmlColorDanger,
$coverageHtmlCustomCssFile,
$coveragePhp,
$coverageText,
$coverageTextShowUncoveredFiles,
$coverageTextShowOnlySummary,
$coverageXml,
$pathCoverage,
$xmlConfiguration->codeCoverage()->ignoreDeprecatedCodeUnits(),
$disableCodeCoverageIgnore,
$failOnDeprecation,
$failOnEmptyTestSuite,
$failOnIncomplete,
$failOnNotice,
$failOnRisky,
$failOnSkipped,
$failOnWarning,
$stopOnDefect,
$stopOnDeprecation,
$stopOnError,
$stopOnFailure,
$stopOnIncomplete,
$stopOnNotice,
$stopOnRisky,
$stopOnSkipped,
$stopOnWarning,
$outputToStandardErrorStream,
$columns,
$noExtensions,
$pharExtensionDirectory,
$extensionBootstrappers,
$backupGlobals,
$backupStaticProperties,
$beStrictAboutChangesToGlobalState,
$colors,
$processIsolation,
$enforceTimeLimit,
$defaultTimeLimit,
$timeoutForSmallTests,
$timeoutForMediumTests,
$timeoutForLargeTests,
$reportUselessTests,
$strictCoverage,
$disallowTestOutput,
$displayDetailsOnIncompleteTests,
$displayDetailsOnSkippedTests,
$displayDetailsOnTestsThatTriggerDeprecations,
$displayDetailsOnTestsThatTriggerErrors,
$displayDetailsOnTestsThatTriggerNotices,
$displayDetailsOnTestsThatTriggerWarnings,
$reverseDefectList,
$requireCoverageMetadata,
$registerMockObjectsFromTestArgumentsRecursively,
$noProgress,
$noResults,
$noOutput,
$executionOrder,
$executionOrderDefects,
$resolveDependencies,
$logfileTeamcity,
$logfileJunit,
$logfileTestdoxHtml,
$logfileTestdoxText,
$logEventsText,
$logEventsVerboseText,
$teamCityOutput,
$testDoxOutput,
$testsCovering,
$testsUsing,
$filter,
$groups,
$excludeGroups,
$randomOrderSeed,
$includeUncoveredFiles,
$xmlConfiguration->testSuite(),
$includeTestSuite,
$excludeTestSuite,
$xmlConfiguration->phpunit()->hasDefaultTestSuite() ? $xmlConfiguration->phpunit()->defaultTestSuite() : null,
$testSuffixes,
new Php(
DirectoryCollection::fromArray($includePaths),
IniSettingCollection::fromArray($iniSettings),
$xmlConfiguration->php()->constants(),
$xmlConfiguration->php()->globalVariables(),
$xmlConfiguration->php()->envVariables(),
$xmlConfiguration->php()->postVariables(),
$xmlConfiguration->php()->getVariables(),
$xmlConfiguration->php()->cookieVariables(),
$xmlConfiguration->php()->serverVariables(),
$xmlConfiguration->php()->filesVariables(),
$xmlConfiguration->php()->requestVariables(),
),
$xmlConfiguration->phpunit()->controlGarbageCollector(),
$xmlConfiguration->phpunit()->numberOfTestsBeforeGarbageCollection(),
$generateBaseline,
$cliConfiguration->debug(),
);
}
}
src/TextUI/Configuration/Xml/SchemaFinder.php 0000644 00000003520 15243426620 0015131 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use function defined;
use function is_file;
use function rsort;
use function sprintf;
use DirectoryIterator;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SchemaFinder
{
/**
* @psalm-return non-empty-list<non-empty-string>
*/
public function available(): array
{
$result = [Version::series()];
foreach ((new DirectoryIterator($this->path() . 'schema')) as $file) {
if ($file->isDot()) {
continue;
}
$version = $file->getBasename('.xsd');
assert(!empty($version));
$result[] = $version;
}
rsort($result);
return $result;
}
/**
* @throws CannotFindSchemaException
*/
public function find(string $version): string
{
if ($version === Version::series()) {
$filename = $this->path() . 'phpunit.xsd';
} else {
$filename = $this->path() . 'schema/' . $version . '.xsd';
}
if (!is_file($filename)) {
throw new CannotFindSchemaException(
sprintf(
'Schema for PHPUnit %s is not available',
$version,
),
);
}
return $filename;
}
private function path(): string
{
if (defined('__PHPUNIT_PHAR_ROOT__')) {
return __PHPUNIT_PHAR_ROOT__ . '/';
}
return __DIR__ . '/../../../../';
}
}
src/TextUI/Configuration/Xml/TestSuiteMapper.php 0000644 00000007736 15243426620 0015714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use const PHP_VERSION;
use function array_merge;
use function array_unique;
use function explode;
use function in_array;
use function is_dir;
use function is_file;
use function str_contains;
use function version_compare;
use PHPUnit\Framework\Exception as FrameworkException;
use PHPUnit\Framework\TestSuite as TestSuiteObject;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\RuntimeException;
use PHPUnit\TextUI\TestDirectoryNotFoundException;
use PHPUnit\TextUI\TestFileNotFoundException;
use SebastianBergmann\FileIterator\Facade;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteMapper
{
/**
* @psalm-param non-empty-string $xmlConfigurationFile,
*
* @throws RuntimeException
* @throws TestDirectoryNotFoundException
* @throws TestFileNotFoundException
*/
public function map(string $xmlConfigurationFile, TestSuiteCollection $configuration, string $filter, string $excludedTestSuites): TestSuiteObject
{
try {
$filterAsArray = $filter ? explode(',', $filter) : [];
$excludedFilterAsArray = $excludedTestSuites ? explode(',', $excludedTestSuites) : [];
$result = TestSuiteObject::empty($xmlConfigurationFile);
foreach ($configuration as $testSuiteConfiguration) {
if (!empty($filterAsArray) && !in_array($testSuiteConfiguration->name(), $filterAsArray, true)) {
continue;
}
if (!empty($excludedFilterAsArray) && in_array($testSuiteConfiguration->name(), $excludedFilterAsArray, true)) {
continue;
}
$exclude = [];
foreach ($testSuiteConfiguration->exclude()->asArray() as $file) {
$exclude[] = $file->path();
}
$files = [];
foreach ($testSuiteConfiguration->directories() as $directory) {
if (!str_contains($directory->path(), '*') && !is_dir($directory->path())) {
throw new TestDirectoryNotFoundException($directory->path());
}
if (!version_compare(PHP_VERSION, $directory->phpVersion(), $directory->phpVersionOperator()->asString())) {
continue;
}
$files = array_merge(
$files,
(new Facade)->getFilesAsArray(
$directory->path(),
$directory->suffix(),
$directory->prefix(),
$exclude,
),
);
}
foreach ($testSuiteConfiguration->files() as $file) {
if (!is_file($file->path())) {
throw new TestFileNotFoundException($file->path());
}
if (!version_compare(PHP_VERSION, $file->phpVersion(), $file->phpVersionOperator()->asString())) {
continue;
}
$files[] = $file->path();
}
if (!empty($files)) {
$testSuite = TestSuiteObject::empty($testSuiteConfiguration->name());
$testSuite->addTestFiles(array_unique($files));
$result->addTest($testSuite);
}
}
return $result;
} catch (FrameworkException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
}
src/TextUI/Configuration/Xml/Migration/MigrationBuilder.php 0000644 00000005336 15243426620 0020001 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function version_compare;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationBuilder
{
private const AVAILABLE_MIGRATIONS = [
'8.5' => [
RemoveLogTypes::class,
],
'9.2' => [
RemoveCacheTokensAttribute::class,
IntroduceCoverageElement::class,
MoveAttributesFromRootToCoverage::class,
MoveAttributesFromFilterWhitelistToCoverage::class,
MoveWhitelistIncludesToCoverage::class,
MoveWhitelistExcludesToCoverage::class,
RemoveEmptyFilter::class,
CoverageCloverToReport::class,
CoverageCrap4jToReport::class,
CoverageHtmlToReport::class,
CoveragePhpToReport::class,
CoverageTextToReport::class,
CoverageXmlToReport::class,
ConvertLogTypes::class,
],
'9.5' => [
RemoveListeners::class,
RemoveTestSuiteLoaderAttributes::class,
RemoveCacheResultFileAttribute::class,
RemoveCoverageElementCacheDirectoryAttribute::class,
RemoveCoverageElementProcessUncoveredFilesAttribute::class,
IntroduceCacheDirectoryAttribute::class,
RenameBackupStaticAttributesAttribute::class,
RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute::class,
RemoveBeStrictAboutTodoAnnotatedTestsAttribute::class,
RemovePrinterAttributes::class,
RemoveVerboseAttribute::class,
RenameForceCoversAnnotationAttribute::class,
RenameBeStrictAboutCoversAnnotationAttribute::class,
RemoveConversionToExceptionsAttributes::class,
RemoveNoInteractionAttribute::class,
RemoveLoggingElements::class,
RemoveTestDoxGroupsElement::class,
],
'10.0' => [
MoveCoverageDirectoriesToSource::class,
],
];
/**
* @throws MigrationBuilderException
*/
public function build(string $fromVersion): array
{
$stack = [new UpdateSchemaLocation];
foreach (self::AVAILABLE_MIGRATIONS as $version => $migrations) {
if (version_compare($version, $fromVersion, '<')) {
continue;
}
foreach ($migrations as $migration) {
$stack[] = new $migration;
}
}
return $stack;
}
}
src/TextUI/Configuration/Xml/Migration/MigrationException.php 0000644 00000001011 15243426620 0020333 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveAttributesFromFilterWhitelistToCoverage.php 0000644 00000002625 15243426620 0027476 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveAttributesFromFilterWhitelistToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if (!$whitelist) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$map = [
'addUncoveredFilesFromWhitelist' => 'includeUncoveredFiles',
'processUncoveredFilesFromWhitelist' => 'processUncoveredFiles',
];
foreach ($map as $old => $new) {
if (!$whitelist->hasAttribute($old)) {
continue;
}
$coverage->setAttribute($new, $whitelist->getAttribute($old));
$whitelist->removeAttribute($old);
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoverageCrap4jToReport.php 0000644 00000001573 15243426620 0023152 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageCrap4jToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-crap4j';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$crap4j = $logNode->ownerDocument->createElement('crap4j');
$crap4j->setAttribute('outputFile', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $crap4j, ['threshold']);
return $crap4j;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCoverageElementCacheDirectoryAttribute.php 0000644 00000001550 15243426620 0027567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCoverageElementCacheDirectoryAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('coverage')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
if ($node->hasAttribute('cacheDirectory')) {
$node->removeAttribute('cacheDirectory');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveWhitelistIncludesToCoverage.php 0000644 00000002627 15243426620 0025126 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveWhitelistIncludesToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist === null) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$include = $document->createElement('include');
$coverage->appendChild($include);
foreach (SnapshotNodeList::fromNodeList($whitelist->childNodes) as $child) {
if (!$child instanceof DOMElement) {
continue;
}
if (!($child->nodeName === 'directory' || $child->nodeName === 'file')) {
continue;
}
$include->appendChild($child);
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/IntroduceCoverageElement.php 0000644 00000001342 15243426620 0023570 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IntroduceCoverageElement implements Migration
{
public function migrate(DOMDocument $document): void
{
$coverage = $document->createElement('coverage');
$document->documentElement->insertBefore(
$coverage,
$document->documentElement->firstChild,
);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/ConvertLogTypes.php 0000644 00000002764 15243426620 0021766 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConvertLogTypes implements Migration
{
public function migrate(DOMDocument $document): void
{
$logging = $document->getElementsByTagName('logging')->item(0);
if (!$logging instanceof DOMElement) {
return;
}
$types = [
'junit' => 'junit',
'teamcity' => 'teamcity',
'testdox-html' => 'testdoxHtml',
'testdox-text' => 'testdoxText',
'testdox-xml' => 'testdoxXml',
'plain' => 'text',
];
$logNodes = [];
foreach ($logging->getElementsByTagName('log') as $logNode) {
if (!isset($types[$logNode->getAttribute('type')])) {
continue;
}
$logNodes[] = $logNode;
}
foreach ($logNodes as $oldNode) {
$newLogNode = $document->createElement($types[$oldNode->getAttribute('type')]);
$newLogNode->setAttribute('outputFile', $oldNode->getAttribute('target'));
$logging->replaceChild($newLogNode, $oldNode);
}
}
}
Configuration/Xml/Migration/Migrations/RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute.php0000644 00000001555 15243426620 0032233 0 ustar 00 src/TextUI <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveBeStrictAboutResourceUsageDuringSmallTestsAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutResourceUsageDuringSmallTests')) {
$root->removeAttribute('beStrictAboutResourceUsageDuringSmallTests');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveVerboseAttribute.php 0000644 00000001404 15243426620 0023314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveVerboseAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('verbose')) {
$root->removeAttribute('verbose');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveBeStrictAboutTodoAnnotatedTestsAttribute.php0000644 00000001514 15243426620 0030132 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveBeStrictAboutTodoAnnotatedTestsAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutTodoAnnotatedTests')) {
$root->removeAttribute('beStrictAboutTodoAnnotatedTests');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveWhitelistExcludesToCoverage.php 0000644 00000004105 15243426620 0025125 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use function in_array;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveWhitelistExcludesToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist === null) {
return;
}
$excludeNodes = SnapshotNodeList::fromNodeList($whitelist->getElementsByTagName('exclude'));
if ($excludeNodes->count() === 0) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$targetExclude = $coverage->getElementsByTagName('exclude')->item(0);
if ($targetExclude === null) {
$targetExclude = $coverage->appendChild(
$document->createElement('exclude'),
);
}
foreach ($excludeNodes as $excludeNode) {
assert($excludeNode instanceof DOMElement);
foreach (SnapshotNodeList::fromNodeList($excludeNode->childNodes) as $child) {
if (!$child instanceof DOMElement || !in_array($child->nodeName, ['directory', 'file'], true)) {
continue;
}
$targetExclude->appendChild($child);
}
if ($excludeNode->getElementsByTagName('*')->count() !== 0) {
throw new MigrationException('Dangling child elements in exclude found.');
}
$whitelist->removeChild($excludeNode);
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveListeners.php 0000644 00000001406 15243426620 0021775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveListeners implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('listeners')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveConversionToExceptionsAttributes.php 0000644 00000002356 15243426620 0026573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveConversionToExceptionsAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('convertDeprecationsToExceptions')) {
$root->removeAttribute('convertDeprecationsToExceptions');
}
if ($root->hasAttribute('convertErrorsToExceptions')) {
$root->removeAttribute('convertErrorsToExceptions');
}
if ($root->hasAttribute('convertNoticesToExceptions')) {
$root->removeAttribute('convertNoticesToExceptions');
}
if ($root->hasAttribute('convertWarningsToExceptions')) {
$root->removeAttribute('convertWarningsToExceptions');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/UpdateSchemaLocation.php 0000644 00000001626 15243426620 0022707 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
use PHPUnit\Runner\Version;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UpdateSchemaLocation implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
$root->setAttributeNS(
'http://www.w3.org/2001/XMLSchema-instance',
'xsi:noNamespaceSchemaLocation',
'https://schema.phpunit.de/' . Version::series() . '/phpunit.xsd',
);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/IntroduceCacheDirectoryAttribute.php 0000644 00000001474 15243426620 0025305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IntroduceCacheDirectoryAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheDirectory')) {
return;
}
$root->setAttribute('cacheDirectory', '.phpunit.cache');
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveAttributesFromRootToCoverage.php 0000644 00000002572 15243426620 0025300 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveAttributesFromRootToCoverage implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$map = [
'disableCodeCoverageIgnore' => 'disableCodeCoverageIgnore',
'ignoreDeprecatedCodeUnitsFromCodeCoverage' => 'ignoreDeprecatedCodeUnits',
];
$root = $document->documentElement;
assert($root instanceof DOMElement);
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
foreach ($map as $old => $new) {
if (!$root->hasAttribute($old)) {
continue;
}
$coverage->setAttribute($new, $root->getAttribute($old));
$root->removeAttribute($old);
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveLogTypes.php 0000644 00000002050 15243426620 0021567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveLogTypes implements Migration
{
public function migrate(DOMDocument $document): void
{
$logging = $document->getElementsByTagName('logging')->item(0);
if (!$logging instanceof DOMElement) {
return;
}
foreach (SnapshotNodeList::fromNodeList($logging->getElementsByTagName('log')) as $logNode) {
assert($logNode instanceof DOMElement);
switch ($logNode->getAttribute('type')) {
case 'json':
case 'tap':
$logging->removeChild($logNode);
}
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoveragePhpToReport.php 0000644 00000001444 15243426620 0022553 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoveragePhpToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-php';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$php = $logNode->ownerDocument->createElement('php');
$php->setAttribute('outputFile', $logNode->getAttribute('target'));
return $php;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RenameForceCoversAnnotationAttribute.php 0000644 00000002003 15243426620 0026130 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameForceCoversAnnotationAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('requireCoverageMetadata')) {
return;
}
if (!$root->hasAttribute('forceCoversAnnotation')) {
return;
}
$root->setAttribute('requireCoverageMetadata', $root->getAttribute('forceCoversAnnotation'));
$root->removeAttribute('forceCoversAnnotation');
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCacheTokensAttribute.php 0000644 00000001420 15243426620 0024074 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCacheTokensAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheTokens')) {
$root->removeAttribute('cacheTokens');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveTestDoxGroupsElement.php 0000644 00000001425 15243426620 0024132 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveTestDoxGroupsElement implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('testdoxGroups')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/Migration.php 0000644 00000000756 15243426620 0020607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Migration
{
public function migrate(DOMDocument $document): void;
}
src/TextUI/Configuration/Xml/Migration/Migrations/RenameBeStrictAboutCoversAnnotationAttribute.php 0000644 00000002057 15243426620 0027615 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameBeStrictAboutCoversAnnotationAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('beStrictAboutCoverageMetadata')) {
return;
}
if (!$root->hasAttribute('beStrictAboutCoversAnnotation')) {
return;
}
$root->setAttribute('beStrictAboutCoverageMetadata', $root->getAttribute('beStrictAboutCoversAnnotation'));
$root->removeAttribute('beStrictAboutCoversAnnotation');
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveNoInteractionAttribute.php 0000644 00000001426 15243426620 0024467 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveNoInteractionAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('noInteraction')) {
$root->removeAttribute('noInteraction');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RenameBackupStaticAttributesAttribute.php 0000644 00000002005 15243426620 0026303 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RenameBackupStaticAttributesAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('backupStaticProperties')) {
return;
}
if (!$root->hasAttribute('backupStaticAttributes')) {
return;
}
$root->setAttribute('backupStaticProperties', $root->getAttribute('backupStaticAttributes'));
$root->removeAttribute('backupStaticAttributes');
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveCacheResultFileAttribute.php 0000644 00000001434 15243426620 0024714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCacheResultFileAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('cacheResultFile')) {
$root->removeAttribute('cacheResultFile');
}
}
}
Configuration/Xml/Migration/Migrations/RemoveCoverageElementProcessUncoveredFilesAttribute.php 0000644 00000001575 15243426620 0031103 0 ustar 00 src/TextUI <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveCoverageElementProcessUncoveredFilesAttribute implements Migration
{
public function migrate(DOMDocument $document): void
{
$node = $document->getElementsByTagName('coverage')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
if ($node->hasAttribute('processUncoveredFiles')) {
$node->removeAttribute('processUncoveredFiles');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/LogToReportMigration.php 0000644 00000004152 15243426620 0022742 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class LogToReportMigration implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$coverage = $document->getElementsByTagName('coverage')->item(0);
if (!$coverage instanceof DOMElement) {
throw new MigrationException('Unexpected state - No coverage element');
}
$logNode = $this->findLogNode($document);
if ($logNode === null) {
return;
}
$reportChild = $this->toReportFormat($logNode);
$report = $coverage->getElementsByTagName('report')->item(0);
if ($report === null) {
$report = $coverage->appendChild($document->createElement('report'));
}
$report->appendChild($reportChild);
$logNode->parentNode->removeChild($logNode);
}
protected function migrateAttributes(DOMElement $src, DOMElement $dest, array $attributes): void
{
foreach ($attributes as $attr) {
if (!$src->hasAttribute($attr)) {
continue;
}
$dest->setAttribute($attr, $src->getAttribute($attr));
$src->removeAttribute($attr);
}
}
abstract protected function forType(): string;
abstract protected function toReportFormat(DOMElement $logNode): DOMElement;
private function findLogNode(DOMDocument $document): ?DOMElement
{
$logNode = (new DOMXPath($document))->query(
sprintf('//logging/log[@type="%s"]', $this->forType()),
)->item(0);
if (!$logNode instanceof DOMElement) {
return null;
}
return $logNode;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveTestSuiteLoaderAttributes.php 0000644 00000001647 15243426620 0025163 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveTestSuiteLoaderAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('testSuiteLoaderClass')) {
$root->removeAttribute('testSuiteLoaderClass');
}
if ($root->hasAttribute('testSuiteLoaderFile')) {
$root->removeAttribute('testSuiteLoaderFile');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoverageCloverToReport.php 0000644 00000001467 15243426620 0023263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageCloverToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-clover';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$clover = $logNode->ownerDocument->createElement('clover');
$clover->setAttribute('outputFile', $logNode->getAttribute('target'));
return $clover;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveLoggingElements.php 0000644 00000002412 15243426620 0023106 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveLoggingElements implements Migration
{
public function migrate(DOMDocument $document): void
{
$this->removeTestDoxElement($document);
$this->removeTextElement($document);
}
private function removeTestDoxElement(DOMDocument $document): void
{
$node = (new DOMXPath($document))->query('logging/testdoxXml')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
private function removeTextElement(DOMDocument $document): void
{
$node = (new DOMXPath($document))->query('logging/text')->item(0);
if (!$node instanceof DOMElement || $node->parentNode === null) {
return;
}
$node->parentNode->removeChild($node);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/MoveCoverageDirectoriesToSource.php 0000644 00000003036 15243426620 0025113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
use DOMXPath;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MoveCoverageDirectoriesToSource implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$source = $document->getElementsByTagName('source')->item(0);
if ($source !== null) {
return;
}
$coverage = $document->getElementsByTagName('coverage')->item(0);
if ($coverage === null) {
return;
}
$root = $document->documentElement;
assert($root instanceof DOMElement);
$source = $document->createElement('source');
$root->appendChild($source);
$xpath = new DOMXPath($document);
foreach (['include', 'exclude'] as $element) {
foreach (SnapshotNodeList::fromNodeList($xpath->query('//coverage/' . $element)) as $node) {
$source->appendChild($node);
}
}
if ($coverage->childElementCount !== 0) {
return;
}
assert($coverage->parentNode !== null);
$coverage->parentNode->removeChild($coverage);
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemoveEmptyFilter.php 0000644 00000003032 15243426620 0022266 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemoveEmptyFilter implements Migration
{
/**
* @throws MigrationException
*/
public function migrate(DOMDocument $document): void
{
$whitelist = $document->getElementsByTagName('whitelist')->item(0);
if ($whitelist instanceof DOMElement) {
$this->ensureEmpty($whitelist);
$whitelist->parentNode->removeChild($whitelist);
}
$filter = $document->getElementsByTagName('filter')->item(0);
if ($filter instanceof DOMElement) {
$this->ensureEmpty($filter);
$filter->parentNode->removeChild($filter);
}
}
/**
* @throws MigrationException
*/
private function ensureEmpty(DOMElement $element): void
{
if ($element->attributes->length > 0) {
throw new MigrationException(sprintf('%s element has unexpected attributes', $element->nodeName));
}
if ($element->getElementsByTagName('*')->length > 0) {
throw new MigrationException(sprintf('%s element has unexpected children', $element->nodeName));
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/RemovePrinterAttributes.php 0000644 00000001577 15243426620 0023530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function assert;
use DOMDocument;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RemovePrinterAttributes implements Migration
{
public function migrate(DOMDocument $document): void
{
$root = $document->documentElement;
assert($root instanceof DOMElement);
if ($root->hasAttribute('printerClass')) {
$root->removeAttribute('printerClass');
}
if ($root->hasAttribute('printerFile')) {
$root->removeAttribute('printerFile');
}
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoverageTextToReport.php 0000644 00000001611 15243426620 0022744 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageTextToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-text';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$text = $logNode->ownerDocument->createElement('text');
$text->setAttribute('outputFile', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $text, ['showUncoveredFiles', 'showOnlySummary']);
return $text;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoverageXmlToReport.php 0000644 00000001451 15243426620 0022562 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageXmlToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-xml';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$xml = $logNode->ownerDocument->createElement('xml');
$xml->setAttribute('outputDirectory', $logNode->getAttribute('target'));
return $xml;
}
}
src/TextUI/Configuration/Xml/Migration/Migrations/CoverageHtmlToReport.php 0000644 00000001610 15243426620 0022723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use DOMElement;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CoverageHtmlToReport extends LogToReportMigration
{
protected function forType(): string
{
return 'coverage-html';
}
protected function toReportFormat(DOMElement $logNode): DOMElement
{
$html = $logNode->ownerDocument->createElement('html');
$html->setAttribute('outputDirectory', $logNode->getAttribute('target'));
$this->migrateAttributes($logNode, $html, ['lowUpperBound', 'highLowerBound']);
return $html;
}
}
src/TextUI/Configuration/Xml/Migration/MigrationBuilderException.php 0000644 00000001020 15243426620 0021642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MigrationBuilderException extends RuntimeException implements Exception
{
}
src/TextUI/Configuration/Xml/Migration/Migrator.php 0000644 00000002670 15243426620 0016323 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Runner\Version;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Migrator
{
/**
* @throws Exception
* @throws MigrationBuilderException
* @throws MigrationException
* @throws XmlException
*/
public function migrate(string $filename): string
{
$origin = (new SchemaDetector)->detect($filename);
if (!$origin->detected()) {
throw new Exception('The file does not validate against any know schema');
}
if ($origin->version() === Version::series()) {
throw new Exception('The file does not need to be migrated');
}
$configurationDocument = (new XmlLoader)->loadFile($filename);
foreach ((new MigrationBuilder)->build($origin->version()) as $migration) {
$migration->migrate($configurationDocument);
}
$configurationDocument->formatOutput = true;
$configurationDocument->preserveWhiteSpace = false;
return $configurationDocument->saveXML();
}
}
src/TextUI/Configuration/Xml/Migration/SnapshotNodeList.php 0000644 00000002146 15243426620 0017776 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function count;
use ArrayIterator;
use Countable;
use DOMNode;
use DOMNodeList;
use IteratorAggregate;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @template-implements IteratorAggregate<int, DOMNode>
*/
final class SnapshotNodeList implements Countable, IteratorAggregate
{
/**
* @psalm-var list<DOMNode>
*/
private array $nodes = [];
public static function fromNodeList(DOMNodeList $list): self
{
$snapshot = new self;
foreach ($list as $node) {
$snapshot->nodes[] = $node;
}
return $snapshot;
}
public function count(): int
{
return count($this->nodes);
}
public function getIterator(): ArrayIterator
{
return new ArrayIterator($this->nodes);
}
}
src/TextUI/Configuration/Xml/SchemaDetector/SchemaDetector.php 0000644 00000002055 15243426620 0020367 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Util\Xml\Loader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SchemaDetector
{
/**
* @throws XmlException
*/
public function detect(string $filename): SchemaDetectionResult
{
$document = (new Loader)->loadFile($filename);
$schemaFinder = new SchemaFinder;
foreach ($schemaFinder->available() as $candidate) {
$schema = (new SchemaFinder)->find($candidate);
if (!(new Validator)->validate($document, $schema)->hasValidationErrors()) {
return new SuccessfulSchemaDetectionResult($candidate);
}
}
return new FailedSchemaDetectionResult;
}
}
src/TextUI/Configuration/Xml/SchemaDetector/FailedSchemaDetectionResult.php 0000644 00000000753 15243426620 0023043 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class FailedSchemaDetectionResult extends SchemaDetectionResult
{
}
src/TextUI/Configuration/Xml/SchemaDetector/SchemaDetectionResult.php 0000644 00000001453 15243426620 0021734 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class SchemaDetectionResult
{
/**
* @psalm-assert-if-true SuccessfulSchemaDetectionResult $this
*/
public function detected(): bool
{
return false;
}
/**
* @throws XmlException
*/
public function version(): string
{
throw new XmlException('No supported schema was detected');
}
}
src/TextUI/Configuration/Xml/SchemaDetector/SuccessfulSchemaDetectionResult.php 0000644 00000002011 15243426620 0023763 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class SuccessfulSchemaDetectionResult extends SchemaDetectionResult
{
/**
* @psalm-var non-empty-string
*/
private readonly string $version;
/**
* @psalm-param non-empty-string $version
*/
public function __construct(string $version)
{
$this->version = $version;
}
/**
* @psalm-assert-if-true SuccessfulSchemaDetectionResult $this
*/
public function detected(): bool
{
return true;
}
/**
* @psalm-return non-empty-string
*/
public function version(): string
{
return $this->version;
}
}
src/TextUI/Configuration/Xml/Loader.php 0000644 00000112405 15243426620 0014012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use const DIRECTORY_SEPARATOR;
use const PHP_VERSION;
use function assert;
use function defined;
use function dirname;
use function explode;
use function is_numeric;
use function preg_match;
use function realpath;
use function str_contains;
use function str_starts_with;
use function strlen;
use function strtolower;
use function substr;
use function trim;
use DOMDocument;
use DOMElement;
use DOMNode;
use DOMXPath;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\Runner\Version;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\Constant;
use PHPUnit\TextUI\Configuration\ConstantCollection;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\DirectoryCollection;
use PHPUnit\TextUI\Configuration\ExtensionBootstrap;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\File;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectory;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection;
use PHPUnit\TextUI\Configuration\Group;
use PHPUnit\TextUI\Configuration\GroupCollection;
use PHPUnit\TextUI\Configuration\IniSetting;
use PHPUnit\TextUI\Configuration\IniSettingCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestDirectory;
use PHPUnit\TextUI\Configuration\TestDirectoryCollection;
use PHPUnit\TextUI\Configuration\TestFile;
use PHPUnit\TextUI\Configuration\TestFileCollection;
use PHPUnit\TextUI\Configuration\TestSuite as TestSuiteConfiguration;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\Configuration\Variable;
use PHPUnit\TextUI\Configuration\VariableCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Clover;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Cobertura;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Crap4j;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Html as CodeCoverageHtml;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Php as CodeCoveragePhp;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Text as CodeCoverageText;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Xml as CodeCoverageXml;
use PHPUnit\TextUI\XmlConfiguration\Logging\Junit;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
use PHPUnit\TextUI\XmlConfiguration\Logging\TeamCity;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Html as TestDoxHtml;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Text as TestDoxText;
use PHPUnit\Util\VersionComparisonOperator;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Loader
{
/**
* @throws Exception
*/
public function load(string $filename): LoadedFromFileConfiguration
{
try {
$document = (new XmlLoader)->loadFile($filename);
} catch (XmlException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$xpath = new DOMXPath($document);
try {
$xsdFilename = (new SchemaFinder)->find(Version::series());
} catch (CannotFindSchemaException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
$configurationFileRealpath = realpath($filename);
return new LoadedFromFileConfiguration(
$configurationFileRealpath,
(new Validator)->validate($document, $xsdFilename),
$this->extensions($xpath),
$this->source($configurationFileRealpath, $xpath),
$this->codeCoverage($configurationFileRealpath, $xpath),
$this->groups($xpath),
$this->logging($configurationFileRealpath, $xpath),
$this->php($configurationFileRealpath, $xpath),
$this->phpunit($configurationFileRealpath, $document),
$this->testSuite($configurationFileRealpath, $xpath),
);
}
private function logging(string $filename, DOMXPath $xpath): Logging
{
$junit = null;
$element = $this->element($xpath, 'logging/junit');
if ($element) {
$junit = new Junit(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$teamCity = null;
$element = $this->element($xpath, 'logging/teamcity');
if ($element) {
$teamCity = new TeamCity(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$testDoxHtml = null;
$element = $this->element($xpath, 'logging/testdoxHtml');
if ($element) {
$testDoxHtml = new TestDoxHtml(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$testDoxText = null;
$element = $this->element($xpath, 'logging/testdoxText');
if ($element) {
$testDoxText = new TestDoxText(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
return new Logging(
$junit,
$teamCity,
$testDoxHtml,
$testDoxText,
);
}
private function extensions(DOMXPath $xpath): ExtensionBootstrapCollection
{
$extensionBootstrappers = [];
foreach ($xpath->query('extensions/bootstrap') as $bootstrap) {
assert($bootstrap instanceof DOMElement);
$parameters = [];
foreach ($xpath->query('parameter', $bootstrap) as $parameter) {
assert($parameter instanceof DOMElement);
$parameters[$parameter->getAttribute('name')] = $parameter->getAttribute('value');
}
$extensionBootstrappers[] = new ExtensionBootstrap(
$bootstrap->getAttribute('class'),
$parameters,
);
}
return ExtensionBootstrapCollection::fromArray($extensionBootstrappers);
}
/**
* @psalm-return non-empty-string
*/
private function toAbsolutePath(string $filename, string $path): string
{
$path = trim($path);
if (str_starts_with($path, '/')) {
return $path;
}
// Matches the following on Windows:
// - \\NetworkComputer\Path
// - \\.\D:
// - \\.\c:
// - C:\Windows
// - C:\windows
// - C:/windows
// - c:/windows
if (defined('PHP_WINDOWS_VERSION_BUILD') &&
!empty($path) &&
($path[0] === '\\' || (strlen($path) >= 3 && preg_match('#^[A-Z]:[/\\\]#i', substr($path, 0, 3))))) {
return $path;
}
if (str_contains($path, '://')) {
return $path;
}
return dirname($filename) . DIRECTORY_SEPARATOR . $path;
}
private function source(string $filename, DOMXPath $xpath): Source
{
$baseline = null;
$restrictDeprecations = false;
$restrictNotices = false;
$restrictWarnings = false;
$ignoreSuppressionOfDeprecations = false;
$ignoreSuppressionOfPhpDeprecations = false;
$ignoreSuppressionOfErrors = false;
$ignoreSuppressionOfNotices = false;
$ignoreSuppressionOfPhpNotices = false;
$ignoreSuppressionOfWarnings = false;
$ignoreSuppressionOfPhpWarnings = false;
$element = $this->element($xpath, 'source');
if ($element) {
$baseline = $this->getStringAttribute($element, 'baseline');
if ($baseline !== null) {
$baseline = $this->toAbsolutePath($filename, $baseline);
}
$restrictDeprecations = $this->getBooleanAttribute($element, 'restrictDeprecations', false);
$restrictNotices = $this->getBooleanAttribute($element, 'restrictNotices', false);
$restrictWarnings = $this->getBooleanAttribute($element, 'restrictWarnings', false);
$ignoreSuppressionOfDeprecations = $this->getBooleanAttribute($element, 'ignoreSuppressionOfDeprecations', false);
$ignoreSuppressionOfPhpDeprecations = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpDeprecations', false);
$ignoreSuppressionOfErrors = $this->getBooleanAttribute($element, 'ignoreSuppressionOfErrors', false);
$ignoreSuppressionOfNotices = $this->getBooleanAttribute($element, 'ignoreSuppressionOfNotices', false);
$ignoreSuppressionOfPhpNotices = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpNotices', false);
$ignoreSuppressionOfWarnings = $this->getBooleanAttribute($element, 'ignoreSuppressionOfWarnings', false);
$ignoreSuppressionOfPhpWarnings = $this->getBooleanAttribute($element, 'ignoreSuppressionOfPhpWarnings', false);
}
return new Source(
$baseline,
false,
$this->readFilterDirectories($filename, $xpath, 'source/include/directory'),
$this->readFilterFiles($filename, $xpath, 'source/include/file'),
$this->readFilterDirectories($filename, $xpath, 'source/exclude/directory'),
$this->readFilterFiles($filename, $xpath, 'source/exclude/file'),
$restrictDeprecations,
$restrictNotices,
$restrictWarnings,
$ignoreSuppressionOfDeprecations,
$ignoreSuppressionOfPhpDeprecations,
$ignoreSuppressionOfErrors,
$ignoreSuppressionOfNotices,
$ignoreSuppressionOfPhpNotices,
$ignoreSuppressionOfWarnings,
$ignoreSuppressionOfPhpWarnings,
);
}
private function codeCoverage(string $filename, DOMXPath $xpath): CodeCoverage
{
$cacheDirectory = null;
$pathCoverage = false;
$includeUncoveredFiles = true;
$ignoreDeprecatedCodeUnits = false;
$disableCodeCoverageIgnore = false;
$element = $this->element($xpath, 'coverage');
if ($element) {
$cacheDirectory = $this->getStringAttribute($element, 'cacheDirectory');
if ($cacheDirectory !== null) {
$cacheDirectory = new Directory(
$this->toAbsolutePath($filename, $cacheDirectory),
);
}
$pathCoverage = $this->getBooleanAttribute(
$element,
'pathCoverage',
false,
);
$includeUncoveredFiles = $this->getBooleanAttribute(
$element,
'includeUncoveredFiles',
true,
);
$ignoreDeprecatedCodeUnits = $this->getBooleanAttribute(
$element,
'ignoreDeprecatedCodeUnits',
false,
);
$disableCodeCoverageIgnore = $this->getBooleanAttribute(
$element,
'disableCodeCoverageIgnore',
false,
);
}
$clover = null;
$element = $this->element($xpath, 'coverage/report/clover');
if ($element) {
$clover = new Clover(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$cobertura = null;
$element = $this->element($xpath, 'coverage/report/cobertura');
if ($element) {
$cobertura = new Cobertura(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$crap4j = null;
$element = $this->element($xpath, 'coverage/report/crap4j');
if ($element) {
$crap4j = new Crap4j(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
$this->getIntegerAttribute($element, 'threshold', 30),
);
}
$html = null;
$element = $this->element($xpath, 'coverage/report/html');
if ($element) {
$defaultColors = Colors::default();
$defaultThresholds = Thresholds::default();
$html = new CodeCoverageHtml(
new Directory(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputDirectory'),
),
),
$this->getIntegerAttribute($element, 'lowUpperBound', $defaultThresholds->lowUpperBound()),
$this->getIntegerAttribute($element, 'highLowerBound', $defaultThresholds->highLowerBound()),
$this->getStringAttributeWithDefault($element, 'colorSuccessLow', $defaultColors->successLow()),
$this->getStringAttributeWithDefault($element, 'colorSuccessMedium', $defaultColors->successMedium()),
$this->getStringAttributeWithDefault($element, 'colorSuccessHigh', $defaultColors->successHigh()),
$this->getStringAttributeWithDefault($element, 'colorWarning', $defaultColors->warning()),
$this->getStringAttributeWithDefault($element, 'colorDanger', $defaultColors->danger()),
$this->getStringAttribute($element, 'customCssFile'),
);
}
$php = null;
$element = $this->element($xpath, 'coverage/report/php');
if ($element) {
$php = new CodeCoveragePhp(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
);
}
$text = null;
$element = $this->element($xpath, 'coverage/report/text');
if ($element) {
$text = new CodeCoverageText(
new File(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputFile'),
),
),
$this->getBooleanAttribute($element, 'showUncoveredFiles', false),
$this->getBooleanAttribute($element, 'showOnlySummary', false),
);
}
$xml = null;
$element = $this->element($xpath, 'coverage/report/xml');
if ($element) {
$xml = new CodeCoverageXml(
new Directory(
$this->toAbsolutePath(
$filename,
(string) $this->getStringAttribute($element, 'outputDirectory'),
),
),
);
}
return new CodeCoverage(
$cacheDirectory,
$this->readFilterDirectories($filename, $xpath, 'coverage/include/directory'),
$this->readFilterFiles($filename, $xpath, 'coverage/include/file'),
$this->readFilterDirectories($filename, $xpath, 'coverage/exclude/directory'),
$this->readFilterFiles($filename, $xpath, 'coverage/exclude/file'),
$pathCoverage,
$includeUncoveredFiles,
$ignoreDeprecatedCodeUnits,
$disableCodeCoverageIgnore,
$clover,
$cobertura,
$crap4j,
$html,
$php,
$text,
$xml,
);
}
private function getBoolean(string $value, bool $default): bool
{
if (strtolower($value) === 'false') {
return false;
}
if (strtolower($value) === 'true') {
return true;
}
return $default;
}
private function getValue(string $value): bool|string
{
if (strtolower($value) === 'false') {
return false;
}
if (strtolower($value) === 'true') {
return true;
}
return $value;
}
private function readFilterDirectories(string $filename, DOMXPath $xpath, string $query): FilterDirectoryCollection
{
$directories = [];
foreach ($xpath->query($query) as $directoryNode) {
assert($directoryNode instanceof DOMElement);
$directoryPath = $directoryNode->textContent;
if (!$directoryPath) {
continue;
}
$directories[] = new FilterDirectory(
$this->toAbsolutePath($filename, $directoryPath),
$directoryNode->hasAttribute('prefix') ? $directoryNode->getAttribute('prefix') : '',
$directoryNode->hasAttribute('suffix') ? $directoryNode->getAttribute('suffix') : '.php',
);
}
return FilterDirectoryCollection::fromArray($directories);
}
private function readFilterFiles(string $filename, DOMXPath $xpath, string $query): FileCollection
{
$files = [];
foreach ($xpath->query($query) as $file) {
assert($file instanceof DOMNode);
$filePath = $file->textContent;
if ($filePath) {
$files[] = new File($this->toAbsolutePath($filename, $filePath));
}
}
return FileCollection::fromArray($files);
}
private function groups(DOMXPath $xpath): Groups
{
$include = [];
$exclude = [];
foreach ($xpath->query('groups/include/group') as $group) {
assert($group instanceof DOMNode);
$include[] = new Group($group->textContent);
}
foreach ($xpath->query('groups/exclude/group') as $group) {
assert($group instanceof DOMNode);
$exclude[] = new Group($group->textContent);
}
return new Groups(
GroupCollection::fromArray($include),
GroupCollection::fromArray($exclude),
);
}
private function getBooleanAttribute(DOMElement $element, string $attribute, bool $default): bool
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $this->getBoolean(
$element->getAttribute($attribute),
false,
);
}
private function getIntegerAttribute(DOMElement $element, string $attribute, int $default): int
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $this->getInteger(
$element->getAttribute($attribute),
$default,
);
}
private function getStringAttribute(DOMElement $element, string $attribute): ?string
{
if (!$element->hasAttribute($attribute)) {
return null;
}
return $element->getAttribute($attribute);
}
private function getStringAttributeWithDefault(DOMElement $element, string $attribute, string $default): string
{
if (!$element->hasAttribute($attribute)) {
return $default;
}
return $element->getAttribute($attribute);
}
private function getInteger(string $value, int $default): int
{
if (is_numeric($value)) {
return (int) $value;
}
return $default;
}
private function php(string $filename, DOMXPath $xpath): Php
{
$includePaths = [];
foreach ($xpath->query('php/includePath') as $includePath) {
assert($includePath instanceof DOMNode);
$path = $includePath->textContent;
if ($path) {
$includePaths[] = new Directory($this->toAbsolutePath($filename, $path));
}
}
$iniSettings = [];
foreach ($xpath->query('php/ini') as $ini) {
assert($ini instanceof DOMElement);
$iniSettings[] = new IniSetting(
$ini->getAttribute('name'),
$ini->getAttribute('value'),
);
}
$constants = [];
foreach ($xpath->query('php/const') as $const) {
assert($const instanceof DOMElement);
$value = $const->getAttribute('value');
$constants[] = new Constant(
$const->getAttribute('name'),
$this->getValue($value),
);
}
$variables = [
'var' => [],
'env' => [],
'post' => [],
'get' => [],
'cookie' => [],
'server' => [],
'files' => [],
'request' => [],
];
foreach (['var', 'env', 'post', 'get', 'cookie', 'server', 'files', 'request'] as $array) {
foreach ($xpath->query('php/' . $array) as $var) {
assert($var instanceof DOMElement);
$name = $var->getAttribute('name');
$value = $var->getAttribute('value');
$force = false;
$verbatim = false;
if ($var->hasAttribute('force')) {
$force = $this->getBoolean($var->getAttribute('force'), false);
}
if ($var->hasAttribute('verbatim')) {
$verbatim = $this->getBoolean($var->getAttribute('verbatim'), false);
}
if (!$verbatim) {
$value = $this->getValue($value);
}
$variables[$array][] = new Variable($name, $value, $force);
}
}
return new Php(
DirectoryCollection::fromArray($includePaths),
IniSettingCollection::fromArray($iniSettings),
ConstantCollection::fromArray($constants),
VariableCollection::fromArray($variables['var']),
VariableCollection::fromArray($variables['env']),
VariableCollection::fromArray($variables['post']),
VariableCollection::fromArray($variables['get']),
VariableCollection::fromArray($variables['cookie']),
VariableCollection::fromArray($variables['server']),
VariableCollection::fromArray($variables['files']),
VariableCollection::fromArray($variables['request']),
);
}
private function phpunit(string $filename, DOMDocument $document): PHPUnit
{
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$defectsFirst = false;
$resolveDependencies = $this->getBooleanAttribute($document->documentElement, 'resolveDependencies', true);
if ($document->documentElement->hasAttribute('executionOrder')) {
foreach (explode(',', $document->documentElement->getAttribute('executionOrder')) as $order) {
switch ($order) {
case 'default':
$executionOrder = TestSuiteSorter::ORDER_DEFAULT;
$defectsFirst = false;
$resolveDependencies = true;
break;
case 'depends':
$resolveDependencies = true;
break;
case 'no-depends':
$resolveDependencies = false;
break;
case 'defects':
$defectsFirst = true;
break;
case 'duration':
$executionOrder = TestSuiteSorter::ORDER_DURATION;
break;
case 'random':
$executionOrder = TestSuiteSorter::ORDER_RANDOMIZED;
break;
case 'reverse':
$executionOrder = TestSuiteSorter::ORDER_REVERSED;
break;
case 'size':
$executionOrder = TestSuiteSorter::ORDER_SIZE;
break;
}
}
}
$cacheDirectory = $this->getStringAttribute($document->documentElement, 'cacheDirectory');
if ($cacheDirectory !== null) {
$cacheDirectory = $this->toAbsolutePath($filename, $cacheDirectory);
}
$cacheResultFile = $this->getStringAttribute($document->documentElement, 'cacheResultFile');
if ($cacheResultFile !== null) {
$cacheResultFile = $this->toAbsolutePath($filename, $cacheResultFile);
}
$bootstrap = $this->getStringAttribute($document->documentElement, 'bootstrap');
if ($bootstrap !== null) {
$bootstrap = $this->toAbsolutePath($filename, $bootstrap);
}
$extensionsDirectory = $this->getStringAttribute($document->documentElement, 'extensionsDirectory');
if ($extensionsDirectory !== null) {
$extensionsDirectory = $this->toAbsolutePath($filename, $extensionsDirectory);
}
$backupStaticProperties = false;
if ($document->documentElement->hasAttribute('backupStaticProperties')) {
$backupStaticProperties = $this->getBooleanAttribute($document->documentElement, 'backupStaticProperties', false);
} elseif ($document->documentElement->hasAttribute('backupStaticAttributes')) {
$backupStaticProperties = $this->getBooleanAttribute($document->documentElement, 'backupStaticAttributes', false);
}
$requireCoverageMetadata = false;
if ($document->documentElement->hasAttribute('requireCoverageMetadata')) {
$requireCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'requireCoverageMetadata', false);
} elseif ($document->documentElement->hasAttribute('forceCoversAnnotation')) {
$requireCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'forceCoversAnnotation', false);
}
$beStrictAboutCoverageMetadata = false;
if ($document->documentElement->hasAttribute('beStrictAboutCoverageMetadata')) {
$beStrictAboutCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'beStrictAboutCoverageMetadata', false);
} elseif ($document->documentElement->hasAttribute('forceCoversAnnotation')) {
$beStrictAboutCoverageMetadata = $this->getBooleanAttribute($document->documentElement, 'beStrictAboutCoversAnnotation', false);
}
return new PHPUnit(
$cacheDirectory,
$this->getBooleanAttribute($document->documentElement, 'cacheResult', true),
$cacheResultFile,
$this->getColumns($document),
$this->getColors($document),
$this->getBooleanAttribute($document->documentElement, 'stderr', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnIncompleteTests', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnSkippedTests', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerDeprecations', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerErrors', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerNotices', false),
$this->getBooleanAttribute($document->documentElement, 'displayDetailsOnTestsThatTriggerWarnings', false),
$this->getBooleanAttribute($document->documentElement, 'reverseDefectList', false),
$requireCoverageMetadata,
$bootstrap,
$this->getBooleanAttribute($document->documentElement, 'processIsolation', false),
$this->getBooleanAttribute($document->documentElement, 'failOnDeprecation', false),
$this->getBooleanAttribute($document->documentElement, 'failOnEmptyTestSuite', false),
$this->getBooleanAttribute($document->documentElement, 'failOnIncomplete', false),
$this->getBooleanAttribute($document->documentElement, 'failOnNotice', false),
$this->getBooleanAttribute($document->documentElement, 'failOnRisky', false),
$this->getBooleanAttribute($document->documentElement, 'failOnSkipped', false),
$this->getBooleanAttribute($document->documentElement, 'failOnWarning', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnDefect', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnDeprecation', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnError', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnFailure', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnIncomplete', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnNotice', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnRisky', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnSkipped', false),
$this->getBooleanAttribute($document->documentElement, 'stopOnWarning', false),
$extensionsDirectory,
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutChangesToGlobalState', false),
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutOutputDuringTests', false),
$this->getBooleanAttribute($document->documentElement, 'beStrictAboutTestsThatDoNotTestAnything', true),
$beStrictAboutCoverageMetadata,
$this->getBooleanAttribute($document->documentElement, 'enforceTimeLimit', false),
$this->getIntegerAttribute($document->documentElement, 'defaultTimeLimit', 1),
$this->getIntegerAttribute($document->documentElement, 'timeoutForSmallTests', 1),
$this->getIntegerAttribute($document->documentElement, 'timeoutForMediumTests', 10),
$this->getIntegerAttribute($document->documentElement, 'timeoutForLargeTests', 60),
$this->getStringAttribute($document->documentElement, 'defaultTestSuite'),
$executionOrder,
$resolveDependencies,
$defectsFirst,
$this->getBooleanAttribute($document->documentElement, 'backupGlobals', false),
$backupStaticProperties,
$this->getBooleanAttribute($document->documentElement, 'registerMockObjectsFromTestArgumentsRecursively', false),
$this->getBooleanAttribute($document->documentElement, 'testdox', false),
$this->getBooleanAttribute($document->documentElement, 'controlGarbageCollector', false),
$this->getIntegerAttribute($document->documentElement, 'numberOfTestsBeforeGarbageCollection', 100),
);
}
private function getColors(DOMDocument $document): string
{
$colors = Configuration::COLOR_DEFAULT;
if ($document->documentElement->hasAttribute('colors')) {
/* only allow boolean for compatibility with previous versions
'always' only allowed from command line */
if ($this->getBoolean($document->documentElement->getAttribute('colors'), false)) {
$colors = Configuration::COLOR_AUTO;
} else {
$colors = Configuration::COLOR_NEVER;
}
}
return $colors;
}
private function getColumns(DOMDocument $document): int|string
{
$columns = 80;
if ($document->documentElement->hasAttribute('columns')) {
$columns = $document->documentElement->getAttribute('columns');
if ($columns !== 'max') {
$columns = $this->getInteger($columns, 80);
}
}
return $columns;
}
private function testSuite(string $filename, DOMXPath $xpath): TestSuiteCollection
{
$testSuites = [];
foreach ($this->getTestSuiteElements($xpath) as $element) {
$exclude = [];
foreach ($element->getElementsByTagName('exclude') as $excludeNode) {
$excludeFile = $excludeNode->textContent;
if ($excludeFile) {
$exclude[] = new File($this->toAbsolutePath($filename, $excludeFile));
}
}
$directories = [];
foreach ($element->getElementsByTagName('directory') as $directoryNode) {
assert($directoryNode instanceof DOMElement);
$directory = $directoryNode->textContent;
if (empty($directory)) {
continue;
}
$prefix = '';
if ($directoryNode->hasAttribute('prefix')) {
$prefix = $directoryNode->getAttribute('prefix');
}
$suffix = 'Test.php';
if ($directoryNode->hasAttribute('suffix')) {
$suffix = $directoryNode->getAttribute('suffix');
}
$phpVersion = PHP_VERSION;
if ($directoryNode->hasAttribute('phpVersion')) {
$phpVersion = $directoryNode->getAttribute('phpVersion');
}
$phpVersionOperator = new VersionComparisonOperator('>=');
if ($directoryNode->hasAttribute('phpVersionOperator')) {
$phpVersionOperator = new VersionComparisonOperator($directoryNode->getAttribute('phpVersionOperator'));
}
$directories[] = new TestDirectory(
$this->toAbsolutePath($filename, $directory),
$prefix,
$suffix,
$phpVersion,
$phpVersionOperator,
);
}
$files = [];
foreach ($element->getElementsByTagName('file') as $fileNode) {
assert($fileNode instanceof DOMElement);
$file = $fileNode->textContent;
if (empty($file)) {
continue;
}
$phpVersion = PHP_VERSION;
if ($fileNode->hasAttribute('phpVersion')) {
$phpVersion = $fileNode->getAttribute('phpVersion');
}
$phpVersionOperator = new VersionComparisonOperator('>=');
if ($fileNode->hasAttribute('phpVersionOperator')) {
$phpVersionOperator = new VersionComparisonOperator($fileNode->getAttribute('phpVersionOperator'));
}
$files[] = new TestFile(
$this->toAbsolutePath($filename, $file),
$phpVersion,
$phpVersionOperator,
);
}
$name = $element->getAttribute('name');
assert(!empty($name));
$testSuites[] = new TestSuiteConfiguration(
$name,
TestDirectoryCollection::fromArray($directories),
TestFileCollection::fromArray($files),
FileCollection::fromArray($exclude),
);
}
return TestSuiteCollection::fromArray($testSuites);
}
/**
* @psalm-return list<DOMElement>
*/
private function getTestSuiteElements(DOMXPath $xpath): array
{
$elements = [];
$testSuiteNodes = $xpath->query('testsuites/testsuite');
if ($testSuiteNodes->length === 0) {
$testSuiteNodes = $xpath->query('testsuite');
}
if ($testSuiteNodes->length === 1) {
$element = $testSuiteNodes->item(0);
assert($element instanceof DOMElement);
$elements[] = $element;
} else {
foreach ($testSuiteNodes as $testSuiteNode) {
assert($testSuiteNode instanceof DOMElement);
$elements[] = $testSuiteNode;
}
}
return $elements;
}
private function element(DOMXPath $xpath, string $element): ?DOMElement
{
$nodes = $xpath->query($element);
if ($nodes->length === 1) {
$node = $nodes->item(0);
assert($node instanceof DOMElement);
return $node;
}
return null;
}
}
src/TextUI/Configuration/Xml/Generator.php 0000644 00000004003 15243426620 0014524 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function str_replace;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
/**
* @var string
*/
private const TEMPLATE = <<<'EOT'
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/{phpunit_version}/phpunit.xsd"
bootstrap="{bootstrap_script}"
cacheDirectory="{cache_directory}"
executionOrder="depends,defects"
requireCoverageMetadata="true"
beStrictAboutCoverageMetadata="true"
beStrictAboutOutputDuringTests="true"
failOnRisky="true"
failOnWarning="true">
<testsuites>
<testsuite name="default">
<directory>{tests_directory}</directory>
</testsuite>
</testsuites>
<source restrictDeprecations="true" restrictNotices="true" restrictWarnings="true">
<include>
<directory>{src_directory}</directory>
</include>
</source>
</phpunit>
EOT;
public function generateDefaultConfiguration(string $phpunitVersion, string $bootstrapScript, string $testsDirectory, string $srcDirectory, string $cacheDirectory): string
{
return str_replace(
[
'{phpunit_version}',
'{bootstrap_script}',
'{tests_directory}',
'{src_directory}',
'{cache_directory}',
],
[
$phpunitVersion,
$bootstrapScript,
$testsDirectory,
$srcDirectory,
$cacheDirectory,
],
self::TEMPLATE,
);
}
}
src/TextUI/Configuration/Xml/DefaultConfiguration.php 0000644 00000011217 15243426620 0016717 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\Runner\TestSuiteSorter;
use PHPUnit\TextUI\Configuration\ConstantCollection;
use PHPUnit\TextUI\Configuration\DirectoryCollection;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection as CodeCoverageFilterDirectoryCollection;
use PHPUnit\TextUI\Configuration\GroupCollection;
use PHPUnit\TextUI\Configuration\IniSettingCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\Configuration\VariableCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class DefaultConfiguration extends Configuration
{
public static function create(): self
{
return new self(
ExtensionBootstrapCollection::fromArray([]),
new Source(
null,
false,
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
),
new CodeCoverage(
null,
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
CodeCoverageFilterDirectoryCollection::fromArray([]),
FileCollection::fromArray([]),
false,
true,
false,
false,
null,
null,
null,
null,
null,
null,
null,
),
new Groups(
GroupCollection::fromArray([]),
GroupCollection::fromArray([]),
),
new Logging(
null,
null,
null,
null,
),
new Php(
DirectoryCollection::fromArray([]),
IniSettingCollection::fromArray([]),
ConstantCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
VariableCollection::fromArray([]),
),
new PHPUnit(
null,
true,
null,
80,
\PHPUnit\TextUI\Configuration\Configuration::COLOR_DEFAULT,
false,
false,
false,
false,
false,
false,
false,
false,
false,
null,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
null,
false,
false,
true,
false,
false,
1,
1,
10,
60,
null,
TestSuiteSorter::ORDER_DEFAULT,
true,
false,
false,
false,
false,
false,
false,
100,
),
TestSuiteCollection::fromArray([]),
);
}
public function isDefault(): bool
{
return true;
}
}
src/TextUI/Configuration/Xml/Configuration.php 0000644 00000005155 15243426620 0015416 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class Configuration
{
private readonly ExtensionBootstrapCollection $extensions;
private readonly Source $source;
private readonly CodeCoverage $codeCoverage;
private readonly Groups $groups;
private readonly Logging $logging;
private readonly Php $php;
private readonly PHPUnit $phpunit;
private readonly TestSuiteCollection $testSuite;
public function __construct(ExtensionBootstrapCollection $extensions, Source $source, CodeCoverage $codeCoverage, Groups $groups, Logging $logging, Php $php, PHPUnit $phpunit, TestSuiteCollection $testSuite)
{
$this->extensions = $extensions;
$this->source = $source;
$this->codeCoverage = $codeCoverage;
$this->groups = $groups;
$this->logging = $logging;
$this->php = $php;
$this->phpunit = $phpunit;
$this->testSuite = $testSuite;
}
public function extensions(): ExtensionBootstrapCollection
{
return $this->extensions;
}
public function source(): Source
{
return $this->source;
}
public function codeCoverage(): CodeCoverage
{
return $this->codeCoverage;
}
public function groups(): Groups
{
return $this->groups;
}
public function logging(): Logging
{
return $this->logging;
}
public function php(): Php
{
return $this->php;
}
public function phpunit(): PHPUnit
{
return $this->phpunit;
}
public function testSuite(): TestSuiteCollection
{
return $this->testSuite;
}
/**
* @psalm-assert-if-true DefaultConfiguration $this
*/
public function isDefault(): bool
{
return false;
}
/**
* @psalm-assert-if-true LoadedFromFileConfiguration $this
*/
public function wasLoadedFromFile(): bool
{
return false;
}
}
src/TextUI/Configuration/Xml/Groups.php 0000644 00000002144 15243426620 0014061 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\GroupCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Groups
{
private readonly GroupCollection $include;
private readonly GroupCollection $exclude;
public function __construct(GroupCollection $include, GroupCollection $exclude)
{
$this->include = $include;
$this->exclude = $exclude;
}
public function hasInclude(): bool
{
return !$this->include->isEmpty();
}
public function include(): GroupCollection
{
return $this->include;
}
public function hasExclude(): bool
{
return !$this->exclude->isEmpty();
}
public function exclude(): GroupCollection
{
return $this->exclude;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Html.php 0000644 00000005447 15243426620 0017320 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\NoCustomCssFileException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Html
{
private readonly Directory $target;
private readonly int $lowUpperBound;
private readonly int $highLowerBound;
private readonly string $colorSuccessLow;
private readonly string $colorSuccessMedium;
private readonly string $colorSuccessHigh;
private readonly string $colorWarning;
private readonly string $colorDanger;
private readonly ?string $customCssFile;
public function __construct(Directory $target, int $lowUpperBound, int $highLowerBound, string $colorSuccessLow, string $colorSuccessMedium, string $colorSuccessHigh, string $colorWarning, string $colorDanger, ?string $customCssFile)
{
$this->target = $target;
$this->lowUpperBound = $lowUpperBound;
$this->highLowerBound = $highLowerBound;
$this->colorSuccessLow = $colorSuccessLow;
$this->colorSuccessMedium = $colorSuccessMedium;
$this->colorSuccessHigh = $colorSuccessHigh;
$this->colorWarning = $colorWarning;
$this->colorDanger = $colorDanger;
$this->customCssFile = $customCssFile;
}
public function target(): Directory
{
return $this->target;
}
public function lowUpperBound(): int
{
return $this->lowUpperBound;
}
public function highLowerBound(): int
{
return $this->highLowerBound;
}
public function colorSuccessLow(): string
{
return $this->colorSuccessLow;
}
public function colorSuccessMedium(): string
{
return $this->colorSuccessMedium;
}
public function colorSuccessHigh(): string
{
return $this->colorSuccessHigh;
}
public function colorWarning(): string
{
return $this->colorWarning;
}
public function colorDanger(): string
{
return $this->colorDanger;
}
/**
* @psalm-assert-if-true !null $this->customCssFile
*/
public function hasCustomCssFile(): bool
{
return $this->customCssFile !== null;
}
/**
* @throws NoCustomCssFileException
*/
public function customCssFile(): string
{
if (!$this->hasCustomCssFile()) {
throw new NoCustomCssFileException;
}
return $this->customCssFile;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Crap4j.php 0000644 00000001563 15243426620 0017532 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Crap4j
{
private readonly File $target;
private readonly int $threshold;
public function __construct(File $target, int $threshold)
{
$this->target = $target;
$this->threshold = $threshold;
}
public function target(): File
{
return $this->target;
}
public function threshold(): int
{
return $this->threshold;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Text.php 0000644 00000002214 15243426620 0017325 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Text
{
private readonly File $target;
private readonly bool $showUncoveredFiles;
private readonly bool $showOnlySummary;
public function __construct(File $target, bool $showUncoveredFiles, bool $showOnlySummary)
{
$this->target = $target;
$this->showUncoveredFiles = $showUncoveredFiles;
$this->showOnlySummary = $showOnlySummary;
}
public function target(): File
{
return $this->target;
}
public function showUncoveredFiles(): bool
{
return $this->showUncoveredFiles;
}
public function showOnlySummary(): bool
{
return $this->showOnlySummary;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Php.php 0000644 00000001276 15243426620 0017137 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Php
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Cobertura.php 0000644 00000001304 15243426620 0020326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Cobertura
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Clover.php 0000644 00000001301 15243426620 0017627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Clover
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/Report/Xml.php 0000644 00000001322 15243426620 0017140 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report;
use PHPUnit\TextUI\Configuration\Directory;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Xml
{
private readonly Directory $target;
public function __construct(Directory $target)
{
$this->target = $target;
}
public function target(): Directory
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/CodeCoverage/CodeCoverage.php 0000644 00000017161 15243426620 0017463 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\CodeCoverage;
use function count;
use PHPUnit\TextUI\Configuration\Directory;
use PHPUnit\TextUI\Configuration\FileCollection;
use PHPUnit\TextUI\Configuration\FilterDirectoryCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Clover;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Cobertura;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Crap4j;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Html;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Php;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Text;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\Report\Xml;
use PHPUnit\TextUI\XmlConfiguration\Exception;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class CodeCoverage
{
private readonly ?Directory $cacheDirectory;
private readonly FilterDirectoryCollection $directories;
private readonly FileCollection $files;
private readonly FilterDirectoryCollection $excludeDirectories;
private readonly FileCollection $excludeFiles;
private readonly bool $pathCoverage;
private readonly bool $includeUncoveredFiles;
private readonly bool $ignoreDeprecatedCodeUnits;
private readonly bool $disableCodeCoverageIgnore;
private readonly ?Clover $clover;
private readonly ?Cobertura $cobertura;
private readonly ?Crap4j $crap4j;
private readonly ?Html $html;
private readonly ?Php $php;
private readonly ?Text $text;
private readonly ?Xml $xml;
public function __construct(?Directory $cacheDirectory, FilterDirectoryCollection $directories, FileCollection $files, FilterDirectoryCollection $excludeDirectories, FileCollection $excludeFiles, bool $pathCoverage, bool $includeUncoveredFiles, bool $ignoreDeprecatedCodeUnits, bool $disableCodeCoverageIgnore, ?Clover $clover, ?Cobertura $cobertura, ?Crap4j $crap4j, ?Html $html, ?Php $php, ?Text $text, ?Xml $xml)
{
$this->cacheDirectory = $cacheDirectory;
$this->directories = $directories;
$this->files = $files;
$this->excludeDirectories = $excludeDirectories;
$this->excludeFiles = $excludeFiles;
$this->pathCoverage = $pathCoverage;
$this->includeUncoveredFiles = $includeUncoveredFiles;
$this->ignoreDeprecatedCodeUnits = $ignoreDeprecatedCodeUnits;
$this->disableCodeCoverageIgnore = $disableCodeCoverageIgnore;
$this->clover = $clover;
$this->cobertura = $cobertura;
$this->crap4j = $crap4j;
$this->html = $html;
$this->php = $php;
$this->text = $text;
$this->xml = $xml;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*
* @deprecated
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheDirectory(): Directory
{
if (!$this->hasCacheDirectory()) {
throw new Exception(
'No cache directory has been configured',
);
}
return $this->cacheDirectory;
}
public function hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport(): bool
{
return count($this->directories) > 0 || count($this->files) > 0;
}
public function directories(): FilterDirectoryCollection
{
return $this->directories;
}
public function files(): FileCollection
{
return $this->files;
}
public function excludeDirectories(): FilterDirectoryCollection
{
return $this->excludeDirectories;
}
public function excludeFiles(): FileCollection
{
return $this->excludeFiles;
}
public function pathCoverage(): bool
{
return $this->pathCoverage;
}
public function includeUncoveredFiles(): bool
{
return $this->includeUncoveredFiles;
}
public function ignoreDeprecatedCodeUnits(): bool
{
return $this->ignoreDeprecatedCodeUnits;
}
public function disableCodeCoverageIgnore(): bool
{
return $this->disableCodeCoverageIgnore;
}
/**
* @psalm-assert-if-true !null $this->clover
*/
public function hasClover(): bool
{
return $this->clover !== null;
}
/**
* @throws Exception
*/
public function clover(): Clover
{
if (!$this->hasClover()) {
throw new Exception(
'Code Coverage report "Clover XML" has not been configured',
);
}
return $this->clover;
}
/**
* @psalm-assert-if-true !null $this->cobertura
*/
public function hasCobertura(): bool
{
return $this->cobertura !== null;
}
/**
* @throws Exception
*/
public function cobertura(): Cobertura
{
if (!$this->hasCobertura()) {
throw new Exception(
'Code Coverage report "Cobertura XML" has not been configured',
);
}
return $this->cobertura;
}
/**
* @psalm-assert-if-true !null $this->crap4j
*/
public function hasCrap4j(): bool
{
return $this->crap4j !== null;
}
/**
* @throws Exception
*/
public function crap4j(): Crap4j
{
if (!$this->hasCrap4j()) {
throw new Exception(
'Code Coverage report "Crap4J" has not been configured',
);
}
return $this->crap4j;
}
/**
* @psalm-assert-if-true !null $this->html
*/
public function hasHtml(): bool
{
return $this->html !== null;
}
/**
* @throws Exception
*/
public function html(): Html
{
if (!$this->hasHtml()) {
throw new Exception(
'Code Coverage report "HTML" has not been configured',
);
}
return $this->html;
}
/**
* @psalm-assert-if-true !null $this->php
*/
public function hasPhp(): bool
{
return $this->php !== null;
}
/**
* @throws Exception
*/
public function php(): Php
{
if (!$this->hasPhp()) {
throw new Exception(
'Code Coverage report "PHP" has not been configured',
);
}
return $this->php;
}
/**
* @psalm-assert-if-true !null $this->text
*/
public function hasText(): bool
{
return $this->text !== null;
}
/**
* @throws Exception
*/
public function text(): Text
{
if (!$this->hasText()) {
throw new Exception(
'Code Coverage report "Text" has not been configured',
);
}
return $this->text;
}
/**
* @psalm-assert-if-true !null $this->xml
*/
public function hasXml(): bool
{
return $this->xml !== null;
}
/**
* @throws Exception
*/
public function xml(): Xml
{
if (!$this->hasXml()) {
throw new Exception(
'Code Coverage report "XML" has not been configured',
);
}
return $this->xml;
}
}
src/TextUI/Configuration/Xml/PHPUnit.php 0000644 00000040236 15243426620 0014075 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class PHPUnit
{
private readonly ?string $cacheDirectory;
private readonly bool $cacheResult;
private readonly ?string $cacheResultFile;
private readonly int|string $columns;
private readonly string $colors;
private readonly bool $stderr;
private readonly bool $displayDetailsOnIncompleteTests;
private readonly bool $displayDetailsOnSkippedTests;
private readonly bool $displayDetailsOnTestsThatTriggerDeprecations;
private readonly bool $displayDetailsOnTestsThatTriggerErrors;
private readonly bool $displayDetailsOnTestsThatTriggerNotices;
private readonly bool $displayDetailsOnTestsThatTriggerWarnings;
private readonly bool $reverseDefectList;
private readonly bool $requireCoverageMetadata;
private readonly ?string $bootstrap;
private readonly bool $processIsolation;
private readonly bool $failOnDeprecation;
private readonly bool $failOnEmptyTestSuite;
private readonly bool $failOnIncomplete;
private readonly bool $failOnNotice;
private readonly bool $failOnRisky;
private readonly bool $failOnSkipped;
private readonly bool $failOnWarning;
private readonly bool $stopOnDefect;
private readonly bool $stopOnDeprecation;
private readonly bool $stopOnError;
private readonly bool $stopOnFailure;
private readonly bool $stopOnIncomplete;
private readonly bool $stopOnNotice;
private readonly bool $stopOnRisky;
private readonly bool $stopOnSkipped;
private readonly bool $stopOnWarning;
/**
* @psalm-var ?non-empty-string
*/
private readonly ?string $extensionsDirectory;
private readonly bool $beStrictAboutChangesToGlobalState;
private readonly bool $beStrictAboutOutputDuringTests;
private readonly bool $beStrictAboutTestsThatDoNotTestAnything;
private readonly bool $beStrictAboutCoverageMetadata;
private readonly bool $enforceTimeLimit;
private readonly int $defaultTimeLimit;
private readonly int $timeoutForSmallTests;
private readonly int $timeoutForMediumTests;
private readonly int $timeoutForLargeTests;
private readonly ?string $defaultTestSuite;
private readonly int $executionOrder;
private readonly bool $resolveDependencies;
private readonly bool $defectsFirst;
private readonly bool $backupGlobals;
private readonly bool $backupStaticProperties;
private readonly bool $registerMockObjectsFromTestArgumentsRecursively;
private readonly bool $testdoxPrinter;
private readonly bool $controlGarbageCollector;
private readonly int $numberOfTestsBeforeGarbageCollection;
/**
* @psalm-param ?non-empty-string $extensionsDirectory
*/
public function __construct(?string $cacheDirectory, bool $cacheResult, ?string $cacheResultFile, int|string $columns, string $colors, bool $stderr, bool $displayDetailsOnIncompleteTests, bool $displayDetailsOnSkippedTests, bool $displayDetailsOnTestsThatTriggerDeprecations, bool $displayDetailsOnTestsThatTriggerErrors, bool $displayDetailsOnTestsThatTriggerNotices, bool $displayDetailsOnTestsThatTriggerWarnings, bool $reverseDefectList, bool $requireCoverageMetadata, ?string $bootstrap, bool $processIsolation, bool $failOnDeprecation, bool $failOnEmptyTestSuite, bool $failOnIncomplete, bool $failOnNotice, bool $failOnRisky, bool $failOnSkipped, bool $failOnWarning, bool $stopOnDefect, bool $stopOnDeprecation, bool $stopOnError, bool $stopOnFailure, bool $stopOnIncomplete, bool $stopOnNotice, bool $stopOnRisky, bool $stopOnSkipped, bool $stopOnWarning, ?string $extensionsDirectory, bool $beStrictAboutChangesToGlobalState, bool $beStrictAboutOutputDuringTests, bool $beStrictAboutTestsThatDoNotTestAnything, bool $beStrictAboutCoverageMetadata, bool $enforceTimeLimit, int $defaultTimeLimit, int $timeoutForSmallTests, int $timeoutForMediumTests, int $timeoutForLargeTests, ?string $defaultTestSuite, int $executionOrder, bool $resolveDependencies, bool $defectsFirst, bool $backupGlobals, bool $backupStaticProperties, bool $registerMockObjectsFromTestArgumentsRecursively, bool $testdoxPrinter, bool $controlGarbageCollector, int $numberOfTestsBeforeGarbageCollection)
{
$this->cacheDirectory = $cacheDirectory;
$this->cacheResult = $cacheResult;
$this->cacheResultFile = $cacheResultFile;
$this->columns = $columns;
$this->colors = $colors;
$this->stderr = $stderr;
$this->displayDetailsOnIncompleteTests = $displayDetailsOnIncompleteTests;
$this->displayDetailsOnSkippedTests = $displayDetailsOnSkippedTests;
$this->displayDetailsOnTestsThatTriggerDeprecations = $displayDetailsOnTestsThatTriggerDeprecations;
$this->displayDetailsOnTestsThatTriggerErrors = $displayDetailsOnTestsThatTriggerErrors;
$this->displayDetailsOnTestsThatTriggerNotices = $displayDetailsOnTestsThatTriggerNotices;
$this->displayDetailsOnTestsThatTriggerWarnings = $displayDetailsOnTestsThatTriggerWarnings;
$this->reverseDefectList = $reverseDefectList;
$this->requireCoverageMetadata = $requireCoverageMetadata;
$this->bootstrap = $bootstrap;
$this->processIsolation = $processIsolation;
$this->failOnDeprecation = $failOnDeprecation;
$this->failOnEmptyTestSuite = $failOnEmptyTestSuite;
$this->failOnIncomplete = $failOnIncomplete;
$this->failOnNotice = $failOnNotice;
$this->failOnRisky = $failOnRisky;
$this->failOnSkipped = $failOnSkipped;
$this->failOnWarning = $failOnWarning;
$this->stopOnDefect = $stopOnDefect;
$this->stopOnDeprecation = $stopOnDeprecation;
$this->stopOnError = $stopOnError;
$this->stopOnFailure = $stopOnFailure;
$this->stopOnIncomplete = $stopOnIncomplete;
$this->stopOnNotice = $stopOnNotice;
$this->stopOnRisky = $stopOnRisky;
$this->stopOnSkipped = $stopOnSkipped;
$this->stopOnWarning = $stopOnWarning;
$this->extensionsDirectory = $extensionsDirectory;
$this->beStrictAboutChangesToGlobalState = $beStrictAboutChangesToGlobalState;
$this->beStrictAboutOutputDuringTests = $beStrictAboutOutputDuringTests;
$this->beStrictAboutTestsThatDoNotTestAnything = $beStrictAboutTestsThatDoNotTestAnything;
$this->beStrictAboutCoverageMetadata = $beStrictAboutCoverageMetadata;
$this->enforceTimeLimit = $enforceTimeLimit;
$this->defaultTimeLimit = $defaultTimeLimit;
$this->timeoutForSmallTests = $timeoutForSmallTests;
$this->timeoutForMediumTests = $timeoutForMediumTests;
$this->timeoutForLargeTests = $timeoutForLargeTests;
$this->defaultTestSuite = $defaultTestSuite;
$this->executionOrder = $executionOrder;
$this->resolveDependencies = $resolveDependencies;
$this->defectsFirst = $defectsFirst;
$this->backupGlobals = $backupGlobals;
$this->backupStaticProperties = $backupStaticProperties;
$this->registerMockObjectsFromTestArgumentsRecursively = $registerMockObjectsFromTestArgumentsRecursively;
$this->testdoxPrinter = $testdoxPrinter;
$this->controlGarbageCollector = $controlGarbageCollector;
$this->numberOfTestsBeforeGarbageCollection = $numberOfTestsBeforeGarbageCollection;
}
/**
* @psalm-assert-if-true !null $this->cacheDirectory
*/
public function hasCacheDirectory(): bool
{
return $this->cacheDirectory !== null;
}
/**
* @throws Exception
*/
public function cacheDirectory(): string
{
if (!$this->hasCacheDirectory()) {
throw new Exception('Cache directory is not configured');
}
return $this->cacheDirectory;
}
public function cacheResult(): bool
{
return $this->cacheResult;
}
/**
* @psalm-assert-if-true !null $this->cacheResultFile
*
* @deprecated
*/
public function hasCacheResultFile(): bool
{
return $this->cacheResultFile !== null;
}
/**
* @throws Exception
*
* @deprecated
*/
public function cacheResultFile(): string
{
if (!$this->hasCacheResultFile()) {
throw new Exception('Cache result file is not configured');
}
return $this->cacheResultFile;
}
public function columns(): int|string
{
return $this->columns;
}
public function colors(): string
{
return $this->colors;
}
public function stderr(): bool
{
return $this->stderr;
}
public function displayDetailsOnIncompleteTests(): bool
{
return $this->displayDetailsOnIncompleteTests;
}
public function displayDetailsOnSkippedTests(): bool
{
return $this->displayDetailsOnSkippedTests;
}
public function displayDetailsOnTestsThatTriggerDeprecations(): bool
{
return $this->displayDetailsOnTestsThatTriggerDeprecations;
}
public function displayDetailsOnTestsThatTriggerErrors(): bool
{
return $this->displayDetailsOnTestsThatTriggerErrors;
}
public function displayDetailsOnTestsThatTriggerNotices(): bool
{
return $this->displayDetailsOnTestsThatTriggerNotices;
}
public function displayDetailsOnTestsThatTriggerWarnings(): bool
{
return $this->displayDetailsOnTestsThatTriggerWarnings;
}
public function reverseDefectList(): bool
{
return $this->reverseDefectList;
}
public function requireCoverageMetadata(): bool
{
return $this->requireCoverageMetadata;
}
/**
* @psalm-assert-if-true !null $this->bootstrap
*/
public function hasBootstrap(): bool
{
return $this->bootstrap !== null;
}
/**
* @throws Exception
*/
public function bootstrap(): string
{
if (!$this->hasBootstrap()) {
throw new Exception('Bootstrap script is not configured');
}
return $this->bootstrap;
}
public function processIsolation(): bool
{
return $this->processIsolation;
}
public function failOnDeprecation(): bool
{
return $this->failOnDeprecation;
}
public function failOnEmptyTestSuite(): bool
{
return $this->failOnEmptyTestSuite;
}
public function failOnIncomplete(): bool
{
return $this->failOnIncomplete;
}
public function failOnNotice(): bool
{
return $this->failOnNotice;
}
public function failOnRisky(): bool
{
return $this->failOnRisky;
}
public function failOnSkipped(): bool
{
return $this->failOnSkipped;
}
public function failOnWarning(): bool
{
return $this->failOnWarning;
}
public function stopOnDefect(): bool
{
return $this->stopOnDefect;
}
public function stopOnDeprecation(): bool
{
return $this->stopOnDeprecation;
}
public function stopOnError(): bool
{
return $this->stopOnError;
}
public function stopOnFailure(): bool
{
return $this->stopOnFailure;
}
public function stopOnIncomplete(): bool
{
return $this->stopOnIncomplete;
}
public function stopOnNotice(): bool
{
return $this->stopOnNotice;
}
public function stopOnRisky(): bool
{
return $this->stopOnRisky;
}
public function stopOnSkipped(): bool
{
return $this->stopOnSkipped;
}
public function stopOnWarning(): bool
{
return $this->stopOnWarning;
}
/**
* @psalm-assert-if-true !null $this->extensionsDirectory
*/
public function hasExtensionsDirectory(): bool
{
return $this->extensionsDirectory !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws Exception
*/
public function extensionsDirectory(): string
{
if (!$this->hasExtensionsDirectory()) {
throw new Exception('Extensions directory is not configured');
}
return $this->extensionsDirectory;
}
public function beStrictAboutChangesToGlobalState(): bool
{
return $this->beStrictAboutChangesToGlobalState;
}
public function beStrictAboutOutputDuringTests(): bool
{
return $this->beStrictAboutOutputDuringTests;
}
public function beStrictAboutTestsThatDoNotTestAnything(): bool
{
return $this->beStrictAboutTestsThatDoNotTestAnything;
}
public function beStrictAboutCoverageMetadata(): bool
{
return $this->beStrictAboutCoverageMetadata;
}
public function enforceTimeLimit(): bool
{
return $this->enforceTimeLimit;
}
public function defaultTimeLimit(): int
{
return $this->defaultTimeLimit;
}
public function timeoutForSmallTests(): int
{
return $this->timeoutForSmallTests;
}
public function timeoutForMediumTests(): int
{
return $this->timeoutForMediumTests;
}
public function timeoutForLargeTests(): int
{
return $this->timeoutForLargeTests;
}
/**
* @psalm-assert-if-true !null $this->defaultTestSuite
*/
public function hasDefaultTestSuite(): bool
{
return $this->defaultTestSuite !== null;
}
/**
* @throws Exception
*/
public function defaultTestSuite(): string
{
if (!$this->hasDefaultTestSuite()) {
throw new Exception('Default test suite is not configured');
}
return $this->defaultTestSuite;
}
public function executionOrder(): int
{
return $this->executionOrder;
}
public function resolveDependencies(): bool
{
return $this->resolveDependencies;
}
public function defectsFirst(): bool
{
return $this->defectsFirst;
}
public function backupGlobals(): bool
{
return $this->backupGlobals;
}
public function backupStaticProperties(): bool
{
return $this->backupStaticProperties;
}
/**
* @deprecated
*/
public function registerMockObjectsFromTestArgumentsRecursively(): bool
{
return $this->registerMockObjectsFromTestArgumentsRecursively;
}
public function testdoxPrinter(): bool
{
return $this->testdoxPrinter;
}
public function controlGarbageCollector(): bool
{
return $this->controlGarbageCollector;
}
public function numberOfTestsBeforeGarbageCollection(): int
{
return $this->numberOfTestsBeforeGarbageCollection;
}
}
src/TextUI/Configuration/Xml/Exception.php 0000644 00000000762 15243426620 0014544 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
src/TextUI/Configuration/Xml/LoadedFromFileConfiguration.php 0000644 00000003542 15243426620 0020151 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use PHPUnit\TextUI\Configuration\ExtensionBootstrapCollection;
use PHPUnit\TextUI\Configuration\Php;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\TestSuiteCollection;
use PHPUnit\TextUI\XmlConfiguration\CodeCoverage\CodeCoverage;
use PHPUnit\TextUI\XmlConfiguration\Logging\Logging;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class LoadedFromFileConfiguration extends Configuration
{
private readonly string $filename;
private readonly ValidationResult $validationResult;
public function __construct(string $filename, ValidationResult $validationResult, ExtensionBootstrapCollection $extensions, Source $source, CodeCoverage $codeCoverage, Groups $groups, Logging $logging, Php $php, PHPUnit $phpunit, TestSuiteCollection $testSuite)
{
$this->filename = $filename;
$this->validationResult = $validationResult;
parent::__construct(
$extensions,
$source,
$codeCoverage,
$groups,
$logging,
$php,
$phpunit,
$testSuite,
);
}
public function filename(): string
{
return $this->filename;
}
public function hasValidationErrors(): bool
{
return $this->validationResult->hasValidationErrors();
}
public function validationErrors(): string
{
return $this->validationResult->asString();
}
public function wasLoadedFromFile(): bool
{
return true;
}
}
src/TextUI/Configuration/Xml/Logging/TeamCity.php 0000644 00000001267 15243426620 0015714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TeamCity
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/Logging/Junit.php 0000644 00000001264 15243426620 0015263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Junit
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/Logging/Logging.php 0000644 00000004727 15243426620 0015567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging;
use PHPUnit\TextUI\XmlConfiguration\Exception;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Html as TestDoxHtml;
use PHPUnit\TextUI\XmlConfiguration\Logging\TestDox\Text as TestDoxText;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Logging
{
private readonly ?Junit $junit;
private readonly ?TeamCity $teamCity;
private readonly ?TestDoxHtml $testDoxHtml;
private readonly ?TestDoxText $testDoxText;
public function __construct(?Junit $junit, ?TeamCity $teamCity, ?TestDoxHtml $testDoxHtml, ?TestDoxText $testDoxText)
{
$this->junit = $junit;
$this->teamCity = $teamCity;
$this->testDoxHtml = $testDoxHtml;
$this->testDoxText = $testDoxText;
}
public function hasJunit(): bool
{
return $this->junit !== null;
}
/**
* @throws Exception
*/
public function junit(): Junit
{
if ($this->junit === null) {
throw new Exception('Logger "JUnit XML" is not configured');
}
return $this->junit;
}
public function hasTeamCity(): bool
{
return $this->teamCity !== null;
}
/**
* @throws Exception
*/
public function teamCity(): TeamCity
{
if ($this->teamCity === null) {
throw new Exception('Logger "Team City" is not configured');
}
return $this->teamCity;
}
public function hasTestDoxHtml(): bool
{
return $this->testDoxHtml !== null;
}
/**
* @throws Exception
*/
public function testDoxHtml(): TestDoxHtml
{
if ($this->testDoxHtml === null) {
throw new Exception('Logger "TestDox HTML" is not configured');
}
return $this->testDoxHtml;
}
public function hasTestDoxText(): bool
{
return $this->testDoxText !== null;
}
/**
* @throws Exception
*/
public function testDoxText(): TestDoxText
{
if ($this->testDoxText === null) {
throw new Exception('Logger "TestDox Text" is not configured');
}
return $this->testDoxText;
}
}
src/TextUI/Configuration/Xml/Logging/TestDox/Html.php 0000644 00000001273 15243426620 0016470 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging\TestDox;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Html
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/Logging/TestDox/Text.php 0000644 00000001273 15243426620 0016510 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration\Logging\TestDox;
use PHPUnit\TextUI\Configuration\File;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Text
{
private readonly File $target;
public function __construct(File $target)
{
$this->target = $target;
}
public function target(): File
{
return $this->target;
}
}
src/TextUI/Configuration/Xml/Validator/Validator.php 0000644 00000001757 15243426620 0016465 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function file_get_contents;
use function libxml_clear_errors;
use function libxml_get_errors;
use function libxml_use_internal_errors;
use DOMDocument;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Validator
{
public function validate(DOMDocument $document, string $xsdFilename): ValidationResult
{
$originalErrorHandling = libxml_use_internal_errors(true);
$document->schemaValidateSource(file_get_contents($xsdFilename));
$errors = libxml_get_errors();
libxml_clear_errors();
libxml_use_internal_errors($originalErrorHandling);
return ValidationResult::fromArray($errors);
}
}
src/TextUI/Configuration/Xml/Validator/ValidationResult.php 0000644 00000003301 15243426620 0020014 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\XmlConfiguration;
use function sprintf;
use function trim;
use LibXMLError;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ValidationResult
{
/**
* @psalm-var array<int,list<string>>
*/
private readonly array $validationErrors;
/**
* @psalm-param array<int,LibXMLError> $errors
*/
public static function fromArray(array $errors): self
{
$validationErrors = [];
foreach ($errors as $error) {
if (!isset($validationErrors[$error->line])) {
$validationErrors[$error->line] = [];
}
$validationErrors[$error->line][] = trim($error->message);
}
return new self($validationErrors);
}
private function __construct(array $validationErrors)
{
$this->validationErrors = $validationErrors;
}
public function hasValidationErrors(): bool
{
return !empty($this->validationErrors);
}
public function asString(): string
{
$buffer = '';
foreach ($this->validationErrors as $line => $validationErrorsOnLine) {
$buffer .= sprintf(PHP_EOL . ' Line %d:' . PHP_EOL, $line);
foreach ($validationErrorsOnLine as $validationError) {
$buffer .= sprintf(' - %s' . PHP_EOL, $validationError);
}
}
return $buffer;
}
}
src/TextUI/Configuration/Value/TestDirectory.php 0000644 00000003303 15243426620 0015720 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestDirectory
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
private readonly string $prefix;
private readonly string $suffix;
private readonly string $phpVersion;
private readonly VersionComparisonOperator $phpVersionOperator;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path, string $prefix, string $suffix, string $phpVersion, VersionComparisonOperator $phpVersionOperator)
{
$this->path = $path;
$this->prefix = $prefix;
$this->suffix = $suffix;
$this->phpVersion = $phpVersion;
$this->phpVersionOperator = $phpVersionOperator;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
public function prefix(): string
{
return $this->prefix;
}
public function suffix(): string
{
return $this->suffix;
}
public function phpVersion(): string
{
return $this->phpVersion;
}
public function phpVersionOperator(): VersionComparisonOperator
{
return $this->phpVersionOperator;
}
}
src/TextUI/Configuration/Value/ExtensionBootstrapCollectionIterator.php 0000644 00000002714 15243426620 0022521 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, ExtensionBootstrap>
*/
final class ExtensionBootstrapCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<ExtensionBootstrap>
*/
private readonly array $extensionBootstraps;
private int $position = 0;
public function __construct(ExtensionBootstrapCollection $extensionBootstraps)
{
$this->extensionBootstraps = $extensionBootstraps->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->extensionBootstraps);
}
public function key(): int
{
return $this->position;
}
public function current(): ExtensionBootstrap
{
return $this->extensionBootstraps[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/TestSuiteCollectionIterator.php 0000644 00000002551 15243426620 0020577 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestSuite>
*/
final class TestSuiteCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestSuite>
*/
private readonly array $testSuites;
private int $position = 0;
public function __construct(TestSuiteCollection $testSuites)
{
$this->testSuites = $testSuites->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->testSuites);
}
public function key(): int
{
return $this->position;
}
public function current(): TestSuite
{
return $this->testSuites[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/GroupCollection.php 0000644 00000002740 15243426620 0016230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Group>
*/
final class GroupCollection implements IteratorAggregate
{
/**
* @psalm-var list<Group>
*/
private readonly array $groups;
/**
* @psalm-param list<Group> $groups
*/
public static function fromArray(array $groups): self
{
return new self(...$groups);
}
private function __construct(Group ...$groups)
{
$this->groups = $groups;
}
/**
* @psalm-return list<Group>
*/
public function asArray(): array
{
return $this->groups;
}
/**
* @psalm-return list<string>
*/
public function asArrayOfStrings(): array
{
$result = [];
foreach ($this->groups as $group) {
$result[] = $group->name();
}
return $result;
}
public function isEmpty(): bool
{
return empty($this->groups);
}
public function getIterator(): GroupCollectionIterator
{
return new GroupCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/Variable.php 0000644 00000001706 15243426620 0014646 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Variable
{
private readonly string $name;
private readonly mixed $value;
private readonly bool $force;
public function __construct(string $name, mixed $value, bool $force)
{
$this->name = $name;
$this->value = $value;
$this->force = $force;
}
public function name(): string
{
return $this->name;
}
public function value(): mixed
{
return $this->value;
}
public function force(): bool
{
return $this->force;
}
}
src/TextUI/Configuration/Value/FilterDirectoryCollection.php 0000644 00000002752 15243426620 0020251 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, FilterDirectory>
*/
final class FilterDirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<FilterDirectory>
*/
private readonly array $directories;
/**
* @psalm-param list<FilterDirectory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(FilterDirectory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<FilterDirectory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function notEmpty(): bool
{
return !empty($this->directories);
}
public function getIterator(): FilterDirectoryCollectionIterator
{
return new FilterDirectoryCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/FilterDirectoryCollectionIterator.php 0000644 00000002615 15243426620 0021761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, FilterDirectory>
*/
final class FilterDirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<FilterDirectory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(FilterDirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): FilterDirectory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/TestFileCollection.php 0000644 00000002565 15243426620 0016660 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestFile>
*/
final class TestFileCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestFile>
*/
private readonly array $files;
/**
* @psalm-param list<TestFile> $files
*/
public static function fromArray(array $files): self
{
return new self(...$files);
}
private function __construct(TestFile ...$files)
{
$this->files = $files;
}
/**
* @psalm-return list<TestFile>
*/
public function asArray(): array
{
return $this->files;
}
public function count(): int
{
return count($this->files);
}
public function getIterator(): TestFileCollectionIterator
{
return new TestFileCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
src/TextUI/Configuration/Value/FilterDirectory.php 0000644 00000002207 15243426620 0016230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class FilterDirectory
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
private readonly string $prefix;
private readonly string $suffix;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path, string $prefix, string $suffix)
{
$this->path = $path;
$this->prefix = $prefix;
$this->suffix = $suffix;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
public function prefix(): string
{
return $this->prefix;
}
public function suffix(): string
{
return $this->suffix;
}
}
src/TextUI/Configuration/Value/GroupCollectionIterator.php 0000644 00000002475 15243426620 0017747 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Group>
*/
final class GroupCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Group>
*/
private readonly array $groups;
private int $position = 0;
public function __construct(GroupCollection $groups)
{
$this->groups = $groups->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->groups);
}
public function key(): int
{
return $this->position;
}
public function current(): Group
{
return $this->groups[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/DirectoryCollection.php 0000644 00000002663 15243426620 0017104 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Directory>
*/
final class DirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Directory>
*/
private readonly array $directories;
/**
* @psalm-param list<Directory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(Directory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<Directory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function getIterator(): DirectoryCollectionIterator
{
return new DirectoryCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
src/TextUI/Configuration/Value/Constant.php 0000644 00000001476 15243426620 0014716 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Constant
{
private readonly string $name;
private readonly bool|string $value;
public function __construct(string $name, bool|string $value)
{
$this->name = $name;
$this->value = $value;
}
public function name(): string
{
return $this->name;
}
public function value(): bool|string
{
return $this->value;
}
}
src/TextUI/Configuration/Value/Directory.php 0000644 00000001217 15243426620 0015062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Directory
{
private readonly string $path;
public function __construct(string $path)
{
$this->path = $path;
}
public function path(): string
{
return $this->path;
}
}
src/TextUI/Configuration/Value/IniSettingCollection.php 0000644 00000002545 15243426620 0017214 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, IniSetting>
*/
final class IniSettingCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<IniSetting>
*/
private readonly array $iniSettings;
/**
* @psalm-param list<IniSetting> $iniSettings
*/
public static function fromArray(array $iniSettings): self
{
return new self(...$iniSettings);
}
private function __construct(IniSetting ...$iniSettings)
{
$this->iniSettings = $iniSettings;
}
/**
* @psalm-return list<IniSetting>
*/
public function asArray(): array
{
return $this->iniSettings;
}
public function count(): int
{
return count($this->iniSettings);
}
public function getIterator(): IniSettingCollectionIterator
{
return new IniSettingCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/Source.php 0000644 00000012721 15243426620 0014360 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Source
{
/**
* @psalm-var non-empty-string
*/
private readonly ?string $baseline;
private readonly bool $ignoreBaseline;
private readonly FilterDirectoryCollection $includeDirectories;
private readonly FileCollection $includeFiles;
private readonly FilterDirectoryCollection $excludeDirectories;
private readonly FileCollection $excludeFiles;
private readonly bool $restrictDeprecations;
private readonly bool $restrictNotices;
private readonly bool $restrictWarnings;
private readonly bool $ignoreSuppressionOfDeprecations;
private readonly bool $ignoreSuppressionOfPhpDeprecations;
private readonly bool $ignoreSuppressionOfErrors;
private readonly bool $ignoreSuppressionOfNotices;
private readonly bool $ignoreSuppressionOfPhpNotices;
private readonly bool $ignoreSuppressionOfWarnings;
private readonly bool $ignoreSuppressionOfPhpWarnings;
/**
* @psalm-param non-empty-string $baseline
*/
public function __construct(?string $baseline, bool $ignoreBaseline, FilterDirectoryCollection $includeDirectories, FileCollection $includeFiles, FilterDirectoryCollection $excludeDirectories, FileCollection $excludeFiles, bool $restrictDeprecations, bool $restrictNotices, bool $restrictWarnings, bool $ignoreSuppressionOfDeprecations, bool $ignoreSuppressionOfPhpDeprecations, bool $ignoreSuppressionOfErrors, bool $ignoreSuppressionOfNotices, bool $ignoreSuppressionOfPhpNotices, bool $ignoreSuppressionOfWarnings, bool $ignoreSuppressionOfPhpWarnings)
{
$this->baseline = $baseline;
$this->ignoreBaseline = $ignoreBaseline;
$this->includeDirectories = $includeDirectories;
$this->includeFiles = $includeFiles;
$this->excludeDirectories = $excludeDirectories;
$this->excludeFiles = $excludeFiles;
$this->restrictDeprecations = $restrictDeprecations;
$this->restrictNotices = $restrictNotices;
$this->restrictWarnings = $restrictWarnings;
$this->ignoreSuppressionOfDeprecations = $ignoreSuppressionOfDeprecations;
$this->ignoreSuppressionOfPhpDeprecations = $ignoreSuppressionOfPhpDeprecations;
$this->ignoreSuppressionOfErrors = $ignoreSuppressionOfErrors;
$this->ignoreSuppressionOfNotices = $ignoreSuppressionOfNotices;
$this->ignoreSuppressionOfPhpNotices = $ignoreSuppressionOfPhpNotices;
$this->ignoreSuppressionOfWarnings = $ignoreSuppressionOfWarnings;
$this->ignoreSuppressionOfPhpWarnings = $ignoreSuppressionOfPhpWarnings;
}
/**
* @psalm-assert-if-true !null $this->baseline
*/
public function useBaseline(): bool
{
return $this->hasBaseline() && !$this->ignoreBaseline;
}
/**
* @psalm-assert-if-true !null $this->baseline
*/
public function hasBaseline(): bool
{
return $this->baseline !== null;
}
/**
* @psalm-return non-empty-string
*
* @throws NoBaselineException
*/
public function baseline(): string
{
if (!$this->hasBaseline()) {
throw new NoBaselineException;
}
return $this->baseline;
}
public function includeDirectories(): FilterDirectoryCollection
{
return $this->includeDirectories;
}
public function includeFiles(): FileCollection
{
return $this->includeFiles;
}
public function excludeDirectories(): FilterDirectoryCollection
{
return $this->excludeDirectories;
}
public function excludeFiles(): FileCollection
{
return $this->excludeFiles;
}
public function notEmpty(): bool
{
return $this->includeDirectories->notEmpty() || $this->includeFiles->notEmpty();
}
public function restrictDeprecations(): bool
{
return $this->restrictDeprecations;
}
public function restrictNotices(): bool
{
return $this->restrictNotices;
}
public function restrictWarnings(): bool
{
return $this->restrictWarnings;
}
public function ignoreSuppressionOfDeprecations(): bool
{
return $this->ignoreSuppressionOfDeprecations;
}
public function ignoreSuppressionOfPhpDeprecations(): bool
{
return $this->ignoreSuppressionOfPhpDeprecations;
}
public function ignoreSuppressionOfErrors(): bool
{
return $this->ignoreSuppressionOfErrors;
}
public function ignoreSuppressionOfNotices(): bool
{
return $this->ignoreSuppressionOfNotices;
}
public function ignoreSuppressionOfPhpNotices(): bool
{
return $this->ignoreSuppressionOfPhpNotices;
}
public function ignoreSuppressionOfWarnings(): bool
{
return $this->ignoreSuppressionOfWarnings;
}
public function ignoreSuppressionOfPhpWarnings(): bool
{
return $this->ignoreSuppressionOfPhpWarnings;
}
}
src/TextUI/Configuration/Value/VariableCollection.php 0000644 00000002503 15243426620 0016656 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Variable>
*/
final class VariableCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Variable>
*/
private readonly array $variables;
/**
* @psalm-param list<Variable> $variables
*/
public static function fromArray(array $variables): self
{
return new self(...$variables);
}
private function __construct(Variable ...$variables)
{
$this->variables = $variables;
}
/**
* @psalm-return list<Variable>
*/
public function asArray(): array
{
return $this->variables;
}
public function count(): int
{
return count($this->variables);
}
public function getIterator(): VariableCollectionIterator
{
return new VariableCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/TestFileCollectionIterator.php 0000644 00000002506 15243426620 0020365 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestFile>
*/
final class TestFileCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestFile>
*/
private readonly array $files;
private int $position = 0;
public function __construct(TestFileCollection $files)
{
$this->files = $files->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->files);
}
public function key(): int
{
return $this->position;
}
public function current(): TestFile
{
return $this->files[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/FileCollectionIterator.php 0000644 00000002462 15243426620 0017526 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, File>
*/
final class FileCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<File>
*/
private readonly array $files;
private int $position = 0;
public function __construct(FileCollection $files)
{
$this->files = $files->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->files);
}
public function key(): int
{
return $this->position;
}
public function current(): File
{
return $this->files[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/TestFile.php 0000644 00000002266 15243426620 0014642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use PHPUnit\Util\VersionComparisonOperator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestFile
{
private readonly string $path;
private readonly string $phpVersion;
private readonly VersionComparisonOperator $phpVersionOperator;
public function __construct(string $path, string $phpVersion, VersionComparisonOperator $phpVersionOperator)
{
$this->path = $path;
$this->phpVersion = $phpVersion;
$this->phpVersionOperator = $phpVersionOperator;
}
public function path(): string
{
return $this->path;
}
public function phpVersion(): string
{
return $this->phpVersion;
}
public function phpVersionOperator(): VersionComparisonOperator
{
return $this->phpVersionOperator;
}
}
src/TextUI/Configuration/Value/VariableCollectionIterator.php 0000644 00000002536 15243426620 0020376 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Variable>
*/
final class VariableCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Variable>
*/
private readonly array $variables;
private int $position = 0;
public function __construct(VariableCollection $variables)
{
$this->variables = $variables->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->variables);
}
public function key(): int
{
return $this->position;
}
public function current(): Variable
{
return $this->variables[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/Group.php 0000644 00000001213 15243426620 0014206 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Group
{
private readonly string $name;
public function __construct(string $name)
{
$this->name = $name;
}
public function name(): string
{
return $this->name;
}
}
src/TextUI/Configuration/Value/ConstantCollection.php 0000644 00000002503 15243426620 0016722 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, Constant>
*/
final class ConstantCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<Constant>
*/
private readonly array $constants;
/**
* @psalm-param list<Constant> $constants
*/
public static function fromArray(array $constants): self
{
return new self(...$constants);
}
private function __construct(Constant ...$constants)
{
$this->constants = $constants;
}
/**
* @psalm-return list<Constant>
*/
public function asArray(): array
{
return $this->constants;
}
public function count(): int
{
return count($this->constants);
}
public function getIterator(): ConstantCollectionIterator
{
return new ConstantCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/TestSuiteCollection.php 0000644 00000002652 15243426620 0017067 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestSuite>
*/
final class TestSuiteCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestSuite>
*/
private readonly array $testSuites;
/**
* @psalm-param list<TestSuite> $testSuites
*/
public static function fromArray(array $testSuites): self
{
return new self(...$testSuites);
}
private function __construct(TestSuite ...$testSuites)
{
$this->testSuites = $testSuites;
}
/**
* @psalm-return list<TestSuite>
*/
public function asArray(): array
{
return $this->testSuites;
}
public function count(): int
{
return count($this->testSuites);
}
public function getIterator(): TestSuiteCollectionIterator
{
return new TestSuiteCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
src/TextUI/Configuration/Value/Php.php 0000644 00000006232 15243426620 0013647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Php
{
private readonly DirectoryCollection $includePaths;
private readonly IniSettingCollection $iniSettings;
private readonly ConstantCollection $constants;
private readonly VariableCollection $globalVariables;
private readonly VariableCollection $envVariables;
private readonly VariableCollection $postVariables;
private readonly VariableCollection $getVariables;
private readonly VariableCollection $cookieVariables;
private readonly VariableCollection $serverVariables;
private readonly VariableCollection $filesVariables;
private readonly VariableCollection $requestVariables;
public function __construct(DirectoryCollection $includePaths, IniSettingCollection $iniSettings, ConstantCollection $constants, VariableCollection $globalVariables, VariableCollection $envVariables, VariableCollection $postVariables, VariableCollection $getVariables, VariableCollection $cookieVariables, VariableCollection $serverVariables, VariableCollection $filesVariables, VariableCollection $requestVariables)
{
$this->includePaths = $includePaths;
$this->iniSettings = $iniSettings;
$this->constants = $constants;
$this->globalVariables = $globalVariables;
$this->envVariables = $envVariables;
$this->postVariables = $postVariables;
$this->getVariables = $getVariables;
$this->cookieVariables = $cookieVariables;
$this->serverVariables = $serverVariables;
$this->filesVariables = $filesVariables;
$this->requestVariables = $requestVariables;
}
public function includePaths(): DirectoryCollection
{
return $this->includePaths;
}
public function iniSettings(): IniSettingCollection
{
return $this->iniSettings;
}
public function constants(): ConstantCollection
{
return $this->constants;
}
public function globalVariables(): VariableCollection
{
return $this->globalVariables;
}
public function envVariables(): VariableCollection
{
return $this->envVariables;
}
public function postVariables(): VariableCollection
{
return $this->postVariables;
}
public function getVariables(): VariableCollection
{
return $this->getVariables;
}
public function cookieVariables(): VariableCollection
{
return $this->cookieVariables;
}
public function serverVariables(): VariableCollection
{
return $this->serverVariables;
}
public function filesVariables(): VariableCollection
{
return $this->filesVariables;
}
public function requestVariables(): VariableCollection
{
return $this->requestVariables;
}
}
src/TextUI/Configuration/Value/File.php 0000644 00000001456 15243426620 0014002 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class File
{
/**
* @psalm-var non-empty-string
*/
private readonly string $path;
/**
* @psalm-param non-empty-string $path
*/
public function __construct(string $path)
{
$this->path = $path;
}
/**
* @psalm-return non-empty-string
*/
public function path(): string
{
return $this->path;
}
}
src/TextUI/Configuration/Value/ExtensionBootstrapCollection.php 0000644 00000002537 15243426620 0021012 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, ExtensionBootstrap>
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ExtensionBootstrapCollection implements IteratorAggregate
{
/**
* @psalm-var list<ExtensionBootstrap>
*/
private readonly array $extensionBootstraps;
/**
* @psalm-param list<ExtensionBootstrap> $extensionBootstraps
*/
public static function fromArray(array $extensionBootstraps): self
{
return new self(...$extensionBootstraps);
}
private function __construct(ExtensionBootstrap ...$extensionBootstraps)
{
$this->extensionBootstraps = $extensionBootstraps;
}
/**
* @psalm-return list<ExtensionBootstrap>
*/
public function asArray(): array
{
return $this->extensionBootstraps;
}
public function getIterator(): ExtensionBootstrapCollectionIterator
{
return new ExtensionBootstrapCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/TestDirectoryCollection.php 0000644 00000002723 15243426620 0017741 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, TestDirectory>
*/
final class TestDirectoryCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<TestDirectory>
*/
private readonly array $directories;
/**
* @psalm-param list<TestDirectory> $directories
*/
public static function fromArray(array $directories): self
{
return new self(...$directories);
}
private function __construct(TestDirectory ...$directories)
{
$this->directories = $directories;
}
/**
* @psalm-return list<TestDirectory>
*/
public function asArray(): array
{
return $this->directories;
}
public function count(): int
{
return count($this->directories);
}
public function getIterator(): TestDirectoryCollectionIterator
{
return new TestDirectoryCollectionIterator($this);
}
public function isEmpty(): bool
{
return $this->count() === 0;
}
}
src/TextUI/Configuration/Value/ConstantCollectionIterator.php 0000644 00000002536 15243426620 0020442 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Constant>
*/
final class ConstantCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Constant>
*/
private readonly array $constants;
private int $position = 0;
public function __construct(ConstantCollection $constants)
{
$this->constants = $constants->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->constants);
}
public function key(): int
{
return $this->position;
}
public function current(): Constant
{
return $this->constants[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/DirectoryCollectionIterator.php 0000644 00000002557 15243426620 0020620 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, Directory>
*/
final class DirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<Directory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(DirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): Directory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/ExtensionBootstrap.php 0000644 00000002266 15243426620 0016775 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class ExtensionBootstrap
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var array<string,string>
*/
private readonly array $parameters;
/**
* @psalm-param class-string $className
* @psalm-param array<string,string> $parameters
*/
public function __construct(string $className, array $parameters)
{
$this->className = $className;
$this->parameters = $parameters;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return array<string,string>
*/
public function parameters(): array
{
return $this->parameters;
}
}
src/TextUI/Configuration/Value/FileCollection.php 0000644 00000002526 15243426620 0016015 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use Countable;
use IteratorAggregate;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*
* @template-implements IteratorAggregate<int, File>
*/
final class FileCollection implements Countable, IteratorAggregate
{
/**
* @psalm-var list<File>
*/
private readonly array $files;
/**
* @psalm-param list<File> $files
*/
public static function fromArray(array $files): self
{
return new self(...$files);
}
private function __construct(File ...$files)
{
$this->files = $files;
}
/**
* @psalm-return list<File>
*/
public function asArray(): array
{
return $this->files;
}
public function count(): int
{
return count($this->files);
}
public function notEmpty(): bool
{
return !empty($this->files);
}
public function getIterator(): FileCollectionIterator
{
return new FileCollectionIterator($this);
}
}
src/TextUI/Configuration/Value/IniSetting.php 0000644 00000001461 15243426620 0015174 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class IniSetting
{
private readonly string $name;
private readonly string $value;
public function __construct(string $name, string $value)
{
$this->name = $name;
$this->value = $value;
}
public function name(): string
{
return $this->name;
}
public function value(): string
{
return $this->value;
}
}
src/TextUI/Configuration/Value/TestDirectoryCollectionIterator.php 0000644 00000002603 15243426620 0021450 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, TestDirectory>
*/
final class TestDirectoryCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<TestDirectory>
*/
private readonly array $directories;
private int $position = 0;
public function __construct(TestDirectoryCollection $directories)
{
$this->directories = $directories->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->directories);
}
public function key(): int
{
return $this->position;
}
public function current(): TestDirectory
{
return $this->directories[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/IniSettingCollectionIterator.php 0000644 00000002564 15243426620 0020727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
use function count;
use function iterator_count;
use Countable;
use Iterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @template-implements Iterator<int, IniSetting>
*/
final class IniSettingCollectionIterator implements Countable, Iterator
{
/**
* @psalm-var list<IniSetting>
*/
private readonly array $iniSettings;
private int $position = 0;
public function __construct(IniSettingCollection $iniSettings)
{
$this->iniSettings = $iniSettings->asArray();
}
public function count(): int
{
return iterator_count($this);
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->iniSettings);
}
public function key(): int
{
return $this->position;
}
public function current(): IniSetting
{
return $this->iniSettings[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/TextUI/Configuration/Value/TestSuite.php 0000644 00000002703 15243426620 0015050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TextUI\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class TestSuite
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
private readonly TestDirectoryCollection $directories;
private readonly TestFileCollection $files;
private readonly FileCollection $exclude;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name, TestDirectoryCollection $directories, TestFileCollection $files, FileCollection $exclude)
{
$this->name = $name;
$this->directories = $directories;
$this->files = $files;
$this->exclude = $exclude;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
public function directories(): TestDirectoryCollection
{
return $this->directories;
}
public function files(): TestFileCollection
{
return $this->files;
}
public function exclude(): FileCollection
{
return $this->exclude;
}
}
src/Framework/TestSize/Known.php 0000644 00000001204 15243426620 0012650 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class Known extends TestSize
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
abstract public function isGreaterThan(self $other): bool;
}
src/Framework/TestSize/Medium.php 0000644 00000001366 15243426620 0013005 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Medium extends Known
{
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return $other->isSmall();
}
public function asString(): string
{
return 'medium';
}
}
src/Framework/TestSize/Unknown.php 0000644 00000001225 15243426620 0013216 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Unknown extends TestSize
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asString(): string
{
return 'unknown';
}
}
src/Framework/TestSize/TestSize.php 0000644 00000002665 15243426620 0013342 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
abstract class TestSize
{
public static function unknown(): self
{
return new Unknown;
}
public static function small(): self
{
return new Small;
}
public static function medium(): self
{
return new Medium;
}
public static function large(): self
{
return new Large;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return false;
}
/**
* @psalm-assert-if-true Medium $this
*/
public function isMedium(): bool
{
return false;
}
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return false;
}
abstract public function asString(): string;
}
src/Framework/TestSize/Small.php 0000644 00000001346 15243426620 0012633 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Small extends Known
{
/**
* @psalm-assert-if-true Small $this
*/
public function isSmall(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return false;
}
public function asString(): string
{
return 'small';
}
}
src/Framework/TestSize/Large.php 0000644 00000001363 15243426620 0012614 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestSize;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @psalm-immutable
*/
final class Large extends Known
{
/**
* @psalm-assert-if-true Large $this
*/
public function isLarge(): bool
{
return true;
}
public function isGreaterThan(TestSize $other): bool
{
return !$other->isLarge();
}
public function asString(): string
{
return 'large';
}
}
src/Framework/TestBuilder.php 0000644 00000023433 15243426620 0012240 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function assert;
use PHPUnit\Metadata\Api\DataProvider;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\BackupGlobals;
use PHPUnit\Metadata\BackupStaticProperties;
use PHPUnit\Metadata\ExcludeGlobalVariableFromBackup;
use PHPUnit\Metadata\ExcludeStaticPropertyFromBackup;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\PreserveGlobalState;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestBuilder
{
/**
* @psalm-param non-empty-string $methodName
*
* @throws InvalidDataProviderException
*/
public function build(ReflectionClass $theClass, string $methodName): Test
{
$className = $theClass->getName();
$data = (new DataProvider)->providedData(
$className,
$methodName,
);
if ($data !== null) {
return $this->buildDataProviderTestSuite(
$methodName,
$className,
$data,
$this->shouldTestMethodBeRunInSeparateProcess($className, $methodName),
$this->shouldGlobalStateBePreserved($className, $methodName),
$this->shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess($className),
$this->backupSettings($className, $methodName),
);
}
$test = new $className($methodName);
assert($test instanceof TestCase);
$this->configureTestCase(
$test,
$this->shouldTestMethodBeRunInSeparateProcess($className, $methodName),
$this->shouldGlobalStateBePreserved($className, $methodName),
$this->shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess($className),
$this->backupSettings($className, $methodName),
);
return $test;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>} $backupSettings
*/
private function buildDataProviderTestSuite(string $methodName, string $className, array $data, bool $runTestInSeparateProcess, ?bool $preserveGlobalState, bool $runClassInSeparateProcess, array $backupSettings): DataProviderTestSuite
{
$dataProviderTestSuite = DataProviderTestSuite::empty(
$className . '::' . $methodName,
);
$groups = (new Groups)->groups($className, $methodName);
foreach ($data as $_dataName => $_data) {
$_test = new $className($methodName);
assert($_test instanceof TestCase);
$_test->setData($_dataName, $_data);
$this->configureTestCase(
$_test,
$runTestInSeparateProcess,
$preserveGlobalState,
$runClassInSeparateProcess,
$backupSettings,
);
$dataProviderTestSuite->addTest($_test, $groups);
}
return $dataProviderTestSuite;
}
/**
* @psalm-param array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>} $backupSettings
*/
private function configureTestCase(TestCase $test, bool $runTestInSeparateProcess, ?bool $preserveGlobalState, bool $runClassInSeparateProcess, array $backupSettings): void
{
if ($runTestInSeparateProcess) {
$test->setRunTestInSeparateProcess(true);
}
if ($runClassInSeparateProcess) {
$test->setRunClassInSeparateProcess(true);
}
if ($preserveGlobalState !== null) {
$test->setPreserveGlobalState($preserveGlobalState);
}
if ($backupSettings['backupGlobals'] !== null) {
$test->setBackupGlobals($backupSettings['backupGlobals']);
} else {
$test->setBackupGlobals(ConfigurationRegistry::get()->backupGlobals());
}
$test->setBackupGlobalsExcludeList($backupSettings['backupGlobalsExcludeList']);
if ($backupSettings['backupStaticProperties'] !== null) {
$test->setBackupStaticProperties($backupSettings['backupStaticProperties']);
} else {
$test->setBackupStaticProperties(ConfigurationRegistry::get()->backupStaticProperties());
}
$test->setBackupStaticPropertiesExcludeList($backupSettings['backupStaticPropertiesExcludeList']);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @psalm-return array{backupGlobals: ?bool, backupGlobalsExcludeList: list<string>, backupStaticProperties: ?bool, backupStaticPropertiesExcludeList: array<string,list<string>>}
*/
private function backupSettings(string $className, string $methodName): array
{
$metadataForClass = MetadataRegistry::parser()->forClass($className);
$metadataForMethod = MetadataRegistry::parser()->forMethod($className, $methodName);
$metadataForClassAndMethod = MetadataRegistry::parser()->forClassAndMethod($className, $methodName);
$backupGlobals = null;
$backupGlobalsExcludeList = [];
if ($metadataForMethod->isBackupGlobals()->isNotEmpty()) {
$metadata = $metadataForMethod->isBackupGlobals()->asArray()[0];
assert($metadata instanceof BackupGlobals);
if ($metadata->enabled()) {
$backupGlobals = true;
}
} elseif ($metadataForClass->isBackupGlobals()->isNotEmpty()) {
$metadata = $metadataForClass->isBackupGlobals()->asArray()[0];
assert($metadata instanceof BackupGlobals);
if ($metadata->enabled()) {
$backupGlobals = true;
}
}
foreach ($metadataForClassAndMethod->isExcludeGlobalVariableFromBackup() as $metadata) {
assert($metadata instanceof ExcludeGlobalVariableFromBackup);
$backupGlobalsExcludeList[] = $metadata->globalVariableName();
}
$backupStaticProperties = null;
$backupStaticPropertiesExcludeList = [];
if ($metadataForMethod->isBackupStaticProperties()->isNotEmpty()) {
$metadata = $metadataForMethod->isBackupStaticProperties()->asArray()[0];
assert($metadata instanceof BackupStaticProperties);
if ($metadata->enabled()) {
$backupStaticProperties = true;
}
} elseif ($metadataForClass->isBackupStaticProperties()->isNotEmpty()) {
$metadata = $metadataForClass->isBackupStaticProperties()->asArray()[0];
assert($metadata instanceof BackupStaticProperties);
if ($metadata->enabled()) {
$backupStaticProperties = true;
}
}
foreach ($metadataForClassAndMethod->isExcludeStaticPropertyFromBackup() as $metadata) {
assert($metadata instanceof ExcludeStaticPropertyFromBackup);
if (!isset($backupStaticPropertiesExcludeList[$metadata->className()])) {
$backupStaticPropertiesExcludeList[$metadata->className()] = [];
}
$backupStaticPropertiesExcludeList[$metadata->className()][] = $metadata->propertyName();
}
return [
'backupGlobals' => $backupGlobals,
'backupGlobalsExcludeList' => $backupGlobalsExcludeList,
'backupStaticProperties' => $backupStaticProperties,
'backupStaticPropertiesExcludeList' => $backupStaticPropertiesExcludeList,
];
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function shouldGlobalStateBePreserved(string $className, string $methodName): ?bool
{
$metadataForMethod = MetadataRegistry::parser()->forMethod($className, $methodName);
if ($metadataForMethod->isPreserveGlobalState()->isNotEmpty()) {
$metadata = $metadataForMethod->isPreserveGlobalState()->asArray()[0];
assert($metadata instanceof PreserveGlobalState);
return $metadata->enabled();
}
$metadataForClass = MetadataRegistry::parser()->forClass($className);
if ($metadataForClass->isPreserveGlobalState()->isNotEmpty()) {
$metadata = $metadataForClass->isPreserveGlobalState()->asArray()[0];
assert($metadata instanceof PreserveGlobalState);
return $metadata->enabled();
}
return null;
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function shouldTestMethodBeRunInSeparateProcess(string $className, string $methodName): bool
{
if (MetadataRegistry::parser()->forClass($className)->isRunTestsInSeparateProcesses()->isNotEmpty()) {
return true;
}
if (MetadataRegistry::parser()->forMethod($className, $methodName)->isRunInSeparateProcess()->isNotEmpty()) {
return true;
}
return false;
}
/**
* @psalm-param class-string $className
*/
private function shouldAllTestMethodsOfTestClassBeRunInSingleSeparateProcess(string $className): bool
{
return MetadataRegistry::parser()->forClass($className)->isRunClassInSeparateProcess()->isNotEmpty();
}
}
src/Framework/Test.php 0000644 00000000742 15243426620 0010727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Countable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Test extends Countable
{
public function run(): void;
}
src/Framework/TestRunner.php 0000644 00000037640 15243426620 0012130 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const PHP_EOL;
use function assert;
use function class_exists;
use function defined;
use function error_clear_last;
use function extension_loaded;
use function get_include_path;
use function hrtime;
use function serialize;
use function sprintf;
use function sys_get_temp_dir;
use function tempnam;
use function unlink;
use function var_export;
use AssertionError;
use PHPUnit\Event;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Metadata\Api\CodeCoverage as CodeCoverageMetadataApi;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Runner\CodeCoverage;
use PHPUnit\Runner\ErrorHandler;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\GlobalState;
use PHPUnit\Util\PHP\AbstractPhpProcess;
use ReflectionClass;
use SebastianBergmann\CodeCoverage\Exception as OriginalCodeCoverageException;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Invoker\Invoker;
use SebastianBergmann\Invoker\TimeoutException;
use SebastianBergmann\Template\Template;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunner
{
private ?bool $timeLimitCanBeEnforced = null;
private readonly Configuration $configuration;
public function __construct()
{
$this->configuration = ConfigurationRegistry::get();
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws CodeCoverageException
* @throws InvalidArgumentException
* @throws MoreThanOneDataSetFromDataProviderException
* @throws UnintentionallyCoveredCodeException
*/
public function run(TestCase $test): void
{
Assert::resetCount();
if ($this->configuration->registerMockObjectsFromTestArgumentsRecursively()) {
$test->registerMockObjectsFromTestArgumentsRecursively();
}
$shouldCodeCoverageBeCollected = (new CodeCoverageMetadataApi)->shouldCodeCoverageBeCollectedFor(
$test::class,
$test->name(),
);
$error = false;
$failure = false;
$incomplete = false;
$risky = false;
$skipped = false;
error_clear_last();
if ($this->shouldErrorHandlerBeUsed($test)) {
ErrorHandler::instance()->enable();
}
$collectCodeCoverage = CodeCoverage::instance()->isActive() &&
$shouldCodeCoverageBeCollected;
if ($collectCodeCoverage) {
CodeCoverage::instance()->start($test);
}
try {
if ($this->canTimeLimitBeEnforced() &&
$this->shouldTimeLimitBeEnforced($test)) {
$risky = $this->runTestWithTimeout($test);
} else {
$test->runBare();
}
} catch (AssertionFailedError $e) {
$failure = true;
if ($e instanceof IncompleteTestError) {
$incomplete = true;
} elseif ($e instanceof SkippedTest) {
$skipped = true;
}
} catch (AssertionError $e) {
$test->addToAssertionCount(1);
$failure = true;
$frame = $e->getTrace()[0];
assert(isset($frame['file']));
assert(isset($frame['line']));
$e = new AssertionFailedError(
sprintf(
'%s in %s:%s',
$e->getMessage(),
$frame['file'],
$frame['line'],
),
);
} catch (Throwable $e) {
$error = true;
}
$test->addToAssertionCount(Assert::getCount());
if ($this->configuration->reportUselessTests() &&
!$test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() === 0) {
$risky = true;
}
if (!$error && !$failure && !$incomplete && !$skipped && !$risky &&
$this->configuration->requireCoverageMetadata() &&
!$this->hasCoverageMetadata($test::class, $test->name())) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test does not define a code coverage target but is expected to do so',
);
$risky = true;
}
if ($collectCodeCoverage) {
$append = !$risky && !$incomplete && !$skipped;
$linesToBeCovered = [];
$linesToBeUsed = [];
if ($append) {
try {
$linesToBeCovered = (new CodeCoverageMetadataApi)->linesToBeCovered(
$test::class,
$test->name(),
);
$linesToBeUsed = (new CodeCoverageMetadataApi)->linesToBeUsed(
$test::class,
$test->name(),
);
} catch (InvalidCoversTargetException $cce) {
Event\Facade::emitter()->testTriggeredPhpunitWarning(
$test->valueObjectForEvents(),
$cce->getMessage(),
);
$append = false;
}
}
try {
CodeCoverage::instance()->stop(
$append,
$linesToBeCovered,
$linesToBeUsed,
);
} catch (UnintentionallyCoveredCodeException $cce) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test executed code that is not listed as code to be covered or used:' .
PHP_EOL .
$cce->getMessage(),
);
} catch (OriginalCodeCoverageException $cce) {
$error = true;
$e = $e ?? $cce;
}
}
ErrorHandler::instance()->disable();
if (!$error &&
!$incomplete &&
!$skipped &&
$this->configuration->reportUselessTests() &&
!$test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() === 0) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
'This test did not perform any assertions',
);
}
if ($test->doesNotPerformAssertions() &&
$test->numberOfAssertionsPerformed() > 0) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test is not expected to perform assertions but performed %d assertion%s',
$test->numberOfAssertionsPerformed(),
$test->numberOfAssertionsPerformed() > 1 ? 's' : '',
),
);
}
if ($test->hasUnexpectedOutput()) {
Event\Facade::emitter()->testPrintedUnexpectedOutput($test->output());
}
if ($this->configuration->disallowTestOutput() && $test->hasUnexpectedOutput()) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test printed output: %s',
$test->output(),
),
);
}
if ($test->wasPrepared()) {
Event\Facade::emitter()->testFinished(
$test->valueObjectForEvents(),
$test->numberOfAssertionsPerformed(),
);
}
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws \PHPUnit\Util\Exception
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
* @throws ProcessIsolationException
* @throws StaticAnalysisCacheNotConfiguredException
*/
public function runInSeparateProcess(TestCase $test, bool $runEntireClass, bool $preserveGlobalState): void
{
$class = new ReflectionClass($test);
if ($runEntireClass) {
$template = new Template(
__DIR__ . '/../Util/PHP/Template/TestCaseClass.tpl',
);
} else {
$template = new Template(
__DIR__ . '/../Util/PHP/Template/TestCaseMethod.tpl',
);
}
$bootstrap = '';
$constants = '';
$globals = '';
$includedFiles = '';
$iniSettings = '';
if (ConfigurationRegistry::get()->hasBootstrap()) {
$bootstrap = ConfigurationRegistry::get()->bootstrap();
}
if ($preserveGlobalState) {
$constants = GlobalState::getConstantsAsString();
$globals = GlobalState::getGlobalsAsString();
$includedFiles = GlobalState::getIncludedFilesAsString();
$iniSettings = GlobalState::getIniSettingsAsString();
}
$exportObjects = Event\Facade::emitter()->exportsObjects() ? 'true' : 'false';
$coverage = CodeCoverage::instance()->isActive() ? 'true' : 'false';
$linesToBeIgnored = var_export(CodeCoverage::instance()->linesToBeIgnored(), true);
if (defined('PHPUNIT_COMPOSER_INSTALL')) {
$composerAutoload = var_export(PHPUNIT_COMPOSER_INSTALL, true);
} else {
$composerAutoload = '\'\'';
}
if (defined('__PHPUNIT_PHAR__')) {
$phar = var_export(__PHPUNIT_PHAR__, true);
} else {
$phar = '\'\'';
}
$data = var_export(serialize($test->providedData()), true);
$dataName = var_export($test->dataName(), true);
$dependencyInput = var_export(serialize($test->dependencyInput()), true);
$includePath = var_export(get_include_path(), true);
// must do these fixes because TestCaseMethod.tpl has unserialize('{data}') in it, and we can't break BC
// the lines above used to use addcslashes() rather than var_export(), which breaks null byte escape sequences
$data = "'." . $data . ".'";
$dataName = "'.(" . $dataName . ").'";
$dependencyInput = "'." . $dependencyInput . ".'";
$includePath = "'." . $includePath . ".'";
$offset = hrtime();
$serializedConfiguration = $this->saveConfigurationForChildProcess();
$processResultFile = tempnam(sys_get_temp_dir(), 'phpunit_');
$var = [
'bootstrap' => $bootstrap,
'composerAutoload' => $composerAutoload,
'phar' => $phar,
'filename' => $class->getFileName(),
'className' => $class->getName(),
'collectCodeCoverageInformation' => $coverage,
'linesToBeIgnored' => $linesToBeIgnored,
'data' => $data,
'dataName' => $dataName,
'dependencyInput' => $dependencyInput,
'constants' => $constants,
'globals' => $globals,
'include_path' => $includePath,
'included_files' => $includedFiles,
'iniSettings' => $iniSettings,
'name' => $test->name(),
'offsetSeconds' => $offset[0],
'offsetNanoseconds' => $offset[1],
'serializedConfiguration' => $serializedConfiguration,
'processResultFile' => $processResultFile,
'exportObjects' => $exportObjects,
];
if (!$runEntireClass) {
$var['methodName'] = $test->name();
}
$template->setVar($var);
$php = AbstractPhpProcess::factory();
$php->runTestJob($template->render(), $test, $processResultFile);
@unlink($serializedConfiguration);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
private function hasCoverageMetadata(string $className, string $methodName): bool
{
foreach (MetadataRegistry::parser()->forClassAndMethod($className, $methodName) as $metadata) {
if ($metadata->isCovers()) {
return true;
}
if ($metadata->isCoversClass()) {
return true;
}
if ($metadata->isCoversFunction()) {
return true;
}
if ($metadata->isCoversNothing()) {
return true;
}
}
return false;
}
private function canTimeLimitBeEnforced(): bool
{
if ($this->timeLimitCanBeEnforced !== null) {
return $this->timeLimitCanBeEnforced;
}
if (!class_exists(Invoker::class)) {
$this->timeLimitCanBeEnforced = false;
return $this->timeLimitCanBeEnforced;
}
$this->timeLimitCanBeEnforced = (new Invoker)->canInvokeWithTimeout();
return $this->timeLimitCanBeEnforced;
}
private function shouldTimeLimitBeEnforced(TestCase $test): bool
{
if (!$this->configuration->enforceTimeLimit()) {
return false;
}
if (!(($this->configuration->defaultTimeLimit() || $test->size()->isKnown()))) {
return false;
}
if (extension_loaded('xdebug') && xdebug_is_debugger_active()) {
return false;
}
return true;
}
/**
* @throws Throwable
*/
private function runTestWithTimeout(TestCase $test): bool
{
$_timeout = $this->configuration->defaultTimeLimit();
$testSize = $test->size();
if ($testSize->isSmall()) {
$_timeout = $this->configuration->timeoutForSmallTests();
} elseif ($testSize->isMedium()) {
$_timeout = $this->configuration->timeoutForMediumTests();
} elseif ($testSize->isLarge()) {
$_timeout = $this->configuration->timeoutForLargeTests();
}
try {
(new Invoker)->invoke([$test, 'runBare'], [], $_timeout);
} catch (TimeoutException) {
Event\Facade::emitter()->testConsideredRisky(
$test->valueObjectForEvents(),
sprintf(
'This test was aborted after %d second%s',
$_timeout,
$_timeout !== 1 ? 's' : '',
),
);
return true;
}
return false;
}
/**
* @throws ProcessIsolationException
*/
private function saveConfigurationForChildProcess(): string
{
$path = tempnam(sys_get_temp_dir(), 'phpunit_');
if ($path === false) {
throw new ProcessIsolationException;
}
if (!ConfigurationRegistry::saveTo($path)) {
throw new ProcessIsolationException;
}
return $path;
}
private function shouldErrorHandlerBeUsed(TestCase $test): bool
{
if (MetadataRegistry::parser()->forMethod($test::class, $test->name())->isWithoutErrorHandler()->isNotEmpty()) {
return false;
}
return true;
}
}
src/Framework/TestStatus/TestStatus.php 0000644 00000007530 15243426620 0014260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestStatus
{
private readonly string $message;
public static function from(int $status): self
{
return match ($status) {
0 => self::success(),
1 => self::skipped(),
2 => self::incomplete(),
3 => self::notice(),
4 => self::deprecation(),
5 => self::risky(),
6 => self::warning(),
7 => self::failure(),
8 => self::error(),
default => self::unknown(),
};
}
public static function unknown(): self
{
return new Unknown;
}
public static function success(): self
{
return new Success;
}
public static function skipped(string $message = ''): self
{
return new Skipped($message);
}
public static function incomplete(string $message = ''): self
{
return new Incomplete($message);
}
public static function notice(string $message = ''): self
{
return new Notice($message);
}
public static function deprecation(string $message = ''): self
{
return new Deprecation($message);
}
public static function failure(string $message = ''): self
{
return new Failure($message);
}
public static function error(string $message = ''): self
{
return new Error($message);
}
public static function warning(string $message = ''): self
{
return new Warning($message);
}
public static function risky(string $message = ''): self
{
return new Risky($message);
}
private function __construct(string $message = '')
{
$this->message = $message;
}
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return false;
}
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return false;
}
/**
* @psalm-assert-if-true Skipped $this
*/
public function isSkipped(): bool
{
return false;
}
/**
* @psalm-assert-if-true Incomplete $this
*/
public function isIncomplete(): bool
{
return false;
}
/**
* @psalm-assert-if-true Notice $this
*/
public function isNotice(): bool
{
return false;
}
/**
* @psalm-assert-if-true Deprecation $this
*/
public function isDeprecation(): bool
{
return false;
}
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return false;
}
/**
* @psalm-assert-if-true Error $this
*/
public function isError(): bool
{
return false;
}
/**
* @psalm-assert-if-true Warning $this
*/
public function isWarning(): bool
{
return false;
}
/**
* @psalm-assert-if-true Risky $this
*/
public function isRisky(): bool
{
return false;
}
public function message(): string
{
return $this->message;
}
public function isMoreImportantThan(self $other): bool
{
return $this->asInt() > $other->asInt();
}
abstract public function asInt(): int;
abstract public function asString(): string;
}
src/Framework/TestStatus/Success.php 0000644 00000001324 15243426620 0013540 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Success extends Known
{
/**
* @psalm-assert-if-true Success $this
*/
public function isSuccess(): bool
{
return true;
}
public function asInt(): int
{
return 0;
}
public function asString(): string
{
return 'success';
}
}
src/Framework/TestStatus/Deprecation.php 0000644 00000001344 15243426620 0014367 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Deprecation extends Known
{
/**
* @psalm-assert-if-true Deprecation $this
*/
public function isDeprecation(): bool
{
return true;
}
public function asInt(): int
{
return 4;
}
public function asString(): string
{
return 'deprecation';
}
}
src/Framework/TestStatus/Known.php 0000644 00000001110 15243426620 0013215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Known extends TestStatus
{
/**
* @psalm-assert-if-true Known $this
*/
public function isKnown(): bool
{
return true;
}
}
src/Framework/TestStatus/Unknown.php 0000644 00000001332 15243426620 0013566 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Unknown extends TestStatus
{
/**
* @psalm-assert-if-true Unknown $this
*/
public function isUnknown(): bool
{
return true;
}
public function asInt(): int
{
return -1;
}
public function asString(): string
{
return 'unknown';
}
}
src/Framework/TestStatus/Incomplete.php 0000644 00000001340 15243426620 0014225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Incomplete extends Known
{
/**
* @psalm-assert-if-true Incomplete $this
*/
public function isIncomplete(): bool
{
return true;
}
public function asInt(): int
{
return 2;
}
public function asString(): string
{
return 'incomplete';
}
}
src/Framework/TestStatus/Error.php 0000644 00000001314 15243426620 0013220 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Error extends Known
{
/**
* @psalm-assert-if-true Error $this
*/
public function isError(): bool
{
return true;
}
public function asInt(): int
{
return 8;
}
public function asString(): string
{
return 'error';
}
}
src/Framework/TestStatus/Risky.php 0000644 00000001314 15243426620 0013230 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Risky extends Known
{
/**
* @psalm-assert-if-true Risky $this
*/
public function isRisky(): bool
{
return true;
}
public function asInt(): int
{
return 5;
}
public function asString(): string
{
return 'risky';
}
}
src/Framework/TestStatus/Failure.php 0000644 00000001324 15243426620 0013517 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Failure extends Known
{
/**
* @psalm-assert-if-true Failure $this
*/
public function isFailure(): bool
{
return true;
}
public function asInt(): int
{
return 7;
}
public function asString(): string
{
return 'failure';
}
}
src/Framework/TestStatus/Warning.php 0000644 00000001324 15243426620 0013535 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Warning extends Known
{
/**
* @psalm-assert-if-true Warning $this
*/
public function isWarning(): bool
{
return true;
}
public function asInt(): int
{
return 6;
}
public function asString(): string
{
return 'warning';
}
}
src/Framework/TestStatus/Skipped.php 0000644 00000001324 15243426620 0013527 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Skipped extends Known
{
/**
* @psalm-assert-if-true Skipped $this
*/
public function isSkipped(): bool
{
return true;
}
public function asInt(): int
{
return 1;
}
public function asString(): string
{
return 'skipped';
}
}
src/Framework/TestStatus/Notice.php 0000644 00000001320 15243426620 0013345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Notice extends Known
{
/**
* @psalm-assert-if-true Notice $this
*/
public function isNotice(): bool
{
return true;
}
public function asInt(): int
{
return 3;
}
public function asString(): string
{
return 'notice';
}
}
src/Framework/Assert/Functions.php 0000644 00000247316 15243426620 0013233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function func_get_args;
use function function_exists;
use ArrayAccess;
use Countable;
use PHPUnit\Framework\Constraint\ArrayHasKey;
use PHPUnit\Framework\Constraint\Callback;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\Count;
use PHPUnit\Framework\Constraint\DirectoryExists;
use PHPUnit\Framework\Constraint\FileExists;
use PHPUnit\Framework\Constraint\GreaterThan;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEmpty;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\Constraint\IsEqualCanonicalizing;
use PHPUnit\Framework\Constraint\IsEqualIgnoringCase;
use PHPUnit\Framework\Constraint\IsEqualWithDelta;
use PHPUnit\Framework\Constraint\IsFalse;
use PHPUnit\Framework\Constraint\IsFinite;
use PHPUnit\Framework\Constraint\IsIdentical;
use PHPUnit\Framework\Constraint\IsInfinite;
use PHPUnit\Framework\Constraint\IsInstanceOf;
use PHPUnit\Framework\Constraint\IsJson;
use PHPUnit\Framework\Constraint\IsList;
use PHPUnit\Framework\Constraint\IsNan;
use PHPUnit\Framework\Constraint\IsNull;
use PHPUnit\Framework\Constraint\IsReadable;
use PHPUnit\Framework\Constraint\IsTrue;
use PHPUnit\Framework\Constraint\IsType;
use PHPUnit\Framework\Constraint\IsWritable;
use PHPUnit\Framework\Constraint\LessThan;
use PHPUnit\Framework\Constraint\LogicalAnd;
use PHPUnit\Framework\Constraint\LogicalNot;
use PHPUnit\Framework\Constraint\LogicalOr;
use PHPUnit\Framework\Constraint\LogicalXor;
use PHPUnit\Framework\Constraint\ObjectEquals;
use PHPUnit\Framework\Constraint\RegularExpression;
use PHPUnit\Framework\Constraint\StringContains;
use PHPUnit\Framework\Constraint\StringEndsWith;
use PHPUnit\Framework\Constraint\StringEqualsStringIgnoringLineEndings;
use PHPUnit\Framework\Constraint\StringMatchesFormatDescription;
use PHPUnit\Framework\Constraint\StringStartsWith;
use PHPUnit\Framework\Constraint\TraversableContainsEqual;
use PHPUnit\Framework\Constraint\TraversableContainsIdentical;
use PHPUnit\Framework\Constraint\TraversableContainsOnly;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount as AnyInvokedCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastCount as InvokedAtLeastCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastOnce as InvokedAtLeastOnceMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount as InvokedAtMostCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedCount as InvokedCountMatcher;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls as ConsecutiveCallsStub;
use PHPUnit\Framework\MockObject\Stub\Exception as ExceptionStub;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument as ReturnArgumentStub;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback as ReturnCallbackStub;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf as ReturnSelfStub;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap as ReturnValueMapStub;
use PHPUnit\Util\Xml\XmlException;
use Throwable;
if (!function_exists('PHPUnit\Framework\assertArrayHasKey')) {
/**
* Asserts that an array has a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertArrayHasKey
*/
function assertArrayHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
Assert::assertArrayHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertArrayNotHasKey')) {
/**
* Asserts that an array does not have a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertArrayNotHasKey
*/
function assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
Assert::assertArrayNotHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsList')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsList
*/
function assertIsList(mixed $array, string $message = ''): void
{
Assert::assertIsList(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContains')) {
/**
* Asserts that a haystack contains a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContains
*/
function assertContains(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsEquals
*/
function assertContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertContainsEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContains')) {
/**
* Asserts that a haystack does not contain a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContains
*/
function assertNotContains(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertNotContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContainsEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContainsEquals
*/
function assertNotContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
Assert::assertNotContainsEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsOnly')) {
/**
* Asserts that a haystack contains only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsOnly
*/
function assertContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
Assert::assertContainsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertContainsOnlyInstancesOf')) {
/**
* Asserts that a haystack contains only instances of a given class name.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertContainsOnlyInstancesOf
*/
function assertContainsOnlyInstancesOf(string $className, iterable $haystack, string $message = ''): void
{
Assert::assertContainsOnlyInstancesOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotContainsOnly')) {
/**
* Asserts that a haystack does not contain only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotContainsOnly
*/
function assertNotContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
Assert::assertNotContainsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertCount')) {
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertCount
*/
function assertCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
Assert::assertCount(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotCount')) {
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotCount
*/
function assertNotCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
Assert::assertNotCount(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEquals')) {
/**
* Asserts that two variables are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEquals
*/
function assertEquals(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsCanonicalizing')) {
/**
* Asserts that two variables are equal (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsCanonicalizing
*/
function assertEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsIgnoringCase')) {
/**
* Asserts that two variables are equal (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsIgnoringCase
*/
function assertEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEqualsWithDelta')) {
/**
* Asserts that two variables are equal (with delta).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEqualsWithDelta
*/
function assertEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
Assert::assertEqualsWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEquals')) {
/**
* Asserts that two variables are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEquals
*/
function assertNotEquals(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsCanonicalizing')) {
/**
* Asserts that two variables are not equal (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsCanonicalizing
*/
function assertNotEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsIgnoringCase')) {
/**
* Asserts that two variables are not equal (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsIgnoringCase
*/
function assertNotEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEqualsWithDelta')) {
/**
* Asserts that two variables are not equal (with delta).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEqualsWithDelta
*/
function assertNotEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
Assert::assertNotEqualsWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectEquals')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectEquals
*/
function assertObjectEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
{
Assert::assertObjectEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertEmpty')) {
/**
* Asserts that a variable is empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert empty $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertEmpty
*/
function assertEmpty(mixed $actual, string $message = ''): void
{
Assert::assertEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotEmpty')) {
/**
* Asserts that a variable is not empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert !empty $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotEmpty
*/
function assertNotEmpty(mixed $actual, string $message = ''): void
{
Assert::assertNotEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertGreaterThan')) {
/**
* Asserts that a value is greater than another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertGreaterThan
*/
function assertGreaterThan(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertGreaterThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertGreaterThanOrEqual')) {
/**
* Asserts that a value is greater than or equal to another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertGreaterThanOrEqual
*/
function assertGreaterThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertGreaterThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertLessThan')) {
/**
* Asserts that a value is smaller than another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertLessThan
*/
function assertLessThan(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertLessThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertLessThanOrEqual')) {
/**
* Asserts that a value is smaller than or equal to another value.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertLessThanOrEqual
*/
function assertLessThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertLessThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEquals')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEquals
*/
function assertFileEquals(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEqualsCanonicalizing')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEqualsCanonicalizing
*/
function assertFileEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileEqualsIgnoringCase')) {
/**
* Asserts that the contents of one file is equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileEqualsIgnoringCase
*/
function assertFileEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEquals')) {
/**
* Asserts that the contents of one file is not equal to the contents of
* another file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEquals
*/
function assertFileNotEquals(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEqualsCanonicalizing')) {
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEqualsCanonicalizing
*/
function assertFileNotEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEqualsCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileNotEqualsIgnoringCase')) {
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileNotEqualsIgnoringCase
*/
function assertFileNotEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
Assert::assertFileNotEqualsIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFile')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFile
*/
function assertStringEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFileCanonicalizing')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFileCanonicalizing
*/
function assertStringEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFileCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsFileIgnoringCase')) {
/**
* Asserts that the contents of a string is equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsFileIgnoringCase
*/
function assertStringEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringEqualsFileIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFile')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFile
*/
function assertStringNotEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFileCanonicalizing')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFileCanonicalizing
*/
function assertStringNotEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFileCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotEqualsFileIgnoringCase')) {
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotEqualsFileIgnoringCase
*/
function assertStringNotEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
Assert::assertStringNotEqualsFileIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsReadable')) {
/**
* Asserts that a file/dir is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsReadable
*/
function assertIsReadable(string $filename, string $message = ''): void
{
Assert::assertIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotReadable')) {
/**
* Asserts that a file/dir exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotReadable
*/
function assertIsNotReadable(string $filename, string $message = ''): void
{
Assert::assertIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsWritable')) {
/**
* Asserts that a file/dir exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsWritable
*/
function assertIsWritable(string $filename, string $message = ''): void
{
Assert::assertIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotWritable')) {
/**
* Asserts that a file/dir exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotWritable
*/
function assertIsNotWritable(string $filename, string $message = ''): void
{
Assert::assertIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryExists')) {
/**
* Asserts that a directory exists.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryExists
*/
function assertDirectoryExists(string $directory, string $message = ''): void
{
Assert::assertDirectoryExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryDoesNotExist')) {
/**
* Asserts that a directory does not exist.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryDoesNotExist
*/
function assertDirectoryDoesNotExist(string $directory, string $message = ''): void
{
Assert::assertDirectoryDoesNotExist(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsReadable')) {
/**
* Asserts that a directory exists and is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsReadable
*/
function assertDirectoryIsReadable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsNotReadable')) {
/**
* Asserts that a directory exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsNotReadable
*/
function assertDirectoryIsNotReadable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsWritable')) {
/**
* Asserts that a directory exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsWritable
*/
function assertDirectoryIsWritable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDirectoryIsNotWritable')) {
/**
* Asserts that a directory exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDirectoryIsNotWritable
*/
function assertDirectoryIsNotWritable(string $directory, string $message = ''): void
{
Assert::assertDirectoryIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileExists')) {
/**
* Asserts that a file exists.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileExists
*/
function assertFileExists(string $filename, string $message = ''): void
{
Assert::assertFileExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileDoesNotExist')) {
/**
* Asserts that a file does not exist.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileDoesNotExist
*/
function assertFileDoesNotExist(string $filename, string $message = ''): void
{
Assert::assertFileDoesNotExist(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsReadable')) {
/**
* Asserts that a file exists and is readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsReadable
*/
function assertFileIsReadable(string $file, string $message = ''): void
{
Assert::assertFileIsReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsNotReadable')) {
/**
* Asserts that a file exists and is not readable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsNotReadable
*/
function assertFileIsNotReadable(string $file, string $message = ''): void
{
Assert::assertFileIsNotReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsWritable')) {
/**
* Asserts that a file exists and is writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsWritable
*/
function assertFileIsWritable(string $file, string $message = ''): void
{
Assert::assertFileIsWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileIsNotWritable')) {
/**
* Asserts that a file exists and is not writable.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileIsNotWritable
*/
function assertFileIsNotWritable(string $file, string $message = ''): void
{
Assert::assertFileIsNotWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertTrue')) {
/**
* Asserts that a condition is true.
*
* @throws ExpectationFailedException
*
* @psalm-assert true $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertTrue
*/
function assertTrue(mixed $condition, string $message = ''): void
{
Assert::assertTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotTrue')) {
/**
* Asserts that a condition is not true.
*
* @throws ExpectationFailedException
*
* @psalm-assert !true $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotTrue
*/
function assertNotTrue(mixed $condition, string $message = ''): void
{
Assert::assertNotTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFalse')) {
/**
* Asserts that a condition is false.
*
* @throws ExpectationFailedException
*
* @psalm-assert false $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFalse
*/
function assertFalse(mixed $condition, string $message = ''): void
{
Assert::assertFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotFalse')) {
/**
* Asserts that a condition is not false.
*
* @throws ExpectationFailedException
*
* @psalm-assert !false $condition
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotFalse
*/
function assertNotFalse(mixed $condition, string $message = ''): void
{
Assert::assertNotFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNull')) {
/**
* Asserts that a variable is null.
*
* @throws ExpectationFailedException
*
* @psalm-assert null $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNull
*/
function assertNull(mixed $actual, string $message = ''): void
{
Assert::assertNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotNull')) {
/**
* Asserts that a variable is not null.
*
* @throws ExpectationFailedException
*
* @psalm-assert !null $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotNull
*/
function assertNotNull(mixed $actual, string $message = ''): void
{
Assert::assertNotNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFinite')) {
/**
* Asserts that a variable is finite.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFinite
*/
function assertFinite(mixed $actual, string $message = ''): void
{
Assert::assertFinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertInfinite')) {
/**
* Asserts that a variable is infinite.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertInfinite
*/
function assertInfinite(mixed $actual, string $message = ''): void
{
Assert::assertInfinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNan')) {
/**
* Asserts that a variable is nan.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNan
*/
function assertNan(mixed $actual, string $message = ''): void
{
Assert::assertNan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectHasProperty')) {
/**
* Asserts that an object has a specified property.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectHasProperty
*/
function assertObjectHasProperty(string $propertyName, object $object, string $message = ''): void
{
Assert::assertObjectHasProperty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertObjectNotHasProperty')) {
/**
* Asserts that an object does not have a specified property.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertObjectNotHasProperty
*/
function assertObjectNotHasProperty(string $propertyName, object $object, string $message = ''): void
{
Assert::assertObjectNotHasProperty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertSame')) {
/**
* Asserts that two variables have the same type and value.
* Used on objects, it asserts that two variables reference
* the same object.
*
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType
*
* @psalm-param ExpectedType $expected
*
* @psalm-assert =ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertSame
*/
function assertSame(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertSame(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotSame')) {
/**
* Asserts that two variables do not have the same type and value.
* Used on objects, it asserts that two variables do not reference
* the same object.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotSame
*/
function assertNotSame(mixed $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotSame(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertInstanceOf')) {
/**
* Asserts that a variable is of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws UnknownClassOrInterfaceException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert =ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertInstanceOf
*/
function assertInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
Assert::assertInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotInstanceOf')) {
/**
* Asserts that a variable is not of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert !ExpectedType $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotInstanceOf
*/
function assertNotInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
Assert::assertNotInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsArray')) {
/**
* Asserts that a variable is of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert array $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsArray
*/
function assertIsArray(mixed $actual, string $message = ''): void
{
Assert::assertIsArray(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsBool')) {
/**
* Asserts that a variable is of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert bool $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsBool
*/
function assertIsBool(mixed $actual, string $message = ''): void
{
Assert::assertIsBool(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsFloat')) {
/**
* Asserts that a variable is of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert float $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsFloat
*/
function assertIsFloat(mixed $actual, string $message = ''): void
{
Assert::assertIsFloat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsInt')) {
/**
* Asserts that a variable is of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert int $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsInt
*/
function assertIsInt(mixed $actual, string $message = ''): void
{
Assert::assertIsInt(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNumeric')) {
/**
* Asserts that a variable is of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert numeric $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNumeric
*/
function assertIsNumeric(mixed $actual, string $message = ''): void
{
Assert::assertIsNumeric(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsObject')) {
/**
* Asserts that a variable is of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert object $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsObject
*/
function assertIsObject(mixed $actual, string $message = ''): void
{
Assert::assertIsObject(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsResource')) {
/**
* Asserts that a variable is of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsResource
*/
function assertIsResource(mixed $actual, string $message = ''): void
{
Assert::assertIsResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsClosedResource')) {
/**
* Asserts that a variable is of type resource and is closed.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsClosedResource
*/
function assertIsClosedResource(mixed $actual, string $message = ''): void
{
Assert::assertIsClosedResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsString')) {
/**
* Asserts that a variable is of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert string $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsString
*/
function assertIsString(mixed $actual, string $message = ''): void
{
Assert::assertIsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsScalar')) {
/**
* Asserts that a variable is of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert scalar $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsScalar
*/
function assertIsScalar(mixed $actual, string $message = ''): void
{
Assert::assertIsScalar(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsCallable')) {
/**
* Asserts that a variable is of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert callable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsCallable
*/
function assertIsCallable(mixed $actual, string $message = ''): void
{
Assert::assertIsCallable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsIterable')) {
/**
* Asserts that a variable is of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert iterable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsIterable
*/
function assertIsIterable(mixed $actual, string $message = ''): void
{
Assert::assertIsIterable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotArray')) {
/**
* Asserts that a variable is not of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !array $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotArray
*/
function assertIsNotArray(mixed $actual, string $message = ''): void
{
Assert::assertIsNotArray(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotBool')) {
/**
* Asserts that a variable is not of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !bool $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotBool
*/
function assertIsNotBool(mixed $actual, string $message = ''): void
{
Assert::assertIsNotBool(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotFloat')) {
/**
* Asserts that a variable is not of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !float $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotFloat
*/
function assertIsNotFloat(mixed $actual, string $message = ''): void
{
Assert::assertIsNotFloat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotInt')) {
/**
* Asserts that a variable is not of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !int $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotInt
*/
function assertIsNotInt(mixed $actual, string $message = ''): void
{
Assert::assertIsNotInt(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotNumeric')) {
/**
* Asserts that a variable is not of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !numeric $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotNumeric
*/
function assertIsNotNumeric(mixed $actual, string $message = ''): void
{
Assert::assertIsNotNumeric(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotObject')) {
/**
* Asserts that a variable is not of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !object $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotObject
*/
function assertIsNotObject(mixed $actual, string $message = ''): void
{
Assert::assertIsNotObject(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotResource')) {
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotResource
*/
function assertIsNotResource(mixed $actual, string $message = ''): void
{
Assert::assertIsNotResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotClosedResource')) {
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotClosedResource
*/
function assertIsNotClosedResource(mixed $actual, string $message = ''): void
{
Assert::assertIsNotClosedResource(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotString')) {
/**
* Asserts that a variable is not of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !string $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotString
*/
function assertIsNotString(mixed $actual, string $message = ''): void
{
Assert::assertIsNotString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotScalar')) {
/**
* Asserts that a variable is not of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !scalar $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotScalar
*/
function assertIsNotScalar(mixed $actual, string $message = ''): void
{
Assert::assertIsNotScalar(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotCallable')) {
/**
* Asserts that a variable is not of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !callable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotCallable
*/
function assertIsNotCallable(mixed $actual, string $message = ''): void
{
Assert::assertIsNotCallable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertIsNotIterable')) {
/**
* Asserts that a variable is not of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !iterable $actual
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertIsNotIterable
*/
function assertIsNotIterable(mixed $actual, string $message = ''): void
{
Assert::assertIsNotIterable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertMatchesRegularExpression')) {
/**
* Asserts that a string matches a given regular expression.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertMatchesRegularExpression
*/
function assertMatchesRegularExpression(string $pattern, string $string, string $message = ''): void
{
Assert::assertMatchesRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertDoesNotMatchRegularExpression')) {
/**
* Asserts that a string does not match a given regular expression.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertDoesNotMatchRegularExpression
*/
function assertDoesNotMatchRegularExpression(string $pattern, string $string, string $message = ''): void
{
Assert::assertDoesNotMatchRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertSameSize')) {
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertSameSize
*/
function assertSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
Assert::assertSameSize(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertNotSameSize')) {
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is not the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertNotSameSize
*/
function assertNotSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
Assert::assertNotSameSize(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsStringIgnoringLineEndings')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsStringIgnoringLineEndings
*/
function assertStringContainsStringIgnoringLineEndings(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEqualsStringIgnoringLineEndings')) {
/**
* Asserts that two strings are equal except for line endings.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEqualsStringIgnoringLineEndings
*/
function assertStringEqualsStringIgnoringLineEndings(string $expected, string $actual, string $message = ''): void
{
Assert::assertStringEqualsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileMatchesFormat')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileMatchesFormat
*/
function assertFileMatchesFormat(string $format, string $actualFile, string $message = ''): void
{
Assert::assertFileMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertFileMatchesFormatFile')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertFileMatchesFormatFile
*/
function assertFileMatchesFormatFile(string $formatFile, string $actualFile, string $message = ''): void
{
Assert::assertFileMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringMatchesFormat')) {
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringMatchesFormat
*/
function assertStringMatchesFormat(string $format, string $string, string $message = ''): void
{
Assert::assertStringMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotMatchesFormat')) {
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotMatchesFormat
*/
function assertStringNotMatchesFormat(string $format, string $string, string $message = ''): void
{
Assert::assertStringNotMatchesFormat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringMatchesFormatFile')) {
/**
* Asserts that a string matches a given format file.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringMatchesFormatFile
*/
function assertStringMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
Assert::assertStringMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotMatchesFormatFile')) {
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotMatchesFormatFile
*/
function assertStringNotMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
Assert::assertStringNotMatchesFormatFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringStartsWith')) {
/**
* Asserts that a string starts with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringStartsWith
*/
function assertStringStartsWith(string $prefix, string $string, string $message = ''): void
{
Assert::assertStringStartsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringStartsNotWith')) {
/**
* Asserts that a string starts not with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringStartsNotWith
*/
function assertStringStartsNotWith(string $prefix, string $string, string $message = ''): void
{
Assert::assertStringStartsNotWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsString')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsString
*/
function assertStringContainsString(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringContainsStringIgnoringCase')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringContainsStringIgnoringCase
*/
function assertStringContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringContainsStringIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotContainsString')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotContainsString
*/
function assertStringNotContainsString(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringNotContainsString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringNotContainsStringIgnoringCase')) {
/**
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringNotContainsStringIgnoringCase
*/
function assertStringNotContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
Assert::assertStringNotContainsStringIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEndsWith')) {
/**
* Asserts that a string ends with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEndsWith
*/
function assertStringEndsWith(string $suffix, string $string, string $message = ''): void
{
Assert::assertStringEndsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertStringEndsNotWith')) {
/**
* Asserts that a string ends not with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertStringEndsNotWith
*/
function assertStringEndsNotWith(string $suffix, string $string, string $message = ''): void
{
Assert::assertStringEndsNotWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlFileEqualsXmlFile')) {
/**
* Asserts that two XML files are equal.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlFileEqualsXmlFile
*/
function assertXmlFileEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertXmlFileEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlFileNotEqualsXmlFile')) {
/**
* Asserts that two XML files are not equal.
*
* @throws \PHPUnit\Util\Exception
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlFileNotEqualsXmlFile
*/
function assertXmlFileNotEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertXmlFileNotEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringEqualsXmlFile')) {
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringEqualsXmlFile
*/
function assertXmlStringEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringNotEqualsXmlFile')) {
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringNotEqualsXmlFile
*/
function assertXmlStringNotEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringNotEqualsXmlFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringEqualsXmlString')) {
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringEqualsXmlString
*/
function assertXmlStringEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringEqualsXmlString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertXmlStringNotEqualsXmlString')) {
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertXmlStringNotEqualsXmlString
*/
function assertXmlStringNotEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
Assert::assertXmlStringNotEqualsXmlString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertThat')) {
/**
* Evaluates a PHPUnit\Framework\Constraint matcher object.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertThat
*/
function assertThat(mixed $value, Constraint $constraint, string $message = ''): void
{
Assert::assertThat(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJson')) {
/**
* Asserts that a string is a valid JSON string.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJson
*/
function assertJson(string $actual, string $message = ''): void
{
Assert::assertJson(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringEqualsJsonString')) {
/**
* Asserts that two given JSON encoded objects or arrays are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringEqualsJsonString
*/
function assertJsonStringEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringEqualsJsonString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringNotEqualsJsonString')) {
/**
* Asserts that two given JSON encoded objects or arrays are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringNotEqualsJsonString
*/
function assertJsonStringNotEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringNotEqualsJsonString(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringEqualsJsonFile')) {
/**
* Asserts that the generated JSON encoded object and the content of the given file are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringEqualsJsonFile
*/
function assertJsonStringEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonStringNotEqualsJsonFile')) {
/**
* Asserts that the generated JSON encoded object and the content of the given file are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonStringNotEqualsJsonFile
*/
function assertJsonStringNotEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
Assert::assertJsonStringNotEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonFileEqualsJsonFile')) {
/**
* Asserts that two JSON files are equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonFileEqualsJsonFile
*/
function assertJsonFileEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertJsonFileEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\assertJsonFileNotEqualsJsonFile')) {
/**
* Asserts that two JSON files are not equal.
*
* @throws ExpectationFailedException
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @see Assert::assertJsonFileNotEqualsJsonFile
*/
function assertJsonFileNotEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
Assert::assertJsonFileNotEqualsJsonFile(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalAnd')) {
function logicalAnd(mixed ...$constraints): LogicalAnd
{
return Assert::logicalAnd(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalOr')) {
function logicalOr(mixed ...$constraints): LogicalOr
{
return Assert::logicalOr(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalNot')) {
function logicalNot(Constraint $constraint): LogicalNot
{
return Assert::logicalNot(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\logicalXor')) {
function logicalXor(mixed ...$constraints): LogicalXor
{
return Assert::logicalXor(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\anything')) {
function anything(): IsAnything
{
return Assert::anything(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isTrue')) {
function isTrue(): IsTrue
{
return Assert::isTrue(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isFalse')) {
function isFalse(): IsFalse
{
return Assert::isFalse(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isJson')) {
function isJson(): IsJson
{
return Assert::isJson(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isNull')) {
function isNull(): IsNull
{
return Assert::isNull(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isFinite')) {
function isFinite(): IsFinite
{
return Assert::isFinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isInfinite')) {
function isInfinite(): IsInfinite
{
return Assert::isInfinite(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isNan')) {
function isNan(): IsNan
{
return Assert::isNan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsEqual')) {
function containsEqual(mixed $value): TraversableContainsEqual
{
return Assert::containsEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsIdentical')) {
function containsIdentical(mixed $value): TraversableContainsIdentical
{
return Assert::containsIdentical(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsOnly')) {
function containsOnly(string $type): TraversableContainsOnly
{
return Assert::containsOnly(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\containsOnlyInstancesOf')) {
function containsOnlyInstancesOf(string $className): TraversableContainsOnly
{
return Assert::containsOnlyInstancesOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\arrayHasKey')) {
function arrayHasKey(int|string $key): ArrayHasKey
{
return Assert::arrayHasKey(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isList')) {
function isList(): IsList
{
return Assert::isList(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalTo')) {
function equalTo(mixed $value): IsEqual
{
return Assert::equalTo(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToCanonicalizing')) {
function equalToCanonicalizing(mixed $value): IsEqualCanonicalizing
{
return Assert::equalToCanonicalizing(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToIgnoringCase')) {
function equalToIgnoringCase(mixed $value): IsEqualIgnoringCase
{
return Assert::equalToIgnoringCase(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\equalToWithDelta')) {
function equalToWithDelta(mixed $value, float $delta): IsEqualWithDelta
{
return Assert::equalToWithDelta(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isEmpty')) {
function isEmpty(): IsEmpty
{
return Assert::isEmpty(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isWritable')) {
function isWritable(): IsWritable
{
return Assert::isWritable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isReadable')) {
function isReadable(): IsReadable
{
return Assert::isReadable(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\directoryExists')) {
function directoryExists(): DirectoryExists
{
return Assert::directoryExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\fileExists')) {
function fileExists(): FileExists
{
return Assert::fileExists(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\greaterThan')) {
function greaterThan(mixed $value): GreaterThan
{
return Assert::greaterThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\greaterThanOrEqual')) {
function greaterThanOrEqual(mixed $value): LogicalOr
{
return Assert::greaterThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\identicalTo')) {
function identicalTo(mixed $value): IsIdentical
{
return Assert::identicalTo(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isInstanceOf')) {
function isInstanceOf(string $className): IsInstanceOf
{
return Assert::isInstanceOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\isType')) {
function isType(string $type): IsType
{
return Assert::isType(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\lessThan')) {
function lessThan(mixed $value): LessThan
{
return Assert::lessThan(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\lessThanOrEqual')) {
function lessThanOrEqual(mixed $value): LogicalOr
{
return Assert::lessThanOrEqual(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\matchesRegularExpression')) {
function matchesRegularExpression(string $pattern): RegularExpression
{
return Assert::matchesRegularExpression(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\matches')) {
function matches(string $string): StringMatchesFormatDescription
{
return Assert::matches(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringStartsWith')) {
function stringStartsWith(string $prefix): StringStartsWith
{
return Assert::stringStartsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringContains')) {
function stringContains(string $string, bool $case = true): StringContains
{
return Assert::stringContains(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringEndsWith')) {
function stringEndsWith(string $suffix): StringEndsWith
{
return Assert::stringEndsWith(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\stringEqualsStringIgnoringLineEndings')) {
function stringEqualsStringIgnoringLineEndings(string $string): StringEqualsStringIgnoringLineEndings
{
return Assert::stringEqualsStringIgnoringLineEndings(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\countOf')) {
function countOf(int $count): Count
{
return Assert::countOf(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\objectEquals')) {
function objectEquals(object $object, string $method = 'equals'): ObjectEquals
{
return Assert::objectEquals(...func_get_args());
}
}
if (!function_exists('PHPUnit\Framework\callback')) {
/**
* @psalm-template CallbackInput of mixed
*
* @psalm-param callable(CallbackInput $callback): bool $callback
*
* @psalm-return Callback<CallbackInput>
*/
function callback(callable $callback): Callback
{
return Assert::callback($callback);
}
}
if (!function_exists('PHPUnit\Framework\any')) {
/**
* Returns a matcher that matches when the method is executed
* zero or more times.
*/
function any(): AnyInvokedCountMatcher
{
return new AnyInvokedCountMatcher;
}
}
if (!function_exists('PHPUnit\Framework\never')) {
/**
* Returns a matcher that matches when the method is never executed.
*/
function never(): InvokedCountMatcher
{
return new InvokedCountMatcher(0);
}
}
if (!function_exists('PHPUnit\Framework\atLeast')) {
/**
* Returns a matcher that matches when the method is executed
* at least N times.
*/
function atLeast(int $requiredInvocations): InvokedAtLeastCountMatcher
{
return new InvokedAtLeastCountMatcher(
$requiredInvocations,
);
}
}
if (!function_exists('PHPUnit\Framework\atLeastOnce')) {
/**
* Returns a matcher that matches when the method is executed at least once.
*/
function atLeastOnce(): InvokedAtLeastOnceMatcher
{
return new InvokedAtLeastOnceMatcher;
}
}
if (!function_exists('PHPUnit\Framework\once')) {
/**
* Returns a matcher that matches when the method is executed exactly once.
*/
function once(): InvokedCountMatcher
{
return new InvokedCountMatcher(1);
}
}
if (!function_exists('PHPUnit\Framework\exactly')) {
/**
* Returns a matcher that matches when the method is executed
* exactly $count times.
*/
function exactly(int $count): InvokedCountMatcher
{
return new InvokedCountMatcher($count);
}
}
if (!function_exists('PHPUnit\Framework\atMost')) {
/**
* Returns a matcher that matches when the method is executed
* at most N times.
*/
function atMost(int $allowedInvocations): InvokedAtMostCountMatcher
{
return new InvokedAtMostCountMatcher($allowedInvocations);
}
}
if (!function_exists('PHPUnit\Framework\returnValue')) {
function returnValue(mixed $value): ReturnStub
{
return new ReturnStub($value);
}
}
if (!function_exists('PHPUnit\Framework\returnValueMap')) {
function returnValueMap(array $valueMap): ReturnValueMapStub
{
return new ReturnValueMapStub($valueMap);
}
}
if (!function_exists('PHPUnit\Framework\returnArgument')) {
function returnArgument(int $argumentIndex): ReturnArgumentStub
{
return new ReturnArgumentStub($argumentIndex);
}
}
if (!function_exists('PHPUnit\Framework\returnCallback')) {
function returnCallback(callable $callback): ReturnCallbackStub
{
return new ReturnCallbackStub($callback);
}
}
if (!function_exists('PHPUnit\Framework\returnSelf')) {
/**
* Returns the current object.
*
* This method is useful when mocking a fluent interface.
*/
function returnSelf(): ReturnSelfStub
{
return new ReturnSelfStub;
}
}
if (!function_exists('PHPUnit\Framework\throwException')) {
function throwException(Throwable $exception): ExceptionStub
{
return new ExceptionStub($exception);
}
}
if (!function_exists('PHPUnit\Framework\onConsecutiveCalls')) {
function onConsecutiveCalls(): ConsecutiveCallsStub
{
$arguments = func_get_args();
return new ConsecutiveCallsStub($arguments);
}
}
src/Framework/Attributes/RunTestsInSeparateProcesses.php 0000644 00000001020 15243426620 0017556 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class RunTestsInSeparateProcesses
{
}
src/Framework/Attributes/DependsUsingDeepClone.php 0000644 00000001673 15243426620 0016311 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsUsingDeepClone
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/AfterClass.php 0000644 00000001000 15243426620 0014151 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class AfterClass
{
}
src/Framework/Attributes/RequiresSetting.php 0000644 00000002362 15243426620 0015273 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresSetting
{
/**
* @psalm-var non-empty-string
*/
private readonly string $setting;
/**
* @psalm-var non-empty-string
*/
private readonly string $value;
/**
* @psalm-param non-empty-string $setting
* @psalm-param non-empty-string $value
*/
public function __construct(string $setting, string $value)
{
$this->setting = $setting;
$this->value = $value;
}
/**
* @psalm-return non-empty-string
*/
public function setting(): string
{
return $this->setting;
}
/**
* @psalm-return non-empty-string
*/
public function value(): string
{
return $this->value;
}
}
src/Framework/Attributes/Test.php 0000644 00000000772 15243426620 0013060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class Test
{
}
src/Framework/Attributes/BeforeClass.php 0000644 00000001001 15243426620 0014313 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class BeforeClass
{
}
src/Framework/Attributes/DependsExternalUsingDeepClone.php 0000644 00000002412 15243426620 0020004 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternalUsingDeepClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/BackupGlobals.php 0000644 00000001360 15243426620 0014644 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class BackupGlobals
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Framework/Attributes/DependsUsingShallowClone.php 0000644 00000001676 15243426620 0017050 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsUsingShallowClone
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/RunInSeparateProcess.php 0000644 00000001012 15243426620 0016204 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class RunInSeparateProcess
{
}
src/Framework/Attributes/CoversClass.php 0000644 00000001635 15243426620 0014367 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class CoversClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/IgnoreClassForCodeCoverage.php 0000644 00000001767 15243426620 0017275 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreClassForCodeCoverage
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/DependsOnClass.php 0000644 00000001641 15243426620 0015002 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/TestWithJson.php 0000644 00000001610 15243426620 0014536 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class TestWithJson
{
/**
* @psalm-var non-empty-string
*/
private readonly string $json;
/**
* @psalm-param non-empty-string $json
*/
public function __construct(string $json)
{
$this->json = $json;
}
/**
* @psalm-return non-empty-string
*/
public function json(): string
{
return $this->json;
}
}
src/Framework/Attributes/DataProvider.php 0000644 00000001662 15243426620 0014524 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DataProvider
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/CoversNothing.php 0000644 00000001035 15243426620 0014722 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class CoversNothing
{
}
src/Framework/Attributes/Before.php 0000644 00000000774 15243426620 0013345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class Before
{
}
src/Framework/Attributes/DependsOnClassUsingDeepClone.php 0000644 00000001657 15243426620 0017576 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClassUsingDeepClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/RunClassInSeparateProcess.php 0000644 00000001016 15243426620 0017176 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class RunClassInSeparateProcess
{
}
src/Framework/Attributes/Medium.php 0000644 00000000773 15243426620 0013362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Medium
{
}
src/Framework/Attributes/RequiresOperatingSystem.php 0000644 00000001755 15243426620 0017020 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresOperatingSystem
{
/**
* @psalm-var non-empty-string
*/
private readonly string $regularExpression;
/**
* @psalm-param non-empty-string $regularExpression
*/
public function __construct(string $regularExpression)
{
$this->regularExpression = $regularExpression;
}
/**
* @psalm-return non-empty-string
*/
public function regularExpression(): string
{
return $this->regularExpression;
}
}
src/Framework/Attributes/Ticket.php 0000644 00000001634 15243426620 0013362 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Ticket
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param non-empty-string $text
*/
public function __construct(string $text)
{
$this->text = $text;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
src/Framework/Attributes/PreCondition.php 0000644 00000001002 15243426620 0014521 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class PreCondition
{
}
src/Framework/Attributes/RequiresOperatingSystemFamily.php 0000644 00000002017 15243426620 0020152 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresOperatingSystemFamily
{
/**
* @psalm-var non-empty-string
*/
private readonly string $operatingSystemFamily;
/**
* @psalm-param non-empty-string $operatingSystemFamily
*/
public function __construct(string $operatingSystemFamily)
{
$this->operatingSystemFamily = $operatingSystemFamily;
}
/**
* @psalm-return non-empty-string
*/
public function operatingSystemFamily(): string
{
return $this->operatingSystemFamily;
}
}
src/Framework/Attributes/IgnoreMethodForCodeCoverage.php 0000644 00000002522 15243426620 0017436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreMethodForCodeCoverage
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/BackupStaticProperties.php 0000644 00000001371 15243426620 0016567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class BackupStaticProperties
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Framework/Attributes/WithoutErrorHandler.php 0000644 00000001011 15243426620 0016077 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class WithoutErrorHandler
{
}
src/Framework/Attributes/TestDox.php 0000644 00000001602 15243426620 0013524 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class TestDox
{
/**
* @psalm-var non-empty-string
*/
private readonly string $text;
/**
* @psalm-param non-empty-string $text
*/
public function __construct(string $text)
{
$this->text = $text;
}
/**
* @psalm-return non-empty-string
*/
public function text(): string
{
return $this->text;
}
}
src/Framework/Attributes/RequiresFunction.php 0000644 00000001736 15243426620 0015447 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Framework/Attributes/UsesFunction.php 0000644 00000001677 15243426620 0014573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class UsesFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Framework/Attributes/UsesClass.php 0000644 00000001633 15243426620 0014043 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class UsesClass
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/After.php 0000644 00000000773 15243426620 0013203 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class After
{
}
src/Framework/Attributes/Group.php 0000644 00000001633 15243426620 0013232 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Group
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
/**
* @psalm-param non-empty-string $name
*/
public function __construct(string $name)
{
$this->name = $name;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
}
src/Framework/Attributes/Small.php 0000644 00000000772 15243426620 0013211 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Small
{
}
src/Framework/Attributes/ExcludeGlobalVariableFromBackup.php 0000644 00000002027 15243426620 0020266 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class ExcludeGlobalVariableFromBackup
{
/**
* @psalm-var non-empty-string
*/
private readonly string $globalVariableName;
/**
* @psalm-param non-empty-string $globalVariableName
*/
public function __construct(string $globalVariableName)
{
$this->globalVariableName = $globalVariableName;
}
/**
* @psalm-return non-empty-string
*/
public function globalVariableName(): string
{
return $this->globalVariableName;
}
}
src/Framework/Attributes/IgnoreDeprecations.php 0000644 00000001042 15243426620 0015714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class IgnoreDeprecations
{
}
src/Framework/Attributes/DoesNotPerformAssertions.php 0000644 00000001050 15243426620 0017110 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class DoesNotPerformAssertions
{
}
src/Framework/Attributes/Depends.php 0000644 00000001655 15243426620 0013524 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class Depends
{
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/PostCondition.php 0000644 00000001003 15243426620 0014721 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD)]
final class PostCondition
{
}
src/Framework/Attributes/PreserveGlobalState.php 0000644 00000001366 15243426620 0016056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class PreserveGlobalState
{
private readonly bool $enabled;
public function __construct(bool $enabled)
{
$this->enabled = $enabled;
}
public function enabled(): bool
{
return $this->enabled;
}
}
src/Framework/Attributes/RequiresMethod.php 0000644 00000002425 15243426620 0015076 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresMethod
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/IgnoreFunctionForCodeCoverage.php 0000644 00000002033 15243426620 0020000 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5513
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class IgnoreFunctionForCodeCoverage
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Framework/Attributes/Large.php 0000644 00000000772 15243426620 0013173 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS)]
final class Large
{
}
src/Framework/Attributes/CodeCoverageIgnore.php 0000644 00000001155 15243426620 0015627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5236
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class CodeCoverageIgnore
{
}
src/Framework/Attributes/DataProviderExternal.php 0000644 00000002401 15243426620 0016217 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DataProviderExternal
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/TestWith.php 0000644 00000001335 15243426620 0013710 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class TestWith
{
private readonly array $data;
public function __construct(array $data)
{
$this->data = $data;
}
public function data(): array
{
return $this->data;
}
}
src/Framework/Attributes/RequiresPhpExtension.php 0000644 00000002600 15243426620 0016275 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class RequiresPhpExtension
{
/**
* @psalm-var non-empty-string
*/
private readonly string $extension;
/**
* @psalm-var null|non-empty-string
*/
private readonly ?string $versionRequirement;
/**
* @psalm-param non-empty-string $extension
* @psalm-param null|non-empty-string $versionRequirement
*/
public function __construct(string $extension, ?string $versionRequirement = null)
{
$this->extension = $extension;
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function extension(): string
{
return $this->extension;
}
/**
* @psalm-return null|non-empty-string
*/
public function versionRequirement(): ?string
{
return $this->versionRequirement;
}
}
src/Framework/Attributes/RequiresPhpunit.php 0000644 00000001754 15243426620 0015311 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresPhpunit
{
/**
* @psalm-var non-empty-string
*/
private readonly string $versionRequirement;
/**
* @psalm-param non-empty-string $versionRequirement
*/
public function __construct(string $versionRequirement)
{
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function versionRequirement(): string
{
return $this->versionRequirement;
}
}
src/Framework/Attributes/ExcludeStaticPropertyFromBackup.php 0000644 00000002466 15243426620 0020423 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class ExcludeStaticPropertyFromBackup
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $propertyName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $propertyName
*/
public function __construct(string $className, string $propertyName)
{
$this->className = $className;
$this->propertyName = $propertyName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function propertyName(): string
{
return $this->propertyName;
}
}
src/Framework/Attributes/CoversFunction.php 0000644 00000001701 15243426620 0015101 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
final class CoversFunction
{
/**
* @psalm-var non-empty-string
*/
private readonly string $functionName;
/**
* @psalm-param non-empty-string $functionName
*/
public function __construct(string $functionName)
{
$this->functionName = $functionName;
}
/**
* @psalm-return non-empty-string
*/
public function functionName(): string
{
return $this->functionName;
}
}
src/Framework/Attributes/RequiresPhp.php 0000644 00000001750 15243426620 0014405 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
final class RequiresPhp
{
/**
* @psalm-var non-empty-string
*/
private readonly string $versionRequirement;
/**
* @psalm-param non-empty-string $versionRequirement
*/
public function __construct(string $versionRequirement)
{
$this->versionRequirement = $versionRequirement;
}
/**
* @psalm-return non-empty-string
*/
public function versionRequirement(): string
{
return $this->versionRequirement;
}
}
src/Framework/Attributes/DependsOnClassUsingShallowClone.php 0000644 00000001662 15243426620 0020326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsOnClassUsingShallowClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-param class-string $className
*/
public function __construct(string $className)
{
$this->className = $className;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
}
src/Framework/Attributes/DependsExternal.php 0000644 00000002374 15243426620 0015226 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternal
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Attributes/DependsExternalUsingShallowClone.php 0000644 00000002415 15243426620 0020543 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Attributes;
use Attribute;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
final class DependsExternalUsingShallowClone
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
$this->className = $className;
$this->methodName = $methodName;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
}
src/Framework/Assert.php 0000644 00000205623 15243426620 0011256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function class_exists;
use function count;
use function file_get_contents;
use function interface_exists;
use function is_bool;
use ArrayAccess;
use Countable;
use Generator;
use PHPUnit\Event;
use PHPUnit\Framework\Constraint\ArrayHasKey;
use PHPUnit\Framework\Constraint\Callback;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\Count;
use PHPUnit\Framework\Constraint\DirectoryExists;
use PHPUnit\Framework\Constraint\FileExists;
use PHPUnit\Framework\Constraint\GreaterThan;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEmpty;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\Constraint\IsEqualCanonicalizing;
use PHPUnit\Framework\Constraint\IsEqualIgnoringCase;
use PHPUnit\Framework\Constraint\IsEqualWithDelta;
use PHPUnit\Framework\Constraint\IsFalse;
use PHPUnit\Framework\Constraint\IsFinite;
use PHPUnit\Framework\Constraint\IsIdentical;
use PHPUnit\Framework\Constraint\IsInfinite;
use PHPUnit\Framework\Constraint\IsInstanceOf;
use PHPUnit\Framework\Constraint\IsJson;
use PHPUnit\Framework\Constraint\IsList;
use PHPUnit\Framework\Constraint\IsNan;
use PHPUnit\Framework\Constraint\IsNull;
use PHPUnit\Framework\Constraint\IsReadable;
use PHPUnit\Framework\Constraint\IsTrue;
use PHPUnit\Framework\Constraint\IsType;
use PHPUnit\Framework\Constraint\IsWritable;
use PHPUnit\Framework\Constraint\JsonMatches;
use PHPUnit\Framework\Constraint\LessThan;
use PHPUnit\Framework\Constraint\LogicalAnd;
use PHPUnit\Framework\Constraint\LogicalNot;
use PHPUnit\Framework\Constraint\LogicalOr;
use PHPUnit\Framework\Constraint\LogicalXor;
use PHPUnit\Framework\Constraint\ObjectEquals;
use PHPUnit\Framework\Constraint\ObjectHasProperty;
use PHPUnit\Framework\Constraint\RegularExpression;
use PHPUnit\Framework\Constraint\SameSize;
use PHPUnit\Framework\Constraint\StringContains;
use PHPUnit\Framework\Constraint\StringEndsWith;
use PHPUnit\Framework\Constraint\StringEqualsStringIgnoringLineEndings;
use PHPUnit\Framework\Constraint\StringMatchesFormatDescription;
use PHPUnit\Framework\Constraint\StringStartsWith;
use PHPUnit\Framework\Constraint\TraversableContainsEqual;
use PHPUnit\Framework\Constraint\TraversableContainsIdentical;
use PHPUnit\Framework\Constraint\TraversableContainsOnly;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Assert
{
private static int $count = 0;
/**
* Asserts that an array has a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertArrayHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
$constraint = new ArrayHasKey($key);
static::assertThat($array, $constraint, $message);
}
/**
* Asserts that an array does not have a specified key.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
{
$constraint = new LogicalNot(
new ArrayHasKey($key),
);
static::assertThat($array, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertIsList(mixed $array, string $message = ''): void
{
static::assertThat(
$array,
new IsList,
$message,
);
}
/**
* Asserts that a haystack contains a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContains(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new TraversableContainsIdentical($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new TraversableContainsEqual($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a haystack does not contain a needle.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertNotContains(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new LogicalNot(
new TraversableContainsIdentical($needle),
);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertNotContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new TraversableContainsEqual($needle));
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a haystack contains only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
if ($isNativeType === null) {
$isNativeType = self::isNativeType($type);
}
static::assertThat(
$haystack,
new TraversableContainsOnly(
$type,
$isNativeType,
),
$message,
);
}
/**
* Asserts that a haystack contains only instances of a given class name.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertContainsOnlyInstancesOf(string $className, iterable $haystack, string $message = ''): void
{
static::assertThat(
$haystack,
new TraversableContainsOnly(
$className,
false,
),
$message,
);
}
/**
* Asserts that a haystack does not contain only values of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*/
final public static function assertNotContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
{
if ($isNativeType === null) {
$isNativeType = self::isNativeType($type);
}
static::assertThat(
$haystack,
new LogicalNot(
new TraversableContainsOnly(
$type,
$isNativeType,
),
),
$message,
);
}
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
if ($haystack instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$haystack');
}
static::assertThat(
$haystack,
new Count($expectedCount),
$message,
);
}
/**
* Asserts the number of elements of an array, Countable or Traversable.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertNotCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
{
if ($haystack instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$haystack');
}
$constraint = new LogicalNot(
new Count($expectedCount),
);
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that two variables are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertEquals(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqual($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqualCanonicalizing($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new IsEqualIgnoringCase($expected);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are equal (with delta).
*
* @throws ExpectationFailedException
*/
final public static function assertEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
$constraint = new IsEqualWithDelta(
$expected,
$delta,
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertNotEquals(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqual($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualCanonicalizing($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualIgnoringCase($expected),
);
static::assertThat($actual, $constraint, $message);
}
/**
* Asserts that two variables are not equal (with delta).
*
* @throws ExpectationFailedException
*/
final public static function assertNotEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
{
$constraint = new LogicalNot(
new IsEqualWithDelta(
$expected,
$delta,
),
);
static::assertThat($actual, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertObjectEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
{
static::assertThat(
$actual,
static::objectEquals($expected, $method),
$message,
);
}
/**
* Asserts that a variable is empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert empty $actual
*/
final public static function assertEmpty(mixed $actual, string $message = ''): void
{
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat($actual, static::isEmpty(), $message);
}
/**
* Asserts that a variable is not empty.
*
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*
* @psalm-assert !empty $actual
*/
final public static function assertNotEmpty(mixed $actual, string $message = ''): void
{
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat($actual, static::logicalNot(static::isEmpty()), $message);
}
/**
* Asserts that a value is greater than another value.
*
* @throws ExpectationFailedException
*/
final public static function assertGreaterThan(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::greaterThan($expected), $message);
}
/**
* Asserts that a value is greater than or equal to another value.
*
* @throws ExpectationFailedException
*/
final public static function assertGreaterThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
static::greaterThanOrEqual($expected),
$message,
);
}
/**
* Asserts that a value is smaller than another value.
*
* @throws ExpectationFailedException
*/
final public static function assertLessThan(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::lessThan($expected), $message);
}
/**
* Asserts that a value is smaller than or equal to another value.
*
* @throws ExpectationFailedException
*/
final public static function assertLessThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::lessThanOrEqual($expected), $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file.
*
* @throws ExpectationFailedException
*/
final public static function assertFileEquals(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqual(file_get_contents($expected));
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertFileEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqualCanonicalizing(
file_get_contents($expected),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertFileEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new IsEqualIgnoringCase(file_get_contents($expected));
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of
* another file.
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEquals(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqual(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqualCanonicalizing(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of one file is not equal to the contents of another
* file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertFileNotEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
{
static::assertFileExists($expected, $message);
static::assertFileExists($actual, $message);
$constraint = new LogicalNot(
new IsEqualIgnoringCase(file_get_contents($expected)),
);
static::assertThat(file_get_contents($actual), $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqual(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqualCanonicalizing(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new IsEqualIgnoringCase(file_get_contents($expectedFile));
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqual(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (canonicalizing).
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqualCanonicalizing(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that the contents of a string is not equal
* to the contents of a file (ignoring case).
*
* @throws ExpectationFailedException
*/
final public static function assertStringNotEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$constraint = new LogicalNot(
new IsEqualIgnoringCase(file_get_contents($expectedFile)),
);
static::assertThat($actualString, $constraint, $message);
}
/**
* Asserts that a file/dir is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsReadable(string $filename, string $message = ''): void
{
static::assertThat($filename, new IsReadable, $message);
}
/**
* Asserts that a file/dir exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsNotReadable(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new IsReadable), $message);
}
/**
* Asserts that a file/dir exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsWritable(string $filename, string $message = ''): void
{
static::assertThat($filename, new IsWritable, $message);
}
/**
* Asserts that a file/dir exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertIsNotWritable(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new IsWritable), $message);
}
/**
* Asserts that a directory exists.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryExists(string $directory, string $message = ''): void
{
static::assertThat($directory, new DirectoryExists, $message);
}
/**
* Asserts that a directory does not exist.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryDoesNotExist(string $directory, string $message = ''): void
{
static::assertThat($directory, new LogicalNot(new DirectoryExists), $message);
}
/**
* Asserts that a directory exists and is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsReadable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsReadable($directory, $message);
}
/**
* Asserts that a directory exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsNotReadable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsNotReadable($directory, $message);
}
/**
* Asserts that a directory exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsWritable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsWritable($directory, $message);
}
/**
* Asserts that a directory exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertDirectoryIsNotWritable(string $directory, string $message = ''): void
{
self::assertDirectoryExists($directory, $message);
self::assertIsNotWritable($directory, $message);
}
/**
* Asserts that a file exists.
*
* @throws ExpectationFailedException
*/
final public static function assertFileExists(string $filename, string $message = ''): void
{
static::assertThat($filename, new FileExists, $message);
}
/**
* Asserts that a file does not exist.
*
* @throws ExpectationFailedException
*/
final public static function assertFileDoesNotExist(string $filename, string $message = ''): void
{
static::assertThat($filename, new LogicalNot(new FileExists), $message);
}
/**
* Asserts that a file exists and is readable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsReadable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsReadable($file, $message);
}
/**
* Asserts that a file exists and is not readable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsNotReadable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsNotReadable($file, $message);
}
/**
* Asserts that a file exists and is writable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsWritable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsWritable($file, $message);
}
/**
* Asserts that a file exists and is not writable.
*
* @throws ExpectationFailedException
*/
final public static function assertFileIsNotWritable(string $file, string $message = ''): void
{
self::assertFileExists($file, $message);
self::assertIsNotWritable($file, $message);
}
/**
* Asserts that a condition is true.
*
* @throws ExpectationFailedException
*
* @psalm-assert true $condition
*/
final public static function assertTrue(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::isTrue(), $message);
}
/**
* Asserts that a condition is not true.
*
* @throws ExpectationFailedException
*
* @psalm-assert !true $condition
*/
final public static function assertNotTrue(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::logicalNot(static::isTrue()), $message);
}
/**
* Asserts that a condition is false.
*
* @throws ExpectationFailedException
*
* @psalm-assert false $condition
*/
final public static function assertFalse(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::isFalse(), $message);
}
/**
* Asserts that a condition is not false.
*
* @throws ExpectationFailedException
*
* @psalm-assert !false $condition
*/
final public static function assertNotFalse(mixed $condition, string $message = ''): void
{
static::assertThat($condition, static::logicalNot(static::isFalse()), $message);
}
/**
* Asserts that a variable is null.
*
* @throws ExpectationFailedException
*
* @psalm-assert null $actual
*/
final public static function assertNull(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isNull(), $message);
}
/**
* Asserts that a variable is not null.
*
* @throws ExpectationFailedException
*
* @psalm-assert !null $actual
*/
final public static function assertNotNull(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::logicalNot(static::isNull()), $message);
}
/**
* Asserts that a variable is finite.
*
* @throws ExpectationFailedException
*/
final public static function assertFinite(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isFinite(), $message);
}
/**
* Asserts that a variable is infinite.
*
* @throws ExpectationFailedException
*/
final public static function assertInfinite(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isInfinite(), $message);
}
/**
* Asserts that a variable is nan.
*
* @throws ExpectationFailedException
*/
final public static function assertNan(mixed $actual, string $message = ''): void
{
static::assertThat($actual, static::isNan(), $message);
}
/**
* Asserts that an object has a specified property.
*
* @throws ExpectationFailedException
*/
final public static function assertObjectHasProperty(string $propertyName, object $object, string $message = ''): void
{
static::assertThat(
$object,
new ObjectHasProperty($propertyName),
$message,
);
}
/**
* Asserts that an object does not have a specified property.
*
* @throws ExpectationFailedException
*/
final public static function assertObjectNotHasProperty(string $propertyName, object $object, string $message = ''): void
{
static::assertThat(
$object,
new LogicalNot(
new ObjectHasProperty($propertyName),
),
$message,
);
}
/**
* Asserts that two variables have the same type and value.
* Used on objects, it asserts that two variables reference
* the same object.
*
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType
*
* @psalm-param ExpectedType $expected
*
* @psalm-assert =ExpectedType $actual
*/
final public static function assertSame(mixed $expected, mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsIdentical($expected),
$message,
);
}
/**
* Asserts that two variables do not have the same type and value.
* Used on objects, it asserts that two variables do not reference
* the same object.
*
* @throws ExpectationFailedException
*/
final public static function assertNotSame(mixed $expected, mixed $actual, string $message = ''): void
{
if (is_bool($expected) && is_bool($actual)) {
static::assertNotEquals($expected, $actual, $message);
}
static::assertThat(
$actual,
new LogicalNot(
new IsIdentical($expected),
),
$message,
);
}
/**
* Asserts that a variable is of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws UnknownClassOrInterfaceException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert =ExpectedType $actual
*/
final public static function assertInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
if (!class_exists($expected) && !interface_exists($expected)) {
throw new UnknownClassOrInterfaceException($expected);
}
static::assertThat(
$actual,
new IsInstanceOf($expected),
$message,
);
}
/**
* Asserts that a variable is not of a given type.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-template ExpectedType of object
*
* @psalm-param class-string<ExpectedType> $expected
*
* @psalm-assert !ExpectedType $actual
*/
final public static function assertNotInstanceOf(string $expected, mixed $actual, string $message = ''): void
{
if (!class_exists($expected) && !interface_exists($expected)) {
throw new UnknownClassOrInterfaceException($expected);
}
static::assertThat(
$actual,
new LogicalNot(
new IsInstanceOf($expected),
),
$message,
);
}
/**
* Asserts that a variable is of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert array $actual
*/
final public static function assertIsArray(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_ARRAY),
$message,
);
}
/**
* Asserts that a variable is of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert bool $actual
*/
final public static function assertIsBool(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_BOOL),
$message,
);
}
/**
* Asserts that a variable is of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert float $actual
*/
final public static function assertIsFloat(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_FLOAT),
$message,
);
}
/**
* Asserts that a variable is of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert int $actual
*/
final public static function assertIsInt(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_INT),
$message,
);
}
/**
* Asserts that a variable is of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert numeric $actual
*/
final public static function assertIsNumeric(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_NUMERIC),
$message,
);
}
/**
* Asserts that a variable is of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert object $actual
*/
final public static function assertIsObject(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_OBJECT),
$message,
);
}
/**
* Asserts that a variable is of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*/
final public static function assertIsResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_RESOURCE),
$message,
);
}
/**
* Asserts that a variable is of type resource and is closed.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert resource $actual
*/
final public static function assertIsClosedResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_CLOSED_RESOURCE),
$message,
);
}
/**
* Asserts that a variable is of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert string $actual
*/
final public static function assertIsString(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_STRING),
$message,
);
}
/**
* Asserts that a variable is of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert scalar $actual
*/
final public static function assertIsScalar(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_SCALAR),
$message,
);
}
/**
* Asserts that a variable is of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert callable $actual
*/
final public static function assertIsCallable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_CALLABLE),
$message,
);
}
/**
* Asserts that a variable is of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert iterable $actual
*/
final public static function assertIsIterable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new IsType(IsType::TYPE_ITERABLE),
$message,
);
}
/**
* Asserts that a variable is not of type array.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !array $actual
*/
final public static function assertIsNotArray(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_ARRAY)),
$message,
);
}
/**
* Asserts that a variable is not of type bool.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !bool $actual
*/
final public static function assertIsNotBool(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_BOOL)),
$message,
);
}
/**
* Asserts that a variable is not of type float.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !float $actual
*/
final public static function assertIsNotFloat(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_FLOAT)),
$message,
);
}
/**
* Asserts that a variable is not of type int.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !int $actual
*/
final public static function assertIsNotInt(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_INT)),
$message,
);
}
/**
* Asserts that a variable is not of type numeric.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !numeric $actual
*/
final public static function assertIsNotNumeric(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_NUMERIC)),
$message,
);
}
/**
* Asserts that a variable is not of type object.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !object $actual
*/
final public static function assertIsNotObject(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_OBJECT)),
$message,
);
}
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*/
final public static function assertIsNotResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_RESOURCE)),
$message,
);
}
/**
* Asserts that a variable is not of type resource.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !resource $actual
*/
final public static function assertIsNotClosedResource(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_CLOSED_RESOURCE)),
$message,
);
}
/**
* Asserts that a variable is not of type string.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !string $actual
*/
final public static function assertIsNotString(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_STRING)),
$message,
);
}
/**
* Asserts that a variable is not of type scalar.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !scalar $actual
*/
final public static function assertIsNotScalar(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_SCALAR)),
$message,
);
}
/**
* Asserts that a variable is not of type callable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !callable $actual
*/
final public static function assertIsNotCallable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_CALLABLE)),
$message,
);
}
/**
* Asserts that a variable is not of type iterable.
*
* @throws Exception
* @throws ExpectationFailedException
*
* @psalm-assert !iterable $actual
*/
final public static function assertIsNotIterable(mixed $actual, string $message = ''): void
{
static::assertThat(
$actual,
new LogicalNot(new IsType(IsType::TYPE_ITERABLE)),
$message,
);
}
/**
* Asserts that a string matches a given regular expression.
*
* @throws ExpectationFailedException
*/
final public static function assertMatchesRegularExpression(string $pattern, string $string, string $message = ''): void
{
static::assertThat($string, new RegularExpression($pattern), $message);
}
/**
* Asserts that a string does not match a given regular expression.
*
* @throws ExpectationFailedException
*/
final public static function assertDoesNotMatchRegularExpression(string $pattern, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new RegularExpression($pattern),
),
$message,
);
}
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
if ($expected instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$expected');
}
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat(
$actual,
new SameSize($expected),
$message,
);
}
/**
* Assert that the size of two arrays (or `Countable` or `Traversable` objects)
* is not the same.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws GeneratorNotSupportedException
*/
final public static function assertNotSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
{
if ($expected instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$expected');
}
if ($actual instanceof Generator) {
throw GeneratorNotSupportedException::fromParameterName('$actual');
}
static::assertThat(
$actual,
new LogicalNot(
new SameSize($expected),
),
$message,
);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsStringIgnoringLineEndings(string $needle, string $haystack, string $message = ''): void
{
static::assertThat($haystack, new StringContains($needle, false, true), $message);
}
/**
* Asserts that two strings are equal except for line endings.
*
* @throws ExpectationFailedException
*/
final public static function assertStringEqualsStringIgnoringLineEndings(string $expected, string $actual, string $message = ''): void
{
static::assertThat($actual, new StringEqualsStringIgnoringLineEndings($expected), $message);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertFileMatchesFormat(string $format, string $actualFile, string $message = ''): void
{
static::assertFileExists($actualFile, $message);
static::assertThat(
file_get_contents($actualFile),
new StringMatchesFormatDescription($format),
$message,
);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertFileMatchesFormatFile(string $formatFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertFileExists($actualFile, $message);
static::assertThat(
file_get_contents($actualFile),
new StringMatchesFormatDescription(file_get_contents($formatFile)),
$message,
);
}
/**
* Asserts that a string matches a given format string.
*
* @throws ExpectationFailedException
*/
final public static function assertStringMatchesFormat(string $format, string $string, string $message = ''): void
{
static::assertThat($string, new StringMatchesFormatDescription($format), $message);
}
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*/
final public static function assertStringNotMatchesFormat(string $format, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringMatchesFormatDescription($format),
),
$message,
);
}
/**
* Asserts that a string matches a given format file.
*
* @throws ExpectationFailedException
*/
final public static function assertStringMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertThat(
$string,
new StringMatchesFormatDescription(
file_get_contents($formatFile),
),
$message,
);
}
/**
* Asserts that a string does not match a given format string.
*
* @throws ExpectationFailedException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5472
*/
final public static function assertStringNotMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
{
static::assertFileExists($formatFile, $message);
static::assertThat(
$string,
new LogicalNot(
new StringMatchesFormatDescription(
file_get_contents($formatFile),
),
),
$message,
);
}
/**
* Asserts that a string starts with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringStartsWith(string $prefix, string $string, string $message = ''): void
{
static::assertThat($string, new StringStartsWith($prefix), $message);
}
/**
* Asserts that a string starts not with a given prefix.
*
* @psalm-param non-empty-string $prefix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringStartsNotWith(string $prefix, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringStartsWith($prefix),
),
$message,
);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsString(string $needle, string $haystack, string $message = ''): void
{
$constraint = new StringContains($needle);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
$constraint = new StringContains($needle, true);
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringNotContainsString(string $needle, string $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new StringContains($needle));
static::assertThat($haystack, $constraint, $message);
}
/**
* @throws ExpectationFailedException
*/
final public static function assertStringNotContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
{
$constraint = new LogicalNot(new StringContains($needle, true));
static::assertThat($haystack, $constraint, $message);
}
/**
* Asserts that a string ends with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringEndsWith(string $suffix, string $string, string $message = ''): void
{
static::assertThat($string, new StringEndsWith($suffix), $message);
}
/**
* Asserts that a string ends not with a given suffix.
*
* @psalm-param non-empty-string $suffix
*
* @throws ExpectationFailedException
* @throws InvalidArgumentException
*/
final public static function assertStringEndsNotWith(string $suffix, string $string, string $message = ''): void
{
static::assertThat(
$string,
new LogicalNot(
new StringEndsWith($suffix),
),
$message,
);
}
/**
* Asserts that two XML files are equal.
*
* @throws Exception
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlFileEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->loadFile($actualFile);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML files are not equal.
*
* @throws \PHPUnit\Util\Exception
* @throws ExpectationFailedException
*/
final public static function assertXmlFileNotEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->loadFile($actualFile);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->load($actualXml);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringNotEqualsXmlFile(string $expectedFile, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->loadFile($expectedFile);
$actual = (new XmlLoader)->load($actualXml);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->load($expectedXml);
$actual = (new XmlLoader)->load($actualXml);
static::assertEquals($expected, $actual, $message);
}
/**
* Asserts that two XML documents are not equal.
*
* @throws ExpectationFailedException
* @throws XmlException
*/
final public static function assertXmlStringNotEqualsXmlString(string $expectedXml, string $actualXml, string $message = ''): void
{
$expected = (new XmlLoader)->load($expectedXml);
$actual = (new XmlLoader)->load($actualXml);
static::assertNotEquals($expected, $actual, $message);
}
/**
* Evaluates a PHPUnit\Framework\Constraint matcher object.
*
* @throws ExpectationFailedException
*/
final public static function assertThat(mixed $value, Constraint $constraint, string $message = ''): void
{
self::$count += count($constraint);
$hasFailed = true;
try {
$constraint->evaluate($value, $message);
$hasFailed = false;
} finally {
if ($hasFailed) {
Event\Facade::emitter()->testAssertionFailed(
$value,
$constraint,
$message,
);
} else {
Event\Facade::emitter()->testAssertionSucceeded(
$value,
$constraint,
$message,
);
}
}
}
/**
* Asserts that a string is a valid JSON string.
*
* @throws ExpectationFailedException
*/
final public static function assertJson(string $actual, string $message = ''): void
{
static::assertThat($actual, static::isJson(), $message);
}
/**
* Asserts that two given JSON encoded objects or arrays are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat($actualJson, new JsonMatches($expectedJson), $message);
}
/**
* Asserts that two given JSON encoded objects or arrays are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringNotEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
{
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat(
$actualJson,
new LogicalNot(
new JsonMatches($expectedJson),
),
$message,
);
}
/**
* Asserts that the generated JSON encoded object and the content of the given file are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat($actualJson, new JsonMatches($expectedJson), $message);
}
/**
* Asserts that the generated JSON encoded object and the content of the given file are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonStringNotEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
static::assertThat(
$actualJson,
new LogicalNot(
new JsonMatches($expectedJson),
),
$message,
);
}
/**
* Asserts that two JSON files are equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonFileEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
static::assertFileExists($actualFile, $message);
$actualJson = file_get_contents($actualFile);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
$constraintExpected = new JsonMatches(
$expectedJson,
);
$constraintActual = new JsonMatches($actualJson);
static::assertThat($expectedJson, $constraintActual, $message);
static::assertThat($actualJson, $constraintExpected, $message);
}
/**
* Asserts that two JSON files are not equal.
*
* @throws ExpectationFailedException
*/
final public static function assertJsonFileNotEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
{
static::assertFileExists($expectedFile, $message);
static::assertFileExists($actualFile, $message);
$actualJson = file_get_contents($actualFile);
$expectedJson = file_get_contents($expectedFile);
static::assertJson($expectedJson, $message);
static::assertJson($actualJson, $message);
$constraintExpected = new JsonMatches(
$expectedJson,
);
$constraintActual = new JsonMatches($actualJson);
static::assertThat($expectedJson, new LogicalNot($constraintActual), $message);
static::assertThat($actualJson, new LogicalNot($constraintExpected), $message);
}
/**
* @throws Exception
*/
final public static function logicalAnd(mixed ...$constraints): LogicalAnd
{
return LogicalAnd::fromConstraints(...$constraints);
}
final public static function logicalOr(mixed ...$constraints): LogicalOr
{
return LogicalOr::fromConstraints(...$constraints);
}
final public static function logicalNot(Constraint $constraint): LogicalNot
{
return new LogicalNot($constraint);
}
final public static function logicalXor(mixed ...$constraints): LogicalXor
{
return LogicalXor::fromConstraints(...$constraints);
}
final public static function anything(): IsAnything
{
return new IsAnything;
}
final public static function isTrue(): IsTrue
{
return new IsTrue;
}
/**
* @psalm-template CallbackInput of mixed
*
* @psalm-param callable(CallbackInput $callback): bool $callback
*
* @psalm-return Callback<CallbackInput>
*/
final public static function callback(callable $callback): Callback
{
return new Callback($callback);
}
final public static function isFalse(): IsFalse
{
return new IsFalse;
}
final public static function isJson(): IsJson
{
return new IsJson;
}
final public static function isNull(): IsNull
{
return new IsNull;
}
final public static function isFinite(): IsFinite
{
return new IsFinite;
}
final public static function isInfinite(): IsInfinite
{
return new IsInfinite;
}
final public static function isNan(): IsNan
{
return new IsNan;
}
final public static function containsEqual(mixed $value): TraversableContainsEqual
{
return new TraversableContainsEqual($value);
}
final public static function containsIdentical(mixed $value): TraversableContainsIdentical
{
return new TraversableContainsIdentical($value);
}
/**
* @throws Exception
*/
final public static function containsOnly(string $type): TraversableContainsOnly
{
return new TraversableContainsOnly($type);
}
/**
* @throws Exception
*/
final public static function containsOnlyInstancesOf(string $className): TraversableContainsOnly
{
return new TraversableContainsOnly($className, false);
}
final public static function arrayHasKey(int|string $key): ArrayHasKey
{
return new ArrayHasKey($key);
}
final public static function isList(): IsList
{
return new IsList;
}
final public static function equalTo(mixed $value): IsEqual
{
return new IsEqual($value, 0.0, false, false);
}
final public static function equalToCanonicalizing(mixed $value): IsEqualCanonicalizing
{
return new IsEqualCanonicalizing($value);
}
final public static function equalToIgnoringCase(mixed $value): IsEqualIgnoringCase
{
return new IsEqualIgnoringCase($value);
}
final public static function equalToWithDelta(mixed $value, float $delta): IsEqualWithDelta
{
return new IsEqualWithDelta($value, $delta);
}
final public static function isEmpty(): IsEmpty
{
return new IsEmpty;
}
final public static function isWritable(): IsWritable
{
return new IsWritable;
}
final public static function isReadable(): IsReadable
{
return new IsReadable;
}
final public static function directoryExists(): DirectoryExists
{
return new DirectoryExists;
}
final public static function fileExists(): FileExists
{
return new FileExists;
}
final public static function greaterThan(mixed $value): GreaterThan
{
return new GreaterThan($value);
}
final public static function greaterThanOrEqual(mixed $value): LogicalOr
{
return static::logicalOr(
new IsEqual($value),
new GreaterThan($value),
);
}
final public static function identicalTo(mixed $value): IsIdentical
{
return new IsIdentical($value);
}
/**
* @throws UnknownClassOrInterfaceException
*/
final public static function isInstanceOf(string $className): IsInstanceOf
{
return new IsInstanceOf($className);
}
/**
* @psalm-param 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable' $type
*
* @throws Exception
*/
final public static function isType(string $type): IsType
{
return new IsType($type);
}
final public static function lessThan(mixed $value): LessThan
{
return new LessThan($value);
}
final public static function lessThanOrEqual(mixed $value): LogicalOr
{
return static::logicalOr(
new IsEqual($value),
new LessThan($value),
);
}
final public static function matchesRegularExpression(string $pattern): RegularExpression
{
return new RegularExpression($pattern);
}
final public static function matches(string $string): StringMatchesFormatDescription
{
return new StringMatchesFormatDescription($string);
}
/**
* @psalm-param non-empty-string $prefix
*
* @throws InvalidArgumentException
*/
final public static function stringStartsWith(string $prefix): StringStartsWith
{
return new StringStartsWith($prefix);
}
final public static function stringContains(string $string, bool $case = true): StringContains
{
return new StringContains($string, $case);
}
/**
* @psalm-param non-empty-string $suffix
*
* @throws InvalidArgumentException
*/
final public static function stringEndsWith(string $suffix): StringEndsWith
{
return new StringEndsWith($suffix);
}
final public static function stringEqualsStringIgnoringLineEndings(string $string): StringEqualsStringIgnoringLineEndings
{
return new StringEqualsStringIgnoringLineEndings($string);
}
final public static function countOf(int $count): Count
{
return new Count($count);
}
final public static function objectEquals(object $object, string $method = 'equals'): ObjectEquals
{
return new ObjectEquals($object, $method);
}
/**
* Fails a test with the given message.
*
* @throws AssertionFailedError
*/
final public static function fail(string $message = ''): never
{
self::$count++;
throw new AssertionFailedError($message);
}
/**
* Mark the test as incomplete.
*
* @throws IncompleteTestError
*/
final public static function markTestIncomplete(string $message = ''): never
{
throw new IncompleteTestError($message);
}
/**
* Mark the test as skipped.
*
* @throws SkippedWithMessageException
*/
final public static function markTestSkipped(string $message = ''): never
{
throw new SkippedWithMessageException($message);
}
/**
* Return the current assertion count.
*/
final public static function getCount(): int
{
return self::$count;
}
/**
* Reset the assertion counter.
*/
final public static function resetCount(): void
{
self::$count = 0;
}
private static function isNativeType(string $type): bool
{
return match ($type) {
'numeric', 'integer', 'int', 'iterable', 'float', 'string', 'boolean', 'bool', 'null', 'array', 'object', 'resource', 'scalar' => true,
default => false,
};
}
}
src/Framework/TestSuiteIterator.php 0000644 00000003367 15243426620 0013461 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function assert;
use function count;
use RecursiveIterator;
/**
* @template-implements RecursiveIterator<int, Test>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteIterator implements RecursiveIterator
{
private int $position = 0;
/**
* @psalm-var list<Test>
*/
private readonly array $tests;
public function __construct(TestSuite $testSuite)
{
$this->tests = $testSuite->tests();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->tests);
}
public function key(): int
{
return $this->position;
}
public function current(): Test
{
return $this->tests[$this->position];
}
public function next(): void
{
$this->position++;
}
/**
* @throws NoChildTestSuiteException
*/
public function getChildren(): self
{
if (!$this->hasChildren()) {
throw new NoChildTestSuiteException(
'The current item is not a TestSuite instance and therefore does not have any children.',
);
}
$current = $this->current();
assert($current instanceof TestSuite);
return new self($current);
}
public function hasChildren(): bool
{
return $this->valid() && $this->current() instanceof TestSuite;
}
}
src/Framework/ExecutionOrderDependency.php 0000644 00000011452 15243426620 0014746 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function array_filter;
use function array_map;
use function array_values;
use function explode;
use function in_array;
use function str_contains;
use PHPUnit\Metadata\DependsOnClass;
use PHPUnit\Metadata\DependsOnMethod;
use Stringable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionOrderDependency implements Stringable
{
private string $className = '';
private string $methodName = '';
private readonly bool $shallowClone;
private readonly bool $deepClone;
public static function invalid(): self
{
return new self(
'',
'',
false,
false,
);
}
public static function forClass(DependsOnClass $metadata): self
{
return new self(
$metadata->className(),
'class',
$metadata->deepClone(),
$metadata->shallowClone(),
);
}
public static function forMethod(DependsOnMethod $metadata): self
{
return new self(
$metadata->className(),
$metadata->methodName(),
$metadata->deepClone(),
$metadata->shallowClone(),
);
}
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function filterInvalid(array $dependencies): array
{
return array_values(
array_filter(
$dependencies,
static fn (self $d) => $d->isValid(),
),
);
}
/**
* @psalm-param list<ExecutionOrderDependency> $existing
* @psalm-param list<ExecutionOrderDependency> $additional
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function mergeUnique(array $existing, array $additional): array
{
$existingTargets = array_map(
static fn ($dependency) => $dependency->getTarget(),
$existing,
);
foreach ($additional as $dependency) {
$additionalTarget = $dependency->getTarget();
if (in_array($additionalTarget, $existingTargets, true)) {
continue;
}
$existingTargets[] = $additionalTarget;
$existing[] = $dependency;
}
return $existing;
}
/**
* @psalm-param list<ExecutionOrderDependency> $left
* @psalm-param list<ExecutionOrderDependency> $right
*
* @psalm-return list<ExecutionOrderDependency>
*/
public static function diff(array $left, array $right): array
{
if ($right === []) {
return $left;
}
if ($left === []) {
return [];
}
$diff = [];
$rightTargets = array_map(
static fn ($dependency) => $dependency->getTarget(),
$right,
);
foreach ($left as $dependency) {
if (in_array($dependency->getTarget(), $rightTargets, true)) {
continue;
}
$diff[] = $dependency;
}
return $diff;
}
public function __construct(string $classOrCallableName, ?string $methodName = null, bool $deepClone = false, bool $shallowClone = false)
{
$this->deepClone = $deepClone;
$this->shallowClone = $shallowClone;
if ($classOrCallableName === '') {
return;
}
if (str_contains($classOrCallableName, '::')) {
[$this->className, $this->methodName] = explode('::', $classOrCallableName);
} else {
$this->className = $classOrCallableName;
$this->methodName = !empty($methodName) ? $methodName : 'class';
}
}
public function __toString(): string
{
return $this->getTarget();
}
public function isValid(): bool
{
// Invalid dependencies can be declared and are skipped by the runner
return $this->className !== '' && $this->methodName !== '';
}
public function shallowClone(): bool
{
return $this->shallowClone;
}
public function deepClone(): bool
{
return $this->deepClone;
}
public function targetIsClass(): bool
{
return $this->methodName === 'class';
}
public function getTarget(): string
{
return $this->isValid()
? $this->className . '::' . $this->methodName
: '';
}
public function getTargetClassName(): string
{
return $this->className;
}
}
src/Framework/Reorderable.php 0000644 00000001224 15243426620 0012232 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Reorderable
{
public function sortId(): string;
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array;
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array;
}
src/Framework/Exception/ExpectationFailedException.php 0000644 00000002241 15243426620 0017211 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Exception;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* Exception for expectations which failed their check.
*
* The exception contains the error message and optionally a
* SebastianBergmann\Comparator\ComparisonFailure which is used to
* generate diff output of the failed expectations.
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExpectationFailedException extends AssertionFailedError
{
protected ?ComparisonFailure $comparisonFailure = null;
public function __construct(string $message, ?ComparisonFailure $comparisonFailure = null, ?Exception $previous = null)
{
$this->comparisonFailure = $comparisonFailure;
parent::__construct($message, 0, $previous);
}
public function getComparisonFailure(): ?ComparisonFailure
{
return $this->comparisonFailure;
}
}
src/Framework/Exception/AssertionFailedError.php 0000644 00000001152 15243426620 0016030 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class AssertionFailedError extends Exception implements SelfDescribing
{
/**
* Wrapper for getMessage() which is declared as final.
*/
public function toString(): string
{
return $this->getMessage();
}
}
src/Framework/Exception/InvalidArgumentException.php 0000644 00000000672 15243426620 0016720 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class InvalidArgumentException extends Exception
{
}
src/Framework/Exception/UnknownTypeException.php 0000644 00000001240 15243426620 0016120 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownTypeException extends InvalidArgumentException
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Type "%s" is not known',
$name,
),
);
}
}
src/Framework/Exception/Incomplete/IncompleteTestError.php 0000644 00000000727 15243426620 0020021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncompleteTestError extends AssertionFailedError implements IncompleteTest
{
}
src/Framework/Exception/Incomplete/IncompleteTest.php 0000644 00000000673 15243426620 0017007 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface IncompleteTest extends Throwable
{
}
src/Framework/Exception/NoChildTestSuiteException.php 0000644 00000000670 15243426620 0017017 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoChildTestSuiteException extends Exception
{
}
src/Framework/Exception/EmptyStringException.php 0000644 00000000702 15243426620 0016106 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class EmptyStringException extends InvalidArgumentException
{
}
src/Framework/Exception/Skipped/SkippedWithMessageException.php 0000644 00000000734 15243426620 0020765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SkippedWithMessageException extends AssertionFailedError implements SkippedTest
{
}
src/Framework/Exception/Skipped/SkippedTestSuiteError.php 0000644 00000000726 15243426620 0017632 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SkippedTestSuiteError extends AssertionFailedError implements SkippedTest
{
}
src/Framework/Exception/Skipped/SkippedTest.php 0000644 00000000670 15243426620 0015604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface SkippedTest extends Throwable
{
}
src/Framework/Exception/CodeCoverageException.php 0000644 00000000656 15243426620 0016157 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class CodeCoverageException extends Exception
{
}
src/Framework/Exception/InvalidDataProviderException.php 0000644 00000000673 15243426620 0017523 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDataProviderException extends Exception
{
}
src/Framework/Exception/PhptAssertionFailedError.php 0000644 00000002453 15243426620 0016671 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptAssertionFailedError extends AssertionFailedError
{
private readonly string $syntheticFile;
private readonly int $syntheticLine;
private readonly array $syntheticTrace;
private readonly string $diff;
public function __construct(string $message, int $code, string $file, int $line, array $trace, string $diff)
{
parent::__construct($message, $code);
$this->syntheticFile = $file;
$this->syntheticLine = $line;
$this->syntheticTrace = $trace;
$this->diff = $diff;
}
public function syntheticFile(): string
{
return $this->syntheticFile;
}
public function syntheticLine(): int
{
return $this->syntheticLine;
}
public function syntheticTrace(): array
{
return $this->syntheticTrace;
}
public function diff(): string
{
return $this->diff;
}
}
src/Framework/Exception/Exception.php 0000644 00000004204 15243426620 0013701 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function array_keys;
use function get_object_vars;
use RuntimeException;
use Throwable;
/**
* Base class for all PHPUnit Framework exceptions.
*
* Ensures that exceptions thrown during a test run do not leave stray
* references behind.
*
* Every Exception contains a stack trace. Each stack frame contains the 'args'
* of the called function. The function arguments can contain references to
* instantiated objects. The references prevent the objects from being
* destructed (until test results are eventually printed), so memory cannot be
* freed up.
*
* With enabled process isolation, test results are serialized in the child
* process and unserialized in the parent process. The stack trace of Exceptions
* may contain objects that cannot be serialized or unserialized (e.g., PDO
* connections). Unserializing user-space objects from the child process into
* the parent would break the intended encapsulation of process isolation.
*
* @see http://fabien.potencier.org/article/9/php-serialization-stack-traces-and-exceptions
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class Exception extends RuntimeException implements \PHPUnit\Exception
{
protected array $serializableTrace;
public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
$this->serializableTrace = $this->getTrace();
foreach (array_keys($this->serializableTrace) as $key) {
unset($this->serializableTrace[$key]['args']);
}
}
public function __sleep(): array
{
return array_keys(get_object_vars($this));
}
/**
* Returns the serializable trace (without 'args').
*/
public function getSerializableTrace(): array
{
return $this->serializableTrace;
}
}
src/Framework/Exception/GeneratorNotSupportedException.php 0000644 00000001400 15243426620 0020132 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GeneratorNotSupportedException extends InvalidArgumentException
{
public static function fromParameterName(string $parameterName): self
{
return new self(
sprintf(
'Passing an argument of type Generator for the %s parameter is not supported',
$parameterName,
),
);
}
}
src/Framework/Exception/UnknownClassOrInterfaceException.php 0000644 00000001274 15243426620 0020375 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownClassOrInterfaceException extends InvalidArgumentException
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Class or interface "%s" does not exist',
$name,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotAcceptParameterTypeException.php 0000644 00000001475 15243426620 0026604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotAcceptParameterTypeException extends Exception
{
public function __construct(string $className, string $methodName, string $type)
{
parent::__construct(
sprintf(
'%s is not an accepted argument type for comparison method %s::%s().',
$type,
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareBoolReturnTypeException.php 0000644 00000001424 15243426620 0027111 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareBoolReturnTypeException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not declare bool return type.',
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ActualValueIsNotAnObjectException.php 0000644 00000001103 15243426620 0022767 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ActualValueIsNotAnObjectException extends Exception
{
public function __construct()
{
parent::__construct(
'Actual value is not an object',
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareExactlyOneParameterException.php 0000644 00000001436 15243426620 0030073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareExactlyOneParameterException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not declare exactly one parameter.',
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotExistException.php 0000644 00000001361 15243426620 0023770 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotExistException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Comparison method %s::%s() does not exist.',
$className,
$methodName,
),
);
}
}
src/Framework/Exception/ObjectEquals/ComparisonMethodDoesNotDeclareParameterTypeException.php 0000644 00000001434 15243426620 0026737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ComparisonMethodDoesNotDeclareParameterTypeException extends Exception
{
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Parameter of comparison method %s::%s() does not have a declared type.',
$className,
$methodName,
),
);
}
}
src/Framework/Exception/InvalidDependencyException.php 0000644 00000000733 15243426620 0017212 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidDependencyException extends AssertionFailedError implements SkippedTest
{
}
src/Framework/Exception/InvalidCoversTargetException.php 0000644 00000000707 15243426620 0017545 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidCoversTargetException extends CodeCoverageException
{
}
src/Framework/Exception/ProcessIsolationException.php 0000644 00000000670 15243426620 0017125 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ProcessIsolationException extends Exception
{
}
src/Framework/TestCase.php 0000644 00000215636 15243426620 0011535 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const LC_ALL;
use const LC_COLLATE;
use const LC_CTYPE;
use const LC_MONETARY;
use const LC_NUMERIC;
use const LC_TIME;
use const PATHINFO_FILENAME;
use const PHP_EOL;
use const PHP_URL_PATH;
use function array_is_list;
use function array_keys;
use function array_map;
use function array_merge;
use function array_values;
use function assert;
use function basename;
use function chdir;
use function class_exists;
use function clearstatcache;
use function count;
use function defined;
use function explode;
use function getcwd;
use function implode;
use function in_array;
use function ini_set;
use function is_array;
use function is_callable;
use function is_int;
use function is_object;
use function is_string;
use function libxml_clear_errors;
use function method_exists;
use function ob_end_clean;
use function ob_get_clean;
use function ob_get_contents;
use function ob_get_level;
use function ob_start;
use function parse_url;
use function pathinfo;
use function preg_replace;
use function setlocale;
use function sprintf;
use function str_contains;
use function trim;
use AssertionError;
use DeepCopy\DeepCopy;
use PHPUnit\Event;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Event\RuntimeException;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\Constraint\Exception as ExceptionConstraint;
use PHPUnit\Framework\Constraint\ExceptionCode;
use PHPUnit\Framework\Constraint\ExceptionMessageIsOrContains;
use PHPUnit\Framework\Constraint\ExceptionMessageMatchesRegularExpression;
use PHPUnit\Framework\MockObject\Exception as MockObjectException;
use PHPUnit\Framework\MockObject\Generator\Generator as MockGenerator;
use PHPUnit\Framework\MockObject\MockBuilder;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\MockObject\MockObjectInternal;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount as AnyInvokedCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastCount as InvokedAtLeastCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtLeastOnce as InvokedAtLeastOnceMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount as InvokedAtMostCountMatcher;
use PHPUnit\Framework\MockObject\Rule\InvokedCount as InvokedCountMatcher;
use PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls as ConsecutiveCallsStub;
use PHPUnit\Framework\MockObject\Stub\Exception as ExceptionStub;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument as ReturnArgumentStub;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback as ReturnCallbackStub;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf as ReturnSelfStub;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap as ReturnValueMapStub;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\Api\HookMethods;
use PHPUnit\Metadata\Api\Requirements;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\TestRunner\TestResult\PassedTests;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\Cloner;
use PHPUnit\Util\Test as TestUtil;
use ReflectionClass;
use ReflectionException;
use ReflectionMethod;
use ReflectionObject;
use ReflectionParameter;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
use SebastianBergmann\Diff\Differ;
use SebastianBergmann\Diff\Output\UnifiedDiffOutputBuilder;
use SebastianBergmann\Exporter\Exporter;
use SebastianBergmann\GlobalState\ExcludeList as GlobalStateExcludeList;
use SebastianBergmann\GlobalState\Restorer;
use SebastianBergmann\GlobalState\Snapshot;
use SebastianBergmann\Invoker\TimeoutException;
use SebastianBergmann\ObjectEnumerator\Enumerator;
use SebastianBergmann\RecursionContext\Context;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TestCase extends Assert implements Reorderable, SelfDescribing, Test
{
private const LOCALE_CATEGORIES = [LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC, LC_TIME];
private ?bool $backupGlobals = null;
/**
* @psalm-var list<string>
*/
private array $backupGlobalsExcludeList = [];
private ?bool $backupStaticProperties = null;
/**
* @psalm-var array<string,list<class-string>>
*/
private array $backupStaticPropertiesExcludeList = [];
private ?Snapshot $snapshot = null;
private ?bool $runClassInSeparateProcess = null;
private ?bool $runTestInSeparateProcess = null;
private bool $preserveGlobalState = false;
private bool $inIsolation = false;
private ?string $expectedException = null;
private ?string $expectedExceptionMessage = null;
private ?string $expectedExceptionMessageRegExp = null;
private null|int|string $expectedExceptionCode = null;
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $providedTests = [];
private array $data = [];
private int|string $dataName = '';
/**
* @psalm-var non-empty-string
*/
private string $name;
/**
* @psalm-var list<string>
*/
private array $groups = [];
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $dependencies = [];
private array $dependencyInput = [];
/**
* @psalm-var array<string,string>
*/
private array $iniSettings = [];
private array $locale = [];
/**
* @psalm-var list<MockObjectInternal>
*/
private array $mockObjects = [];
private bool $registerMockObjectsFromTestArgumentsRecursively = false;
private TestStatus $status;
private int $numberOfAssertionsPerformed = 0;
private mixed $testResult = null;
private string $output = '';
private ?string $outputExpectedRegex = null;
private ?string $outputExpectedString = null;
private bool $outputBufferingActive = false;
private int $outputBufferingLevel;
private bool $outputRetrievedForAssertion = false;
private bool $doesNotPerformAssertions = false;
/**
* @psalm-var list<Comparator>
*/
private array $customComparators = [];
private ?Event\Code\TestMethod $testValueObjectForEvents = null;
private bool $wasPrepared = false;
/**
* @psalm-var array<class-string, true>
*/
private array $failureTypes = [];
/**
* Returns a matcher that matches when the method is executed
* zero or more times.
*/
final public static function any(): AnyInvokedCountMatcher
{
return new AnyInvokedCountMatcher;
}
/**
* Returns a matcher that matches when the method is never executed.
*/
final public static function never(): InvokedCountMatcher
{
return new InvokedCountMatcher(0);
}
/**
* Returns a matcher that matches when the method is executed
* at least N times.
*/
final public static function atLeast(int $requiredInvocations): InvokedAtLeastCountMatcher
{
return new InvokedAtLeastCountMatcher(
$requiredInvocations,
);
}
/**
* Returns a matcher that matches when the method is executed at least once.
*/
final public static function atLeastOnce(): InvokedAtLeastOnceMatcher
{
return new InvokedAtLeastOnceMatcher;
}
/**
* Returns a matcher that matches when the method is executed exactly once.
*/
final public static function once(): InvokedCountMatcher
{
return new InvokedCountMatcher(1);
}
/**
* Returns a matcher that matches when the method is executed
* exactly $count times.
*/
final public static function exactly(int $count): InvokedCountMatcher
{
return new InvokedCountMatcher($count);
}
/**
* Returns a matcher that matches when the method is executed
* at most N times.
*/
final public static function atMost(int $allowedInvocations): InvokedAtMostCountMatcher
{
return new InvokedAtMostCountMatcher($allowedInvocations);
}
/**
* @deprecated Use <code>$double->willReturn()</code> instead of <code>$double->will($this->returnValue())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnValue(mixed $value): ReturnStub
{
return new ReturnStub($value);
}
/**
* @deprecated Use <code>$double->willReturnMap()</code> instead of <code>$double->will($this->returnValueMap())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnValueMap(array $valueMap): ReturnValueMapStub
{
return new ReturnValueMapStub($valueMap);
}
/**
* @deprecated Use <code>$double->willReturnArgument()</code> instead of <code>$double->will($this->returnArgument())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnArgument(int $argumentIndex): ReturnArgumentStub
{
return new ReturnArgumentStub($argumentIndex);
}
/**
* @deprecated Use <code>$double->willReturnCallback()</code> instead of <code>$double->will($this->returnCallback())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnCallback(callable $callback): ReturnCallbackStub
{
return new ReturnCallbackStub($callback);
}
/**
* @deprecated Use <code>$double->willReturnSelf()</code> instead of <code>$double->will($this->returnSelf())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
*/
final public static function returnSelf(): ReturnSelfStub
{
return new ReturnSelfStub;
}
final public static function throwException(Throwable $exception): ExceptionStub
{
return new ExceptionStub($exception);
}
/**
* @deprecated Use <code>$double->willReturn()</code> instead of <code>$double->will($this->onConsecutiveCalls())</code>
* @see https://github.com/sebastianbergmann/phpunit/issues/5423
* @see https://github.com/sebastianbergmann/phpunit/issues/5425
*/
final public static function onConsecutiveCalls(mixed ...$arguments): ConsecutiveCallsStub
{
return new ConsecutiveCallsStub($arguments);
}
/**
* @psalm-param non-empty-string $name
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function __construct(string $name)
{
$this->setName($name);
$this->status = TestStatus::unknown();
}
/**
* This method is called before the first test of this test class is run.
*/
public static function setUpBeforeClass(): void
{
}
/**
* This method is called after the last test of this test class is run.
*/
public static function tearDownAfterClass(): void
{
}
/**
* This method is called before each test.
*/
protected function setUp(): void
{
}
/**
* Performs assertions shared by all tests of a test case.
*
* This method is called between setUp() and test.
*/
protected function assertPreConditions(): void
{
}
/**
* Performs assertions shared by all tests of a test case.
*
* This method is called between test and tearDown().
*/
protected function assertPostConditions(): void
{
}
/**
* This method is called after each test.
*/
protected function tearDown(): void
{
}
/**
* Returns a string representation of the test case.
*
* @throws Exception
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function toString(): string
{
$buffer = sprintf(
'%s::%s',
(new ReflectionClass($this))->getName(),
$this->name,
);
return $buffer . $this->dataSetAsStringWithData();
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function count(): int
{
return 1;
}
final public function getActualOutputForAssertion(): string
{
$this->outputRetrievedForAssertion = true;
return $this->output();
}
final public function expectOutputRegex(string $expectedRegex): void
{
$this->outputExpectedRegex = $expectedRegex;
}
final public function expectOutputString(string $expectedString): void
{
$this->outputExpectedString = $expectedString;
}
/**
* @psalm-param class-string<Throwable> $exception
*/
final public function expectException(string $exception): void
{
$this->expectedException = $exception;
}
final public function expectExceptionCode(int|string $code): void
{
$this->expectedExceptionCode = $code;
}
final public function expectExceptionMessage(string $message): void
{
$this->expectedExceptionMessage = $message;
}
final public function expectExceptionMessageMatches(string $regularExpression): void
{
$this->expectedExceptionMessageRegExp = $regularExpression;
}
/**
* Sets up an expectation for an exception to be raised by the code under test.
* Information for expected exception class, expected exception message, and
* expected exception code are retrieved from a given Exception object.
*/
final public function expectExceptionObject(\Exception $exception): void
{
$this->expectException($exception::class);
$this->expectExceptionMessage($exception->getMessage());
$this->expectExceptionCode($exception->getCode());
}
final public function expectNotToPerformAssertions(): void
{
$this->doesNotPerformAssertions = true;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function status(): TestStatus
{
return $this->status;
}
/**
* @throws \PHPUnit\Runner\Exception
* @throws \PHPUnit\Util\Exception
* @throws \SebastianBergmann\CodeCoverage\InvalidArgumentException
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws CodeCoverageException
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
* @throws ProcessIsolationException
* @throws StaticAnalysisCacheNotConfiguredException
* @throws UnintentionallyCoveredCodeException
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function run(): void
{
if (!$this->handleDependencies()) {
return;
}
if (!$this->shouldRunInSeparateProcess()) {
(new TestRunner)->run($this);
} else {
(new TestRunner)->runInSeparateProcess(
$this,
$this->runClassInSeparateProcess && !$this->runTestInSeparateProcess,
$this->preserveGlobalState,
);
}
}
/**
* Returns a builder object to create mock objects using a fluent interface.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $className
*
* @psalm-return MockBuilder<RealInstanceType>
*/
final public function getMockBuilder(string $className): MockBuilder
{
return new MockBuilder($this, $className);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function groups(): array
{
return $this->groups;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setGroups(array $groups): void
{
$this->groups = $groups;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function nameWithDataSet(): string
{
return $this->name . $this->dataSetAsString();
}
/**
* @psalm-return non-empty-string
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function name(): string
{
return $this->name;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function size(): TestSize
{
return (new Groups)->size(
static::class,
$this->name,
);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function hasUnexpectedOutput(): bool
{
if ($this->output === '') {
return false;
}
if ($this->expectsOutput()) {
return false;
}
return true;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function output(): string
{
if (!$this->outputBufferingActive) {
return $this->output;
}
return (string) ob_get_contents();
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function doesNotPerformAssertions(): bool
{
return $this->doesNotPerformAssertions;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function expectsOutput(): bool
{
return $this->hasExpectationOnOutput() || $this->outputRetrievedForAssertion;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated
*/
final public function registerMockObjectsFromTestArgumentsRecursively(): void
{
$this->registerMockObjectsFromTestArgumentsRecursively = true;
}
/**
* @throws Throwable
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function runBare(): void
{
$emitter = Event\Facade::emitter();
$emitter->testPreparationStarted(
$this->valueObjectForEvents(),
);
$this->snapshotGlobalState();
$this->startOutputBuffering();
clearstatcache();
$hookMethods = (new HookMethods)->hookMethods(static::class);
$hasMetRequirements = false;
$this->numberOfAssertionsPerformed = 0;
$currentWorkingDirectory = getcwd();
try {
$this->checkRequirements();
$hasMetRequirements = true;
if ($this->inIsolation) {
$this->invokeBeforeClassHookMethods($hookMethods, $emitter);
}
if (method_exists(static::class, $this->name) &&
MetadataRegistry::parser()->forClassAndMethod(static::class, $this->name)->isDoesNotPerformAssertions()->isNotEmpty()) {
$this->doesNotPerformAssertions = true;
}
$this->invokeBeforeTestHookMethods($hookMethods, $emitter);
$this->invokePreConditionHookMethods($hookMethods, $emitter);
$emitter->testPrepared(
$this->valueObjectForEvents(),
);
$this->wasPrepared = true;
$this->testResult = $this->runTest();
$this->verifyMockObjects();
$this->invokePostConditionHookMethods($hookMethods, $emitter);
$this->status = TestStatus::success();
} catch (IncompleteTest $e) {
$this->status = TestStatus::incomplete($e->getMessage());
$emitter->testMarkedAsIncomplete(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
);
} catch (SkippedTest $e) {
$this->status = TestStatus::skipped($e->getMessage());
$emitter->testSkipped(
$this->valueObjectForEvents(),
$e->getMessage(),
);
} catch (AssertionError|AssertionFailedError $e) {
if (!$this->wasPrepared) {
$this->wasPrepared = true;
$emitter->testPreparationFailed(
$this->valueObjectForEvents(),
);
}
$this->status = TestStatus::failure($e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
} catch (TimeoutException $e) {
$this->status = TestStatus::risky($e->getMessage());
} catch (Throwable $_e) {
if ($this->isRegisteredFailure($_e)) {
$this->status = TestStatus::failure($_e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($_e),
null,
);
} else {
$e = $this->transformException($_e);
$this->status = TestStatus::error($e->getMessage());
$emitter->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
);
}
}
$outputBufferingStopped = false;
if (!isset($e) &&
$this->hasExpectationOnOutput() &&
$this->stopOutputBuffering()) {
$outputBufferingStopped = true;
$this->performAssertionsOnOutput();
}
if ($this->status->isSuccess()) {
$emitter->testPassed(
$this->valueObjectForEvents(),
);
if (!$this->usesDataProvider()) {
PassedTests::instance()->testMethodPassed(
$this->valueObjectForEvents(),
$this->testResult,
);
}
}
try {
$this->mockObjects = [];
} catch (Throwable $t) {
Event\Facade::emitter()->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($t),
);
}
// Tear down the fixture. An exception raised in tearDown() will be
// caught and passed on when no exception was raised before.
try {
if ($hasMetRequirements) {
$this->invokeAfterTestHookMethods($hookMethods, $emitter);
if ($this->inIsolation) {
$this->invokeAfterClassHookMethods($hookMethods, $emitter);
}
}
} catch (AssertionError|AssertionFailedError $e) {
$this->status = TestStatus::failure($e->getMessage());
$emitter->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
} catch (Throwable $exceptionRaisedDuringTearDown) {
if (!isset($e)) {
$this->status = TestStatus::error($exceptionRaisedDuringTearDown->getMessage());
$e = $exceptionRaisedDuringTearDown;
$emitter->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($exceptionRaisedDuringTearDown),
);
}
}
if (!$outputBufferingStopped) {
$this->stopOutputBuffering();
}
clearstatcache();
if ($currentWorkingDirectory !== getcwd()) {
chdir($currentWorkingDirectory);
}
$this->restoreGlobalState();
$this->unregisterCustomComparators();
$this->cleanupIniSettings();
$this->cleanupLocaleSettings();
libxml_clear_errors();
$this->testValueObjectForEvents = null;
if (isset($e)) {
$this->onNotSuccessfulTest($e);
}
}
/**
* @psalm-param non-empty-string $name
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setName(string $name): void
{
$this->name = $name;
if (is_callable($this->sortId(), true)) {
$this->providedTests = [new ExecutionOrderDependency($this->sortId())];
}
}
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setDependencies(array $dependencies): void
{
$this->dependencies = $dependencies;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setDependencyInput(array $dependencyInput): void
{
$this->dependencyInput = $dependencyInput;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dependencyInput(): array
{
return $this->dependencyInput;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function hasDependencyInput(): bool
{
return !empty($this->dependencyInput);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupGlobals(bool $backupGlobals): void
{
$this->backupGlobals = $backupGlobals;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupGlobalsExcludeList(array $backupGlobalsExcludeList): void
{
$this->backupGlobalsExcludeList = $backupGlobalsExcludeList;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupStaticProperties(bool $backupStaticProperties): void
{
$this->backupStaticProperties = $backupStaticProperties;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setBackupStaticPropertiesExcludeList(array $backupStaticPropertiesExcludeList): void
{
$this->backupStaticPropertiesExcludeList = $backupStaticPropertiesExcludeList;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setRunTestInSeparateProcess(bool $runTestInSeparateProcess): void
{
if ($this->runTestInSeparateProcess === null) {
$this->runTestInSeparateProcess = $runTestInSeparateProcess;
}
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setRunClassInSeparateProcess(bool $runClassInSeparateProcess): void
{
$this->runClassInSeparateProcess = $runClassInSeparateProcess;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setPreserveGlobalState(bool $preserveGlobalState): void
{
$this->preserveGlobalState = $preserveGlobalState;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setInIsolation(bool $inIsolation): void
{
$this->inIsolation = $inIsolation;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function isInIsolation(): bool
{
return $this->inIsolation;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function result(): mixed
{
return $this->testResult;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setResult(mixed $result): void
{
$this->testResult = $result;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function registerMockObject(MockObject $mockObject): void
{
assert($mockObject instanceof MockObjectInternal);
$this->mockObjects[] = $mockObject;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function addToAssertionCount(int $count): void
{
$this->numberOfAssertionsPerformed += $count;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function numberOfAssertionsPerformed(): int
{
return $this->numberOfAssertionsPerformed;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function usesDataProvider(): bool
{
return !empty($this->data);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataName(): int|string
{
return $this->dataName;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataSetAsString(): string
{
$buffer = '';
if (!empty($this->data)) {
if (is_int($this->dataName)) {
$buffer .= sprintf(' with data set #%d', $this->dataName);
} else {
$buffer .= sprintf(' with data set "%s"', $this->dataName);
}
}
return $buffer;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function dataSetAsStringWithData(): string
{
if (empty($this->data)) {
return '';
}
return $this->dataSetAsString() . sprintf(
' (%s)',
(new Exporter)->shortenedRecursiveExport($this->data),
);
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function providedData(): array
{
return $this->data;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function sortId(): string
{
$id = $this->name;
if (!str_contains($id, '::')) {
$id = static::class . '::' . $id;
}
if ($this->usesDataProvider()) {
$id .= $this->dataSetAsString();
}
return $id;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function provides(): array
{
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function requires(): array
{
return $this->dependencies;
}
/**
* @throws RuntimeException
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function setData(int|string $dataName, array $data): void
{
$this->dataName = $dataName;
$this->data = $data;
if (array_is_list($data)) {
return;
}
try {
$reflector = new ReflectionMethod($this, $this->name);
$parameters = array_map(static fn (ReflectionParameter $parameter) => $parameter->name, $reflector->getParameters());
foreach (array_keys($data) as $parameter) {
if (is_string($parameter) && !in_array($parameter, $parameters, true)) {
Event\Facade::emitter()->testTriggeredPhpunitDeprecation(
$this->valueObjectForEvents(),
sprintf(
'Providing invalid named argument $%s for method %s::%s() is deprecated and will not be supported in PHPUnit 11.0.',
$parameter,
$this::class,
$this->name,
),
);
}
}
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*
* @throws MoreThanOneDataSetFromDataProviderException
*/
final public function valueObjectForEvents(): Event\Code\TestMethod
{
if ($this->testValueObjectForEvents !== null) {
return $this->testValueObjectForEvents;
}
$this->testValueObjectForEvents = Event\Code\TestMethodBuilder::fromTestCase($this);
return $this->testValueObjectForEvents;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
final public function wasPrepared(): bool
{
return $this->wasPrepared;
}
final protected function registerComparator(Comparator $comparator): void
{
ComparatorFactory::getInstance()->register($comparator);
Event\Facade::emitter()->testRegisteredComparator($comparator::class);
$this->customComparators[] = $comparator;
}
/**
* @psalm-param class-string $classOrInterface
*/
final protected function registerFailureType(string $classOrInterface): void
{
$this->failureTypes[$classOrInterface] = true;
}
/**
* @throws AssertionFailedError
* @throws Exception
* @throws ExpectationFailedException
* @throws Throwable
*
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
protected function runTest(): mixed
{
$testArguments = array_merge($this->data, $this->dependencyInput);
$this->registerMockObjectsFromTestArguments($testArguments);
try {
$testResult = $this->{$this->name}(...array_values($testArguments));
} catch (Throwable $exception) {
if (!$this->shouldExceptionExpectationsBeVerified($exception)) {
throw $exception;
}
$this->verifyExceptionExpectations($exception);
return null;
}
$this->expectedExceptionWasNotRaised();
return $testResult;
}
/**
* This method is a wrapper for the ini_set() function that automatically
* resets the modified php.ini setting to its original value after the
* test is run.
*
* @throws Exception
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5214
*/
protected function iniSet(string $varName, string $newValue): void
{
$currentValue = ini_set($varName, $newValue);
if ($currentValue !== false) {
$this->iniSettings[$varName] = $currentValue;
} else {
throw new Exception(
sprintf(
'INI setting "%s" could not be set to "%s".',
$varName,
$newValue,
),
);
}
}
/**
* This method is a wrapper for the setlocale() function that automatically
* resets the locale to its original value after the test is run.
*
* @throws Exception
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5216
*/
protected function setLocale(mixed ...$arguments): void
{
if (count($arguments) < 2) {
throw new Exception;
}
[$category, $locale] = $arguments;
if (!in_array($category, self::LOCALE_CATEGORIES, true)) {
throw new Exception;
}
if (!is_array($locale) && !is_string($locale)) {
throw new Exception;
}
$this->locale[$category] = setlocale($category, '0');
$result = setlocale(...$arguments);
if ($result === false) {
throw new Exception(
'The locale functionality is not implemented on your platform, ' .
'the specified locale does not exist or the category name is ' .
'invalid.',
);
}
}
/**
* Creates a mock object for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected function createMock(string $originalClassName): MockObject
{
$mock = (new MockGenerator)->testDouble(
$originalClassName,
true,
callOriginalConstructor: false,
callOriginalClone: false,
cloneArguments: false,
allowMockingUnknownTypes: false,
);
assert($mock instanceof $originalClassName);
assert($mock instanceof MockObject);
$this->registerMockObject($mock);
Event\Facade::emitter()->testCreatedMockObject($originalClassName);
return $mock;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws MockObjectException
*/
protected function createMockForIntersectionOfInterfaces(array $interfaces): MockObject
{
$mock = (new MockGenerator)->testDoubleForInterfaceIntersection($interfaces, true);
assert($mock instanceof MockObject);
$this->registerMockObject($mock);
Event\Facade::emitter()->testCreatedMockObjectForIntersectionOfInterfaces($interfaces);
return $mock;
}
/**
* Creates (and configures) a mock object for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected function createConfiguredMock(string $originalClassName, array $configuration): MockObject
{
$o = $this->createMock($originalClassName);
foreach ($configuration as $method => $return) {
$o->method($method)->willReturn($return);
}
return $o;
}
/**
* Creates a partial mock object for the specified interface or class.
*
* @psalm-param list<non-empty-string> $methods
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*/
protected function createPartialMock(string $originalClassName, array $methods): MockObject
{
$partialMock = $this->getMockBuilder($originalClassName)
->disableOriginalConstructor()
->disableOriginalClone()
->disableArgumentCloning()
->disallowMockingUnknownTypes()
->onlyMethods($methods)
->getMock();
Event\Facade::emitter()->testCreatedPartialMockObject(
$originalClassName,
...$methods,
);
return $partialMock;
}
/**
* Creates a test proxy for the specified class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5240
*/
protected function createTestProxy(string $originalClassName, array $constructorArguments = []): MockObject
{
$testProxy = $this->getMockBuilder($originalClassName)
->setConstructorArgs($constructorArguments)
->enableProxyingToOriginalMethods()
->getMock();
Event\Facade::emitter()->testCreatedTestProxy(
$originalClassName,
$constructorArguments,
);
return $testProxy;
}
/**
* Creates a mock object for the specified abstract class with all abstract
* methods of the class mocked. Concrete methods are not mocked by default.
* To mock concrete methods, use the 7th parameter ($mockedMethods).
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return MockObject&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5241
*/
protected function getMockForAbstractClass(string $originalClassName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
{
$mockObject = (new MockGenerator)->mockObjectForAbstractClass(
$originalClassName,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$mockedMethods,
$cloneArguments,
);
$this->registerMockObject($mockObject);
Event\Facade::emitter()->testCreatedMockObjectForAbstractClass($originalClassName);
assert($mockObject instanceof $originalClassName);
assert($mockObject instanceof MockObject);
return $mockObject;
}
/**
* Creates a mock object based on the given WSDL file.
*
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5242
*/
protected function getMockFromWsdl(string $wsdlFile, string $originalClassName = '', string $mockClassName = '', array $methods = [], bool $callOriginalConstructor = true, array $options = []): MockObject
{
if ($originalClassName === '') {
$fileName = pathinfo(basename(parse_url($wsdlFile, PHP_URL_PATH)), PATHINFO_FILENAME);
$originalClassName = preg_replace('/\W/', '', $fileName);
}
if (!class_exists($originalClassName)) {
eval(
(new MockGenerator)->generateClassFromWsdl(
$wsdlFile,
$originalClassName,
$methods,
$options,
)
);
}
$mockObject = (new MockGenerator)->testDouble(
$originalClassName,
true,
$methods,
['', $options],
$mockClassName,
$callOriginalConstructor,
false,
false,
);
Event\Facade::emitter()->testCreatedMockObjectFromWsdl(
$wsdlFile,
$originalClassName,
$mockClassName,
$methods,
$callOriginalConstructor,
$options,
);
assert($mockObject instanceof MockObject);
$this->registerMockObject($mockObject);
return $mockObject;
}
/**
* Creates a mock object for the specified trait with all abstract methods
* of the trait mocked. Concrete methods to mock can be specified with the
* `$mockedMethods` parameter.
*
* @psalm-param trait-string $traitName
*
* @throws InvalidArgumentException
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
protected function getMockForTrait(string $traitName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
{
$mockObject = (new MockGenerator)->mockObjectForTrait(
$traitName,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$mockedMethods,
$cloneArguments,
);
$this->registerMockObject($mockObject);
Event\Facade::emitter()->testCreatedMockObjectForTrait($traitName);
return $mockObject;
}
/**
* Creates an object that uses the specified trait.
*
* @psalm-param trait-string $traitName
*
* @throws MockObjectException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5244
*/
protected function getObjectForTrait(string $traitName, array $arguments = [], string $traitClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true): object
{
return (new MockGenerator)->objectForTrait(
$traitName,
$traitClassName,
$callAutoload,
$callOriginalConstructor,
$arguments,
);
}
protected function transformException(Throwable $t): Throwable
{
return $t;
}
/**
* This method is called when a test method did not execute successfully.
*
* @throws Throwable
*/
protected function onNotSuccessfulTest(Throwable $t): never
{
throw $t;
}
/**
* @throws Throwable
*/
private function verifyMockObjects(): void
{
foreach ($this->mockObjects as $mockObject) {
if ($mockObject->__phpunit_hasMatchers()) {
$this->numberOfAssertionsPerformed++;
}
$mockObject->__phpunit_verify(
$this->shouldInvocationMockerBeReset($mockObject),
);
}
}
/**
* @throws SkippedTest
*/
private function checkRequirements(): void
{
if (!$this->name || !method_exists($this, $this->name)) {
return;
}
$missingRequirements = (new Requirements)->requirementsNotSatisfiedFor(
static::class,
$this->name,
);
if (!empty($missingRequirements)) {
$this->markTestSkipped(implode(PHP_EOL, $missingRequirements));
}
}
private function handleDependencies(): bool
{
if ([] === $this->dependencies || $this->inIsolation) {
return true;
}
$passedTests = PassedTests::instance();
foreach ($this->dependencies as $dependency) {
if (!$dependency->isValid()) {
$this->markErrorForInvalidDependency();
return false;
}
if ($dependency->targetIsClass()) {
$dependencyClassName = $dependency->getTargetClassName();
if (!class_exists($dependencyClassName)) {
$this->markErrorForInvalidDependency($dependency);
return false;
}
if (!$passedTests->hasTestClassPassed($dependencyClassName)) {
$this->markSkippedForMissingDependency($dependency);
return false;
}
continue;
}
$dependencyTarget = $dependency->getTarget();
if (!$passedTests->hasTestMethodPassed($dependencyTarget)) {
if (!$this->isCallableTestMethod($dependencyTarget)) {
$this->markErrorForInvalidDependency($dependency);
} else {
$this->markSkippedForMissingDependency($dependency);
}
return false;
}
if ($passedTests->isGreaterThan($dependencyTarget, $this->size())) {
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
'This test depends on a test that is larger than itself',
);
return false;
}
$returnValue = $passedTests->returnValue($dependencyTarget);
if ($dependency->deepClone()) {
$deepCopy = new DeepCopy;
$deepCopy->skipUncloneable(false);
$this->dependencyInput[$dependencyTarget] = $deepCopy->copy($returnValue);
} elseif ($dependency->shallowClone()) {
$this->dependencyInput[$dependencyTarget] = clone $returnValue;
} else {
$this->dependencyInput[$dependencyTarget] = $returnValue;
}
}
$this->testValueObjectForEvents = null;
return true;
}
/**
* @throws Exception
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function markErrorForInvalidDependency(?ExecutionOrderDependency $dependency = null): void
{
$message = 'This test has an invalid dependency';
if ($dependency !== null) {
$message = sprintf(
'This test depends on "%s" which does not exist',
$dependency->targetIsClass() ? $dependency->getTargetClassName() : $dependency->getTarget(),
);
}
$exception = new InvalidDependencyException($message);
Event\Facade::emitter()->testErrored(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($exception),
);
$this->status = TestStatus::error($message);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function markSkippedForMissingDependency(ExecutionOrderDependency $dependency): void
{
$message = sprintf(
'This test depends on "%s" to pass',
$dependency->getTarget(),
);
Event\Facade::emitter()->testSkipped(
$this->valueObjectForEvents(),
$message,
);
$this->status = TestStatus::skipped($message);
}
private function startOutputBuffering(): void
{
ob_start();
$this->outputBufferingActive = true;
$this->outputBufferingLevel = ob_get_level();
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function stopOutputBuffering(): bool
{
$bufferingLevel = ob_get_level();
if ($bufferingLevel !== $this->outputBufferingLevel) {
if ($bufferingLevel > $this->outputBufferingLevel) {
$message = 'Test code or tested code did not close its own output buffers';
} else {
$message = 'Test code or tested code closed output buffers other than its own';
}
while (ob_get_level() >= $this->outputBufferingLevel) {
ob_end_clean();
}
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
$message,
);
$this->status = TestStatus::risky($message);
return false;
}
$this->output = ob_get_clean();
$this->outputBufferingActive = false;
$this->outputBufferingLevel = ob_get_level();
return true;
}
private function snapshotGlobalState(): void
{
if ($this->runTestInSeparateProcess || $this->inIsolation ||
(!$this->backupGlobals && !$this->backupStaticProperties)) {
return;
}
$snapshot = $this->createGlobalStateSnapshot($this->backupGlobals === true);
$this->snapshot = $snapshot;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function restoreGlobalState(): void
{
if (!$this->snapshot instanceof Snapshot) {
return;
}
if (ConfigurationRegistry::get()->beStrictAboutChangesToGlobalState()) {
$this->compareGlobalStateSnapshots(
$this->snapshot,
$this->createGlobalStateSnapshot($this->backupGlobals === true),
);
}
$restorer = new Restorer;
if ($this->backupGlobals) {
$restorer->restoreGlobalVariables($this->snapshot);
}
if ($this->backupStaticProperties) {
$restorer->restoreStaticProperties($this->snapshot);
}
$this->snapshot = null;
}
private function createGlobalStateSnapshot(bool $backupGlobals): Snapshot
{
$excludeList = new GlobalStateExcludeList;
foreach ($this->backupGlobalsExcludeList as $globalVariable) {
$excludeList->addGlobalVariable($globalVariable);
}
if (!defined('PHPUNIT_TESTSUITE')) {
$excludeList->addClassNamePrefix('PHPUnit');
$excludeList->addClassNamePrefix('SebastianBergmann\CodeCoverage');
$excludeList->addClassNamePrefix('SebastianBergmann\FileIterator');
$excludeList->addClassNamePrefix('SebastianBergmann\Invoker');
$excludeList->addClassNamePrefix('SebastianBergmann\Template');
$excludeList->addClassNamePrefix('SebastianBergmann\Timer');
$excludeList->addStaticProperty(ComparatorFactory::class, 'instance');
foreach ($this->backupStaticPropertiesExcludeList as $class => $properties) {
foreach ($properties as $property) {
$excludeList->addStaticProperty($class, $property);
}
}
}
return new Snapshot(
$excludeList,
$backupGlobals,
(bool) $this->backupStaticProperties,
false,
false,
false,
false,
false,
false,
false,
);
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function compareGlobalStateSnapshots(Snapshot $before, Snapshot $after): void
{
$backupGlobals = $this->backupGlobals === null || $this->backupGlobals;
if ($backupGlobals) {
$this->compareGlobalStateSnapshotPart(
$before->globalVariables(),
$after->globalVariables(),
"--- Global variables before the test\n+++ Global variables after the test\n",
);
$this->compareGlobalStateSnapshotPart(
$before->superGlobalVariables(),
$after->superGlobalVariables(),
"--- Super-global variables before the test\n+++ Super-global variables after the test\n",
);
}
if ($this->backupStaticProperties) {
$this->compareGlobalStateSnapshotPart(
$before->staticProperties(),
$after->staticProperties(),
"--- Static properties before the test\n+++ Static properties after the test\n",
);
}
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
private function compareGlobalStateSnapshotPart(array $before, array $after, string $header): void
{
if ($before != $after) {
$differ = new Differ(new UnifiedDiffOutputBuilder($header));
$exporter = new Exporter;
Event\Facade::emitter()->testConsideredRisky(
$this->valueObjectForEvents(),
'This test modified global state but was not expected to do so' . PHP_EOL .
trim(
$differ->diff(
$exporter->export($before),
$exporter->export($after),
),
),
);
}
}
private function shouldInvocationMockerBeReset(MockObject $mock): bool
{
$enumerator = new Enumerator;
if (in_array($mock, $enumerator->enumerate($this->dependencyInput), true)) {
return false;
}
if (!is_array($this->testResult) && !is_object($this->testResult)) {
return true;
}
return !in_array($mock, $enumerator->enumerate($this->testResult), true);
}
/**
* @deprecated
*/
private function registerMockObjectsFromTestArguments(array $testArguments, Context $context = new Context): void
{
if ($this->registerMockObjectsFromTestArgumentsRecursively) {
foreach ((new Enumerator)->enumerate($testArguments) as $object) {
if ($object instanceof MockObject) {
$this->registerMockObject($object);
}
}
} else {
foreach ($testArguments as &$testArgument) {
if ($testArgument instanceof MockObject) {
$testArgument = Cloner::clone($testArgument);
$this->registerMockObject($testArgument);
} elseif (is_array($testArgument) && !$context->contains($testArgument)) {
$testArgumentCopy = $testArgument;
$context->add($testArgument);
$this->registerMockObjectsFromTestArguments(
$testArgumentCopy,
$context,
);
}
}
}
}
private function unregisterCustomComparators(): void
{
$factory = ComparatorFactory::getInstance();
foreach ($this->customComparators as $comparator) {
$factory->unregister($comparator);
}
$this->customComparators = [];
}
private function cleanupIniSettings(): void
{
foreach ($this->iniSettings as $varName => $oldValue) {
ini_set($varName, $oldValue);
}
$this->iniSettings = [];
}
private function cleanupLocaleSettings(): void
{
foreach ($this->locale as $category => $locale) {
setlocale($category, $locale);
}
$this->locale = [];
}
/**
* @throws Exception
*/
private function shouldExceptionExpectationsBeVerified(Throwable $throwable): bool
{
$result = false;
if ($this->expectedException !== null || $this->expectedExceptionCode !== null || $this->expectedExceptionMessage !== null || $this->expectedExceptionMessageRegExp !== null) {
$result = true;
}
if ($throwable instanceof Exception) {
$result = false;
}
if (is_string($this->expectedException)) {
try {
$reflector = new ReflectionClass($this->expectedException);
// @codeCoverageIgnoreStart
} catch (ReflectionException $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
if ($this->expectedException === 'PHPUnit\Framework\Exception' ||
$this->expectedException === '\PHPUnit\Framework\Exception' ||
$reflector->isSubclassOf(Exception::class)) {
$result = true;
}
}
return $result;
}
private function shouldRunInSeparateProcess(): bool
{
if ($this->inIsolation) {
return false;
}
if ($this->runTestInSeparateProcess) {
return true;
}
if ($this->runClassInSeparateProcess) {
return true;
}
return ConfigurationRegistry::get()->processIsolation();
}
private function isCallableTestMethod(string $dependency): bool
{
[$className, $methodName] = explode('::', $dependency);
if (!class_exists($className)) {
return false;
}
$class = new ReflectionClass($className);
if (!$class->isSubclassOf(__CLASS__)) {
return false;
}
if (!$class->hasMethod($methodName)) {
return false;
}
return TestUtil::isTestMethod(
$class->getMethod($methodName),
);
}
/**
* @throws Exception
* @throws ExpectationFailedException
* @throws MoreThanOneDataSetFromDataProviderException
* @throws NoPreviousThrowableException
*/
private function performAssertionsOnOutput(): void
{
try {
if ($this->outputExpectedRegex !== null) {
$this->assertMatchesRegularExpression($this->outputExpectedRegex, $this->output);
} elseif ($this->outputExpectedString !== null) {
$this->assertSame($this->outputExpectedString, $this->output);
}
} catch (ExpectationFailedException $e) {
$this->status = TestStatus::failure($e->getMessage());
Event\Facade::emitter()->testFailed(
$this->valueObjectForEvents(),
Event\Code\ThrowableBuilder::from($e),
Event\Code\ComparisonFailureBuilder::from($e),
);
throw $e;
}
}
/**
* @throws Throwable
*/
private function invokeBeforeClassHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['beforeClass'],
$emitter,
'testBeforeFirstTestMethodCalled',
'testBeforeFirstTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokeBeforeTestHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['before'],
$emitter,
'testBeforeTestMethodCalled',
'testBeforeTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokePreConditionHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['preCondition'],
$emitter,
'testPreConditionCalled',
'testPreConditionFinished',
);
}
/**
* @throws Throwable
*/
private function invokePostConditionHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['postCondition'],
$emitter,
'testPostConditionCalled',
'testPostConditionFinished',
);
}
/**
* @throws Throwable
*/
private function invokeAfterTestHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['after'],
$emitter,
'testAfterTestMethodCalled',
'testAfterTestMethodFinished',
);
}
/**
* @throws Throwable
*/
private function invokeAfterClassHookMethods(array $hookMethods, Event\Emitter $emitter): void
{
$this->invokeHookMethods(
$hookMethods['afterClass'],
$emitter,
'testAfterLastTestMethodCalled',
'testAfterLastTestMethodFinished',
);
}
/**
* @psalm-param list<non-empty-string> $hookMethods
* @psalm-param 'testBeforeFirstTestMethodCalled'|'testBeforeTestMethodCalled'|'testPreConditionCalled'|'testPostConditionCalled'|'testAfterTestMethodCalled'|'testAfterLastTestMethodCalled' $calledMethod
* @psalm-param 'testBeforeFirstTestMethodFinished'|'testBeforeTestMethodFinished'|'testPreConditionFinished'|'testPostConditionFinished'|'testAfterTestMethodFinished'|'testAfterLastTestMethodFinished' $finishedMethod
*
* @throws Throwable
*/
private function invokeHookMethods(array $hookMethods, Event\Emitter $emitter, string $calledMethod, string $finishedMethod): void
{
$methodsInvoked = [];
foreach ($hookMethods as $methodName) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($methodName)) {
continue;
}
try {
$this->{$methodName}();
} catch (Throwable $t) {
}
$methodInvoked = new Event\Code\ClassMethod(
static::class,
$methodName,
);
$emitter->{$calledMethod}(
static::class,
$methodInvoked
);
$methodsInvoked[] = $methodInvoked;
if (isset($t)) {
break;
}
}
if (!empty($methodsInvoked)) {
$emitter->{$finishedMethod}(
static::class,
...$methodsInvoked
);
}
if (isset($t)) {
throw $t;
}
}
private function methodDoesNotExistOrIsDeclaredInTestCase(string $methodName): bool
{
$reflector = new ReflectionObject($this);
return !$reflector->hasMethod($methodName) ||
$reflector->getMethod($methodName)->getDeclaringClass()->getName() === self::class;
}
/**
* @throws ExpectationFailedException
*/
private function verifyExceptionExpectations(\Exception|Throwable $exception): void
{
if ($this->expectedException !== null) {
$this->assertThat(
$exception,
new ExceptionConstraint(
$this->expectedException,
),
);
}
if ($this->expectedExceptionMessage !== null) {
$this->assertThat(
$exception->getMessage(),
new ExceptionMessageIsOrContains(
$this->expectedExceptionMessage,
),
);
}
if ($this->expectedExceptionMessageRegExp !== null) {
$this->assertThat(
$exception->getMessage(),
new ExceptionMessageMatchesRegularExpression(
$this->expectedExceptionMessageRegExp,
),
);
}
if ($this->expectedExceptionCode !== null) {
$this->assertThat(
$exception->getCode(),
new ExceptionCode(
$this->expectedExceptionCode,
),
);
}
}
/**
* @throws AssertionFailedError
*/
private function expectedExceptionWasNotRaised(): void
{
if ($this->expectedException !== null) {
$this->assertThat(
null,
new ExceptionConstraint($this->expectedException),
);
} elseif ($this->expectedExceptionMessage !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with message "%s" is thrown',
$this->expectedExceptionMessage,
),
);
} elseif ($this->expectedExceptionMessageRegExp !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with message matching "%s" is thrown',
$this->expectedExceptionMessageRegExp,
),
);
} elseif ($this->expectedExceptionCode !== null) {
$this->numberOfAssertionsPerformed++;
throw new AssertionFailedError(
sprintf(
'Failed asserting that exception with code "%s" is thrown',
$this->expectedExceptionCode,
),
);
}
}
private function isRegisteredFailure(Throwable $t): bool
{
foreach (array_keys($this->failureTypes) as $failureType) {
if ($t instanceof $failureType) {
return true;
}
}
return false;
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
private function hasExpectationOnOutput(): bool
{
return is_string($this->outputExpectedString) || is_string($this->outputExpectedRegex);
}
/**
* Creates a test stub for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return Stub&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
protected static function createStub(string $originalClassName): Stub
{
$stub = (new MockGenerator)->testDouble(
$originalClassName,
true,
callOriginalConstructor: false,
callOriginalClone: false,
cloneArguments: false,
allowMockingUnknownTypes: false,
);
Event\Facade::emitter()->testCreatedStub($originalClassName);
assert($stub instanceof $originalClassName);
assert($stub instanceof Stub);
return $stub;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws MockObjectException
*/
protected static function createStubForIntersectionOfInterfaces(array $interfaces): Stub
{
$stub = (new MockGenerator)->testDoubleForInterfaceIntersection($interfaces, true);
Event\Facade::emitter()->testCreatedStubForIntersectionOfInterfaces($interfaces);
return $stub;
}
/**
* Creates (and configures) a test stub for the specified interface or class.
*
* @psalm-template RealInstanceType of object
*
* @psalm-param class-string<RealInstanceType> $originalClassName
*
* @psalm-return Stub&RealInstanceType
*
* @throws InvalidArgumentException
* @throws MockObjectException
* @throws NoPreviousThrowableException
*/
final protected static function createConfiguredStub(string $originalClassName, array $configuration): Stub
{
$o = self::createStub($originalClassName);
foreach ($configuration as $method => $return) {
$o->method($method)->willReturn($return);
}
return $o;
}
}
src/Framework/TestSuite.php 0000644 00000044557 15243426620 0011755 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use const PHP_EOL;
use function array_keys;
use function array_map;
use function assert;
use function call_user_func;
use function class_exists;
use function count;
use function implode;
use function is_callable;
use function is_file;
use function is_subclass_of;
use function sprintf;
use function str_ends_with;
use function str_starts_with;
use function trim;
use Iterator;
use IteratorAggregate;
use PHPUnit\Event;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Metadata\Api\Dependencies;
use PHPUnit\Metadata\Api\Groups;
use PHPUnit\Metadata\Api\HookMethods;
use PHPUnit\Metadata\Api\Requirements;
use PHPUnit\Metadata\MetadataCollection;
use PHPUnit\Runner\Exception as RunnerException;
use PHPUnit\Runner\Filter\Factory;
use PHPUnit\Runner\PhptTestCase;
use PHPUnit\Runner\TestSuiteLoader;
use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
use PHPUnit\Util\Filter;
use PHPUnit\Util\Reflection;
use PHPUnit\Util\Test as TestUtil;
use ReflectionClass;
use ReflectionMethod;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use Throwable;
/**
* @template-implements IteratorAggregate<int, Test>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
class TestSuite implements IteratorAggregate, Reorderable, SelfDescribing, Test
{
/**
* @psalm-var non-empty-string
*/
private string $name;
/**
* @psalm-var array<string,list<Test>>
*/
private array $groups = [];
/**
* @psalm-var ?list<ExecutionOrderDependency>
*/
private ?array $requiredTests = null;
/**
* @psalm-var list<Test>
*/
private array $tests = [];
/**
* @psalm-var ?list<ExecutionOrderDependency>
*/
private ?array $providedTests = null;
private ?Factory $iteratorFilter = null;
/**
* @psalm-param non-empty-string $name
*/
public static function empty(string $name): static
{
return new static($name);
}
/**
* @psalm-param class-string $className
*/
public static function fromClassName(string $className): static
{
assert(class_exists($className));
$class = new ReflectionClass($className);
return static::fromClassReflector($class);
}
public static function fromClassReflector(ReflectionClass $class): static
{
$testSuite = new static($class->getName());
$constructor = $class->getConstructor();
if ($constructor !== null && !$constructor->isPublic()) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Class "%s" has no public constructor.',
$class->getName(),
),
);
return $testSuite;
}
foreach (Reflection::publicMethodsInTestClass($class) as $method) {
if ($method->getDeclaringClass()->getName() === Assert::class) {
continue;
}
if ($method->getDeclaringClass()->getName() === TestCase::class) {
continue;
}
if (!TestUtil::isTestMethod($method)) {
continue;
}
$testSuite->addTestMethod($class, $method);
}
if (count($testSuite) === 0) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'No tests found in class "%s".',
$class->getName(),
),
);
}
return $testSuite;
}
/**
* @psalm-param non-empty-string $name
*/
final private function __construct(string $name)
{
$this->name = $name;
}
/**
* Returns a string representation of the test suite.
*/
public function toString(): string
{
return $this->name();
}
/**
* Adds a test to the suite.
*/
public function addTest(Test $test, array $groups = []): void
{
$class = new ReflectionClass($test);
if (!$class->isAbstract()) {
$this->tests[] = $test;
$this->clearCaches();
if ($test instanceof self && empty($groups)) {
$groups = $test->groups();
}
if ($this->containsOnlyVirtualGroups($groups)) {
$groups[] = 'default';
}
foreach ($groups as $group) {
if (!isset($this->groups[$group])) {
$this->groups[$group] = [$test];
} else {
$this->groups[$group][] = $test;
}
}
if ($test instanceof TestCase) {
$test->setGroups($groups);
}
}
}
/**
* Adds the tests from the given class to the suite.
*
* @throws Exception
*/
public function addTestSuite(ReflectionClass $testClass): void
{
if ($testClass->isAbstract()) {
throw new Exception(
sprintf(
'Class %s is abstract',
$testClass->getName(),
),
);
}
if (!$testClass->isSubclassOf(TestCase::class)) {
throw new Exception(
sprintf(
'Class %s is not a subclass of %s',
$testClass->getName(),
TestCase::class,
),
);
}
$this->addTest(self::fromClassReflector($testClass));
}
/**
* Wraps both <code>addTest()</code> and <code>addTestSuite</code>
* as well as the separate import statements for the user's convenience.
*
* If the named file cannot be read or there are no new tests that can be
* added, a <code>PHPUnit\Framework\WarningTestCase</code> will be created instead,
* leaving the current test run untouched.
*
* @throws Exception
*/
public function addTestFile(string $filename): void
{
if (str_ends_with($filename, '.phpt') && is_file($filename)) {
try {
$this->addTest(new PhptTestCase($filename));
} catch (RunnerException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
return;
}
try {
$this->addTestSuite(
(new TestSuiteLoader)->load($filename),
);
} catch (RunnerException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
}
/**
* Wrapper for addTestFile() that adds multiple test files.
*
* @throws Exception
*/
public function addTestFiles(iterable $fileNames): void
{
foreach ($fileNames as $filename) {
$this->addTestFile((string) $filename);
}
}
/**
* Counts the number of test cases that will be run by this test.
*/
public function count(): int
{
$numTests = 0;
foreach ($this as $test) {
$numTests += count($test);
}
return $numTests;
}
public function isEmpty(): bool
{
return empty($this->tests);
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
/**
* Returns the test groups of the suite.
*
* @psalm-return list<string>
*/
public function groups(): array
{
return array_map(
'strval',
array_keys($this->groups),
);
}
public function groupDetails(): array
{
return $this->groups;
}
/**
* @throws CodeCoverageException
* @throws Event\RuntimeException
* @throws Exception
* @throws InvalidArgumentException
* @throws NoPreviousThrowableException
* @throws UnintentionallyCoveredCodeException
*/
public function run(): void
{
if (count($this) === 0) {
return;
}
$emitter = Event\Facade::emitter();
$testSuiteValueObjectForEvents = Event\TestSuite\TestSuiteBuilder::from($this);
$emitter->testSuiteStarted($testSuiteValueObjectForEvents);
if (!$this->invokeMethodsBeforeFirstTest($emitter, $testSuiteValueObjectForEvents)) {
return;
}
foreach ($this as $test) {
if (TestResultFacade::shouldStop()) {
$emitter->testRunnerExecutionAborted();
break;
}
$test->run();
}
$this->invokeMethodsAfterLastTest($emitter);
$emitter->testSuiteFinished($testSuiteValueObjectForEvents);
}
/**
* Returns the tests as an enumeration.
*
* @psalm-return list<Test>
*/
public function tests(): array
{
return $this->tests;
}
/**
* Set tests of the test suite.
*
* @psalm-param list<Test> $tests
*/
public function setTests(array $tests): void
{
$this->tests = $tests;
}
/**
* Mark the test suite as skipped.
*
* @throws SkippedTestSuiteError
*/
public function markTestSuiteSkipped(string $message = ''): never
{
throw new SkippedTestSuiteError($message);
}
/**
* Returns an iterator for this test suite.
*/
public function getIterator(): Iterator
{
$iterator = new TestSuiteIterator($this);
if ($this->iteratorFilter !== null) {
$iterator = $this->iteratorFilter->factory($iterator, $this);
}
return $iterator;
}
public function injectFilter(Factory $filter): void
{
$this->iteratorFilter = $filter;
foreach ($this as $test) {
if ($test instanceof self) {
$test->injectFilter($filter);
}
}
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
if ($this->providedTests === null) {
$this->providedTests = [];
if (is_callable($this->sortId(), true)) {
$this->providedTests[] = new ExecutionOrderDependency($this->sortId());
}
foreach ($this->tests as $test) {
if (!($test instanceof Reorderable)) {
continue;
}
$this->providedTests = ExecutionOrderDependency::mergeUnique($this->providedTests, $test->provides());
}
}
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
if ($this->requiredTests === null) {
$this->requiredTests = [];
foreach ($this->tests as $test) {
if (!($test instanceof Reorderable)) {
continue;
}
$this->requiredTests = ExecutionOrderDependency::mergeUnique(
ExecutionOrderDependency::filterInvalid($this->requiredTests),
$test->requires(),
);
}
$this->requiredTests = ExecutionOrderDependency::diff($this->requiredTests, $this->provides());
}
return $this->requiredTests;
}
public function sortId(): string
{
return $this->name() . '::class';
}
/**
* @psalm-assert-if-true class-string $this->name
*/
public function isForTestClass(): bool
{
return class_exists($this->name, false) && is_subclass_of($this->name, TestCase::class);
}
/**
* @throws Event\TestData\MoreThanOneDataSetFromDataProviderException
* @throws Exception
*/
protected function addTestMethod(ReflectionClass $class, ReflectionMethod $method): void
{
$className = $class->getName();
$methodName = $method->getName();
assert(!empty($methodName));
try {
$test = (new TestBuilder)->build($class, $methodName);
} catch (InvalidDataProviderException $e) {
Event\Facade::emitter()->testTriggeredPhpunitError(
new TestMethod(
$className,
$methodName,
$class->getFileName(),
$method->getStartLine(),
Event\Code\TestDoxBuilder::fromClassNameAndMethodName(
$className,
$methodName,
),
MetadataCollection::fromArray([]),
Event\TestData\TestDataCollection::fromArray([]),
),
sprintf(
"The data provider specified for %s::%s is invalid\n%s",
$className,
$methodName,
$this->throwableToString($e),
),
);
return;
}
if ($test instanceof TestCase || $test instanceof DataProviderTestSuite) {
$test->setDependencies(
Dependencies::dependencies($class->getName(), $methodName),
);
}
$this->addTest(
$test,
(new Groups)->groups($class->getName(), $methodName),
);
}
private function clearCaches(): void
{
$this->providedTests = null;
$this->requiredTests = null;
}
private function containsOnlyVirtualGroups(array $groups): bool
{
foreach ($groups as $group) {
if (!str_starts_with($group, '__phpunit_')) {
return false;
}
}
return true;
}
private function methodDoesNotExistOrIsDeclaredInTestCase(string $methodName): bool
{
$reflector = new ReflectionClass($this->name);
return !$reflector->hasMethod($methodName) ||
$reflector->getMethod($methodName)->getDeclaringClass()->getName() === TestCase::class;
}
/**
* @throws Exception
*/
private function throwableToString(Throwable $t): string
{
$message = $t->getMessage();
if (empty(trim($message))) {
$message = '<no message>';
}
if ($t instanceof InvalidDataProviderException) {
return sprintf(
"%s\n%s",
$message,
Filter::getFilteredStacktrace($t),
);
}
return sprintf(
"%s: %s\n%s",
$t::class,
$message,
Filter::getFilteredStacktrace($t),
);
}
/**
* @throws Exception
* @throws NoPreviousThrowableException
*/
private function invokeMethodsBeforeFirstTest(Event\Emitter $emitter, Event\TestSuite\TestSuite $testSuiteValueObjectForEvents): bool
{
if (!$this->isForTestClass()) {
return true;
}
$methodsCalledBeforeFirstTest = [];
$beforeClassMethods = (new HookMethods)->hookMethods($this->name)['beforeClass'];
try {
foreach ($beforeClassMethods as $beforeClassMethod) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($beforeClassMethod)) {
continue;
}
if ($missingRequirements = (new Requirements)->requirementsNotSatisfiedFor($this->name, $beforeClassMethod)) {
$this->markTestSuiteSkipped(implode(PHP_EOL, $missingRequirements));
}
$methodCalledBeforeFirstTest = new Event\Code\ClassMethod(
$this->name,
$beforeClassMethod,
);
$emitter->testBeforeFirstTestMethodCalled(
$this->name,
$methodCalledBeforeFirstTest,
);
$methodsCalledBeforeFirstTest[] = $methodCalledBeforeFirstTest;
call_user_func([$this->name, $beforeClassMethod]);
}
} catch (SkippedTest|SkippedTestSuiteError $e) {
$emitter->testSuiteSkipped(
$testSuiteValueObjectForEvents,
$e->getMessage(),
);
return false;
} catch (Throwable $t) {
assert(isset($methodCalledBeforeFirstTest));
$emitter->testBeforeFirstTestMethodErrored(
$this->name,
$methodCalledBeforeFirstTest,
Event\Code\ThrowableBuilder::from($t),
);
if (!empty($methodsCalledBeforeFirstTest)) {
$emitter->testBeforeFirstTestMethodFinished(
$this->name,
...$methodsCalledBeforeFirstTest,
);
}
return false;
}
if (!empty($methodsCalledBeforeFirstTest)) {
$emitter->testBeforeFirstTestMethodFinished(
$this->name,
...$methodsCalledBeforeFirstTest,
);
}
return true;
}
private function invokeMethodsAfterLastTest(Event\Emitter $emitter): void
{
if (!$this->isForTestClass()) {
return;
}
$methodsCalledAfterLastTest = [];
$afterClassMethods = (new HookMethods)->hookMethods($this->name)['afterClass'];
foreach ($afterClassMethods as $afterClassMethod) {
if ($this->methodDoesNotExistOrIsDeclaredInTestCase($afterClassMethod)) {
continue;
}
try {
call_user_func([$this->name, $afterClassMethod]);
$methodCalledAfterLastTest = new Event\Code\ClassMethod(
$this->name,
$afterClassMethod,
);
$emitter->testAfterLastTestMethodCalled(
$this->name,
$methodCalledAfterLastTest,
);
$methodsCalledAfterLastTest[] = $methodCalledAfterLastTest;
} catch (Throwable) {
// @todo
}
}
if (!empty($methodsCalledAfterLastTest)) {
$emitter->testAfterLastTestMethodFinished(
$this->name,
...$methodsCalledAfterLastTest,
);
}
}
}
src/Framework/Constraint/Operator/LogicalXor.php 0000644 00000003217 15243426620 0015772 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_reduce;
use function array_shift;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalXor extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'xor';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php.
*/
public function precedence(): int
{
return 23;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws ExpectationFailedException
*/
public function matches(mixed $other): bool
{
$constraints = $this->constraints();
$initial = array_shift($constraints);
if ($initial === null) {
return false;
}
return array_reduce(
$constraints,
static fn (bool $matches, Constraint $constraint): bool => $matches xor $constraint->evaluate($other, '', true),
$initial->evaluate($other, '', true),
);
}
}
src/Framework/Constraint/Operator/BinaryOperator.php 0000644 00000006334 15243426620 0016672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_map;
use function count;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class BinaryOperator extends Operator
{
/**
* @psalm-var list<Constraint>
*/
private readonly array $constraints;
protected function __construct(mixed ...$constraints)
{
$this->constraints = array_map(
fn ($constraint): Constraint => $this->checkConstraint($constraint),
$constraints,
);
}
/**
* Returns the number of operands (constraints).
*/
final public function arity(): int
{
return count($this->constraints);
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->toString();
}
$text = '';
foreach ($this->constraints as $key => $constraint) {
$constraint = $constraint->reduce();
$text .= $this->constraintToString($constraint, $key);
}
return $text;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
$count = 0;
foreach ($this->constraints as $constraint) {
$count += count($constraint);
}
return $count;
}
/**
* @psalm-return list<Constraint>
*/
final protected function constraints(): array
{
return $this->constraints;
}
/**
* Returns true if the $constraint needs to be wrapped with braces.
*/
final protected function constraintNeedsParentheses(Constraint $constraint): bool
{
return $this->arity() > 1 && parent::constraintNeedsParentheses($constraint);
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* See Constraint::reduce() for more.
*/
protected function reduce(): Constraint
{
if ($this->arity() === 1 && $this->constraints[0] instanceof Operator) {
return $this->constraints[0]->reduce();
}
return parent::reduce();
}
/**
* Returns string representation of given operand in context of this operator.
*/
private function constraintToString(Constraint $constraint, int $position): string
{
$prefix = '';
if ($position > 0) {
$prefix = (' ' . $this->operator() . ' ');
}
if ($this->constraintNeedsParentheses($constraint)) {
return $prefix . '( ' . $constraint->toString() . ' )';
}
$string = $constraint->toStringInContext($this, $position);
if ($string === '') {
$string = $constraint->toString();
}
return $prefix . $string;
}
}
src/Framework/Constraint/Operator/LogicalNot.php 0000644 00000007000 15243426620 0015754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_map;
use function count;
use function preg_match;
use function preg_quote;
use function preg_replace;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalNot extends UnaryOperator
{
public static function negate(string $string): string
{
$positives = [
'contains ',
'exists',
'has ',
'is ',
'are ',
'matches ',
'starts with ',
'ends with ',
'reference ',
'not not ',
];
$negatives = [
'does not contain ',
'does not exist',
'does not have ',
'is not ',
'are not ',
'does not match ',
'starts not with ',
'ends not with ',
'don\'t reference ',
'not ',
];
preg_match('/(\'[\w\W]*\')([\w\W]*)("[\w\W]*")/i', $string, $matches);
if (count($matches) === 0) {
preg_match('/(\'[\w\W]*\')([\w\W]*)(\'[\w\W]*\')/i', $string, $matches);
}
$positives = array_map(
static fn (string $s) => '/\\b' . preg_quote($s, '/') . '/',
$positives,
);
if (count($matches) > 0) {
$nonInput = $matches[2];
$negatedString = preg_replace(
'/' . preg_quote($nonInput, '/') . '/',
preg_replace(
$positives,
$negatives,
$nonInput,
),
$string,
);
} else {
$negatedString = preg_replace(
$positives,
$negatives,
$string,
);
}
return $negatedString;
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'not';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 5;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws ExpectationFailedException
*/
protected function matches(mixed $other): bool
{
return !$this->constraint()->evaluate($other, '', true);
}
/**
* Applies additional transformation to strings returned by toString() or
* failureDescription().
*/
protected function transformString(string $string): string
{
return self::negate($string);
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* See Constraint::reduce() for more.
*/
protected function reduce(): Constraint
{
$constraint = $this->constraint();
if ($constraint instanceof self) {
return $constraint->constraint()->reduce();
}
return parent::reduce();
}
}
src/Framework/Constraint/Operator/UnaryOperator.php 0000644 00000006653 15243426620 0016550 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class UnaryOperator extends Operator
{
private readonly Constraint $constraint;
public function __construct(mixed $constraint)
{
$this->constraint = $this->checkConstraint($constraint);
}
/**
* Returns the number of operands (constraints).
*/
public function arity(): int
{
return 1;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->toString();
}
$constraint = $this->constraint->reduce();
if ($this->constraintNeedsParentheses($constraint)) {
return $this->operator() . '( ' . $constraint->toString() . ' )';
}
$string = $constraint->toStringInContext($this, 0);
if ($string === '') {
return $this->transformString($constraint->toString());
}
return $string;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return count($this->constraint);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
$reduced = $this->reduce();
if ($reduced !== $this) {
return $reduced->failureDescription($other);
}
$constraint = $this->constraint->reduce();
if ($this->constraintNeedsParentheses($constraint)) {
return $this->operator() . '( ' . $constraint->failureDescription($other) . ' )';
}
$string = $constraint->failureDescriptionInContext($this, 0, $other);
if ($string === '') {
return $this->transformString($constraint->failureDescription($other));
}
return $string;
}
/**
* Transforms string returned by the memeber constraint's toString() or
* failureDescription() such that it reflects constraint's participation in
* this expression.
*
* The method may be overwritten in a subclass to apply default
* transformation in case the operand constraint does not provide its own
* custom strings via toStringInContext() or failureDescriptionInContext().
*/
protected function transformString(string $string): string
{
return $string;
}
/**
* Provides access to $this->constraint for subclasses.
*/
final protected function constraint(): Constraint
{
return $this->constraint;
}
/**
* Returns true if the $constraint needs to be wrapped with parentheses.
*/
protected function constraintNeedsParentheses(Constraint $constraint): bool
{
$constraint = $constraint->reduce();
return $constraint instanceof self || parent::constraintNeedsParentheses($constraint);
}
}
src/Framework/Constraint/Operator/LogicalAnd.php 0000644 00000002473 15243426620 0015727 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalAnd extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'and';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 22;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
foreach ($this->constraints() as $constraint) {
if (!$constraint->evaluate($other, '', true)) {
return false;
}
}
return [] !== $this->constraints();
}
}
src/Framework/Constraint/Operator/Operator.php 0000644 00000002662 15243426620 0015525 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Operator extends Constraint
{
/**
* Returns the name of this operator.
*/
abstract public function operator(): string;
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
abstract public function precedence(): int;
/**
* Returns the number of operands.
*/
abstract public function arity(): int;
/**
* Validates $constraint argument.
*/
protected function checkConstraint(mixed $constraint): Constraint
{
if (!$constraint instanceof Constraint) {
return new IsEqual($constraint);
}
return $constraint;
}
/**
* Returns true if the $constraint needs to be wrapped with braces.
*/
protected function constraintNeedsParentheses(Constraint $constraint): bool
{
return $constraint instanceof self &&
$constraint->arity() > 1 &&
$this->precedence() <= $constraint->precedence();
}
}
src/Framework/Constraint/Operator/LogicalOr.php 0000644 00000002436 15243426620 0015604 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LogicalOr extends BinaryOperator
{
public static function fromConstraints(mixed ...$constraints): self
{
return new self(...$constraints);
}
/**
* Returns the name of this operator.
*/
public function operator(): string
{
return 'or';
}
/**
* Returns this operator's precedence.
*
* @see https://www.php.net/manual/en/language.operators.precedence.php
*/
public function precedence(): int
{
return 24;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
public function matches(mixed $other): bool
{
foreach ($this->constraints() as $constraint) {
if ($constraint->evaluate($other, '', true)) {
return true;
}
}
return false;
}
}
src/Framework/Constraint/Traversable/TraversableContainsOnly.php 0000644 00000003752 15243426620 0021225 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsOnly extends Constraint
{
private Constraint $constraint;
private readonly string $type;
/**
* @throws Exception
*/
public function __construct(string $type, bool $isNativeType = true)
{
if ($isNativeType) {
$this->constraint = new IsType($type);
} else {
$this->constraint = new IsInstanceOf($type);
}
$this->type = $type;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): bool
{
$success = true;
foreach ($other as $item) {
if (!$this->constraint->evaluate($item, '', true)) {
$success = false;
break;
}
}
if (!$success && !$returnResult) {
$this->fail($other, $description);
}
return $success;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'contains only values of type "' . $this->type . '"';
}
}
src/Framework/Constraint/Traversable/TraversableContainsIdentical.php 0000644 00000001717 15243426620 0022177 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use SplObjectStorage;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsIdentical extends TraversableContains
{
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof SplObjectStorage) {
return $other->contains($this->value());
}
foreach ($other as $element) {
if ($this->value() === $element) {
return true;
}
}
return false;
}
}
src/Framework/Constraint/Traversable/IsList.php 0000644 00000002471 15243426620 0015616 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_is_list;
use function is_array;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsList extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is a list';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (!is_array($other)) {
return false;
}
return array_is_list($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return $this->valueToTypeStringFragment($other) . $this->toString(true);
}
}
src/Framework/Constraint/Traversable/ArrayHasKey.php 0000644 00000003155 15243426620 0016572 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function array_key_exists;
use function is_array;
use ArrayAccess;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ArrayHasKey extends Constraint
{
private readonly int|string $key;
public function __construct(int|string $key)
{
$this->key = $key;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'has the key ' . Exporter::export($this->key);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (is_array($other)) {
return array_key_exists($this->key, $other);
}
if ($other instanceof ArrayAccess) {
return $other->offsetExists($this->key);
}
return false;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return 'an array ' . $this->toString(true);
}
}
src/Framework/Constraint/Traversable/TraversableContains.php 0000644 00000002616 15243426620 0020361 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_array;
use function sprintf;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class TraversableContains extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'contains ' . Exporter::export($this->value, $exportObjects);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'%s %s',
is_array($other) ? 'an array' : 'a traversable',
$this->toString(true),
);
}
protected function value(): mixed
{
return $this->value;
}
}
src/Framework/Constraint/Traversable/TraversableContainsEqual.php 0000644 00000002011 15243426620 0021336 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use SplObjectStorage;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class TraversableContainsEqual extends TraversableContains
{
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof SplObjectStorage) {
return $other->contains($this->value());
}
foreach ($other as $element) {
/* @noinspection TypeUnsafeComparisonInspection */
if ($this->value() == $element) {
return true;
}
}
return false;
}
}
src/Framework/Constraint/Constraint.php 0000644 00000020270 15243426620 0014256 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function sprintf;
use function strtolower;
use Countable;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
abstract class Constraint implements Countable, SelfDescribing
{
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
$success = false;
if ($this->matches($other)) {
$success = true;
}
if ($returnResult) {
return $success;
}
if (!$success) {
$this->fail($other, $description);
}
return null;
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return 1;
}
/**
* @deprecated
*/
protected function exporter(): \SebastianBergmann\Exporter\Exporter
{
return new \SebastianBergmann\Exporter\Exporter;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* This method can be overridden to implement the evaluation algorithm.
*/
protected function matches(mixed $other): bool
{
return false;
}
/**
* Throws an exception for the given compared value and test description.
*
* @throws ExpectationFailedException
*/
protected function fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): never
{
$failureDescription = sprintf(
'Failed asserting that %s.',
$this->failureDescription($other),
);
$additionalFailureDescription = $this->additionalFailureDescription($other);
if ($additionalFailureDescription) {
$failureDescription .= "\n" . $additionalFailureDescription;
}
if (!empty($description)) {
$failureDescription = $description . "\n" . $failureDescription;
}
throw new ExpectationFailedException(
$failureDescription,
$comparisonFailure,
);
}
/**
* Return additional failure description where needed.
*
* The function can be overridden to provide additional failure
* information like a diff
*/
protected function additionalFailureDescription(mixed $other): string
{
return '';
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* To provide additional failure information additionalFailureDescription
* can be used.
*/
protected function failureDescription(mixed $other): string
{
return Exporter::export($other, true) . ' ' . $this->toString(true);
}
/**
* Returns a custom string representation of the constraint object when it
* appears in context of an $operator expression.
*
* The purpose of this method is to provide meaningful descriptive string
* in context of operators such as LogicalNot. Native PHPUnit constraints
* are supported out of the box by LogicalNot, but externally developed
* ones had no way to provide correct strings in this context.
*
* The method shall return empty string, when it does not handle
* customization by itself.
*/
protected function toStringInContext(Operator $operator, mixed $role): string
{
return '';
}
/**
* Returns the description of the failure when this constraint appears in
* context of an $operator expression.
*
* The purpose of this method is to provide meaningful failure description
* in context of operators such as LogicalNot. Native PHPUnit constraints
* are supported out of the box by LogicalNot, but externally developed
* ones had no way to provide correct messages in this context.
*
* The method shall return empty string, when it does not handle
* customization by itself.
*/
protected function failureDescriptionInContext(Operator $operator, mixed $role, mixed $other): string
{
$string = $this->toStringInContext($operator, $role);
if ($string === '') {
return '';
}
return Exporter::export($other, true) . ' ' . $string;
}
/**
* Reduces the sub-expression starting at $this by skipping degenerate
* sub-expression and returns first descendant constraint that starts
* a non-reducible sub-expression.
*
* Returns $this for terminal constraints and for operators that start
* non-reducible sub-expression, or the nearest descendant of $this that
* starts a non-reducible sub-expression.
*
* A constraint expression may be modelled as a tree with non-terminal
* nodes (operators) and terminal nodes. For example:
*
* LogicalOr (operator, non-terminal)
* + LogicalAnd (operator, non-terminal)
* | + IsType('int') (terminal)
* | + GreaterThan(10) (terminal)
* + LogicalNot (operator, non-terminal)
* + IsType('array') (terminal)
*
* A degenerate sub-expression is a part of the tree, that effectively does
* not contribute to the evaluation of the expression it appears in. An example
* of degenerate sub-expression is a BinaryOperator constructed with single
* operand or nested BinaryOperators, each with single operand. An
* expression involving a degenerate sub-expression is equivalent to a
* reduced expression with the degenerate sub-expression removed, for example
*
* LogicalAnd (operator)
* + LogicalOr (degenerate operator)
* | + LogicalAnd (degenerate operator)
* | + IsType('int') (terminal)
* + GreaterThan(10) (terminal)
*
* is equivalent to
*
* LogicalAnd (operator)
* + IsType('int') (terminal)
* + GreaterThan(10) (terminal)
*
* because the subexpression
*
* + LogicalOr
* + LogicalAnd
* + -
*
* is degenerate. Calling reduce() on the LogicalOr object above, as well
* as on LogicalAnd, shall return the IsType('int') instance.
*
* Other specific reductions can be implemented, for example cascade of
* LogicalNot operators
*
* + LogicalNot
* + LogicalNot
* +LogicalNot
* + IsTrue
*
* can be reduced to
*
* LogicalNot
* + IsTrue
*/
protected function reduce(): self
{
return $this;
}
/**
* @psalm-return non-empty-string
*/
protected function valueToTypeStringFragment(mixed $value): string
{
$type = strtolower(gettype($value));
if ($type === 'double') {
$type = 'float';
}
if ($type === 'resource (closed)') {
$type = 'closed resource';
}
return match ($type) {
'array', 'integer', 'object' => 'an ' . $type . ' ',
'boolean', 'closed resource', 'float', 'resource', 'string' => 'a ' . $type . ' ',
'null' => 'null ',
default => 'a value of ' . $type . ' ',
};
}
}
src/Framework/Constraint/JsonMatches.php 0000644 00000005143 15243426620 0014352 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function json_decode;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\InvalidJsonException;
use PHPUnit\Util\Json;
use SebastianBergmann\Comparator\ComparisonFailure;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class JsonMatches extends Constraint
{
private readonly string $value;
public function __construct(string $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the object.
*/
public function toString(): string
{
return sprintf(
'matches JSON string "%s"',
$this->value,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* This method can be overridden to implement the evaluation algorithm.
*/
protected function matches(mixed $other): bool
{
[$error, $recodedOther] = Json::canonicalize($other);
if ($error) {
return false;
}
[$error, $recodedValue] = Json::canonicalize($this->value);
if ($error) {
return false;
}
return $recodedOther == $recodedValue;
}
/**
* Throws an exception for the given compared value and test description.
*
* @throws ExpectationFailedException
* @throws InvalidJsonException
*/
protected function fail(mixed $other, string $description, ?ComparisonFailure $comparisonFailure = null): never
{
if ($comparisonFailure === null) {
[$error, $recodedOther] = Json::canonicalize($other);
if ($error) {
parent::fail($other, $description);
}
[$error, $recodedValue] = Json::canonicalize($this->value);
if ($error) {
parent::fail($other, $description);
}
$comparisonFailure = new ComparisonFailure(
json_decode($this->value),
json_decode($other),
Json::prettify($recodedValue),
Json::prettify($recodedOther),
'Failed asserting that two json values are equal.',
);
}
parent::fail($other, $description, $comparisonFailure);
}
}
src/Framework/Constraint/Equality/IsEqualIgnoringCase.php 0000644 00000005554 15243426620 0017573 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualIgnoringCase extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
0.0,
false,
true,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
return sprintf(
'is equal to %s',
Exporter::export($this->value, $exportObjects),
);
}
}
src/Framework/Constraint/Equality/IsEqualWithDelta.php 0000644 00000005175 15243426620 0017107 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualWithDelta extends Constraint
{
private readonly mixed $value;
private readonly float $delta;
public function __construct(mixed $value, float $delta)
{
$this->value = $value;
$this->delta = $delta;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
$this->delta,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return sprintf(
'is equal to %s with delta <%F>',
Exporter::export($this->value, $exportObjects),
$this->delta,
);
}
}
src/Framework/Constraint/Equality/IsEqualCanonicalizing.php 0000644 00000005527 15243426620 0020153 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqualCanonicalizing extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
0.0,
true,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
return sprintf(
'is equal to %s',
Exporter::export($this->value, $exportObjects),
);
}
}
src/Framework/Constraint/Equality/IsEqual.php 0000644 00000006615 15243426620 0015301 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function sprintf;
use function str_contains;
use function trim;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use SebastianBergmann\Comparator\Factory as ComparatorFactory;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEqual extends Constraint
{
private readonly mixed $value;
private readonly float $delta;
private readonly bool $canonicalize;
private readonly bool $ignoreCase;
public function __construct(mixed $value, float $delta = 0.0, bool $canonicalize = false, bool $ignoreCase = false)
{
$this->value = $value;
$this->delta = $delta;
$this->canonicalize = $canonicalize;
$this->ignoreCase = $ignoreCase;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
// If $this->value and $other are identical, they are also equal.
// This is the most common path and will allow us to skip
// initialization of all the comparators.
if ($this->value === $other) {
return true;
}
$comparatorFactory = ComparatorFactory::getInstance();
try {
$comparator = $comparatorFactory->getComparatorFor(
$this->value,
$other,
);
$comparator->assertEquals(
$this->value,
$other,
$this->delta,
$this->canonicalize,
$this->ignoreCase,
);
} catch (ComparisonFailure $f) {
if ($returnResult) {
return false;
}
throw new ExpectationFailedException(
trim($description . "\n" . $f->getMessage()),
$f,
);
}
return true;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
$delta = '';
if (is_string($this->value)) {
if (str_contains($this->value, "\n")) {
return 'is equal to <text>';
}
return sprintf(
"is equal to '%s'",
$this->value,
);
}
if ($this->delta != 0) {
$delta = sprintf(
' with delta <%F>',
$this->delta,
);
}
return sprintf(
'is equal to %s%s',
Exporter::export($this->value, $exportObjects),
$delta,
);
}
}
src/Framework/Constraint/Callback.php 0000644 00000002347 15243426620 0013633 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @psalm-template CallbackInput of mixed
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Callback extends Constraint
{
/**
* @psalm-var callable(CallbackInput $input): bool
*/
private readonly mixed $callback;
/**
* @psalm-param callable(CallbackInput $input): bool $callback
*/
public function __construct(callable $callback)
{
$this->callback = $callback;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is accepted by specified callback';
}
/**
* Evaluates the constraint for parameter $value. Returns true if the
* constraint is met, false otherwise.
*
* @psalm-param CallbackInput $other
*/
protected function matches(mixed $other): bool
{
return ($this->callback)($other);
}
}
src/Framework/Constraint/Math/IsInfinite.php 0000644 00000001544 15243426620 0015067 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_infinite;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsInfinite extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is infinite';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_infinite($other);
}
}
src/Framework/Constraint/Math/IsNan.php 0000644 00000001520 15243426620 0014030 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_nan;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsNan extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is nan';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_nan($other);
}
}
src/Framework/Constraint/Math/IsFinite.php 0000644 00000001534 15243426620 0014537 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_finite;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsFinite extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is finite';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_finite($other);
}
}
src/Framework/Constraint/Boolean/IsFalse.php 0000644 00000001500 15243426620 0015032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsFalse extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is false';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === false;
}
}
src/Framework/Constraint/Boolean/IsTrue.php 0000644 00000001475 15243426620 0014732 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsTrue extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is true';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === true;
}
}
src/Framework/Constraint/IsIdentical.php 0000644 00000007332 15243426620 0014326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function explode;
use function gettype;
use function is_array;
use function is_object;
use function is_string;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Util\Exporter;
use SebastianBergmann\Comparator\ComparisonFailure;
use UnitEnum;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsIdentical extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
$success = $this->value === $other;
if ($returnResult) {
return $success;
}
if (!$success) {
$f = null;
// if both values are strings, make sure a diff is generated
if (is_string($this->value) && is_string($other)) {
$f = new ComparisonFailure(
$this->value,
$other,
sprintf("'%s'", $this->value),
sprintf("'%s'", $other),
);
}
// if both values are array or enums, make sure a diff is generated
if ((is_array($this->value) && is_array($other)) || ($this->value instanceof UnitEnum && $other instanceof UnitEnum)) {
$f = new ComparisonFailure(
$this->value,
$other,
Exporter::export($this->value, true),
Exporter::export($other, true),
);
}
$this->fail($other, $description, $f);
}
return null;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
if (is_object($this->value)) {
return 'is identical to an object of class "' .
$this->value::class . '"';
}
return 'is identical to ' . Exporter::export($this->value, $exportObjects);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if (is_object($this->value) && is_object($other)) {
return 'two variables reference the same object';
}
if (explode(' ', gettype($this->value), 2)[0] === 'resource' && explode(' ', gettype($other), 2)[0] === 'resource') {
return 'two variables reference the same resource';
}
if (is_string($this->value) && is_string($other)) {
return 'two strings are identical';
}
if (is_array($this->value) && is_array($other)) {
return 'two arrays are identical';
}
return parent::failureDescription($other);
}
}
src/Framework/Constraint/String/StringContains.php 0000644 00000010456 15243426620 0016352 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function mb_detect_encoding;
use function mb_stripos;
use function mb_strtolower;
use function sprintf;
use function str_contains;
use function strlen;
use function strtr;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringContains extends Constraint
{
private readonly string $needle;
private readonly bool $ignoreCase;
private readonly bool $ignoreLineEndings;
public function __construct(string $needle, bool $ignoreCase = false, bool $ignoreLineEndings = false)
{
if ($ignoreLineEndings) {
$needle = $this->normalizeLineEndings($needle);
}
$this->needle = $needle;
$this->ignoreCase = $ignoreCase;
$this->ignoreLineEndings = $ignoreLineEndings;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
$needle = $this->needle;
if ($this->ignoreCase) {
$needle = mb_strtolower($this->needle, 'UTF-8');
}
return sprintf(
'contains "%s" [%s](length: %s)',
$needle,
$this->getDetectedEncoding($needle),
strlen($needle),
);
}
public function failureDescription(mixed $other): string
{
$stringifiedHaystack = Exporter::export($other, true);
$haystackEncoding = $this->getDetectedEncoding($other);
$haystackLength = $this->getHaystackLength($other);
$haystackInformation = sprintf(
'%s [%s](length: %s) ',
$stringifiedHaystack,
$haystackEncoding,
$haystackLength,
);
$needleInformation = $this->toString(true);
return $haystackInformation . $needleInformation;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
$haystack = $other;
if ('' === $this->needle) {
return true;
}
if (!is_string($haystack)) {
return false;
}
if ($this->ignoreLineEndings) {
$haystack = $this->normalizeLineEndings($haystack);
}
if ($this->ignoreCase) {
/*
* We must use the multibyte-safe version, so we can accurately compare non-latin uppercase characters with
* their lowercase equivalents.
*/
return mb_stripos($haystack, $this->needle, 0, 'UTF-8') !== false;
}
/*
* Use the non-multibyte safe functions to see if the string is contained in $other.
*
* This function is very fast, and we don't care about the character position in the string.
*
* Additionally, we want this method to be binary safe, so we can check if some binary data is in other binary
* data.
*/
return str_contains($haystack, $this->needle);
}
private function getDetectedEncoding(mixed $other): string
{
if ($this->ignoreCase) {
return 'Encoding ignored';
}
if (!is_string($other)) {
return 'Encoding detection failed';
}
$detectedEncoding = mb_detect_encoding($other, null, true);
if ($detectedEncoding === false) {
return 'Encoding detection failed';
}
return $detectedEncoding;
}
private function getHaystackLength(mixed $haystack): int
{
if (!is_string($haystack)) {
return 0;
}
if ($this->ignoreLineEndings) {
$haystack = $this->normalizeLineEndings($haystack);
}
return strlen($haystack);
}
private function normalizeLineEndings(string $string): string
{
return strtr(
$string,
[
"\r\n" => "\n",
"\r" => "\n",
],
);
}
}
src/Framework/Constraint/String/StringMatchesFormatDescription.php 0000644 00000006306 15243426620 0021534 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use const DIRECTORY_SEPARATOR;
use function explode;
use function implode;
use function preg_match;
use function preg_quote;
use function preg_replace;
use function strtr;
use SebastianBergmann\Diff\Differ;
use SebastianBergmann\Diff\Output\UnifiedDiffOutputBuilder;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringMatchesFormatDescription extends Constraint
{
private readonly string $formatDescription;
public function __construct(string $formatDescription)
{
$this->formatDescription = $formatDescription;
}
public function toString(): string
{
return 'matches format description:' . PHP_EOL . $this->formatDescription;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
$other = $this->convertNewlines($other);
$matches = preg_match(
$this->regularExpressionForFormatDescription(
$this->convertNewlines($this->formatDescription),
),
$other,
);
return $matches > 0;
}
protected function failureDescription(mixed $other): string
{
return 'string matches format description';
}
protected function additionalFailureDescription(mixed $other): string
{
$from = explode("\n", $this->formatDescription);
$to = explode("\n", $this->convertNewlines($other));
foreach ($from as $index => $line) {
if (isset($to[$index]) && $line !== $to[$index]) {
$line = $this->regularExpressionForFormatDescription($line);
if (preg_match($line, $to[$index]) > 0) {
$from[$index] = $to[$index];
}
}
}
$from = implode("\n", $from);
$to = implode("\n", $to);
return $this->differ()->diff($from, $to);
}
private function regularExpressionForFormatDescription(string $string): string
{
$string = strtr(
preg_quote($string, '/'),
[
'%%' => '%',
'%e' => '\\' . DIRECTORY_SEPARATOR,
'%s' => '[^\r\n]+',
'%S' => '[^\r\n]*',
'%a' => '.+',
'%A' => '.*',
'%w' => '\s*',
'%i' => '[+-]?\d+',
'%d' => '\d+',
'%x' => '[0-9a-fA-F]+',
'%f' => '[+-]?\.?\d+\.?\d*(?:[Ee][+-]?\d+)?',
'%c' => '.',
],
);
return '/^' . $string . '$/s';
}
private function convertNewlines(string $text): string
{
return preg_replace('/\r\n/', "\n", $text);
}
private function differ(): Differ
{
return new Differ(new UnifiedDiffOutputBuilder("--- Expected\n+++ Actual\n"));
}
}
src/Framework/Constraint/String/StringEndsWith.php 0000644 00000002323 15243426620 0016313 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function str_ends_with;
use PHPUnit\Framework\EmptyStringException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringEndsWith extends Constraint
{
private readonly string $suffix;
/**
* @throws EmptyStringException
*/
public function __construct(string $suffix)
{
if ($suffix === '') {
throw new EmptyStringException;
}
$this->suffix = $suffix;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'ends with "' . $this->suffix . '"';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return str_ends_with((string) $other, $this->suffix);
}
}
src/Framework/Constraint/String/RegularExpression.php 0000644 00000002145 15243426620 0017062 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function preg_match;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class RegularExpression extends Constraint
{
private readonly string $pattern;
public function __construct(string $pattern)
{
$this->pattern = $pattern;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'matches PCRE pattern "%s"',
$this->pattern,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return preg_match($this->pattern, $other) > 0;
}
}
src/Framework/Constraint/String/IsJson.php 0000644 00000004560 15243426620 0014611 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_string;
use function json_decode;
use function json_last_error;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsJson extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is valid JSON';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if (!is_string($other) || $other === '') {
return false;
}
json_decode($other);
if (json_last_error()) {
return false;
}
return true;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if (!is_string($other)) {
return $this->valueToTypeStringFragment($other) . 'is valid JSON';
}
if ($other === '') {
return 'an empty string is valid JSON';
}
return sprintf(
'a string is valid JSON (%s)',
$this->determineJsonError($other),
);
}
private function determineJsonError(string $json): string
{
json_decode($json);
return match (json_last_error()) {
JSON_ERROR_NONE => '',
JSON_ERROR_DEPTH => 'Maximum stack depth exceeded',
JSON_ERROR_STATE_MISMATCH => 'Underflow or the modes mismatch',
JSON_ERROR_CTRL_CHAR => 'Unexpected control character found',
JSON_ERROR_SYNTAX => 'Syntax error, malformed JSON',
JSON_ERROR_UTF8 => 'Malformed UTF-8 characters, possibly incorrectly encoded',
default => 'Unknown error',
};
}
}
src/Framework/Constraint/String/StringStartsWith.php 0000644 00000002333 15243426620 0016703 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function str_starts_with;
use PHPUnit\Framework\EmptyStringException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringStartsWith extends Constraint
{
private readonly string $prefix;
/**
* @throws EmptyStringException
*/
public function __construct(string $prefix)
{
if ($prefix === '') {
throw new EmptyStringException;
}
$this->prefix = $prefix;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'starts with "' . $this->prefix . '"';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return str_starts_with((string) $other, $this->prefix);
}
}
src/Framework/Constraint/String/StringEqualsStringIgnoringLineEndings.php 0000644 00000002623 15243426620 0023027 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function strtr;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class StringEqualsStringIgnoringLineEndings extends Constraint
{
private readonly string $string;
public function __construct(string $string)
{
$this->string = $this->normalizeLineEndings($string);
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is equal to "%s" ignoring line endings',
$this->string,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->string === $this->normalizeLineEndings((string) $other);
}
private function normalizeLineEndings(string $string): string
{
return strtr(
$string,
[
"\r\n" => "\n",
"\r" => "\n",
],
);
}
}
src/Framework/Constraint/Type/IsNull.php 0000644 00000001475 15243426620 0014267 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsNull extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is null';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other === null;
}
}
src/Framework/Constraint/Type/IsInstanceOf.php 0000644 00000003760 15243426620 0015405 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function class_exists;
use function interface_exists;
use function sprintf;
use PHPUnit\Framework\UnknownClassOrInterfaceException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsInstanceOf extends Constraint
{
/**
* @psalm-var class-string
*/
private readonly string $name;
/**
* @psalm-var 'class'|'interface'
*/
private readonly string $type;
/**
* @throws UnknownClassOrInterfaceException
*/
public function __construct(string $name)
{
if (class_exists($name)) {
$this->type = 'class';
} elseif (interface_exists($name)) {
$this->type = 'interface';
} else {
throw new UnknownClassOrInterfaceException($name);
}
$this->name = $name;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is an instance of %s %s',
$this->type,
$this->name,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other instanceof $this->name;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return $this->valueToTypeStringFragment($other) . $this->toString(true);
}
}
src/Framework/Constraint/Type/IsType.php 0000644 00000011324 15243426620 0014270 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function is_array;
use function is_bool;
use function is_callable;
use function is_float;
use function is_int;
use function is_iterable;
use function is_numeric;
use function is_object;
use function is_scalar;
use function is_string;
use function sprintf;
use PHPUnit\Framework\UnknownTypeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsType extends Constraint
{
/**
* @var string
*/
public const TYPE_ARRAY = 'array';
/**
* @var string
*/
public const TYPE_BOOL = 'bool';
/**
* @var string
*/
public const TYPE_FLOAT = 'float';
/**
* @var string
*/
public const TYPE_INT = 'int';
/**
* @var string
*/
public const TYPE_NULL = 'null';
/**
* @var string
*/
public const TYPE_NUMERIC = 'numeric';
/**
* @var string
*/
public const TYPE_OBJECT = 'object';
/**
* @var string
*/
public const TYPE_RESOURCE = 'resource';
/**
* @var string
*/
public const TYPE_CLOSED_RESOURCE = 'resource (closed)';
/**
* @var string
*/
public const TYPE_STRING = 'string';
/**
* @var string
*/
public const TYPE_SCALAR = 'scalar';
/**
* @var string
*/
public const TYPE_CALLABLE = 'callable';
/**
* @var string
*/
public const TYPE_ITERABLE = 'iterable';
/**
* @psalm-var array<string,bool>
*/
private const KNOWN_TYPES = [
'array' => true,
'boolean' => true,
'bool' => true,
'double' => true,
'float' => true,
'integer' => true,
'int' => true,
'null' => true,
'numeric' => true,
'object' => true,
'real' => true,
'resource' => true,
'resource (closed)' => true,
'string' => true,
'scalar' => true,
'callable' => true,
'iterable' => true,
];
/**
* @psalm-var 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable'
*/
private readonly string $type;
/**
* @psalm-param 'array'|'boolean'|'bool'|'double'|'float'|'integer'|'int'|'null'|'numeric'|'object'|'real'|'resource'|'resource (closed)'|'string'|'scalar'|'callable'|'iterable' $type
*
* @throws UnknownTypeException
*/
public function __construct(string $type)
{
if (!isset(self::KNOWN_TYPES[$type])) {
throw new UnknownTypeException($type);
}
$this->type = $type;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'is of type %s',
$this->type,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
switch ($this->type) {
case 'numeric':
return is_numeric($other);
case 'integer':
case 'int':
return is_int($other);
case 'double':
case 'float':
case 'real':
return is_float($other);
case 'string':
return is_string($other);
case 'boolean':
case 'bool':
return is_bool($other);
case 'null':
return null === $other;
case 'array':
return is_array($other);
case 'object':
return is_object($other);
case 'resource':
$type = gettype($other);
return $type === 'resource' || $type === 'resource (closed)';
case 'resource (closed)':
return gettype($other) === 'resource (closed)';
case 'scalar':
return is_scalar($other);
case 'callable':
return is_callable($other);
case 'iterable':
return is_iterable($other);
default:
return false;
}
}
}
src/Framework/Constraint/Cardinality/IsEmpty.php 0000644 00000003200 15243426620 0015761 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
use function gettype;
use function sprintf;
use function str_starts_with;
use Countable;
use EmptyIterator;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsEmpty extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is empty';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
if ($other instanceof EmptyIterator) {
return true;
}
if ($other instanceof Countable) {
return count($other) === 0;
}
return empty($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
$type = gettype($other);
return sprintf(
'%s %s %s',
str_starts_with($type, 'a') || str_starts_with($type, 'o') ? 'an' : 'a',
$type,
$this->toString(true),
);
}
}
src/Framework/Constraint/Cardinality/SameSize.php 0000644 00000001310 15243426620 0016107 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use Countable;
use PHPUnit\Framework\Exception;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class SameSize extends Count
{
/**
* @psalm-param Countable|iterable $expected
*
* @throws Exception
*/
public function __construct($expected)
{
parent::__construct((int) $this->getCountOf($expected));
}
}
src/Framework/Constraint/Cardinality/LessThan.php 0000644 00000002061 15243426620 0016114 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class LessThan extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'is less than ' . Exporter::export($this->value, $exportObjects);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->value > $other;
}
}
src/Framework/Constraint/Cardinality/GreaterThan.php 0000644 00000002067 15243426620 0016605 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Util\Exporter;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class GreaterThan extends Constraint
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(bool $exportObjects = false): string
{
return 'is greater than ' . Exporter::export($this->value, $exportObjects);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $this->value < $other;
}
}
src/Framework/Constraint/Cardinality/Count.php 0000644 00000006254 15243426620 0015473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function count;
use function is_countable;
use function iterator_count;
use function sprintf;
use EmptyIterator;
use Generator;
use Iterator;
use IteratorAggregate;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\GeneratorNotSupportedException;
use Traversable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
class Count extends Constraint
{
private readonly int $expectedCount;
public function __construct(int $expected)
{
$this->expectedCount = $expected;
}
public function toString(): string
{
return sprintf(
'count matches %d',
$this->expectedCount,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws Exception
*/
protected function matches(mixed $other): bool
{
return $this->expectedCount === $this->getCountOf($other);
}
/**
* @throws Exception
*/
protected function getCountOf(mixed $other): ?int
{
if (is_countable($other)) {
return count($other);
}
if ($other instanceof EmptyIterator) {
return 0;
}
if ($other instanceof Traversable) {
while ($other instanceof IteratorAggregate) {
try {
$other = $other->getIterator();
} catch (\Exception $e) {
throw new Exception(
$e->getMessage(),
$e->getCode(),
$e,
);
}
}
$iterator = $other;
if ($iterator instanceof Generator) {
throw new GeneratorNotSupportedException;
}
if (!$iterator instanceof Iterator) {
return iterator_count($iterator);
}
$key = $iterator->key();
$count = iterator_count($iterator);
// Manually rewind $iterator to previous key, since iterator_count
// moves pointer.
if ($key !== null) {
$iterator->rewind();
while ($iterator->valid() && $key !== $iterator->key()) {
$iterator->next();
}
}
return $count;
}
return null;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @throws Exception
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'actual size %d matches expected size %d',
(int) $this->getCountOf($other),
$this->expectedCount,
);
}
}
src/Framework/Constraint/Filesystem/IsWritable.php 0000644 00000002372 15243426620 0016326 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_writable;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsWritable extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is writable';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_writable($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'"%s" is writable',
$other,
);
}
}
src/Framework/Constraint/Filesystem/IsReadable.php 0000644 00000002372 15243426620 0016254 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_readable;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsReadable extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is readable';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_readable($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'"%s" is readable',
$other,
);
}
}
src/Framework/Constraint/Filesystem/FileExists.php 0000644 00000002372 15243426620 0016340 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function file_exists;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class FileExists extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'file exists';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return file_exists($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'file "%s" exists',
$other,
);
}
}
src/Framework/Constraint/Filesystem/DirectoryExists.php 0000644 00000002377 15243426620 0017432 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_dir;
use function sprintf;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryExists extends Constraint
{
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'directory exists';
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return is_dir($other);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'directory "%s" exists',
$other,
);
}
}
src/Framework/Constraint/Exception/ExceptionCode.php 0000644 00000002744 15243426620 0016627 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionCode extends Constraint
{
private readonly int|string $expectedCode;
public function __construct(int|string $expected)
{
$this->expectedCode = $expected;
}
public function toString(): string
{
return 'exception code is ' . $this->expectedCode;
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return (string) $other === (string) $this->expectedCode;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
'%s is equal to expected exception code %s',
Exporter::export($other, true),
Exporter::export($this->expectedCode, true),
);
}
}
src/Framework/Constraint/Exception/ExceptionMessageIsOrContains.php 0000644 00000003376 15243426620 0021637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use function str_contains;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionMessageIsOrContains extends Constraint
{
private readonly string $expectedMessage;
public function __construct(string $expectedMessage)
{
$this->expectedMessage = $expectedMessage;
}
public function toString(): string
{
if ($this->expectedMessage === '') {
return 'exception message is empty';
}
return 'exception message contains ' . Exporter::export($this->expectedMessage);
}
protected function matches(mixed $other): bool
{
if ($this->expectedMessage === '') {
return $other === '';
}
return str_contains((string) $other, $this->expectedMessage);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
if ($this->expectedMessage === '') {
return sprintf(
"exception message is empty but is '%s'",
$other,
);
}
return sprintf(
"exception message '%s' contains '%s'",
$other,
$this->expectedMessage,
);
}
}
src/Framework/Constraint/Exception/Exception.php 0000644 00000003770 15243426620 0016034 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function sprintf;
use PHPUnit\Util\Filter;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends Constraint
{
private readonly string $className;
public function __construct(string $className)
{
$this->className = $className;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'exception of type "%s"',
$this->className,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*/
protected function matches(mixed $other): bool
{
return $other instanceof $this->className;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @throws \PHPUnit\Framework\Exception
*/
protected function failureDescription(mixed $other): string
{
if ($other === null) {
return sprintf(
'exception of type "%s" is thrown',
$this->className,
);
}
$message = '';
if ($other instanceof Throwable) {
$message = '. Message was: "' . $other->getMessage() . '" at'
. "\n" . Filter::getFilteredStacktrace($other);
}
return sprintf(
'exception of type "%s" matches expected exception "%s"%s',
$other::class,
$this->className,
$message,
);
}
}
src/Framework/Constraint/Exception/ExceptionMessageMatchesRegularExpression.php 0000644 00000003672 15243426620 0024251 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function preg_match;
use function sprintf;
use Exception;
use PHPUnit\Util\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExceptionMessageMatchesRegularExpression extends Constraint
{
private readonly string $regularExpression;
public function __construct(string $regularExpression)
{
$this->regularExpression = $regularExpression;
}
public function toString(): string
{
return 'exception message matches ' . Exporter::export($this->regularExpression);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @throws \PHPUnit\Framework\Exception
* @throws Exception
*/
protected function matches(mixed $other): bool
{
$match = @preg_match($this->regularExpression, (string) $other);
if ($match === false) {
throw new \PHPUnit\Framework\Exception(
sprintf(
'Invalid expected exception message regular expression given: %s',
$this->regularExpression,
),
);
}
return $match === 1;
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*/
protected function failureDescription(mixed $other): string
{
return sprintf(
"exception message '%s' matches '%s'",
$other,
$this->regularExpression,
);
}
}
src/Framework/Constraint/Object/ObjectEquals.php 0000644 00000010435 15243426620 0015723 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function is_object;
use PHPUnit\Framework\ActualValueIsNotAnObjectException;
use PHPUnit\Framework\ComparisonMethodDoesNotAcceptParameterTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareBoolReturnTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareExactlyOneParameterException;
use PHPUnit\Framework\ComparisonMethodDoesNotDeclareParameterTypeException;
use PHPUnit\Framework\ComparisonMethodDoesNotExistException;
use ReflectionNamedType;
use ReflectionObject;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ObjectEquals extends Constraint
{
private readonly object $expected;
private readonly string $method;
public function __construct(object $object, string $method = 'equals')
{
$this->expected = $object;
$this->method = $method;
}
public function toString(): string
{
return 'two objects are equal';
}
/**
* @throws ActualValueIsNotAnObjectException
* @throws ComparisonMethodDoesNotAcceptParameterTypeException
* @throws ComparisonMethodDoesNotDeclareBoolReturnTypeException
* @throws ComparisonMethodDoesNotDeclareExactlyOneParameterException
* @throws ComparisonMethodDoesNotDeclareParameterTypeException
* @throws ComparisonMethodDoesNotExistException
*/
protected function matches(mixed $other): bool
{
if (!is_object($other)) {
throw new ActualValueIsNotAnObjectException;
}
$object = new ReflectionObject($other);
if (!$object->hasMethod($this->method)) {
throw new ComparisonMethodDoesNotExistException(
$other::class,
$this->method,
);
}
$method = $object->getMethod($this->method);
if (!$method->hasReturnType()) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
$returnType = $method->getReturnType();
if (!$returnType instanceof ReflectionNamedType) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($returnType->allowsNull()) {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($returnType->getName() !== 'bool') {
throw new ComparisonMethodDoesNotDeclareBoolReturnTypeException(
$other::class,
$this->method,
);
}
if ($method->getNumberOfParameters() !== 1 || $method->getNumberOfRequiredParameters() !== 1) {
throw new ComparisonMethodDoesNotDeclareExactlyOneParameterException(
$other::class,
$this->method,
);
}
$parameter = $method->getParameters()[0];
if (!$parameter->hasType()) {
throw new ComparisonMethodDoesNotDeclareParameterTypeException(
$other::class,
$this->method,
);
}
$type = $parameter->getType();
if (!$type instanceof ReflectionNamedType) {
throw new ComparisonMethodDoesNotDeclareParameterTypeException(
$other::class,
$this->method,
);
}
$typeName = $type->getName();
if ($typeName === 'self') {
$typeName = $other::class;
}
if (!$this->expected instanceof $typeName) {
throw new ComparisonMethodDoesNotAcceptParameterTypeException(
$other::class,
$this->method,
$this->expected::class,
);
}
return $other->{$this->method}($this->expected);
}
protected function failureDescription(mixed $other): string
{
return $this->toString(true);
}
}
src/Framework/Constraint/Object/ObjectHasProperty.php 0000644 00000004000 15243426620 0016740 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use function gettype;
use function is_object;
use function sprintf;
use ReflectionObject;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ObjectHasProperty extends Constraint
{
private readonly string $propertyName;
public function __construct(string $propertyName)
{
$this->propertyName = $propertyName;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return sprintf(
'has property "%s"',
$this->propertyName,
);
}
/**
* Evaluates the constraint for parameter $other. Returns true if the
* constraint is met, false otherwise.
*
* @param mixed $other value or object to evaluate
*/
protected function matches(mixed $other): bool
{
if (!is_object($other)) {
return false;
}
return (new ReflectionObject($other))->hasProperty($this->propertyName);
}
/**
* Returns the description of the failure.
*
* The beginning of failure messages is "Failed asserting that" in most
* cases. This method should return the second part of that sentence.
*
* @param mixed $other evaluated value or object
*/
protected function failureDescription(mixed $other): string
{
if (is_object($other)) {
return sprintf(
'object of class "%s" %s',
$other::class,
$this->toString(true),
);
}
return sprintf(
'"%s" (%s) %s',
$other,
gettype($other),
$this->toString(true),
);
}
}
src/Framework/Constraint/IsAnything.php 0000644 00000002552 15243426620 0014212 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\Constraint;
use PHPUnit\Framework\ExpectationFailedException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class IsAnything extends Constraint
{
/**
* Evaluates the constraint for parameter $other.
*
* If $returnResult is set to false (the default), an exception is thrown
* in case of a failure. null is returned otherwise.
*
* If $returnResult is true, the result of the evaluation is returned as
* a boolean value instead: true in case of success, false in case of a
* failure.
*
* @throws ExpectationFailedException
*/
public function evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
{
return $returnResult ? true : null;
}
/**
* Returns a string representation of the constraint.
*/
public function toString(): string
{
return 'is anything';
}
/**
* Counts the number of constraint elements.
*/
public function count(): int
{
return 0;
}
}
src/Framework/SelfDescribing.php 0000644 00000001007 15243426620 0012666 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface SelfDescribing
{
/**
* Returns a string representation of the object.
*/
public function toString(): string;
}
src/Framework/MockObject/Runtime/Invocation.php 0000644 00000007426 15243426620 0015572 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_map;
use function implode;
use function is_object;
use function sprintf;
use function str_starts_with;
use function strtolower;
use function substr;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Util\Cloner;
use SebastianBergmann\Exporter\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Invocation implements SelfDescribing
{
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly array $parameters;
private readonly string $returnType;
private readonly bool $isReturnTypeNullable;
private readonly bool $proxiedCall;
private readonly MockObjectInternal|StubInternal $object;
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName, array $parameters, string $returnType, MockObjectInternal|StubInternal $object, bool $cloneObjects = false, bool $proxiedCall = false)
{
$this->className = $className;
$this->methodName = $methodName;
$this->object = $object;
$this->proxiedCall = $proxiedCall;
if (strtolower($methodName) === '__tostring') {
$returnType = 'string';
}
if (str_starts_with($returnType, '?')) {
$returnType = substr($returnType, 1);
$this->isReturnTypeNullable = true;
} else {
$this->isReturnTypeNullable = false;
}
$this->returnType = $returnType;
if (!$cloneObjects) {
$this->parameters = $parameters;
return;
}
foreach ($parameters as $key => $value) {
if (is_object($value)) {
$parameters[$key] = Cloner::clone($value);
}
}
$this->parameters = $parameters;
}
/**
* @psalm-return class-string
*/
public function className(): string
{
return $this->className;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
public function parameters(): array
{
return $this->parameters;
}
/**
* @throws Exception
*/
public function generateReturnValue(): mixed
{
if ($this->returnType === 'never') {
throw new NeverReturningMethodException(
$this->className,
$this->methodName,
);
}
if ($this->isReturnTypeNullable || $this->proxiedCall) {
return null;
}
return (new ReturnValueGenerator)->generate(
$this->className,
$this->methodName,
$this->object::class,
$this->returnType,
);
}
public function toString(): string
{
$exporter = new Exporter;
return sprintf(
'%s::%s(%s)%s',
$this->className,
$this->methodName,
implode(
', ',
array_map(
[$exporter, 'shortenedExport'],
$this->parameters,
),
),
$this->returnType ? sprintf(': %s', $this->returnType) : '',
);
}
public function object(): MockObjectInternal|StubInternal
{
return $this->object;
}
}
src/Framework/MockObject/Runtime/Builder/InvocationStubber.php 0000644 00000002203 15243426620 0020473 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\MockObject\Stub\Stub;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface InvocationStubber
{
public function will(Stub $stub): Identity;
public function willReturn(mixed $value, mixed ...$nextValues): self;
public function willReturnReference(mixed &$reference): self;
/**
* @psalm-param array<int, array<int, mixed>> $valueMap
*/
public function willReturnMap(array $valueMap): self;
public function willReturnArgument(int $argumentIndex): self;
public function willReturnCallback(callable $callback): self;
public function willReturnSelf(): self;
public function willReturnOnConsecutiveCalls(mixed ...$values): self;
public function willThrowException(Throwable $exception): self;
}
src/Framework/MockObject/Runtime/Builder/InvocationMocker.php 0000644 00000021556 15243426620 0020321 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use function array_flip;
use function array_key_exists;
use function array_map;
use function array_merge;
use function array_pop;
use function assert;
use function count;
use function is_string;
use function range;
use function strtolower;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
use PHPUnit\Framework\MockObject\IncompatibleReturnValueException;
use PHPUnit\Framework\MockObject\InvocationHandler;
use PHPUnit\Framework\MockObject\Matcher;
use PHPUnit\Framework\MockObject\MatcherAlreadyRegisteredException;
use PHPUnit\Framework\MockObject\MethodCannotBeConfiguredException;
use PHPUnit\Framework\MockObject\MethodNameAlreadyConfiguredException;
use PHPUnit\Framework\MockObject\MethodNameNotConfiguredException;
use PHPUnit\Framework\MockObject\MethodParametersAlreadyConfiguredException;
use PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls;
use PHPUnit\Framework\MockObject\Stub\Exception;
use PHPUnit\Framework\MockObject\Stub\ReturnArgument;
use PHPUnit\Framework\MockObject\Stub\ReturnCallback;
use PHPUnit\Framework\MockObject\Stub\ReturnReference;
use PHPUnit\Framework\MockObject\Stub\ReturnSelf;
use PHPUnit\Framework\MockObject\Stub\ReturnStub;
use PHPUnit\Framework\MockObject\Stub\ReturnValueMap;
use PHPUnit\Framework\MockObject\Stub\Stub;
use Throwable;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class InvocationMocker implements InvocationStubber, MethodNameMatch
{
private readonly InvocationHandler $invocationHandler;
private readonly Matcher $matcher;
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
/**
* @psalm-var ?array<string, int>
*/
private ?array $configurableMethodNames = null;
public function __construct(InvocationHandler $handler, Matcher $matcher, ConfigurableMethod ...$configurableMethods)
{
$this->invocationHandler = $handler;
$this->matcher = $matcher;
$this->configurableMethods = $configurableMethods;
}
/**
* @throws MatcherAlreadyRegisteredException
*
* @return $this
*/
public function id(string $id): self
{
$this->invocationHandler->registerMatcher($id, $this->matcher);
return $this;
}
/**
* @return $this
*/
public function will(Stub $stub): Identity
{
$this->matcher->setStub($stub);
return $this;
}
/**
* @throws IncompatibleReturnValueException
*/
public function willReturn(mixed $value, mixed ...$nextValues): self
{
if (count($nextValues) === 0) {
$this->ensureTypeOfReturnValues([$value]);
$stub = $value instanceof Stub ? $value : new ReturnStub($value);
return $this->will($stub);
}
$values = array_merge([$value], $nextValues);
$this->ensureTypeOfReturnValues($values);
$stub = new ConsecutiveCalls($values);
return $this->will($stub);
}
public function willReturnReference(mixed &$reference): self
{
$stub = new ReturnReference($reference);
return $this->will($stub);
}
public function willReturnMap(array $valueMap): self
{
$method = $this->configuredMethod();
assert($method instanceof ConfigurableMethod);
$numberOfParameters = $method->numberOfParameters();
$defaultValues = $method->defaultParameterValues();
$hasDefaultValues = !empty($defaultValues);
$_valueMap = [];
foreach ($valueMap as $mapping) {
$numberOfConfiguredParameters = count($mapping) - 1;
if ($numberOfConfiguredParameters === $numberOfParameters || !$hasDefaultValues) {
$_valueMap[] = $mapping;
continue;
}
$_mapping = [];
$returnValue = array_pop($mapping);
foreach (range(0, $numberOfParameters - 1) as $i) {
if (isset($mapping[$i])) {
$_mapping[] = $mapping[$i];
continue;
}
if (isset($defaultValues[$i])) {
$_mapping[] = $defaultValues[$i];
}
}
$_mapping[] = $returnValue;
$_valueMap[] = $_mapping;
}
$stub = new ReturnValueMap($_valueMap);
return $this->will($stub);
}
public function willReturnArgument(int $argumentIndex): self
{
$stub = new ReturnArgument($argumentIndex);
return $this->will($stub);
}
public function willReturnCallback(callable $callback): self
{
$stub = new ReturnCallback($callback);
return $this->will($stub);
}
public function willReturnSelf(): self
{
$stub = new ReturnSelf;
return $this->will($stub);
}
public function willReturnOnConsecutiveCalls(mixed ...$values): self
{
$stub = new ConsecutiveCalls($values);
return $this->will($stub);
}
public function willThrowException(Throwable $exception): self
{
$stub = new Exception($exception);
return $this->will($stub);
}
/**
* @return $this
*/
public function after(string $id): self
{
$this->matcher->setAfterMatchBuilderId($id);
return $this;
}
/**
* @throws \PHPUnit\Framework\Exception
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*
* @return $this
*/
public function with(mixed ...$arguments): self
{
$this->ensureParametersCanBeConfigured();
$this->matcher->setParametersRule(new Rule\Parameters($arguments));
return $this;
}
/**
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*
* @return $this
*/
public function withAnyParameters(): self
{
$this->ensureParametersCanBeConfigured();
$this->matcher->setParametersRule(new Rule\AnyParameters);
return $this;
}
/**
* @throws InvalidArgumentException
* @throws MethodCannotBeConfiguredException
* @throws MethodNameAlreadyConfiguredException
*
* @return $this
*/
public function method(Constraint|string $constraint): self
{
if ($this->matcher->hasMethodNameRule()) {
throw new MethodNameAlreadyConfiguredException;
}
if (is_string($constraint)) {
$this->configurableMethodNames ??= array_flip(
array_map(
static fn (ConfigurableMethod $configurable) => strtolower($configurable->name()),
$this->configurableMethods,
),
);
if (!array_key_exists(strtolower($constraint), $this->configurableMethodNames)) {
throw new MethodCannotBeConfiguredException($constraint);
}
}
$this->matcher->setMethodNameRule(new Rule\MethodName($constraint));
return $this;
}
/**
* @throws MethodNameNotConfiguredException
* @throws MethodParametersAlreadyConfiguredException
*/
private function ensureParametersCanBeConfigured(): void
{
if (!$this->matcher->hasMethodNameRule()) {
throw new MethodNameNotConfiguredException;
}
if ($this->matcher->hasParametersRule()) {
throw new MethodParametersAlreadyConfiguredException;
}
}
private function configuredMethod(): ?ConfigurableMethod
{
$configuredMethod = null;
foreach ($this->configurableMethods as $configurableMethod) {
if ($this->matcher->methodNameRule()->matchesName($configurableMethod->name())) {
if ($configuredMethod !== null) {
return null;
}
$configuredMethod = $configurableMethod;
}
}
return $configuredMethod;
}
/**
* @throws IncompatibleReturnValueException
*/
private function ensureTypeOfReturnValues(array $values): void
{
$configuredMethod = $this->configuredMethod();
if ($configuredMethod === null) {
return;
}
foreach ($values as $value) {
if (!$configuredMethod->mayReturn($value)) {
throw new IncompatibleReturnValueException(
$configuredMethod,
$value,
);
}
}
}
}
src/Framework/MockObject/Runtime/Builder/ParametersMatch.php 0000644 00000002777 15243426620 0020133 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface ParametersMatch extends Stub
{
/**
* Defines the expectation which must occur before the current is valid.
*/
public function after(string $id): Stub;
/**
* Sets the parameters to match for, each parameter to this function will
* be part of match. To perform specific matches or constraints create a
* new PHPUnit\Framework\Constraint\Constraint and use it for the parameter.
* If the parameter value is not a constraint it will use the
* PHPUnit\Framework\Constraint\IsEqual for the value.
*
* Some examples:
* <code>
* // match first parameter with value 2
* $b->with(2);
* // match first parameter with value 'smock' and second identical to 42
* $b->with('smock', new PHPUnit\Framework\Constraint\IsEqual(42));
* </code>
*/
public function with(mixed ...$arguments): self;
/**
* Sets a rule which allows any kind of parameters.
*
* Some examples:
* <code>
* // match any number of parameters
* $b->withAnyParameters();
* </code>
*/
public function withAnyParameters(): self;
}
src/Framework/MockObject/Runtime/Builder/Stub.php 0000644 00000001303 15243426620 0015750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\MockObject\Stub\Stub as BaseStub;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Stub extends Identity
{
/**
* Stubs the matching method with the stub object $stub. Any invocations of
* the matched method will now be handled by the stub instead.
*/
public function will(BaseStub $stub): Identity;
}
src/Framework/MockObject/Runtime/Builder/MethodNameMatch.php 0000644 00000001272 15243426620 0020036 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
use PHPUnit\Framework\Constraint\Constraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface MethodNameMatch extends ParametersMatch
{
/**
* Adds a new method name match and returns the parameter match object for
* further matching possibilities.
*/
public function method(Constraint|string $constraint): self;
}
src/Framework/MockObject/Runtime/Builder/Identity.php 0000644 00000001130 15243426620 0016622 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Builder;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Identity
{
/**
* Sets the identification of the expectation to $id.
*
* @note The identifier is unique per mock object.
*/
public function id(string $id): self;
}
src/Framework/MockObject/Runtime/Rule/InvocationOrder.php 0000644 00000002327 15243426620 0017470 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function count;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
use PHPUnit\Framework\SelfDescribing;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class InvocationOrder implements SelfDescribing
{
/**
* @psalm-var list<BaseInvocation>
*/
private array $invocations = [];
public function numberOfInvocations(): int
{
return count($this->invocations);
}
public function hasBeenInvoked(): bool
{
return count($this->invocations) > 0;
}
final public function invoked(BaseInvocation $invocation): void
{
$this->invocations[] = $invocation;
$this->invokedDo($invocation);
}
abstract public function matches(BaseInvocation $invocation): bool;
abstract public function verify(): void;
protected function invokedDo(BaseInvocation $invocation): void
{
}
}
src/Framework/MockObject/Runtime/Rule/ParametersRule.php 0000644 00000001353 15243426620 0017314 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface ParametersRule
{
/**
* @throws ExpectationFailedException if the invocation violates the rule
*/
public function apply(BaseInvocation $invocation): void;
public function verify(): void;
}
src/Framework/MockObject/Runtime/Rule/AnyInvokedCount.php 0000644 00000001364 15243426620 0017443 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnyInvokedCount extends InvocationOrder
{
public function toString(): string
{
return 'invoked zero or more times';
}
public function verify(): void
{
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
src/Framework/MockObject/Runtime/Rule/InvokedAtMostCount.php 0000644 00000003527 15243426620 0020126 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtMostCount extends InvocationOrder
{
private readonly int $allowedInvocations;
public function __construct(int $allowedInvocations)
{
$this->allowedInvocations = $allowedInvocations;
}
public function toString(): string
{
return sprintf(
'invoked at most %d time%s',
$this->allowedInvocations,
$this->allowedInvocations !== 1 ? 's' : '',
);
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualInvocations = $this->numberOfInvocations();
if ($actualInvocations > $this->allowedInvocations) {
throw new ExpectationFailedException(
sprintf(
'Expected invocation at most %d time%s but it occurred %d time%s.',
$this->allowedInvocations,
$this->allowedInvocations !== 1 ? 's' : '',
$actualInvocations,
$actualInvocations !== 1 ? 's' : '',
),
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
src/Framework/MockObject/Runtime/Rule/InvokedCount.php 0000644 00000005106 15243426620 0016771 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedCount extends InvocationOrder
{
private readonly int $expectedCount;
public function __construct(int $expectedCount)
{
$this->expectedCount = $expectedCount;
}
public function isNever(): bool
{
return $this->expectedCount === 0;
}
public function toString(): string
{
return sprintf(
'invoked %d time%s',
$this->expectedCount,
$this->expectedCount !== 1 ? 's' : '',
);
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualCount = $this->numberOfInvocations();
if ($actualCount !== $this->expectedCount) {
throw new ExpectationFailedException(
sprintf(
'Method was expected to be called %d time%s, actually called %d time%s.',
$this->expectedCount,
$this->expectedCount !== 1 ? 's' : '',
$actualCount,
$actualCount !== 1 ? 's' : '',
),
);
}
}
/**
* @throws ExpectationFailedException
*/
protected function invokedDo(BaseInvocation $invocation): void
{
$count = $this->numberOfInvocations();
if ($count > $this->expectedCount) {
$message = $invocation->toString() . ' ';
$message .= match ($this->expectedCount) {
0 => 'was not expected to be called.',
1 => 'was not expected to be called more than once.',
default => sprintf(
'was not expected to be called more than %d times.',
$this->expectedCount,
),
};
throw new ExpectationFailedException($message);
}
}
}
src/Framework/MockObject/Runtime/Rule/InvokedAtLeastOnce.php 0000644 00000002330 15243426620 0020037 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtLeastOnce extends InvocationOrder
{
public function toString(): string
{
return 'invoked at least once';
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$count = $this->numberOfInvocations();
if ($count < 1) {
throw new ExpectationFailedException(
'Expected invocation at least once but it never occurred.',
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
src/Framework/MockObject/Runtime/Rule/AnyParameters.php 0000644 00000001174 15243426620 0017135 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class AnyParameters implements ParametersRule
{
public function apply(BaseInvocation $invocation): void
{
}
public function verify(): void
{
}
}
src/Framework/MockObject/Runtime/Rule/Parameters.php 0000644 00000010044 15243426620 0016461 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function count;
use function sprintf;
use Exception;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\Constraint\IsAnything;
use PHPUnit\Framework\Constraint\IsEqual;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Parameters implements ParametersRule
{
/**
* @psalm-var list<Constraint>
*/
private array $parameters = [];
private ?BaseInvocation $invocation = null;
private null|bool|ExpectationFailedException $parameterVerificationResult;
/**
* @throws \PHPUnit\Framework\Exception
*/
public function __construct(array $parameters)
{
foreach ($parameters as $parameter) {
if (!($parameter instanceof Constraint)) {
$parameter = new IsEqual(
$parameter,
);
}
$this->parameters[] = $parameter;
}
}
/**
* @throws Exception
*/
public function apply(BaseInvocation $invocation): void
{
$this->invocation = $invocation;
$this->parameterVerificationResult = null;
try {
$this->parameterVerificationResult = $this->doVerify();
} catch (ExpectationFailedException $e) {
$this->parameterVerificationResult = $e;
throw $this->parameterVerificationResult;
}
}
/**
* Checks if the invocation $invocation matches the current rules. If it
* does the rule will get the invoked() method called which should check
* if an expectation is met.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$this->doVerify();
}
/**
* @throws ExpectationFailedException
*/
private function doVerify(): bool
{
if (isset($this->parameterVerificationResult)) {
return $this->guardAgainstDuplicateEvaluationOfParameterConstraints();
}
if ($this->invocation === null) {
throw new ExpectationFailedException('Mocked method does not exist.');
}
if (count($this->invocation->parameters()) < count($this->parameters)) {
$message = 'Parameter count for invocation %s is too low.';
// The user called `->with($this->anything())`, but may have meant
// `->withAnyParameters()`.
//
// @see https://github.com/sebastianbergmann/phpunit-mock-objects/issues/199
if (count($this->parameters) === 1 &&
$this->parameters[0]::class === IsAnything::class) {
$message .= "\nTo allow 0 or more parameters with any value, omit ->with() or use ->withAnyParameters() instead.";
}
throw new ExpectationFailedException(
sprintf($message, $this->invocation->toString()),
);
}
foreach ($this->parameters as $i => $parameter) {
$parameter->evaluate(
$this->invocation->parameters()[$i],
sprintf(
'Parameter %s for invocation %s does not match expected ' .
'value.',
$i,
$this->invocation->toString(),
),
);
}
return true;
}
/**
* @throws ExpectationFailedException
*/
private function guardAgainstDuplicateEvaluationOfParameterConstraints(): bool
{
if ($this->parameterVerificationResult instanceof ExpectationFailedException) {
throw $this->parameterVerificationResult;
}
return (bool) $this->parameterVerificationResult;
}
}
src/Framework/MockObject/Runtime/Rule/MethodName.php 0000644 00000003022 15243426620 0016375 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function is_string;
use PHPUnit\Framework\Constraint\Constraint;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
use PHPUnit\Framework\MockObject\MethodNameConstraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodName
{
private readonly Constraint $constraint;
/**
* @throws InvalidArgumentException
*/
public function __construct(Constraint|string $constraint)
{
if (is_string($constraint)) {
$constraint = new MethodNameConstraint($constraint);
}
$this->constraint = $constraint;
}
public function toString(): string
{
return 'method name ' . $this->constraint->toString();
}
/**
* @throws ExpectationFailedException
*/
public function matches(BaseInvocation $invocation): bool
{
return $this->matchesName($invocation->methodName());
}
/**
* @throws ExpectationFailedException
*/
public function matchesName(string $methodName): bool
{
return (bool) $this->constraint->evaluate($methodName, '', true);
}
}
src/Framework/MockObject/Runtime/Rule/InvokedAtLeastCount.php 0000644 00000003543 15243426620 0020252 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Rule;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Invocation as BaseInvocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvokedAtLeastCount extends InvocationOrder
{
private readonly int $requiredInvocations;
public function __construct(int $requiredInvocations)
{
$this->requiredInvocations = $requiredInvocations;
}
public function toString(): string
{
return sprintf(
'invoked at least %d time%s',
$this->requiredInvocations,
$this->requiredInvocations !== 1 ? 's' : '',
);
}
/**
* Verifies that the current expectation is valid. If everything is OK the
* code should just return, if not it must throw an exception.
*
* @throws ExpectationFailedException
*/
public function verify(): void
{
$actualInvocations = $this->numberOfInvocations();
if ($actualInvocations < $this->requiredInvocations) {
throw new ExpectationFailedException(
sprintf(
'Expected invocation at least %d time%s but it occurred %d time%s.',
$this->requiredInvocations,
$this->requiredInvocations !== 1 ? 's' : '',
$actualInvocations,
$actualInvocations !== 1 ? 's' : '',
),
);
}
}
public function matches(BaseInvocation $invocation): bool
{
return true;
}
}
src/Framework/MockObject/Runtime/ReturnValueGenerator.php 0000644 00000016166 15243426620 0017605 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_keys;
use function array_map;
use function explode;
use function in_array;
use function interface_exists;
use function sprintf;
use function str_contains;
use function str_ends_with;
use function str_starts_with;
use function substr;
use PHPUnit\Framework\MockObject\Generator\Generator;
use ReflectionClass;
use stdClass;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueGenerator
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param class-string $stubClassName
*
* @throws Exception
*/
public function generate(string $className, string $methodName, string $stubClassName, string $returnType): mixed
{
$intersection = false;
$union = false;
if (str_contains($returnType, '|')) {
$types = explode('|', $returnType);
$union = true;
foreach (array_keys($types) as $key) {
if (str_starts_with($types[$key], '(') && str_ends_with($types[$key], ')')) {
$types[$key] = substr($types[$key], 1, -1);
}
}
} elseif (str_contains($returnType, '&')) {
$types = explode('&', $returnType);
$intersection = true;
} else {
$types = [$returnType];
}
if (!$intersection) {
$lowerTypes = array_map('strtolower', $types);
if (in_array('', $lowerTypes, true) ||
in_array('null', $lowerTypes, true) ||
in_array('mixed', $lowerTypes, true) ||
in_array('void', $lowerTypes, true)) {
return null;
}
if (in_array('true', $lowerTypes, true)) {
return true;
}
if (in_array('false', $lowerTypes, true) ||
in_array('bool', $lowerTypes, true)) {
return false;
}
if (in_array('float', $lowerTypes, true)) {
return 0.0;
}
if (in_array('int', $lowerTypes, true)) {
return 0;
}
if (in_array('string', $lowerTypes, true)) {
return '';
}
if (in_array('array', $lowerTypes, true)) {
return [];
}
if (in_array('static', $lowerTypes, true)) {
return $this->newInstanceOf($stubClassName, $className, $methodName);
}
if (in_array('object', $lowerTypes, true)) {
return new stdClass;
}
if (in_array('callable', $lowerTypes, true) ||
in_array('closure', $lowerTypes, true)) {
return static function (): void
{
};
}
if (in_array('traversable', $lowerTypes, true) ||
in_array('generator', $lowerTypes, true) ||
in_array('iterable', $lowerTypes, true)) {
$generator = static function (): \Generator
{
yield from [];
};
return $generator();
}
if (!$union) {
return $this->testDoubleFor($returnType, $className, $methodName);
}
}
if ($union) {
foreach ($types as $type) {
if (str_contains($type, '&')) {
$_types = explode('&', $type);
if ($this->onlyInterfaces($_types)) {
return $this->testDoubleForIntersectionOfInterfaces($_types, $className, $methodName);
}
}
}
}
if ($intersection && $this->onlyInterfaces($types)) {
return $this->testDoubleForIntersectionOfInterfaces($types, $className, $methodName);
}
$reason = '';
if ($union) {
$reason = ' because the declared return type is a union';
} elseif ($intersection) {
$reason = ' because the declared return type is an intersection';
}
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated%s, please configure a return value for this method',
$className,
$methodName,
$reason,
),
);
}
/**
* @psalm-param non-empty-list<string> $types
*/
private function onlyInterfaces(array $types): bool
{
foreach ($types as $type) {
if (!interface_exists($type)) {
return false;
}
}
return true;
}
/**
* @psalm-param class-string $stubClassName
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function newInstanceOf(string $stubClassName, string $className, string $methodName): Stub
{
try {
return (new ReflectionClass($stubClassName))->newInstanceWithoutConstructor();
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
/**
* @psalm-param class-string $type
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function testDoubleFor(string $type, string $className, string $methodName): Stub
{
try {
return (new Generator)->testDouble($type, false, [], [], '', false);
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
/**
* @psalm-param non-empty-list<string> $types
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*
* @throws RuntimeException
*/
private function testDoubleForIntersectionOfInterfaces(array $types, string $className, string $methodName): Stub
{
try {
return (new Generator)->testDoubleForInterfaceIntersection($types, false);
} catch (Throwable $t) {
throw new RuntimeException(
sprintf(
'Return value for %s::%s() cannot be generated: %s',
$className,
$methodName,
$t->getMessage(),
),
);
}
}
}
src/Framework/MockObject/Runtime/InvocationHandler.php 0000644 00000007446 15243426620 0017072 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function strtolower;
use Exception;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvocationHandler
{
/**
* @psalm-var list<Matcher>
*/
private array $matchers = [];
/**
* @psalm-var array<string,Matcher>
*/
private array $matcherMap = [];
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
private readonly bool $returnValueGeneration;
/**
* @psalm-param list<ConfigurableMethod> $configurableMethods
*/
public function __construct(array $configurableMethods, bool $returnValueGeneration)
{
$this->configurableMethods = $configurableMethods;
$this->returnValueGeneration = $returnValueGeneration;
}
public function hasMatchers(): bool
{
foreach ($this->matchers as $matcher) {
if ($matcher->hasMatchers()) {
return true;
}
}
return false;
}
/**
* Looks up the match builder with identification $id and returns it.
*/
public function lookupMatcher(string $id): ?Matcher
{
return $this->matcherMap[$id] ?? null;
}
/**
* Registers a matcher with the identification $id. The matcher can later be
* looked up using lookupMatcher() to figure out if it has been invoked.
*
* @throws MatcherAlreadyRegisteredException
*/
public function registerMatcher(string $id, Matcher $matcher): void
{
if (isset($this->matcherMap[$id])) {
throw new MatcherAlreadyRegisteredException($id);
}
$this->matcherMap[$id] = $matcher;
}
public function expects(InvocationOrder $rule): InvocationMocker
{
$matcher = new Matcher($rule);
$this->addMatcher($matcher);
return new InvocationMocker(
$this,
$matcher,
...$this->configurableMethods,
);
}
/**
* @throws \PHPUnit\Framework\MockObject\Exception
* @throws Exception
*/
public function invoke(Invocation $invocation): mixed
{
$exception = null;
$hasReturnValue = false;
$returnValue = null;
foreach ($this->matchers as $match) {
try {
if ($match->matches($invocation)) {
$value = $match->invoked($invocation);
if (!$hasReturnValue) {
$returnValue = $value;
$hasReturnValue = true;
}
}
} catch (Exception $e) {
$exception = $e;
}
}
if ($exception !== null) {
throw $exception;
}
if ($hasReturnValue) {
return $returnValue;
}
if (!$this->returnValueGeneration) {
if (strtolower($invocation->methodName()) === '__tostring') {
return '';
}
throw new ReturnValueNotConfiguredException($invocation);
}
return $invocation->generateReturnValue();
}
/**
* @throws Throwable
*/
public function verify(): void
{
foreach ($this->matchers as $matcher) {
$matcher->verify();
}
}
private function addMatcher(Matcher $matcher): void
{
$this->matchers[] = $matcher;
}
}
src/Framework/MockObject/Runtime/Api/StubApi.php 0000644 00000003363 15243426620 0015535 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait StubApi
{
/**
* @psalm-var list<ConfigurableMethod>
*/
private static array $__phpunit_configurableMethods;
private bool $__phpunit_returnValueGeneration = true;
private ?InvocationHandler $__phpunit_invocationMocker = null;
/** @noinspection MagicMethodsValidityInspection */
public static function __phpunit_initConfigurableMethods(ConfigurableMethod ...$configurableMethods): void
{
static::$__phpunit_configurableMethods = $configurableMethods;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_setReturnValueGeneration(bool $returnValueGeneration): void
{
$this->__phpunit_returnValueGeneration = $returnValueGeneration;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_getInvocationHandler(): InvocationHandler
{
if ($this->__phpunit_invocationMocker === null) {
$this->__phpunit_invocationMocker = new InvocationHandler(
static::$__phpunit_configurableMethods,
$this->__phpunit_returnValueGeneration,
);
}
return $this->__phpunit_invocationMocker;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_unsetInvocationMocker(): void
{
$this->__phpunit_invocationMocker = null;
}
}
src/Framework/MockObject/Runtime/Api/ProxiedCloneMethod.php 0000644 00000001113 15243426620 0017711 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait ProxiedCloneMethod
{
public function __clone(): void
{
$this->__phpunit_invocationMocker = clone $this->__phpunit_getInvocationHandler();
parent::__clone();
}
}
src/Framework/MockObject/Runtime/Api/MockObjectApi.php 0000644 00000003136 15243426620 0016636 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker as InvocationMockerBuilder;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait MockObjectApi
{
private object $__phpunit_originalObject;
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_hasMatchers(): bool
{
return $this->__phpunit_getInvocationHandler()->hasMatchers();
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_setOriginalObject(object $originalObject): void
{
$this->__phpunit_originalObject = $originalObject;
}
/** @noinspection MagicMethodsValidityInspection */
public function __phpunit_verify(bool $unsetInvocationMocker = true): void
{
$this->__phpunit_getInvocationHandler()->verify();
if ($unsetInvocationMocker) {
$this->__phpunit_unsetInvocationMocker();
}
}
abstract public function __phpunit_getInvocationHandler(): InvocationHandler;
abstract public function __phpunit_unsetInvocationMocker(): void;
public function expects(InvocationOrder $matcher): InvocationMockerBuilder
{
return $this->__phpunit_getInvocationHandler()->expects($matcher);
}
}
src/Framework/MockObject/Runtime/Api/DoubledCloneMethod.php 0000644 00000001057 15243426620 0017664 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait DoubledCloneMethod
{
public function __clone(): void
{
$this->__phpunit_invocationMocker = clone $this->__phpunit_getInvocationHandler();
}
}
src/Framework/MockObject/Runtime/Api/Method.php 0000644 00000001455 15243426620 0015406 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function call_user_func_array;
use function func_get_args;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait Method
{
public function method(): InvocationMocker
{
$expects = $this->expects(new AnyInvokedCount);
return call_user_func_array(
[$expects, 'method'],
func_get_args(),
);
}
}
src/Framework/MockObject/Runtime/Stub/ReturnSelf.php 0000644 00000001265 15243426620 0016462 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
use PHPUnit\Framework\MockObject\RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnSelf implements Stub
{
/**
* @throws RuntimeException
*/
public function invoke(Invocation $invocation): object
{
return $invocation->object();
}
}
src/Framework/MockObject/Runtime/Stub/ReturnStub.php 0000644 00000001306 15243426620 0016502 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnStub implements Stub
{
private readonly mixed $value;
public function __construct(mixed $value)
{
$this->value = $value;
}
public function invoke(Invocation $invocation): mixed
{
return $this->value;
}
}
src/Framework/MockObject/Runtime/Stub/ReturnArgument.php 0000644 00000001421 15243426620 0017345 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnArgument implements Stub
{
private readonly int $argumentIndex;
public function __construct(int $argumentIndex)
{
$this->argumentIndex = $argumentIndex;
}
public function invoke(Invocation $invocation): mixed
{
return $invocation->parameters()[$this->argumentIndex] ?? null;
}
}
src/Framework/MockObject/Runtime/Stub/ReturnCallback.php 0000644 00000001506 15243426620 0017263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function call_user_func_array;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnCallback implements Stub
{
/**
* @var callable
*/
private $callback;
public function __construct(callable $callback)
{
$this->callback = $callback;
}
public function invoke(Invocation $invocation): mixed
{
return call_user_func_array($this->callback, $invocation->parameters());
}
}
src/Framework/MockObject/Runtime/Stub/ConsecutiveCalls.php 0000644 00000001547 15243426620 0017642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function array_shift;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConsecutiveCalls implements Stub
{
private array $stack;
public function __construct(array $stack)
{
$this->stack = $stack;
}
public function invoke(Invocation $invocation): mixed
{
$value = array_shift($this->stack);
if ($value instanceof Stub) {
$value = $value->invoke($invocation);
}
return $value;
}
}
src/Framework/MockObject/Runtime/Stub/Stub.php 0000644 00000001170 15243426620 0015301 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Stub
{
/**
* Fakes the processing of the invocation $invocation by returning a
* specific value.
*/
public function invoke(Invocation $invocation): mixed;
}
src/Framework/MockObject/Runtime/Stub/Exception.php 0000644 00000001430 15243426620 0016321 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception implements Stub
{
private readonly Throwable $exception;
public function __construct(Throwable $exception)
{
$this->exception = $exception;
}
/**
* @throws Throwable
*/
public function invoke(Invocation $invocation): never
{
throw $this->exception;
}
}
src/Framework/MockObject/Runtime/Stub/ReturnValueMap.php 0000644 00000002206 15243426620 0017277 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use function array_pop;
use function count;
use function is_array;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueMap implements Stub
{
private readonly array $valueMap;
public function __construct(array $valueMap)
{
$this->valueMap = $valueMap;
}
public function invoke(Invocation $invocation): mixed
{
$parameterCount = count($invocation->parameters());
foreach ($this->valueMap as $map) {
if (!is_array($map) || $parameterCount !== (count($map) - 1)) {
continue;
}
$return = array_pop($map);
if ($invocation->parameters() === $map) {
return $return;
}
}
return null;
}
}
src/Framework/MockObject/Runtime/Stub/ReturnReference.php 0000644 00000001330 15243426620 0017460 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\Invocation;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnReference implements Stub
{
private mixed $reference;
public function __construct(mixed &$reference)
{
$this->reference = &$reference;
}
public function invoke(Invocation $invocation): mixed
{
return $this->reference;
}
}
src/Framework/MockObject/Runtime/Matcher.php 0000644 00000014361 15243426620 0015040 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\MockObject\Rule\AnyInvokedCount;
use PHPUnit\Framework\MockObject\Rule\AnyParameters;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
use PHPUnit\Framework\MockObject\Rule\InvokedAtMostCount;
use PHPUnit\Framework\MockObject\Rule\InvokedCount;
use PHPUnit\Framework\MockObject\Rule\MethodName;
use PHPUnit\Framework\MockObject\Rule\ParametersRule;
use PHPUnit\Framework\MockObject\Stub\Stub;
use PHPUnit\Util\ThrowableToStringMapper;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Matcher
{
private readonly InvocationOrder $invocationRule;
private ?string $afterMatchBuilderId = null;
private ?MethodName $methodNameRule = null;
private ?ParametersRule $parametersRule = null;
private ?Stub $stub = null;
public function __construct(InvocationOrder $rule)
{
$this->invocationRule = $rule;
}
public function hasMatchers(): bool
{
return !$this->invocationRule instanceof AnyInvokedCount;
}
public function hasMethodNameRule(): bool
{
return $this->methodNameRule !== null;
}
public function methodNameRule(): MethodName
{
return $this->methodNameRule;
}
public function setMethodNameRule(MethodName $rule): void
{
$this->methodNameRule = $rule;
}
public function hasParametersRule(): bool
{
return $this->parametersRule !== null;
}
public function setParametersRule(ParametersRule $rule): void
{
$this->parametersRule = $rule;
}
public function setStub(Stub $stub): void
{
$this->stub = $stub;
}
public function setAfterMatchBuilderId(string $id): void
{
$this->afterMatchBuilderId = $id;
}
/**
* @throws Exception
* @throws ExpectationFailedException
* @throws MatchBuilderNotFoundException
* @throws MethodNameNotConfiguredException
* @throws RuntimeException
*/
public function invoked(Invocation $invocation): mixed
{
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
if ($this->afterMatchBuilderId !== null) {
$matcher = $invocation->object()
->__phpunit_getInvocationHandler()
->lookupMatcher($this->afterMatchBuilderId);
if (!$matcher) {
throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
}
}
$this->invocationRule->invoked($invocation);
try {
$this->parametersRule?->apply($invocation);
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
$e->getMessage(),
),
$e->getComparisonFailure(),
);
}
if ($this->stub) {
return $this->stub->invoke($invocation);
}
return $invocation->generateReturnValue();
}
/**
* @throws ExpectationFailedException
* @throws MatchBuilderNotFoundException
* @throws MethodNameNotConfiguredException
* @throws RuntimeException
*/
public function matches(Invocation $invocation): bool
{
if ($this->afterMatchBuilderId !== null) {
$matcher = $invocation->object()
->__phpunit_getInvocationHandler()
->lookupMatcher($this->afterMatchBuilderId);
if (!$matcher) {
throw new MatchBuilderNotFoundException($this->afterMatchBuilderId);
}
if (!$matcher->invocationRule->hasBeenInvoked()) {
return false;
}
}
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
if (!$this->invocationRule->matches($invocation)) {
return false;
}
try {
if (!$this->methodNameRule->matches($invocation)) {
return false;
}
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
$e->getMessage(),
),
$e->getComparisonFailure(),
);
}
return true;
}
/**
* @throws ExpectationFailedException
* @throws MethodNameNotConfiguredException
*/
public function verify(): void
{
if ($this->methodNameRule === null) {
throw new MethodNameNotConfiguredException;
}
try {
$this->invocationRule->verify();
if ($this->parametersRule === null) {
$this->parametersRule = new AnyParameters;
}
$invocationIsAny = $this->invocationRule instanceof AnyInvokedCount;
$invocationIsNever = $this->invocationRule instanceof InvokedCount && $this->invocationRule->isNever();
$invocationIsAtMost = $this->invocationRule instanceof InvokedAtMostCount;
if (!$invocationIsAny && !$invocationIsNever && !$invocationIsAtMost) {
$this->parametersRule->verify();
}
} catch (ExpectationFailedException $e) {
throw new ExpectationFailedException(
sprintf(
"Expectation failed for %s when %s.\n%s",
$this->methodNameRule->toString(),
$this->invocationRule->toString(),
ThrowableToStringMapper::map($e),
),
);
}
}
}
src/Framework/MockObject/Runtime/Interface/MockObjectInternal.php 0000644 00000001241 15243426620 0021063 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface MockObjectInternal extends MockObject, StubInternal
{
public function __phpunit_hasMatchers(): bool;
public function __phpunit_setOriginalObject(object $originalObject): void;
public function __phpunit_verify(bool $unsetInvocationMocker = true): void;
}
src/Framework/MockObject/Runtime/Interface/Stub.php 0000644 00000001033 15243426620 0016262 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationStubber;
/**
* @method InvocationStubber method($constraint)
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Stub
{
}
src/Framework/MockObject/Runtime/Interface/MockObject.php 0000644 00000001263 15243426620 0017372 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use PHPUnit\Framework\MockObject\Builder\InvocationMocker;
use PHPUnit\Framework\MockObject\Rule\InvocationOrder;
/**
* @method InvocationMocker method($constraint)
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface MockObject extends Stub
{
public function expects(InvocationOrder $invocationRule): InvocationMocker;
}
src/Framework/MockObject/Runtime/Interface/StubInternal.php 0000644 00000001407 15243426620 0017764 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface StubInternal extends Stub
{
public static function __phpunit_initConfigurableMethods(ConfigurableMethod ...$configurableMethods): void;
public function __phpunit_getInvocationHandler(): InvocationHandler;
public function __phpunit_setReturnValueGeneration(bool $returnValueGeneration): void;
public function __phpunit_unsetInvocationMocker(): void;
}
src/Framework/MockObject/Runtime/MethodNameConstraint.php 0000644 00000001712 15243426620 0017537 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use function strtolower;
use PHPUnit\Framework\Constraint\Constraint;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameConstraint extends Constraint
{
private readonly string $methodName;
public function __construct(string $methodName)
{
$this->methodName = $methodName;
}
public function toString(): string
{
return sprintf(
'is "%s"',
$this->methodName,
);
}
protected function matches(mixed $other): bool
{
return strtolower($this->methodName) === strtolower((string) $other);
}
}
src/Framework/MockObject/MockBuilder.php 0000644 00000030346 15243426620 0014233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function array_merge;
use function assert;
use function trait_exists;
use PHPUnit\Framework\Exception;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\Generator\ClassAlreadyExistsException;
use PHPUnit\Framework\MockObject\Generator\ClassIsEnumerationException;
use PHPUnit\Framework\MockObject\Generator\ClassIsFinalException;
use PHPUnit\Framework\MockObject\Generator\ClassIsReadonlyException;
use PHPUnit\Framework\MockObject\Generator\DuplicateMethodException;
use PHPUnit\Framework\MockObject\Generator\Generator;
use PHPUnit\Framework\MockObject\Generator\InvalidMethodNameException;
use PHPUnit\Framework\MockObject\Generator\OriginalConstructorInvocationRequiredException;
use PHPUnit\Framework\MockObject\Generator\ReflectionException;
use PHPUnit\Framework\MockObject\Generator\RuntimeException;
use PHPUnit\Framework\MockObject\Generator\UnknownTypeException;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
/**
* @psalm-template MockedType
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class MockBuilder
{
private readonly TestCase $testCase;
/**
* @psalm-var class-string|trait-string
*/
private readonly string $type;
/**
* @psalm-var list<non-empty-string>
*/
private array $methods = [];
private bool $emptyMethodsArray = false;
/**
* @psalm-var ?class-string
*/
private ?string $mockClassName = null;
private array $constructorArgs = [];
private bool $originalConstructor = true;
private bool $originalClone = true;
private bool $autoload = true;
private bool $cloneArguments = false;
private bool $callOriginalMethods = false;
private ?object $proxyTarget = null;
private bool $allowMockingUnknownTypes = true;
private bool $returnValueGeneration = true;
private readonly Generator $generator;
/**
* @psalm-param class-string|trait-string $type
*/
public function __construct(TestCase $testCase, string $type)
{
$this->testCase = $testCase;
$this->type = $type;
$this->generator = new Generator;
}
/**
* Creates a mock object using a fluent interface.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTypeException
*
* @psalm-return MockObject&MockedType
*/
public function getMock(): MockObject
{
$object = $this->generator->testDouble(
$this->type,
true,
!$this->emptyMethodsArray ? $this->methods : null,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->cloneArguments,
$this->callOriginalMethods,
$this->proxyTarget,
$this->allowMockingUnknownTypes,
$this->returnValueGeneration,
);
assert($object instanceof $this->type);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Creates a mock object for an abstract class using a fluent interface.
*
* @psalm-return MockObject&MockedType
*
* @throws Exception
* @throws ReflectionException
* @throws RuntimeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5305
*/
public function getMockForAbstractClass(): MockObject
{
$object = $this->generator->mockObjectForAbstractClass(
$this->type,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->methods,
$this->cloneArguments,
);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Creates a mock object for a trait using a fluent interface.
*
* @psalm-return MockObject&MockedType
*
* @throws Exception
* @throws ReflectionException
* @throws RuntimeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5306
*/
public function getMockForTrait(): MockObject
{
assert(trait_exists($this->type));
$object = $this->generator->mockObjectForTrait(
$this->type,
$this->constructorArgs,
$this->mockClassName ?? '',
$this->originalConstructor,
$this->originalClone,
$this->autoload,
$this->methods,
$this->cloneArguments,
);
assert($object instanceof MockObject);
$this->testCase->registerMockObject($object);
return $object;
}
/**
* Specifies the subset of methods to mock, requiring each to exist in the class.
*
* @psalm-param list<non-empty-string> $methods
*
* @throws CannotUseOnlyMethodsException
* @throws ReflectionException
*
* @return $this
*/
public function onlyMethods(array $methods): self
{
if (empty($methods)) {
$this->emptyMethodsArray = true;
return $this;
}
try {
$reflector = new ReflectionClass($this->type);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
foreach ($methods as $method) {
if (!$reflector->hasMethod($method)) {
throw new CannotUseOnlyMethodsException($this->type, $method);
}
}
$this->methods = array_merge($this->methods, $methods);
return $this;
}
/**
* Specifies methods that don't exist in the class which you want to mock.
*
* @psalm-param list<non-empty-string> $methods
*
* @throws CannotUseAddMethodsException
* @throws ReflectionException
* @throws RuntimeException
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5320
*/
public function addMethods(array $methods): self
{
if (empty($methods)) {
$this->emptyMethodsArray = true;
return $this;
}
try {
$reflector = new ReflectionClass($this->type);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
foreach ($methods as $method) {
if ($reflector->hasMethod($method)) {
throw new CannotUseAddMethodsException($this->type, $method);
}
}
$this->methods = array_merge($this->methods, $methods);
return $this;
}
/**
* Specifies the arguments for the constructor.
*
* @return $this
*/
public function setConstructorArgs(array $arguments): self
{
$this->constructorArgs = $arguments;
return $this;
}
/**
* Specifies the name for the mock class.
*
* @psalm-param class-string $name
*
* @return $this
*/
public function setMockClassName(string $name): self
{
$this->mockClassName = $name;
return $this;
}
/**
* Disables the invocation of the original constructor.
*
* @return $this
*/
public function disableOriginalConstructor(): self
{
$this->originalConstructor = false;
return $this;
}
/**
* Enables the invocation of the original constructor.
*
* @return $this
*/
public function enableOriginalConstructor(): self
{
$this->originalConstructor = true;
return $this;
}
/**
* Disables the invocation of the original clone constructor.
*
* @return $this
*/
public function disableOriginalClone(): self
{
$this->originalClone = false;
return $this;
}
/**
* Enables the invocation of the original clone constructor.
*
* @return $this
*/
public function enableOriginalClone(): self
{
$this->originalClone = true;
return $this;
}
/**
* Disables the use of class autoloading while creating the mock object.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5309
*/
public function disableAutoload(): self
{
$this->autoload = false;
return $this;
}
/**
* Enables the use of class autoloading while creating the mock object.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5309
*/
public function enableAutoload(): self
{
$this->autoload = true;
return $this;
}
/**
* Disables the cloning of arguments passed to mocked methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5315
*/
public function disableArgumentCloning(): self
{
$this->cloneArguments = false;
return $this;
}
/**
* Enables the cloning of arguments passed to mocked methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5315
*/
public function enableArgumentCloning(): self
{
$this->cloneArguments = true;
return $this;
}
/**
* Enables the invocation of the original methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function enableProxyingToOriginalMethods(): self
{
$this->callOriginalMethods = true;
return $this;
}
/**
* Disables the invocation of the original methods.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function disableProxyingToOriginalMethods(): self
{
$this->callOriginalMethods = false;
$this->proxyTarget = null;
return $this;
}
/**
* Sets the proxy target.
*
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5307
*/
public function setProxyTarget(object $object): self
{
$this->proxyTarget = $object;
return $this;
}
/**
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5308
*/
public function allowMockingUnknownTypes(): self
{
$this->allowMockingUnknownTypes = true;
return $this;
}
/**
* @return $this
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5308
*/
public function disallowMockingUnknownTypes(): self
{
$this->allowMockingUnknownTypes = false;
return $this;
}
/**
* @return $this
*/
public function enableAutoReturnValueGeneration(): self
{
$this->returnValueGeneration = true;
return $this;
}
/**
* @return $this
*/
public function disableAutoReturnValueGeneration(): self
{
$this->returnValueGeneration = false;
return $this;
}
}
src/Framework/MockObject/ConfigurableMethod.php 0000644 00000003756 15243426620 0015601 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use SebastianBergmann\Type\Type;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ConfigurableMethod
{
/**
* @psalm-var non-empty-string
*/
private readonly string $name;
/**
* @psalm-var array<int, mixed>
*/
private readonly array $defaultParameterValues;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfParameters;
private readonly Type $returnType;
/**
* @psalm-param non-empty-string $name
* @psalm-param array<int, mixed> $defaultParameterValues
* @psalm-param non-negative-int $numberOfParameters
*/
public function __construct(string $name, array $defaultParameterValues, int $numberOfParameters, Type $returnType)
{
$this->name = $name;
$this->defaultParameterValues = $defaultParameterValues;
$this->numberOfParameters = $numberOfParameters;
$this->returnType = $returnType;
}
/**
* @psalm-return non-empty-string
*/
public function name(): string
{
return $this->name;
}
/**
* @psalm-return array<int, mixed>
*/
public function defaultParameterValues(): array
{
return $this->defaultParameterValues;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfParameters(): int
{
return $this->numberOfParameters;
}
public function mayReturn(mixed $value): bool
{
return $this->returnType->isAssignable(Type::fromValue($value, false));
}
public function returnTypeDeclaration(): string
{
return $this->returnType->asString();
}
}
src/Framework/MockObject/Exception/MethodCannotBeConfiguredException.php 0000644 00000001503 15243426620 0022501 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodCannotBeConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $method)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" which cannot be configured because it does not exist, has not been specified, is final, or is static',
$method,
),
);
}
}
src/Framework/MockObject/Exception/CannotUseAddMethodsException.php 0000644 00000001554 15243426620 0021503 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotUseAddMethodsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type, string $methodName)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" with addMethods(), but it exists in class "%s". Use onlyMethods() for methods that exist in the class',
$methodName,
$type,
),
);
}
}
src/Framework/MockObject/Exception/MatchBuilderNotFoundException.php 0000644 00000001351 15243426620 0021662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MatchBuilderNotFoundException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $id)
{
parent::__construct(
sprintf(
'No builder found for match builder identification <%s>',
$id,
),
);
}
}
src/Framework/MockObject/Exception/MatcherAlreadyRegisteredException.php 0000644 00000001341 15243426620 0022544 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MatcherAlreadyRegisteredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $id)
{
parent::__construct(
sprintf(
'Matcher with id <%s> is already registered',
$id,
),
);
}
}
src/Framework/MockObject/Exception/IncompatibleReturnValueException.php 0000644 00000001642 15243426620 0022450 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function get_debug_type;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncompatibleReturnValueException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(ConfigurableMethod $method, mixed $value)
{
parent::__construct(
sprintf(
'Method %s may not return value of type %s, its declared return type is "%s"',
$method->name(),
get_debug_type($value),
$method->returnTypeDeclaration(),
),
);
}
}
src/Framework/MockObject/Exception/BadMethodCallException.php 0000644 00000000743 15243426620 0020271 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BadMethodCallException extends \BadMethodCallException implements Exception
{
}
src/Framework/MockObject/Exception/ReturnValueNotConfiguredException.php 0000644 00000001525 15243426620 0022610 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReturnValueNotConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(Invocation $invocation)
{
parent::__construct(
sprintf(
'No return value is configured for %s::%s() and return value generation is disabled',
$invocation->className(),
$invocation->methodName(),
),
);
}
}
src/Framework/MockObject/Exception/MethodNameAlreadyConfiguredException.php 0000644 00000001146 15243426620 0023175 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameAlreadyConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method name is already configured');
}
}
src/Framework/MockObject/Exception/Exception.php 0000644 00000000701 15243426620 0015717 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends Throwable
{
}
src/Framework/MockObject/Exception/RuntimeException.php 0000644 00000000727 15243426620 0017273 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \RuntimeException implements Exception
{
}
src/Framework/MockObject/Exception/ReflectionException.php 0000644 00000000760 15243426620 0017737 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
src/Framework/MockObject/Exception/MethodParametersAlreadyConfiguredException.php 0000644 00000001157 15243426620 0024422 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodParametersAlreadyConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method parameters already configured');
}
}
src/Framework/MockObject/Exception/NeverReturningMethodException.php 0000644 00000001644 15243426620 0021765 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
use RuntimeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class NeverReturningMethodException extends RuntimeException implements Exception
{
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
*/
public function __construct(string $className, string $methodName)
{
parent::__construct(
sprintf(
'Method %s::%s() is declared to never return',
$className,
$methodName,
),
);
}
}
src/Framework/MockObject/Exception/CannotUseOnlyMethodsException.php 0000644 00000001477 15243426620 0021740 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotUseOnlyMethodsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type, string $methodName)
{
parent::__construct(
sprintf(
'Trying to configure method "%s" with onlyMethods(), but it does not exist in class "%s"',
$methodName,
$type,
),
);
}
}
src/Framework/MockObject/Exception/MethodNameNotConfiguredException.php 0000644 00000001136 15243426620 0022353 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MethodNameNotConfiguredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Method name is not configured');
}
}
src/Framework/MockObject/Generator/MockMethod.php 0000644 00000026673 15243426620 0016023 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function count;
use function explode;
use function implode;
use function is_object;
use function is_string;
use function preg_match;
use function preg_replace;
use function sprintf;
use function strlen;
use function strpos;
use function substr;
use function substr_count;
use function trim;
use function var_export;
use ReflectionMethod;
use ReflectionParameter;
use SebastianBergmann\Type\ReflectionMapper;
use SebastianBergmann\Type\Type;
use SebastianBergmann\Type\UnknownType;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockMethod
{
use TemplateLoader;
/**
* @psalm-var class-string
*/
private readonly string $className;
/**
* @psalm-var non-empty-string
*/
private readonly string $methodName;
private readonly bool $cloneArguments;
private readonly string $modifier;
private readonly string $argumentsForDeclaration;
private readonly string $argumentsForCall;
private readonly Type $returnType;
private readonly string $reference;
private readonly bool $callOriginalMethod;
private readonly bool $static;
private readonly ?string $deprecation;
/**
* @psalm-var array<int, mixed>
*/
private readonly array $defaultParameterValues;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfParameters;
/**
* @throws ReflectionException
* @throws RuntimeException
*/
public static function fromReflection(ReflectionMethod $method, bool $callOriginalMethod, bool $cloneArguments): self
{
if ($method->isPrivate()) {
$modifier = 'private';
} elseif ($method->isProtected()) {
$modifier = 'protected';
} else {
$modifier = 'public';
}
if ($method->isStatic()) {
$modifier .= ' static';
}
if ($method->returnsReference()) {
$reference = '&';
} else {
$reference = '';
}
$docComment = $method->getDocComment();
if (is_string($docComment) &&
preg_match('#\*[ \t]*+@deprecated[ \t]*+(.*?)\r?+\n[ \t]*+\*(?:[ \t]*+@|/$)#s', $docComment, $deprecation)) {
$deprecation = trim(preg_replace('#[ \t]*\r?\n[ \t]*+\*[ \t]*+#', ' ', $deprecation[1]));
} else {
$deprecation = null;
}
return new self(
$method->getDeclaringClass()->getName(),
$method->getName(),
$cloneArguments,
$modifier,
self::methodParametersForDeclaration($method),
self::methodParametersForCall($method),
self::methodParametersDefaultValues($method),
count($method->getParameters()),
(new ReflectionMapper)->fromReturnType($method),
$reference,
$callOriginalMethod,
$method->isStatic(),
$deprecation,
);
}
/**
* @param class-string $className
* @param non-empty-string $methodName
*/
public static function fromName(string $className, string $methodName, bool $cloneArguments): self
{
return new self(
$className,
$methodName,
$cloneArguments,
'public',
'',
'',
[],
0,
new UnknownType,
'',
false,
false,
null,
);
}
/**
* @psalm-param class-string $className
* @psalm-param non-empty-string $methodName
* @psalm-param array<int, mixed> $defaultParameterValues
* @psalm-param non-negative-int $numberOfParameters
*/
private function __construct(string $className, string $methodName, bool $cloneArguments, string $modifier, string $argumentsForDeclaration, string $argumentsForCall, array $defaultParameterValues, int $numberOfParameters, Type $returnType, string $reference, bool $callOriginalMethod, bool $static, ?string $deprecation)
{
$this->className = $className;
$this->methodName = $methodName;
$this->cloneArguments = $cloneArguments;
$this->modifier = $modifier;
$this->argumentsForDeclaration = $argumentsForDeclaration;
$this->argumentsForCall = $argumentsForCall;
$this->defaultParameterValues = $defaultParameterValues;
$this->numberOfParameters = $numberOfParameters;
$this->returnType = $returnType;
$this->reference = $reference;
$this->callOriginalMethod = $callOriginalMethod;
$this->static = $static;
$this->deprecation = $deprecation;
}
/**
* @psalm-return non-empty-string
*/
public function methodName(): string
{
return $this->methodName;
}
/**
* @throws RuntimeException
*/
public function generateCode(): string
{
if ($this->static) {
$templateFile = 'doubled_static_method.tpl';
} else {
$templateFile = sprintf(
'%s_method.tpl',
$this->callOriginalMethod ? 'proxied' : 'doubled',
);
}
$deprecation = $this->deprecation;
$returnResult = '';
if (!$this->returnType->isNever() && !$this->returnType->isVoid()) {
$returnResult = <<<'EOT'
return $__phpunit_result;
EOT;
}
if (null !== $this->deprecation) {
$deprecation = "The {$this->className}::{$this->methodName} method is deprecated ({$this->deprecation}).";
$deprecationTemplate = $this->loadTemplate('deprecation.tpl');
$deprecationTemplate->setVar(
[
'deprecation' => var_export($deprecation, true),
],
);
$deprecation = $deprecationTemplate->render();
}
$template = $this->loadTemplate($templateFile);
$template->setVar(
[
'arguments_decl' => $this->argumentsForDeclaration,
'arguments_call' => $this->argumentsForCall,
'return_declaration' => !empty($this->returnType->asString()) ? (': ' . $this->returnType->asString()) : '',
'return_type' => $this->returnType->asString(),
'arguments_count' => !empty($this->argumentsForCall) ? substr_count($this->argumentsForCall, ',') + 1 : 0,
'class_name' => $this->className,
'method_name' => $this->methodName,
'modifier' => $this->modifier,
'reference' => $this->reference,
'clone_arguments' => $this->cloneArguments ? 'true' : 'false',
'deprecation' => $deprecation,
'return_result' => $returnResult,
],
);
return $template->render();
}
public function returnType(): Type
{
return $this->returnType;
}
/**
* @psalm-return array<int, mixed>
*/
public function defaultParameterValues(): array
{
return $this->defaultParameterValues;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfParameters(): int
{
return $this->numberOfParameters;
}
/**
* Returns the parameters of a function or method.
*
* @throws RuntimeException
*/
private static function methodParametersForDeclaration(ReflectionMethod $method): string
{
$parameters = [];
$types = (new ReflectionMapper)->fromParameterTypes($method);
foreach ($method->getParameters() as $i => $parameter) {
$name = '$' . $parameter->getName();
/* Note: PHP extensions may use empty names for reference arguments
* or "..." for methods taking a variable number of arguments.
*/
if ($name === '$' || $name === '$...') {
$name = '$arg' . $i;
}
$default = '';
$reference = '';
$typeDeclaration = '';
if (!$types[$i]->type()->isUnknown()) {
$typeDeclaration = $types[$i]->type()->asString() . ' ';
}
if ($parameter->isPassedByReference()) {
$reference = '&';
}
if ($parameter->isVariadic()) {
$name = '...' . $name;
} elseif ($parameter->isDefaultValueAvailable()) {
$default = ' = ' . self::exportDefaultValue($parameter);
} elseif ($parameter->isOptional()) {
$default = ' = null';
}
$parameters[] = $typeDeclaration . $reference . $name . $default;
}
return implode(', ', $parameters);
}
/**
* Returns the parameters of a function or method.
*
* @throws ReflectionException
*/
private static function methodParametersForCall(ReflectionMethod $method): string
{
$parameters = [];
foreach ($method->getParameters() as $i => $parameter) {
$name = '$' . $parameter->getName();
/* Note: PHP extensions may use empty names for reference arguments
* or "..." for methods taking a variable number of arguments.
*/
if ($name === '$' || $name === '$...') {
$name = '$arg' . $i;
}
if ($parameter->isVariadic()) {
continue;
}
if ($parameter->isPassedByReference()) {
$parameters[] = '&' . $name;
} else {
$parameters[] = $name;
}
}
return implode(', ', $parameters);
}
/**
* @throws ReflectionException
*/
private static function exportDefaultValue(ReflectionParameter $parameter): string
{
try {
$defaultValue = $parameter->getDefaultValue();
if (!is_object($defaultValue)) {
return var_export($defaultValue, true);
}
$parameterAsString = $parameter->__toString();
return explode(
' = ',
substr(
substr(
$parameterAsString,
strpos($parameterAsString, '<optional> ') + strlen('<optional> '),
),
0,
-2,
),
)[1];
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
/**
* @psalm-return array<int, mixed>
*/
private static function methodParametersDefaultValues(ReflectionMethod $method): array
{
$result = [];
foreach ($method->getParameters() as $i => $parameter) {
if (!$parameter->isDefaultValueAvailable()) {
continue;
}
$result[$i] = $parameter->getDefaultValue();
}
return $result;
}
}
src/Framework/MockObject/Generator/MockClass.php 0000644 00000003276 15243426620 0015642 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function call_user_func;
use function class_exists;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockClass implements MockType
{
private readonly string $classCode;
/**
* @psalm-var class-string
*/
private readonly string $mockName;
/**
* @psalm-var list<ConfigurableMethod>
*/
private readonly array $configurableMethods;
/**
* @psalm-param class-string $mockName
* @psalm-param list<ConfigurableMethod> $configurableMethods
*/
public function __construct(string $classCode, string $mockName, array $configurableMethods)
{
$this->classCode = $classCode;
$this->mockName = $mockName;
$this->configurableMethods = $configurableMethods;
}
/**
* @psalm-return class-string
*/
public function generate(): string
{
if (!class_exists($this->mockName, false)) {
eval($this->classCode);
call_user_func(
[
$this->mockName,
'__phpunit_initConfigurableMethods',
],
...$this->configurableMethods,
);
}
return $this->mockName;
}
public function classCode(): string
{
return $this->classCode;
}
}
src/Framework/MockObject/Generator/Generator.php 0000644 00000103420 15243426620 0015701 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use const PHP_EOL;
use const PREG_OFFSET_CAPTURE;
use const WSDL_CACHE_NONE;
use function array_merge;
use function array_pop;
use function array_unique;
use function assert;
use function class_exists;
use function count;
use function explode;
use function extension_loaded;
use function implode;
use function in_array;
use function interface_exists;
use function is_array;
use function is_object;
use function md5;
use function method_exists;
use function mt_rand;
use function preg_match;
use function preg_match_all;
use function range;
use function serialize;
use function sort;
use function sprintf;
use function str_contains;
use function str_replace;
use function strlen;
use function strpos;
use function substr;
use function trait_exists;
use Exception;
use Iterator;
use IteratorAggregate;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\MockObject\ConfigurableMethod;
use PHPUnit\Framework\MockObject\DoubledCloneMethod;
use PHPUnit\Framework\MockObject\Method;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\MockObject\MockObjectApi;
use PHPUnit\Framework\MockObject\MockObjectInternal;
use PHPUnit\Framework\MockObject\ProxiedCloneMethod;
use PHPUnit\Framework\MockObject\Stub;
use PHPUnit\Framework\MockObject\StubApi;
use PHPUnit\Framework\MockObject\StubInternal;
use ReflectionClass;
use ReflectionMethod;
use SoapClient;
use SoapFault;
use Throwable;
use Traversable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
use TemplateLoader;
/**
* @var array
*/
private const EXCLUDED_METHOD_NAMES = [
'__CLASS__' => true,
'__DIR__' => true,
'__FILE__' => true,
'__FUNCTION__' => true,
'__LINE__' => true,
'__METHOD__' => true,
'__NAMESPACE__' => true,
'__TRAIT__' => true,
'__clone' => true,
'__halt_compiler' => true,
];
/**
* @psalm-var array<non-empty-string, MockClass>
*/
private static array $cache = [];
/**
* Returns a test double for the specified class.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTypeException
*/
public function testDouble(string $type, bool $mockObject, ?array $methods = [], array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, bool $cloneArguments = true, bool $callOriginalMethods = false, ?object $proxyTarget = null, bool $allowMockingUnknownTypes = true, bool $returnValueGeneration = true): MockObject|Stub
{
if ($type === Traversable::class) {
$type = Iterator::class;
}
if (!$allowMockingUnknownTypes) {
$this->ensureKnownType($type, $callAutoload);
}
$this->ensureValidMethods($methods);
$this->ensureMockedClassDoesNotAlreadyExist($mockClassName);
if (!$callOriginalConstructor && $callOriginalMethods) {
throw new OriginalConstructorInvocationRequiredException;
}
$mock = $this->generate(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
$object = $this->getObject(
$mock,
$type,
$callOriginalConstructor,
$arguments,
$callOriginalMethods,
$proxyTarget,
$returnValueGeneration,
);
assert($object instanceof $type);
if ($mockObject) {
assert($object instanceof MockObject);
} else {
assert($object instanceof Stub);
}
return $object;
}
/**
* @psalm-param list<class-string> $interfaces
*
* @throws RuntimeException
* @throws UnknownTypeException
*/
public function testDoubleForInterfaceIntersection(array $interfaces, bool $mockObject, bool $callAutoload = true): MockObject|Stub
{
if (count($interfaces) < 2) {
throw new RuntimeException('At least two interfaces must be specified');
}
foreach ($interfaces as $interface) {
if (!interface_exists($interface, $callAutoload)) {
throw new UnknownTypeException($interface);
}
}
sort($interfaces);
$methods = [];
foreach ($interfaces as $interface) {
$methods = array_merge($methods, $this->namesOfMethodsIn($interface));
}
if (count(array_unique($methods)) < count($methods)) {
throw new RuntimeException('Interfaces must not declare the same method');
}
$unqualifiedNames = [];
foreach ($interfaces as $interface) {
$parts = explode('\\', $interface);
$unqualifiedNames[] = array_pop($parts);
}
sort($unqualifiedNames);
do {
$intersectionName = sprintf(
'Intersection_%s_%s',
implode('_', $unqualifiedNames),
substr(md5((string) mt_rand()), 0, 8),
);
} while (interface_exists($intersectionName, false));
$template = $this->loadTemplate('intersection.tpl');
$template->setVar(
[
'intersection' => $intersectionName,
'interfaces' => implode(', ', $interfaces),
],
);
eval($template->render());
return $this->testDouble($intersectionName, $mockObject);
}
/**
* Returns a mock object for the specified abstract class with all abstract
* methods of the class mocked.
*
* Concrete methods to mock can be specified with the $mockedMethods parameter.
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownClassException
* @throws UnknownTypeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5241
*/
public function mockObjectForAbstractClass(string $originalClassName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, ?array $mockedMethods = null, bool $cloneArguments = true): MockObject
{
if (class_exists($originalClassName, $callAutoload) ||
interface_exists($originalClassName, $callAutoload)) {
$reflector = $this->reflectClass($originalClassName);
$methods = $mockedMethods;
foreach ($reflector->getMethods() as $method) {
if ($method->isAbstract() && !in_array($method->getName(), $methods ?? [], true)) {
$methods[] = $method->getName();
}
}
if (empty($methods)) {
$methods = null;
}
$mockObject = $this->testDouble(
$originalClassName,
true,
$methods,
$arguments,
$mockClassName,
$callOriginalConstructor,
$callOriginalClone,
$callAutoload,
$cloneArguments,
);
assert($mockObject instanceof $originalClassName);
assert($mockObject instanceof MockObject);
return $mockObject;
}
throw new UnknownClassException($originalClassName);
}
/**
* Returns a mock object for the specified trait with all abstract methods
* of the trait mocked. Concrete methods to mock can be specified with the
* `$mockedMethods` parameter.
*
* @psalm-param trait-string $traitName
*
* @throws ClassAlreadyExistsException
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws DuplicateMethodException
* @throws InvalidArgumentException
* @throws InvalidMethodNameException
* @throws OriginalConstructorInvocationRequiredException
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownClassException
* @throws UnknownTraitException
* @throws UnknownTypeException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
public function mockObjectForTrait(string $traitName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, ?array $mockedMethods = null, bool $cloneArguments = true): MockObject
{
if (!trait_exists($traitName, $callAutoload)) {
throw new UnknownTraitException($traitName);
}
$className = $this->generateClassName(
$traitName,
'',
'Trait_',
);
$classTemplate = $this->loadTemplate('trait_class.tpl');
$classTemplate->setVar(
[
'prologue' => 'abstract ',
'class_name' => $className['className'],
'trait_name' => $traitName,
],
);
$mockTrait = new MockTrait($classTemplate->render(), $className['className']);
$mockTrait->generate();
return $this->mockObjectForAbstractClass($className['className'], $arguments, $mockClassName, $callOriginalConstructor, $callOriginalClone, $callAutoload, $mockedMethods, $cloneArguments);
}
/**
* Returns an object for the specified trait.
*
* @psalm-param trait-string $traitName
*
* @throws ReflectionException
* @throws RuntimeException
* @throws UnknownTraitException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5244
*/
public function objectForTrait(string $traitName, string $traitClassName = '', bool $callAutoload = true, bool $callOriginalConstructor = false, array $arguments = []): object
{
if (!trait_exists($traitName, $callAutoload)) {
throw new UnknownTraitException($traitName);
}
$className = $this->generateClassName(
$traitName,
$traitClassName,
'Trait_',
);
$classTemplate = $this->loadTemplate('trait_class.tpl');
$classTemplate->setVar(
[
'prologue' => '',
'class_name' => $className['className'],
'trait_name' => $traitName,
],
);
return $this->getObject(
new MockTrait(
$classTemplate->render(),
$className['className'],
),
'',
$callOriginalConstructor,
$arguments,
);
}
/**
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws ReflectionException
* @throws RuntimeException
*
* @todo This method is only public because it is used to test generated code in PHPT tests
*
* @see https://github.com/sebastianbergmann/phpunit/issues/5476
*/
public function generate(string $type, bool $mockObject, ?array $methods = null, string $mockClassName = '', bool $callOriginalClone = true, bool $callAutoload = true, bool $cloneArguments = true, bool $callOriginalMethods = false): MockClass
{
if ($mockClassName !== '') {
return $this->generateCodeForTestDoubleClass(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
}
$key = md5(
$type .
($mockObject ? 'MockObject' : 'TestStub') .
serialize($methods) .
serialize($callOriginalClone) .
serialize($cloneArguments) .
serialize($callOriginalMethods),
);
if (!isset(self::$cache[$key])) {
self::$cache[$key] = $this->generateCodeForTestDoubleClass(
$type,
$mockObject,
$methods,
$mockClassName,
$callOriginalClone,
$callAutoload,
$cloneArguments,
$callOriginalMethods,
);
}
return self::$cache[$key];
}
/**
* @throws RuntimeException
* @throws SoapExtensionNotAvailableException
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5242
*/
public function generateClassFromWsdl(string $wsdlFile, string $className, array $methods = [], array $options = []): string
{
if (!extension_loaded('soap')) {
throw new SoapExtensionNotAvailableException;
}
$options['cache_wsdl'] = WSDL_CACHE_NONE;
try {
$client = new SoapClient($wsdlFile, $options);
$_methods = array_unique($client->__getFunctions());
unset($client);
} catch (SoapFault $e) {
throw new RuntimeException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
sort($_methods);
$methodTemplate = $this->loadTemplate('wsdl_method.tpl');
$methodsBuffer = '';
foreach ($_methods as $method) {
preg_match_all('/[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*\(/', $method, $matches, PREG_OFFSET_CAPTURE);
$lastFunction = array_pop($matches[0]);
$nameStart = $lastFunction[1];
$nameEnd = $nameStart + strlen($lastFunction[0]) - 1;
$name = str_replace('(', '', $lastFunction[0]);
if (empty($methods) || in_array($name, $methods, true)) {
$arguments = explode(
',',
str_replace(')', '', substr($method, $nameEnd + 1)),
);
foreach (range(0, count($arguments) - 1) as $i) {
$parameterStart = strpos($arguments[$i], '$');
if (!$parameterStart) {
continue;
}
$arguments[$i] = substr($arguments[$i], $parameterStart);
}
$methodTemplate->setVar(
[
'method_name' => $name,
'arguments' => implode(', ', $arguments),
],
);
$methodsBuffer .= $methodTemplate->render();
}
}
$optionsBuffer = '[';
foreach ($options as $key => $value) {
$optionsBuffer .= $key . ' => ' . $value;
}
$optionsBuffer .= ']';
$classTemplate = $this->loadTemplate('wsdl_class.tpl');
$namespace = '';
if (str_contains($className, '\\')) {
$parts = explode('\\', $className);
$className = array_pop($parts);
$namespace = 'namespace ' . implode('\\', $parts) . ';' . "\n\n";
}
$classTemplate->setVar(
[
'namespace' => $namespace,
'class_name' => $className,
'wsdl' => $wsdlFile,
'options' => $optionsBuffer,
'methods' => $methodsBuffer,
],
);
return $classTemplate->render();
}
/**
* @throws ReflectionException
*
* @psalm-return list<MockMethod>
*/
public function mockClassMethods(string $className, bool $callOriginalMethods, bool $cloneArguments): array
{
$class = $this->reflectClass($className);
$methods = [];
foreach ($class->getMethods() as $method) {
if (($method->isPublic() || $method->isAbstract()) && $this->canMethodBeDoubled($method)) {
$methods[] = MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments);
}
}
return $methods;
}
/**
* @psalm-param class-string $interfaceName
*
* @throws ReflectionException
*
* @psalm-return list<ReflectionMethod>
*/
private function userDefinedInterfaceMethods(string $interfaceName): array
{
$interface = $this->reflectClass($interfaceName);
$methods = [];
foreach ($interface->getMethods() as $method) {
if (!$method->isUserDefined()) {
continue;
}
$methods[] = $method;
}
return $methods;
}
/**
* @throws ReflectionException
* @throws RuntimeException
*/
private function getObject(MockType $mockClass, string $type = '', bool $callOriginalConstructor = false, array $arguments = [], bool $callOriginalMethods = false, ?object $proxyTarget = null, bool $returnValueGeneration = true): object
{
$className = $mockClass->generate();
$object = $this->instantiate($className, $callOriginalConstructor, $arguments);
if ($callOriginalMethods) {
$this->instantiateProxyTarget($proxyTarget, $object, $type, $arguments);
}
if ($object instanceof StubInternal) {
$object->__phpunit_setReturnValueGeneration($returnValueGeneration);
}
return $object;
}
/**
* @throws ClassIsEnumerationException
* @throws ClassIsFinalException
* @throws ClassIsReadonlyException
* @throws ReflectionException
* @throws RuntimeException
*/
private function generateCodeForTestDoubleClass(string $type, bool $mockObject, ?array $explicitMethods, string $mockClassName, bool $callOriginalClone, bool $callAutoload, bool $cloneArguments, bool $callOriginalMethods): MockClass
{
$classTemplate = $this->loadTemplate('test_double_class.tpl');
$additionalInterfaces = [];
$doubledCloneMethod = false;
$proxiedCloneMethod = false;
$isClass = false;
$isInterface = false;
$class = null;
$mockMethods = new MockMethodSet;
$testDoubleClassPrefix = $mockObject ? 'MockObject_' : 'TestStub_';
$_mockClassName = $this->generateClassName(
$type,
$mockClassName,
$testDoubleClassPrefix,
);
if (class_exists($_mockClassName['fullClassName'], $callAutoload)) {
$isClass = true;
} elseif (interface_exists($_mockClassName['fullClassName'], $callAutoload)) {
$isInterface = true;
}
if (!$isClass && !$isInterface) {
$prologue = 'class ' . $_mockClassName['originalClassName'] . "\n{\n}\n\n";
if (!empty($_mockClassName['namespaceName'])) {
$prologue = 'namespace ' . $_mockClassName['namespaceName'] .
" {\n\n" . $prologue . "}\n\n" .
"namespace {\n\n";
$epilogue = "\n\n}";
}
$doubledCloneMethod = true;
} else {
$class = $this->reflectClass($_mockClassName['fullClassName']);
if ($class->isEnum()) {
throw new ClassIsEnumerationException($_mockClassName['fullClassName']);
}
if ($class->isFinal()) {
throw new ClassIsFinalException($_mockClassName['fullClassName']);
}
if (method_exists($class, 'isReadOnly') && $class->isReadOnly()) {
throw new ClassIsReadonlyException($_mockClassName['fullClassName']);
}
// @see https://github.com/sebastianbergmann/phpunit/issues/2995
if ($isInterface && $class->implementsInterface(Throwable::class)) {
$actualClassName = Exception::class;
$additionalInterfaces[] = $class->getName();
$isInterface = false;
$class = $this->reflectClass($actualClassName);
foreach ($this->userDefinedInterfaceMethods($_mockClassName['fullClassName']) as $method) {
$methodName = $method->getName();
if ($class->hasMethod($methodName)) {
$classMethod = $class->getMethod($methodName);
if (!$this->canMethodBeDoubled($classMethod)) {
continue;
}
}
$mockMethods->addMethods(
MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments),
);
}
$_mockClassName = $this->generateClassName(
$actualClassName,
$_mockClassName['className'],
$testDoubleClassPrefix,
);
}
// @see https://github.com/sebastianbergmann/phpunit-mock-objects/issues/103
if ($isInterface && $class->implementsInterface(Traversable::class) &&
!$class->implementsInterface(Iterator::class) &&
!$class->implementsInterface(IteratorAggregate::class)) {
$additionalInterfaces[] = Iterator::class;
$mockMethods->addMethods(
...$this->mockClassMethods(Iterator::class, $callOriginalMethods, $cloneArguments),
);
}
if ($class->hasMethod('__clone')) {
$cloneMethod = $class->getMethod('__clone');
if (!$cloneMethod->isFinal()) {
if ($callOriginalClone && !$isInterface) {
$proxiedCloneMethod = true;
} else {
$doubledCloneMethod = true;
}
}
} else {
$doubledCloneMethod = true;
}
}
if ($isClass && $explicitMethods === []) {
$mockMethods->addMethods(
...$this->mockClassMethods($_mockClassName['fullClassName'], $callOriginalMethods, $cloneArguments),
);
}
if ($isInterface && ($explicitMethods === [] || $explicitMethods === null)) {
$mockMethods->addMethods(
...$this->interfaceMethods($_mockClassName['fullClassName'], $cloneArguments),
);
}
if (is_array($explicitMethods)) {
foreach ($explicitMethods as $methodName) {
if ($class !== null && $class->hasMethod($methodName)) {
$method = $class->getMethod($methodName);
if ($this->canMethodBeDoubled($method)) {
$mockMethods->addMethods(
MockMethod::fromReflection($method, $callOriginalMethods, $cloneArguments),
);
}
} else {
$mockMethods->addMethods(
MockMethod::fromName(
$_mockClassName['fullClassName'],
$methodName,
$cloneArguments,
),
);
}
}
}
$mockedMethods = '';
$configurable = [];
foreach ($mockMethods->asArray() as $mockMethod) {
$mockedMethods .= $mockMethod->generateCode();
$configurable[] = new ConfigurableMethod(
$mockMethod->methodName(),
$mockMethod->defaultParameterValues(),
$mockMethod->numberOfParameters(),
$mockMethod->returnType(),
);
}
/** @psalm-var trait-string[] $traits */
$traits = [StubApi::class];
if ($mockObject) {
$traits[] = MockObjectApi::class;
}
if (!$mockMethods->hasMethod('method') && (!isset($class) || !$class->hasMethod('method'))) {
$traits[] = Method::class;
}
if ($doubledCloneMethod) {
$traits[] = DoubledCloneMethod::class;
}
if ($proxiedCloneMethod) {
$traits[] = ProxiedCloneMethod::class;
}
$useStatements = '';
foreach ($traits as $trait) {
$useStatements .= sprintf(
' use %s;' . PHP_EOL,
$trait,
);
}
unset($traits);
$classTemplate->setVar(
[
'prologue' => $prologue ?? '',
'epilogue' => $epilogue ?? '',
'class_declaration' => $this->generateTestDoubleClassDeclaration(
$mockObject,
$_mockClassName,
$isInterface,
$additionalInterfaces,
),
'use_statements' => $useStatements,
'mock_class_name' => $_mockClassName['className'],
'mocked_methods' => $mockedMethods,
],
);
return new MockClass(
$classTemplate->render(),
$_mockClassName['className'],
$configurable,
);
}
private function generateClassName(string $type, string $className, string $prefix): array
{
if ($type[0] === '\\') {
$type = substr($type, 1);
}
$classNameParts = explode('\\', $type);
if (count($classNameParts) > 1) {
$type = array_pop($classNameParts);
$namespaceName = implode('\\', $classNameParts);
$fullClassName = $namespaceName . '\\' . $type;
} else {
$namespaceName = '';
$fullClassName = $type;
}
if ($className === '') {
do {
$className = $prefix . $type . '_' .
substr(md5((string) mt_rand()), 0, 8);
} while (class_exists($className, false));
}
return [
'className' => $className,
'originalClassName' => $type,
'fullClassName' => $fullClassName,
'namespaceName' => $namespaceName,
];
}
private function generateTestDoubleClassDeclaration(bool $mockObject, array $mockClassName, bool $isInterface, array $additionalInterfaces = []): string
{
if ($mockObject) {
$additionalInterfaces[] = MockObjectInternal::class;
} else {
$additionalInterfaces[] = StubInternal::class;
}
$buffer = 'class ';
$interfaces = implode(', ', $additionalInterfaces);
if ($isInterface) {
$buffer .= sprintf(
'%s implements %s',
$mockClassName['className'],
$interfaces,
);
if (!in_array($mockClassName['originalClassName'], $additionalInterfaces, true)) {
$buffer .= ', ';
if (!empty($mockClassName['namespaceName'])) {
$buffer .= $mockClassName['namespaceName'] . '\\';
}
$buffer .= $mockClassName['originalClassName'];
}
} else {
$buffer .= sprintf(
'%s extends %s%s implements %s',
$mockClassName['className'],
!empty($mockClassName['namespaceName']) ? $mockClassName['namespaceName'] . '\\' : '',
$mockClassName['originalClassName'],
$interfaces,
);
}
return $buffer;
}
private function canMethodBeDoubled(ReflectionMethod $method): bool
{
if ($method->isConstructor()) {
return false;
}
if ($method->isDestructor()) {
return false;
}
if ($method->isFinal()) {
return false;
}
if ($method->isPrivate()) {
return false;
}
return !$this->isMethodNameExcluded($method->getName());
}
private function isMethodNameExcluded(string $name): bool
{
return isset(self::EXCLUDED_METHOD_NAMES[$name]);
}
/**
* @throws UnknownTypeException
*/
private function ensureKnownType(string $type, bool $callAutoload): void
{
if (!class_exists($type, $callAutoload) && !interface_exists($type, $callAutoload)) {
throw new UnknownTypeException($type);
}
}
/**
* @throws DuplicateMethodException
* @throws InvalidMethodNameException
*/
private function ensureValidMethods(?array $methods): void
{
if ($methods === null) {
return;
}
foreach ($methods as $method) {
if (!preg_match('~[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*~', (string) $method)) {
throw new InvalidMethodNameException((string) $method);
}
}
if ($methods !== array_unique($methods)) {
throw new DuplicateMethodException($methods);
}
}
/**
* @throws ClassAlreadyExistsException
* @throws ReflectionException
*/
private function ensureMockedClassDoesNotAlreadyExist(string $mockClassName): void
{
if ($mockClassName !== '' && class_exists($mockClassName, false)) {
$reflector = $this->reflectClass($mockClassName);
if (!$reflector->implementsInterface(MockObject::class)) {
throw new ClassAlreadyExistsException($mockClassName);
}
}
}
/**
* @psalm-param class-string $className
*
* @throws ReflectionException
*/
private function instantiate(string $className, bool $callOriginalConstructor, array $arguments): object
{
if ($callOriginalConstructor) {
if (count($arguments) === 0) {
return new $className;
}
try {
return (new ReflectionClass($className))->newInstanceArgs($arguments);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
try {
return (new ReflectionClass($className))->newInstanceWithoutConstructor();
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
// @codeCoverageIgnoreEnd
}
}
/**
* @psalm-param class-string $type
*
* @throws ReflectionException
*/
private function instantiateProxyTarget(?object $proxyTarget, object $object, string $type, array $arguments): void
{
if (!is_object($proxyTarget)) {
assert(class_exists($type));
if (count($arguments) === 0) {
$proxyTarget = new $type;
} else {
$class = new ReflectionClass($type);
try {
$proxyTarget = $class->newInstanceArgs($arguments);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
}
}
$object->__phpunit_setOriginalObject($proxyTarget);
}
/**
* @psalm-param class-string $className
*
* @throws ReflectionException
*/
private function reflectClass(string $className): ReflectionClass
{
try {
$class = new ReflectionClass($className);
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new ReflectionException(
$e->getMessage(),
$e->getCode(),
$e,
);
}
// @codeCoverageIgnoreEnd
return $class;
}
/**
* @psalm-param class-string $classOrInterfaceName
*
* @psalm-return list<string>
*
* @throws ReflectionException
*/
private function namesOfMethodsIn(string $classOrInterfaceName): array
{
$class = $this->reflectClass($classOrInterfaceName);
$methods = [];
foreach ($class->getMethods() as $method) {
if ($method->isPublic() || $method->isAbstract()) {
$methods[] = $method->getName();
}
}
return $methods;
}
/**
* @psalm-param class-string $interfaceName
*
* @psalm-return list<MockMethod>
*
* @throws ReflectionException
*/
private function interfaceMethods(string $interfaceName, bool $cloneArguments): array
{
$class = $this->reflectClass($interfaceName);
$methods = [];
foreach ($class->getMethods() as $method) {
$methods[] = MockMethod::fromReflection($method, false, $cloneArguments);
}
return $methods;
}
}
src/Framework/MockObject/Generator/MockType.php 0000644 00000001002 15243426620 0015477 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface MockType
{
/**
* @psalm-return class-string
*/
public function generate(): string;
}
src/Framework/MockObject/Generator/Exception/ClassIsReadonlyException.php 0000644 00000001375 15243426620 0022635 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsReadonlyException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is declared "readonly" and cannot be doubled',
$className,
),
);
}
}
src/Framework/MockObject/Generator/Exception/ClassAlreadyExistsException.php 0000644 00000001342 15243426620 0023337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassAlreadyExistsException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" already exists',
$className,
),
);
}
}
src/Framework/MockObject/Generator/Exception/UnknownTraitException.php 0000644 00000001447 15243426620 0022241 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
final class UnknownTraitException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $traitName)
{
parent::__construct(
sprintf(
'Trait "%s" does not exist',
$traitName,
),
);
}
}
src/Framework/MockObject/Generator/Exception/UnknownTypeException.php 0000644 00000001336 15243426620 0022074 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownTypeException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $type)
{
parent::__construct(
sprintf(
'Class or interface "%s" does not exist',
$type,
),
);
}
}
src/Framework/MockObject/Generator/Exception/OriginalConstructorInvocationRequiredException.php 0000644 00000001240 15243426620 0027332 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class OriginalConstructorInvocationRequiredException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct('Proxying to original methods requires invoking the original constructor');
}
}
src/Framework/MockObject/Generator/Exception/UnknownClassException.php 0000644 00000001334 15243426620 0022216 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnknownClassException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" does not exist',
$className,
),
);
}
}
src/Framework/MockObject/Generator/Exception/DuplicateMethodException.php 0000644 00000002015 15243426620 0022641 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function array_diff_assoc;
use function array_unique;
use function implode;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DuplicateMethodException extends \PHPUnit\Framework\Exception implements Exception
{
/**
* @psalm-param list<string> $methods
*/
public function __construct(array $methods)
{
parent::__construct(
sprintf(
'Cannot double using a method list that contains duplicates: "%s" (duplicate: "%s")',
implode(', ', $methods),
implode(', ', array_unique(array_diff_assoc($methods, array_unique($methods)))),
),
);
}
}
src/Framework/MockObject/Generator/Exception/Exception.php 0000644 00000001001 15243426620 0017637 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use PHPUnit\Framework\MockObject\Exception as BaseException;
/**
* @internal This interface is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends BaseException
{
}
src/Framework/MockObject/Generator/Exception/RuntimeException.php 0000644 00000000754 15243426620 0021221 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class RuntimeException extends \PHPUnit\Framework\Exception implements Exception
{
}
src/Framework/MockObject/Generator/Exception/ReflectionException.php 0000644 00000000757 15243426620 0021673 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends \PHPUnit\Framework\Exception implements Exception
{
}
src/Framework/MockObject/Generator/Exception/ClassIsEnumerationException.php 0000644 00000001373 15243426620 0023344 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsEnumerationException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is an enumeration and cannot be doubled',
$className,
),
);
}
}
src/Framework/MockObject/Generator/Exception/SoapExtensionNotAvailableException.php 0000644 00000001246 15243426620 0024654 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class SoapExtensionNotAvailableException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct()
{
parent::__construct(
'The SOAP extension is required to generate a test double from WSDL',
);
}
}
src/Framework/MockObject/Generator/Exception/ClassIsFinalException.php 0000644 00000001367 15243426620 0022112 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsFinalException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $className)
{
parent::__construct(
sprintf(
'Class "%s" is declared "final" and cannot be doubled',
$className,
),
);
}
}
src/Framework/MockObject/Generator/Exception/InvalidMethodNameException.php 0000644 00000001355 15243426620 0023124 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidMethodNameException extends \PHPUnit\Framework\Exception implements Exception
{
public function __construct(string $method)
{
parent::__construct(
sprintf(
'Cannot double method with invalid name "%s"',
$method,
),
);
}
}
src/Framework/MockObject/Generator/templates/doubled_static_method.tpl 0000644 00000000356 15243426620 0022312 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{
throw new \PHPUnit\Framework\MockObject\BadMethodCallException('Static method "{method_name}" cannot be invoked on mock object');
}
src/Framework/MockObject/Generator/templates/proxied_method.tpl 0000644 00000003232 15243426620 0020773 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{
$__phpunit_definedVariables = get_defined_vars();
$__phpunit_namedVariadicParameters = [];
foreach ($__phpunit_definedVariables as $__phpunit_definedVariableName => $__phpunit_definedVariableValue) {
if ((new ReflectionParameter([__CLASS__, __FUNCTION__], $__phpunit_definedVariableName))->isVariadic()) {
foreach ($__phpunit_definedVariableValue as $__phpunit_key => $__phpunit_namedValue) {
if (is_string($__phpunit_key)) {
$__phpunit_namedVariadicParameters[$__phpunit_key] = $__phpunit_namedValue;
}
}
}
}
$__phpunit_arguments = [{arguments_call}];
$__phpunit_count = func_num_args();
if ($__phpunit_count > {arguments_count}) {
$__phpunit_arguments_tmp = func_get_args();
for ($__phpunit_i = {arguments_count}; $__phpunit_i < $__phpunit_count; $__phpunit_i++) {
$__phpunit_arguments[] = $__phpunit_arguments_tmp[$__phpunit_i];
}
}
$__phpunit_arguments = array_merge($__phpunit_arguments, $__phpunit_namedVariadicParameters);
$this->__phpunit_getInvocationHandler()->invoke(
new \PHPUnit\Framework\MockObject\Invocation(
'{class_name}', '{method_name}', $__phpunit_arguments, '{return_type}', $this, {clone_arguments}, true
)
);
$__phpunit_result = call_user_func_array([$this->__phpunit_originalObject, "{method_name}"], $__phpunit_arguments);{return_result}
}
src/Framework/MockObject/Generator/templates/doubled_method.tpl 0000644 00000003070 15243426620 0020737 0 ustar 00
{modifier} function {reference}{method_name}({arguments_decl}){return_declaration}
{{deprecation}
$__phpunit_definedVariables = get_defined_vars();
$__phpunit_namedVariadicParameters = [];
foreach ($__phpunit_definedVariables as $__phpunit_definedVariableName => $__phpunit_definedVariableValue) {
if ((new ReflectionParameter([__CLASS__, __FUNCTION__], $__phpunit_definedVariableName))->isVariadic()) {
foreach ($__phpunit_definedVariableValue as $__phpunit_key => $__phpunit_namedValue) {
if (is_string($__phpunit_key)) {
$__phpunit_namedVariadicParameters[$__phpunit_key] = $__phpunit_namedValue;
}
}
}
}
$__phpunit_arguments = [{arguments_call}];
$__phpunit_count = func_num_args();
if ($__phpunit_count > {arguments_count}) {
$__phpunit_arguments_tmp = func_get_args();
for ($__phpunit_i = {arguments_count}; $__phpunit_i < $__phpunit_count; $__phpunit_i++) {
$__phpunit_arguments[] = $__phpunit_arguments_tmp[$__phpunit_i];
}
}
$__phpunit_arguments = array_merge($__phpunit_arguments, $__phpunit_namedVariadicParameters);
$__phpunit_result = $this->__phpunit_getInvocationHandler()->invoke(
new \PHPUnit\Framework\MockObject\Invocation(
'{class_name}', '{method_name}', $__phpunit_arguments, '{return_type}', $this, {clone_arguments}
)
);{return_result}
}
src/Framework/MockObject/Generator/templates/deprecation.tpl 0000644 00000000073 15243426620 0020256 0 ustar 00
@trigger_error({deprecation}, E_USER_DEPRECATED);
src/Framework/MockObject/Generator/templates/intersection.tpl 0000644 00000000114 15243426620 0020463 0 ustar 00 declare(strict_types=1);
interface {intersection} extends {interfaces}
{
}
src/Framework/MockObject/Generator/templates/test_double_class.tpl 0000644 00000000146 15243426620 0021460 0 ustar 00 declare(strict_types=1);
{prologue}{class_declaration}
{
{use_statements}{mocked_methods}}{epilogue}
src/Framework/MockObject/Generator/templates/wsdl_class.tpl 0000644 00000000315 15243426620 0020116 0 ustar 00 declare(strict_types=1);
{namespace}class {class_name} extends \SoapClient
{
public function __construct($wsdl, array $options)
{
parent::__construct('{wsdl}', $options);
}
{methods}}
src/Framework/MockObject/Generator/templates/trait_class.tpl 0000644 00000000121 15243426620 0020263 0 ustar 00 declare(strict_types=1);
{prologue}class {class_name}
{
use {trait_name};
}
src/Framework/MockObject/Generator/templates/wsdl_method.tpl 0000644 00000000074 15243426620 0020273 0 ustar 00
public function {method_name}({arguments})
{
}
src/Framework/MockObject/Generator/MockMethodSet.php 0000644 00000002110 15243426620 0016453 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function array_key_exists;
use function array_values;
use function strtolower;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class MockMethodSet
{
/**
* @psalm-var array<string,MockMethod>
*/
private array $methods = [];
public function addMethods(MockMethod ...$methods): void
{
foreach ($methods as $method) {
$this->methods[strtolower($method->methodName())] = $method;
}
}
/**
* @psalm-return list<MockMethod>
*/
public function asArray(): array
{
return array_values($this->methods);
}
public function hasMethod(string $methodName): bool
{
return array_key_exists(strtolower($methodName), $this->methods);
}
}
src/Framework/MockObject/Generator/TemplateLoader.php 0000644 00000001646 15243426620 0016664 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use SebastianBergmann\Template\Template;
/**
* @internal This trait is not covered by the backward compatibility promise for PHPUnit
*/
trait TemplateLoader
{
/**
* @psalm-var array<string,Template>
*/
private static array $templates = [];
/**
* @psalm-suppress MissingThrowsDocblock
*/
private function loadTemplate(string $template): Template
{
$filename = __DIR__ . '/templates/' . $template;
if (!isset(self::$templates[$filename])) {
self::$templates[$filename] = new Template($filename);
}
return self::$templates[$filename];
}
}
src/Framework/MockObject/Generator/MockTrait.php 0000644 00000002151 15243426620 0015647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework\MockObject\Generator;
use function class_exists;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @deprecated https://github.com/sebastianbergmann/phpunit/issues/5243
*/
final class MockTrait implements MockType
{
private readonly string $classCode;
/**
* @psalm-var class-string
*/
private readonly string $mockName;
/**
* @psalm-param class-string $mockName
*/
public function __construct(string $classCode, string $mockName)
{
$this->classCode = $classCode;
$this->mockName = $mockName;
}
/**
* @psalm-return class-string
*/
public function generate(): string
{
if (!class_exists($this->mockName, false)) {
eval($this->classCode);
}
return $this->mockName;
}
}
src/Framework/DataProviderTestSuite.php 0000644 00000003635 15243426620 0014252 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Framework;
use function explode;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Api\Groups;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DataProviderTestSuite extends TestSuite
{
/**
* @psalm-var list<ExecutionOrderDependency>
*/
private array $dependencies = [];
private ?array $providedTests = null;
/**
* @psalm-param list<ExecutionOrderDependency> $dependencies
*/
public function setDependencies(array $dependencies): void
{
$this->dependencies = $dependencies;
foreach ($this->tests() as $test) {
if (!$test instanceof TestCase) {
continue;
}
$test->setDependencies($dependencies);
}
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
if ($this->providedTests === null) {
$this->providedTests = [new ExecutionOrderDependency($this->name())];
}
return $this->providedTests;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
// A DataProviderTestSuite does not have to traverse its child tests
// as these are inherited and cannot reference dataProvider rows directly
return $this->dependencies;
}
/**
* Returns the size of each test created using the data provider(s).
*/
public function size(): TestSize
{
[$className, $methodName] = explode('::', $this->name());
return (new Groups)->size($className, $methodName);
}
}
src/Exception.php 0000644 00000000513 15243426620 0010005 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit;
use Throwable;
interface Exception extends Throwable
{
}
src/Runner/Filter/Factory.php 0000644 00000003726 15243426620 0012165 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function assert;
use FilterIterator;
use Iterator;
use PHPUnit\Framework\TestSuite;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Factory
{
/**
* @psalm-var array<int,array{0: ReflectionClass, 1: array|string}>
*/
private array $filters = [];
/**
* @psalm-param list<non-empty-string> $testIds
*/
public function addTestIdFilter(array $testIds): void
{
$this->filters[] = [
new ReflectionClass(TestIdFilterIterator::class), $testIds,
];
}
/**
* @psalm-param list<non-empty-string> $groups
*/
public function addExcludeGroupFilter(array $groups): void
{
$this->filters[] = [
new ReflectionClass(ExcludeGroupFilterIterator::class), $groups,
];
}
/**
* @psalm-param list<non-empty-string> $groups
*/
public function addIncludeGroupFilter(array $groups): void
{
$this->filters[] = [
new ReflectionClass(IncludeGroupFilterIterator::class), $groups,
];
}
/**
* @psalm-param non-empty-string $name
*/
public function addNameFilter(string $name): void
{
$this->filters[] = [
new ReflectionClass(NameFilterIterator::class), $name,
];
}
public function factory(Iterator $iterator, TestSuite $suite): FilterIterator
{
foreach ($this->filters as $filter) {
[$class, $arguments] = $filter;
$iterator = $class->newInstance($iterator, $arguments, $suite);
}
assert($iterator instanceof FilterIterator);
return $iterator;
}
}
src/Runner/Filter/GroupFilterIterator.php 0000644 00000003166 15243426620 0014530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function array_map;
use function array_push;
use function in_array;
use function spl_object_id;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestSuite;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class GroupFilterIterator extends RecursiveFilterIterator
{
/**
* @psalm-var list<int>
*/
protected array $groupTests = [];
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param list<non-empty-string> $groups
*/
public function __construct(RecursiveIterator $iterator, array $groups, TestSuite $suite)
{
parent::__construct($iterator);
foreach ($suite->groupDetails() as $group => $tests) {
if (in_array((string) $group, $groups, true)) {
$testHashes = array_map(
'spl_object_id',
$tests,
);
array_push($this->groupTests, ...$testHashes);
}
}
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
return $this->doAccept(spl_object_id($test));
}
abstract protected function doAccept(int $id): bool;
}
src/Runner/Filter/IncludeGroupFilterIterator.php 0000644 00000001121 15243426620 0016021 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class IncludeGroupFilterIterator extends GroupFilterIterator
{
protected function doAccept(int $id): bool
{
return in_array($id, $this->groupTests, true);
}
}
src/Runner/Filter/NameFilterIterator.php 0000644 00000007427 15243426620 0014320 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function end;
use function implode;
use function preg_match;
use function sprintf;
use function str_replace;
use Exception;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NameFilterIterator extends RecursiveFilterIterator
{
private ?string $filter = null;
private ?int $filterMin = null;
private ?int $filterMax = null;
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param non-empty-string $filter
*
* @throws Exception
*/
public function __construct(RecursiveIterator $iterator, string $filter)
{
parent::__construct($iterator);
$this->setFilter($filter);
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
$tmp = $this->describe($test);
if ($tmp[0] !== '') {
$name = implode('::', $tmp);
} else {
$name = $tmp[1];
}
$accepted = @preg_match($this->filter, $name, $matches);
if ($accepted && isset($this->filterMax)) {
$set = end($matches);
$accepted = $set >= $this->filterMin && $set <= $this->filterMax;
}
return (bool) $accepted;
}
/**
* @throws Exception
*/
private function setFilter(string $filter): void
{
if (@preg_match($filter, '') === false) {
// Handles:
// * testAssertEqualsSucceeds#4
// * testAssertEqualsSucceeds#4-8
if (preg_match('/^(.*?)#(\d+)(?:-(\d+))?$/', $filter, $matches)) {
if (isset($matches[3]) && $matches[2] < $matches[3]) {
$filter = sprintf(
'%s.*with data set #(\d+)$',
$matches[1],
);
$this->filterMin = (int) $matches[2];
$this->filterMax = (int) $matches[3];
} else {
$filter = sprintf(
'%s.*with data set #%s$',
$matches[1],
$matches[2],
);
}
} // Handles:
// * testDetermineJsonError@JSON_ERROR_NONE
// * testDetermineJsonError@JSON.*
elseif (preg_match('/^(.*?)@(.+)$/', $filter, $matches)) {
$filter = sprintf(
'%s.*with data set "%s"$',
$matches[1],
$matches[2],
);
}
// Escape delimiters in regular expression. Do NOT use preg_quote,
// to keep magic characters.
$filter = sprintf(
'/%s/i',
str_replace(
'/',
'\\/',
$filter,
),
);
}
$this->filter = $filter;
}
/**
* @psalm-return array{0: string, 1: string}
*/
private function describe(Test $test): array
{
if ($test instanceof TestCase) {
return [$test::class, $test->nameWithDataSet()];
}
if ($test instanceof SelfDescribing) {
return ['', $test->toString()];
}
return ['', $test::class];
}
}
src/Runner/Filter/TestIdFilterIterator.php 0000644 00000003300 15243426620 0014616 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Event\TestData\NoDataSetFromDataProviderException;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\PhptTestCase;
use RecursiveFilterIterator;
use RecursiveIterator;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestIdFilterIterator extends RecursiveFilterIterator
{
/**
* @psalm-var non-empty-list<non-empty-string>
*/
private readonly array $testIds;
/**
* @psalm-param RecursiveIterator<int, Test> $iterator
* @psalm-param non-empty-list<non-empty-string> $testIds
*/
public function __construct(RecursiveIterator $iterator, array $testIds)
{
parent::__construct($iterator);
$this->testIds = $testIds;
}
public function accept(): bool
{
$test = $this->getInnerIterator()->current();
if ($test instanceof TestSuite) {
return true;
}
if (!$test instanceof TestCase && !$test instanceof PhptTestCase) {
return false;
}
try {
return in_array($test->valueObjectForEvents()->id(), $this->testIds, true);
} catch (MoreThanOneDataSetFromDataProviderException|NoDataSetFromDataProviderException) {
return false;
}
}
}
src/Runner/Filter/ExcludeGroupFilterIterator.php 0000644 00000001122 15243426620 0016030 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Filter;
use function in_array;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExcludeGroupFilterIterator extends GroupFilterIterator
{
protected function doAccept(int $id): bool
{
return !in_array($id, $this->groupTests, true);
}
}
src/Runner/GarbageCollection/GarbageCollectionHandler.php 0000644 00000004244 15243426620 0017533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use function gc_collect_cycles;
use function gc_disable;
use function gc_enable;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\UnknownSubscriberTypeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class GarbageCollectionHandler
{
private readonly Facade $facade;
private readonly int $threshold;
private int $tests = 0;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, int $threshold)
{
$this->facade = $facade;
$this->threshold = $threshold;
$this->registerSubscribers();
}
public function executionStarted(): void
{
gc_disable();
$this->facade->emitter()->testRunnerDisabledGarbageCollection();
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
}
public function executionFinished(): void
{
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
gc_enable();
$this->facade->emitter()->testRunnerEnabledGarbageCollection();
}
public function testFinished(): void
{
$this->tests++;
if ($this->tests === $this->threshold) {
gc_collect_cycles();
$this->facade->emitter()->testRunnerTriggeredGarbageCollection();
$this->tests = 0;
}
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(): void
{
$this->facade->registerSubscribers(
new ExecutionStartedSubscriber($this),
new ExecutionFinishedSubscriber($this),
new TestFinishedSubscriber($this),
);
}
}
src/Runner/GarbageCollection/Subscriber/ExecutionStartedSubscriber.php 0000644 00000001635 15243426620 0022313 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber as TestRunnerExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStartedSubscriber extends Subscriber implements TestRunnerExecutionStartedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(ExecutionStarted $event): void
{
$this->handler()->executionStarted();
}
}
src/Runner/GarbageCollection/Subscriber/TestFinishedSubscriber.php 0000644 00000001467 15243426620 0021415 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->handler()->testFinished();
}
}
src/Runner/GarbageCollection/Subscriber/Subscriber.php 0000644 00000001273 15243426620 0017076 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly GarbageCollectionHandler $handler;
public function __construct(GarbageCollectionHandler $handler)
{
$this->handler = $handler;
}
protected function handler(): GarbageCollectionHandler
{
return $this->handler;
}
}
src/Runner/GarbageCollection/Subscriber/ExecutionFinishedSubscriber.php 0000644 00000001644 15243426620 0022436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\GarbageCollection;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber as TestRunnerExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionFinishedSubscriber extends Subscriber implements TestRunnerExecutionFinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(ExecutionFinished $event): void
{
$this->handler()->executionFinished();
}
}
src/Runner/ErrorHandler.php 0000644 00000014065 15243426620 0011716 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use const E_COMPILE_ERROR;
use const E_COMPILE_WARNING;
use const E_CORE_ERROR;
use const E_CORE_WARNING;
use const E_DEPRECATED;
use const E_ERROR;
use const E_NOTICE;
use const E_PARSE;
use const E_RECOVERABLE_ERROR;
use const E_STRICT;
use const E_USER_DEPRECATED;
use const E_USER_ERROR;
use const E_USER_NOTICE;
use const E_USER_WARNING;
use const E_WARNING;
use function error_reporting;
use function restore_error_handler;
use function set_error_handler;
use PHPUnit\Event;
use PHPUnit\Event\Code\NoTestCaseObjectOnCallStackException;
use PHPUnit\Runner\Baseline\Baseline;
use PHPUnit\Runner\Baseline\Issue;
use PHPUnit\Util\ExcludeList;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorHandler
{
private const UNHANDLEABLE_LEVELS = E_ERROR | E_PARSE | E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_COMPILE_WARNING;
private const INSUPPRESSIBLE_LEVELS = E_ERROR | E_PARSE | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR;
private static ?self $instance = null;
private ?Baseline $baseline = null;
private bool $enabled = false;
private ?int $originalErrorReportingLevel = null;
public static function instance(): self
{
return self::$instance ?? self::$instance = new self;
}
/**
* @throws NoTestCaseObjectOnCallStackException
*/
public function __invoke(int $errorNumber, string $errorString, string $errorFile, int $errorLine): bool
{
$suppressed = (error_reporting() & ~self::INSUPPRESSIBLE_LEVELS) === 0;
if ($suppressed && (new ExcludeList)->isExcluded($errorFile)) {
return false;
}
$test = Event\Code\TestMethodBuilder::fromCallStack();
$ignoredByBaseline = $this->ignoredByBaseline($errorFile, $errorLine, $errorString);
$ignoredByTest = $test->metadata()->isIgnoreDeprecations()->isNotEmpty();
switch ($errorNumber) {
case E_NOTICE:
case E_STRICT:
Event\Facade::emitter()->testTriggeredPhpNotice(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_USER_NOTICE:
Event\Facade::emitter()->testTriggeredNotice(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_WARNING:
Event\Facade::emitter()->testTriggeredPhpWarning(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_USER_WARNING:
Event\Facade::emitter()->testTriggeredWarning(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
);
break;
case E_DEPRECATED:
Event\Facade::emitter()->testTriggeredPhpDeprecation(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
);
break;
case E_USER_DEPRECATED:
Event\Facade::emitter()->testTriggeredDeprecation(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
$ignoredByBaseline,
$ignoredByTest,
);
break;
case E_USER_ERROR:
Event\Facade::emitter()->testTriggeredError(
$test,
$errorString,
$errorFile,
$errorLine,
$suppressed,
);
throw new ErrorException('E_USER_ERROR was triggered');
default:
return false;
}
return false;
}
public function enable(): void
{
if ($this->enabled) {
return;
}
$oldErrorHandler = set_error_handler($this);
if ($oldErrorHandler !== null) {
restore_error_handler();
return;
}
$this->enabled = true;
$this->originalErrorReportingLevel = error_reporting();
error_reporting($this->originalErrorReportingLevel & self::UNHANDLEABLE_LEVELS);
}
public function disable(): void
{
if (!$this->enabled) {
return;
}
restore_error_handler();
error_reporting(error_reporting() | $this->originalErrorReportingLevel);
$this->enabled = false;
$this->originalErrorReportingLevel = null;
}
public function use(Baseline $baseline): void
{
$this->baseline = $baseline;
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
private function ignoredByBaseline(string $file, int $line, string $description): bool
{
if ($this->baseline === null) {
return false;
}
return $this->baseline->has(Issue::from($file, $line, null, $description));
}
}
src/Runner/Extension/PharLoader.php 0000644 00000010752 15243426620 0013323 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function count;
use function explode;
use function extension_loaded;
use function implode;
use function is_file;
use function sprintf;
use function str_contains;
use PharIo\Manifest\ApplicationName;
use PharIo\Manifest\Exception as ManifestException;
use PharIo\Manifest\ManifestLoader;
use PharIo\Version\Version as PharIoVersion;
use PHPUnit\Event;
use PHPUnit\Runner\Version;
use SebastianBergmann\FileIterator\Facade as FileIteratorFacade;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PharLoader
{
/**
* @psalm-param non-empty-string $directory
*
* @psalm-return list<string>
*/
public function loadPharExtensionsInDirectory(string $directory): array
{
$pharExtensionLoaded = extension_loaded('phar');
$loadedExtensions = [];
foreach ((new FileIteratorFacade)->getFilesAsArray($directory, '.phar') as $file) {
if (!$pharExtensionLoaded) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s because the PHAR extension is not available',
$file,
),
);
continue;
}
if (!is_file('phar://' . $file . '/manifest.xml')) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not an extension for PHPUnit',
$file,
),
);
continue;
}
try {
$applicationName = new ApplicationName('phpunit/phpunit');
$version = new PharIoVersion($this->phpunitVersion());
$manifest = ManifestLoader::fromFile('phar://' . $file . '/manifest.xml');
if (!$manifest->isExtensionFor($applicationName)) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not an extension for PHPUnit',
$file,
),
);
continue;
}
if (!$manifest->isExtensionFor($applicationName, $version)) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'%s is not compatible with PHPUnit %s',
$file,
Version::series(),
),
);
continue;
}
} catch (ManifestException $e) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s: %s',
$file,
$e->getMessage(),
),
);
continue;
}
try {
/** @psalm-suppress UnresolvableInclude */
@require $file;
} catch (Throwable $t) {
Event\Facade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot load extension from %s: %s',
$file,
$t->getMessage(),
),
);
continue;
}
$loadedExtensions[] = $manifest->getName()->asString() . ' ' . $manifest->getVersion()->getVersionString();
Event\Facade::emitter()->testRunnerLoadedExtensionFromPhar(
$file,
$manifest->getName()->asString(),
$manifest->getVersion()->getVersionString(),
);
}
return $loadedExtensions;
}
private function phpunitVersion(): string
{
$version = Version::id();
if (!str_contains($version, '-')) {
return $version;
}
$parts = explode('.', explode('-', $version)[0]);
if (count($parts) === 2) {
$parts[] = 0;
}
return implode('.', $parts);
}
}
src/Runner/Extension/ParameterCollection.php 0000644 00000002352 15243426620 0015233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function array_key_exists;
use PHPUnit\Runner\ParameterDoesNotExistException;
/**
* @psalm-immutable
*
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class ParameterCollection
{
private readonly array $parameters;
/**
* @psalm-param array<string, string> $parameters
*/
public static function fromArray(array $parameters): self
{
return new self($parameters);
}
private function __construct(array $parameters)
{
$this->parameters = $parameters;
}
public function has(string $name): bool
{
return array_key_exists($name, $this->parameters);
}
/**
* @throws ParameterDoesNotExistException
*/
public function get(string $name): string
{
if (!$this->has($name)) {
throw new ParameterDoesNotExistException($name);
}
return $this->parameters[$name];
}
}
src/Runner/Extension/Facade.php 0000644 00000005424 15243426620 0012445 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\Subscriber;
use PHPUnit\Event\Tracer\Tracer;
use PHPUnit\Event\UnknownSubscriberTypeException;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private bool $replacesOutput = false;
private bool $replacesProgressOutput = false;
private bool $replacesResultOutput = false;
private bool $requiresCodeCoverageCollection = false;
private bool $requiresExportOfObjects = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscribers(Subscriber ...$subscribers): void
{
EventFacade::instance()->registerSubscribers(...$subscribers);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function registerSubscriber(Subscriber $subscriber): void
{
EventFacade::instance()->registerSubscriber($subscriber);
}
/**
* @throws EventFacadeIsSealedException
*/
public function registerTracer(Tracer $tracer): void
{
EventFacade::instance()->registerTracer($tracer);
}
public function replaceOutput(): void
{
$this->replacesOutput = true;
}
public function replacesOutput(): bool
{
return $this->replacesOutput;
}
public function replaceProgressOutput(): void
{
$this->replacesProgressOutput = true;
}
public function replacesProgressOutput(): bool
{
return $this->replacesOutput || $this->replacesProgressOutput;
}
public function replaceResultOutput(): void
{
$this->replacesResultOutput = true;
}
public function replacesResultOutput(): bool
{
return $this->replacesOutput || $this->replacesResultOutput;
}
public function requireCodeCoverageCollection(): void
{
$this->requiresCodeCoverageCollection = true;
}
public function requiresCodeCoverageCollection(): bool
{
return $this->requiresCodeCoverageCollection;
}
/**
* @deprecated
*/
public function requireExportOfObjects(): void
{
$this->requiresExportOfObjects = true;
}
/**
* @deprecated
*/
public function requiresExportOfObjects(): bool
{
return $this->requiresExportOfObjects;
}
}
src/Runner/Extension/ExtensionBootstrapper.php 0000644 00000005214 15243426620 0015660 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use function assert;
use function class_exists;
use function class_implements;
use function in_array;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\TextUI\Configuration\Configuration;
use ReflectionClass;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExtensionBootstrapper
{
private readonly Configuration $configuration;
private readonly Facade $facade;
public function __construct(Configuration $configuration, Facade $facade)
{
$this->configuration = $configuration;
$this->facade = $facade;
}
/**
* @psalm-param class-string $className
* @psalm-param array<string, string> $parameters
*/
public function bootstrap(string $className, array $parameters): void
{
if (!class_exists($className)) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot bootstrap extension because class %s does not exist',
$className,
),
);
return;
}
if (!in_array(Extension::class, class_implements($className), true)) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Cannot bootstrap extension because class %s does not implement interface %s',
$className,
Extension::class,
),
);
return;
}
try {
$instance = (new ReflectionClass($className))->newInstance();
assert($instance instanceof Extension);
$instance->bootstrap(
$this->configuration,
$this->facade,
ParameterCollection::fromArray($parameters),
);
} catch (Throwable $t) {
EventFacade::emitter()->testRunnerTriggeredWarning(
sprintf(
'Bootstrapping of extension %s failed: %s%s%s',
$className,
$t->getMessage(),
PHP_EOL,
$t->getTraceAsString(),
),
);
return;
}
EventFacade::emitter()->testRunnerBootstrappedExtension(
$className,
$parameters,
);
}
}
src/Runner/Extension/Extension.php 0000644 00000001120 15243426620 0013243 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Extension;
use PHPUnit\TextUI\Configuration\Configuration;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
interface Extension
{
public function bootstrap(Configuration $configuration, Facade $facade, ParameterCollection $parameters): void;
}
src/Runner/PhptTestCase.php 0000644 00000056220 15243426620 0011675 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use const DEBUG_BACKTRACE_IGNORE_ARGS;
use const DIRECTORY_SEPARATOR;
use function array_merge;
use function basename;
use function debug_backtrace;
use function defined;
use function dirname;
use function explode;
use function extension_loaded;
use function file;
use function file_get_contents;
use function file_put_contents;
use function is_array;
use function is_file;
use function is_readable;
use function is_string;
use function ltrim;
use function preg_match;
use function preg_replace;
use function preg_split;
use function realpath;
use function rtrim;
use function str_contains;
use function str_replace;
use function str_starts_with;
use function strncasecmp;
use function substr;
use function trim;
use function unlink;
use function unserialize;
use function var_export;
use PHPUnit\Event\Code\Phpt;
use PHPUnit\Event\Code\ThrowableBuilder;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\NoPreviousThrowableException;
use PHPUnit\Framework\Assert;
use PHPUnit\Framework\AssertionFailedError;
use PHPUnit\Framework\ExecutionOrderDependency;
use PHPUnit\Framework\ExpectationFailedException;
use PHPUnit\Framework\IncompleteTestError;
use PHPUnit\Framework\PhptAssertionFailedError;
use PHPUnit\Framework\Reorderable;
use PHPUnit\Framework\SelfDescribing;
use PHPUnit\Framework\Test;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
use PHPUnit\Util\PHP\AbstractPhpProcess;
use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
use SebastianBergmann\CodeCoverage\InvalidArgumentException;
use SebastianBergmann\CodeCoverage\ReflectionException;
use SebastianBergmann\CodeCoverage\StaticAnalysisCacheNotConfiguredException;
use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
use SebastianBergmann\CodeCoverage\Test\TestStatus\TestStatus;
use SebastianBergmann\CodeCoverage\TestIdMissingException;
use SebastianBergmann\CodeCoverage\UnintentionallyCoveredCodeException;
use SebastianBergmann\Template\Template;
use Throwable;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptTestCase implements Reorderable, SelfDescribing, Test
{
/**
* @psalm-var non-empty-string
*/
private readonly string $filename;
private readonly AbstractPhpProcess $phpUtil;
private string $output = '';
/**
* Constructs a test case with the given filename.
*
* @psalm-param non-empty-string $filename
*
* @throws Exception
*/
public function __construct(string $filename, ?AbstractPhpProcess $phpUtil = null)
{
if (!is_file($filename)) {
throw new FileDoesNotExistException($filename);
}
$this->filename = $filename;
$this->phpUtil = $phpUtil ?: AbstractPhpProcess::factory();
}
/**
* Counts the number of test cases executed by run(TestResult result).
*/
public function count(): int
{
return 1;
}
/**
* Runs a test and collects its result in a TestResult instance.
*
* @throws \PHPUnit\Framework\Exception
* @throws \SebastianBergmann\Template\InvalidArgumentException
* @throws Exception
* @throws InvalidArgumentException
* @throws NoPreviousThrowableException
* @throws ReflectionException
* @throws StaticAnalysisCacheNotConfiguredException
* @throws TestIdMissingException
* @throws UnintentionallyCoveredCodeException
*
* @noinspection RepetitiveMethodCallsInspection
*/
public function run(): void
{
$emitter = EventFacade::emitter();
$emitter->testPreparationStarted(
$this->valueObjectForEvents(),
);
try {
$sections = $this->parse();
} catch (Exception $e) {
$emitter->testPrepared($this->valueObjectForEvents());
$emitter->testErrored($this->valueObjectForEvents(), ThrowableBuilder::from($e));
$emitter->testFinished($this->valueObjectForEvents(), 0);
return;
}
$code = $this->render($sections['FILE']);
$xfail = false;
$settings = $this->parseIniSection($this->settings(CodeCoverage::instance()->isActive()));
$emitter->testPrepared($this->valueObjectForEvents());
if (isset($sections['INI'])) {
$settings = $this->parseIniSection($sections['INI'], $settings);
}
if (isset($sections['ENV'])) {
$env = $this->parseEnvSection($sections['ENV']);
$this->phpUtil->setEnv($env);
}
$this->phpUtil->setUseStderrRedirection(true);
if ($this->shouldTestBeSkipped($sections, $settings)) {
return;
}
if (isset($sections['XFAIL'])) {
$xfail = trim($sections['XFAIL']);
}
if (isset($sections['STDIN'])) {
$this->phpUtil->setStdin($sections['STDIN']);
}
if (isset($sections['ARGS'])) {
$this->phpUtil->setArgs($sections['ARGS']);
}
if (CodeCoverage::instance()->isActive()) {
$codeCoverageCacheDirectory = null;
if (CodeCoverage::instance()->codeCoverage()->cachesStaticAnalysis()) {
$codeCoverageCacheDirectory = CodeCoverage::instance()->codeCoverage()->cacheDirectory();
}
$this->renderForCoverage(
$code,
CodeCoverage::instance()->codeCoverage()->collectsBranchAndPathCoverage(),
$codeCoverageCacheDirectory,
);
}
$jobResult = $this->phpUtil->runJob($code, $this->stringifyIni($settings));
$this->output = $jobResult['stdout'] ?? '';
if (CodeCoverage::instance()->isActive()) {
$coverage = $this->cleanupForCoverage();
CodeCoverage::instance()->codeCoverage()->start($this->filename, TestSize::large());
CodeCoverage::instance()->codeCoverage()->append(
$coverage,
$this->filename,
true,
TestStatus::unknown(),
);
}
try {
$this->assertPhptExpectation($sections, $this->output);
} catch (AssertionFailedError $e) {
$failure = $e;
if ($xfail !== false) {
$failure = new IncompleteTestError($xfail, 0, $e);
} elseif ($e instanceof ExpectationFailedException) {
$comparisonFailure = $e->getComparisonFailure();
if ($comparisonFailure) {
$diff = $comparisonFailure->getDiff();
} else {
$diff = $e->getMessage();
}
$hint = $this->getLocationHintFromDiff($diff, $sections);
$trace = array_merge($hint, debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS));
$failure = new PhptAssertionFailedError(
$e->getMessage(),
0,
(string) $trace[0]['file'],
(int) $trace[0]['line'],
$trace,
$comparisonFailure ? $diff : '',
);
}
if ($failure instanceof IncompleteTestError) {
$emitter->testMarkedAsIncomplete($this->valueObjectForEvents(), ThrowableBuilder::from($failure));
} else {
$emitter->testFailed($this->valueObjectForEvents(), ThrowableBuilder::from($failure), null);
}
} catch (Throwable $t) {
$emitter->testErrored($this->valueObjectForEvents(), ThrowableBuilder::from($t));
}
$this->runClean($sections, CodeCoverage::instance()->isActive());
$emitter->testFinished($this->valueObjectForEvents(), 1);
}
/**
* Returns the name of the test case.
*/
public function getName(): string
{
return $this->toString();
}
/**
* Returns a string representation of the test case.
*/
public function toString(): string
{
return $this->filename;
}
public function usesDataProvider(): bool
{
return false;
}
public function numberOfAssertionsPerformed(): int
{
return 1;
}
public function output(): string
{
return $this->output;
}
public function hasOutput(): bool
{
return !empty($this->output);
}
public function sortId(): string
{
return $this->filename;
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function provides(): array
{
return [];
}
/**
* @psalm-return list<ExecutionOrderDependency>
*/
public function requires(): array
{
return [];
}
/**
* @internal This method is not covered by the backward compatibility promise for PHPUnit
*/
public function valueObjectForEvents(): Phpt
{
return new Phpt($this->filename);
}
/**
* Parse --INI-- section key value pairs and return as array.
*/
private function parseIniSection(array|string $content, array $ini = []): array
{
if (is_string($content)) {
$content = explode("\n", trim($content));
}
foreach ($content as $setting) {
if (!str_contains($setting, '=')) {
continue;
}
$setting = explode('=', $setting, 2);
$name = trim($setting[0]);
$value = trim($setting[1]);
if ($name === 'extension' || $name === 'zend_extension') {
if (!isset($ini[$name])) {
$ini[$name] = [];
}
$ini[$name][] = $value;
continue;
}
$ini[$name] = $value;
}
return $ini;
}
private function parseEnvSection(string $content): array
{
$env = [];
foreach (explode("\n", trim($content)) as $e) {
$e = explode('=', trim($e), 2);
if (!empty($e[0]) && isset($e[1])) {
$env[$e[0]] = $e[1];
}
}
return $env;
}
/**
* @throws Exception
* @throws ExpectationFailedException
*/
private function assertPhptExpectation(array $sections, string $output): void
{
$assertions = [
'EXPECT' => 'assertEquals',
'EXPECTF' => 'assertStringMatchesFormat',
'EXPECTREGEX' => 'assertMatchesRegularExpression',
];
$actual = preg_replace('/\r\n/', "\n", trim($output));
foreach ($assertions as $sectionName => $sectionAssertion) {
if (isset($sections[$sectionName])) {
$sectionContent = preg_replace('/\r\n/', "\n", trim($sections[$sectionName]));
$expected = $sectionName === 'EXPECTREGEX' ? "/{$sectionContent}/" : $sectionContent;
Assert::$sectionAssertion($expected, $actual);
return;
}
}
throw new InvalidPhptFileException;
}
private function shouldTestBeSkipped(array $sections, array $settings): bool
{
if (!isset($sections['SKIPIF'])) {
return false;
}
$skipif = $this->render($sections['SKIPIF']);
$jobResult = $this->phpUtil->runJob($skipif, $this->stringifyIni($settings));
if (!strncasecmp('skip', ltrim($jobResult['stdout']), 4)) {
$message = '';
if (preg_match('/^\s*skip\s*(.+)\s*/i', $jobResult['stdout'], $skipMatch)) {
$message = substr($skipMatch[1], 2);
}
EventFacade::emitter()->testSkipped(
$this->valueObjectForEvents(),
$message,
);
EventFacade::emitter()->testFinished($this->valueObjectForEvents(), 0);
return true;
}
return false;
}
private function runClean(array $sections, bool $collectCoverage): void
{
$this->phpUtil->setStdin('');
$this->phpUtil->setArgs('');
if (isset($sections['CLEAN'])) {
$cleanCode = $this->render($sections['CLEAN']);
$this->phpUtil->runJob($cleanCode, $this->settings($collectCoverage));
}
}
/**
* @throws Exception
*/
private function parse(): array
{
$sections = [];
$section = '';
$unsupportedSections = [
'CGI',
'COOKIE',
'DEFLATE_POST',
'EXPECTHEADERS',
'EXTENSIONS',
'GET',
'GZIP_POST',
'HEADERS',
'PHPDBG',
'POST',
'POST_RAW',
'PUT',
'REDIRECTTEST',
'REQUEST',
];
$lineNr = 0;
foreach (file($this->filename) as $line) {
$lineNr++;
if (preg_match('/^--([_A-Z]+)--/', $line, $result)) {
$section = $result[1];
$sections[$section] = '';
$sections[$section . '_offset'] = $lineNr;
continue;
}
if (empty($section)) {
throw new InvalidPhptFileException;
}
$sections[$section] .= $line;
}
if (isset($sections['FILEEOF'])) {
$sections['FILE'] = rtrim($sections['FILEEOF'], "\r\n");
unset($sections['FILEEOF']);
}
$this->parseExternal($sections);
if (!$this->validate($sections)) {
throw new InvalidPhptFileException;
}
foreach ($unsupportedSections as $section) {
if (isset($sections[$section])) {
throw new UnsupportedPhptSectionException($section);
}
}
return $sections;
}
/**
* @throws Exception
*/
private function parseExternal(array &$sections): void
{
$allowSections = [
'FILE',
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
];
$testDirectory = dirname($this->filename) . DIRECTORY_SEPARATOR;
foreach ($allowSections as $section) {
if (isset($sections[$section . '_EXTERNAL'])) {
$externalFilename = trim($sections[$section . '_EXTERNAL']);
if (!is_file($testDirectory . $externalFilename) ||
!is_readable($testDirectory . $externalFilename)) {
throw new PhptExternalFileCannotBeLoadedException(
$section,
$testDirectory . $externalFilename,
);
}
$sections[$section] = file_get_contents($testDirectory . $externalFilename);
}
}
}
private function validate(array $sections): bool
{
$requiredSections = [
'FILE',
[
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
],
];
foreach ($requiredSections as $section) {
if (is_array($section)) {
$foundSection = false;
foreach ($section as $anySection) {
if (isset($sections[$anySection])) {
$foundSection = true;
break;
}
}
if (!$foundSection) {
return false;
}
continue;
}
if (!isset($sections[$section])) {
return false;
}
}
return true;
}
private function render(string $code): string
{
return str_replace(
[
'__DIR__',
'__FILE__',
],
[
"'" . dirname($this->filename) . "'",
"'" . $this->filename . "'",
],
$code,
);
}
private function getCoverageFiles(): array
{
$baseDir = dirname(realpath($this->filename)) . DIRECTORY_SEPARATOR;
$basename = basename($this->filename, 'phpt');
return [
'coverage' => $baseDir . $basename . 'coverage',
'job' => $baseDir . $basename . 'php',
];
}
/**
* @throws \SebastianBergmann\Template\InvalidArgumentException
*/
private function renderForCoverage(string &$job, bool $pathCoverage, ?string $codeCoverageCacheDirectory): void
{
$files = $this->getCoverageFiles();
$template = new Template(
__DIR__ . '/../Util/PHP/Template/PhptTestCase.tpl',
);
$composerAutoload = '\'\'';
if (defined('PHPUNIT_COMPOSER_INSTALL')) {
$composerAutoload = var_export(PHPUNIT_COMPOSER_INSTALL, true);
}
$phar = '\'\'';
if (defined('__PHPUNIT_PHAR__')) {
$phar = var_export(__PHPUNIT_PHAR__, true);
}
if ($codeCoverageCacheDirectory === null) {
$codeCoverageCacheDirectory = 'null';
} else {
$codeCoverageCacheDirectory = "'" . $codeCoverageCacheDirectory . "'";
}
$bootstrap = '';
if (ConfigurationRegistry::get()->hasBootstrap()) {
$bootstrap = ConfigurationRegistry::get()->bootstrap();
}
$template->setVar(
[
'bootstrap' => $bootstrap,
'composerAutoload' => $composerAutoload,
'phar' => $phar,
'job' => $files['job'],
'coverageFile' => $files['coverage'],
'driverMethod' => $pathCoverage ? 'forLineAndPathCoverage' : 'forLineCoverage',
'codeCoverageCacheDirectory' => $codeCoverageCacheDirectory,
],
);
file_put_contents($files['job'], $job);
$job = $template->render();
}
private function cleanupForCoverage(): RawCodeCoverageData
{
$coverage = RawCodeCoverageData::fromXdebugWithoutPathCoverage([]);
$files = $this->getCoverageFiles();
$buffer = false;
if (is_file($files['coverage'])) {
$buffer = @file_get_contents($files['coverage']);
}
if ($buffer !== false) {
$coverage = @unserialize($buffer);
if ($coverage === false) {
$coverage = RawCodeCoverageData::fromXdebugWithoutPathCoverage([]);
}
}
foreach ($files as $file) {
@unlink($file);
}
return $coverage;
}
private function stringifyIni(array $ini): array
{
$settings = [];
foreach ($ini as $key => $value) {
if (is_array($value)) {
foreach ($value as $val) {
$settings[] = $key . '=' . $val;
}
continue;
}
$settings[] = $key . '=' . $value;
}
return $settings;
}
private function getLocationHintFromDiff(string $message, array $sections): array
{
$needle = '';
$previousLine = '';
$block = 'message';
foreach (preg_split('/\r\n|\r|\n/', $message) as $line) {
$line = trim($line);
if ($block === 'message' && $line === '--- Expected') {
$block = 'expected';
}
if ($block === 'expected' && $line === '@@ @@') {
$block = 'diff';
}
if ($block === 'diff') {
if (str_starts_with($line, '+')) {
$needle = $this->getCleanDiffLine($previousLine);
break;
}
if (str_starts_with($line, '-')) {
$needle = $this->getCleanDiffLine($line);
break;
}
}
if (!empty($line)) {
$previousLine = $line;
}
}
return $this->getLocationHint($needle, $sections);
}
private function getCleanDiffLine(string $line): string
{
if (preg_match('/^[\-+]([\'\"]?)(.*)\1$/', $line, $matches)) {
$line = $matches[2];
}
return $line;
}
private function getLocationHint(string $needle, array $sections): array
{
$needle = trim($needle);
if (empty($needle)) {
return [[
'file' => realpath($this->filename),
'line' => 1,
]];
}
$search = [
// 'FILE',
'EXPECT',
'EXPECTF',
'EXPECTREGEX',
];
foreach ($search as $section) {
if (!isset($sections[$section])) {
continue;
}
if (isset($sections[$section . '_EXTERNAL'])) {
$externalFile = trim($sections[$section . '_EXTERNAL']);
return [
[
'file' => realpath(dirname($this->filename) . DIRECTORY_SEPARATOR . $externalFile),
'line' => 1,
],
[
'file' => realpath($this->filename),
'line' => ($sections[$section . '_EXTERNAL_offset'] ?? 0) + 1,
],
];
}
$sectionOffset = $sections[$section . '_offset'] ?? 0;
$offset = $sectionOffset + 1;
foreach (preg_split('/\r\n|\r|\n/', $sections[$section]) as $line) {
if (str_contains($line, $needle)) {
return [
[
'file' => realpath($this->filename),
'line' => $offset,
],
];
}
$offset++;
}
}
return [
[
'file' => realpath($this->filename),
'line' => 1,
],
];
}
/**
* @psalm-return list<string>
*/
private function settings(bool $collectCoverage): array
{
$settings = [
'allow_url_fopen=1',
'auto_append_file=',
'auto_prepend_file=',
'disable_functions=',
'display_errors=1',
'docref_ext=.html',
'docref_root=',
'error_append_string=',
'error_prepend_string=',
'error_reporting=-1',
'html_errors=0',
'log_errors=0',
'open_basedir=',
'output_buffering=Off',
'output_handler=',
'report_memleaks=0',
'report_zend_debug=0',
];
if (extension_loaded('pcov')) {
if ($collectCoverage) {
$settings[] = 'pcov.enabled=1';
} else {
$settings[] = 'pcov.enabled=0';
}
}
if (extension_loaded('xdebug')) {
if ($collectCoverage) {
$settings[] = 'xdebug.mode=coverage';
} else {
$settings[] = 'xdebug.mode=off';
}
}
return $settings;
}
}
src/Runner/ResultCache/NullResultCache.php 0000644 00000001622 15243426620 0014561 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NullResultCache implements ResultCache
{
public function setStatus(string $id, TestStatus $status): void
{
}
public function status(string $id): TestStatus
{
return TestStatus::unknown();
}
public function setTime(string $id, float $time): void
{
}
public function time(string $id): float
{
return 0;
}
public function load(): void
{
}
public function persist(): void
{
}
}
src/Runner/ResultCache/ResultCache.php 0000644 00000001373 15243426620 0013731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface ResultCache
{
public function setStatus(string $id, TestStatus $status): void;
public function status(string $id): TestStatus;
public function setTime(string $id, float $time): void;
public function time(string $id): float;
public function load(): void;
public function persist(): void;
}
src/Runner/ResultCache/DefaultResultCache.php 0000644 00000007161 15243426620 0015237 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use const DIRECTORY_SEPARATOR;
use function array_keys;
use function assert;
use function dirname;
use function file_get_contents;
use function file_put_contents;
use function is_array;
use function is_dir;
use function is_file;
use function json_decode;
use function json_encode;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Runner\DirectoryCannotBeCreatedException;
use PHPUnit\Runner\Exception;
use PHPUnit\Util\Filesystem;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DefaultResultCache implements ResultCache
{
/**
* @var int
*/
private const VERSION = 1;
/**
* @var string
*/
private const DEFAULT_RESULT_CACHE_FILENAME = '.phpunit.result.cache';
private readonly string $cacheFilename;
/**
* @psalm-var array<string, TestStatus>
*/
private array $defects = [];
/**
* @psalm-var array<string, float>
*/
private array $times = [];
public function __construct(?string $filepath = null)
{
if ($filepath !== null && is_dir($filepath)) {
$filepath .= DIRECTORY_SEPARATOR . self::DEFAULT_RESULT_CACHE_FILENAME;
}
$this->cacheFilename = $filepath ?? $_ENV['PHPUNIT_RESULT_CACHE'] ?? self::DEFAULT_RESULT_CACHE_FILENAME;
}
public function setStatus(string $id, TestStatus $status): void
{
if ($status->isSuccess()) {
return;
}
$this->defects[$id] = $status;
}
public function status(string $id): TestStatus
{
return $this->defects[$id] ?? TestStatus::unknown();
}
public function setTime(string $id, float $time): void
{
$this->times[$id] = $time;
}
public function time(string $id): float
{
return $this->times[$id] ?? 0.0;
}
public function load(): void
{
if (!is_file($this->cacheFilename)) {
return;
}
$contents = file_get_contents($this->cacheFilename);
if ($contents === false) {
return;
}
$data = json_decode(
$contents,
true,
);
if ($data === null) {
return;
}
if (!isset($data['version'])) {
return;
}
if ($data['version'] !== self::VERSION) {
return;
}
assert(isset($data['defects']) && is_array($data['defects']));
assert(isset($data['times']) && is_array($data['times']));
foreach (array_keys($data['defects']) as $test) {
$data['defects'][$test] = TestStatus::from($data['defects'][$test]);
}
$this->defects = $data['defects'];
$this->times = $data['times'];
}
/**
* @throws Exception
*/
public function persist(): void
{
if (!Filesystem::createDirectory(dirname($this->cacheFilename))) {
throw new DirectoryCannotBeCreatedException($this->cacheFilename);
}
$data = [
'version' => self::VERSION,
'defects' => [],
'times' => $this->times,
];
foreach ($this->defects as $test => $status) {
$data['defects'][$test] = $status->asInt();
}
file_put_contents(
$this->cacheFilename,
json_encode($data),
LOCK_EX,
);
}
}
src/Runner/ResultCache/Subscriber/TestFailedSubscriber.php 0000644 00000001214 15243426620 0017674 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->handler()->testFailed($event);
}
}
src/Runner/ResultCache/Subscriber/TestPreparedSubscriber.php 0000644 00000001230 15243426620 0020250 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->handler()->testPrepared($event);
}
}
src/Runner/ResultCache/Subscriber/TestFinishedSubscriber.php 0000644 00000001467 15243426620 0020253 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->handler()->testFinished($event);
}
}
src/Runner/ResultCache/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001246 15243426620 0021260 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->handler()->testSuiteFinished();
}
}
src/Runner/ResultCache/Subscriber/TestSkippedSubscriber.php 0000644 00000001461 15243426620 0020113 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws \PHPUnit\Framework\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->handler()->testSkipped($event);
}
}
src/Runner/ResultCache/Subscriber/Subscriber.php 0000644 00000001243 15243426620 0015731 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly ResultCacheHandler $handler;
public function __construct(ResultCacheHandler $handler)
{
$this->handler = $handler;
}
protected function handler(): ResultCacheHandler
{
return $this->handler;
}
}
src/Runner/ResultCache/Subscriber/TestErroredSubscriber.php 0000644 00000001222 15243426620 0020111 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->handler()->testErrored($event);
}
}
src/Runner/ResultCache/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001310 15243426620 0021730 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->handler()->testMarkedIncomplete($event);
}
}
src/Runner/ResultCache/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001240 15243426620 0021127 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->handler()->testSuiteStarted();
}
}
src/Runner/ResultCache/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001302 15243426620 0021607 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->handler()->testConsideredRisky($event);
}
}
src/Runner/ResultCache/ResultCacheHandler.php 0000644 00000010250 15243426620 0015221 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\ResultCache;
use function round;
use PHPUnit\Event\Event;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\InvalidArgumentException;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ResultCacheHandler
{
private readonly ResultCache $cache;
private ?HRTime $time = null;
private int $testSuite = 0;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(ResultCache $cache, Facade $facade)
{
$this->cache = $cache;
$this->registerSubscribers($facade);
}
public function testSuiteStarted(): void
{
$this->testSuite++;
}
public function testSuiteFinished(): void
{
$this->testSuite--;
if ($this->testSuite === 0) {
$this->cache->persist();
}
}
public function testPrepared(Prepared $event): void
{
$this->time = $event->telemetryInfo()->time();
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::incomplete($event->throwable()->message()),
);
}
public function testConsideredRisky(ConsideredRisky $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::risky($event->message()),
);
}
public function testErrored(Errored $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::error($event->throwable()->message()),
);
}
public function testFailed(Failed $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::failure($event->throwable()->message()),
);
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
$this->cache->setStatus(
$event->test()->id(),
TestStatus::skipped($event->message()),
);
$this->cache->setTime($event->test()->id(), $this->duration($event));
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
$this->cache->setTime($event->test()->id(), $this->duration($event));
$this->time = null;
}
/**
* @throws \PHPUnit\Event\InvalidArgumentException
* @throws InvalidArgumentException
*/
private function duration(Event $event): float
{
if ($this->time === null) {
return 0.0;
}
return round($event->telemetryInfo()->time()->duration($this->time)->asFloat(), 3);
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestSkippedSubscriber($this),
new TestFinishedSubscriber($this),
);
}
}
src/Runner/Baseline/Writer.php 0000644 00000003516 15243426620 0012324 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function dirname;
use function file_put_contents;
use XMLWriter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Writer
{
/**
* @psalm-param non-empty-string $baselineFile
*/
public function write(string $baselineFile, Baseline $baseline): void
{
$pathCalculator = new RelativePathCalculator(dirname($baselineFile));
$writer = new XMLWriter;
$writer->openMemory();
$writer->setIndent(true);
$writer->startDocument();
$writer->startElement('files');
$writer->writeAttribute('version', (string) Baseline::VERSION);
foreach ($baseline->groupedByFileAndLine() as $file => $lines) {
assert(!empty($file));
$writer->startElement('file');
$writer->writeAttribute('path', $pathCalculator->calculate($file));
foreach ($lines as $line => $issues) {
$writer->startElement('line');
$writer->writeAttribute('number', (string) $line);
$writer->writeAttribute('hash', $issues[0]->hash());
foreach ($issues as $issue) {
$writer->startElement('issue');
$writer->writeCData($issue->description());
$writer->endElement();
}
$writer->endElement();
}
$writer->endElement();
}
$writer->endElement();
file_put_contents($baselineFile, $writer->outputMemory());
}
}
src/Runner/Baseline/Generator.php 0000644 00000004674 15243426620 0013004 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Runner\FileDoesNotExistException;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Generator
{
private Baseline $baseline;
private readonly Source $source;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, Source $source)
{
$facade->registerSubscribers(
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
$this->baseline = new Baseline;
$this->source = $source;
}
public function baseline(): Baseline
{
return $this->baseline;
}
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function testTriggeredIssue(DeprecationTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpWarningTriggered|WarningTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$this->baseline->add(
Issue::from(
$event->file(),
$event->line(),
null,
$event->message(),
),
);
}
}
src/Runner/Baseline/Reader.php 0000644 00000005720 15243426620 0012251 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function dirname;
use function file_exists;
use function realpath;
use function sprintf;
use function str_replace;
use function trim;
use DOMElement;
use DOMXPath;
use PHPUnit\Util\Xml\Loader as XmlLoader;
use PHPUnit\Util\Xml\XmlException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Reader
{
/**
* @psalm-param non-empty-string $baselineFile
*
* @throws CannotLoadBaselineException
*/
public function read(string $baselineFile): Baseline
{
if (!file_exists($baselineFile)) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline %s, file does not exist',
$baselineFile,
),
);
}
try {
$document = (new XmlLoader)->loadFile($baselineFile);
} catch (XmlException $e) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline: %s',
trim($e->getMessage()),
),
);
}
$version = (int) $document->documentElement->getAttribute('version');
if ($version !== Baseline::VERSION) {
throw new CannotLoadBaselineException(
sprintf(
'Cannot read baseline %s, version %d is not supported',
$baselineFile,
$version,
),
);
}
$baseline = new Baseline;
$baselineDirectory = dirname(realpath($baselineFile));
$xpath = new DOMXPath($document);
foreach ($xpath->query('file') as $fileElement) {
assert($fileElement instanceof DOMElement);
$file = $baselineDirectory . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $fileElement->getAttribute('path'));
foreach ($xpath->query('line', $fileElement) as $lineElement) {
assert($lineElement instanceof DOMElement);
$line = (int) $lineElement->getAttribute('number');
$hash = $lineElement->getAttribute('hash');
foreach ($xpath->query('issue', $lineElement) as $issueElement) {
assert($issueElement instanceof DOMElement);
$description = $issueElement->textContent;
assert($line > 0);
assert(!empty($hash));
assert(!empty($description));
$baseline->add(Issue::from($file, $line, $hash, $description));
}
}
}
return $baseline;
}
}
src/Runner/Baseline/Exception/CannotLoadBaselineException.php 0000644 00000001021 15243426620 0020337 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Runner\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CannotLoadBaselineException extends RuntimeException implements Exception
{
}
src/Runner/Baseline/Exception/FileDoesNotHaveLineException.php 0000644 00000001432 15243426620 0020447 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function sprintf;
use PHPUnit\Runner\Exception;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FileDoesNotHaveLineException extends RuntimeException implements Exception
{
public function __construct(string $file, int $line)
{
parent::__construct(
sprintf(
'File "%s" does not have line %d',
$file,
$line,
),
);
}
}
src/Runner/Baseline/Issue.php 0000644 00000006523 15243426620 0012141 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function assert;
use function file;
use function is_file;
use function sha1;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Issue
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
/**
* @psalm-var non-empty-string
*/
private readonly string $hash;
/**
* @psalm-var non-empty-string
*/
private readonly string $description;
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param ?non-empty-string $hash
* @psalm-param non-empty-string $description
*
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public static function from(string $file, int $line, ?string $hash, string $description): self
{
if ($hash === null) {
$hash = self::calculateHash($file, $line);
}
return new self($file, $line, $hash, $description);
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $hash
* @psalm-param non-empty-string $description
*/
private function __construct(string $file, int $line, string $hash, string $description)
{
$this->file = $file;
$this->line = $line;
$this->hash = $hash;
$this->description = $description;
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
/**
* @psalm-return non-empty-string
*/
public function hash(): string
{
return $this->hash;
}
/**
* @psalm-return non-empty-string
*/
public function description(): string
{
return $this->description;
}
public function equals(self $other): bool
{
return $this->file() === $other->file() &&
$this->line() === $other->line() &&
$this->hash() === $other->hash() &&
$this->description() === $other->description();
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
*
* @psalm-return non-empty-string
*
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
private static function calculateHash(string $file, int $line): string
{
$lines = @file($file, FILE_IGNORE_NEW_LINES);
if ($lines === false && !is_file($file)) {
throw new FileDoesNotExistException($file);
}
$key = $line - 1;
if (!isset($lines[$key])) {
throw new FileDoesNotHaveLineException($file, $line);
}
$hash = sha1($lines[$key]);
assert($hash !== '');
return $hash;
}
}
src/Runner/Baseline/Baseline.php 0000644 00000002712 15243426620 0012567 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Baseline
{
public const VERSION = 1;
/**
* @psalm-var array<non-empty-string, array<positive-int, list<Issue>>>
*/
private array $issues = [];
public function add(Issue $issue): void
{
if (!isset($this->issues[$issue->file()])) {
$this->issues[$issue->file()] = [];
}
if (!isset($this->issues[$issue->file()][$issue->line()])) {
$this->issues[$issue->file()][$issue->line()] = [];
}
$this->issues[$issue->file()][$issue->line()][] = $issue;
}
public function has(Issue $issue): bool
{
if (!isset($this->issues[$issue->file()][$issue->line()])) {
return false;
}
foreach ($this->issues[$issue->file()][$issue->line()] as $_issue) {
if ($_issue->equals($issue)) {
return true;
}
}
return false;
}
/**
* @psalm-return array<string, array<positive-int, list<Issue>>>
*/
public function groupedByFileAndLine(): array
{
return $this->issues;
}
}
src/Runner/Baseline/RelativePathCalculator.php 0000644 00000005267 15243426620 0015457 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use function array_fill;
use function array_merge;
use function array_slice;
use function assert;
use function count;
use function explode;
use function implode;
use function str_replace;
use function strpos;
use function substr;
use function trim;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*
* @see Copied from https://github.com/phpstan/phpstan-src/blob/1.10.33/src/File/ParentDirectoryRelativePathHelper.php
*/
final class RelativePathCalculator
{
/**
* @psalm-var non-empty-string $baselineDirectory
*/
private readonly string $baselineDirectory;
/**
* @psalm-param non-empty-string $baselineDirectory
*/
public function __construct(string $baselineDirectory)
{
$this->baselineDirectory = $baselineDirectory;
}
/**
* @psalm-param non-empty-string $filename
*
* @psalm-return non-empty-string
*/
public function calculate(string $filename): string
{
$result = implode('/', $this->parts($filename));
assert($result !== '');
return $result;
}
/**
* @psalm-param non-empty-string $filename
*
* @psalm-return list<non-empty-string>
*/
public function parts(string $filename): array
{
$schemePosition = strpos($filename, '://');
if ($schemePosition !== false) {
$filename = substr($filename, $schemePosition + 3);
assert($filename !== '');
}
$parentParts = explode('/', trim(str_replace('\\', '/', $this->baselineDirectory), '/'));
$parentPartsCount = count($parentParts);
$filenameParts = explode('/', trim(str_replace('\\', '/', $filename), '/'));
$filenamePartsCount = count($filenameParts);
$i = 0;
for (; $i < $filenamePartsCount; $i++) {
if ($parentPartsCount < $i + 1) {
break;
}
$parentPath = implode('/', array_slice($parentParts, 0, $i + 1));
$filenamePath = implode('/', array_slice($filenameParts, 0, $i + 1));
if ($parentPath !== $filenamePath) {
break;
}
}
if ($i === 0) {
return [$filename];
}
$dotsCount = $parentPartsCount - $i;
assert($dotsCount >= 0);
return array_merge(array_fill(0, $dotsCount, '..'), array_slice($filenameParts, $i));
}
}
src/Runner/Baseline/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001523 15243426620 0021111 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(NoticeTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/Baseline/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001573 15243426620 0022602 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpDeprecationTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/Baseline/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001530 15243426620 0021273 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(WarningTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/Baseline/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001542 15243426620 0021562 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpNoticeTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/Baseline/Subscriber/Subscriber.php 0000644 00000001221 15243426620 0015245 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly Generator $generator;
public function __construct(Generator $generator)
{
$this->generator = $generator;
}
protected function generator(): Generator
{
return $this->generator;
}
}
src/Runner/Baseline/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001547 15243426620 0021753 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(PhpWarningTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/Baseline/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001554 15243426620 0022131 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner\Baseline;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
use PHPUnit\Runner\FileDoesNotExistException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
/**
* @throws FileDoesNotExistException
* @throws FileDoesNotHaveLineException
*/
public function notify(DeprecationTriggered $event): void
{
$this->generator()->testTriggeredIssue($event);
}
}
src/Runner/TestSuiteLoader.php 0000644 00000007412 15243426620 0012405 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_diff;
use function array_values;
use function basename;
use function class_exists;
use function get_declared_classes;
use function realpath;
use function str_ends_with;
use function strpos;
use function strtolower;
use function substr;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteLoader
{
/**
* @psalm-var list<class-string>
*/
private static array $declaredClasses = [];
/**
* @psalm-var array<non-empty-string, list<class-string>>
*/
private static array $fileToClassesMap = [];
/**
* @throws Exception
*/
public function load(string $suiteClassFile): ReflectionClass
{
$suiteClassFile = realpath($suiteClassFile);
$suiteClassName = $this->classNameFromFileName($suiteClassFile);
$loadedClasses = $this->loadSuiteClassFile($suiteClassFile);
foreach ($loadedClasses as $className) {
/** @noinspection PhpUnhandledExceptionInspection */
$class = new ReflectionClass($className);
if ($class->isAnonymous()) {
continue;
}
if ($class->getFileName() !== $suiteClassFile) {
continue;
}
if (!$class->isSubclassOf(TestCase::class)) {
continue;
}
if (!str_ends_with(strtolower($class->getShortName()), strtolower($suiteClassName))) {
continue;
}
if (!$class->isAbstract()) {
return $class;
}
$e = new ClassIsAbstractException($class->getName(), $suiteClassFile);
}
if (isset($e)) {
throw $e;
}
if (!class_exists($suiteClassName)) {
throw new ClassCannotBeFoundException($suiteClassName, $suiteClassFile);
}
throw new ClassDoesNotExtendTestCaseException($suiteClassName, $suiteClassFile);
}
private function classNameFromFileName(string $suiteClassFile): string
{
$className = basename($suiteClassFile, '.php');
$dotPos = strpos($className, '.');
if ($dotPos !== false) {
$className = substr($className, 0, $dotPos);
}
return $className;
}
/**
* @psalm-return list<class-string>
*/
private function loadSuiteClassFile(string $suiteClassFile): array
{
if (isset(self::$fileToClassesMap[$suiteClassFile])) {
return self::$fileToClassesMap[$suiteClassFile];
}
if (empty(self::$declaredClasses)) {
self::$declaredClasses = get_declared_classes();
}
require_once $suiteClassFile;
$loadedClasses = array_values(
array_diff(
get_declared_classes(),
self::$declaredClasses,
),
);
foreach ($loadedClasses as $loadedClass) {
/** @noinspection PhpUnhandledExceptionInspection */
$class = new ReflectionClass($loadedClass);
if (!isset(self::$fileToClassesMap[$class->getFileName()])) {
self::$fileToClassesMap[$class->getFileName()] = [];
}
self::$fileToClassesMap[$class->getFileName()][] = $class->getName();
}
self::$declaredClasses = get_declared_classes();
if (empty($loadedClasses)) {
return self::$declaredClasses;
}
return $loadedClasses;
}
}
src/Runner/Exception/ErrorException.php 0000644 00000000707 15243426620 0014233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use Error;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ErrorException extends Error implements Exception
{
}
src/Runner/Exception/ClassDoesNotExtendTestCaseException.php 0000644 00000001452 15243426620 0020305 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassDoesNotExtendTestCaseException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s declared in %s does not extend PHPUnit\Framework\TestCase',
$className,
$file,
),
);
}
}
src/Runner/Exception/ClassCannotBeFoundException.php 0000644 00000001376 15243426620 0016620 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassCannotBeFoundException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s cannot be found in %s',
$className,
$file,
),
);
}
}
src/Runner/Exception/InvalidPhptFileException.php 0000644 00000000747 15243426620 0016170 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidPhptFileException extends RuntimeException implements Exception
{
}
src/Runner/Exception/ParameterDoesNotExistException.php 0000644 00000001321 15243426620 0017364 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ParameterDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $name)
{
parent::__construct(
sprintf(
'Parameter "%s" does not exist',
$name,
),
);
}
}
src/Runner/Exception/UnsupportedPhptSectionException.php 0000644 00000001344 15243426620 0017651 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class UnsupportedPhptSectionException extends RuntimeException implements Exception
{
public function __construct(string $section)
{
parent::__construct(
sprintf(
'PHPUnit does not support PHPT %s sections',
$section,
),
);
}
}
src/Runner/Exception/PhptExternalFileCannotBeLoadedException.php 0000644 00000001434 15243426620 0021101 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PhptExternalFileCannotBeLoadedException extends RuntimeException implements Exception
{
public function __construct(string $section, string $file)
{
parent::__construct(
sprintf(
'Could not load --%s-- %s for PHPT file',
$section . '_EXTERNAL',
$file,
),
);
}
}
src/Runner/Exception/ClassIsAbstractException.php 0000644 00000001400 15243426620 0016156 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ClassIsAbstractException extends RuntimeException implements Exception
{
public function __construct(string $className, string $file)
{
parent::__construct(
sprintf(
'Class %s declared in %s is abstract',
$className,
$file,
),
);
}
}
src/Runner/Exception/Exception.php 0000644 00000000654 15243426620 0013222 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
interface Exception extends \PHPUnit\Exception
{
}
src/Runner/Exception/InvalidOrderException.php 0000644 00000000744 15243426620 0015525 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class InvalidOrderException extends RuntimeException implements Exception
{
}
src/Runner/Exception/ReflectionException.php 0000644 00000000742 15243426620 0015233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ReflectionException extends RuntimeException implements Exception
{
}
src/Runner/Exception/NoIgnoredEventException.php 0000644 00000000746 15243426620 0016033 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NoIgnoredEventException extends RuntimeException implements Exception
{
}
src/Runner/Exception/FileDoesNotExistException.php 0000644 00000001307 15243426620 0016327 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class FileDoesNotExistException extends RuntimeException implements Exception
{
public function __construct(string $file)
{
parent::__construct(
sprintf(
'File "%s" does not exist',
$file,
),
);
}
}
src/Runner/Exception/DirectoryCannotBeCreatedException.php 0000644 00000001335 15243426620 0020006 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function sprintf;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class DirectoryCannotBeCreatedException extends RuntimeException implements Exception
{
public function __construct(string $directory)
{
parent::__construct(
sprintf(
'Cannot create directory "%s"',
$directory,
),
);
}
}
src/Runner/TestResult/Collector.php 0000644 00000045453 15243426620 0013400 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function array_values;
use function assert;
use function implode;
use function str_contains;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\Skipped as TestSkipped;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\TestRunner\DeprecationTriggered as TestRunnerDeprecationTriggered;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\WarningTriggered as TestRunnerWarningTriggered;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuiteForTestClass;
use PHPUnit\Event\TestSuite\TestSuiteForTestMethodWithDataProvider;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
use PHPUnit\TextUI\Configuration\Source;
use PHPUnit\TextUI\Configuration\SourceFilter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Collector
{
private readonly Source $source;
private int $numberOfTests = 0;
private int $numberOfTestsRun = 0;
private int $numberOfAssertions = 0;
private bool $prepared = false;
private bool $currentTestSuiteForTestClassFailed = false;
/**
* @psalm-var non-negative-int
*/
private int $numberOfIssuesIgnoredByBaseline = 0;
/**
* @psalm-var list<BeforeFirstTestMethodErrored|Errored>
*/
private array $testErroredEvents = [];
/**
* @psalm-var list<Failed>
*/
private array $testFailedEvents = [];
/**
* @psalm-var list<MarkedIncomplete>
*/
private array $testMarkedIncompleteEvents = [];
/**
* @psalm-var list<TestSuiteSkipped>
*/
private array $testSuiteSkippedEvents = [];
/**
* @psalm-var list<TestSkipped>
*/
private array $testSkippedEvents = [];
/**
* @psalm-var array<string,list<ConsideredRisky>>
*/
private array $testConsideredRiskyEvents = [];
/**
* @psalm-var array<string,list<PhpunitDeprecationTriggered>>
*/
private array $testTriggeredPhpunitDeprecationEvents = [];
/**
* @psalm-var array<string,list<PhpunitErrorTriggered>>
*/
private array $testTriggeredPhpunitErrorEvents = [];
/**
* @psalm-var array<string,list<PhpunitWarningTriggered>>
*/
private array $testTriggeredPhpunitWarningEvents = [];
/**
* @psalm-var list<TestRunnerWarningTriggered>
*/
private array $testRunnerTriggeredWarningEvents = [];
/**
* @psalm-var list<TestRunnerDeprecationTriggered>
*/
private array $testRunnerTriggeredDeprecationEvents = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $errors = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $deprecations = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $notices = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $warnings = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpDeprecations = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpNotices = [];
/**
* @psalm-var array<non-empty-string, Issue>
*/
private array $phpWarnings = [];
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade, Source $source)
{
$facade->registerSubscribers(
new ExecutionStartedSubscriber($this),
new TestSuiteSkippedSubscriber($this),
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new BeforeTestClassMethodErroredSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredErrorSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitErrorSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
new TestRunnerTriggeredDeprecationSubscriber($this),
new TestRunnerTriggeredWarningSubscriber($this),
);
$this->source = $source;
}
public function result(): TestResult
{
return new TestResult(
$this->numberOfTests,
$this->numberOfTestsRun,
$this->numberOfAssertions,
$this->testErroredEvents,
$this->testFailedEvents,
$this->testConsideredRiskyEvents,
$this->testSuiteSkippedEvents,
$this->testSkippedEvents,
$this->testMarkedIncompleteEvents,
$this->testTriggeredPhpunitDeprecationEvents,
$this->testTriggeredPhpunitErrorEvents,
$this->testTriggeredPhpunitWarningEvents,
$this->testRunnerTriggeredDeprecationEvents,
$this->testRunnerTriggeredWarningEvents,
array_values($this->errors),
array_values($this->deprecations),
array_values($this->notices),
array_values($this->warnings),
array_values($this->phpDeprecations),
array_values($this->phpNotices),
array_values($this->phpWarnings),
$this->numberOfIssuesIgnoredByBaseline,
);
}
public function executionStarted(ExecutionStarted $event): void
{
$this->numberOfTests = $event->testSuite()->count();
}
public function testSuiteSkipped(TestSuiteSkipped $event): void
{
$testSuite = $event->testSuite();
if (!$testSuite->isForTestClass()) {
return;
}
$this->testSuiteSkippedEvents[] = $event;
}
public function testSuiteStarted(TestSuiteStarted $event): void
{
$testSuite = $event->testSuite();
if (!$testSuite->isForTestClass()) {
return;
}
$this->currentTestSuiteForTestClassFailed = false;
}
public function testSuiteFinished(TestSuiteFinished $event): void
{
if ($this->currentTestSuiteForTestClassFailed) {
return;
}
$testSuite = $event->testSuite();
if ($testSuite->isWithName()) {
return;
}
if ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$test = $testSuite->tests()->asArray()[0];
assert($test instanceof TestMethod);
PassedTests::instance()->testMethodPassed($test, null);
return;
}
assert($testSuite instanceof TestSuiteForTestClass);
PassedTests::instance()->testClassPassed($testSuite->className());
}
public function testPrepared(): void
{
$this->prepared = true;
}
public function testFinished(Finished $event): void
{
$this->numberOfAssertions += $event->numberOfAssertionsPerformed();
$this->numberOfTestsRun++;
$this->prepared = false;
}
public function beforeTestClassMethodErrored(BeforeFirstTestMethodErrored $event): void
{
$this->testErroredEvents[] = $event;
$this->numberOfTestsRun++;
}
public function testErrored(Errored $event): void
{
$this->testErroredEvents[] = $event;
$this->currentTestSuiteForTestClassFailed = true;
/*
* @todo Eliminate this special case
*/
if (str_contains($event->asString(), 'Test was run in child process and ended unexpectedly')) {
return;
}
if (!$this->prepared) {
$this->numberOfTestsRun++;
}
}
public function testFailed(Failed $event): void
{
$this->testFailedEvents[] = $event;
$this->currentTestSuiteForTestClassFailed = true;
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->testMarkedIncompleteEvents[] = $event;
}
public function testSkipped(TestSkipped $event): void
{
$this->testSkippedEvents[] = $event;
if (!$this->prepared) {
$this->numberOfTestsRun++;
}
}
public function testConsideredRisky(ConsideredRisky $event): void
{
if (!isset($this->testConsideredRiskyEvents[$event->test()->id()])) {
$this->testConsideredRiskyEvents[$event->test()->id()] = [];
}
$this->testConsideredRiskyEvents[$event->test()->id()][] = $event;
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if ($event->ignoredByTest()) {
return;
}
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfDeprecations() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictDeprecations() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->deprecations[$id])) {
$this->deprecations[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->deprecations[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if ($event->ignoredByTest()) {
return;
}
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpDeprecations() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictDeprecations() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpDeprecations[$id])) {
$this->phpDeprecations[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpDeprecations[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpunitDeprecation(PhpunitDeprecationTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitDeprecationEvents[$event->test()->id()][] = $event;
}
public function testTriggeredError(ErrorTriggered $event): void
{
if (!$this->source->ignoreSuppressionOfErrors() && $event->wasSuppressed()) {
return;
}
$id = $this->issueId($event);
if (!isset($this->errors[$id])) {
$this->errors[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->errors[$id]->triggeredBy($event->test());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfNotices() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictNotices() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->notices[$id])) {
$this->notices[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->notices[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpNotices() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictNotices() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpNotices[$id])) {
$this->phpNotices[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpNotices[$id]->triggeredBy($event->test());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->warnings[$id])) {
$this->warnings[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->warnings[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if ($event->ignoredByBaseline()) {
$this->numberOfIssuesIgnoredByBaseline++;
return;
}
if (!$this->source->ignoreSuppressionOfPhpWarnings() && $event->wasSuppressed()) {
return;
}
if ($this->source->restrictWarnings() && !(new SourceFilter)->includes($this->source, $event->file())) {
return;
}
$id = $this->issueId($event);
if (!isset($this->phpWarnings[$id])) {
$this->phpWarnings[$id] = Issue::from(
$event->file(),
$event->line(),
$event->message(),
$event->test(),
);
return;
}
$this->phpWarnings[$id]->triggeredBy($event->test());
}
public function testTriggeredPhpunitError(PhpunitErrorTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitErrorEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitErrorEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitErrorEvents[$event->test()->id()][] = $event;
}
public function testTriggeredPhpunitWarning(PhpunitWarningTriggered $event): void
{
if (!isset($this->testTriggeredPhpunitWarningEvents[$event->test()->id()])) {
$this->testTriggeredPhpunitWarningEvents[$event->test()->id()] = [];
}
$this->testTriggeredPhpunitWarningEvents[$event->test()->id()][] = $event;
}
public function testRunnerTriggeredDeprecation(TestRunnerDeprecationTriggered $event): void
{
$this->testRunnerTriggeredDeprecationEvents[] = $event;
}
public function testRunnerTriggeredWarning(TestRunnerWarningTriggered $event): void
{
$this->testRunnerTriggeredWarningEvents[] = $event;
}
public function hasErroredTests(): bool
{
return !empty($this->testErroredEvents);
}
public function hasFailedTests(): bool
{
return !empty($this->testFailedEvents);
}
public function hasRiskyTests(): bool
{
return !empty($this->testConsideredRiskyEvents);
}
public function hasSkippedTests(): bool
{
return !empty($this->testSkippedEvents);
}
public function hasIncompleteTests(): bool
{
return !empty($this->testMarkedIncompleteEvents);
}
public function hasDeprecations(): bool
{
return !empty($this->deprecations) ||
!empty($this->phpDeprecations) ||
!empty($this->testTriggeredPhpunitDeprecationEvents) ||
!empty($this->testRunnerTriggeredDeprecationEvents);
}
public function hasNotices(): bool
{
return !empty($this->notices) ||
!empty($this->phpNotices);
}
public function hasWarnings(): bool
{
return !empty($this->warnings) ||
!empty($this->phpWarnings) ||
!empty($this->testTriggeredPhpunitWarningEvents) ||
!empty($this->testRunnerTriggeredWarningEvents);
}
/**
* @psalm-return non-empty-string
*/
private function issueId(DeprecationTriggered|ErrorTriggered|NoticeTriggered|PhpDeprecationTriggered|PhpNoticeTriggered|PhpWarningTriggered|WarningTriggered $event): string
{
return implode(':', [$event->file(), $event->line(), $event->message()]);
}
}
src/Runner/TestResult/PassedTests.php 0000644 00000005673 15243426620 0013714 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function array_merge;
use function assert;
use function in_array;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Framework\TestSize\Known;
use PHPUnit\Framework\TestSize\TestSize;
use PHPUnit\Metadata\Api\Groups;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PassedTests
{
private static ?self $instance = null;
/**
* @psalm-var list<class-string>
*/
private array $passedTestClasses = [];
/**
* @psalm-var array<string,array{returnValue: mixed, size: TestSize}>
*/
private array $passedTestMethods = [];
public static function instance(): self
{
if (self::$instance !== null) {
return self::$instance;
}
self::$instance = new self;
return self::$instance;
}
/**
* @psalm-param class-string $className
*/
public function testClassPassed(string $className): void
{
$this->passedTestClasses[] = $className;
}
public function testMethodPassed(TestMethod $test, mixed $returnValue): void
{
$size = (new Groups)->size(
$test->className(),
$test->methodName(),
);
$this->passedTestMethods[$test->className() . '::' . $test->methodName()] = [
'returnValue' => $returnValue,
'size' => $size,
];
}
public function import(self $other): void
{
$this->passedTestClasses = array_merge(
$this->passedTestClasses,
$other->passedTestClasses,
);
$this->passedTestMethods = array_merge(
$this->passedTestMethods,
$other->passedTestMethods,
);
}
/**
* @psalm-param class-string $className
*/
public function hasTestClassPassed(string $className): bool
{
return in_array($className, $this->passedTestClasses, true);
}
public function hasTestMethodPassed(string $method): bool
{
return isset($this->passedTestMethods[$method]);
}
public function isGreaterThan(string $method, TestSize $other): bool
{
if ($other->isUnknown()) {
return false;
}
assert($other instanceof Known);
$size = $this->passedTestMethods[$method]['size'];
if ($size->isUnknown()) {
return false;
}
assert($size instanceof Known);
return $size->isGreaterThan($other);
}
public function returnValue(string $method): mixed
{
if (isset($this->passedTestMethods[$method])) {
return $this->passedTestMethods[$method]['returnValue'];
}
return null;
}
}
src/Runner/TestResult/TestResult.php 0000644 00000037552 15243426620 0013571 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use function count;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\Skipped as TestSkipped;
use PHPUnit\Event\TestRunner\DeprecationTriggered as TestRunnerDeprecationTriggered;
use PHPUnit\Event\TestRunner\WarningTriggered as TestRunnerWarningTriggered;
use PHPUnit\Event\TestSuite\Skipped as TestSuiteSkipped;
use PHPUnit\TestRunner\TestResult\Issues\Issue;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResult
{
private readonly int $numberOfTests;
private readonly int $numberOfTestsRun;
private readonly int $numberOfAssertions;
/**
* @psalm-var list<BeforeFirstTestMethodErrored|Errored>
*/
private readonly array $testErroredEvents;
/**
* @psalm-var list<Failed>
*/
private readonly array $testFailedEvents;
/**
* @psalm-var list<MarkedIncomplete>
*/
private readonly array $testMarkedIncompleteEvents;
/**
* @psalm-var list<TestSuiteSkipped>
*/
private readonly array $testSuiteSkippedEvents;
/**
* @psalm-var list<TestSkipped>
*/
private readonly array $testSkippedEvents;
/**
* @psalm-var array<string,list<ConsideredRisky>>
*/
private readonly array $testConsideredRiskyEvents;
/**
* @psalm-var array<string,list<PhpunitDeprecationTriggered>>
*/
private readonly array $testTriggeredPhpunitDeprecationEvents;
/**
* @psalm-var array<string,list<PhpunitErrorTriggered>>
*/
private readonly array $testTriggeredPhpunitErrorEvents;
/**
* @psalm-var array<string,list<PhpunitWarningTriggered>>
*/
private readonly array $testTriggeredPhpunitWarningEvents;
/**
* @psalm-var list<TestRunnerDeprecationTriggered>
*/
private readonly array $testRunnerTriggeredDeprecationEvents;
/**
* @psalm-var list<TestRunnerWarningTriggered>
*/
private readonly array $testRunnerTriggeredWarningEvents;
/**
* @psalm-var list<Issue>
*/
private readonly array $errors;
/**
* @psalm-var list<Issue>
*/
private readonly array $deprecations;
/**
* @psalm-var list<Issue>
*/
private readonly array $notices;
/**
* @psalm-var list<Issue>
*/
private readonly array $warnings;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpDeprecations;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpNotices;
/**
* @psalm-var list<Issue>
*/
private readonly array $phpWarnings;
/**
* @psalm-var non-negative-int
*/
private readonly int $numberOfIssuesIgnoredByBaseline;
/**
* @psalm-param list<BeforeFirstTestMethodErrored|Errored> $testErroredEvents
* @psalm-param list<Failed> $testFailedEvents
* @psalm-param array<string,list<ConsideredRisky>> $testConsideredRiskyEvents
* @psalm-param list<TestSuiteSkipped> $testSuiteSkippedEvents
* @psalm-param list<TestSkipped> $testSkippedEvents
* @psalm-param list<MarkedIncomplete> $testMarkedIncompleteEvents
* @psalm-param array<string,list<PhpunitDeprecationTriggered>> $testTriggeredPhpunitDeprecationEvents
* @psalm-param array<string,list<PhpunitErrorTriggered>> $testTriggeredPhpunitErrorEvents
* @psalm-param array<string,list<PhpunitWarningTriggered>> $testTriggeredPhpunitWarningEvents
* @psalm-param list<TestRunnerDeprecationTriggered> $testRunnerTriggeredDeprecationEvents
* @psalm-param list<TestRunnerWarningTriggered> $testRunnerTriggeredWarningEvents
* @psalm-param list<Issue> $errors
* @psalm-param list<Issue> $deprecations
* @psalm-param list<Issue> $notices
* @psalm-param list<Issue> $warnings
* @psalm-param list<Issue> $phpDeprecations
* @psalm-param list<Issue> $phpNotices
* @psalm-param list<Issue> $phpWarnings
* @psalm-param non-negative-int $numberOfIssuesIgnoredByBaseline
*/
public function __construct(int $numberOfTests, int $numberOfTestsRun, int $numberOfAssertions, array $testErroredEvents, array $testFailedEvents, array $testConsideredRiskyEvents, array $testSuiteSkippedEvents, array $testSkippedEvents, array $testMarkedIncompleteEvents, array $testTriggeredPhpunitDeprecationEvents, array $testTriggeredPhpunitErrorEvents, array $testTriggeredPhpunitWarningEvents, array $testRunnerTriggeredDeprecationEvents, array $testRunnerTriggeredWarningEvents, array $errors, array $deprecations, array $notices, array $warnings, array $phpDeprecations, array $phpNotices, array $phpWarnings, int $numberOfIssuesIgnoredByBaseline)
{
$this->numberOfTests = $numberOfTests;
$this->numberOfTestsRun = $numberOfTestsRun;
$this->numberOfAssertions = $numberOfAssertions;
$this->testErroredEvents = $testErroredEvents;
$this->testFailedEvents = $testFailedEvents;
$this->testConsideredRiskyEvents = $testConsideredRiskyEvents;
$this->testSuiteSkippedEvents = $testSuiteSkippedEvents;
$this->testSkippedEvents = $testSkippedEvents;
$this->testMarkedIncompleteEvents = $testMarkedIncompleteEvents;
$this->testTriggeredPhpunitDeprecationEvents = $testTriggeredPhpunitDeprecationEvents;
$this->testTriggeredPhpunitErrorEvents = $testTriggeredPhpunitErrorEvents;
$this->testTriggeredPhpunitWarningEvents = $testTriggeredPhpunitWarningEvents;
$this->testRunnerTriggeredDeprecationEvents = $testRunnerTriggeredDeprecationEvents;
$this->testRunnerTriggeredWarningEvents = $testRunnerTriggeredWarningEvents;
$this->errors = $errors;
$this->deprecations = $deprecations;
$this->notices = $notices;
$this->warnings = $warnings;
$this->phpDeprecations = $phpDeprecations;
$this->phpNotices = $phpNotices;
$this->phpWarnings = $phpWarnings;
$this->numberOfIssuesIgnoredByBaseline = $numberOfIssuesIgnoredByBaseline;
}
public function numberOfTestsRun(): int
{
return $this->numberOfTestsRun;
}
public function numberOfAssertions(): int
{
return $this->numberOfAssertions;
}
/**
* @psalm-return list<BeforeFirstTestMethodErrored|Errored>
*/
public function testErroredEvents(): array
{
return $this->testErroredEvents;
}
public function numberOfTestErroredEvents(): int
{
return count($this->testErroredEvents);
}
public function hasTestErroredEvents(): bool
{
return $this->numberOfTestErroredEvents() > 0;
}
/**
* @psalm-return list<Failed>
*/
public function testFailedEvents(): array
{
return $this->testFailedEvents;
}
public function numberOfTestFailedEvents(): int
{
return count($this->testFailedEvents);
}
public function hasTestFailedEvents(): bool
{
return $this->numberOfTestFailedEvents() > 0;
}
/**
* @psalm-return array<string,list<ConsideredRisky>>
*/
public function testConsideredRiskyEvents(): array
{
return $this->testConsideredRiskyEvents;
}
public function numberOfTestsWithTestConsideredRiskyEvents(): int
{
return count($this->testConsideredRiskyEvents);
}
public function hasTestConsideredRiskyEvents(): bool
{
return $this->numberOfTestsWithTestConsideredRiskyEvents() > 0;
}
/**
* @psalm-return list<TestSuiteSkipped>
*/
public function testSuiteSkippedEvents(): array
{
return $this->testSuiteSkippedEvents;
}
public function numberOfTestSuiteSkippedEvents(): int
{
return count($this->testSuiteSkippedEvents);
}
public function hasTestSuiteSkippedEvents(): bool
{
return $this->numberOfTestSuiteSkippedEvents() > 0;
}
/**
* @psalm-return list<TestSkipped>
*/
public function testSkippedEvents(): array
{
return $this->testSkippedEvents;
}
public function numberOfTestSkippedEvents(): int
{
return count($this->testSkippedEvents);
}
public function hasTestSkippedEvents(): bool
{
return $this->numberOfTestSkippedEvents() > 0;
}
/**
* @psalm-return list<MarkedIncomplete>
*/
public function testMarkedIncompleteEvents(): array
{
return $this->testMarkedIncompleteEvents;
}
public function numberOfTestMarkedIncompleteEvents(): int
{
return count($this->testMarkedIncompleteEvents);
}
public function hasTestMarkedIncompleteEvents(): bool
{
return $this->numberOfTestMarkedIncompleteEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitDeprecationTriggered>>
*/
public function testTriggeredPhpunitDeprecationEvents(): array
{
return $this->testTriggeredPhpunitDeprecationEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitDeprecationEvents(): int
{
return count($this->testTriggeredPhpunitDeprecationEvents);
}
public function hasTestTriggeredPhpunitDeprecationEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitDeprecationEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitErrorTriggered>>
*/
public function testTriggeredPhpunitErrorEvents(): array
{
return $this->testTriggeredPhpunitErrorEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitErrorEvents(): int
{
return count($this->testTriggeredPhpunitErrorEvents);
}
public function hasTestTriggeredPhpunitErrorEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitErrorEvents() > 0;
}
/**
* @psalm-return array<string,list<PhpunitWarningTriggered>>
*/
public function testTriggeredPhpunitWarningEvents(): array
{
return $this->testTriggeredPhpunitWarningEvents;
}
public function numberOfTestsWithTestTriggeredPhpunitWarningEvents(): int
{
return count($this->testTriggeredPhpunitWarningEvents);
}
public function hasTestTriggeredPhpunitWarningEvents(): bool
{
return $this->numberOfTestsWithTestTriggeredPhpunitWarningEvents() > 0;
}
/**
* @psalm-return list<TestRunnerDeprecationTriggered>
*/
public function testRunnerTriggeredDeprecationEvents(): array
{
return $this->testRunnerTriggeredDeprecationEvents;
}
public function numberOfTestRunnerTriggeredDeprecationEvents(): int
{
return count($this->testRunnerTriggeredDeprecationEvents);
}
public function hasTestRunnerTriggeredDeprecationEvents(): bool
{
return $this->numberOfTestRunnerTriggeredDeprecationEvents() > 0;
}
/**
* @psalm-return list<TestRunnerWarningTriggered>
*/
public function testRunnerTriggeredWarningEvents(): array
{
return $this->testRunnerTriggeredWarningEvents;
}
public function numberOfTestRunnerTriggeredWarningEvents(): int
{
return count($this->testRunnerTriggeredWarningEvents);
}
public function hasTestRunnerTriggeredWarningEvents(): bool
{
return $this->numberOfTestRunnerTriggeredWarningEvents() > 0;
}
public function wasSuccessful(): bool
{
return $this->wasSuccessfulIgnoringPhpunitWarnings() &&
!$this->hasTestTriggeredPhpunitErrorEvents() &&
!$this->hasTestRunnerTriggeredWarningEvents() &&
!$this->hasTestTriggeredPhpunitWarningEvents();
}
public function wasSuccessfulIgnoringPhpunitWarnings(): bool
{
return !$this->hasTestErroredEvents() &&
!$this->hasTestFailedEvents();
}
public function wasSuccessfulAndNoTestHasIssues(): bool
{
return $this->wasSuccessful() && !$this->hasTestsWithIssues();
}
public function hasTestsWithIssues(): bool
{
return $this->hasRiskyTests() ||
$this->hasIncompleteTests() ||
$this->hasDeprecations() ||
!empty($this->errors) ||
$this->hasNotices() ||
$this->hasWarnings();
}
/**
* @psalm-return list<Issue>
*/
public function errors(): array
{
return $this->errors;
}
/**
* @psalm-return list<Issue>
*/
public function deprecations(): array
{
return $this->deprecations;
}
/**
* @psalm-return list<Issue>
*/
public function notices(): array
{
return $this->notices;
}
/**
* @psalm-return list<Issue>
*/
public function warnings(): array
{
return $this->warnings;
}
/**
* @psalm-return list<Issue>
*/
public function phpDeprecations(): array
{
return $this->phpDeprecations;
}
/**
* @psalm-return list<Issue>
*/
public function phpNotices(): array
{
return $this->phpNotices;
}
/**
* @psalm-return list<Issue>
*/
public function phpWarnings(): array
{
return $this->phpWarnings;
}
public function hasTests(): bool
{
return $this->numberOfTests > 0;
}
public function hasErrors(): bool
{
return $this->numberOfErrors() > 0;
}
public function numberOfErrors(): int
{
return $this->numberOfTestErroredEvents() +
count($this->errors) +
$this->numberOfTestsWithTestTriggeredPhpunitErrorEvents();
}
public function hasDeprecations(): bool
{
return $this->numberOfDeprecations() > 0;
}
public function numberOfDeprecations(): int
{
return count($this->deprecations) +
count($this->phpDeprecations) +
count($this->testTriggeredPhpunitDeprecationEvents) +
count($this->testRunnerTriggeredDeprecationEvents);
}
public function hasNotices(): bool
{
return $this->numberOfNotices() > 0;
}
public function numberOfNotices(): int
{
return count($this->notices) +
count($this->phpNotices);
}
public function hasWarnings(): bool
{
return $this->numberOfWarnings() > 0;
}
public function numberOfWarnings(): int
{
return count($this->warnings) +
count($this->phpWarnings) +
count($this->testTriggeredPhpunitWarningEvents) +
count($this->testRunnerTriggeredWarningEvents);
}
public function hasIncompleteTests(): bool
{
return !empty($this->testMarkedIncompleteEvents);
}
public function hasRiskyTests(): bool
{
return !empty($this->testConsideredRiskyEvents);
}
public function hasSkippedTests(): bool
{
return !empty($this->testSkippedEvents);
}
public function hasIssuesIgnoredByBaseline(): bool
{
return $this->numberOfIssuesIgnoredByBaseline > 0;
}
/**
* @psalm-return non-negative-int
*/
public function numberOfIssuesIgnoredByBaseline(): int
{
return $this->numberOfIssuesIgnoredByBaseline;
}
}
src/Runner/TestResult/Facade.php 0000644 00000005500 15243426620 0012602 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Configuration\Registry as ConfigurationRegistry;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Facade
{
private static ?Collector $collector = null;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function init(): void
{
self::collector();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function result(): TestResult
{
return self::collector()->result();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public static function shouldStop(): bool
{
$configuration = ConfigurationRegistry::get();
$collector = self::collector();
if (($configuration->stopOnDefect() || $configuration->stopOnError()) && $collector->hasErroredTests()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnFailure()) && $collector->hasFailedTests()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnWarning()) && $collector->hasWarnings()) {
return true;
}
if (($configuration->stopOnDefect() || $configuration->stopOnRisky()) && $collector->hasRiskyTests()) {
return true;
}
if ($configuration->stopOnDeprecation() && $collector->hasDeprecations()) {
return true;
}
if ($configuration->stopOnNotice() && $collector->hasNotices()) {
return true;
}
if ($configuration->stopOnIncomplete() && $collector->hasIncompleteTests()) {
return true;
}
if ($configuration->stopOnSkipped() && $collector->hasSkippedTests()) {
return true;
}
return false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private static function collector(): Collector
{
if (self::$collector === null) {
$configuration = ConfigurationRegistry::get();
self::$collector = new Collector(
EventFacade::instance(),
$configuration->source(),
);
}
return self::$collector;
}
}
src/Runner/TestResult/Issue.php 0000644 00000005144 15243426620 0012533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult\Issues;
use PHPUnit\Event\Code\Test;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Issue
{
/**
* @psalm-var non-empty-string
*/
private readonly string $file;
/**
* @psalm-var positive-int
*/
private readonly int $line;
/**
* @psalm-var non-empty-string
*/
private readonly string $description;
/**
* @psalm-var non-empty-array<non-empty-string, array{test: Test, count: int}>
*/
private array $triggeringTests;
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
public static function from(string $file, int $line, string $description, Test $triggeringTest): self
{
return new self($file, $line, $description, $triggeringTest);
}
/**
* @psalm-param non-empty-string $file
* @psalm-param positive-int $line
* @psalm-param non-empty-string $description
*/
private function __construct(string $file, int $line, string $description, Test $triggeringTest)
{
$this->file = $file;
$this->line = $line;
$this->description = $description;
$this->triggeringTests = [
$triggeringTest->id() => [
'test' => $triggeringTest,
'count' => 1,
],
];
}
public function triggeredBy(Test $test): void
{
if (isset($this->triggeringTests[$test->id()])) {
$this->triggeringTests[$test->id()]['count']++;
return;
}
$this->triggeringTests[$test->id()] = [
'test' => $test,
'count' => 1,
];
}
/**
* @psalm-return non-empty-string
*/
public function file(): string
{
return $this->file;
}
/**
* @psalm-return positive-int
*/
public function line(): int
{
return $this->line;
}
/**
* @psalm-return non-empty-string
*/
public function description(): string
{
return $this->description;
}
/**
* @psalm-return non-empty-array<non-empty-string, array{test: Test, count: int}>
*/
public function triggeringTests(): array
{
return $this->triggeringTests;
}
}
src/Runner/TestResult/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001307 15243426620 0021505 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->collector()->testTriggeredNotice($event);
}
}
src/Runner/TestResult/Subscriber/TestFailedSubscriber.php 0000644 00000001221 15243426620 0017606 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->collector()->testFailed($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001367 15243426620 0023247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpunitWarning($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001367 15243426620 0023177 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpDeprecation($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001315 15243426620 0021670 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testTriggeredWarning($event);
}
}
src/Runner/TestResult/Subscriber/TestPreparedSubscriber.php 0000644 00000001227 15243426620 0020172 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->collector()->testPrepared();
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpunitErrorSubscriber.php 0000644 00000001353 15243426620 0022726 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitErrorSubscriber extends Subscriber implements PhpunitErrorTriggeredSubscriber
{
public function notify(PhpunitErrorTriggered $event): void
{
$this->collector()->testTriggeredPhpunitError($event);
}
}
src/Runner/TestResult/Subscriber/ExecutionStartedSubscriber.php 0000644 00000001403 15243426620 0021056 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\ExecutionStarted;
use PHPUnit\Event\TestRunner\ExecutionStartedSubscriber as TestRunnerExecutionStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class ExecutionStartedSubscriber extends Subscriber implements TestRunnerExecutionStartedSubscriber
{
public function notify(ExecutionStarted $event): void
{
$this->collector()->executionStarted($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001331 15243426620 0022152 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->collector()->testTriggeredPhpNotice($event);
}
}
src/Runner/TestResult/Subscriber/TestFinishedSubscriber.php 0000644 00000001235 15243426620 0020160 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->collector()->testFinished($event);
}
}
src/Runner/TestResult/Subscriber/BeforeTestClassMethodErroredSubscriber.php 0000644 00000001415 15243426620 0023303 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\BeforeFirstTestMethodErrored;
use PHPUnit\Event\Test\BeforeFirstTestMethodErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class BeforeTestClassMethodErroredSubscriber extends Subscriber implements BeforeFirstTestMethodErroredSubscriber
{
public function notify(BeforeFirstTestMethodErrored $event): void
{
$this->collector()->beforeTestClassMethodErrored($event);
}
}
src/Runner/TestResult/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001261 15243426620 0021171 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->collector()->testSuiteFinished($event);
}
}
src/Runner/TestResult/Subscriber/TestRunnerTriggeredDeprecationSubscriber.php 0000644 00000001375 15243426620 0023720 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\DeprecationTriggered;
use PHPUnit\Event\TestRunner\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testRunnerTriggeredDeprecation($event);
}
}
src/Runner/TestResult/Subscriber/TestSkippedSubscriber.php 0000644 00000001227 15243426620 0020027 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSkipped($event);
}
}
src/Runner/TestResult/Subscriber/TestSuiteSkippedSubscriber.php 0000644 00000001253 15243426620 0021040 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Skipped;
use PHPUnit\Event\TestSuite\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSuiteSkipped($event);
}
}
src/Runner/TestResult/Subscriber/TestRunnerTriggeredWarningSubscriber.php 0000644 00000001345 15243426620 0023065 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestRunner\WarningTriggered;
use PHPUnit\Event\TestRunner\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testRunnerTriggeredWarning($event);
}
}
src/Runner/TestResult/Subscriber/Subscriber.php 0000644 00000001227 15243426620 0015647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly Collector $collector;
public function __construct(Collector $collector)
{
$this->collector = $collector;
}
protected function collector(): Collector
{
return $this->collector;
}
}
src/Runner/TestResult/Subscriber/TestErroredSubscriber.php 0000644 00000001227 15243426620 0020032 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->collector()->testErrored($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001417 15243426620 0024073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpunitDeprecation($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredErrorSubscriber.php 0000644 00000001301 15243426620 0021347 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\ErrorTriggered;
use PHPUnit\Event\Test\ErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredErrorSubscriber extends Subscriber implements ErrorTriggeredSubscriber
{
public function notify(ErrorTriggered $event): void
{
$this->collector()->testTriggeredError($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001337 15243426620 0022344 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpWarning($event);
}
}
src/Runner/TestResult/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001345 15243426620 0022523 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testTriggeredDeprecation($event);
}
}
src/Runner/TestResult/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001315 15243426620 0021651 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->collector()->testMarkedIncomplete($event);
}
}
src/Runner/TestResult/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001253 15243426620 0021047 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->collector()->testSuiteStarted($event);
}
}
src/Runner/TestResult/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001307 15243426620 0021530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\TestRunner\TestResult;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->collector()->testConsideredRisky($event);
}
}
src/Runner/Version.php 0000644 00000003113 15243426620 0010744 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_slice;
use function dirname;
use function explode;
use function implode;
use function str_contains;
use SebastianBergmann\Version as VersionId;
/**
* @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
*/
final class Version
{
private static string $pharVersion = '';
private static string $version = '';
/**
* Returns the current version of PHPUnit.
*/
public static function id(): string
{
if (self::$pharVersion !== '') {
return self::$pharVersion;
}
if (self::$version === '') {
self::$version = (new VersionId('10.5.20', dirname(__DIR__, 2)))->asString();
}
return self::$version;
}
public static function series(): string
{
if (str_contains(self::id(), '-')) {
$version = explode('-', self::id(), 2)[0];
} else {
$version = self::id();
}
return implode('.', array_slice(explode('.', $version), 0, 2));
}
public static function majorVersionNumber(): int
{
return (int) explode('.', self::series())[0];
}
public static function getVersionString(): string
{
return 'PHPUnit ' . self::id() . ' by Sebastian Bergmann and contributors.';
}
}
src/Runner/TestSuiteSorter.php 0000644 00000023311 15243426620 0012451 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function array_diff;
use function array_merge;
use function array_reverse;
use function array_splice;
use function count;
use function in_array;
use function max;
use function shuffle;
use function usort;
use PHPUnit\Framework\DataProviderTestSuite;
use PHPUnit\Framework\Reorderable;
use PHPUnit\Framework\Test;
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\TestSuite;
use PHPUnit\Runner\ResultCache\NullResultCache;
use PHPUnit\Runner\ResultCache\ResultCache;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteSorter
{
/**
* @var int
*/
public const ORDER_DEFAULT = 0;
/**
* @var int
*/
public const ORDER_RANDOMIZED = 1;
/**
* @var int
*/
public const ORDER_REVERSED = 2;
/**
* @var int
*/
public const ORDER_DEFECTS_FIRST = 3;
/**
* @var int
*/
public const ORDER_DURATION = 4;
/**
* @var int
*/
public const ORDER_SIZE = 5;
private const SIZE_SORT_WEIGHT = [
'small' => 1,
'medium' => 2,
'large' => 3,
'unknown' => 4,
];
/**
* @psalm-var array<string, int> Associative array of (string => DEFECT_SORT_WEIGHT) elements
*/
private array $defectSortOrder = [];
private readonly ResultCache $cache;
/**
* @psalm-var array<string> A list of normalized names of tests before reordering
*/
private array $originalExecutionOrder = [];
/**
* @psalm-var array<string> A list of normalized names of tests affected by reordering
*/
private array $executionOrder = [];
public function __construct(?ResultCache $cache = null)
{
$this->cache = $cache ?? new NullResultCache;
}
/**
* @throws Exception
*/
public function reorderTestsInSuite(Test $suite, int $order, bool $resolveDependencies, int $orderDefects, bool $isRootTestSuite = true): void
{
$allowedOrders = [
self::ORDER_DEFAULT,
self::ORDER_REVERSED,
self::ORDER_RANDOMIZED,
self::ORDER_DURATION,
self::ORDER_SIZE,
];
if (!in_array($order, $allowedOrders, true)) {
throw new InvalidOrderException;
}
$allowedOrderDefects = [
self::ORDER_DEFAULT,
self::ORDER_DEFECTS_FIRST,
];
if (!in_array($orderDefects, $allowedOrderDefects, true)) {
throw new InvalidOrderException;
}
if ($isRootTestSuite) {
$this->originalExecutionOrder = $this->calculateTestExecutionOrder($suite);
}
if ($suite instanceof TestSuite) {
foreach ($suite as $_suite) {
$this->reorderTestsInSuite($_suite, $order, $resolveDependencies, $orderDefects, false);
}
if ($orderDefects === self::ORDER_DEFECTS_FIRST) {
$this->addSuiteToDefectSortOrder($suite);
}
$this->sort($suite, $order, $resolveDependencies, $orderDefects);
}
if ($isRootTestSuite) {
$this->executionOrder = $this->calculateTestExecutionOrder($suite);
}
}
public function getOriginalExecutionOrder(): array
{
return $this->originalExecutionOrder;
}
public function getExecutionOrder(): array
{
return $this->executionOrder;
}
private function sort(TestSuite $suite, int $order, bool $resolveDependencies, int $orderDefects): void
{
if (empty($suite->tests())) {
return;
}
if ($order === self::ORDER_REVERSED) {
$suite->setTests($this->reverse($suite->tests()));
} elseif ($order === self::ORDER_RANDOMIZED) {
$suite->setTests($this->randomize($suite->tests()));
} elseif ($order === self::ORDER_DURATION) {
$suite->setTests($this->sortByDuration($suite->tests()));
} elseif ($order === self::ORDER_SIZE) {
$suite->setTests($this->sortBySize($suite->tests()));
}
if ($orderDefects === self::ORDER_DEFECTS_FIRST) {
$suite->setTests($this->sortDefectsFirst($suite->tests()));
}
if ($resolveDependencies && !($suite instanceof DataProviderTestSuite)) {
$tests = $suite->tests();
$suite->setTests($this->resolveDependencies($tests));
}
}
private function addSuiteToDefectSortOrder(TestSuite $suite): void
{
$max = 0;
foreach ($suite->tests() as $test) {
if (!$test instanceof Reorderable) {
continue;
}
if (!isset($this->defectSortOrder[$test->sortId()])) {
$this->defectSortOrder[$test->sortId()] = $this->cache->status($test->sortId())->asInt();
$max = max($max, $this->defectSortOrder[$test->sortId()]);
}
}
$this->defectSortOrder[$suite->sortId()] = $max;
}
private function reverse(array $tests): array
{
return array_reverse($tests);
}
private function randomize(array $tests): array
{
shuffle($tests);
return $tests;
}
private function sortDefectsFirst(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpDefectPriorityAndTime($left, $right),
);
return $tests;
}
private function sortByDuration(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpDuration($left, $right),
);
return $tests;
}
private function sortBySize(array $tests): array
{
usort(
$tests,
fn ($left, $right) => $this->cmpSize($left, $right),
);
return $tests;
}
/**
* Comparator callback function to sort tests for "reach failure as fast as possible".
*
* 1. sort tests by defect weight defined in self::DEFECT_SORT_WEIGHT
* 2. when tests are equally defective, sort the fastest to the front
* 3. do not reorder successful tests
*/
private function cmpDefectPriorityAndTime(Test $a, Test $b): int
{
if (!($a instanceof Reorderable && $b instanceof Reorderable)) {
return 0;
}
$priorityA = $this->defectSortOrder[$a->sortId()] ?? 0;
$priorityB = $this->defectSortOrder[$b->sortId()] ?? 0;
if ($priorityB <=> $priorityA) {
// Sort defect weight descending
return $priorityB <=> $priorityA;
}
if ($priorityA || $priorityB) {
return $this->cmpDuration($a, $b);
}
// do not change execution order
return 0;
}
/**
* Compares test duration for sorting tests by duration ascending.
*/
private function cmpDuration(Test $a, Test $b): int
{
if (!($a instanceof Reorderable && $b instanceof Reorderable)) {
return 0;
}
return $this->cache->time($a->sortId()) <=> $this->cache->time($b->sortId());
}
/**
* Compares test size for sorting tests small->medium->large->unknown.
*/
private function cmpSize(Test $a, Test $b): int
{
$sizeA = ($a instanceof TestCase || $a instanceof DataProviderTestSuite)
? $a->size()->asString()
: 'unknown';
$sizeB = ($b instanceof TestCase || $b instanceof DataProviderTestSuite)
? $b->size()->asString()
: 'unknown';
return self::SIZE_SORT_WEIGHT[$sizeA] <=> self::SIZE_SORT_WEIGHT[$sizeB];
}
/**
* Reorder Tests within a TestCase in such a way as to resolve as many dependencies as possible.
* The algorithm will leave the tests in original running order when it can.
* For more details see the documentation for test dependencies.
*
* Short description of algorithm:
* 1. Pick the next Test from remaining tests to be checked for dependencies.
* 2. If the test has no dependencies: mark done, start again from the top
* 3. If the test has dependencies but none left to do: mark done, start again from the top
* 4. When we reach the end add any leftover tests to the end. These will be marked 'skipped' during execution.
*
* @psalm-param array<DataProviderTestSuite|TestCase> $tests
*
* @psalm-return array<DataProviderTestSuite|TestCase>
*/
private function resolveDependencies(array $tests): array
{
$newTestOrder = [];
$i = 0;
$provided = [];
do {
if ([] === array_diff($tests[$i]->requires(), $provided)) {
$provided = array_merge($provided, $tests[$i]->provides());
$newTestOrder = array_merge($newTestOrder, array_splice($tests, $i, 1));
$i = 0;
} else {
$i++;
}
} while (!empty($tests) && ($i < count($tests)));
return array_merge($newTestOrder, $tests);
}
private function calculateTestExecutionOrder(Test $suite): array
{
$tests = [];
if ($suite instanceof TestSuite) {
foreach ($suite->tests() as $test) {
if (!$test instanceof TestSuite && $test instanceof Reorderable) {
$tests[] = $test->sortId();
} else {
$tests = array_merge($tests, $this->calculateTestExecutionOrder($test));
}
}
}
return $tests;
}
}
src/Runner/CodeCoverage.php 0000644 00000033022 15243426620 0011647 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Runner;
use function file_put_contents;
use function sprintf;
use PHPUnit\Event\Facade as EventFacade;
use PHPUnit\Event\TestData\MoreThanOneDataSetFromDataProviderException;
use PHPUnit\Framework\TestCase;
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
use PHPUnit\TextUI\Configuration\Configuration;
use PHPUnit\TextUI\Output\Printer;
use SebastianBergmann\CodeCoverage\Driver\Driver;
use SebastianBergmann\CodeCoverage\Driver\Selector;
use SebastianBergmann\CodeCoverage\Exception as CodeCoverageException;
use SebastianBergmann\CodeCoverage\Filter;
use SebastianBergmann\CodeCoverage\Report\Clover as CloverReport;
use SebastianBergmann\CodeCoverage\Report\Cobertura as CoberturaReport;
use SebastianBergmann\CodeCoverage\Report\Crap4j as Crap4jReport;
use SebastianBergmann\CodeCoverage\Report\Html\Colors;
use SebastianBergmann\CodeCoverage\Report\Html\CustomCssFile;
use SebastianBergmann\CodeCoverage\Report\Html\Facade as HtmlReport;
use SebastianBergmann\CodeCoverage\Report\PHP as PhpReport;
use SebastianBergmann\CodeCoverage\Report\Text as TextReport;
use SebastianBergmann\CodeCoverage\Report\Thresholds;
use SebastianBergmann\CodeCoverage\Report\Xml\Facade as XmlReport;
use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
use SebastianBergmann\CodeCoverage\Test\TestStatus\TestStatus;
use SebastianBergmann\Comparator\Comparator;
use SebastianBergmann\Timer\NoActiveTimerException;
use SebastianBergmann\Timer\Timer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class CodeCoverage
{
private static ?self $instance = null;
private ?\SebastianBergmann\CodeCoverage\CodeCoverage $codeCoverage = null;
private ?Driver $driver = null;
private bool $collecting = false;
private ?TestCase $test = null;
private ?Timer $timer = null;
/**
* @psalm-var array<string,list<int>>
*/
private array $linesToBeIgnored = [];
public static function instance(): self
{
if (self::$instance === null) {
self::$instance = new self;
}
return self::$instance;
}
public function init(Configuration $configuration, CodeCoverageFilterRegistry $codeCoverageFilterRegistry, bool $extensionRequiresCodeCoverageCollection): void
{
$codeCoverageFilterRegistry->init($configuration);
if (!$configuration->hasCoverageReport() && !$extensionRequiresCodeCoverageCollection) {
return;
}
$this->activate($codeCoverageFilterRegistry->get(), $configuration->pathCoverage());
if (!$this->isActive()) {
return;
}
if ($configuration->hasCoverageCacheDirectory()) {
$this->codeCoverage()->cacheStaticAnalysis($configuration->coverageCacheDirectory());
}
$this->codeCoverage()->excludeSubclassesOfThisClassFromUnintentionallyCoveredCodeCheck(Comparator::class);
if ($configuration->strictCoverage()) {
$this->codeCoverage()->enableCheckForUnintentionallyCoveredCode();
}
if ($configuration->ignoreDeprecatedCodeUnitsFromCodeCoverage()) {
$this->codeCoverage()->ignoreDeprecatedCode();
} else {
$this->codeCoverage()->doNotIgnoreDeprecatedCode();
}
if ($configuration->disableCodeCoverageIgnore()) {
$this->codeCoverage()->disableAnnotationsForIgnoringCode();
} else {
$this->codeCoverage()->enableAnnotationsForIgnoringCode();
}
if ($configuration->includeUncoveredFiles()) {
$this->codeCoverage()->includeUncoveredFiles();
} else {
$this->codeCoverage()->excludeUncoveredFiles();
}
if ($codeCoverageFilterRegistry->get()->isEmpty()) {
if (!$codeCoverageFilterRegistry->configured()) {
EventFacade::emitter()->testRunnerTriggeredWarning(
'No filter is configured, code coverage will not be processed',
);
} else {
EventFacade::emitter()->testRunnerTriggeredWarning(
'Incorrect filter configuration, code coverage will not be processed',
);
}
$this->deactivate();
}
}
/**
* @psalm-assert-if-true !null $this->instance
*/
public function isActive(): bool
{
return $this->codeCoverage !== null;
}
public function codeCoverage(): \SebastianBergmann\CodeCoverage\CodeCoverage
{
return $this->codeCoverage;
}
public function driver(): Driver
{
return $this->driver;
}
/**
* @throws MoreThanOneDataSetFromDataProviderException
*/
public function start(TestCase $test): void
{
if ($this->collecting) {
return;
}
$size = TestSize::unknown();
if ($test->size()->isSmall()) {
$size = TestSize::small();
} elseif ($test->size()->isMedium()) {
$size = TestSize::medium();
} elseif ($test->size()->isLarge()) {
$size = TestSize::large();
}
$this->test = $test;
$this->codeCoverage->start(
$test->valueObjectForEvents()->id(),
$size,
);
$this->collecting = true;
}
public function stop(bool $append = true, array|false $linesToBeCovered = [], array $linesToBeUsed = []): void
{
if (!$this->collecting) {
return;
}
$status = TestStatus::unknown();
if ($this->test !== null) {
if ($this->test->status()->isSuccess()) {
$status = TestStatus::success();
} else {
$status = TestStatus::failure();
}
}
/* @noinspection UnusedFunctionResultInspection */
$this->codeCoverage->stop($append, $status, $linesToBeCovered, $linesToBeUsed, $this->linesToBeIgnored);
$this->test = null;
$this->collecting = false;
}
public function deactivate(): void
{
$this->driver = null;
$this->codeCoverage = null;
$this->test = null;
}
public function generateReports(Printer $printer, Configuration $configuration): void
{
if (!$this->isActive()) {
return;
}
if ($configuration->hasCoveragePhp()) {
$this->codeCoverageGenerationStart($printer, 'PHP');
try {
$writer = new PhpReport;
$writer->process($this->codeCoverage(), $configuration->coveragePhp());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageClover()) {
$this->codeCoverageGenerationStart($printer, 'Clover XML');
try {
$writer = new CloverReport;
$writer->process($this->codeCoverage(), $configuration->coverageClover());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageCobertura()) {
$this->codeCoverageGenerationStart($printer, 'Cobertura XML');
try {
$writer = new CoberturaReport;
$writer->process($this->codeCoverage(), $configuration->coverageCobertura());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageCrap4j()) {
$this->codeCoverageGenerationStart($printer, 'Crap4J XML');
try {
$writer = new Crap4jReport($configuration->coverageCrap4jThreshold());
$writer->process($this->codeCoverage(), $configuration->coverageCrap4j());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageHtml()) {
$this->codeCoverageGenerationStart($printer, 'HTML');
try {
$customCssFile = CustomCssFile::default();
if ($configuration->hasCoverageHtmlCustomCssFile()) {
$customCssFile = CustomCssFile::from($configuration->coverageHtmlCustomCssFile());
}
$writer = new HtmlReport(
sprintf(
' and <a href="https://phpunit.de/">PHPUnit %s</a>',
Version::id(),
),
Colors::from(
$configuration->coverageHtmlColorSuccessLow(),
$configuration->coverageHtmlColorSuccessMedium(),
$configuration->coverageHtmlColorSuccessHigh(),
$configuration->coverageHtmlColorWarning(),
$configuration->coverageHtmlColorDanger(),
),
Thresholds::from(
$configuration->coverageHtmlLowUpperBound(),
$configuration->coverageHtmlHighLowerBound(),
),
$customCssFile,
);
$writer->process($this->codeCoverage(), $configuration->coverageHtml());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
if ($configuration->hasCoverageText()) {
$processor = new TextReport(
Thresholds::default(),
$configuration->coverageTextShowUncoveredFiles(),
$configuration->coverageTextShowOnlySummary(),
);
$textReport = $processor->process($this->codeCoverage(), $configuration->colors());
if ($configuration->coverageText() === 'php://stdout') {
$printer->print($textReport);
} else {
file_put_contents($configuration->coverageText(), $textReport);
}
}
if ($configuration->hasCoverageXml()) {
$this->codeCoverageGenerationStart($printer, 'PHPUnit XML');
try {
$writer = new XmlReport(Version::id());
$writer->process($this->codeCoverage(), $configuration->coverageXml());
$this->codeCoverageGenerationSucceeded($printer);
unset($writer);
} catch (CodeCoverageException $e) {
$this->codeCoverageGenerationFailed($printer, $e);
}
}
}
/**
* @psalm-param array<string,list<int>> $linesToBeIgnored
*/
public function ignoreLines(array $linesToBeIgnored): void
{
$this->linesToBeIgnored = $linesToBeIgnored;
}
/**
* @psalm-return array<string,list<int>>
*/
public function linesToBeIgnored(): array
{
return $this->linesToBeIgnored;
}
private function activate(Filter $filter, bool $pathCoverage): void
{
try {
if ($pathCoverage) {
$this->driver = (new Selector)->forLineAndPathCoverage($filter);
} else {
$this->driver = (new Selector)->forLineCoverage($filter);
}
$this->codeCoverage = new \SebastianBergmann\CodeCoverage\CodeCoverage(
$this->driver,
$filter,
);
} catch (CodeCoverageException $e) {
EventFacade::emitter()->testRunnerTriggeredWarning(
$e->getMessage(),
);
}
}
private function codeCoverageGenerationStart(Printer $printer, string $format): void
{
$printer->print(
sprintf(
"\nGenerating code coverage report in %s format ... ",
$format,
),
);
$this->timer()->start();
}
/**
* @throws NoActiveTimerException
*/
private function codeCoverageGenerationSucceeded(Printer $printer): void
{
$printer->print(
sprintf(
"done [%s]\n",
$this->timer()->stop()->asString(),
),
);
}
/**
* @throws NoActiveTimerException
*/
private function codeCoverageGenerationFailed(Printer $printer, CodeCoverageException $e): void
{
$printer->print(
sprintf(
"failed [%s]\n%s\n",
$this->timer()->stop()->asString(),
$e->getMessage(),
),
);
}
private function timer(): Timer
{
if ($this->timer === null) {
$this->timer = new Timer;
}
return $this->timer;
}
}
src/Logging/EventLogger.php 0000644 00000003267 15243426620 0011667 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging;
use const FILE_APPEND;
use const LOCK_EX;
use const PHP_EOL;
use function file_put_contents;
use function implode;
use function preg_split;
use function str_repeat;
use function strlen;
use PHPUnit\Event\Event;
use PHPUnit\Event\Tracer\Tracer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class EventLogger implements Tracer
{
private readonly string $path;
private readonly bool $includeTelemetryInfo;
public function __construct(string $path, bool $includeTelemetryInfo)
{
$this->path = $path;
$this->includeTelemetryInfo = $includeTelemetryInfo;
}
public function trace(Event $event): void
{
$telemetryInfo = $this->telemetryInfo($event);
$indentation = PHP_EOL . str_repeat(' ', strlen($telemetryInfo));
$lines = preg_split('/\r\n|\r|\n/', $event->asString());
$flags = FILE_APPEND;
if (PHP_OS_FAMILY !== 'Windows' || $this->path !== 'php://stdout') {
$flags |= LOCK_EX;
}
file_put_contents(
$this->path,
$telemetryInfo . implode($indentation, $lines) . PHP_EOL,
$flags,
);
}
private function telemetryInfo(Event $event): string
{
if (!$this->includeTelemetryInfo) {
return '';
}
return $event->telemetryInfo()->asString() . ' ';
}
}
src/Logging/JUnit/JunitXmlLogger.php 0000644 00000030703 15243426620 0013404 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use function assert;
use function basename;
use function is_int;
use function sprintf;
use function str_replace;
use function trim;
use DOMDocument;
use DOMElement;
use PHPUnit\Event\Code\Test;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Telemetry\Info;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\PreparationStarted;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\TextUI\Output\Printer;
use PHPUnit\Util\Xml;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class JunitXmlLogger
{
private readonly Printer $printer;
private DOMDocument $document;
private DOMElement $root;
/**
* @var DOMElement[]
*/
private array $testSuites = [];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteTests = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteAssertions = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteErrors = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteFailures = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteSkipped = [0];
/**
* @psalm-var array<int,int>
*/
private array $testSuiteTimes = [0];
private int $testSuiteLevel = 0;
private ?DOMElement $currentTestCase = null;
private ?HRTime $time = null;
private bool $prepared = false;
private bool $preparationFailed = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$this->registerSubscribers($facade);
$this->createDocument();
}
public function flush(): void
{
$this->printer->print($this->document->saveXML());
$this->printer->flush();
}
public function testSuiteStarted(Started $event): void
{
$testSuite = $this->document->createElement('testsuite');
$testSuite->setAttribute('name', $event->testSuite()->name());
if ($event->testSuite()->isForTestClass()) {
$testSuite->setAttribute('file', $event->testSuite()->file());
}
if ($this->testSuiteLevel > 0) {
$this->testSuites[$this->testSuiteLevel]->appendChild($testSuite);
} else {
$this->root->appendChild($testSuite);
}
$this->testSuiteLevel++;
$this->testSuites[$this->testSuiteLevel] = $testSuite;
$this->testSuiteTests[$this->testSuiteLevel] = 0;
$this->testSuiteAssertions[$this->testSuiteLevel] = 0;
$this->testSuiteErrors[$this->testSuiteLevel] = 0;
$this->testSuiteFailures[$this->testSuiteLevel] = 0;
$this->testSuiteSkipped[$this->testSuiteLevel] = 0;
$this->testSuiteTimes[$this->testSuiteLevel] = 0;
}
public function testSuiteFinished(): void
{
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'tests',
(string) $this->testSuiteTests[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'assertions',
(string) $this->testSuiteAssertions[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'errors',
(string) $this->testSuiteErrors[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'failures',
(string) $this->testSuiteFailures[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'skipped',
(string) $this->testSuiteSkipped[$this->testSuiteLevel],
);
$this->testSuites[$this->testSuiteLevel]->setAttribute(
'time',
sprintf('%F', $this->testSuiteTimes[$this->testSuiteLevel]),
);
if ($this->testSuiteLevel > 1) {
$this->testSuiteTests[$this->testSuiteLevel - 1] += $this->testSuiteTests[$this->testSuiteLevel];
$this->testSuiteAssertions[$this->testSuiteLevel - 1] += $this->testSuiteAssertions[$this->testSuiteLevel];
$this->testSuiteErrors[$this->testSuiteLevel - 1] += $this->testSuiteErrors[$this->testSuiteLevel];
$this->testSuiteFailures[$this->testSuiteLevel - 1] += $this->testSuiteFailures[$this->testSuiteLevel];
$this->testSuiteSkipped[$this->testSuiteLevel - 1] += $this->testSuiteSkipped[$this->testSuiteLevel];
$this->testSuiteTimes[$this->testSuiteLevel - 1] += $this->testSuiteTimes[$this->testSuiteLevel];
}
$this->testSuiteLevel--;
}
/**
* @throws InvalidArgumentException
*/
public function testPreparationStarted(PreparationStarted $event): void
{
$this->createTestCase($event);
}
/**
* @throws InvalidArgumentException
*/
public function testPreparationFailed(): void
{
$this->preparationFailed = true;
}
/**
* @throws InvalidArgumentException
*/
public function testPrepared(): void
{
$this->prepared = true;
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
if (!$this->prepared || $this->preparationFailed) {
return;
}
$this->handleFinish($event->telemetryInfo(), $event->numberOfAssertionsPerformed());
}
/**
* @throws InvalidArgumentException
*/
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
$this->handleIncompleteOrSkipped($event);
}
/**
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
$this->handleIncompleteOrSkipped($event);
}
/**
* @throws InvalidArgumentException
*/
public function testErrored(Errored $event): void
{
$this->handleFault($event, 'error');
$this->testSuiteErrors[$this->testSuiteLevel]++;
}
/**
* @throws InvalidArgumentException
*/
public function testFailed(Failed $event): void
{
$this->handleFault($event, 'failure');
$this->testSuiteFailures[$this->testSuiteLevel]++;
}
/**
* @throws InvalidArgumentException
*/
private function handleFinish(Info $telemetryInfo, int $numberOfAssertionsPerformed): void
{
assert($this->currentTestCase !== null);
assert($this->time !== null);
$time = $telemetryInfo->time()->duration($this->time)->asFloat();
$this->testSuiteAssertions[$this->testSuiteLevel] += $numberOfAssertionsPerformed;
$this->currentTestCase->setAttribute(
'assertions',
(string) $numberOfAssertionsPerformed,
);
$this->currentTestCase->setAttribute(
'time',
sprintf('%F', $time),
);
$this->testSuites[$this->testSuiteLevel]->appendChild(
$this->currentTestCase,
);
$this->testSuiteTests[$this->testSuiteLevel]++;
$this->testSuiteTimes[$this->testSuiteLevel] += $time;
$this->currentTestCase = null;
$this->time = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparationStartedSubscriber($this),
new TestPreparationFailedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestRunnerExecutionFinishedSubscriber($this),
);
}
private function createDocument(): void
{
$this->document = new DOMDocument('1.0', 'UTF-8');
$this->document->formatOutput = true;
$this->root = $this->document->createElement('testsuites');
$this->document->appendChild($this->root);
}
/**
* @throws InvalidArgumentException
*/
private function handleFault(Errored|Failed $event, string $type): void
{
if (!$this->prepared) {
$this->createTestCase($event);
}
assert($this->currentTestCase !== null);
$buffer = $this->testAsString($event->test());
$throwable = $event->throwable();
$buffer .= trim(
$throwable->description() . PHP_EOL .
$throwable->stackTrace(),
);
$fault = $this->document->createElement(
$type,
Xml::prepareString($buffer),
);
$fault->setAttribute('type', $throwable->className());
$this->currentTestCase->appendChild($fault);
if (!$this->prepared) {
$this->handleFinish($event->telemetryInfo(), 0);
}
}
/**
* @throws InvalidArgumentException
*/
private function handleIncompleteOrSkipped(MarkedIncomplete|Skipped $event): void
{
if (!$this->prepared) {
$this->createTestCase($event);
}
assert($this->currentTestCase !== null);
$skipped = $this->document->createElement('skipped');
$this->currentTestCase->appendChild($skipped);
$this->testSuiteSkipped[$this->testSuiteLevel]++;
if (!$this->prepared) {
$this->handleFinish($event->telemetryInfo(), 0);
}
}
/**
* @throws InvalidArgumentException
*/
private function testAsString(Test $test): string
{
if ($test->isPhpt()) {
return basename($test->file());
}
assert($test instanceof TestMethod);
return sprintf(
'%s::%s%s',
$test->className(),
$this->name($test),
PHP_EOL,
);
}
/**
* @throws InvalidArgumentException
*/
private function name(Test $test): string
{
if ($test->isPhpt()) {
return basename($test->file());
}
assert($test instanceof TestMethod);
if (!$test->testData()->hasDataFromDataProvider()) {
return $test->methodName();
}
$dataSetName = $test->testData()->dataFromDataProvider()->dataSetName();
if (is_int($dataSetName)) {
return sprintf(
'%s with data set #%d',
$test->methodName(),
$dataSetName,
);
}
return sprintf(
'%s with data set "%s"',
$test->methodName(),
$dataSetName,
);
}
/**
* @throws InvalidArgumentException
*
* @psalm-assert !null $this->currentTestCase
*/
private function createTestCase(Errored|Failed|MarkedIncomplete|PreparationStarted|Prepared|Skipped $event): void
{
$testCase = $this->document->createElement('testcase');
$test = $event->test();
$testCase->setAttribute('name', $this->name($test));
$testCase->setAttribute('file', $test->file());
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
$testCase->setAttribute('line', (string) $test->line());
$testCase->setAttribute('class', $test->className());
$testCase->setAttribute('classname', str_replace('\\', '.', $test->className()));
}
$this->currentTestCase = $testCase;
$this->time = $event->telemetryInfo()->time();
}
}
src/Logging/JUnit/Subscriber/TestFailedSubscriber.php 0000644 00000001352 15243426620 0016643 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Failed $event): void
{
$this->logger()->testFailed($event);
}
}
src/Logging/JUnit/Subscriber/TestPreparationFailedSubscriber.php 0000644 00000001446 15243426620 0021054 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\PreparationFailed;
use PHPUnit\Event\Test\PreparationFailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparationFailedSubscriber extends Subscriber implements PreparationFailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(PreparationFailed $event): void
{
$this->logger()->testPreparationFailed();
}
}
src/Logging/JUnit/Subscriber/TestPreparedSubscriber.php 0000644 00000001360 15243426620 0017220 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Prepared $event): void
{
$this->logger()->testPrepared();
}
}
src/Logging/JUnit/Subscriber/TestFinishedSubscriber.php 0000644 00000001366 15243426620 0017215 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->logger()->testFinished($event);
}
}
src/Logging/JUnit/Subscriber/TestRunnerExecutionFinishedSubscriber.php 0000644 00000001304 15243426620 0022263 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionFinishedSubscriber extends Subscriber implements ExecutionFinishedSubscriber
{
public function notify(ExecutionFinished $event): void
{
$this->logger()->flush();
}
}
src/Logging/JUnit/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001240 15243426620 0020216 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->logger()->testSuiteFinished();
}
}
src/Logging/JUnit/Subscriber/TestSkippedSubscriber.php 0000644 00000001360 15243426620 0017055 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->logger()->testSkipped($event);
}
}
src/Logging/JUnit/Subscriber/Subscriber.php 0000644 00000001214 15243426620 0014673 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly JunitXmlLogger $logger;
public function __construct(JunitXmlLogger $logger)
{
$this->logger = $logger;
}
protected function logger(): JunitXmlLogger
{
return $this->logger;
}
}
src/Logging/JUnit/Subscriber/TestErroredSubscriber.php 0000644 00000001360 15243426620 0017060 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Errored $event): void
{
$this->logger()->testErrored($event);
}
}
src/Logging/JUnit/Subscriber/TestPreparationStartedSubscriber.php 0000644 00000001462 15243426620 0021274 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\PreparationStarted;
use PHPUnit\Event\Test\PreparationStartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparationStartedSubscriber extends Subscriber implements PreparationStartedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(PreparationStarted $event): void
{
$this->logger()->testPreparationStarted($event);
}
}
src/Logging/JUnit/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001446 15243426620 0020706 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(MarkedIncomplete $event): void
{
$this->logger()->testMarkedIncomplete($event);
}
}
src/Logging/JUnit/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001240 15243426620 0020073 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\JUnit;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->logger()->testSuiteStarted($event);
}
}
src/Logging/TeamCity/TeamCityLogger.php 0000644 00000024253 15243426620 0014042 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use function assert;
use function getmypid;
use function ini_get;
use function is_a;
use function round;
use function sprintf;
use function str_replace;
use function stripos;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\Event;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Telemetry\HRTime;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\TestSuite\Finished as TestSuiteFinished;
use PHPUnit\Event\TestSuite\Started as TestSuiteStarted;
use PHPUnit\Event\TestSuite\TestSuiteForTestClass;
use PHPUnit\Event\TestSuite\TestSuiteForTestMethodWithDataProvider;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\Exception as FrameworkException;
use PHPUnit\TextUI\Output\Printer;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TeamCityLogger
{
private readonly Printer $printer;
private bool $isSummaryTestCountPrinted = false;
private ?HRTime $time = null;
private ?int $flowId;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Printer $printer, Facade $facade)
{
$this->printer = $printer;
$this->registerSubscribers($facade);
$this->setFlowId();
}
public function testSuiteStarted(TestSuiteStarted $event): void
{
$testSuite = $event->testSuite();
if (!$this->isSummaryTestCountPrinted) {
$this->isSummaryTestCountPrinted = true;
$this->writeMessage(
'testCount',
['count' => $testSuite->count()],
);
}
$parameters = ['name' => $testSuite->name()];
if ($testSuite->isForTestClass()) {
assert($testSuite instanceof TestSuiteForTestClass);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s',
$testSuite->file(),
$testSuite->name(),
);
} elseif ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s',
$testSuite->file(),
$testSuite->name(),
);
$parameters['name'] = $testSuite->methodName();
}
$this->writeMessage('testSuiteStarted', $parameters);
}
public function testSuiteFinished(TestSuiteFinished $event): void
{
$testSuite = $event->testSuite();
$parameters = ['name' => $testSuite->name()];
if ($testSuite->isForTestMethodWithDataProvider()) {
assert($testSuite instanceof TestSuiteForTestMethodWithDataProvider);
$parameters['name'] = $testSuite->methodName();
}
$this->writeMessage('testSuiteFinished', $parameters);
}
public function testPrepared(Prepared $event): void
{
$test = $event->test();
$parameters = [
'name' => $test->name(),
];
if ($test->isTestMethod()) {
assert($test instanceof TestMethod);
$parameters['locationHint'] = sprintf(
'php_qn://%s::\\%s::%s',
$test->file(),
$test->className(),
$test->name(),
);
}
$this->writeMessage('testStarted', $parameters);
$this->time = $event->telemetryInfo()->time();
}
/**
* @throws InvalidArgumentException
*/
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testIgnored',
[
'name' => $event->test()->name(),
'message' => $event->throwable()->message(),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testSkipped(Skipped $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$parameters = [
'name' => $event->test()->name(),
'message' => $event->message(),
];
$parameters['duration'] = $this->duration($event);
$this->writeMessage('testIgnored', $parameters);
}
/**
* @throws InvalidArgumentException
*/
public function testErrored(Errored $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testFailed',
[
'name' => $event->test()->name(),
'message' => $this->message($event->throwable()),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testFailed(Failed $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$parameters = [
'name' => $event->test()->name(),
'message' => $this->message($event->throwable()),
'details' => $this->details($event->throwable()),
'duration' => $this->duration($event),
];
if ($event->hasComparisonFailure()) {
$parameters['type'] = 'comparisonFailure';
$parameters['actual'] = $event->comparisonFailure()->actual();
$parameters['expected'] = $event->comparisonFailure()->expected();
}
$this->writeMessage('testFailed', $parameters);
}
/**
* @throws InvalidArgumentException
*/
public function testConsideredRisky(ConsideredRisky $event): void
{
if ($this->time === null) {
$this->time = $event->telemetryInfo()->time();
}
$this->writeMessage(
'testFailed',
[
'name' => $event->test()->name(),
'message' => $event->message(),
'details' => '',
'duration' => $this->duration($event),
],
);
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
$this->writeMessage(
'testFinished',
[
'name' => $event->test()->name(),
'duration' => $this->duration($event),
],
);
$this->time = null;
}
public function flush(): void
{
$this->printer->flush();
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestSuiteStartedSubscriber($this),
new TestSuiteFinishedSubscriber($this),
new TestPreparedSubscriber($this),
new TestFinishedSubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestSkippedSubscriber($this),
new TestConsideredRiskySubscriber($this),
new TestRunnerExecutionFinishedSubscriber($this),
);
}
private function setFlowId(): void
{
if (stripos(ini_get('disable_functions'), 'getmypid') === false) {
$this->flowId = getmypid();
}
}
private function writeMessage(string $eventName, array $parameters = []): void
{
$this->printer->print(
sprintf(
"\n##teamcity[%s",
$eventName,
),
);
if ($this->flowId !== null) {
$parameters['flowId'] = $this->flowId;
}
foreach ($parameters as $key => $value) {
$this->printer->print(
sprintf(
" %s='%s'",
$key,
$this->escape((string) $value),
),
);
}
$this->printer->print("]\n");
}
/**
* @throws InvalidArgumentException
*/
private function duration(Event $event): int
{
if ($this->time === null) {
return 0;
}
return (int) round($event->telemetryInfo()->time()->duration($this->time)->asFloat() * 1000);
}
private function escape(string $string): string
{
return str_replace(
['|', "'", "\n", "\r", ']', '['],
['||', "|'", '|n', '|r', '|]', '|['],
$string,
);
}
private function message(Throwable $throwable): string
{
if (is_a($throwable->className(), FrameworkException::class, true)) {
return $throwable->message();
}
$buffer = $throwable->className();
if (!empty($throwable->message())) {
$buffer .= ': ' . $throwable->message();
}
return $buffer;
}
private function details(Throwable $throwable): string
{
$buffer = $throwable->stackTrace();
while ($throwable->hasPrevious()) {
$throwable = $throwable->previous();
$buffer .= sprintf(
"\nCaused by\n%s\n%s",
$throwable->description(),
$throwable->stackTrace(),
);
}
return $buffer;
}
}
src/Logging/TeamCity/Subscriber/TestFailedSubscriber.php 0000644 00000001355 15243426620 0017334 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Failed $event): void
{
$this->logger()->testFailed($event);
}
}
src/Logging/TeamCity/Subscriber/TestPreparedSubscriber.php 0000644 00000001225 15243426620 0017706 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->logger()->testPrepared($event);
}
}
src/Logging/TeamCity/Subscriber/TestFinishedSubscriber.php 0000644 00000001371 15243426620 0017677 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->logger()->testFinished($event);
}
}
src/Logging/TeamCity/Subscriber/TestRunnerExecutionFinishedSubscriber.php 0000644 00000001307 15243426620 0022754 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestRunner\ExecutionFinished;
use PHPUnit\Event\TestRunner\ExecutionFinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestRunnerExecutionFinishedSubscriber extends Subscriber implements ExecutionFinishedSubscriber
{
public function notify(ExecutionFinished $event): void
{
$this->logger()->flush();
}
}
src/Logging/TeamCity/Subscriber/TestSuiteFinishedSubscriber.php 0000644 00000001251 15243426620 0020706 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestSuite\Finished;
use PHPUnit\Event\TestSuite\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
public function notify(Finished $event): void
{
$this->logger()->testSuiteFinished($event);
}
}
src/Logging/TeamCity/Subscriber/TestSkippedSubscriber.php 0000644 00000001363 15243426620 0017546 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Skipped $event): void
{
$this->logger()->testSkipped($event);
}
}
src/Logging/TeamCity/Subscriber/Subscriber.php 0000644 00000001217 15243426620 0015364 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly TeamCityLogger $logger;
public function __construct(TeamCityLogger $logger)
{
$this->logger = $logger;
}
protected function logger(): TeamCityLogger
{
return $this->logger;
}
}
src/Logging/TeamCity/Subscriber/TestErroredSubscriber.php 0000644 00000001363 15243426620 0017551 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Errored $event): void
{
$this->logger()->testErrored($event);
}
}
src/Logging/TeamCity/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001451 15243426620 0021370 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(MarkedIncomplete $event): void
{
$this->logger()->testMarkedIncomplete($event);
}
}
src/Logging/TeamCity/Subscriber/TestSuiteStartedSubscriber.php 0000644 00000001243 15243426620 0020564 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\TestSuite\Started;
use PHPUnit\Event\TestSuite\StartedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSuiteStartedSubscriber extends Subscriber implements StartedSubscriber
{
public function notify(Started $event): void
{
$this->logger()->testSuiteStarted($event);
}
}
src/Logging/TeamCity/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001443 15243426620 0021247 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TeamCity;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(ConsideredRisky $event): void
{
$this->logger()->testConsideredRisky($event);
}
}
src/Logging/TestDox/NamePrettifier.php 0000644 00000021110 15243426620 0013741 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function array_key_exists;
use function array_keys;
use function array_map;
use function array_pop;
use function array_values;
use function assert;
use function class_exists;
use function explode;
use function gettype;
use function implode;
use function is_bool;
use function is_float;
use function is_int;
use function is_object;
use function is_scalar;
use function method_exists;
use function preg_quote;
use function preg_replace;
use function rtrim;
use function sprintf;
use function str_contains;
use function str_ends_with;
use function str_replace;
use function str_starts_with;
use function strlen;
use function strtolower;
use function strtoupper;
use function substr;
use function trim;
use PHPUnit\Framework\TestCase;
use PHPUnit\Metadata\Parser\Registry as MetadataRegistry;
use PHPUnit\Metadata\TestDox;
use PHPUnit\Util\Color;
use ReflectionEnum;
use ReflectionMethod;
use ReflectionObject;
use SebastianBergmann\Exporter\Exporter;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class NamePrettifier
{
/**
* @psalm-var array<string, int>
*/
private static array $strings = [];
/**
* @psalm-param class-string $className
*/
public function prettifyTestClassName(string $className): string
{
if (class_exists($className)) {
$classLevelTestDox = MetadataRegistry::parser()->forClass($className)->isTestDox();
if ($classLevelTestDox->isNotEmpty()) {
$classLevelTestDox = $classLevelTestDox->asArray()[0];
assert($classLevelTestDox instanceof TestDox);
return $classLevelTestDox->text();
}
}
$parts = explode('\\', $className);
$className = array_pop($parts);
if (str_ends_with($className, 'Test')) {
$className = substr($className, 0, strlen($className) - strlen('Test'));
}
if (str_starts_with($className, 'Tests')) {
$className = substr($className, strlen('Tests'));
} elseif (str_starts_with($className, 'Test')) {
$className = substr($className, strlen('Test'));
}
if (empty($className)) {
$className = 'UnnamedTests';
}
if (!empty($parts)) {
$parts[] = $className;
$fullyQualifiedName = implode('\\', $parts);
} else {
$fullyQualifiedName = $className;
}
$result = preg_replace('/(?<=[[:lower:]])(?=[[:upper:]])/u', ' ', $className);
if ($fullyQualifiedName !== $className) {
return $result . ' (' . $fullyQualifiedName . ')';
}
return $result;
}
// NOTE: this method is on a hot path and very performance sensitive. change with care.
public function prettifyTestMethodName(string $name): string
{
if ($name === '') {
return '';
}
$string = rtrim($name, '0123456789');
if (array_key_exists($string, self::$strings)) {
$name = $string;
} elseif ($string === $name) {
self::$strings[$string] = 1;
}
if (str_starts_with($name, 'test_')) {
$name = substr($name, 5);
} elseif (str_starts_with($name, 'test')) {
$name = substr($name, 4);
}
if ($name === '') {
return '';
}
$name[0] = strtoupper($name[0]);
$noUnderscore = str_replace('_', ' ', $name);
if ($noUnderscore !== $name) {
return trim($noUnderscore);
}
$wasNumeric = false;
$buffer = '';
$len = strlen($name);
for ($i = 0; $i < $len; $i++) {
if ($i > 0 && $name[$i] >= 'A' && $name[$i] <= 'Z') {
$buffer .= ' ' . strtolower($name[$i]);
} else {
$isNumeric = $name[$i] >= '0' && $name[$i] <= '9';
if (!$wasNumeric && $isNumeric) {
$buffer .= ' ';
$wasNumeric = true;
}
if ($wasNumeric && !$isNumeric) {
$wasNumeric = false;
}
$buffer .= $name[$i];
}
}
return $buffer;
}
public function prettifyTestCase(TestCase $test, bool $colorize): string
{
$annotationWithPlaceholders = false;
$methodLevelTestDox = MetadataRegistry::parser()->forMethod($test::class, $test->name())->isTestDox()->isMethodLevel();
if ($methodLevelTestDox->isNotEmpty()) {
$methodLevelTestDox = $methodLevelTestDox->asArray()[0];
assert($methodLevelTestDox instanceof TestDox);
$result = $methodLevelTestDox->text();
if (str_contains($result, '$')) {
$annotation = $result;
$providedData = $this->mapTestMethodParameterNamesToProvidedDataValues($test, $colorize);
$variables = array_map(
static fn (string $variable): string => sprintf(
'/%s(?=\b)/',
preg_quote($variable, '/'),
),
array_keys($providedData),
);
$result = trim(preg_replace($variables, $providedData, $annotation));
$annotationWithPlaceholders = true;
}
} else {
$result = $this->prettifyTestMethodName($test->name());
}
if (!$annotationWithPlaceholders && $test->usesDataProvider()) {
$result .= $this->prettifyDataSet($test, $colorize);
}
return $result;
}
public function prettifyDataSet(TestCase $test, bool $colorize): string
{
if (!$colorize) {
return $test->dataSetAsString();
}
if (is_int($test->dataName())) {
return Color::dim(' with data set ') . Color::colorize('fg-cyan', (string) $test->dataName());
}
return Color::dim(' with ') . Color::colorize('fg-cyan', Color::visualizeWhitespace($test->dataName()));
}
private function mapTestMethodParameterNamesToProvidedDataValues(TestCase $test, bool $colorize): array
{
assert(method_exists($test, $test->name()));
/** @noinspection PhpUnhandledExceptionInspection */
$reflector = new ReflectionMethod($test::class, $test->name());
$providedData = [];
$providedDataValues = array_values($test->providedData());
$i = 0;
$providedData['$_dataName'] = $test->dataName();
foreach ($reflector->getParameters() as $parameter) {
if (!array_key_exists($i, $providedDataValues) && $parameter->isDefaultValueAvailable()) {
$providedDataValues[$i] = $parameter->getDefaultValue();
}
$value = $providedDataValues[$i++] ?? null;
if (is_object($value)) {
$reflector = new ReflectionObject($value);
if ($reflector->isEnum()) {
$enumReflector = new ReflectionEnum($value);
if ($enumReflector->isBacked()) {
$value = $value->value;
} else {
$value = $value->name;
}
} elseif ($reflector->hasMethod('__toString')) {
$value = (string) $value;
} else {
$value = $value::class;
}
}
if (!is_scalar($value)) {
$value = gettype($value);
if ($value === 'NULL') {
$value = 'null';
}
}
if (is_bool($value) || is_int($value) || is_float($value)) {
$value = (new Exporter)->export($value);
}
if ($value === '') {
if ($colorize) {
$value = Color::colorize('dim,underlined', 'empty');
} else {
$value = "''";
}
}
$providedData['$' . $parameter->getName()] = $value;
}
if ($colorize) {
$providedData = array_map(
static fn ($value) => Color::colorize('fg-cyan', Color::visualizeWhitespace((string) $value, true)),
$providedData,
);
}
return $providedData;
}
}
src/Logging/TestDox/PlainTextRenderer.php 0000644 00000003613 15243426620 0014432 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class PlainTextRenderer
{
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function render(array $tests): string
{
$buffer = '';
foreach ($tests as $prettifiedClassName => $_tests) {
$buffer .= $prettifiedClassName . "\n";
foreach ($this->reduce($_tests) as $prettifiedMethodName => $outcome) {
$buffer .= sprintf(
' [%s] %s' . "\n",
$outcome,
$prettifiedMethodName,
);
}
$buffer .= "\n";
}
return $buffer;
}
/**
* @psalm-return array<string, 'x'|' '>
*/
private function reduce(TestResultCollection $tests): array
{
$result = [];
foreach ($tests as $test) {
$prettifiedMethodName = $test->test()->testDox()->prettifiedMethodName();
$success = true;
if ($test->status()->isError() ||
$test->status()->isFailure() ||
$test->status()->isIncomplete() ||
$test->status()->isSkipped()) {
$success = false;
}
if (!isset($result[$prettifiedMethodName])) {
$result[$prettifiedMethodName] = $success ? 'x' : ' ';
continue;
}
if ($success) {
continue;
}
$result[$prettifiedMethodName] = ' ';
}
return $result;
}
}
src/Logging/TestDox/TestResult/TestResult.php 0000644 00000002434 15243426620 0015267 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Framework\TestStatus\TestStatus;
/**
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResult
{
private readonly TestMethod $test;
private readonly TestStatus $status;
private readonly ?Throwable $throwable;
public function __construct(TestMethod $test, TestStatus $status, ?Throwable $throwable)
{
$this->test = $test;
$this->status = $status;
$this->throwable = $throwable;
}
public function test(): TestMethod
{
return $this->test;
}
public function status(): TestStatus
{
return $this->status;
}
/**
* @psalm-assert-if-true !null $this->throwable
*/
public function hasThrowable(): bool
{
return $this->throwable !== null;
}
public function throwable(): ?Throwable
{
return $this->throwable;
}
}
src/Logging/TestDox/TestResult/TestResultCollectionIterator.php 0000644 00000002324 15243426620 0021013 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function count;
use Iterator;
/**
* @template-implements Iterator<int, TestResult>
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollectionIterator implements Iterator
{
/**
* @psalm-var list<TestResult>
*/
private readonly array $testResults;
private int $position = 0;
public function __construct(TestResultCollection $testResults)
{
$this->testResults = $testResults->asArray();
}
public function rewind(): void
{
$this->position = 0;
}
public function valid(): bool
{
return $this->position < count($this->testResults);
}
public function key(): int
{
return $this->position;
}
public function current(): TestResult
{
return $this->testResults[$this->position];
}
public function next(): void
{
$this->position++;
}
}
src/Logging/TestDox/TestResult/TestResultCollection.php 0000644 00000002312 15243426620 0017276 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use IteratorAggregate;
/**
* @template-implements IteratorAggregate<int, TestResult>
*
* @psalm-immutable
*
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollection implements IteratorAggregate
{
/**
* @psalm-var list<TestResult>
*/
private readonly array $testResults;
/**
* @psalm-param list<TestResult> $testResults
*/
public static function fromArray(array $testResults): self
{
return new self(...$testResults);
}
private function __construct(TestResult ...$testResults)
{
$this->testResults = $testResults;
}
/**
* @psalm-return list<TestResult>
*/
public function asArray(): array
{
return $this->testResults;
}
public function getIterator(): TestResultCollectionIterator
{
return new TestResultCollectionIterator($this);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredNoticeSubscriber.php 0000644 00000001301 15243426620 0023206 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\NoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredNoticeSubscriber extends Subscriber implements NoticeTriggeredSubscriber
{
public function notify(NoticeTriggered $event): void
{
$this->collector()->testTriggeredNotice($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestFailedSubscriber.php 0000644 00000001213 15243426620 0021316 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\FailedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFailedSubscriber extends Subscriber implements FailedSubscriber
{
public function notify(Failed $event): void
{
$this->collector()->testFailed($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitWarningSubscriber.php 0000644 00000001361 15243426620 0024750 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitWarningSubscriber extends Subscriber implements PhpunitWarningTriggeredSubscriber
{
public function notify(PhpunitWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpunitWarning($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpDeprecationSubscriber.php 0000644 00000001361 15243426620 0024700 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpDeprecationSubscriber extends Subscriber implements PhpDeprecationTriggeredSubscriber
{
public function notify(PhpDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpDeprecation($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredWarningSubscriber.php 0000644 00000001307 15243426620 0023400 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\Test\WarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredWarningSubscriber extends Subscriber implements WarningTriggeredSubscriber
{
public function notify(WarningTriggered $event): void
{
$this->collector()->testTriggeredWarning($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestPreparedSubscriber.php 0000644 00000001227 15243426620 0021701 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\PreparedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPreparedSubscriber extends Subscriber implements PreparedSubscriber
{
public function notify(Prepared $event): void
{
$this->collector()->testPrepared($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitErrorSubscriber.php 0000644 00000001345 15243426620 0024436 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitErrorSubscriber extends Subscriber implements PhpunitErrorTriggeredSubscriber
{
public function notify(PhpunitErrorTriggered $event): void
{
$this->collector()->testTriggeredPhpunitError($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpNoticeSubscriber.php 0000644 00000001323 15243426620 0023662 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpNoticeSubscriber extends Subscriber implements PhpNoticeTriggeredSubscriber
{
public function notify(PhpNoticeTriggered $event): void
{
$this->collector()->testTriggeredPhpNotice($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestFinishedSubscriber.php 0000644 00000001373 15243426620 0021672 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\FinishedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestFinishedSubscriber extends Subscriber implements FinishedSubscriber
{
/**
* @throws InvalidArgumentException
*/
public function notify(Finished $event): void
{
$this->collector()->testFinished($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestSkippedSubscriber.php 0000644 00000001221 15243426620 0021530 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\SkippedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestSkippedSubscriber extends Subscriber implements SkippedSubscriber
{
public function notify(Skipped $event): void
{
$this->collector()->testSkipped($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestPassedSubscriber.php 0000644 00000001213 15243426620 0021351 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Passed;
use PHPUnit\Event\Test\PassedSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestPassedSubscriber extends Subscriber implements PassedSubscriber
{
public function notify(Passed $event): void
{
$this->collector()->testPassed($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/Subscriber.php 0000644 00000001257 15243426620 0017361 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
abstract class Subscriber
{
private readonly TestResultCollector $collector;
public function __construct(TestResultCollector $collector)
{
$this->collector = $collector;
}
protected function collector(): TestResultCollector
{
return $this->collector;
}
}
src/Logging/TestDox/TestResult/Subscriber/TestErroredSubscriber.php 0000644 00000001221 15243426620 0021533 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\ErroredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestErroredSubscriber extends Subscriber implements ErroredSubscriber
{
public function notify(Errored $event): void
{
$this->collector()->testErrored($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpunitDeprecationSubscriber.php 0000644 00000001411 15243426620 0025574 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpunitDeprecationSubscriber extends Subscriber implements PhpunitDeprecationTriggeredSubscriber
{
public function notify(PhpunitDeprecationTriggered $event): void
{
$this->collector()->testTriggeredPhpunitDeprecation($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredPhpWarningSubscriber.php 0000644 00000001331 15243426620 0024045 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredPhpWarningSubscriber extends Subscriber implements PhpWarningTriggeredSubscriber
{
public function notify(PhpWarningTriggered $event): void
{
$this->collector()->testTriggeredPhpWarning($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestTriggeredDeprecationSubscriber.php 0000644 00000001337 15243426620 0024233 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\DeprecationTriggeredSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestTriggeredDeprecationSubscriber extends Subscriber implements DeprecationTriggeredSubscriber
{
public function notify(DeprecationTriggered $event): void
{
$this->collector()->testTriggeredDeprecation($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestMarkedIncompleteSubscriber.php 0000644 00000001307 15243426620 0023361 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\MarkedIncompleteSubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestMarkedIncompleteSubscriber extends Subscriber implements MarkedIncompleteSubscriber
{
public function notify(MarkedIncomplete $event): void
{
$this->collector()->testMarkedIncomplete($event);
}
}
src/Logging/TestDox/TestResult/Subscriber/TestConsideredRiskySubscriber.php 0000644 00000001301 15243426620 0023231 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\ConsideredRiskySubscriber;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestConsideredRiskySubscriber extends Subscriber implements ConsideredRiskySubscriber
{
public function notify(ConsideredRisky $event): void
{
$this->collector()->testConsideredRisky($event);
}
}
src/Logging/TestDox/TestResult/TestResultCollector.php 0000644 00000023754 15243426620 0017146 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function array_keys;
use function array_merge;
use function assert;
use function is_subclass_of;
use function ksort;
use function uksort;
use function usort;
use PHPUnit\Event\Code\TestMethod;
use PHPUnit\Event\Code\Throwable;
use PHPUnit\Event\EventFacadeIsSealedException;
use PHPUnit\Event\Facade;
use PHPUnit\Event\InvalidArgumentException;
use PHPUnit\Event\Test\ConsideredRisky;
use PHPUnit\Event\Test\DeprecationTriggered;
use PHPUnit\Event\Test\Errored;
use PHPUnit\Event\Test\Failed;
use PHPUnit\Event\Test\Finished;
use PHPUnit\Event\Test\MarkedIncomplete;
use PHPUnit\Event\Test\NoticeTriggered;
use PHPUnit\Event\Test\Passed;
use PHPUnit\Event\Test\PhpDeprecationTriggered;
use PHPUnit\Event\Test\PhpNoticeTriggered;
use PHPUnit\Event\Test\PhpunitDeprecationTriggered;
use PHPUnit\Event\Test\PhpunitErrorTriggered;
use PHPUnit\Event\Test\PhpunitWarningTriggered;
use PHPUnit\Event\Test\PhpWarningTriggered;
use PHPUnit\Event\Test\Prepared;
use PHPUnit\Event\Test\Skipped;
use PHPUnit\Event\Test\WarningTriggered;
use PHPUnit\Event\UnknownSubscriberTypeException;
use PHPUnit\Framework\TestStatus\TestStatus;
use PHPUnit\Logging\TestDox\TestResult as TestDoxTestMethod;
use ReflectionMethod;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class TestResultCollector
{
/**
* @psalm-var array<string, list<TestDoxTestMethod>>
*/
private array $tests = [];
private ?TestStatus $status = null;
private ?Throwable $throwable = null;
private bool $prepared = false;
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
public function __construct(Facade $facade)
{
$this->registerSubscribers($facade);
}
/**
* @psalm-return array<string, TestResultCollection>
*/
public function testMethodsGroupedByClass(): array
{
$result = [];
foreach ($this->tests as $prettifiedClassName => $tests) {
$testsByDeclaringClass = [];
foreach ($tests as $test) {
$declaringClassName = (new ReflectionMethod($test->test()->className(), $test->test()->methodName()))->getDeclaringClass()->getName();
if (!isset($testsByDeclaringClass[$declaringClassName])) {
$testsByDeclaringClass[$declaringClassName] = [];
}
$testsByDeclaringClass[$declaringClassName][] = $test;
}
foreach (array_keys($testsByDeclaringClass) as $declaringClassName) {
usort(
$testsByDeclaringClass[$declaringClassName],
static function (TestDoxTestMethod $a, TestDoxTestMethod $b): int
{
return $a->test()->line() <=> $b->test()->line();
},
);
}
uksort(
$testsByDeclaringClass,
/**
* @psalm-param class-string $a
* @psalm-param class-string $b
*/
static function (string $a, string $b): int
{
if (is_subclass_of($b, $a)) {
return -1;
}
if (is_subclass_of($a, $b)) {
return 1;
}
return 0;
},
);
$tests = [];
foreach ($testsByDeclaringClass as $_tests) {
$tests = array_merge($tests, $_tests);
}
$result[$prettifiedClassName] = TestResultCollection::fromArray($tests);
}
ksort($result);
return $result;
}
public function testPrepared(Prepared $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::unknown();
$this->throwable = null;
$this->prepared = true;
}
public function testErrored(Errored $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::error($event->throwable()->message());
$this->throwable = $event->throwable();
if (!$this->prepared) {
$test = $event->test();
assert($test instanceof TestMethod);
$this->process($test);
}
}
public function testFailed(Failed $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->status = TestStatus::failure($event->throwable()->message());
$this->throwable = $event->throwable();
}
public function testPassed(Passed $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::success());
}
public function testSkipped(Skipped $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::skipped($event->message()));
}
public function testMarkedIncomplete(MarkedIncomplete $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::incomplete($event->throwable()->message()));
$this->throwable = $event->throwable();
}
public function testConsideredRisky(ConsideredRisky $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::risky());
}
public function testTriggeredDeprecation(DeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredNotice(NoticeTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredWarning(WarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpDeprecation(PhpDeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpNotice(PhpNoticeTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::notice());
}
public function testTriggeredPhpWarning(PhpWarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
public function testTriggeredPhpunitDeprecation(PhpunitDeprecationTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::deprecation());
}
public function testTriggeredPhpunitError(PhpunitErrorTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::error());
}
public function testTriggeredPhpunitWarning(PhpunitWarningTriggered $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$this->updateTestStatus(TestStatus::warning());
}
/**
* @throws InvalidArgumentException
*/
public function testFinished(Finished $event): void
{
if (!$event->test()->isTestMethod()) {
return;
}
$test = $event->test();
assert($test instanceof TestMethod);
$this->process($test);
$this->status = null;
$this->throwable = null;
$this->prepared = false;
}
/**
* @throws EventFacadeIsSealedException
* @throws UnknownSubscriberTypeException
*/
private function registerSubscribers(Facade $facade): void
{
$facade->registerSubscribers(
new TestConsideredRiskySubscriber($this),
new TestErroredSubscriber($this),
new TestFailedSubscriber($this),
new TestFinishedSubscriber($this),
new TestMarkedIncompleteSubscriber($this),
new TestPassedSubscriber($this),
new TestPreparedSubscriber($this),
new TestSkippedSubscriber($this),
new TestTriggeredDeprecationSubscriber($this),
new TestTriggeredNoticeSubscriber($this),
new TestTriggeredPhpDeprecationSubscriber($this),
new TestTriggeredPhpNoticeSubscriber($this),
new TestTriggeredPhpunitDeprecationSubscriber($this),
new TestTriggeredPhpunitErrorSubscriber($this),
new TestTriggeredPhpunitWarningSubscriber($this),
new TestTriggeredPhpWarningSubscriber($this),
new TestTriggeredWarningSubscriber($this),
);
}
private function updateTestStatus(TestStatus $status): void
{
if ($this->status !== null &&
$this->status->isMoreImportantThan($status)) {
return;
}
$this->status = $status;
}
private function process(TestMethod $test): void
{
if (!isset($this->tests[$test->testDox()->prettifiedClassName()])) {
$this->tests[$test->testDox()->prettifiedClassName()] = [];
}
$this->tests[$test->testDox()->prettifiedClassName()][] = new TestDoxTestMethod(
$test,
$this->status,
$this->throwable,
);
}
}
src/Logging/TestDox/HtmlRenderer.php 0000644 00000007061 15243426620 0013427 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging\TestDox;
use function sprintf;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class HtmlRenderer
{
/**
* @var string
*/
private const PAGE_HEADER = <<<'EOT'
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8"/>
<title>Test Documentation</title>
<style>
body {
text-rendering: optimizeLegibility;
font-family: Source SansSerif Pro, Arial, sans-serif;
font-variant-ligatures: common-ligatures;
font-kerning: normal;
margin-left: 2rem;
background-color: #fff;
color: #000;
}
body > ul > li {
font-size: larger;
}
h2 {
font-size: larger;
text-decoration-line: underline;
text-decoration-thickness: 2px;
margin: 0;
padding: 0.5rem 0;
}
ul {
list-style: none;
margin: 0 0 2rem;
padding: 0 0 0 1rem;
text-indent: -1rem;
}
.success:before {
color: #4e9a06;
content: '✓';
padding-right: 0.5rem;
}
.defect {
color: #a40000;
}
.defect:before {
color: #a40000;
content: '✗';
padding-right: 0.5rem;
}
</style>
</head>
<body>
EOT;
/**
* @var string
*/
private const CLASS_HEADER = <<<'EOT'
<h2>%s</h2>
<ul>
EOT;
/**
* @var string
*/
private const CLASS_FOOTER = <<<'EOT'
</ul>
EOT;
/**
* @var string
*/
private const PAGE_FOOTER = <<<'EOT'
</body>
</html>
EOT;
/**
* @psalm-param array<string, TestResultCollection> $tests
*/
public function render(array $tests): string
{
$buffer = self::PAGE_HEADER;
foreach ($tests as $prettifiedClassName => $_tests) {
$buffer .= sprintf(
self::CLASS_HEADER,
$prettifiedClassName,
);
foreach ($this->reduce($_tests) as $prettifiedMethodName => $outcome) {
$buffer .= sprintf(
" <li class=\"%s\">%s</li>\n",
$outcome,
$prettifiedMethodName,
);
}
$buffer .= self::CLASS_FOOTER;
}
return $buffer . self::PAGE_FOOTER;
}
/**
* @psalm-return array<string, 'success'|'defect'>
*/
private function reduce(TestResultCollection $tests): array
{
$result = [];
foreach ($tests as $test) {
$prettifiedMethodName = $test->test()->testDox()->prettifiedMethodName();
if (!isset($result[$prettifiedMethodName])) {
$result[$prettifiedMethodName] = $test->status()->isSuccess() ? 'success' : 'defect';
continue;
}
if ($test->status()->isSuccess()) {
continue;
}
$result[$prettifiedMethodName] = 'defect';
}
return $result;
}
}
src/Logging/Exception.php 0000644 00000000742 15243426620 0011377 0 ustar 00 <?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace PHPUnit\Logging;
use RuntimeException;
/**
* @internal This class is not covered by the backward compatibility promise for PHPUnit
*/
final class Exception extends RuntimeException implements \PHPUnit\Exception
{
}
SECURITY.md 0000644 00000004371 15243426620 0006346 0 ustar 00 # Security Policy
If you believe you have found a security vulnerability in PHPUnit, please report it to us through coordinated disclosure.
**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**
Instead, please email `sebastian@phpunit.de`.
Please include as much of the information listed below as you can to help us better understand and resolve the issue:
* The type of issue
* Full paths of source file(s) related to the manifestation of the issue
* The location of the affected source code (tag/branch/commit or direct URL)
* Any special configuration required to reproduce the issue
* Step-by-step instructions to reproduce the issue
* Proof-of-concept or exploit code (if possible)
* Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
## Web Context
PHPUnit is a framework for writing as well as a command-line tool for running tests. Writing and running tests is a development-time activity. There is no reason why PHPUnit should be installed on a webserver and/or in a production environment.
**If you upload PHPUnit to a webserver then your deployment process is broken. On a more general note, if your `vendor` directory is publicly accessible on your webserver then your deployment process is also broken.**
Please note that if you upload PHPUnit to a webserver "bad things" may happen. [You have been warned.](https://thephp.cc/articles/phpunit-a-security-risk?ref=phpunit)
PHPUnit is developed with a focus on development environments and the command-line. No specific testing or hardening with regard to using PHPUnit in an HTTP or web context or with untrusted input data is performed. PHPUnit might also contain functionality that intentionally exposes internal application data for debugging purposes.
If PHPUnit is used in a web application, the application developer is responsible for filtering inputs or escaping outputs as necessary and for verifying that the used functionality is safe for use within the intended context.
Vulnerabilities specific to the use outside a development context will be fixed as applicable, provided that the fix does not have an averse effect on the primary use case for development purposes.
schema/9.1.xsd 0000644 00000041325 15243426620 0007044 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="35"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="70"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
schema/9.3.xsd 0000644 00000042674 15243426620 0007056 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.3 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/10.0.xsd 0000644 00000036404 15243426620 0007115 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/9.2.xsd 0000644 00000041334 15243426620 0007045 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.2 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="50"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="90"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
schema/9.5.xsd 0000644 00000043104 15243426620 0007045 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="false"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/10.4.xsd 0000644 00000043107 15243426620 0007117 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.4 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="baseline" type="xs:anyURI"/>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/8.5.xsd 0000644 00000041323 15243426620 0007045 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 8.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="json"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="tap"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="50"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="90"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="false"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
schema/9.4.xsd 0000644 00000043012 15243426620 0007042 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.4 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="processUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\DefaultResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxXml" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="logToFileType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/10.2.xsd 0000644 00000042521 15243426620 0007114 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.2 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/9.0.xsd 0000644 00000041064 15243426620 0007043 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 9.0 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="filtersType">
<xs:sequence>
<xs:element name="whitelist" type="whiteListType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="filterType">
<xs:sequence>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:group ref="pathGroup"/>
<xs:element name="exclude">
<xs:complexType>
<xs:group ref="pathGroup"/>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="whiteListType">
<xs:complexContent>
<xs:extension base="filterType">
<xs:attribute name="addUncoveredFilesFromWhitelist" default="true" type="xs:boolean"/>
<xs:attribute name="processUncoveredFilesFromWhitelist" default="false" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="extension" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="listenersType">
<xs:sequence>
<xs:element name="listener" type="objectType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="objectType">
<xs:sequence>
<xs:element name="arguments" minOccurs="0">
<xs:complexType>
<xs:group ref="argumentsGroup"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
<xs:attribute name="file" type="xs:anyURI"/>
</xs:complexType>
<xs:complexType name="arrayType">
<xs:sequence>
<xs:element name="element" type="argumentType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="argumentType">
<xs:group ref="argumentChoice"/>
<xs:attribute name="key" use="required"/>
</xs:complexType>
<xs:group name="argumentsGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="array" type="arrayType" />
<xs:element name="integer" type="xs:integer" />
<xs:element name="string" type="xs:string" />
<xs:element name="double" type="xs:double" />
<xs:element name="null" />
<xs:element name="object" type="objectType" />
<xs:element name="file" type="xs:anyURI" />
<xs:element name="directory" type="xs:anyURI" />
<xs:element name="boolean" type="xs:boolean" />
</xs:choice>
</xs:sequence>
</xs:group>
<xs:group name="argumentChoice">
<xs:choice>
<xs:element name="array" type="arrayType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="integer" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="string" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="double" type="xs:double" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="null" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="object" type="objectType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="file" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="directory" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="boolean" type="xs:boolean" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:group>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:complexType name="loggersType">
<xs:sequence>
<xs:element name="log" type="loggerType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="loggerType">
<xs:attribute name="type">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="coverage-html"/>
<xs:enumeration value="coverage-text"/>
<xs:enumeration value="coverage-clover"/>
<xs:enumeration value="coverage-crap4j"/>
<xs:enumeration value="coverage-xml"/>
<xs:enumeration value="coverage-php"/>
<xs:enumeration value="plain"/>
<xs:enumeration value="teamcity"/>
<xs:enumeration value="junit"/>
<xs:enumeration value="testdox-html"/>
<xs:enumeration value="testdox-text"/>
<xs:enumeration value="testdox-xml"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="target" type="xs:anyURI"/>
<xs:attribute name="lowUpperBound" type="xs:nonNegativeInteger" default="35"/>
<xs:attribute name="highLowerBound" type="xs:nonNegativeInteger" default="70"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
<xs:attribute name="threshold" type="xs:nonNegativeInteger" default="30"/>
</xs:complexType>
<xs:group name="pathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="directoryFilterType"/>
<xs:element name="file" type="fileFilterType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="directoryFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="fileFilterType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticAttributes" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="cacheTokens" type="xs:boolean" default="false"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="convertDeprecationsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertErrorsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertNoticesToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="convertWarningsToExceptions" type="xs:boolean" default="true"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
<xs:attribute name="forceCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="printerClass" type="xs:string" default="PHPUnit\TextUI\ResultPrinter"/>
<xs:attribute name="printerFile" type="xs:anyURI"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutResourceUsageDuringSmallTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoversAnnotation" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreDeprecatedCodeUnitsFromCodeCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="testSuiteLoaderClass" type="xs:string" default="PHPUnit\Runner\StandardTestSuiteLoader"/>
<xs:attribute name="testSuiteLoaderFile" type="xs:anyURI"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="verbose" type="xs:boolean" default="false"/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:string"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="noInteraction" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="testdoxGroups" type="groupsType" minOccurs="0"/>
<xs:element name="filter" type="filtersType" minOccurs="0"/>
<xs:element name="logging" type="loggersType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="listeners" type="listenersType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:group ref="pathGroup"/>
<xs:element name="exclude" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
schema/10.3.xsd 0000644 00000043016 15243426620 0007115 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.3 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
schema/10.1.xsd 0000644 00000041253 15243426620 0007114 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.1 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
phpunit 0000755 00000005325 15243426620 0006172 0 ustar 00 #!/usr/bin/env php
<?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (!version_compare(PHP_VERSION, PHP_VERSION, '=')) {
fwrite(
STDERR,
sprintf(
'%s declares an invalid value for PHP_VERSION.' . PHP_EOL .
'This breaks fundamental functionality such as version_compare().' . PHP_EOL .
'Please use a different PHP interpreter.' . PHP_EOL,
PHP_BINARY
)
);
die(1);
}
if (version_compare('8.1.0', PHP_VERSION, '>')) {
fwrite(
STDERR,
sprintf(
'This version of PHPUnit requires PHP >= 8.1.' . PHP_EOL .
'You are using PHP %s (%s).' . PHP_EOL,
PHP_VERSION,
PHP_BINARY
)
);
die(1);
}
if (!ini_get('date.timezone')) {
ini_set('date.timezone', 'UTC');
}
if (isset($GLOBALS['_composer_autoload_path'])) {
define('PHPUNIT_COMPOSER_INSTALL', $GLOBALS['_composer_autoload_path']);
unset($GLOBALS['_composer_autoload_path']);
} else {
foreach (array(__DIR__ . '/../../autoload.php', __DIR__ . '/../vendor/autoload.php', __DIR__ . '/vendor/autoload.php') as $file) {
if (file_exists($file)) {
define('PHPUNIT_COMPOSER_INSTALL', $file);
break;
}
}
unset($file);
}
if (!defined('PHPUNIT_COMPOSER_INSTALL')) {
fwrite(
STDERR,
'You need to set up the project dependencies using Composer:' . PHP_EOL . PHP_EOL .
' composer install' . PHP_EOL . PHP_EOL .
'You can learn all about Composer on https://getcomposer.org/.' . PHP_EOL
);
die(1);
}
require PHPUNIT_COMPOSER_INSTALL;
$requiredExtensions = ['dom', 'json', 'libxml', 'mbstring', 'tokenizer', 'xml', 'xmlwriter'];
$unavailableExtensions = array_filter(
$requiredExtensions,
static function ($extension) {
return !extension_loaded($extension);
}
);
// Workaround for https://github.com/sebastianbergmann/phpunit/issues/5662
if (!function_exists('ctype_alnum')) {
$unavailableExtensions[] = 'ctype';
}
if ([] !== $unavailableExtensions) {
fwrite(
STDERR,
sprintf(
'PHPUnit requires the "%s" extensions, but the "%s" %s not available.' . PHP_EOL,
implode('", "', $requiredExtensions),
implode('", "', $unavailableExtensions),
count($unavailableExtensions) === 1 ? 'extension is' : 'extensions are'
)
);
die(1);
}
unset($requiredExtensions, $unavailableExtensions);
exit((new PHPUnit\TextUI\Application)->run($_SERVER['argv']));
phpunit.xsd 0000644 00000043107 15243426620 0006764 0 ustar 00 <?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation source="https://phpunit.de/documentation.html">
This Schema file defines the rules by which the XML configuration file of PHPUnit 10.5 may be structured.
</xs:documentation>
<xs:appinfo source="https://phpunit.de/documentation.html"/>
</xs:annotation>
<xs:element name="phpunit" type="phpUnitType">
<xs:annotation>
<xs:documentation>Root Element</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="sourceType">
<xs:all>
<xs:element name="include" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
<xs:element name="exclude" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="sourcePathGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="baseline" type="xs:anyURI"/>
<xs:attribute name="restrictDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="restrictNotices" type="xs:boolean" default="false"/>
<xs:attribute name="restrictWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfErrors" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpNotices" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfWarnings" type="xs:boolean" default="false"/>
<xs:attribute name="ignoreSuppressionOfPhpWarnings" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:group name="sourcePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="sourceDirectoryType"/>
<xs:element name="file" type="xs:anyURI"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="sourceDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default=".php"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="coverageType">
<xs:all>
<xs:element name="report" minOccurs="0" maxOccurs="1">
<xs:complexType>
<xs:group ref="coverageReportGroup"/>
</xs:complexType>
</xs:element>
</xs:all>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="pathCoverage" type="xs:boolean" default="false"/>
<xs:attribute name="includeUncoveredFiles" type="xs:boolean" default="true"/>
<xs:attribute name="ignoreDeprecatedCodeUnits" type="xs:boolean" default="false"/>
<xs:attribute name="disableCodeCoverageIgnore" type="xs:boolean" default="false"/>
</xs:complexType>
<xs:complexType name="loggingType">
<xs:group ref="loggingGroup"/>
</xs:complexType>
<xs:complexType name="groupsType">
<xs:choice>
<xs:sequence>
<xs:element name="include" type="groupType"/>
<xs:element name="exclude" type="groupType" minOccurs="0"/>
</xs:sequence>
<xs:sequence>
<xs:element name="exclude" type="groupType"/>
</xs:sequence>
</xs:choice>
</xs:complexType>
<xs:complexType name="groupType">
<xs:sequence>
<xs:element name="group" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="extensionsType">
<xs:sequence>
<xs:element name="bootstrap" type="bootstrapType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="bootstrapType">
<xs:sequence>
<xs:element name="parameter" type="parameterType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="class" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="parameterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name="columnsType">
<xs:union>
<xs:simpleType>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="max"/>
</xs:restriction>
</xs:simpleType>
</xs:union>
</xs:simpleType>
<xs:simpleType name="executionOrderType">
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="defects"/>
<xs:enumeration value="depends"/>
<xs:enumeration value="depends,defects"/>
<xs:enumeration value="depends,duration"/>
<xs:enumeration value="depends,random"/>
<xs:enumeration value="depends,reverse"/>
<xs:enumeration value="depends,size"/>
<xs:enumeration value="duration"/>
<xs:enumeration value="no-depends"/>
<xs:enumeration value="no-depends,defects"/>
<xs:enumeration value="no-depends,duration"/>
<xs:enumeration value="no-depends,random"/>
<xs:enumeration value="no-depends,reverse"/>
<xs:enumeration value="no-depends,size"/>
<xs:enumeration value="random"/>
<xs:enumeration value="reverse"/>
<xs:enumeration value="size"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="phpType">
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="includePath" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ini" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="const" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="var" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="env" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="post" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="get" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="cookie" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="server" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="files" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="request" type="namedValueType" minOccurs="0" maxOccurs="unbounded"/>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="namedValueType">
<xs:attribute name="name" use="required" type="xs:string"/>
<xs:attribute name="value" use="required" type="xs:anySimpleType"/>
<xs:attribute name="verbatim" use="optional" type="xs:boolean"/>
<xs:attribute name="force" use="optional" type="xs:boolean"/>
</xs:complexType>
<xs:complexType name="phpUnitType">
<xs:annotation>
<xs:documentation>The main type specifying the document structure</xs:documentation>
</xs:annotation>
<xs:group ref="configGroup"/>
<xs:attributeGroup ref="configAttributeGroup"/>
</xs:complexType>
<xs:attributeGroup name="configAttributeGroup">
<xs:attribute name="backupGlobals" type="xs:boolean" default="false"/>
<xs:attribute name="backupStaticProperties" type="xs:boolean" default="false"/>
<xs:attribute name="bootstrap" type="xs:anyURI"/>
<xs:attribute name="cacheDirectory" type="xs:anyURI"/>
<xs:attribute name="cacheResult" type="xs:boolean" default="true"/>
<xs:attribute name="cacheResultFile" type="xs:anyURI"/>
<xs:attribute name="colors" type="xs:boolean" default="false"/>
<xs:attribute name="columns" type="columnsType" default="80"/>
<xs:attribute name="controlGarbageCollector" type="xs:boolean" default="false"/>
<xs:attribute name="numberOfTestsBeforeGarbageCollection" type="xs:integer" default="100"/>
<xs:attribute name="requireCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="processIsolation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="failOnEmptyTestSuite" type="xs:boolean" default="false"/>
<xs:attribute name="failOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="failOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="failOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="failOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="failOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDefect" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnDeprecation" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnError" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnFailure" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnIncomplete" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnNotice" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnRisky" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnSkipped" type="xs:boolean" default="false"/>
<xs:attribute name="stopOnWarning" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutChangesToGlobalState" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutOutputDuringTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutTestsThatDoNotTestAnything" type="xs:boolean" default="true"/>
<xs:attribute name="beStrictAboutTodoAnnotatedTests" type="xs:boolean" default="false"/>
<xs:attribute name="beStrictAboutCoverageMetadata" type="xs:boolean" default="false"/>
<xs:attribute name="defaultTimeLimit" type="xs:integer" default="0"/>
<xs:attribute name="enforceTimeLimit" type="xs:boolean" default="false"/>
<xs:attribute name="timeoutForSmallTests" type="xs:integer" default="1"/>
<xs:attribute name="timeoutForMediumTests" type="xs:integer" default="10"/>
<xs:attribute name="timeoutForLargeTests" type="xs:integer" default="60"/>
<xs:attribute name="defaultTestSuite" type="xs:string" default=""/>
<xs:attribute name="testdox" type="xs:boolean" default="false"/>
<xs:attribute name="stderr" type="xs:boolean" default="false"/>
<xs:attribute name="reverseDefectList" type="xs:boolean" default="false"/>
<xs:attribute name="registerMockObjectsFromTestArgumentsRecursively" type="xs:boolean" default="false"/>
<xs:attribute name="extensionsDirectory" type="xs:anyURI"/>
<xs:attribute name="executionOrder" type="executionOrderType" default="default"/>
<xs:attribute name="resolveDependencies" type="xs:boolean" default="true"/>
<xs:attribute name="displayDetailsOnIncompleteTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnSkippedTests" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerDeprecations" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerErrors" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerNotices" type="xs:boolean" default="false"/>
<xs:attribute name="displayDetailsOnTestsThatTriggerWarnings" type="xs:boolean" default="false"/>
</xs:attributeGroup>
<xs:group name="configGroup">
<xs:all>
<xs:element ref="testSuiteFacet" minOccurs="0"/>
<xs:element name="groups" type="groupsType" minOccurs="0"/>
<xs:element name="source" type="sourceType" minOccurs="0"/>
<xs:element name="coverage" type="coverageType" minOccurs="0"/>
<xs:element name="logging" type="loggingType" minOccurs="0"/>
<xs:element name="extensions" type="extensionsType" minOccurs="0"/>
<xs:element name="php" type="phpType" minOccurs="0"/>
</xs:all>
</xs:group>
<xs:element name="testSuiteFacet" abstract="true"/>
<xs:element name="testsuite" type="testSuiteType" substitutionGroup="testSuiteFacet"/>
<xs:element name="testsuites" type="testSuitesType" substitutionGroup="testSuiteFacet"/>
<xs:complexType name="testSuitesType">
<xs:sequence>
<xs:element name="testsuite" type="testSuiteType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="testSuiteType">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:group ref="testSuitePathGroup"/>
<xs:element name="exclude" type="xs:string"/>
</xs:choice>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:group name="testSuitePathGroup">
<xs:sequence>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="directory" type="testSuiteDirectoryType"/>
<xs:element name="file" type="testSuiteFileType"/>
</xs:choice>
</xs:sequence>
</xs:group>
<xs:complexType name="testSuiteDirectoryType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="prefix" default=""/>
<xs:attribute type="xs:string" name="suffix" default="Test.php"/>
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="testSuiteFileType">
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attributeGroup ref="phpVersionGroup"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:attributeGroup name="phpVersionGroup">
<xs:attribute name="phpVersion" type="xs:string" default="5.3.0"/>
<xs:attribute name="phpVersionOperator" type="xs:string" default=">="/>
</xs:attributeGroup>
<xs:group name="coverageReportGroup">
<xs:all>
<xs:element name="clover" type="logToFileType" minOccurs="0"/>
<xs:element name="cobertura" type="logToFileType" minOccurs="0"/>
<xs:element name="crap4j" type="coverageReportCrap4JType" minOccurs="0" />
<xs:element name="html" type="coverageReportHtmlType" minOccurs="0" />
<xs:element name="php" type="logToFileType" minOccurs="0" />
<xs:element name="text" type="coverageReportTextType" minOccurs="0" />
<xs:element name="xml" type="logToDirectoryType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:group name="loggingGroup">
<xs:all>
<xs:element name="junit" type="logToFileType" minOccurs="0" />
<xs:element name="teamcity" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxHtml" type="logToFileType" minOccurs="0" />
<xs:element name="testdoxText" type="logToFileType" minOccurs="0" />
</xs:all>
</xs:group>
<xs:complexType name="logToFileType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="logToDirectoryType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
</xs:complexType>
<xs:complexType name="coverageReportCrap4JType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="threshold" type="xs:integer"/>
</xs:complexType>
<xs:complexType name="coverageReportHtmlType">
<xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
<xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
<xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
<xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
<xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
<xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
<xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
<xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
<xs:attribute name="customCssFile" type="xs:string"/>
</xs:complexType>
<xs:complexType name="coverageReportTextType">
<xs:attribute name="outputFile" type="xs:anyURI" use="required"/>
<xs:attribute name="showUncoveredFiles" type="xs:boolean" default="false"/>
<xs:attribute name="showOnlySummary" type="xs:boolean" default="false"/>
</xs:complexType>
</xs:schema>
composer.json 0000644 00000004773 15243426620 0007305 0 ustar 00 {
"name": "phpunit/phpunit",
"description": "The PHP Unit Testing framework.",
"type": "library",
"keywords": [
"phpunit",
"xunit",
"testing"
],
"homepage": "https://phpunit.de/",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/phpunit/issues",
"security": "https://github.com/sebastianbergmann/phpunit/security/policy"
},
"prefer-stable": true,
"require": {
"php": ">=8.1",
"ext-dom": "*",
"ext-json": "*",
"ext-libxml": "*",
"ext-mbstring": "*",
"ext-xml": "*",
"ext-xmlwriter": "*",
"myclabs/deep-copy": "^1.10.1",
"phar-io/manifest": "^2.0.3",
"phar-io/version": "^3.0.2",
"phpunit/php-code-coverage": "^10.1.5",
"phpunit/php-file-iterator": "^4.0",
"phpunit/php-invoker": "^4.0",
"phpunit/php-text-template": "^3.0",
"phpunit/php-timer": "^6.0",
"sebastian/cli-parser": "^2.0",
"sebastian/code-unit": "^2.0",
"sebastian/comparator": "^5.0",
"sebastian/diff": "^5.0",
"sebastian/environment": "^6.0",
"sebastian/exporter": "^5.1",
"sebastian/global-state": "^6.0.1",
"sebastian/object-enumerator": "^5.0",
"sebastian/recursion-context": "^5.0",
"sebastian/type": "^4.0",
"sebastian/version": "^4.0"
},
"config": {
"platform": {
"php": "8.1.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"suggest": {
"ext-soap": "To be able to generate mocks based on WSDL files"
},
"bin": [
"phpunit"
],
"autoload": {
"classmap": [
"src/"
],
"files": [
"src/Framework/Assert/Functions.php"
]
},
"autoload-dev": {
"classmap": [
"tests/"
],
"files": [
"tests/_files/CoverageNamespacedFunctionTest.php",
"tests/_files/CoveredFunction.php",
"tests/_files/Generator.php",
"tests/_files/NamespaceCoveredFunction.php",
"tests/end-to-end/code-coverage/ignore-function-using-attribute/src/CoveredFunction.php"
]
},
"extra": {
"branch-alias": {
"dev-main": "10.5-dev"
}
}
}
DEPRECATIONS.md 0000644 00000032650 15243426620 0006760 0 ustar 00 # Deprecations
## Soft Deprecations
This functionality is currently [soft-deprecated](https://phpunit.de/backward-compatibility.html#soft-deprecation):
### Writing Tests
#### Assertions, Constraints, and Expectations
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|------------------------------------------------|--------|-------------|
| [#5472](https://github.com/sebastianbergmann/phpunit/issues/5472) | `TestCase::assertStringNotMatchesFormat()` | 10.4.0 | |
| [#5472](https://github.com/sebastianbergmann/phpunit/issues/5472) | `TestCase::assertStringNotMatchesFormatFile()` | 10.4.0 | |
#### Test Double API
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|---------------------------------------------------|--------|-----------------------------------------------------------------------------------------|
| [#5240](https://github.com/sebastianbergmann/phpunit/issues/5240) | `TestCase::createTestProxy()` | 10.1.0 | |
| [#5241](https://github.com/sebastianbergmann/phpunit/issues/5241) | `TestCase::getMockForAbstractClass()` | 10.1.0 | |
| [#5242](https://github.com/sebastianbergmann/phpunit/issues/5242) | `TestCase::getMockFromWsdl()` | 10.1.0 | |
| [#5243](https://github.com/sebastianbergmann/phpunit/issues/5243) | `TestCase::getMockForTrait()` | 10.1.0 | |
| [#5244](https://github.com/sebastianbergmann/phpunit/issues/5244) | `TestCase::getObjectForTrait()` | 10.1.0 | |
| [#5305](https://github.com/sebastianbergmann/phpunit/issues/5305) | `MockBuilder::getMockForAbstractClass()` | 10.1.0 | |
| [#5306](https://github.com/sebastianbergmann/phpunit/issues/5306) | `MockBuilder::getMockForTrait()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::disableProxyingToOriginalMethods()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::enableProxyingToOriginalMethods()` | 10.1.0 | |
| [#5307](https://github.com/sebastianbergmann/phpunit/issues/5307) | `MockBuilder::setProxyTarget()` | 10.1.0 | |
| [#5308](https://github.com/sebastianbergmann/phpunit/issues/5308) | `MockBuilder::allowMockingUnknownTypes()` | 10.1.0 | |
| [#5308](https://github.com/sebastianbergmann/phpunit/issues/5308) | `MockBuilder::disallowMockingUnknownTypes()` | 10.1.0 | |
| [#5309](https://github.com/sebastianbergmann/phpunit/issues/5309) | `MockBuilder::disableAutoload()` | 10.1.0 | |
| [#5309](https://github.com/sebastianbergmann/phpunit/issues/5309) | `MockBuilder::enableAutoload()` | 10.1.0 | |
| [#5315](https://github.com/sebastianbergmann/phpunit/issues/5315) | `MockBuilder::disableArgumentCloning()` | 10.1.0 | |
| [#5315](https://github.com/sebastianbergmann/phpunit/issues/5315) | `MockBuilder::enableArgumentCloning()` | 10.1.0 | |
| [#5320](https://github.com/sebastianbergmann/phpunit/issues/5320) | `MockBuilder::addMethods()` | 10.1.0 | |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::onConsecutiveCalls()` | 10.3.0 | Use `$double->willReturn()` instead of `$double->will($this->onConsecutiveCalls())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnArgument()` | 10.3.0 | Use `$double->willReturnArgument()` instead of `$double->will($this->returnArgument())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnCallback()` | 10.3.0 | Use `$double->willReturnCallback()` instead of `$double->will($this->returnCallback())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnSelf()` | 10.3.0 | Use `$double->willReturnSelf()` instead of `$double->will($this->returnSelf())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnValue()` | 10.3.0 | Use `$double->willReturn()` instead of `$double->will($this->returnValue())` |
| [#5423](https://github.com/sebastianbergmann/phpunit/issues/5423) | `TestCase::returnValueMap()` | 10.3.0 | Use `$double->willReturnMap()` instead of `$double->will($this->returnValueMap())` |
#### Miscellaneous
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|----------------------------------------------------------------|--------|--------------------------------------------------------------------|
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5236) | `PHPUnit\Framework\Attributes\CodeCoverageIgnore()` | 10.1.0 | |
| [#5214](https://github.com/sebastianbergmann/phpunit/issues/5214) | `TestCase::iniSet()` | 10.3.0 | |
| [#5216](https://github.com/sebastianbergmann/phpunit/issues/5216) | `TestCase::setLocale()` | 10.3.0 | |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreClassForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the class' doc-comment |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreMethodForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the method's doc-comment |
| [#5236](https://github.com/sebastianbergmann/phpunit/issues/5513) | `PHPUnit\Framework\Attributes\IgnoreFunctionForCodeCoverage()` | 10.4.0 | Use `@codeCoverageIgnore` annotation in the function's doc-comment |
### Running Tests
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|--------|-------------|
| [#5481](https://github.com/sebastianbergmann/phpunit/issues/5481) | `dataSet` attribute for `testCaseMethod` elements in the XML document generated by `--list-tests-xml` | 10.4.0 | |
### Extending PHPUnit
| Issue | Description | Since | Replacement |
|-------|------------------------------------------------------------------------------------------------------------------------------|--------|--------------------------------------------------------------------------------|
| | `PHPUnit\TextUI\Configuration\Configuration::coverageExcludeDirectories()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->excludeDirectories()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageExcludeFiles()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->excludeFiles()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageIncludeDirectories()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->includeDirectories()` |
| | `PHPUnit\TextUI\Configuration\Configuration::coverageIncludeFiles()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->includeFiles()` |
| | `PHPUnit\TextUI\Configuration\Configuration::loadPharExtensions()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::noExtensions()` |
| | `PHPUnit\TextUI\Configuration\Configuration::hasNonEmptyListOfFilesToBeIncludedInCodeCoverageReport()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->notEmpty()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictDeprecations()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictDeprecations()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictNotices()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictNotices()` |
| | `PHPUnit\TextUI\Configuration\Configuration::restrictWarnings()` | 10.2.0 | `PHPUnit\TextUI\Configuration\Configuration::source()->restrictWarnings()` |
| | `PHPUnit\TextUI\Configuration\Configuration::cliArgument()` | 10.4.0 | `PHPUnit\TextUI\Configuration\Configuration::cliArguments()[0]` |
| | `PHPUnit\TextUI\Configuration\Configuration::hasCliArgument()` | 10.4.0 | `PHPUnit\TextUI\Configuration\Configuration::hasCliArguments()` |
| | `PHPUnit\Framework\Constraint\Constraint::exporter()` | 10.4.0 | |
| | `PHPUnit\TextUI\Configuration\Configuration::registerMockObjectsFromTestArgumentsRecursively()` | 10.5.3 | |
| | `Test\AssertionFailed` and `Test\AssertionSucceeded` events | 10.5.3 | |
| | `PHPUnit\Runner\Extension\Facade::requireExportOfObjects()` and `PHPUnit\Runner\Extension\Facade::requiresExportOfObjects()` | 10.5.3 | |
## Hard Deprecations
This functionality is currently [hard-deprecated](https://phpunit.de/backward-compatibility.html#hard-deprecation):
### Writing Tests
#### Miscellaneous
| Issue | Description | Since | Replacement |
|-------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|---------|-------------|
| [#5100](https://github.com/sebastianbergmann/phpunit/issues/5100) | Support for non-static data provider methods, non-public data provider methods, and data provider methods that declare parameters | 10.0.0 | |
| [#5812](https://github.com/sebastianbergmann/phpunit/pull/5812) | Support for string array keys in data sets returned by data provider methods that do not match the parameter names of the test method(s) that use(s) them | 10.5.18 | |
.phpstorm.meta.php 0000644 00000001375 15243426620 0010146 0 ustar 00 <?php
namespace PHPSTORM_META {
override(
\PHPUnit\Framework\TestCase::createStub(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createConfiguredStub(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createConfiguredMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createPartialMock(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::createTestProxy(0),
map([""=>"$0"])
);
override(
\PHPUnit\Framework\TestCase::getMockForAbstractClass(0),
map([""=>"$0"])
);
}
README.md 0000644 00000003761 15243426620 0006036 0 ustar 00 # PHPUnit
[](https://packagist.org/packages/phpunit/phpunit)
[](https://github.com/sebastianbergmann/phpunit/actions)
[](https://shepherd.dev/github/sebastianbergmann/phpunit)
[](https://codecov.io/gh/sebastianbergmann/phpunit)
PHPUnit is a programmer-oriented testing framework for PHP. It is an instance of the xUnit architecture for unit testing frameworks.
## Installation
We distribute a [PHP Archive (PHAR)](https://php.net/phar) that has all required (as well as some optional) dependencies of PHPUnit bundled in a single file:
```bash
$ wget https://phar.phpunit.de/phpunit-X.Y.phar
$ php phpunit-X.Y.phar --version
```
Please replace `X.Y` with the version of PHPUnit you are interested in.
Alternatively, you may use [Composer](https://getcomposer.org/) to download and install PHPUnit as well as its dependencies. Please refer to the [documentation](https://phpunit.de/documentation.html) for details on how to install PHPUnit.
## Contribute
Please refer to [CONTRIBUTING.md](https://github.com/sebastianbergmann/phpunit/blob/main/.github/CONTRIBUTING.md) for information on how to contribute to PHPUnit and its related projects.
## List of Contributors
Thanks to everyone who has contributed to PHPUnit! You can find a detailed list of contributors on every PHPUnit related package on GitHub. This list shows only the major components:
* [PHPUnit](https://github.com/sebastianbergmann/phpunit/graphs/contributors)
* [php-code-coverage](https://github.com/sebastianbergmann/php-code-coverage/graphs/contributors)
A very special thanks to everyone who has contributed to the [documentation](https://github.com/sebastianbergmann/phpunit-documentation-english/graphs/contributors).
ChangeLog-10.5.md 0000644 00000027161 15243426620 0007311 0 ustar 00 # Changes in PHPUnit 10.5
All notable changes of the PHPUnit 10.5 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
## [10.5.20] - 2024-04-24
* [#5771](https://github.com/sebastianbergmann/phpunit/issues/5771): JUnit XML logger may crash when test that is run in separate process exits unexpectedly
* [#5819](https://github.com/sebastianbergmann/phpunit/issues/5819): Duplicate keys from different data providers are not handled properly
## [10.5.19] - 2024-04-17
### Fixed
* [#5818](https://github.com/sebastianbergmann/phpunit/issues/5818): Calling `method()` on a test stub created using `createStubForIntersectionOfInterfaces()` throws an unexpected exception
## [10.5.18] - 2024-04-14
### Deprecated
* [#5812](https://github.com/sebastianbergmann/phpunit/pull/5812): Support for string array keys in data sets returned by data provider methods that do not match the parameter names of the test method(s) that use(s) them
### Fixed
* [#5795](https://github.com/sebastianbergmann/phpunit/issues/5795): Using `@testWith` annotation may generate `PHP Warning: Uninitialized string offset 0`
## [10.5.17] - 2024-04-05
### Changed
* The namespaces of dependencies are now prefixed with `PHPUnitPHAR` instead of just `PHPUnit` for the PHAR distribution of PHPUnit
## [10.5.16] - 2024-03-28
### Changed
* [#5766](https://github.com/sebastianbergmann/phpunit/pull/5766): Do not use a shell in `proc_open()` if not really needed
* [#5772](https://github.com/sebastianbergmann/phpunit/pull/5772): Cleanup process handling after dropping temp-file handling
### Fixed
* [#5570](https://github.com/sebastianbergmann/phpunit/pull/5570): Windows does not support exclusive locks on stdout
## [10.5.15] - 2024-03-22
### Fixed
* [#5765](https://github.com/sebastianbergmann/phpunit/pull/5765): Be more forgiving with error handlers that do not respect error suppression
## [10.5.14] - 2024-03-21
### Changed
* [#5747](https://github.com/sebastianbergmann/phpunit/pull/5747): Cache result of `Groups::groups()`
* [#5748](https://github.com/sebastianbergmann/phpunit/pull/5748): Improve performance of `NamePrettifier::prettifyTestMethodName()`
* [#5750](https://github.com/sebastianbergmann/phpunit/pull/5750): Micro-optimize `NamePrettifier::prettifyTestMethodName()` once again
### Fixed
* [#5760](https://github.com/sebastianbergmann/phpunit/issues/5760): TestDox printer does not display details about exceptions raised in before-test methods
## [10.5.13] - 2024-03-12
### Changed
* [#5727](https://github.com/sebastianbergmann/phpunit/pull/5727): Prevent duplicate call of `NamePrettifier::prettifyTestMethodName()`
* [#5739](https://github.com/sebastianbergmann/phpunit/pull/5739): Micro-optimize `NamePrettifier::prettifyTestMethodName()`
* [#5740](https://github.com/sebastianbergmann/phpunit/pull/5740): Micro-optimize `TestRunner::runTestWithTimeout()`
* [#5741](https://github.com/sebastianbergmann/phpunit/pull/5741): Save call to `Telemetry\System::snapshot()`
* [#5742](https://github.com/sebastianbergmann/phpunit/pull/5742): Prevent file IO when not strictly necessary
* [#5743](https://github.com/sebastianbergmann/phpunit/pull/5743): Prevent unnecessary `ExecutionOrderDependency::getTarget()` call
* [#5744](https://github.com/sebastianbergmann/phpunit/pull/5744): Simplify `NamePrettifier::prettifyTestMethodName()`
### Fixed
* [#5351](https://github.com/sebastianbergmann/phpunit/issues/5351): Incorrect code coverage metadata does not prevent code coverage data from being collected
* [#5746](https://github.com/sebastianbergmann/phpunit/issues/5746): Using `-d` CLI option multiple times triggers warning
## [10.5.12] - 2024-03-09
### Fixed
* [#5652](https://github.com/sebastianbergmann/phpunit/issues/5652): `HRTime::duration()` throws `InvalidArgumentException`
## [10.5.11] - 2024-02-25
### Fixed
* [#5704](https://github.com/sebastianbergmann/phpunit/issues/5704#issuecomment-1951105254): No warning when CLI options are used multiple times
* [#5707](https://github.com/sebastianbergmann/phpunit/issues/5707): `--fail-on-empty-test-suite` CLI option is not documented in `--help` output
* No warning when the `#[CoversClass]` and `#[UsesClass]` attributes are used with the name of an interface
* Resource usage information is printed when the `--debug` CLI option is used
## [10.5.10] - 2024-02-04
### Changed
* Improve output of `--check-version` CLI option
* Improve description of `--check-version` CLI option
### Fixed
* [#5692](https://github.com/sebastianbergmann/phpunit/issues/5692): `--log-events-text` and `--log-events-verbose-text` require the destination file to exit
## [10.5.9] - 2024-01-22
### Changed
* Show help for `--manifest`, `--sbom`, and `--composer-lock` when the PHAR is used
### Fixed
* [#5676](https://github.com/sebastianbergmann/phpunit/issues/5676): PHPUnit's test runner overwrites custom error handler registered using `set_error_handler()` in bootstrap script
## [10.5.8] - 2024-01-19
### Fixed
* [#5673](https://github.com/sebastianbergmann/phpunit/issues/5673): Confusing error message when migration of a configuration is requested that does not need to be migrated
## [10.5.7] - 2024-01-14
### Fixed
* [#5662](https://github.com/sebastianbergmann/phpunit/issues/5662): PHPUnit errors out on startup when the `ctype` extension is not loaded but a polyfill for it was installed
## [10.5.6] - 2024-01-13
### Added
* Added the `--debug` CLI option as an alias for `--no-output --log-events-text php://stdout`
### Fixed
* [#5455](https://github.com/sebastianbergmann/phpunit/issues/5455): `willReturnCallback()` does not pass unknown named variadic arguments to callback
* [#5488](https://github.com/sebastianbergmann/phpunit/issues/5488): Details about tests that are considered risky are not displayed when the TestDox result printer is used
* [#5516](https://github.com/sebastianbergmann/phpunit/issues/5516): Assertions that use the `LogicalNot` constraint (`assertNotEquals()`, `assertStringNotContainsString()`, ...) can generate confusing failure messages
* [#5518](https://github.com/sebastianbergmann/phpunit/issues/5518): Details about deprecations, notices, and warnings are not displayed when the TestDox result printer is used
* [#5574](https://github.com/sebastianbergmann/phpunit/issues/5574): Wrong backtrace line is reported
* [#5633](https://github.com/sebastianbergmann/phpunit/pull/5633): `--log-events-text` and `--log-events-verbose-text` CLI options do not handle absolute and relative paths
* [#5634](https://github.com/sebastianbergmann/phpunit/pull/5634): Exceptions in the destructor of a test double are ignored
* [#5641](https://github.com/sebastianbergmann/phpunit/issues/5641): The `TestSuite` value object returned by `TestSuite\Filtered::testSuite()` contains all tests instead of only the filtered tests
## [10.5.5] - 2023-12-27
### Fixed
* [#5619](https://github.com/sebastianbergmann/phpunit/pull/5619): Reverted change introduced in PHPUnit 10.5.4 that broke backward compatibility
## [10.5.4] - 2023-12-27
### Fixed
* [#5592](https://github.com/sebastianbergmann/phpunit/issues/5592): Error Handler prevents `error_get_last()` usage in tests
* [#5592](https://github.com/sebastianbergmann/phpunit/issues/5592): `E_USER_ERROR` does not abort test execution
* [#5612](https://github.com/sebastianbergmann/phpunit/issues/5612): Empty `<coverage>` element in XML configuration after migrating configuration
* [#5616](https://github.com/sebastianbergmann/phpunit/issues/5616): Values from data provider are not shown for failed test
* [#5619](https://github.com/sebastianbergmann/phpunit/pull/5619): Check and restore error/exception global handlers
* [#5621](https://github.com/sebastianbergmann/phpunit/issues/5621): Name of data set is missing from TeamCity output
## [10.5.3] - 2023-12-13
### Changed
* Make PHAR build reproducible (the only remaining differences were in the timestamps for the files in the PHAR)
### Deprecated
* `Test\AssertionFailed` and `Test\AssertionSucceeded` events
* `PHPUnit\Runner\Extension\Facade::requireExportOfObjects()` and `PHPUnit\Runner\Extension\Facade::requiresExportOfObjects()`
* `registerMockObjectsFromTestArgumentsRecursively` attribute on the `<phpunit>` element of the XML configuration file
* `PHPUnit\TextUI\Configuration\Configuration::registerMockObjectsFromTestArgumentsRecursively()`
### Fixed
* [#5614](https://github.com/sebastianbergmann/phpunit/issues/5614): Infinite recursion when data provider provides recursive array
## [10.5.2] - 2023-12-05
### Fixed
* [#5561](https://github.com/sebastianbergmann/phpunit/issues/5561): JUnit XML logger does not handle assertion failures in before-test methods
* [#5567](https://github.com/sebastianbergmann/phpunit/issues/5567): Infinite recursion when recursive / self-referencing arrays are checked whether they contain only scalar values
## [10.5.1] - 2023-12-01
### Fixed
* [#5593](https://github.com/sebastianbergmann/phpunit/issues/5593): Return Value Generator fails to correctly create test stub for method with `static` return type declaration when used recursively
* [#5596](https://github.com/sebastianbergmann/phpunit/issues/5596): `PHPUnit\Framework\TestCase` has `@internal` annotation in PHAR
## [10.5.0] - 2023-12-01
### Added
* [#5532](https://github.com/sebastianbergmann/phpunit/issues/5532): `#[IgnoreDeprecations]` attribute to ignore `E_(USER_)DEPRECATED` issues on test class and test method level
* [#5551](https://github.com/sebastianbergmann/phpunit/issues/5551): Support for omitting parameter default values for `willReturnMap()`
* [#5577](https://github.com/sebastianbergmann/phpunit/issues/5577): `--composer-lock` CLI option for PHAR binary that displays the `composer.lock` used to build the PHAR
### Changed
* `MockBuilder::disableAutoReturnValueGeneration()` and `MockBuilder::enableAutoReturnValueGeneration()` are no longer deprecated
### Fixed
* [#5563](https://github.com/sebastianbergmann/phpunit/issues/5563): `createMockForIntersectionOfInterfaces()` does not automatically register mock object for expectation verification
[10.5.20]: https://github.com/sebastianbergmann/phpunit/compare/10.5.19...10.5.20
[10.5.19]: https://github.com/sebastianbergmann/phpunit/compare/10.5.18...10.5.19
[10.5.18]: https://github.com/sebastianbergmann/phpunit/compare/10.5.17...10.5.18
[10.5.17]: https://github.com/sebastianbergmann/phpunit/compare/10.5.16...10.5.17
[10.5.16]: https://github.com/sebastianbergmann/phpunit/compare/10.5.15...10.5.16
[10.5.15]: https://github.com/sebastianbergmann/phpunit/compare/10.5.14...10.5.15
[10.5.14]: https://github.com/sebastianbergmann/phpunit/compare/10.5.13...10.5.14
[10.5.13]: https://github.com/sebastianbergmann/phpunit/compare/10.5.12...10.5.13
[10.5.12]: https://github.com/sebastianbergmann/phpunit/compare/10.5.11...10.5.12
[10.5.11]: https://github.com/sebastianbergmann/phpunit/compare/10.5.10...10.5.11
[10.5.10]: https://github.com/sebastianbergmann/phpunit/compare/10.5.9...10.5.10
[10.5.9]: https://github.com/sebastianbergmann/phpunit/compare/10.5.8...10.5.9
[10.5.8]: https://github.com/sebastianbergmann/phpunit/compare/10.5.7...10.5.8
[10.5.7]: https://github.com/sebastianbergmann/phpunit/compare/10.5.6...10.5.7
[10.5.6]: https://github.com/sebastianbergmann/phpunit/compare/10.5.5...10.5.6
[10.5.5]: https://github.com/sebastianbergmann/phpunit/compare/10.5.4...10.5.5
[10.5.4]: https://github.com/sebastianbergmann/phpunit/compare/10.5.3...10.5.4
[10.5.3]: https://github.com/sebastianbergmann/phpunit/compare/10.5.2...10.5.3
[10.5.2]: https://github.com/sebastianbergmann/phpunit/compare/10.5.1...10.5.2
[10.5.1]: https://github.com/sebastianbergmann/phpunit/compare/10.5.0...10.5.1
[10.5.0]: https://github.com/sebastianbergmann/phpunit/compare/10.4.2...10.5.0
home/mip/mip/vendor/phpunit/phpunit/phpunit 0000755 00000005325 15243435563 0015155 0 ustar 00 #!/usr/bin/env php
<?php declare(strict_types=1);
/*
* This file is part of PHPUnit.
*
* (c) Sebastian Bergmann <sebastian@phpunit.de>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
if (!version_compare(PHP_VERSION, PHP_VERSION, '=')) {
fwrite(
STDERR,
sprintf(
'%s declares an invalid value for PHP_VERSION.' . PHP_EOL .
'This breaks fundamental functionality such as version_compare().' . PHP_EOL .
'Please use a different PHP interpreter.' . PHP_EOL,
PHP_BINARY
)
);
die(1);
}
if (version_compare('8.1.0', PHP_VERSION, '>')) {
fwrite(
STDERR,
sprintf(
'This version of PHPUnit requires PHP >= 8.1.' . PHP_EOL .
'You are using PHP %s (%s).' . PHP_EOL,
PHP_VERSION,
PHP_BINARY
)
);
die(1);
}
if (!ini_get('date.timezone')) {
ini_set('date.timezone', 'UTC');
}
if (isset($GLOBALS['_composer_autoload_path'])) {
define('PHPUNIT_COMPOSER_INSTALL', $GLOBALS['_composer_autoload_path']);
unset($GLOBALS['_composer_autoload_path']);
} else {
foreach (array(__DIR__ . '/../../autoload.php', __DIR__ . '/../vendor/autoload.php', __DIR__ . '/vendor/autoload.php') as $file) {
if (file_exists($file)) {
define('PHPUNIT_COMPOSER_INSTALL', $file);
break;
}
}
unset($file);
}
if (!defined('PHPUNIT_COMPOSER_INSTALL')) {
fwrite(
STDERR,
'You need to set up the project dependencies using Composer:' . PHP_EOL . PHP_EOL .
' composer install' . PHP_EOL . PHP_EOL .
'You can learn all about Composer on https://getcomposer.org/.' . PHP_EOL
);
die(1);
}
require PHPUNIT_COMPOSER_INSTALL;
$requiredExtensions = ['dom', 'json', 'libxml', 'mbstring', 'tokenizer', 'xml', 'xmlwriter'];
$unavailableExtensions = array_filter(
$requiredExtensions,
static function ($extension) {
