L’unione di tipi `X | None`
`X | None` descrive un valore di tipo `X` oppure `None`. In `-> str | None` indica il risultato di una funzione, non un valore predefinito.
CKTIS / Python
Sintassi, operatori e concetti di programmazione. Trova una spiegazione, consulta un esempio e torna a imparare.
`X | None` descrive un valore di tipo `X` oppure `None`. In `-> str | None` indica il risultato di una funzione, non un valore predefinito.
Usa `X | None` per ammettere un valore di tipo `X` oppure `None`. Se una classe è definita più avanti, racchiudi l’intera annotazione tra virgolette o usa l’import da `__future__`.
Usa `setUp()` per far partire ogni test con dati nuovi. Poi verifica i valori con `assertEqual()` e un’eccezione attesa con `assertRaises()`.
Verifica più input in un solo metodo di test, identifica i sottotest non riusciti e distingui un’asserzione di uguaglianza da una verifica delle eccezioni.
Esegui una suite di test o un singolo caso di test e usa il `TestResult` restituito per creare un riepilogo personalizzato senza analizzare il rapporto testuale.
Nella definizione di una funzione, `*args` raccoglie gli argomenti posizionali in eccesso in una tupla. In una chiamata, `*` spacchetta un iterabile in argomenti posizionali.
In Python 3.12, `*args` raccoglie gli argomenti posizionali in più in una tupla e `**kwargs` gli argomenti per nome senza corrispondenza in un dizionario. In una chiamata, gli stessi simboli espandono gli argomenti.
Nella definizione di una funzione, `*items` raccoglie gli argomenti posizionali rimanenti in una tupla. In una chiamata, `*values` fa il contrario: passa gli elementi di un iterabile come argomenti posizionali distinti.
Avvolgi un logger esistente in `logging.LoggerAdapter` con un campo `team` per associare lo stesso contesto alle chiamate a `info`, `warning` ed `error`.
Usa `write()` per scrivere testo in memoria un pezzo alla volta, `read()` per leggere dalla posizione corrente e `getvalue()` per ottenere l’intero buffer senza tornare all’inizio.
AssertionError è un’eccezione integrata che viene sollevata quando la condizione di un’istruzione assert è falsa. Le asserzioni verificano le ipotesi interne del programma, non servono per la convalida obbligatoria degli input: l’ottimizzazione può rimuoverle.
Exception è la classe base integrata di Python per le eccezioni ordinarie. Permette di definire tipi di errore personalizzati e intercettarli insieme, ma non comprende tutti i discendenti di BaseException.
IndexError è un’eccezione integrata che viene generata quando si tenta di accedere a un elemento di una sequenza usando un indice fuori intervallo. Scopri i limiti degli indici validi, la differenza tra indicizzazione e slicing e come intercettare questa eccezione.
KeyError indica che una chiave richiesta non è stata trovata in un mapping, ad esempio un dict. Scopri la differenza tra l’accesso con le parentesi quadre e get(), e gestisci le chiavi mancanti senza nascondere errori non correlati.
NameError significa che Python non è riuscito a trovare un nome usato negli ambiti disponibili. Controlla l’ortografia, l’ordine delle assegnazioni e gli import. Distingui NameError da AttributeError. UnboundLocalError è una sottoclasse di NameError.
StopIteration segnala che un iteratore si è esaurito durante next(). Il suo attributo value può contenere il valore restituito da un generatore. Terminare un generatore con return è diverso dal lasciare che un StopIteration sollevato esplicitamente fuoriesca dal suo codice.
TimeoutError segnala che un’operazione ha superato il proprio limite di tempo. In Python 3.14, asyncio.TimeoutError è un alias deprecato della stessa classe, non un’eccezione distinta. Intercetta TimeoutError e distingui un timeout dal normale annullamento di un’attività.
TypeError indica che un’operazione o una funzione ha ricevuto un oggetto di tipo inappropriato. Scopri in cosa differisce da ValueError e come gestirlo senza nascondere il problema sottostante.
UnboundLocalError si verifica quando una funzione legge una variabile locale a cui in quel momento non è associato alcun valore. È una sottoclasse di NameError; una causa frequente è un’assegnazione che nasconde una variabile di uno scope esterno.
ValueError indica che un argomento ha il tipo corretto, ma un valore non accettabile. Scopri in cosa differisce da TypeError e come sollevarlo e intercettarlo.
ZeroDivisionError è un’eccezione integrata che viene generata quando una divisione o un’operazione di resto utilizza un divisore pari a zero. Gestiscila con except ZeroDivisionError quando il programma può reagire in modo appropriato a questo caso.
Restituisce il valore assoluto di un numero o il modulo di un complesso.
Ottiene un iteratore asincrono tramite `__aiter__` senza attendere un valore.
Verifica il valore logico degli elementi fino al primo falso.