djresttoolkit 0.17.4__tar.gz → 1.0.0__tar.gz

{djresttoolkit-0.17.4 → djresttoolkit-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djresttoolkit
-Version: 0.17.4
+Version: 1.0.0
 Summary: A collection of Django and DRF utilities to simplify API development.
 Project-URL: Homepage, https://github.com/shaileshpandit141/djresttoolkit
 Project-URL: Documentation, https://shaileshpandit141.github.io/djresttoolkit
@@ -47,9 +47,7 @@ Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
 Requires-Python: >=3.13
 Requires-Dist: faker>=37.5.3
-Requires-Dist: pydantic-settings>=2.10.1
 Requires-Dist: pydantic>=2.11.7
-Requires-Dist: pyyaml>=6.0.2
 Provides-Extra: dev
 Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
@@ -72,8 +70,8 @@ djresttoolkit is a collection of utilities and helpers for Django and Django RES
 - **DB Flush Command (`dbflush`)**
   Management command to flush all models or a specific model, resetting auto-increment IDs safely with transaction support.
 
-- **EnvBaseSettings**
-  Typed settings loader using **YAML + .env**, supports nested keys and overrides. Great for structured configuration management.
+- **BaseEnvConfig**
+  Singleton environment loader that reads and parses environment variables.
 
 - **EmailSender**
   Custom class to send templated emails (`text` and `html`) with context. Supports error handling and logging.
@@ -186,10 +184,6 @@ python manage.py dbseed --count 10
 python manage.py dbseed --model User --seed 42
 ```
 
-Here’s a **concise API reference** for your database flush management command for `djresttoolkit`:
-
----
-
 ### 2. DB Flush Command — API Reference
 
 ```python
@@ -246,77 +240,54 @@ or
 Flushed 120 records from all models and reset IDs.
 ```
 
-### 3. EnvBaseSettings — API Reference
+###  3. BaseEnvConfig — API Reference
 
 ```python
-from djresttoolkit.envconfig import EnvBaseSettings
+from djresttoolkit.envconfig import BaseEnvConfig
 ```
 
-#### `EnvBaseSettings`
-
-A **base settings class** for managing application configuration using:
-
-- YAML files (default `.environ.yaml`)
-- Environment variables (default `.env`)
-
-Supports **nested configuration** using double underscores (`__`) in environment variable names.
-
-#### Class Attributes
-
-- Attributes
-  - `env_file`
-    - Type: `str`
-    - Default: `.env`
-    - Description: Environment variable file path.
-  - `yaml_file`
-    - Type: `str`
-    - Default: `.environ.yaml`
-    - Description: YAML configuration file path.
-  - `model_config`
-    - Type: `SettingsConfigDict`
-    - Description: Pydantic settings configuration (file encoding, nested delimiter).
+#### `BaseEnvConfig`
 
-#### Methods
+Singleton environment loader that reads and parses environment variables with support for booleans, numbers, and JSON.
 
-#### `load(cls, *, env_file: str | None = None, ymal_file: str | None = None, warning: bool = True) -> EnvBaseSettings`
+> ⚠️ **Note:** Note: If you are using a .env file, load it first with python-dotenv:
+>
+> ```python
+> from dotenv import load_dotenv
+> load_dotenv()
+> ```
 
-Loads configuration from **YAML first**, then overrides with **environment variables**.
-
-#### Parameters
-
-- `env_file` — Optional custom `.env` file path.
-- `ymal_file` — Optional custom YAML file path.
-- `warning` — Emit a warning if YAML file is missing (default `True`).
-
-#### Returns
-
-- Instance of `EnvBaseSettings` (or subclass) with loaded configuration.
-
-#### Raises
-
-- `UserWarning` if YAML file not found and `warning=True`.
+or
+>
+> ```python
+> from djresttoolkit.envconfig import load_dotenv
+> load_dotenv()
+> ```
 
-### Usage Example
+#### Usage Example
 
 ```python
-from djresttoolkit.envconfig import EnvBaseSettings
+from djresttoolkit.envconfig import load_dotenv, BaseEnvConfig
+
+load_dotenv()
 
-class EnvSettings(EnvBaseSettings["EnvSettings"]):
-    debug: bool = False
-    database_url: str
+class EnvConfig(BaseEnvConfig):
+    DEBUG: bool = False
+    DATABASE_URL: str
 
-# Load settings
-settings = EnvSettings.load(warning=False)
+config = EnvConfig()
+print(config.DEBUG)
+print(config.DATABASE_URL)
 
-print(settings.debug)
-print(settings.database_url)
+config.reload()
 ```
 
 #### Features
 
-- Prioritizes `.env` variables over YAML.
-- Supports nested keys: `DATABASE__HOST`:- `settings.database.host`.
-- Designed to be subclassed for project-specific settings.
+- Thread-safe singleton.
+- Automatic type parsing for environment variables.
+- Supports default values and runtime reloading.
+- Designed for subclassing with project-specific settings.
 
 ### 4. EmailSender — API Reference
 

{djresttoolkit-0.17.4 → djresttoolkit-1.0.0}/README.md

@@ -14,8 +14,8 @@ djresttoolkit is a collection of utilities and helpers for Django and Django RES
 - **DB Flush Command (`dbflush`)**
   Management command to flush all models or a specific model, resetting auto-increment IDs safely with transaction support.
 
-- **EnvBaseSettings**
-  Typed settings loader using **YAML + .env**, supports nested keys and overrides. Great for structured configuration management.
+- **BaseEnvConfig**
+  Singleton environment loader that reads and parses environment variables.
 
 - **EmailSender**
   Custom class to send templated emails (`text` and `html`) with context. Supports error handling and logging.
@@ -128,10 +128,6 @@ python manage.py dbseed --count 10
 python manage.py dbseed --model User --seed 42
 ```
 
-Here’s a **concise API reference** for your database flush management command for `djresttoolkit`:
-
----
-
 ### 2. DB Flush Command — API Reference
 
 ```python
@@ -188,77 +184,54 @@ or
 Flushed 120 records from all models and reset IDs.
 ```
 
-### 3. EnvBaseSettings — API Reference
+###  3. BaseEnvConfig — API Reference
 
 ```python
-from djresttoolkit.envconfig import EnvBaseSettings
+from djresttoolkit.envconfig import BaseEnvConfig
 ```
 
-#### `EnvBaseSettings`
-
-A **base settings class** for managing application configuration using:
-
-- YAML files (default `.environ.yaml`)
-- Environment variables (default `.env`)
-
-Supports **nested configuration** using double underscores (`__`) in environment variable names.
-
-#### Class Attributes
-
-- Attributes
-  - `env_file`
-    - Type: `str`
-    - Default: `.env`
-    - Description: Environment variable file path.
-  - `yaml_file`
-    - Type: `str`
-    - Default: `.environ.yaml`
-    - Description: YAML configuration file path.
-  - `model_config`
-    - Type: `SettingsConfigDict`
-    - Description: Pydantic settings configuration (file encoding, nested delimiter).
+#### `BaseEnvConfig`
 
-#### Methods
+Singleton environment loader that reads and parses environment variables with support for booleans, numbers, and JSON.
 
-#### `load(cls, *, env_file: str | None = None, ymal_file: str | None = None, warning: bool = True) -> EnvBaseSettings`
+> ⚠️ **Note:** Note: If you are using a .env file, load it first with python-dotenv:
+>
+> ```python
+> from dotenv import load_dotenv
+> load_dotenv()
+> ```
 
-Loads configuration from **YAML first**, then overrides with **environment variables**.
-
-#### Parameters
-
-- `env_file` — Optional custom `.env` file path.
-- `ymal_file` — Optional custom YAML file path.
-- `warning` — Emit a warning if YAML file is missing (default `True`).
-
-#### Returns
-
-- Instance of `EnvBaseSettings` (or subclass) with loaded configuration.
-
-#### Raises
-
-- `UserWarning` if YAML file not found and `warning=True`.
+or
+>
+> ```python
+> from djresttoolkit.envconfig import load_dotenv
+> load_dotenv()
+> ```
 
-### Usage Example
+#### Usage Example
 
 ```python
-from djresttoolkit.envconfig import EnvBaseSettings
+from djresttoolkit.envconfig import load_dotenv, BaseEnvConfig
+
+load_dotenv()
 
-class EnvSettings(EnvBaseSettings["EnvSettings"]):
-    debug: bool = False
-    database_url: str
+class EnvConfig(BaseEnvConfig):
+    DEBUG: bool = False
+    DATABASE_URL: str
 
-# Load settings
-settings = EnvSettings.load(warning=False)
+config = EnvConfig()
+print(config.DEBUG)
+print(config.DATABASE_URL)
 
-print(settings.debug)
-print(settings.database_url)
+config.reload()
 ```
 
 #### Features
 
-- Prioritizes `.env` variables over YAML.
-- Supports nested keys: `DATABASE__HOST`:- `settings.database.host`.
-- Designed to be subclassed for project-specific settings.
+- Thread-safe singleton.
+- Automatic type parsing for environment variables.
+- Supports default values and runtime reloading.
+- Designed for subclassing with project-specific settings.
 
 ### 4. EmailSender — API Reference
 

{djresttoolkit-0.17.4 → djresttoolkit-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@
 
 [project]
 name = "djresttoolkit"
-version = "0.17.4"
+version = "1.0.0"
 description = "A collection of Django and DRF utilities to simplify API development."
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { file = "LICENSE" }
@@ -48,8 +48,6 @@ requires-python = ">=3.13"
 dependencies = [
     "faker>=37.5.3",
     "pydantic>=2.11.7",
-    "pydantic-settings>=2.10.1",
-    "pyyaml>=6.0.2",
 ]
 
 # CLI scripts entry point configuration

djresttoolkit-1.0.0/src/djresttoolkit/envconfig/__init__.py

@@ -0,0 +1,4 @@
+from ._base_env_config import BaseEnvConfig
+from dotenv import load_dotenv
+
+__all__ = ["load_dotenv", "BaseEnvConfig"]

djresttoolkit-1.0.0/src/djresttoolkit/envconfig/_base_env_config.py

@@ -0,0 +1,84 @@
+import threading
+import json
+from os import getenv
+from typing import Any, Self, get_type_hints
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class BaseEnvConfig:
+    """Production-ready environment loader."""
+
+    _instance_lock = threading.Lock()
+    _instance = None
+
+    def __new__(cls, *args: Any, **kwargs: Any) -> Self:
+        if cls._instance is None:
+            with cls._instance_lock:
+                if cls._instance is None:
+                    cls._instance = super().__new__(cls)
+        return cls._instance
+
+    def __init__(self) -> None:
+        if getattr(self, "_initialized", False):
+            return
+
+        self._env_cache: dict[str, Any] = {}
+        self._sync_env()
+        self._initialized = True
+
+    def _sync_env(self) -> None:
+        hints = get_type_hints(self.__class__)
+        for field, _ in hints.items():
+            raw = getenv(field)
+
+            if raw is None:
+                if hasattr(self, field):
+                    value = getattr(self, field)
+                    logger.info(f"{field} not set, using default: {value}")
+                else:
+                    raise EnvironmentError(
+                        f"Missing required environment variable: {field}"
+                    )
+            else:
+                if field in self._env_cache:
+                    value = self._env_cache[field]
+                else:
+                    value = self._parse_env_value(raw)
+                    self._env_cache[field] = value
+
+            setattr(self, field, value)
+
+    def _parse_env_value(self, raw: str) -> Any:
+        """Parse string from environment."""
+        lowered = raw.lower()
+
+        # Boolean parsing
+        if lowered == "true":
+            return True
+        if lowered == "false":
+            return False
+
+        # JSON parsing
+        try:
+            return json.loads(raw)
+        except json.JSONDecodeError:
+            pass
+
+        # Numeric parsing
+        if raw.isdigit():
+            return int(raw)
+        try:
+            return float(raw)
+        except ValueError:
+            pass
+
+        # Fallback: plain string
+        return raw
+
+    def reload(self) -> None:
+        """Reload environment variables at runtime."""
+        self._env_cache.clear()
+        self._sync_env()
+        logger.info("Environment variables reloaded.")

{djresttoolkit-0.17.4 → djresttoolkit-1.0.0}/src/djresttoolkit/mail/_email_sender.py

@@ -80,7 +80,10 @@ class EmailSender:
                 to=unique_recipients,
             )
             email.attach_alternative(
-                content=self.email_content["template"]["html"],
+                content=render_to_string(
+                    self.email_content["template"]["html"],
+                    self.email_content["context"],
+                ),
                 mimetype="text/html",
             )
             email.send()

{djresttoolkit-0.17.4 → djresttoolkit-1.0.0}/uv.lock

@@ -342,13 +342,11 @@ wheels = [
 
 [[package]]
 name = "djresttoolkit"
-version = "0.8.0"
+version = "1.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "faker" },
     { name = "pydantic" },
-    { name = "pydantic-settings" },
-    { name = "pyyaml" },
 ]
 
 [package.optional-dependencies]
@@ -380,9 +378,7 @@ requires-dist = [
     { name = "faker", specifier = ">=37.5.3" },
     { name = "mypy", marker = "extra == 'dev'" },
     { name = "pydantic", specifier = ">=2.11.7" },
-    { name = "pydantic-settings", specifier = ">=2.10.1" },
     { name = "pytest", marker = "extra == 'dev'" },
-    { name = "pyyaml", specifier = ">=6.0.2" },
     { name = "ruff", marker = "extra == 'dev'" },
 ]
 provides-extras = ["dev"]

djresttoolkit-0.17.4/src/djresttoolkit/envconfig/__init__.py

@@ -1,3 +0,0 @@
-from ._env_settings import EnvBaseSettings
-
-__all__ = ["EnvBaseSettings"]

djresttoolkit-0.17.4/src/djresttoolkit/envconfig/_env_settings.py

@@ -1,84 +0,0 @@
-import warnings
-from pathlib import Path
-from typing import Any, ClassVar
-
-import yaml
-from pydantic_settings import BaseSettings, SettingsConfigDict
-
-
-class EnvBaseSettings[T: "EnvBaseSettings"](BaseSettings):
-    """ "
-    EnvBaseSettings is a base settings class for managing application configuration
-    using both YAML files and environment variables.
-    This class is designed to load configuration values from a YAML file first,
-    and then override those values with environment variables if present. It supports
-    nested configuration using a double underscore (`__`) as the delimiter in
-    environment variable names, allowing for hierarchical settings.
-
-    Class Attributes:
-        env_file (str): The default filename for the environment variables file (default: ".env").
-        yaml_file (str): The default filename for the YAML configuration file (default: ".environ.yaml").
-        model_config (SettingsConfigDict): Configuration for environment variable parsing, including file encoding and nested delimiter.
-
-    Methods:
-        load(cls, *, env_file: str | None = None, ymal_file: str | None = None, warning: bool = True) -> "EnvBaseSettings":
-            Loads configuration from a YAML file (if it exists), then overrides with environment variables.
-            - env_file: Optional custom path to the .env file.
-            - ymal_file: Optional custom path to the YAML file.
-            - warning: If True, emits a warning if the YAML file is not found.
-            Returns an instance of EnvBaseSettings with the loaded configuration.
-
-    Usage:
-        - Define your settings as subclasses of EnvBaseSettings.
-        - Call `YourSettingsClass.load()` to load configuration from files and environment variables.
-        - Supports nested configuration via double underscore in environment variable names (e.g., `DATABASE__HOST`).
-
-    Raises:
-        - UserWarning: If the YAML file is not found and `warning` is True.
-
-    Example:
-    ```python
-        from djresttoolkit.envconfig import EnvBaseSettings
-        
-        class EnvSettings(EnvBaseSettings):
-            debug: bool = False
-            database_url: str
-            
-        settings = EnvSettings.load(warning=False)
-    ```
-
-    """
-
-    env_file: ClassVar[str] = ".env"
-    yaml_file: ClassVar[str] = ".environ.yaml"
-
-    model_config = SettingsConfigDict(
-        env_file=env_file,
-        env_file_encoding="utf-8",
-        env_nested_delimiter="__",
-    )
-
-    @classmethod
-    def load(
-        cls: type[T],
-        *,
-        env_file: str | None = None,
-        ymal_file: str | None = None,
-        warning: bool = True,
-    ) -> T:
-        """Load from YAML first, then override with .env."""
-        if env_file:
-            cls.env_file = env_file
-        if ymal_file:
-            cls.yaml_file = ymal_file
-
-        config_file = Path(cls.yaml_file)
-        yaml_data: dict[str, Any] = {}
-        if config_file.exists():
-            with config_file.open("r") as f:
-                yaml_data = yaml.safe_load(f) or {}
-        elif warning:
-            msg: str = f"Config file {config_file} not found, using only env vars."
-            warnings.warn(msg, UserWarning, stacklevel=1)
-
-        return cls(**yaml_data)