utilities/README.md

# Fix Gaia Excel - Script Python

Script per leggere e processare file Excel con struttura specifica, cercando e estraendo dati dalla colonna "Titoli - Operativita - Data ottenimento - Data scadenza".

## Requisiti

- Python 3.6 o superiore
- pip (gestore pacchetti Python)

## Installazione

### 1. Creare l'ambiente virtuale

```powershell
# Crea l'ambiente virtuale nella cartella venv
python -m venv venv
```

### 2. Attivare l'ambiente virtuale

**Su Windows (PowerShell):**
```powershell
.\venv\Scripts\Activate.ps1
```

**Su Windows (CMD):**
```cmd
.\venv\Scripts\activate.bat
```

**Su Linux/macOS:**
```bash
source venv/bin/activate
```

> **Nota:** Se ricevi un errore di policy su PowerShell, esegui:
> ```powershell
> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
> ```

### 3. Installare le dipendenze

```powershell
pip install -r requirements.txt
```

Se il file `requirements.txt` non esiste, installa manualmente:
```powershell
pip install openpyxl
```

### 4. Generare il file requirements.txt (opzionale)

Se vuoi aggiornare il file delle dipendenze:
```powershell
pip freeze > requirements.txt
```

## Utilizzo

### Eseguire lo script

```powershell
python fixgaiaexcel.py <percorso_file_excel>
```

**Esempio:**
```powershell
python fixgaiaexcel.py data\report.xlsx
```

### Output

Lo script:
1. Apre il file Excel specificato
2. Cerca la colonna con intestazione "Titoli - Operativita - Data ottenimento - Data scadenza"
3. Estrae e stampa tutti i dati sotto quella colonna
4. Mostra il conteggio totale degli elementi trovati

### Esempio di output

```
Apertura file: data\report.xlsx
----------------------------------------------------------------------
Foglio attivo: Foglio1
Dimensioni: 150 righe x 10 colonne
----------------------------------------------------------------------
Colonna target trovata: posizione 5
Intestazione: Titoli - Operativita - Data ottenimento - Data scadenza
----------------------------------------------------------------------

Dati trovati (10 elementi):

    1. Valore 1
    2. Valore 2
    3. Valore 3
    ...

----------------------------------------------------------------------
Totale elementi letti: 10
```

## Reinstallazione su nuovo PC

### Passaggi completi

1. **Clona o copia il progetto** sul nuovo PC

2. **Verifica che Python sia installato:**
   ```powershell
   python --version
   ```
   
   Se Python non è installato, scaricalo da [python.org](https://www.python.org/downloads/)

3. **Crea l'ambiente virtuale:**
   ```powershell
   python -m venv venv
   ```

4. **Attiva l'ambiente virtuale:**
   ```powershell
   .\venv\Scripts\Activate.ps1
   ```

5. **Installa le dipendenze:**
   ```powershell
   pip install -r requirements.txt
   ```

6. **Verifica l'installazione:**
   ```powershell
   pip list
   ```
   
   Dovresti vedere `openpyxl` nella lista dei pacchetti installati.

7. **Testa lo script:**
   ```powershell
   python fixgaiaexcel.py --help
   ```

## Struttura del progetto

```
cripy/
├── venv/                  # Ambiente virtuale (NON committare in git)
├── data/                  # Cartella per i file Excel
├── fixgaiaexcel.py        # Script principale
├── requirements.txt       # Dipendenze Python
└── README.md             # Questo file
```

## Troubleshooting

### Errore: "Il file non esiste"
Verifica che il percorso del file Excel sia corretto e che il file esista.

### Errore: "Colonna non trovata"
Lo script cerca l'intestazione esatta nella prima riga. Verifica che il file Excel contenga la colonna "Titoli - Operativita - Data ottenimento - Data scadenza" nella prima riga.

### Errore di importazione openpyxl
Assicurati di aver attivato l'ambiente virtuale e installato le dipendenze:
```powershell
.\venv\Scripts\Activate.ps1
pip install openpyxl
```

## Disattivare l'ambiente virtuale

Quando hai finito di lavorare:
```powershell
deactivate
```

## Note

- L'ambiente virtuale (`venv/`) non dovrebbe essere committato in git. Aggiungi al `.gitignore`:
  ```
  venv/
  __pycache__/
  *.pyc
  ```

- Il file `requirements.txt` dovrebbe essere committato per facilitare l'installazione su altri PC.