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

Change History (1)

comment:1 by JorisBenschop, 9 years ago

Resolution: invalid
Status: newclosed

Never mind I should have read the docs that tell me to load mysqlclient and everything works

Note: See TracTickets for help on using tickets.
Back to Top