orionis 0.418.0__py3-none-any.whl → 0.420.0__py3-none-any.whl

orionis/_contracts/foundation/providers/service_providers_bootstrapper.py

@@ -1,47 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import List, Type
-from orionis._contracts.providers.service_provider import IServiceProvider
-from orionis._providers.service_provider import ServiceProvider
-
-class IServiceProvidersBootstrapper(ABC):
-
-    @abstractmethod
-    def _autoload(self) -> None:
-        """
-        Scans the provider directories and loads provider classes.
-
-        This method searches for Python files in the specified directories, imports them,
-        and registers any class that inherits from `ServiceProvider`.
-
-        Raises
-        ------
-        BootstrapRuntimeError
-            If there is an error loading a module.
-        """
-        pass
-
-    @abstractmethod
-    def _register(self, concrete: Type[IServiceProvider]) -> None:
-        """
-        Validates and registers a service provider class.
-
-        This method ensures that the provided class is valid (inherits from `ServiceProvider`,
-        has a `register` and `boot` method) and registers it in the
-        `_service_providers` dictionary.
-
-        Parameters
-        ----------
-        concrete : ServiceProvider
-            The service provider class to register
-        """
-        pass
-
-    @abstractmethod
-    def get(self) -> List[Type[IServiceProvider]]:
-        """
-        Retrieve the registered service providers that should run before bootstrapping.
-
-        Returns:
-            List[Type[IServiceProvider]]: A list of service providers to run before bootstrapping.
-        """
-        pass

orionis/_contracts/providers/service_provider.py

@@ -1,14 +0,0 @@
-from abc import ABC, abstractmethod
-from orionis._container.container import Container
-
-class IServiceProvider(ABC):
-
-    @abstractmethod
-    def register(self, container: Container) -> None:
-        """
-        Registers services or bindings into the given container.
-
-        Args:
-            container (Container): The container to register services or bindings into.
-        """
-        pass

orionis/_contracts/services/commands/reactor_commands_service.py

@@ -1,23 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import Optional
-
-class IReactorCommandsService(ABC):
-    """
-    Interface for the ReactorCommandsService class.
-    Service responsible for executing and managing CLI commands in Orionis.
-
-    This service handles:
-    - Parsing command arguments.
-    - Executing commands and logging their output.
-    - Managing execution timing and error handling.
-    """
-
-    @abstractmethod
-    def execute(self, signature: Optional[str] = None, vars: dict = {}, *args, **kwargs):
-        """
-        Processes and executes a CLI command.
-
-        Determines if the command originates from `sys.argv` or is explicitly called,
-        then executes the appropriate command pipeline, handling success and errors.
-        """
-        pass

orionis/_contracts/services/commands/schedule_service.py

