orionis 0.413.0__tar.gz → 0.415.0__tar.gz

{orionis-0.413.0/orionis.egg-info → orionis-0.415.0}/PKG-INFO

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

{orionis-0.413.0 → orionis-0.415.0}/orionis/metadata/framework.py

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

orionis-0.415.0/orionis/support/entities/base.py

@@ -0,0 +1,123 @@
+from dataclasses import asdict, fields, is_dataclass, MISSING
+from enum import Enum
+
+class BaseEntity:
+
+    def toDict(self) -> dict:
+        """
+        Converts the current dataclass instance into a dictionary.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        dict
+            A dictionary containing all fields of the instance, with field names as keys and their corresponding values.
+
+        Notes
+        -----
+        This method uses `dataclasses.asdict` to recursively convert the dataclass instance and any nested dataclasses into dictionaries.
+        Enum values are preserved as their actual values.
+        """
+
+        # Use asdict to convert the dataclass instance to a dictionary, including nested dataclasses
+        return asdict(self)
+
+    def getFields(self):
+        """
+        Retrieves detailed information about each field in the current dataclass instance.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        list of dict
+            Each dictionary in the returned list contains:
+                - name (str): The name of the field.
+                - types (list of str): The type(s) of the field, represented as a list of type names.
+                - default: The default value of the field, resolved from the field definition, default factory, or metadata.
+                - metadata (dict): The metadata associated with the field.
+
+        Notes
+        -----
+        - Handles complex field types, including unions and generics, by representing them as lists of type names.
+        - Resolves default values from direct assignment, default factories, or metadata, and normalizes dataclass and Enum values.
+        - Metadata defaults are normalized if present and callable or dataclass/Enum types.
+        """
+
+        # List to hold field information dictionaries
+        __fields = []
+
+        # Iterate over all fields defined in the dataclass
+        for field in fields(self):
+
+            # Extract the field name
+            __name = field.name
+
+            # Attempt to get the type name; handles simple types
+            __type = getattr(field.type, '__name__', None)
+
+            # If type name is not available, handle complex types (e.g., Unions)
+            if __type is None:
+                type_lst = []
+                type_str = str(field.type).split('|')
+                for itype in type_str:
+                    type_lst.append(itype.strip())
+                __type = type_lst
+
+            # Ensure __type is always a list for consistency
+            __type = type_lst if isinstance(__type, list) else [__type]
+
+            # Extract metadata as a dictionary
+            metadata = dict(field.metadata) if field.metadata else {}
+
+            # Normalize default value in metadata if present
+            if 'default' in metadata:
+                metadata_default = metadata['default']
+                if callable(metadata_default):
+                    metadata_default = metadata_default()
+                if is_dataclass(metadata_default):
+                    metadata_default = asdict(metadata_default)
+                elif isinstance(metadata_default, Enum):
+                    metadata_default = metadata_default.value
+                metadata['default'] = metadata_default
+
+            __metadata = metadata
+
+            # Initialize default value
+            __default = None
+
+            # Resolve default value from field definition
+            if field.default is not MISSING:
+                __default = field.default() if callable(field.default) else field.default
+                if is_dataclass(__default):
+                    __default = asdict(__default)
+                elif isinstance(__default, Enum):
+                    __default = __default.value
+
+            # Resolve default value from default factory if present
+            elif field.default_factory is not MISSING:
+                __default = field.default_factory() if callable(field.default_factory) else field.default_factory
+                if is_dataclass(__default):
+                    __default = asdict(__default)
+                elif isinstance(__default, Enum):
+                    __default = __default.value
+
+            # If no default found, check metadata for custom default
+            else:
+                __default = __metadata.get('default', None)
+
+            # Append the field information dictionary to the list
+            __fields.append({
+                "name": __name,
+                "types": __type,
+                "default": __default,
+                "metadata": __metadata
+            })
+
+        # Return the list of field information dictionaries
+        return __fields

orionis-0.415.0/orionis/support/facades/console.py

@@ -0,0 +1,21 @@
+from orionis.container.facades.facade import Facade
+
+class Console(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls) -> str:
+        """
+        Returns the service container binding key used to resolve the console component.
+
+        This method provides the unique string identifier that the service container uses
+        to locate and instantiate the console service. It is typically used internally
+        by the Facade base class to delegate calls to the underlying implementation.
+
+        Returns
+        -------
+        str
+            The string key `"core.orionis.console"` that identifies the console service in the container.
+        """
+
+        # Return the binding key for the console service in the container
+        return "core.orionis.console"

