orionis 0.625.0__py3-none-any.whl → 0.627.0__py3-none-any.whl

orionis/console/commands/make_command.py

@@ -0,0 +1,130 @@
+from pathlib import Path
+import re
+from typing import List
+from orionis.console.args.argument import CLIArgument
+from orionis.console.base.command import BaseCommand
+from orionis.console.contracts.reactor import IReactor
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from rich.console import Console
+from rich.panel import Panel
+
+from orionis.foundation.contracts.application import IApplication
+
+class MakeCommand(BaseCommand):
+    """
+    Command class to display usage information for the Orionis CLI.
+    """
+
+    # Indicates whether timestamps will be shown in the command output
+    timestamps: bool = False
+
+    # Command signature and description
+    signature: str = "make:command"
+
+    # Command description
+    description: str = "Creates a new custom console command for the Orionis CLI."
+
+    async def options(self) -> List[CLIArgument]:
+        """
+        Defines the command-line options available for the `make:command` command.
+
+        This method specifies the arguments that can be passed to the command when it is invoked
+        from the CLI. It includes both required and optional arguments, each represented as a
+        `CLIArgument` instance.
+
+        Returns
+        -------
+        List[CLIArgument]
+            A list of `CLIArgument` objects representing the available command-line options.
+        """
+
+        return [
+            CLIArgument(
+                flags=["name"],
+                type=str,
+                required=True,
+                help="The filename where the new command will be created."
+            ),
+            CLIArgument(
+                flags=["--signature", "-s"],
+                type=str,
+                required=False,
+                help="The signature for the new command."
+            ),
+        ]
+
+    def handle(self, app: IApplication) -> dict:
+        """
+        Handles the creation of a new custom console command file.
+
+        This method processes the user-provided arguments, validates them, loads a command stub template,
+        replaces placeholders with the appropriate values, and writes the resulting code to a new file
+        in the commands directory. It also ensures that the file does not already exist and provides
+        feedback to the user regarding the operation's success or failure.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application instance used to resolve paths and interact with the application environment.
+
+        Returns
+        -------
+        dict
+            An empty dictionary. The method's primary purpose is side effects (file creation and user feedback).
+        """
+
+        try:
+
+            # Print a new line to separate output
+            self.newLine()
+
+            # Retrieve the 'name' argument (required) and 'signature' argument (optional, with default)
+            name: str = self.argument("name")
+            signature: str = self.argument("signature", "custom:command")
+
+            # Validate that the name argument is provided
+            if not name:
+                self.error("The 'name' argument is required.")
+
+            # Validate that the file name starts with a lowercase letter and contains only lowercase letters, numbers, or underscores
+            if not re.match(r'^[a-z][a-z0-9_]*$', name):
+                self.error("The 'name' argument must start with a lowercase letter and contain only lowercase letters, numbers, and underscores (_).")
+
+            # Validate the command signature: must start with a lowercase letter, can contain lowercase letters, numbers (not at the start), and the special characters ':' and '_'
+            if not re.match(r'^[a-z][a-z0-9_:]*$', signature):
+                self.error("The 'signature' argument must start with a lowercase letter and can only contain lowercase letters, numbers (not at the start), and the special characters ':' and '_'.")
+
+            # Load the command stub template from the stubs directory
+            stub_path = Path(__file__).parent.parent / "stubs" / "command.stub"
+            with open(stub_path, "r", encoding="utf-8") as file:
+                stub = file.read()
+
+            # Generate the class name by capitalizing each word and appending 'Command'
+            class_name = ''.join(word.capitalize() for word in name.split('_')) + "Command"
+            # Replace placeholders in the stub with the actual class name and signature
+            stub = stub.replace("{{class_name}}", class_name)
+            stub = stub.replace("{{signature}}", signature)
+
+            # Ensure the commands directory exists
+            commands_dir = app.path('console') / "commands"
+            commands_dir.mkdir(parents=True, exist_ok=True)
+            file_path = commands_dir / f"{name}.py"
+
+            # Check if the file already exists to prevent overwriting
+            if file_path.exists():
+                file_path = file_path.relative_to(app.path('root'))
+                self.error(f"The file [{file_path}] already exists. Please choose another name.")
+            else:
+                # Write the generated command code to the new file
+                with open(file_path, "w", encoding="utf-8") as file:
+                    file.write(stub)
+                file_path = file_path.relative_to(app.path('root'))
+                self.info(f"Console command [{file_path}] created successfully.")
+
+            # Print a new line to separate output
+            self.newLine()
+
+        except Exception as e:
+
+            # Catch any unexpected exceptions and raise a CLI-specific runtime error
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/console/core/reactor.py