@@ -1,317 +0,0 @@
-
-from typing import Any
-from datetime import datetime
-from abc import ABC, abstractmethod
-
-class IScheduleService(ABC):
-    """
-    A class that manages the scheduling of tasks using the APScheduler.
-
-    Attributes
-    ----------
-    scheduler : BackgroundScheduler
-        The background scheduler instance used to schedule tasks.
-    callback : function | None
-        A callback function that will be called when the scheduled task is triggered.
-
-    Methods
-    -------
-    command(signature: str, vars: dict[str, Any] = {}, *args: Any, **kwargs: Any) -> 'Schedule':
-        Defines a command to execute.
-    """
-
-    @abstractmethod
-    def command(self, signature: str, vars: dict[str, Any] = {}, *args: Any, **kwargs: Any):
-        """
-        Defines a Orionis command to be executed.
-
-        Parameters
-        ----------
-        signature : str
-            The signature of the command to execute.
-        vars : dict, optional
-            A dictionary of variables to pass to the command, by default an empty dictionary.
-        *args : Any
-            Additional positional arguments to pass to the command.
-        **kwargs : Any
-            Additional keyword arguments to pass to the command.
-
-        Returns
-        -------
-        Schedule
-            Returns the Schedule instance itself, allowing method chaining.
-        """
-        pass
-
-    @abstractmethod
-    def onceAt(self, date: datetime):
-        """
-        Schedule the defined command to execute every X seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everySeconds(self, seconds: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedule the defined command to execute every X seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everySecond(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every second.
-        """
-        pass
-
-    @abstractmethod
-    def everyTwoSeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every two seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyFiveSeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every five seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyTenSeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every ten seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyFifteenSeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every fifteen seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyTwentySeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every twenty seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyThirtySeconds(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every thirty seconds.
-        """
-        pass
-
-    @abstractmethod
-    def everyMinutes(self, minutes: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every X minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyMinute(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every minute.
-        """
-        pass
-
-    @abstractmethod
-    def everyTwoMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every two minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyThreeMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every three minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyFourMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every four minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyFiveMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every five minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyTenMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every ten minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyFifteenMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every fifteen minutes.
-        """
-        pass
-
-    @abstractmethod
-    def everyThirtyMinutes(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every thirty minutes.
-        """
-        pass
-
-    @abstractmethod
-    def hours(self, hours: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every X hours.
-        """
-        pass
-
-    @abstractmethod
-    def hourly(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every hour.
-        """
-        pass
-
-    @abstractmethod
-    def hourlyAt(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every hour at a specific minute.
-        """
-        pass
-
-    @abstractmethod
-    def everyOddHour(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every odd hour.
-        """
-        pass
-
-    @abstractmethod
-    def everyTwoHours(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every two hours.
-        """
-        pass
-
-    @abstractmethod
-    def everyThreeHours(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every three hours.
-        """
-        pass
-
-    @abstractmethod
-    def everyFourHours(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every four hours.
-        """
-        pass
-
-    @abstractmethod
-    def everySixHours(self, minute: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every six hours.
-        """
-        pass
-
-    @abstractmethod
-    def days(self, days: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every X days.
-        """
-        pass
-
-    @abstractmethod
-    def daily(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute daily at midnight.
-        """
-        pass
-
-    @abstractmethod
-    def dailyAt(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute daily at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def twiceDaily(self, first_hour: int, second_hour: int, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute twice a day at specific hours.
-        """
-        pass
-
-    @abstractmethod
-    def monday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every Monday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def tuesday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every tuesday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def wednesday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every wednesday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def thursday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every thursday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def friday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every friday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def saturday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every saturday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def sunday(self, at: str, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute every sunday at a specific time.
-        """
-        pass
-
-    @abstractmethod
-    def weekly(self, start_date: datetime = None, end_date: datetime = None):
-        """
-        Schedules the defined command to execute weekly on Sunday at midnight.
-        """
-        pass
-
-    @abstractmethod
-    def start(self):
-        """
-        Starts the scheduler and stops automatically when there are no more jobs.
-        """
-        pass

orionis/_contracts/services/config/config_service.py

@@ -1,37 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import Any, Optional
-
-class IConfigService(ABC):
-
-    @abstractmethod
-    def set(self, key: str, value: Any) -> None:
-        """
-        Dynamically sets a configuration value using dot notation.
-
-        Parameters
-        ----------
-        key : str
-            The configuration key (e.g., 'app.debug').
-        value : Any
-            The value to set.
-        """
-        pass
-
-    @abstractmethod
-    def get(self, key: str, default: Optional[Any] = None) -> Any:
-        """
-        Retrieves a configuration value using dot notation.
-
-        Parameters
-        ----------
-        key : str
-            The configuration key (e.g., 'app.debug').
-        default : Optional[Any]
-            The default value to return if the key is not found.
-
-        Returns
-        -------
-        Any
-            The configuration value or the default value if the key is not found.
-        """
-        pass

orionis/_contracts/services/environment/environment_service.py

@@ -1,74 +0,0 @@
-from abc import ABC, abstractmethod
-
-class IEnvironmentService(ABC):
-
-    @abstractmethod
-    def _initialize(self, path: str = None):
-        """
-        Initializes the instance by setting the path to the .env file.
-        If no path is provided, defaults to a `.env` file in the current directory.
-
-        Parameters
-        ----------
-        path : str, optional
-            Path to the .env file. Defaults to None.
-        """
-        pass
-
-    @abstractmethod
-    def get(self, key: str, default=None) -> str:
-        """
-        Retrieves the value of an environment variable from the .env file
-        or from system environment variables if not found.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable.
-        default : optional
-            Default value if the key does not exist. Defaults to None.
-
-        Returns
-        -------
-        str
-            The value of the environment variable or the default value.
-        """
-        pass
-
-    @abstractmethod
-    def set(self, key: str, value: str) -> None:
-        """
-        Sets the value of an environment variable in the .env file.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable.
-        value : str
-            The value to set.
-        """
-        pass
-
-    @abstractmethod
-    def unset(self, key: str) -> None:
-        """
-        Removes an environment variable from the .env file.
-
-        Parameters
-        ----------
-        key : str
-            The key of the environment variable to remove.
-        """
-        pass
-
-    @abstractmethod
-    def all(self) -> dict:
-        """
-        Retrieves all environment variable values from the .env file.
-
-        Returns
-        -------
-        dict
-            A dictionary of all environment variables and their values.
-        """
-        pass

orionis/_contracts/services/files/path_resolver_service.py

@@ -1,29 +0,0 @@
-from abc import ABC, abstractmethod
-
-class IPathResolverService(ABC):
-
-    @abstractmethod
-    def resolve(self, route: str) -> str:
-        """
-        Resolves and returns the absolute path as a string.
-
-        This method combines the base path (current working directory) with the provided
-        relative path, resolves it to an absolute path, and validates that it exists
-        and is either a directory or a file.
-
-        Parameters
-        ----------
-        route : str
-            The relative directory or file path to be resolved.
-
-        Returns
-        -------
-        str
-            The absolute path to the directory or file.
-
-        Raises
-        ------
-        ValueError
-            If the resolved path does not exist or is neither a directory nor a file.
-        """
-        pass

orionis/_contracts/services/log/log_service.py

@@ -1,89 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import Optional
-
-class ILogguerService(ABC):
-
-    @abstractmethod
-    def _initialize_logger(self, path: Optional[str], level: int, filename: Optional[str] = 'orionis.log'):
-        """
-        Configures the logger with the specified settings.
-
-        This method sets up the logger to write logs to a file. If the specified
-        directory does not exist, it creates it. The log format includes the
-        timestamp and the log message.
-
-        Parameters
-        ----------
-        path : Optional[str]
-            The directory path where the log file will be stored.
-        level : int
-            The logging level (e.g., logging.INFO, logging.ERROR).
-        filename : Optional[str]
-            The name of the log file.
-
-        Raises
-        ------
-        RuntimeError
-            If the logger cannot be initialized due to an error.
-        """
-        pass
-
-    @abstractmethod
-    def info(self, message: str) -> None:
-        """
-        Logs an informational message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        pass
-
-    @abstractmethod
-    def error(self, message: str) -> None:
-        """
-        Logs an error message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        pass
-
-    @abstractmethod
-    def success(self, message: str) -> None:
-        """
-        Logs a success message (treated as info).
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        pass
-
-    @abstractmethod
-    def warning(self, message: str) -> None:
-        """
-        Logs a warning message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        pass
-
-    @abstractmethod
-    def debug(self, message: str) -> None:
-        """
-        Logs a debug message.
-
-        Parameters
-        ----------
-        message : str
-            The message to log.
-        """
-        pass

orionis/_contracts/support/exception_parse.py

@@ -1,26 +0,0 @@
-from abc import ABC, abstractmethod
-
-class IExceptionParse(ABC):
-
-    @abstractmethod
-    def toDict(exception):
-        """
-        Parse the provided exception and serialize it into a dictionary format.
-
-        Parameters
-        ----------
-        exception : Exception
-            The exception object to be serialized.
-
-        Returns
-        -------
-        dict
-            A dictionary containing the exception details such as error type, message,
-            and the stack trace.
-
-        Notes
-        -----
-        - Uses `traceback.TracebackException.from_exception()` to extract detailed traceback information.
-        - The stack trace includes filenames, line numbers, function names, and the exact line of code.
-        """
-        pass