feat: add support for options with attached values by =

Author: paulbalandan

system/CLI/CommandLineParser.php

@@ -83,7 +83,13 @@ private function parseTokens(array $tokens): void
                 $name  = ltrim($token, '-');
                 $value = null;
 
-                if (isset($tokens[$index + 1]) && ! str_starts_with($tokens[$index + 1], '-')) {
+                if (str_contains($name, '=')) {
+                    [$name, $value] = explode('=', $name, 2);
+
+                    if ($value === '') {
+                        $value = null;
+                    }
+                } elseif (isset($tokens[$index + 1]) && ! str_starts_with($tokens[$index + 1], '-')) {
                     $value = $tokens[$index + 1];
 
                     $optionValue = true;

tests/system/CLI/CommandLineParserTest.php

@@ -107,5 +107,23 @@ public static function provideParseCommand(): iterable
             ['b', 'c', 'd'],
             [],
         ];
+
+        yield 'options with equals sign' => [
+            ['--key=value', '--foo='],
+            [],
+            ['key' => 'value', 'foo' => null],
+        ];
+
+        yield 'options with equals sign and double hyphen' => [
+            ['--key=value', '--foo=', 'bar', '--', 'b', 'c', 'd'],
+            ['bar', 'b', 'c', 'd'],
+            ['key' => 'value', 'foo' => null],
+        ];
+
+        yield 'mixed options with and without equals sign' => [
+            ['--key=value', '--foo', 'bar', '--', 'b', 'c', 'd'],
+            ['b', 'c', 'd'],
+            ['key' => 'value', 'foo' => 'bar'],
+        ];
     }
 }

user_guide_src/source/changelogs/v4.8.0.rst

@@ -145,6 +145,8 @@ Commands
 
 - ``CLI`` now supports the ``--`` separator to mean that what follows are arguments, not options. This allows you to have arguments that start with ``-`` without them being treated as options.
     For example: ``spark my:command -- --myarg`` will pass ``--myarg`` as an argument instead of an option.
+- ``CLI`` now supports options with values specified using an equals sign (e.g., ``--option=value``) in addition to the existing space-separated syntax (e.g., ``--option value``).
+    This provides more flexibility in how you can pass options to commands.
 
 Testing
 =======
@@ -197,6 +199,8 @@ HTTP
     Consequently, ``CURLRequest``'s ``$config`` parameter is unused and will be removed in a future release.
 - ``CLIRequest`` now supports the ``--`` separator to mean that what follows are arguments, not options. This allows you to have arguments that start with ``-`` without them being treated as options.
     For example: ``php index.php command -- --myarg`` will pass ``--myarg`` as an argument instead of an option.
+- ``CLIRequest`` now supports options with values specified using an equals sign (e.g., ``--option=value``) in addition to the existing space-separated syntax (e.g., ``--option value``).
+    This provides more flexibility in how you can pass options to CLI requests.
 
 Validation
 ==========