classOptions
final class Options
The command and the option values given on the command line.
Properties§
public string $commandpublic array<string, string|bool> $valuesMethods§
public function __construct(public string $command, public array<string, string|bool> $values)Parameters
$command | string | The command name |
$values | array<string, string|bool> | Option values by option name |
public static function fromInput(string $command, InputInterface $input): selfReads the global options and the options of a command.
Parameters
$command | string | The command name |
$input | InputInterface | The parsed command line |
Returns
self The optionsTest cases 3
Called from 1
public static function definitions(string $command): list<array{string, bool, string}>Declares the options of a command.
Parameters
$command | string | The command name |
Returns
list<array{string, bool, string}> The name, whether it is a flag, and the description of each optionTest cases 4
public function text(string $name, string|null $default = null): string|nullReturns a value option.
Parameters
$name | string | The option name |
$default | string|null | The value when the option is not given |
Returns
string|null The valueTest cases 1
Called from 5
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:53
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:55
- method-call Requirements\Console\Options::percentage() packages/requirements/src/Console/Options.php:119
- method-call Requirements\Console\Options::matches() packages/requirements/src/Console/Options.php:139
- method-call Requirements\Console\Options::matches() packages/requirements/src/Console/Options.php:143
Calls 1
- function-call
is_stringline 93
public function flag(string $name): boolTells whether a flag is set.
Parameters
$name | string | The option name |
Returns
bool True when the flag was givenTest cases 1
Called from 11
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:40
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:41
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:49
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:51
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:53
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:54
- method-call Requirements\Console\Options::matches() packages/requirements/src/Console/Options.php:144
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:29
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:31
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:47
- method-call Requirements\Console\Verdict::render() packages/requirements/src/Console/Verdict.php:36
public function percentage(string $name): float|nullReturns a percentage option.
Parameters
$name | string | The option name |
Returns
float|null The percentage, or null when the option is not givenThrows
InvalidInputException When the value is not a number from 0 to 100Test cases 2
Called from 1
Calls 4
- method-call Options::text() line 119
- function-call
is_numericline 123 - new InvalidInputException line 124
- static-call Fields::percentage() line 126
public function matches(Item $item): boolTells whether an item passes the spec filters.
Parameters
$item | Item | The item |
Returns
bool True when the item has every given ID, category, status, kind, origin, source and label, and no source under --without-sourceTest cases 2
Called from 1
Calls 3
- method-call Options::text() line 139
- function-call
in_arrayline 144 - method-call Options::flag() line 144
Test cases 40§
Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.
Dedicated tests 10
OptionsTest::testDefinitionsDeclaresTheOptionsOfEachCommandcallsOptionsTest::testFlagTellsWhetherTheFlagIsSetcallsOptionsTest::testFromInputReadsGlobalAndCommandOptionscallsOptionsTest::testFromInputReadsOnlyTheGlobalOptionsOfACommandWithoutOptionscallsOptionsTest::testFromInputSkipsValuesThatAreNeitherTextNorFlagscallsOptionsTest::testMatchesFiltersAnIndependentItemcallsOptionsTest::testMatchesFiltersASourcedItemcallsOptionsTest::testPercentageRejectsInvalidValuescallsOptionsTest::testPercentageReturnsTheNumbercallsOptionsTest::testTextReturnsTheValueOrTheDefaultcalls
Other tests reaching this symbol 30
ApplicationTestcallsCommandHandlerTest::testInvokeReturnsOneForAFailedJsonReportcallsCommandHandlerTest::testInvokeReturnsOneForAFailedTerminalReportcallsCommandHandlerTest::testInvokeWritesUnescapedSlashesAndUnicodecallsCommandLineTestcallsExecutorTest::testExecuteCheckFailsOnInvalidEvidencecallsExecutorTest::testExecuteCheckReadsLiveSourcescallsExecutorTest::testExecuteCheckReportsValidEvidencecallsExecutorTest::testExecuteCoverageAppliesTheThresholdOptionscallsExecutorTest::testExecuteCoverageRefusesASnapshotOfInvalidEvidencecallsExecutorTest::testExecuteCoverageReportsTheConfiguredModecallsExecutorTest::testExecuteCoverageReportsTheLiveModecallsExecutorTest::testExecuteCoverageWritesAndComparesASnapshotcallsExecutorTest::testExecuteFormatFailsTheCheckWhenADocumentNeedsFormattingcallsExecutorTest::testExecuteFormatReportsNoChangesForCanonicalDocumentscallsExecutorTest::testExecuteFormatRewritesDocumentsAndPassescallsExecutorTest::testExecuteLintCountsTheValidatedItemscallsExecutorTest::testExecuteRejectsAnUnknownCommandcallsExecutorTest::testExecuteSpecAcceptsEmptySelectionByDefaultcallsExecutorTest::testExecuteSpecListsRecordsWithoutRunningTestscallsExecutorTest::testExecuteSpecPassesOnlyWhenEveryItemPassescallsExecutorTest::testStrictSpecRequiresLinksEvenWithoutTestExecutioncallsOverviewTestcallsReporterTest::testRenderRejectsAReportWithoutTheShapeOfItsCommandcallsReporterTest::testRenderWritesTheTitleTheCommandBodyAndTheVerdictcallsSpecificationReportTest::testGenerateChecksLinkageIndependentlyOfExecutioncallsVerdictTest::testRenderClosesAPassedReportWithTheCommandMessagecallsVerdictTest::testRenderRejectsErrorsThatAreNotAListOfStringscallsVerdictTest::testRenderReportsAFailedReportcallsVerdictTest::testRenderShowsErrorsBeforeTheSuccessOfAPassedReportcalls
Relations§
Static calls 2
Method calls 14
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:40
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:41
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:49
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:51
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:53
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:53
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:53
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:54
- method-call Requirements\Console\Executor::execute() packages/requirements/src/Console/Executor.php:55
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:28
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:29
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:31
- method-call Requirements\Console\SpecificationReport::generate() packages/requirements/src/Console/SpecificationReport.php:47
- method-call Requirements\Console\Verdict::render() packages/requirements/src/Console/Verdict.php:36
Type declarations 4
- type Requirements\Console\Executor packages/requirements/src/Console/Executor.php:34
- type Requirements\Console\Reporter packages/requirements/src/Console/Reporter.php:31
- type Requirements\Console\SpecificationReport packages/requirements/src/Console/SpecificationReport.php:26
- type Requirements\Console\Verdict packages/requirements/src/Console/Verdict.php:25