Installare Python e diagnosticare correttamente l’ambiente di sviluppo

by theArchitect
SHARE
Installare Python e diagnosticare correttamente l’ambiente di sviluppo
© Guida-HTML5.it

Introduzione

Installare Python non significa soltanto scaricare un programma e fare clic su “Avanti”. Per lavorare in modo affidabile è importante verificare che il comando sia disponibile dal terminale, che l’interprete utilizzato sia quello atteso e che la codifica dei caratteri funzioni correttamente.

In questo tutorial costruiremo un piccolo strumento diagnostico, scritto in Python, capace di controllare l’ambiente di esecuzione. È un approccio utile quando si lavora su computer diversi, quando si configura un nuovo IDE oppure quando un programma sembra usare una versione di Python diversa da quella installata.

Il tutorial non tratta la gestione di più versioni tramite strumenti dedicati e non introduce pacchetti esterni: useremo esclusivamente la libreria standard di Python.

Codice completo

Creiamo un file chiamato diagnostica_python.py e inseriamo il seguente codice:

import os
import platform
import sys
import sysconfig
from pathlib import Path


def controlla_interprete():
    """Mostra informazioni sull´interprete Python in uso."""
    print("=== Interprete Python ===")
    print(f"Versione: {platform.python_version()}")
    print(f"Eseguibile: {sys.executable}")
    print(f"Implementazione: {platform.python_implementation()}")
    print()


def controlla_sistema():
    """Mostra informazioni di base sul sistema operativo."""
    print("=== Sistema operativo ===")
    print(f"Sistema: {platform.system()}")
    print(f"Versione sistema: {platform.release()}")
    print(f"Architettura: {platform.machine()}")
    print()


def controlla_cartella_corrente():
    """Verifica la cartella dalla quale viene eseguito lo script."""
    cartella = Path.cwd()

    print("=== Cartella di lavoro ===")
    print(f"Percorso corrente: {cartella}")
    print(f"Esiste: {cartella.exists()}")
    print(f"È una directory: {cartella.is_dir()}")
    print()


def controlla_encoding():
    """Verifica la codifica predefinita e scrive un carattere Unicode."""
    print("=== Codifica ===")
    print(f"Codifica predefinita: {sys.getdefaultencoding()}")
    print(f"Codifica del filesystem: {sys.getfilesystemencoding()}")

    # Questo testo verifica la gestione di caratteri non ASCII.
    print("Test Unicode: à è ì ò ù — Python funziona!")
    print()


def mostra_percorso_libreria_standard():
    """Mostra dove si trova la libreria standard."""
    percorso = sysconfig.get_paths()["stdlib"]

    print("=== Libreria standard ===")
    print(f"Percorso: {percorso}")
    print(f"Esiste: {os.path.isdir(percorso)}")
    print()


def main():
    controlla_interprete()
    controlla_sistema()
    controlla_cartella_corrente()
    controlla_encoding()
    mostra_percorso_libreria_standard()


if __name__ == "__main__":
    main()

Salviamo il file in una cartella facilmente raggiungibile, per esempio Documenti/python-test.

Spiegazione

Installare Python

Il metodo consigliato è scaricare Python dal sito ufficiale python.org. Durante l’installazione su Windows è essenziale selezionare l’opzione Add Python to PATH. Questa impostazione permette di eseguire Python dal terminale senza indicare ogni volta il percorso completo dell’interprete.

Su macOS è preferibile utilizzare il programma di installazione ufficiale oppure un gestore di pacchetti affidabile. Su molte distribuzioni Linux Python è già presente, ma potrebbe essere necessario installare anche il pacchetto relativo a pip e quello degli strumenti di sviluppo.

Al termine dell’installazione, apriamo un nuovo terminale. Su Windows possiamo provare:

python --version

Su macOS e Linux spesso il comando corretto è:

python3 --version

Il risultato dovrebbe contenere una versione come Python 3.12.x. È importante usare Python 3: Python 2 non è più supportato.

Eseguire il programma

Dal terminale entriamo nella cartella che contiene il file. Su Windows, per esempio:

cd Documentipython-test
python diagnostica_python.py

Su macOS o Linux:

cd ~/Documenti/python-test
python3 diagnostica_python.py

Il programma stampa il percorso dell’interprete realmente utilizzato. Questo dato è particolarmente utile: se l’IDE usa un interprete diverso dal terminale, i pacchetti e le configurazioni potrebbero non coincidere.

Analisi delle parti principali

Il modulo sys fornisce informazioni sull’interprete, tra cui sys.executable, cioè il percorso assoluto del programma Python in esecuzione. Il modulo platform identifica sistema operativo, architettura e versione dell’implementazione.

La classe Path, importata da pathlib, consente di lavorare con i percorsi in modo più leggibile e compatibile tra sistemi diversi. Invece di concatenare stringhe con barre diverse, possiamo usare metodi come Path.cwd() e exists().

Il modulo sysconfig permette infine di individuare cartelle importanti dell’installazione, come quella della libreria standard.

Best practice

  • Usa sempre Python 3: controlla la versione prima di iniziare un progetto.
  • Verifica l’interprete effettivo: sys.executable è più affidabile del semplice comando digitato nel terminale.
  • Riapri il terminale dopo l’installazione: le modifiche al PATH potrebbero non essere disponibili nelle sessioni già aperte.
  • Evita di modificare manualmente il PATH senza necessità: un’impostazione errata può rendere difficile individuare gli eseguibili.
  • Conserva i progetti in cartelle dedicate: separare codice, documentazione e file temporanei rende l’ambiente più ordinato.
  • Usa percorsi tramite pathlib: il codice sarà più leggibile e meno dipendente dal sistema operativo.
  • Controlla la codifica: testare caratteri accentati e simboli Unicode evita problemi durante la lettura e scrittura dei file.

Se il comando python non viene riconosciuto, possiamo provare python3. Se nessuno dei due funziona, occorre verificare l’installazione e il PATH. Su Windows può essere utile anche il comando py --version, fornito dal Python Launcher.

Riepilogo

Una corretta installazione di Python deve essere verificata, non semplicemente completata. Dopo aver installato Python 3 dal canale ufficiale, è opportuno controllare la versione, individuare l’interprete usato e verificare sistema operativo, cartella di lavoro e codifica.

Lo script creato in questo tutorial può diventare uno strumento riutilizzabile per diagnosticare configurazioni non funzionanti. Prima di iniziare un progetto, eseguirlo permette di scoprire rapidamente quale Python è attivo e dove si trovano le sue librerie.

Approfondisci con risorse ufficiali

SHARE