feat: add support for lazy load in providers

Author: fede-bello

pydantic_settings/sources/providers/aws.py

@@ -44,6 +44,7 @@ def __init__(
         env_parse_none_str: str | None = None,
         env_parse_enums: bool | None = None,
         version_id: str | None = None,
+        lazy_load: bool | None = None,
     ) -> None:
         import_aws_secrets_manager()
         self._secretsmanager_client = boto3_client('secretsmanager', region_name=region_name, endpoint_url=endpoint_url)  # type: ignore
@@ -57,6 +58,7 @@ def __init__(
             env_ignore_empty=False,
             env_parse_none_str=env_parse_none_str,
             env_parse_enums=env_parse_enums,
+            lazy_load=lazy_load,
         )
 
     def _load_env_vars(self) -> Mapping[str, str | None]:

pydantic_settings/sources/providers/azure.py

@@ -105,6 +105,7 @@ def __init__(
         env_prefix: str | None = None,
         env_parse_none_str: str | None = None,
         env_parse_enums: bool | None = None,
+        lazy_load: bool | None = None,
     ) -> None:
         import_azure_key_vault()
         self._url = url
@@ -119,6 +120,7 @@ def __init__(
             env_ignore_empty=False,
             env_parse_none_str=env_parse_none_str,
             env_parse_enums=env_parse_enums,
+            lazy_load=lazy_load,
         )
 
     def _load_env_vars(self) -> Mapping[str, str | None]:

pydantic_settings/sources/providers/cli.py

@@ -308,6 +308,7 @@ def __init__(
         cli_kebab_case: bool | Literal['all', 'no_enums'] | None = None,
         cli_shortcuts: Mapping[str, str | list[str]] | None = None,
         case_sensitive: bool | None = True,
+        lazy_load: bool | None = None,
         root_parser: Any = None,
         parse_args_method: Callable[..., Any] | None = None,
         add_argument_method: Callable[..., Any] | None = ArgumentParser.add_argument,
@@ -384,6 +385,7 @@ def __init__(
             env_parse_enums=True,
             env_prefix=self.cli_prefix,
             case_sensitive=case_sensitive,
+            lazy_load=lazy_load,
         )
 
         root_parser = (

pydantic_settings/sources/providers/dotenv.py

@@ -43,6 +43,7 @@ def __init__(
         env_ignore_empty: bool | None = None,
         env_parse_none_str: str | None = None,
         env_parse_enums: bool | None = None,
+        lazy_load: bool | None = None,
     ) -> None:
         self.env_file = env_file if env_file != ENV_FILE_SENTINEL else settings_cls.model_config.get('env_file')
         self.env_file_encoding = (
@@ -57,6 +58,7 @@ def __init__(
             env_ignore_empty,
             env_parse_none_str,
             env_parse_enums,
+            lazy_load,
         )
 
     def _load_env_vars(self) -> Mapping[str, str | None]:

pydantic_settings/sources/providers/env.py

@@ -45,9 +45,10 @@ def __init__(
         env_ignore_empty: bool | None = None,
         env_parse_none_str: str | None = None,
         env_parse_enums: bool | None = None,
+        lazy_load: bool | None = None,
     ) -> None:
         super().__init__(
-            settings_cls, case_sensitive, env_prefix, env_ignore_empty, env_parse_none_str, env_parse_enums
+            settings_cls, case_sensitive, env_prefix, env_ignore_empty, env_parse_none_str, env_parse_enums, lazy_load
         )
         self.env_nested_delimiter = (
             env_nested_delimiter if env_nested_delimiter is not None else self.config.get('env_nested_delimiter')

pydantic_settings/sources/providers/gcp.py

@@ -102,6 +102,7 @@ def __init__(
         env_parse_enums: bool | None = None,
         secret_client: SecretManagerServiceClient | None = None,
         case_sensitive: bool | None = True,
+        lazy_load: bool | None = None,
     ) -> None:
         # Import Google Packages if they haven't already been imported
         if SecretManagerServiceClient is None or Credentials is None or google_auth_default is None:
@@ -131,14 +132,14 @@ def __init__(
             self._secret_client = secret_client
         else:
             self._secret_client = SecretManagerServiceClient(credentials=self._credentials)
-
         super().__init__(
             settings_cls,
             case_sensitive=case_sensitive,
             env_prefix=env_prefix,
             env_ignore_empty=False,
             env_parse_none_str=env_parse_none_str,
             env_parse_enums=env_parse_enums,
+            lazy_load=lazy_load,
         )
 
     def _load_env_vars(self) -> Mapping[str, str | None]:

pydantic_settings/sources/providers/nested_secrets.py

@@ -31,6 +31,7 @@ def __init__(
         secrets_prefix: str | None = None,
         secrets_nested_delimiter: str | None = None,
         secrets_nested_subdir: bool | None = None,
+        lazy_load: bool | None = None,
         # args for compatibility with SecretsSettingsSource, don't use directly
         case_sensitive: bool | None = None,
         env_prefix: str | None = None,
@@ -115,6 +116,7 @@ def __init__(
             env_ignore_empty=False,  # match SecretsSettingsSource behaviour
             env_parse_enums=True,  # we can pass everything here, it will still behave as "True"
             env_parse_none_str=None,  # match SecretsSettingsSource behaviour
+            lazy_load=lazy_load,
         )
         self.env_parse_none_str = None  # update manually because of None
 

pydantic_settings/sources/providers/secrets.py

@@ -36,9 +36,10 @@ def __init__(
         env_ignore_empty: bool | None = None,
         env_parse_none_str: str | None = None,
         env_parse_enums: bool | None = None,
+        lazy_load: bool | None = None,
     ) -> None:
         super().__init__(
-            settings_cls, case_sensitive, env_prefix, env_ignore_empty, env_parse_none_str, env_parse_enums
+            settings_cls, case_sensitive, env_prefix, env_ignore_empty, env_parse_none_str, env_parse_enums, lazy_load
         )
         self.secrets_dir = secrets_dir if secrets_dir is not None else self.config.get('secrets_dir')