modules: add charset connection option

plugins/doc_fragments/mysql.py

@@ -70,6 +70,11 @@ options:
       - This optoin has no effect on MySQLdb.
     type: bool
     version_added: '1.1.0'
+  charset:
+    description:
+      - Charset value of the same database driver option.
+    type: str
+    version_added: '2.0.0'
 requirements:
    - PyMySQL (Python 2.7 and Python 3.X), or
    - MySQLdb (Python 2.x)

plugins/module_utils/mysql.py

@@ -43,7 +43,7 @@ def parse_from_mysql_config_file(cnf):
 
 def mysql_connect(module, login_user=None, login_password=None, config_file='', ssl_cert=None,
                   ssl_key=None, ssl_ca=None, db=None, cursor_class=None, connect_timeout=30,
-                  autocommit=False, config_overrides_defaults=False, check_hostname=None):
+                  autocommit=False, config_overrides_defaults=False, check_hostname=None, charset=None):
     config = {}
 
     if config_file and os.path.exists(config_file):
@@ -97,6 +97,8 @@ def mysql_connect(module, login_user=None, login_password=None, config_file='',
                 config['ssl']['check_hostname'] = check_hostname
             else:
                 module.fail_json(msg='To use check_hostname, pymysql >= 0.7.11 is required on the target host')
+    if charset is not None:
+        config['charset'] = charset
 
     if _mysql_cursor_param == 'cursor':
         # In case of PyMySQL driver:
@@ -132,6 +134,7 @@ def mysql_common_argument_spec():
         client_key=dict(type='path', aliases=['ssl_key']),
         ca_cert=dict(type='path', aliases=['ssl_ca']),
         check_hostname=dict(type='bool', default=None),
+        charset=dict(type='str'),
     )
 
 

plugins/modules/mysql_query.py

@@ -148,6 +148,7 @@ def main():
     check_hostname = module.params['check_hostname']
     config_file = module.params['config_file']
     query = module.params["query"]
+    charset = module.params["charset"]
 
     if not isinstance(query, (str, list)):
         module.fail_json(msg="the query option value must be a string or list, passed %s" % type(query))
@@ -180,7 +181,8 @@ def main():
                                               config_file, ssl_cert, ssl_key, ssl_ca, db,
                                               check_hostname=check_hostname,
                                               connect_timeout=connect_timeout,
-                                              cursor_class='DictCursor', autocommit=autocommit)
+                                              cursor_class='DictCursor', autocommit=autocommit,
+                                              charset=charset)
     except Exception as e:
         module.fail_json(msg="unable to connect to database, check login_user and "
                              "login_password are correct or %s has the credentials. "

plugins/modules/mysql_user.py

@@ -1161,6 +1161,8 @@ def main():
     plugin_hash_string = module.params["plugin_hash_string"]
     plugin_auth_string = module.params["plugin_auth_string"]
     resource_limits = module.params["resource_limits"]
+    charset = module.params["charset"]
+
     if priv and not isinstance(priv, (str, dict)):
         module.fail_json(msg="priv parameter must be str or dict but %s was passed" % type(priv))
 
@@ -1175,7 +1177,7 @@ def main():
         if check_implicit_admin:
             try:
                 cursor, db_conn = mysql_connect(module, "root", "", config_file, ssl_cert, ssl_key, ssl_ca, db,
-                                                connect_timeout=connect_timeout, check_hostname=check_hostname)
+                                                connect_timeout=connect_timeout, check_hostname=check_hostname, charset=charset)
             except Exception:
                 pass