Initial commit

README.md

@@ -0,0 +1,185 @@
+# 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.