Il logging è uno strumento essenziale per qualsiasi sviluppatore Python che desidera monitorare, fare debug e gestire le proprie applicazioni in modo efficiente. Dalla registrazione di semplici messaggi informativi alla gestione di complessi flussi di dati e diagnostica, il logging fornisce una visione chiara del comportamento del codice durante l'esecuzione.

In questa guida completa, esploreremo le basi del logging in Python, utilizzando la configurazione semplice offerta da basicConfig(). Successivamente, approfondiremo le tecniche avanzate di personalizzazione per configurare loggers, handlers e formatters secondo le esigenze specifiche del tuo progetto. Che tu sia un principiante in cerca di una panoramica chiara o un programmatore esperto alla ricerca di tecniche avanzate, questa guida ti fornirà le conoscenze necessarie per gestire efficacemente il logging in Python.

Prepara il tuo ambiente di sviluppo e iniziamo questo viaggio attraverso le potenzialità del logging in Python, partendo dalle fondamenta fino ad arrivare a configurazioni sofisticate che ti aiuteranno a mantenere il controllo sulle tue applicazioni.

logging.basicConfig()

logging.basicConfig() è un modo veloce e semplice per configurare il logging di base sui tuoi script. È progettato per configurazioni semplici e può essere utilizzato per impostare:

1. il livello di log
2. il formato
3. gli handler di base

Tuttavia, basicConfig() può essere invocato solo una volta e non fornisce la flessibilità necessaria per configurazioni più complesse.

Esempio di utilizzo di basicConfig():

import logging

# Configura il logging di base
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    handlers=[
        logging.FileHandler('logfile.log'), # imposta lo stream su file
        logging.StreamHandler() # imposta lo stream su console
    ]
)

logger = logging.getLogger(__name__)
logger.info("Questo è un messaggio di info")

Definizione manuale dei logger e degli handler

La configurazione manuale dei logger offre un controllo molto più fine. Puoi creare e configurare multipli handler con livelli di log diversi, formattatori personalizzati e molte altre opzioni. Questo è particolarmente utile per applicazioni più grandi o quando hai bisogno di una configurazione di logging più complessa.

Ad esempio, potresti aver bisogno di visualizzare i log di debug sulla console, mentre inserire i log di info nel file. Per fare questo la configurazione basicConfig non basta, ma dovrai definire i logger in maniera manuale. Come segue:

import logging

# Ottieni il logger
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)  # Imposta il livello di log del logger

# Formattatore
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# FileHandler per scrivere i log su un file
file_handler = logging.FileHandler('logfile.log')
file_handler.setLevel(logging.INFO)  # Imposta il livello di log per il file
file_handler.setFormatter(formatter)

# StreamHandler per scrivere i log sulla console
stream_handler = logging.StreamHandler()
stream_handler.setLevel(logging.DEBUG)  # Imposta il livello di log per la console
stream_handler.setFormatter(formatter)

# Aggiungi gli handler al logger
logger.addHandler(file_handler)
logger.addHandler(stream_handler)

# Esempio di log
logger.debug("Questo è un messaggio di debug")
logger.info("Questo è un messaggio di info")
logger.warning("Questo è un messaggio di warning")
logger.error("Questo è un messaggio di errore")

Differenze principali

Abbiamo visto quindi che le due configurazioni hanno caratteristiche e peculiarità differenti. Vediamo insieme quali sono le principali differenze.

1.Flessibilità:

• basicConfig(): Offre una configurazione rapida e semplice, ma limitata a una singola chiamata e meno flessibile per configurazioni complesse.
• Configurazione manuale: consente una configurazione dettagliata e complessa, con più handler, formattatori e livelli di log.

2. Controllo sugli handler:

• basicConfig(): Imposta gli handler di base come file e stream, ma non permette un controllo dettagliato su di essi dopo la configurazione iniziale.
• Configurazione manuale: Consente di creare, configurare e aggiungere più handler con livelli di log e formattatori diversi.

3. Configurazione successiva:

• basicConfig(): Dopo la prima chiamata, ulteriori chiamate a basicConfig() non avranno effetto.
• Configurazione manuale: Puoi aggiungere, rimuovere o modificare gli handler in qualsiasi momento durante l'esecuzione del programma.

Quando usare ciascun approccio

Dopo aver capito e sottolineato le principali differenze e caratteristiche di ciascun approccio, vediamo quando è meglio utilizzare uno piuttosto che l'altro.

Utilizzo basicConfig()

L'utilizzo di basicConfig è consigliato quando hai bisogno di una configurazione di logging semplice e veloce per piccoli script o applicazioni che non richiedono una configurazione complessa.

Utilizzo configurazione manuale

La configurazione manuale è consigliata quando lavori su applicazioni più grandi e complesse che richiedono un controllo dettagliato sul logging, con diversi livelli di log, multipli handler e formattatori personalizzati.

Conclusione

La scelta tra basicConfig() e la configurazione manuale dipende dalle tue esigenze specifiche. Per configurazioni semplici, basicConfig() è sufficiente. Per configurazioni più avanzate, la configurazione manuale offre la flessibilità e il controllo necessari.

Altri articoli

Gestione dei turni di lavoro

Gestire Python virtualenv con pyenv su Linux

Risolvere errore uploader id su youtube-dl

VIM come IDE di sviluppo in Python