orionis 0.308.0__tar.gz → 0.310.0__tar.gz

{orionis-0.308.0/orionis.egg-info → orionis-0.310.0}/PKG-INFO

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

orionis-0.310.0/orionis/container/container.py

@@ -0,0 +1,22 @@
+from typing import Any, Callable
+from orionis.container.enums.lifetimes import Lifetime
+from orionis.services.introspection.abstract.reflection_abstract import ReflectionAbstract
+
+
+class Container:
+
+    def transient(self, abstract: Callable[..., Any], concrete: Callable[..., Any]) -> None:
+        """
+        Registers a service with a transient lifetime.
+
+        Parameters
+        ----------
+        abstract : Callable[..., Any]
+            The abstract base type or alias to be bound.
+        concrete : Callable[..., Any]
+            The concrete implementation to associate with the abstract type.
+        """
+
+        ReflectionAbstract.ensureIsAbstractClass(abstract)
+
+        # self.bind(abstract, concrete, Lifetime.TRANSIENT)

orionis-0.310.0/orionis/container/enums/lifetimes.py

@@ -0,0 +1,8 @@
+from enum import Enum, auto
+
+class Lifetime(Enum):
+    """Defines the lifecycle types for dependency injection."""
+
+    TRANSIENT = auto()
+    SINGLETON = auto()
+    SCOPED = auto()

orionis-0.310.0/orionis/container/exceptions/container_exception.py

@@ -0,0 +1,17 @@
+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]}"

orionis-0.310.0/orionis/container/exceptions/type_error_exception.py

@@ -0,0 +1,17 @@
+class OrionisContainerTypeError(TypeError):
+    """
+    Custom exception for TypeError related to the Orionis container.
+    """
+
+    def __init__(self, message: str) -> None:
+        """
+        Initializes the exception with an error message.
+
+        Args:
+            message (str): Descriptive error message.
+        """
+        super().__init__(message)
+
+    def __str__(self) -> str:
+        """Returns a string representation of the exception."""
+        return f"[OrionisContainerTypeError] {self.args[0]}"

orionis-0.310.0/orionis/container/exceptions/value_exception.py

@@ -0,0 +1,17 @@
+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.308.0 → orionis-0.310.0}/orionis/foundation/config/testing/entities/testing.py

@@ -1,4 +1,4 @@
-from dataclasses import asdict, dataclass, field
+from dataclasses import asdict, dataclass, field, fields
 from typing import List
 from orionis.foundation.config.exceptions.integrity import OrionisIntegrityException
 from orionis.services.system.workers import Workers
@@ -51,7 +51,7 @@ class Testing:
         metadata={
             "description": "The maximum number of worker threads/processes to use when running tests in parallel. Default is 4.",
             "required": True,
-            "default": "Workers.calculate()"
+            "default": Workers().__class__
         }
     )
 
@@ -277,3 +277,24 @@ class Testing:
         """
         return asdict(self)
 
+    def getFields(self):
+        """
+        Retrieves a list of field information for the current dataclass instance.
+
+        Returns:
+            list: A list of dictionaries, each containing details about a field:
+                - name (str): The name of the field.
+                - type (type): The type of the field.
+                - default: The default value of the field, if specified; otherwise, the value from metadata or None.
+                - metadata (mapping): The metadata associated with the field.
+        """
+        __fields = []
+        for field in fields(self):
+            __metadata = dict(field.metadata) or {}
+            __fields.append({
+                "name": field.name,
+                "type": field.type.__name__ if hasattr(field.type, '__name__') else str(field.type),
+                "default": field.default if (field.default is not None and '_MISSING_TYPE' not in str(field.default)) else __metadata.get('default', None),
+                "metadata": __metadata
+            })
+        return __fields

{orionis-0.308.0 → orionis-0.310.0}/orionis/metadata/framework.py

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

{orionis-0.308.0 → orionis-0.310.0}/orionis/services/introspection/abstract/reflection_abstract.py

@@ -11,31 +11,40 @@ from orionis.services.introspection.exceptions.reflection_value_error import Ref
 
 class ReflectionAbstract(IReflectionAbstract):
 
-    def __init__(self, abstract: Type) -> None:
+    @staticmethod
+    def ensureIsAbstractClass(abstract: Type):
         """
