orionis 0.252.0__tar.gz → 0.254.0__tar.gz

{orionis-0.252.0/orionis.egg-info → orionis-0.254.0}/PKG-INFO

@@ -1,10 +1,11 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: orionis
-Version: 0.252.0
+Version: 0.254.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro
 Author-email: raulmauriciounate@gmail.com
+Keywords: orionis,framework,python,orionis-framework,django,flask,fastapi,starlettewerkzeuguvicorn
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -23,6 +24,8 @@ Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary

orionis-0.254.0/orionis/application.py

@@ -0,0 +1,6 @@
+from orionis.luminate.app import Orionis as Application, Configuration
+
+__all__ = [
+    "Application",
+    "Configuration"
+]

{orionis-0.252.0 → orionis-0.254.0}/orionis/framework.py

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

orionis-0.254.0/orionis/importscan.py

@@ -0,0 +1,46 @@
+"""
+This module overrides Python's built-in import mechanism to track and log
+the number of times modules from the 'orionis' package are imported.
+It prints a message each time such a module is imported, including the import count
+and the fromlist used.
+
+Usage:
+    Simply import this module at the start of your application to enable tracking.
+"""
+
+import builtins
+from collections import defaultdict
+from threading import Lock
+
+# Store the original __import__ function
+_original_import = builtins.__import__
+
+# Dictionary to count imports per module
+_import_count = defaultdict(int)
+
+# Lock to ensure thread safety
+_import_lock = Lock()
+
+def custom_import(name, globals=None, locals=None, fromlist=(), level=0):
+    """
+    Custom import function that tracks imports of 'orionis' modules.
+
+    Args:
+        name (str): The name of the module to import.
+        globals (dict, optional): The global namespace.
+        locals (dict, optional): The local namespace.
+        fromlist (tuple, optional): Names to import from the module.
+        level (int, optional): Relative import level.
+
+    Returns:
+        The imported module.
+    """
+    if str(name).startswith("orionis"):
+        with _import_lock:
+            _import_count[name] += 1
+            count = _import_count[name]
+        print(f"[{str(count).zfill(4)} Imports] -> {name} | fromlist={fromlist}")
+    return _original_import(name, globals, locals, fromlist, level)
+
+# Override the built-in __import__ function
+builtins.__import__ = custom_import

orionis-0.252.0/orionis/luminate/application.py → orionis-0.254.0/orionis/luminate/_application.py

@@ -1,14 +1,14 @@
 from typing import Dict, List, Type
-from orionis.luminate.contracts.application import IApplication
-from orionis.luminate.contracts.container.container import IContainer
-from orionis.luminate.contracts.foundation.bootstraper import IBootstrapper
-from orionis.luminate.contracts.providers.service_provider import IServiceProvider
-from orionis.luminate.container.container import Container
-from orionis.luminate.foundation.config.config_bootstrapper import ConfigBootstrapper
-from orionis.luminate.foundation.console.command_bootstrapper import CommandsBootstrapper
-from orionis.luminate.foundation.environment.environment_bootstrapper import EnvironmentBootstrapper
-from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
-from orionis.luminate.foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
+from orionis.luminate._contracts.application import IApplication
+from orionis.luminate._contracts.container.container import IContainer
+from orionis.luminate._contracts.foundation.bootstraper import IBootstrapper
+from orionis.luminate._contracts.providers.service_provider import IServiceProvider
+from orionis.luminate._container.container import Container
+from orionis.luminate._foundation.config.config_bootstrapper import ConfigBootstrapper
+from orionis.luminate._foundation.console.command_bootstrapper import CommandsBootstrapper
+from orionis.luminate._foundation.environment.environment_bootstrapper import EnvironmentBootstrapper
+from orionis.luminate._foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate._foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
 from orionis.luminate.support.patterns.singleton import SingletonMeta
 
 class Application(metaclass=SingletonMeta):

{orionis-0.252.0/orionis/luminate/container → orionis-0.254.0/orionis/luminate/_container}/container.py

@@ -2,10 +2,10 @@ import inspect
 from threading import Lock
 from typing import Callable, Any, Dict, Deque, Optional, Type, get_origin, get_args
 from collections import deque
