Skip to content

bpo-42179: Clarify exception chaining #23160

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
willingc merged 5 commits into from
Dec 16, 2020
Merged

bpo-42179: Clarify exception chaining #23160

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
86fe587
Update errors.rst
greatvovan Nov 5, 2020
c29f3a2
Update errors.rst
greatvovan Nov 5, 2020
35d34c3
Update errors.rst
greatvovan Nov 5, 2020
bb29890
Merge branch 'master' into bugfix/bpo-42179
greatvovan Nov 6, 2020
2831bc0
Update errors.rst
greatvovan Nov 9, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update errors.rst 
Wording
  • Loading branch information
@greatvovan
greatvovan authored Nov 5, 2020
commit c29f3a239ded54e3c3f4c682be78003fd0acd8ea
6 changes: 3 additions & 3 deletions Doc/tutorial/errors.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -303,9 +303,9 @@ The expression following the :keyword:`from` must be either an exception or
``None``. Exception chaining happens automatically when an exception is raised
inside an exception handler or :keyword:`finally` section, however in this case
``__context__`` attribute of the exception is used. Chaining with
Copy link
Copy Markdown
Contributor

@willingc willingc Nov 5, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I recommend submitting this sentence right before the builtin exceptions sentence after #23162 lands. Then add "Chaining with ... takes priority."

``__context__`` works similarly, but when formatting exception traceback
``__cause__`` takes priority. For more information about chaining mechanics
see :ref:`bltin-exceptions`.
``__context__`` works similarly to chaining wit ``__cause__``,
but when formatting exception traceback ``__cause__`` takes priority.
For more information about chaining mechanics see :ref:`bltin-exceptions`.

Exception chaining can be disabled by using ``from None`` idiom:

Expand Down