Conflict with Django startproject command, when installing DRF 3.15.2 (pulling Django 4.2.16)

[ivanleoncz]

I'm preparing a demo of DRF to a developer which I'm mentoring, showing the basics, etc. By installing DRF, it automatically pulls Django package along, thus allowing me to first create a project, through (for example) django-admin startproject tutorial.

I'm installing DRF 3.15.2 (automatically pulling Django 4.2.16).

For some reason, creating a project with name tutorial, results in conflict:

ivanleoncz@mother-base: ~/test_drf $ pwd
/home/ivanleoncz/test_drf

ivanleoncz@mother-base: ~/test_drf $ python3 -m venv venv
ivanleoncz@mother-base: ~/test_drf $ python3 --version
Python 3.8.10

ivanleoncz@mother-base: ~/test_drf $ pip3 --version
pip 24.2 from /home/ivanleoncz/.local/lib/python3.8/site-packages/pip (python 3.8)

ivanleoncz@mother-base: ~/test_drf $ source venv/bin/activate
(venv) ivanleoncz@mother-base: ~/test_drf $ ls
venv

(venv) ivanleoncz@mother-base: ~/test_drf $ pip3 install djangorestframework
Collecting djangorestframework
  Using cached djangorestframework-3.15.2-py3-none-any.whl (1.1 MB)
Collecting django>=4.2
  Using cached Django-4.2.16-py3-none-any.whl (8.0 MB)
Collecting backports.zoneinfo; python_version < "3.9"
  Using cached backports.zoneinfo-0.2.1-cp38-cp38-manylinux1_x86_64.whl (74 kB)
Collecting asgiref<4,>=3.6.0
  Using cached asgiref-3.8.1-py3-none-any.whl (23 kB)
Collecting sqlparse>=0.3.1
  Using cached sqlparse-0.5.1-py3-none-any.whl (44 kB)
Collecting typing-extensions>=4; python_version < "3.11"
  Using cached typing_extensions-4.12.2-py3-none-any.whl (37 kB)
Installing collected packages: typing-extensions, asgiref, sqlparse, backports.zoneinfo, django, djangorestframework
Successfully installed asgiref-3.8.1 backports.zoneinfo-0.2.1 django-4.2.16 djangorestframework-3.15.2 sqlparse-0.5.1 typing-extensions-4.12.2

(venv) ivanleoncz@mother-base: ~/test_drf $ pip3 freeze
asgiref==3.8.1
backports.zoneinfo==0.2.1
Django==4.2.16
djangorestframework==3.15.2
sqlparse==0.5.1
typing-extensions==4.12.2

(venv) ivanleoncz@mother-base: ~/test_drf $ django-admin startproject tutorial
----------------------------------------------------------------------------------------------------------------------------------------------------------------
CommandError: 'tutorial' conflicts with the name of an existing Python module and cannot be used as a project name. Please try another name.
----------------------------------------------------------------------------------------------------------------------------------------------------------------

The same doesn't happen when using version 3.15:

(venv) ivanleoncz@mother-base: ~/test_drf $ pip3 uninstall djangorestframework
Found existing installation: djangorestframework 3.15.2
Uninstalling djangorestframework-3.15.2:
  Would remove:
    /home/ivanleoncz/test_drf/venv/lib/python3.8/site-packages/djangorestframework-3.15.2.dist-info/*
    /home/ivanleoncz/test_drf/venv/lib/python3.8/site-packages/rest_framework/*
    /home/ivanleoncz/test_drf/venv/lib/python3.8/site-packages/tutorial/*
Proceed (y/n)? y
  Successfully uninstalled djangorestframework-3.15.2

(venv) ivanleoncz@mother-base: ~/test_drf $ pip3 install djangorestframework==3.15
Collecting djangorestframework==3.15
  Downloading djangorestframework-3.15.0-py3-none-any.whl (1.1 MB)
     |████████████████████████████████| 1.1 MB 1.2 MB/s 
Requirement already satisfied: backports.zoneinfo; python_version < "3.9" in ./venv/lib/python3.8/site-packages (from djangorestframework==3.15) (0.2.1)
Requirement already satisfied: django>=3.0 in ./venv/lib/python3.8/site-packages (from djangorestframework==3.15) (4.2.16)
Requirement already satisfied: sqlparse>=0.3.1 in ./venv/lib/python3.8/site-packages (from django>=3.0->djangorestframework==3.15) (0.5.1)
Requirement already satisfied: asgiref<4,>=3.6.0 in ./venv/lib/python3.8/site-packages (from django>=3.0->djangorestframework==3.15) (3.8.1)
Requirement already satisfied: typing-extensions>=4; python_version < "3.11" in ./venv/lib/python3.8/site-packages (from asgiref<4,>=3.6.0->django>=3.0->djangorestframework==3.15) (4.12.2)
Installing collected packages: djangorestframework
Successfully installed djangorestframework-3.15.0

(venv) ivanleoncz@mother-base: ~/test_drf $ django-admin startproject tutorial

(venv) ivanleoncz@mother-base: ~/test_drf $ pip3 freeze
asgiref==3.8.1
backports.zoneinfo==0.2.1
Django==4.2.16
djangorestframework==3.15.0
sqlparse==0.5.1
typing-extensions==4.12.2

(venv) ivanleoncz@mother-base: ~/test_drf $ ls
tutorial  venv

I have a feeling that something is messed up here with my environment, but I wanted to check here as well, and count with some recommendation.

Thanks,

[browniebroke]

That's because you're using Python 3.8, and Django 4.2 is the latest version to support it: https://docs.djangoproject.com/en/5.1/faq/install/#what-python-version-can-i-use-with-django

• On 4.2 branch: https://github.com/django/django/blob/52116774549e27ac5d1ba9423e2fe61c5503a4a4/setup.cfg#L38
• On 5.0 branch: https://github.com/django/django/blob/901ec7a217d174b25ac008c9c385928a36f870d1/setup.cfg#L36

You should use Python 3.10 or later if you want to install a more modern version of Djnago. It has nothing to do with DRF, you should be able to reproduce the problem with pip3 install Django.