🔧 Update npm + login page

This commit is contained in:
TiclemFR
2024-01-25 14:00:48 +01:00
parent 468c2cd0e6
commit 336f2bae93
128 changed files with 3078 additions and 2368 deletions

View File

@@ -2,6 +2,12 @@
All notable changes of the PHPUnit 10.5 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
## [10.5.9] - 2024-01-22
### Fixed
* [#5676](https://github.com/sebastianbergmann/phpunit/issues/5676): PHPUnit's test runner overwrites custom error handler registered using `set_error_handler()` in bootstrap script
## [10.5.8] - 2024-01-19
### Fixed
@@ -91,6 +97,7 @@ All notable changes of the PHPUnit 10.5 release series are documented in this fi
* [#5563](https://github.com/sebastianbergmann/phpunit/issues/5563): `createMockForIntersectionOfInterfaces()` does not automatically register mock object for expectation verification
[10.5.9]: https://github.com/sebastianbergmann/phpunit/compare/10.5.8...10.5.9
[10.5.8]: https://github.com/sebastianbergmann/phpunit/compare/10.5.7...10.5.8
[10.5.7]: https://github.com/sebastianbergmann/phpunit/compare/10.5.6...10.5.7
[10.5.6]: https://github.com/sebastianbergmann/phpunit/compare/10.5.5...10.5.6

View File

@@ -166,7 +166,13 @@ final class ErrorHandler
return;
}
set_error_handler($this);
$oldErrorHandler = set_error_handler($this);
if ($oldErrorHandler !== null) {
restore_error_handler();
return;
}
$this->enabled = true;
$this->originalErrorReportingLevel = error_reporting();

View File

@@ -34,7 +34,7 @@ final class Version
}
if (self::$version === '') {
self::$version = (new VersionId('10.5.8', dirname(__DIR__, 2)))->asString();
self::$version = (new VersionId('10.5.9', dirname(__DIR__, 2)))->asString();
}
return self::$version;

View File

