orionis 0.256.0__tar.gz → 0.257.0__tar.gz

{orionis-0.256.0/orionis.egg-info → orionis-0.257.0}/PKG-INFO

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

{orionis-0.256.0 → orionis-0.257.0}/orionis/framework.py

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

orionis-0.257.0/orionis/luminate/foundation/skeletom/exceptions/integrity.py

@@ -0,0 +1,29 @@
+class SkeletomIntegrityException(Exception):
+    """
+    Exception raised when an integrity violation is detected within the Orionis framework configuration.
+    This exception is specifically designed to highlight issues such as duplicate identifiers, missing required fields,
+    or other inconsistencies that compromise the integrity of the framework's setup. By providing a clear and descriptive
+    error message, it assists developers in quickly identifying and resolving configuration problems, thereby ensuring
+    the reliability and correctness of the framework.
+        msg (str): A detailed, human-readable description of the integrity error encountered.
+        raise SkeletomIntegrityException("Duplicate test case identifier found in configuration.")
+        msg (str): The error message describing the specific integrity violation.
+    """
+
+    def __init__(self, msg: str):
+        """
+        Initializes the exception with a custom error message.
+
+        Args:
+            msg (str): The error message describing the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Return a string representation of the exception, including the class name and the first argument.
+
+        Returns:
+            str: A string in the format '<ClassName>: <first argument>'.
+        """
+        return f"{self.__class__.__name__}: {self.args[0]}"

orionis-0.257.0/orionis/luminate/foundation/skeletom/roots/console.py

@@ -0,0 +1,83 @@
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+from orionis.luminate.foundation.skeletom.exceptions.integrity import SkeletomIntegrityException
+
+@dataclass(frozen=True, kw_only=True)
+class RootConsole:
+    """
+    Root configuration for the console kernel and command registration paths.
+
+    Attributes
+    ----------
+    path_kernel : str
+        Path to the console kernel file. This file defines scheduled tasks and command bindings.
+    path_commands : str
+        Path to the directory containing custom command definitions.
+    """
+
+    path_kernel: str = field(
+        default='app/console/kernel.py',
+        metadata={
+            'description': 'Path to the console kernel file. This file defines scheduled tasks and command bindings.'
+        }
+    )
+
+    path_commands: str = field(
+        default='app/console/commands',
+        metadata={
+            'description': 'Path to the directory containing custom command definitions.'
+        }
+    )
+
+    def __post_init__(self):
+        """
+        Validates the initialization of RootConsole fields.
+
+        Ensures that `path_kernel` is a string pointing to a Python file,
+        and `path_commands` is a string pointing to an existing directory.
+
+        Raises:
+            SkeletomIntegrityException: If any validation fails.
+        """
+        if not isinstance(self.path_kernel, str):
+            raise SkeletomIntegrityException("path_kernel must be a string.")
+        if not isinstance(self.path_commands, str):
+            raise SkeletomIntegrityException("path_commands must be a string.")
+
+        kernel_path = Path(self.path_kernel)
+        commands_path = Path(self.path_commands)
+
+        if kernel_path.suffix != '.py':
+            raise SkeletomIntegrityException(
+                f"path_kernel must be a Python file with '.py' extension (got: {self.path_kernel})"
+            )
+
+        if not commands_path.exists() or not commands_path.is_dir():
+            raise SkeletomIntegrityException(
+                f"path_commands must exist and be a directory (got: {self.path_commands})"
+            )
+
+    def getKernelPath(self) -> Path:
+        """
+        Returns the filesystem path to the kernel directory.
+        Returns:
+            Path: The path object representing the kernel directory.
+        """
+        return Path(self.path_kernel)
+
+    def getCommandsPath(self) -> Path:
+        """
+        Returns the path to the commands directory as a Path object.
+
+        Returns:
+            Path: The path to the commands directory.
+        """
+        return Path(self.path_commands)
+
+    def toDict(self) -> dict:
+        """
+        Convert the object to a dictionary representation.
+        Returns:
+            dict: A dictionary representation of the Dataclass object.
+        """
+        return asdict(self)

orionis-0.257.0/orionis/luminate/foundation/skeletom/roots/http.py

