FastAPI Application

Benvenuto! Questa guida ti aiuterà a configurare l'ambiente e a eseguire questa applicazione FastAPI sulla tua macchina.

---

Requisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Python 3.7 o superiore installato.
• Accesso al terminale (PowerShell su Windows, terminale su macOS/Linux).

Per verificare la versione di Python, esegui:

python --version

---

Installazione

Segui i passaggi sottostanti per configurare l'ambiente e avviare l'applicazione.

1. Clona o scarica il progetto

Se il progetto è ospitato su un repository (es. GitHub):

git clone <URL_DEL_REPOSITORY>
cd <NOME_CARTELLA_PROGETTO>

Se hai ricevuto un file .zip, estrai il contenuto in una directory di tua scelta e accedi alla directory.

---

2. Crea un ambiente virtuale

1. Nel terminale, crea un ambiente virtuale:

   python -m venv .venv

   Questo creerà una directory chiamata .venv all'interno del progetto.

2. Attiva l'ambiente virtuale:

   • Windows:

     .venv\Scripts\activate

   • macOS/Linux:

     source .venv/bin/activate

   Dopo l'attivazione, dovresti vedere il nome dell'ambiente virtuale (ad esempio, .venv) all'inizio del prompt del terminale.

---

3. Installa le dipendenze

Con l'ambiente virtuale attivo, installa le dipendenze richieste.

Se non è presente, puoi installare manualmente i pacchetti richiesti:

pip install fastapi uvicorn

---

4. Avvia l'applicazione

Con l'ambiente virtuale attivo, esegui l'applicazione con il comando:

uvicorn backend.app:app --reload

Spiegazione del comando:

• backend.app: Specifica il percorso del file app.py che contiene l'applicazione. Se il file si trova in un'altra posizione, modifica il percorso di conseguenza.
• --reload: Abilita il ricaricamento automatico durante lo sviluppo, così le modifiche al codice saranno applicate senza riavviare manualmente il server.

---

5. Verifica il funzionamento

1. Apri un browser e vai a:
   • http://127.0.0.1:8000: Verifica l'endpoint principale dell'app.
   • http://127.0.0.1:8000/docs: Esplora la documentazione interattiva Swagger UI.
   • http://127.0.0.1:8000/redoc: Esplora la documentazione ReDoc.

---

6. Disattiva l'ambiente virtuale

Quando hai terminato, puoi disattivare l'ambiente virtuale con:

deactivate