Hide the toolbar's models when the database store isn't used.

Author: tim-schilling

debug_toolbar/apps.py

@@ -26,6 +26,13 @@ def ready(self):
             cls.ready()
         _manage_migrations_visibility(self.name)
 
+    def import_models(self):
+        dt_config = dt_settings.get_config()
+        if dt_config["TOOLBAR_STORE_CLASS"] == "debug_toolbar.store.DatabaseStore":
+            return super().import_models()
+        # Not using the database store, don't import the models
+        self.models = {}
+
 
 def _manage_migrations_visibility(app_name):
     """

docs/changes.rst

@@ -16,8 +16,11 @@ Pending
 * Upgraded CI ``postgis`` version to 17-3.5.
 * Added how to generate the documentation locally to the contributing
   documentation.
-* Hide the toolbar's migrations unless the database store is being used. This
-  may change in the future.
+* Hide the toolbar's migrations unless ``debug_toolbar.store.DatabaseStore``
+  is being used. This may change in the future.
+* Hide ``debug_toolbar.HistoryEntry`` as a model unless
+  ``debug_toolbar.store.DatabaseStore`` is being used. This may change in the
+  future.
 
 6.0.0 (2025-07-22)
 ------------------

tests/test_apps.py

@@ -1,5 +1,6 @@
 from unittest.mock import patch
 
+from django.apps import apps
 from django.test import SimpleTestCase, override_settings
 
 from debug_toolbar.apps import _manage_migrations_visibility
@@ -25,3 +26,22 @@ def test_migrations_are_hidden(self, mocked_migration_modules):
         mocked_migration_modules.setdefault.assert_called_once_with(
             "debug_toolbar", None
         )
+
+    @override_settings(
+        DEBUG_TOOLBAR_CONFIG={
+            "TOOLBAR_STORE_CLASS": "debug_toolbar.store.DatabaseStore"
+        }
+    )
+    def test_models_are_visible(self):
+        app_config = apps.get_app_config("debug_toolbar")
+        app_config.import_models()
+        apps.get_model("debug_toolbar", "HistoryEntry")
+
+    @override_settings(
+        DEBUG_TOOLBAR_CONFIG={"TOOLBAR_STORE_CLASS": "debug_toolbar.store.MemoryStore"}
+    )
+    def test_models_are_hidden(self):
+        app_config = apps.get_app_config("debug_toolbar")
+        app_config.import_models()
+        with self.assertRaises(LookupError):
+            apps.get_model("debug_toolbar", "HistoryEntry")