@@ -0,0 +1,93 @@
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+from orionis.luminate.foundation.skeletom.exceptions.integrity import SkeletomIntegrityException
+
+@dataclass(frozen=True, kw_only=True)
+class RootHttp:
+    """
+    Root configuration for HTTP controllers, middleware, and request validation paths.
+
+    Attributes
+    ----------
+    path_controllers : str
+        Path to the directory containing HTTP controller classes.
+    path_middleware : str
+        Path to the directory containing HTTP middleware classes.
+    path_request : str
+        Path to the directory containing HTTP request validation classes.
+    """
+
+    path_controllers: str = field(
+        default='app/http/controllers',
+        metadata={
+            'description': 'Path to the directory containing HTTP controller classes.'
+        }
+    )
+
+    path_middleware: str = field(
+        default='app/http/middleware',
+        metadata={
+            'description': 'Path to the directory containing HTTP middleware classes.'
+        }
+    )
+
+    path_request: str = field(
+        default='app/http/requests',
+        metadata={
+            'description': 'Path to the directory containing HTTP request validation classes.'
+        }
+    )
+
+    def __post_init__(self):
+        """
+        Validates the initialization of RootHttp fields.
+
+        Ensures that all paths are strings and point to existing directories.
+
+        Raises:
+            SkeletomIntegrityException: If any validation fails.
+        """
+        for attr_name in ['path_controllers', 'path_middleware', 'path_request']:
+            value = getattr(self, attr_name)
+            if not isinstance(value, str):
+                raise SkeletomIntegrityException(f"{attr_name} must be a string.")
+            path = Path(value)
+            if not path.exists() or not path.is_dir():
+                raise SkeletomIntegrityException(
+                    f"{attr_name} must exist and be a directory (got: {value})"
+                )
+
+    def getControllersPath(self) -> Path:
+        """
+        Returns the path to the controllers directory as a Path object.
+
+        Returns:
+            Path: The path to the controllers directory.
+        """
+        return Path(self.path_controllers)
+
+    def getMiddlewarePath(self) -> Path:
+        """
+        Returns the path to the middleware directory as a Path object.
+
+        Returns:
+            Path: The path to the middleware directory.
+        """
+        return Path(self.path_middleware)
+
+    def getRequestPath(self) -> Path:
+        """
+        Returns the path to the request validation directory as a Path object.
+
+        Returns:
+            Path: The path to the request validation directory.
+        """
+        return Path(self.path_request)
+
+    def toDict(self) -> dict:
+        """
+        Convert the object to a dictionary representation.
+        Returns:
+            dict: A dictionary representation of the Dataclass object.
+        """
+        return asdict(self)

orionis-0.257.0/orionis/luminate/foundation/skeletom/startup.py

