orionis 0.195.0__py3-none-any.whl → 0.197.0__py3-none-any.whl

orionis/framework.py

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

orionis/installer/manager.py

@@ -1,6 +1,7 @@
 import subprocess
 import sys
 from orionis.installer.contracts.manager import IInstallerManager
+from orionis.installer.contracts.output import IInstallerOutput
 from orionis.installer.output import InstallerOutput
 from orionis.installer.setup import InstallerSetup
 
@@ -13,20 +14,15 @@ class InstallerManager(IInstallerManager):
 
     Attributes
     ----------
-    output : InstallerOutput
-        Instance of Output to manage command-line display messages.
+    _output : InstallerOutput
+        Instance of InstallerOutput to manage command-line display messages.
     """
 
     def __init__(self):
         """
         Initialize the Management class with an output handler.
-
-        Parameters
-        ----------
-        output : Output
-            An instance of Output to handle command-line messages.
         """
-        self._output = InstallerOutput()
+        self._output : IInstallerOutput = InstallerOutput()
 
     def handleVersion(self) -> str:
         """
@@ -45,7 +41,7 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs during the upgrade process.
         """
         try:
@@ -55,7 +51,6 @@ class InstallerManager(IInstallerManager):
         except Exception as e:
             raise RuntimeError(f"Upgrade failed: {e}")
 
-
     def handleNewApp(self, name_app: str = "example-app") -> None:
         """
         Create a new application with the specified name.
@@ -67,7 +62,7 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs during the application setup.
         """
         try:
@@ -81,10 +76,10 @@ class InstallerManager(IInstallerManager):
 
         Raises
         ------
-        Exception
+        RuntimeError
             If an error occurs while displaying information.
         """
         try:
-            self._output.asciiInfo()
+            self._output.printHelp()
         except Exception as e:
-            raise RuntimeError(f"Failed to display information: {e}")
+            raise RuntimeError(f"Failed to display information: {e}")

orionis/installer/setup.py

@@ -1,10 +1,10 @@
-import re
 import os
-import sys
+import re
 import shutil
 import subprocess
+import sys
 from unicodedata import normalize
-from orionis.framework import SKELETON, DOCS
+from orionis.framework import DOCS, SKELETON
 from orionis.installer.contracts.output import IInstallerOutput
 from orionis.installer.contracts.setup import IInstallerSetup
 from orionis.luminate.console.output.console import Console

orionis/luminate/console/base/command.py

@@ -16,7 +16,7 @@ class BaseCommand(IBaseCommand):
     """
     args = {}
 
-    def success(self, message: str = '', timestamp: bool = True):
+    def success(self, message: str, timestamp: bool = True):
         """
         Prints a success message with a green background.
 
@@ -29,7 +29,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.success(message, timestamp)
 
-    def textSuccess(self, message: str = ''):
+    def textSuccess(self, message: str):
         """
         Prints a success message in green.
 
@@ -40,7 +40,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textSuccess(message)
 
-    def textSuccessBold(self, message: str = ''):
+    def textSuccessBold(self, message: str):
         """
         Prints a bold success message in green.
 
@@ -51,7 +51,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textSuccessBold(message)
 
-    def info(self, message: str = '', timestamp: bool = True):
+    def info(self, message: str, timestamp: bool = True):
         """
         Prints an informational message with a blue background.
 
@@ -64,7 +64,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.info(message, timestamp)
 
-    def textInfo(self, message: str = ''):
+    def textInfo(self, message: str):
         """
         Prints an informational message in blue.
 
@@ -75,7 +75,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textInfo(message)
 
-    def textInfoBold(self, message: str = ''):
+    def textInfoBold(self, message: str):
         """
         Prints a bold informational message in blue.
 
@@ -86,7 +86,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textInfoBold(message)
 
-    def warning(self, message: str = '', timestamp: bool = True):
+    def warning(self, message: str, timestamp: bool = True):
         """
         Prints a warning message with a yellow background.
 
@@ -99,7 +99,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.warning(message, timestamp)
 
-    def textWarning(self, message: str = ''):
+    def textWarning(self, message: str):
         """
         Prints a warning message in yellow.
 
@@ -110,7 +110,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textWarning(message)
 
-    def textWarningBold(self, message: str = ''):
+    def textWarningBold(self, message: str):
         """
         Prints a bold warning message in yellow.
 
