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.