V 3.2.0 - Release

Docs/pdf_combiner.md

@@ -0,0 +1,60 @@
+## 🖼️ _Generazione PDF da Immagini JPEG_ - **pdf_combiner.py**
+
+Uno script Python con interfaccia grafica che consente di selezionare immagini JPEG e convertirle in un **PDF ottimizzato**, pronto per l’archiviazione o la stampa.
+
+---
+
+## Descrizione 📄
+
+L'**Elaboratore di Documenti Scansionati** permette di importare una o più immagini, migliorarne automaticamente la leggibilità e generare un PDF ordinato e pulito.
+
+Ideale per:
+
+- **Digitalizzare documenti cartacei** in modo rapido.
+- **Migliorare la leggibilità** di scansioni non perfette.
+- **Creare archivi PDF** partendo da immagini di bassa qualità.
+
+---
+
+## Funzionalità 🌟
+
+- **Correzione orientamento**: Rileva automaticamente la rotazione delle pagine.
+- **Pulizia avanzata**: Rimuove bordi, rumore e migliora la leggibilità del testo.
+- **Conversione bianco/nero**: Per un output chiaro, leggibile e leggero.
+- **Interfaccia intuitiva**: Selezione immagini con un semplice click.
+- **Output ordinato**: Salva un PDF nella cartella delle immagini, con nome e data.
+
+---
+
+### Esempio di utilizzo 🧪
+
+1. Avvia lo script.
+2. Seleziona una o più immagini `.jpeg` o `.jpg`.
+3. Clicca su **"Elabora Documenti"**.
+4. Attendi la fine del processo: il PDF sarà generato automaticamente.
+
+---
+
+## Output 📊
+
+### Output PDF
+
+- Nome file: `Documenti_Scansionati_YYYYMMDD_HHMMSS.pdf`
+- Posizione: stessa cartella delle immagini originali.
+
+### Output Terminale / Log
+
+```plaintext
+Immagine 1/3: Analisi immagine...
+Immagine 1/3: Correzione orientamento...
+Immagine 1/3: Conversione in bianco e nero...
+...
+Creazione PDF...
+Elaborazione completata!
+```
+
+## Note 📝
+
+- Compatibilità: Supporta immagini .jpeg, .jpg e .png.
+- Performance: Il processo potrebbe richiedere alcuni secondi per immagine.
+- Nitidezza & Contrasto: Le funzioni di aumento sono disabilitate per migliorare la leggibilità del testo.

README.md

@@ -7,7 +7,7 @@
 </p>
 <br>
 <p align="center">
-	<img src="https://img.shields.io/badge/version-3.1-blue.svg" alt="versione">
+	<img src="https://img.shields.io/badge/version-3.2-blue.svg" alt="versione">
 	<img src="https://img.shields.io/github/last-commit/Magnetarman/Python-Script?style=flat&logo=git&logoColor=white&color=0080ff" alt="last-commit">
 	<img src="https://img.shields.io/github/languages/top/Magnetarman/Python-Script?style=flat&color=0080ff" alt="repo-top-language">
 	<img src="https://img.shields.io/github/languages/count/Magnetarman/Python-Script?style=flat&color=0080ff" alt="repo-language-count">
@@ -26,15 +26,19 @@
 
 ## 👾 Features
 
-**Versione 3.0** - Nuovo approccio all'esecuzione: non si esegue più uno script isolato, ma tramite un unico punto d’ingresso interattivo.
+**Experimental Branch** - Ramo Sperimentale pubblico.
+
+> **ATTENZIONE** - Questo ramo è da interdersi come sviluppo attivo, è sconsigliato utilizzare la versione degli script presenti in questo ramo in quanto potrebbero avere problemi di funzionamento o non avviarsi del tutto. **Consigliato l'utilizzo a personale esperto.**
 
-Introdotto il file `main.py` che gestisce:
+**Versione 3.0** - Nuovo approccio all'esecuzione: non si esegue più uno script isolato, ma tramite un unico punto d’ingresso interattivo.
 