-        Initializes the reflection class with the provided abstract base class (interface).
+        Ensures that the provided object is an abstract base class (interface).
 
         Parameters
         ----------
         abstract : Type
-            The abstract base class (interface) to be reflected upon.
+            The class to check.
 
         Raises
         ------
         ReflectionTypeError
-            If 'abstract' is not a class type.
-        ReflectionTypeError
-            If 'abstract' is not an abstract base class (interface).
+            If 'abstract' is not a class type or not an abstract base class.
         """
-
-        # Check if the provided abstract is a class type
         if not isinstance(abstract, type):
             raise ReflectionTypeError(f"Expected a class type for 'abstract', got {type(abstract).__name__!r}")
-
-        # Check if it's an abstract base class (interface)
         if not bool(getattr(abstract, '__abstractmethods__', False)):
             raise ReflectionTypeError(f"Provided class '{abstract.__name__}' is not an interface (abstract base class)")
+        return True
+
+    def __init__(self, abstract: Type) -> None:
+        """
+        Initializes the ReflectionAbstract instance with the given abstract class.
+        Args:
+            abstract (Type): The abstract base class (interface) to be reflected.
+        Raises:
+            TypeError: If the provided abstract is not an abstract base class.
+        """
+
+        # Ensure the provided abstract is an abstract base class (interface)
+        ReflectionAbstract.ensureIsAbstractClass(abstract)
 
+        # Set the abstract class as a private attribute
         self.__abstract = abstract
 
     def getClass(self) -> Type:

{orionis-0.308.0 → orionis-0.310.0}/orionis/test/logs/history.py

@@ -6,7 +6,7 @@ from typing import Dict, List, Optional, Tuple
 from orionis.services.environment.env import Env
 from orionis.test.exceptions.test_persistence_error import OrionisTestPersistenceError
 from orionis.test.exceptions.test_value_error import OrionisTestValueError
-from orionis.test.logs.contracts.history import ITestHistory
+from orionis.test.contracts.history import ITestHistory
 
 class TestHistory(ITestHistory):
 

{orionis-0.308.0 → orionis-0.310.0}/orionis/test/output/dumper.py

@@ -1,7 +1,7 @@
 import os
 import sys
 from orionis.test.exceptions.test_runtime_error import OrionisTestRuntimeError
-from orionis.test.output.contracts.dumper import ITestDumper
+from orionis.test.contracts.dumper import ITestDumper
 
 class TestDumper(ITestDumper):
     """

{orionis-0.308.0 → orionis-0.310.0}/orionis/test/suite/test_unit.py

@@ -25,7 +25,7 @@ from orionis.test.exceptions.test_failure_exception import OrionisTestFailureExc
 from orionis.test.exceptions.test_persistence_error import OrionisTestPersistenceError
 from orionis.test.exceptions.test_value_error import OrionisTestValueError
 from orionis.test.logs.history import TestHistory
-from orionis.test.suite.contracts.test_unit import IUnitTest
+from orionis.test.contracts.test_unit import IUnitTest
 from orionis.test.view.render import TestingResultRender
 
 class UnitTest(IUnitTest):

{orionis-0.308.0 → orionis-0.310.0}/orionis/test/test_suite.py

@@ -1,5 +1,6 @@
 import re
 from os import walk
+from dataclasses import fields
 from orionis.foundation.config.testing.entities.testing import Testing as Configuration
 from orionis.test.exceptions.test_config_exception import OrionisTestConfigException
 from orionis.test.suite.test_unit import UnitTest
@@ -28,7 +29,7 @@ class TestSuite:
         Returns the results of the executed test suite.
     """
 
-    def __init__(self, config:Configuration = None):
+    def __init__(self, config:Configuration = None, **kwargs):
         """
         Initializes the TestSuite with the provided configuration.
 
