:connectstring: mysql+aiomysql://user:password@host:port/dbname[?key=value&key=value...]
:url: https://github.com/aio-libs/aiomysql
-.. warning:: The aiomysql dialect as of September, 2021 appears to be unmaintained
- and no longer functions for Python version 3.10. Please refer to the
- :ref:`asyncmy` dialect for current MySQL/MariaDD asyncio functionality.
+.. warning:: The aiomysql dialect is not currently tested as part of
+ SQLAlchemy’s continuous integration. As of September, 2021 the driver
+ appears to be unmaintained and no longer functions for Python version 3.10,
+ and additionally depends on a significantly outdated version of PyMySQL.
+ Please refer to the :ref:`asyncmy` dialect for current MySQL/MariaDB asyncio
+ functionality.
The aiomysql dialect is SQLAlchemy's second Python asyncio dialect.
aiomysql;python_version>="3"
asyncmy =
%(asyncio)s
- asyncmy>=0.2.0,!=0.2.1,!=0.2.2;python_version>="3"
+ asyncmy>=0.2.3;python_version>="3"
aiosqlite =
%(asyncio)s
aiosqlite;python_version>="3"
mysql: .[mysql]
mysql: .[pymysql]
- mysql: git+https://github.com/sqlalchemy/aiomysql@sqlalchemy_tox; python_version >= '3'
mysql: .[asyncmy]; python_version >= '3'
mysql: .[mariadb_connector]; python_version >= '3'
py2{,7}-mysql: MYSQL={env:TOX_MYSQL_PY2K:{env:TOX_MYSQL:--db mysql}}
mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql}
- py3{,5,6,7,8,9}-mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql --dbdriver mariadbconnector --dbdriver aiomysql}
- # omit aiomysql for Python 3.10
- py3{,10,11}-mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql --dbdriver mariadbconnector }
+ py3-mysql: EXTRA_MYSQL_DRIVERS={env:EXTRA_MYSQL_DRIVERS:--dbdriver mysqldb --dbdriver pymysql --dbdriver mariadbconnector --dbdriver asyncmy}
mssql: MSSQL={env:TOX_MSSQL:--db mssql}