updated configuration provider interface and doc

Author: warmagedon007

docs/providers/configuration.rst

@@ -212,6 +212,19 @@ the container will call ``config.from_pydantic()`` automatically:
    if __name__ == "__main__":
        container = Container()  # Config is loaded from Settings()
 
+In addition, if you need the pydantic instance to be initialized on use, you can provide ``pydantic_settings.BaseSettings`` type instead.
+The container will initialize a pydantic instance on load without kwargs.
+
+.. code-block:: python
+   :emphasize-lines: 3
+
+   class Container(containers.DeclarativeContainer):
+
+       config = providers.Configuration(pydantic_settings=[Settings])
+
+
+   if __name__ == "__main__":
+       container = Container()  # Config is loaded from Settings instance that is initialized
 
 .. note::
 

src/dependency_injector/providers.pyi

@@ -272,7 +272,7 @@ class Configuration(Object[Any]):
         ini_files: Optional[_Iterable[Union[Path, str]]] = None,
         yaml_files: Optional[_Iterable[Union[Path, str]]] = None,
         json_files: Optional[_Iterable[Union[Path, str]]] = None,
-        pydantic_settings: Optional[_Iterable[PydanticSettings]] = None,
+        pydantic_settings: Optional[_Iterable[Union[PydanticSettings, Type[PydanticSettings]]]] = None,
     ) -> None: ...
     def __enter__(self) -> _Self: ...
     def __exit__(self, *exc_info: Any) -> None: ...
@@ -292,8 +292,8 @@ class Configuration(Object[Any]):
     def set_yaml_files(self, files: _Iterable[Union[Path, str]]) -> _Self: ...
     def get_json_files(self) -> _List[Union[Path, str]]: ...
     def set_json_files(self, files: _Iterable[Union[Path, str]]) -> _Self: ...
-    def get_pydantic_settings(self) -> _List[PydanticSettings]: ...
-    def set_pydantic_settings(self, settings: _Iterable[PydanticSettings]) -> _Self: ...
+    def get_pydantic_settings(self) -> _List[Union[PydanticSettings, Type[PydanticSettings]]]: ...
+    def set_pydantic_settings(self, settings: _Iterable[Union[PydanticSettings, Type[PydanticSettings]]]) -> _Self: ...
     def load(self, required: bool = False, envs_required: bool = False) -> None: ...
     def get(self, selector: str) -> Any: ...
     def set(self, selector: str, value: Any) -> OverridingContext[P]: ...
@@ -319,7 +319,7 @@ class Configuration(Object[Any]):
         envs_required: bool = False,
     ) -> None: ...
     def from_pydantic(
-        self, settings: PydanticSettings, required: bool = False, **kwargs: Any
+        self, settings: Union[PydanticSettings, Type[PydanticSettings]], required: bool = False, **kwargs: Any
     ) -> None: ...
     def from_dict(self, options: _Dict[str, Any], required: bool = False) -> None: ...
     def from_env(

tests/typing/configuration.py

@@ -33,6 +33,8 @@
 
 config2.from_pydantic(PydanticSettings())
 
+config2.from_pydantic(PydanticSettings)
+
 # Test 3: to check as_*() methods
 config3 = providers.Configuration()
 int3 = config3.option.as_int()
@@ -91,3 +93,8 @@
     strict=True,
     default={},
 )
+
+# Test 7: pydantic class
+config7_pydantic_class = providers.Configuration(
+    pydantic_settings=[PydanticSettings]
+)