V 3.1.0 Beta

- Add organizzazione in ordine alfabetico degli script
- Add breve descrizione degli script nella lista di selezione
- Update "Readme.md" con info sulla V 3.0

Author: Magnetarman

README.md

@@ -31,6 +31,46 @@ pip install -r requirements.txt
 
 ![Update requirements.txt](https://github.com/Magnetarman/Python-Script/actions/workflows/update-reqs.yml/badge.svg)
 
+## **Versione 3.0**
+
+Nuovo approccio all'esecuzione: non si esegue più uno script isolato, ma tramite un unico punto d’ingresso interattivo.
+
+---
+
+### Novità della Versione 3.0
+
+- **Punto d’ingresso unificato:**  
+  È stato introdotto il file `main.py`, il quale gestisce in modo automatico:
+
+  - L'installazione automatica delle dipendenze necessarie, lette dal file `requirements.txt`.
+  - La presentazione di un menu interattivo in terminale che permette di scegliere quale script eseguire.
+  - Organizzazione degli script automaticamente in ordine alfabetico per maggiore praticità.
+  - Inserimento affianco dello script di una brevissima descrizione per aumentare facilmente la comprensione.
+
+- **Riorganizzazione della repository:**  
+  La nuova struttura semplifica l'organizzazione e l'esecuzione degli script, rendendo più chiara la gestione degli strumenti messi a disposizione.
+
+---
+
+### Requisiti 📦
+
+- **Python 3.x** (consigliata la versione 3.10 o superiore)
+- **Pip** per l'installazione delle dipendenze
+
+---
+
+### Installazione ed Esecuzione 🔧
+
+1. **Clonare la repository e passare al ramo di sviluppo 3.0:**
+
+   ```bash
+   git clone https://github.com/Magnetarman/Python-Script.git
+   cd Python-Script
+   git checkout v-3.0
+   ```
+
+---
+
 ## Licenza 📜
 
 Tutto il progetto è concesso sotto licenza **MIT**. Sentiti libero di utilizzarlo, modificarlo e condividerlo!

main.py

@@ -1,84 +1,94 @@
+#!/usr/bin/env python3
 import os
-import subprocess
 import sys
+import subprocess
 
-def check_python_installed():
-    """Verifica se Python è installato."""
-    try:
-        subprocess.run(['python', '--version'], check=True, stdout=subprocess.DEVNULL)
-        return True
-    except FileNotFoundError:
-        print("Python non è installato. Installalo prima di procedere.")
-        return False
-
-def check_python_version(min_version):
-    """Verifica se la versione di Python è compatibile."""
-    current_version = sys.version_info
-    min_required = tuple(map(int, min_version.split('.')))
-    
-    if current_version >= min_required:
-        return True
-    else:
-        print(f"Richiesta versione Python {min_version} o superiore. Versione attuale: {sys.version}")
-        return False
-
-def sync_libraries():
-    """Sincronizza le librerie con requirements.txt."""
-    requirements_file = 'requirements.txt'
-    if os.path.exists(requirements_file):
-        try:
-            subprocess.run(['pip', 'install', '-r', requirements_file], check=True)
-            print("Librerie sincronizzate con successo.")
-        except subprocess.CalledProcessError as e:
-            print(f"Errore durante l'installazione delle librerie: {e}")
-    else:
-        print("File requirements.txt non trovato.")
+def get_scripts(directory):
+    """
+    Restituisce una lista di file .py presenti in 'directory', 
+    escludendo questo script principale (main.py).
+    La lista viene ordinata alfabeticamente.
+    """
+    scripts = []
+    for file in os.listdir(directory):
+        if file.endswith('.py') and file != 'main.py':
+            scripts.append(file)
+    return sorted(scripts)
 
-def list_scripts(directory):
-    """Elenca tutti gli script Python nella directory specificata."""
-    return [f for f in os.listdir(directory) if f.endswith('.py') and f != 'main.py']
+def get_description(filepath):
+    """
+    Estrae una breve descrizione dallo script in 'filepath'.
+    La funzione cerca il primo commento (linea che inizia con "#") o docstring che non sia uno shebang.
+    Se non viene trovata una descrizione, restituisce un messaggio generico.
+    """
+    try:
+        with open(filepath, 'r', encoding='utf-8') as f:
+            for line in f:
+                line = line.strip()
+                # Ignora shebang e linee vuote
+                if line.startswith("#!") or not line:
+                    continue
+                # Se è un commento, lo considera descrizione
+                if line.startswith("#"):
+                    return line.lstrip("#").strip()
+                # Se è l'inizio di una docstring in formato triple quotes
+                if line.startswith('"""') or line.startswith("'''"):
+                    # Rimuove i delimitatori se presenti sulla stessa linea
+                    desc = line.strip('"""').strip("'''").strip()
+                    if desc:  # Se contiene del testo, lo restituisce
+                        return desc
+                    # Altrimenti, continua a leggere le righe successive fino a chiudere la docstring
+                    description_lines = []
+                    for next_line in f:
+                        next_line = next_line.strip()
+                        if next_line.endswith('"""') or next_line.endswith("'''"):
+                            description_lines.append(next_line.rstrip('"""').rstrip("'''").strip())
+                            break
+                        description_lines.append(next_line)
+                    return " ".join(description_lines).strip()
+        return "Nessuna descrizione disponibile."
+    except Exception:
+        return "Nessuna descrizione disponibile."
 
 def main():
-    # Controlla la versione di Python richiesta (modifica '3.8' se necessario)
-    if not check_python_version('3.8'):
-        sys.exit(1)
-
-    # Controlla se Python è installato
-    if not check_python_installed():
-        sys.exit(1)
-
-    # Sincronizza le librerie con requirements.txt
-    sync_libraries()
+    # Se esiste una cartella "scripts", usiamola, altrimenti la directory corrente
+    base_dir = os.getcwd()
+    scripts_dir = os.path.join(base_dir, "scripts")
+    if os.path.isdir(scripts_dir):
+        directory = scripts_dir
+    else:
+        directory = base_dir
 
-    # Specifica la directory contenente gli script
-    scripts_dir = './scripts'  # Cambia il percorso se necessario
+    scripts = get_scripts(directory)
+    if not scripts:
+        print("Nessuno script disponibile da eseguire.")
+        return
 
-    while True:  # Ciclo per mantenere il wrapper attivo finché l'utente non digita 'exit'
-        # Elenca gli script disponibili
-        scripts = list_scripts(scripts_dir)
-        if not scripts:
-            print("Nessuno script trovato nella directory.")
-            break
+    # Stampa il menu di selezione in ordine alfabetico
+    print("Seleziona lo script da eseguire:\n")
+    for idx, script in enumerate(scripts, start=1):
+        desc = get_description(os.path.join(directory, script))
+        print(f"{idx}. {script} - {desc}")
 
-        print("\nSeleziona uno script da eseguire (digita 'exit' per uscire):")
-        for i, script in enumerate(scripts, start=1):
-            print(f"{i}. {script}")
+    print("\n0. Esci")
 
-        user_input = input("\nInserisci il numero dello script o 'exit': ").strip()
+    try:
+        choice = int(input("\nInserisci il numero corrispondente alla tua scelta: "))
+    except ValueError:
+        print("Scelta non valida. Inserire un numero.")
+        return
 
-        if user_input.lower() == 'exit':
-            print("Uscita dal wrapper...")
-            sys.exit(0)  # Termina il programma e chiude il terminale
+    if choice == 0:
+        print("Uscita.")
+        return
 
-        try:
-            choice = int(user_input)
-            if 1 <= choice <= len(scripts):
-                selected_script = scripts[choice - 1]
-                subprocess.run(['python', os.path.join(scripts_dir, selected_script)])
-            else:
-                print("Scelta non valida.")
-        except ValueError:
-            print("Inserisci un numero valido o 'exit'.")
+    if 1 <= choice <= len(scripts):
+        selected_script = os.path.join(directory, scripts[choice - 1])
+        print(f"Esecuzione di {scripts[choice - 1]}...\n")
+        # Avvia lo script selezionato usando l'interprete Python
+        subprocess.run([sys.executable, selected_script])
+    else:
+        print("Scelta non valida.")
 
 if __name__ == '__main__':
     main()

scripts/audio_extract.py

@@ -1,3 +1,4 @@
+# Estrazione tracce audio .flac da file .mkv (anche ricorsiva).
 import os
 import subprocess
 

scripts/color_palette.py

@@ -1,3 +1,4 @@
+# Estrazione e salvataggio dei colori in formato PDF dominanti da un'immagine.
 import sys
 from PIL import Image
 from sklearn.cluster import KMeans

scripts/efolder.py

@@ -1,3 +1,4 @@
+# Individuazione e rimozione sicura di cartelle vuote in una directory.
 import os
 
 def find_empty_directories(folder_path):

scripts/elenco_cartelle.py

@@ -1,3 +1,4 @@
+# Elenco cartelle di primo livello e salvataggio su file di testo.
 import os
 
 def list_folders_in_path():

scripts/eml_converter.py

@@ -1,3 +1,4 @@
+# Conversione di email .eml in PDF con dettagli del messaggio.
 import os
 import sys
 import pdfkit

scripts/estensioni.py

@@ -1,3 +1,4 @@
+# Analisi e elenco ordinato delle estensioni file in una directory.
 import os
 
 def get_file_extensions(folder_path):

scripts/image_downloader.py

@@ -1,3 +1,4 @@
+# Download immagini da una pagina web, inclusi contenuti Base64.
 import os
 import requests
 import base64

scripts/remove.py

@@ -1,3 +1,4 @@
+# Rimozione file non musicali e pulizia cartelle vuote in una directory.
 import os
 import re
 

scripts/sposta_file.py

@@ -1,3 +1,4 @@
+# Spostamento file in directory principale e rimozione cartelle vuote.
 import os
 import shutil
 

scripts/transcribe_wav.py

@@ -1,3 +1,4 @@
+# Conversione audio .wav in testo con Whisper di OpenAI e salvataggio in .txt.
 import os
 import whisper
 from pydub import AudioSegment

scripts/trash.py

@@ -1,3 +1,4 @@
+# Spostamento file con nomi specifici in una cartella "duplicati".
 import os
 import shutil
 from tkinter import Tk, filedialog