orionis 0.225.0__tar.gz → 0.227.0__tar.gz

{orionis-0.225.0/orionis.egg-info → orionis-0.227.0}/PKG-INFO

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

{orionis-0.225.0 → orionis-0.227.0}/orionis/framework.py

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

orionis-0.227.0/orionis/luminate/support/environment/contracts/env.py

@@ -0,0 +1,68 @@
+from abc import ABC, abstractmethod
+from typing import Any, Optional, Union
+
+class IEnv(ABC):
+    """
+    Interface for a utility class to manage environment variables in a `.env` file.
+    """
+
+    @staticmethod
+    @abstractmethod
+    def get(key: str, default: Optional[Any] = None) -> Any:
+        """
+        Retrieve the value of an environment variable.
+
+        Parameters
+        ----------
+        key : str
+            Name of the environment variable.
+        default : Any, optional
+            Default value if variable is not found.
+
+        Returns
+        -------
+        Any
+            Parsed value or default.
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def set(key: str, value: Union[str, int, float, bool, list, dict]) -> None:
+        """
+        Set the value of an environment variable.
+
+        Parameters
+        ----------
+        key : str
+            Name of the environment variable.
+        value : str, int, float, bool, list, or dict
+            Value to assign, will be serialized.
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def unset(key: str) -> None:
+        """
+        Remove an environment variable.
+
+        Parameters
+        ----------
+        key : str
+            Name of the environment variable.
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    def all() -> dict:
+        """
+        Retrieve all environment variables as a dictionary.
+
+        Returns
+        -------
+        dict
+            Dictionary of parsed environment variables.
+        """
+        pass

{orionis-0.225.0 → orionis-0.227.0}/orionis/luminate/support/environment/env.py

@@ -1,13 +1,14 @@
 import os
 from typing import Any, Optional, Union
 from dotenv import set_key, unset_key, dotenv_values
+from orionis.luminate.support.environment.contracts.env import IEnv
 from orionis.luminate.support.environment.functions import (
     _initialize,
     _parse_value,
     _serialize_value,
 )
 
-class Env:
+class Env(IEnv):
     """
     A utility class for managing environment variables stored in a `.env` file.
     """

{orionis-0.225.0 → orionis-0.227.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.225.0 → orionis-0.227.0}/orionis.egg-info/SOURCES.txt

@@ -174,6 +174,8 @@ orionis/luminate/support/environment/__init__.py
 orionis/luminate/support/environment/env.py
 orionis/luminate/support/environment/functions.py
 orionis/luminate/support/environment/helper.py
+orionis/luminate/support/environment/contracts/__init__.py
+orionis/luminate/support/environment/contracts/env.py
 orionis/luminate/support/inspection/__init__.py
 orionis/luminate/support/inspection/container_integrity.py
 orionis/luminate/support/inspection/functions.py