@@ -288,7 +288,7 @@ class Reactor(IReactor):
         from orionis.console.commands.cache import CacheClearCommand
         from orionis.console.commands.scheduler_work import ScheduleWorkCommand
         from orionis.console.commands.scheduler_list import ScheduleListCommand
-        from orionis.console.commands.make_listener import MakeListenerCommand
+        from orionis.console.commands.make_command import MakeCommand
 
         # List of core command classes to load (extend this list as more core commands are added)
         core_commands = [
@@ -300,7 +300,7 @@ class Reactor(IReactor):
             CacheClearCommand,
             ScheduleWorkCommand,
             ScheduleListCommand,
-            MakeListenerCommand
+            MakeCommand
         ]
 
         # Iterate through the core command classes and register them

orionis/console/stubs/command.stub

@@ -0,0 +1,31 @@
+from orionis.console.base.command import BaseCommand
+from orionis.console.args.argument import CLIArgument
+from typing import List
+
+class {{class_name}}(BaseCommand):
+    """
+    [Command objective]
+    """
+
+    # Command signature
+    signature: str = "{{signature}}"
+
+    # Command description
+    description: str = "[Command description]"
+
+    def options(cls) -> List[CLIArgument]:
+        """
+        Define the command's arguments and options.
+        Returns a list of CLIArgument instances.
+        """
+        return []
+
+    async def handle(self) -> None:
+        """
+        Implement the command logic here.
+        You can access arguments using self.argument("name").
+        """
+        try:
+            pass
+        except Exception as e:
+            raise e

orionis/metadata/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.625.0"
+VERSION = "0.627.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

