update: add debugf for print logs

Author: inhere

src/AbstractApplication.php

@@ -429,6 +429,19 @@ public function logf(int $level, string $format, ...$args): void
         Console::logf($level, $format, ...$args);
     }
 
+    /**
+     * @param string $format
+     * @param mixed  ...$args
+     */
+    public function debugf(string $format, ...$args): void
+    {
+        if ($this->getVerbLevel() < Console::VERB_DEBUG) {
+            return;
+        }
+
+        Console::logf(Console::VERB_DEBUG, $format, ...$args);
+    }
+
     /**********************************************************
      * getter/setter methods
      **********************************************************/

src/Application.php

@@ -139,6 +139,7 @@ public function command(string $name, $handler = null, $option = null)
             ];
         }
 
+        $this->logf(Console::VERB_CRAZY, 'load application command: %s', $name);
         $this->router->addCommand($name, $handler, (array)$option);
 
         return $this;
@@ -265,7 +266,7 @@ public function dispatch(string $name, bool $detachedRun = false)
         }
 
         $cmdId = $name;
-        $this->logf(Console::VERB_DEBUG, 'begin dispatch the input command: %s', $name);
+        $this->debugf( 'begin dispatch the input command: %s', $name);
 
         // format is: `group action`
         if (strpos($name, ' ') > 0) {
@@ -277,8 +278,9 @@ public function dispatch(string $name, bool $detachedRun = false)
 
         // command not found
         if (!$info) {
-            if (true === $this->fire(ConsoleEvent::ON_NOT_FOUND, $cmdId, $this)) {
-                $this->logf(Console::VERB_DEBUG, 'not found handle by user, command: %s', $name);
+            $evtName = ConsoleEvent::ON_NOT_FOUND;
+            if (true === $this->fire($evtName, $cmdId, $this)) {
+                $this->debugf('user custom handle the not found command: %s, event: %s', $name, $evtName);
                 return 0;
             }
 

src/Concern/AttachApplicationTrait.php

@@ -101,6 +101,19 @@ public function getVerbLevel(): int
         return (int)$this->input->getLongOpt('debug', Console::VERB_ERROR);
     }
 
+    /**
+     * @param string $format
+     * @param mixed  ...$args
+     */
+    public function debugf(string $format, ...$args): void
+    {
+        if ($this->getVerbLevel() < Console::VERB_DEBUG) {
+            return;
+        }
+
+        Console::logf(Console::VERB_DEBUG, $format, ...$args);
+    }
+
     /**
      * @param int    $level
      * @param string $format

src/Controller.php

@@ -217,15 +217,15 @@ public function run(string $command = '')
 
         // if not input sub-command, render group help.
         if (!$command) {
-            $this->logf(Console::VERB_DEBUG, 'sub-command is empty, display help for the group: %s', self::getName());
+            $this->debugf('sub-command is empty, display help for the group: %s', self::getName());
             return $this->showHelp();
         }
 
         $command = $this->getRealCommandName($command);
 
         // convert 'boo-foo' to 'booFoo'
         $this->action = Str::camelCase($command);
-        $this->logf(Console::VERB_DEBUG, 'will run the group action: %s, sub-command: %s', $this->action, $command);
+        $this->debugf('will run the group action: %s, sub-command: %s', $this->action, $command);
 
         // do running
         return parent::run($command);
@@ -277,7 +277,7 @@ final public function execute($input, $output)
         $group  = static::getName();
 
         if ($this->isDisabled($action)) {
-            $this->logf(Console::VERB_DEBUG, 'command %s is disabled on the group %s', $action, $group);
+            $this->debugf('command %s is disabled on the group %s', $action, $group);
             $output->error(sprintf("Sorry, The command '%s' is invalid in the group '%s'!", $action, $group));
             return -1;
         }
@@ -291,7 +291,7 @@ final public function execute($input, $output)
             if (method_exists($this, $beforeFunc = 'before' . ucfirst($action))) {
                 $beforeOk = $this->$beforeFunc($input, $output);
                 if ($beforeOk === false) {
-                    $this->logf(Console::VERB_DEBUG, '%s() returns FALSE, interrupt processing continues', $beforeFunc);
+                    $this->debugf('%s() returns FALSE, interrupt processing continues', $beforeFunc);
                     return 0;
                 }
             }
@@ -309,11 +309,11 @@ final public function execute($input, $output)
 
         // if user custom handle not found logic.
         if ($this->onNotFound($action)) {
-            $this->logf(Console::VERB_DEBUG, 'user custom handle the action:%s not found logic', $action);
+            $this->debugf('user custom handle the action:%s not found logic', $action);
             return 0;
         }
 
-        $this->logf(Console::VERB_DEBUG, 'action:%s not found on the group controller', $action);
+        $this->debugf('action:%s not found on the group controller', $action);
 
         // if you defined the method '$this->notFoundCallback' , will call it
         // if (($notFoundCallback = $this->notFoundCallback) && method_exists($this, $notFoundCallback)) {