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

orionis/console/commands/cache.py

@@ -4,7 +4,25 @@ from orionis.console.exceptions import CLIOrionisRuntimeError
 
 class CacheClearCommand(BaseCommand):
     """
-    Command class to display usage information for the Orionis CLI.
+    Command to clear Python bytecode cache files (.pyc) and __pycache__ directories in the Orionis application.
+
+    This command helps maintain a clean development environment by removing all Python cache artifacts
+    from the current working directory, preventing issues related to stale or invalid bytecode.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Whether to display timestamps in the command output.
+    signature : str
+        The CLI signature to invoke this command.
+    description : str
+        A brief summary of the command's functionality.
+
+    Methods
+    -------
+    handle() -> bool
+        Executes the cache clearing process using the `pyclean .` utility. Returns True if successful,
+        otherwise raises CLIOrionisRuntimeError on failure.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/help.py

@@ -6,7 +6,23 @@ from rich.panel import Panel
 
 class HelpCommand(BaseCommand):
     """
-    Command class to display usage information for the Orionis CLI.
+    Provides usage instructions and lists all available commands for the Orionis CLI.
+
+    This command displays a formatted help message including usage examples, a summary of all registered commands, and their descriptions. It is intended to guide users in understanding the available CLI functionality and command syntax.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        Command signature.
+    description : str
+        Command description.
+
+    Methods
+    -------
+    handle(reactor, console)
+        Displays usage information and a list of available commands.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/make_command.py

@@ -12,7 +12,19 @@ from orionis.foundation.contracts.application import IApplication
 
 class MakeCommand(BaseCommand):
     """
-    Command class to display usage information for the Orionis CLI.
+    Generates a new custom console command scaffold for the Orionis CLI.
+
+    This command automates the creation of a Python file for a new CLI command, using a template stub.
+    It ensures the generated command follows naming conventions and includes the specified signature.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        The command signature.
+    description : str
+        The command description.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/publisher.py

@@ -15,11 +15,11 @@ from orionis.metadata.framework import VERSION
 
 class PublisherCommand(BaseCommand):
     """
-    PublisherCommand is a console command for automating the process of publishing a Python package to the Orionis repository (PyPI).
+    Automates the process of testing, versioning, building, and publishing a Python package to the Orionis (PyPI) repository.
 
-    This command performs the following steps:
-        1. Runs the project's test suite and aborts if there are any test failures or errors.
-        2. Bumps the minor version number in the file where the VERSION constant is defined.
+    This command performs the following workflow:
+        1. Executes the project's test suite and aborts if any tests fail or error.
+        2. Increments the minor version number in the file where the VERSION constant is defined.
         3. Commits and pushes changes to the Git repository if there are modifications.
         4. Builds the package distributions (source and wheel) using `setup.py`.
         5. Publishes the built distributions to PyPI using Twine and a token from environment variables.
@@ -30,7 +30,7 @@ class PublisherCommand(BaseCommand):
     timestamps : bool
         Indicates whether timestamps will be shown in the command output.
     signature : str
-        Command signature ("publisher").
+        Command signature for invocation.
     description : str
         Command description.
 

orionis/console/commands/scheduler_list.py

@@ -9,13 +9,12 @@ from orionis.foundation.contracts.application import IApplication
 
 class ScheduleListCommand(BaseCommand):
     """
-    Command class to display a list of scheduled tasks defined in the Orionis application.
+    Displays a list of all scheduled jobs registered in the Orionis application.
 
-    Methods
-    -------
-    handle(app: IApplication, console: Console) -> bool
-        Lists all scheduled jobs configured in the application by retrieving them from the
-        ISchedule service and displaying them in a formatted table using the rich library.
+    This command retrieves scheduled tasks from the ISchedule service and presents them
+    in a formatted table using the rich library. It provides details such as signature,
+    arguments, purpose, random delay, start and end dates, and additional details for
+    each scheduled job.
 
     Attributes
     ----------
@@ -25,7 +24,6 @@ class ScheduleListCommand(BaseCommand):
         Command signature for invocation.
     description : str
         Description of the command.
-
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/scheduler_work.py

@@ -9,30 +9,28 @@ from orionis.services.introspection.instances.reflection import ReflectionInstan
 
 class ScheduleWorkCommand(BaseCommand):
     """