orionis-0.415.0/orionis/support/facades/dumper.py

@@ -0,0 +1,21 @@
+from orionis.container.facades.facade import Facade
+
+class Dumper(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls) -> str:
+        """
+        Returns the binding key used to retrieve the dumper component from the service container.
+
+        This method provides the unique string identifier that the service container uses to resolve
+        and return the dumper service instance. It is typically used internally by the Facade base class
+        to access the underlying implementation.
+
+        Returns
+        -------
+        str
+            The string "core.orionis.dumper", which is the service container binding key for the dumper component.
+        """
+
+        # Return the service container binding key for the dumper component
+        return "core.orionis.dumper"

orionis-0.415.0/orionis/support/facades/logger.py

@@ -0,0 +1,22 @@
+from orionis.container.facades.facade import Facade
+
+class Log(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls) -> str:
+        """
+        Returns the binding key used to resolve the logger service from the service container.
+
+        This method provides the unique identifier required by the service container to retrieve
+        the logger component. It is used internally by the Facade base class to delegate calls
+        to the appropriate service implementation.
+
+        Returns
+        -------
+        str
+            The binding key for the logger service in the service container, specifically
+            "core.orionis.logger".
+        """
+
+        # Return the service container binding key for the logger component
+        return "core.orionis.logger"

orionis-0.415.0/orionis/support/facades/path_resolver.py

@@ -0,0 +1,22 @@
+from orionis.container.facades.facade import Facade
+
+class PathResolver(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls):
+        """
+        Returns the service container binding key used to resolve the path resolver component.
+
+        This method provides the unique string identifier that the service container uses
+        to locate and retrieve the path resolver service. It is typically used internally
+        by the facade mechanism to delegate calls to the appropriate underlying implementation.
+
+        Returns
+        -------
+        str
+            The string key "core.orionis.path_resolver" that identifies the path resolver
+            service in the container.
+        """
+
+        # Return the binding key for the path resolver service in the container
+        return "core.orionis.path_resolver"

orionis-0.415.0/orionis/support/facades/progress_bar.py

@@ -0,0 +1,22 @@
+from orionis.container.facades.facade import Facade
+
+class ProgressBar(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls):
+        """
+        Returns the binding key used to retrieve the progress bar service from the service container.
+
+        This method provides the unique string identifier that the service container uses to resolve
+        the progress bar component. It is typically used internally by the Facade system to access
+        the underlying implementation.
+
+        Returns
+        -------
+        str
+            The binding key for the progress bar service in the service container, specifically
+            "core.orionis.progress_bar".
+        """
+
+        # Return the service container binding key for the progress bar component
+        return "core.orionis.progress_bar"

orionis-0.415.0/orionis/support/facades/testing.py

@@ -0,0 +1,22 @@
+from orionis.container.facades.facade import Facade
+
+class Test(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls) -> str:
+        """
+        Returns the service container binding key for the testing component.
+
+        This method provides the unique string identifier used by the service container
+        to resolve the testing component. It is typically used internally by the Facade
+        system to retrieve the correct implementation from the container.
+
+        Returns
+        -------
+        str
+            The string key "core.orionis.testing" that identifies the testing component
+            in the service container.
+        """
+
+        # Return the binding key for the testing component in the service container
+        return "core.orionis.testing"

orionis-0.415.0/orionis/support/facades/workers.py

@@ -0,0 +1,22 @@
+from orionis.container.facades.facade import Facade
+
+class Workers(Facade):
+
+    @classmethod
+    def getFacadeAccessor(cls):
+        """
+        Returns the service container binding key for the workers component.
+
+        This method provides the unique string identifier used by the service container
+        to resolve the workers service. It is typically used internally by the Facade
+        mechanism to access the underlying implementation.
+
+        Returns
+        -------
+        str
+            The string key "core.orionis.workers" that identifies the workers service
+            in the service container.
+        """
+
+        # Return the binding key for the workers service in the container
+        return "core.orionis.workers"

{orionis-0.413.0 → orionis-0.415.0}/orionis/test/core/unit_test.py

@@ -1,6 +1,5 @@
 import io
 import json
-import os
 import re
 import time
 import traceback
@@ -316,9 +315,27 @@ class UnitTest(IUnitTest):
             tests = self.__loader.discover(
                 start_dir=str(full_path),
                 pattern=self.__pattern,
-                top_level_dir=None
+                top_level_dir="."
             )
 
