Primo progetto

8.1 Analisi dell'interfaccia IDE

Ok, abbiamo creato un nuovo progetto. Vediamo cosa abbiamo qui.

1. Struttura delle cartelle e dei file del progetto:

Qui si visualizza il contenuto della cartella del nostro progetto — pythonProject.

2. File attualmente aperto:

Questa è semplicemente il contenuto del file main.py, con la sintassi del codice evidenziata.

3. Sopra — il menu principale:

Pulsanti utili in alto a destra:

• «Triangolo verde» — pulsante per avviare il progetto.
• «Insetto» — pulsante per avviare la modalità di debug.
• «Lente d'ingrandimento» — ricerca nel progetto.
• «Ingranaggio» — impostazioni.

4. A sinistra si vede il menu laterale:

Qui ci sono diversi pulsanti utili, noi in particolare saremo interessati al pulsante Terminal.

5. Barra di stato:

A sinistra nella barra di stato viene visualizzato il percorso del file attualmente aperto. A destra — la sua codifica: CRLF, UTF-8.

E proprio a destra viene visualizzata la versione corrente di Python — Python 3.12.x, su cui sarà eseguito il nostro progetto. È utile dare un'occhiata qui se hai diverse versioni di Python installate sul computer e ci sono progetti che funzionano su altre versioni.

8.2 Analisi del progetto

Un progetto normale è composto da file che vengono visualizzati nel pannello di sinistra. Questi file possono essere suddivisi condizionalmente in 4 parti.

File con codice in linguaggio Python. Tali file hanno l\'estensione .py e PyCharm li contrassegna con un\'icona blu e gialla. Nel nostro progetto ora c\'è solo un file di questo tipo: main.py

File statici. Così vengono chiamati i file che contengono dati, ma non codice. Possono essere file di testo, immagini, file multimediali e così via. Al momento nel nostro progetto non ce ne sono.

Ambiente virtuale Python. Nella cartella chiamata .venv (abbreviazione di Virtual Environment) sono contenuti i file Python, così come diverse utilità di servizio. È qui che il gestore di pacchetti pip scaricherà le librerie di terze parti che vorrai utilizzare.

Librerie di terze parti (External libraries). Al momento nel nostro progetto non ce ne sono, ma quando le scaricherai, PyCharm le visualizzerà sicuramente qui.

8.3 Ambiente virtuale .venv

Parliamo un po\' più in dettaglio dell\'ambiente virtuale. .venv è un modulo in Python che offre la possibilità di creare diversi ambienti virtuali leggeri e isolati per i progetti Python. È uno strumento che permette di gestire le dipendenze del progetto, isolandole dalle librerie di sistema. Immagina che sia una stanza isolata per il tuo progetto, dove può conservare i suoi giocattoli e strumenti personali senza disturbare gli altri abitanti della casa.

Tecnicamente funziona in modo semplice: all\'interno della cartella del progetto viene creata una copia dell\'interprete Python e uno spazio separato per le librerie. Questo garantisce che se installi una versione specifica di una libreria per un progetto, non romperà un altro che necessita di una versione più vecchia. L\'uso di un ambiente virtuale è una regola di buon tono che salva da infiniti conflitti di versioni.

Gestione dell\'ambiente in PyCharm

PyCharm di solito si occupa di questo e crea tutto automaticamente. Ma capita di aver eliminato accidentalmente la cartella necessaria o semplicemente di voler ricominciare tutto da zero. Saper gestire queste impostazioni manualmente è un\'abilità utile.

Creiamo un ambiente

Nell\'angolo in basso a destra viene visualizzato lo stato della connessione del linguaggio Python. Se vedi lì una scritta come Python 3.XX, significa che l\'installazione è andata a buon fine. L\'ambiente di sviluppo vede l\'interprete ed è pronto a eseguire i tuoi comandi.

Se invece c\'è scritto No interpreter, clicca su questa scritta.

1. Nel menu che appare selezioniamo Add New Interpreter e poi Add Local Interpreter.
2. Nelle impostazioni a sinistra selezioniamo Environment. Al centro assicurati che ci sia la spunta su Generate New.
3. Premiamo OK. L\'editor creerà una nuova cartella .venv e passerà immediatamente il progetto su di essa. Ora hai un sistema assolutamente pulito senza spazzatura inutile.

