mirror of
https://github.com/pestphp/pest.git
synced 2026-03-06 07:47:22 +01:00
Compare commits
195 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 55b9266648 | |||
| 4313a1ef20 | |||
| 005ef03845 | |||
| eb56483ba2 | |||
| 5d6b717c9a | |||
| 14859a4c89 | |||
| 8a44d3f136 | |||
| be71d6918d | |||
| afb3dd459a | |||
| b6e3ffafa7 | |||
| 6c95f3d8cf | |||
| 2192373bec | |||
| dfcdaa3f8e | |||
| 79bc9e677f | |||
| 60b615ea6a | |||
| 8787481e40 | |||
| c24406259f | |||
| cbd6a65057 | |||
| 175004baf3 | |||
| 6d9c0483a6 | |||
| 2dc413cba0 | |||
| 206548af2b | |||
| af6de422e9 | |||
| 1c7b254395 | |||
| de1c721cd9 | |||
| f8dd286213 | |||
| e11337df2d | |||
| 2f90d4ccd7 | |||
| 2db15af24a | |||
| c9e3932637 | |||
| d218afaf77 | |||
| 19739ff814 | |||
| 478144fb35 | |||
| 5d81cf0d4c | |||
| 0b115230f9 | |||
| 0b246f7a76 | |||
| 7914224ff7 | |||
| 997b0e9368 | |||
| a76414aeee | |||
| d2096df82a | |||
| 4951b1b0f9 | |||
| f2e31452f2 | |||
| c2985ffb31 | |||
| 492f797dd5 | |||
| 0b261ef97b | |||
| f19692a72f | |||
| 0787b37f2c | |||
| f0223b50d0 | |||
| 0263fcb2ac | |||
| c0a234317b | |||
| 72100075d2 | |||
| a7aa923241 | |||
| e012517b16 | |||
| b1dd18af8a | |||
| 398e3ff3b5 | |||
| 03648f580c | |||
| df2212055b | |||
| b1a137c513 | |||
| 62267dfd3e | |||
| f996a48dfa | |||
| 54e00dd4dc | |||
| f1414a0beb | |||
| 47f2ae32c1 | |||
| 306b7eb2a6 | |||
| 02f72aabb2 | |||
| e3a21384e6 | |||
| 331381eed5 | |||
| 75a7d77a80 | |||
| cc242a50d1 | |||
| 704acbf6de | |||
| 7baa48e068 | |||
| 3742e74adf | |||
| cbcea04768 | |||
| f0581f87c6 | |||
| 60763f2223 | |||
| 8a589022d9 | |||
| 00109e9976 | |||
| 43107c1743 | |||
| 546253d591 | |||
| d94a6580f5 | |||
| fb75b712d3 | |||
| 6ead2a4e8b | |||
| 9afe2296a6 | |||
| 0221c2a643 | |||
| 0518971d2f | |||
| fe3747f850 | |||
| 844d175981 | |||
| 4e719214c6 | |||
| 2f6b99885e | |||
| 4b24da1a58 | |||
| 72d482de28 | |||
| 049da041b2 | |||
| 4d7aa2b98f | |||
| 2e352c0084 | |||
| 3f854713e6 | |||
| 011bd3ba82 | |||
| 4de70da0a0 | |||
| 6820d8b7aa | |||
| 6886558ed1 | |||
| b795a92840 | |||
| 2e622f6fd4 | |||
| 5f7a1663dd | |||
| f3f35a2ed1 | |||
| 86a6b32715 | |||
| 1efb9de043 | |||
| b60d21dfe2 | |||
| 39e0d61dec | |||
| be41181b43 | |||
| 632ffc2f8e | |||
| 705f19dd87 | |||
| 5637dfa75d | |||
| cf5275293f | |||
| 81efe5953b | |||
| a37a3b9f99 | |||
| 9100913184 | |||
| 8fdb0b3d32 | |||
| 8322ff0f5e | |||
| c8287567eb | |||
| b00bc4d5ea | |||
| 8abc0d1920 | |||
| ea967b439f | |||
| 23d7191990 | |||
| c7e6df7c95 | |||
| 805b81edc0 | |||
| c42541a3d9 | |||
| 3f352605ca | |||
| 21a04fefcf | |||
| aa4fb3bba2 | |||
| 4d0dffafd3 | |||
| 19e75d1070 | |||
| cee5b9feb9 | |||
| 355a2349af | |||
| 7e815cc985 | |||
| fb443e0fa0 | |||
| 7f1135eeac | |||
| 25e15e76e0 | |||
| 9426881cf6 | |||
| 1f6970a5b3 | |||
| e541ee86fc | |||
| b1c6f247e0 | |||
| 36b585835d | |||
| 17db4bd616 | |||
| c98d8ca26a | |||
| d5334f96a4 | |||
| 54f4ee57ad | |||
| 4f3796ed2e | |||
| ac13a288fb | |||
| e2ccc9deac | |||
| 80129f2e23 | |||
| 5802bbc1dd | |||
| ee2f4eedbd | |||
| 0de1ce053a | |||
| be9056f978 | |||
| 26a6e7d712 | |||
| a90b90ad29 | |||
| bc951787d3 | |||
| 0ae0887665 | |||
| 551fa01415 | |||
| 68ea2c7d7e | |||
| 3e8616ec64 | |||
| 465c65243d | |||
| 9c0e5ddfc6 | |||
| 8442b9a6e4 | |||
| a1208b5876 | |||
| b5f89d1ff8 | |||
| cd823193cc | |||
| eb7bb34825 | |||
| 19e3d929b1 | |||
| 25729f6262 | |||
| cbb6a58c8a | |||
| 167c96965e | |||
| 8db3238a1f | |||
| cbd8cae83e | |||
| 3e03a87e02 | |||
| 193dd107d7 | |||
| 0cea8fe922 | |||
| abbbc9fdbb | |||
| 10b210d2bb | |||
| 9385a3dcea | |||
| c0af671ca2 | |||
| eb9f31edeb | |||
| 0e5470b192 | |||
| 2122e57990 | |||
| e42d224db2 | |||
| 070139eda7 | |||
| a0d0182031 | |||
| 1885d4e110 | |||
| 5959890125 | |||
| 7460bd6c1f | |||
| 801346b894 | |||
| 40fd06c0d0 | |||
| aa9fe351a6 | |||
| e00efb1b6d | |||
| 86a765b06b | |||
| c9180e590e |
66
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
66
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
@ -0,0 +1,66 @@
|
||||
name: Bug Report
|
||||
description: Report an Issue or Bug with the Pest
|
||||
title: "[Bug]: "
|
||||
labels: ["bug"]
|
||||
body:
|
||||
- type: markdown
|
||||
attributes:
|
||||
value: |
|
||||
We're sorry to hear you have a problem. Can you help us solve it by providing the following details.
|
||||
- type: textarea
|
||||
id: what-happened
|
||||
attributes:
|
||||
label: What Happened
|
||||
description: What did you expect to happen?
|
||||
placeholder: When I use expect()->toBeTrue() in my tests, I get an error
|
||||
validations:
|
||||
required: true
|
||||
- type: textarea
|
||||
id: how-to-reproduce
|
||||
attributes:
|
||||
label: How to Reproduce
|
||||
description: How did this occur, please add any config values used and provide a set of reliable steps if possible.
|
||||
placeholder: Install a fresh Laravel app, add Pest, add a test that uses expect()->toBeTrue()
|
||||
validations:
|
||||
required: true
|
||||
- type: input
|
||||
id: repository-sample
|
||||
attributes:
|
||||
label: Sample Repository
|
||||
description: If possible, please provide a sample repository that reproduces the issue.
|
||||
placeholder: https://github.com.br/your-username/your-repository
|
||||
- type: input
|
||||
id: pest-version
|
||||
attributes:
|
||||
label: Pest Version
|
||||
description: What version of our Package are you running? Please be as specific as possible
|
||||
placeholder: 2.14.1
|
||||
validations:
|
||||
required: true
|
||||
- type: input
|
||||
id: php-version
|
||||
attributes:
|
||||
label: PHP Version
|
||||
description: What version of PHP are you running? Please be as specific as possible
|
||||
placeholder: 8.1.20
|
||||
validations:
|
||||
required: true
|
||||
- type: dropdown
|
||||
id: operating-systems
|
||||
attributes:
|
||||
label: Operation System
|
||||
description: On which operating systems does the problem occur? You can select more than one.
|
||||
multiple: true
|
||||
options:
|
||||
- macOS
|
||||
- Windows
|
||||
- Linux
|
||||
validations:
|
||||
required: true
|
||||
- type: textarea
|
||||
id: notes
|
||||
attributes:
|
||||
label: Notes
|
||||
description: Use this field to provide any other notes that you feel might be relevant to the issue.
|
||||
validations:
|
||||
required: false
|
||||
20
.github/PULL_REQUEST_TEMPLATE.md
vendored
20
.github/PULL_REQUEST_TEMPLATE.md
vendored
@ -1,10 +1,16 @@
|
||||
| Q | A
|
||||
| ------------- | ---
|
||||
| Bug fix? | yes/no
|
||||
| New feature? | yes/no
|
||||
| Fixed tickets | #... <!-- #-prefixed issue number(s), if any -->
|
||||
|
||||
<!--
|
||||
- Replace this comment by a description of what your PR is solving.
|
||||
- Fill in the form below correctly. This will help the Pest team to understand the PR and also work on it.
|
||||
-->
|
||||
|
||||
### What:
|
||||
|
||||
- [ ] Bug Fix
|
||||
- [ ] New Feature
|
||||
|
||||
### Description:
|
||||
|
||||
<!-- describe what your PR is solving -->
|
||||
|
||||
### Related:
|
||||
|
||||
<!-- link to the issue(s) your PR is solving. If it doesn't exist, remove the "Related" section. -->
|
||||
|
||||
7
.github/workflows/static.yml
vendored
7
.github/workflows/static.yml
vendored
@ -30,8 +30,11 @@ jobs:
|
||||
- name: Install Dependencies
|
||||
run: composer update --prefer-stable --no-interaction --no-progress --ansi
|
||||
|
||||
- name: Types
|
||||
run: composer test:types
|
||||
- name: Type Check
|
||||
run: composer test:type:check
|
||||
|
||||
- name: Type Coverage
|
||||
run: composer test:type:coverage
|
||||
|
||||
- name: Refacto
|
||||
run: composer test:refacto
|
||||
|
||||
2
.github/workflows/tests.yml
vendored
2
.github/workflows/tests.yml
vendored
@ -14,7 +14,7 @@ jobs:
|
||||
strategy:
|
||||
matrix:
|
||||
os: [ubuntu-latest, macos-latest, windows-latest]
|
||||
php: ['8.1', '8.2']
|
||||
php: ['8.1', '8.2', '8.3']
|
||||
dependency-version: [prefer-lowest, prefer-stable]
|
||||
|
||||
name: PHP ${{ matrix.php }} - ${{ matrix.os }} - ${{ matrix.dependency-version }}
|
||||
|
||||
138
CHANGELOG.md
138
CHANGELOG.md
@ -2,6 +2,144 @@
|
||||
|
||||
## Unreleased
|
||||
|
||||
## [v2.16.0 (2023-08-21)](https://github.com/pestphp/pest/compare/v2.15.0...v2.16.0)
|
||||
|
||||
### Added
|
||||
|
||||
- `toBeDigits` ([#911](https://github.com/pestphp/pest/pull/911))
|
||||
- `toBeCamelCase`, `toBeKebabCase`, `toBeSnakeCase`, `toBeStudlyCase`, `toHaveSnakeCaseKeys`, `toHaveKebabCaseKeys`, `toHaveCamelCaseKeys`, `toHaveStudlyCaseKeys`` ([#921](https://github.com/pestphp/pest/pull/921))
|
||||
- native functions support on `arch` expectations, e.g: `expect('sleep')->toBeUsed();` ([#4](https://github.com/pestphp/pest-plugin-arch/pull/4))
|
||||
|
||||
### Changed
|
||||
|
||||
- `phpunit.xml` stub ([#915](https://github.com/pestphp/pest/pull/915))
|
||||
|
||||
### Fixed
|
||||
|
||||
- Nested sequences ([#895](https://github.com/pestphp/pest/pull/895))
|
||||
|
||||
## [v2.15.0 (2023-08-17)](https://github.com/pestphp/pest/compare/v2.14.1...v2.15.0)
|
||||
|
||||
### Added
|
||||
|
||||
- PHP 8.3 support ([0b261ef](https://github.com/pestphp/pest/commit/0b261ef97b7ceed20cbeeb2b0b41e08e0a8fcaa1))
|
||||
|
||||
## [v2.14.1 (2023-08-16)](https://github.com/pestphp/pest/compare/v2.14.0...v2.14.1)
|
||||
|
||||
### Changed
|
||||
|
||||
- Bumps PHPUnit to `^10.3.2` ([e012517](https://github.com/pestphp/pest/commit/e012517b1643002b36a68096f4a5e26682b1e175))
|
||||
|
||||
## [v2.14.0 (2023-08-14)](https://github.com/pestphp/pest/compare/v2.13.0...v2.14.0)
|
||||
|
||||
### Added
|
||||
|
||||
- `toBeUppercase()`, `toBeLowercase()`, `toBeAlphaNumeric()`, `toBeAlpha()` ([#906](https://github.com/pestphp/pest/pull/906))
|
||||
|
||||
## [v2.13.0 (2023-08-09)](https://github.com/pestphp/pest/compare/v2.12.2...v2.13.0)
|
||||
|
||||
### Added
|
||||
|
||||
- `expect()->ddWhen` and `expect()->ddUnless` ([306b7eb](https://github.com/pestphp/pest/commit/306b7eb2a6a57e570d58228b46501ad9ba4062b4))
|
||||
|
||||
## [v2.12.2 (2023-08-07)](https://github.com/pestphp/pest/compare/v2.12.0...v2.12.2)
|
||||
|
||||
### Fixed
|
||||
|
||||
- Running tests from `uses` parent class ([#898](https://github.com/pestphp/pest/pull/898))
|
||||
|
||||
## [v2.12.0 (2023-08-02)](https://github.com/pestphp/pest/compare/v2.11.0...v2.12.0)
|
||||
|
||||
### Added
|
||||
|
||||
- Allows multiple `toMatchSnapshot` per test ([#881](https://github.com/pestphp/pest/pull/881))
|
||||
|
||||
### Changed
|
||||
|
||||
- Bumps PHPUnit to `^10.2.7` ([43107c1](https://github.com/pestphp/pest/commit/43107c17436e41e23018ae31705c688168c14784))
|
||||
|
||||
## [v2.11.0 (2023-08-01)](https://github.com/pestphp/pest/compare/v2.10.1...v2.11.0)
|
||||
|
||||
### Added
|
||||
|
||||
- `toBeInvokable`expectation ([#891](https://github.com/pestphp/pest/pull/891))
|
||||
|
||||
## [v2.10.1 (2023-07-31)](https://github.com/pestphp/pest/compare/v2.10.0...v2.10.1)
|
||||
|
||||
### Fixed
|
||||
|
||||
- `not->toHaveSuffix` and `toHavePrefix` expectations ([#888](https://github.com/pestphp/pest/pull/888))
|
||||
|
||||
## [v2.10.0 (2023-07-31)](https://github.com/pestphp/pest/compare/v2.9.5...v2.10.0)
|
||||
|
||||
### Added
|
||||
|
||||
- `repeat` feature ([f3f35a2](https://github.com/pestphp/pest/commit/f3f35a2ed119f63eefd323a8c66d3387e908df3f))
|
||||
|
||||
### Fixed
|
||||
|
||||
- `-v` option ([86a6b32](https://github.com/pestphp/pest/commit/86a6b3271518742dc39761228687a5107551d279))
|
||||
|
||||
## [v2.9.5 (2023-07-22)](https://github.com/pestphp/pest/compare/v2.9.4...v2.9.5)
|
||||
|
||||
### Fixed
|
||||
|
||||
- Assertions count on arch expectations ([632ffc2](https://github.com/pestphp/pest/commit/632ffc2f8e1fe45f739b12b818426ae14700079e))
|
||||
|
||||
## [v2.9.4 (2023-07-22)](https://github.com/pestphp/pest/compare/v2.9.3...v2.9.4)
|
||||
|
||||
### Fixed
|
||||
|
||||
- Output on `describe` `beforeEach` failure ([5637dfa](https://github.com/pestphp/pest/commit/5637dfa75d1a331adc810935536cde7c3196af06))
|
||||
|
||||
## [v2.9.3 (2023-07-20)](https://github.com/pestphp/pest/compare/v2.9.2...v2.9.3)
|
||||
|
||||
### Fixed
|
||||
|
||||
- Snapshots directory on Windows environments ([cf52752](https://github.com/pestphp/pest/commit/cf5275293fe693ec2cf4dbadbadae01daaa08169))
|
||||
|
||||
## [v2.9.2 (2023-07-20)](https://github.com/pestphp/pest/compare/v2.9.1...v2.9.2)
|
||||
|
||||
### Fixed
|
||||
|
||||
- `beforeEach` on Windows environments ([a37a3b9](https://github.com/pestphp/pest/commit/a37a3b9f9931bc1ab1ea9e1d6d38dfb55dde3f74))
|
||||
|
||||
## [v2.9.1 (2023-07-20)](https://github.com/pestphp/pest/compare/v2.9.0...v2.9.1)
|
||||
|
||||
### Chore
|
||||
|
||||
- Bumps PHPUnit to `^10.2.6` ([8fdb0b3](https://github.com/pestphp/pest/commit/8fdb0b3d32ce9ee12bd182f22751c2b41a53e97b))
|
||||
|
||||
## [v2.9.0 (2023-07-19)](https://github.com/pestphp/pest/compare/v2.8.1...v2.9.0)
|
||||
|
||||
> "Spicy Summer" is the codename assigned to Pest 2.9, for full details check our announcement: [https://pestphp.com/docs/pest-spicy-summer-release](https://pestphp.com/docs/pest-spicy-summer-release)
|
||||
|
||||
### Added
|
||||
|
||||
- Built-in Snapshot Testing ([c828756](https://github.com/pestphp/pest/commit/c8287567eb8c3dbea5845b2a6f70804b094b4b60))
|
||||
- Describe Blocks ([c828756](https://github.com/pestphp/pest/commit/c8287567eb8c3dbea5845b2a6f70804b094b4b60))
|
||||
- Architectural Testing++ ([c828756](https://github.com/pestphp/pest/commit/c8287567eb8c3dbea5845b2a6f70804b094b4b60))
|
||||
- Type Coverage Plugin ([c828756](https://github.com/pestphp/pest/commit/c8287567eb8c3dbea5845b2a6f70804b094b4b60))
|
||||
- Drift Plugin ([c828756](https://github.com/pestphp/pest/commit/c8287567eb8c3dbea5845b2a6f70804b094b4b60))
|
||||
|
||||
## [v2.8.1 (2023-06-20)](https://github.com/pestphp/pest/compare/v2.8.0...v2.8.1)
|
||||
|
||||
### Fixed
|
||||
- Fixes "Cannot find TestCase object on call stack" ([eb7bb34](https://github.com/pestphp/pest/commit/eb7bb348253f412e806a6ba6f0df46c0435d0dfe))
|
||||
|
||||
## [v2.8.0 (2023-06-19)](https://github.com/pestphp/pest/compare/v2.7.0...v2.8.0)
|
||||
|
||||
### Added
|
||||
- Support for `globs` in `uses` ([#829](https://github.com/pestphp/pest/pull/829))
|
||||
|
||||
## [v2.7.0 (2023-06-15)](https://github.com/pestphp/pest/compare/v2.6.3...v2.7.0)
|
||||
|
||||
### Added
|
||||
- Support for unexpected output on printer ([eb9f31e](https://github.com/pestphp/pest/commit/eb9f31edeb00a88c449874f3d48156128a00fff8))
|
||||
|
||||
### Chore
|
||||
- Bumps PHPUnit to `^10.2.2` ([0e5470b](https://github.com/pestphp/pest/commit/0e5470b192b259ba2db7c02a50371216c98fc0a6))
|
||||
|
||||
## [v2.6.3 (2023-06-07)](https://github.com/pestphp/pest/compare/v2.6.2...v2.6.3)
|
||||
|
||||
### Chore
|
||||
|
||||
@ -32,7 +32,6 @@ We cannot thank our sponsors enough for their incredible support in funding Pest
|
||||
- [Codecourse](https://codecourse.com/)
|
||||
- [Laracasts](https://laracasts.com/)
|
||||
- [Localazy](https://localazy.com)
|
||||
- [Hyvor](https://hyvor.com/)
|
||||
- [Fathom Analytics](https://usefathom.com/)
|
||||
- [Meema](https://meema.io)
|
||||
- [Zapiet](https://www.zapiet.com)
|
||||
|
||||
@ -31,6 +31,7 @@ $bootPest = (static function (): void {
|
||||
$getopt = getopt('', [
|
||||
'status-file:',
|
||||
'progress-file:',
|
||||
'unexpected-output-file:',
|
||||
'testresult-file:',
|
||||
'teamcity-file:',
|
||||
'testdox-file:',
|
||||
@ -45,6 +46,7 @@ $bootPest = (static function (): void {
|
||||
];
|
||||
|
||||
foreach ($composerAutoloadFiles as $file) {
|
||||
|
||||
if (file_exists($file)) {
|
||||
require_once $file;
|
||||
define('PHPUNIT_COMPOSER_INSTALL', $file);
|
||||
@ -58,6 +60,7 @@ $bootPest = (static function (): void {
|
||||
assert(is_resource($statusFile));
|
||||
|
||||
assert(isset($getopt['progress-file']) && is_string($getopt['progress-file']));
|
||||
assert(isset($getopt['unexpected-output-file']) && is_string($getopt['unexpected-output-file']));
|
||||
assert(isset($getopt['testresult-file']) && is_string($getopt['testresult-file']));
|
||||
assert(! isset($getopt['teamcity-file']) || is_string($getopt['teamcity-file']));
|
||||
assert(! isset($getopt['testdox-file']) || is_string($getopt['testdox-file']));
|
||||
@ -73,6 +76,7 @@ $bootPest = (static function (): void {
|
||||
$application = new ApplicationForWrapperWorker(
|
||||
$phpunitArgv,
|
||||
$getopt['progress-file'],
|
||||
$getopt['unexpected-output-file'],
|
||||
$getopt['testresult-file'],
|
||||
$getopt['teamcity-file'] ?? null,
|
||||
$getopt['testdox-file'] ?? null,
|
||||
@ -88,10 +92,10 @@ $bootPest = (static function (): void {
|
||||
$testPath = fgets(STDIN);
|
||||
if ($testPath === false || $testPath === WrapperWorker::COMMAND_EXIT) {
|
||||
$application->end();
|
||||
|
||||
exit;
|
||||
}
|
||||
|
||||
// It must be a 1 byte string to ensure filesize() is equal to the number of tests executed
|
||||
$exitCode = $application->runTest(realpath(trim($testPath)));
|
||||
|
||||
fwrite($statusFile, (string) $exitCode);
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "pestphp/pest",
|
||||
"description": "An elegant PHP Testing Framework.",
|
||||
"description": "The elegant PHP Testing Framework.",
|
||||
"keywords": [
|
||||
"php",
|
||||
"framework",
|
||||
@ -18,16 +18,16 @@
|
||||
],
|
||||
"require": {
|
||||
"php": "^8.1.0",
|
||||
"brianium/paratest": "^7.1.4",
|
||||
"nunomaduro/collision": "^7.5.2",
|
||||
"brianium/paratest": "^7.2.6",
|
||||
"nunomaduro/collision": "^7.8.1",
|
||||
"nunomaduro/termwind": "^1.15.1",
|
||||
"pestphp/pest-plugin": "^2.0.1",
|
||||
"pestphp/pest-plugin-arch": "^2.2.0",
|
||||
"phpunit/phpunit": "^10.2.1"
|
||||
"pestphp/pest-plugin": "^2.1.1",
|
||||
"pestphp/pest-plugin-arch": "^2.3.3",
|
||||
"phpunit/phpunit": "^10.3.2"
|
||||
},
|
||||
"conflict": {
|
||||
"webmozart/assert": "<1.11.0",
|
||||
"phpunit/phpunit": ">10.2.1"
|
||||
"phpunit/phpunit": ">10.3.2"
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
@ -42,6 +42,7 @@
|
||||
"psr-4": {
|
||||
"Tests\\Fixtures\\Covers\\": "tests/Fixtures/Covers",
|
||||
"Tests\\Fixtures\\Inheritance\\": "tests/Fixtures/Inheritance",
|
||||
"Tests\\Fixtures\\Arch\\": "tests/Fixtures/Arch",
|
||||
"Tests\\": "tests/PHPUnit/"
|
||||
},
|
||||
"files": [
|
||||
@ -49,10 +50,12 @@
|
||||
]
|
||||
},
|
||||
"require-dev": {
|
||||
"pestphp/pest-dev-tools": "^2.10.0",
|
||||
"symfony/process": "^6.3.0"
|
||||
"pestphp/pest-dev-tools": "^2.16.0",
|
||||
"pestphp/pest-plugin-type-coverage": "^2.2.0",
|
||||
"symfony/process": "^6.3.4"
|
||||
},
|
||||
"minimum-stability": "stable",
|
||||
"minimum-stability": "dev",
|
||||
"prefer-stable": true,
|
||||
"config": {
|
||||
"sort-packages": true,
|
||||
"preferred-install": "dist",
|
||||
@ -68,16 +71,18 @@
|
||||
"lint": "pint",
|
||||
"test:refacto": "rector --dry-run",
|
||||
"test:lint": "pint --test",
|
||||
"test:types": "phpstan analyse --ansi --memory-limit=-1 --debug",
|
||||
"test:type:check": "phpstan analyse --ansi --memory-limit=-1 --debug",
|
||||
"test:type:coverage": "php bin/pest --type-coverage --min=100",
|
||||
"test:unit": "php bin/pest --colors=always --exclude-group=integration --compact",
|
||||
"test:inline": "php bin/pest --colors=always --configuration=phpunit.inline.xml",
|
||||
"test:parallel": "php bin/pest --colors=always --exclude-group=integration --parallel --processes=10",
|
||||
"test:integration": "php bin/pest --colors=always --group=integration",
|
||||
"update:snapshots": "REBUILD_SNAPSHOTS=true php bin/pest --colors=always",
|
||||
"update:snapshots": "REBUILD_SNAPSHOTS=true php bin/pest --colors=always --update-snapshots",
|
||||
"test": [
|
||||
"@test:refacto",
|
||||
"@test:lint",
|
||||
"@test:types",
|
||||
"@test:type:check",
|
||||
"@test:type:coverage",
|
||||
"@test:unit",
|
||||
"@test:parallel",
|
||||
"@test:integration"
|
||||
@ -98,6 +103,8 @@
|
||||
"Pest\\Plugins\\ProcessIsolation",
|
||||
"Pest\\Plugins\\Profile",
|
||||
"Pest\\Plugins\\Retry",
|
||||
"Pest\\Plugins\\Snapshot",
|
||||
"Pest\\Plugins\\Verbose",
|
||||
"Pest\\Plugins\\Version",
|
||||
"Pest\\Plugins\\Parallel"
|
||||
]
|
||||
|
||||
@ -34,17 +34,18 @@
|
||||
|
||||
namespace PHPUnit\Runner\Filter;
|
||||
|
||||
use function end;
|
||||
use Exception;
|
||||
use function implode;
|
||||
use Pest\Contracts\HasPrintableTestCaseName;
|
||||
use PHPUnit\Framework\SelfDescribing;
|
||||
use PHPUnit\Framework\Test;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
use PHPUnit\Framework\TestSuite;
|
||||
use function preg_match;
|
||||
use RecursiveFilterIterator;
|
||||
use RecursiveIterator;
|
||||
|
||||
use function end;
|
||||
use function implode;
|
||||
use function preg_match;
|
||||
use function sprintf;
|
||||
use function str_replace;
|
||||
|
||||
|
||||
@ -45,9 +45,15 @@ declare(strict_types=1);
|
||||
|
||||
namespace PHPUnit\Runner\ResultCache;
|
||||
|
||||
use const DIRECTORY_SEPARATOR;
|
||||
|
||||
use PHPUnit\Framework\TestStatus\TestStatus;
|
||||
use PHPUnit\Runner\DirectoryCannotBeCreatedException;
|
||||
use PHPUnit\Runner\Exception;
|
||||
use PHPUnit\Util\Filesystem;
|
||||
|
||||
use function array_keys;
|
||||
use function assert;
|
||||
use const DIRECTORY_SEPARATOR;
|
||||
use function dirname;
|
||||
use function file_get_contents;
|
||||
use function file_put_contents;
|
||||
@ -57,10 +63,6 @@ use function is_file;
|
||||
use function json_decode;
|
||||
use function json_encode;
|
||||
use function Pest\version;
|
||||
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
|
||||
@ -89,7 +91,7 @@ final class DefaultResultCache implements ResultCache
|
||||
*/
|
||||
private array $times = [];
|
||||
|
||||
public function __construct(?string $filepath = null)
|
||||
public function __construct(string $filepath = null)
|
||||
{
|
||||
if ($filepath !== null && is_dir($filepath)) {
|
||||
$filepath .= DIRECTORY_SEPARATOR.self::DEFAULT_RESULT_CACHE_FILENAME;
|
||||
|
||||
@ -36,18 +36,19 @@ declare(strict_types=1);
|
||||
|
||||
namespace PHPUnit\Runner;
|
||||
|
||||
use function array_diff;
|
||||
use function array_values;
|
||||
use function basename;
|
||||
use function class_exists;
|
||||
use Exception;
|
||||
use function get_declared_classes;
|
||||
use Pest\Contracts\HasPrintableTestCaseName;
|
||||
use Pest\TestCases\IgnorableTestCase;
|
||||
use Pest\TestSuite;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
use ReflectionClass;
|
||||
use ReflectionException;
|
||||
|
||||
use function array_diff;
|
||||
use function array_values;
|
||||
use function basename;
|
||||
use function class_exists;
|
||||
use function get_declared_classes;
|
||||
use function substr;
|
||||
|
||||
/**
|
||||
@ -60,6 +61,11 @@ final class TestSuiteLoader
|
||||
*/
|
||||
private static array $loadedClasses = [];
|
||||
|
||||
/**
|
||||
* @psalm-var array<string, array<class-string>>
|
||||
*/
|
||||
private static array $loadedClassesByFilename = [];
|
||||
|
||||
/**
|
||||
* @psalm-var list<class-string>
|
||||
*/
|
||||
@ -97,6 +103,17 @@ final class TestSuiteLoader
|
||||
|
||||
self::$loadedClasses = array_merge($loadedClasses, self::$loadedClasses);
|
||||
|
||||
foreach ($loadedClasses as $loadedClass) {
|
||||
$reflection = new ReflectionClass($loadedClass);
|
||||
$filename = $reflection->getFileName();
|
||||
self::$loadedClassesByFilename[$filename] = [
|
||||
$loadedClass,
|
||||
...self::$loadedClassesByFilename[$filename] ?? [],
|
||||
];
|
||||
}
|
||||
|
||||
$loadedClasses = array_merge(self::$loadedClassesByFilename[$suiteClassFile] ?? [], $loadedClasses);
|
||||
|
||||
if (empty($loadedClasses)) {
|
||||
return $this->exceptionFor($suiteClassName, $suiteClassFile);
|
||||
}
|
||||
|
||||
@ -45,7 +45,6 @@ declare(strict_types=1);
|
||||
|
||||
namespace PHPUnit\TextUI;
|
||||
|
||||
use function array_map;
|
||||
use Pest\Plugins\Only;
|
||||
use PHPUnit\Event;
|
||||
use PHPUnit\Framework\TestSuite;
|
||||
@ -53,6 +52,8 @@ use PHPUnit\Runner\Filter\Factory;
|
||||
use PHPUnit\TextUI\Configuration\Configuration;
|
||||
use PHPUnit\TextUI\Configuration\FilterNotConfiguredException;
|
||||
|
||||
use function array_map;
|
||||
|
||||
/**
|
||||
* @internal This class is not covered by the backward compatibility promise for PHPUnit
|
||||
*/
|
||||
|
||||
39
src/Bootstrappers/BootExcludeList.php
Normal file
39
src/Bootstrappers/BootExcludeList.php
Normal file
@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Bootstrappers;
|
||||
|
||||
use Pest\Contracts\Bootstrapper;
|
||||
use PHPUnit\Util\ExcludeList;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class BootExcludeList implements Bootstrapper
|
||||
{
|
||||
/**
|
||||
* The directories to exclude.
|
||||
*
|
||||
* @var array<int, non-empty-string>
|
||||
*/
|
||||
private const EXCLUDE_LIST = [
|
||||
'bin',
|
||||
'overrides',
|
||||
'resources',
|
||||
'src',
|
||||
'stubs',
|
||||
];
|
||||
|
||||
/**
|
||||
* Boots the "exclude list" for PHPUnit to ignore Pest files.
|
||||
*/
|
||||
public function boot(): void
|
||||
{
|
||||
$baseDirectory = dirname(__DIR__, 2);
|
||||
|
||||
foreach (self::EXCLUDE_LIST as $directory) {
|
||||
ExcludeList::addDirectory($baseDirectory.DIRECTORY_SEPARATOR.$directory);
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -7,12 +7,13 @@ namespace Pest\Bootstrappers;
|
||||
use Pest\Contracts\Bootstrapper;
|
||||
use Pest\Support\DatasetInfo;
|
||||
use Pest\Support\Str;
|
||||
use function Pest\testDirectory;
|
||||
use Pest\TestSuite;
|
||||
use RecursiveDirectoryIterator;
|
||||
use RecursiveIteratorIterator;
|
||||
use SebastianBergmann\FileIterator\Facade as PhpUnitFileIterator;
|
||||
|
||||
use function Pest\testDirectory;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
|
||||
@ -5,7 +5,6 @@ declare(strict_types=1);
|
||||
namespace Pest\Concerns;
|
||||
|
||||
use Closure;
|
||||
use Pest\Expectation;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
@ -37,7 +36,7 @@ trait Pipeable
|
||||
/**
|
||||
* Register an interceptor that should replace an existing expectation.
|
||||
*
|
||||
* @param string|Closure(mixed $value, mixed ...$arguments):bool $filter
|
||||
* @param string|Closure(mixed $value, mixed ...$arguments):bool $filter
|
||||
*/
|
||||
public function intercept(string $name, string|Closure $filter, Closure $handler): void
|
||||
{
|
||||
|
||||
@ -23,40 +23,50 @@ use Throwable;
|
||||
trait Testable
|
||||
{
|
||||
/**
|
||||
* Test method description.
|
||||
* The test's description.
|
||||
*/
|
||||
private string $__description;
|
||||
|
||||
/**
|
||||
* Test "latest" method description.
|
||||
* The test's latest description.
|
||||
*/
|
||||
private static string $__latestDescription;
|
||||
|
||||
/**
|
||||
* The Test Case "test" closure.
|
||||
* The test's describing, if any.
|
||||
*/
|
||||
public ?string $__describing = null;
|
||||
|
||||
/**
|
||||
* The test's test closure.
|
||||
*/
|
||||
private Closure $__test;
|
||||
|
||||
/**
|
||||
* The Test Case "setUp" closure.
|
||||
* The test's before each closure.
|
||||
*/
|
||||
private ?Closure $__beforeEach = null;
|
||||
|
||||
/**
|
||||
* The Test Case "tearDown" closure.
|
||||
* The test's after each closure.
|
||||
*/
|
||||
private ?Closure $__afterEach = null;
|
||||
|
||||
/**
|
||||
* The Test Case "setUpBeforeClass" closure.
|
||||
* The test's before all closure.
|
||||
*/
|
||||
private static ?Closure $__beforeAll = null;
|
||||
|
||||
/**
|
||||
* The test "tearDownAfterClass" closure.
|
||||
* The test's after all closure.
|
||||
*/
|
||||
private static ?Closure $__afterAll = null;
|
||||
|
||||
/**
|
||||
* The list of snapshot changes, if any.
|
||||
*/
|
||||
private array $__snapshotChanges = [];
|
||||
|
||||
/**
|
||||
* Resets the test case static properties.
|
||||
*/
|
||||
@ -78,6 +88,7 @@ trait Testable
|
||||
if ($test->hasMethod($name)) {
|
||||
$method = $test->getMethod($name);
|
||||
$this->__description = self::$__latestDescription = $method->description;
|
||||
$this->__describing = $method->describing;
|
||||
$this->__test = $method->getClosure($this);
|
||||
}
|
||||
}
|
||||
@ -92,7 +103,7 @@ trait Testable
|
||||
}
|
||||
|
||||
self::$__beforeAll = (self::$__beforeAll instanceof Closure)
|
||||
? ChainableClosure::fromStatic(self::$__beforeAll, $hook)
|
||||
? ChainableClosure::boundStatically(self::$__beforeAll, $hook)
|
||||
: $hook;
|
||||
}
|
||||
|
||||
@ -106,7 +117,7 @@ trait Testable
|
||||
}
|
||||
|
||||
self::$__afterAll = (self::$__afterAll instanceof Closure)
|
||||
? ChainableClosure::fromStatic(self::$__afterAll, $hook)
|
||||
? ChainableClosure::boundStatically(self::$__afterAll, $hook)
|
||||
: $hook;
|
||||
}
|
||||
|
||||
@ -136,7 +147,7 @@ trait Testable
|
||||
}
|
||||
|
||||
$this->{$property} = ($this->{$property} instanceof Closure)
|
||||
? ChainableClosure::from($this->{$property}, $hook)
|
||||
? ChainableClosure::bound($this->{$property}, $hook)
|
||||
: $hook;
|
||||
}
|
||||
|
||||
@ -150,7 +161,7 @@ trait Testable
|
||||
$beforeAll = TestSuite::getInstance()->beforeAll->get(self::$__filename);
|
||||
|
||||
if (self::$__beforeAll instanceof Closure) {
|
||||
$beforeAll = ChainableClosure::fromStatic(self::$__beforeAll, $beforeAll);
|
||||
$beforeAll = ChainableClosure::boundStatically(self::$__beforeAll, $beforeAll);
|
||||
}
|
||||
|
||||
call_user_func(Closure::bind($beforeAll, null, self::class));
|
||||
@ -164,7 +175,7 @@ trait Testable
|
||||
$afterAll = TestSuite::getInstance()->afterAll->get(self::$__filename);
|
||||
|
||||
if (self::$__afterAll instanceof Closure) {
|
||||
$afterAll = ChainableClosure::fromStatic(self::$__afterAll, $afterAll);
|
||||
$afterAll = ChainableClosure::boundStatically(self::$__afterAll, $afterAll);
|
||||
}
|
||||
|
||||
call_user_func(Closure::bind($afterAll, null, self::class));
|
||||
@ -179,12 +190,33 @@ trait Testable
|
||||
{
|
||||
TestSuite::getInstance()->test = $this;
|
||||
|
||||
$method = TestSuite::getInstance()->tests->get(self::$__filename)->getMethod($this->name());
|
||||
|
||||
$description = $this->dataName() ? $method->description.' with '.$this->dataName() : $method->description;
|
||||
|
||||
if ($method->repetitions > 1) {
|
||||
$matches = [];
|
||||
preg_match('/\((.*?)\)/', $description, $matches);
|
||||
|
||||
if (count($matches) > 1) {
|
||||
if (str_contains($description, 'with '.$matches[0].' /')) {
|
||||
$description = str_replace('with '.$matches[0].' /', '', $description);
|
||||
} else {
|
||||
$description = str_replace('with '.$matches[0], '', $description);
|
||||
}
|
||||
}
|
||||
|
||||
$description .= ' @ repetition '.($matches[1].' of '.$method->repetitions);
|
||||
}
|
||||
|
||||
$this->__description = self::$__latestDescription = $description;
|
||||
|
||||
parent::setUp();
|
||||
|
||||
$beforeEach = TestSuite::getInstance()->beforeEach->get(self::$__filename)[1];
|
||||
|
||||
if ($this->__beforeEach instanceof Closure) {
|
||||
$beforeEach = ChainableClosure::from($this->__beforeEach, $beforeEach);
|
||||
$beforeEach = ChainableClosure::bound($this->__beforeEach, $beforeEach);
|
||||
}
|
||||
|
||||
$this->__callClosure($beforeEach, func_get_args());
|
||||
@ -198,7 +230,7 @@ trait Testable
|
||||
$afterEach = TestSuite::getInstance()->afterEach->get(self::$__filename);
|
||||
|
||||
if ($this->__afterEach instanceof Closure) {
|
||||
$afterEach = ChainableClosure::from($this->__afterEach, $afterEach);
|
||||
$afterEach = ChainableClosure::bound($this->__afterEach, $afterEach);
|
||||
}
|
||||
|
||||
$this->__callClosure($afterEach, func_get_args());
|
||||
@ -230,7 +262,9 @@ trait Testable
|
||||
{
|
||||
$method = TestSuite::getInstance()->tests->get(self::$__filename)->getMethod($this->name());
|
||||
|
||||
$this->__description = self::$__latestDescription = $this->dataName() ? $method->description.' with '.$this->dataName() : $method->description;
|
||||
if ($method->repetitions > 1) {
|
||||
array_shift($arguments);
|
||||
}
|
||||
|
||||
$underlyingTest = Reflection::getFunctionVariable($this->__test, 'closure');
|
||||
$testParameterTypes = array_values(Reflection::getFunctionArguments($underlyingTest));
|
||||
@ -302,6 +336,24 @@ trait Testable
|
||||
return ExceptionTrace::ensure(fn (): mixed => call_user_func_array(Closure::bind($closure, $this, $this::class), $arguments));
|
||||
}
|
||||
|
||||
/** @postCondition */
|
||||
protected function __MarkTestIncompleteIfSnapshotHaveChanged(): void
|
||||
{
|
||||
if (count($this->__snapshotChanges) === 0) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (count($this->__snapshotChanges) === 1) {
|
||||
$this->markTestIncomplete($this->__snapshotChanges[0]);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$messages = implode(PHP_EOL, array_map(static fn (string $message): string => '- $message', $this->__snapshotChanges));
|
||||
|
||||
$this->markTestIncomplete($messages);
|
||||
}
|
||||
|
||||
/**
|
||||
* The printable test case name.
|
||||
*/
|
||||
|
||||
@ -12,13 +12,13 @@ use Symfony\Component\Console\Exception\ExceptionInterface;
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class BeforeEachAlreadyExist extends InvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
final class AfterAllWithinDescribe extends InvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
{
|
||||
/**
|
||||
* Creates a new Exception instance.
|
||||
*/
|
||||
public function __construct(string $filename)
|
||||
{
|
||||
parent::__construct(sprintf('The beforeEach already exists in the filename `%s`.', $filename));
|
||||
parent::__construct(sprintf('The afterAll method can not be used within describe functions. Filename `%s`.', $filename));
|
||||
}
|
||||
}
|
||||
@ -12,13 +12,13 @@ use Symfony\Component\Console\Exception\ExceptionInterface;
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class AfterEachAlreadyExist extends InvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
final class BeforeAllAlreadyExist extends InvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
{
|
||||
/**
|
||||
* Creates a new Exception instance.
|
||||
*/
|
||||
public function __construct(string $filename)
|
||||
{
|
||||
parent::__construct(sprintf('The afterEach already exists in the filename `%s`.', $filename));
|
||||
parent::__construct(sprintf('The beforeAll already exists in the filename `%s`.', $filename));
|
||||
}
|
||||
}
|
||||
24
src/Exceptions/BeforeAllWithinDescribe.php
Normal file
24
src/Exceptions/BeforeAllWithinDescribe.php
Normal file
@ -0,0 +1,24 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Exceptions;
|
||||
|
||||
use InvalidArgumentException;
|
||||
use NunoMaduro\Collision\Contracts\RenderlessEditor;
|
||||
use NunoMaduro\Collision\Contracts\RenderlessTrace;
|
||||
use Symfony\Component\Console\Exception\ExceptionInterface;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class BeforeAllWithinDescribe extends InvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
{
|
||||
/**
|
||||
* Creates a new Exception instance.
|
||||
*/
|
||||
public function __construct(string $filename)
|
||||
{
|
||||
parent::__construct(sprintf('The beforeAll method can not be used within describe functions. Filename `%s`.', $filename));
|
||||
}
|
||||
}
|
||||
24
src/Exceptions/InvalidArgumentException.php
Normal file
24
src/Exceptions/InvalidArgumentException.php
Normal file
@ -0,0 +1,24 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Exceptions;
|
||||
|
||||
use InvalidArgumentException as BaseInvalidArgumentException;
|
||||
use NunoMaduro\Collision\Contracts\RenderlessEditor;
|
||||
use NunoMaduro\Collision\Contracts\RenderlessTrace;
|
||||
use Symfony\Component\Console\Exception\ExceptionInterface;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class InvalidArgumentException extends BaseInvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
|
||||
{
|
||||
/**
|
||||
* Creates a new Exception instance.
|
||||
*/
|
||||
public function __construct(string $message)
|
||||
{
|
||||
parent::__construct($message, 1);
|
||||
}
|
||||
}
|
||||
@ -6,13 +6,18 @@ namespace Pest;
|
||||
|
||||
use BadMethodCallException;
|
||||
use Closure;
|
||||
use InvalidArgumentException;
|
||||
use OutOfRangeException;
|
||||
use Pest\Arch\Contracts\ArchExpectation;
|
||||
use Pest\Arch\Expectations\Targeted;
|
||||
use Pest\Arch\Expectations\ToBeUsedIn;
|
||||
use Pest\Arch\Expectations\ToBeUsedInNothing;
|
||||
use Pest\Arch\Expectations\ToOnlyBeUsedIn;
|
||||
use Pest\Arch\Expectations\ToOnlyUse;
|
||||
use Pest\Arch\Expectations\ToUse;
|
||||
use Pest\Arch\Expectations\ToUseNothing;
|
||||
use Pest\Arch\PendingArchExpectation;
|
||||
use Pest\Arch\Support\FileLineFinder;
|
||||
use Pest\Concerns\Extendable;
|
||||
use Pest\Concerns\Pipeable;
|
||||
use Pest\Concerns\Retrievable;
|
||||
@ -24,7 +29,7 @@ use Pest\Expectations\HigherOrderExpectation;
|
||||
use Pest\Expectations\OppositeExpectation;
|
||||
use Pest\Matchers\Any;
|
||||
use Pest\Support\ExpectationPipeline;
|
||||
use PHPUnit\Framework\Assert;
|
||||
use PHPUnit\Architecture\Elements\ObjectDescription;
|
||||
use PHPUnit\Framework\ExpectationFailedException;
|
||||
|
||||
/**
|
||||
@ -34,8 +39,13 @@ use PHPUnit\Framework\ExpectationFailedException;
|
||||
*
|
||||
* @property OppositeExpectation $not Creates the opposite expectation.
|
||||
* @property EachExpectation $each Creates an expectation on each element on the traversable value.
|
||||
* @property PendingArchExpectation $classes
|
||||
* @property PendingArchExpectation $traits
|
||||
* @property PendingArchExpectation $interfaces
|
||||
* @property PendingArchExpectation $enums
|
||||
*
|
||||
* @mixin Mixins\Expectation<TValue>
|
||||
* @mixin PendingArchExpectation
|
||||
*/
|
||||
final class Expectation
|
||||
{
|
||||
@ -118,6 +128,40 @@ final class Expectation
|
||||
exit(1);
|
||||
}
|
||||
|
||||
/**
|
||||
* Dump the expectation value when the result of the condition is truthy.
|
||||
*
|
||||
* @param (\Closure(TValue): bool)|bool $condition
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function ddWhen(Closure|bool $condition, mixed ...$arguments): Expectation
|
||||
{
|
||||
$condition = $condition instanceof Closure ? $condition($this->value) : $condition;
|
||||
|
||||
if (! $condition) {
|
||||
return $this;
|
||||
}
|
||||
|
||||
$this->dd(...$arguments);
|
||||
}
|
||||
|
||||
/**
|
||||
* Dump the expectation value when the result of the condition is falsy.
|
||||
*
|
||||
* @param (\Closure(TValue): bool)|bool $condition
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function ddUnless(Closure|bool $condition, mixed ...$arguments): Expectation
|
||||
{
|
||||
$condition = $condition instanceof Closure ? $condition($this->value) : $condition;
|
||||
|
||||
if ($condition) {
|
||||
return $this;
|
||||
}
|
||||
|
||||
$this->dd(...$arguments);
|
||||
}
|
||||
|
||||
/**
|
||||
* Send the expectation value to Ray along with all given arguments.
|
||||
*
|
||||
@ -167,7 +211,7 @@ final class Expectation
|
||||
*
|
||||
* @template TSequenceValue
|
||||
*
|
||||
* @param (callable(self<TValue>, self<string|int>): void)|TSequenceValue ...$callbacks
|
||||
* @param (callable(self<TValue>, self<string|int>): void)|TSequenceValue ...$callbacks
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function sequence(mixed ...$callbacks): self
|
||||
@ -176,30 +220,26 @@ final class Expectation
|
||||
throw new BadMethodCallException('Expectation value is not iterable.');
|
||||
}
|
||||
|
||||
$value = is_array($this->value) ? $this->value : iterator_to_array($this->value);
|
||||
$keys = array_keys($value);
|
||||
$values = array_values($value);
|
||||
$callbacksCount = count($callbacks);
|
||||
|
||||
$index = 0;
|
||||
|
||||
while (count($callbacks) < count($values)) {
|
||||
$callbacks[] = $callbacks[$index];
|
||||
$index = $index < count($values) - 1 ? $index + 1 : 0;
|
||||
if (count($callbacks) == 0) {
|
||||
throw new InvalidArgumentException('No sequence expectations defined.');
|
||||
}
|
||||
|
||||
if ($callbacksCount > count($values)) {
|
||||
Assert::assertLessThanOrEqual(count($value), count($callbacks));
|
||||
}
|
||||
$index = $valuesCount = 0;
|
||||
|
||||
foreach ($values as $key => $item) {
|
||||
if ($callbacks[$key] instanceof Closure) {
|
||||
call_user_func($callbacks[$key], new self($item), new self($keys[$key]));
|
||||
foreach ($this->value as $key => $value) {
|
||||
$valuesCount++;
|
||||
|
||||
continue;
|
||||
if ($callbacks[$index] instanceof Closure) {
|
||||
$callbacks[$index](new self($value), new self($key));
|
||||
} else {
|
||||
(new self($value))->toEqual($callbacks[$index]);
|
||||
}
|
||||
|
||||
(new self($item))->toEqual($callbacks[$key]);
|
||||
$index = isset($callbacks[$index + 1]) ? $index + 1 : 0;
|
||||
}
|
||||
|
||||
if (count($callbacks) > $valuesCount) {
|
||||
throw new OutOfRangeException('Sequence expectations are more than the iterable items.');
|
||||
}
|
||||
|
||||
return $this;
|
||||
@ -210,8 +250,8 @@ final class Expectation
|
||||
*
|
||||
* @template TMatchSubject of array-key
|
||||
*
|
||||
* @param (callable(): TMatchSubject)|TMatchSubject $subject
|
||||
* @param array<TMatchSubject, (callable(self<TValue>): mixed)|TValue> $expressions
|
||||
* @param (callable(): TMatchSubject)|TMatchSubject $subject
|
||||
* @param array<TMatchSubject, (callable(self<TValue>): mixed)|TValue> $expressions
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function match(mixed $subject, array $expressions): self
|
||||
@ -248,7 +288,7 @@ final class Expectation
|
||||
/**
|
||||
* Apply the callback if the given "condition" is falsy.
|
||||
*
|
||||
* @param (callable(): bool)|bool $condition
|
||||
* @param (callable(): bool)|bool $condition
|
||||
* @param callable(Expectation<TValue>): mixed $callback
|
||||
* @return self<TValue>
|
||||
*/
|
||||
@ -264,7 +304,7 @@ final class Expectation
|
||||
/**
|
||||
* Apply the callback if the given "condition" is truthy.
|
||||
*
|
||||
* @param (callable(): bool)|bool $condition
|
||||
* @param (callable(): bool)|bool $condition
|
||||
* @param callable(self<TValue>): mixed $callback
|
||||
* @return self<TValue>
|
||||
*/
|
||||
@ -287,9 +327,23 @@ final class Expectation
|
||||
* @param array<int, mixed> $parameters
|
||||
* @return Expectation<TValue>|HigherOrderExpectation<Expectation<TValue>, TValue>
|
||||
*/
|
||||
public function __call(string $method, array $parameters): Expectation|HigherOrderExpectation
|
||||
public function __call(string $method, array $parameters): Expectation|HigherOrderExpectation|PendingArchExpectation
|
||||
{
|
||||
if (! self::hasMethod($method)) {
|
||||
if (! is_object($this->value) && method_exists(PendingArchExpectation::class, $method)) {
|
||||
$pendingArchExpectation = new PendingArchExpectation($this, []);
|
||||
|
||||
return $pendingArchExpectation->$method(...$parameters); // @phpstan-ignore-line
|
||||
}
|
||||
|
||||
if (! is_object($this->value)) {
|
||||
throw new BadMethodCallException(sprintf(
|
||||
'Method "%s" does not exist in %s.',
|
||||
$method,
|
||||
gettype($this->value)
|
||||
));
|
||||
}
|
||||
|
||||
/* @phpstan-ignore-next-line */
|
||||
return new HigherOrderExpectation($this, call_user_func_array($this->value->$method(...), $parameters));
|
||||
}
|
||||
@ -333,6 +387,11 @@ final class Expectation
|
||||
public function __get(string $name)
|
||||
{
|
||||
if (! self::hasMethod($name)) {
|
||||
if (! is_object($this->value) && method_exists(PendingArchExpectation::class, $name)) {
|
||||
/* @phpstan-ignore-next-line */
|
||||
return $this->{$name}();
|
||||
}
|
||||
|
||||
/* @phpstan-ignore-next-line */
|
||||
return new HigherOrderExpectation($this, $this->retrieve($name, $this->value));
|
||||
}
|
||||
@ -369,6 +428,252 @@ final class Expectation
|
||||
return ToUse::make($this, $targets);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target use the "declare(strict_types=1)" declaration.
|
||||
*/
|
||||
public function toUseStrictTypes(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => str_contains((string) file_get_contents($object->path), 'declare(strict_types=1);'),
|
||||
'to use strict types',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, '<?php')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is final.
|
||||
*/
|
||||
public function toBeFinal(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => ! enum_exists($object->name) && $object->reflectionClass->isFinal(),
|
||||
'to be final',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is readonly.
|
||||
*/
|
||||
public function toBeReadonly(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => ! enum_exists($object->name) && $object->reflectionClass->isReadOnly() && assert(true), // @phpstan-ignore-line
|
||||
'to be readonly',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is trait.
|
||||
*/
|
||||
public function toBeTrait(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->isTrait(),
|
||||
'to be trait',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are traits.
|
||||
*/
|
||||
public function toBeTraits(): ArchExpectation
|
||||
{
|
||||
return $this->toBeTrait();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is abstract.
|
||||
*/
|
||||
public function toBeAbstract(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->isAbstract(),
|
||||
'to be abstract',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is enum.
|
||||
*/
|
||||
public function toBeEnum(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->isEnum(),
|
||||
'to be enum',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are enums.
|
||||
*/
|
||||
public function toBeEnums(): ArchExpectation
|
||||
{
|
||||
return $this->toBeEnum();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets is an class.
|
||||
*/
|
||||
public function toBeClass(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => class_exists($object->name) && ! enum_exists($object->name),
|
||||
'to be class',
|
||||
FileLineFinder::where(fn (string $line): bool => true),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are classes.
|
||||
*/
|
||||
public function toBeClasses(): ArchExpectation
|
||||
{
|
||||
return $this->toBeClass();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is interface.
|
||||
*/
|
||||
public function toBeInterface(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->isInterface(),
|
||||
'to be interface',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are interfaces.
|
||||
*/
|
||||
public function toBeInterfaces(): ArchExpectation
|
||||
{
|
||||
return $this->toBeInterface();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to be subclass of the given class.
|
||||
*
|
||||
* @param class-string $class
|
||||
*/
|
||||
public function toExtend(string $class): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $class === $object->reflectionClass->getName() || $object->reflectionClass->isSubclassOf($class),
|
||||
sprintf("to extend '%s'", $class),
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to be have a parent class.
|
||||
*/
|
||||
public function toExtendNothing(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->getParentClass() === false,
|
||||
'to extend nothing',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to not implement any interfaces.
|
||||
*/
|
||||
public function toImplementNothing(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->getInterfaceNames() === [],
|
||||
'to implement nothing',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to only implement the given interfaces.
|
||||
*
|
||||
* @param array<int, class-string>|class-string $interfaces
|
||||
*/
|
||||
public function toOnlyImplement(array|string $interfaces): ArchExpectation
|
||||
{
|
||||
$interfaces = is_array($interfaces) ? $interfaces : [$interfaces];
|
||||
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => count($interfaces) === count($object->reflectionClass->getInterfaceNames())
|
||||
&& array_diff($interfaces, $object->reflectionClass->getInterfaceNames()) === [],
|
||||
"to only implement '".implode("', '", $interfaces)."'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to have the given prefix.
|
||||
*/
|
||||
public function toHavePrefix(string $prefix): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => str_starts_with($object->reflectionClass->getShortName(), $prefix),
|
||||
"to have prefix '{$prefix}'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to have the given suffix.
|
||||
*/
|
||||
public function toHaveSuffix(string $suffix): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => str_ends_with($object->reflectionClass->getName(), $suffix),
|
||||
"to have suffix '{$suffix}'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to implement the given interfaces.
|
||||
*
|
||||
* @param array<int, class-string>|class-string $interfaces
|
||||
*/
|
||||
public function toImplement(array|string $interfaces): ArchExpectation
|
||||
{
|
||||
$interfaces = is_array($interfaces) ? $interfaces : [$interfaces];
|
||||
|
||||
return Targeted::make(
|
||||
$this,
|
||||
function (ObjectDescription $object) use ($interfaces): bool {
|
||||
foreach ($interfaces as $interface) {
|
||||
if (! $object->reflectionClass->implementsInterface($interface)) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
},
|
||||
"to implement '".implode("', '", $interfaces)."'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target "only" use on the given dependencies.
|
||||
*
|
||||
@ -419,4 +724,113 @@ final class Expectation
|
||||
{
|
||||
return ToBeUsedInNothing::make($this);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation dependency is an invokable class.
|
||||
*/
|
||||
public function toBeInvokable(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->hasMethod('__invoke'),
|
||||
'to be invokable',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class'))
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation is iterable and contains snake_case keys.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toHaveSnakeCaseKeys(string $message = ''): self
|
||||
{
|
||||
if (! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('iterable');
|
||||
}
|
||||
|
||||
foreach ($this->value as $k => $item) {
|
||||
if (is_string($k)) {
|
||||
$this->and($k)->toBeSnakeCase($message);
|
||||
}
|
||||
|
||||
if (is_array($item)) {
|
||||
$this->and($item)->toHaveSnakeCaseKeys($message);
|
||||
}
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation is iterable and contains kebab-case keys.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toHaveKebabCaseKeys(string $message = ''): self
|
||||
{
|
||||
if (! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('iterable');
|
||||
}
|
||||
|
||||
foreach ($this->value as $k => $item) {
|
||||
if (is_string($k)) {
|
||||
$this->and($k)->toBeKebabCase($message);
|
||||
}
|
||||
|
||||
if (is_array($item)) {
|
||||
$this->and($item)->toHaveKebabCaseKeys($message);
|
||||
}
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation is iterable and contains camelCase keys.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toHaveCamelCaseKeys(string $message = ''): self
|
||||
{
|
||||
if (! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('iterable');
|
||||
}
|
||||
|
||||
foreach ($this->value as $k => $item) {
|
||||
if (is_string($k)) {
|
||||
$this->and($k)->toBeCamelCase($message);
|
||||
}
|
||||
|
||||
if (is_array($item)) {
|
||||
$this->and($item)->toHaveCamelCaseKeys($message);
|
||||
}
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation is iterable and contains StudlyCase keys.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toHaveStudlyCaseKeys(string $message = ''): self
|
||||
{
|
||||
if (! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('iterable');
|
||||
}
|
||||
|
||||
foreach ($this->value as $k => $item) {
|
||||
if (is_string($k)) {
|
||||
$this->and($k)->toBeStudlyCase($message);
|
||||
}
|
||||
|
||||
if (is_array($item)) {
|
||||
$this->and($item)->toHaveStudlyCaseKeys($message);
|
||||
}
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
|
||||
@ -4,9 +4,10 @@ declare(strict_types=1);
|
||||
|
||||
namespace Pest\Expectations;
|
||||
|
||||
use function expect;
|
||||
use Pest\Expectation;
|
||||
|
||||
use function expect;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*
|
||||
|
||||
@ -5,15 +5,20 @@ declare(strict_types=1);
|
||||
namespace Pest\Expectations;
|
||||
|
||||
use Pest\Arch\Contracts\ArchExpectation;
|
||||
use Pest\Arch\Expectations\Targeted;
|
||||
use Pest\Arch\Expectations\ToBeUsedIn;
|
||||
use Pest\Arch\Expectations\ToBeUsedInNothing;
|
||||
use Pest\Arch\Expectations\ToUse;
|
||||
use Pest\Arch\GroupArchExpectation;
|
||||
use Pest\Arch\PendingArchExpectation;
|
||||
use Pest\Arch\SingleArchExpectation;
|
||||
use Pest\Arch\Support\FileLineFinder;
|
||||
use Pest\Exceptions\InvalidExpectation;
|
||||
use Pest\Expectation;
|
||||
use Pest\Support\Arr;
|
||||
use Pest\Support\Exporter;
|
||||
use PHPUnit\Architecture\Elements\ObjectDescription;
|
||||
use PHPUnit\Framework\AssertionFailedError;
|
||||
use PHPUnit\Framework\ExpectationFailedException;
|
||||
|
||||
/**
|
||||
@ -72,6 +77,246 @@ final class OppositeExpectation
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target does not use the "declare(strict_types=1)" declaration.
|
||||
*/
|
||||
public function toUseStrictTypes(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! str_contains((string) file_get_contents($object->path), 'declare(strict_types=1);'),
|
||||
'not to use strict types',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, '<?php')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not final.
|
||||
*/
|
||||
public function toBeFinal(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! enum_exists($object->name) && ! $object->reflectionClass->isFinal(),
|
||||
'not to be final',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not readonly.
|
||||
*/
|
||||
public function toBeReadonly(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! enum_exists($object->name) && ! $object->reflectionClass->isReadOnly() && assert(true), // @phpstan-ignore-line
|
||||
'not to be readonly',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not trait.
|
||||
*/
|
||||
public function toBeTrait(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->isTrait(),
|
||||
'not to be trait',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are not traits.
|
||||
*/
|
||||
public function toBeTraits(): ArchExpectation
|
||||
{
|
||||
return $this->toBeTrait();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not abstract.
|
||||
*/
|
||||
public function toBeAbstract(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->isAbstract(),
|
||||
'not to be abstract',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not enum.
|
||||
*/
|
||||
public function toBeEnum(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->isEnum(),
|
||||
'not to be enum',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are not enums.
|
||||
*/
|
||||
public function toBeEnums(): ArchExpectation
|
||||
{
|
||||
return $this->toBeEnum();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets is an class.
|
||||
*/
|
||||
public function toBeClass(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! class_exists($object->name),
|
||||
'not to be class',
|
||||
FileLineFinder::where(fn (string $line): bool => true),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are not classes.
|
||||
*/
|
||||
public function toBeClasses(): ArchExpectation
|
||||
{
|
||||
return $this->toBeClass();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target is not interface.
|
||||
*/
|
||||
public function toBeInterface(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->isInterface(),
|
||||
'not to be interface',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation targets are not interfaces.
|
||||
*/
|
||||
public function toBeInterfaces(): ArchExpectation
|
||||
{
|
||||
return $this->toBeInterface();
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to be subclass of the given class.
|
||||
*
|
||||
* @param class-string $class
|
||||
*/
|
||||
public function toExtend(string $class): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->isSubclassOf($class),
|
||||
sprintf("not to extend '%s'", $class),
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to be not have any parent class.
|
||||
*/
|
||||
public function toExtendNothing(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->getParentClass() !== false,
|
||||
'to extend a class',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target not to implement the given interfaces.
|
||||
*
|
||||
* @param array<int, class-string>|string $interfaces
|
||||
*/
|
||||
public function toImplement(array|string $interfaces): ArchExpectation
|
||||
{
|
||||
$interfaces = is_array($interfaces) ? $interfaces : [$interfaces];
|
||||
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
function (ObjectDescription $object) use ($interfaces): bool {
|
||||
foreach ($interfaces as $interface) {
|
||||
if ($object->reflectionClass->implementsInterface($interface)) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
},
|
||||
"not to implement '".implode("', '", $interfaces)."'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to not implement any interfaces.
|
||||
*/
|
||||
public function toImplementNothing(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => $object->reflectionClass->getInterfaceNames() !== [],
|
||||
'to implement an interface',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Not supported.
|
||||
*
|
||||
* @param array<int, class-string>|string $interfaces
|
||||
*/
|
||||
public function toOnlyImplement(array|string $interfaces): never
|
||||
{
|
||||
throw InvalidExpectation::fromMethods(['not', 'toOnlyImplement']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to not have the given prefix.
|
||||
*/
|
||||
public function toHavePrefix(string $prefix): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! str_starts_with($object->reflectionClass->getShortName(), $prefix),
|
||||
"not to have prefix '{$prefix}'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation target to not have the given suffix.
|
||||
*/
|
||||
public function toHaveSuffix(string $suffix): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! str_ends_with($object->reflectionClass->getName(), $suffix),
|
||||
"not to have suffix '{$suffix}'",
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class')),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Not supported.
|
||||
*
|
||||
* @param array<int, string>|string $targets
|
||||
*/
|
||||
public function toOnlyUse(array|string $targets): never
|
||||
@ -79,6 +324,9 @@ final class OppositeExpectation
|
||||
throw InvalidExpectation::fromMethods(['not', 'toOnlyUse']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Not supported.
|
||||
*/
|
||||
public function toUseNothing(): never
|
||||
{
|
||||
throw InvalidExpectation::fromMethods(['not', 'toUseNothing']);
|
||||
@ -117,6 +365,19 @@ final class OppositeExpectation
|
||||
throw InvalidExpectation::fromMethods(['not', 'toBeUsedInNothing']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the given expectation dependency is not an invokable class.
|
||||
*/
|
||||
public function toBeInvokable(): ArchExpectation
|
||||
{
|
||||
return Targeted::make(
|
||||
$this->original,
|
||||
fn (ObjectDescription $object): bool => ! $object->reflectionClass->hasMethod('__invoke'),
|
||||
'to not be invokable',
|
||||
FileLineFinder::where(fn (string $line): bool => str_contains($line, 'class'))
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle dynamic method calls into the original expectation.
|
||||
*
|
||||
@ -126,9 +387,13 @@ final class OppositeExpectation
|
||||
public function __call(string $name, array $arguments): Expectation
|
||||
{
|
||||
try {
|
||||
if (! is_object($this->original->value) && method_exists(PendingArchExpectation::class, $name)) {
|
||||
throw InvalidExpectation::fromMethods(['not', $name]);
|
||||
}
|
||||
|
||||
/* @phpstan-ignore-next-line */
|
||||
$this->original->{$name}(...$arguments);
|
||||
} catch (ExpectationFailedException) {
|
||||
} catch (ExpectationFailedException|AssertionFailedError) {
|
||||
return $this->original;
|
||||
}
|
||||
|
||||
@ -143,8 +408,12 @@ final class OppositeExpectation
|
||||
public function __get(string $name): Expectation
|
||||
{
|
||||
try {
|
||||
if (! is_object($this->original->value) && method_exists(PendingArchExpectation::class, $name)) {
|
||||
throw InvalidExpectation::fromMethods(['not', $name]);
|
||||
}
|
||||
|
||||
$this->original->{$name}; // @phpstan-ignore-line
|
||||
} catch (ExpectationFailedException) { // @phpstan-ignore-line
|
||||
} catch (ExpectationFailedException) {
|
||||
return $this->original;
|
||||
}
|
||||
|
||||
@ -162,8 +431,13 @@ final class OppositeExpectation
|
||||
|
||||
$exporter = Exporter::default();
|
||||
|
||||
$toString = fn ($argument): string => $exporter->shortenedExport($argument);
|
||||
$toString = fn (mixed $argument): string => $exporter->shortenedExport($argument);
|
||||
|
||||
throw new ExpectationFailedException(sprintf('Expecting %s not %s %s.', $toString($this->original->value), strtolower((string) preg_replace('/(?<!\ )[A-Z]/', ' $0', $name)), implode(' ', array_map(fn ($argument): string => $toString($argument), $arguments))));
|
||||
throw new ExpectationFailedException(sprintf(
|
||||
'Expecting %s not %s %s.',
|
||||
$toString($this->original->value),
|
||||
strtolower((string) preg_replace('/(?<!\ )[A-Z]/', ' $0', $name)),
|
||||
implode(' ', array_map(fn (mixed $argument): string => $toString($argument), $arguments)),
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
@ -20,7 +20,7 @@ abstract class Attribute
|
||||
* @param array<int, string> $attributes
|
||||
* @return array<int, string>
|
||||
*/
|
||||
public function __invoke(TestCaseMethodFactory $method, array $attributes): array // @phpstan-ignore-line
|
||||
public function __invoke(TestCaseMethodFactory $method, array $attributes): array // @phpstan-ignore-line
|
||||
{
|
||||
return $attributes;
|
||||
}
|
||||
|
||||
@ -98,7 +98,7 @@ final class TestCaseFactory
|
||||
{
|
||||
if ('\\' === DIRECTORY_SEPARATOR) {
|
||||
// In case Windows, strtolower drive name, like in UsesCall.
|
||||
$filename = (string) preg_replace_callback('~^(?P<drive>[a-z]+:\\\)~i', static fn ($match): string => strtolower($match['drive']), $filename);
|
||||
$filename = (string) preg_replace_callback('~^(?P<drive>[a-z]+:\\\)~i', static fn (array $match): string => strtolower($match['drive']), $filename);
|
||||
}
|
||||
|
||||
$filename = str_replace('\\\\', '\\', addslashes((string) realpath($filename)));
|
||||
@ -134,7 +134,7 @@ final class TestCaseFactory
|
||||
|
||||
$hasPrintableTestCaseClassFQN = sprintf('\%s', HasPrintableTestCaseName::class);
|
||||
$traitsCode = sprintf('use %s;', implode(', ', array_map(
|
||||
static fn ($trait): string => sprintf('\%s', $trait), $this->traits))
|
||||
static fn (string $trait): string => sprintf('\%s', $trait), $this->traits))
|
||||
);
|
||||
|
||||
$partsFQN = explode('\\', $classFQN);
|
||||
|
||||
@ -22,40 +22,50 @@ final class TestCaseMethodFactory
|
||||
use HigherOrderable;
|
||||
|
||||
/**
|
||||
* Determines if the Test Case Method is a "todo".
|
||||
* The test's describing, if any.
|
||||
*/
|
||||
public ?string $describing = null;
|
||||
|
||||
/**
|
||||
* The test's number of repetitions.
|
||||
*/
|
||||
public int $repetitions = 1;
|
||||
|
||||
/**
|
||||
* Determines if the test is a "todo".
|
||||
*/
|
||||
public bool $todo = false;
|
||||
|
||||
/**
|
||||
* The Test Case Dataset, if any.
|
||||
* The test's datasets.
|
||||
*
|
||||
* @var array<Closure|iterable<int|string, mixed>|string>
|
||||
*/
|
||||
public array $datasets = [];
|
||||
|
||||
/**
|
||||
* The Test Case depends, if any.
|
||||
* The test's dependencies.
|
||||
*
|
||||
* @var array<int, string>
|
||||
*/
|
||||
public array $depends = [];
|
||||
|
||||
/**
|
||||
* The Test Case groups, if any.
|
||||
* The test's groups.
|
||||
*
|
||||
* @var array<int, string>
|
||||
*/
|
||||
public array $groups = [];
|
||||
|
||||
/**
|
||||
* The covered classes and functions, if any.
|
||||
* The covered classes and functions.
|
||||
*
|
||||
* @var array<int, \Pest\Factories\Covers\CoversClass|\Pest\Factories\Covers\CoversFunction|\Pest\Factories\Covers\CoversNothing>
|
||||
*/
|
||||
public array $covers = [];
|
||||
|
||||
/**
|
||||
* Creates a new Factory instance.
|
||||
* Creates a new test case method factory instance.
|
||||
*/
|
||||
public function __construct(
|
||||
public string $filename,
|
||||
@ -70,7 +80,7 @@ final class TestCaseMethodFactory
|
||||
}
|
||||
|
||||
/**
|
||||
* Makes the Test Case classes.
|
||||
* Creates the test's closure.
|
||||
*/
|
||||
public function getClosure(TestCase $concrete): Closure
|
||||
{
|
||||
@ -135,18 +145,18 @@ final class TestCaseMethodFactory
|
||||
$attributes = (new $attribute())->__invoke($this, $attributes);
|
||||
}
|
||||
|
||||
if ($this->datasets !== []) {
|
||||
if ($this->datasets !== [] || $this->repetitions > 1) {
|
||||
$dataProviderName = $methodName.'_dataset';
|
||||
$annotations[] = "@dataProvider $dataProviderName";
|
||||
$datasetsCode = $this->buildDatasetForEvaluation($methodName, $dataProviderName);
|
||||
}
|
||||
|
||||
$annotations = implode('', array_map(
|
||||
static fn ($annotation): string => sprintf("\n * %s", $annotation), $annotations,
|
||||
static fn (string $annotation): string => sprintf("\n * %s", $annotation), $annotations,
|
||||
));
|
||||
|
||||
$attributes = implode('', array_map(
|
||||
static fn ($attribute): string => sprintf("\n %s", $attribute), $attributes,
|
||||
static fn (string $attribute): string => sprintf("\n %s", $attribute), $attributes,
|
||||
));
|
||||
|
||||
return <<<PHP
|
||||
@ -172,7 +182,13 @@ final class TestCaseMethodFactory
|
||||
*/
|
||||
private function buildDatasetForEvaluation(string $methodName, string $dataProviderName): string
|
||||
{
|
||||
DatasetsRepository::with($this->filename, $methodName, $this->datasets);
|
||||
$datasets = $this->datasets;
|
||||
|
||||
if ($this->repetitions > 1) {
|
||||
$datasets = [range(1, $this->repetitions), ...$datasets];
|
||||
}
|
||||
|
||||
DatasetsRepository::with($this->filename, $methodName, $datasets);
|
||||
|
||||
return <<<EOF
|
||||
|
||||
|
||||
@ -2,9 +2,13 @@
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
use Pest\Concerns\Expectable;
|
||||
use Pest\Exceptions\AfterAllWithinDescribe;
|
||||
use Pest\Exceptions\BeforeAllWithinDescribe;
|
||||
use Pest\Expectation;
|
||||
use Pest\PendingCalls\AfterEachCall;
|
||||
use Pest\PendingCalls\BeforeEachCall;
|
||||
use Pest\PendingCalls\DescribeCall;
|
||||
use Pest\PendingCalls\TestCall;
|
||||
use Pest\PendingCalls\UsesCall;
|
||||
use Pest\Repositories\DatasetsRepository;
|
||||
@ -35,6 +39,12 @@ if (! function_exists('beforeAll')) {
|
||||
*/
|
||||
function beforeAll(Closure $closure): void
|
||||
{
|
||||
if (! is_null(DescribeCall::describing())) {
|
||||
$filename = Backtrace::file();
|
||||
|
||||
throw new BeforeAllWithinDescribe($filename);
|
||||
}
|
||||
|
||||
TestSuite::getInstance()->beforeAll->set($closure);
|
||||
}
|
||||
}
|
||||
@ -43,7 +53,7 @@ if (! function_exists('beforeEach')) {
|
||||
/**
|
||||
* Runs the given closure before each test in the current file.
|
||||
*
|
||||
* @return HigherOrderTapProxy<TestCall|TestCase>|TestCall|TestCase|mixed
|
||||
* @return HigherOrderTapProxy<Expectable|TestCall|TestCase>|Expectable|TestCall|TestCase|mixed
|
||||
*/
|
||||
function beforeEach(Closure $closure = null): BeforeEachCall
|
||||
{
|
||||
@ -67,6 +77,22 @@ if (! function_exists('dataset')) {
|
||||
}
|
||||
}
|
||||
|
||||
if (! function_exists('describe')) {
|
||||
/**
|
||||
* Adds the given closure as a group of tests. The first argument
|
||||
* is the group description; the second argument is a closure
|
||||
* that contains the group tests.
|
||||
*
|
||||
* @return HigherOrderTapProxy<Expectable|TestCall|TestCase>|Expectable|TestCall|TestCase|mixed
|
||||
*/
|
||||
function describe(string $description, Closure $tests): DescribeCall
|
||||
{
|
||||
$filename = Backtrace::testFile();
|
||||
|
||||
return new DescribeCall(TestSuite::getInstance(), $filename, $description, $tests);
|
||||
}
|
||||
}
|
||||
|
||||
if (! function_exists('uses')) {
|
||||
/**
|
||||
* The uses function binds the given
|
||||
@ -88,7 +114,7 @@ if (! function_exists('test')) {
|
||||
* is the test description; the second argument is
|
||||
* a closure that contains the test expectations.
|
||||
*
|
||||
* @return TestCall|TestCase|mixed
|
||||
* @return Expectable|TestCall|TestCase|mixed
|
||||
*/
|
||||
function test(string $description = null, Closure $closure = null): HigherOrderTapProxy|TestCall
|
||||
{
|
||||
@ -108,7 +134,7 @@ if (! function_exists('it')) {
|
||||
* is the test description; the second argument is
|
||||
* a closure that contains the test expectations.
|
||||
*
|
||||
* @return TestCall|TestCase|mixed
|
||||
* @return Expectable|TestCall|TestCase|mixed
|
||||
*/
|
||||
function it(string $description, Closure $closure = null): TestCall
|
||||
{
|
||||
@ -127,7 +153,7 @@ if (! function_exists('todo')) {
|
||||
* is marked as incomplete. Yet, Collision, Pest's
|
||||
* printer, will display it as a "todo" test.
|
||||
*
|
||||
* @return TestCall|TestCase|mixed
|
||||
* @return Expectable|TestCall|TestCase|mixed
|
||||
*/
|
||||
function todo(string $description): TestCall
|
||||
{
|
||||
@ -143,7 +169,7 @@ if (! function_exists('afterEach')) {
|
||||
/**
|
||||
* Runs the given closure after each test in the current file.
|
||||
*
|
||||
* @return HigherOrderTapProxy<TestCall|TestCase>|TestCall|mixed
|
||||
* @return Expectable|HigherOrderTapProxy<Expectable|TestCall|TestCase>|TestCall|mixed
|
||||
*/
|
||||
function afterEach(Closure $closure = null): AfterEachCall
|
||||
{
|
||||
@ -159,6 +185,12 @@ if (! function_exists('afterAll')) {
|
||||
*/
|
||||
function afterAll(Closure $closure): void
|
||||
{
|
||||
if (! is_null(DescribeCall::describing())) {
|
||||
$filename = Backtrace::file();
|
||||
|
||||
throw new AfterAllWithinDescribe($filename);
|
||||
}
|
||||
|
||||
TestSuite::getInstance()->afterAll->set($closure);
|
||||
}
|
||||
}
|
||||
|
||||
@ -33,6 +33,7 @@ final class Kernel
|
||||
Bootstrappers\BootFiles::class,
|
||||
Bootstrappers\BootView::class,
|
||||
Bootstrappers\BootKernelDump::class,
|
||||
Bootstrappers\BootExcludeList::class,
|
||||
];
|
||||
|
||||
/**
|
||||
@ -67,10 +68,14 @@ final class Kernel
|
||||
|
||||
CallsBoot::execute();
|
||||
|
||||
return new self(
|
||||
$kernel = new self(
|
||||
new Application(),
|
||||
$output,
|
||||
);
|
||||
|
||||
Container::getInstance()->add(self::class, $kernel);
|
||||
|
||||
return $kernel;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@ -153,7 +153,7 @@ final class Converter
|
||||
/**
|
||||
* Gets the test suite location.
|
||||
*/
|
||||
public function getTestSuiteLocation(TestSuite $testSuite): string|null
|
||||
public function getTestSuiteLocation(TestSuite $testSuite): ?string
|
||||
{
|
||||
$tests = $testSuite->tests()->asArray();
|
||||
|
||||
|
||||
@ -9,7 +9,7 @@ namespace Pest\Logging\TeamCity;
|
||||
*/
|
||||
final class ServiceMessage
|
||||
{
|
||||
private static int|null $flowId = null;
|
||||
private static ?int $flowId = null;
|
||||
|
||||
/**
|
||||
* @param array<string, string|int|null> $parameters
|
||||
@ -25,14 +25,14 @@ final class ServiceMessage
|
||||
$paramsToString = '';
|
||||
|
||||
foreach ([...$this->parameters, 'flowId' => self::$flowId] as $key => $value) {
|
||||
$value = self::escapeServiceMessage((string) $value);
|
||||
$value = $this->escapeServiceMessage((string) $value);
|
||||
$paramsToString .= " $key='$value'";
|
||||
}
|
||||
|
||||
return "##teamcity[$this->type$paramsToString]";
|
||||
}
|
||||
|
||||
public static function testSuiteStarted(string $name, string|null $location): self
|
||||
public static function testSuiteStarted(string $name, ?string $location): self
|
||||
{
|
||||
return new self('testSuiteStarted', [
|
||||
'name' => $name,
|
||||
@ -127,7 +127,7 @@ final class ServiceMessage
|
||||
]);
|
||||
}
|
||||
|
||||
private static function escapeServiceMessage(string $text): string
|
||||
private function escapeServiceMessage(string $text): string
|
||||
{
|
||||
return str_replace(
|
||||
['|', "'", "\n", "\r", ']', '['],
|
||||
|
||||
@ -60,7 +60,7 @@ final class TeamCityLogger
|
||||
public function __construct(
|
||||
private readonly OutputInterface $output,
|
||||
private readonly Converter $converter,
|
||||
private readonly int|null $flowId,
|
||||
private readonly ?int $flowId,
|
||||
private readonly bool $withoutDuration,
|
||||
) {
|
||||
$this->registerSubscribers();
|
||||
|
||||
@ -6,20 +6,25 @@ namespace Pest\Mixins;
|
||||
|
||||
use BadMethodCallException;
|
||||
use Closure;
|
||||
use Countable;
|
||||
use DateTimeInterface;
|
||||
use Error;
|
||||
use InvalidArgumentException;
|
||||
use JsonSerializable;
|
||||
use Pest\Exceptions\InvalidExpectationValue;
|
||||
use Pest\Matchers\Any;
|
||||
use Pest\Support\Arr;
|
||||
use Pest\Support\Exporter;
|
||||
use Pest\Support\NullClosure;
|
||||
use Pest\TestSuite;
|
||||
use PHPUnit\Framework\Assert;
|
||||
use PHPUnit\Framework\Constraint\Constraint;
|
||||
use PHPUnit\Framework\ExpectationFailedException;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
use ReflectionFunction;
|
||||
use ReflectionNamedType;
|
||||
use Throwable;
|
||||
use Traversable;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
@ -33,7 +38,7 @@ final class Expectation
|
||||
/**
|
||||
* The exporter instance, if any.
|
||||
*/
|
||||
private Exporter|null $exporter = null;
|
||||
private ?Exporter $exporter = null;
|
||||
|
||||
/**
|
||||
* Creates a new expectation.
|
||||
@ -260,7 +265,7 @@ final class Expectation
|
||||
public function toHaveCount(int $count, string $message = ''): self
|
||||
{
|
||||
if (! is_countable($this->value) && ! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('string');
|
||||
InvalidExpectationValue::expected('countable|iterable');
|
||||
}
|
||||
|
||||
Assert::assertCount($count, $this->value, $message);
|
||||
@ -268,6 +273,23 @@ final class Expectation
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the size of the value and $expected are the same.
|
||||
*
|
||||
* @param Countable|iterable<mixed> $expected
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toHaveSameSize(Countable|iterable $expected, string $message = ''): self
|
||||
{
|
||||
if (! is_countable($this->value) && ! is_iterable($this->value)) {
|
||||
InvalidExpectationValue::expected('countable|iterable');
|
||||
}
|
||||
|
||||
Assert::assertSameSize($expected, $this->value, $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value contains the property $name.
|
||||
*
|
||||
@ -498,6 +520,18 @@ final class Expectation
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value contains only digits.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeDigits(string $message = ''): self
|
||||
{
|
||||
Assert::assertTrue(ctype_digit((string) $this->value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is of type object.
|
||||
*
|
||||
@ -794,6 +828,48 @@ final class Expectation
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value "stringable" matches the given snapshot..
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toMatchSnapshot(string $message = ''): self
|
||||
{
|
||||
$snapshots = TestSuite::getInstance()->snapshots;
|
||||
$snapshots->startNewExpectation();
|
||||
|
||||
$testCase = TestSuite::getInstance()->test;
|
||||
assert($testCase instanceof TestCase);
|
||||
|
||||
$string = match (true) {
|
||||
is_string($this->value) => $this->value,
|
||||
is_object($this->value) && method_exists($this->value, '__toString') => $this->value->__toString(),
|
||||
is_object($this->value) && method_exists($this->value, 'toString') => $this->value->toString(),
|
||||
$this->value instanceof \Illuminate\Testing\TestResponse => $this->value->getContent(), // @phpstan-ignore-line
|
||||
is_array($this->value) => json_encode($this->value, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT),
|
||||
$this->value instanceof Traversable => json_encode(iterator_to_array($this->value), JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT),
|
||||
$this->value instanceof JsonSerializable => json_encode($this->value->jsonSerialize(), JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT),
|
||||
is_object($this->value) && method_exists($this->value, 'toArray') => json_encode($this->value->toArray(), JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT),
|
||||
default => InvalidExpectationValue::expected('array|object|string'),
|
||||
};
|
||||
|
||||
if ($snapshots->has()) {
|
||||
[$filename, $content] = $snapshots->get();
|
||||
|
||||
Assert::assertSame(
|
||||
strtr($content, ["\r\n" => "\n", "\r" => "\n"]),
|
||||
strtr($string, ["\r\n" => "\n", "\r" => "\n"]),
|
||||
$message === '' ? "Failed asserting that the string value matches its snapshot ($filename)." : $message
|
||||
);
|
||||
} else {
|
||||
$filename = $snapshots->save($string);
|
||||
|
||||
TestSuite::getInstance()->registerSnapshotChange("Snapshot created at [$filename]");
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value matches a regular expression.
|
||||
*
|
||||
@ -839,7 +915,7 @@ final class Expectation
|
||||
/**
|
||||
* Asserts that executing value throws an exception.
|
||||
*
|
||||
* @param (Closure(Throwable): mixed)|string $exception
|
||||
* @param (Closure(Throwable): mixed)|string $exception
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toThrow(callable|string|Throwable $exception, string $exceptionMessage = null, string $message = ''): self
|
||||
@ -915,4 +991,124 @@ final class Expectation
|
||||
|
||||
return $this->exporter->shortenedExport($value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is uppercase.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeUppercase(string $message = ''): self
|
||||
{
|
||||
Assert::assertTrue(ctype_upper((string) $this->value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is lowercase.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeLowercase(string $message = ''): self
|
||||
{
|
||||
Assert::assertTrue(ctype_lower((string) $this->value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is alphanumeric.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeAlphaNumeric(string $message = ''): self
|
||||
{
|
||||
Assert::assertTrue(ctype_alnum((string) $this->value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is alpha.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeAlpha(string $message = ''): self
|
||||
{
|
||||
Assert::assertTrue(ctype_alpha((string) $this->value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is snake_case.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeSnakeCase(string $message = ''): self
|
||||
{
|
||||
$value = (string) $this->value;
|
||||
|
||||
if ($message === '') {
|
||||
$message = "Failed asserting that {$value} is snake_case.";
|
||||
}
|
||||
|
||||
Assert::assertTrue((bool) preg_match('/^[\p{Ll}_]+$/u', $value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is kebab-case.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeKebabCase(string $message = ''): self
|
||||
{
|
||||
$value = (string) $this->value;
|
||||
|
||||
if ($message === '') {
|
||||
$message = "Failed asserting that {$value} is kebab-case.";
|
||||
}
|
||||
|
||||
Assert::assertTrue((bool) preg_match('/^[\p{Ll}-]+$/u', $value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is camelCase.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeCamelCase(string $message = ''): self
|
||||
{
|
||||
$value = (string) $this->value;
|
||||
|
||||
if ($message === '') {
|
||||
$message = "Failed asserting that {$value} is camelCase.";
|
||||
}
|
||||
|
||||
Assert::assertTrue((bool) preg_match('/^\p{Ll}[\p{Ll}\p{Lu}]+$/u', $value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Asserts that the value is StudlyCase.
|
||||
*
|
||||
* @return self<TValue>
|
||||
*/
|
||||
public function toBeStudlyCase(string $message = ''): self
|
||||
{
|
||||
$value = (string) $this->value;
|
||||
|
||||
if ($message === '') {
|
||||
$message = "Failed asserting that {$value} is StudlyCase.";
|
||||
}
|
||||
|
||||
Assert::assertTrue((bool) preg_match('/^\p{Lu}+\p{Ll}[\p{Ll}\p{Lu}]+$/u', $value), $message);
|
||||
|
||||
return $this;
|
||||
}
|
||||
}
|
||||
|
||||
@ -5,6 +5,7 @@ declare(strict_types=1);
|
||||
namespace Pest\PendingCalls;
|
||||
|
||||
use Closure;
|
||||
use Pest\PendingCalls\Concerns\Describable;
|
||||
use Pest\Support\Backtrace;
|
||||
use Pest\Support\ChainableClosure;
|
||||
use Pest\Support\HigherOrderMessageCollection;
|
||||
@ -16,6 +17,8 @@ use Pest\TestSuite;
|
||||
*/
|
||||
final class AfterEachCall
|
||||
{
|
||||
use Describable;
|
||||
|
||||
/**
|
||||
* The "afterEach" closure.
|
||||
*/
|
||||
@ -37,6 +40,8 @@ final class AfterEachCall
|
||||
$this->closure = $closure instanceof Closure ? $closure : NullClosure::create();
|
||||
|
||||
$this->proxies = new HigherOrderMessageCollection();
|
||||
|
||||
$this->describing = DescribeCall::describing();
|
||||
}
|
||||
|
||||
/**
|
||||
@ -44,14 +49,23 @@ final class AfterEachCall
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
$describing = $this->describing;
|
||||
|
||||
$proxies = $this->proxies;
|
||||
|
||||
$afterEachTestCase = ChainableClosure::boundWhen(
|
||||
fn (): bool => is_null($describing) || $this->__describing === $describing, // @phpstan-ignore-line
|
||||
ChainableClosure::bound(fn () => $proxies->chain($this), $this->closure)->bindTo($this, self::class), // @phpstan-ignore-line
|
||||
)->bindTo($this, self::class);
|
||||
|
||||
assert($afterEachTestCase instanceof Closure);
|
||||
|
||||
$this->testSuite->afterEach->set(
|
||||
$this->filename,
|
||||
ChainableClosure::from(function () use ($proxies): void {
|
||||
$proxies->chain($this);
|
||||
}, $this->closure)
|
||||
$this,
|
||||
$afterEachTestCase,
|
||||
);
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@ -5,6 +5,7 @@ declare(strict_types=1);
|
||||
namespace Pest\PendingCalls;
|
||||
|
||||
use Closure;
|
||||
use Pest\PendingCalls\Concerns\Describable;
|
||||
use Pest\Support\Backtrace;
|
||||
use Pest\Support\ChainableClosure;
|
||||
use Pest\Support\HigherOrderMessageCollection;
|
||||
@ -16,6 +17,8 @@ use Pest\TestSuite;
|
||||
*/
|
||||
final class BeforeEachCall
|
||||
{
|
||||
use Describable;
|
||||
|
||||
/**
|
||||
* Holds the before each closure.
|
||||
*/
|
||||
@ -35,7 +38,7 @@ final class BeforeEachCall
|
||||
* Creates a new Pending Call.
|
||||
*/
|
||||
public function __construct(
|
||||
private readonly TestSuite $testSuite,
|
||||
public readonly TestSuite $testSuite,
|
||||
private readonly string $filename,
|
||||
Closure $closure = null
|
||||
) {
|
||||
@ -43,6 +46,8 @@ final class BeforeEachCall
|
||||
|
||||
$this->testCallProxies = new HigherOrderMessageCollection();
|
||||
$this->testCaseProxies = new HigherOrderMessageCollection();
|
||||
|
||||
$this->describing = DescribeCall::describing();
|
||||
}
|
||||
|
||||
/**
|
||||
@ -50,16 +55,31 @@ final class BeforeEachCall
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
$describing = $this->describing;
|
||||
$testCaseProxies = $this->testCaseProxies;
|
||||
|
||||
$beforeEachTestCall = function (TestCall $testCall) use ($describing): void {
|
||||
if ($describing !== $this->describing) {
|
||||
return;
|
||||
}
|
||||
if ($describing !== $testCall->describing) {
|
||||
return;
|
||||
}
|
||||
$this->testCallProxies->chain($testCall);
|
||||
};
|
||||
|
||||
$beforeEachTestCase = ChainableClosure::boundWhen(
|
||||
fn (): bool => is_null($describing) || $this->__describing === $describing, // @phpstan-ignore-line
|
||||
ChainableClosure::bound(fn () => $testCaseProxies->chain($this), $this->closure)->bindTo($this, self::class), // @phpstan-ignore-line
|
||||
)->bindTo($this, self::class);
|
||||
|
||||
assert($beforeEachTestCase instanceof Closure);
|
||||
|
||||
$this->testSuite->beforeEach->set(
|
||||
$this->filename,
|
||||
function (TestCall $testCall): void {
|
||||
$this->testCallProxies->chain($testCall);
|
||||
},
|
||||
ChainableClosure::from(function () use ($testCaseProxies): void {
|
||||
$testCaseProxies->chain($this);
|
||||
}, $this->closure),
|
||||
$this,
|
||||
$beforeEachTestCall,
|
||||
$beforeEachTestCase,
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
13
src/PendingCalls/Concerns/Describable.php
Normal file
13
src/PendingCalls/Concerns/Describable.php
Normal file
@ -0,0 +1,13 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\PendingCalls\Concerns;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
trait Describable
|
||||
{
|
||||
public ?string $describing = null;
|
||||
}
|
||||
70
src/PendingCalls/DescribeCall.php
Normal file
70
src/PendingCalls/DescribeCall.php
Normal file
@ -0,0 +1,70 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\PendingCalls;
|
||||
|
||||
use Closure;
|
||||
use Pest\Support\Backtrace;
|
||||
use Pest\TestSuite;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class DescribeCall
|
||||
{
|
||||
/**
|
||||
* The current describe call.
|
||||
*/
|
||||
private static ?string $describing = null;
|
||||
|
||||
/**
|
||||
* Creates a new Pending Call.
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly TestSuite $testSuite,
|
||||
public readonly string $filename,
|
||||
public readonly string $description,
|
||||
public readonly Closure $tests
|
||||
) {
|
||||
//
|
||||
}
|
||||
|
||||
/**
|
||||
* What is the current describing.
|
||||
*/
|
||||
public static function describing(): ?string
|
||||
{
|
||||
return self::$describing;
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates the Call.
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
self::$describing = $this->description;
|
||||
|
||||
try {
|
||||
($this->tests)();
|
||||
} finally {
|
||||
self::$describing = null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Dynamically calls methods on each test call.
|
||||
*
|
||||
* @param array<int, mixed> $arguments
|
||||
*/
|
||||
public function __call(string $name, array $arguments): BeforeEachCall
|
||||
{
|
||||
$filename = Backtrace::file();
|
||||
|
||||
$beforeEachCall = new BeforeEachCall(TestSuite::getInstance(), $filename);
|
||||
|
||||
$beforeEachCall->describing = $this->description;
|
||||
|
||||
return $beforeEachCall->{$name}(...$arguments); // @phpstan-ignore-line
|
||||
}
|
||||
}
|
||||
@ -5,11 +5,12 @@ declare(strict_types=1);
|
||||
namespace Pest\PendingCalls;
|
||||
|
||||
use Closure;
|
||||
use InvalidArgumentException;
|
||||
use Pest\Exceptions\InvalidArgumentException;
|
||||
use Pest\Factories\Covers\CoversClass;
|
||||
use Pest\Factories\Covers\CoversFunction;
|
||||
use Pest\Factories\Covers\CoversNothing;
|
||||
use Pest\Factories\TestCaseMethodFactory;
|
||||
use Pest\PendingCalls\Concerns\Describable;
|
||||
use Pest\Plugins\Only;
|
||||
use Pest\Support\Backtrace;
|
||||
use Pest\Support\Exporter;
|
||||
@ -25,10 +26,12 @@ use PHPUnit\Framework\TestCase;
|
||||
*/
|
||||
final class TestCall
|
||||
{
|
||||
use Describable;
|
||||
|
||||
/**
|
||||
* The Test Case Factory.
|
||||
*/
|
||||
private readonly TestCaseMethodFactory $testCaseMethod;
|
||||
public readonly TestCaseMethodFactory $testCaseMethod;
|
||||
|
||||
/**
|
||||
* If test call is descriptionLess.
|
||||
@ -48,7 +51,9 @@ final class TestCall
|
||||
|
||||
$this->descriptionLess = $description === null;
|
||||
|
||||
$this->testSuite->beforeEach->get($filename)[0]($this);
|
||||
$this->describing = DescribeCall::describing();
|
||||
|
||||
$this->testSuite->beforeEach->get($this->filename)[0]($this);
|
||||
}
|
||||
|
||||
/**
|
||||
@ -84,7 +89,7 @@ final class TestCall
|
||||
/**
|
||||
* Asserts that the test throws the given `$exceptionClass` when called if the given condition is true.
|
||||
*
|
||||
* @param (callable(): bool)|bool $condition
|
||||
* @param (callable(): bool)|bool $condition
|
||||
*/
|
||||
public function throwsIf(callable|bool $condition, string|int $exception, string $exceptionMessage = null, int $exceptionCode = null): self
|
||||
{
|
||||
@ -209,6 +214,20 @@ final class TestCall
|
||||
: $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Repeats the current test the given number of times.
|
||||
*/
|
||||
public function repeat(int $times): self
|
||||
{
|
||||
if ($times < 1) {
|
||||
throw new InvalidArgumentException('The number of repetitions must be greater than 0.');
|
||||
}
|
||||
|
||||
$this->testCaseMethod->repetitions = $times;
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the test as "todo".
|
||||
*/
|
||||
@ -316,12 +335,14 @@ final class TestCall
|
||||
private function addChain(string $file, int $line, string $name, array $arguments = null): self
|
||||
{
|
||||
$exporter = Exporter::default();
|
||||
|
||||
$this->testCaseMethod
|
||||
->chains
|
||||
->add($file, $line, $name, $arguments);
|
||||
|
||||
if ($this->descriptionLess) {
|
||||
Exporter::default();
|
||||
|
||||
if ($this->testCaseMethod->description !== null) {
|
||||
$this->testCaseMethod->description .= ' → ';
|
||||
}
|
||||
@ -338,6 +359,11 @@ final class TestCall
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
if (! is_null($this->describing)) {
|
||||
$this->testCaseMethod->describing = $this->describing;
|
||||
$this->testCaseMethod->description = sprintf('`%s` → %s', $this->describing, $this->testCaseMethod->description);
|
||||
}
|
||||
|
||||
$this->testSuite->tests->set($this->testCaseMethod);
|
||||
}
|
||||
}
|
||||
|
||||
@ -66,11 +66,11 @@ final class UsesCall
|
||||
*/
|
||||
public function in(string ...$targets): void
|
||||
{
|
||||
$targets = array_map(function ($path): string {
|
||||
$targets = array_map(function (string $path): string {
|
||||
$startChar = DIRECTORY_SEPARATOR;
|
||||
|
||||
if ('\\' === DIRECTORY_SEPARATOR || preg_match('~\A[A-Z]:(?![^/\\\\])~i', $path) > 0) {
|
||||
$path = (string) preg_replace_callback('~^(?P<drive>[a-z]+:\\\)~i', fn ($match): string => strtolower($match['drive']), $path);
|
||||
$path = (string) preg_replace_callback('~^(?P<drive>[a-z]+:\\\)~i', fn (array $match): string => strtolower($match['drive']), $path);
|
||||
|
||||
$startChar = strtolower((string) preg_replace('~^([a-z]+:\\\).*$~i', '$1', __DIR__));
|
||||
}
|
||||
@ -84,8 +84,10 @@ final class UsesCall
|
||||
}, $targets);
|
||||
|
||||
$this->targets = array_reduce($targets, function (array $accumulator, string $target): array {
|
||||
if (is_dir($target) || file_exists($target)) {
|
||||
$accumulator[] = (string) realpath($target);
|
||||
if (($matches = glob($target)) !== false) {
|
||||
foreach ($matches as $file) {
|
||||
$accumulator[] = (string) realpath($file);
|
||||
}
|
||||
}
|
||||
|
||||
return $accumulator;
|
||||
|
||||
@ -6,7 +6,7 @@ namespace Pest;
|
||||
|
||||
function version(): string
|
||||
{
|
||||
return '2.6.3';
|
||||
return '2.16.1';
|
||||
}
|
||||
|
||||
function testDirectory(string $file = ''): string
|
||||
|
||||
@ -44,6 +44,6 @@ trait HandleArguments
|
||||
|
||||
unset($arguments[$argument]);
|
||||
|
||||
return array_flip($arguments);
|
||||
return array_values(array_flip($arguments));
|
||||
}
|
||||
}
|
||||
|
||||
@ -50,7 +50,7 @@ final class Coverage implements AddsOutput, HandlesArguments
|
||||
*/
|
||||
public function handleArguments(array $originals): array
|
||||
{
|
||||
$arguments = [...[''], ...array_values(array_filter($originals, function ($original): bool {
|
||||
$arguments = [...[''], ...array_values(array_filter($originals, function (string $original): bool {
|
||||
foreach ([self::COVERAGE_OPTION, self::MIN_OPTION] as $option) {
|
||||
if ($original === sprintf('--%s', $option)) {
|
||||
return true;
|
||||
|
||||
@ -6,10 +6,11 @@ namespace Pest\Plugins;
|
||||
|
||||
use Pest\Contracts\Plugins\HandlesArguments;
|
||||
use Pest\Support\View;
|
||||
use function Pest\version;
|
||||
use PHPUnit\TextUI\Help as PHPUnitHelp;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
use function Pest\version;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
@ -107,6 +108,10 @@ final class Help implements HandlesArguments
|
||||
'arg' => '--parallel',
|
||||
'desc' => 'Run tests in parallel',
|
||||
],
|
||||
[
|
||||
'arg' => '--update-snapshots',
|
||||
'desc' => 'Update snapshots for tests using the "toMatchSnapshot" expectation',
|
||||
],
|
||||
], ...$content['Execution']];
|
||||
|
||||
$content['Selection'] = [[
|
||||
|
||||
@ -60,13 +60,13 @@ final class Init implements HandlesArguments
|
||||
|
||||
$this->init();
|
||||
|
||||
return array_values($arguments);
|
||||
exit(0);
|
||||
}
|
||||
|
||||
/**
|
||||
* Initializes the tests directory.
|
||||
*/
|
||||
private function init(): void
|
||||
public function init(): void
|
||||
{
|
||||
$testsBaseDir = "{$this->testSuite->rootPath}/tests";
|
||||
|
||||
@ -112,8 +112,6 @@ final class Init implements HandlesArguments
|
||||
View::render('components.new-line');
|
||||
|
||||
(new Thanks($this->input, $this->output))();
|
||||
|
||||
exit(0);
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@ -13,11 +13,12 @@ use Pest\Plugins\Parallel\Paratest\CleanConsoleOutput;
|
||||
use Pest\Support\Arr;
|
||||
use Pest\Support\Container;
|
||||
use Pest\TestSuite;
|
||||
use function Pest\version;
|
||||
use Stringable;
|
||||
use Symfony\Component\Console\Application;
|
||||
use Symfony\Component\Console\Input\ArgvInput;
|
||||
|
||||
use function Pest\version;
|
||||
|
||||
final class Parallel implements HandlesArguments
|
||||
{
|
||||
use HandleArguments;
|
||||
@ -115,13 +116,13 @@ final class Parallel implements HandlesArguments
|
||||
private function runTestSuiteInParallel(array $arguments): int
|
||||
{
|
||||
$handlers = array_filter(
|
||||
array_map(fn ($handler): object|string => Container::getInstance()->get($handler), self::HANDLERS),
|
||||
fn ($handler): bool => $handler instanceof HandlesArguments,
|
||||
array_map(fn (string $handler): object|string => Container::getInstance()->get($handler), self::HANDLERS),
|
||||
fn (object|string $handler): bool => $handler instanceof HandlesArguments,
|
||||
);
|
||||
|
||||
$filteredArguments = array_reduce(
|
||||
$handlers,
|
||||
fn ($arguments, HandlesArguments $handler): array => $handler->handleArguments($arguments),
|
||||
fn (array $arguments, HandlesArguments $handler): array => $handler->handleArguments($arguments),
|
||||
$arguments
|
||||
);
|
||||
|
||||
@ -139,13 +140,13 @@ final class Parallel implements HandlesArguments
|
||||
private function runWorkerHandlers(array $arguments): array
|
||||
{
|
||||
$handlers = array_filter(
|
||||
array_map(fn ($handler): object|string => Container::getInstance()->get($handler), self::HANDLERS),
|
||||
fn ($handler): bool => $handler instanceof HandlersWorkerArguments,
|
||||
array_map(fn (string $handler): object|string => Container::getInstance()->get($handler), self::HANDLERS),
|
||||
fn (object|string $handler): bool => $handler instanceof HandlersWorkerArguments,
|
||||
);
|
||||
|
||||
return array_reduce(
|
||||
$handlers,
|
||||
fn ($arguments, HandlersWorkerArguments $handler): array => $handler->handleWorkerArguments($arguments),
|
||||
fn (array $arguments, HandlersWorkerArguments $handler): array => $handler->handleWorkerArguments($arguments),
|
||||
$arguments
|
||||
);
|
||||
}
|
||||
|
||||
@ -30,7 +30,7 @@ final class Parallel implements HandlesArguments
|
||||
*/
|
||||
public function handleArguments(array $arguments): array
|
||||
{
|
||||
$args = array_reduce(self::ARGS_TO_REMOVE, fn ($args, $arg): array => $this->popArgument($arg, $args), $arguments);
|
||||
$args = array_reduce(self::ARGS_TO_REMOVE, fn (array $args, string $arg): array => $this->popArgument($arg, $args), $arguments);
|
||||
|
||||
return $this->pushArgument('--runner='.WrapperRunner::class, $args);
|
||||
}
|
||||
|
||||
@ -4,6 +4,16 @@ declare(strict_types=1);
|
||||
|
||||
namespace Pest\Plugins\Parallel\Paratest;
|
||||
|
||||
use ParaTest\Options;
|
||||
use Pest\Plugins\Parallel\Support\CompactPrinter;
|
||||
use Pest\Support\StateGenerator;
|
||||
use PHPUnit\TestRunner\TestResult\TestResult;
|
||||
use PHPUnit\TextUI\Output\Printer;
|
||||
use SebastianBergmann\Timer\Duration;
|
||||
use SplFileInfo;
|
||||
use Symfony\Component\Console\Formatter\OutputFormatter;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
use function assert;
|
||||
use function fclose;
|
||||
use function feof;
|
||||
@ -12,20 +22,11 @@ use function fread;
|
||||
use function fseek;
|
||||
use function ftell;
|
||||
use function fwrite;
|
||||
use NunoMaduro\Collision\Adapters\Phpunit\State;
|
||||
use ParaTest\Options;
|
||||
use Pest\Plugins\Parallel\Support\CompactPrinter;
|
||||
use Pest\Support\StateGenerator;
|
||||
use PHPUnit\TestRunner\TestResult\TestResult;
|
||||
use PHPUnit\TextUI\Output\Printer;
|
||||
use function preg_replace;
|
||||
use SebastianBergmann\Timer\Duration;
|
||||
use SplFileInfo;
|
||||
use function strlen;
|
||||
use Symfony\Component\Console\Formatter\OutputFormatter;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
/** @internal */
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class ResultPrinter
|
||||
{
|
||||
/**
|
||||
@ -51,7 +52,7 @@ final class ResultPrinter
|
||||
/** @var resource|null */
|
||||
private $teamcityLogFileHandle;
|
||||
|
||||
/** @var array<string, int> */
|
||||
/** @var array<non-empty-string, int> */
|
||||
private array $tailPositions;
|
||||
|
||||
public function __construct(
|
||||
@ -74,6 +75,7 @@ final class ResultPrinter
|
||||
if (str_starts_with($buffer, 'done [')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->output->write(OutputFormatter::escape($buffer));
|
||||
}
|
||||
|
||||
@ -93,9 +95,12 @@ final class ResultPrinter
|
||||
$this->teamcityLogFileHandle = $teamcityLogFileHandle;
|
||||
}
|
||||
|
||||
/** @param array<int, SplFileInfo> $teamcityFiles */
|
||||
public function printFeedback(SplFileInfo $progressFile, array $teamcityFiles): void
|
||||
{
|
||||
/** @param list<SplFileInfo> $teamcityFiles */
|
||||
public function printFeedback(
|
||||
SplFileInfo $progressFile,
|
||||
SplFileInfo $outputFile,
|
||||
array $teamcityFiles
|
||||
): void {
|
||||
if ($this->options->needsTeamcity) {
|
||||
$teamcityProgress = $this->tailMultiple($teamcityFiles);
|
||||
|
||||
@ -115,6 +120,15 @@ final class ResultPrinter
|
||||
return;
|
||||
}
|
||||
|
||||
$unexpectedOutput = $this->tail($outputFile);
|
||||
if ($unexpectedOutput !== '') {
|
||||
if (preg_match('/^T+$/', $unexpectedOutput) > 0) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->output->write($unexpectedOutput);
|
||||
}
|
||||
|
||||
$feedbackItems = $this->tail($progressFile);
|
||||
if ($feedbackItems === '') {
|
||||
return;
|
||||
@ -129,8 +143,8 @@ final class ResultPrinter
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<int, SplFileInfo> $teamcityFiles
|
||||
* @param array<int, SplFileInfo> $testdoxFiles
|
||||
* @param list<SplFileInfo> $teamcityFiles
|
||||
* @param list<SplFileInfo> $testdoxFiles
|
||||
*/
|
||||
public function printResults(TestResult $testResult, array $teamcityFiles, array $testdoxFiles, Duration $duration): void
|
||||
{
|
||||
@ -183,7 +197,7 @@ final class ResultPrinter
|
||||
$this->compactPrinter->descriptionItem($item);
|
||||
}
|
||||
|
||||
/** @param array<int, SplFileInfo> $files */
|
||||
/** @param list<SplFileInfo> $files */
|
||||
private function tailMultiple(array $files): string
|
||||
{
|
||||
$content = '';
|
||||
@ -201,6 +215,7 @@ final class ResultPrinter
|
||||
private function tail(SplFileInfo $file): string
|
||||
{
|
||||
$path = $file->getPathname();
|
||||
assert($path !== '');
|
||||
$handle = fopen($path, 'r');
|
||||
assert($handle !== false);
|
||||
$fseek = fseek($handle, $this->tailPositions[$path] ?? 0);
|
||||
|
||||
@ -4,15 +4,9 @@ declare(strict_types=1);
|
||||
|
||||
namespace Pest\Plugins\Parallel\Paratest;
|
||||
|
||||
use function array_merge;
|
||||
use function array_merge_recursive;
|
||||
use function array_shift;
|
||||
use function assert;
|
||||
use function count;
|
||||
use const DIRECTORY_SEPARATOR;
|
||||
use function dirname;
|
||||
use function file_get_contents;
|
||||
use function max;
|
||||
|
||||
use NunoMaduro\Collision\Adapters\Phpunit\Support\ResultReflection;
|
||||
use ParaTest\Coverage\CoverageMerger;
|
||||
use ParaTest\JUnit\LogMerger;
|
||||
use ParaTest\JUnit\Writer;
|
||||
@ -23,16 +17,26 @@ use ParaTest\WrapperRunner\WrapperWorker;
|
||||
use Pest\Result;
|
||||
use Pest\TestSuite;
|
||||
use PHPUnit\Event\Facade as EventFacade;
|
||||
use PHPUnit\Event\TestRunner\WarningTriggered;
|
||||
use PHPUnit\Runner\CodeCoverage;
|
||||
use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
|
||||
use PHPUnit\TestRunner\TestResult\TestResult;
|
||||
use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
|
||||
use PHPUnit\Util\ExcludeList;
|
||||
use function realpath;
|
||||
use SebastianBergmann\Timer\Timer;
|
||||
use SplFileInfo;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
use Symfony\Component\Process\PhpExecutableFinder;
|
||||
|
||||
use function array_merge;
|
||||
use function array_merge_recursive;
|
||||
use function array_shift;
|
||||
use function assert;
|
||||
use function count;
|
||||
use function dirname;
|
||||
use function file_get_contents;
|
||||
use function max;
|
||||
use function realpath;
|
||||
use function unlink;
|
||||
use function unserialize;
|
||||
use function usleep;
|
||||
@ -48,36 +52,39 @@ final class WrapperRunner implements RunnerInterface
|
||||
|
||||
private readonly Timer $timer;
|
||||
|
||||
/** @var array<int, string> */
|
||||
/** @var list<non-empty-string> */
|
||||
private array $pending = [];
|
||||
|
||||
private int $exitCode = -1;
|
||||
private int $exitcode = -1;
|
||||
|
||||
/** @var array<int,WrapperWorker> */
|
||||
/** @var array<positive-int,WrapperWorker> */
|
||||
private array $workers = [];
|
||||
|
||||
/** @var array<int,int> */
|
||||
private array $batches = [];
|
||||
|
||||
/** @var array<int, SplFileInfo> */
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $unexpectedOutputFiles = [];
|
||||
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $testresultFiles = [];
|
||||
|
||||
/** @var array<int, SplFileInfo> */
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $coverageFiles = [];
|
||||
|
||||
/** @var array<int, SplFileInfo> */
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $junitFiles = [];
|
||||
|
||||
/** @var array<int, SplFileInfo> */
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $teamcityFiles = [];
|
||||
|
||||
/** @var array<int, SplFileInfo> */
|
||||
/** @var list<SplFileInfo> */
|
||||
private array $testdoxFiles = [];
|
||||
|
||||
/** @var array<int, string> */
|
||||
/** @var non-empty-string[] */
|
||||
private readonly array $parameters;
|
||||
|
||||
private readonly CodeCoverageFilterRegistry $codeCoverageFilterRegistry;
|
||||
private CodeCoverageFilterRegistry $codeCoverageFilterRegistry;
|
||||
|
||||
public function __construct(
|
||||
private readonly Options $options,
|
||||
@ -86,11 +93,10 @@ final class WrapperRunner implements RunnerInterface
|
||||
$this->printer = new ResultPrinter($output, $options);
|
||||
$this->timer = new Timer();
|
||||
|
||||
$worker = realpath(
|
||||
$wrapper = realpath(
|
||||
dirname(__DIR__, 4).DIRECTORY_SEPARATOR.'bin'.DIRECTORY_SEPARATOR.'worker.php',
|
||||
);
|
||||
|
||||
assert($worker !== false);
|
||||
assert($wrapper !== false);
|
||||
$phpFinder = new PhpExecutableFinder();
|
||||
$phpBin = $phpFinder->find(false);
|
||||
assert($phpBin !== false);
|
||||
@ -101,7 +107,7 @@ final class WrapperRunner implements RunnerInterface
|
||||
$parameters = array_merge($parameters, $options->passthruPhp);
|
||||
}
|
||||
|
||||
$parameters[] = $worker;
|
||||
$parameters[] = $wrapper;
|
||||
|
||||
$this->parameters = $parameters;
|
||||
$this->codeCoverageFilterRegistry = new CodeCoverageFilterRegistry();
|
||||
@ -110,14 +116,15 @@ final class WrapperRunner implements RunnerInterface
|
||||
public function run(): int
|
||||
{
|
||||
$directory = dirname(__DIR__);
|
||||
assert(strlen($directory) > 0);
|
||||
assert($directory !== '');
|
||||
ExcludeList::addDirectory($directory);
|
||||
|
||||
TestResultFacade::init();
|
||||
|
||||
EventFacade::instance()->seal();
|
||||
|
||||
$suiteLoader = new SuiteLoader($this->options, $this->output, $this->codeCoverageFilterRegistry);
|
||||
$suiteLoader = new SuiteLoader(
|
||||
$this->options,
|
||||
$this->output,
|
||||
$this->codeCoverageFilterRegistry,
|
||||
);
|
||||
$this->pending = $this->getTestFiles($suiteLoader);
|
||||
|
||||
$result = TestResultFacade::result();
|
||||
@ -142,7 +149,7 @@ final class WrapperRunner implements RunnerInterface
|
||||
{
|
||||
$batchSize = $this->options->maxBatchSize;
|
||||
|
||||
while ($this->pending !== [] && $this->workers !== []) {
|
||||
while (count($this->pending) > 0 && count($this->workers) > 0) {
|
||||
foreach ($this->workers as $token => $worker) {
|
||||
if (! $worker->isRunning()) {
|
||||
throw $worker->getWorkerCrashedException();
|
||||
@ -160,13 +167,11 @@ final class WrapperRunner implements RunnerInterface
|
||||
}
|
||||
|
||||
if (
|
||||
$this->exitCode > 0
|
||||
$this->exitcode > 0
|
||||
&& $this->options->configuration->stopOnFailure()
|
||||
) {
|
||||
$this->pending = [];
|
||||
} elseif (($pending = array_shift($this->pending)) !== null) {
|
||||
$this->debug(sprintf('Assigning %s to worker %d', $pending, $token));
|
||||
|
||||
$worker->assign($pending);
|
||||
$this->batches[$token]++;
|
||||
}
|
||||
@ -178,9 +183,10 @@ final class WrapperRunner implements RunnerInterface
|
||||
|
||||
private function flushWorker(WrapperWorker $worker): void
|
||||
{
|
||||
$this->exitCode = max($this->exitCode, $worker->getExitCode());
|
||||
$this->exitcode = max($this->exitcode, $worker->getExitCode());
|
||||
$this->printer->printFeedback(
|
||||
$worker->progressFile,
|
||||
$worker->unexpectedOutputFile,
|
||||
$this->teamcityFiles,
|
||||
);
|
||||
$worker->reset();
|
||||
@ -189,10 +195,10 @@ final class WrapperRunner implements RunnerInterface
|
||||
private function waitForAllToFinish(): void
|
||||
{
|
||||
$stopped = [];
|
||||
while ($this->workers !== []) {
|
||||
while (count($this->workers) > 0) {
|
||||
foreach ($this->workers as $index => $worker) {
|
||||
if ($worker->isRunning()) {
|
||||
if (! array_key_exists($index, $stopped) && $worker->isFree()) {
|
||||
if (! isset($stopped[$index]) && $worker->isFree()) {
|
||||
$worker->stop();
|
||||
$stopped[$index] = true;
|
||||
}
|
||||
@ -212,22 +218,19 @@ final class WrapperRunner implements RunnerInterface
|
||||
}
|
||||
}
|
||||
|
||||
/** @param positive-int $token */
|
||||
private function startWorker(int $token): WrapperWorker
|
||||
{
|
||||
/** @var array<non-empty-string> $parameters */
|
||||
$parameters = $this->parameters;
|
||||
|
||||
$worker = new WrapperWorker(
|
||||
$this->output,
|
||||
$this->options,
|
||||
$parameters,
|
||||
$this->parameters,
|
||||
$token,
|
||||
);
|
||||
|
||||
$worker->start();
|
||||
|
||||
$this->batches[$token] = 0;
|
||||
|
||||
$this->unexpectedOutputFiles[] = $worker->unexpectedOutputFile;
|
||||
$this->testresultFiles[] = $worker->testresultFile;
|
||||
|
||||
if (isset($worker->junitFile)) {
|
||||
@ -273,7 +276,7 @@ final class WrapperRunner implements RunnerInterface
|
||||
assert($testResult instanceof TestResult);
|
||||
|
||||
$testResultSum = new TestResult(
|
||||
$testResultSum->numberOfTests() + $testResult->numberOfTests(),
|
||||
(int) $testResultSum->hasTests() + (int) $testResult->hasTests(),
|
||||
$testResultSum->numberOfTestsRun() + $testResult->numberOfTestsRun(),
|
||||
$testResultSum->numberOfAssertions() + $testResult->numberOfAssertions(),
|
||||
array_merge_recursive($testResultSum->testErroredEvents(), $testResult->testErroredEvents()),
|
||||
@ -282,23 +285,23 @@ final class WrapperRunner implements RunnerInterface
|
||||
array_merge_recursive($testResultSum->testSuiteSkippedEvents(), $testResult->testSuiteSkippedEvents()),
|
||||
array_merge_recursive($testResultSum->testSkippedEvents(), $testResult->testSkippedEvents()),
|
||||
array_merge_recursive($testResultSum->testMarkedIncompleteEvents(), $testResult->testMarkedIncompleteEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredDeprecationEvents(), $testResult->testTriggeredDeprecationEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpDeprecationEvents(), $testResult->testTriggeredPhpDeprecationEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpunitDeprecationEvents(), $testResult->testTriggeredPhpunitDeprecationEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredErrorEvents(), $testResult->testTriggeredErrorEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredNoticeEvents(), $testResult->testTriggeredNoticeEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpNoticeEvents(), $testResult->testTriggeredPhpNoticeEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredWarningEvents(), $testResult->testTriggeredWarningEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpWarningEvents(), $testResult->testTriggeredPhpWarningEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpunitErrorEvents(), $testResult->testTriggeredPhpunitErrorEvents()),
|
||||
array_merge_recursive($testResultSum->testTriggeredPhpunitWarningEvents(), $testResult->testTriggeredPhpunitWarningEvents()),
|
||||
array_merge_recursive($testResultSum->testRunnerTriggeredDeprecationEvents(), $testResult->testRunnerTriggeredDeprecationEvents()),
|
||||
array_merge_recursive($testResultSum->testRunnerTriggeredWarningEvents(), $testResult->testRunnerTriggeredWarningEvents()),
|
||||
array_merge_recursive($testResultSum->errors(), $testResult->errors()),
|
||||
array_merge_recursive($testResultSum->deprecations(), $testResult->deprecations()),
|
||||
array_merge_recursive($testResultSum->notices(), $testResult->notices()),
|
||||
array_merge_recursive($testResultSum->warnings(), $testResult->warnings()),
|
||||
array_merge_recursive($testResultSum->phpDeprecations(), $testResult->phpDeprecations()),
|
||||
array_merge_recursive($testResultSum->phpNotices(), $testResult->phpNotices()),
|
||||
array_merge_recursive($testResultSum->phpWarnings(), $testResult->phpWarnings()),
|
||||
);
|
||||
}
|
||||
|
||||
$testResultSum = new TestResult(
|
||||
$testResultSum->numberOfTests(),
|
||||
ResultReflection::numberOfTests($testResultSum),
|
||||
$testResultSum->numberOfTestsRun(),
|
||||
$testResultSum->numberOfAssertions(),
|
||||
$testResultSum->testErroredEvents(),
|
||||
@ -307,18 +310,21 @@ final class WrapperRunner implements RunnerInterface
|
||||
$testResultSum->testSuiteSkippedEvents(),
|
||||
$testResultSum->testSkippedEvents(),
|
||||
$testResultSum->testMarkedIncompleteEvents(),
|
||||
$testResultSum->testTriggeredDeprecationEvents(),
|
||||
$testResultSum->testTriggeredPhpDeprecationEvents(),
|
||||
$testResultSum->testTriggeredPhpunitDeprecationEvents(),
|
||||
$testResultSum->testTriggeredErrorEvents(),
|
||||
$testResultSum->testTriggeredNoticeEvents(),
|
||||
$testResultSum->testTriggeredPhpNoticeEvents(),
|
||||
$testResultSum->testTriggeredWarningEvents(),
|
||||
$testResultSum->testTriggeredPhpWarningEvents(),
|
||||
$testResultSum->testTriggeredPhpunitErrorEvents(),
|
||||
$testResultSum->testTriggeredPhpunitWarningEvents(),
|
||||
$testResultSum->testRunnerTriggeredDeprecationEvents(),
|
||||
array_values(array_filter($testResultSum->testRunnerTriggeredWarningEvents(), fn ($event): bool => ! str_contains($event->message(), 'No tests found'))),
|
||||
array_values(array_filter(
|
||||
$testResultSum->testRunnerTriggeredWarningEvents(),
|
||||
fn (WarningTriggered $event): bool => ! str_contains($event->message(), 'No tests found')
|
||||
)),
|
||||
$testResultSum->errors(),
|
||||
$testResultSum->deprecations(),
|
||||
$testResultSum->notices(),
|
||||
$testResultSum->warnings(),
|
||||
$testResultSum->phpDeprecations(),
|
||||
$testResultSum->phpNotices(),
|
||||
$testResultSum->phpWarnings(),
|
||||
);
|
||||
|
||||
$this->printer->printResults(
|
||||
@ -330,15 +336,16 @@ final class WrapperRunner implements RunnerInterface
|
||||
$this->generateCodeCoverageReports();
|
||||
$this->generateLogs();
|
||||
|
||||
$exitCode = Result::exitCode($this->options->configuration, $testResultSum);
|
||||
$exitcode = Result::exitCode($this->options->configuration, $testResultSum);
|
||||
|
||||
$this->clearFiles($this->unexpectedOutputFiles);
|
||||
$this->clearFiles($this->testresultFiles);
|
||||
$this->clearFiles($this->coverageFiles);
|
||||
$this->clearFiles($this->junitFiles);
|
||||
$this->clearFiles($this->teamcityFiles);
|
||||
$this->clearFiles($this->testdoxFiles);
|
||||
|
||||
return $exitCode;
|
||||
return $exitcode;
|
||||
}
|
||||
|
||||
private function generateCodeCoverageReports(): void
|
||||
@ -348,10 +355,11 @@ final class WrapperRunner implements RunnerInterface
|
||||
}
|
||||
|
||||
$coverageManager = new CodeCoverage();
|
||||
|
||||
// @phpstan-ignore-next-line
|
||||
is_bool(true) && $coverageManager->init($this->options->configuration, $this->codeCoverageFilterRegistry, true);
|
||||
|
||||
$coverageManager->init(
|
||||
$this->options->configuration,
|
||||
$this->codeCoverageFilterRegistry,
|
||||
false,
|
||||
);
|
||||
$coverageMerger = new CoverageMerger($coverageManager->codeCoverage());
|
||||
foreach ($this->coverageFiles as $coverageFile) {
|
||||
$coverageMerger->addCoverageFromFile($coverageFile);
|
||||
@ -376,7 +384,7 @@ final class WrapperRunner implements RunnerInterface
|
||||
);
|
||||
}
|
||||
|
||||
/** @param array<int, SplFileInfo> $files */
|
||||
/** @param list<SplFileInfo> $files */
|
||||
private function clearFiles(array $files): void
|
||||
{
|
||||
foreach ($files as $file) {
|
||||
@ -391,31 +399,19 @@ final class WrapperRunner implements RunnerInterface
|
||||
/**
|
||||
* Returns the test files to be executed.
|
||||
*
|
||||
* @return array<int, string>
|
||||
* @return array<int, non-empty-string>
|
||||
*/
|
||||
private function getTestFiles(SuiteLoader $suiteLoader): array
|
||||
{
|
||||
$this->debug(sprintf('Found %d test file%s', count($suiteLoader->files), count($suiteLoader->files) === 1 ? '' : 's'));
|
||||
|
||||
/** @var array<string, string> $files */
|
||||
$files = $suiteLoader->files;
|
||||
|
||||
return [
|
||||
/** @var array<string, non-empty-string> $files */
|
||||
$files = [
|
||||
...array_values(array_filter(
|
||||
$files,
|
||||
$suiteLoader->tests,
|
||||
fn (string $filename): bool => ! str_ends_with($filename, "eval()'d code")
|
||||
)),
|
||||
...TestSuite::getInstance()->tests->getFilenames(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Prints a debug message.
|
||||
*/
|
||||
private function debug(string $message): void
|
||||
{
|
||||
if ($this->options->verbose) {
|
||||
$this->output->writeln(" <fg=blue>{$message}</> ");
|
||||
}
|
||||
return $files; // @phpstan-ignore-line
|
||||
}
|
||||
}
|
||||
|
||||
@ -16,8 +16,9 @@ use PHPUnit\TestRunner\TestResult\TestResult as PHPUnitTestResult;
|
||||
use SebastianBergmann\Timer\Duration;
|
||||
use Symfony\Component\Console\Output\ConsoleOutput;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
use function Termwind\render;
|
||||
use Termwind\Terminal;
|
||||
|
||||
use function Termwind\render;
|
||||
use function Termwind\terminal;
|
||||
|
||||
/**
|
||||
@ -134,6 +135,10 @@ final class CompactPrinter
|
||||
null,
|
||||
null,
|
||||
null,
|
||||
null,
|
||||
null,
|
||||
null,
|
||||
null,
|
||||
);
|
||||
|
||||
$telemetry = new Info(
|
||||
|
||||
35
src/Plugins/Snapshot.php
Normal file
35
src/Plugins/Snapshot.php
Normal file
@ -0,0 +1,35 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Plugins;
|
||||
|
||||
use Pest\Contracts\Plugins\HandlesArguments;
|
||||
use Pest\Exceptions\InvalidOption;
|
||||
use Pest\TestSuite;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class Snapshot implements HandlesArguments
|
||||
{
|
||||
use Concerns\HandleArguments;
|
||||
|
||||
/**
|
||||
* {@inheritDoc}
|
||||
*/
|
||||
public function handleArguments(array $arguments): array
|
||||
{
|
||||
if (! $this->hasArgument('--update-snapshots', $arguments)) {
|
||||
return $arguments;
|
||||
}
|
||||
|
||||
if ($this->hasArgument('--parallel', $arguments)) {
|
||||
throw new InvalidOption('The [--update-snapshots] option is not supported when running in parallel.');
|
||||
}
|
||||
|
||||
TestSuite::getInstance()->snapshots->flush();
|
||||
|
||||
return $this->popArgument('--update-snapshots', $arguments);
|
||||
}
|
||||
}
|
||||
38
src/Plugins/Verbose.php
Normal file
38
src/Plugins/Verbose.php
Normal file
@ -0,0 +1,38 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Plugins;
|
||||
|
||||
use Pest\Contracts\Plugins\HandlesArguments;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class Verbose implements HandlesArguments
|
||||
{
|
||||
use Concerns\HandleArguments;
|
||||
|
||||
/**
|
||||
* The list of verbosity levels.
|
||||
*/
|
||||
private const VERBOSITY_LEVELS = ['v', 'vv', 'vvv', 'q'];
|
||||
|
||||
/**
|
||||
* {@inheritDoc}
|
||||
*/
|
||||
public function handleArguments(array $arguments): array
|
||||
{
|
||||
foreach (self::VERBOSITY_LEVELS as $level) {
|
||||
if ($this->hasArgument('-'.$level, $arguments)) {
|
||||
$arguments = $this->popArgument('-'.$level, $arguments);
|
||||
}
|
||||
}
|
||||
|
||||
if ($this->hasArgument('--quiet', $arguments)) {
|
||||
return $this->popArgument('--quiet', $arguments);
|
||||
}
|
||||
|
||||
return $arguments;
|
||||
}
|
||||
}
|
||||
@ -6,6 +6,7 @@ namespace Pest\Plugins;
|
||||
|
||||
use Pest\Contracts\Plugins\HandlesArguments;
|
||||
use Pest\Support\View;
|
||||
|
||||
use function Pest\version;
|
||||
|
||||
/**
|
||||
|
||||
@ -6,7 +6,7 @@ namespace Pest\Repositories;
|
||||
|
||||
use Closure;
|
||||
use Mockery;
|
||||
use Pest\Exceptions\AfterEachAlreadyExist;
|
||||
use Pest\PendingCalls\AfterEachCall;
|
||||
use Pest\Support\ChainableClosure;
|
||||
use Pest\Support\NullClosure;
|
||||
|
||||
@ -23,13 +23,18 @@ final class AfterEachRepository
|
||||
/**
|
||||
* Sets a after each closure.
|
||||
*/
|
||||
public function set(string $filename, Closure $closure): void
|
||||
public function set(string $filename, AfterEachCall $afterEachCall, Closure $afterEachTestCase): void
|
||||
{
|
||||
if (array_key_exists($filename, $this->state)) {
|
||||
throw new AfterEachAlreadyExist($filename);
|
||||
$fromAfterEachTestCase = $this->state[$filename];
|
||||
|
||||
$afterEachTestCase = ChainableClosure::bound($fromAfterEachTestCase, $afterEachTestCase)
|
||||
->bindTo($afterEachCall, $afterEachCall::class);
|
||||
}
|
||||
|
||||
$this->state[$filename] = $closure;
|
||||
assert($afterEachTestCase instanceof Closure);
|
||||
|
||||
$this->state[$filename] = $afterEachTestCase;
|
||||
}
|
||||
|
||||
/**
|
||||
@ -39,7 +44,7 @@ final class AfterEachRepository
|
||||
{
|
||||
$afterEach = $this->state[$filename] ?? NullClosure::create();
|
||||
|
||||
return ChainableClosure::from(function (): void {
|
||||
return ChainableClosure::bound(function (): void {
|
||||
if (class_exists(Mockery::class)) {
|
||||
if ($container = Mockery::getContainer()) {
|
||||
/* @phpstan-ignore-next-line */
|
||||
|
||||
@ -5,7 +5,7 @@ declare(strict_types=1);
|
||||
namespace Pest\Repositories;
|
||||
|
||||
use Closure;
|
||||
use Pest\Exceptions\BeforeEachAlreadyExist;
|
||||
use Pest\Exceptions\BeforeAllAlreadyExist;
|
||||
use Pest\Support\NullClosure;
|
||||
use Pest\Support\Reflection;
|
||||
|
||||
@ -39,7 +39,7 @@ final class BeforeAllRepository
|
||||
$filename = Reflection::getFileNameFromClosure($closure);
|
||||
|
||||
if (array_key_exists($filename, $this->state)) {
|
||||
throw new BeforeEachAlreadyExist($filename);
|
||||
throw new BeforeAllAlreadyExist($filename);
|
||||
}
|
||||
|
||||
$this->state[$filename] = $closure;
|
||||
|
||||
@ -5,7 +5,8 @@ declare(strict_types=1);
|
||||
namespace Pest\Repositories;
|
||||
|
||||
use Closure;
|
||||
use Pest\Exceptions\BeforeEachAlreadyExist;
|
||||
use Pest\PendingCalls\BeforeEachCall;
|
||||
use Pest\Support\ChainableClosure;
|
||||
use Pest\Support\NullClosure;
|
||||
|
||||
/**
|
||||
@ -21,10 +22,14 @@ final class BeforeEachRepository
|
||||
/**
|
||||
* Sets a before each closure.
|
||||
*/
|
||||
public function set(string $filename, Closure $beforeEachTestCall, Closure $beforeEachTestCase): void
|
||||
public function set(string $filename, BeforeEachCall $beforeEachCall, Closure $beforeEachTestCall, Closure $beforeEachTestCase): void
|
||||
{
|
||||
if (array_key_exists($filename, $this->state)) {
|
||||
throw new BeforeEachAlreadyExist($filename);
|
||||
[$fromBeforeEachTestCall, $fromBeforeEachTestCase] = $this->state[$filename];
|
||||
|
||||
$beforeEachTestCall = ChainableClosure::unbound($fromBeforeEachTestCall, $beforeEachTestCall);
|
||||
$beforeEachTestCase = ChainableClosure::bound($fromBeforeEachTestCase, $beforeEachTestCase)->bindTo($beforeEachCall, $beforeEachCall::class);
|
||||
assert($beforeEachTestCase instanceof Closure);
|
||||
}
|
||||
|
||||
$this->state[$filename] = [$beforeEachTestCall, $beforeEachTestCase];
|
||||
|
||||
@ -10,9 +10,10 @@ use Pest\Exceptions\DatasetAlreadyExists;
|
||||
use Pest\Exceptions\DatasetDoesNotExist;
|
||||
use Pest\Exceptions\ShouldNotHappen;
|
||||
use Pest\Support\Exporter;
|
||||
use function sprintf;
|
||||
use Traversable;
|
||||
|
||||
use function sprintf;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
@ -66,11 +67,11 @@ final class DatasetsRepository
|
||||
}
|
||||
|
||||
/**
|
||||
* @return Closure|array<int|string, mixed>|never
|
||||
* @return Closure|array<int|string, mixed>
|
||||
*
|
||||
* @throws ShouldNotHappen
|
||||
*/
|
||||
public static function get(string $filename, string $description)
|
||||
public static function get(string $filename, string $description): Closure|array
|
||||
{
|
||||
$dataset = self::$withs[$filename.self::SEPARATOR.$description];
|
||||
|
||||
@ -89,7 +90,7 @@ final class DatasetsRepository
|
||||
* @param array<Closure|iterable<int|string, mixed>|string> $dataset
|
||||
* @return array<string, mixed>|null
|
||||
*/
|
||||
public static function resolve(array $dataset, string $currentTestFile): array|null
|
||||
public static function resolve(array $dataset, string $currentTestFile): ?array
|
||||
{
|
||||
if ($dataset === []) {
|
||||
return null;
|
||||
@ -138,7 +139,7 @@ final class DatasetsRepository
|
||||
|
||||
/**
|
||||
* @param array<Closure|iterable<int|string, mixed>|string> $datasets
|
||||
* @return array<array<mixed>>
|
||||
* @return array<int, array<int, mixed>>
|
||||
*/
|
||||
private static function processDatasets(array $datasets, string $currentTestFile): array
|
||||
{
|
||||
@ -193,7 +194,7 @@ final class DatasetsRepository
|
||||
|
||||
$closestScopeDatasetKey = array_reduce(
|
||||
array_keys($matchingDatasets),
|
||||
fn ($keyA, $keyB) => $keyA !== null && strlen((string) $keyA) > strlen($keyB) ? $keyA : $keyB
|
||||
fn (string|int|null $keyA, string|int|null $keyB): string|int|null => $keyA !== null && strlen((string) $keyA) > strlen((string) $keyB) ? $keyA : $keyB
|
||||
);
|
||||
|
||||
if ($closestScopeDatasetKey === null) {
|
||||
|
||||
141
src/Repositories/SnapshotRepository.php
Normal file
141
src/Repositories/SnapshotRepository.php
Normal file
@ -0,0 +1,141 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace Pest\Repositories;
|
||||
|
||||
use Pest\Exceptions\ShouldNotHappen;
|
||||
use Pest\TestSuite;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
final class SnapshotRepository
|
||||
{
|
||||
/** @var array<string, int> */
|
||||
private static array $expectationsCounter = [];
|
||||
|
||||
/**
|
||||
* Creates a snapshot repository instance.
|
||||
*/
|
||||
public function __construct(
|
||||
readonly private string $testsPath,
|
||||
readonly private string $snapshotsPath,
|
||||
) {
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks if the snapshot exists.
|
||||
*/
|
||||
public function has(): bool
|
||||
{
|
||||
return file_exists($this->getSnapshotFilename());
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the snapshot.
|
||||
*
|
||||
* @return array{0: string, 1: string}
|
||||
*
|
||||
* @throws ShouldNotHappen
|
||||
*/
|
||||
public function get(): array
|
||||
{
|
||||
$contents = file_get_contents($snapshotFilename = $this->getSnapshotFilename());
|
||||
|
||||
if ($contents === false) {
|
||||
throw ShouldNotHappen::fromMessage('Snapshot file could not be read.');
|
||||
}
|
||||
|
||||
$snapshot = str_replace(dirname($this->testsPath).'/', '', $snapshotFilename);
|
||||
|
||||
return [$snapshot, $contents];
|
||||
}
|
||||
|
||||
/**
|
||||
* Saves the given snapshot for the given test case.
|
||||
*/
|
||||
public function save(string $snapshot): string
|
||||
{
|
||||
$snapshotFilename = $this->getSnapshotFilename();
|
||||
|
||||
if (! file_exists(dirname($snapshotFilename))) {
|
||||
mkdir(dirname($snapshotFilename), 0755, true);
|
||||
}
|
||||
|
||||
file_put_contents($snapshotFilename, $snapshot);
|
||||
|
||||
return str_replace(dirname($this->testsPath).'/', '', $snapshotFilename);
|
||||
}
|
||||
|
||||
/**
|
||||
* Flushes the snapshots.
|
||||
*/
|
||||
public function flush(): void
|
||||
{
|
||||
$absoluteSnapshotsPath = $this->testsPath.'/'.$this->snapshotsPath;
|
||||
|
||||
$deleteDirectory = function (string $path) use (&$deleteDirectory): void {
|
||||
if (file_exists($path)) {
|
||||
$scannedDir = scandir($path);
|
||||
assert(is_array($scannedDir));
|
||||
|
||||
$files = array_diff($scannedDir, ['.', '..']);
|
||||
|
||||
foreach ($files as $file) {
|
||||
if (is_dir($path.'/'.$file)) {
|
||||
$deleteDirectory($path.'/'.$file);
|
||||
} else {
|
||||
unlink($path.'/'.$file);
|
||||
}
|
||||
}
|
||||
|
||||
rmdir($path);
|
||||
}
|
||||
};
|
||||
|
||||
if (file_exists($absoluteSnapshotsPath)) {
|
||||
$deleteDirectory($absoluteSnapshotsPath);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the snapshot's "filename".
|
||||
*/
|
||||
private function getSnapshotFilename(): string
|
||||
{
|
||||
$relativePath = str_replace($this->testsPath, '', TestSuite::getInstance()->getFilename());
|
||||
|
||||
// remove extension from filename
|
||||
$relativePath = substr($relativePath, 0, (int) strrpos($relativePath, '.'));
|
||||
|
||||
$description = TestSuite::getInstance()->getDescription();
|
||||
|
||||
if ($this->getCurrentSnapshotCounter() > 1) {
|
||||
$description .= '__'.$this->getCurrentSnapshotCounter();
|
||||
}
|
||||
|
||||
return sprintf('%s/%s.snap', $this->testsPath.'/'.$this->snapshotsPath.$relativePath, $description);
|
||||
}
|
||||
|
||||
private function getCurrentSnapshotKey(): string
|
||||
{
|
||||
return TestSuite::getInstance()->getFilename().'###'.TestSuite::getInstance()->getDescription();
|
||||
}
|
||||
|
||||
private function getCurrentSnapshotCounter(): int
|
||||
{
|
||||
return self::$expectationsCounter[$this->getCurrentSnapshotKey()] ?? 0;
|
||||
}
|
||||
|
||||
public function startNewExpectation(): void
|
||||
{
|
||||
$key = $this->getCurrentSnapshotKey();
|
||||
|
||||
if (! isset(self::$expectationsCounter[$key])) {
|
||||
self::$expectationsCounter[$key] = 0;
|
||||
}
|
||||
|
||||
self::$expectationsCounter[$key]++;
|
||||
}
|
||||
}
|
||||
@ -4,6 +4,7 @@ declare(strict_types=1);
|
||||
|
||||
namespace Pest;
|
||||
|
||||
use NunoMaduro\Collision\Adapters\Phpunit\Support\ResultReflection;
|
||||
use PHPUnit\TestRunner\TestResult\TestResult;
|
||||
use PHPUnit\TextUI\Configuration\Configuration;
|
||||
|
||||
@ -39,15 +40,13 @@ final class Result
|
||||
*/
|
||||
public static function exitCode(Configuration $configuration, TestResult $result): int
|
||||
{
|
||||
$returnCode = self::FAILURE_EXIT;
|
||||
|
||||
if ($result->wasSuccessfulIgnoringPhpunitWarnings()
|
||||
&& ! $result->hasTestTriggeredPhpunitWarningEvents()) {
|
||||
$returnCode = self::SUCCESS_EXIT;
|
||||
return self::SUCCESS_EXIT;
|
||||
}
|
||||
|
||||
if ($configuration->failOnEmptyTestSuite() && $result->numberOfTests() === 0) {
|
||||
$returnCode = self::FAILURE_EXIT;
|
||||
if ($configuration->failOnEmptyTestSuite() && ResultReflection::numberOfTests($result) === 0) {
|
||||
return self::FAILURE_EXIT;
|
||||
}
|
||||
|
||||
if ($result->wasSuccessfulIgnoringPhpunitWarnings()) {
|
||||
@ -55,9 +54,9 @@ final class Result
|
||||
$returnCode = self::FAILURE_EXIT;
|
||||
}
|
||||
|
||||
$warnings = $result->numberOfTestsWithTestTriggeredPhpunitWarningEvents()
|
||||
+ $result->numberOfTestsWithTestTriggeredWarningEvents()
|
||||
+ $result->numberOfTestsWithTestTriggeredPhpWarningEvents();
|
||||
$warnings = $result->numberOfTestsWithTestTriggeredPhpunitWarningEvents() +
|
||||
+count($result->warnings())
|
||||
+ count($result->phpWarnings());
|
||||
|
||||
if ($configuration->failOnWarning() && $warnings > 0) {
|
||||
$returnCode = self::FAILURE_EXIT;
|
||||
@ -76,6 +75,6 @@ final class Result
|
||||
return self::EXCEPTION_EXIT;
|
||||
}
|
||||
|
||||
return $returnCode;
|
||||
return self::FAILURE_EXIT;
|
||||
}
|
||||
}
|
||||
|
||||
@ -78,9 +78,7 @@ final class Backtrace
|
||||
*/
|
||||
public static function file(): string
|
||||
{
|
||||
$trace = debug_backtrace(self::BACKTRACE_OPTIONS)[1];
|
||||
|
||||
assert(array_key_exists(self::FILE, $trace));
|
||||
$trace = self::backtrace();
|
||||
|
||||
return $trace[self::FILE];
|
||||
}
|
||||
@ -90,9 +88,7 @@ final class Backtrace
|
||||
*/
|
||||
public static function dirname(): string
|
||||
{
|
||||
$trace = debug_backtrace(self::BACKTRACE_OPTIONS)[1];
|
||||
|
||||
assert(array_key_exists(self::FILE, $trace));
|
||||
$trace = self::backtrace();
|
||||
|
||||
return dirname($trace[self::FILE]);
|
||||
}
|
||||
@ -102,8 +98,30 @@ final class Backtrace
|
||||
*/
|
||||
public static function line(): int
|
||||
{
|
||||
$trace = debug_backtrace(self::BACKTRACE_OPTIONS)[1];
|
||||
$trace = self::backtrace();
|
||||
|
||||
return $trace['line'] ?? 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array{function: string, line?: int, file: string, class?: class-string, type?: string, args?: mixed[], object?: object}
|
||||
*/
|
||||
private static function backtrace(): array
|
||||
{
|
||||
$backtrace = debug_backtrace(self::BACKTRACE_OPTIONS);
|
||||
|
||||
foreach ($backtrace as $trace) {
|
||||
if (! isset($trace['file'])) {
|
||||
continue;
|
||||
}
|
||||
|
||||
if (str_contains($trace['file'], 'pest'.DIRECTORY_SEPARATOR.'src')) {
|
||||
continue;
|
||||
}
|
||||
|
||||
return $trace;
|
||||
}
|
||||
|
||||
throw ShouldNotHappen::fromMessage('Backtrace not found.');
|
||||
}
|
||||
}
|
||||
|
||||
@ -13,9 +13,25 @@ use Pest\Exceptions\ShouldNotHappen;
|
||||
final class ChainableClosure
|
||||
{
|
||||
/**
|
||||
* Calls the given `$closure` and chains the `$next` closure.
|
||||
* Calls the given `$closure` when the given condition is true, "bound" to the same object.
|
||||
*/
|
||||
public static function from(Closure $closure, Closure $next): Closure
|
||||
public static function boundWhen(Closure $condition, Closure $next): Closure
|
||||
{
|
||||
return function () use ($condition, $next): void {
|
||||
if (! is_object($this)) { // @phpstan-ignore-line
|
||||
throw ShouldNotHappen::fromMessage('$this not bound to chainable closure.');
|
||||
}
|
||||
|
||||
if (\Pest\Support\Closure::bind($condition, $this, self::class)(...func_get_args())) {
|
||||
\Pest\Support\Closure::bind($next, $this, self::class)(...func_get_args());
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Calls the given `$closure` and chains the `$next` closure, "bound" to the same object.
|
||||
*/
|
||||
public static function bound(Closure $closure, Closure $next): Closure
|
||||
{
|
||||
return function () use ($closure, $next): void {
|
||||
if (! is_object($this)) { // @phpstan-ignore-line
|
||||
@ -28,9 +44,20 @@ final class ChainableClosure
|
||||
}
|
||||
|
||||
/**
|
||||
* Call the given static `$closure` and chains the `$next` closure.
|
||||
* Calls the given `$closure` and chains the `$next` closure, "unbound" of any object.
|
||||
*/
|
||||
public static function fromStatic(Closure $closure, Closure $next): Closure
|
||||
public static function unbound(Closure $closure, Closure $next): Closure
|
||||
{
|
||||
return function () use ($closure, $next): void {
|
||||
$closure(...func_get_args());
|
||||
$next(...func_get_args());
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Call the given static `$closure` and chains the `$next` closure, "bound" to the same object statically.
|
||||
*/
|
||||
public static function boundStatically(Closure $closure, Closure $next): Closure
|
||||
{
|
||||
return static function () use ($closure, $next): void {
|
||||
\Pest\Support\Closure::bind($closure, null, self::class)(...func_get_args());
|
||||
|
||||
@ -18,7 +18,7 @@ final class Closure
|
||||
*
|
||||
* @throws ShouldNotHappen
|
||||
*/
|
||||
public static function bind(BaseClosure|null $closure, ?object $newThis, object|string|null $newScope = 'static'): BaseClosure
|
||||
public static function bind(?BaseClosure $closure, ?object $newThis, object|string|null $newScope = 'static'): BaseClosure
|
||||
{
|
||||
if ($closure == null) {
|
||||
throw ShouldNotHappen::fromMessage('Could not bind null closure.');
|
||||
|
||||
@ -10,6 +10,7 @@ use SebastianBergmann\CodeCoverage\Node\Directory;
|
||||
use SebastianBergmann\CodeCoverage\Node\File;
|
||||
use SebastianBergmann\Environment\Runtime;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
|
||||
use function Termwind\render;
|
||||
use function Termwind\renderUsing;
|
||||
use function Termwind\terminal;
|
||||
@ -159,10 +160,11 @@ final class Coverage
|
||||
* ['11', '20..25', '50', '60..80'];
|
||||
* ```
|
||||
*
|
||||
*
|
||||
* @param File $file
|
||||
* @return array<int, string>
|
||||
*/
|
||||
public static function getMissingCoverage($file): array
|
||||
public static function getMissingCoverage(mixed $file): array
|
||||
{
|
||||
$shouldBeNewLine = true;
|
||||
|
||||
|
||||
@ -4,6 +4,8 @@ declare(strict_types=1);
|
||||
|
||||
namespace Pest\Support;
|
||||
|
||||
use function Pest\testDirectory;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
*/
|
||||
@ -25,6 +27,10 @@ final class DatasetInfo
|
||||
|
||||
public static function scope(string $file): string
|
||||
{
|
||||
if (Str::endsWith($file, testDirectory('Pest.php'))) {
|
||||
return dirname($file);
|
||||
}
|
||||
|
||||
if (self::isInsideADatasetsDirectory($file)) {
|
||||
return dirname($file, 2);
|
||||
}
|
||||
|
||||
@ -18,11 +18,9 @@ final class ExceptionTrace
|
||||
/**
|
||||
* Ensures the given closure reports the good execution context.
|
||||
*
|
||||
* @return mixed
|
||||
*
|
||||
* @throws Throwable
|
||||
*/
|
||||
public static function ensure(Closure $closure)
|
||||
public static function ensure(Closure $closure): mixed
|
||||
{
|
||||
try {
|
||||
return $closure();
|
||||
@ -32,7 +30,7 @@ final class ExceptionTrace
|
||||
|
||||
$message = str_replace(self::UNDEFINED_METHOD, 'Call to undefined method ', $message);
|
||||
|
||||
if (class_exists($class) && count(class_parents($class)) > 0 && array_values(class_parents($class))[0] === TestCase::class) {
|
||||
if (class_exists((string) $class) && (is_countable(class_parents($class)) ? count(class_parents($class)) : 0) > 0 && array_values(class_parents($class))[0] === TestCase::class) { // @phpstan-ignore-line
|
||||
$message .= '. Did you forget to use the [uses()] function? Read more at: https://pestphp.com/docs/configuring-tests';
|
||||
}
|
||||
|
||||
|
||||
@ -84,6 +84,6 @@ final class ExpectationPipeline
|
||||
*/
|
||||
public function carry(): Closure
|
||||
{
|
||||
return fn ($stack, $pipe): Closure => fn () => $pipe($stack, ...$this->passables);
|
||||
return fn (mixed $stack, callable $pipe): Closure => fn () => $pipe($stack, ...$this->passables);
|
||||
}
|
||||
}
|
||||
|
||||
@ -77,6 +77,12 @@ final class Exporter
|
||||
*/
|
||||
public function shortenedExport(mixed $value): string
|
||||
{
|
||||
return (string) preg_replace(['#\.{3}#', '#\\\n\s*#'], ['…'], $this->exporter->shortenedExport($value));
|
||||
$map = [
|
||||
'#\.{3}#' => '…',
|
||||
'#\\\n\s*#' => '',
|
||||
'# Object \(…\)#' => '',
|
||||
];
|
||||
|
||||
return (string) preg_replace(array_keys($map), array_values($map), $this->exporter->shortenedExport($value));
|
||||
}
|
||||
}
|
||||
|
||||
@ -25,7 +25,7 @@ final class HigherOrderCallables
|
||||
*
|
||||
* Create a new expectation. Callable values will be executed prior to returning the new expectation.
|
||||
*
|
||||
* @param (Closure():TValue)|TValue $value
|
||||
* @param (Closure():TValue)|TValue $value
|
||||
* @return Expectation<TValue>
|
||||
*/
|
||||
public function expect(mixed $value): Expectation
|
||||
|
||||
@ -62,7 +62,7 @@ final class HigherOrderMessage
|
||||
Reflection::setPropertyValue($throwable, 'file', $this->filename);
|
||||
Reflection::setPropertyValue($throwable, 'line', $this->line);
|
||||
|
||||
if ($throwable->getMessage() === self::getUndefinedMethodMessage($target, $this->name)) {
|
||||
if ($throwable->getMessage() === $this->getUndefinedMethodMessage($target, $this->name)) {
|
||||
/** @var ReflectionClass<TValue> $reflection */
|
||||
$reflection = new ReflectionClass($target);
|
||||
/* @phpstan-ignore-next-line */
|
||||
@ -94,7 +94,7 @@ final class HigherOrderMessage
|
||||
return in_array($this->name, get_class_methods(HigherOrderCallables::class), true);
|
||||
}
|
||||
|
||||
private static function getUndefinedMethodMessage(object $target, string $methodName): string
|
||||
private function getUndefinedMethodMessage(object $target, string $methodName): string
|
||||
{
|
||||
if (\PHP_MAJOR_VERSION >= 8) {
|
||||
return sprintf(self::UNDEFINED_METHOD, sprintf('%s::%s()', $target::class, $methodName));
|
||||
|
||||
@ -24,9 +24,8 @@ final class Reflection
|
||||
* Calls the given method with args on the given object.
|
||||
*
|
||||
* @param array<int, mixed> $args
|
||||
* @return mixed
|
||||
*/
|
||||
public static function call(object $object, string $method, array $args = [])
|
||||
public static function call(object $object, string $method, array $args = []): mixed
|
||||
{
|
||||
$reflectionClass = new ReflectionClass($object);
|
||||
|
||||
@ -53,9 +52,8 @@ final class Reflection
|
||||
* Bind a callable to the TestCase and return the result.
|
||||
*
|
||||
* @param array<int, mixed> $args
|
||||
* @return mixed
|
||||
*/
|
||||
public static function bindCallable(callable $callable, array $args = [])
|
||||
public static function bindCallable(callable $callable, array $args = []): mixed
|
||||
{
|
||||
return Closure::fromCallable($callable)->bindTo(TestSuite::getInstance()->test)(...$args);
|
||||
}
|
||||
@ -63,10 +61,8 @@ final class Reflection
|
||||
/**
|
||||
* Bind a callable to the TestCase and return the result,
|
||||
* passing in the current dataset values as arguments.
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public static function bindCallableWithData(callable $callable)
|
||||
public static function bindCallableWithData(callable $callable): mixed
|
||||
{
|
||||
$test = TestSuite::getInstance()->test;
|
||||
|
||||
@ -87,10 +83,8 @@ final class Reflection
|
||||
|
||||
/**
|
||||
* Gets the property value from of the given object.
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public static function getPropertyValue(object $object, string $property)
|
||||
public static function getPropertyValue(object $object, string $property): mixed
|
||||
{
|
||||
$reflectionClass = new ReflectionClass($object);
|
||||
|
||||
@ -206,10 +200,7 @@ final class Reflection
|
||||
return $arguments;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return mixed
|
||||
*/
|
||||
public static function getFunctionVariable(Closure $function, string $key)
|
||||
public static function getFunctionVariable(Closure $function, string $key): mixed
|
||||
{
|
||||
return (new ReflectionFunction($function))->getStaticVariables()[$key] ?? null;
|
||||
}
|
||||
|
||||
@ -74,64 +74,76 @@ final class StateGenerator
|
||||
));
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredDeprecationEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->deprecations() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::DEPRECATED,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::DEPRECATED,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredPhpDeprecationEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->phpDeprecations() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::DEPRECATED,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::DEPRECATED,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredNoticeEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->notices() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::NOTICE,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::NOTICE,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredPhpNoticeEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->phpNotices() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::NOTICE,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::NOTICE,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredWarningEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->warnings() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::WARN,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::WARN,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($testResult->testTriggeredPhpWarningEvents() as $testResultEvent) {
|
||||
$testResultEvent = $testResultEvent[0];
|
||||
foreach ($testResult->phpWarnings() as $testResultEvent) {
|
||||
foreach ($testResultEvent->triggeringTests() as $triggeringTest) {
|
||||
['test' => $test] = $triggeringTest;
|
||||
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$testResultEvent->test(),
|
||||
TestResult::WARN,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->message()))
|
||||
));
|
||||
$state->add(TestResult::fromPestParallelTestCase(
|
||||
$test,
|
||||
TestResult::WARN,
|
||||
ThrowableBuilder::from(new TestOutcome($testResultEvent->description()))
|
||||
));
|
||||
}
|
||||
}
|
||||
|
||||
// for each test that passed, we need to add it to the state
|
||||
@ -140,7 +152,7 @@ final class StateGenerator
|
||||
new TestMethod(
|
||||
"$i", // @phpstan-ignore-line
|
||||
'', // @phpstan-ignore-line
|
||||
'',
|
||||
'', // @phpstan-ignore-line
|
||||
1,
|
||||
TestDoxBuilder::fromClassNameAndMethodName('', ''), // @phpstan-ignore-line
|
||||
MetadataCollection::fromArray([]),
|
||||
|
||||
@ -5,9 +5,10 @@ declare(strict_types=1);
|
||||
namespace Pest\Support;
|
||||
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
use Termwind\Termwind;
|
||||
|
||||
use function Termwind\render;
|
||||
use function Termwind\renderUsing;
|
||||
use Termwind\Termwind;
|
||||
|
||||
/**
|
||||
* @internal
|
||||
|
||||
@ -16,7 +16,7 @@ final class GitDirtyTestCaseFilter implements TestCaseFilter
|
||||
/**
|
||||
* @var string[]|null
|
||||
*/
|
||||
private array|null $changedFiles = null;
|
||||
private ?array $changedFiles = null;
|
||||
|
||||
public function __construct(private readonly string $projectRoot)
|
||||
{
|
||||
@ -59,13 +59,18 @@ final class GitDirtyTestCaseFilter implements TestCaseFilter
|
||||
$dirtyFiles[substr($dirtyFile, 3)] = trim(substr($dirtyFile, 0, 3));
|
||||
}
|
||||
|
||||
$dirtyFiles = array_filter($dirtyFiles, fn ($status): bool => $status !== 'D');
|
||||
$dirtyFiles = array_filter($dirtyFiles, fn (string $status): bool => $status !== 'D');
|
||||
|
||||
$dirtyFiles = array_map(fn ($file, $status): string => in_array($status, ['R', 'RM'], true) ? explode(' -> ', $file)[1] : $file, array_keys($dirtyFiles), $dirtyFiles);
|
||||
$dirtyFiles = array_map(
|
||||
fn (string $file, string $status): string => in_array($status, ['R', 'RM'], true)
|
||||
? explode(' -> ', $file)[1]
|
||||
: $file, array_keys($dirtyFiles), $dirtyFiles,
|
||||
);
|
||||
|
||||
$dirtyFiles = array_filter(
|
||||
$dirtyFiles,
|
||||
fn ($file): bool => str_starts_with('.'.DIRECTORY_SEPARATOR.$file, TestSuite::getInstance()->testPath) || str_starts_with($file, TestSuite::getInstance()->testPath)
|
||||
fn (string $file): bool => str_starts_with('.'.DIRECTORY_SEPARATOR.$file, TestSuite::getInstance()->testPath)
|
||||
|| str_starts_with($file, TestSuite::getInstance()->testPath)
|
||||
);
|
||||
|
||||
$dirtyFiles = array_values($dirtyFiles);
|
||||
|
||||
@ -9,7 +9,9 @@ use Pest\Repositories\AfterAllRepository;
|
||||
use Pest\Repositories\AfterEachRepository;
|
||||
use Pest\Repositories\BeforeAllRepository;
|
||||
use Pest\Repositories\BeforeEachRepository;
|
||||
use Pest\Repositories\SnapshotRepository;
|
||||
use Pest\Repositories\TestRepository;
|
||||
use Pest\Support\Str;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
/**
|
||||
@ -47,6 +49,11 @@ final class TestSuite
|
||||
*/
|
||||
public AfterAllRepository $afterAll;
|
||||
|
||||
/**
|
||||
* Holds the snapshots repository.
|
||||
*/
|
||||
public SnapshotRepository $snapshots;
|
||||
|
||||
/**
|
||||
* Holds the root path.
|
||||
*/
|
||||
@ -69,8 +76,11 @@ final class TestSuite
|
||||
$this->tests = new TestRepository();
|
||||
$this->afterEach = new AfterEachRepository();
|
||||
$this->afterAll = new AfterAllRepository();
|
||||
|
||||
$this->rootPath = (string) realpath($rootPath);
|
||||
$this->snapshots = new SnapshotRepository(
|
||||
implode(DIRECTORY_SEPARATOR, [$this->rootPath, $this->testPath]),
|
||||
implode(DIRECTORY_SEPARATOR, ['.pest', 'snapshots']),
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
@ -96,4 +106,28 @@ final class TestSuite
|
||||
|
||||
return self::$instance;
|
||||
}
|
||||
|
||||
public function getFilename(): string
|
||||
{
|
||||
assert($this->test instanceof TestCase);
|
||||
|
||||
return (fn () => self::$__filename)->call($this->test, $this->test::class); // @phpstan-ignore-line
|
||||
}
|
||||
|
||||
public function getDescription(): string
|
||||
{
|
||||
assert($this->test instanceof TestCase);
|
||||
|
||||
$description = str_replace('__pest_evaluable_', '', $this->test->name());
|
||||
$datasetAsString = str_replace('__pest_evaluable_', '', Str::evaluable($this->test->dataSetAsStringWithData()));
|
||||
|
||||
return str_replace(' ', '_', $description.$datasetAsString);
|
||||
}
|
||||
|
||||
public function registerSnapshotChange(string $message): void
|
||||
{
|
||||
assert($this->test instanceof TestCase);
|
||||
|
||||
(fn (): string => $this->__snapshotChanges[] = $message)->call($this->test, $this->test::class); // @phpstan-ignore-line
|
||||
}
|
||||
}
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
|
||||
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.3/phpunit.xsd"
|
||||
bootstrap="vendor/autoload.php"
|
||||
colors="true"
|
||||
>
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
|
||||
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.3/phpunit.xsd"
|
||||
bootstrap="vendor/autoload.php"
|
||||
colors="true"
|
||||
>
|
||||
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1,7 @@
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-12">
|
||||
<h1>Snapshot</h1>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -0,0 +1,7 @@
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-12">
|
||||
<h1>Snapshot</h1>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -0,0 +1,7 @@
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-12">
|
||||
<h1>Snapshot</h1>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
@ -0,0 +1 @@
|
||||
foo bar 2
|
||||
@ -0,0 +1 @@
|
||||
foo bar 1
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user