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 <noreply@anthropic.com>
This commit is contained in:
@@ -8,19 +8,38 @@ Questa guida non presume nessuna conoscenza di Python: segui i passaggi nell'ord
|
|||||||
|
|
||||||
Serve Python 3.10 o superiore.
|
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.
|
### Windows
|
||||||
- **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.
|
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
|
## 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
|
## 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.
|
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:
|
Poi attivalo:
|
||||||
@@ -40,6 +59,11 @@ Poi attivalo:
|
|||||||
```
|
```
|
||||||
.venv\Scripts\Activate.ps1
|
.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)**:
|
- **Windows (Prompt dei comandi)**:
|
||||||
```
|
```
|
||||||
.venv\Scripts\activate.bat
|
.venv\Scripts\activate.bat
|
||||||
@@ -68,7 +92,7 @@ pip install -r requirements.txt
|
|||||||
Con l'ambiente virtuale attivo (vedi punto 4), lancia:
|
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`:
|
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
|
## 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
|
## Struttura degli script
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user