Skip to content

uv-cheatsheet.mdx

Latest commit

 

History

History
126 lines (94 loc) · 3.14 KB

uv-cheatsheet.mdx

File metadata and controls

126 lines (94 loc) · 3.14 KB
title UV Cheatsheet
description Riferimento rapido per uv: il package manager Python ultra-veloce scritto in Rust
icon ⚡
tag Cheatsheet
date 2026-01-05

import InfoBox from '../../components/InfoBox.astro';

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

- `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 `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