-from orionis.luminate.container.container_integrity import ContainerIntegrity
-from orionis.luminate.container.lifetimes import Lifetime
-from orionis.luminate.container.exception import OrionisContainerException, OrionisContainerValueError, OrionisContainerTypeError
-from orionis.luminate.contracts.container.container import IContainer
+from orionis.luminate._container.container_integrity import ContainerIntegrity
+from orionis.luminate._container.lifetimes import Lifetime
+from orionis.luminate._container.exception import OrionisContainerException, OrionisContainerValueError, OrionisContainerTypeError
+from orionis.luminate._contracts.container.container import IContainer
 
 class Container(IContainer):
     """

{orionis-0.252.0/orionis/luminate/support/introspection → orionis-0.254.0/orionis/luminate/_container}/container_integrity.py

@@ -2,8 +2,8 @@ import re
 import inspect
 from abc import ABC
 from typing import Any, Callable, Set, Type
-from orionis.luminate.container.exception import OrionisContainerValueError, OrionisContainerTypeError
-from orionis.luminate.contracts.container.container_integrity import IContainerIntegrity
+from orionis.luminate._container.exception import OrionisContainerValueError, OrionisContainerTypeError
+from orionis.luminate._contracts.container.container_integrity import IContainerIntegrity
 
 class ContainerIntegrity(IContainerIntegrity):
 

{orionis-0.252.0/orionis/luminate/container → orionis-0.254.0/orionis/luminate/_container}/resolve.py

@@ -1,6 +1,6 @@
 from typing import Any, Callable
-from orionis.luminate.container.container import Container
-from orionis.luminate.container.exception import OrionisContainerValueError
+from orionis.luminate._container.container import Container
+from orionis.luminate._container.exception import OrionisContainerValueError
 
 class Resolve:
     """

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/application.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
 from typing import List, Type
-from orionis.luminate.contracts.container.container import IContainer
-from orionis.luminate.contracts.providers.service_provider import IServiceProvider
+from orionis.luminate._contracts.container.container import IContainer
+from orionis.luminate._contracts.providers.service_provider import IServiceProvider
 
 class IApplication(ABC):
     """

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/console/task_manager.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from orionis.luminate.facades.commands.scheduler_facade import Schedule
+from orionis.luminate._facades.commands.scheduler_facade import Schedule
 
 class ITaskManager(ABC):
     """

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/facades/commands/scheduler_facade.py

@@ -1,6 +1,6 @@
 from abc import ABC, abstractmethod
 from typing import Any
-from orionis.luminate.services_.commands.scheduler_service import ScheduleService
+from orionis.luminate._services.commands.scheduler_service import ScheduleService
 
 class ISchedule(ABC):
 

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/facades/facade.py

@@ -1,4 +1,4 @@
-from orionis.luminate.container.container import Container
+from orionis.luminate._container.container import Container
 from orionis.luminate.support.async.async_io import AsyncExecutor
 
 class FacadeMeta(type):

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/foundation/providers/service_providers_bootstrapper.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
 from typing import List, Type
-from orionis.luminate.contracts.providers.service_provider import IServiceProvider
-from orionis.luminate.providers.service_provider import ServiceProvider
+from orionis.luminate._contracts.providers.service_provider import IServiceProvider
+from orionis.luminate._providers.service_provider import ServiceProvider
 
 class IServiceProvidersBootstrapper(ABC):
 

{orionis-0.252.0/orionis/luminate/contracts → orionis-0.254.0/orionis/luminate/_contracts}/providers/service_provider.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from orionis.luminate.container.container import Container
+from orionis.luminate._container.container import Container
 
 class IServiceProvider(ABC):
 

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/app_facade.py

@@ -1,6 +1,6 @@
 from typing import Any
-from orionis.luminate.application import Application
-from orionis.luminate.container.resolve import Resolve
+from orionis.luminate._application import Application
+from orionis.luminate._container.resolve import Resolve
 
 def app(abstract: Any = None) -> Any:
     """

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/commands/commands_facade.py

@@ -1,7 +1,7 @@
 from typing import Any
-from orionis.luminate.contracts.facades.commands.commands_facade import ICommand
-from orionis.luminate.contracts.services.commands.reactor_commands_service import IReactorCommandsService
-from orionis.luminate.facades.app_facade import app
+from orionis.luminate._contracts.facades.commands.commands_facade import ICommand
+from orionis.luminate._contracts.services.commands.reactor_commands_service import IReactorCommandsService
+from orionis.luminate._facades.app_facade import app
 
 class Command(ICommand):
     """

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/commands/scheduler_facade.py