@@ -0,0 +1,101 @@
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+from typing import Type
+from orionis.luminate.foundation.skeletom.roots.console import RootConsole
+from orionis.luminate.foundation.skeletom.roots.http import RootHttp
+from orionis.luminate.foundation.skeletom.exceptions.integrity import SkeletomIntegrityException
+
+@dataclass(frozen=True, kw_only=True)
+class SkeletomConfig:
+    """
+    Configuration for the Skeletom framework components and application structure.
+
+    Attributes
+    ----------
+    console : RootConsole
+        Console configuration for logging and command registration.
+    http : RootHttp
+        HTTP server configuration.
+    exceptions : str
+        Directory where exception classes are stored.
+    models : str
+        Directory where model classes are stored.
+    providers : str
+        Directory where provider classes are stored.
+    services : str
+        Directory where service classes are stored.
+    notifications : str
+        Directory where notification classes are stored.
+    """
+
+    console: RootConsole = field(
+        default_factory=RootConsole,
+        metadata={
+            "description": "Console configuration for logging and command registration."
+        }
+    )
+
+    http: RootHttp = field(
+        default_factory=RootHttp,
+        metadata={
+            "description": "HTTP server configuration."
+        }
+    )
+
+    exceptions: str = field(
+        default="app/exceptions",
+        metadata={
+            "description": "Directory where exception classes are stored."
+        }
+    )
+
+    models: str = field(
+        default="app/models",
+        metadata={
+            "description": "Directory where model classes are stored."
+        }
+    )
+
+    providers: str = field(
+        default="app/providers",
+        metadata={
+            "description": "Directory where provider classes are stored."
+        }
+    )
+
+    services: str = field(
+        default="app/services",
+        metadata={
+            "description": "Directory where service classes are stored."
+        }
+    )
+
+    notifications: str = field(
+        default="app/notifications",
+        metadata={
+            "description": "Directory where notification classes are stored."
+        }
+    )
+
+    def __post_init__(self):
+        # Validate all string paths
+        for attr in ['exceptions', 'models', 'providers', 'services', 'notifications']:
+            value = getattr(self, attr)
+            if not isinstance(value, str):
+                raise SkeletomIntegrityException(f"{attr} must be a string (got: {type(value).__name__})")
+
+        # Validate console type
+        if not isinstance(self.console, RootConsole):
+            raise SkeletomIntegrityException("console must be an instance of RootConsole.")
+
+        # Validate http type
+        if not isinstance(self.http, RootHttp):
+            raise SkeletomIntegrityException("http must be an instance of RootHttp.")
+
+    def toDict(self) -> dict:
+        """
+        Convert the object to a dictionary representation.
+        Returns:
+            dict: A dictionary representation of the Dataclass object.
+        """
+        return asdict(self)

orionis-0.257.0/orionis/luminate/services/introspection/abstracts/entities/abstract_class_attributes.py

@@ -0,0 +1,37 @@
+from dataclasses import dataclass, field
+from typing import Any, Dict
+
+@dataclass(frozen=True, kw_only=True)
+class AbstractClassAttributes:
+    """
+    A class to represent the attributes of an entity.
+    """
+    public: Dict[str, Any] = field()
+    private: Dict[str, Any] = field()
+    protected: Dict[str, Any] = field()
+
+    def __post_init__(self):
+        """
+        Post-initialization method to validate attribute types.
+
+        Ensures that the 'public', 'private', and 'protected' attributes of the instance
+        are all dictionaries. Raises a TypeError if any of these attributes are not of type dict.
+
+        Raises:
+            TypeError: If 'public', 'private', or 'protected' is not a dict.
+        """
+        if not isinstance(self.public, dict):
+            raise TypeError(
+                f"Invalid type for 'public' attribute in {self.__class__.__name__}: "
+                f"expected 'dict', got '{type(self.public).__name__}'."
+            )
+        if not isinstance(self.private, dict):
+            raise TypeError(
+                f"Invalid type for 'private' attribute in {self.__class__.__name__}: "
+                f"expected 'dict', got '{type(self.private).__name__}'."
+            )
+        if not isinstance(self.protected, dict):
+            raise TypeError(
+                f"Invalid type for 'protected' attribute in {self.__class__.__name__}: "
+                f"expected 'dict', got '{type(self.protected).__name__}'."
+            )

{orionis-0.256.0/orionis/luminate/support → orionis-0.257.0/orionis/luminate/services}/introspection/abstracts/reflect_abstract.py

@@ -3,7 +3,7 @@ import ast
 import inspect
 import types
 from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type, TypeVar
-from orionis.luminate.support.introspection.abstracts.entities.abstract_class_attributes import AbstractClassAttributes
+from orionis.luminate.services.introspection.abstracts.entities.abstract_class_attributes import AbstractClassAttributes
 
 ABC = TypeVar('ABC', bound=abc.ABC)
 

{orionis-0.256.0 → orionis-0.257.0}/orionis/luminate/services/introspection/dependencies/contracts/reflect_dependencies.py

@@ -1,6 +1,6 @@
 from abc import ABC, abstractmethod