Eliminiamo il vecchio o il superfluo

A volte gli esperimenti portano a un vicolo cieco, ed è più facile eliminare l\'ambiente che cercare di ripararlo. Ecco come farlo:

1. Clicchiamo nuovamente sulla versione Python nell\'angolo in basso a destra e selezioniamo la voce Interpreter Settings.
2. In alto cerchiamo il campo Python Interpreter. Apriamo l\'elenco e selezioniamo la voce Show All.
3. Vedrai un elenco di tutti gli ambienti che PyCharm conosce. Seleziona quello che vuoi rimuovere e premi il pulsante con il meno nel menu sopra l\'elenco.
4. Un punto importante: PyCharm semplicemente «dimenticherà» questo ambiente e smetterà di usarlo. Per liberare fisicamente spazio su disco, devi andare nella cartella del progetto tramite il normale esplora file ed eliminare manualmente la cartella .venv.

Creazione di un secondo ambiente

Errore: «Already contains Python»

Se entri nel menu per aggiungere l\'interprete e selezioni Generate new, PyCharm potrebbe mostrare un avviso rosso e bloccare il pulsante OK. Questo accade perché l\'editor per abitudine cerca di creare un nuovo ambiente nella stessa cartella .venv che è già occupata dal tuo primo ambiente. Due diversi set di librerie non possono vivere in una sola cartella.

Come risolvere questo problema

Bisogna semplicemente dare alla nuova «sandbox» un nome unico. Ecco come farlo:

1. Apri il menu Add Local Interpreter, come abbiamo fatto prima.
2. Seleziona la voce Generate new.
3. Guarda il campo Location. Molto probabilmente, il percorso lì termina con il nome standard \.venv.
4. Posiziona il cursore alla fine della riga e aggiungi semplicemente qualsiasi cifra. Cambia la fine del percorso in \.venv_2 e premi Enter.
5. La scritta rossa scomparirà immediatamente. Premi OK.

Ora nel tuo progetto esisteranno fisicamente due diverse cartelle con le impostazioni e PyCharm passerà automaticamente alla nuova versione.

Come passare da un ambiente all'altro

La capacità di destreggiarsi tra gli ambienti è un\'abilità importante. Ma qui c\'è un trucco: PyCharm non sempre ricorda automaticamente i tuoi vecchi ambienti.

Spesso accade che hai creato un secondo ambiente, e il primo è scomparso dal menu, sebbene la cartella .venv si trovi ancora nel progetto. In questo caso devi semplicemente indicare a PyCharm dove cercare il vecchio Python. Esempio per passare da .venv_2 a .venv:

1. Clicca sulla versione Python nell\'angolo e seleziona Add New Interpreter -> Add Local Interpreter.
2. Nella finestra che appare sposta il punto sulla voce Select Existing.
3. Nel campo Python Path clicca sull\'icona della cartella a destra.
4. Ora devi trovare il file di avvio di Python nella tua vecchia cartella (.venv). Segui il percorso: Tuo_progetto -> .venv -> Scripts (per Windows) o bin (per macOS/Linux).
5. All\'interno di questa cartella seleziona il file python e premi OK.

Ora il vecchio ambiente apparirà di nuovo nelle impostazioni e diventerà attivo. Questo metodo funziona in modo impeccabile, anche se PyCharm ha «dimenticato» le tue impostazioni.

8.4 Lavorare con il terminale

In PyCharm puoi lavorare direttamente con la riga di comando del sistema operativo. In Linux e MacOS la riga di comando è comunemente chiamata Terminal (Terminal), quindi in PyCharm è chiamata così. Anche se, in realtà, non è un capriccio di PyCharm, ma un nome consolidato tra i programmatori.

Per aprire Terminal devi premere il pulsante del terminale nel menu laterale:

Dovrebbe apparire una finestra come questa:

In questa finestra puoi scrivere comandi del tuo sistema operativo. Noi siamo interessati a uno di questi.

Scopriamo la versione attuale dell'interprete di Python che abbiamo installato. Per farlo devi scrivere:

        python --version

Ecco cosa ho ottenuto:

Se anche tu hai ottenuto Python 3.12.x, allora sei sulla strada giusta.