Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

AssertionError — niespełniona asercja

AssertionError to wbudowany wyjątek zgłaszany, gdy warunek instrukcji assert jest fałszywy. Asercje służą do sprawdzania wewnętrznych założeń programu, nie do obowiązkowej walidacji danych: optymalizacja może je usunąć.

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

Składnia

assert condition
assert condition, message
raise AssertionError(message)

AssertionError to wbudowana klasa wyjątku dziedzicząca po Exception. Gdy asercje są włączone, instrukcja assert condition sprawdza wartość logiczną warunku i zgłasza AssertionError, jeśli jest ona fałszywa. Wariant assert condition, message przekazuje wartość message do konstruktora wyjątku; wyrażenie komunikatu jest obliczane tylko wtedy, gdy warunek nie jest spełniony.

Asercja opisuje założenie programisty dotyczące wewnętrznego stanu programu. W przykładzie first_item zakłada, że lista nie jest pusta. Wywołanie z [] narusza to założenie, a except AssertionError as exc przechwytuje wyjątek i wypisuje jego typ oraz komunikat. Przechwycenie służy tu demonstracji, a nie naprawieniu przyczyny błędu.

Nie używaj assert do obowiązkowej walidacji danych użytkownika ani kontroli uprawnień. Przy optymalizacji, np. przez -O, instrukcje assert są pomijane: ani warunek, ani komunikat nie są obliczane. Nie umieszczaj w nich operacji niezbędnych do działania programu. Wymagane sprawdzenia zapisuj jako if z jawnym raise, dobierając odpowiedni wyjątek, np. ValueError dla nieodpowiedniej wartości argumentu.

Można też jawnie wykonać raise AssertionError(message); taka instrukcja nie znika po włączeniu optymalizacji. Przy diagnozowaniu błędu sprawdź naruszone założenie oraz kod, który wytworzył nieoczekiwany stan, zamiast jedynie usuwać asercję.

Przykłady

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))

Wynik

AssertionError
items must not be empty

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła