gh-139320: Cover exception chaining in the docs of contextmanager.__exit__ (GH-140169)

This commit is contained in:
Bartosz Sławecki 2025-12-16 11:15:37 +01:00 committed by GitHub
parent 15a9762500
commit a44509ea87
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -5475,9 +5475,11 @@ before the statement body is executed and exited when the statement ends:
Returning a true value from this method will cause the :keyword:`with` statement
to suppress the exception and continue execution with the statement immediately
following the :keyword:`!with` statement. Otherwise the exception continues
propagating after this method has finished executing. Exceptions that occur
during execution of this method will replace any exception that occurred in the
body of the :keyword:`!with` statement.
propagating after this method has finished executing.
If this method raises an exception while handling an earlier exception from the
:keyword:`with` block, the new exception is raised, and the original exception
is stored in its :attr:`~BaseException.__context__` attribute.
The exception passed in should never be reraised explicitly - instead, this
method should return a false value to indicate that the method completed