orionis 0.43.0__py3-none-any.whl → 0.46.0__py3-none-any.whl

orionis/contracts/installer/i_installer_output.py

@@ -0,0 +1,101 @@
+from abc import ABC, abstractmethod
+
+class IInstallerOutput(ABC):
+    """
+    Interface for the InstallerOutput class.
+    """
+
+    @abstractmethod
+    def _print(label: str, message: str, color_code: str):
+        """
+        Prints messages to the console with specific formatting and colors.
+
+        Parameters
+        ----------
+        label : str
+            The label for the message (e.g., INFO, FAIL, ERROR).
+        message : str
+            The message to display.
+        color_code : str
+            ANSI color code for the background of the message.
+        """
+        pass
+
+    @abstractmethod
+    def asciiIco():
+        """
+        Displays a welcome message to the framework, including ASCII art.
+
+        Attempts to load an ASCII art file (art.ascii). If not found, defaults to displaying basic information.
+
+        If the ASCII art file is found, placeholders are replaced with dynamic content such as version, docs, and year.
+        """
+        pass
+
+    @abstractmethod
+    def asciiInfo():
+        """
+        Displays another type of welcome message to the framework, including different ASCII art.
+
+        Attempts to load an ASCII art file (info.ascii). If not found, defaults to displaying basic information.
+
+        Similar to `asciiIco()`, but with different ASCII art.
+        """
+        pass
+
+    @abstractmethod
+    def startInstallation():
+        """
+        Displays the starting message when the installation begins.
+        This includes a welcoming message and the ASCII art.
+        """
+        pass
+
+    @abstractmethod
+    def endInstallation():
+        """
+        Displays the ending message after the installation is complete.
+        Provides a message of encouragement to start using the framework.
+        """
+        pass
+
+    @abstractmethod
+    def info(message: str = ''):
+        """
+        Displays an informational message to the console.
+
+        Parameters
+        ----------
+        message : str, optional
+            The message to display. Defaults to an empty string.
+        """
+        pass
+
+    @abstractmethod
+    def fail(message: str = ''):
+        """
+        Displays a failure message to the console.
+
+        Parameters
+        ----------
+        message : str, optional
+            The message to display. Defaults to an empty string.
+        """
+        pass
+
+    @abstractmethod
+    def error(message: str = '', e = None):
+        """
+        Displays an error message to the console and terminates the program.
+
+        Parameters
+        ----------
+        message : str, optional
+            The message to display. Defaults to an empty string.
+
+        Raises
+        ------
+        SystemExit
+            Terminates the program with a non-zero exit code, indicating an error occurred.
+        """
+        pass

orionis/contracts/installer/i_installer_setup.py

@@ -0,0 +1,59 @@
+from abc import ABC, abstractmethod
+
+class InstallerSetup(ABC):
+    """
+    Interface for the InstallerSetup class.
+    """
+
+    @abstractmethod
+    def _sanitize_folder_name(self, name: str) -> str:
+        """
+        Sanitize the provided folder name to ensure it is valid across different operating systems.
+
+        Steps:
+        1. Normalize text to remove accents and special characters.
+        2. Convert to lowercase.
+        3. Replace spaces with underscores.
+        4. Remove invalid characters.
+        5. Strip leading and trailing whitespace.
+        6. Enforce length limit (255 characters).
+        7. Ensure the result contains only valid characters.
+
+        Parameters
+        ----------
+        name : str
+            The original folder name to sanitize.
+
+        Returns
+        -------
+        str
+            The sanitized folder name.
+
+        Raises
+        ------
+        ValueError
+            If the sanitized folder name is empty or contains invalid characters.
+        """
+        pass
+
+    @abstractmethod
+    def handle(self):
+        """
+        Executes the setup process for initializing the Orionis project.
+
+        This process includes:
+        1. Cloning the repository.
+        2. Creating a virtual environment.
+        3. Installing dependencies from requirements.txt.
+        4. Setting up the .env file.
+        5. Generating an API key.
+        6. Cleaning up temporary files and .git remote origin.
+
+        Raises
+        ------
+        ValueError
+            If there is an error during any subprocess execution.
+        Exception
+            If any unexpected error occurs.
+        """
+        pass

orionis/contracts/providers/i_service_provider.py

