Skip to content

bpo-45292: [PEP-654] exception groups and except* documentation #30158

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
iritkatriel merged 17 commits into from
Jan 6, 2022
+208 −1
Merged

bpo-45292: [PEP-654] exception groups and except* documentation #30158

Changes from 1 commit
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
f42d81e
bpo-45292: except* documentation
iritkatriel Dec 16, 2021
1eaebb2
fix
iritkatriel Dec 16, 2021
59ae0f5
Apply suggestions from code review
iritkatriel Dec 17, 2021
af959d7
add _except_star anchor
iritkatriel Dec 17, 2021
27db9c3
add small note example
iritkatriel Dec 17, 2021
274f7f1
mentioned __note__ in traceback doc
iritkatriel Dec 17, 2021
9f90292
Apply suggestions from code review
iritkatriel Dec 17, 2021
a285f87
typo
iritkatriel Dec 19, 2021
6a99f8c
nested exceptions must be instances
iritkatriel Dec 19, 2021
7a13adb
subgroup/split check condition for interior nodes as well. This mean …
iritkatriel Dec 19, 2021
be728bf
Kumar’s edit
iritkatriel Dec 20, 2021
cbff13f
attribute references
iritkatriel Dec 20, 2021
2b76b03
reword __note__ description
iritkatriel Dec 21, 2021
dd967c2
fix the contructor description
iritkatriel Dec 22, 2021
a964a2d
add subclassing example
iritkatriel Jan 4, 2022
939a1f6
remove __note__ documentation
iritkatriel Jan 6, 2022
4a46570
Fix prompt in example
iritkatriel Jan 6, 2022
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
nested exceptions must be instances
  • Loading branch information
@iritkatriel
iritkatriel committed Dec 19, 2021
commit 6a99f8c76b0efb5e45a9efec3470037440a2f86e
23 changes: 20 additions & 3 deletions Doc/tutorial/errors.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -509,9 +509,9 @@ tasks may have failed in parallel, but there are also other use cases where
it is desirable to continue execution and collect multiple errors rather than
raise the first exception.

The builtin :exc:`ExceptionGroup` wraps a list of exceptions so that they can
be raised together. It is an exception itself, so it can be caught like any
other exception. ::
The builtin :exc:`ExceptionGroup` wraps a list of exception instances so
that they can be raised together. It is an exception itself, so it can be
caught like any other exception. ::

>>> def f():
... excs = [OSError('error 1'), SystemError('error 2')]
Comment thread
iritkatriel marked this conversation as resolved.
Expand Down Expand Up @@ -569,6 +569,23 @@ other clauses and eventually to be reraised. ::
+------------------------------------
>>>

Note that the exceptions nested in an exception group must be instances,
not types. This is because in practice the exceptions would typically
be ones that have already been raised and caught by the program, along
the following pattern::

>>> excs = []
... for test in tests:
... try:
... test.run()
... except Exception as e:
... excs.append(e)
...
... if excs:
Comment thread
iritkatriel marked this conversation as resolved.
Outdated
... raise ExceptionGroup("Test Failures", excs)
...


Enriching Exceptions with Notes
===============================

Expand Down