]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commitdiff
Merge branch 'mysqlclient' of https://bitbucket.org/methane/sqlalchemy into pr48
authorMike Bayer <mike_mp@zzzcomputing.com>
Fri, 20 Mar 2015 19:17:07 +0000 (15:17 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Fri, 20 Mar 2015 19:17:07 +0000 (15:17 -0400)
Conflicts:
lib/sqlalchemy/dialects/mysql/mysqldb.py

1  2 
lib/sqlalchemy/dialects/mysql/mysqldb.py

index c61b0984685e96c34a4f287820b89e76102989cb,b18930b66379be29e35b18f79d08320e540288b4..c1c576e106fbaff493602c4a95f5d0afede6dc2f
@@@ -29,18 -28,11 +29,27 @@@ unicode** will include both charset an
  
      create_engine("mysql+mysqldb://user:pass@host/dbname?charset=utf8&use_unicode=0")
  
 -As of this writing, MySQLdb only runs on Python 2 and development has been stopped.
 -`mysqlclient`_ is fork of MySQLdb and provides Python 3 support and some bugfixes.
 +The ``'utf8'`` charset on MySQL only supports **up to three-byte codepoints**,
 +and not four-byte codepoints as normally supported by utf8.  In order to
 +support all unicode codepoints, MySQL versions 5.5.3 and above
 +provide a MySQL-specific encoding ``'utf8mb4'``, which supports
 +codepoints up to four bytes in size::
 +
 +    create_engine("mysql+mysqldb://user:pass@host/dbname?charset=utf8mb4&use_unicode=0")
 +
 +.. seealso::
 +
 +    :ref:`mysql_unicode` - Includes background on the ``'utf8mb4'`` character set.
 +
++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
  
  Known Issues
  -------------