Skip to content
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

gh-95914: Add paragraph about PEP 654 in main body of 'What's New in 3.11' #95937

Merged
merged 8 commits into from
Aug 13, 2022
Merged

gh-95914: Add paragraph about PEP 654 in main body of 'What's New in 3.11' #95937

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
232d87b
gh-95914: add paragraph about pep 654 in main body of 'what's new in …
iritkatriel Aug 12, 2022
6953eba
whitespace
iritkatriel Aug 13, 2022
87d77c4
heading
iritkatriel Aug 13, 2022
e18ee3c
whitespace
iritkatriel Aug 13, 2022
4b13c09
:keyword:
iritkatriel Aug 13, 2022
dd28613
revert PEP-678 changes. Update titles
iritkatriel Aug 13, 2022
c64a047
whitespace
iritkatriel Aug 13, 2022
602fdc9
whitespace
iritkatriel Aug 13, 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
21 changes: 19 additions & 2 deletions Doc/whatsnew/3.11.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -176,8 +176,25 @@ The :option:`-X` ``no_debug_ranges`` option and the environment variable
See :pep:`657` for more details. (Contributed by Pablo Galindo, Batuhan Taskaya
and Ammar Askar in :issue:`43950`.)

Exceptions can be enriched with notes (PEP 678)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

PEP 654: Exception Groups and ``except*``
-----------------------------------------

:pep:`654` introduces language features that enable a program
to raise and handle multiple unrelated exceptions simultaneously.
The builtin types :exc:`ExceptionGroup` and :exc:`BaseExceptionGroup`
make it possible to group exceptions and raise them together,
and the new :keyword:`except* <except_star>` syntax generalizes
:keyword:`except` to match subgroups of exception groups.

See :pep:`654` for more details.

(Contributed by Irit Katriel in :issue:`45292`. PEP written by
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
(Contributed by Irit Katriel in :issue:`45292`. PEP written by
(Contributed by Irit Katriel in :gh:`89455`. PEP written by

Copy link
Member Author

Choose a reason for hiding this comment

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

This should be done (if at all) in a separate PR where the summary reference to the same issue is updated as well.

I say "if at all" because this is not historically accurate - I did the work under a bpo issue. Are you going to change all references to bpo issues in the docs to the gh issues they were mapped to?

Irit Katriel, Yury Selivanov and Guido van Rossum.)


PEP 678: Exceptions can be enriched with notes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The :meth:`add_note` method was added to :exc:`BaseException`. It can be
used to enrich exceptions with context information which is not available
Expand Down