cpython: 287bb82768a7 (original) (raw)

Mercurial > cpython

changeset 99572:287bb82768a7

Issue #11072: change the incorrect "deprecation" of ftplib dir() and nlst() APIs into a note that mlsd() is a nicer API if the server supports it. They aren't deprecated, they are all different server commands. Not all servers support all commands. [#11072]

Gregory P. Smith greg@krypto.org
date	Sun, 13 Dec 2015 22:10:58 -0800
parents	41717421b134(current diff)ecef6b3f6639(diff)
children	f8afbc4749a1
files
diffstat	1 files changed, 3 insertions(+), 3 deletions(-)[+] [-] Doc/library/ftplib.rst 6

line wrap: on

line diff

--- a/Doc/library/ftplib.rst +++ b/Doc/library/ftplib.rst @@ -314,7 +314,7 @@ followed by lines for the text versi .. method:: FTP.mlsd(path="", facts=[])

List a directory in a standardized format by using MLSD command

List a directory in a standardized format by using MLSD command (:rfc:3659). If path is omitted the current directory is assumed. facts is a list of strings representing the type of information desired (e.g. ["type", "size", "perm"]). Return a generator object yielding a @@ -333,7 +333,7 @@ followed by lines for the text versi directory). Multiple arguments can be used to pass non-standard options to the NLST command.

.. deprecated:: 3.3 use :meth:mlsd instead.

.. note:: If your server supports the command, :meth:mlsd offers a better API.

.. method:: FTP.dir(argument[, ...]) @@ -345,7 +345,7 @@ followed by lines for the text versi as a callback function as for :meth:retrlines; the default prints to sys.stdout. This method returns None.

.. deprecated:: 3.3 use :meth:mlsd instead.

.. note:: If your server supports the command, :meth:mlsd offers a better API.

.. method:: FTP.rename(fromname, toname)