@@ -0,0 +1,27 @@
+from abc import ABC, abstractmethod
+from orionis.luminate.container.container import Container
+
+class IServiceProvider(ABC):
+
+    @abstractmethod
+    def register(self, container: Container) -> None:
+        """
+        Registers services or bindings into the given container.
+
+        Args:
+            container (Container): The container to register services or bindings into.
+        """
+        pass
+
+    @abstractmethod
+    def boot(self, container: Container) -> None:
+        """
+        Boot the service provider.
+
+        This method is intended to be overridden by subclasses to perform
+        any necessary bootstrapping or initialization tasks.
+
+        Args:
+            container (Container): The service container instance.
+        """
+        pass

orionis/contracts/services/config/i_config_service.py

@@ -0,0 +1,37 @@
+from abc import ABC, abstractmethod
+from typing import Any, Optional
+
+class IConfigService(ABC):
+
+    @abstractmethod
+    def set(self, key: str, value: Any) -> None:
+        """
+        Dynamically sets a configuration value using dot notation.
+
+        Parameters
+        ----------
+        key : str
+            The configuration key (e.g., 'app.debug').
+        value : Any
+            The value to set.
+        """
+        pass
+
+    @abstractmethod
+    def get(self, key: str, default: Optional[Any] = None) -> Any:
+        """
+        Retrieves a configuration value using dot notation.
+
+        Parameters
+        ----------
+        key : str
+            The configuration key (e.g., 'app.debug').
+        default : Optional[Any]
+            The default value to return if the key is not found.
+
+        Returns
+        -------
+        Any
+            The configuration value or the default value if the key is not found.
+        """
+        pass

orionis/contracts/services/files/i_path_service.py

@@ -0,0 +1,31 @@
+import os
+from pathlib import Path
+from abc import ABC, abstractmethod
+
+class IPathService(ABC):
+
+    @abstractmethod
+    def resolve(self, route: str) -> str:
+        """
+        Resolves and returns the absolute path as a string.
+
+        This method combines the base path (current working directory) with the provided
+        relative path, resolves it to an absolute path, and validates that it exists
+        and is either a directory or a file.
+
+        Parameters
+        ----------
+        route : str
+            The relative directory or file path to be resolved.
+
+        Returns
+        -------
+        str
+            The absolute path to the directory or file.
+
+        Raises
+        ------
+        ValueError
+            If the resolved path does not exist or is neither a directory nor a file.
+        """
+        pass

orionis/contracts/services/log/i_log_service.py

@@ -0,0 +1,89 @@
+from abc import ABC, abstractmethod
+from typing import Optional
+
+class ILogguerService(ABC):
+
+    @abstractmethod
+    def _initialize_logger(self, path: Optional[str], level: int, filename: Optional[str] = 'orionis.log'):
+        """
+        Configures the logger with the specified settings.
+
+        This method sets up the logger to write logs to a file. If the specified
+        directory does not exist, it creates it. The log format includes the
+        timestamp and the log message.
+
+        Parameters
+        ----------
+        path : Optional[str]
+            The directory path where the log file will be stored.
+        level : int
+            The logging level (e.g., logging.INFO, logging.ERROR).
+        filename : Optional[str]
+            The name of the log file.
+
+        Raises
+        ------
+        RuntimeError
+            If the logger cannot be initialized due to an error.
+        """
+        pass
+
+    @abstractmethod
+    def info(self, message: str) -> None:
+        """
+        Logs an informational message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        pass
+
+    @abstractmethod
+    def error(self, message: str) -> None:
+        """
+        Logs an error message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        pass
+
+    @abstractmethod
+    def success(self, message: str) -> None:
+        """
+        Logs a success message (treated as info).
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        pass
+
+    @abstractmethod
+    def warning(self, message: str) -> None:
+        """
+        Logs a warning message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        pass
+
+    @abstractmethod
+    def debug(self, message: str) -> None:
+        """
+        Logs a debug message.
+
+        Parameters
+        ----------
+        message : str
+            The message to log.
+        """
+        pass

orionis/{luminate/facades/environment.py → contracts/support/i_environment.py}

@@ -1,29 +1,22 @@
-from orionis.luminate.config.environment import Environment
-from orionis.luminate.contracts.facades.env_interface import IEnv
+from abc import ABC, abstractmethod
 
