add support for is_loaded to allow conditional loading

CHANGES.rst

@@ -15,6 +15,7 @@ Unreleased
   ``initial_for_field`` instead.
 - ``Field`` now mirrors pydantic's typed signature, so its keyword arguments are
   type-checked and autocompleted.
+- ``GoodConf.is_loaded`` allows to check whether the configuration got loaded.
 
 7.0.0 (3 March 2026)
 ========================

README.rst

@@ -61,6 +61,7 @@ First, create a ``conf.py`` file in your project's directory, next to
         model_config = {"default_files": ["/etc/myproject/myproject.yaml", "myproject.yaml"]}
 
     config = AppConfig()
+    config.is_loaded  # False at this point, till `config.load()` is executed (see below)
 
 Next, use the config in your ``settings.py`` file:
 

goodconf/__init__.py

@@ -201,6 +201,8 @@ def __repr__(self) -> str:
 
 
 class GoodConf(BaseSettings):
+    _is_loaded: bool = False
+
     def __init__(
         self,
         load: bool = False,  # noqa: FBT001, FBT002 — documented public-API positional
@@ -262,10 +264,18 @@ def _load(
         if config_file := _config_file or _init_config_file:
             kwargs["_config_file"] = config_file
         super().__init__(**kwargs)
+        self._is_loaded = True
 
     def load(self, filename: str | None = None) -> None:
         self._load(_config_file=filename)
 
+    @property
+    def is_loaded(self) -> bool:
+        try:
+            return self._is_loaded
+        except AttributeError:
+            return False
+
     @classmethod
     def get_initial(cls, **override: t.Any) -> dict[str, t.Any]:
         return {

pyproject.toml

@@ -29,7 +29,7 @@ classifiers = [
 ]
 dependencies = [
   "pydantic-settings>=2.13",
-  "pydantic>=2.7",
+  "pydantic>=2.12",
 ]
 description = "Load configuration variables from a file or environment"
 dynamic = ["version"]

tests/test_goodconf.py

@@ -281,3 +281,17 @@ class SettingsClass:
         False,
     )
     assert fileconfigsettingssource.get_field_value(None, "a") == (None, "", False)  # type: ignore[arg-type]
+
+
+def test_config_is_loaded() -> None:
+
+    class TestConf(GoodConf):
+        a: bool = False
+
+    cfg = TestConf()
+    assert cfg.is_loaded is False
+    cfg.load()
+    assert cfg.is_loaded is True
+
+    cfg = TestConf(load=True)
+    assert cfg.is_loaded is True