traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Issue 6288: Update contextlib.nested() docstring to reflect new documentation

This commit is contained in:
Nick Coghlan 2009-06-23 10:19:30 +00:00
parent 94819cf47c
commit 0d8b4e33e7
1 changed files with 8 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Lib/contextlib.py
View File

@ -87,19 +87,17 @@ def contextmanager(func):
@contextmanager
def nested(*managers):
"""Support multiple context managers in a single with-statement.
"""Combine multiple context managers into a single nested context manager.
Code like this:
This function has been deprecated in favour of the multiple manager form
of the :keyword:`with` statement.
with nested(A, B, C) as (X, Y, Z):
<body>
The one advantage of this function over the multiple manager form of the
:keyword:`with` statement is that argument unpacking allows it to be
used with a variable number of context managers as follows:
is equivalent to this:
with A as X:
with B as Y:
with C as Z:
<body>
with nested(*managers):
do_something()
"""
warn("With-statements now directly support multiple context managers",