-def env(key: str, default=None) -> str:
-    """
-    Retrieves the value of an environment variable from the .env file
-    or from system environment variables if not found.
+class IEnvironment(ABC):
 
-    Parameters
-    ----------
-    key : str
-        The key of the environment variable.
-    default : optional
-        Default value if the key does not exist. Defaults to None.
-
-    Returns
-    -------
-    str
-        The value of the environment variable or the default value.
-    """
-    return Environment().get(key, default)
+    @abstractmethod
+    def _initialize(self, path: str = None):
+        """
+        Initializes the instance by setting the path to the .env file.
+        If no path is provided, defaults to a `.env` file in the current directory.
 
-class Env(IEnv):
+        Parameters
+        ----------
+        path : str, optional
+            Path to the .env file. Defaults to None.
+        """
+        pass
 
-    @staticmethod
-    def get(key: str, default=None) -> str:
+    @abstractmethod
+    def get(self, key: str, default=None) -> str:
         """
         Retrieves the value of an environment variable from the .env file
         or from system environment variables if not found.
@@ -40,10 +33,10 @@ class Env(IEnv):
         str
             The value of the environment variable or the default value.
         """
-        Environment().get(key, default)
+        pass
 
-    @staticmethod
-    def set(key: str, value: str) -> None:
+    @abstractmethod
+    def set(self, key: str, value: str) -> None:
         """
         Sets the value of an environment variable in the .env file.
 
@@ -54,10 +47,10 @@ class Env(IEnv):
         value : str
             The value to set.
         """
-        Environment().set(key, value)
+        pass
 
-    @staticmethod
-    def unset(key: str) -> None:
+    @abstractmethod
+    def unset(self, key: str) -> None:
         """
         Removes an environment variable from the .env file.
 
@@ -66,10 +59,10 @@ class Env(IEnv):
         key : str
             The key of the environment variable to remove.
         """
-        Environment().unset(key)
+        pass
 
-    @staticmethod
-    def all() -> dict:
+    @abstractmethod
+    def all(self) -> dict:
         """
         Retrieves all environment variable values from the .env file.
 
@@ -78,4 +71,4 @@ class Env(IEnv):
         dict
             A dictionary of all environment variables and their values.
         """
-        Environment().all()
+        pass

orionis/{luminate/contracts/tools/exception_to_dict_interface.py → contracts/support/i_exception_to_dict.py}

@@ -1,15 +1,6 @@
 from abc import ABC, abstractmethod
 
 class IExceptionsToDict(ABC):
-    """
-    A utility class to parse an exception and convert it into a structured dictionary.
-
-    Methods
-    -------
-    parse(exception: Exception) -> dict
-        Converts an exception into a dictionary containing the error type, message, 
-        and stack trace information.
-    """
 
     @abstractmethod
     def parse(exception):

orionis/{luminate/contracts/tools/reflection_interface.py → contracts/support/i_reflection.py}

@@ -2,15 +2,19 @@ from abc import ABC, abstractmethod
 from typing import Any, List, Optional
 
 class IReflection(ABC):
-    """
-    Abstract base class for reflection operations on a Python class.
-    This interface defines the methods that any reflection class must implement.
-    """
 
     @abstractmethod
     def safeImport(self):
         """
-        Safely imports the module and class as specified in the instance.
+        Safely imports the specified module and assigns the class object if a classname is provided.
+
+        This method raises a ValueError if the module cannot be imported or if the class does not exist
+        within the module.
+
+        Raises
+        ------
+        ValueError
+            If the module cannot be imported or the class does not exist in the module.
         """
         pass
 
@@ -22,7 +26,12 @@ class IReflection(ABC):
         Returns
         -------
         str
-            The file path of the class definition.
+            The file path if the class is found, otherwise raises an error.
+
+        Raises
+        ------
+        ValueError
+            If the class has not been loaded yet.
         """
         pass
 
@@ -128,7 +137,7 @@ class IReflection(ABC):
     @abstractmethod
     def getFileName(self, remove_extension: bool = False) -> str:
         """
-        Retrieves the file name where the class is defined.
+        Retrieves the file name where the class is defined, the same as `get_file()`.
 
         Parameters
         ----------
