Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

AssertionError — asserzione fallita

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.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

assert condition
assert condition, message
raise AssertionError(message)

AssertionError è una classe di eccezione integrata che deriva da Exception. Quando le asserzioni sono abilitate, assert condition verifica il valore di verità della condizione e solleva AssertionError se è falsa. La forma assert condition, message passa il valore di message al costruttore dell’eccezione; l’espressione del messaggio viene valutata solo se la condizione non è soddisfatta.

Un’asserzione esprime un’ipotesi del programmatore sullo stato interno del programma. Nell’esempio, first_item presuppone che la lista non sia vuota. La chiamata con [] viola tale ipotesi, e except AssertionError as exc intercetta l’eccezione e ne stampa il tipo e il messaggio. Qui l’intercettazione serve a mostrare l’eccezione, non a correggerne la causa.

Non usare assert per la convalida obbligatoria dei dati dell’utente o per i controlli delle autorizzazioni. Con l’ottimizzazione, ad esempio tramite -O, le istruzioni assert vengono ignorate: non vengono valutati né la condizione né il messaggio. Non inserire al loro interno operazioni necessarie al funzionamento del programma. Scrivi i controlli obbligatori usando if con un raise esplicito e scegli un’eccezione adatta, come ValueError per un valore di argomento non appropriato.

Puoi anche eseguire esplicitamente raise AssertionError(message); questa istruzione non viene rimossa dall’ottimizzazione. Per diagnosticare l’errore, esamina l’ipotesi violata e il codice che ha prodotto lo stato inatteso, invece di limitarti a eliminare l’asserzione.

Esempi

def first_item(items):
    assert len(items) > 0, "items must not be empty"
    return items[0]

try:
    first_item([])
except AssertionError as exc:
    print(type(exc).__name__)
    print(str(exc))

Risultato

AssertionError
items must not be empty

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti