summaryrefslogtreecommitdiffstats
path: root/Doc/library/ftplib.rst
diff options
context:
space:
mode:
authorGiampaolo RodolĂ  <g.rodola@gmail.com>2010-05-10 14:53:29 (GMT)
committerGiampaolo RodolĂ  <g.rodola@gmail.com>2010-05-10 14:53:29 (GMT)
commitbd576b75b7bed253b7bf4af5a967e3ee4dc1af8a (patch)
treefe5924f78b230670672d6097bc3be6724fed9b27 /Doc/library/ftplib.rst
parentf95a1b3c53bdd678b64aa608d4375660033460c3 (diff)
downloadcpython-bd576b75b7bed253b7bf4af5a967e3ee4dc1af8a.zip
cpython-bd576b75b7bed253b7bf4af5a967e3ee4dc1af8a.tar.gz
cpython-bd576b75b7bed253b7bf4af5a967e3ee4dc1af8a.tar.bz2
Fix issue #4972: adds ftplib.FTP context manager protocol
Diffstat (limited to 'Doc/library/ftplib.rst')
-rw-r--r--Doc/library/ftplib.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/Doc/library/ftplib.rst b/Doc/library/ftplib.rst
index 02edef7..857f413 100644
--- a/Doc/library/ftplib.rst
+++ b/Doc/library/ftplib.rst
@@ -46,6 +46,25 @@ The module defines the following items:
connection attempt (if is not specified, the global default timeout setting
will be used).
+ :class:`FTP` class supports the :keyword:`with` statement. Here is a sample
+ on how using it:
+
+ >>> 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
+ >>>
+
+ .. versionchanged:: 3.2
+ Support for the :keyword:`with` statement was added.
+
+
.. class:: FTP_TLS(host='', user='', passwd='', acct='', [keyfile[, certfile[, timeout]]])
A :class:`FTP` subclass which adds TLS support to FTP as described in