@@ -1,7 +1,7 @@
 from typing import Any
-from orionis.luminate.contracts.facades.commands.scheduler_facade import ISchedule
-from orionis.luminate.contracts.services.commands.schedule_service import IScheduleService
-from orionis.luminate.facades.app_facade import app
+from orionis.luminate._contracts.facades.commands.scheduler_facade import ISchedule
+from orionis.luminate._contracts.services.commands.schedule_service import IScheduleService
+from orionis.luminate._facades.app_facade import app
 
 class Schedule(ISchedule):
 

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/config/config_facade.py

@@ -1,7 +1,7 @@
 from typing import Any, Optional
-from orionis.luminate.contracts.facades.config.config_facade import IConfig
-from orionis.luminate.contracts.services.config.config_service import IConfigService
-from orionis.luminate.facades.app_facade import app
+from orionis.luminate._contracts.facades.config.config_facade import IConfig
+from orionis.luminate._contracts.services.config.config_service import IConfigService
+from orionis.luminate._facades.app_facade import app
 
 class Config(IConfig):
 

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/environment/environment_facade.py

@@ -1,6 +1,6 @@
-from orionis.luminate.contracts.facades.environment.environment_facade import IEnv
-from orionis.luminate.contracts.services.environment.environment_service import IEnvironmentService
-from orionis.luminate.facades.app_facade import app
+from orionis.luminate._contracts.facades.environment.environment_facade import IEnv
+from orionis.luminate._contracts.services.environment.environment_service import IEnvironmentService
+from orionis.luminate._facades.app_facade import app
 
 class Env(IEnv):
 

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/files/path_facade.py

@@ -1,7 +1,7 @@
 import os
-from orionis.luminate.contracts.facades.files.path_facade import IPath
-from orionis.luminate.contracts.services.files.path_resolver_service import IPathResolverService
-from orionis.luminate.services_.files.path_resolver_service import PathResolverService
+from orionis.luminate._contracts.facades.files.path_facade import IPath
+from orionis.luminate._contracts.services.files.path_resolver_service import IPathResolverService
+from orionis.luminate._services.files.path_resolver_service import PathResolverService
 
 class Path(IPath):
     """

{orionis-0.252.0/orionis/luminate/facades → orionis-0.254.0/orionis/luminate/_facades}/log/log_facade.py

@@ -1,5 +1,5 @@
-from orionis.luminate.contracts.facades.facade import Facade
-from orionis.luminate.contracts.services.log.log_service import ILogguerService
+from orionis.luminate._contracts.facades.facade import Facade
+from orionis.luminate._contracts.services.log.log_service import ILogguerService
 
 class Log(Facade):
     """

{orionis-0.252.0/orionis/luminate/foundation → orionis-0.254.0/orionis/luminate/_foundation}/console/command_bootstrapper.py

@@ -2,8 +2,8 @@ import pathlib
 import importlib
 import inspect
 from typing import Any, Callable, Dict, List
-from orionis.luminate.contracts.foundation.console.command_bootstrapper import ICommandsBootstrapper
-from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate._contracts.foundation.console.command_bootstrapper import ICommandsBootstrapper
+from orionis.luminate._foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 from orionis.luminate.console.base.command import BaseCommand
 
 class CommandsBootstrapper(ICommandsBootstrapper):

{orionis-0.252.0/orionis/luminate/foundation → orionis-0.254.0/orionis/luminate/_foundation}/environment/environment_bootstrapper.py

@@ -1,5 +1,5 @@
 from typing import Dict
-from orionis.luminate.contracts.foundation.environment.environment_bootstrapper import IEnvironmentBootstrapper
+from orionis.luminate._contracts.foundation.environment.environment_bootstrapper import IEnvironmentBootstrapper
 from orionis.luminate.support.environment.env import Env
 # from orionis.luminate.services.environment.environment_service import EnvironmentService
 

{orionis-0.252.0/orionis/luminate → orionis-0.254.0/orionis/luminate/_foundation}/foundation/config/config_bootstrapper.py

@@ -2,9 +2,9 @@ import importlib
 import pathlib
 from dataclasses import asdict
 from typing import Any, Dict
