Added backward compatibility test for ConnectionHandler.databases property.

ngnpope · felixxm · commit d3677043fce0 · 2022-05-13T12:01:07.000+02:00
The ConnectionHandler.databases property is no longer used within
Django, but it is maintained for backward compatibility with 3rd party
packages that have used this private API in the past.
diff --git a/django/db/utils.py b/django/db/utils.py
@@ -183,6 +183,9 @@ def configure_settings(self, databases):
 
     @property
     def databases(self):
+        # Maintained for backward compatibility as some 3rd party packages have
+        # made use of this private API in the past. It is no longer used within
+        # Django itself.
         return self.settings
 
     def create_connection(self, alias):
diff --git a/tests/db_utils/tests.py b/tests/db_utils/tests.py
@@ -40,6 +40,14 @@ def test_no_default_database(self):
         with self.assertRaisesMessage(ImproperlyConfigured, msg):
             conns["other"].ensure_connection()
 
+    def test_databases_property(self):
+        # The "databases" property is maintained for backwards compatibility
+        # with 3rd party packages. It should be an alias of the "settings"
+        # property.
+        conn = ConnectionHandler({})
+        self.assertNotEqual(conn.settings, {})
+        self.assertEqual(conn.settings, conn.databases)
+
     def test_nonexistent_alias(self):
         msg = "The connection 'nonexistent' doesn't exist."
         conns = ConnectionHandler(
