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
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
attribute references
  • Loading branch information
@iritkatriel
iritkatriel committed Dec 20, 2021
commit cbff13f87da6d264e325bc6cd4e87b7c20992dbe
17 changes: 9 additions & 8 deletions Doc/library/exceptions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -889,9 +889,9 @@ their subgroups based on the types of the contained exceptions.
same check that is used in an ``except`` clause.

The nesting structure of the current exception is preserved in the result,
as are the values of its ``msg``, ``__traceback__``, ``__cause__``,
``__context__`` and ``__note__`` fields. Empty nested groups are omitted
from the result.
as are the values of its :attr:`message`, :attr:`__traceback__`,
:attr:`__cause__`, :attr:`__context__` and :attr:`__note__` fields.
Empty nested groups are omitted from the result.

The condition is checked for all exceptions in the nested exception group,
including the top-level and any nested exception groups. If the condition is
Expand All @@ -905,11 +905,12 @@ their subgroups based on the types of the contained exceptions.

.. method:: derive(excs)

Returns an exception group with the same ``msg``, ``__traceback__``,
``__cause__``, ``__context__`` and ``__note__`` but which wraps the
exceptions in ``excs``. This method is used by :meth:`subgroup` and
:meth:`split` and may need to be overridden in subclasses if there are
additional values that need to be copied over to the result.
Returns an exception group with the same :attr:`message`,
:attr:`__traceback__`, :attr:`__cause__`, :attr:`__context__`
and :attr:`__note__` but which wraps the exceptions in ``excs``.
This method is used by :meth:`subgroup` and :meth:`split` and
may need to be overridden in subclasses if there are additional
values that need to be copied over to the result.

.. versionadded:: 3.11

Expand Down