mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-25 17:59:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

[3.12] gh-109184: update traceback module doc w.r.t notes (message is no longer always at the end) (#109201) (#109334)

Browse source 
gh-109184: update traceback module doc w.r.t notes (message is no longer always at the end) (#109201)

(cherry picked from commit 0e76cc359b)
This commit is contained in:
Irit Katriel 2023-09-13 11:35:26 +01:00 • committed by GitHub
parent 21f4e6d6cb
commit 08bd2aa793
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

40
Doc/library/traceback.rst
View file

@ -139,11 +139,11 @@ The module defines the following functions:
Format the exception part of a traceback using an exception value such as Format the exception part of a traceback using an exception value such as
given by ``sys.last_value``. The return value is a list of strings, each given by ``sys.last_value``. The return value is a list of strings, each
ending in a newline. Normally, the list contains a single string; however, ending in a newline. The list contains the exception's message, which is
for :exc:`SyntaxError` exceptions, it contains several lines that (when normally a single string; however, for :exc:`SyntaxError` exceptions, it
printed) display detailed information about where the syntax error occurred. contains several lines that (when printed) display detailed information
The message indicating which exception occurred is the always last string in about where the syntax error occurred. Following the message, the list
the list. contains the exception's :attr:`notes <BaseException.__notes__>`.
Since Python 3.10, instead of passing *value*, an exception object Since Python 3.10, instead of passing *value*, an exception object
can be passed as the first argument. If *value* is provided, the first can be passed as the first argument. If *value* is provided, the first
@ -153,6 +153,9 @@ The module defines the following functions:
The *etype* parameter has been renamed to *exc* and is now The *etype* parameter has been renamed to *exc* and is now
positional-only. positional-only.
.. versionchanged:: 3.11
The returned list now includes any notes attached to the exception.
.. function:: format_exception(exc, /[, value, tb], limit=None, chain=True) .. function:: format_exception(exc, /[, value, tb], limit=None, chain=True)
@ -235,6 +238,12 @@ capture data for later printing in a lightweight fashion.
group's exceptions array. The formatted output is truncated when either group's exceptions array. The formatted output is truncated when either
limit is exceeded. limit is exceeded.
.. versionchanged:: 3.10
Added the *compact* parameter.
.. versionchanged:: 3.11
Added the *max_group_width* and *max_group_depth* parameters.
.. attribute:: __cause__ .. attribute:: __cause__
A :class:`TracebackException` of the original ``__cause__``. A :class:`TracebackException` of the original ``__cause__``.
@ -330,28 +339,21 @@ capture data for later printing in a lightweight fashion.
some containing internal newlines. :func:`~traceback.print_exception` some containing internal newlines. :func:`~traceback.print_exception`
is a wrapper around this method which just prints the lines to a file. is a wrapper around this method which just prints the lines to a file.
The message indicating which exception occurred is always the last
string in the output.
.. method:: format_exception_only() .. method:: format_exception_only()
Format the exception part of the traceback. Format the exception part of the traceback.
The return value is a generator of strings, each ending in a newline. The return value is a generator of strings, each ending in a newline.
Normally, the generator emits a single string; however, for The generator emits the exception's message followed by its notes
:exc:`SyntaxError` exceptions, it emits several lines that (when (if it has any). The exception message is normally a single string;
printed) display detailed information about where the syntax however, for :exc:`SyntaxError` exceptions, it consists of several
error occurred. lines that (when printed) display detailed information about where
the syntax error occurred.
The message indicating which exception occurred is always the last .. versionchanged:: 3.11
string in the output. The exception's notes are now included in the output.
.. versionchanged:: 3.10
Added the *compact* parameter.
.. versionchanged:: 3.11
Added the *max_group_width* and *max_group_depth* parameters.
:class:`StackSummary` Objects :class:`StackSummary` Objects