-from orionis.luminate.contracts.foundation.config.config_bootstrapper import IConfigBootstrapper
-from orionis.luminate.contracts.config.config import IConfig
-from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate._contracts.foundation.config.config_bootstrapper import IConfigBootstrapper
+from orionis.luminate._contracts.config.config import IConfig
+from orionis.luminate._foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 
 class ConfigBootstrapper(IConfigBootstrapper):
     """

{orionis-0.252.0/orionis/luminate/foundation → orionis-0.254.0/orionis/luminate/_foundation}/providers/service_providers_bootstrapper.py

@@ -2,10 +2,10 @@ import importlib
 import inspect
 import pathlib
 from typing import List, Type
-from orionis.luminate.contracts.foundation.providers.service_providers_bootstrapper import IServiceProvidersBootstrapper
-from orionis.luminate.contracts.providers.service_provider import IServiceProvider
-from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
-from orionis.luminate.providers.service_provider import ServiceProvider
+from orionis.luminate._contracts.foundation.providers.service_providers_bootstrapper import IServiceProvidersBootstrapper
+from orionis.luminate._contracts.providers.service_provider import IServiceProvider
+from orionis.luminate._foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate._providers.service_provider import ServiceProvider
 
 class ServiceProvidersBootstrapper(IServiceProvidersBootstrapper):
     """

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/commands/reactor_commands_service_provider.py

@@ -1,10 +1,10 @@
-from orionis.luminate.contracts.services.commands.reactor_commands_service import IReactorCommandsService
-from orionis.luminate.contracts.services.config.config_service import IConfigService
-from orionis.luminate.contracts.services.log.log_service import ILogguerService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.commands.reactor_commands_service import ReactorCommandsService
-from orionis.luminate.services_.config.config_service import ConfigService
-from orionis.luminate.services_.log.log_service import LogguerService
+from orionis.luminate._contracts.services.commands.reactor_commands_service import IReactorCommandsService
+from orionis.luminate._contracts.services.config.config_service import IConfigService
+from orionis.luminate._contracts.services.log.log_service import ILogguerService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.commands.reactor_commands_service import ReactorCommandsService
+from orionis.luminate._services.config.config_service import ConfigService
+from orionis.luminate._services.log.log_service import LogguerService
 
 class ReactorCommandsServiceProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/commands/scheduler_provider.py

@@ -1,6 +1,6 @@
-from orionis.luminate.contracts.services.commands.schedule_service import IScheduleService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.commands.scheduler_service import ScheduleService
+from orionis.luminate._contracts.services.commands.schedule_service import IScheduleService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.commands.scheduler_service import ScheduleService
 
 class ScheduleServiceProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/config/config_service_provider.py

@@ -1,6 +1,6 @@
-from orionis.luminate.contracts.services.config.config_service import IConfigService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.config.config_service import ConfigService
+from orionis.luminate._contracts.services.config.config_service import IConfigService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.config.config_service import ConfigService
 
 class ConfigServiceProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/environment/environment__service_provider.py

@@ -1,7 +1,7 @@
-from orionis.luminate.contracts.services.environment.environment_service import IEnvironmentService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.environment.environment_service import EnvironmentService
-from orionis.luminate.services_.files.path_resolver_service import PathResolverService
+from orionis.luminate._contracts.services.environment.environment_service import IEnvironmentService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.environment.environment_service import EnvironmentService
+from orionis.luminate._services.files.path_resolver_service import PathResolverService
 
 class EnvironmentServiceProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/files/paths_provider.py

@@ -1,6 +1,6 @@
-from orionis.luminate.contracts.services.files.path_resolver_service import IPathResolverService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.files.path_resolver_service import PathResolverService
+from orionis.luminate._contracts.services.files.path_resolver_service import IPathResolverService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.files.path_resolver_service import PathResolverService
 
 class PathResolverProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/log/log_service_provider.py

@@ -1,8 +1,8 @@
-from orionis.luminate.contracts.services.config.config_service import IConfigService
-from orionis.luminate.contracts.services.log.log_service import ILogguerService
-from orionis.luminate.providers.service_provider import ServiceProvider
-from orionis.luminate.services_.config.config_service import ConfigService
-from orionis.luminate.services_.log.log_service import LogguerService
+from orionis.luminate._contracts.services.config.config_service import IConfigService
+from orionis.luminate._contracts.services.log.log_service import ILogguerService
+from orionis.luminate._providers.service_provider import ServiceProvider
+from orionis.luminate._services.config.config_service import ConfigService
+from orionis.luminate._services.log.log_service import LogguerService
 
 class LogServiceProvider(ServiceProvider):
 

