orionis 0.729.0__tar.gz → 0.731.0__tar.gz

{orionis-0.729.0/orionis.egg-info → orionis-0.731.0}/PKG-INFO

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

{orionis-0.729.0 → orionis-0.731.0}/orionis/console/commands/make_command.py

@@ -106,7 +106,11 @@ class MakeCommand(BaseCommand):
                 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"
+            class_name = ''.join(word.capitalize() for word in name.split('_'))
+            if not class_name.endswith("Command"):
+                class_name = class_name.rstrip("_") + "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)
@@ -114,6 +118,12 @@ class MakeCommand(BaseCommand):
             # Ensure the commands directory exists
             commands_dir = app.path('console') / "commands"
             commands_dir.mkdir(parents=True, exist_ok=True)
+
+            # Ensure the name ends with 'command' (case-insensitive)
+            if not name.lower().endswith("command"):
+                name = name.rstrip("_") + "_command"
+
+            # Define the full path for the new command file
             file_path = commands_dir / f"{name}.py"
 
             # Check if the file already exists to prevent overwriting

orionis-0.731.0/orionis/console/commands/make_scheduler_listener.py

@@ -0,0 +1,131 @@
+import re
+from pathlib import Path
+from typing import List
+from orionis.console.args.argument import CLIArgument
+from orionis.console.base.command import BaseCommand
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.foundation.contracts.application import IApplication
+
+class MakeSchedulerListenerCommand(BaseCommand):
+    """
+    Command to create a new custom scheduler listener for scheduled task events.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        Command signature.
+    description : str
+        Command description.
+
+    Methods
+    -------
+    options() -> List[CLIArgument]
+        Returns the CLI arguments required for this command.
+    handle(app: IApplication) -> dict
+        Handles the creation of the scheduler listener file.
+    """
+
+    # Indicates whether timestamps will be shown in the command output
+    timestamps: bool = False
+
+    # Command signature and description
+    signature: str = "make:scheduler-listener"
+
+    # Command description
+    description: str = (
+        "Creates a new custom scheduler listener to handle events for a scheduled task."
+    )
+
+    async def options(self) -> List[CLIArgument]:
+        """
+        Returns the CLI arguments required for this command.
+
+        Returns
+        -------
+        List[CLIArgument]
+            A list containing the required CLIArgument for the listener name.
+        """
+
+        # Define the required CLI argument for the listener name
+        return [
+            CLIArgument(
+                flags=["name"],
+                type=str,
+                required=True,
+                help="The filename where the new command will be created."
+            )
+        ]
+
+    def handle(self, app: IApplication) -> dict:
+        """
+        Handles the creation of the scheduler listener file.
+
+        This method validates the listener name, loads the stub template,
+        generates the listener class, ensures the listeners directory exists,
+        and writes the new listener file. If the file already exists, it
+        prevents overwriting and displays an error.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application instance used to resolve paths.
+
+        Returns
+        -------
+        dict
+            An empty dictionary. All output is handled via CLI messaging.
+        """
+
+        try:
+
+            # Retrieve the 'name' argument (required)
+            listener_name: str = self.argument("name")
+
+            # Validate that the listener_name argument is provided
+            if not listener_name:
+                self.error("The 'name' argument is required.")
+
+            # Validate that the listener name starts with a lowercase letter and contains only lowercase letters, numbers, or underscores
+            if not re.match(r'^[a-z][a-z0-9_]*$', listener_name):
+                self.error("The 'name' argument must start with a lowercase letter and contain only lowercase letters, numbers, and underscores (_).")
+
+            # Load the listener stub template from the stubs directory
+            stub_path = Path(__file__).parent.parent / "stubs" / "listener.stub"
+            with open(stub_path, "r", encoding="utf-8") as file:
+                stub_content = file.read()
+
+            # Generate the class name by capitalizing each word and appending 'Listener'
+            class_name = ''.join(word.capitalize() for word in listener_name.split('_'))
+            if not class_name.endswith("Listener"):
+                class_name = class_name.rstrip("_") + "Listener"
+
+            # Replace placeholders in the stub with the actual class name
+            stub_content = stub_content.replace("{{class_name}}", class_name)
+
+            # Ensure the listeners directory exists
+            listeners_dir = app.path('console') / "listeners"
+            listeners_dir.mkdir(parents=True, exist_ok=True)
+
+            # Ensure the listener_name ends with 'listener' (case-insensitive)
+            if not listener_name.lower().endswith("listener"):
+                listener_name = listener_name.rstrip("_") + "_listener"
+
+            file_path = listeners_dir / f"{listener_name}.py"
+
+            # Check if the file already exists to prevent overwriting
+            if file_path.exists():
+                relative_path = file_path.relative_to(app.path('root'))
+                self.error(f"The file [{relative_path}] already exists. Please choose a different name.")
+            else:
+                # Write the generated listener code to the new file
+                with open(file_path, "w", encoding="utf-8") as file:
+                    file.write(stub_content)
+                relative_path = file_path.relative_to(app.path('root'))
+                self.info(f"Listener [{relative_path}] was created successfully.")
+
+        except Exception as exc:
+
+            # Catch any unexpected exceptions and raise a CLI-specific runtime error
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {exc}") from exc

