https://github.com/python/cpython/commit/5c02ea8bae2287a828840f5734966da23dc573dc
commit: 5c02ea8bae2287a828840f5734966da23dc573dc
branch: main
author: Irit Katriel <[email protected]>
committer: iritkatriel <[email protected]>
date: 2024-06-05T11:56:01Z
summary:
gh-119287: clarify doc on BaseExceptionGroup.derive and link to it from
contextlib.suppress (#119657)
files:
M Doc/library/contextlib.rst
M Doc/library/exceptions.rst
diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index bad9da52d6a6ca..27cf99446e5980 100644
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -314,7 +314,9 @@ Functions and classes provided:
If the code within the :keyword:`!with` block raises a
:exc:`BaseExceptionGroup`, suppressed exceptions are removed from the
- group. If any exceptions in the group are not suppressed, a group
containing them is re-raised.
+ group. Any exceptions of the group which are not suppressed are re-raised
in
+ a new group which is created using the original group's
:meth:`~BaseExceptionGroup.derive`
+ method.
.. versionadded:: 3.4
diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index 7879fb015bddfa..7910b306f143d7 100644
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -989,7 +989,8 @@ their subgroups based on the types of the contained
exceptions.
Returns an exception group with the same :attr:`message`, but which
wraps the exceptions in ``excs``.
- This method is used by :meth:`subgroup` and :meth:`split`. A
+ This method is used by :meth:`subgroup` and :meth:`split`, which
+ are used in various contexts to break up an exception group. A
subclass needs to override it in order to make :meth:`subgroup`
and :meth:`split` return instances of the subclass rather
than :exc:`ExceptionGroup`.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