{orionis-0.252.0/orionis/luminate/providers → orionis-0.254.0/orionis/luminate/_providers}/service_provider.py

@@ -1,5 +1,5 @@
-from orionis.luminate.contracts.container.container import IContainer
-from orionis.luminate.contracts.providers.service_provider import IServiceProvider
+from orionis.luminate._contracts.container.container import IContainer
+from orionis.luminate._contracts.providers.service_provider import IServiceProvider
 
 class ServiceProvider(IServiceProvider):
     """

{orionis-0.252.0/orionis/luminate/services_ → orionis-0.254.0/orionis/luminate/_services}/commands/reactor_commands_service.py

@@ -6,9 +6,9 @@ from orionis.luminate.console.exceptions.cli_exception import CLIOrionisExceptio
 from orionis.luminate.console.output.console import Console
 from orionis.luminate.console.output.executor import Executor
 from orionis.luminate.console.parser import Parser
-from orionis.luminate.contracts.application import IApplication
-from orionis.luminate.contracts.services.log.log_service import ILogguerService
-from orionis.luminate.facades.app_facade import app
+from orionis.luminate._contracts.application import IApplication
+from orionis.luminate._contracts.services.log.log_service import ILogguerService
+from orionis.luminate._facades.app_facade import app
 
 class ReactorCommandsService:
     """

{orionis-0.252.0/orionis/luminate/services_ → orionis-0.254.0/orionis/luminate/_services}/commands/scheduler_service.py

@@ -8,7 +8,7 @@ from apscheduler.schedulers.background import BackgroundScheduler
 from apscheduler.triggers.cron import CronTrigger
 from apscheduler.triggers.interval import IntervalTrigger
 from orionis.luminate.console.exceptions.cli_schedule_exception import CLIOrionisScheduleException
-from orionis.luminate.facades.commands.commands_facade import Command
+from orionis.luminate._facades.commands.commands_facade import Command
 
 class ScheduleService:
     """

{orionis-0.252.0/orionis/luminate/services_ → orionis-0.254.0/orionis/luminate/_services}/config/config_service.py

@@ -1,6 +1,6 @@
 import copy
 from typing import Any, Optional
-from orionis.luminate.contracts.application import IApplication
+from orionis.luminate._contracts.application import IApplication
 
 class ConfigService:
 

{orionis-0.252.0/orionis/luminate/services_ → orionis-0.254.0/orionis/luminate/_services}/log/log_service.py

@@ -4,7 +4,7 @@ from pathlib import Path
 import re
 from datetime import datetime
 from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
-from orionis.luminate.contracts.services.config.config_service import IConfigService
+from orionis.luminate._contracts.services.config.config_service import IConfigService
 
 class LogguerService:
     """

orionis-0.254.0/orionis/luminate/adapters/dicts/dot_dict.py