{orionis-0.625.0.dist-info → orionis-0.627.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.625.0
+Version: 0.627.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

{orionis-0.625.0.dist-info → orionis-0.627.0.dist-info}/RECORD

@@ -10,7 +10,7 @@ orionis/console/base/scheduler_event_listener.py,sha256=X2mZBAYLBCtLOH7QSrCEaLeJ
 orionis/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/commands/cache.py,sha256=d-J6Qu5Xpp9z0BU4OOb--gp9zWfUZOWm_LEBKIO8k-o,2321
 orionis/console/commands/help.py,sha256=0VQLw_8ghyMIbWH9L6S2I5umwa_rniK1lzDdX0qYS_U,3118
-orionis/console/commands/make_listener.py,sha256=vuXKOPIw_7MbiGwHGiDjLyd5-OqyBov1LKozsv2itEc,1801
+orionis/console/commands/make_command.py,sha256=4sjQ_z5jLCl-fEmkiwkM7vkSA964Xx9tijL7YcFkLck,5782
 orionis/console/commands/publisher.py,sha256=m-4RGDI3gc3-ED7Pl0rASLcoZP694q9jNKq0vRMM9uA,21380
 orionis/console/commands/scheduler_list.py,sha256=OU9qOjZNZRRElxwpg-E8nVefJToeiWu2E2l8P17NZtI,4759
 orionis/console/commands/scheduler_work.py,sha256=YYKqGLI5crJKuyVjCVwO1ZY_ZxlTWFr1eoz0bQUvyXU,5919
@@ -32,7 +32,7 @@ orionis/console/contracts/reactor.py,sha256=iT6ShoCutAWEeJzOf_PK7CGXi9TgrOD5tewH
 orionis/console/contracts/schedule.py,sha256=xtXgp4BPhvhg3YSM4mrIdbyoBdr4OJBi1gBM_kJN5UQ,13694
 orionis/console/contracts/schedule_event_listener.py,sha256=h06qsBxuEMD3KLSyu0JXdUDHlQW19BX9lA09Qrh2QXg,3818
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=6scyrKukt6BEcLBxIrfAKA8QYnvNTl2dXePw6IWGPUw,43831
+orionis/console/core/reactor.py,sha256=pnjL2MdqNLhhlfpVYC9tCGWO4ZjlrIS4ixNGk9PY7DU,43814
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/debug.py,sha256=p8uflSXeDJDrVM9mZY4JMYEus73Z6TsLnQQtgP0QUak,22427
 orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -61,8 +61,8 @@ orionis/console/output/console.py,sha256=EtSDWRBW8wk0iJdPfB1mzU49krLJBaSAUdVdVOz
 orionis/console/output/executor.py,sha256=uQjFPOlyZLFj9pcyYPugCqxwJog0AJgK1OcmQH2ELbw,7314
 orionis/console/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/request/cli_request.py,sha256=lO7088xlVK1VP-NhCIgAo7qXGzCW3nXVOJag43fUv20,13207
-orionis/console/stub/command.stub,sha256=IfQ0bTrpataVFcT1ZdHyyiYNZ67D5Aox_QvgVJLeJnI,1240
-orionis/console/stub/listener.stub,sha256=DbX-ghx2-vb73kzQ6L20lyg5vSKn58jSLTwFuwNQU9k,4331
+orionis/console/stubs/command.stub,sha256=ABQ2eFxJ0u0DvTfmoO_DdECkBy-rie-woG62G2Gxw8Y,805
+orionis/console/stubs/listener.stub,sha256=DbX-ghx2-vb73kzQ6L20lyg5vSKn58jSLTwFuwNQU9k,4331
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/schedule.py,sha256=ZeeuQ9Tbu5KNowKC5oIk7yWeJXzlDQiQ278mWEgoCXc,87989
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -216,7 +216,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=IUzbmVQgudOKc9b_rqMAxApxsx57n8g2ZIwHE4IR4nQ,4089
+orionis/metadata/framework.py,sha256=c9JAamq8zVc7UugmpWAQ31X-LdFKRzq0Oied_NpUoqY,4089
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -403,8 +403,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.625.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.625.0.dist-info/METADATA,sha256=q1ztZyJ9RrzH5jtITrEtKrpmpRmTOdI5iSgkK0qOau8,4772
-orionis-0.625.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.625.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.625.0.dist-info/RECORD,,
+orionis-0.627.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.627.0.dist-info/METADATA,sha256=PrIbWXNzer85VG0nm79qdQSPwfnhOuIS2MVspWEUhrM,4772
+orionis-0.627.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.627.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.627.0.dist-info/RECORD,,

orionis/console/commands/make_listener.py

@@ -1,54 +0,0 @@
-from orionis.console.base.command import BaseCommand
-from orionis.console.exceptions import CLIOrionisRuntimeError
-
-class MakeListenerCommand(BaseCommand):
-    """
-    Este comando se encarga de crear los listener tando para CLI como para otro tipo de Eventos.
-    """
-
-    # Indicates whether timestamps will be shown in the command output
-    timestamps: bool = False
-
-    # Command signature and description
-    signature: str = "make:listener"
-
-    # Command description
-    description: str = "Displays usage information, examples, and a list of available commands in the Orionis CLI."
-
-    def handle(self) -> dict:
-        """
-        Displays usage information and a list of available commands for the Orionis CLI.
-
-        Parameters
-        ----------
-        reactor : IReactor
-            The reactor instance providing command metadata via the `info()` method.
-
-        Returns
-        -------
-        dict
-            A dictionary containing the list of available commands, each with its signature and description.
-
-        Raises
-        ------
-        CLIOrionisRuntimeError
-            If an unexpected error occurs during help information generation or display.
-        """
-        try:
-
-            # Solicitar el nombre del listener al usuario
-            ans = self.choice(
-                question="Tipo de Listener",
-                choices=[
-                    "Listener para eventos CLI",
-                    "Listener para eventos de Schedule",
-                ],
-                default_index=0
-            )
-
-            print(ans)
-
-        except Exception as e:
-
-            # Raise a custom runtime error if any exception occurs
-            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/console/stub/command.stub

@@ -1,42 +0,0 @@
-from orionis.console.base.command import BaseCommand
-from orionis.console.args.argument import CLIArgument
-from orionis.console.exceptions import CLIOrionisRuntimeError
-
-class {{class_name}}(BaseCommand):
-    """
-    Command: {{signature}}
-    {{description}}
-    """
-
-    # Enable timestamps
-    timestamps: bool = True
-
-    # Command signature
-    signature: str = "{{signature}}"
-
-    # Command description
-    description: str = "{{description}}"
-
-    # Arguments (edit as needed)
-    arguments = [
-        CLIArgument(
-            flags=["--example", "-e"],
-            type=str,
-            help="Example argument for {{class_name}}",
-            default=None,
-            required=False,
-            metavar="EXAMPLE",
-            dest="example",
-            action="store",
-        ),
-    ]
-
-    async def handle(self, *args, **kwargs) -> None:
-        try:
-            self.textSuccessBold("{{class_name}} executed successfully!")
-            example_value = self.argument("example")
-            if example_value:
-                self.info(f"Received argument: {example_value}")
-
-        except Exception as e:
-            raise CLIOrionisRuntimeError(f"An error occurred: {str(e)}") from e