Add a constant to specify SSL_MODE.

Author: Jun Yamasaki

MySQLdb/__init__.py

@@ -27,7 +27,7 @@
 
 from ._mysql import *
 from MySQLdb.compat import PY2
-from MySQLdb.constants import FIELD_TYPE
+from MySQLdb.constants import FIELD_TYPE, SSL_MODE
 from MySQLdb.times import Date, Time, Timestamp, \
     DateFromTicks, TimeFromTicks, TimestampFromTicks
 

MySQLdb/constants/SSL_MODE.py

@@ -0,0 +1,11 @@
+"""MySQL SSL_MODE Constants
+
+These constants are used to specify SSL_MODE.
+
+"""
+
+DISABLED = 1
+PREFERRED = 2
+REQUIRED = 3
+VERIFY_CA = 4
+VERIFY_IDENTITY = 5

MySQLdb/constants/__init__.py

@@ -1 +1 @@
-__all__ = ['CR', 'FIELD_TYPE','CLIENT','ER','FLAG']
+__all__ = ['CR', 'FIELD_TYPE','CLIENT','ER','FLAG','SSL_MODE']

doc/MySQLdb.constants.rst

@@ -49,3 +49,10 @@ constants Package
     :undoc-members:
     :show-inheritance:
 
+:mod:`SSL_MODE` Module
+------------------
+
+.. automodule:: MySQLdb.constants.SSL_MODE
+    :members:
+    :undoc-members:
+    :show-inheritance:

doc/user_guide.rst

@@ -357,6 +357,17 @@ connect(parameters...)
 
             *This must be a keyword parameter.*
 
+         ssl_mode
+            If present, specify the security settings for the
+            connection to the server. For more information on ssl_mode,
+            see the MySQL documentation. The constants can be referenced
+            as follows: ``MySQLdb.constants.PREFERRED``
+
+            If not present, the session ssl_mode will be unchanged,
+            but it becomes PREFERRED in Version 5.7 or later.
+
+            *This must be a keyword parameter.*
+
          ssl
             This parameter takes a dictionary or mapping, where the
             keys are parameter names used by the mysql_ssl_set_ MySQL

metadata.cfg

@@ -40,3 +40,4 @@ py_modules:
         MySQLdb.constants.ER
         MySQLdb.constants.FIELD_TYPE
         MySQLdb.constants.FLAG
+        MySQLdb.constants.SSL_MODE