orionis 0.4.0__tar.gz → 0.6.0__tar.gz

{orionis-0.4.0/orionis.egg-info → orionis-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.4.0
+Version: 0.6.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro
@@ -27,6 +27,8 @@ Dynamic: summary
 
 🚀 **Orionis Framework – Elegant, Fast, and Powerful** ⚡
 
+![Orionis Framework Logo](https://raw.githubusercontent.com/orionis-framework/framework/refs/heads/1.x/orionis/luminate/static/logos/OrionisFramework.png)
+
 🔬 **(Currently in Beta – Evolving Towards Perfection!)**
 
 ---

{orionis-0.4.0 → orionis-0.6.0}/README.md

@@ -2,6 +2,8 @@
 
 🚀 **Orionis Framework – Elegant, Fast, and Powerful** ⚡
 
+![Orionis Framework Logo](https://raw.githubusercontent.com/orionis-framework/framework/refs/heads/1.x/orionis/luminate/static/logos/OrionisFramework.png)
+
 🔬 **(Currently in Beta – Evolving Towards Perfection!)**
 
 ---

orionis-0.6.0/orionis/framework.py

@@ -0,0 +1,35 @@
+#--------------------------------------------------------------------------
+# Framework Information
+#--------------------------------------------------------------------------
+# Name of the framework
+NAME = "orionis"
+
+# Current version of the framework
+VERSION = "0.6.0"
+
+# Full name of the author or maintainer of the project
+AUTHOR = "Raul Mauricio Uñate Castro"
+
+# Email address of the author or maintainer for contact purposes
+AUTHOR_EMAIL = "raulmauriciounate@gmail.com"
+
+# Short description of the project or framework
+DESCRIPTION = "Orionis Framework – Elegant, Fast, and Powerful."
+
+#--------------------------------------------------------------------------
+# Project URLs
+#--------------------------------------------------------------------------
+# URL to the project's skeleton or template repository (for initial setup)
+SKELETON = "https://github.com/orionis-framework/skeleton"
+
+# URL to the project's main framework repository
+FRAMEWORK = "https://github.com/orionis-framework/framework"
+
+# URL to the project's documentation
+DOCS = "https://github.com/orionis-framework/docs"
+
+#--------------------------------------------------------------------------
+# Python Requirements
+#--------------------------------------------------------------------------
+# Minimum Python version required to run the project
+PYTHON_REQUIRES = ">=3.12"

{orionis-0.4.0 → orionis-0.6.0}/orionis/luminate/console/exceptions/cli_exception.py

@@ -38,9 +38,9 @@ class CLIOrionisException(Exception):
         str
             A string containing the exception name and the response message.
         """
-        return f"CLIOrionisException: {self.response}"
+        return f"[CLIOrionisException]: {self.response}"
 
-class CLIOrionisValueError(Exception):
+class CLIOrionisValueError(ValueError):
     """
     Custom exception raised when there is an issue with dumping the Orionis data.
 
@@ -80,7 +80,7 @@ class CLIOrionisValueError(Exception):
         str
             A string containing the exception name and the response message.
         """
-        return f"CLIOrionisValueError: {self.response}"
+        return f"[CLIOrionisValueError]: {self.response}"
 
 class CLIOrionisScheduleException(Exception):
     """
@@ -104,7 +104,7 @@ class CLIOrionisScheduleException(Exception):
 
     def __init__(self, response: str):
         """
-        Initializes the CLIOrionisValueError with the given response message.
+        Initializes the CLIOrionisScheduleException with the given response message.
 
         Parameters
         ----------
@@ -122,4 +122,4 @@ class CLIOrionisScheduleException(Exception):
         str
             A string containing the exception name and the response message.
         """
-        return f"CLIOrionisValueError: {self.response}"
+        return f"[CLIOrionisScheduleException]: {self.response}"

orionis-0.6.0/orionis/luminate/container/container.py

@@ -0,0 +1,266 @@
+import inspect
+from typing import Any, Callable
+from orionis.luminate.container.exception import OrionisContainerException, OrionisContainerValueError
+
+class Container:
+    """Service container and dependency injection."""
+
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._bindings = {}
+            cls._instance._transients = {}
+            cls._instance._singletons = {}
+            cls._instance._scoped_services = {}
+            cls._instance._instances = {}
+            cls._instance._aliases = {}
+            cls._instance._scoped_instances = {}
+            cls._instance._conditional_bindings = {}
+        return cls._instance
+
+    def bind(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service with a specific implementation.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        if self.has(abstract):
+            raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
+
+        if not callable(concrete):
+            raise TypeError(f"The implementation of '{abstract}' must be a callable or instantiable class.")
+
+        self._bindings[abstract] = concrete
+
+    def transient(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Transient, creating a new instance on each request.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        if self.has(abstract):
+            raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
+
+        if not callable(concrete):
+            raise TypeError(f"The implementation of '{abstract}' must be a callable or instantiable class.")
+
+        self._transients[abstract] = concrete
+
+    def singleton(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Singleton, ensuring a single shared instance.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        if self.has(abstract):
+            raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
+
+        if not callable(concrete):
+            raise TypeError(f"The implementation of '{abstract}' must be a callable or instantiable class.")
+
+        self._singletons[abstract] = concrete
+
+    def scoped(self, abstract: str, concrete: Callable[..., Any]) -> None:
+        """Registers a service as Scoped, shared within the same request.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Raises:
+            OrionisContainerException: If the service is already registered.
+            TypeError: If the implementation is not a callable or instantiable class.
+        """
+        if self.has(abstract):
+            raise OrionisContainerException(f"The service '{abstract}' is already registered in the container.")
+
+        if not callable(concrete):
+            raise TypeError(f"The implementation of '{abstract}' must be a callable or instantiable class.")
+
+        self._scoped_services[abstract] = concrete
+
+    def instance(self, abstract: str, instance: Any) -> None:
+        """Registers a specific instance in the container, allowing it to be reused.
+
+        Args:
+            abstract (str): Name or key of the service to register.
+            instance (Any): Specific instance of the service to register.
+
+        Raises:
+            OrionisContainerException: If the instance is already registered.
+            ValueError: If the provided instance is of an unexpected or invalid type.
+        """
+        if abstract in self._instances:
+            raise OrionisContainerException(f"The instance '{abstract}' is already registered in the container.")
+
+        if not isinstance(instance, object):
+            raise ValueError(f"The instance of '{abstract}' must be a valid object.")
+
+        self._instances[abstract] = instance
+
+    def has(self, abstract: str) -> bool:
+        """Checks if a service is registered in the container.
+
+        Args:
+            abstract (str): Name or key of the service to check.
+
+        Returns:
+            bool: True if the service is registered, False otherwise.
+
+        Raises:
+            ValueError: If the service name (abstract) is not a valid string.
+        """
+        # Check that 'abstract' is a string
+        if not isinstance(abstract, str):
+            raise ValueError(f"The service name '{abstract}' must be a string.")
+
+        # Efficient check if the service is in any of the containers
+        return any(abstract in container for container in [
+            self._bindings,
+            self._transients,
+            self._singletons,
+            self._scoped_services,
+            self._instances
+        ])
+
+    def alias(self, abstract: str, alias: str) -> None:
+        """Creates an alias for a registered service, allowing access to the service using an alternative name.
+
+        Args:
+            abstract (str): Name or key of the original service.
+            alias (str): The alias to assign to the service.
+
+        Raises:
+            OrionisContainerException: If the original service is not registered.
+            ValueError: If the alias is not a valid string or is already in use.
+        """
+        # Validate alias type
+        if not isinstance(alias, str) or not alias:
+            raise ValueError("The alias must be a non-empty string.")
+
+        # Check if the original service is registered
+        if not self.has(abstract):
+            raise OrionisContainerException(f"The service '{abstract}' is not registered in the container.")
+
+        # Check if the alias is already in use
+        if alias in self._aliases:
+            raise ValueError(f"The alias '{alias}' is already in use.")
+
+        self._aliases[alias] = abstract
+
+    def make(self, abstract: str):
+        """Automatically resolves a dependency, handling instances, singletons, scoped, transients, and aliases.
+
+        This method resolves the dependencies of a service and handles the following service types:
+        1. **Instances**: Returns a specific instance.
+        2. **Singletons**: Returns the same unique instance each time.
+        3. **Scoped**: Returns a shared instance within the same request.
+        4. **Transients**: Creates a new instance each time.
+        5. **Aliases**: Resolves an alias to the original service.
+
+        Args:
+            abstract (str): Name or key of the service to resolve.
+
+        Returns:
+            Any: The resolved instance or service.
+
+        Raises:
+            OrionisContainerException: If the service is not found.
+        """
+        # If the service is a specific instance, return it directly
+        if abstract in self._instances:
+            return self._instances[abstract]
+
+        # If it is a singleton, return the same instance or resolve it if it is not yet resolved
+        if abstract in self._singletons:
+            if abstract not in self._instances:
+                self._instances[abstract] = self._resolve(self._singletons[abstract])
+            return self._instances[abstract]
+
+        # If it is a scoped service, validate that it is in the same request context
+        if abstract in self._scoped_services:
+            if abstract not in self._scoped_instances:
+                self._scoped_instances[abstract] = self._resolve(self._scoped_services[abstract])
+            return self._scoped_instances[abstract]
+
+        # If it is a transient service, create a new instance each time
+        if abstract in self._transients:
+            return self._resolve(self._transients[abstract])
+
+        # If it is a regular binding, resolve it directly
+        if abstract in self._bindings:
+            return self._resolve(self._bindings[abstract])
+
+        # If it is an alias, resolve the alias recursively
+        if abstract in self._aliases:
+            return self.make(self._aliases[abstract])
+
+        raise OrionisContainerValueError(f"No definition found for '{abstract}'. Ensure the service is registered.")
+
+    def _resolve(self, concrete: Callable[..., Any]):
+        """Automatically resolves the dependencies of a service, handling its constructor dependencies.
+
+        If the service is a class, it recursively resolves its dependencies (constructor parameters).
+
+        Args:
+            concrete (Callable[..., Any]): Concrete implementation of the service.
+
+        Returns:
+            Any: The resolved service instance.
+
+        Raises:
+            ValueError: If there is a constructor parameter whose type cannot be resolved.
+        """
+        if inspect.isclass(concrete):
+            constructor = inspect.signature(concrete.__init__)
+            parameters = constructor.parameters
+
+            # If the class has no parameters in its constructor, instantiate it directly
+            if len(parameters) == 0 or (len(parameters) == 1 and "self" in parameters):
+                return concrete()
+
+            dependencies = {}
+            for name, param in parameters.items():
+                if name == "self" or param.kind in (param.VAR_POSITIONAL, param.VAR_KEYWORD):
+                    continue
+
+                param_type = param.annotation
+                if param_type == param.empty:
+                    raise OrionisContainerValueError(f"Parameter type {name} not specified in {concrete.__name__}")
+
+                dep_name = param_type.__name__
+
+                # Conditional resolution of dependencies, if registered
+                if concrete in self._conditional_bindings and dep_name in self._conditional_bindings[concrete]:
+                    dependencies[name] = self.make(self._conditional_bindings[concrete][dep_name])
+                else:
+                    dependencies[name] = self.make(dep_name)
+
+            return concrete(**dependencies)
+
+        return concrete(self)
+
+    def startRequest(self):
+        """Starts a new request and clears the Scoped instances.
+
+        This method should be called at the beginning of each request to ensure that
+        scoped services do not persist between requests.
+        """
+        self._scoped_instances = {}

orionis-0.6.0/orionis/luminate/container/exception.py

@@ -0,0 +1,36 @@
+class OrionisContainerException(Exception):
+    """
+    Excepción personalizada para errores relacionados con el contenedor de inyección de dependencias Orionis.
+    """
+
+    def __init__(self, message: str) -> None:
+        """
+        Inicializa la excepción con un mensaje de error.
+
+        Args:
+            message (str): Mensaje descriptivo del error.
+        """
+        super().__init__(message)
+
+    def __str__(self) -> str:
+        """Retorna una representación en cadena de la excepción."""
+        return f"[OrionisContainerException] {self.args[0]}"
+
+
+class OrionisContainerValueError(ValueError):
+    """
+    Excepción personalizada para errores de tipo ValueError en el contenedor Orionis.
+    """
+
+    def __init__(self, message: str) -> None:
+        """
+        Inicializa la excepción con un mensaje de error.
+
+        Args:
+            message (str): Mensaje descriptivo del error.
+        """
+        super().__init__(message)
+
+    def __str__(self) -> str:
+        """Retorna una representación en cadena de la excepción."""
+        return f"[OrionisContainerValueError] {self.args[0]}"

{orionis-0.4.0 → orionis-0.6.0}/orionis/luminate/publisher/pypi.py

@@ -2,6 +2,7 @@ import os
 import sys
 import shutil
 import subprocess
+import time
 from orionis.framework import VERSION
 from orionis.luminate.console.output.console import Console
 from orionis.luminate.contracts.publisher.pypi_publisher_interface import IPypiPublisher
@@ -70,10 +71,17 @@ class PypiPublisher(IPypiPublisher):
         subprocess.CalledProcessError
             If any of the subprocess calls to Git fail.
         """
-        subprocess.run(
-            ["git", "rm", "-r", "--cached", "."], capture_output=True, text=True, cwd=self.project_root
+        result = subprocess.run(
+            ["git", "rm", "-r", "--cached", "."], capture_output=True, text=True, cwd=self.project_root, check=True
         )
 
+        # Verificamos si el comando fue exitoso
+        if result.returncode == 0:
+            Console.info("✅ Archivos removidos del índice con éxito")
+
+        # Añadimos un pequeño retraso para evitar problemas de sincronización
+        time.sleep(4)
+
         git_status = subprocess.run(
             ["git", "status", "--short"], capture_output=True, text=True, cwd=self.project_root
         )
@@ -159,6 +167,7 @@ class PypiPublisher(IPypiPublisher):
                 check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, cwd=self.project_root
             )
         except Exception as e:
+            print(e)
             Console.fail(f"🔴 Error loading the package. Try changing the version and retry. Error: {e}")
             Console.warning("⛔ If the issue persists, review the script in detail.")
             exit()

{orionis-0.4.0 → orionis-0.6.0}/orionis/luminate/test/exception.py

@@ -45,4 +45,4 @@ class OrionisTestFailureException(Exception):
         str
             A formatted string containing the exception name and response message.
         """
-        return f"OrionisTestFailureException: {self.response}"
+        return f"[OrionisTestFailureException]: {self.response}"

{orionis-0.4.0 → orionis-0.6.0/orionis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: orionis
-Version: 0.4.0
+Version: 0.6.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro
@@ -27,6 +27,8 @@ Dynamic: summary
 
 🚀 **Orionis Framework – Elegant, Fast, and Powerful** ⚡
 
+![Orionis Framework Logo](https://raw.githubusercontent.com/orionis-framework/framework/refs/heads/1.x/orionis/luminate/static/logos/OrionisFramework.png)
+
 🔬 **(Currently in Beta – Evolving Towards Perfection!)**
 
 ---

{orionis-0.4.0 → orionis-0.6.0}/orionis.egg-info/SOURCES.txt

@@ -62,6 +62,8 @@ orionis/luminate/console/scripts/__init__.py
 orionis/luminate/console/scripts/management.py
 orionis/luminate/console/tasks/__init__.py
 orionis/luminate/console/tasks/scheduler.py
+orionis/luminate/container/container.py
+orionis/luminate/container/exception.py
 orionis/luminate/contracts/__init__.py
 orionis/luminate/contracts/bootstrap/parser_interface.py
 orionis/luminate/contracts/cache/__init__.py
@@ -124,10 +126,13 @@ orionis/luminate/pipelines/__init__.py
 orionis/luminate/pipelines/cli_pipeline.py
 orionis/luminate/publisher/__init__.py
 orionis/luminate/publisher/pypi.py
+orionis/luminate/static/bg/galaxy.jpg
+orionis/luminate/static/favicon/OrionisFrameworkFavicon.png
 orionis/luminate/static/logos/OrionisFramework.jpg
 orionis/luminate/static/logos/OrionisFramework.png
 orionis/luminate/static/logos/OrionisFramework.psd
 orionis/luminate/static/logos/OrionisFramework2.png
+orionis/luminate/static/logos/OrionisFramework3.png
 orionis/luminate/test/__init__.py
 orionis/luminate/test/exception.py
 orionis/luminate/test/unit_test.py

orionis-0.4.0/orionis/framework.py

@@ -1,45 +0,0 @@
-#--------------------------------------------------------------------------
-# Name of the project or framework
-#--------------------------------------------------------------------------
-NAME = "orionis"
-
-#--------------------------------------------------------------------------
-# Current version of the project or framework
-#--------------------------------------------------------------------------
-VERSION = "0.4.0"
-
-#--------------------------------------------------------------------------
-# Full name of the author or maintainer of the project
-#--------------------------------------------------------------------------
-AUTHOR = "Raul Mauricio Uñate Castro"
-
-#--------------------------------------------------------------------------
-# Email address of the author or maintainer for contact purposes
-#--------------------------------------------------------------------------
-AUTHOR_EMAIL = "raulmauriciounate@gmail.com"
-
-#--------------------------------------------------------------------------
-# Short description of the project or framework
-#--------------------------------------------------------------------------
-DESCRIPTION = "Orionis Framework – Elegant, Fast, and Powerful."
-
-#--------------------------------------------------------------------------
-# URL to the project's skeleton or template repository
-# This is typically used for initial project setup
-#--------------------------------------------------------------------------
-SKELETON = "https://github.com/orionis-framework/skeleton"
-
-#--------------------------------------------------------------------------
-# URL to the project's framework repository
-#--------------------------------------------------------------------------
-FRAMEWORK = "https://github.com/orionis-framework/framework"
-
-#--------------------------------------------------------------------------
-# URL to the project's documentation
-#--------------------------------------------------------------------------
-DOCS = "https://github.com/orionis-framework/docs"
-
-#--------------------------------------------------------------------------
-# Minimum Python version required to run the project
-#--------------------------------------------------------------------------
-PYTHON_REQUIRES = ">=3.12"