orionis 0.179.0__tar.gz → 0.182.0__tar.gz

{orionis-0.179.0/orionis.egg-info → orionis-0.182.0}/PKG-INFO

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

orionis-0.179.0/orionis/cli_manager.py → orionis-0.182.0/orionis/console.py

@@ -1,8 +1,8 @@
 import argparse
 from orionis.installer.manager import InstallerManager
-from orionis.installer.output.output import InstallerOutput
+from orionis.luminate.console.output.console import Console
 
-# Main entry point for the Orionis CLI tool.
+# Main entry point for the Orionis CLI Installer.
 def main():
 
     # Initialize the argument parser
@@ -27,7 +27,7 @@ def main():
         else:
             installer.handleInfo()
     except Exception as e:
-        InstallerOutput.error(f"An error occurred: {e}", e)
+        Console.exception(e)
 
 # Execute the main function if the script is run directly
 if __name__ == "__main__":

{orionis-0.179.0 → orionis-0.182.0}/orionis/framework.py

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

orionis-0.182.0/orionis/installer/contracts/output.py

@@ -0,0 +1,39 @@
+from abc import ABC, abstractmethod
+
+class IInstallerOutput(ABC):
+
+    @abstractmethod
+    def printHelp(self):
+        """
+        Prints the help message with available commands.
+
+        If the ASCII file is not found, it falls back to a basic message.
+        """
+        pass
+
+    @abstractmethod
+    def printIcon(self):
+        """
+        Prints the Orionis icon with a motivational message.
+
+        If the ASCII file is not found, it falls back to a basic message.
+        """
+        pass
+
+    @abstractmethod
+    def printStartInstallation(self):
+        """
+        Prints the start of the installation message.
+
+        Displays the Orionis icon and a thank you message.
+        """
+        pass
+
+    @abstractmethod
+    def printEndInstallation(self):
+        """
+        Prints the end of the installation message.
+
+        Displays a welcome message and encourages the user to start using the framework.
+        """
+        pass

orionis-0.182.0/orionis/installer/contracts/setup.py

@@ -0,0 +1,28 @@
+from abc import ABC, abstractmethod
+
+class IInstallerSetup(ABC):
+    """
+    Interface for the InstallerSetup class.
+    """
+
+    @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-0.179.0 → orionis-0.182.0}/orionis/installer/manager.py

@@ -1,9 +1,8 @@
-
 import subprocess
 import sys
-from orionis.installer.contracts.installer_manager import IInstallerManager
-from orionis.installer.contracts.installer_setup import InstallerSetup
-from orionis.installer.output.output import InstallerOutput
+from orionis.installer.contracts.manager import IInstallerManager
+from orionis.installer.output import InstallerOutput
+from orionis.installer.setup import InstallerSetup
 
 class InstallerManager(IInstallerManager):
     """
@@ -18,7 +17,7 @@ class InstallerManager(IInstallerManager):
         Instance of Output to manage command-line display messages.
     """
 
-    def __init__(self, output = InstallerOutput):
+    def __init__(self):
         """
         Initialize the Management class with an output handler.
 
@@ -27,7 +26,7 @@ class InstallerManager(IInstallerManager):
         output : Output
             An instance of Output to handle command-line messages.
         """
-        self.output = output
+        self._output = InstallerOutput()
 
     def handleVersion(self) -> str:
         """
@@ -37,16 +36,8 @@ class InstallerManager(IInstallerManager):
         -------
         str
             The ASCII representation of the framework version.
-
-        Raises
-        ------
-        Exception
-            If an error occurs while generating the ASCII version output.
         """
-        try:
-            return self.output.asciiIco()
-        except Exception as e:
-            raise RuntimeError(f"Failed to display version: {e}")
+        return self._output.printIcon()
 
     def handleUpgrade(self) -> None:
         """
@@ -58,7 +49,6 @@ class InstallerManager(IInstallerManager):
             If an error occurs during the upgrade process.
         """
         try:
