[Python-checkins] [3.10] bpo-28516: document contextlib.ExitStack.__enter__ behavior (GH-31636) (GH-32171)
JelleZijlstra
webhook-mailer at python.org
Mon Mar 28 22:40:04 EDT 2022
https://github.com/python/cpython/commit/604d003ab4d1084ef828ebca1b28f2bf1b93c744
commit: 604d003ab4d1084ef828ebca1b28f2bf1b93c744
branch: 3.10
author: Jelle Zijlstra <jelle.zijlstra at gmail.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2022-03-28T19:39:55-07:00
summary:
[3.10] bpo-28516: document contextlib.ExitStack.__enter__ behavior (GH-31636) (GH-32171)
The enter_context is updated with following information: 'The :meth:`__enter__` method
returns the ExitStack instance, and performs no additional operations.'
Co-authored-by: Jelle Zijlstra <jelle.zijlstra at gmail.com>
(cherry picked from commit 86384cf83f96fcaec03e2ad6516e2e24f20d3b92)
Co-authored-by: vidhya <96202776+Vidhyavinu at users.noreply.github.com>
files:
M Doc/library/contextlib.rst
diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index b6ec6b8c876be..0fe3206540e80 100644
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -485,6 +485,9 @@ Functions and classes provided:
# the with statement, even if attempts to open files later
# in the list raise an exception
+ The :meth:`__enter__` method returns the :class:`ExitStack` instance, and
+ performs no additional operations.
+
Each instance maintains a stack of registered callbacks that are called in
reverse order when the instance is closed (either explicitly or implicitly
at the end of a :keyword:`with` statement). Note that callbacks are *not*
More information about the Python-checkins
mailing list