From: Rob Berry <rob@lostpropertyhq.com>
Date: Thu, 18 Dec 2014 13:17:11 +0000 (+0000)
Subject: Update gaerdbms to highlight improved connection method
X-Git-Tag: rel_0_9_9~57
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=216ef0408435795cc01010f8572cd10c78d6e86f;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

Update gaerdbms to highlight improved connection method

(cherry picked from commit 0d15791a6e3ec35e3c2e297026d8396742e30a34)
---

diff --git a/lib/sqlalchemy/dialects/mysql/gaerdbms.py b/lib/sqlalchemy/dialects/mysql/gaerdbms.py
index 0059f5a656..947b066cc4 100644
--- a/lib/sqlalchemy/dialects/mysql/gaerdbms.py
+++ b/lib/sqlalchemy/dialects/mysql/gaerdbms.py
@@ -17,6 +17,10 @@ developers-guide
 
     .. versionadded:: 0.7.8
 
+    .. deprecated:: 1.0 Cloud SQL now recommends creating connections via the
+        mysql dialect using the URL format
+        `mysql://root@/<dbname>?unix_socket=/cloudsql/<projectid>:<instancename>`
+
 
 Pooling
 -------
@@ -33,6 +37,14 @@ import os
 from .mysqldb import MySQLDialect_mysqldb
 from ...pool import NullPool
 import re
+from sqlalchemy.util import warn_deprecated
+
+
+warn_deprecated(
+    "Google Cloud SQL now recommends creating connections via the "
+    "mysql dialect using the URL format "
+    "mysql://root@/<dbname>?unix_socket=/cloudsql/<projectid>:<instancename>"
+)
 
 
 def _is_dev_environment():