CKTIS / Python
AssertionError — неуспешна проверка с твърдение
AssertionError е вградено изключение, което се повдига, когато условието на оператор assert е невярно. Твърденията проверяват вътрешни предположения на програмата, а не служат за задължителна проверка на входни данни: оптимизацията може да ги премахне.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
assert condition
assert condition, message
raise AssertionError(message)AssertionError е вграден клас изключение, наследяващ Exception. Когато твърденията са активирани, assert condition проверява логическата стойност на условието и повдига AssertionError, ако то е невярно. Формата assert condition, message подава стойността на message към конструктора на изключението; изразът на съобщението се оценява само ако условието не е изпълнено.
Твърдението изразява предположение на програмиста за вътрешното състояние на програмата. В примера first_item приема, че списъкът не е празен. Извикването с [] нарушава това предположение, а except AssertionError as exc прихваща изключението и извежда неговия тип и съобщение. Тук прихващането служи за демонстрация на изключението, а не за отстраняване на причината му.
Не използвайте assert за задължителна проверка на потребителски входни данни или права за достъп. При оптимизация, например с -O, операторите assert се пропускат: не се оценяват нито условието, нито съобщението. Не поставяйте в тях операции, необходими за работата на програмата. Записвайте задължителните проверки с if и изричен raise, като изберете подходящо изключение, например ValueError за неподходяща стойност на аргумент.
Можете също изрично да изпълните raise AssertionError(message); оптимизацията не премахва този оператор. Когато диагностицирате грешката, проверете нарушеното предположение и кода, довел до неочакваното състояние, вместо просто да премахнете твърдението.
Примери
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))Резултат
AssertionError items must not be empty
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.