+            # Check for failed test imports (unittest.loader._FailedTest)
+            for test in self.__flattenTestSuite(tests):
+                if test.__class__.__name__ == "_FailedTest":
+                    # Extract the error message from the test's traceback
+                    error_message = ""
+                    if hasattr(test, "_exception"):
+                        error_message = str(test._exception)
+                    elif hasattr(test, "_outcome") and hasattr(test._outcome, "errors"):
+                        error_message = str(test._outcome.errors)
+                    else:
+                        # Try to get error from test id or str(test)
+                        error_message = str(test)
+                    raise OrionisTestValueError(
+                        f"Failed to import test module: {test.id()}.\n"
+                        f"Error details: {error_message}\n"
+                        "Please check for import errors or missing dependencies."
+                    )
+
             # If name pattern is provided, filter tests by name
             if test_name_pattern:
                 tests = self.__filterTestsByName(
@@ -365,6 +382,7 @@ class UnitTest(IUnitTest):
                 f"Error importing tests from path '{str(full_path)}': {str(e)}.\n"
                 "Please verify that the directory and test modules are accessible and correct."
             )
+
         except Exception as e:
 
             # Raise a general error for unexpected issues
@@ -700,6 +718,11 @@ class UnitTest(IUnitTest):
         # Iterate through all test cases in the original (possibly nested) suite
         for test_case in self.__flattenTestSuite(self.__suite):
 
+            # If it's a failed test, add it as-is to the flattened suite
+            if test_case.__class__.__name__ == "_FailedTest":
+                flattened_suite.addTest(test_case)
+                continue
+
             # Get the test method name using reflection
             rf_instance = ReflectionInstance(test_case)
             method_name = rf_instance.getAttribute("_testMethodName")
@@ -730,14 +753,7 @@ class UnitTest(IUnitTest):
                 continue
 
             # Attempt to extract dependency information from the test method signature
-            try:
-                signature = rf_instance.getMethodDependencies(method_name)
-            except Exception as e:
-                raise OrionisTestValueError(
-                    f"Failed to resolve test dependencies in '../{method_name}.py. "
-                    f"This may be caused by incorrect imports, missing modules, or undefined classes. "
-                    f"Please verify that all test methods and their dependencies are correctly declared and accessible."
-                )
+            signature = rf_instance.getMethodDependencies(method_name)
 
             # If there are no dependencies to resolve, or unresolved dependencies exist, add as-is
             if ((not signature.resolved and not signature.unresolved) or (not signature.resolved and len(signature.unresolved) > 0)):

{orionis-0.413.0 → orionis-0.415.0}/orionis/test/output/dumper.py

@@ -66,7 +66,7 @@ class TestDumper(ITestDumper):
                     SyncTestCase,
                     unittest.TestCase,
                     unittest.IsolatedAsyncioTestCase
-                ),
+                )
             )
 
         except Exception:

{orionis-0.413.0 → orionis-0.415.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.413.0 → orionis-0.415.0}/orionis.egg-info/SOURCES.txt

@@ -2,6 +2,61 @@ LICENCE
 MANIFEST.in
 README.md
 setup.py
