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