@@ -37,6 +38,26 @@ class TestSuite:
         config : Configuration, optional
             Configuration object specifying parameters for test suite execution. If not provided, a new Configuration instance is created.
         """
+
+        # Check if config is None and kwargs are provided
+        if config is None:
+
+            try:
+
+                # Attempt to create a Configuration instance with provided keyword arguments
+                config = Configuration(**kwargs)
+
+            except TypeError:
+
+                # If a TypeError occurs, it indicates that the provided arguments do not match the Configuration class
+                required_fields = []
+                for field in Configuration().getFields():
+                    required_fields.append(f"{field.get('name')} = (Type: {field.get('type')}, Default: {field.get('default')})")
+
+                # Raise an exception with a detailed message about the required fields
+                raise OrionisTestConfigException(f"The provided configuration is not valid. Please ensure it is an instance of the Configuration class or provide valid keyword arguments. \n{str("\n").join(required_fields)}]")
+
+        # Assign the configuration to the instance variable
         self.__config = config or Configuration()
 
     def run(self) -> 'UnitTest':

{orionis-0.308.0 → orionis-0.310.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.308.0 → orionis-0.310.0}/orionis.egg-info/SOURCES.txt

@@ -145,6 +145,11 @@ orionis/console/output/console.py
 orionis/console/output/executor.py
 orionis/console/output/progress_bar.py
 orionis/console/output/styles.py
+orionis/container/container.py
+orionis/container/enums/lifetimes.py
+orionis/container/exceptions/container_exception.py
+orionis/container/exceptions/type_error_exception.py
+orionis/container/exceptions/value_exception.py
 orionis/foundation/__init__.py
 orionis/foundation/config/__init__.py
 orionis/foundation/config/startup.py
@@ -164,8 +169,6 @@ orionis/foundation/config/cache/entities/file.py
 orionis/foundation/config/cache/entities/stores.py
 orionis/foundation/config/cache/enums/__init__.py
 orionis/foundation/config/cache/enums/drivers.py
-orionis/foundation/config/contracts/__init__.py
-orionis/foundation/config/contracts/config.py
 orionis/foundation/config/cors/__init__.py
 orionis/foundation/config/cors/entities/__init__.py
 orionis/foundation/config/cors/entities/cors.py
@@ -235,6 +238,8 @@ orionis/foundation/config/testing/entities/__init__.py
 orionis/foundation/config/testing/entities/testing.py
 orionis/foundation/config/testing/enums/__init__.py
 orionis/foundation/config/testing/enums/test_mode.py
+orionis/foundation/contracts/__init__.py
+orionis/foundation/contracts/config.py
 orionis/metadata/__init__.py
 orionis/metadata/framework.py
 orionis/metadata/package.py
@@ -324,6 +329,10 @@ orionis/test/cases/__init__.py
 orionis/test/cases/test_async.py
 orionis/test/cases/test_case.py
 orionis/test/cases/test_sync.py
+orionis/test/contracts/__init__.py
+orionis/test/contracts/dumper.py
+orionis/test/contracts/history.py
+orionis/test/contracts/test_unit.py
 orionis/test/entities/__init__.py
 orionis/test/entities/test_result.py
 orionis/test/enums/__init__.py
@@ -337,16 +346,10 @@ orionis/test/exceptions/test_runtime_error.py
 orionis/test/exceptions/test_value_error.py
 orionis/test/logs/__init__.py
 orionis/test/logs/history.py
-orionis/test/logs/contracts/__init__.py
-orionis/test/logs/contracts/history.py
 orionis/test/output/__init__.py
 orionis/test/output/dumper.py
-orionis/test/output/contracts/__init__.py
-orionis/test/output/contracts/dumper.py
 orionis/test/suite/__init__.py
 orionis/test/suite/test_unit.py
-orionis/test/suite/contracts/__init__.py
-orionis/test/suite/contracts/test_unit.py
 orionis/test/view/__init__.py
 orionis/test/view/render.py
 tests/__init__.py