add new function: multi select

Author: inhere

examples/Controllers/HomeController.php

@@ -379,6 +379,7 @@ public function defArgCommand()
      */
     public function confirmCommand()
     {
+        // can also: $this->confirm();
         $a = Interact::confirm('continue');
 
         $this->write('Your answer is: ' . ($a ? 'yes' : 'no'));
@@ -390,11 +391,25 @@ public function confirmCommand()
     public function selectCommand()
     {
         $opts = ['john', 'simon', 'rose'];
+        // can also: $this->select();
         $a = Interact::select('you name is', $opts);
 
         $this->write('Your answer is: ' . $opts[$a]);
     }
 
+    /**
+     * This is a demo for use <magenta>Interact::multiSelect()</magenta> method
+     */
+    public function msCommand()
+    {
+        $opts = ['john', 'simon', 'rose', 'tom'];
+
+        // can also: $a = Interact::multiSelect('Your friends are', $opts);
+        $a = $this->multiSelect('Your friends are', $opts);
+
+        $this->write('Your answer is: ' . json_encode($a));
+    }
+
     /**
      * This is a demo for use <magenta>Interact::ask()</magenta> method
      */

src/Traits/UserInteractAwareTrait.php

@@ -18,6 +18,9 @@
  * @method string readRow($message = null, $nl = false)
  * @method string read($message = null, $nl = false, array $opts = [])
  *
+ * @method array checkbox(string $description, $options, $default = null, $allowExit = true)
+ * @method array multiSelect(string $description, $options, $default = null, $allowExit = true)
+ *
  * @method string askHiddenInput(string $prompt = 'Enter Password:')
  * @method string promptSilent(string $prompt = 'Enter Password:')
  * @method string askPassword(string $prompt = 'Enter Password:')

src/Utils/Interact.php

@@ -142,7 +142,55 @@ public static function checkbox(string $description, $options, $default = null,
      */
     public static function multiSelect(string $description, $options, $default = null, $allowExit = true)
     {
-        return [];
+        if (!$description = trim($description)) {
+            self::error('Please provide a description text!', 1);
+        }
+
+        $sep = ','; // ',' ' '
+        $options = \is_array($options) ? $options : explode(',', $options);
+
+        // If default option is error
+        if (null !== $default && !isset($options[$default])) {
+            self::error("The default option [{$default}] don't exists.", true);
+        }
+
+        if ($allowExit) {
+            $options['q'] = 'quit';
+        }
+
+        $text = "<comment>$description</comment>";
+        foreach ($options as $key => $value) {
+            $text .= "\n  <info>$key</info>) $value";
+        }
+
+        self::write($text);
+        $defaultText = $default ? "[default:<comment>{$default}</comment>]" : '';
+        $filter = function ($val) use($options){
+            return $val !== 'q' && isset($options[$val]);
+        };
+
+        beginChoice:
+        $r = self::read("Your choice{$defaultText} : ");
+        $r = $r !== '' ? str_replace(' ', '', trim($r, $sep)) : '';
+
+        // empty
+        if ($r === '') {
+            goto beginChoice;
+        }
+
+        // exit
+        if ($r === 'q') {
+            self::write("\n  Quit,ByeBye.", true, true);
+        }
+
+        $rs = strpos($r, $sep) ? array_filter(explode($sep, $r), $filter) : [$r];
+
+        // error, try again
+        if (!$rs) {
+            goto beginChoice;
+        }
+
+        return $rs;
     }
 
     /**
@@ -333,7 +381,7 @@ public static function limitedAsk($question, $default = null, \Closure $validato
                 }
             } else {
                 $num = $times + 1;
-                $answer = self::read(sprintf('(You have a [<bold>%s</bold>] chance to enter!) ', $num));
+                $answer = self::read(sprintf('(You have [<bold>%s</bold>] chances to enter!) ', $num));
             }
 
             // If setting verify callback