-            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}")
@@ -81,7 +71,7 @@ class InstallerManager(IInstallerManager):
             If an error occurs during the application setup.
         """
         try:
-            InstallerSetup(name=name_app, output=self.output).handle()
+            return InstallerSetup(name=name_app, output=self._output).handle()
         except Exception as e:
             raise RuntimeError(f"Failed to create new app: {e}")
 
@@ -95,6 +85,6 @@ class InstallerManager(IInstallerManager):
             If an error occurs while displaying information.
         """
         try:
-            self.output.asciiInfo()
+            self._output.asciiInfo()
         except Exception as e:
             raise RuntimeError(f"Failed to display information: {e}")

orionis-0.182.0/orionis/installer/output.py

@@ -0,0 +1,256 @@
+import os
+import datetime
+import requests
+from orionis.framework import API, NAME, VERSION, DOCS
+from orionis.installer.contracts.output import IInstallerOutput
+
+class InstallerOutput(IInstallerOutput):
+    """
+    A class to handle the output and display messages for the Orionis installer.
+
+    This class provides methods to load ASCII art, format messages with ANSI colors,
+    and display installation-related information such as commands, version, and status.
+
+    Attributes
+    ----------
+    None
+
+    Methods
+    -------
+    _loadAsciiFile(name: str) -> str
+        Loads an ASCII file from the static directory.
+    _ansiMessage(message: str) -> str
+        Formats a message with green ANSI color.
+    _ansiCommands() -> str
+        Formats a list of commands with yellow ANSI color.
+    _ansiVersion(version: str = None) -> str
+        Formats version information with green ANSI color.
+    _ansiTextGreen(text: str) -> str
+        Wraps text in green ANSI color.
+    _year() -> str
+        Returns the current year as a string.
+    _newVersion() -> str
+        Checks for a new version of Orionis and returns a formatted message.
+    _replacePlaceholders(content: str, message: str) -> str
+        Replaces placeholders in a string with dynamic content.
+    _fallbackAscii() -> str
+        Provides a fallback ASCII message if the file is not found.
+    printHelp()
+        Prints the help message with available commands.
+    printIcon()
+        Prints the Orionis icon with a motivational message.
+    printStartInstallation()
+        Prints the start of the installation message.
+    printEndInstallation()
+        Prints the end of the installation message.
+    """
+
+    def _loadAsciiFile(self, name: str) -> str:
+        """
+        Loads an ASCII file from the static directory.
+
+        Parameters
+        ----------
+        name : str
+            The name of the ASCII file (without the .ascii extension).
+
+        Returns
+        -------
+        str
+            The content of the ASCII file.
+
+        Raises
+        ------
+        FileNotFoundError
+            If the file does not exist.
+        """
+        dir_path = os.path.dirname(__file__)
+        path = os.path.join(dir_path, '..', 'static', 'ascii', f"{name}.ascii")
+        try:
+            with open(path, 'r', encoding='utf-8') as file:
+                return file.read()
+        except FileNotFoundError:
+            raise FileNotFoundError(f"File {name}.ascii not found")
+
+    def _ansiMessage(self, message: str) -> str:
+        """
+        Formats a message with green ANSI color.
+
+        Parameters
+        ----------
+        message : str
+            The message to format.
+
+        Returns
+        -------
+        str
+            The formatted message.
+        """
+        return "\033[92m{} \033[0m".format(message)
+
+    def _ansiCommands(self) -> str:
+        """
+        Formats a list of commands with yellow ANSI color.
+
+        Returns
+        -------
+        str
+            The formatted list of commands.
+        """
+        commands = [
+            {'name': 'orionis new <app_name>', 'description': 'Creates a new Orionis app with the specified name.'},
+            {'name': 'orionis --version', 'description': 'Displays the current version of Orionis.'},
+            {'name': 'orionis --upgrade', 'description': 'Upgrades Orionis to the latest version.'}
+        ]
+        commands_array = [
+            "\033[1m\033[93m- {} :\033[0m {}".format(command['name'], command['description'])
+            for command in commands
+        ]
+        return "\n".join(commands_array)
+
+    def _ansiVersion(self, version: str = None) -> str:
+        """
+        Formats version information with green ANSI color.
+
+        Parameters
+        ----------
+        version : str, optional
+            The latest version available. If None, assumes the current version is the latest.
+
+        Returns
+        -------
+        str
+            The formatted version message.
+        """
+        if version:
+            return self._ansiTextGreen(f"A new version ({version}) is available. Please consider upgrading from the current version ({VERSION}).")
+        return self._ansiTextGreen("You are using the latest stable version available.")
+
+    def _ansiTextGreen(self, text: str) -> str:
+        """
+        Wraps text in green ANSI color.
+
+        Parameters
+        ----------
+        text : str
+            The text to format.
+
+        Returns
+        -------
+        str
+            The formatted text.
+        """
+        return f"\u001b[32m{text}\u001b[0m"
+
+    def _year(self) -> str:
+        """
+        Returns the current year as a string.
+
+        Returns
+        -------
+        str
+            The current year.
+        """
+        return str(datetime.datetime.now().year)
+
+    def _newVersion(self) -> str:
+        """
+        Checks for a new version of Orionis and returns a formatted message.
+
+        Returns
+        -------
+        str
+            The formatted version message.
+        """
+        try:
+            response = requests.get(API, timeout=10)
+            response.raise_for_status()
+            data = response.json()
+            latest_version = data.get("info", {}).get("version")
+            if not latest_version:
+                raise ValueError("Version information not found in API response.")
+            if latest_version != VERSION:
+                return self._ansiVersion(latest_version)
+            return self._ansiVersion()
+        except (requests.RequestException, ValueError) as e:
+            return self._ansiVersion()
+
+    def _replacePlaceholders(self, content: str, message: str) -> str:
+        """
+        Replaces placeholders in a string with dynamic content.
+
+        Parameters
+        ----------
+        content : str
+            The string containing placeholders.
+        message : str
+            The message to replace the {{message}} placeholder.
+
+        Returns
+        -------
+        str
+            The string with placeholders replaced.
+        """
+        return content.replace('{{version}}', VERSION) \
+                      .replace('{{docs}}', DOCS) \
+                      .replace('{{year}}', self._year()) \
+                      .replace('{{message}}', self._ansiMessage(message)) \
+                      .replace('{{commands}}', self._ansiCommands()) \
+                      .replace('{{new_version}}', self._newVersion())
+
+    def _fallbackAscii(self) -> str:
+        """
+        Provides a fallback ASCII message if the file is not found.
+
+        Returns
+        -------
+        str
+            The fallback message.
+        """
+        return f"{NAME.upper()}\nVersion: {VERSION}\nDocs: {DOCS}"
+
+    def printHelp(self):
+        """
+        Prints the help message with available commands.
+
+        If the ASCII file is not found, it falls back to a basic message.
+        """
+        try:
+            content = self._loadAsciiFile('info')
+            output = self._replacePlaceholders(content, "The list of commands accepted by the Orionis interpreter are:")
+            print(output)
+        except FileNotFoundError:
+            output = self._fallbackAscii()
+            print(output)
+
+    def printIcon(self):
+        """
+        Prints the Orionis icon with a motivational message.
+
+        If the ASCII file is not found, it falls back to a basic message.
+        """
+        try:
+            content = self._loadAsciiFile('icon')
+            output = self._replacePlaceholders(content, "Python isn't just powerful; it’s thrilling.")
+            print(output)
+        except FileNotFoundError:
+            output = self._fallbackAscii()
+            print(output)
+
+    def printStartInstallation(self):
+        """
+        Prints the start of the installation message.
+
+        Displays the Orionis icon and a thank you message.
+        """
+        self.printIcon()
+        print(self._ansiTextGreen("Thank you for using the framework!"))
+
+    def printEndInstallation(self):
+        """
+        Prints the end of the installation message.
+
+        Displays a welcome message and encourages the user to start using the framework.
+        """
+        print(self._ansiTextGreen("Welcome aboard, the journey starts now. Let your imagination soar!"))
+        print("-------------------------------------------")

