Mini-manuale: aggiornare i pacchetti Python (anche in virtualenv)

Guida rapida ai comandi per verificare e aggiornare i moduli Python installati, sia globalmente sia dentro un ambiente virtuale (venv).

1. Verificare pacchetti obsoleti

pip list --outdated

Mostra i pacchetti installati con versione più recente disponibile.

2. Aggiornare un singolo pacchetto

pip install -U nome_pacchetto

Esempio:

pip install -U requests

Aggiorna solo il modulo indicato.

3. Aggiornare tutti i pacchetti (Linux/macOS)

pip list --outdated --format=freeze | cut -d= -f1 | xargs -n1 pip install -U

Aggiorna automaticamente tutti i moduli obsoleti.

4. Aggiornare tutti i pacchetti (Windows PowerShell)

pip list --outdated --format=freeze | % { ($_ -split '=')[0] } | % { pip install -U $_ }

5. Metodo consigliato: pip-review

Installazione:

pip install pip-review

Aggiornamento automatico:

pip-review --auto

Metodo più pulito e leggibile.

6. Aggiornare pip

python -m pip install --upgrade pip

Da eseguire sempre prima degli altri aggiornamenti.

7. Salvare lo stato dell’ambiente

pip freeze > requirements.txt

Salva tutte le versioni installate.

8. Aggiornare da requirements.txt

pip install -U -r requirements.txt

Aggiorna i pacchetti elencati nel file.

9. Ambienti virtuali (virtualenv / venv)

Creare ambiente virtuale

python -m venv venv

Attivare

Linux/macOS

source venv/bin/activate

Windows

venv\Scripts\activate

Quando il virtualenv è attivo, tutti i comandi pip agiscono solo dentro quell’ambiente.

10. Aggiornare tutti i moduli dentro un virtualenv

Procedura completa consigliata

Attiva l’ambiente:

source venv/bin/activate      # Linux/macOS
venv\Scripts\activate         # Windows

Aggiorna pip:

python -m pip install --upgrade pip

Aggiorna tutti i pacchetti:

pip list --outdated --format=freeze | cut -d= -f1 | xargs -n1 pip install -U

oppure:

pip-review --auto

11. Aggiornare virtualenv mantenendo requirements

Workflow professionale:

source venv/bin/activate
pip freeze > requirements.txt
pip-review --auto
pip freeze > requirements_updated.txt

Confronta i file per vedere cosa è cambiato.

12. Ricreare virtualenv aggiornato da zero (metodo più pulito)

rm -rf venv
python -m venv venv
source venv/bin/activate
pip install -U pip
pip install -r requirements.txt

Metodo molto usato in:

• CI/CD
• ambienti di build
• deploy riproducibili

13. Avvertenze tecniche

Aggiornare tutto può rompere dipendenze. Best practice:

• aggiornare in branch dedicato
• eseguire test
• usare requirements.txt
• non aggiornare in produzione senza verifica

14. Flusso consigliato sviluppo locale

source venv/bin/activate
python -m pip install --upgrade pip
pip list --outdated
pip-review --auto
pip freeze > requirements.txt

Mantiene l’ambiente aggiornato e replicabile.