WIP

Signed-off-by: alexmerlin <alex.merlin.1985@gmail.com>

Author: alexmerlin

docs/book/v1/component/collection.md

@@ -1,3 +1,50 @@
 # Create Collection
 
 > Collections can be created only in APIs.
+
+To create a collection, use either of the following commands:
+
+```shell
+composer make collection
+```
+
+OR
+
+```shell
+./vendor/bin/dot-maker collection
+```
+
+The command must identify in which module you want to create the new collection.
+To determine this, it will prompt you to enter the name of an existing module:
+
+> Existing module name:
+
+If you input a module name which does not exist (like, "NonExistentModule"), the command throws an error:
+
+> Module "NonExistentModule" not found
+
+and will keep prompting for a valid module name until you provide one.
+
+---
+
+Once the target module has been identified, the command will prompt you to input a name for the collection:
+
+> Collection name:
+
+**The name must contain only letters and numbers.**
+
+If you leave the name blank, the command will exit.
+
+If you input an invalid name (like, "."), the command throws an error:
+
+> Invalid Collection name: "."
+
+If you input the name of an existing collection (like, "ExistingCollection"), the command throws an error:
+
+> Class "ExistingCollection" already exists at /path/to/project/src/ExistingModule/src/Collection/ExistingCollection.php
+
+If you input a valid name, the command will create the collection and output a success message:
+
+> Created Collection: /path/to/project/src/ExistingModule/src/Collection/NewCollection.php
+
+To allow the creation of multiple collections, the command will loop until you leave the name blank.

docs/book/v1/component/handler.md

@@ -0,0 +1 @@
+# Create Handler

mkdocs.yml

@@ -17,6 +17,7 @@ nav:
           - Create Command: v1/component/command.md
           - Create Entity: v1/component/entity.md
           - Create Form: v1/component/form.md
+          - Create Handler: v1/component/handler.md
           - Create Input: v1/component/input.md
           - Create InputFilter: v1/component/input-filter.md
           - Create Middleware: v1/component/middleware.md

src/IO/Output.php

@@ -49,13 +49,13 @@ public static function warning(string $message, bool $exit = false): void
         $exit && exit(self::SUCCESS);
     }
 
-    public static function write(string $message, bool $exit = false): void
+    public static function write(string $message = '', bool $exit = false): void
     {
         fwrite(STDOUT, $message);
         $exit && exit(self::SUCCESS);
     }
 
-    public static function writeLine(string $message, bool $exit = false): void
+    public static function writeLine(string $message = '', bool $exit = false): void
     {
         fwrite(STDOUT, $message . PHP_EOL);
         $exit && exit(self::SUCCESS);

src/Type/Collection.php

@@ -27,7 +27,7 @@ public function __invoke(): void
         }
 
         while (true) {
-            $name = ucfirst(Input::prompt('Enter new Collection name: '));
+            $name = ucfirst(Input::prompt('Collection name: '));
             if ($name === '') {
                 return;
             }

src/Type/Command.php

@@ -31,7 +31,7 @@ class Command extends AbstractType implements FileInterface
     public function __invoke(): void
     {
         while (true) {
-            $name = ucfirst(Input::prompt('Enter new Command name: '));
+            $name = ucfirst(Input::prompt('Command name: '));
             if ($name === '') {
                 return;
             }

src/Type/Entity.php

@@ -28,7 +28,7 @@ class Entity extends AbstractType implements FileInterface
     public function __invoke(): void
     {
         while (true) {
-            $name = ucfirst(Input::prompt('Enter new Entity name: '));
+            $name = ucfirst(Input::prompt('Entity name: '));
             if ($name === '') {
                 return;
             }

src/Type/Form.php

@@ -23,7 +23,7 @@ public function __invoke(): void
             return;
         }
 
-        $name = ucfirst(Input::prompt('Enter new Form name: '));
+        $name = ucfirst(Input::prompt('Form name: '));
         if ($name === '') {
             return;
         }

src/Type/Handler.php

@@ -19,7 +19,7 @@ class Handler extends AbstractType implements FileInterface
     public function __invoke(): void
     {
         while (true) {
-            $name = ucfirst(Input::prompt('Enter new Handler name: '));
+            $name = ucfirst(Input::prompt('Handler name: '));
             if ($name === '') {
                 break;
             }

src/Type/Help.php

@@ -4,30 +4,56 @@
 
 namespace Dot\Maker\Type;
 
+use Dot\Maker\ColorEnum;
 use Dot\Maker\IO\Output;
+use Dot\Maker\Message;
 
 class Help extends AbstractType
 {
     public function __invoke(): void
     {
         Output::info('dot-maker');
-        Output::writeLine(<<<HELP
-
-Usage: ./vendor/bin/dot-maker <component>
-
-Where <component> must be replaced with one of the following strings:
-— collection
-— command
-— command
-— entity
-— form
-— handler
-— input
-— input-filter
-— middleware
-— module
-— repository
-— service
-HELP);
+        Output::writeLine();
+        Output::writeLine(
+            (string) (new Message('Usage: '))
+                ->appendLine(
+                    ColorEnum::colorize('./vendor/bin/dot-maker', ColorEnum::ForegroundBrightWhite)
+                )
+                ->append(' ')
+                ->append(
+                    ColorEnum::colorize('<component>', ColorEnum::ForegroundBrightYellow)
+                )
+        );
+        Output::writeLine('OR');
+        Output::writeLine(
+            (string) (new Message())
+                ->append(
+                    ColorEnum::colorize('composer make', ColorEnum::ForegroundBrightWhite)
+                )
+                ->append(' ')
+                ->append(
+                    ColorEnum::colorize('<component>', ColorEnum::ForegroundBrightYellow)
+                )
+        );
+        Output::writeLine();
+        Output::writeLine(
+            (string) (new Message('Where '))
+                ->append(
+                    ColorEnum::colorize('<component>', ColorEnum::ForegroundBrightYellow)
+                )
+                ->append(' must be replaced with one of the following strings:')
+        );
+        Output::writeLine('— collection');
+        Output::writeLine('— command');
+        Output::writeLine('— entity');
+        Output::writeLine('— form');
+        Output::writeLine('— handler');
+        Output::writeLine('— input');
+        Output::writeLine('— input-filter');
+        Output::writeLine('— middleware');
+        Output::writeLine('— module');
+        Output::writeLine('— repository');
+        Output::writeLine('— service');
+        Output::writeLine('— service-interface');
     }
 }