refactor(parser): delete doc-based command configuration parser

cleo/commands/command.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-import inspect
-import re
-
 from typing import TYPE_CHECKING
 from typing import Any
 from typing import ContextManager
@@ -13,7 +10,6 @@
 from cleo.io.inputs.string_input import StringInput
 from cleo.io.null_io import NullIO
 from cleo.io.outputs.output import Verbosity
-from cleo.parser import Parser
 from cleo.ui.table_separator import TableSeparator
 
 
@@ -47,40 +43,13 @@ def io(self) -> IO:
         return self._io
 
     def configure(self) -> None:
-        if not self.name:
-            doc = self.__doc__
-
-            if not doc:
-                for base in inspect.getmro(self.__class__):
-                    if base.__doc__ is not None:
-                        doc = base.__doc__
-                        break
-
-            if doc:
-                self._parse_doc(doc)
 
         for argument in self.arguments:
             self._definition.add_argument(argument)
 
         for option in self.options:
             self._definition.add_option(option)
 
-    def _parse_doc(self, doc: str) -> None:
-        lines = doc.strip().split("\n", 1)
-        if len(lines) > 1:
-            self.description = lines[0].strip()
-            signature = re.sub(r"\s{2,}", " ", lines[1].strip())
-            definition = Parser.parse(signature)
-            self.name = definition["name"]
-
-            for argument in definition["arguments"]:
-                self._definition.add_argument(argument)
-
-            for option in definition["options"]:
-                self._definition.add_option(option)
-        else:
-            self.description = lines[0].strip()
-
     def execute(self, io: IO) -> int:
         self._io = io
 

tests/commands/completion/fixtures/command_with_colons.py

@@ -1,12 +1,10 @@
 from __future__ import annotations
 
 from cleo.commands.command import Command
+from cleo.helpers import option
 
 
 class CommandWithColons(Command):
-    """
-    Test.
-
-    command:with:colons
-        { --goodbye }
-    """
+    name = "command:with:colons"
+    options = [option("goodbye", flag=False)]
+    description = "Test."

tests/commands/completion/fixtures/hello_command.py

@@ -1,13 +1,18 @@
 from __future__ import annotations
 
 from cleo.commands.command import Command
+from cleo.helpers import option
 
 
 class HelloCommand(Command):
-    """
-    Complete me please.
-
-    hello
-        { --dangerous-option= : This $hould be `escaped`. }
-        { --option-without-description }
-    """
+    name = "hello"
+    options = [
+        option(
+            "dangerous-option",
+            flag=False,
+            default=" ",
+            description="This $hould be `escaped`.",
+        ),
+        option("option-without-description", flag=False),
+    ]
+    description = "Complete me please."

tests/commands/test_command.py

@@ -9,12 +9,8 @@
 
 
 class MyCommand(Command):
-    """
-    Command testing.
-
-    test
-        {action : The action to execute.}
-    """
+    name = "test"
+    arguments = [argument("action", description="The action to execute.")]
 
     def handle(self) -> int:
         action = self.argument("action")

tests/fixtures/inherited_command.py

@@ -4,11 +4,8 @@
 
 
 class ParentCommand(Command):
-    """
-    Parent Command.
-
-    parent
-    """
+    name = "parent"
+    description = "Parent Command."
 
 
 class ChildCommand(ParentCommand):

tests/fixtures/signature_command.py

@@ -1,16 +1,22 @@
 from __future__ import annotations
 
 from cleo.commands.command import Command
+from cleo.helpers import argument
+from cleo.helpers import option
 
 
 class SignatureCommand(Command):
-    """
-    description
-
-    signature:command {foo : Foo} {bar? : Bar} {--z|baz : Baz} {--Z|bazz : Bazz}
-    """
-
+    name = "signature:command"
+    options = [
+        option("baz", "z", description="Baz"),
+        option("bazz", "Z", description="Bazz"),
+    ]
+    arguments = [
+        argument("foo", description="Foo"),
+        argument("bar", description="Bar", optional=True),
+    ]
     help = "help"
+    description = "description"
 
     def handle(self) -> int:
         self.line("handle called")