From e4bea84c011f82e2b929ca3bc870c33842cbf20c Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Mon, 13 Jul 2026 23:23:57 +0200 Subject: [PATCH] Espande il README con istruzioni dettagliate per Windows Aggiunge una guida passo passo per l'installazione di Python su Windows (incluso il chiarimento che venv e' gia' incluso), la soluzione per l'errore di execution policy in PowerShell, e la nota sull'installazione di python3-venv su Linux/WSL quando necessario. Co-Authored-By: Claude Sonnet 5 --- README.md | 44 ++++++++++++++++++++++++++++++++++---------- 1 file changed, 34 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 38148ae..97d93dc 100644 --- a/README.md +++ b/README.md @@ -8,19 +8,38 @@ Questa guida non presume nessuna conoscenza di Python: segui i passaggi nell'ord Serve Python 3.10 o superiore. -- **Windows**: scarica l'installer da [python.org/downloads](https://www.python.org/downloads/), avvialo e **spunta la casella "Add python.exe to PATH"** prima di cliccare Install. -- **macOS**: scarica l'installer da [python.org/downloads](https://www.python.org/downloads/) oppure, se hai [Homebrew](https://brew.sh), esegui `brew install python`. -- **Linux**: quasi sempre è già installato. Verifica con il comando del punto 2. +### Windows + +1. Vai su [python.org/downloads](https://www.python.org/downloads/) e clicca sul pulsante giallo per scaricare l'ultima versione (es. "Download Python 3.12.x"). +2. Avvia il file scaricato (es. `python-3.12.x-amd64.exe`). +3. Nella prima schermata dell'installer, **spunta in basso la casella "Add python.exe to PATH"** — è il passaggio più importante, senza non funzionerà nulla dal terminale. +4. Clicca su "Install Now" e attendi il completamento. +5. Al termine, clicca "Close". + +Il modulo `venv` (necessario al punto 4) è già incluso automaticamente in questa installazione: su Windows non serve installare nient'altro. + +### macOS + +Scarica l'installer da [python.org/downloads](https://www.python.org/downloads/) oppure, se hai [Homebrew](https://brew.sh), esegui `brew install python`. + +### Linux (o WSL su Windows) + +Su molte distribuzioni Python è già preinstallato, ma il modulo `venv` a volte è un pacchetto separato. Se al punto 4 ottieni un errore tipo `ensurepip is not available`, installalo con (Debian/Ubuntu): + +``` +sudo apt update +sudo apt install python3-venv +``` ## 2. Verificare l'installazione -Apri il terminale (Prompt dei comandi/PowerShell su Windows, Terminale su macOS/Linux) e digita: +Apri il terminale — su Windows si chiama **PowerShell** (cercalo nel menu Start digitando "PowerShell") oppure "Prompt dei comandi"; su macOS/Linux è il "Terminale" — e digita: ``` -python3 --version +python --version ``` -Se ottieni un errore, prova con `python --version`. Dovresti vedere qualcosa come `Python 3.11.x`. Da qui in poi, ovunque leggi `python3`, usa il comando che ha funzionato per te (`python3` o `python`). +Su Windows dovrebbe funzionare subito grazie al PATH configurato al punto 1. Su macOS/Linux, se `python` non è riconosciuto, prova con `python3 --version`. Dovresti vedere qualcosa come `Python 3.11.x`. Da qui in poi, ovunque leggi `python`, usa il comando che ha funzionato per te (`python` o `python3`). ## 3. Scaricare il progetto @@ -31,7 +50,7 @@ Se non l'hai già fatto, scarica o clona questa cartella sul tuo computer. Poi a L'ambiente virtuale è una cartella isolata dove vengono installate le librerie necessarie, senza toccare il resto del tuo computer. Va creato una sola volta. ``` -python3 -m venv .venv +python -m venv .venv ``` Poi attivalo: @@ -40,6 +59,11 @@ Poi attivalo: ``` .venv\Scripts\Activate.ps1 ``` + Se compare un errore che parla di "esecuzione script disabilitata" (`execution policy`), apri PowerShell **come amministratore** ed esegui una sola volta: + ``` + Set-ExecutionPolicy -Scope CurrentUser RemoteSigned + ``` + poi riprova ad attivare l'ambiente virtuale. - **Windows (Prompt dei comandi)**: ``` .venv\Scripts\activate.bat @@ -68,7 +92,7 @@ pip install -r requirements.txt Con l'ambiente virtuale attivo (vedi punto 4), lancia: ``` -python3 main.py +python main.py ``` Lo script esegue in sequenza tutti i passaggi ed elaborerà **tutti** i file presenti in `raw`: @@ -88,9 +112,9 @@ Lo script esegue in sequenza tutti i passaggi ed elaborerà **tutti** i file pre ## 8. Rilanciare la pipeline su nuovi dati -Ogni volta che hai nuovi file da elaborare, ripeti solo i punti 5 e 6 (aggiungi i `.txt` in `raw` e rilancia `python3 main.py`) — non serve ricreare l'ambiente virtuale. +Ogni volta che hai nuovi file da elaborare, ripeti solo i punti 5 e 6 (aggiungi i `.txt` in `raw` e rilancia `python main.py`) — non serve ricreare l'ambiente virtuale. -Se vuoi rielaborare gli stessi file da zero (es. con un potenziale di riferimento diverso), puoi lanciare di nuovo `python3 main.py`: i file in `output` verranno sovrascritti con i nuovi risultati. +Se vuoi rielaborare gli stessi file da zero (es. con un potenziale di riferimento diverso), puoi lanciare di nuovo `python main.py`: i file in `output` verranno sovrascritti con i nuovi risultati. ## Struttura degli script