+environment/__init__.py
+environment/test_services_environment.py
+foundation/__init__.py
+foundation/config/__init__.py
+foundation/config/app/__init__.py
+foundation/config/app/test_foundation_config_app.py
+foundation/config/auth/__init__.py
+foundation/config/auth/test_foundation_config_auth.py
+foundation/config/cache/__init__.py
+foundation/config/cache/test_foundation_config_cache.py
+foundation/config/cache/test_foundation_config_cache_file.py
+foundation/config/cache/test_foundation_config_cache_stores.py
+foundation/config/cors/__init__.py
+foundation/config/cors/test_foundation_config_cors.py
+foundation/config/database/__init__.py
+foundation/config/database/test_foundation_config_database.py
+foundation/config/database/test_foundation_config_database_connections.py
+foundation/config/database/test_foundation_config_database_mysql.py
+foundation/config/database/test_foundation_config_database_oracle.py
+foundation/config/database/test_foundation_config_database_pgsql.py
+foundation/config/database/test_foundation_config_database_sqlite.py
+foundation/config/filesystems/__init__.py
+foundation/config/filesystems/test_foundation_config_filesystems.py
+foundation/config/filesystems/test_foundation_config_filesystems_aws.py
+foundation/config/filesystems/test_foundation_config_filesystems_disks.py
+foundation/config/filesystems/test_foundation_config_filesystems_local.py
+foundation/config/filesystems/test_foundation_config_filesystems_public.py
+foundation/config/logging/__init__.py
+foundation/config/logging/test_foundation_config_logging.py
+foundation/config/logging/test_foundation_config_logging_channels.py
+foundation/config/logging/test_foundation_config_logging_chunked.py
+foundation/config/logging/test_foundation_config_logging_daily.py
+foundation/config/logging/test_foundation_config_logging_hourly.py
+foundation/config/logging/test_foundation_config_logging_monthly.py
+foundation/config/logging/test_foundation_config_logging_stack.py
+foundation/config/logging/test_foundation_config_logging_weekly.py
+foundation/config/mail/__init__.py
+foundation/config/mail/test_foundation_config_mail.py
+foundation/config/mail/test_foundation_config_mail_file.py
+foundation/config/mail/test_foundation_config_mail_mailers.py
+foundation/config/mail/test_foundation_config_mail_smtp.py
+foundation/config/queue/__init__.py
+foundation/config/queue/test_foundation_config_queue.py
+foundation/config/queue/test_foundation_config_queue_brokers.py
+foundation/config/queue/test_foundation_config_queue_database.py
+foundation/config/root/__init__.py
+foundation/config/root/test_foundation_config_root_paths.py
+foundation/config/session/__init__.py
+foundation/config/session/test_foundation_config_session.py
+foundation/config/startup/__init__.py
+foundation/config/startup/test_foundation_config_startup.py
+foundation/config/testing/__init__.py
+foundation/config/testing/test_foundation_config_testing.py
+foundation/exceptions/__init__.py
+foundation/exceptions/test_foundation_config_exceptions.py
 orionis/__init__.py
 orionis.egg-info/PKG-INFO
 orionis.egg-info/SOURCES.txt
@@ -471,67 +526,12 @@ tests/container/validators/test_is_valid_alias.py
 tests/container/validators/test_lifetime.py
 tests/example/__init__.py
 tests/example/test_example.py
-tests/foundation/__init__.py
-tests/foundation/config/__init__.py
-tests/foundation/config/app/__init__.py
-tests/foundation/config/app/test_foundation_config_app.py
-tests/foundation/config/auth/__init__.py
-tests/foundation/config/auth/test_foundation_config_auth.py
-tests/foundation/config/cache/__init__.py
-tests/foundation/config/cache/test_foundation_config_cache.py
-tests/foundation/config/cache/test_foundation_config_cache_file.py
-tests/foundation/config/cache/test_foundation_config_cache_stores.py
-tests/foundation/config/cors/__init__.py
-tests/foundation/config/cors/test_foundation_config_cors.py
-tests/foundation/config/database/__init__.py
-tests/foundation/config/database/test_foundation_config_database.py
-tests/foundation/config/database/test_foundation_config_database_connections.py
-tests/foundation/config/database/test_foundation_config_database_mysql.py
-tests/foundation/config/database/test_foundation_config_database_oracle.py
-tests/foundation/config/database/test_foundation_config_database_pgsql.py
-tests/foundation/config/database/test_foundation_config_database_sqlite.py
-tests/foundation/config/filesystems/__init__.py
-tests/foundation/config/filesystems/test_foundation_config_filesystems.py
-tests/foundation/config/filesystems/test_foundation_config_filesystems_aws.py
-tests/foundation/config/filesystems/test_foundation_config_filesystems_disks.py
-tests/foundation/config/filesystems/test_foundation_config_filesystems_local.py
-tests/foundation/config/filesystems/test_foundation_config_filesystems_public.py
-tests/foundation/config/logging/__init__.py
-tests/foundation/config/logging/test_foundation_config_logging.py
-tests/foundation/config/logging/test_foundation_config_logging_channels.py
-tests/foundation/config/logging/test_foundation_config_logging_chunked.py
-tests/foundation/config/logging/test_foundation_config_logging_daily.py
-tests/foundation/config/logging/test_foundation_config_logging_hourly.py
-tests/foundation/config/logging/test_foundation_config_logging_monthly.py
-tests/foundation/config/logging/test_foundation_config_logging_stack.py
-tests/foundation/config/logging/test_foundation_config_logging_weekly.py
-tests/foundation/config/mail/__init__.py
-tests/foundation/config/mail/test_foundation_config_mail.py
-tests/foundation/config/mail/test_foundation_config_mail_file.py
-tests/foundation/config/mail/test_foundation_config_mail_mailers.py
-tests/foundation/config/mail/test_foundation_config_mail_smtp.py
-tests/foundation/config/queue/__init__.py
-tests/foundation/config/queue/test_foundation_config_queue.py
-tests/foundation/config/queue/test_foundation_config_queue_brokers.py
-tests/foundation/config/queue/test_foundation_config_queue_database.py
-tests/foundation/config/root/__init__.py
-tests/foundation/config/root/test_foundation_config_root_paths.py
-tests/foundation/config/session/__init__.py
-tests/foundation/config/session/test_foundation_config_session.py
-tests/foundation/config/startup/__init__.py
-tests/foundation/config/startup/test_foundation_config_startup.py
-tests/foundation/config/testing/__init__.py
-tests/foundation/config/testing/test_foundation_config_testing.py
-tests/foundation/exceptions/__init__.py
-tests/foundation/exceptions/test_foundation_config_exceptions.py
 tests/metadata/__init__.py
 tests/metadata/test_metadata_framework.py
 tests/metadata/test_metadata_package.py
 tests/services/__init__.py
 tests/services/asynchrony/__init__.py
 tests/services/asynchrony/test_services_asynchrony_coroutine.py
