Python Language Reference Manual by Guido van Rossum and Fred L. Drake, Jr. Paperback (6"x9"), 120 pages ISBN 0954161785 RRP £12.95 ($19.95) Sales of this book support the Python Software Foundation! Get a printed copy>>>

Python Language Reference Manual Buy the book here! >>> support free software

6.2 Assert statements

Assert statements are a convenient way to insert debugging assertions into a program:

assert_stmt "assert" expression ["," expression]

The simple form, ‘assert expression’, is equivalent to

    if __debug__:
       if not expression: raise AssertionError

The extended form, ‘assert expression1, expression2’, is equivalent to

    if __debug__:
       if not expression1: raise AssertionError, expression2

These equivalences assume that __debug__ and AssertionError refer to the built-in variables with those names. In the current implementation, the built-in variable __debug__ is True under normal circumstances, and False when optimization is requested (command line option -O). The current code generator emits no code for an assert statement when optimization is requested at compile time. Note that it is unnecessary to include the source code for the expression that failed in the error message; it will be displayed as part of the stack trace.

Assignments to __debug__ are illegal. The value for the built-in variable is determined when the interpreter starts.