-from orionis.luminate.support.introspection.dependencies.entities.class_dependencies import ClassDependency
-from orionis.luminate.support.introspection.dependencies.entities.method_dependencies import MethodDependency
+from orionis.luminate.services.introspection.dependencies.entities.class_dependencies import ClassDependency
+from orionis.luminate.services.introspection.dependencies.entities.method_dependencies import MethodDependency
 
 class IReflectDependencies(ABC):
     """

{orionis-0.256.0 → orionis-0.257.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.256.0 → orionis-0.257.0}/orionis.egg-info/SOURCES.txt

@@ -246,6 +246,13 @@ orionis/luminate/foundation/config/testing/entities/__init__.py
 orionis/luminate/foundation/config/testing/entities/testing.py
 orionis/luminate/foundation/config/testing/enums/__init__.py
 orionis/luminate/foundation/config/testing/enums/test_mode.py
+orionis/luminate/foundation/skeletom/__init__.py
+orionis/luminate/foundation/skeletom/startup.py
+orionis/luminate/foundation/skeletom/exceptions/__init__.py
+orionis/luminate/foundation/skeletom/exceptions/integrity.py
+orionis/luminate/foundation/skeletom/roots/__init__.py
+orionis/luminate/foundation/skeletom/roots/console.py
+orionis/luminate/foundation/skeletom/roots/http.py
 orionis/luminate/patterns/__init__.py
 orionis/luminate/patterns/singleton/__init__.py
 orionis/luminate/patterns/singleton/meta_class.py
@@ -258,6 +265,10 @@ orionis/luminate/services/environment/env.py
 orionis/luminate/services/environment/contracts/__init__.py
 orionis/luminate/services/environment/contracts/env.py
 orionis/luminate/services/introspection/__init__.py
+orionis/luminate/services/introspection/abstracts/__init__.py
+orionis/luminate/services/introspection/abstracts/reflect_abstract.py
+orionis/luminate/services/introspection/abstracts/entities/__init__.py
+orionis/luminate/services/introspection/abstracts/entities/abstract_class_attributes.py
 orionis/luminate/services/introspection/dependencies/__init__.py
 orionis/luminate/services/introspection/dependencies/reflect_dependencies.py
 orionis/luminate/services/introspection/dependencies/contracts/__init__.py
@@ -299,10 +310,6 @@ orionis/luminate/support/introspection/reflexion_concrete_with_abstract.py
 orionis/luminate/support/introspection/reflexion_instance_with_abstract.py
 orionis/luminate/support/introspection/reflexion_module.py
 orionis/luminate/support/introspection/reflexion_module_with_classname.py
-orionis/luminate/support/introspection/abstracts/__init__.py
-orionis/luminate/support/introspection/abstracts/reflect_abstract.py
-orionis/luminate/support/introspection/abstracts/entities/__init__.py
-orionis/luminate/support/introspection/abstracts/entities/abstract_class_attributes.py
 orionis/luminate/support/introspection/contracts/__init__.py
 orionis/luminate/support/introspection/contracts/reflection.py
 orionis/luminate/support/introspection/contracts/reflexion_abstract.py
@@ -344,55 +351,56 @@ orionis/static/ascii/icon.ascii
 orionis/static/ascii/info.ascii
 orionis/static/bg/galaxy.jpg
 tests/__init__.py
-tests/config/__init__.py
-tests/config/session.py
-tests/config/app/__init__.py
-tests/config/app/test_app.py
-tests/config/auth/__init__.py
-tests/config/auth/test_auth.py
-tests/config/cache/__init__.py
-tests/config/cache/test_cache.py
-tests/config/cache/test_cache_file.py
-tests/config/cache/test_cache_stores.py
-tests/config/cors/__init__.py
-tests/config/cors/test_cors.py
-tests/config/database/__init__.py
-tests/config/database/test_database.py
-tests/config/database/test_database_connections.py
-tests/config/database/test_database_mysql.py
-tests/config/database/test_database_oracle.py
-tests/config/database/test_database_pgsql.py
-tests/config/database/test_database_sqlite.py
-tests/config/exceptions/__init__.py
-tests/config/exceptions/test_exceptions_integrity.py
-tests/config/filesystems/__init__.py
-tests/config/filesystems/test_filesystems.py
-tests/config/filesystems/test_filesystems_aws.py
-tests/config/filesystems/test_filesystems_disks.py
-tests/config/filesystems/test_filesystems_local.py
-tests/config/filesystems/test_filesystems_public.py
-tests/config/logging/__init__.py
-tests/config/logging/test_logging.py
-tests/config/logging/test_logging_channels.py
-tests/config/logging/test_logging_chunked.py
-tests/config/logging/test_logging_daily.py
-tests/config/logging/test_logging_hourly.py
-tests/config/logging/test_logging_monthly.py
-tests/config/logging/test_logging_stack.py
-tests/config/logging/test_logging_weekly.py
-tests/config/mail/__init__.py
-tests/config/mail/test_mail.py
-tests/config/mail/test_mail_file.py
-tests/config/mail/test_mail_mailers.py
-tests/config/mail/test_mail_smtp.py
-tests/config/queue/__init__.py
-tests/config/queue/test_queue.py
-tests/config/queue/test_queue_brokers.py
-tests/config/queue/test_queue_database.py
-tests/config/testing/__init__.py
-tests/config/testing/test_testing.py
 tests/example/__init__.py
 tests/example/test_example.py
+tests/foundation/__init__.py
+tests/foundation/config/__init__.py
+tests/foundation/config/session.py
+tests/foundation/config/app/__init__.py
+tests/foundation/config/app/test_app.py
+tests/foundation/config/auth/__init__.py
+tests/foundation/config/auth/test_auth.py
+tests/foundation/config/cache/__init__.py
+tests/foundation/config/cache/test_cache.py
+tests/foundation/config/cache/test_cache_file.py
+tests/foundation/config/cache/test_cache_stores.py
+tests/foundation/config/cors/__init__.py
+tests/foundation/config/cors/test_cors.py
+tests/foundation/config/database/__init__.py
+tests/foundation/config/database/test_database.py
+tests/foundation/config/database/test_database_connections.py
+tests/foundation/config/database/test_database_mysql.py
+tests/foundation/config/database/test_database_oracle.py
+tests/foundation/config/database/test_database_pgsql.py
+tests/foundation/config/database/test_database_sqlite.py
+tests/foundation/config/exceptions/__init__.py
+tests/foundation/config/exceptions/test_exceptions_integrity.py
+tests/foundation/config/filesystems/__init__.py
+tests/foundation/config/filesystems/test_filesystems.py
+tests/foundation/config/filesystems/test_filesystems_aws.py
+tests/foundation/config/filesystems/test_filesystems_disks.py
+tests/foundation/config/filesystems/test_filesystems_local.py
+tests/foundation/config/filesystems/test_filesystems_public.py
+tests/foundation/config/logging/__init__.py
+tests/foundation/config/logging/test_logging.py
+tests/foundation/config/logging/test_logging_channels.py
+tests/foundation/config/logging/test_logging_chunked.py
+tests/foundation/config/logging/test_logging_daily.py
+tests/foundation/config/logging/test_logging_hourly.py
+tests/foundation/config/logging/test_logging_monthly.py
+tests/foundation/config/logging/test_logging_stack.py
+tests/foundation/config/logging/test_logging_weekly.py
+tests/foundation/config/mail/__init__.py
+tests/foundation/config/mail/test_mail.py
+tests/foundation/config/mail/test_mail_file.py
+tests/foundation/config/mail/test_mail_mailers.py
+tests/foundation/config/mail/test_mail_smtp.py
+tests/foundation/config/queue/__init__.py
+tests/foundation/config/queue/test_queue.py
+tests/foundation/config/queue/test_queue_brokers.py
+tests/foundation/config/queue/test_queue_database.py
+tests/foundation/config/testing/__init__.py
+tests/foundation/config/testing/test_testing.py
 tests/patterns/__init__.py
 tests/patterns/singleton/__init__.py
 tests/patterns/singleton/test_singleton.py

orionis-0.256.0/orionis/luminate/support/introspection/abstracts/entities/abstract_class_attributes.py

@@ -1,11 +0,0 @@
-from dataclasses import dataclass
-from typing import Any, Dict
-
-@dataclass(frozen=True, kw_only=True)
-class AbstractClassAttributes:
-    """
-    A class to represent the attributes of an entity.
-    """
-    public: Dict[str, Any]
-    private: Dict[str, Any]
-    protected: Dict[str, Any]