UV Cheatsheet - Software Engineering 3.0

Il gestore Python ultrarapido scritto in Rust

Gestione Progetti

Comando	Descrizione
`uv init`	Crea nuovo progetto
`uv init --lib`	Crea come libreria
`uv sync`	Sincronizza dipendenze
`uv lock`	Aggiorna lockfile
`uv run script.py`	Esegue script
`uv run pytest`	Esegue comando nel venv

Dipendenze

Comando	Descrizione
`uv add requests`	Aggiunge dipendenza
`uv add 'requests>=2.28'`	Con vincolo versione
`uv add --dev pytest`	Dipendenza dev
`uv add --group test pytest`	In gruppo specifico
`uv remove requests`	Rimuove dipendenza
`uv tree`	Albero dipendenze

Gestione Python

Comando	Descrizione
`uv python list`	Versioni disponibili
`uv python install 3.12`	Installa versione
`uv python install 3.11 3.12`	Installa multiple
`uv python uninstall 3.11`	Rimuove versione
`uv python pin 3.12`	Fissa per progetto
`uv python find`	Trova interprete attivo

Ambienti Virtuali

Comando	Descrizione
`uv venv`	Crea .venv
`uv venv --python 3.11`	Con versione specifica
`uv venv myenv`	Nome personalizzato

Modalità pip (senza progetto)

Comando	Descrizione
`uv pip install requests`	Installa nel venv
`uv pip install -r req.txt`	Da requirements
`uv pip uninstall requests`	Disinstalla
`uv pip list`	Lista pacchetti
`uv pip freeze`	Output requirements
`uv pip compile req.in`	Genera lockfile

Tool Globali

Comando	Descrizione
`uv tool install ruff`	Installa CLI globale
`uv tool upgrade ruff`	Aggiorna tool
`uv tool list`	Lista installati
`uv tool uninstall ruff`	Rimuove tool
`uvx ruff check .`	Esegue senza installare

Script Standalone

Comando	Descrizione
`uv run --with requests script.py`	Con dipendenza temp
`uv add --script script.py requests`	Dipendenza inline

Cache e Manutenzione

Comando	Descrizione
`uv cache clean`	Pulisce cache
`uv cache prune`	Rimuove non usati
`uv cache dir`	Mostra path cache
`uv self update`	Aggiorna uv

Modello Mentale

💡 Come Pensare a uv

uv python ... - gestione interpreti Python
uv add/remove - dipendenze del progetto
uv run - esegui qualsiasi cosa nel contesto del progetto
uv tool - CLI globali (ruff, black, mypy…)
uv pip - modalità classica compatibile pip

✅ Tip

uv run crea automaticamente il venv se non esiste e installa le dipendenze. È il modo più semplice per lavorare: basta uv run python script.py e sei operativo.

Help rapido: uv --help o uv add --help