mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-02 03:01:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 15

gh-66944: Note that the contextlib.closing example is for illustrative purposes (#112198)

Browse source 
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
This commit is contained in:
Ville Skyttä 2024-01-23 03:00:53 +02:00 • committed by GitHub
parent 647b6cc7f1
commit 9af9ac153a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 8 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/contextlib.rst
View file

@ -182,6 +182,14 @@ Functions and classes provided:
without needing to explicitly close ``page``. Even if an error occurs,
``page.close()`` will be called when the :keyword:`with` block is exited.
.. note::
Most types managing resources support the :term:`context manager` protocol,
which closes *thing* on leaving the :keyword:`with` statment.
As such, :func:`!closing` is most useful for third party types that don't
support context managers.
This example is purely for illustration purposes,
as :func:`~urllib.request.urlopen` would normally be used in a context manager.
.. function:: aclosing(thing)