mirror of
https://github.com/moparisthebest/SickRage
synced 2024-08-13 16:53:54 -04:00
95 lines
3.4 KiB
Python
95 lines
3.4 KiB
Python
# mysql/mysqldb.py
|
|
# Copyright (C) 2005-2014 the SQLAlchemy authors and contributors <see AUTHORS file>
|
|
#
|
|
# This module is part of SQLAlchemy and is released under
|
|
# the MIT License: http://www.opensource.org/licenses/mit-license.php
|
|
|
|
"""
|
|
|
|
.. dialect:: mysql+mysqldb
|
|
:name: MySQL-Python
|
|
:dbapi: mysqldb
|
|
:connectstring: mysql+mysqldb://<user>:<password>@<host>[:<port>]/<dbname>
|
|
:url: http://sourceforge.net/projects/mysql-python
|
|
|
|
|
|
Unicode
|
|
-------
|
|
|
|
MySQLdb requires a "charset" parameter to be passed in order for it
|
|
to handle non-ASCII characters correctly. When this parameter is passed,
|
|
MySQLdb will also implicitly set the "use_unicode" flag to true, which means
|
|
that it will return Python unicode objects instead of bytestrings.
|
|
However, SQLAlchemy's decode process, when C extensions are enabled,
|
|
is orders of magnitude faster than that of MySQLdb as it does not call into
|
|
Python functions to do so. Therefore, the **recommended URL to use for
|
|
unicode** will include both charset and use_unicode=0::
|
|
|
|
create_engine("mysql+mysqldb://user:pass@host/dbname?charset=utf8&use_unicode=0")
|
|
|
|
As of this writing, MySQLdb only runs on Python 2. It is not known how
|
|
MySQLdb behaves on Python 3 as far as unicode decoding.
|
|
|
|
|
|
Known Issues
|
|
-------------
|
|
|
|
MySQL-python version 1.2.2 has a serious memory leak related
|
|
to unicode conversion, a feature which is disabled via ``use_unicode=0``.
|
|
It is strongly advised to use the latest version of MySQL-Python.
|
|
|
|
"""
|
|
|
|
from .base import (MySQLDialect, MySQLExecutionContext,
|
|
MySQLCompiler, MySQLIdentifierPreparer)
|
|
from ...connectors.mysqldb import (
|
|
MySQLDBExecutionContext,
|
|
MySQLDBCompiler,
|
|
MySQLDBIdentifierPreparer,
|
|
MySQLDBConnector
|
|
)
|
|
from .base import TEXT
|
|
from ... import sql
|
|
|
|
class MySQLExecutionContext_mysqldb(MySQLDBExecutionContext, MySQLExecutionContext):
|
|
pass
|
|
|
|
|
|
class MySQLCompiler_mysqldb(MySQLDBCompiler, MySQLCompiler):
|
|
pass
|
|
|
|
|
|
class MySQLIdentifierPreparer_mysqldb(MySQLDBIdentifierPreparer, MySQLIdentifierPreparer):
|
|
pass
|
|
|
|
|
|
class MySQLDialect_mysqldb(MySQLDBConnector, MySQLDialect):
|
|
execution_ctx_cls = MySQLExecutionContext_mysqldb
|
|
statement_compiler = MySQLCompiler_mysqldb
|
|
preparer = MySQLIdentifierPreparer_mysqldb
|
|
|
|
def _check_unicode_returns(self, connection):
|
|
# work around issue fixed in
|
|
# https://github.com/farcepest/MySQLdb1/commit/cd44524fef63bd3fcb71947392326e9742d520e8
|
|
# specific issue w/ the utf8_bin collation and unicode returns
|
|
|
|
has_utf8_bin = connection.scalar(
|
|
"show collation where %s = 'utf8' and %s = 'utf8_bin'"
|
|
% (
|
|
self.identifier_preparer.quote("Charset"),
|
|
self.identifier_preparer.quote("Collation")
|
|
))
|
|
if has_utf8_bin:
|
|
additional_tests = [
|
|
sql.collate(sql.cast(
|
|
sql.literal_column(
|
|
"'test collated returns'"),
|
|
TEXT(charset='utf8')), "utf8_bin")
|
|
]
|
|
else:
|
|
additional_tests = []
|
|
return super(MySQLDBConnector, self)._check_unicode_returns(
|
|
connection, additional_tests)
|
|
|
|
dialect = MySQLDialect_mysqldb
|