diff --git a/Doc/library/traceback.rst b/Doc/library/traceback.rst index 31a4583c14f..adf0648fd64 100644 --- a/Doc/library/traceback.rst +++ b/Doc/library/traceback.rst @@ -14,7 +14,7 @@ interpreter. .. index:: object: traceback The module uses traceback objects --- this is the object type that is stored in -the variables ``sys.exc_traceback`` (deprecated) and ``sys.last_traceback`` and +the variables :data:`sys.exc_traceback` (deprecated) and :data:`sys.last_traceback` and returned as the third item from :func:`sys.exc_info`. The module defines the following functions: @@ -58,7 +58,8 @@ The module defines the following functions: .. function:: print_last([limit[, file]]) This is a shorthand for ``print_exception(sys.last_type, sys.last_value, - sys.last_traceback, limit, file)``. + sys.last_traceback, limit, file)``. In general it will work only after + an exception has reached an interactive prompt (see :data:`sys.last_type`). .. function:: print_stack([f[, limit[, file]]]) @@ -195,27 +196,25 @@ exception and traceback:: print "*** format_tb:" print repr(traceback.format_tb(exceptionTraceback)) print "*** tb_lineno:", traceback.tb_lineno(exceptionTraceback) - print "*** print_last:" - traceback.print_last() The output for the example would look similar to this:: *** print_tb: - File "", line 9, in + File "", line 10, in lumberjack() *** print_exception: Traceback (most recent call last): - File "", line 9, in + File "", line 10, in lumberjack() - File "", line 3, in lumberjack + File "", line 4, in lumberjack bright_side_of_death() IndexError: tuple index out of range *** print_exc: Traceback (most recent call last): - File "", line 9, in + File "", line 10, in lumberjack() - File "", line 3, in lumberjack + File "", line 4, in lumberjack bright_side_of_death() IndexError: tuple index out of range *** format_exc, first and last line: @@ -223,27 +222,19 @@ The output for the example would look similar to this:: IndexError: tuple index out of range *** format_exception: ['Traceback (most recent call last):\n', - ' File "", line 9, in \n lumberjack()\n', - ' File "", line 3, in lumberjack\n bright_side_of_death()\n', - ' File "", line 6, in bright_side_of_death\n return tuple()[0]\n', + ' File "", line 10, in \n lumberjack()\n', + ' File "", line 4, in lumberjack\n bright_side_of_death()\n', + ' File "", line 7, in bright_side_of_death\n return tuple()[0]\n', 'IndexError: tuple index out of range\n'] *** extract_tb: - [('', 9, '', 'lumberjack()'), - ('', 3, 'lumberjack', 'bright_side_of_death()'), - ('', 6, 'bright_side_of_death', 'return tuple()[0]')] + [('', 10, '', 'lumberjack()'), + ('', 4, 'lumberjack', 'bright_side_of_death()'), + (u'', 7, 'bright_side_of_death', 'return tuple()[0]')] *** format_tb: - [' File "", line 9, in \n lumberjack()\n', - ' File "", line 3, in lumberjack\n bright_side_of_death()\n', - ' File "", line 6, in bright_side_of_death\n return tuple()[0]\n'] - *** tb_lineno: 2 - *** print_last: - Traceback (most recent call last): - File "", line 9, in - lumberjack() - File "", line 3, in lumberjack - bright_side_of_death() - IndexError: tuple index out of range - + [' File "", line 10, in \n lumberjack()\n', + ' File "", line 4, in lumberjack\n bright_side_of_death()\n', + ' File "", line 7, in bright_side_of_death\n return tuple()[0]\n'] + *** tb_lineno: 10 The following example shows the different ways to print and format the stack:: @@ -271,7 +262,10 @@ The following example shows the different ways to print and format the stack:: ' File "", line 8, in lumberstack\n print repr(traceback.format_stack())\n'] -This last example demonstrates the final few formatting functions:: +This last example demonstrates the final few formatting functions: + +.. doctest:: + :options: +NORMALIZE_WHITESPACE >>> import traceback >>> traceback.format_list([('spam.py', 3, '', 'spam.eggs()'),