{orionis-0.729.0 → orionis-0.731.0}/orionis/console/core/reactor.py

@@ -288,6 +288,7 @@ class Reactor(IReactor):
         from orionis.console.commands.scheduler_work import ScheduleWorkCommand
         from orionis.console.commands.test import TestCommand
         from orionis.console.commands.version import VersionCommand
+        from orionis.console.commands.make_scheduler_listener import MakeSchedulerListenerCommand
 
         # List of core command classes to load (extend this list as more core commands are added)
         core_commands = [
@@ -298,7 +299,8 @@ class Reactor(IReactor):
             ScheduleListCommand,
             ScheduleWorkCommand,
             TestCommand,
-            VersionCommand
+            VersionCommand,
+            MakeSchedulerListenerCommand
         ]
 
         # Iterate through the core command classes and register them

{orionis-0.729.0 → orionis-0.731.0}/orionis/console/stubs/command.stub

@@ -10,7 +10,7 @@ class {{class_name}}(BaseCommand):
     # Command description
     description: str = "[Command description]"
 
-    def options(cls) -> List[CLIArgument]:
+    def options(self) -> List[CLIArgument]:
         """
         Define the command's arguments and options.
         Returns a list of CLIArgument instances.

{orionis-0.729.0 → orionis-0.731.0}/orionis/console/stubs/listener.stub

@@ -2,7 +2,7 @@ from orionis.console.base.scheduler_event_listener import BaseScheduleEventListe
 from orionis.console.contracts.schedule import ISchedule
 from orionis.console.entities.event_job import EventJob
 
-class InspireListener(BaseScheduleEventListener):
+class {{class_name}}(BaseScheduleEventListener):
 
     async def before(self, event: EventJob, schedule: ISchedule):
         """
@@ -20,7 +20,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().before(event, schedule)
+        pass
 
     async def after(self, event: EventJob, schedule: ISchedule):
         """
@@ -38,7 +38,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().after(event, schedule)
+        pass
 
     async def onFailure(self, event: EventJob, schedule: ISchedule):
         """
@@ -56,7 +56,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onFailure(event, schedule)
+        pass
 
     async def onMissed(self, event: EventJob, schedule: ISchedule):
         """
@@ -74,7 +74,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onMissed(event, schedule)
+        pass
 
     async def onMaxInstances(self, event: EventJob, schedule: ISchedule):
         """
@@ -92,7 +92,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onMaxInstances(event, schedule)
+        pass
 
     async def onPaused(self, event: EventJob, schedule: ISchedule):
         """
@@ -110,7 +110,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onPaused(event, schedule)
+        pass
 
     async def onResumed(self, event: EventJob, schedule: ISchedule):
         """
@@ -128,7 +128,7 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onResumed(event, schedule)
+        pass
 
     async def onRemoved(self, event: EventJob, schedule: ISchedule):
         """
@@ -146,4 +146,4 @@ class InspireListener(BaseScheduleEventListener):
         None
             This method does not return any value.
         """
-        await super().onRemoved(event, schedule)
+        pass

{orionis-0.729.0 → orionis-0.731.0}/orionis/metadata/framework.py

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

{orionis-0.729.0 → orionis-0.731.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.729.0 → orionis-0.731.0}/orionis.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ orionis/console/commands/__publisher__.py
 orionis/console/commands/cache_clear.py
 orionis/console/commands/help.py
 orionis/console/commands/make_command.py
+orionis/console/commands/make_scheduler_listener.py
 orionis/console/commands/scheduler_list.py
 orionis/console/commands/scheduler_work.py
 orionis/console/commands/test.py