search

DjangoGirls / tutorial

This is a tutorial we are using for Django Girls workshops
http://tutorial.djangogirls.org/
Other
1.53k stars 1.86k forks source link

Python version incompatibility with PythonAnywhere #1839

Open ChaosCrafter opened 2 months ago

ChaosCrafter commented 2 months ago

Issue description

If the latest python version is installed (currently 3.12) then it is not supported by PythonAnywhere (PA), and the instuctions on PA setup don't make it clear that the pip version needs to match the python version. Pip3.10 and pa_autoconfigure_django.py --python=3.10 do work for python3.12 (at least as far as django templates stage, I've not explored further), but pip3.8 throws an error, and pa_autoconfigure_django.py --python=3.8 throws a page of library mismatches.

Suggestion:

  1. Update the PythonAnywhere to reference --python=3.10 and pip3.10, or at least explain the need to use the right python version and the limits on PythonAnywhere.
  2. Worst case, explain the meaning of the errors that occur when the wrong python version is used to help troubleshooting
  3. Update the install instructions to specify that python version 3.10 (rather than "latest") should be the one installed.
  4. If possible, monitor PythonAnywhere to track the latest python version supported, and update the site accordingly. Ideally, have LATEST_RECOMMENDED_PYTHON=3.10 defined on the site and used in the spots where the python version can change so it can be easily updated in one spot.

Language

This has been seen in the English language version, but likely exists in all languages.

Operating system

Seen while building in Windows, but OS independent, as it's a python version issue.