-tests/services/environment/__init__.py
-tests/services/environment/test_services_environment.py
 tests/services/introspection/__init__.py
 tests/services/introspection/test_reflection.py
 tests/services/introspection/dependencies/__init__.py
@@ -556,6 +556,9 @@ tests/services/system/__init__.py
 tests/services/system/test_services_system_imports.py
 tests/services/system/test_services_system_workers.py
 tests/support/__init__.py
+tests/support/entities/__init__.py
+tests/support/entities/mock_dataclass.py
+tests/support/entities/test_base.py
 tests/support/patterns/__init__.py
 tests/support/patterns/singleton/__init__.py
 tests/support/patterns/singleton/test_patterns_singleton.py
@@ -564,5 +567,14 @@ tests/support/standard/test_services_std.py
 tests/support/wrapper/__init__.py
 tests/support/wrapper/test_services_wrapper_docdict.py
 tests/testing/__init__.py
-tests/testing/test_testing_result.py
-tests/testing/test_testing_unit.py
+tests/testing/test_testing_unit.py
+tests/testing/cases/__init__.py
+tests/testing/cases/test_testing_asynchronous.py
+tests/testing/cases/test_testing_synchronous.py
+tests/testing/entities/__init__.py
+tests/testing/entities/test_testing_result.py
+tests/testing/enums/__init__.py
+tests/testing/enums/test_testing_status.py
+tests/testing/output/__init__.py
+tests/testing/output/test_testing_dumper.py
+tests/testing/output/test_testing_printer.py

orionis-0.415.0/orionis.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+environment
+foundation
+orionis
+tests

{orionis-0.413.0 → orionis-0.415.0}/tests/container/entities/test_binding.py

@@ -3,7 +3,7 @@ from orionis.container.enums.lifetimes import Lifetime
 from orionis.container.exceptions.type import OrionisContainerTypeError
 from orionis.test.cases.asynchronous import AsyncTestCase
 
-class TestBinding(AsyncTestCase):
+class TestEntities(AsyncTestCase):
 
     async def testBindingInitialization(self):
         """

{orionis-0.413.0 → orionis-0.415.0}/tests/container/test_thread_safety.py

@@ -1,4 +1,3 @@
-import threading
 import time
 import random
 from concurrent.futures import ThreadPoolExecutor, as_completed

orionis-0.415.0/tests/support/entities/mock_dataclass.py

@@ -0,0 +1,34 @@
+from dataclasses import dataclass, field
+from enum import Enum
+from orionis.support.entities.base import BaseEntity
+
+class Color(Enum):
+    """Enumeration for available colors."""
+    RED = 1
+    GREEN = 2
+
+@dataclass
+class ExampleEntity(BaseEntity):
+    """
+    Example entity representing a data structure with id, name, color, and tags.
+
+    Attributes
+    ----------
+    id : int
+        Unique identifier for the entity.
+    name : str
+        Name of the entity.
+    color : Color
+        Color associated with the entity.
+    tags : list
+        List of tags associated with the entity.
+
+    Returns
+    -------
+    ExampleEntity
+        An instance of ExampleEntity with specified attributes.
+    """
+    id: int = 0  # Default id is 0
+    name: str = "default"  # Default name is 'default'
+    color: Color = Color.RED  # Default color is RED
+    tags: list = field(default_factory=list, metadata={"default": ["tag1", "tag2"]})  # Default tags list