@@ -340,4 +349,4 @@ class IReflection(ABC):
         str
             A string describing the class and module.
         """
-        pass
+        pass

orionis/{luminate/contracts/tools/std_interface.py → contracts/support/i_std.py}

@@ -2,23 +2,10 @@ from abc import ABC, abstractmethod
 
 class IStdClass(ABC):
     """
-    An abstract base class defining the contract for any StdClass-like object.
-    This class ensures that any concrete implementation provides the necessary methods
-    for attribute management and dynamic behavior.
+    Interface for a dynamic class that allows setting arbitrary attributes,
+    similar to PHP's stdClass.
     """
 
-    @abstractmethod
-    def __init__(self, **kwargs):
-        """
-        Initializes the object with optional keyword arguments to set attributes.
-
-        Parameters
-        ----------
-        kwargs : dict
-            Key-value pairs to set as attributes.
-        """
-        pass
-
     @abstractmethod
     def __repr__(self) -> str:
         """
@@ -44,7 +31,7 @@ class IStdClass(ABC):
         pass
 
     @abstractmethod
-    def update(self, **kwargs) -> None:
+    def update(self, **kwargs):
         """
         Updates the object's attributes dynamically.
 

orionis/framework.py

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

orionis/{luminate/console/scripts/management.py → installer/installer_manager.py}

@@ -1,9 +1,11 @@
-from orionis.luminate.installer.setup import Setup
-from orionis.luminate.installer.output import Output
-from orionis.luminate.installer.upgrade import Upgrade
-from orionis.luminate.contracts.console.scripts.management_interface import IManagement
 
-class Management(IManagement):
+import subprocess
+import sys
+from orionis.contracts.installer.i_installer_manager import IInstallerManager
+from orionis.installer.installer_output import InstallerOutput
+from orionis.installer.installer_setup import InstallerSetup
+
+class InstallerManager(IInstallerManager):
     """
     Management class responsible for handling framework-related operations.
 
@@ -12,11 +14,11 @@ class Management(IManagement):
 
     Attributes
     ----------
-    output : Output
+    output : InstallerOutput
         Instance of Output to manage command-line display messages.
     """
 
-    def __init__(self, output = Output):
+    def __init__(self, output = InstallerOutput):
         """
         Initialize the Management class with an output handler.
 
@@ -27,7 +29,7 @@ class Management(IManagement):
         """
         self.output = output
 
-    def displayVersion(self) -> str:
+    def handleVersion(self) -> str:
         """
         Display the current version of the framework in ASCII format.
 
@@ -46,7 +48,7 @@ class Management(IManagement):
         except Exception as e:
             raise RuntimeError(f"Failed to display version: {e}")
 
-    def executeUpgrade(self) -> None:
+    def handleUpgrade(self) -> None:
         """
         Execute the framework upgrade process to the latest version.
 
@@ -56,11 +58,15 @@ class Management(IManagement):
             If an error occurs during the upgrade process.
         """
         try:
-            Upgrade.execute()
+            self.output.info("Starting the upgrade process...")
+            subprocess.check_call([sys.executable, "-m", "pip", "install", "--upgrade", "orionis"])
+        except subprocess.CalledProcessError as e:
+            raise RuntimeError(f"Upgrade failed: {e}")
         except Exception as e:
-            raise RuntimeError(f"Upgrade process failed: {e}")
+            raise RuntimeError(f"Upgrade failed: {e}")
+
 
-    def createNewApp(self, name_app: str = "example-app") -> None:
+    def handleNewApp(self, name_app: str = "example-app") -> None:
         """
         Create a new application with the specified name.
 
@@ -75,11 +81,11 @@ class Management(IManagement):
             If an error occurs during the application setup.
         """
         try:
-            Setup(name_app).handle()
+            InstallerSetup(name=name_app, output=self.output).handle()
         except Exception as e:
-            raise RuntimeError(f"Failed to create application '{name_app}': {e}")
+            raise RuntimeError(f"Failed to create new app: {e}")
 
-    def displayInfo(self) -> None:
+    def handleInfo(self) -> None:
         """
         Display additional framework information in ASCII format.
 
@@ -91,4 +97,4 @@ class Management(IManagement):
         try:
             self.output.asciiInfo()
         except Exception as e:
-            raise RuntimeError(f"Failed to display information: {e}")
+            raise RuntimeError(f"Failed to display information: {e}")