🛠️ Installer¶

Il file streaming_installer.py gestisce l'intero ciclo di vita del progetto: dal setup iniziale alla compilazione e al rilascio dell'eseguibile.

Utilizzo¶

python streaming_installer.py [FLAG AZIONE] [FLAG MODIFICATORI]

Combinazioni non valide

--exe e --clean sono già inclusi in --install. Non combinarli con quest'ultimo.

Flag azione¶

Setup iniziale (nessun flag)¶

Esecuzione interattiva guidata:

python streaming_installer.py

Esegue in sequenza:

Creazione del virtual environment
Download opzionale dell'ultima versione da GitHub
Installazione delle dipendenze

`--install` / `-i` — Installazione completa¶

python streaming_installer.py --install

Esegue tutti i passi in sequenza senza interruzioni:

setup venv → download da GitHub → install dipendenze
    → build exe → deploy → pulizia → rimozione sorgenti

Note

La rimozione dei sorgenti richiede conferma esplicita.

`--exe` / `-x` — Compila l'eseguibile¶

python streaming_installer.py --exe

Compila Streaming Santa Croce.exe con PyInstaller e copia i file JSON nella cartella dist/.

Antivirus

Se PyInstaller viene bloccato dall'antivirus, l'installer attende che venga aggiunta un'eccezione e poi riprova automaticamente.

`--format` / `-f` — Formatta il codice¶

python streaming_installer.py --format

Riformatta tutti i file .py del progetto con autopep8 (max 300 caratteri per riga, cartella venv esclusa).

`--lint` / `-l` — Analisi statica¶

python streaming_installer.py --lint

Esegue pylint su tutti i file .py del progetto e logga il report completo.

Note

Lo script termina con exit code 0 anche in presenza di warning: pylint usa exit code non-zero per qualsiasi osservazione, quindi l'errore viene loggato ma non blocca il processo.

`--docs` / `-d` — Genera la documentazione¶

python streaming_installer.py --docs

Genera il sito di documentazione HTML con MkDocs a partire dal file mkdocs.yml. L'output viene scritto nella cartella site/.

`--clean` / `-c` — Pulizia¶

python streaming_installer.py --clean

Rimuove i file e le directory temporanei generati dalla build:

build/, dist/, site/
__pycache__/
Streaming Santa Croce.spec
streaming.log

Flag modificatori¶

Questi flag non avviano operazioni da soli, ma modificano il comportamento degli altri flag.

Flag	Alias	Descrizione
`--verbose`	`-v`	Mostra l'output dettagliato di pip riga per riga
`--dry-run`	`-n`	Simula gli step senza eseguirli
`--branch BRANCH`	`-b`	Branch GitHub da scaricare (default: `master`)

Esempi¶

# Installazione completa con output dettagliato
python streaming_installer.py --install --verbose

# Formattazione + analisi statica
python streaming_installer.py --format --lint

# Simulazione di un'installazione su branch alternativo
python streaming_installer.py --install --branch develop --dry-run

# Solo pulizia dei file temporanei
python streaming_installer.py --clean

Riferimento API¶

Per i dettagli implementativi del modulo installer, consulta il riferimento API.