{orionis-0.179.0/orionis/installer/setup → orionis-0.182.0/orionis/installer}/setup.py

@@ -5,9 +5,11 @@ import shutil
 import subprocess
 from unicodedata import normalize
 from orionis.framework import SKELETON, DOCS
-from orionis.installer.output.output import InstallerOutput
+from orionis.installer.contracts.output import IInstallerOutput
+from orionis.installer.contracts.setup import IInstallerSetup
+from orionis.luminate.console.output.console import Console
 
-class InstallerSetup:
+class InstallerSetup(IInstallerSetup):
     """
     A class to initialize a Orionis project by performing the following setup actions:
     1. Sanitize the folder name.
@@ -33,19 +35,19 @@ class InstallerSetup:
         The sanitized folder name for the application.
     """
 
-    def __init__(self, name: str = 'example-app', output = InstallerOutput):
+    def __init__(self, output : IInstallerOutput, name: str = 'example-app'):
         """
         Initialize OrionislInit class.
 
         Parameters
         ----------
-        output : InstallerOutput
+        output : IInstallerOutput
             An instance of InstallerOutput.
         name_app : str, optional
             Name of the application. If not provided, defaults to "example-app".
         """
-        self.output = output
-        self.output.startInstallation()
+        self._output = output
+        self._output.printStartInstallation()
         self.name_app_folder = self._sanitize_folder_name(name)
 
     def _sanitize_folder_name(self, name: str) -> str:
