🌐 Modulo 1: Cos'è un Server Web?

• Apri PyCharm
• File → New Project
• Scegli una cartella (es. flask-corso)
• Seleziona New environment using Virtualenv
• Clicca su Create

Nel terminale di PyCharm (in basso), digita:

pip install flask

Vedrai l'installazione procedere. Quando finisce, Flask è pronto!

Controlla che Flask sia installato correttamente:

pip list

Dovresti vedere Flask nella lista dei pacchetti installati.

In PyCharm, fai clic destro sulla cartella del progetto → New → Python File

Chiamalo app.py

Digita il seguente codice nel file app.py:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return 'Benvenuto nel mio primo server web!'

if __name__ == '__main__':
    app.run(debug=True)

In PyCharm, fai clic destro su app.py → Run 'app'

Oppure usa il terminale:

python app.py

Apri il browser e vai su:

http://localhost:5000

Dovresti vedere il messaggio "Benvenuto nel mio primo server web!" 🎉

from flask import Flask importa la classe Flask dal modulo flask.

Analogia: Come quando compri un nuovo elettrodomestico, devi prima toglierlo dalla scatola (importarlo) prima di poterlo usare.

app = Flask(__name__) crea un'istanza della classe Flask, ovvero la nostra applicazione web.

🔍 Il misterioso parametro __name__

__name__ è una variabile speciale di Python che contiene il nome del modulo corrente:

• Se eseguiamo python app.py → __name__ = '__main__'
• Se importiamo app.py come modulo → __name__ = 'app'

Perché Flask ha bisogno di __name__?

1. Per trovare risorse: Cartelle statiche (CSS, JS, immagini) e template (HTML)
2. Per debugging: Sapere da quale file è partita l'applicazione
3. Per configurazione: Impostazioni specifiche per l'ambiente

Cosa sono i decoratori? Sono funzioni speciali che "decorano" (modificano/estendono) altre funzioni.

🔧 Cosa fa esattamente @app.route('/')?

Il decoratore @app.route('/') fa queste cose:

1. Registra la URL: Dice a Flask: "Quando qualcuno visita '/', chiama questa funzione"
2. Crea un collegamento: Associa la funzione home() al percorso '/'
3. Gestisce l'HTTP: Trasforma la tua funzione Python in un handler HTTP

📝 Sintassi equivalente senza decoratori

Per capire meglio, ecco come sarebbe senza la sintassi col @:

@app.route('/')
def home():
    return "Ciao"

def home():
    return "Ciao"

app.add_url_rule('/', 'home', home)

def home(): definisce una funzione normale di Python che diventa un handler HTTP grazie al decoratore.

🎯 Cosa deve restituire una funzione Flask?

Una funzione decorata con @app.route() può restituire:

• Stringhe: return "Ciao mondo" → Diventa HTML
• Tuple: return "Testo", 200 → Con status code personalizzato
• Response object: Per controllo avanzato
• JSON: Per API (lo vedremo più avanti)

🔗 Il ciclo completo richiesta-risposta

if __name__ == '__main__':
    app.run(debug=True)

🔒 Perché if __name__ == '__main__'?

Questa condizione impedisce che il server parta accidentalmente quando importi app.py come modulo.

🔍 DEBUG=True - Spiegazione Approfondita

Il parametro debug=True attiva la modalità di sviluppo di Flask, che offre diverse funzionalità cruciali:

🎯 Quando usare debug=True

🛠️ Configurazioni Alternative

🧪 Prova il Debug Mode

Crea un errore nel tuo codice per vedere il debugger in azione:

@app.route('/errore')
def pagina_errore():
    # Errore intenzionale: variabile non definita
    return variabile_non_definita  # ← NameError!

# Poi visita: http://localhost:5000/errore
# Vedrai il debugger interattivo di Flask!