v2.0.0

Breaking Changes

• Console::run() and Console::exec() return the process exit code as an int instead of void. Callers can ignore the value, but a subclass that overrides either method with a : void signature has to be updated (#50)
• An option declared with a type other than flag and passed without a value is now a validation error instead of being silently true (#38)
• A command that declares -h or --help itself now receives that option instead of the console showing the auto generated help (#36)

New Features

• Space separated option values: an option declared in $optionDefinitions with a type other than flag takes the next token, so -o value and --opt value work next to --opt=value. A negative number like -5 is an argument now and no longer needs the -- marker (#48)
• Commands decide the process exit code with setExitCode(), returned by Console::run() (#50)
• Uncaught command exceptions are handled by the console: setDebug() adds the class name and stack trace, setExceptionHandler() hands them to the application (#51)
• Help output lists the argument and option definitions of a command (#49)
• Definition defaults are applied to arguments and options before the command runs (#39)
• New flag option type for options that are meant to be passed without a value (#38)
• NO_COLOR and FORCE_COLOR environment conventions are honoured (#47)
• Validation errors are translatable, with en, es and pt-br messages (#55, thanks to @mahdyaralipor)

Fixes

• Validation messages and help output use the definition name instead of the array key (#54)
• Help is resolved through the command registry, and value arguments are skipped when looking for it (#36)
• Command suggestions only come from active commands and their aliases (#40)
• CLI::strlen() strips arbitrary ANSI sequences, and style codes are cached (#45)
• CLI::style() validates colors and formats even when the terminal has no ANSI support (#44)
• Quiet mode silences progress(), spinner(), liveLine(), clear() and beep() (#37)
• --quiet and --no-ansi are scoped to their dispatch instead of leaking into the next one (#41)
• An empty argument no longer raises a string offset warning in Console::prepare() (#35)
• composer.json requires only ext-mbstring, the unused extension requirements are gone (#42)

Internal

• The test suite is platform independent and runs on Windows (#43)
• CI runs the tests on PHP 8.2, 8.3 and 8.4, and the lint and static analysis jobs are blocking (#53)

Documentation

• README examples corrected to match the actual behaviour, and the option parsing rules are documented (#46, #48)

v1.1.0

New Features

• Auto generated help output for -h and --help on any command (#2)
• "Did you mean" suggestions for unknown command names, using Levenshtein distance (#3)
• Command aliases, so a command can be reached by multiple names (#4)
• Console wide quiet mode and --no-ansi / -q global flags (#8)
• Progress bar and spinner helpers (CLI::progress(), CLI::spinner()) (#14)
• Signal handling via pcntl: CLI::onSignal(), CLI::onSigint(), CLI::restoreSignal() (#12)
• Typed argument and option definitions with validation for commands (#6)
• CLI::masked() prompt helper that echoes a mask character for sensitive input (#16)
• PHPStan static analysis config and composer script (#10)

Fixes

• Declare required PHP extensions in composer.json (#1)

Documentation

• Real README overview of the CLI, Command and Console components (#5)
• Step by step guide to registering and running a custom command (#7)
• Docs for output, color and input helpers (#11)

Internal

• Subprocess tests covering command dispatch and process exit codes (#13)
• CI badge and PHPStan in the lint job (#9)
• PHPStan raised to level 10