Merge pull request #16 from hmohammad2520-org:evmod_loader

Added `envmod_loader` implementation

Author: HMohammad2520

README.md

@@ -91,9 +91,41 @@ class Config:
 ENVMod.save_example('.my_example_path')
 ENVMod.load_dotenv('.my_env')
 ENVMod.sync_env_file('.my_env')
+```
+
+#### Recommended (Type-safe, IDE-friendly) Argument Loading
+
+```python
 config = Config(**ENVMod.load_args(Config.__init__), session=Session())
 ```
 
+**Why this is recommended:**
+
+* Full IDE autocompletion
+* No static type checker errors
+* Explicit and predictable behavior
+* Best for libraries, frameworks, production code
+
+---
+
+#### Convenience Mode (Runtime Magic) Argument Loading
+
+```python
+config = Config(envmod_loader, session=Session()) #type: ignore
+```
+
+**What this does:**
+
+* Automatically loads environment variables
+* Injects them into `__init__`
+* Overrides missing arguments
+
+**Why `# type: ignore` is required:**
+
+* Static analyzers cannot infer runtime argument injection
+* This is intentional and documented behavior
+
+
 ### Method Monitor
 
 ```python

classmods/_env_mod.py

@@ -259,11 +259,15 @@ def register(
             >>> api_service = APIService(**ENVMod.load_args(APIService.__init__))
             >>> db_service = AnotherService(**ENVMod.load_args(AnotherService.connect_db))
 
+            ## Not Recommended ##
+            >>> api_service = APIService(envmod_loader=True) #type: ignore
+
         Notes:
             - Type hints must be provided to ensure proper type casting from environment strings.
             - Default values are automatically handled; required parameters are those without defaults.
             - Environment variable names are generated using the section name and the parameter name
             (e.g., "API_HOST").
+            - You can use the `envmod_loader` as a parameter to magicly load args, but it is not IDE friendly.
         """
         exclude = exclude or []
 
@@ -307,11 +311,14 @@ def decorator(func: Callable) -> Callable:
 
             @wraps(func)
             def wrapper(*args: Any, **kwargs: Any) -> Any:
+                if kwargs.pop("envmod_loader", False):
+                    loaded_args = cls.load_args(func)
+                    kwargs = {**loaded_args, **kwargs}
                 return func(*args, **kwargs)
 
             cls._registry[wrapper] = section
-            return wrapper
 
+            return wrapper
         return decorator
 
     @classmethod