[Python-checkins] r84524 - python/branches/py3k/Doc/whatsnew/3.2.rst

Sun Sep 5 10:46:36 CEST 2010

Author: raymond.hettinger
Date: Sun Sep 5 10:46:36 2010
New Revision: 84524
Log:
Add example of ftplib's new context manager.
Modified:
 python/branches/py3k/Doc/whatsnew/3.2.rst
Modified: python/branches/py3k/Doc/whatsnew/3.2.rst
==============================================================================

--- python/branches/py3k/Doc/whatsnew/3.2.rst	(original)
+++ python/branches/py3k/Doc/whatsnew/3.2.rst	Sun Sep 5 10:46:36 2010
@@ -216,7 +216,7 @@
 :issue:`8814`.)
 
 * The :mod:`abc` module now supports :func:`abstractclassmethod` and
- :func:`staticmethod`.
+ :func:`abstractstaticmethod`.
 
 (:issue:`5867`)
 
@@ -261,6 +261,20 @@
 `appspot issue 53094 <http://codereview.appspot.com/53094>`_.)
 
 * The :class:`ftplib.FTP` class now supports the context manager protocol
+ to unconditionally consume :exc:`socket.error` exceptions and to close
+ the ftp connection when done::
+
+ >>> from ftplib import FTP
+ >>> with FTP("ftp1.at.proftpd.org") as ftp:
+ ... ftp.login()
+ ... ftp.dir()
+ ...
+ '230 Anonymous login ok, restrictions apply.'
+ dr-xr-xr-x 9 ftp ftp 154 May 6 10:43 .
+ dr-xr-xr-x 9 ftp ftp 154 May 6 10:43 ..
+ dr-xr-xr-x 5 ftp ftp 4096 May 6 10:43 CentOS
+ dr-xr-xr-x 3 ftp ftp 18 Jul 10 2008 Fedora
+
 (Contributed by Tarek Ziadé and Giampaolo Rodolà; :issue:`4972`.)
 
 * A warning message will now get printed at interpreter shutdown if
@@ -270,16 +284,17 @@
 
 * The :mod:`os` module now has the :const:`ST_RDONLY` and :const:`ST_NOSUID`
 constants, for use with the :func:`~os.statvfs` function.
+
 (Patch by Adam Jackson; :issue:`7647`.)
 
 * The :func:`shutil.copytree` function has two new options:
 
- * *ignore_dangling_symlinks*: when ``symlinks=False`` (meaning that the
+ * *ignore_dangling_symlinks*: when ``symlinks=False`` dp that the
 function copies the file pointed to by the symlink, not the symlink
- itself) this option will silence the error raised if the file doesn't
+ itself. This option will silence the error raised if the file doesn't
 exist.
 
- * *copy_function*: a callable that will be used to copy files.
+ * *copy_function*: is a callable that will be used to copy files.
 :func:`shutil.copy2` is used by default.
 
 (Contributed by Tarek Ziadé.)
