Feature mysqlclient

MySQL-Python hasn't been released in about five years and there
is no reason that it should be listed as a viable DBAPI;
all MySQL / MariaDB users should be using mysqlclient or PyMySQL today.

Change-Id: I2f12babe6e60bc7393398400a125d0592e86dbb8

1 files changed, 12 insertions, 10 deletions

diff --git a/lib/sqlalchemy/dialects/mysql/mysqldb.py b/lib/sqlalchemy/dialects/mysql/mysqldb.py
index 9f1dd7d8b..744909170 100644
--- a/lib/sqlalchemy/dialects/mysql/mysqldb.py
+++ b/lib/sqlalchemy/dialects/mysql/mysqldb.py
@@ -8,10 +8,20 @@
 """
 
 .. dialect:: mysql+mysqldb
-    :name: MySQL-Python
+    :name: mysqlclient (maintained fork of MySQL-Python)
     :dbapi: mysqldb
     :connectstring: mysql+mysqldb://<user>:<password>@<host>[:<port>]/<dbname>
-    :url: http://sourceforge.net/projects/mysql-python
+    :url: https://pypi.org/project/mysqlclient/
+
+Driver Status
+-------------
+
+The mysqlclient DBAPI is a maintained fork of the
+`MySQL-Python <http://sourceforge.net/projects/mysql-python>`_ DBAPI
+that is no longer maintained.  `mysqlclient`_ supports Python 2 and Python 3
+and is very stable.
+
+.. _mysqlclient: https://github.com/PyMySQL/mysqlclient-python
 
 .. _mysqldb_unicode:
 
@@ -21,14 +31,6 @@ Unicode
 Please see :ref:`mysql_unicode` for current recommendations on unicode
 handling.
 
-Py3K Support
-------------
-
-Currently, MySQLdb only runs on Python 2 and development has been stopped.
-`mysqlclient`_ is fork of MySQLdb and provides Python 3 support as well
-as some bugfixes.
-
-.. _mysqlclient: https://github.com/PyMySQL/mysqlclient-python
 
 Using MySQLdb with Google Cloud SQL
 -----------------------------------