Merge pull request #116 from kodie/kodie/command-logo-support

Add logo support for commands (rebased)

Author: adhocore

README.md

@@ -185,7 +185,8 @@ class InitCommand extends Ahc\Cli\Input\Command
                 '<bold>  init</end> <comment>--apple applet --ball ballon <arggg></end> ## details 1<eol/>' .
                 // $0 will be interpolated to actual command name
                 '<bold>  $0</end> <comment>-a applet -b ballon <arggg> [arg2]</end> ## details 2<eol/>'
-            );
+            )
+            ->logo('Ascii art logo of your command');
     }
 
     // This method is auto called before `self::execute()` and receives `Interactor $io` instance

src/Input/Command.php

@@ -52,6 +52,8 @@ class Command extends Parser implements Groupable
 
     protected ?string $_alias = null;
 
+    protected string $_logo = '';
+
     protected string $_help = '';
 
     private array $_events = [];
@@ -154,6 +156,24 @@ public function bind(?App $app = null): self
         return $this;
     }
 
+    /**
+     * Sets or gets the ASCII art logo.
+     *
+     * @param string|null $logo
+     *
+     * @return string|self
+     */
+    public function logo(?string $logo = null)
+    {
+        if (func_num_args() === 0) {
+            return $this->_logo;
+        }
+
+        $this->_logo = $logo;
+
+        return $this;
+    }
+
     /**
      * Registers argument definitions (all at once). Only last one can be variadic.
      */
@@ -332,6 +352,11 @@ public function showDefaultHelp(): mixed
     {
         $io     = $this->io();
         $helper = new OutputHelper($io->writer());
+        $app    = $this->app();
+
+        if (($logo = $this->logo()) || ($app && ($logo = $app->logo()) && $app->getDefaultCommand() === $this->_name)) {
+            $io->logo($logo, true);
+        }
 
         $io->help_header("Command {$this->_name}, version {$this->_version}", true)->eol();
         $io->help_summary($this->_desc, true)->eol();

tests/ApplicationTest.php

@@ -237,6 +237,21 @@ public function test_logo()
         $this->assertSame($logo, $a->logo());
     }
 
+    public function test_logo_command()
+    {
+        $a = $this->newApp('test', '0.0.2');
+        $c = $a->command('cmd');
+
+        $this->assertSame($c, $c->logo($logo = '
+            | |_ ___  ___| |_
+            | __/ _ \/ __| __|
+            | ||  __/\__ \ |_
+             \__\___||___/\__|
+        '));
+
+        $this->assertSame($logo, $c->logo());
+    }
+
     public function test_add()
     {
         $a = $this->newApp('test', '0.0.1-test');