Opened 10 years ago
Last modified 10 years ago
#23446 closed New feature
mysqldb1 is no longer maintained and should not be recommended — at Initial Version
Reported by: | frewsxcv | Owned by: | nobody |
---|---|---|---|
Component: | Database layer (models, ORM) | Version: | dev |
Severity: | Normal | Keywords: | |
Cc: | frewsxcv, django@… | Triage Stage: | Ready for checkin |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
Currently, the documentation recommends mysqldb1. Here is why this recommendation is hurting the community, especially new users using MySQL with Django:
- mysqldb1 is not compatible with Python 3
- mysqldb1 has not had a commit since November 2013 (besides one tox commit from January 2014).
- mysqldb1's author, farcepest, is not addressing any of the GitHub issues (and is inactive on GitHub in general)
- the latest version of mysqldb1, 1.2.5 has a regression from its previous version 1 2 and it has not been addressed
In an attempt to solve this dilemma, I propose we stop recommending it as a MySQL driver in the documentation.
In replace of it, I would like to recommend a fork called [mysqlclient https://pypi.python.org/pypi/mysqlclient/1.3.2]. A diff between mysqlclient and mysqldb1 can be found here. Some of the benefits of mysqlclient over mysqldb1:
- mysqlclient supports Python 2.7 and Python 3.x (same as Django)
- mysqlclient is authored by the same team that authored PyMySQL and much more active
If others agree, I would be happy to write the copy in the documentation to support this change.