@@ -11,6 +11,7 @@ namespace PHPUnit\TextUI;
use const PHP_EOL;
use function count;
use function defined;
use function explode;
use function max;
use function preg_replace_callback;
@@ -26,144 +27,7 @@ use SebastianBergmann\Environment\Console;
*/
final class Help
{
private const LEFT_MARGIN = ' ';
private const HELP_TEXT = [
'Usage' => [
['text' => 'phpunit [options] <directory|file> ...'],
],
'Configuration' => [
['arg' => '--bootstrap <file>', 'desc' => 'A PHP script that is included before the tests run'],
['arg' => '-c|--configuration <file>', 'desc' => 'Read configuration from XML file'],
['arg' => '--no-configuration', 'desc' => 'Ignore default configuration file (phpunit.xml)'],
['arg' => '--no-extensions', 'desc' => 'Do not load PHPUnit extensions'],
['arg' => '--include-path <path(s)>', 'desc' => 'Prepend PHP\'s include_path with given path(s)'],
['arg' => '-d <key[=value]>', 'desc' => 'Sets a php.ini value'],
['arg' => '--cache-directory <dir>', 'desc' => 'Specify cache directory'],
['arg' => '--generate-configuration', 'desc' => 'Generate configuration file with suggested settings'],
['arg' => '--migrate-configuration', 'desc' => 'Migrate configuration file to current format'],
['arg' => '--generate-baseline <file>', 'desc' => 'Generate baseline for issues'],
['arg' => '--use-baseline <file>', 'desc' => 'Use baseline to ignore issues'],
['arg' => '--ignore-baseline', 'desc' => 'Do not use baseline to ignore issues'],
],
'Selection' => [
['arg' => '--list-suites', 'desc' => 'List available test suites'],
['arg' => '--testsuite <name>', 'desc' => 'Only run tests from the specified test suite(s)'],
['arg' => '--exclude-testsuite <name>', 'desc' => 'Exclude tests from the specified test suite(s)'],
['arg' => '--list-groups', 'desc' => 'List available test groups'],
['arg' => '--group <name>', 'desc' => 'Only run tests from the specified group(s)'],
['arg' => '--exclude-group <name>', 'desc' => 'Exclude tests from the specified group(s)'],
['arg' => '--covers <name>', 'desc' => 'Only run tests that intend to cover <name>'],
['arg' => '--uses <name>', 'desc' => 'Only run tests that intend to use <name>'],
['arg' => '--list-tests', 'desc' => 'List available tests'],
['arg' => '--list-tests-xml <file>', 'desc' => 'List available tests in XML format'],
['arg' => '--filter <pattern>', 'desc' => 'Filter which tests to run'],
['arg' => '--test-suffix <suffixes>', 'desc' => 'Only search for test in files with specified suffix(es). Default: Test.php,.phpt'],
],
'Execution' => [
['arg' => '--process-isolation', 'desc' => 'Run each test in a separate PHP process'],
['arg' => '--globals-backup', 'desc' => 'Backup and restore $GLOBALS for each test'],
['arg' => '--static-backup', 'desc' => 'Backup and restore static properties for each test'],
['spacer' => ''],
['arg' => '--strict-coverage', 'desc' => 'Be strict about code coverage metadata'],
['arg' => '--strict-global-state', 'desc' => 'Be strict about changes to global state'],
['arg' => '--disallow-test-output', 'desc' => 'Be strict about output during tests'],
['arg' => '--enforce-time-limit', 'desc' => 'Enforce time limit based on test size'],
['arg' => '--default-time-limit <sec>', 'desc' => 'Timeout in seconds for tests that have no declared size'],
['arg' => '--dont-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
['spacer' => ''],
['arg' => '--stop-on-defect', 'desc' => 'Stop after first error, failure, warning, or risky test'],
['arg' => '--stop-on-error', 'desc' => 'Stop after first error'],
['arg' => '--stop-on-failure', 'desc' => 'Stop after first failure'],
['arg' => '--stop-on-warning', 'desc' => 'Stop after first warning'],
['arg' => '--stop-on-risky', 'desc' => 'Stop after first risky test'],
['arg' => '--stop-on-deprecation', 'desc' => 'Stop after first test that triggered a deprecation'],
['arg' => '--stop-on-notice', 'desc' => 'Stop after first test that triggered a notice'],
['arg' => '--stop-on-skipped', 'desc' => 'Stop after first skipped test'],
['arg' => '--stop-on-incomplete', 'desc' => 'Stop after first incomplete test'],
['spacer' => ''],
['arg' => '--fail-on-warning', 'desc' => 'Signal failure using shell exit code when a warning was triggered'],
['arg' => '--fail-on-risky', 'desc' => 'Signal failure using shell exit code when a test was considered risky'],
['arg' => '--fail-on-deprecation', 'desc' => 'Signal failure using shell exit code when a deprecation was triggered'],
['arg' => '--fail-on-notice', 'desc' => 'Signal failure using shell exit code when a notice was triggered'],
['arg' => '--fail-on-skipped', 'desc' => 'Signal failure using shell exit code when a test was skipped'],
['arg' => '--fail-on-incomplete', 'desc' => 'Signal failure using shell exit code when a test was marked incomplete'],
['spacer' => ''],
['arg' => '--cache-result', 'desc' => 'Write test results to cache file'],
['arg' => '--do-not-cache-result', 'desc' => 'Do not write test results to cache file'],
['spacer' => ''],
['arg' => '--order-by <order>', 'desc' => 'Run tests in order: default|defects|depends|duration|no-depends|random|reverse|size'],
['arg' => '--random-order-seed <N>', 'desc' => 'Use the specified random seed when running tests in random order'],
],
'Reporting' => [
['arg' => '--colors <flag>', 'desc' => 'Use colors in output ("never", "auto" or "always")'],
['arg' => '--columns <n>', 'desc' => 'Number of columns to use for progress output'],
['arg' => '--columns max', 'desc' => 'Use maximum number of columns for progress output'],
['arg' => '--stderr', 'desc' => 'Write to STDERR instead of STDOUT'],
['spacer' => ''],
['arg' => '--no-progress', 'desc' => 'Disable output of test execution progress'],
['arg' => '--no-results', 'desc' => 'Disable output of test results'],
['arg' => '--no-output', 'desc' => 'Disable all output'],
['spacer' => ''],
['arg' => '--display-incomplete', 'desc' => 'Display details for incomplete tests'],
['arg' => '--display-skipped', 'desc' => 'Display details for skipped tests'],
['arg' => '--display-deprecations', 'desc' => 'Display details for deprecations triggered by tests'],
['arg' => '--display-errors', 'desc' => 'Display details for errors triggered by tests'],
['arg' => '--display-notices', 'desc' => 'Display details for notices triggered by tests'],
['arg' => '--display-warnings', 'desc' => 'Display details for warnings triggered by tests'],
['arg' => '--reverse-list', 'desc' => 'Print defects in reverse order'],
['spacer' => ''],
['arg' => '--teamcity', 'desc' => 'Replace default progress and result output with TeamCity format'],
['arg' => '--testdox', 'desc' => 'Replace default result output with TestDox format'],
['spacer' => ''],
['arg' => '--debug', 'desc' => 'Replace default progress and result output with debugging information'],
],
'Logging' => [
['arg' => '--log-junit <file>', 'desc' => 'Write test results in JUnit XML format to file'],
['arg' => '--log-teamcity <file>', 'desc' => 'Write test results in TeamCity format to file'],
['arg' => '--testdox-html <file>', 'desc' => 'Write test results in TestDox format (HTML) to file'],
['arg' => '--testdox-text <file>', 'desc' => 'Write test results in TestDox format (plain text) to file'],
['arg' => '--log-events-text <file>', 'desc' => 'Stream events as plain text to file'],
['arg' => '--log-events-verbose-text <file>', 'desc' => 'Stream events as plain text with extended information to file'],
['arg' => '--no-logging', 'desc' => 'Ignore logging configured in the XML configuration file'],
],
'Code Coverage' => [
['arg' => '--coverage-clover <file>', 'desc' => 'Write code coverage report in Clover XML format to file'],
['arg' => '--coverage-cobertura <file>', 'desc' => 'Write code coverage report in Cobertura XML format to file'],
['arg' => '--coverage-crap4j <file>', 'desc' => 'Write code coverage report in Crap4J XML format to file'],
['arg' => '--coverage-html <dir>', 'desc' => 'Write code coverage report in HTML format to directory'],
['arg' => '--coverage-php <file>', 'desc' => 'Write serialized code coverage data to file'],
['arg' => '--coverage-text=<file>', 'desc' => 'Write code coverage report in text format to file [default: standard output]'],
['arg' => '--coverage-xml <dir>', 'desc' => 'Write code coverage report in XML format to directory'],
['arg' => '--warm-coverage-cache', 'desc' => 'Warm static analysis cache'],
['arg' => '--coverage-filter <dir>', 'desc' => 'Include <dir> in code coverage reporting'],
['arg' => '--path-coverage', 'desc' => 'Report path coverage in addition to line coverage'],
['arg' => '--disable-coverage-ignore', 'desc' => 'Disable metadata for ignoring code coverage'],
['arg' => '--no-coverage', 'desc' => 'Ignore code coverage reporting configured in the XML configuration file'],
],
'Miscellaneous' => [
['arg' => '-h|--help', 'desc' => 'Prints this usage information'],
['arg' => '--version', 'desc' => 'Prints the version and exits'],
['arg' => '--atleast-version <min>', 'desc' => 'Checks that version is greater than <min> and exits'],
['arg' => '--check-version', 'desc' => 'Check whether PHPUnit is the latest version and exits'],
],
];
private const LEFT_MARGIN = ' ';
private int $lengthOfLongestOptionName = 0;
private readonly int $columnsAvailableForDescription;
private ?bool $hasColor;
@@ -180,7 +44,7 @@ final class Help
$this->hasColor = $withColor;
}
foreach (self::HELP_TEXT as $options) {
foreach ($this->elements() as $options) {
foreach ($options as $option) {
if (isset($option['arg'])) {
$this->lengthOfLongestOptionName = max($this->lengthOfLongestOptionName, isset($option['arg']) ? strlen($option['arg']) : 0);
@@ -204,7 +68,7 @@ final class Help
{
$buffer = '';
foreach (self::HELP_TEXT as $section => $options) {
foreach ($this->elements() as $section => $options) {
$buffer .= "{$section}:" . PHP_EOL;
if ($section !== 'Usage') {
@@ -237,7 +101,7 @@ final class Help
{
$buffer = '';
foreach (self::HELP_TEXT as $section => $options) {
foreach ($this->elements() as $section => $options) {
$buffer .= Color::colorize('fg-yellow', "{$section}:") . PHP_EOL;
if ($section !== 'Usage') {
@@ -276,4 +140,157 @@ final class Help
return $buffer;
}
/**
* @psalm-return array<non-empty-string, non-empty-list<array{text: non-empty-string}|array{arg: non-empty-string, desc: non-empty-string}|array{spacer: ''}>>
*/
private function elements(): array
{
$elements = [
'Usage' => [
['text' => 'phpunit [options] <directory|file> ...'],
],
'Configuration' => [
['arg' => '--bootstrap <file>', 'desc' => 'A PHP script that is included before the tests run'],
['arg' => '-c|--configuration <file>', 'desc' => 'Read configuration from XML file'],
['arg' => '--no-configuration', 'desc' => 'Ignore default configuration file (phpunit.xml)'],
['arg' => '--no-extensions', 'desc' => 'Do not load PHPUnit extensions'],
['arg' => '--include-path <path(s)>', 'desc' => 'Prepend PHP\'s include_path with given path(s)'],
['arg' => '-d <key[=value]>', 'desc' => 'Sets a php.ini value'],
['arg' => '--cache-directory <dir>', 'desc' => 'Specify cache directory'],
['arg' => '--generate-configuration', 'desc' => 'Generate configuration file with suggested settings'],
['arg' => '--migrate-configuration', 'desc' => 'Migrate configuration file to current format'],
['arg' => '--generate-baseline <file>', 'desc' => 'Generate baseline for issues'],
['arg' => '--use-baseline <file>', 'desc' => 'Use baseline to ignore issues'],
['arg' => '--ignore-baseline', 'desc' => 'Do not use baseline to ignore issues'],
],
'Selection' => [
['arg' => '--list-suites', 'desc' => 'List available test suites'],
['arg' => '--testsuite <name>', 'desc' => 'Only run tests from the specified test suite(s)'],
['arg' => '--exclude-testsuite <name>', 'desc' => 'Exclude tests from the specified test suite(s)'],
['arg' => '--list-groups', 'desc' => 'List available test groups'],
['arg' => '--group <name>', 'desc' => 'Only run tests from the specified group(s)'],
['arg' => '--exclude-group <name>', 'desc' => 'Exclude tests from the specified group(s)'],
['arg' => '--covers <name>', 'desc' => 'Only run tests that intend to cover <name>'],
['arg' => '--uses <name>', 'desc' => 'Only run tests that intend to use <name>'],
['arg' => '--list-tests', 'desc' => 'List available tests'],
['arg' => '--list-tests-xml <file>', 'desc' => 'List available tests in XML format'],
['arg' => '--filter <pattern>', 'desc' => 'Filter which tests to run'],
['arg' => '--test-suffix <suffixes>', 'desc' => 'Only search for test in files with specified suffix(es). Default: Test.php,.phpt'],
],
'Execution' => [
['arg' => '--process-isolation', 'desc' => 'Run each test in a separate PHP process'],
['arg' => '--globals-backup', 'desc' => 'Backup and restore $GLOBALS for each test'],
['arg' => '--static-backup', 'desc' => 'Backup and restore static properties for each test'],
['spacer' => ''],
['arg' => '--strict-coverage', 'desc' => 'Be strict about code coverage metadata'],
['arg' => '--strict-global-state', 'desc' => 'Be strict about changes to global state'],
['arg' => '--disallow-test-output', 'desc' => 'Be strict about output during tests'],
['arg' => '--enforce-time-limit', 'desc' => 'Enforce time limit based on test size'],
['arg' => '--default-time-limit <sec>', 'desc' => 'Timeout in seconds for tests that have no declared size'],
['arg' => '--dont-report-useless-tests', 'desc' => 'Do not report tests that do not test anything'],
['spacer' => ''],
['arg' => '--stop-on-defect', 'desc' => 'Stop after first error, failure, warning, or risky test'],
['arg' => '--stop-on-error', 'desc' => 'Stop after first error'],
['arg' => '--stop-on-failure', 'desc' => 'Stop after first failure'],
['arg' => '--stop-on-warning', 'desc' => 'Stop after first warning'],
['arg' => '--stop-on-risky', 'desc' => 'Stop after first risky test'],
['arg' => '--stop-on-deprecation', 'desc' => 'Stop after first test that triggered a deprecation'],
['arg' => '--stop-on-notice', 'desc' => 'Stop after first test that triggered a notice'],
['arg' => '--stop-on-skipped', 'desc' => 'Stop after first skipped test'],
['arg' => '--stop-on-incomplete', 'desc' => 'Stop after first incomplete test'],
['spacer' => ''],
['arg' => '--fail-on-warning', 'desc' => 'Signal failure using shell exit code when a warning was triggered'],
['arg' => '--fail-on-risky', 'desc' => 'Signal failure using shell exit code when a test was considered risky'],
['arg' => '--fail-on-deprecation', 'desc' => 'Signal failure using shell exit code when a deprecation was triggered'],
['arg' => '--fail-on-notice', 'desc' => 'Signal failure using shell exit code when a notice was triggered'],
['arg' => '--fail-on-skipped', 'desc' => 'Signal failure using shell exit code when a test was skipped'],
['arg' => '--fail-on-incomplete', 'desc' => 'Signal failure using shell exit code when a test was marked incomplete'],
['spacer' => ''],
['arg' => '--cache-result', 'desc' => 'Write test results to cache file'],
['arg' => '--do-not-cache-result', 'desc' => 'Do not write test results to cache file'],
['spacer' => ''],
['arg' => '--order-by <order>', 'desc' => 'Run tests in order: default|defects|depends|duration|no-depends|random|reverse|size'],
['arg' => '--random-order-seed <N>', 'desc' => 'Use the specified random seed when running tests in random order'],
],
'Reporting' => [
['arg' => '--colors <flag>', 'desc' => 'Use colors in output ("never", "auto" or "always")'],
['arg' => '--columns <n>', 'desc' => 'Number of columns to use for progress output'],
['arg' => '--columns max', 'desc' => 'Use maximum number of columns for progress output'],
['arg' => '--stderr', 'desc' => 'Write to STDERR instead of STDOUT'],
['spacer' => ''],
['arg' => '--no-progress', 'desc' => 'Disable output of test execution progress'],
['arg' => '--no-results', 'desc' => 'Disable output of test results'],
['arg' => '--no-output', 'desc' => 'Disable all output'],
['spacer' => ''],
['arg' => '--display-incomplete', 'desc' => 'Display details for incomplete tests'],
['arg' => '--display-skipped', 'desc' => 'Display details for skipped tests'],
['arg' => '--display-deprecations', 'desc' => 'Display details for deprecations triggered by tests'],
['arg' => '--display-errors', 'desc' => 'Display details for errors triggered by tests'],
['arg' => '--display-notices', 'desc' => 'Display details for notices triggered by tests'],
['arg' => '--display-warnings', 'desc' => 'Display details for warnings triggered by tests'],
['arg' => '--reverse-list', 'desc' => 'Print defects in reverse order'],
['spacer' => ''],
['arg' => '--teamcity', 'desc' => 'Replace default progress and result output with TeamCity format'],
['arg' => '--testdox', 'desc' => 'Replace default result output with TestDox format'],
['spacer' => ''],
['arg' => '--debug', 'desc' => 'Replace default progress and result output with debugging information'],
],
'Logging' => [
['arg' => '--log-junit <file>', 'desc' => 'Write test results in JUnit XML format to file'],
['arg' => '--log-teamcity <file>', 'desc' => 'Write test results in TeamCity format to file'],
['arg' => '--testdox-html <file>', 'desc' => 'Write test results in TestDox format (HTML) to file'],
['arg' => '--testdox-text <file>', 'desc' => 'Write test results in TestDox format (plain text) to file'],
['arg' => '--log-events-text <file>', 'desc' => 'Stream events as plain text to file'],
['arg' => '--log-events-verbose-text <file>', 'desc' => 'Stream events as plain text with extended information to file'],
['arg' => '--no-logging', 'desc' => 'Ignore logging configured in the XML configuration file'],
],
'Code Coverage' => [
['arg' => '--coverage-clover <file>', 'desc' => 'Write code coverage report in Clover XML format to file'],
['arg' => '--coverage-cobertura <file>', 'desc' => 'Write code coverage report in Cobertura XML format to file'],
['arg' => '--coverage-crap4j <file>', 'desc' => 'Write code coverage report in Crap4J XML format to file'],
['arg' => '--coverage-html <dir>', 'desc' => 'Write code coverage report in HTML format to directory'],
['arg' => '--coverage-php <file>', 'desc' => 'Write serialized code coverage data to file'],
['arg' => '--coverage-text=<file>', 'desc' => 'Write code coverage report in text format to file [default: standard output]'],
['arg' => '--coverage-xml <dir>', 'desc' => 'Write code coverage report in XML format to directory'],
['arg' => '--warm-coverage-cache', 'desc' => 'Warm static analysis cache'],
['arg' => '--coverage-filter <dir>', 'desc' => 'Include <dir> in code coverage reporting'],
['arg' => '--path-coverage', 'desc' => 'Report path coverage in addition to line coverage'],
['arg' => '--disable-coverage-ignore', 'desc' => 'Disable metadata for ignoring code coverage'],
['arg' => '--no-coverage', 'desc' => 'Ignore code coverage reporting configured in the XML configuration file'],
],
];
if (defined('__PHPUNIT_PHAR__')) {
$elements['PHAR'] = [
['arg' => '--manifest', 'desc' => 'Print Software Bill of Materials (SBOM) in plain-text format'],
['arg' => '--sbom', 'desc' => 'Print Software Bill of Materials (SBOM) in CycloneDX XML format'],
['arg' => '--composer-lock', 'desc' => 'Print composer.lock file used to build the PHAR'],
];
}
$elements['Miscellaneous'] = [
['arg' => '-h|--help', 'desc' => 'Prints this usage information'],
['arg' => '--version', 'desc' => 'Prints the version and exits'],
['arg' => '--atleast-version <min>', 'desc' => 'Checks that version is greater than <min> and exits'],
['arg' => '--check-version', 'desc' => 'Check whether PHPUnit is the latest version and exits'],
];
return $elements;
}
}