@@ -121,7 +121,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textWarningBold(message)
 
-    def fail(self, message: str = '', timestamp: bool = True):
+    def fail(self, message: str, timestamp: bool = True):
         """
         Prints a failure message with a red background.
 
@@ -134,7 +134,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.fail(message, timestamp)
 
-    def error(self, message: str = '', timestamp: bool = True):
+    def error(self, message: str, timestamp: bool = True):
         """
         Prints an error message with a red background.
 
@@ -147,7 +147,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.error(message, timestamp)
 
-    def textError(self, message: str = ''):
+    def textError(self, message: str):
         """
         Prints an error message in red.
 
@@ -158,7 +158,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textError(message)
 
-    def textErrorBold(self, message: str = ''):
+    def textErrorBold(self, message: str):
         """
         Prints a bold error message in red.
 
@@ -169,7 +169,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textErrorBold(message)
 
-    def textMuted(self, message: str = ''):
+    def textMuted(self, message: str):
         """
         Prints a muted (gray) message.
 
@@ -180,7 +180,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textMuted(message)
 
-    def textMutedBold(self, message: str = ''):
+    def textMutedBold(self, message: str):
         """
         Prints a bold muted (gray) message.
 
@@ -191,7 +191,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.textMutedBold(message)
 
-    def textUnderline(self, message: str = ''):
+    def textUnderline(self, message: str):
         """
         Prints an underlined message.
 
@@ -214,7 +214,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.clearLine()
 
-    def line(self, message: str = ''):
+    def line(self, message: str):
         """
         Prints a line of text.
 
@@ -236,7 +236,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.newLine(count)
 
-    def write(self, message: str = ''):
+    def write(self, message: str):
         """
         Prints a message without moving to the next line.
 
@@ -247,7 +247,7 @@ class BaseCommand(IBaseCommand):
         """
         Console.write(message)
 
-    def writeLine(self, message: str = ''):
+    def writeLine(self, message: str):
         """
         Prints a message and moves to the next line.
 

orionis/luminate/console/commands/help.py

@@ -1,6 +1,7 @@
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 from orionis.luminate.contracts.application import IApplication
+from orionis.framework import NAME
 
 class HelpCommand(BaseCommand):
     """
@@ -35,7 +36,7 @@ class HelpCommand(BaseCommand):
 
             # Display the available commands
             self.newLine()
-            self.textSuccessBold(" (CLI Interpreter) Available Commands: ")
+            self.textSuccessBold(f" ({str(NAME).upper()} CLI Interpreter) Available Commands: ")
 
             # Initialize an empty list to store the rows.
             rows = []

orionis/luminate/console/output/console.py