-- L'installazione automatica delle dipendenze dal file `requirements.txt`.
-- Un menu interattivo per scegliere quale script eseguire.
-- Organizzazione automatica degli script in ordine alfabetico.
-- Breve descrizione affiancata a ciascuno script.
-- Migliore gestione e chiarezza degli strumenti disponibili.
+> Introdotto il file `main.py` che gestisce:
+>
+> - L'installazione automatica delle dipendenze dal file `requirements.txt`.
+> - Un menu interattivo per scegliere quale script eseguire.
+> - Organizzazione automatica degli script in ordine alfabetico.
+> - Breve descrizione affiancata a ciascuno script.
+> - Migliore gestione e chiarezza degli strumenti disponibili.
 
 ---
 
@@ -49,7 +53,7 @@ Introdotto il file `main.py` che gestisce:
     ├── README.md
     ├── install.ps1
     ├── main.py
-	├── Docs
+    ├── Docs
     ├── pipreqs-config.toml
     ├── requirements.txt
     └── scripts
@@ -65,6 +69,7 @@ Introdotto il file `main.py` che gestisce:
         ├── remove.py
         ├── sposta_file.py
         ├── transcribe_wav.py
+        ├── pdf_combiner.py
         └── trash.py
 ```
 
@@ -148,6 +153,11 @@ Introdotto il file `main.py` che gestisce:
 			<tr>
 				<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/estensioni.py'>estensioni.py</a></b></td>
 				<td><code>❯ Analisi e elenco ordinato delle estensioni file in una directory.</code></td>
+				</tr>
+				<tr>
+				<td><b><a href='https://github.com/Magnetarman/Python-Script/blob/master/scripts/pdf_combiner.py'>pdf_combiner.py</a></b></td>
+				<td><code>❯  Genera PDF da immagini Jpeg.</code></td>
+			</tr>
 			</tr>
 			</table>
 		</blockquote>
@@ -175,7 +185,7 @@ Utilizza Python-Script seguendo questi step:
 ❯ git clone https://github.com/Magnetarman/Python-Script
 ```
 
-2. utilizza il terminale per Navigare fino alla cartella:
+2. Utilizza il terminale per Navigare fino alla cartella:
 
 ```sh
 ❯ cd Python-Script
@@ -187,14 +197,38 @@ Utilizza Python-Script seguendo questi step:
 ❯ py main.py
 ```
 
+### ⚙️ Installatione Alternativa
+
+1. Clona la repository the Python-Script:
+
+```sh
+❯ git clone https://github.com/Magnetarman/Python-Script
+```
+
+2. Avvia il terminale in **modalita amministratore**, Naviga fino alla cartella::
+
+```sh
+❯ cd Python-Script
+```
+
+3. Avvia lo script `install.ps1`:
+
+```sh
+❯ ./install.ps1
+```
+
+> Lo script `install.ps1` avviato installerà Python e dipendenze minimali. Successivamente lo scipt si occuperà di avviare automaticamente il `main.py` per utilizzare gli script disponibili.
+
 ---
 
 ## 📌 Roadmap
 
 - [x] **`V 3.0`**: <strike>Creazione 'main.py'.</strike>
 - [x] **`V 3.1`**: <strike>Refactor 'Readme.md'. Creazione Cartella 'Docs' con la documentazione di ogni script.</strike>
-- [ ] **`V 3.2`**: Automatizzare il processo di installazione di Python e dipendenze al 100%.
-- [ ] **`V 4.0`**: unificare il tutto in un unico'main.py' con aggiunta di Interfaccia grafica.
+- [x] **`V 3.1.1`**: <strike>Aggiunta Script PDF Combiner in versione Stabile.</strike>
+- [x] **`V 3.1.2`**: <strike>il wrapper `main.py` aggiunge automaticamente i nuovi script all'avvio.</strike>
+- [x] **`V 3.2`**: Automatizzare il processo di installazione di Python e dipendenze al 100%.
+- [ ] **`V 4.0`**: unificare il tutto in un unico 'main.py' con aggiunta di Interfaccia grafica.
 
 ---
 
@@ -229,16 +263,6 @@ Utilizza Python-Script seguendo questi step:
 8. **Revisione**: Una volta che la tua PR sarà revisionata e approvata, verrà unita ("merged") nel branch principale. Congratulazioni per il tuo contributo!
 </details>
 
-<details closed>
-<summary>Contributor Graph</summary>
-<br>
-<p align="left">
-   <a href="https://github.com{/Magnetarman/Python-Script/}graphs/contributors">
-      <img src="https://contrib.rocks/image?repo=Magnetarman/Python-Script">
-   </a>
-</p>
-</details>
-
 ---
 
 ## 🎗 Licenza