Opened 9 years ago
Closed 9 years ago
#25111 closed Cleanup/optimization (invalid)
Tutorial for 1.8 breaks with recommended mysql settings
Reported by: | JorisBenschop | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.8 |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Unreviewed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | yes | UI/UX: | no |
Description
The current tutorial mentions it is optimized for python 3.2. However, on page 1 it recommends using "django.db.backends.mysql" to interact with mysql. This yields an error because this backend loads the MySQLdb module which does not exist for python 3.2. Considering this is page 1 of the basic tutorial such an error should not happen.
Possible solution would be change the docs to specify that django has a dependncy on mysql.connector.python, and suggest the appropriate backend. I know this connector is external, but so is MySQLdb.
Personally i would recommend to alter the code that runs "import MySQLdb" to include an exception that checks if python version is > 3 and return a message asking the user to install the correct module. Asking to install MySQLdb from python3 users is confusing.
Apologies if this is a diplicate
Never mind I should have read the docs that tell me to load mysqlclient and everything works