@@ -106,6 +108,17 @@ class InstallerSetup:
 
         return name
 
+    def _printInfo(self, message: str) -> None:
+        """
+        Display an information message to the console.
+
+        Parameters
+        ----------
+        message : str
+            The message to display.
+        """
+        Console.info(message)
+
     def handle(self):
         """
         Executes the setup process for initializing the Orionis project.
@@ -131,19 +144,19 @@ class InstallerSetup:
                 raise ValueError(f"The folder '{self.name_app_folder}' already exists.")
 
             # Clone the repository
-            self.output.info(f"Cloning the repository into '{self.name_app_folder}'... (Getting Latest Version)")
+            self._printInfo(f"Cloning the repository into '{self.name_app_folder}'... (Getting Latest Version)")
             subprocess.run(["git", "clone", SKELETON, self.name_app_folder], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-            self.output.info(f"Repository successfully cloned into '{self.name_app_folder}'.")
+            self._printInfo(f"Repository successfully cloned into '{self.name_app_folder}'.")
 
             # Change to the project directory
             project_path = os.path.join(os.getcwd(), self.name_app_folder)
             os.chdir(project_path)
-            self.output.info(f"Entering directory '{self.name_app_folder}'.")
+            self._printInfo(f"Entering directory '{self.name_app_folder}'.")
 
             # Create a virtual environment
-            self.output.info("Creating virtual environment...")
+            self._printInfo("Creating virtual environment...")
             subprocess.run([sys.executable, "-m", "venv", "venv"], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-            self.output.info("Virtual environment successfully created.")
+            self._printInfo("Virtual environment successfully created.")
 
             # Virtual environment path
             venv_path = os.path.join(project_path, "venv", "Scripts" if os.name == "nt" else "bin")
@@ -153,9 +166,9 @@ class InstallerSetup:
                 raise ValueError(f"'requirements.txt' not found. Please visit the Orionis Docs for more details: {DOCS}")
 
             # Install dependencies from requirements.txt
-            self.output.info("Installing dependencies from 'requirements.txt'...")
+            self._printInfo("Installing dependencies from 'requirements.txt'...")
             subprocess.run([os.path.join(venv_path, "pip"), "install", "-r", "requirements.txt"], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-            self.output.info("Dependencies successfully installed.")
+            self._printInfo("Dependencies successfully installed.")
 
             # Create .env
             example_env_path = os.path.join(project_path, '.env.example')
@@ -170,10 +183,10 @@ class InstallerSetup:
             subprocess.run(["git", "remote", "remove", "origin"], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 
             # Finish Process Message
-            self.output.info(f"Project '{self.name_app_folder}' successfully created at '{os.path.abspath(project_path)}'.")
-            self.output.endInstallation()
+            self._printInfo(f"Project '{self.name_app_folder}' successfully created at '{os.path.abspath(project_path)}'.")
+            self._output.printEndInstallation()
 
         except subprocess.CalledProcessError as e:
             raise ValueError(f"Error while executing command: {e}")
         except Exception as e:
-            raise RuntimeError(f"An unexpected error occurred: {e}")
+            raise RuntimeError(f"An unexpected error occurred: {e}")

{orionis-0.179.0 → orionis-0.182.0}/orionis/luminate/services/commands/reactor_commands_service.py

@@ -1,6 +1,5 @@
 import time
 from typing import Any, Dict, Optional
-from orionis.luminate.container.resolve import Resolve
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.command_filter import CommandFilter
 from orionis.luminate.console.exceptions.cli_exception import CLIOrionisException
@@ -21,7 +20,7 @@ class ReactorCommandsService:
     - Managing execution timing and error handling.
     """
 