@@ -0,0 +1,63 @@
+from typing import Any, Optional, Dict
+
+class DotDict(dict):
+    """
+    A dictionary subclass that allows attribute-style access to keys, with full support for nested dictionaries.
+    Nested dicts are automatically converted to DotDict instances, enabling recursive dot notation.
+    Missing keys return None instead of raising AttributeError or KeyError.
+    """
+
+    # Memory optimization
+    __slots__ = ()
+
+    def __getattr__(self, key: str) -> Optional[Any]:
+        """Enable dot notation access with automatic nested DotDict conversion."""
+        try:
+            value = self[key]
+            if isinstance(value, dict) and not isinstance(value, DotDict):
+                value = DotDict(value)
+                self[key] = value
+            return value
+        except KeyError:
+            return None
+
+    def __setattr__(self, key: str, value: Any) -> None:
+        """Enable dot notation assignment with nested dictionary conversion."""
+        if isinstance(value, dict) and not isinstance(value, DotDict):
+            value = DotDict(value)
+        self[key] = value
+
+    def __delattr__(self, key: str) -> None:
+        """Enable dot notation deletion with proper error handling."""
+        try:
+            del self[key]
+        except KeyError as e:
+            raise AttributeError(f"'{self.__class__.__name__}' has no attribute '{key}'") from e
+
+    def get(self, key: str, default: Optional[Any] = None) -> Optional[Any]:
+        """
+        Get a value by key, returning default if not found.
+        Nested dicts are automatically converted to DotDict.
+        """
+        value = super().get(key, default)
+        if isinstance(value, dict) and not isinstance(value, DotDict):
+            value = DotDict(value)
+            self[key] = value
+        return value
+
+    def export(self) -> Dict[str, Any]:
+        """
+        Recursively convert this DotDict and all nested DotDicts to regular dicts.
+        """
+        return {k: v.export() if isinstance(v, DotDict) else v for k, v in self.items()}
+
+    def copy(self) -> 'DotDict':
+        """
+        Return a deep copy of this DotDict with all nested dictionaries converted.
+        """
+        return DotDict({k: v.copy() if isinstance(v, DotDict) else (DotDict(v) if isinstance(v, dict) else v)
+                        for k, v in self.items()})
+
+    def __repr__(self) -> str:
+        """Official string representation of the DotDict."""
+        return f"DotDict({super().__repr__()})"

orionis-0.254.0/orionis/luminate/app.py

@@ -0,0 +1,12 @@
+from orionis.luminate.foundation.config.configuration import Configuration
+
+class Orionis:
+
+    def __init__(self, config:Configuration = None):
+        """
+        Initializes the instance with the provided configuration.
+
+        Args:
+            config (Configuration, optional): An optional Configuration object. If not provided, a default Configuration is created and used.
+        """
+        self.__config = config if config else Configuration()

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/base/command.py

@@ -1,7 +1,7 @@
 import argparse
 from orionis.luminate.console.output.console import Console
 from orionis.luminate.console.output.progress_bar import ProgressBar
-from orionis.luminate.contracts.console.base.command import IBaseCommand
+from orionis.luminate._contracts.console.base.command import IBaseCommand
 
 class BaseCommand(IBaseCommand):
     """

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/command_filter.py

@@ -1,4 +1,4 @@
-from orionis.luminate.contracts.console.command_filter import ICommandFilter
+from orionis.luminate._contracts.console.command_filter import ICommandFilter
 
 class CommandFilter(ICommandFilter):
     """

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/commands/help.py

@@ -1,7 +1,7 @@
 from orionis.framework import NAME
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
-from orionis.luminate.contracts.application import IApplication
+from orionis.luminate._contracts.application import IApplication
 
 class HelpCommand(BaseCommand):
     """

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/commands/schedule_work.py

@@ -1,8 +1,8 @@
 import importlib
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
-from orionis.luminate.contracts.console.task_manager import ITaskManager
-from orionis.luminate.facades.commands.scheduler_facade import Schedule
+from orionis.luminate._contracts.console.task_manager import ITaskManager
+from orionis.luminate._facades.commands.scheduler_facade import Schedule
 
 class ScheduleWorkCommand(BaseCommand):
     """

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/dumper/dump_die.py

@@ -228,7 +228,7 @@ class Debug:
         """
         if self.line_tcbk is None:
             frame = inspect.currentframe()
-            caller_frame = frame.f_back.f_back if frame else None
+            caller_frame = frame.f_back.f_back.f_back.f_back if frame else None
             line_info = f"[blue underline]{self.__getLineInfo(caller_frame) if caller_frame else 'Unknown location'}[/]"
         else:
             line_info = f"[blue underline]{self.line_tcbk}[/]"

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/kernel.py

@@ -1,5 +1,5 @@
 from typing import Any
-from orionis.luminate.contracts.console.kernel import ICLIKernel
+from orionis.luminate._contracts.console.kernel import ICLIKernel
 
 class CLIKernel(ICLIKernel):
     """

{orionis-0.252.0 → orionis-0.254.0}/orionis/luminate/console/output/console.py

@@ -3,7 +3,7 @@ import getpass
 import os
 import sys
 from orionis.luminate.console.output.styles import ANSIColors
-from orionis.luminate.contracts.console.output.console import IConsole
+from orionis.luminate._contracts.console.output.console import IConsole
 from orionis.luminate.support.parsers.exception_parser import ExceptionParser
 
 class Console(IConsole):