Installazione

Prima di iniziare a sviluppare con Django, è necessario configurare correttamente l’ambiente di sviluppo. In questa guida vedremo come installare Django 5.x passo dopo passo, utilizzando le best practice raccomandate dalla community.

Prerequisiti

Per utilizzare Django 5.x sono necessari i seguenti requisiti:

Python 3.10 o superiore: Django 5.x richiede almeno Python 3.10.
pip: Il gestore di pacchetti Python, solitamente incluso con l’installazione di Python.

Verifica di avere Python installato correttamente:

python --version
# Output atteso: Python 3.12.x (o superiore)

pip --version
# Output atteso: pip 24.x.x

Creare un Ambiente Virtuale

Un ambiente virtuale isola le dipendenze del progetto dal sistema globale. Questo è fondamentale per evitare conflitti tra versioni diverse dei pacchetti.

# Crea una cartella per il progetto
mkdir mio_progetto_django
cd mio_progetto_django

# Crea l'ambiente virtuale
python -m venv venv

Attiva l’ambiente virtuale in base al tuo sistema operativo:

# Su Windows
venv\Scripts\activate

# Su macOS/Linux
source venv/bin/activate

Quando l’ambiente è attivo, vedrai il prefisso (venv) nel terminale:

(venv) C:\mio_progetto_django>

Per disattivare l’ambiente virtuale:

deactivate

Installare Django

Con l’ambiente virtuale attivo, installa Django tramite pip:

pip install django

Questo installerà l’ultima versione stabile di Django. Se hai bisogno di una versione specifica:

# Installa una versione specifica
pip install django==5.1

# Installa l'ultima versione di una major release
pip install django>=5.0,<6.0

Verificare l’Installazione

Dopo l’installazione, verifica che Django sia stato installato correttamente:

# Verifica la versione di Django
django-admin --version
# Output atteso: 5.1.x

# Oppure tramite Python
python -c "import django; print(django.get_version())"

Puoi anche verificare l’installazione dalla shell interattiva di Python:

import django
print(django.VERSION)
# Output: (5, 1, 0, 'final', 0)

Gestire le Dipendenze con requirements.txt

Per mantenere traccia delle dipendenze del progetto, genera un file requirements.txt:

# Salva tutte le dipendenze installate
pip freeze > requirements.txt

Il file conterrà qualcosa come:

asgiref==3.8.1
Django==5.1
sqlparse==0.5.1

Per reinstallare le dipendenze su un’altra macchina o ambiente:

pip install -r requirements.txt

Strumenti Aggiuntivi Consigliati

Alcuni pacchetti utili da installare insieme a Django:

# Django Debug Toolbar per il debugging
pip install django-debug-toolbar

# Django Extensions per comandi aggiuntivi
pip install django-extensions

# Driver per PostgreSQL (se necessario)
pip install psycopg2-binary

Aggiornare Django

Per aggiornare Django all’ultima versione disponibile:

pip install --upgrade django

Prima di aggiornare, consulta sempre le note di rilascio per verificare eventuali modifiche incompatibili.

Conclusione

Hai configurato correttamente il tuo ambiente di sviluppo Django con un ambiente virtuale isolato. Questa configurazione ti permette di lavorare su progetti diversi senza conflitti tra dipendenze. Nel prossimo capitolo vedremo come creare il tuo primo progetto Django.