-    Executes the scheduled tasks defined in the application's scheduler.
+    Runs the application's scheduled tasks worker.
 
-    This command dynamically loads the scheduler module specified in the application's configuration,
-    retrieves the `Scheduler` class and its `tasks` method, registers the scheduled tasks with the
-    ISchedule service, and starts the scheduler worker. It provides user feedback via the console and
-    handles errors by raising CLIOrionisRuntimeError exceptions.
+    This command initializes and starts the scheduler worker, which executes all tasks registered in the application's scheduler. It ensures the scheduler is properly configured, registers event listeners if available, and provides feedback to the user via the console. Errors during initialization or execution are reported as CLIOrionisRuntimeError.
 
-    Parameters
+    Attributes
     ----------
-    orionis : IApplication
-        The application instance providing configuration and service resolution.
-    console : Console
-        The Rich console instance used for displaying output to the user.
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        Command signature for invocation.
+    description : str
+        Brief description of the command.
 
     Returns
     -------
     bool
-        Returns True if the scheduler worker starts successfully. If an error occurs during the process,
-        a CLIOrionisRuntimeError is raised.
+        True if the scheduler worker starts successfully.
 
     Raises
     ------
     CLIOrionisRuntimeError
-        If the scheduler module, class, or tasks method cannot be found, or if any unexpected error occurs.
+        If the scheduler is not properly defined or an unexpected error occurs.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/test.py

@@ -5,7 +5,7 @@ from orionis.test.contracts.kernel import ITestKernel
 
 class TestCommand(BaseCommand):
     """
-    Command class to display usage information for the Orionis CLI.
+    Command class to execute all automated tests using the configured test kernel for the Orionis application.
 
     Attributes
     ----------

orionis/console/commands/version.py

@@ -6,16 +6,19 @@ from orionis.metadata import framework
 
 class VersionCommand(BaseCommand):
     """
-    VersionCommand is a console command that displays the current version and metadata of the Orionis framework.
+    Displays the current version and metadata of the Orionis framework.
+
+    This command outputs the framework's version, author, Python requirements, documentation, and repository links
+    in a formatted panel for the user.
 
     Attributes
     ----------
     timestamps : bool
-        Indicates whether timestamps should be included (default: False).
+        Indicates whether timestamps will be shown in the command output.
     signature : str
-        The command signature used to invoke this command ("version").
+        Command signature used to invoke this command ("version").
     description : str
-        A brief description of what the command does.
+        Description of the command's purpose.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/console/commands/workflow.py

@@ -6,7 +6,19 @@ from rich.panel import Panel
 
 class WorkFlowGithubCommand(BaseCommand):
     """
-    Command class to display usage information for the Orionis CLI.
+    Runs the test suite and displays the results in the Orionis CLI workflow.
+
+    This command executes the project's test suite using the provided reactor. If any tests fail or errors occur,
+    it displays a summary panel and prevents further workflow actions by raising an exception.
+
+    Attributes
+    ----------
+    timestamps : bool
+        Indicates whether timestamps will be shown in the command output.
+    signature : str
+        Command signature for invocation.
+    description : str
+        Brief description of the command's purpose.
     """
 
     # Indicates whether timestamps will be shown in the command output

orionis/metadata/framework.py

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

orionis/test/records/logs.py

@@ -93,8 +93,7 @@ class TestLogs(ITestLogs):
                     database=str(self.__db_path),
                     timeout=5.0,
                     isolation_level=None,
-                    check_same_thread=False,
-                    autocommit=True
+                    check_same_thread=False
                 )
 
                 # Enable Write-Ahead Logging for better concurrency

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

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

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

@@ -8,15 +8,15 @@ orionis/console/base/command.py,sha256=tAO_EVy1aNWneNSKYYMAf9yDTfbvHAqSJnZZ6pOR4
 orionis/console/base/scheduler.py,sha256=IKNhpI_lPbI8H3YruD9z7eNdjuqNYceaclx_Hr5BHfY,8065
 orionis/console/base/scheduler_event_listener.py,sha256=X2mZBAYLBCtLOH7QSrCEaLeJ5m8Hq5UtGxaWRRvWbfo,4421
 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_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