-    def __init__(self, command_filter: CommandFilter, log: Log, executor: Executor, console: Console, app = Resolve(IApplication)) -> None:
+    def __init__(self, command_filter: CommandFilter, log: Log, executor: Executor, console: Console, app : IApplication) -> None:
         """
         Initializes the ReactorCommandsService instance.
 

{orionis-0.179.0 → orionis-0.182.0}/orionis/luminate/services/config/config_service.py

@@ -1,11 +1,10 @@
 import copy
 from typing import Any, Optional
-from orionis.luminate.container.resolve import Resolve
 from orionis.luminate.contracts.application import IApplication
 
 class ConfigService:
 
-    def __init__(self,  app = Resolve(IApplication)) -> None:
+    def __init__(self,  app : IApplication) -> None:
         """
         Initializes the ConfigService with the provided configuration.
 

{orionis-0.179.0 → orionis-0.182.0}/orionis/static/ascii/icon.ascii

@@ -9,4 +9,5 @@ ___________________________________________
 Orionis Team © 2023 - {{year}}
 Version: {{version}}
 Docs: {{docs}}
+{{new_version}}
 -------------------------------------------

{orionis-0.179.0 → orionis-0.182.0}/orionis/static/ascii/info.ascii

@@ -11,4 +11,5 @@ ___________________________________________
 Orionis Team © 2023 - {{year}}
 Version: {{version}}
 Docs: {{docs}}
+{{new_version}}
 -------------------------------------------

{orionis-0.179.0 → orionis-0.182.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.179.0 → orionis-0.182.0}/orionis.egg-info/SOURCES.txt

@@ -3,7 +3,7 @@ MANIFEST.in
 README.md
 setup.py
 orionis/__init__.py
-orionis/cli_manager.py
+orionis/console.py
 orionis/framework.py
 orionis.egg-info/PKG-INFO
 orionis.egg-info/SOURCES.txt
@@ -13,15 +13,12 @@ orionis.egg-info/requires.txt
 orionis.egg-info/top_level.txt
 orionis/installer/__init__.py
 orionis/installer/manager.py
-orionis/installer/version.py
+orionis/installer/output.py
+orionis/installer/setup.py
 orionis/installer/contracts/__init__.py
-orionis/installer/contracts/installer_manager.py
-orionis/installer/contracts/installer_output.py
-orionis/installer/contracts/installer_setup.py
-orionis/installer/output/__init__.py
-orionis/installer/output/output.py
-orionis/installer/setup/__init__.py
-orionis/installer/setup/setup.py
+orionis/installer/contracts/manager.py
+orionis/installer/contracts/output.py
+orionis/installer/contracts/setup.py
 orionis/luminate/__init__.py
 orionis/luminate/application.py
 orionis/luminate/config/__init__.py

orionis-0.182.0/orionis.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+orionis = orionis.console:main

{orionis-0.179.0 → orionis-0.182.0}/setup.py

@@ -25,7 +25,7 @@ setup(
     ],
     entry_points={
         "console_scripts": [
-            "orionis=orionis.cli_manager:main"
+            "orionis=orionis.console:main"
         ]
     },
     test_suite="tests"