update readme. add method for autoload commands and controllers

Author: inhere

README.md

@@ -198,6 +198,15 @@ class HomeController extends Controller
 
 更多请查看 [examples](./examples) 中的示例代码和在目录下运行示例 `php examples/app` 来查看效果
 
+### 自动扫描注册
+
+可以配置命名空间和对应的路径来，自动扫描并注册命令。
+
+```php
+$app->registerCommands('App\\Console\\Commands', get_path('app/Console/Commands'));
+$app->registerGroups('App\\Console\\Controllers', get_path('app/Console/Controllers'));
+```
+
 ## 输入
 
 > 输入对象是 `Inhere\Console\IO\Input` 的实例

src/Application.php

@@ -9,6 +9,7 @@
 namespace Inhere\Console;
 
 use Inhere\Console\Base\AbstractApplication;
+use Inhere\Console\Utils\Helper;
 
 /**
  * Class App
@@ -157,6 +158,69 @@ public function addGroup(string $name, string $controller = null)
         return $this->controller($name, $controller);
     }
 
+    /**
+     * auto register commands from a dir.
+     * @param string $namespace
+     * @param string $basePath
+     * @return $this
+     * @throws \InvalidArgumentException
+     */
+    public function registerCommands(string $namespace, string $basePath)
+    {
+        $length = \strlen($basePath) + 1;
+        $iterator = Helper::recursiveDirectoryIterator($basePath, $this->getFileFilter());
+
+        foreach ($iterator as $file) {
+            $class = $namespace . '\\' . \substr($file, $length, -4);
+            $this->addCommand($class);
+        }
+
+        return $this;
+    }
+
+    /**
+     * auto register controllers from a dir.
+     * @param string $namespace
+     * @param string $basePath
+     * @return $this
+     * @throws \InvalidArgumentException
+     */
+    public function registerGroups(string $namespace, string $basePath)
+    {
+        $length = \strlen($basePath) + 1;
+        $iterator = Helper::recursiveDirectoryIterator($basePath, $this->getFileFilter());
+
+        foreach ($iterator as $file) {
+            $class = $namespace . '\\' . \substr($file, $length, -4);
+            $this->addController($class);
+        }
+
+        return $this;
+    }
+
+    /**
+     * @return \Closure
+     */
+    protected function getFileFilter()
+    {
+        return function (\SplFileInfo $f) {
+            $name = $f->getFilename();
+
+            // Skip hidden files and directories.
+            if ($name[0] === '.') {
+                return false;
+            }
+
+            // go on read sub-dir
+            if ($f->isDir()) {
+                return true;
+            }
+
+            // php file
+            return $f->isFile() && \substr($name, -4) === '.php';
+        };
+    }
+
     /****************************************************************************
      * dispatch and run console controller/command
      ****************************************************************************/

src/BuiltIn/PharController.php

@@ -9,7 +9,7 @@
 namespace Inhere\Console\BuiltIn;
 
 use Inhere\Console\Controller;
-use Inhere\Console\Utils\PharCompiler;
+use Inhere\Console\Components\PharCompiler;
 
 /**
  * Class PharController
@@ -49,7 +49,7 @@ public function packCommand()
             'dirExclude' => '#[\.git|tests]#',
 
             'fileInclude' => ['LICENSE', 'app', 'liteApp'],
-            'fileMatch' => '#\.php#',
+            'fileMatch' => '#\.php$#',
         ]);
 
         $pharFile = BASE_PATH . '/test.phar';
@@ -60,4 +60,4 @@ public function packCommand()
             'size' => round(filesize($pharFile) / 1000, 2) . ' kb',
         ]);
     }
-}
+}

src/Utils/AutoCompletion.php src/Components/AutoCompletion.phpsrc/Utils/AutoCompletion.php renamed to src/Components/AutoCompletion.php

@@ -6,13 +6,13 @@
  * Time: 17:56
  */
 
-namespace Inhere\Console\Utils;
+namespace Inhere\Console\Components;
 
 /**
  * Class AutoCompletion - a simple command auto-completion tool
  *
  * @todo not available
- * @package Inhere\Console\Utils
+ * @package Inhere\Console\Components
  */
 class AutoCompletion
 {

src/Components/AutoLoader.php

@@ -6,13 +6,13 @@
  * Time: 17:57
  */
 
-namespace Inhere\Console\Utils;
+namespace Inhere\Console\Components;
 
 use Phar;
 
 /**
  * Class PharCompiler
- * @package Inhere\Console\Utils
+ * @package Inhere\Console\Components
  * @ref Psy\Compiler (package psy/psysh)
  */
 class PharCompiler

src/Utils/PharCompiler.php src/Components/PharCompiler.phpsrc/Utils/PharCompiler.php renamed to src/Components/PharCompiler.php

@@ -92,12 +92,12 @@ public static function init($object, array $options)
      * @param string $srcDir
      * @param callable $filter
      * @return \RecursiveIteratorIterator
-     * @throws \LogicException
+     * @throws \InvalidArgumentException
      */
     public static function recursiveDirectoryIterator(string $srcDir, callable $filter)
     {
         if (!$srcDir || !file_exists($srcDir)) {
-            throw new \LogicException('Please provide a exists source directory.');
+            throw new \InvalidArgumentException('Please provide a exists source directory.');
         }
 
         $directory = new \RecursiveDirectoryIterator($srcDir);