-orionis/console/commands/test.py,sha256=-EmQwFwMBuby3OI9HwqMIwuJzd2CGbWbOqmwrR25sOE,2402
-orionis/console/commands/version.py,sha256=u2f7SetqEX__ufG6c37Ga-CylT4FGvy6wgld6RPBZGc,3589
-orionis/console/commands/workflow.py,sha256=NYOmjTSvm2o6AE4h9LSTZMFSYPQreNmEJtronyOxaYk,2451
+orionis/console/commands/cache.py,sha256=WU4VX4u1CoqHeY6ob2peCRzCKypRA7bpqUApo5_z1wU,3054
+orionis/console/commands/help.py,sha256=VFIn3UqQm4pxwjfSQohVwKNpc7F-6XRcwSZQwDSLEaU,3739
+orionis/console/commands/make_command.py,sha256=NEdCW43-W_W9h1G4i5zEglhEIdvt_GWUBZFIGOCbPrY,6238
+orionis/console/commands/publisher.py,sha256=xVFMVU4xrhmLK_ztou5UWJ2ONpzPc1fjjJufxnetej4,21371
+orionis/console/commands/scheduler_list.py,sha256=Wtjy73fpcjI6GGsJg6BHWVUXItzHbY1QLEhryXpCLcs,4770
+orionis/console/commands/scheduler_work.py,sha256=iPTgP7gOmTPr__TltYQWiqbDXbCP2njuO_2fCzwmMuc,5778
+orionis/console/commands/test.py,sha256=LXtl918TmYhg0sjBiCfbsvaXUmCLqwCXTazmy7AJhlE,2445
+orionis/console/commands/version.py,sha256=0EEFOzzUMzH7DOULKmkHkDLt4D8k938FIkkV3iBQ-t8,3694
+orionis/console/commands/workflow.py,sha256=uaesN9HotrgwuOYMCDeN_nzHr9CVZx4_sLTshISSbtU,2946
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/base_command.py,sha256=UlDN41Ts0ulxM-B2kgeKNr9_gNv_0LCth_pon1os-8U,7617
 orionis/console/contracts/base_scheduler.py,sha256=RSxEW57MoMU3pXfliIrQw9WuMk95p-xHXi1yACp1qsU,7728
@@ -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=c9JAamq8zVc7UugmpWAQ31X-LdFKRzq0Oied_NpUoqY,4089
+orionis/metadata/framework.py,sha256=8WuxcQ0_lA18cThdYtXEUKgdwqFxUU7csC25Dk3eV7M,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
@@ -385,7 +385,7 @@ orionis/test/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSu
 orionis/test/output/dumper.py,sha256=_FPetJq96fiWJhN29gMG8Rt6MEEgiyFHC5k95ACNtKY,5906
 orionis/test/output/printer.py,sha256=3nevE9nyhMn0n8UpE-Nwsy4d1l3GE0wnBf4fAGPQxf4,29623
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/records/logs.py,sha256=YeEaWVzgts8sPtz2_QadGHmgfKahE0OptpF6upu4zq0,22081
+orionis/test/records/logs.py,sha256=Dtu5HaWa2meblgTUXVAcOFaxkSJ3YxfDRaFoc_nhMCU,22043
 orionis/test/validators/__init__.py,sha256=mhzMkpLPTyI8GMXYevIibRf1PnRDvSJLLDwjGhnvxes,875
 orionis/test/validators/base_path.py,sha256=wAn5_HG0vQ5GH7wDKriO33Ijl1L1F3882BH67oraJnQ,1477
 orionis/test/validators/execution_mode.py,sha256=YnrQlnIaoPtM0xjW7jJ2170m1aHwAPPIZBjSVe9g2QM,1693
@@ -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.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-0.631.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.631.0.dist-info/METADATA,sha256=SmDnopPaeynF5MJ8HlS13MT7TDsPlqKbPcri_KAP_bQ,4772
+orionis-0.631.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.631.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.631.0.dist-info/RECORD,,