CKTIS / Python
AssertionError — asserção falhada
AssertionError é uma exceção integrada lançada quando a condição de uma instrução assert é falsa. As asserções verificam pressupostos internos do programa, não se destinam à validação obrigatória de entradas: a otimização pode removê-las.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
assert condition
assert condition, message
raise AssertionError(message)AssertionError é uma classe de exceção integrada que deriva de Exception. Quando as asserções estão ativadas, assert condition verifica o valor lógico da condição e lança AssertionError se esta for falsa. A forma assert condition, message passa o valor de message ao construtor da exceção; a expressão da mensagem só é avaliada quando a condição não é satisfeita.
Uma asserção exprime um pressuposto do programador sobre o estado interno do programa. No exemplo, first_item pressupõe que a lista não está vazia. A chamada com [] viola esse pressuposto, e except AssertionError as exc captura a exceção e apresenta o respetivo tipo e mensagem. Neste caso, a captura serve para demonstrar a exceção, não para corrigir a sua causa.
Não uses assert para a validação obrigatória de dados do utilizador nem para verificações de permissões. Com a otimização, por exemplo através de -O, as instruções assert são ignoradas: nem a condição nem a mensagem são avaliadas. Não coloques nelas operações necessárias para o funcionamento do programa. Escreve as verificações obrigatórias com if e um raise explícito, escolhendo uma exceção adequada, como ValueError para um valor de argumento inadequado.
Também podes executar explicitamente raise AssertionError(message); essa instrução não é removida pela otimização. Ao diagnosticar o erro, verifica o pressuposto violado e o código que produziu o estado inesperado, em vez de simplesmente eliminares a asserção.
Exemplos
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))Resultado
AssertionError items must not be empty
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.