@@ -442,8 +442,8 @@ class Console(IConsole):
         """
 
         errors = ExceptionsToDict.parse(e)
-        error_type = errors.get("error_type").split(".")[-1]
-        error_message = errors.get("error_message").replace(error_type, "").replace("[]", "").strip()
+        error_type = str(errors.get("error_type")).split(".")[-1]
+        error_message = str(errors.get("error_message")).replace(error_type, "").replace("[]", "").strip()
         stack_trace = errors.get("stack_trace")
 
         # Format the output with a more eye-catching appearance

orionis/luminate/contracts/facades/facade.py

@@ -2,20 +2,36 @@ from orionis.luminate.container.container import Container
 from orionis.luminate.support.asyn_run import AsyncExecutor
 
 class FacadeMeta(type):
-    def __getattr__(cls, name):
+    """
+    Metaclass for Facade pattern. It intercepts attribute access to dynamically resolve and delegate calls
+    to the underlying service. This is where the magic happens, folks!
+    """
+    def __getattr__(cls, name: str):
+        """
+        When an undefined attribute is accessed, this method resolves the service and delegates the call.
+        It's like having a genie in a bottle, but for services.
+        """
         service = cls.resolve()
         return getattr(service, name)
 
-
-# Clase base para las fachadas usando la metaclase
 class Facade(metaclass=FacadeMeta):
-
-    _container = Container()
+    """
+    Base Facade class. It provides a clean and simple interface to interact with complex services.
+    Think of it as the friendly face of a very complicated machine.
+    """
 
     @classmethod
     def getFacadeAccessor(cls):
-        raise NotImplementedError("Debes definir el nombre del servicio")
+        """
+        This method must be overridden by subclasses to return the name of the service to be resolved.
+        If not, it throws a tantrum (NotImplementedError).
+        """
+        raise NotImplementedError("You must define the service name")
 
     @classmethod
     def resolve(cls):
-        return AsyncExecutor.run(cls._container.make(cls.getFacadeAccessor()))
+        """
+        Resolves the service by using the AsyncExecutor to make it from the Container.
+        It's like calling the butler to fetch something from the pantry.
+        """
+        return AsyncExecutor.run(Container().make(cls.getFacadeAccessor()))

orionis/luminate/facades/log/log_facade.py

@@ -2,7 +2,15 @@ from orionis.luminate.contracts.facades.facade import Facade
 from orionis.luminate.contracts.services.log.log_service import ILogguerService
 
 class Log(Facade):
+    """
+    Log Facade class. This is the friendly interface for interacting with the logging service.
+    It's like the concierge of your application's logging system—always ready to help!
+    """
 
     @classmethod
     def getFacadeAccessor(cls):
+        """
+        Returns the service accessor for the logging system. In this case, it's the `ILogguerService`.
+        This is where the magic of the Facade pattern comes alive—connecting the interface to the actual service.
+        """
         return ILogguerService

{orionis-0.195.0.dist-info → orionis-0.197.0.dist-info}/METADATA

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

{orionis-0.195.0.dist-info → orionis-0.197.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=bCLZJxPci2g-4X3TFzsf_MXKlVuK3CxEoxEi9kBQg3c,1469
+orionis/framework.py,sha256=qRf3MBqE0BJyfxQWiCeS5RknzvE007hmit6b1ki-WsU,1469
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/installer/manager.py,sha256=SYP-k_3c2oxFOCCWfMz-wnekWivn3VcFVMUU5e_sJYo,2787
+orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
-orionis/installer/setup.py,sha256=xP9y84S4OuEp8wrsZInQz3pS8nenIEPQU2sYUrKyJNg,7383
+orionis/installer/setup.py,sha256=w5YBWN_wE_sLQ7cUSXomUgPH5lp5tfqnEfa1MUcFEok,7383
 orionis/installer/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/contracts/manager.py,sha256=Zfndhuyu0JaTKo3PsGsKmVsvotQMw8Pmt4KQp97elY8,1567
 orionis/installer/contracts/output.py,sha256=t1KLw610-hHy63UbFFE2BYwWHWRbW8_ofuEvRLx_IUE,983
@@ -27,17 +27,17 @@ orionis/luminate/console/command_filter.py,sha256=fmqjQZFwhsEMKWuTtt4dIQF-souVSJ
 orionis/luminate/console/kernel.py,sha256=knzOpbsHJJpAbCSrnFXgRHK9Uk4OisEW_jiylaR-PLA,891
 orionis/luminate/console/parser.py,sha256=jQPDYHvGt-h2qnmDUObaxF9CmuX9YK_8XTYnQwKCSXE,5586
 orionis/luminate/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/base/command.py,sha256=K-Jv3OTVenyrpTI2Jov-WQ435CA4tgqMy6sztxYKDFA,12674
+orionis/luminate/console/base/command.py,sha256=Z5Pk2VhZEv7_0dP4f9Ay4DLX6DV4N78nraX4ty0pQ5g,12579
 orionis/luminate/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/commands/cache_clear.py,sha256=UV2VFFK-LsUNDrqKb_Q8HWnwlwvIuTWTsbQ5x5rWHGk,2859
-orionis/luminate/console/commands/help.py,sha256=3Sc_nXCA9RFiFvvVUkUjVu3CSLit1JSflt2akP7xtN4,2224
+orionis/luminate/console/commands/help.py,sha256=ifo_5KfwI5mokWIvIAqjys2zSGSbudVACITlsSdbOVU,2281
 orionis/luminate/console/commands/schedule_work.py,sha256=eYF94qgNjjAGLoN4JWA0e0zeNWc3fptj2NY2O7KGGGU,2174
 orionis/luminate/console/commands/tests.py,sha256=Z7e6aM5Vu8C7R8iC8sJgUYVN9aJgtVMkqjUEFxPq91o,1281
 orionis/luminate/console/commands/version.py,sha256=llVPK6ELtf8dIdPvLbybrtipWwZkzV0EXc9ShL-C-GY,1140
 orionis/luminate/console/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/exceptions/cli_exception.py,sha256=T5rFjBEXWQf3RbpMb7KDoYayylm5DLPUPLC5OzkZ2-I,4623
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=URqrEHhsgWk2gOb4G13rCri40uMsihDlSbusYj43NVg,16345
+orionis/luminate/console/output/console.py,sha256=U4Hh1yf6ss9i1uzmMZ3kbOwxyBn4uBr9aem7bnpmB0E,16355
 orionis/luminate/console/output/executor.py,sha256=91722rNiAsKpuq5QYiI7Aqw_7ccmn0DS9KYQrZt0TOs,3369
 orionis/luminate/console/output/progress_bar.py,sha256=ZiPGcUaN3EINeLRKgLGtS1GAb1XWlCDx7wFQ7Ff0hqY,3096
 orionis/luminate/console/output/styles.py,sha256=2e1_FJdNpKaVqmdlCx-udzTleH_6uEFE9_TjH7T1ZUk,3696
@@ -65,7 +65,7 @@ orionis/luminate/contracts/console/output/progress_bar.py,sha256=sOkQzQsliFemqZH
 orionis/luminate/contracts/container/container.py,sha256=rLOS1eYir1e1e06OVNTGESbR24rFOIU1CVni_8AbHgs,8802
 orionis/luminate/contracts/container/container_integrity.py,sha256=xigWcyxLUaFoWXEI75ucJ50Ypw2NtOiRp_CgOY3Qk20,4408
 orionis/luminate/contracts/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/contracts/facades/facade.py,sha256=iDFlEQCIb6-G6bY3a7aIUt5wksHI6b_QwOGLgmcLRUE,627
+orionis/luminate/contracts/facades/facade.py,sha256=YZBF7KpkQ16sOxT-slwWkWMJ13LPCtdPzWuruFntCY0,1500
 orionis/luminate/contracts/facades/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/facades/commands/commands_facade.py,sha256=LpSfZb3lTmhgMx0H42NmFbKLvcOqSDIbpQrkQpF9RPY,1274
 orionis/luminate/contracts/facades/commands/scheduler_facade.py,sha256=CR2E7WbYGt8ZMpekUzWBHCor3FEnBmYMDwPfKSYPq84,947
@@ -118,7 +118,7 @@ orionis/luminate/facades/environment/environment_facade.py,sha256=byjVQWCQuqjgc2
 orionis/luminate/facades/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/facades/files/path_facade.py,sha256=z6DLW7IiBc6nonEwcIbylgpbrM9hgVzZ2Cptdxjr93I,9219
 orionis/luminate/facades/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/log/log_facade.py,sha256=u13p3r8Upq2-VNYM73icoVuxn-xpNdVz-Z7Ejoh_cSM,248
+orionis/luminate/facades/log/log_facade.py,sha256=8WTLtCvfSdF9ve3lrc3GV0hXxNtolah8WJWfkMUQ_JI,699
 orionis/luminate/facades/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/facades/tests/tests_facade.py,sha256=hvNMU8idxxfvz4x-1_jeloff2Gee0k61VfUhxDrR6eg,1667
 orionis/luminate/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -181,9 +181,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=bhLQ7VGVod4B8sv-rW9AjnOumvaBVsoxieA3sdoM2yM,5244
-orionis-0.195.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.195.0.dist-info/METADATA,sha256=A4tOJYnNbnx50lHim1VhK5FIWIpaKaJKRJeMoJ_BKzM,3003
-orionis-0.195.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.195.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.195.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.195.0.dist-info/RECORD,,
+orionis-0.197.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.197.0.dist-info/METADATA,sha256=SiKzS2G5mQZoaRMQ0ByvKZ4DRcVmvBMrE15rBcmg1HQ,3003
+orionis-0.197.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.197.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.197.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.197.0.dist-info/RECORD,,